Theme / v13.24.1
Claude-Mem
Claude Code 持久化記憶系統
Changelog
版本更新紀錄
收錄 Claude-Mem 的版本變遷軌跡。每條紀錄以舊值→新值呈現，舊值以紅線劃掉但保留可見，方便對照改動軌跡。
v13.24.1
當前版本2026-09-05- 版本定位：v13.18.0→v13.24.1，涵蓋 v13.18.1～v13.24.1。這段版本主軸是 observer 邊界、worker / quota recovery、installer 重整、usage telemetry，以及 Cursor / Grok Bot 獨立 plugin。
- 新增功能：v13.24.0 把 Cursor 與 Grok Bot 拆成獨立 marketplace plugins（
claude-mem-cursor/claude-mem-grok-bot）；新增--provider host，可透過本機 OpenAI-compatible loopback 使用已登入 host agent 寫 observations，不需額外 API key。 - Observer 行為改變：v13.18.1 明確規定 observer 必須「silent by design」且「no contact」——只能單向記錄，不得通知被觀察 session、聯絡其他 agent 或 spawn subagents。這是重要的隔離邊界，避免 observer 反過來改變被觀察行為。
- Worker / 故障恢復：v13.19.0 把 outage warning 改成優先提供
npx claude-mem restart與本機 restart 頁；restart 必須確認 successor 使用不同 PID 且 readiness 通過，避免舊 worker 在 graceful shutdown 期間仍回 health 時被誤判為已恢復。 - Quota 行為改變：v13.20.0 的 quota breaker 會持久化 cooldown，冷卻後只放行一個 probe；assistant prose 型 quota refusal 也會觸發 breaker。observer 改採 bounded generations，cmem gateway key terminally exhausted 時可 fallback 到使用者 Anthropic plan。
- Installer / 商業流程改變：v13.21.x 修掉 v13.20.0 在 cmem.ai 不可達時連
--provider claude都不能安裝的問題；Claude provider 可略過 cmem.ai login。30-day trial 文案與連結統一，付款流程改成先看 offer 再進 Checkout；CMEM Pro 與 Claude Code 預選但仍可取消。 - Telemetry 新增：v13.22.0～v13.23.x 新增
observed_model、observed_billing、IDE/provider 與usage_limit_hit。v13.23.1 修正先前誤讀 SDK message shape，改辨識真正的rate_limit_event，subscription quota guard 才真正生效；API-key session 仍 exempt。 - 重要修補：v13.24.0 雖升 manifests，卻沒重建 committed plugin bundles，marketplace 實際仍跑 v13.23.1 bytes，會造成 worker version mismatch 後反覆 SIGKILL / respawn。v13.24.1 重新產生所有相關 bundles，因此使用 v13.24.0 的 marketplace 使用者應直接升到 v13.24.1。
- 移除 / Breaking Change：這段版本沒有宣告核心 memory API 的全面 removal，但 plugin 安裝面已重新切分；Cursor 與 Grok Bot 現在是獨立 host integration，部署與疑難排解時應把它們視為不同 plugin，而不是同一包裡的兩個模式。
- 既有使用者影響：v13.24.0 不應停留，應升 v13.24.1；使用 Claude provider 的本地安裝在 cmem.ai 不可達時仍能繼續安裝；若使用 quota-sensitive subscription，升級後 observer 不會再對已知用量耗盡狀態持續發送註定失敗的請求。
- 學習重點 / 建議用法：這段 release 很適合學「旁路 observer 的隔離設計」與「健康檢查不能只看 process 活著」。可靠系統應區分 process liveness、readiness、版本一致性與依賴服務可用性。
v13.18.0
舊版本2026-08-29- v13.15.0→v13.18.0：橫跨 Cowork 整合、Windows 大修、installer 試用方案實驗到 CMEM Pro 試用長度定案的六個版本。
- v13.16.0 在 marketplace 新增第二個 plugin
claude-mem-cowork，為 Cowork（Claude 原生 App 的雲端 session）擷取工具使用並串流至 cmem.ai，由 Pro 在伺服器端運行 observer，編譯後的 observations 會注入每個新 session 與子 agent。設計上 fail-soft：無 API key 時靜默 no-op，cmem.ai 無法連線時事件先在本機排隊稍後補送，每個 hook 一律 exit 0；credential 脫敏同步強化（短值、含空白值、任何 Authorization scheme、Cookie header、完整 URI userinfo）。 - v13.16.1 是 Windows 大修（rollup 五項修復）：worker 關閉/重啟時完整砍掉
uvx → uv → python → chroma-mcp行程樹（含 PID 身分檢查，杜絕殭屍 Python 行程與 port 37777 卡死）、修復tree-sitter.exe解析與 Windows 家目錄（~\）路徑展開、Git Bash 不可達時install/doctor改為明確報錯，並讓npm run build-and-sync不再需要 rsync 或 POSIX shell（可攜式 mirror 重現rsync -a --delete語意）。 - v13.17.0 導入 installer 試用長度方案：每個安裝流程穩定分配 7、14 或 30 天的 CMEM Pro 試用，在提示、重送流程、啟用摘要與 cmem.ai 連結一致顯示，同一長度送至 web start API 並在重跑時保留。
- v13.17.2 大幅加快 Codex 啟動：移除同步的版本/相依性檢查與重複的一次性 MCP 啟動，改走持久化本機 worker 路徑，API 請求上限 2 秒，暖啟動注入 context 不到一秒；另以
pro_offer_viewed事件量化各試用方案曝光（沿用 consent-gated 匿名安裝 UUID 與嚴格屬性白名單，不送 email、prompt 或任何內容）。 - v13.18.0 定案：7/14/30 天試用方案實驗由 30 天勝出，installer 每次都提供 30 天並明確帶入
trial=30，session-start banner、context banner、welcome hint、viewer header 與 cursor-hooks docs 同步更新；cmem.ai 上 7 與 14 天仍為有效值。
v13.12.4
舊版本2026-08-10- 本站此前的記錄版本，已升級至 v13.14.0。
v13.15.0
舊版本2026-08-10- v13.12.4→v13.15.0：CMEM Pro 成為 install prompt 第一選項，每個選項標示每 1,000 observations 的實際成本（依據價格而非品牌）。
- CMEM Pro 採 $30/月 flat-rate 訂閱 + 雲端同步，Anthropic plan 排在最後（每觀察最貴且佔用個人用量）。
- 整段 commit range 也納入 v13.13.0 的
sensitive觀察類型（第 9 類，非隱私但不宜外流的內部 URL、未發布計畫、商業指標），預設觸發 Telegram 通知。 - v13.13.1 新增互動式
/mode-creator工作流，可根據使用者的領域與筆記需求產生自訂 claude-mem mode。 - 既有安裝會自動把舊預設
security_alert遷移為security_alert,sensitive；自訂過的清單則保留不動。 - v13.15.0 的安裝器新增 CMEM Pro 七天試用與 browser device-code 核准流程；模型價格改為即時取得。
圖例
- 當前版本 本站現在記錄的版本
- 舊版本 已被取代，保留作歷史對照
- 已同步 與上游 release 對齊
- 僅上游變動 上游 main 有 commit，但未發佈新版