Files
Arcrun/system-dev/docs
uncle6me-web 406f0fedf8 docs(sdd): credential 遷移 SDD 依 T1.5 spike 改寫——Secrets Store 產品換成 Workers per-script Secrets
依據 T1.5 spike 四驗證全過(2026-07-03,證據 Gitea Arcrun#2):
① API 動態加 secret 免重部署即讀 ② env[ref] 動態字串索引可行
③ 14 把未觸上限(D21 單用戶:記錄即可)④ 重部署後 secrets 存活。

- §2.3 全段改寫:寫入走 CF API PUT /workers/scripts/{script}/secrets、
  讀取走 env[ref]、原三條候選路徑待決撤銷(T1 spike 實證 Secrets Store
  binding 靜態 + .get(ref) 參數被忽略 + REST 唯寫,路徑不成立)
- §2.5 改寫:取值=env[secret_ref](零網路呼叫),wasi-shim
  secret_get(ref) host 端實作=env[ref]
- T3 改寫:ensure store + 注入 store_id 整步取消,改為確保 secrets
  寫入 token/account id 就緒+非關鍵 worker 跑一次 acr update 驗存活
- T4 改寫:secret_get(ref) 實作=env[ref](spike ② 已證)
- T1 標完成(負結果)、T1.5 標完成、T2-T9 解凍施工
- 其餘矛盾句對齊用詞(§0/§2.1/§2.2/§2.4/§3/§4/§5/§6 Q-a/Q-d、
  回填端點更名 migrate-to-workers-secrets)
- 雙讀過渡、回填、回滾、治理(D1 只存 metadata+secret_ref)設計不動

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-03 07:22:38 +08:00
..

Arcrun 文件分類索引

LLM Wiki 結構:長期記憶系統,防止決策遺忘和重複錯誤。 參考:Andrej Karpathy — A Closer Look at How LLMs Remember


分類規則

目錄 用途 例子
1-vision/ 「為什麼」:設計哲學、核心價值、前瞻方向 arcrun 優勢、Haiku 就能搞定、薄殼原則
2-architecture/ 「是什麼」:系統設計、技術棧、組件關係 MVP 架構、零件模型、KV 存儲方案
2-architecture/decisions/ 架構關鍵決策和 trade-off Service binding 為什麼廢、R2 只用 Phase 5、同 zone 1042 解法
3-specs/ 需求和 SDD:設計文件、任務清單 (從 .agents/specs/ 搬來)
4-guides/ 操作手冊:如何做、工作流程 部署流程、CLI 用法、壓測方法
5-records/ 日誌和證據:事件、測試、決策履歷 Incident、壓測報告、問題追蹤
5-records/incidents/ 生產問題復盤:故障原因、改進方案 2026-05-13 同 zone 1042、2026-06-06 MCP route bug
5-records/test-reports/ 壓測結果、驗收報告 2026-06-07 公庫上線測試、2026-06-08 Haiku 乾淨重測
6-user/ 對外文件:README、教程、FAQ self-hosted 安裝、開發者指南

.claude/wiki/ — LLM 本機記憶

檔案 用途 更新頻率
INDEX.md wiki 目錄和導引 每次新增
mistakes.md CC(我)常犯的錯 + 避坑方法 每次踩坑後
status.md 當前進度、已知問題、下一步 每次 session 結束
decisions-summary.md 架構決策快速參考(不是全文,是摘要 + 連結) 每次大決策後
modules/[name].md 關鍵模組說明:職責、入口、常見誤解 不定期補充

檔案遷移計畫

當前位置 新位置 優先級
根目錄 .md(除 README/CLAUDE → docs/ 分類
.agents/specs/ → docs/3-specs/
.claude/rules/ → docs/2-architecture/ + wiki
docs/incidents/ → docs/5-records/incidents/
壓測報告 → docs/5-records/test-reports/

下一步

所有檔案整理進此結構後,wiki 將作為 CC 和任何 LLM 的長期記憶入口。