跳到主內容
TechSpecs搜尋

Theme / v15.10.0

Claude-Mem

Claude Code 持久化記憶系統

主題首頁GitHub ↗

Changelog

版本更新紀錄

收錄 Claude-Mem 的版本變遷軌跡。每條紀錄以舊值→新值呈現，舊值以紅線劃掉但保留可見，方便對照改動軌跡。

當前記錄版本

v15.10.0

查看上游所有 Release ↗

  1. v15.10.0

    當前版本2026-11-06
    • 版本定位：v15.9.0→v15.10.0（上游 2026-11-05 發布）。Release notes 定位：「Setup now leads with discovering your existing work, rules and focus from your transcripts.」
    • Onboarding 探索既有工作（v15.10.0，#5270、#5308、#5384 by @thedotmack）：Setup 以探索既有工作開場，主按鈕為 Discover My Work, Rules & Focus，Skip this step 縮小為其下的次要動作；Share anonymous usage statistics to help improve your Claude-mem experience 勾選框預設勾選、取消勾選會被保留，且在你按下 Discover 前不送出任何東西；hosted setup 忙碌時會先檢查容量再上傳，cooldown 記憶跨重啟保留，讓你能完成 setup。
    • 關閉記憶擷取（v15.10.0，#5353 by @tarunbad）：新增 CLAUDE_MEM_OBSERVER_ENABLED 設定與 Memory capture toggle；設為 "false" 即停止新的 observation 與 summary model calls，同時保留既有 memories、search 與 session-start context。
    • 逐工具選 observer（v15.10.0，#5333 by @ankit4479）：新增 CLAUDE_MEM_PROVIDER_BY_SOURCE 設定，依 session source 選擇 observer provider，例如 Codex sessions 用 Codex、Claude Code sessions 用 Claude。
    • 長效 Claude 登入（v15.10.0，#5372 by @MeggDistribution、#5383 by @xunguangzlj-cloud）：~/.claude-mem/.env 現在可提供 CLAUDE_CODE_OAUTH_TOKEN，讓 stored Claude Code login 過期時 capture 不會停止；因驗證暫停的 sessions 在 credential 被驗證可用後恢復。
    • 合併模式（v15.10.0，#5349 by @BaeJinSeop）：mode overrides 現在可以鏈結（chain），語言模式可與 chill 組合，如 code--chill--ko。
    • Doctor 解釋缺失的 observer（v15.10.0，#5366 by @parveen0029）：npx claude-mem doctor 現在會回報不可用的 observer provider 與 worker 的 dependencies，而不是說一切正常。
    • 可靠性：worker 池滿時等待（v15.10.0，#5386 by @balabommablock-cpu、#5388 by @0xABCD01）：pool of 10 滿了時，worker 改為等待空位而非失敗，且有其他 sessions 等待時會釋放閒置 slot。
    • 可靠性：卡住的 context-reader 請求逾時（v15.10.0，#5387 by @markjoin123）：hung context-reader requests 現在會逾時，卡住的讀取不再讓 observations 停擺。
    • 可靠性：observer 不繼承父 gateway 的模型名稱（v15.10.0，#5316 by @sayedrisat、#5317 by @parveen0029、#5348 by @tarunbad）：observer 不再繼承 parent gateway 的 model names，並保留你的 Claude beta opt-out；model refusal 以 model outage 回報。
    • 安裝與平台：Windows worker daemon 不需 PowerShell（v15.10.0，#5351 by @REI-330）。
    • 安裝與平台：Copilot CLI（v15.10.0，#5305 by @tanishqbaweja）：MCP server 註冊在 ~/.copilot/mcp-config.json，Copilot CLI 會從該處讀取。
    • 安裝與平台：Devin（v15.10.0，#5314 by @patrickballard）：Devin 壓縮（compacts）session 之後，context 會再次被注入。
    • 隱私：更多機密在儲存前遮蔽（v15.10.0，#5298、#5342、#5345、#5352、#5373 by @kevin9327；#5327 by @DeryFerd）：新增 Groq、xAI、NVIDIA NIM、Runcrate、Google OAuth（ya29.）、Linear、Notion、Supabase、Sentry、Databricks 與 HashiCorp Vault tokens。
    • 隱私：含換行的 log 值會被跳脫（v15.10.0，#5328 by @DeryFerd）：使其無法偽造（forge）一筆 log record。
    • 隱私：輸入邊界（v15.10.0，#5360、#5362、#5361、#5330 by @DeryFerd；#5341 by @Afloat16；#5336 by @ryrenz）：batch id arrays、timeline depth、job listing offset 與 empty URL modifiers 加入輸入邊界；/api/observations/batch 接受數字字串形式的 id。
    • 完整教學見 lessons/v15100-onboarding-and-observer-control.mdx。
    上游 Release Notes ↗

  2. v15.9.0

    舊版本2026-11-03
    • 2026-11-04 查核：上游最新 release 仍為 v15.9.0（2026-11-02 發布），其後無新版本。
    • 版本定位：v15.8.0→v15.9.0，涵蓋 v15.8.1（2026-11-01 20:04 UTC）、v15.8.2（2026-11-02 06:00 UTC）、v15.8.3（2026-11-02 06:26 UTC）與 v15.9.0（2026-11-02 18:03 UTC）四個 release。主軸：v15.8.1 儲存庫清理、v15.8.2 遙測瘦身、v15.8.3 瀏覽器 setup 隱私修復，v15.9.0 帶來 Devin 支援、My Work 刷新控制與遠端 worker。
    • 儲存庫清理（v15.8.1，#5259）：Repository cleanup. No changes to how claude-mem runs. repo 根目錄從 60 個條目減至 36；舊計畫、報告、playbook、生成檔與被取代的 cursor-hooks/、ragtime/ 目錄移除；文件移入 docs/、tests/、.github/、.claude/、docker/（changelog 至 docs/CHANGELOG.md、security policy 至 .github/SECURITY.md）；Cloudflare sync hub 原始碼移至 services/sync-hub；npm 套件內容不變。
    • 遙測瘦身與小修正（v15.8.2，#5266、#5269）：高頻事件（observer turns、work-state 使用、context injections、searches、skills）改為每個安裝每日一筆附 count 的彙總；worker start/stop 附 restart_count；失敗改為每類型每日一筆；cmem.ai 額度用盡後 observer 每天探測 gateway 一次而非每次 resume；修復失控的 "opened" 事件；hosted viewer 以 viewer_host='hosted' 回報分析；閒置任務卡片不再顯示 spinner。
    • 瀏覽器 setup 隱私修復（v15.8.3，#5220 修復 #5176）：Browser setup no longer uploads your prompts to cmem.ai without asking. 自 v15.2.0 起，npx claude-mem install 開啟的瀏覽器 setup 會未經詢問上傳最近 30 天提示全文（附 session ID、專案名稱、資料夾路徑與時間戳）。現在掃描只讀取本地後停下詢問；同意面板列出每個偵測到的工具與提示數，只上傳勾選的工具；「Keep everything local」或全部取消勾選即不上傳；analytics 勾選框選用、預設關閉且與上傳同意分離；第二個 start 請求加入目前狀態而非再啟動一次上傳；新增 POST /api/setup/scan/consent 路由（loopback-only、origin 防護）。官方明列不涵蓋：先前版本已上傳的提示不會被移除；cmem.ai 伺服器端處理與隱私政策措辭在此變更之外。
    • Devin 支援（v15.9.0，#5172、#5276）：npx claude-mem install 可設定 Devin CLI 與 Devin Desktop——hooks 為你寫入、Devin 的工具名稱被理解、記憶搜尋工具被註冊。
    • My Work 依你的條件刷新（v15.9.0，#5249、#5236）：My Work 與 Past Focus 新增 Refresh now 按鈕；新設定依 provider 選擇刷新模型——CLAUDE_MEM_WORK_VIEW_CLAUDE_MODEL、CLAUDE_MEM_WORK_VIEW_CODEX_MODEL、CLAUDE_MEM_WORK_VIEW_GEMINI_MODEL。
    • 遠端 worker（v15.9.0，#5285）：新增 CLAUDE_MEM_WORKER_URL 設定；設定值錯誤以明確錯誤失敗而非靜默回退，且任何不在你自己機器上的 worker 必須使用 https。
    • 隱私與安全（v15.9.0，#5272、#5277 等）：關閉錯誤回報現在也阻止已存在磁碟上的錯誤被送出；儲存前遮蔽更多機密——Slack／Discord webhook URL、Stripe webhook secret、PyPI、SendGrid、DigitalOcean、Shopify、Docker Hub、GitLab token、Authorization 標頭後的 Basic 憑證與 --auth-token、--client-secret 等 CLI 旗標；localhost 上其他網站無法再透過 work-state、dedup、corpus、advisor 路由向 worker 傳送寫入（#5200）；Kimi 設定備份只有本人讀得到（#5290）。
    • 記憶、搜尋與匯入修正（v15.9.0）：對話中途切換 observer provider 不再重複觀察（#5227）；重複 turn 摘要不再堆疊（#5228）；檔案搜尋 src/a.ts 與 src\a.ts 兩種分隔寫法都匹配（#5214）；全數字 dateStart／dateEnd 以 epoch 毫秒讀取（#5234）；Chroma 重建期間重啟 worker 不再重新嵌入已完成文件（#5238）；JSON 含空白的 Claude transcripts 不再被略過（#5289）；Codex／Gemini 提示不再重複匯入、遷移複本間舊版 Gemini 用量不再重複計算（#5292 等）。
    • 安裝與 CLI 修正（v15.9.0）：npx claude-mem adopt --help 與 cleanup --help 現在印出說明（PATH 上的 launcher 仍直接執行，讀說明請用 npx，#5288）；Windows launcher 安裝重試短暫檔案鎖並改用 npm 的 claude.exe（#5256、#5198）；macOS 27 被系統終止的 launcher 會重建（#5253）；CODEX_HOME 被遵守且帶引號 TOML 設定正確更新（#5216、#5212）。
    • 完整教學見 lessons/v1581-v1590-devin-support.mdx。
    上游 Release Notes ↗

  3. v15.8.0

    舊版本2026-11-01
    • 版本定位：v15.7.0→v15.8.0（2026-11-01 04:02 UTC 發布，台灣時間 2026-11-01 12:02）。官方變更：「feat(viewer): cloud viewer host for My Work, and work_state sync for every account」。
    • My Work cloud viewer host 與 work_state 同步（v15.8.0，#5193）：My Work 新增 cloud viewer host，且每個帳號都同步 work_state。release notes 未提供 host 網址、啟用方式或其他實作細節。
    • 完整教學見 lessons/v1580-cloud-viewer-host.mdx。
    上游 Release Notes ↗

  4. v15.7.0

    舊版本2026-10-31
    • 版本定位：v15.6.0→v15.7.0（2026-10-30 18:18 UTC 發布，台灣時間 2026-10-31 02:18）。主軸：My Work 的自動 refresh 被拒答案不再跳往下一個 agent（修復隱藏的 codex exec --ephemeral 外流）、note-taker 永遠使用最新 Haiku alias，以及橫跨執行檔探索、安裝來源、worker 端點、Postgres 金鑰與 redaction 的大幅安全強化。
    • My Work：refresh 留在你的 agent，加上 Feedback 按鈕（#5190，修復 #5189）：當 My Work 自動 refresh 從 Claude Code 得到 claude-mem 拒絕的答案（最常見是超過 1,200 字元的 review），過去整個 refresh 會直接跳到下一個登入的 agent——在裝有 Codex 的機器上，這代表隱藏的 codex exec --ephemeral 在 owner 的 ChatGPT 帳號上執行，即使設了 CLAUDE_MEM_PROVIDER=claude（官方回報四天約 230 次執行）。現在被拒答案會終止該 agent 上的該次 refresh：下一次排程執行再試同一個 agent，沿用既有的 failure backoff；完全無法執行的 agent（未登入、crash）仍會把 run 交給下一個。My Work header 的 Star 旁新增 Feedback 按鈕，開啟簡短的 "My Work feedback" issue 表單。
    • Note-taker 永遠使用最新 Haiku（#5195）：note-taker 的預設模型改為 Claude Code 的 haiku alias——永遠解析到最新的 Haiku，不再是釘住的 Haiku 4.5 ID；升級時仍帶著出廠釘選 ID 的已存設定會移到 alias，使用者自行輸入的模型不受影響。repo 的 CLAUDE.md 並將「永不把有日期的 model ID 當預設」寫成政策。
    • My Work 與 worker：activity 驅動的 My Work 背景重建會被合併（coalesced），開啟中的 My Work 頁面不再於每次 database commit 時重建（#5133，減緩 #5124）；Work View 等 database 完成啟動後才建置（#5157）；viewer 的處理狀態在串流中斷（stream gap）後會重新對齊（#5139）；每日 worker log 超過 CLAUDE_MEM_LOG_RETENTION_DAYS（預設 30，0 為永久保留）即被修剪，今天與昨天的檔案永遠保留（#5186）。
    • Projects：父 Git repository 內的命名環境（named environments）可宣告明確繼承（explicit inheritance），無關的父專案記憶不再洩漏進其 context（#5022）；Oh My Pi 將暫時性（transient）專案記憶保留在 model context（#5183）；Claude Duet 支援 capture 與 recall（#5188）。
    • Media 第一階段（預設關閉）（#4341）：image-aware observations 的第一階段——有界的媒體契約（bounded media contracts）與 lazy 載入的 Sharp 0.35.5 轉換器（附大小、像素與期限限制）；CLAUDE_MEM_MEDIA_CAPTURE_ENABLED 與 CLAUDE_MEM_MEDIA_INFERENCE_ENABLED 預設皆為 false。
    • Security：執行檔探索（executable discovery）絕不查看當前目錄（#5148）；安裝器 URL 一律 https，Bun 改從 owner 控制的目錄執行（#5149）；worker 拒絕跨源（cross-origin）瀏覽器寫入 session endpoints 與 POST /api/memory/ingest（#5162、#5161）；Postgres API keys 改以加鹽 scrypt 雜湊儲存（#5160），且所有 Postgres sslmode 皆被遵守（#5152）；atomic writes 改用 exclusive-create 的隨機暫存名稱（#5151）；private tags 在 caps 之前先剝除，Hermes 的最後一輪加上閘門（#5150）；redaction 擴及 GitLab、Hugging Face 與 npm tokens（#5174）、URL credentials 中的密碼（#5173），以及本地 redaction 開啟時的 inbound sync 文字（#5171）。
    • Fixes：hook stdin 在完整時即被框化（framed），不再等待 EOF（#5126）；已關閉 session 的 EPIPE 不再記為 fatal（#5177）；Windows 的 Codex sandbox 拒絕附帶說明（#5140）；OpenAI-compatible provider 從帶文字碼的 200 error envelope 讀取 HTTP status（#5191）；SessionStart 將 memory-use block 計入預算、不含 TeamBrain（#5181）；CLAUDE_MEM_DATA_DIR 開頭的 ~ 會被展開（#5179）；log tail 只讀取完整行（#5166）；過濾後的 Chroma fallback 收窄至 SQLite row ids（#5154）。
    • 完整教學見 lessons/v1570-refresh-stays-on-agent-and-security.mdx。
    上游 Release Notes ↗

  5. v15.6.0

    舊版本2026-10-30
    • 版本定位：v15.4.0→v15.6.0，涵蓋 v15.5.0（2026-10-29 00:48 UTC 發布，台灣時間同日 08:48）與 v15.6.0（2026-10-29 17:01 UTC 發布，台灣時間 2026-10-30 01:01）兩個 release。主軸：v15.5.0 翻新 My Work／My Focus 元件並強化 Observer 批次與 redaction；v15.6.0 把 My Work viewer 的狀態合併為單一 Zustand store。
    • My Work 單一 Zustand store（v15.6.0，#5187）：My Work 過去把狀態放在三處——手寫的 module store、App 的 component state 與 React contexts——現在改跑一個切成 work、view、rules、focus 四個 slice 的 Zustand store。
    • URL 狀態與偏好記憶（v15.6.0）：Reload 與 Back/Forward 正常運作——頁面、focus area 與開啟的 request drawer 都在 URL（?view=、?focus=、?request=）；列表檢視、filter 與 sort 會在造訪之間被記住，主題仍跟隨系統或 ?theme=；瀏覽器儲存被封鎖時，偏好只在當次造訪有效。
    • 即時更新更穩定（v15.6.0）：停止的 source 不能發布；較舊的讀取不會覆寫較新的 live model；當即時更新超前一次儲存時，你會看到當前 model 且你的儲存被保留；heartbeats 只重繪狀態指示器。
    • Drawer 跟隨其請求（v15.6.0）：drawer 以 id 跟隨其請求，請求離開 feed 時關閉；首次讀取失敗會顯示 Retry 按鈕；選定的 Closed filter 即使沒有任何符合項也保持可見。
    • My Rules 與 My Focus 的儲存行為（v15.6.0）：My Rules 一次只儲存一筆，儲存進行中停用控制項；每個 Approve/Reject 收據綁定 worker 儲存的版本，規則自那次儲存後有變更時 Undo 會被拒絕；My Focus 的所有畫面共用一份儲存歷史。
    • Worker（v15.6.0）：rule 儲存回傳 savedRuleId；「Load in Claude Code」把變更發布到其他開啟的分頁；feed signature 包含 rulesFile。
    • My Work／My Focus 元件翻新（v15.5.0，#5136）：My Work 與 My Focus 全面採用 Aceternity components。
    • Observer 與 Work view（v15.5.0）：Observer 新增 opt-in 的 OpenAI-compatible batching（#5117）；Work view 的 summary provider selection 改為明確選擇（#5104）；PostHog 計數 My Work viewer 開啟與頁面切換（#5107）。
    • Redaction 強化（v15.5.0）：遮蔽裸 token、secret、api_key 鍵下的值（#5130）；遮蔽 Authorization header 物件中的 bearer token（#5129）；在結構化酬載中成對比對 MYSQL_PWD 與 dbPassword 鍵（#5111）；遮蔽 Slack 的 app 層級（xapp-）與 refresh（xoxe-）token（#5119）。
    • 修復精選（v15.5.0）：Work view／My Work——build story 藉 part budgets 維持在上限內（#5128）、refresh 失敗不再灌爆 agents 並無限重試（#5108）、refresh corrections 保留被拒的答案（#5113）、呈現錄製的群組標題與 review 摘要（#5114）；Antigravity／MCP——agy MCP 呼叫以其真實工具名與穩定 id 記錄（#5170）、解析 Antigravity 專案脈絡（#5105）、Windows 8.3 短路徑查詢改用 %I 而非 %~I（#5099）；Worker／安裝／agents——POST /api/logs/clear 防範外來 localhost origin（#5123）、Linux 的 port reclaim 從 /proc 讀取佔用者的 port、命令列與名稱（#5101）、安裝或修復完成時清除 last-install-error.json（#5102）、backup-setup 在已安裝的 claude-mem 無備份時停止（#5103）、以解析後的執行檔啟動 Codex（#5112）、Pi 的 session-start context 請求取得 hooks 的 API 預算（#5118）；測試改為對已提交的 plugin bundles（而非建置產物）做語法檢查（#5137）。
    • 完整教學見 lessons/v1550-v1560-mywork-zustand-store.mdx。
    上游 Release Notes ↗

  6. v15.4.0

    舊版本2026-10-28
    • 版本定位：v15.3.0→v15.4.0。主軸：My Work 以焦點區域（Focus areas）為頂層，並讓新對話自動歸入 request。
    • My Work 焦點區域（#5131）：MY FOCUS 列依優先順序列出區域並顯示 needs-you 計數；每個 request 恰屬一個區域或 Other，手機以 chip row 顯示區域。區域頁呈現目標句、合併進度、個人引言、尚未開始的 asks 與 Past focus 連結；My Goals 頁退役，內容移至此處。Suggested 自動列出新區域，可 Keep、Rename、Merge、Dismiss 並 Undo；決定會跨電腦同步，refresh 不會覆蓋。Owner-goals 依序套用三項測試，讓每個陳述恰成為一個 focus area、ask 或 rule，避免 priorities 與 open asks 重複。自動 refresh 中的 Focus 步驟取代 Align，會放置每個 request，並從 Other 或含多個獨立 asks 的 request 提議新區域。request 卡片顯示所屬區域，詳情可用 Move to…；「What came out of it」更名為 Deliverables。
    • The judge 自動歸檔新對話（#5110）：在任何 grouping agent 執行前，每個新對話都先歸檔；code link（相同 work-state 清單或 request_id）會立即加入。CMEM Pro 或自備 OpenRouter key 的安裝中，Jev 也會檢查對話是否延續既有 open request：檢查分數 0.8 以上直接加入，0.5 至未滿 0.8 在卡片提供 Join / Not this 建議，其餘建立自己的 request。相同安裝條件下，Jev 會在 Focus 步驟前為每個 request 建議焦點區域，但目前只作為 Focus agent 的提示；自動放置要等累積足夠的使用者移動來校準門檻。沒有 Jev 時一切照舊。
    • Request 跨 project root 保留對話（#5106）：decision 指定 project root 的 request 會保留來自其他 root 的對話，後續 refresh 也能繼續加入對話。
    • Fixes：sync-api query-plan 測試自行套用 schema，不再因測試執行順序而失敗。
    • CMEM Pro：Jev decisions gateway /api/inference/v1/decisions 已為 Pro 訂閱者上線。
    上游 Release Notes ↗

  7. v15.3.0

    舊版本2026-10-27
    • 版本定位：v15.0.2→v15.3.0，涵蓋 v15.1.0、v15.2.0、v15.2.1（皆 2026-10-25 發布）與 v15.3.0（2026-10-26 發布）四個 release。主軸：React My Work viewer、瀏覽器安裝流程、npm trusted publishing（OIDC）與 My Work 卡片 Deliverables。
    • React My Work viewer（v15.1.0，#5010）：http://localhost:37777 的舊 viewer 由基於即時 worker 資料的 React My Work viewer 取代——每個人類請求一張卡、進度表 (progress meters)、owner goals、goal alignment、shipping velocity 與 build story。My Work 永遠即時：更新隨到隨顯、「Show updates」按鈕移除；header 改讀 claude-mem、連往 /viewer 的 Classic viewer並顯示 GitHub stars 按鈕；開啟的請求抽屜不再因其請求回到 feed 而自行重開（#5056）。
    • 請求分組與進度審查（v15.1.0）：build story 維持在上限內、story 更新會被告知剩餘空間（#5053、#5054）；每個 agent 的 refresh 失敗都會顯示；完成的 subagents 顯示為完成、可從 agent 卡標記完成；Claude Code subagent stops 被記錄。Server：per-prompt semantic injection（#5004）、設定的 embedding model 烘進 Docker image（#5003）。MCP：opt-in loopback HTTP transport 與 per-session workspaces（#5028）。
    • v15.1.0 修復精選：Observer——reasoning 有自己的預算、截斷回覆被回報（#5033）；Search——未過濾的 timelines 限定於其 anchor project（#5013）；Security——私有 prompt 文字不進 Goals；Worker——跨源 loopback 寫入 /api/import 被拒（#5025）；Redaction——小寫 key 名下的 AWS secret keys、PGP private key 區塊與加密 PKCS#8 keys（#5014、#5017）；Smart-read——Bun 回傳 Buffer 時讀取 tree-sitter probe 輸出（#5024）、Go type aliases（#5020）、Swift extension methods（#5016）；Agent runner——npm 安裝的 codex 與 gemini 可被找到並啟動；測試套件拆成 fast 與 integration lanes（#5032）。
    • 瀏覽器安裝流程（v15.2.0，#5031）：全新安裝改開瀏覽器設定流程——①Install：npx claude-mem install 安裝偵測到的 hooks、啟動 worker 並開瀏覽器；②Scan：讀取近 30 天支援的本地 agent 歷史（排除設定的專案與 agent 自寫 prompts、deduplicate、private-tag 清理與 redaction 先跑）；③Reveal：把過濾後的 owner prompts（gzip）上傳 CMEM Cloud 做 hosted intent extraction，回傳的 goals、rules 與 request groups 填入本地 My Work；④Storage choice：At Home 或 On The Go（後者走既有 pairing/login/checkout，記憶憑證在標記付款前先啟用）；⑤Finish Setup：安裝其他選定的本地工具、可匯入既有記憶；⑥What's next：搜尋已存記憶、把結果留成備註、交接給 My Work。既有安裝照舊開 My Work。目標與進度更新使用已安裝且登入的 agent：Claude Code 僅有界檔案工具與記憶 recall、Codex 跑嚴格 read-only profile（無寫入、無網路）、Gemini 內嵌準備好的證據且無 builtin tools/hooks/YOLO；每個存下的答案都過 worker validators。
    • Cloud 未分組對話不再讓安裝失敗（v15.2.0，#5060）：真實 30 天掃描中 hosted model 偶爾把對話排除在所有群組外，worker 過去會拋 Hosted extraction omitted conversation 並在 hosted run 成功後讓 setup 失敗——現在 Cloud 回傳的群組照存、未分組對話留在 My Work 成為自己的請求、本地更新稍後可再分組；未知或重複的 conversation ids 仍大聲失敗。需求：Node ^20.19.0 || >=22.12.0；使用 CMEM Cloud hosted history import 與 intent extraction。
    • npm trusted publishing（OIDC）（v15.2.1，#5063）：Publish to npm 的 GitHub Actions workflow 改以本 repo workflow 簽發的短效 OIDC token 向 npm 認證，取代自 v13.26.1 起每次 tag 都失敗的長效 NPM_TOKEN secret；trusted publishes 並帶 npm provenance attestation（連結套件與建置它的 commit/workflow）。無 plugin 或 worker 的 runtime 行為變更——本版存在是為了透過新發布路徑出貨。
    • My Work 卡片 Deliverables（v15.3.0，#5109）：請 agent 產出 deck、報告、HTML 頁或任何檔案，成品就在 My Work 該請求卡片正面 Deliverables 下一鍵可取——Stop hook 把該 turn 為你做的複製到 ~/.claude-mem/deliverables/<project>/（content-addressed，如 report-3f9a1c2b.md），副本活得比 worktree、暫存資料夾或 temp 目錄久；經 work_state_write 的 work_product/deliverable 欄位算數，source tree 之外寫出的 decks/documents/pages/images/video/spreadsheets 也算，原始碼檔絕不推論複製；SubagentStop 捕捉 subagent 從自身 transcript 的產出。Worker 以 GET /api/deliverables/:id/:filename 服務副本（與 recorded files 同樣的 loopback、same-origin 與 sandbox 規則）；markdown 與文字可內嵌開啟。隱私與上限明確：整個 prompt 為 <private> 的 turn 不留副本與記錄、他主機的 worker 不複製、每次 Stop 50 檔與每檔 512 MiB（觸及時回報、絕不靜默）、CLAUDE_MEM_DELIVERABLES_ENABLED=false 關閉。SessionStart 的 work-state rule 現在要求 agent 把你要求的東西寫成檔案、完成前附為 work_product。
    • v15.3.0 其他新功能：自動本地資料庫快照與 crash-safe restore——npx claude-mem backup [run|status|list] 與 npx claude-mem restore，預設關閉，CLAUDE_MEM_BACKUP_ENABLED=true 搭配 CLAUDE_MEM_BACKUP_INTERVAL_HOURS／CLAUDE_MEM_BACKUP_RETAIN_COUNT（#3751）；Notion export——每則新 observation 存入後即 upsert 進 Notion database，經 CLAUDE_MEM_NOTION_ENABLED＋token＋database id opt-in、絕不阻塞 capture（#4799）；Codex subagents 帶記憶 timeline——新增 SubagentStart hook 給新 subagent 與 SessionStart 相同的 context，繼承父歷史的 forks 略過、Codex 會請求信任新 hook 一次（#4760）；Runcrate preset 供 openai-compatible provider（#5067）。
    • v15.3.0 修復精選：Antigravity CLI——不再註冊 PreToolUse（它曾自動核准每個 agy tool call 並讓每個 call 排隊兩次，#5085），agy prompts 改為每 turn 記錄一次、agy 工作進得了 My Work（#5092）；Redaction——臨時 AWS 憑證完整 redact（ASIA access key IDs、session tokens 與 aws sts JSON 輸出中的 SecretAccessKey，#5066、#5073、#5080）；Transcripts——watcher checkpoints 等 buffered work 存完才釋出（#5072）、transcript-watch config 路徑跟隨 CLAUDE_MEM_DATA_DIR（#5070）；Observer parser 讀 model 定案的型別而非周邊 markup（#5077）；Windows——bun.exe 在非 ASCII 路徑時 launcher 經 8.3 短路徑編譯（#5089）；Release tooling——每個出貨 plugin manifest 帶相同版本、由 build 同步並在 CI 檢查（#5083、#5082、#5075）。
    • 完整教學見 lessons/v1510-v1530-my-work-viewer-and-install.mdx。
    上游 Release Notes ↗

  8. v15.0.2

    舊版本2026-10-24
    • 版本定位：v15.0.1→v15.0.2（2026-10-23 發布）。主軸：別讓 observer 的 reasoning 吃掉輸出預算（output budget）——Observer 請求預設關閉 reasoning，reasoning tokens 不再耗盡輸出預算、讓 session 一個 observation 都收不到；本版即 #5029 的 observer 修復（"Ships the observer repair from #5029."）。
    • Observer 請求預設關閉 reasoning：對 OpenRouter、cmem.ai gateway 與 OpenAI-compatible endpoints 的 Observer 請求現在預設停用 reasoning——"Observer requests to OpenRouter, the cmem.ai gateway, and OpenAI-compatible endpoints now disable reasoning by default, so reasoning tokens no longer fill the output budget and leave a session with zero observations."
    • 空回應記錄並重試一次：以 finish_reason=length 結束的空回應會被記錄（logged）、並在強制關閉 reasoning 的情況下重試一次——"An empty reply with finish_reason=length is logged and retried once with reasoning forced off."；這次重試計入既有的 paid-send budget、並受 per-attempt timeout 約束。
    • 計費如實累計兩次嘗試：Billed usage 保留重試的 prompt size，並加上兩次嘗試的 completion tokens 與成本——"Billed usage keeps the retry's prompt size and adds completion tokens and cost from both attempts."
    • Health status 點名作用中的 OpenRouter 憑證："Health status names the active OpenRouter credential, including a custom OPENROUTER_BASE_URL."——健康狀態會指出目前使用哪一個 OpenRouter credential，包括自訂的 OPENROUTER_BASE_URL。
    • OpenAI「Unsupported parameter」處理：OpenAI 的 "Unsupported parameter" 回應改為丟棄 reasoning 欄位並記住該 endpoint；強制 reasoning（mandatory-reasoning）與無效 effort 的拒絕維持原樣（"Mandatory-reasoning and invalid-effort refusals are left in place."）。
    • 以 stop 結束的空回應維持接受："Empty replies that finish with stop stay accepted."——觸發重試的是以 finish_reason=length 結束的空回應，以 stop 結束的空回應仍被接受。
    • 完整教學見 lessons/v150-smart-recall.mdx 的 v15.0.2 段落。
    上游 Release Notes ↗

  9. v15.0.1

    舊版本2026-10-23
    • 2026-10-23 查核：上游最新 release 仍為 v15.0.1（2026-10-20 發布），其後無新版本。
    • 版本定位：v14.0.1→v15.0.1，涵蓋 v15.0.0 與 v15.0.1 兩個 release（皆 2026-10-20 發布）。主軸：v15.0.0 把記憶回溯（recall）預設改為 Smart 三步工作流、移除 mem_search guided/auto API 與 flash_search；v15.0.1 修復 merged project alias 的 scope 一致性，讓 Smart 回溯跨步驟一致。
    • Smart recall 成為預設（v15.0.0）：Memory recall now defaults to Smart——「search the compact index, inspect context around relevant results, then fetch only the selected details」：先搜尋精簡索引（compact index）、檢視相關結果周圍的 context、再只抓取選中的細節；agent 在這三步之間自行推理相關性（"The agent reasons about relevance between these three steps."）。Local、cloud/Pro 與 standalone-server 的說明各自描述該執行環境可用的工具（"Local, cloud/Pro, and standalone-server instructions describe the tools available in that runtime."）。
    • 淺層單次查詢改用 dumb_search（v15.0.0）：optional one-call lookup 現在是 dumb_search，描述明確："Doesn't reason about the results. Fast, but shallow. Use Smart for reliable recall."——只做確定性的標題比對（deterministic title matching），不推理相關性。
    • API 移除與遷移（breaking）（v15.0.0）：舊 mem_search guided/auto API 與 flash_search 被移除，auto/guided modes 與 continuation cursors 一併移除（"Auto/guided modes and continuation cursors are removed."）。官方遷移指引：用 mem-search skill 做預設 Smart recall——Local 工具為 search → timeline → get_observations，Cloud/Pro 從 memory_search 起步、可用 get_summaries 抓取選中摘要；把舊 mem_search guided/auto 與 flash_search 呼叫換成 Smart workflow，或淺層查詢時明確選用 dumb_search；refresh 既有 MCP connections 讓 client 載入新的 tool catalog 與描述。
    • 正確性修復（v15.0.0）：cloud timeline 支援以選中的搜尋結果為錨點的 context（"Cloud timeline supports context anchored to a selected search result."）；standalone-server 的 recall 限縮在其設定的 server project，不再讀取 local worker 的記憶；selected-detail 輸出誠實回報其邊界、內容必須縮短時保留選中記錄的身分（identities）；native memory lookup 只用 observation-only indexes，mixed local indexes 保留 session/prompt ID 前綴，follow-up read 不會選到同編號但不同種類的記錄；installer prompts、公開文件、整合說明與產生的記憶指引統一採用 Smart-first 政策。
    • Other changes since v14.0.1（v15.0.0）：新增 Hermes Agent 記憶支援與安裝（含既有 YAML 設定的安全處理）；Anthropic API key 與 Claude subscription 之間的 fallback（含 quota 分類、在 message boundary 回到主要 provider）；local context 讀取期間 worker HTTP 請求保持回應、限制廣泛的 full-text fallback 搜尋、移除 quadratic tag-stripping 卡頓；記憶正確性（type="all" 搜尋所有類別、刪除的 observations 移除其 Chroma documents、Chroma 意外退出時 reject pending requests、Windows checkpoint 重新命名失敗時保留前一 checkpoint）；隱私與請求處理收緊（fully private prompts 不再變成 stored user requests、key redaction 處理尾端 dash、內部 Grok research briefs 不變成 user work、辨識多語言 work requests、OpenRouter field condensation 避免不必要的 reasoning）；橫跨 Windows、macOS、Conda、Qoder、Goose、OpenCode、Antigravity、Codex 與 TeamBrain 的安裝與執行期穩定性（launcher self-recursion 與 working-directory 處理、stale temporary-directory 清理、可操作的認證與 missing-runtime 錯誤、正確的 host hook registration）；新增選用的跨專案 context CLAUDE_MEM_CONTEXT_PROJECTS=all、修正 folder context 排序與 glob matching、清理過期的 orphaned summary spool entries、改進 effective-data-directory log lookup 與 cloud authentication telemetry。
    • v15.0.1：Keep Smart recall consistent across merged projects：Smart search、timeline context 與 selected observation details 現在使用同一個 checkout project scope——"An observation found through a merged project alias remains available in the next two steps, instead of incorrectly returning “not found.”"。具體而言：為 search results、explicit timeline anchors、query-selected timeline anchors 與 selected observation reads 解析相同的 project read keys；adopted records 保持可見，同時排除無關或未採用的記錄並尊重 platform-source filters；保留 v15.0.0 的 Smart 預設三步工作流與選用的 dumb_search——"No API or schema migration is required."。回歸涵蓋在 15.0.0 上失敗、隨此修復通過的真實 HTTP/SQLite 案例，以及相關的 scope-isolation 檢查。
    • 完整教學見 lessons/v150-smart-recall.mdx。
    上游 Release Notes ↗

  10. v14.0.1

    舊版本2026-10-18
    • 版本定位：v13.39.0→v14.0.1，涵蓋四個 release：v13.40.0 與 v13.41.0（2026-10-16 發布）、v14.0.0 與 v14.0.1（2026-10-17 發布）。主軸：TeamBrain 團隊共享記憶從終端機指令到正式產品、My Work 成為開門首頁（v13 → v14 的 major 升級主因）、build/release 工作流 skills 與 work-state 遙測。
    • TeamBrain 從終端機到正式產品（v13.40.0 → v14.0.0）：npx claude-mem teambrain join <invite-link> 用與 install 相同的 device-code 登入把本機加入團隊，瀏覽器核准裝置後選擇要共享的專案；另有 teambrain status、share、leave、start（#4815）。用團隊席次加入者保留自己的 local observer——加入不會切換你的 observer provider。裝入團隊後，SessionStart 附加簡短 team brief：本專案的 open collisions、近期 plans 與決策、還有誰在線、指派給你的項目；agent 另獲唯讀 team_brief 與 team_search MCP tools。v14.0.0 起 TeamBrain 以 self-serve 上線：$50 per seat per month，官方網址 cmem.ai/teambrain。
    • My Work：開門即見你交代過什麼（v14.0.0）：Claude-Mem 改以 My Work 開啟——本機、可讀的檢視，呈現你給 agent 的每個請求。Cards、List、Agents 三種檢視；每個請求有一段用你已設定的模型寫的日常語言摘要（新摘要撰寫期間保留上一份有效摘要；無相容 provider 時顯示原始記錄文字）；即時狀態（In progress、Needs you、No recent update、Ready to check、Checked update）；Review 讓你親自把結果標記為 checked——agent 回報 "done" 永不等於人類確認；點開任一請求可下探 workstreams、記錄的證據與原始請求。官方明言：My Work is free, open source and runs on your machine。
    • build / release 工作流 skills（v13.41.0）：build 透過 make-plan、do、babysit 委派一個編碼 session；release 透過 version-bump 與 childhood 委派發布；build-and-release 跑完兩者，先合併就緒的 PR 再從更新後的 main 續跑；恢復既有 childhood skill 讓發布後驗證包含在內。官方強調這些 wrapper 刻意短小、重用既有工作流。
    • Work-state 同步與遙測（v13.40.0/41.0）：agent 的 work-state tracker（work_state_write/work_state_read）同步到雲端成為 work_state content kind（同步伺服器未啟用前 rows 留在本地、绝不丢棄；舊版跳過 work-state ops 的裝置升級後補套用一次）。v13.41.0 加 privacy-preserving PostHog rollups：按 release、host platform 與記錄的 agent role 匯總 work-state 用量，不送 task titles、prompt 文字、專案路徑或原始 session/agent IDs；既有 telemetry opt-out 依然有效；此 release 不回填歷史用量。
    • v14.0.1：新更新到達時，卡片保留原本做事的 agent，不再顯示 Unassigned work。
    • 升級注意（v13.40.0）：本地資料庫 schema 首次開啟時升到 v67；舊版拒開新版開過的資料庫（不可降級），共用 ~/.claude-mem 的每個 install 都要更新；多機使用者請全部升級——v13.29.0 以前的版本無法跳過不認得的同步內容。
    • 完整教學見 lessons/v1340-v1401-teambrain-and-my-work.mdx。
    上游 Release Notes ↗

  11. v13.39.0

    舊版本2026-10-14
    • 2026-10-16 查核：上游最新 release 仍為 v13.39.0（2026-10-13 發布），其後無新版本。
    • 版本定位：v13.36.1→v13.39.0，涵蓋三個 release（皆 2026-10-13 發布）：v13.37.0 修復 v13.36.1 marketplace 更新事故、v13.38.0 讓 hooks 直呼 claude-mem、v13.39.0 恢復 Codex subagent 壓縮後的記憶 timeline。
    • v13.36.1 marketplace 事故修復（v13.37.0）：13.36.1 發布後合併的變更把帶著 git stash conflict markers 的構建產物 commit 進 plugin 檔案——plugin 從 main 安裝，自動更新的裝置在同一個 13.36.1 版號下拿到這些檔案，worker 以 Unexpected << 失敗、mcp-search 關閉連線、記憶擷取停止（npm 版 claude-mem@13.36.1 先發布、不受影響）。CI 現在會先檢查 committed plugin files（merge-conflict markers + node --check）。曾為 13.35.0 關閉 auto-update 釘版的使用者，請重開 autoUpdate 並重啟。
    • Worker 等 locked database（v13.37.0）：13.36.0 的 schema-writer check 在 busy timeout 設定前執行，1ms 內以 database is locked 失敗且兩次失敗不重啟——現在會等鎖。CLAUDE_MEM_QUOTA_FALLBACK_PROVIDER 預設改為 claude（涵蓋 rate-limited／over-capacity／down／回重複批次；設 off 可等待 provider）。
    • Hooks 直呼 claude-mem（v13.38.0，#4345）：每個 Claude Code hook 改用 exec form "command": "claude-mem", "args": [...]、不經 shell——Windows 消除每次工具呼叫閃 console 視窗搶焦點的問題（#3605 等）；npx claude-mem install/update 在本機編譯 launcher（mac/Linux ~/.local/bin/claude-mem、Windows %LOCALAPPDATA%\claude-mem\bin\claude-mem.exe 並加 PATH）；marketplace 安裝自我修復 launcher；launcher 掛掉時 fail open（印一行 claude-mem: <reason>, continuing without memory）。exec form hooks 需 Claude Code 2.1.139+（install／doctor 對舊版警告）；PATH 剛加入時，首次 session 後需從新終端機重啟 Claude Code。
    • v13.38.0 社群修正（16 項）：observer 對拒絕 thinking 參數的 gateway 重試一次（CLAUDE_MEM_OBSERVER_THINKING 文件化）；worker 處理大 repo 不再卡（git 指令不阻擋 event loop）；CLAUDE_MEM_LLM_STREAM_IDLE_TIMEOUT_MS（預設仍 90 秒）；CLAUDE_MEM_DISABLE_SUMMARY=1（headless／唯讀）；mode prompts 驗證（使用者 mode 不得遮蔽內建）；manual sessions 保留 platform、error-shaped 回應不再誤當 host observer、後裝的 Grok agents 被監看；Codex installer 丟掉死 marketplace 註冊；semantic search 空過濾與畸形 concept-file 資料；Sessions 專案名大小寫；Feed 同時間戳穩定最新在前；原生 turn ids 不合併、restore 保留；刪除最後一則記憶立即回 welcome hint；corpus 無上限時 500 observations／上限大於 100 不截斷；Chroma 同記憶寫入序列化並重讀 current row；self-hosted server reclaimed generation；IPv6 主機加括號；cowork plugin session-init 背景化。
    • Codex subagent 壓縮後恢復記憶（v13.39.0，#4733）：Codex 不對 subagent threads 送 SessionStart，壓縮過的 subagent 一直拿不到記憶——新增 PostCompact hook 以 session_id + agent_id 標記、該 thread 下一個 PostToolUse 記錄 observation 並一次性回傳 timeline as additionalContext、SessionStart 清除標記（root thread 不會拿兩次）；共享 session-marker file 的檔案處理同時支撐 Codex compaction gate 與 Kimi context gate。
    • 既有使用者影響：marketplace 安裝且停在壞掉的 13.36.1 者應立即升級；exec form hooks 需 Claude Code 2.1.139+；Windows 使用者升級後 launcher 位於 %LOCALAPPDATA%\claude-mem\bin，首次需從新終端機重啟。
    上游 Release Notes ↗

  12. v13.36.1

    舊版本2026-10-13
    • 版本定位：v13.35.0→v13.36.1，涵蓋 v13.36.0（2026-10-12 發布，官方定位為 community release——自 v13.35.0 以來幾乎每一項變更都來自外部貢獻者並以他們自己的名義合併）與 v13.36.1（同日發布的修補版：關閉審查 v13.36.0 時發現的三個問題，外加八項社群修補，官方明言 Upgrading is recommended）。主軸：provider 失效時不再丟棄記憶、隱私與資料庫安全、搜尋與 Chroma 可靠性。
    • Provider 中斷改為暫停、保留工作（v13.36.0）：Anthropic 額度為空、組織封鎖訂閱存取，或本地模型伺服器離線時，claude-mem 現在暫停觀察器 (observer) 並保留工作，而不是丟棄它（@Mola-maker）；觀察器串流提早結束時，其批次被交回重新處理（@shantanukhanwalkar）。
    • 隱私：<private> 內容不再離開 hook（v13.36.1，#4721）：在 server runtime 下，檔案編輯、工具輸入輸出與 session 起始 prompt 過去帶著 private 區段送達伺服器，且伺服器把它們留在原始事件紀錄中（原本只在組模型 prompt 時才移除）。現在 private 區段在離開 hook 前就移除，伺服器在儲存事件或 session metadata 前再移除一次；worker runtime（預設）不受影響。
    • 資料庫與 Chroma 競態（v13.36.1）：判斷舊版不得開啟已被新版升級之資料庫的檢查，改為在單一 SQLite 寫入鎖內讀取並記錄 schema writer、且在任何 migration 執行之前完成（#4724——此前兩個 worker 同時開庫可能雙雙通過檢查）；每個 Chroma 連線現在擁有自己的 writer-lock token 並只釋放該鎖（#4722——關機期間重連不會留下未上鎖的 sidecar 而讓第二個 writer 寫入同一 store），orphan sweep 的行程表解析新增 fixture 測試。
    • 搜尋改進（v13.36.0）：分頁正確；中文、日文、韓文與泰文詞彙能在句中被找到；長自然語言查詢在沒有記憶符合每一個詞時退回任一詞匹配；資料庫升級後搜尋觸發恢復，另有畸形檔案清單、純文字概念、對絕對路徑的資料夾搜尋、一致日期解析與原生搜尋指令的更好 pattern 等強健性修正。
    • Chroma 可靠性（v13.36.0）：大型 store 在重開機後不再停滯；佔住資料目錄的孤兒 chroma-mcp 行程在啟動前被安全清除，不再造成鎖爭奪；關閉 Chroma 被完整遵守、啟動時更少重寫；重音感知的重複偵測與修正後的相似度門檻。
    • 新設定與新整合（v13.36.0）：Qoder plugin、Screenpipe skill（搜尋會議與螢幕歷史並存成記憶）、Atlas Cloud preset（OpenAI-compatible provider）；設定項 CLAUDE_MEM_OPENROUTER_TEMPERATURE、CLAUDE_MEM_SEMANTIC_INJECT_FORMAT=index（逐 prompt 精簡注入）、CLAUDE_MEM_WORK_STATE_ENABLED=false（關閉 work-state to-do 規則）、CLAUDE_MEM_TOOL_USES_RETENTION_DAYS（opt-in 修剪原始工具日誌，預設保留全部）；重複候選可記錄 distinct／dismissed 判定；viewer 新增 Claude auth method 控制項；server runtime 的記憶上傳改為冪等。
    • 其他修正：使用者資料夾名稱含韓文、日文等非 ASCII 字元時能再次找到 Bun 與 Claude；hooks 不再把專案的 tsconfig 當成錯誤回報（影響 React Native 與 Expo 專案）；viewer 只儲存你改動的部分，舊設定分頁不會覆蓋你在別處的變更；每次關機的每個步驟都會執行、工具輸入為 null 的呼叫也會被捕捉。v13.36.1 另有 @rudycelekli 的八項社群修補：constructor 等 integration id 不再經 alias 表解析、Postgres 數值設定只接受正整數（5ms 退回預設）、過大的 Gemini retry hint 被忽略、以 UTF-8 BOM 開頭的 billing-type 檔案正確讀取、API-key 設定陣列只保留字串、畸形 Gemini 回應段落不再丟棄整個答案、包裝錯誤中的 refused connections 可辨識、hook launcher 在啟動 Node／Bun 前遵守環境變數 opt-out 旗標。
    • Project 變更（v13.36.0）：main 現在是唯一分支，core-dev 與 community-edge 退役，PR 請開向 main。
    • 既有使用者影響：此版修補的三個問題以 server runtime 的隱私洩漏最需注意（worker runtime 不受影響）；資料庫與 Chroma 的競態修補關係到多 worker 併發下的資料完整性，官方建議升級。
    上游 Release Notes ↗

  13. v13.35.0

    舊版本2026-10-12
    • 版本定位：v13.34.2→v13.35.0（單一 release，2026-10-09 發布）。主軸是記憶讀取介面整個重做：單一搜尋工具 mem_search 以有界步驟揭露記憶（緊湊索引 → anchor 周圍 context → 一批選定細節），工具回覆改為針對問題撰寫的可讀文字（不再傾印原始 JSON）。
    • mem_search 兩種模式：guided（預設）以 mem-search step 1 of 3 標注三階段，每則回覆結尾附 Continue with: cursor，可提早收手；automatic（mode: "auto"）單次呼叫跑完同樣三階段，以排序詞彙檢索挑 anchor、不做事 LLM 呼叫。cursor 為 27 字元代幣，搜尋狀態留在 server-side、15 分鐘過期；邊界：limit ≤20、maxDetails 預設 3 上限 5、depth 預設 2 上限 3、查詢 ≤500 字元。本地 worker 與 hosted cmem.ai MCP 共用同一 engine source、回傳相同 model-facing 文字；search/timeline/get_observations 保留給舊客戶端。
    • 策展回覆與檢索不再自我觀察：搜尋、context、選定記錄、corpus、events、job 查詢的 MCP 回覆改為可讀短文字（內部 HTTP 資料仍可供程式取用）；記憶散文中的 JSON 與程式碼範例原樣保留；錯誤為白話訊息。對 claude-mem 自家 search/context 工具與原生 memory_* 查詢的呼叫排除在 observation capture 之外——搜尋記憶不再產生「關於搜尋記憶」的新記憶。
    • save_memory 與記憶守則：新工具 save_memory({ text, title?, project?, metadata? })（worker runtime）記錄明確偏好、修正、決策、handoff 與經驗，回傳短收據；server runtime 下在碰本地 worker 前即拒絕並指向 observation_add。SessionStart 附記憶使用守則（存前先查、精簡、事實與猜測分開、不含憑證、to-do 走 work_state_write；CLAUDE_MEM_MEMORY_INSTRUCTIONS_ENABLED=false 可關）。
    • 原生記憶查詢橋接（Claude Code／Codex）：PreToolUse hook 認得 memory_search、本地 memory 工具讀取與限定在記憶資料夾/note roots 的 Read/Grep/Glob/Bash 讀取，自動補一份同主題 mem_search 結果（上限 10,000 字元、框架為不得作為指令的 retrieved data、JSON 回覆不注入）；僅 worker runtime 生效，CLAUDE_MEM_MEMORY_SEARCH_HOOK_ENABLED=false 停用。
    • Opt-in Markdown 筆記 watcher：CLAUDE_MEM_MEMORY_WATCH_ROOTS 最多 8 個 { path, project }；輪詢且等內容穩定才匯入，跳過隱藏檔/symlink/>64 KiB；以 O_NOFOLLOW 與 device/inode/size/mtime/ctime 五重身份驗證關閉「換父資料夾讀到 root 外檔案」的競態；編輯存為不同 revisions、指紋跨重啟去重、刪原始檔不刪封存；改設定後需重啟 worker。
    • 安全與整合修復：runtime routing 遵守 CLAUDE_MEM_RUNTIME（含 legacy server-beta）、絕不回退本地 worker；修復 chroma-mcp 0.2.6 釘 mcp[cli]==1.6.0 與 pydantic 2.14 的 import 衝突（launcher 加 pydantic<2.14 覆寫，#4595）；OpenCode plugin 改為 V1/V2 雙形——同一 bundle 在 OpenCode V1（1.18.29+）與 V2 載入、正確抽取結構化工具結果（不再存成字面 undefined），於 OpenCode v2.0.22 端到端驗證（#4577）。
    • 驗證與升級：8 個 CI job 全過；完整套件 8,139 個測試（783 檔）——8,105 過、34 skip、0 失敗、38,212 assertions；本地與 hosted 引擎 shared source 逐位元組相同。升級跑 npx claude-mem@13.35.0 install 並重啟 worker；新工具定義需開新 session 或重載 MCP 連線。模型選擇、provider 路由與計費行為不變。
    上游 Release Notes ↗

  14. v13.34.2

    舊版本2026-10-07
    • 版本定位：v13.28.0→v13.34.2，涵蓋 v13.29.0～v13.34.2 十個 release（2026-10-03～10-06，無跳號）。主軸：agent 把 to-do list 放進 claude-mem 的 work state（v13.29.0）、hooks 不再等 worker 的非同步化（v13.30.0）、SessionStart 秒開（v13.31.0）、File Read Gate 重生（v13.32.0/33.0）、Pi 與 DeepSeek Harness 整合（v13.34.0），以及 prompt-cache 修復（v13.30.1/v13.34.2）。
    • Work state：agent 的 to-do list 進 claude-mem（v13.29.0，#4340）：每個 session 的 SessionStart 以 work-state 段落開場——一條規則要 agent 以 work_state_write/work_state_read 作為 canonical to-do list，接著列出專案中仍開啟的項目（每項附最後變更時間，上限 3,000 字元；無開啟項目時 806 字元）；記憶體塞進 10,000 字元上限的剩餘空間。條目存入新的 append-only work_state_entries 表（schema v61），不進 repo。Claude Code 未給 Claude 5 原生 to-do tool，此前 session 結束時沒有任何東西記錄進行中/剩餘的工作。
    • hooks 不再等 worker（v13.30.0，#4368）：observation、file-edit、Stop 與 SessionEnd hooks 把事件寫入 ~/.claude-mem/state/hook-spool/ 後立即返回——不等 worker、不啟動 worker（7 天未處理移至 expired/）；SessionStart 讀 worker 預先準備好的 context-cache（變更後約 2 秒刷新）；worker 以 GET /api/ready 串流啟動階段；雲端同步改走 Supabase Realtime 私有頻道。v13.30.1 進一步修 --continue/--resume：恢復中的對話不再注入新 timeline——重新注入會改變 prompt prefix、破壞 prompt-cache 重用（#4423）。
    • Observer 成本下降（v13.30.0/v13.34.2）：使用者 prompt 不再有獨立 model call（幾乎總是「nothing to record」——九 token 回覆配一整個 prompt；CLAUDE_MEM_OBSERVE_BARE_PROMPTS=true 可恢復，#4336）；observer prompts 前綴固定可被 provider 快取（code mode 兩 session 前 ~7,260 字元相同，原為 422）；OpenRouter 請求帶 session/trace labels 維持快取親和；Claude 路徑的 observer thinking 真正關閉（#3245 用了 Agent SDK 忽略的選項名，Claude Sonnet 4.5 上約 70% observer 輸出 token 花在 thinking，#4335）。v13.34.2 移除 v13.29.0 引入的 history pruning——pruning 改寫已送出的訊息、從第 5 次 observation 起每個請求都改動較早訊息，prefix 式快取（OpenRouter/Gemini）無法重用；現在同 generation 內已送出的訊息不再變動（長 session 會較常 recycle generation，成本影響未量測、不做宣稱）。
    • SessionStart 秒開（v13.31.0）：1.2 GB 資料庫上 SessionStart 原需約 3 秒（最糟 44 秒）——新的 project+date 索引（schema v63）把「每個專案最新記憶」查詢從 ~21,700 rows（63 MB）降到約 4 ms；project-alias 查詢以 covering indexes（schema v64）從 7,499 頁降到 355 頁/9 ms；開雲端同步時也先用本機預計算 context，pull 在背景跑，session 啟動不等網路。
    • File Read Gate 重生（v13.32.0/v13.33.0）：Claude Code 主 session 整檔 Read 已有 observations 的程式碼檔時被擋，改給該檔的 observation timeline。此功能 4 月曾建、因弄壞 Edit 改為 allow+context、7 月 hook 非同步化後無法擋——v13.32.0 帶著「targeted Read 放行」的 Edit 修復回歸且預設開啟（CLAUDE_MEM_FILE_READ_GATE_ENABLED=false 可關）。v13.33.0 兩個修正：marketplace 安裝的 plugin 依賴不執行 install script、tree-sitter CLI 不在——worker 啟動時自行下載並以 SHA-256 驗證（釘選 0.26.9）；攔截門檻提高為 32 KB 以上（1,500B～32KB 仍附 timeline context）——eval 顯示 19 KB 檔擋下來對 Opus 5.5 反而 +20% 成本，49 KB 檔則 −38%/−30%；擋下後 Edit 仍可用（5 次編輯全數正確改到目標行）。
    • 新 provider 與 host（v13.29.0/v13.34.0）：openai-compatible provider（presets：nvidia-nim、deepseek、groq、together、ollama、lmstudio、vllm、minimax 等）；Codex subscription provider（以 ChatGPT 訂閱跑 observer）；多 key 支援（Gemini/OpenRouter/OpenAI-compat）；Kimi Code CLI 與 OMP (Oh My Pi) 安裝支援；v13.34.0 新增 Pi（mem_search/mem_timeline/mem_get_observations 漸進召回）與 DeepSeek Harness（mem_save/mem_context 等）一方整合——分別改編自 pi-mem（MIT）與 dsh-claude-mem（Apache-2.0）並隨附 attribution；安裝器改為詢問你實際使用的 agents 並預選偵測結果。
    • 雲端同步修復（v13.31.1）：遷至 Supabase 後，其 Cloudflare 防火牆依內容擋下部分上傳（HTML「Attention Required!」頁），worker 誤讀為 invalid token 而暫停同步並要求重連——server 端改為壓縮上傳穿過防火牆（即時生效）、worker 端 HTML 401/403 改為普通可重試失敗。
    • 預設值變更（升級注意）（v13.29.0）：CLAUDE_MEM_LLM_TIMEOUT_MS 預設 30,000 → 180,000（3 分鐘）；OpenRouter 預設模型改 cohere/north-mini-code:free（舊 xiaomi/mimo-v2-flash:free 已除役）；subagent observations 預設不進 SessionStart（CLAUDE_MEM_CONTEXT_MAIN_AGENT_ONLY=true）；hooks 不再以 exit 2 阻擋 session；UserPromptSubmit hook timeout 60 → 15 秒；worker 拒絕未知 host 名（DNS-rebinding 防護）；Antigravity 用戶需重跑 npx claude-mem install --ide antigravity。
    • 其他要點：超大 transcript——Stop hook 改從檔尾以 bounded chunks 反向讀取，2.16 GB transcript 約 1 ms / 27 MB（不再 ENOMEM）；失敗的 tool call 也成為 observations（PostToolUseFailure）；新 /handoff skill 寫出 HANDOFF.md（目標、現況、相關檔案、失敗嘗試、下一步與 memory pointers）；Linux/Windows 登入先讀 ~/.claude/.credentials.json；plan mode 下 14 個唯讀工具免權限提示；settings.json 以 0600 建立；opt-in 的 secret redaction（11 種內建 patterns）；命名環境（CLAUDE_MEM_PROJECT_ENVIRONMENTS）與 git-remote 專案命名（org/repo slug）；iFlytek Spark preset。
    • 既有使用者影響：升級後 SessionStart 明顯變快（大資料庫尤甚）；Claude Code 中整檔 Read 大型程式碼檔會被擋（可用設定關閉）；OpenRouter/Gemini observer 用戶的 prompt-cache 重用恢復（v13.34.2）；多個預設值改變（見上）；marketplace 安裝用戶首次啟動 worker 會背景下載 tree-sitter CLI。
    上游 Release Notes ↗

  15. v13.28.0

    舊版本2026-09-26
    • 版本定位：v13.25.3→v13.28.0，涵蓋 v13.26.0～v13.28.0。2026-09-26 一天內連發五版，主軸是雲端同步搬離 Cloudflare、認證失敗行為修正、agent-cost-report 實測計價重建、Grok Bot INDEX 修正與非互動安裝修復。
    • 雲端同步架構搬遷（v13.26.0，#4232/#4233）：舊 Cloudflare Worker hub（sync-hub.black-pond-afbb.workers.dev）因 Free plan 上限每個請求都失敗，CMEM Pro 雲端同步改跑 protocol-v2 新 hub https://sync.cmem.ai（Fly + Neon Postgres）。啟動時自動把仍指向 legacy workers.dev 的 CLAUDE_MEM_CLOUD_SYNC_HUB_URL 改寫為新 hub，不需重新連線；sync 開始遵守 429/503 的 Retry-After；push checkpoint 驗證放寬，hub 位移不再卡死同步；Worker 另加 FORWARD_ORIGIN pass-through 模式。
    • 認證失敗不再無限重試（v13.26.1）：sync server 回 401/403 時暫停雲端同步、每小時重查、續約後自動恢復；狀態可解釋成因（訂閱失效 → cmem.ai/pro 續訂；token 失效 → cmem.ai 重新 Connect）。暫停或長期失敗會以一行白話顯示在 SessionStart context，/api/sync/status 新增 authError 與 health；HTML 錯誤頁改為摘要而非整頁 dump。同版修 #4228（關閉雲端同步的安裝在 worker 啟動時清掉殘留 sync_outbox backlog）與 #4086（被伺服器持續拒絕的單一 op 三次後隔離，其餘佇列續傳）。
    • agent-cost-report 技能重建（v13.27.0/#4238）：改以實測資料計價——Claude Code / Codex transcript token 依 OpenRouter list price 計價並標示 ESTIMATED；note-taker（observer）成本分開計算、永不併入 headline；measured provider spend 只取自 sanctioned 來源（OpenRouter per-key snapshot，附 UTC bucket 標籤）；unavailable 永不顯示為 $0。預設視窗為 PT 最近 7 個完整日（不含今天），產出自帶 report.html＋PDF、report.json、line-items.csv、evidence.json；pipeline CLI（scripts/acr.py，stdlib Python）含 117 個單元測試。v13.27.1 補上 read-only GitHub merged-PR wins 來源（#4241）。
    • Grok Bot / live INDEX（v13.27.1/#4240）：每個 seat 的 80 行 zz-claude-mem-inject.md 先列該 seat 自己的 project rows，剩餘空位才由 house-wide rows 遞補，seat 填滿視窗時跳過 house query；經 POST /api/memory/save（如 grok-seat-save）儲存的 rows 不再被 concept filter 排除，手動儲存成功後觸發 INDEX refresh。
    • 非互動安裝修復（v13.28.0）：無 TTY 的 npx claude-mem install（AI agent、CI、script）不再中止於 "provider must be explicit"——全新安裝無 --provider 時預設 Anthropic plan（local memory），既有 config 保留已存 provider，npx claude-mem update 不會把 CMEM Pro 安裝翻掉；保留的 gemini / openrouter provider 需有可用 key；跳過登入的安裝在成功訊息後印出可選的 deferred sign-in link（best-effort、不改變 exit status、設 CI 時略過）；互動式 OAuth 等待改為尊重 pairing 的 expires_in（上限 30 分鐘）。
    • 移除 / Breaking Change：無核心 memory API removal；legacy workers.dev hub URL 會自動改寫，無需手動遷移步驟。
    • 既有使用者影響：CMEM Pro 使用者不需重新 Connect（hub URL 自動遷移）；同步長期失敗時會在 SessionStart 看到可解釋的狀態行，而非靜默；使用非互動安裝的自動化流程不再需要 --provider workaround；成本報告數字改以 list price 標示 ESTIMATED。
    上游 Release Notes ↗

  16. v13.25.3

    舊版本2026-09-21
    • 版本定位：v13.24.1→v13.25.3，涵蓋 v13.24.2～v13.25.3。這段是典型的穩定線修補：session 觀察品質、worker / supervisor 可靠性、Windows 與 macOS 安裝路徑修正，以及 v13.25.3 的安全性強化。
    • 安全性強化（v13.25.3，#4166）：強化未認證 settings 寫入防護與 telemetry 錯誤內容的 scrubbing。
    • 觀察品質（v13.24.9/v13.24.18/v13.24.22）：救回 prose-only observations 而非丟棄（#3363，closes #3351）；跳過無文字的 assistant frames（#3501）；不再丟棄 session-summary 回應（#4029）；session-summary 輸入以 payload 大小而非事件計數設限（#4030）；空標題 observations 在 capture 時跳過（#3176）；從 observation prompt 剝離 image payloads（#3996）。
    • Worker / supervisor 可靠性（v13.24.15/v13.24.19/v13.24.20）：daemon 不再繼承使用者專案 cwd、worker cwd 改為 DATA_DIR（修 Windows 資料夾鎖死）；worker-unavailable fail-loud latch 只觸發一次後 fail-open（#4033）；health probes 尊重呼叫端剩餘 deadline（#4026）；sync-hub 的排程 projection repair 工作設限（#4046）。
    • 安裝 / 平台修正（v13.24.12/v13.24.13/v13.24.19）：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。
    • 行為 / 資源邊界：quota/reactive 錯誤會暫停 session 而非重試到死（#3999）；GPT-5 400s 時重試 max_completion_tokens（#4003）；cloud sync 未設定時 sync_outbox 成長設限（#4031）；memory_session_id 只註冊一次（#4027）；FileTailer 讀取序列化並在截斷時清 partial（#4019）；不再建立空 CLAUDE.md（#4015）；hook stdin 畸形時 fail open（#4006）；rehydration 使用最新 user_prompts 文字（#4049）。
    • 移除 / Breaking Change：這段版本無核心 memory API 或安裝面 breaking；全是修補與強化。
    • 既有使用者影響：升級收益主要是穩定性（長 session、Windows、quota 狀態）與安全性；無需遷移步驟。
    上游 Release Notes ↗

  17. 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、版本一致性與依賴服務可用性。
    上游 Release Notes ↗

  18. 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 天仍為有效值。
    上游 Release Notes ↗

  19. v13.12.4

    舊版本2026-08-10
    • 本站此前的記錄版本，已升級至 v13.14.0。

  20. 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 Notes ↗

圖例

  • 當前版本　本站現在記錄的版本
  • 舊版本　已被取代，保留作歷史對照
  • 已同步　與上游 release 對齊
  • 僅上游變動　上游 main 有 commit，但未發佈新版