init: kbdb-ingest-plugin 骨架

KBDB 堆疊的餵食器(最薄一層):拉 GitHub repo → 採取/萃取三元組 →
餵 graph 寫入端 → 織跨 vault 的圖。

- CLAUDE.md:上游指針 + ingest 鐵律(純餵食器/不碰儲存/不算向量/
  不帶查詢 MCP/部署繞 Actions/三守則)
- README:定位 + 護城河命題(跨 vault 的圖)
- contracts/ingest-candidate.json:凍結 envelope 契約(與 graph repo 同份)
- docs/3-specs/ingest-pipeline/:SDD 三件式骨架(藍圖指向 InkStoneCo mira-dissolve)

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
2026-06-26 12:43:26 +08:00
commit dffefdcdc2
7 changed files with 313 additions and 0 deletions
+37
View File
@@ -0,0 +1,37 @@
# kbdb-ingest-plugin
KBDB 堆疊的**餵食器**——從 GitHub repo 拉知識庫,採取/萃取成三元組候選,餵給 [kbdb-graph-plugin](https://github.com/uncle6me-web/kbdb-graph-plugin),織成跨 vault 的圖。
堆疊裡最薄的一層:
```
base KBDBarcrun/kbdb ← 儲存(D1 三表 + CRUD API
↑ API
kbdb-graph-plugin ← 三元組領域 + 圖查詢
↑ APIingest 餵候選)
kbdb-ingest-plugin(本 repo ← 純餵食器:拉 + 採取/萃取 + 跨庫織網
```
## 它做什麼
- **採取(優先)**:拉本地 CC 已建好的三元組 + gloss(用了精耕模板的 repo)。
- **萃取(fallback**:裸原文時自己萃成 (subject, predicate, object) + gloss;模型可選(預設 Haiku)。
- **跨 repo 織網**:匯總多 repo 的三元組,織出單一 repo 看不到的跨庫橋與異見。
## 它不做什麼
- ❌ 不碰儲存(不直連 D1/Vectorize/表)——只 POST 候選給 graph 的寫入 API。
- ❌ 不算向量 normalize(歸 base embed 模組)。
- ❌ 不帶查詢 MCPambient 餵食器,只帶 ops CLI)。
## 命題
不是「更好的 notes RAG」(紅海),而是**跨所有 vault 的圖**——Obsidian/Logseq 結構上做不到的那層。護城河是你累積的圖,不是這份程式碼。
## 契約
`contracts/ingest-candidate.json` — ingest→graph 的凍結 envelope 契約(與 graph repo 同一份)。
---
InkStoneCo 子專案。開發規範見 `CLAUDE.md`,跨專案藍圖見 InkStoneCo `docs/3-specs/mira-dissolve/`