Files
kbdb-graph-plugin/system-dev/docs/3-specs/plugin-install/tasks.md
T
Leo d2618758e2 docs(sdd): SDD 生命週期鐵律遷移 + SDD 位置統一到 system-dev/docs/3-specs/
- 位置統一:舊 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>
2026-07-17 17:04:12 +08:00

1.2 KiB
Raw Blame History

KBDB-graph 插件安裝 — Tasks

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

Phase 1:安裝腳本

  • 1.1 scripts/install.shgit 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、零直接 SQLhook 會擋)。
  • 用戶零填寫——base URL 由 AI 查,不叫人填。