Files
kbdb-graph-plugin/.claude/wiki/INDEX.md
T
Leo efe8e165cf feat: KBDB-graph 插件獨立 — 全面改寫成走基本盤 API(API-as-Wall)
按 leo 鐵律(2026-06-14)把插件從「直接 SQL 操作基本盤表」改寫成
「只透過基本盤 arcrun/kbdb HTTP API 讀寫」。零建表、零 migration、零 SQL。

- 新增 src/lib/kbdb-client.ts:唯一對外通道,封裝 entries/templates/records API
- 新增 src/lib/templates.ts:triplet/entity template 定義(替代建表)
- 改寫 21 個違規 action(triplet/graph/entity/search)→ 走 client,圖在插件層記憶體組裝
- 移除所有 migrations、D1/Vectorize/AI 綁定;embedding/語意搜尋歸基本盤 optional 模組
- index.ts 只掛 triplets/graph/entities/search 路由;基本盤路由歸 arcrun/kbdb
- 測試改走 mock client(純 node);裁剪 CLAUDE.md 只留 graph 插件 + 鐵律
- 修正 SDD design.md「讀現狀推翻鐵律」的錯誤判斷(共用 D1 → API-as-Wall)

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-14 20:59:41 +08:00

1.7 KiB
Raw Blame History

.claude/wiki/ — LLM 記憶系統

新 session 開始時從這裡導航。 目的:讓 CC 不需要重新學習已知的事。 維護者:CC(人不手動編輯這裡)


核心檔案

檔案 何時讀 內容
status.md session 開始第一件事 當前進度、下一步
mistakes.md 做新功能前 已知誤解、快速檢查清單
decisions-summary.md 遇到設計判斷時 架構決策摘要

維護規則

  1. 只增不刪——記錄 append,決策改了加新條目說明「舊決策已更新」
  2. status.md 每次 session 結束更新
  3. mistakes.md 每次被糾正後 append
  4. 發現新的重要決策 → 同時更新 decisions-summary.md 和 docs/2-architecture/decisions/

快速導航

這個專案是什麼KBDB-graph —— KBDB 的 graph 插件(triplet 採集 + graph 查詢),類比 Apache AGE 之於 Postgres。要抽成獨立 repoleo 產權)。基本盤(block CRUD)在 arcrun/kbdb,不在這。

動工前必讀

  • docs/HANDOFF-kbdb-plugin.md —— 本目錄專屬交棒(待辦:確認邊界 / 改名+git init+推 GitHub / 定義掛載介面)。
  • 上游約束見 CLAUDE.md 最頂 + github.com/uncle6me-web/InkStoneCo

文件去哪找

  • SDDdesign+tasks)→ docs/3-specs/(現有:arcrun-key-auth、blocks-edit-api
  • 歷史記錄 / bug 復盤 → docs/5-records/(現有:PATCH 403 bug、upsert feature request
  • 分類規則全表 → docs/README.md

絕對限制:本目錄只做 graph 插件 / 萬物皆 Block(禁 CREATE/ALTER TABLE/ API-as-Wall / 部署繞開 GitHub、禁跨 repo Actions / 樂高法(actions < 100 行)。