# Knowledge Base

> 專案的 Knowledge Base：放在 .ai-game-dev/knowledge/ 的 Markdown 筆記，隨專案一起提交，會建立成圖形索引並供 agent 搜尋。Agent 會記錄設計決策與慣例、把筆記整理成空間、在搬移時修正連結並找出失效連結；桌面應用程式則以 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-hant/packages/aigd.knowledge

## 安裝

在專案資料夾中，使用 gamedev CLI：

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

在桌面應用程式中：開啟「套件」視窗（狀態列上的套件圖示），選擇 **瀏覽**，搜尋 `aigd.knowledge`，然後點 **加入專案**。更多資訊：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
# 知識庫 Knowledge Base（`aigd.knowledge`）

專案中給 AI Game Dev agent 使用的 Knowledge Base：`.ai-game-dev/knowledge/` 裡的 Markdown 筆記，隨專案一起提交，並透過 git 與團隊共享。這個套件會把筆記與它們之間的連結索引成圖形，提供 agent 瀏覽、搜尋、連結與整理筆記的工具，並在 3D 視窗中顯示這張圖。它適合希望把設計決策、慣例以及系統運作方式寫下來、讓人與 agent 都找得到的遊戲團隊。

## 你可以做什麼

- 讓 agent 在你工作時，把設計決策與其理由、慣例，以及不容易察覺的陷阱記錄到正確的主題空間。
- 問 agent 團隊對某個系統做了什麼決定；它會搜尋筆記來回答。
- 把筆記整理成空間（含有 `README.md` 的資料夾），並在搬移或重新命名筆記與資料夾時不破壞連結。
- 找出失效連結與孤立筆記，並在圖形中看出所有東西如何串連。
- 在 3D 圖形視窗或桌面應用程式的側邊面板預覽中，自己瀏覽這些筆記。

## 範例請求

- 「寫下我們為戰鬥系統選了固定 60 Hz 的物理步長，以及為什麼。」
- 「Knowledge Base 對我們的存檔格式有什麼說法？」
- 「為物品欄系統建立一個空間，並把道具筆記搬進去。」
- 「檢查 Knowledge Base 有沒有失效連結並修正。」
- `/kb systems`（Knowledge Base 的統計總數與失效連結，以及 `systems` 空間的樹狀結構）

## 運作方式

這些筆記是 `<project>/.ai-game-dev/knowledge/` 底下的純 Markdown 檔案，因此能和你的遊戲一起放在版本控制裡。**空間**是含有 `README.md` 的資料夾：先是 `# Title`，接著是一段文字的描述。筆記之間以從 Knowledge Base 根目錄算起的路徑互相連結，例如 `[Combat](/systems/combat.md)`；相對連結與 wikilink（`[[Combat]]`）也會被索引。

agent 會在其指示中看到最上層空間的清單，並一次往下一層走一個空間。它用一般的檔案工具讀寫筆記，其餘則使用這些工具：

| 工具 | 功能 |
|---|---|
| `kb_space_get` | 開啟一個空間：其描述、子空間與筆記。 |
| `kb_space_create` | 建立一個空間：含有 `README.md` 的資料夾（標題與描述）。 |
| `kb_search` | 依標題、路徑與文字對筆記做排序搜尋，並附上摘要片段。 |
| `kb_links` | 某則筆記（或某個資料夾中所有筆記）的外連連結、反向連結與失效連結。 |
| `kb_move` | 搬移或重新命名筆記或資料夾，並改寫所有指向它的連結。 |
| `kb_lint` | 失效連結、孤立筆記、慣例問題與提示。 |

agent 被要求只記錄重要且長久適用的知識（決策與其理由、慣例、系統的運作方式、不容易察覺的陷阱），先搜尋並更新既有筆記而不是重複建立，而且每一項事實都要以你說過的內容或程式碼所示為依據。

這個套件提供：

- **Knowledge Base** 能力，預設開啟；
- `/kb [folder or note]` 指令（CLI 與桌面版）：筆記、資料夾、連結、失效連結與孤立筆記，然後是樹狀結構；
- 在桌面應用程式中，有 3D 圖形視窗（可從狀態列、工作階段的工具選單，或在檔案總管中對筆記或資料夾選擇「在 Knowledge Base 圖形中開啟」），右側面板有 Knowledge Base 檢視，還有一個指向它的提示。agent 撰寫筆記時，圖形會即時更新。

## 需求

- AI Game Dev 0.25.11 或更新版本。圖形視窗與側邊面板屬於桌面應用程式的一部分。
- 一個專案資料夾；以及 `git`，用來與團隊共享筆記。

## 授權

Apache-2.0.
````
