注入方式

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

​

五个档位

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

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

Skill 文档是例外：模型只能通过注入的结构行发现 Skill，因此这一档在 Skill 上显示为不注入——等于关闭自动召回，只能通过指令触发使用。 默认档位按类型区分：Design 与 Plan 文档默认 L0 - 路径注入，Skill 文档默认 L1 - 摘要注入，Memory 与 Reference 文档默认仅搜索。Memory 的三个预设模块出厂时已按用途调好档位（错题本 L2、用户偏好 L3、项目理解 L0），见 Design 与 Memory。

​

摘要

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

​

注入 Agent

L2 - 全文注入与L3 - 全文规则注入只进入勾选的 Agent。在注入方式菜单旁的注入 Agent面板中勾选，对应 frontmatter 的 injectAgents 字段：

• 新建文档默认为所有 Agent，保存为 injectAgents: ["*"]，之后新增的 Agent 也会收到。
• * 是通配符，可匹配任意字符："*" 表示所有 Agent，"team-*" 表示 id 以 team- 开头的 Agent。YAML 中的 * 需要加引号，也可以直接写成 injectAgents: "*"。
• 没有 injectAgents 字段的文档保持原有行为，只注入 Unity Agent；已写明列表的文档按列表生效，[] 表示不注入任何 Agent。
• CSV 表格没有 frontmatter，始终按无字段处理。

路径、摘要和仅搜索档位不受 injectAgents 限制。

​

目录级配置与继承

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

​

注入状态

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

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

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