Leo/kbdb-graph-plugin

Files

T

Leo c82d75f742 docs: SDD tasks + wiki 收尾（改寫全完成、推 public repo）

- tasks.md：R-EXT-4 改寫全 ✅、R-EXT-2 獨立 repo ✅、部署現況（待基本盤上線跑 install.sh）
- wiki status：改寫完成快照 + 下次第一件事=實際部署
- wiki mistakes：記「讀違規現狀推翻鐵律」「embedding 非插件職責」兩條

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

2026-06-14 21:22:23 +08:00

1.2 KiB

Raw Permalink Blame History

KBDB-graph 插件安裝 — Tasks

對應 design.md。動手前確認 design 已讀。

Phase 1：安裝腳本

1.1 scripts/install.sh：git clone → wrangler whoami → 查 subdomain → 拼 BASE → secret put → deploy
1.2 subdomain 查詢：CF API GET /accounts/{id}/workers/subdomain（可抽 arcrun cli/lib/cf-api.ts 既有實作）
1.3 BASE 拼接 + 健康檢查：deploy 後 GET {BASE}/health 確認基本盤可達，不可達則明確報錯（不是默默裝壞）

Phase 2：配置位置

2.1 wrangler.toml KBDB_BASE_URL = "" 保持空（占位，AI 安裝時填）
2.2 .dev.vars 加入 .gitignore（本地測試值不進版控）
2.3 部署值走 wrangler secret put KBDB_BASE_URL，不寫 toml/git

Phase 3：測試

3.1 單元測試走 mock-client（已有），不依賴 KBDB_BASE_URL
3.2 整合測試 doc：本地起 arcrun/kbdb wrangler dev + 插件 .dev.vars 指 localhost
3.3 整合測試驗證：建 template='triplet' + 填 slot + 查圖，全走 API 無 SQL

不變條件（每步都守）

零建表、零 migration、零直接 SQL（hook 會擋）。
用戶零填寫——base URL 由 AI 查，不叫人填。