Skip to main content
The Knowledge page manages the Agent’s project knowledge base. Everything in it is a Markdown document, grouped into four types by purpose, and all of it participates in retrieval and injection. The Agent relies on this content to understand the project background, so you do not have to explain it again in every session. img

The four types

  • Design (project docs): records design requirements and the factual baseline, so the Agent knows what you want. The AI can propose updates summarized from your sessions (approval required), and later tasks treat the content as the requirements basis.
  • Memory (long-term): experiential notes the AI maintains automatically, so sessions stop starting from zero. Three preset modules by default: Project Understanding, Mistake Notebook, and User Preferences.
  • Skill (workflow): high-frequency workflows written down as documents, so the same kind of task needs no fresh briefing every time. Triggered with a / command or recalled automatically.
  • Reference (external): a read-only library for material from outside the project, for when the Agent needs sources the project itself does not contain. Imports local folders, the official Unity documentation, and Feishu docs.
Maintenance of the first two types is covered in Design and Memory, the last two in Skill and Reference.

Tree and badges

The tree on the left organizes documents by type; right-click to create, rename, move, or delete. Badges on each entry mark document state, and Badge Legend at the top of the tree lists them all:
  • AUTO: the document is maintained automatically by the AI.
  • LX / SM: full-text or semantic retrieval is enabled for this directory. See Retrieval and indexing.
  • EXT: content imported from an external source (local folder, Feishu, Unity docs, and so on), read-only.
  • /cmd: a Skill document that can be triggered in chat with a / command.
  • Plugin badge: content provided by a plugin; it cannot be renamed, moved, or deleted. See Plugins and views.
  • Skill package badge: content provided by a Skill package, read-only.

Overview stats

Selecting a knowledge type shows that type’s overview cards on the right:
  • Search Index: both retrieval channels, full-text and semantic, in one card. The full-text side shows coverage and the Fresh / Stale / Pending states; the semantic side shows coverage and index health. Use it to confirm the Agent can actually retrieve these documents.
  • Knowledge Freshness: the share of indexed documents that are fresh, need a refresh, or have unknown status. Documents needing a refresh return to fresh after the next indexing pass.
  • Context Load: estimates always-on context pressure (about 1 token per CJK character, 4 characters per token otherwise), split into Knowledge Overview, Memory, Auto Skill, and Retrieval Corpus. Use it to judge the token cost the knowledge system adds to every request.
The first two cards answer whether content can be found; the third answers what it costs. More knowledge documents are not automatically better: always-on injection consumes the context window directly, while retrieval coverage is close to free. Keeping the injected total small and leaving most content to retrieval is the basic principle of knowledge base maintenance. The levels are described in Injection modes.