Knowledge Base
gamedev pkg add aigd.knowledge總覽
專案的 Knowledge Base:放在 .ai-game-dev/knowledge/ 的 Markdown 筆記,隨專案一起提交,會建立成圖形索引並供 agent 搜尋。Agent 會記錄設計決策與慣例、把筆記整理成空間、在搬移時修正連結並找出失效連結;桌面應用程式則以 3D 圖形呈現這些筆記。
專案中給 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.
版本
| 版本 | 發布日期 | 需搭配應用程式 |
|---|---|---|
| 0.3.22最新 | 0.25.11 或更新版本 | |
| 0.3.21 | 0.25.11 或更新版本 | |
| 0.3.20 | 0.25.11 或更新版本 | |
| 0.3.19 | 0.25.11 或更新版本 | |
| 0.3.18 | 0.25.11 或更新版本 | |
| 0.3.17 | 0.25.11 或更新版本 | |
| 0.3.16 | 0.25.11 或更新版本 | |
| 0.3.15 | 0.25.11 或更新版本 | |
| 0.3.7 | 0.22.0 或更新版本 | |
| 0.3.6 | 0.22.0 或更新版本 | |
| 0.3.5 | 0.22.0 或更新版本 | |
| 0.3.4 | 0.22.0 或更新版本 | |
| 0.3.3 | 0.22.0 或更新版本 | |
| 0.3.2 | 0.22.0 或更新版本 | |
| 0.2.1 | 0.20.0 或更新版本 |
安裝
在桌面應用程式中
開啟 套件 視窗(狀態列上的套件圖示),選擇 瀏覽,搜尋 aigd.knowledge,然後點選 加到專案。
還沒安裝應用程式?免費下載 AI Game Dev,支援 Windows、macOS 與 Linux。
從終端機
在你的專案資料夾中,使用 gamedev CLI:
gamedev pkg add aigd.knowledge需求
- AI Game Dev 0.25.11 或更新版本
gamedev pkg add aigd.knowledge