Leo
efe8e165cf
按 leo 鐵律（2026-06-14）把插件從「直接 SQL 操作基本盤表」改寫成 「只透過基本盤 arcrun/kbdb HTTP API 讀寫」。零建表、零 migration、零 SQL。 - 新增 src/lib/kbdb-client.ts：唯一對外通道，封裝 entries/templates/records API - 新增 src/lib/templates.ts：triplet/entity template 定義（替代建表） - 改寫 21 個違規 action（triplet/graph/entity/search）→ 走 client，圖在插件層記憶體組裝 - 移除所有 migrations、D1/Vectorize/AI 綁定；embedding/語意搜尋歸基本盤 optional 模組 - index.ts 只掛 triplets/graph/entities/search 路由；基本盤路由歸 arcrun/kbdb - 測試改走 mock client（純 node）；裁剪 CLAUDE.md 只留 graph 插件 + 鐵律 - 修正 SDD design.md「讀現狀推翻鐵律」的錯誤判斷（共用 D1 → API-as-Wall） Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2.3 KiB
2.3 KiB
KBDB Arcrun Key Auth — Tasks
建立：2026-05-05 權威進度來源：本檔。完成一項立刻
[x]，不批次。
Phase 0 — SDD 建立
- 撰寫
design.md - 撰寫
tasks.md（本檔） - richblack review + 認可 → 開 Phase 1
Phase 1 — KBDB auth middleware 接受 ak_ Key
修改檔案：matrix/kbdb/src/index.ts
- 1.1 將 line 103 的
effectiveToken.startsWith('pk_')改為effectiveToken.startsWith('pk_') || effectiveToken.startsWith('ak_') - 1.2 本地跑現有測試確認不 break：
pnpm test
Phase 2 — Arcrun OAuth callback 寫入 KBDB partner 記錄
修改檔案：matrix/arcrun/cypher-executor/src/routes/auth.ts
注意：此 Phase 需要 Arcrun 側有
KBDB_INTERNAL_TOKEN和KBDB_BASE_URL兩個 env binding。
- 2.1 在
Bindingstype（types.ts）加入KBDB_INTERNAL_TOKEN?: string和KBDB_BASE_URL?: string - 2.2 建立 helper
src/lib/kbdb-partner.ts： -ensureKbdbPartner(env, email, apiKey)→ PUT /admin/partners/by-key-hash，失敗靜默 log -revokeKbdbPartner(env, oldApiKey)→ DELETE /admin/partners/{id}，失敗靜默 log - 2.3 在 OAuth callback（UserRecord 建立/取得後）呼叫
ensureKbdbPartner（fire-and-forget） - 2.4 在
PUT /me/api-key/rotate呼叫：revokeKbdbPartner(oldKey)+ensureKbdbPartner(newKey) - 2.5 在
DELETE /me/api-key呼叫revokeKbdbPartner - 2.6
wrangler secret put KBDB_INTERNAL_TOKEN（cypher-executor Worker）← 需要人工執行 - 2.7 在
wrangler.toml加KBDB_BASE_URL = "https://kbdb.finally.click"
另外：KBDB admin.ts 新增 PUT /admin/partners/by-key-hash endpoint（upsert by hash，不產生新 key）。
KBDB types.ts 加入 KBDB_INTERNAL_TOKEN 到 Bindings。
KBDB admin.ts 放寬 org_namespace regex（允許 arcrun:email@domain 格式）。
Phase 3 — 驗證
- 3.1 新用戶 OAuth 登入 → 確認 KBDB partner 記錄建立（
GET /admin/partners查詢） - 3.2 用
ak_xxxKey 直接打 KBDBGET /blocks→ 確認 200（非 401） - 3.3 Key rotate → 確認舊 Key 401，新 Key 200
- 3.4 Key revoke → 確認舊 Key 401
目前狀態
- Phase 0 已完成（等 richblack 認可）
- Phase 1–3 全部
[ ]，等認可後動工