Leo
06e901f590
把 system-dev-template 1.9.x 的知識庫基建搬進 git（從功能 PR 拆出，獨立成筆）： - system-dev/wiki/：LLM 記憶系統（principles 鐵律 + 5 張 ingest 卡 + INDEX/TAXONOMY + status/mistakes） - system-dev/docs/：SDD 新家（3-specs/ + 2-architecture/ + README/SKILL）；ingest-pipeline SDD 從 docs/3-specs/ 搬來 - system-dev/scripts/：install/update - .claude/：wiki/SDD harness（commands + hooks：session-recall / sdd-guard / wiki-secret-scan） SDD 位置統一：docs/3-specs/ingest-pipeline → system-dev/docs/3-specs/ingest-pipeline （對齊 SDD guard hook 預期路徑 + template 1.9.x 規約）。 純基建遷移，不含任何功能程式碼（src/tests/contracts 在功能 PR #3）。 Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2.3 KiB
2.3 KiB
tags, gloss
| tags | gloss | ||
|---|---|---|---|
|
kbdb-ingest-plugin 在 KBDB 堆疊裡的位置——掛在 graph 上、graph 掛在 base 上的最薄餵食器層。 |
掛載架構
來源：CLAUDE.md、README.md、docs/3-specs/ingest-pipeline/design.md
最後更新：2026-06-26
摘要
KBDB 是三層堆疊：base 管儲存、graph 管三元組領域與查詢、ingest 是最薄的餵食器，只透過 API 往上一層 POST 候選。
重點
- 三層由下而上：
base KBDB（arcrun/kbdb）管儲存（D1 三表 + CRUD API）→kbdb-graph-plugin管三元組領域 + 圖查詢，並開POST /triplets/ingest寫入端 →kbdb-ingest-plugin（本 repo）純餵食器：拉 + 採取/萃取 + 跨庫織網。 - 每層只透過上一層的 HTTP API 互動，不碰其內部結構。ingest 只打 graph 的寫入端，從不直連 base。
- ingest 內部資料流：SourceAdapter（GitHub 拉 + content-hash，
source.uri = github:owner/repo@path）→ 採取或 extract → 跨 repo 匯總織網 → POST envelope。 - 無環：graph 永不回呼 ingest。觸發只能從下游發起方向之外（webhook/排程，或 KBDB MCP
refresh代轉），下游圖層不主動驅動上游餵食器。 - 命名只養一個品牌 Arcrun，本元件功能名當水管：
ingest。
實體
本卡關鍵實體（graph node）。
- kbdb-ingest-plugin（本 repo／餵食器）— KBDB 堆疊最薄一層，純 POST 候選 envelope 給 graph、不碰儲存。
- kbdb-graph-plugin（graph 層）— 三元組領域與圖查詢層，對 ingest 開
POST /triplets/ingest寫入端。 - base KBDB（arcrun/kbdb／基本盤）— 最底儲存層，D1 三表 + CRUD API，ingest 與 graph 都不繞過它直碰表。
- SourceAdapter — ingest 內部從 GitHub 拉 repo 並算 content-hash 的元件。
關聯
內文知識關係（端點＝上方 ## 實體 正規名）
- kbdb-ingest-plugin >> 掛載於 >> kbdb-graph-plugin
- kbdb-graph-plugin >> 掛載於 >> base KBDB
- kbdb-ingest-plugin >> POST候選給 >> kbdb-graph-plugin
- SourceAdapter >> 隸屬於 >> kbdb-ingest-plugin
卡片關係（卡對卡）
- 掛載架構 >> 受約束於 >> envelope-契約
- 掛載架構 >> 展開為 >> 採取優先於萃取