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:
@@ -0,0 +1,37 @@
|
||||
# kbdb-ingest-plugin
|
||||
|
||||
KBDB 堆疊的**餵食器**——從 GitHub repo 拉知識庫,採取/萃取成三元組候選,餵給 [kbdb-graph-plugin](https://github.com/uncle6me-web/kbdb-graph-plugin),織成跨 vault 的圖。
|
||||
|
||||
堆疊裡最薄的一層:
|
||||
|
||||
```
|
||||
base KBDB(arcrun/kbdb) ← 儲存(D1 三表 + CRUD API)
|
||||
↑ API
|
||||
kbdb-graph-plugin ← 三元組領域 + 圖查詢
|
||||
↑ API(ingest 餵候選)
|
||||
kbdb-ingest-plugin(本 repo) ← 純餵食器:拉 + 採取/萃取 + 跨庫織網
|
||||
```
|
||||
|
||||
## 它做什麼
|
||||
|
||||
- **採取(優先)**:拉本地 CC 已建好的三元組 + gloss(用了精耕模板的 repo)。
|
||||
- **萃取(fallback)**:裸原文時自己萃成 (subject, predicate, object) + gloss;模型可選(預設 Haiku)。
|
||||
- **跨 repo 織網**:匯總多 repo 的三元組,織出單一 repo 看不到的跨庫橋與異見。
|
||||
|
||||
## 它不做什麼
|
||||
|
||||
- ❌ 不碰儲存(不直連 D1/Vectorize/表)——只 POST 候選給 graph 的寫入 API。
|
||||
- ❌ 不算向量 normalize(歸 base embed 模組)。
|
||||
- ❌ 不帶查詢 MCP(ambient 餵食器,只帶 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/`。
|
||||
Reference in New Issue
Block a user