> ## 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 的项目知识库。所有知识以 Markdown 文档形式存放，按用途分为四类，统一参与检索与注入。Agent 依赖这些内容理解项目背景，不需要在每次会话里重新解释。

<img src="https://mintcdn.com/farlocus/OfAb3Fo_I43YNcC0/images/overview/page-tour/knowledge-types.png?fit=max&auto=format&n=OfAb3Fo_I43YNcC0&q=85&s=326337ae9abcdcf94c389d70502d618a" alt="img" width="2021" height="1325" data-path="images/overview/page-tour/knowledge-types.png" />

## 四类知识

* **Design（项目设计）**：记录项目设计需求与事实基准，解决「Agent 不知道你要什么」的问题。AI 可从会话中总结更新（需审批），后续任务会把其中内容视为需求依据。
* **Memory（长期记忆）**：由 AI 自动维护的经验性信息，解决「每次会话都从零开始」的问题。默认预设`项目理解`、`错题本`、`用户偏好`三个模块。
* **Skill（标准流程）**：把高频工作流固化为文档，解决「同类任务每次都要重新交代」的问题。可通过 / 指令或自动召回触发。
* **Reference（参考资料）**：外部只读资料库，解决「Agent 需要项目之外的资料」的问题。支持导入本地文件夹、Unity 官方文档与飞书文档。

前两类的维护方式见 [Design 与 Memory](/knowledge/memory-and-design)，后两类见 [Skill 与 Reference](/knowledge/skills-and-references)。

## 目录树与徽标

左侧目录树按类型组织文档，支持右键新建、重命名、移动与删除。条目上的徽标标记文档状态，树顶部的`徽标说明`可随时查阅：

* **`AUTO`**：文档由 AI 自动维护。
* **`LX` / `SM`**：该目录已开启全文 / 语义检索，见[检索与索引](/knowledge/retrieval)。
* **`外部`**：内容来自外部导入（本地文件夹 / 飞书 / Unity 文档等），只读。
* **/ 指令徽标**：可在会话中通过 / 指令触发（Skill 文档）。
* **插件徽标**：内容由插件提供，无法重命名、移动或删除，见[插件与视图](/extensions/plugins-and-views)。
* **Skill 包徽标**：内容由 Skill 包提供，只读。

## 总览统计

选中某个知识类型时，右侧显示该类型的总览卡片：

* **`检索索引`**：合并展示全文与语义两条检索通道。全文侧显示覆盖率与`最新` / `需刷新` / `待处理`状态，语义侧显示覆盖率与索引健康度，用于确认 Agent 能不能检索到这些文档。
* **`知识内容新鲜度`**：统计已索引文档中最新、需刷新与状态未知的比例。需刷新的文档在下次索引后恢复最新。
* **`上下文负担`**：估算常驻注入的上下文压力（CJK 按 1 字 ≈ 1 token、其余按 4 字符 ≈ 1 token），分为知识概览、Memory、Auto Skill 与检索语料几部分，用于判断知识体系给每次请求增加的 token 成本。

前两张卡片回答「找不找得到」，第三张回答「代价有多大」。知识文档并非越多越好：常驻注入直接占用上下文窗口，检索覆盖则几乎免费。控制注入总量、把大部分内容交给检索，是维护知识库的基本原则，具体档位见[注入方式](/knowledge/injection)。
