> ## Documentation Index
> Fetch the complete documentation index at: https://linkly.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# 索引范围

> 决定哪些文件进索引：整类关掉不需要的文件类型，或者像 .gitignore 那样用规则排除一部分文件和文件夹。

Linkly AI 默认索引资料夹里所有支持的文件。不想要的部分，有两种办法挡在索引外面：

* **文件类型开关**：整类关掉，比如图片、视频，对所有资料夹生效。
* **排除规则**：写法和 `.gitignore` 相同，按名字或路径排除一部分文件和文件夹。

两者都在「索引管理」页的 **规则** 页签里：点左侧栏底部的索引状态打开「索引管理」，再切到「规则」。

被排除的文件会从索引中移除，搜索、资料库、AI 对话和接入的 Agent 都不会再看到它们。**磁盘上的文件不动。**

***

## 文件类型开关

一共 10 类，分「文档」和「图片与音视频」两组：PDF、Word 文档、Markdown 与纯文本、网页、电子书、表格、演示文稿、图片、音频、视频。每一行后面是这类文件当前的数量。

* **关闭**：这类文件不再扫描、不入库、不计入统计；已经在索引里的，约 1 分钟后移除。关闭前会弹出确认。
* **重新打开**：下一次扫描把它们收回来，重新建立索引。之前识别出的文字、转写结果还在缓存里的，直接复用；缓存已经清掉的，图片要重新识别文字，音视频要重新转写，文件多时要等一阵。

> [!NOTE]
>
> 只是不想识别图片里的文字、但还想按文件名搜到图片，不要关图片类型，去「索引」页签的「解析增强」里关掉文字识别（OCR）。反过来，关掉图片类型以后，OCR 只再处理扫描版 PDF，以及 `Notes`、`Clips`、`Canvas` 目录里的图片。

关掉音频或视频类型后，「解析增强」里对应的转写开关会变成灰色。

## 排除规则

「规则」页签里，「所有资料夹」有一份规则，每个资料夹也各有一份。点「编辑」或「添加规则」打开规则编辑框。

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

### 写法

和 `.gitignore` 相同，一条一行：

| 规则 | 排除什么 |
| - | - |
| `*.csv` | 任意位置的 `.csv` 文件 |
| `草稿/` | 任意层级叫「草稿」的文件夹 |
| `/草稿/` | 只排除资料夹根目录下的「草稿」，更深层的同名文件夹不受影响 |
| `项目A/导出/` | 中间带 `/` 的规则从资料夹根目录开始匹配：只排除这一个文件夹 |
| `**/临时/**` | 任意层级「临时」文件夹里的全部内容 |
| `!重要.md` | 例外：前面的规则排除了它，这一条把它找回来 |

几处细节：

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

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

每个资料夹先套用「所有资料夹」的规则，再套用自己的规则。所以资料夹自己的规则可以用 `!` 找回被「所有资料夹」规则排除的文件。

资料夹之间有嵌套时（比如同时添加了 `资料` 和 `资料/项目A`），里面的文件只按最深的那个资料夹的规则判断。

### 规则编辑框

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

### 什么时候生效

保存后约 1 分钟，被排除的文件才会从索引中移除，这段时间里还能搜到它们。这样「撤销」和来回修改规则都不需要重新处理任何文件。放开规则后，下一次扫描就会把文件收回来，并重新解析。

被排除的文件如果已经推送到[云端知识库](/docs/zh/use-cloud-library)，下次同步时云端的对应文件也会删除。开着自动同步时，一次要删的较多会暂停同步，等你手动推送确认；手动推送会直接删除。

## 资料夹里的 .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` 文件写的规则
* 不支持的格式，比如压缩包、安装包、代码文件

你写的规则只能在这些之外**再排除**，不能把它们挡掉的文件找回来。

> [!NOTE]
>
> [Linkly AI 空间](/docs/zh/linkly-space)里的 `Notes`、`Clips`、`Canvas` 三个目录始终索引，不受类型开关和排除规则影响——笔记搜索、标签、Agent 读取笔记都依赖它们在索引里。

## 让 Agent 帮你写规则

规则保存在 Linkly AI 配置文件 `config.json` 的 `indexScope` 字段里，是纯文本，Agent 可以直接读。

想让 Agent 帮忙写规则时，告诉它你想排除什么、让它给出规则文本，再把整段文本粘贴进规则编辑框，逐条检查后保存。

> [!WARNING]
>
> 不要让 Agent 直接修改 `config.json`：应用运行时不会重新读取这个文件，下一次保存设置时，它的修改会被覆盖。如果在那之前重启了应用，改动会在启动时直接生效，不经过编辑框的检查，没有 1 分钟的等待，也不能撤销。

Agent 用 `list` 浏览一个文件夹时，如果里面没有已索引的文件，提示里会说明可能是被索引规则排除了；`explore` 的概览也会写明哪些类型没有索引、有几个资料夹设了规则。

## 常见问题

> **关掉一个类型后，文件还能搜到？**
>
> 正常。为了能撤销，开关或规则最后一次改动约 1 分钟后，被排除的文件才会从索引中移除。之后搜索和资料库里就看不到了。

> **为什么 !草稿/重要.md 没有生效？**
>
> 因为 `草稿/` 把整个文件夹排除了：被排除的文件夹不会再被扫描，里面的文件不能单独找回。改成 `草稿/*` 加 `!草稿/重要.md`。

> **降级到旧版本后，规则没了？**
>
> 旧版本不认识规则字段，启动时会重写配置文件，规则随之丢失，被排除的文件会重新进入索引。重新升级后，需要再设置一次。

***

## 延伸阅读

* [索引设置](/docs/zh/indexing) —— 索引的各个开关与排查路径
* [常见问题](/docs/zh/faq) —— 连文件名都搜不到时怎么排查
* [Linkly AI 空间](/docs/zh/linkly-space) —— 笔记、剪藏、画布存放的位置


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.