chore: template 1.9.x 知識庫遷移 → system-dev/
把 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>
This commit is contained in:
@@ -0,0 +1,41 @@
|
||||
---
|
||||
tags: [掛載架構, 架構設計]
|
||||
gloss: kbdb-ingest-plugin 在 KBDB 堆疊裡的位置——掛在 graph 上、graph 掛在 base 上的最薄餵食器層。
|
||||
---
|
||||
# 掛載架構
|
||||
|
||||
← [[ingest/00-INDEX]]
|
||||
|
||||
**來源**:`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-契約]]
|
||||
- [[掛載架構]] >> 展開為 >> [[採取優先於萃取]]
|
||||
Reference in New Issue
Block a user