d2618758e2
- 位置統一:舊 docs/3-specs/ 五份 SDD git mv 到 system-dev/docs/3-specs/,舊位置留 README 指針 - 狀態判定:0 份 active(無現行開發,合法);paused×3(ingest-contract/kbdb-graph-extraction/plugin-install,等跨 repo 接通);closed×2 入 archive/(arcrun-key-auth/blocks-edit-api 死件,附封存原因) - 鋪檔(自 system-dev-template v1.15.0):SDD-LIFECYCLE.md、pending-changes.md、sdd-guard.sh 新版、sdd-check.md、sdd-active-check.sh - hook 掛載:settings.json PreToolUse Write|Edit 加 sdd-guard.sh - CLAUDE.md:SDD 鐵律段(濃縮五條+0-active 註明重啟先升 active)+修正遷移後舊路徑 - 驗證:sdd-active-check exit 0;guard pipe-test 0-active 擋 code 寫入(exit 2)/md 放行(exit 0) Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
1.2 KiB
1.2 KiB
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 查,不叫人填。