知識圖譜
知識圖譜儲存專案中實體間的結構化關係。與扁平的記憶不同，它擷取事物之間的關聯——哪些服務依賴什麼、誰負責哪些元件、架構決策如何演變。
核心概念
事實（三元組）
每個關係都是一個「主體 - 謂詞 - 客體」的三元組。
信心度
每筆事實都有一個信心度分數（0-1）。高信心度表示已確認的事實；較低分數表示假設或可能變更的早期決策。
時間有效性
事實可以被標記為失效而不被刪除。時間軸保留歷史——你可以看到什麼時候什麼是有效的，而不僅僅是目前狀態。
使用範例
新增事實
# Record architecture decisions as facts
kg_add
subject: "backend"
predicate: "uses"
object: "PostgreSQL"
confidence: 0.95
# Track ownership
kg_add
subject: "auth-module"
predicate: "owned-by"
object: "backend-team"
查詢關係
# What does the backend use?
kg_query
entity: "backend"
direction: "outgoing"
> backend uses PostgreSQL (0.95)
> backend uses Express (0.90)
> backend deployed-on Docker (0.95)
檢視時間軸
# See how decisions evolved
kg_timeline
entity: "database"
> 2026-03-01 database considered MongoDB
> 2026-03-05 database decided PostgreSQL
> 2026-03-01 MongoDB consideration invalidated
使用情境
架構對應
追蹤哪些服務使用哪些技術、元件如何連結、以及依賴關係。
決策歷史
記錄選擇的原因及其演變過程。不再重複討論已定的決策。
團隊歸屬
對應誰負責哪些模組、服務和領域。適用於大型程式碼庫。
依賴追蹤
在修改前瞭解影響範圍。修改元件前先查詢哪些依賴於它。
API 端點
知識圖譜有 5 個專用工具和對應的 REST 端點。請查閱完整的 API 參考瞭解請求/回應詳情。 REST API →
kg_add— 新增事實（主體 - 謂詞 - 客體）kg_query— 查詢實體關係kg_invalidate— 標記事實為不再有效kg_timeline— 檢視實體的事實歷史kg_stats— 圖譜統計（實體數、事實數）