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

# 注入方式

> 五档注入的取舍、摘要的作用、目录级继承与注入状态

Agent 获取知识有两条路：常驻注入与检索。常驻注入的内容进入每一次请求的上下文窗口，Agent 不需要检索就能看到，但注入越多 token 成本越高；检索按需读取，几乎不增加常驻成本。`注入方式`用来为每份文档在两者之间选择档位。

<img src="https://mintcdn.com/farlocus/OfAb3Fo_I43YNcC0/images/showcases/knowledge.png?fit=max&auto=format&n=OfAb3Fo_I43YNcC0&q=85&s=231d1c19bf1727ec2fa2cac2448e5034" alt="img" width="1280" height="739" data-path="images/showcases/knowledge.png" />

## 五个档位

在文档的`配置`侧栏中设置`注入方式`：

* **`仅搜索`**：只参与检索与召回，不主动进入 Agent 上下文。适合数量大、只在特定任务用到的资料。
* **`L0 - 路径注入`**：向 Agent 提供文档标题与路径，正文按需读取。适合让 Agent 知道「存在这份文档、在哪里」。
* **`L1 - 摘要注入`**：向 Agent 提供摘要；没有摘要时使用正文前段。适合希望 Agent 时刻记得要点、细节按需展开的文档。
* **`L2 - 全文注入`**：将维护规则与正文作为常驻知识注入。适合篇幅可控、几乎每个任务都要参照的内容。
* **`L3 - 全文规则注入`**：将维护规则与正文完整注入为规则，适合高优先级的长期约束，例如必须遵守的项目规范。

默认档位按类型区分：Design 文档默认 `L0 - 路径注入`，Skill 文档默认 `L1 - 摘要注入`，Memory 与 Reference 文档默认`仅搜索`。Memory 的三个预设模块出厂时已按用途调好档位（错题本 L2、用户偏好 L3、项目理解 L0），见 [Design 与 Memory](/knowledge/memory-and-design)。

## 摘要

`L1 - 摘要注入`实际注入的是文档的`摘要`字段，未填写时退回正文前段。正文前段往往是背景铺垫而非结论，对常驻注入的关键文档建议手写摘要：用两三句话说清这份文档覆盖什么、什么情况下应该展开读全文。摘要同时用于搜索结果预览。

## 目录级配置与继承

右键目录选择`目录配置`，可以为整个目录设置注入方式（`仅搜索` / `L0` / `L1`，L1 会在目录路径后附带目录说明）。文档与子目录默认`继承父目录`，顶层目录沿用分类默认配置；配置面板中的`当前生效`会标明实际生效的配置来自本地配置、父目录还是分类默认配置。整理成批文档时，优先在目录层级设置，再对个别文档单独覆盖。

## 注入状态

两处可以核对实际注入情况：

* 目录检查页的`注入状态`：显示子树内的`注入文档`篇数与`注入体积`。常驻注入没有硬性上限，体积增长会直接推高每次请求的成本，明显膨胀时应下调部分文档的档位或精简内容。
* 顶部的`注入预览`：展示当前 Agent 实际注入的 Knowledge 内容块与`预估 Token 消耗`。想确认会话里 Agent 到底带了什么，以这里为准。

档位没有标准答案，只有取舍：L2/L3 换来的是 Agent 每次都看得见，付出的是每次请求都要为它付费。一个实用的检查习惯是定期打开[知识总览](/knowledge/index)的`上下文负担`卡片，常驻部分明显膨胀时，把低频文档降回 `L1` 或`仅搜索`。
