索引是怎么工作的
Linkly AI 的索引是分层的——不是”全做完才能用”，而是每完成一层就多一种搜索能力。1
第一层：文件名（秒级）
扫描到文件后立刻把路径和文件名写进索引。这一层几乎是瞬间完成的，所以刚添加完文件夹你就能按文件名搜到东西。
2
第二层：全文（关键词）
解析文档正文写入本地全文索引，支持关键词匹配。这一层完成后，搜”预算表”能命中正文里出现过这三个字的文档。
3
第三层：语义（向量）
用嵌入模型把正文切块转成向量。这一层完成后，搜”去年花了多少钱”也能命中标题里完全没有这几个字的财务报告。
- 文字识别 (OCR)：从图片和扫描件里认出文字
- 音频转写、视频转写：把音频和视频里的说话内容转成文本
打开索引管理页
下面几个入口都能进入 索引管理 页：- 点主窗口左侧栏底部的索引状态图标。鼠标悬停时弹出的「索引状态」卡片里，点「查看更多」也能进入
- 在主窗口「首页」的「我的知识资产」区，点显示索引状态的那张卡片（例如「搜索已就绪」「文件处理中」）
- 右键点击系统托盘的 L 图标，选择「查看索引」
「状态」怎么看
「索引」页签最上面是四张卡片：「管理」：搜索能力与解析增强
「管理」区分成两组，每一行既显示这项能力的状态，也是它的开关：
每一行右侧的状态标记有这几种：
OCR 和转写正在处理某个文件时，这一行还会显示文件名和进度（页数或时长）。
语义搜索
它做什么：开启后能让用自然语言、描述性的说法搜到文档。 默认值：开启 关掉之后搜索只用关键词。重新打开会自动补建语义索引，不需要重建。文字识别 (OCR)
它做什么：用 OCR 模型认出图片里的文字，以及把扫描版 PDF 转成结构化 Markdown。 默认值：开启 关掉之后，图片和扫描件只能按文件名搜到，它们会出现在「无法解析」页签的「需要 OCR」一类里；重新打开后会自动处理。音频转写 与 视频转写
它们做什么：用语音识别模型把音频和视频里的说话内容转成文本，然后送进全文和语义索引。 默认值：两个都是关闭 ⚠️
什么时候该动它：有会议录音、播客、课程视频要检索时打开。
「策略」：资源占用
「策略」区的三项只影响索引怎么跑，不改变索引什么。1. 性能模式
它做什么：控制后台索引可以占用多少计算资源。 默认值：自动2. 省电模式
它做什么：笔记本用电池时，暂停耗电的重任务。 默认值：关闭 电池供电时会被暂停的：- 本地 OCR，包括扫描版 PDF 转结构化 Markdown
- 本地音视频转写
- 语义索引（向量生成）
- 云端知识库的自动同步
- 数据库整理优化
3. 空闲时休眠模型
它做什么：本地 AI 模型闲置一段时间后释放内存，需要时自动重新加载。 默认值：开启 本地模型（语义嵌入、OCR、语音识别）空闲约 300 秒（5 分钟） 后自动卸载释放内存。 关闭后模型常驻内存，三个加起来约使用 1 GB 左右内存。 什么时候该动它：内存紧张（8 GB 及以下）就保持默认开启。「规则」：决定哪些文件进索引
资料夹里往往不只有你想让 AI 读的东西：成千上万张截图、几个 G 的录屏、导出的中间文件。「规则」页签用来把它们挡在索引之外，分三块。文件类型
按类型开关，分两组：
默认全部打开。关掉某个类型后，约 1 分钟内这类文件会从索引中移除，搜索、资料库和 Agent 都不再看到它们；磁盘上的文件不动。以后重新打开，这些文件会重新扫描，可能要重新识别文字或转写。
排除规则
用通配符排除一部分文件或子目录，写法和.gitignore 相同：
规则分两级：「所有资料夹」一栏对每个资料夹都生效；每个资料夹也可以单独写自己的规则。编辑时，下方会实时列出这条规则会排除哪些文件，写错了也会给出提示。
更顺手的入口在资料库里：右键文件或文件夹，选「添加排除规则…」，就会为它生成一条规则。资料库左侧目录树上，自己带排除规则的资料夹会在行尾显示一个漏斗图标，右键选「编辑排除规则…」即可修改。
排除规则只写资料夹里面的相对路径。想让整个资料夹都不索引，直接在资料库的「管理资料来源」里移除它。
内置规则
这些规则始终生效，不能关闭：- 隐藏文件和文件夹（名字以
.开头的，比如.git、.obsidian） - 系统和同步软件生成的目录
- Linkly AI 自己的应用数据
- 临时文件（Office 打开文档时生成的
~$文件、Thumbs.db） - Git 仓库里被
.gitignore忽略的文件，以及资料夹里.ignore文件列出的内容 - 不支持的格式（压缩包、安装包、代码文件等）
Linkly AI 空间里的笔记、剪藏、画布始终索引，不受类型开关和排除规则影响。
「无法解析」页签
这里列出能按文件名搜到、但正文没能进入索引的文件。这些文件无法进行全文检索和语义检索，Agent 也读不到它们的正文。 左侧按原因分类，并标出每一类的文件数；右侧是选中那一类的文件清单。大多数类别可以点「全部重试」，也可以逐个重试，重新解析并更新索引。「无法读取」一类的文件在内容变化后还会自动重试。 有三类不提供重试：「没有文字」（解析后发现文件里没有可提取的文字），以及「需要 OCR」和「转写已关闭」。后两类打开对应的开关后会自动处理。「高级」页签
硬件加速
它做什么：用 GPU 跑本地模型。关掉后全部使用 CPU，更慢但更稳。 默认值：开启- Windows / Linux：语义索引的嵌入模型在有独显时用 GPU；Windows 有独显时，扫描件文字识别的版面模型也用 GPU
- Apple 芯片的 Mac：只控制扫描件文字识别的版面模型是否使用 Apple GPU
- Windows / Linux 上，如果语义索引改用了云端模型，OCR 也用不上 GPU，这个开关就没有作用，显示为不可用
- Intel 芯片的 Mac 上没有这个开关
索引数据
- 存放位置：索引数据所在的目录，点右侧按钮可以在 Finder / 资源管理器里打开
- 占用空间：全文索引、向量与缓存合计占用的磁盘空间
索引存储优化
点「优化」会合并向量索引的碎片，回收已删除文档占用的空间，同时清理旧版本留下的提取缓存。它不影响搜索结果，磁盘占用会明显减少，搜索也会更快。 中途退出应用是安全的，不会损坏数据，下次启动后可以继续优化。已经是最优状态时，点这个按钮没有任何作用，只会提示「索引已是最优状态」，也无法手动强制重跑。
完全重建索引
这是危险操作：「重建…」按钮是红色的，点击后还要再确认一次。它会：- 删除：现有的索引数据，以及已经处理过的文档内容（含图片文字识别与音视频转写结果），删除后无法恢复
- 不删除：你的原始文件
索引状态
「状态」区第一张卡片、侧栏底部的索引图标和资料库左栏底部，显示的都是同一套状态：
「监控中」是你希望看到的最终状态。
如何暂停索引？
有两个地方可以暂停：- 索引管理页：「状态」区第一张卡片上的「暂停」按钮。暂停后按钮变成「继续索引」，点一下恢复
- 系统托盘菜单：右键点击托盘的 L 图标，菜单里有「⏸ 暂停索引」/「▶ 开始索引」（左键点击打开的是主窗口，不是菜单）
常见问题
为什么音视频文件按文件名搜得到，搜内容却搜不到？
为什么音视频文件按文件名搜得到，搜内容却搜不到？
因为音频转写和视频转写默认是关闭的。关闭时媒体文件仍然会被登记进索引（所以文件名搜得到），但里面说了什么没有被转写。在 索引管理 页的「管理」区打开「音频转写」和「视频转写」，应用会下载 161 MB 的语音识别模型，然后自动把存量文件全部补做完——不需要重新扫描，也不需要重建索引。例外：如果媒体文件旁边有同名的
.srt / .vtt 字幕，或者以前转写过缓存还在，那么开关关着也能搜到内容。扫描版 PDF / 图片里的文字搜不到？
扫描版 PDF / 图片里的文字搜不到？
先去 索引管理 页的「管理」区，看「文字识别 (OCR)」这个开关是不是关着。这个开关同时控制图片和扫描版 PDF 的文字提取，关掉它，扫描版 PDF 也会变成”只有文件名、没有正文”。如果开关是开着的，再看这一行的状态：显示「处理中」并带着「剩 N」，说明还在排队或识别中，等它处理完即可。
索引状态显示「已暂停」，进度不动？
索引状态显示「已暂停」，进度不动？
说明索引被暂停了。点「状态」区第一张卡片上的「继续索引」，或者右键点托盘图标，在菜单里点「▶ 开始索引」，都可以恢复。如果不是暂停，再到主窗口「资料库」里确认是否已经添加了你自己的目录。
语义搜索好像没生效，搜出来的结果都很「字面」？
语义搜索好像没生效，搜出来的结果都很「字面」？
按这个顺序排查：
- 索引管理 页「管理」区的「语义搜索」是不是显示「已关闭」？是的话打开即可（会自动补跑，不用重建）。
- 显示「处理中」？说明还在建向量，等它跑完。
- 两者都不是的话，去 设置 → AI 模型 → 嵌入模型 看模型是不是还在下载或者下载失败了——这种情况在搜索界面完全没有提示，搜索会静默退化成纯关键词。失败的话点卡片上的「重试」。
怎么暂停索引？
怎么暂停索引？
在 索引管理 页「状态」区第一张卡片上点「暂停」；或者右键点击托盘的 L 图标 → 「⏸ 暂停索引」。恢复也是同一个位置，按钮会变成「继续索引」，托盘菜单项会变成「▶ 开始索引」。暂停期间无法执行「完全重建索引」，需要先恢复。
索引占的磁盘空间太大了怎么办？
索引占的磁盘空间太大了怎么办？
去 索引管理 → 高级 → 维护，在「索引存储优化」一行点「优化」。它会合并向量索引的碎片、回收已删除文档占用的空间，不影响搜索结果。如果提示「索引已是最优状态」，说明没有可优化的空间，也无法强制重跑。
搜索结果不对劲，要不要重建索引？
搜索结果不对劲，要不要重建索引？
先别急。重建是最后的手段，期间搜索结果会暂时为空或不完整。按这个顺序试：
- 确认对应的开关没关（OCR / 语义搜索 / 音频转写 / 视频转写）
- 确认索引没被暂停
- 确认状态已经到了「监控中」，而不是还在「处理中」
- 看看文件是不是在「无法解析」页签里，能重试的先重试
调「性能模式」能让索引停下来吗？
调「性能模式」能让索引停下来吗？
不能。性能模式只控制索引占用多少线程、多频繁让位，不控制”要不要跑”。选「均衡」只是让它慢一点、更不打扰你。真正要停，用「状态」区第一张卡片上的「暂停」或托盘菜单的「暂停索引」。另外，「自动」模式看的是键盘鼠标是否空闲（超过 120 秒算空闲）；如果同时打开了省电模式并且正在用电池，空闲时也保持均衡。在纯 Wayland 的 Linux 桌面上拿不到空闲信号，「自动」会一直等价于「均衡」。
省电模式我开了，但好像没什么变化？
省电模式我开了，但好像没什么变化？
这是正常的。省电模式的生效条件是「开关打开 且 正在用电池供电」。插着电源、或者台式机没有电池时，它完全不起作用。正因为如此，它可以常年开着，不需要在出门前手动打开、回家后手动关掉。
索引跑起来电脑很卡怎么办？
索引跑起来电脑很卡怎么办？
按影响从小到大：
- 性能模式改成「均衡」（立即生效，正在跑的任务会按新预算重新领取）
- 临时关掉「音频转写」和「视频转写」——媒体转写是最重的任务
- 还是卡的话，点「暂停」暂停索引，等空闲时再恢复