Files
kbdb-ingest-plugin/README.md
T
Leo dffefdcdc2 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>
2026-06-26 12:43:26 +08:00

38 lines
1.5 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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/`