跳到主內容
TechSpecs搜尋

Theme / v15.10.0

Claude-Mem

Claude Code 持久化記憶系統

主題首頁GitHub ↗
基礎觀念

v13.36.0～v13.36.1：社群版本、Provider 中斷保留工作與隱私修補

🟡 中階｜v13.35.0 → v13.36.1 的升級重點：provider 拒絕服務時改為暫停觀察器而非丟棄記憶、非 ASCII 使用者資料夾名稱修復、搜尋與 Chroma 可靠性強化、一批新設定與整合，以及 v13.36.1 針對 private 區段外洩、schema writer 競態與 Chroma lock 的三項修補。含互動測驗與升級檢查清單。

概述

Claude-Mem v13.36.0（2026-10-12 發布）官方定義為一次社群版本 (community release)：「自 v13.35.0 以來幾乎每一項變更都來自外部貢獻者，並以他們自己的名義合併 (nearly every change since v13.35.0 came from outside contributors and is merged under their own name)」。同日稍晚發布的 v13.36.1 是修補版，關閉 13.36.0 審查中發現的三個問題（#4721、#4722、#4724），外加八項社群修補；官方原文結論是 “Upgrading is recommended.”（建議升級）。

主軸：

  1. Provider 中斷不再丟棄記憶：Anthropic 額度為空、組織封鎖訂閱存取，或本地模型伺服器離線時，改為暫停觀察器 (observer) 並保留工作。
  2. 隱私與資料庫安全：v13.36.1 修掉 server runtime 下 <private> 內容仍隨 hook 外送（#4721）、schema writer 競態（#4724）、Chroma lock 誤放（#4722）。
  3. 搜尋與 Chroma 可靠性：分頁修正、CJK／泰文句中斷詞、重啟後不再停滯、孤兒行程清理。
  4. 一批新面孔：Qoder、Screenpipe、Atlas Cloud 與七個新環境變數／設定。
  5. 專案治理：main 成為唯一分支，PR 一律開向 main。

Provider 中斷不再丟棄記憶

這是本版最大的行為變更。過去 provider 說「不」時，已經捕捉到的記憶會直接消失；現在改為暫停而非丟棄（@Mola-maker）：

  • 觸發情境：Anthropic 額度為空 (an empty Anthropic credit balance)、組織封鎖訂閱存取 (an organization blocking subscription access)，或本地模型伺服器離線 (a local model server that is down)。
  • 行為：暫停觀察器並保留工作 (pauses the observer and keeps the work)，而不是丟棄它。
  • 串流提早結束：當觀察器串流提早結束時，它的批次會被交回重新處理 (handed back for reprocessing)（@shantanukhanwalkar）。
隨堂測驗

使用者的 Anthropic 額度用完，observer 因此無法呼叫模型。依照 v13.36.0 的描述，已捕捉到的批次會如何？

💡 想先看個提示？

注意原文用的是 pauses 而不是 discards。

隱私與資料庫安全（v13.36.1）

v13.36.1 的三個核心修補都在「資料離開你的機器之前」：

  • <private> 內容不再隨 hook 離開（#4721）：在 server runtime 下，檔案編輯、工具輸入與輸出、session 起始 prompt 都會帶著 <private> 區段被送到伺服器，而伺服器把完整的原始事件紀錄留下來（原本只等到組模型 prompt 時才移除）。現在私有區段在任何東西離開 hook 之前就被移除，伺服器在儲存事件或 session metadata 之前再移除一次。worker runtime（預設）不受影響。
  • 新舊 worker 不再在資料庫升級上競態（#4724）：防止舊版 claude-mem 打開新版升級過的資料庫的那道檢查，現在會在同一個 SQLite 寫入鎖內讀取並記錄 schema writer，且在任何 migration 執行之前完成。在此之前，兩個 worker 同時打開資料庫時可能雙雙通過檢查。
  • 已取消的 Chroma 連線不能再釋放新連線的鎖（#4722）：每個 Chroma 連線現在擁有自己的 writer-lock token、只釋放那一個鎖，因此關機期間的重連不會留下沒上鎖的新 sidecar、讓第二個 writer 寫入同一個 store。孤兒清掃 (orphan sweep) 的行程表解析現在也有 fixture 測試。

搜尋與 Chroma 可靠性

  • 搜尋：分頁修正（@junnhwan）；中文、日文、韓文與泰文詞彙能在句子中被找到（@rudycelekli）；長的自然語言查詢在「沒有任何記憶符合全部詞彙」時，退回任一詞匹配 (any-term matching)（@devkancheti4-design）。
  • 搜尋強健性：畸形檔案清單、純文字概念、對絕對路徑的資料夾搜尋、一致的日期解析，以及原生搜尋指令的更好 pattern（@rudycelekli）。
  • Chroma：大型 store 在重啟後不再停滯（@akushonkamen）；佔住資料目錄的孤兒 chroma-mcp 行程會在啟動前安全清除，不再造成鎖爭奪（@akushonkamen）。
  • 同步與重複：其他裝置的 prompt 會被連結（@necatisozer）；關閉 Chroma 會被完整遵守（@CCCLL）；啟動時更少 Chroma 重寫（@Montinou）；重音感知的重複偵測（@rudycelekli）與修正後的相似度門檻（@udsy19）。

新設定與新整合

官方 “New” 段落列出的項目，名稱照抄如下：

  • Qoder plugin 支援（@shouldnotappearcalm）
  • Screenpipe skill：搜尋會議與螢幕歷史並存成記憶（@EzraEllette）
  • Atlas Cloud preset：給 OpenAI-compatible provider 使用（@binyangzhu000-sudo）
  • CLAUDE_MEM_OPENROUTER_TEMPERATURE 設定（@aeneasr）
  • CLAUDE_MEM_SEMANTIC_INJECT_FORMAT=index：精簡的逐 prompt 記憶注入（@ktdrv）
  • CLAUDE_MEM_WORK_STATE_ENABLED=false：關閉 work-state to-do 規則（@noesis-bot）
  • CLAUDE_MEM_TOOL_USES_RETENTION_DAYS：opt-in 修剪原始工具日誌；預設保留全部（@Montinou）
  • Duplicate review：對重複候選記錄 “distinct” 或 “dismissed” 判定（@Montinou）
  • Viewer：設定中的 Claude auth method 控制項（@akushonkamen）
  • Server runtime：冪等的記憶上傳 (idempotent memory uploads)（@escooterclinic）

其他值得注意的修復：hooks 不再把專案的 tsconfig 當成錯誤回報（影響 React Native 與 Expo 專案，@Totopo27）；viewer 只儲存你改動的部分，因此舊的設定分頁無法覆蓋你在別處做的變更（@Cassian433）；使用者資料夾名稱含韓文、日文等非 ASCII 字元時，Bun 與 Claude 能再次被找到（@akushonkamen）；資料庫會記錄最新寫入過的 schema 版本，舊版 claude-mem 會拒絕開啟新版升級過的資料庫（@akushonkamen）。

v13.36.1 社群修補（@rudycelekli 的八項）

  • constructor 這類 integration id 不再經 alias 表解析（#4712）
  • Postgres 數值設定只接受正整數；像 5ms 這樣的值退回預設（#4713）
  • 大到無法表示的 Gemini retry hint 會被忽略，key 不會被無限停用（#4714）
  • 以 UTF-8 BOM 開頭的 billing-type 檔案能被正確讀取（#4715）
  • API-key 設定的陣列只保留字串項目（#4716）
  • Gemini 回應中畸形的一段不再丟棄整個答案（#4717）
  • 被封鎖的連線 (refused connections) 能在包裝過的錯誤中被辨識，恢復機制因此啟動（#4718）
  • Hook launcher 會在啟動 Node 或 Bun 之前遵守環境變數的 opt-out 旗標（#4719）

Project 變更：main 成為唯一分支

官方 “Project” 段落：main 現在是唯一分支。core-dev 與 community-edge 已退役，因此請對 main 開 pull request。

既有使用者影響

  • worker runtime（預設）不受 #4721 影響——<private> 修補是 server runtime 的漏洞；但也因此，任何 server runtime 使用者都應把 v13.36.1 視為隱私修補而非一般小版本。
  • 升級後請改用 main 作為 PR 目標——core-dev 與 community-edge 已不存在。
  • CLAUDE_MEM_TOOL_USES_RETENTION_DAYS 預設不改行為：預設值是保留全部，修剪必須明確 opt-in。
  • v13.36.1 官方明言建議升級（“Upgrading is recommended.”），理由即上述三項審查發現。

隨堂總結測驗

隨堂測驗

團隊在 server runtime 下使用 claude-mem，且習慣用 `<private>` 標記不要外送的內容。升級到 v13.36.0 後應注意什麼？

💡 想先看個提示？

看清楚「server runtime」與「worker runtime」哪一個受影響。

動手升級檢查清單

升級 v13.36.1：動手檢查清單

逐項勾選，確認你已完成升級必要的步驟（進度會保存在此瀏覽器）

0 / 6

延伸閱讀