本頁面由英文機器翻譯而成。閱讀英文原文。

Knowledge Base

官方3Dv0.3.22aigd.knowledge
安裝 還沒安裝應用程式?免費下載
或在終端機中執行
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.

版本

Knowledge Base 的發布版本
版本發布日期需搭配應用程式
0.3.22最新0.25.11 或更新版本
0.3.210.25.11 或更新版本
0.3.200.25.11 或更新版本
0.3.190.25.11 或更新版本
0.3.180.25.11 或更新版本
0.3.170.25.11 或更新版本
0.3.160.25.11 或更新版本
0.3.150.25.11 或更新版本
0.3.70.22.0 或更新版本
0.3.60.22.0 或更新版本
0.3.50.22.0 或更新版本
0.3.40.22.0 或更新版本
0.3.30.22.0 或更新版本
0.3.20.22.0 或更新版本
0.2.10.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