# 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 查，不叫人填。