Skip to main content
Linkly AI 默认索引资料夹里所有支持的文件。不想要的部分，有两种办法挡在索引外面：
  • 文件类型开关：整类关掉，比如图片、视频，对所有资料夹生效。
  • 排除规则：写法和 .gitignore 相同，按名字或路径排除一部分文件和文件夹。
两者都在「索引管理」页的 规则 页签里：点左侧栏底部的索引状态打开「索引管理」，再切到「规则」。 被排除的文件会从索引中移除，搜索、资料库、AI 对话和接入的 Agent 都不会再看到它们。磁盘上的文件不动。

​
文件类型开关

一共 10 类，分「文档」和「图片与音视频」两组：PDF、Word 文档、Markdown 与纯文本、网页、电子书、表格、演示文稿、图片、音频、视频。每一行后面是这类文件当前的数量。
  • 关闭：这类文件不再扫描、不入库、不计入统计；已经在索引里的，约 1 分钟后移除。关闭前会弹出确认。
  • 重新打开：下一次扫描把它们收回来，重新建立索引。之前识别出的文字、转写结果还在缓存里的，直接复用；缓存已经清掉的，图片要重新识别文字，音视频要重新转写，文件多时要等一阵。
只是不想识别图片里的文字、但还想按文件名搜到图片，不要关图片类型，去「索引」页签的「解析增强」里关掉文字识别（OCR）。反过来，关掉图片类型以后，OCR 只再处理扫描版 PDF，以及 Notes、Clips、Canvas 目录里的图片。
关掉音频或视频类型后，「解析增强」里对应的转写开关会变成灰色。

​
排除规则

「规则」页签里，「所有资料夹」有一份规则，每个资料夹也各有一份。点「编辑」或「添加规则」打开规则编辑框。 也可以在 资料库 里右键一个文件或文件夹，选「添加排除规则…」：编辑框会打开，并预填一条只匹配这一项的规则。资料夹已经有规则时，右键菜单里还有「编辑排除规则…」；资料库里，规则直接写出的文件夹，它的上一级文件夹名后面会有一个漏斗图标，点它也能打开编辑框。

​
写法

和 .gitignore 相同，一条一行： 几处细节：
  • * 匹配同一层里的任意字符，? 匹配一个字符，[abc] 匹配括号里的任意一个字符，** 单独占一层时匹配任意多层。? 和 […] 只能匹配英文字母、数字和常见符号，匹配不了中文、带重音的字母等，这些请用 *。
  • 结尾带 / 只匹配文件夹。
  • 规则从上往下套用，命中的最后一条说了算，所以例外规则要写在它要找回的规则后面。
  • 文件夹被排除后，里面的文件不能用 ! 单独找回。想排除一个文件夹、只留其中一两个文件，写成 草稿/* 加 !草稿/重要.md。
  • 英文字母 A 到 Z 不区分大小写：*.PNG 和 *.png 一样。在区分大小写的 Linux 文件系统上也是如此，Draft/ 同样会排除 draft/。带重音的字母等其他字母，大小写要和名字一致：Été/ 不会排除 été/。
  • \ 一律当作 /，所以不能用反斜杠转义；名字里的 *、?、[、{、} 要写成 [*]、[?]、[[]、[{]、[}]（{a,b} 表示 a 或 b）。
  • 路径从资料夹根目录写起，不要写完整的磁盘路径。

​
所有资料夹与单个资料夹

每个资料夹先套用「所有资料夹」的规则，再套用自己的规则。所以资料夹自己的规则可以用 ! 找回被「所有资料夹」规则排除的文件。 资料夹之间有嵌套时（比如同时添加了 资料 和 资料/项目A），里面的文件只按最深的那个资料夹的规则判断。

​
规则编辑框

  • 输入规则时，下方马上告诉你这条规则写得对不对、会排除多少个文件；写法有问题时会给出「改成 …」的建议。
  • 下方的预览列出具体是哪些文件。点列表里的一条规则，预览只列出它排除的文件。
  • 可以把多行规则整段粘贴进输入框，会按行拆开、逐条检查。
  • 保存后会提示有多少个文件将从索引中移除，并给出 10 秒的「撤销」。

​
什么时候生效

保存后约 1 分钟，被排除的文件才会从索引中移除，这段时间里还能搜到它们。这样「撤销」和来回修改规则都不需要重新处理任何文件。放开规则后，下一次扫描就会把文件收回来，并重新解析。 被排除的文件如果已经推送到云端知识库，下次同步时云端的对应文件也会删除。开着自动同步时，一次要删的较多会暂停同步，等你手动推送确认；手动推送会直接删除。

​
资料夹里的 .ignore 文件

规则也可以写在文件里：在资料夹里放一个名为 .ignore 的文件，写法和 .gitignore 相同。
  • 放在哪一层，就对那一层和它下面的内容生效。
  • 不需要 Git 仓库。
  • .gitignore 只在 Git 仓库里生效；.ignore 在任何文件夹里都生效。
  • 匹配方式和 .gitignore 完全一样：区分大小写，\ 是转义符，所以路径只能用 /。
  • 改了 .ignore 不会触发扫描：已经在索引里的文件，要等下一次全量扫描（比如重启 Linkly AI）才会移除。
适合需要跟着文件夹走的规则，比如项目自带的导出目录。

​
内置规则

下面这些始终生效，不能关闭，「规则」页签底部也列着：
  • 隐藏文件和文件夹：名字以 . 开头的，比如 .git、.obsidian、.DS_Store
  • 系统和同步软件生成的目录：node_modules、__pycache__、#recycle、#SynoRecycle、@eaDir、@Recycle、$RECYCLE.BIN、System Volume Information
  • 内置数据文件：Linkly AI 自己的索引、设置和日志等应用数据（ai.linkly.desktop 文件夹）
  • 临时文件：Office 打开文档时生成的 ~$ 文件、Thumbs.db
  • Git 仓库里被 .gitignore 忽略的文件
  • 资料夹里 .ignore 文件写的规则
  • 不支持的格式，比如压缩包、安装包、代码文件
你写的规则只能在这些之外再排除，不能把它们挡掉的文件找回来。
Linkly AI 空间里的 Notes、Clips、Canvas 三个目录始终索引，不受类型开关和排除规则影响——笔记搜索、标签、Agent 读取笔记都依赖它们在索引里。

​
让 Agent 帮你写规则

规则保存在 Linkly AI 配置文件 config.json 的 indexScope 字段里，是纯文本，Agent 可以直接读。 想让 Agent 帮忙写规则时，告诉它你想排除什么、让它给出规则文本，再把整段文本粘贴进规则编辑框，逐条检查后保存。
不要让 Agent 直接修改 config.json：应用运行时不会重新读取这个文件，下一次保存设置时，它的修改会被覆盖。如果在那之前重启了应用，改动会在启动时直接生效，不经过编辑框的检查，没有 1 分钟的等待，也不能撤销。
Agent 用 list 浏览一个文件夹时，如果里面没有已索引的文件，提示里会说明可能是被索引规则排除了；explore 的概览也会写明哪些类型没有索引、有几个资料夹设了规则。

​
常见问题

正常。为了能撤销，开关或规则最后一次改动约 1 分钟后，被排除的文件才会从索引中移除。之后搜索和资料库里就看不到了。
因为 草稿/ 把整个文件夹排除了：被排除的文件夹不会再被扫描，里面的文件不能单独找回。改成 草稿/* 加 !草稿/重要.md。
旧版本不认识规则字段，启动时会重写配置文件，规则随之丢失，被排除的文件会重新进入索引。重新升级后，需要再设置一次。

​
延伸阅读