Files
kbdb-graph-plugin/docs
Leo 613071f41d feat(graph): get_source + refresh 端點 + keyword 收斂 (T3.6-3.7)
對應 issue #1 T3 C 段(圖工具 HTTP API 備好,MCP 註冊薄殼待 arcrun)。

- get_source (3.7): graph-source.ts + GET /graph/source/:name —
  回節點的 active triplet 來源指標(uri/anchor/block_id/content_hash),去重。
  連帶加 source_anchor slot,ingest 從 source.anchor 帶入
- refresh (3.6/3.6b): graph-refresh.ts + POST /graph/refresh —
  純被動代轉 ingest(KBDB_INGEST_URL),只人發起、無排程/webhook(fan-out 紅線)。
  未設 URL → 誠實 forwarded:false,不假綠
- 3.6d: POST /search 移除公開 keyword 模式(重複 KBDB MCP),收斂 suggest-only;
  keywordSearch helper 留作 suggest 內部建構塊
- 3 新測試(get_source uri+anchor / active-only / refresh 未就緒誠實回報)

gates: vitest 19 passed / zero SQL / 無新綁定 / dry-run bundle 乾淨
待接:MCP 註冊薄殼併 arcrun u6u-mcp-server;refresh 端到端待 ingest(T4) 部署

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-26 18:24:04 +08:00
..

文件分類索引

CC 整理文件時的分類依據。找不到分類就問,不要猜。


分類規則

目錄 放什麼 判斷標準
1-vision/ 為什麼做這個 產品願景、北極星、設計哲學
2-architecture/ 系統怎麼設計的 架構圖、技術棧、元件關係
2-architecture/decisions/ 為什麼這樣設計 ADR,選A不選B的原因
3-specs/ 要做什麼 SDD,每個子系統一個目錄
4-guides/ 怎麼做 部署、開發流程、CLI 用法
5-records/ 發生過什麼 歷史記錄,不修改只增加
5-records/incidents/ 生產問題復盤 故障原因、時間線、改進方案
5-records/test-reports/ 測試結果 壓測報告、驗收記錄
6-user/ 給使用者看的 README、安裝教學、FAQ

CC 整理文件時的判斷流程

這個文件是...
├── 有明確子系統 + 設計內容? → docs/3-specs/[子系統]/
├── 解釋為什麼做某個決定?   → docs/2-architecture/decisions/
├── 說明怎麼操作?           → docs/4-guides/
├── 記錄發生過的事?         → docs/5-records/
├── 給外部使用者看的?       → docs/6-user/
└── 以上都不確定?          → 列為「待確認」,問負責人

SDD 結構(docs/3-specs/ 下每個子系統)

docs/3-specs/[子系統名]/
├── design.md    ← 設計文件(要做什麼、怎麼做、邊界在哪)
└── tasks.md     ← 任務清單([ ] 未開始 [🔄] 進行中 [x] 完成)

CC 動手前必須有這兩個檔案。找不到就停手。


.claude/wiki/ — CC 的記憶空間(CC 維護,人不手動編輯)

檔案 用途 更新時機
INDEX.md wiki 導引 新增 wiki 檔案時
mistakes.md CC 已知誤解 + 避坑 每次被糾正後
status.md 當前進度 + 下一步 每次 session 結束
decisions-summary.md 架構決策摘要 重大決策後