Theme / v13.28.0

Claude-Mem

Claude Code 持久化記憶系統

基礎觀念

v13.24.2 → v13.25.3:觀察品質與穩定線修補

理解 v13.24.2~v13.25.3 的重點:session 觀察品質修正(prose-only observations 不再丟棄)、worker/supervisor 可靠性、CVE 修補與 v13.25.3 的安全性強化。

概述

claude-mem v13.24.2 至 v13.25.3(2026-09-11 至 2026-09-21)是典型的穩定線修補:沒有新的大功能地圖,而是把觀察(observation)品質、worker / supervisor 可靠性與安裝路徑逐一修穩。

觀察品質:不再丟掉能救的東西

記憶系統的價值取決於「該記的都記到了」。這批修正處理的都是靜默丟失:

修正 問題
救回 prose-only observations(#3363) 只有文字敘述、沒有工具呼叫的 observations 過去直接丟棄
跳過無文字的 assistant frames(#3501) 空 frames 在批次確認前先過濾
不再丟 session-summary 回應(#4029) 摘要回應過去被丟掉(#1345 的復發)
summary 輸入以 payload 大小設限(#4030) 改以容量而非事件計數切分
空標題 observations 跳過(#3176) 擷取時過濾
剝離 image payloads(#3996) observation prompt 不再夾帶圖片

「prose-only 救回」特別值得注意:AI 代理的很多重要結論就是純文字敘述,不以工具呼叫形式存在——把它們排除在記憶外,等於只記了手、沒記腦。

Worker / Supervisor 可靠性

  • daemon 不再繼承使用者專案 cwd,worker cwd 改為 DATA_DIR——修掉 Windows 上的資料夾鎖死問題
  • worker-unavailable 的 fail-loud latch 只觸發一次,之後 fail-open(#4033)——反覆報警之後學會安靜
  • health probes 尊重呼叫端剩下的 deadline(#4026)——探測不再吃掉上游的全部時間預算
  • sync-hub 的排程 projection repair 設限(#4046)
  • quota / reactive 錯誤暫停 session而非重試到死(#3999)
  • sync_outbox 在 cloud sync 未設定時成長設限(#4031)
  • memory_session_id 只註冊一次(#4027)——sync outbox 不再放大

安全性(v13.25.3)

  • 未認證 settings 寫入防護強化
  • telemetry 錯誤內容 scrubbing 強化(#4166)

另外 shell-quote 升級到 1.9.0,修 CVE-2026-13311(#4018)。

安裝與平台路徑修正

  • Windows CredRead shim 可編譯(OAuth token 查找)
  • macOS keychain account 名稱對齊 Claude Code(#4045)
  • 找得到 bun / uv 安裝器實際放置位置(#4038)
  • Bun runtime 路徑損壞不再 ENOENT(#4039)
  • Windsurf hooks.json 容忍 BOM
  • Volta 的 Bun shims 解析到 bun.exe
  • rehydration 使用最新的 user_prompts 文字(#4049)
  • 不再建立空的 CLAUDE.md(#4015)
  • hook stdin 畸形時 fail open(#4006)

對既有使用者的影響

無遷移步驟。升級收益集中在:

  • 長 session:觀察丟失減少、worker 穩定
  • Windows / macOS:安裝與憑證路徑修正
  • quota 敏感的使用者:不再對已知耗盡狀態重試

學習重點

  1. 記憶系統的 bug 優先級以「靜默丟失」最高:錯誤訊息會被看見,丟掉的 observation 沒有人知道。這批修正大半在堵丟失路徑——prose-only、空 frames、summary 回應、截斷時的 partial。
  2. Fail-loud 也要有 latch:#4033 的設計(報一次之後 fail-open)平衡了兩個極端——永遠靜默與無限報警。警示的目的是讓人修,不是讓人麻木。

來源:v13.25.3