# 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/`。