558e80b4da
wiki 已初始化過(push 檔活躍維護),本次補從沒建的 pull 層 + arcrun 化範本: - cards/decisions/ 14 張決策原子卡(含 gloss/實體/typed-edge 三元組): 從 decisions-summary 全量改寫 13 + 新增「薄殼規則晚於實作-MCP漂移是歷史債」1 - TAXONOMY 從 PKM 範本換成 arcrun 軸(子系統 零件架構/cypher/credential/recipe/kbdb/ 薄殼/部署/平台原則 + 形態 架構決策/踩坑/機制說明/禁令/案例經驗) - principles 填 13 條跨全局原則(從 rules/ + mindset 蒸餾) - INDEX 真實視圖(子系統角度 + 決策角度,指向 cards) - system-dev/scripts/ + scripts/ install/update 安裝腳本(template 接入) 純基建/文檔,無業務 code(功能 code 見前一 commit)。 raw source(docs/)0 異動、wiki 卡際連結無斷鏈。 Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
1.9 KiB
1.9 KiB
架構決策
桶子索引(容器:只連不重寫)。一決策一卡,自包含 + trade-off。 新決策由 /wiki-capture 寫進本桶並在此 append 一行。 權威全文:
system-dev/docs/2-architecture/decisions/DECISIONS.md;本桶是 AI 改寫過的可檢索版。
零件 / 工作流 / 能力補丁
- 工作流是default零件是例外 — 自用→工作流,全生態重用→才零件;「能包」≠「該包」
- 自力救濟階梯-缺能力怎麼補 — 自家API缺→補API/第三方→workflow補丁/純計算→code-node
- 薄殼原則-能力長在API — CLI/MCP/lib 只暴露,齊的單位是「能力」不是「端點」
- 薄殼規則晚於實作-MCP漂移是歷史債 — 為何 MCP/CLI 不一致:紀律 2026-06-07 才補、補前漂移
串接 / 部署
- service-binding-vs-cypher-binding — 零件走 HTTP URL,禁新增 service binding
- same-zone-1042用flag解不用binding — self-hosted cypher 加 global_fetch_strictly_public
- R2用途-平台零件不從R2讀 — 平台零件 bundle 進 Worker,R2 只 Phase 5 用戶自製
- self-hosted部署-共享install加指紋跳過 — root 共享 install + manifest content-hash 跳過未變動
- 不依賴CI-執行鏈路vs零件投稿 — 執行鏈路走 local script,零件投稿才走 PR/CI
credential / recipe
- 多worker-ENCRYPTION_KEY同步 — 各 Worker secret put 同份 key,漂移→解密失敗表現為 401/403
- Recipe-UUID市場模型 — canonical+uuid+author 多維身份,per-uuid 市場數據
kbdb
- embedding是base-optional模組 — binding 開才啟用,預設關降級 LIKE,精耕只 embed:true
- 碰舊Mira需求先查頂層覆寫 — mira 蒸發→當普世缺口,先查頂層 mira-dissolve 覆寫
平台目標
- Haiku能驅動是設計目標 — Haiku 過=設計達成;撞牆是介面缺陷訊號非換模型