Skip to main content
本页汇总 Linkly AI 用户最常问到的一些问题。

​
Linkly AI 如何保护用户数据隐私？

Linkly AI 采用 本地优先（local-first） 架构。文档原文、全文索引、向量索引以及向量化模型推理都在你的设备上完成，默认不会上传到任何服务器。

​
哪些数据存在本地

  • 文档原文：保留在你原本的文件夹中，Linkly AI 只读取，不复制、不搬运。
  • 全文索引（BM25）：使用 Tantivy 在本地构建。
  • 向量索引：嵌入向量保存在本地数据库中。
  • Embedding 模型：本地嵌入模型完全在你的设备上运行；macOS Apple Silicon 自动启用 Metal GPU 加速，Windows / Linux 有独立显卡时使用 GPU 加速。
  • 应用日志：仅写入本地文件，不会自动上传。

​
AI 对话的数据走向

Chatbot 调用大语言模型时，数据流向取决于你选择的 provider：

本地模型

Ollama、LM Studio 等 OpenAI 兼容的本地服务。数据完全留在本机，不出设备。

Linkly 官方

通过 api.linkly.ai 转发到第三方模型供应商。请求会经过 Linkly 服务器。

第三方直连

直接连接 OpenAI、Anthropic 等 API。请求不经过 Linkly 服务器。
你可以在 设置 → AI 模型 中自由添加、切换、禁用各个 provider。

​
用户体验改进计划（遥测）

为了了解哪些功能被使用、运行环境的分布，Linkly AI 默认启用一份匿名的使用数据上报： 随时可以在 设置 → 数据隐私 → 用户体验改进计划 中关闭。关闭后内存中尚未发送的事件也会一并丢弃。
设置中的「数据隐私」面板用三张卡片可视化地展示了每项功能的数据流向（本机 / 官方云 / 第三方），可以一目了然地看到当前哪些数据会离开你的设备。

​
隐私承诺

  • 不接入 Google Analytics 等第三方分析 SDK。
  • 不读取浏览历史与剪贴板。
  • 不强制账号登录，核心功能离线可用。
  • 应用日志只写在本机，需要你主动分享才会发送给我们。

​
Linkly AI 的索引需要多久可以完成？

索引耗时取决于文件数量、文件类型、机器性能和性能模式。Linkly AI 的索引分三个阶段进行：
1

文件名快速索引（秒级）

扫描到文件后立即把路径、文件名写入全文索引，让你在等待完整索引时也能用文件名搜索定位。
2

全文提取与 BM25 索引（分钟级到小时级）

解析文档内容（txt、md、html、docx、doc、pptx、xlsx、csv、epub、rtf、pdf、图片，以及开启转写后的音视频），提取大纲与元数据后写入 Tantivy。可同时使用多个 worker 并行处理。
3

向量嵌入（分钟级到小时级）

调用本地嵌入模型为每个文档块生成向量，写入向量索引。

​
影响速度的关键因素

  • 文件数量：与总耗时近似线性相关。
  • 文件格式：纯文本最快；PDF 需要解析页面结构。
  • 机器性能：Apple Silicon（M 系列）启用 Metal GPU 加速嵌入，速度明显优于纯 CPU 推理；Windows / Linux 有独立显卡时用 GPU 加速嵌入，没有独显时用 CPU。
  • 性能模式：在 索引管理 页的「策略」区可选 高性能 / 均衡 / 自动。高性能模式并发更高、占用更多 CPU；自动模式在电脑空闲时切到高性能。

​
大致预期

下面只是粗略量级，实际耗时因机器与文件构成差异较大：
在主窗口的 索引管理 页可以实时查看进度（解析成功 / 待处理 / 无法解析）。索引进行中时，启动器页脚会显示一个转圈图标，点它也能打开这一页。索引在后台进行，不影响搜索——文件名索引完成后就能搜。
如果你只是想试用 Linkly AI，建议从一个小规模知识库（百级到千级文件）开始，等熟悉后再加入更大的目录。

​
嵌入模型和 OCR 会用核显还是独显？

Windows 和 Linux 上只用独立显卡，核显不参与。实测核显跑这些模型比同一台电脑的 CPU 还慢，所以没有独显时直接用 CPU。Apple 芯片的 Mac 用芯片自带的 GPU。 不同任务的用法不一样： 还有几点：
  • OCR 的版面分析只对 4 页及以上的 PDF 使用 GPU。单张图片和页数较少的 PDF 都用 CPU。
  • 有多块独显时，语义索引只用系统排在第一位的那一块，不按显存大小挑选。OCR 的版面分析使用 Windows 图形设置里为 Linkly AI 指定的显卡。
  • 显存不足、驱动不支持，或 GPU 反复出错时，会自动改用 CPU，索引不会中断。
  • 语义索引改用云端模型时，本机 GPU 不参与。ARM 架构的 Windows 和 Linux 设备目前只用 CPU。
想完全不用 GPU：点主窗口左侧栏底部的索引状态图标，进入「索引管理」页，在「高级」页签的「硬件」下关掉「硬件加速」。
  • Windows 和 Linux：关掉后全部用 CPU，更慢但更稳。
  • Mac：这个开关只控制 OCR 版面分析是否用 GPU，语义索引和转写不受影响。
重新打开开关，会再次尝试使用 GPU。

​
为什么有个文件搜不到？

先做一步分诊——用文件名去搜它，三种结果对应三类完全不同的问题： 这一步很关键：三类问题的处理方式完全不同，跳过分诊很容易在错误的方向上折腾很久。
正文没能进入索引的文件，都可以在 索引管理 页的「无法解析」页签里按原因查看，大多数类别可以「全部重试」或逐个重试。
被排除规则排除的文件和文件夹不会出现在资料库的文件列表里。它所在的文件夹名后面会多一个漏斗图标，鼠标悬停可以看到排除了什么，点一下打开对应的规则。

​
徽章说明

鼠标悬停在徽章上会给出同样的说明。这类文件仍然留在搜索结果里，只是没有正文可搜。提取失败的文件在内容变化后会自动重试，也可以在「无法解析」页签里手动重试。

​
云端占位文件是怎么回事

iCloud Drive、OneDrive、Dropbox、群晖 Drive 这类云盘都有「按需下载」（也叫「仅在线」「智能同步」）功能：文件在访达/资源管理器里看得见，但内容其实还在云端，只有你双击打开时才真正下载下来。 Linkly AI 刻意不去打开这类文件——一旦打开就会触发下载，那意味着一次索引就可能把你几百 GB 的云盘全拉到本地，撑爆磁盘、跑满带宽。所以它只做属性判断，认出是占位文件就跳过正文，保留文件名索引。
怎么办：在云盘客户端里把你真正需要检索的目录设为「始终保留在此设备上」（各家叫法不同，OneDrive 叫「始终保留在此设备上」，Dropbox 叫「设为本地」，iCloud 是右键「立即下载」）。文件落到本地之后，Linkly AI 会在下一次扫描时发现它已经可用，自动补做正文索引——不需要你重建索引，也不需要重新添加文件夹。
扫描会在应用启动、配置变更（比如增删文件夹）以及监听到大量文件变化时自动触发。想立刻促成一次，重启应用是最省事的办法。

​
文件签名异常怎么办

这说明文件头部的特征字节和扩展名不匹配。常见于：从某些同步工具里拿到的替身/存根文件、下载中断留下的半截文件、或者被人手工改过扩展名的文件。 用对应的软件打开确认一下——如果它本来就打不开，那 Linkly AI 跳过它是对的；如果是扩展名写错了，改成正确的扩展名即可。
Linkly AI 在这件事上的取舍是宁可漏判，不可错杀：读取文件头如果遇到临时的 IO 错误或权限抖动，一律按「内容可用」处理，绝不会因为一次瞬时失败就把真文件永久标记成替身。

​
搜得到文件名、没有徽章，正文却搜不到

没有徽章说明文件本身没问题，是正文提取那一步还没做或者做不了。按可能性从大到小：
  1. 对应的提取开关关着。图片和扫描版 PDF 靠「文字识别 (OCR)」，音视频靠「音频转写」「视频转写」——后两个默认就是关的。去 索引管理 页的「管理」区确认。
  2. 还没轮到它。OCR 和音视频转写是最重的任务，排队慢是正常的。索引管理 页的「管理」区能看到它们当前在处理哪个文件。
  3. macOS 导出的旧版 .doc 暂时解析不了。用 textutil 或 Pages 的「Word 97」导出功能生成的 .doc，内部布局与 Microsoft Word 的不同，目前会被跳过。用 Word 另存为 .docx，或转成其他受支持的格式即可。

索引设置

每个开关的作用、默认值，以及每种状态的含义，都在这一页。

​
连文件名都搜不到

这说明文件根本没有进入索引。常见原因有五个： 一、这个文件夹没有被监听。去主窗口「资料库」确认它的父目录已经添加。没有的话，在资料库左栏点「添加新目录」把它加进来。 二、这个格式不在支持列表里。Linkly AI 采用白名单：只有 PDF、DOCX、DOC、PPTX、XLSX、CSV、EPUB、RTF、Markdown、TXT、HTML、图片、音频、视频这些扩展名会被收录。htm、avi 目前都不在其中——不在白名单的文件连文件名都不会被登记。完整清单见工具介绍。 三、它在被忽略的目录里。下面这些目录及其全部子目录会被整体跳过：
  • 以点开头的隐藏目录（.git、.cache、.dropbox.cache 等）
  • node_modules、__pycache__ 这类构建/依赖缓存
  • NAS 的同步元数据目录：#recycle、#SynoRecycle、@eaDir（群晖）、@Recycle（QNAP）
  • 系统目录：$RECYCLE.BIN、System Volume Information
  • 内置数据文件：Linkly AI 自己的应用数据目录 ai.linkly.desktop，无论存放在哪里
在 Git 仓库里，被 .gitignore 排除的文件同样不会被索引。如果你的笔记正好放在某个仓库的忽略目录下，把它挪出来，或者在「资料库」左栏点「添加新目录」单独把那个目录加进来。完整的内置规则在 索引管理 页的「规则」页签底部可以看到。
四、这一类文件被关掉了。在 索引管理 → 规则 → 文件类型 里关掉的类型（比如图片、视频），不会被扫描，已入库的也会移除。 五、它被排除规则排除了。到 索引管理 → 规则 → 排除规则 检查「所有资料夹」和这个资料夹自己的规则；编辑时下方会列出每条规则排除了哪些文件。资料库左栏行尾带漏斗图标的资料夹，就是写了排除规则的。资料夹里的 .ignore 文件也会排除文件。详见索引范围。

​
能添加 NAS 里的文件吗？

可以。先在系统里把 NAS 的共享文件夹挂载好，再像本地文件夹一样添加到资料库：
  • Windows：在资源管理器里「映射网络驱动器」（如 Z:\），或者直接使用 \\NAS名称\共享名 这样的网络路径
  • macOS：在访达里「前往 → 连接服务器」，输入 smb://NAS地址/共享名，挂载后位于 /Volumes 下
  • Linux：用系统的网络位置功能或 mount 挂载 SMB / NFS 共享
然后在主窗口「资料库」左栏点「添加新目录」，选择挂载后的文件夹即可。这类目录会带一个「外接」标记。 使用 NAS 时需要注意：
  • NAS 断开或没挂载时，已索引的内容不会丢。 资料库里该目录会显示「失联」，应用每 15 分钟检查一次，连回来后自动重新扫描。
  • 别的电脑改了 NAS 上的文件，这台电脑不一定能马上发现。 网络共享上的文件改动，系统不一定会及时通知，macOS 和 Linux 上尤其如此；漏掉的改动会在下次启动 Linkly AI 时补上。
  • 首次索引比本地磁盘慢，文件越多越明显，具体取决于网络和 NAS 的读取速度。
  • 群晖、威联通的回收站和缩略图目录（#recycle、@eaDir 等）会自动跳过，不会被索引。

​
音频和视频搜不到里面说了什么？

因为音频转写和视频转写默认是关闭的。关闭时媒体文件照常被登记进索引（所以文件名搜得到），但里面说了什么没有被转写。 去 索引管理 页的「管理」区打开「音频转写」和「视频转写」，应用会下载语音识别模型，然后自动把已有的媒体文件全部补做完——不需要重新扫描，也不需要重建索引。

索引设置

这一页讲清楚了 索引管理 页里每一个开关的作用、默认值，以及索引出问题时的完整排查路径。

​
如何让对话只针对某一篇文档？

有两种方式指定文档：
  • 从文档发起：在「资料库」里选中这篇文件，点文件上方工具栏的「与此文件对话」，或在文件上点右键选这一项。「找资料」的搜索结果上点右键也有。这样会新建一个对话，并把这篇文件放进输入框。目录和库也可以这样发起（「与此目录对话」「与此库对话」）。
  • 在输入框里用 @：在「问答」输入框里输入 @，再输入文件名的关键词，从候选里选中文件。
注意，指定只对当前这一条消息生效。消息发出后输入框会清空；追问时不重新 @ 这篇文件，AI 就会在整个资料库里检索，可能引用其他文档。另外，指定文件只是给 AI 的提示，不会限死检索范围，AI 仍可能去搜别的资料。 想让整段对话只围绕这一篇文档，可以这样做：
  1. 每次追问都重新 @ 这篇文件
  2. 在问题里写明「只根据这篇文档回答，文档里没有的就直接说没有」
被 @ 的文件要先完成索引。对话不支持上传附件，想讨论的文件要先放进资料库。

​
云端知识库能放多少文件？是按文件大小计算的吗？

按文件数量计算，不按文件大小，也没有总容量上限： 推送到云端的不是原始文件，而是 Linkly AI 从文件里提取的正文（音视频是转写文字），以及大纲和检索用的索引数据。所以几百 MB 的 PDF 和几 KB 的文本文件，都只算一个文件。 达到上限后：
  • 如果一次推送会让库里的文件数超过上限，这次推送整个不会执行，应用提示「库文件数已达上限」
  • 只修改或删除已有文件的推送不受影响
  • 已经上传的文件都保留，不会被锁住
另外，单篇文档提取出的正文超过 10 MB 时，云端不会为它建立检索索引。完整的配额说明见云端知识库。

​
没有外网的电脑（离线/内网环境）能用 AI 功能吗？

能。OCR、语音转写和语义搜索都在本机运行（AI 对话、Skills 安装等云端功能除外），只是用到的模型默认要联网下载：
  • 语义搜索和 OCR 模型约 890 MB，首次运行时下载
  • 语音转写模型约 161 MB，打开音视频转写后才下载
完全不能上网的电脑，可以先在有网的机器上下载安装包和官方离线模型包，再拷贝过去按步骤安装。

离线安装指南

要先下载什么、拷贝哪些文件、怎么执行安装——完整流程一页讲全。

​
Linux AppImage 无法启动怎么办？

Linux 发行版在基础运行库、桌面组件和驱动版本上差异很大。AppImage 会携带大部分应用依赖，但不会替换操作系统的 glibc、C++ 运行库、FUSE 和显卡驱动，因此不能保证在所有 Linux 发行版上直接运行。 Linkly AI 提供 x86_64 与 arm64（aarch64） 两种 Linux AppImage，都要求 glibc 2.35 或更高版本。先在 AppImage 所在目录执行下面这些命令：
uname -m 会显示 x86_64 或 aarch64，下载与之对应的 AppImage。最后一条命令会同时启动应用并保存终端错误，方便按下面的错误类型排查。
AppImage 没有执行权限。运行：
不要用 sudo 启动 Linkly AI，否则之后可能产生普通用户无法访问的配置和数据文件。
AppImage 通常通过 FUSE 挂载自身。请只从发行版的官方仓库安装 FUSE 2 兼容库：如果所在环境无法使用 FUSE，可以临时解压运行：
这种方式启动更慢，只绕过 FUSE，不能解决 GLIBC、架构或驱动不兼容。更多背景见 AppImage 官方 FUSE 排障指南。
这是系统基础运行库版本过旧，错误发生在 Linkly AI 真正启动之前：
  • GLIBC_x.y 来自 glibc；当前最低要求是 glibc 2.35。
  • GLIBCXX_x.y 和 CXXABI_x.y 来自系统 C++ 运行库 libstdc++。
先安装发行版提供的全部正式系统更新并重启。如果更新后仍报错，需要升级到该发行版官方支持的较新版本；仅安装 FUSE 或重新下载 AppImage 不会改变结果。
不要手动替换 /lib/.../libc.so.6，不要复制其他发行版的 glibc / libstdc++，不要混用其他发行版的软件源，也不要用 LD_LIBRARY_PATH 强行加载一套自行下载的系统运行库。这些做法可能让桌面、包管理器甚至整个系统无法启动。
下载的包和 CPU 架构不匹配。Linux AppImage 同时提供 x86_64（Linkly AI_<版本>_amd64.AppImage）和 arm64（Linkly AI_<版本>_aarch64.AppImage）两种；按 uname -m 的结果选择（x86_64 选 amd64，aarch64 选 aarch64）。修改执行权限或安装运行库不能解决架构不匹配。
这通常与 Wayland / X11、Mesa 或专有显卡驱动、桌面 portal，以及 WebKitGTK 和驱动的组合有关。先安装发行版的正式系统更新和显卡驱动更新，然后从终端再次启动并保留输出：
不建议从网上照抄未知的 WebKit、GTK 或显卡环境变量作为永久配置，因为同一个开关在不同 WebKitGTK 和驱动版本上的行为可能不同。仍无法启动时，请把下面的诊断信息和 linkly-ai-linux-startup.log 一起发给我们：
AppImage 更新需要替换当前 AppImage 文件。请把它放在当前用户可写的目录中，例如 ~/Applications，不要放在只读挂载点或由 root 拥有的系统目录：
文档可以解决缺执行权限、缺 FUSE 等问题，但不能改变二进制所需的 GLIBC 或 CPU 架构。若应用连 app.log 都没生成，以终端保存的 linkly-ai-linux-startup.log 为准。

​
有 Linux 服务器版或 Docker 版吗？

目前还没有，我们已经在筹备中。如果你有相关的想法或需求，或者想提前试用，欢迎联系我们。

联系我们

在 GitHub Issues 留言，或通过社区页面上的任意渠道找到我们。
在此之前，可以在服务器或容器里安装 Linkly AI CLI，通过局域网或远程方式访问另一台电脑上的 Linkly AI 桌面端，做法见下一节。

​
如何用 CLI 访问另一台电脑上的 Linkly AI？

Linkly AI CLI 默认只连接本机的 Linkly AI。访问另一台电脑有局域网和远程两种方式，都需要 CLI 1.0.0 或更高版本（用 linkly --version 查看版本，linkly self-update 升级）。
两台电脑在同一个网络里时使用。
1

在被访问的电脑上打开局域网访问

点主窗口左侧栏底部的 Agent 图标，进入「Agent 使用」页。在「管理」区打开「允许局域网访问」，「允许本机访问」也要保持开启。第一次打开时会自动生成令牌。
2

复制地址和令牌

在同一页的「集成」区点「查看 MCP 接入配置」，在「局域网」一节复制地址（形如 http://192.168.1.10:60606/mcp）和令牌。
3

在 CLI 所在的电脑上保存连接

在你自己的终端里运行，不要让 AI 助理代为执行：
只需保存一次，之后换终端、换 Agent 会话都不用再输入令牌。
4

使用时加上 --lan

用 linkly doctor --lan 检查连接是否正常。
需要注意：
  • CLI 只能保存一个局域网连接，再次执行 set-key --lan 会覆盖原来的。临时访问另一台电脑，可以在命令后加 --endpoint <地址> --token <令牌>，这种方式不保存。
  • 保存的连接存放在 ~/.linkly/credentials.json。
  • 局域网访问建议只在家庭、公司等可信网络中开启。令牌不要粘贴进任何 AI 对话，对话内容会发送给模型服务商、写进会话记录。令牌泄露或出现在对话里时，在「查看 MCP 接入配置」里重新生成，旧令牌立即失效。
  • 通过 Skills 使用 CLI 的 Agent（如 Claude Code）也会自动用上保存的连接，需要 CLI 1.0.0、Skills 0.9.0 或更高版本。

​
常用设置都在哪里？

打开设置：点主窗口左下角的账号图标，在菜单里选「设置」，或按 ⌘ + ,（Windows/Linux 是 Ctrl + ,）。设置按功能分页，下面这几页最常用：
  • 语言：界面显示语言
  • 开机启动：登录系统时自动启动 Linkly AI
  • 静默启动：开机启动时只驻留后台、不弹出主窗口，默认开启——这样索引和 MCP 服务都在跑，但不会打扰你
  • Linkly AI 空间：默认被索引的那个目录，可以打开或改到别处，详见 Linkly AI 空间
  • 应用数据：索引、本地模型、设置和日志的存放位置，点「打开」直达（取日志就在这里）；也可以改到其他磁盘，应用会重启并迁移数据，详见如何把应用数据迁移到其他磁盘
  • 主题：浅色 / 深色 / 跟随系统
  • 字体大小：小 / 标准 / 大，同时作用于界面和聊天内容
  • 显示 Dock 图标（macOS）：关掉之后应用只留在菜单栏托盘里，不占 Dock 位置
  • 检查更新：手动检查并下载新版本，下载完点「重启以更新」即可
  • 加入开发版体验计划：打开后会收到开发版（beta）更新，能提前用到新功能，但可能遇到未完全测试的改动
  • 还能从这里跳到更新日志、隐私政策、用户协议，以及 CLI 和 Skills 的说明
  • 全局快捷键：「搜索」唤起或隐藏启动器，「主窗口」打开主窗口。点一下就能重新录制，也可以「恢复默认」或「清除」。如果提示该组合已被占用或被系统保留，换一个即可
  • 快捷键一览：列出应用内全部快捷键。在启动器里按 ⌘ + /（Windows/Linux 是 Ctrl + /）可以直接打开这一页
「暂停索引」不在设置里。在主窗口 索引管理 页「状态」区第一张卡片上点「暂停」，或者右键点击托盘的 L 图标，选「暂停索引」。详见索引设置。

​
Linkly AI 空间的位置可以修改吗？

可以。Linkly AI 空间是存放笔记、剪藏等资料的默认文件夹。修改方法：
  1. 进入 设置 → 通用，找到「Linkly AI 空间」一行
  2. 点右侧的「更改」图标按钮，在确认框里点「继续」
  3. 选择一个文件夹，Linkly AI 会在里面新建 LinklyAI 文件夹作为新的空间。如果选的文件夹本身就叫 LinklyAI，就直接用它
修改不会搬动现有文件：旧位置的文件留在原处，继续被索引；之后新建的笔记、剪藏存到新位置。想把旧文件也放到新位置，需要自己手动移动。想改回原来的位置，点旁边的「恢复默认」。
如果修改时提示「当前目录为系统目录，请换一个目录迁移。」，说明你改的是下面一行的「应用数据」，不是 Linkly AI 空间。应用数据不能放在 Windows 等系统目录里，换一个普通文件夹即可，详见下一节。

​
如何把应用数据迁移到其他磁盘？

应用数据是 Linkly AI 存放数据库、索引、本地模型、设置和日志的文件夹，资料多时会占用几 GB。它默认在系统盘上，和软件的安装目录不是一回事：安装时选了 D 盘，应用数据仍然在下面的默认位置。 系统盘空间紧张时，可以在设置里把整个应用数据文件夹迁到其他磁盘。Linkly AI 空间是另一项设置，不会随应用数据一起迁移。

​
迁移步骤

1

打开「应用数据」设置

进入 设置 → 通用，找到「应用数据」一行。
2

选择新位置

点右侧的「更改」按钮（带笔的文件夹图标），在确认框里点「更改并重启」，然后选择一个文件夹。Linkly AI 会在这个文件夹里新建 LinklyAI\ai.linkly.desktop 存放数据。例如选择 D:\Linkly AI Data，数据会放在 D:\Linkly AI Data\LinklyAI\ai.linkly.desktop。
3

等待迁移完成

应用重启后显示进度窗口，依次复制数据、校验副本、切换到新位置，完成后自动重启。资料多时可能需要几分钟，期间请保持窗口打开，不要关机。
4

确认结果

回到 设置 → 通用 → 应用数据，这里显示的应是新路径，旁边的大小就是数据的实际占用。
新位置要满足下面的条件，不满足时会提示原因：
  • 是一个文件夹，不能是磁盘根目录（如 D:\）
  • 不能是系统目录（如 Windows 文件夹），也不能是网络驱动器或共享文件夹；Program Files 下的文件夹可以选
  • 不能和 Linkly AI 空间或任何监听文件夹重叠，也不能在当前的应用数据目录里面
  • 剩余空间至少是当前应用数据大小的 1.1 倍
  • 这个文件夹下不能已经有一个非空的 LinklyAI\ai.linkly.desktop
  • 正在下载模型时不能迁移，等下载完成再试

​
迁移后，原位置为什么还有一个文件夹？

迁移完成后，原位置的数据会被删除，原处留下一个同名的链接，指向新位置（Windows 上是目录联接，macOS 和 Linux 上是符号链接）。Linkly AI 每次启动都通过这个链接找到新位置的数据，所以它必须保留。
  • 链接不占空间。 在资源管理器里查看它的「属性」，会显示和新位置一样的大小，这是因为系统统计时把链接指向的数据也算了进来。想确认空间已经释放，看「此电脑」里系统盘的可用空间：迁移后应该多出了应用数据那么大的空间。
  • 链接和新位置看起来完全一样，内容、大小、修改时间都同步变化。这是因为打开链接看到的就是新位置的数据，并不是两份数据在互相同步。
  • Windows 上 %LOCALAPPDATA%\ai.linkly.desktop 里是应用界面的缓存，不在迁移范围内，删掉后会自动重建。
不要删除原位置的链接，也不要打开它删除里面的文件。 删除里面的文件，删掉的就是新位置上的真实数据。删除链接本身，Linkly AI 下次启动会当作全新安装，重新下载模型、从头建索引，新位置上的数据不会再被使用。
如果删掉链接后还没有再启动过 Linkly AI，用下面的命令把链接重新建上即可（把路径换成你的新位置）：
  • Windows（命令提示符）：
  • macOS（终端）：
  • Linux（终端）：
如果删掉之后已经启动过，原位置会出现一个新的空数据目录。请先停止使用，联系我们协助恢复。
  • 迁回默认位置：在「应用数据」一行点「恢复默认」（回旋箭头图标）。Linkly AI 会重启并把数据复制回默认位置，系统盘要有足够的剩余空间；复制完成后才会清理自定义位置。
  • 换到别的磁盘：再点一次「更改」，按上面的步骤选择新位置即可。
不会。在新位置的副本校验通过、应用在新位置正常启动之前，原来的数据都原样保留。迁移被中断（比如断电、强制退出）后，下次启动会显示恢复窗口，可以点「重试」继续，也可以点「取消更改，继续使用原位置」。遇到处理不了的情况，点「打开日志」，把日志发给我们。
可以，但每次使用 Linkly AI 前都要先接上这块硬盘。没接上时，启动会提示「无法访问应用数据目录」，接上后点「重试」即可。不建议把应用数据放在经常拔插的移动硬盘上。
Windows 卸载时如果勾选了「删除应用数据」，迁移到新位置的数据也会一起删除。只是想卸载后重装、保留现有数据，就不要勾选；重装后 Linkly AI 会通过链接自动找到原来的数据。

​
如何获取 Linkly AI 的应用运行日志？

应用启动后会将运行日志自动写入本地的 app.log 文件（单文件最高 10 MB，滚动覆盖）。当你向我们反馈问题或自行排查问题时，附上这份日志能极大加速定位。日志已经对敏感数据进行了脱敏。 获取日志有两种方式：

​
方式一：从应用内打开（推荐）

这是最简单的方式：
1

打开「通用」页面

在 Linkly AI 中进入 设置 → 通用。
2

打开应用数据目录

找到「应用数据」一行，点击右侧的「打开」按钮。系统会弹出存放应用数据的文件夹。
3

进入 logs 子目录取出 app.log

在该文件夹中进入 logs/ 子目录，将 app.log 发送给我们即可。

​
方式二：手工打开应用数据目录

如果应用已经崩溃或无法启动，可以直接打开磁盘上的目录：
  1. 打开 Finder。
  2. 顶部菜单选择 前往 → 前往文件夹…（或按 ⌘ + ⇧ + G）。
  3. 粘贴下面的路径并回车：
  4. 在打开的文件夹中找到 app.log，发送给我们即可。

​
应用启动时就崩溃怎么办？

如果应用启动后立刻闪退，app.log 可能还来不及写入。这种情况下崩溃信息会单独保存到诊断目录 linkly-ai-diagnostics 里的 startup-panic-<编号>.json 文件中。 下次打开 Linkly AI 时，会弹出「Linkly AI 上次未正常退出」的提示，这份崩溃信息会一起放进诊断报告。写一句崩溃前在做什么，点「发送报告」即可。 如果应用每次启动都崩溃、看不到这个提示，可以按下面的路径手动找到这个文件：
  1. 打开 Finder。
  2. 顶部菜单选择 前往 → 前往文件夹…（或按 ⌘ + ⇧ + G）。
  3. 粘贴下面的路径并回车：
  4. 在打开的文件夹中找到 startup-panic- 开头的 .json 文件，发送给我们即可。
这份文件只在启动期间崩溃时才会生成，下次正常启动、被放进诊断报告后会自动清理。如果连这份文件都没有，请截图记录闪退瞬间的画面或弹窗，并附上系统版本发送给我们。

把日志发给我们

在 GitHub Issues 提交，或通过社区页面上的任意渠道联系我们。