# 知识库

> 项目的知识库：位于 .ai-game-dev/knowledge/ 下的 Markdown 笔记，随项目一起提交，被索引为图谱并可供智能体搜索。智能体会记录设计决策与约定，把笔记整理进空间，在移动时修正链接并找出失效链接；桌面应用以 3D 图谱展示这些笔记。

- ID: `aigd.knowledge`
- 来源: 官方 (第一方 `aigd.*`)
- 分类: 3D
- 发布者: AI Game Dev (`aigd`), 已验证
- 最新版本: 0.3.22 (发布于 2026-11-22)
- 许可证: Apache-2.0
- 需要 AI Game Dev 应用: `>=0.25.11`
- 原生代码: 否
- 评分: 暂无评分
- HTML 页面: https://ai-game.dev/zh-hans/packages/aigd.knowledge

## 安装

使用 gamedev CLI，在项目文件夹中运行：

```bash
gamedev pkg add aigd.knowledge
```

在桌面应用中：打开 Packages 窗口（状态栏中的包图标），选择 **Browse**，搜索 `aigd.knowledge`，然后点击 **Add to Project**。更多：https://ai-game.dev/docs/wiki/app/packages

## 版本

| 版本 | 发布时间 | 需要应用 | 备注 |
|---|---|---|---|
| 0.3.22 | 2026-11-22 | `>=0.25.11` | 最新 |
| 0.3.21 | 2026-11-19 | `>=0.25.11` | - |
| 0.3.20 | 2026-11-13 | `>=0.25.11` | - |
| 0.3.19 | 2026-11-13 | `>=0.25.11` | - |
| 0.3.18 | 2026-11-06 | `>=0.25.11` | - |
| 0.3.17 | 2026-11-02 | `>=0.25.11` | - |
| 0.3.16 | 2026-11-01 | `>=0.25.11` | - |
| 0.3.15 | 2026-11-01 | `>=0.25.11` | - |
| 0.3.7 | 2026-10-15 | `>=0.22.0` | - |
| 0.3.6 | 2026-10-13 | `>=0.22.0` | - |
| 0.3.5 | 2026-10-12 | `>=0.22.0` | - |
| 0.3.4 | 2026-10-11 | `>=0.22.0` | - |
| 0.3.3 | 2026-10-09 | `>=0.22.0` | - |
| 0.3.2 | 2026-10-07 | `>=0.22.0` | - |
| 0.2.1 | 2026-10-05 | `>=0.20.0` | - |

## 描述

````markdown
# 知识库（`aigd.knowledge`）

面向 AI Game Dev 智能体的项目知识库：`.ai-game-dev/knowledge/` 下的 Markdown 笔记，随项目一起提交，并通过 git 与团队共享。本包把笔记及其链接索引为图谱，为智能体提供浏览、搜索、链接和整理笔记的工具，并在 3D 窗口中显示图谱。它适合希望把设计决策、约定以及系统如何运作记录在人和智能体都能找到的地方的游戏团队。

## 你可以做什么

- 让智能体在工作过程中把设计决策及其理由、约定和不易察觉的坑，记录到正确的主题空间中。
- 询问智能体团队对某个系统做出了什么决定；它可以搜索笔记来回答。
- 把笔记整理进空间（带 `README.md` 的文件夹），并在不破坏链接的前提下移动或重命名笔记和文件夹。
- 找出失效链接和孤立笔记，并在图谱中查看各部分的连接关系。
- 你也可以在 3D 图谱窗口或桌面端的侧边面板预览中浏览笔记。

## 示例请求

- “记下来：我们为战斗系统选择了固定的 60 Hz 物理步长，以及原因。”
- “知识库中关于我们的存档格式是怎么说的？”
- “为物品栏系统创建一个空间，并把物品相关的笔记移进去。”
- “检查知识库中的失效链接并修复它们。”
- `/kb systems`（知识库的统计与失效链接，以及 `systems` 空间的目录树）

## 工作方式

笔记都是 `<project>/.ai-game-dev/knowledge/` 下的纯 Markdown 文件，因此与你的游戏一同纳入版本控制。**空间**是一个带有 `README.md` 的文件夹：先是一个 `# Title`，然后是一段描述。笔记之间用从知识库根目录算起的路径互相链接，例如 `[Combat](/systems/combat.md)`；相对链接和 wikilink（`[[Combat]]`）也会被索引。

智能体在其指令中会看到顶层空间的列表，并逐层向下进入单个空间。它用普通的文件工具读写笔记，其余操作则使用以下工具：

| 工具 | 作用 |
|---|---|
| `kb_space_get` | 打开一个空间：其描述、子空间和笔记。 |
| `kb_space_create` | 创建一个空间：一个带有 `README.md` 的文件夹（标题和描述）。 |
| `kb_search` | 按标题、路径和正文对笔记进行排序搜索，并返回摘要片段。 |
| `kb_links` | 某条笔记或某个文件夹中所有笔记的出链、反向链接和失效链接。 |
| `kb_move` | 移动或重命名笔记或文件夹，并重写所有指向它的链接。 |
| `kb_lint` | 失效链接、孤立笔记、约定问题和提示。 |

智能体会被告知只记录重要且持久的知识（决策及其理由、约定、系统如何运作、不易察觉的坑），先搜索、更新已有笔记而不是重复创建，并且每个事实都要以你说过的话或代码所显示的内容为依据。

本包提供：

- **知识库**能力，默认开启；
- `/kb [folder or note]` 命令（CLI 和桌面端）：笔记、文件夹、链接、失效链接和孤立笔记，然后是目录树；
- 在桌面端：3D 图谱窗口（可从状态栏、会话的工具菜单，或在文件浏览器中对笔记或文件夹选择“在知识库图谱中打开”进入）、右侧面板中的知识库视图，以及指向它的提示。智能体写笔记时，图谱会实时更新。

## 环境要求

- AI Game Dev 0.25.11 或更高版本。图谱窗口和侧边面板是桌面应用的一部分。
- 一个项目文件夹；使用 `git` 与团队共享笔记。

## 许可

Apache-2.0.
````
