概述

Claude-Mem v15 系列涵蓋兩個 release：v15.0.0 與 v15.0.1（皆 2026-10-20 發布）。主軸是記憶回溯（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.」

三步依序是：

1. 搜尋精簡索引（compact index）——先在輕量的索引上找到候選結果。
2. 檢視相關結果周圍的 context——不急著抓全文，先看結果周邊的脈絡。
3. 只抓取選中的細節——agent 判斷哪些記錄真正相關，才抓取它們的完整內容。

官方強調中間的判斷由 agent 自己做：「The agent reasons about relevance between these three steps.」另外，「Local, cloud/Pro, and standalone-server instructions describe the tools available in that runtime」——不同執行環境的說明各自列出該環境實際可用的工具。

API 移除與遷移（breaking change）

官方的遷移指引：

• 預設 Smart recall：使用 mem-search skill。Local 環境的工具鏈是 search → timeline → get_observations；Cloud/Pro 從 memory_search 起步，可用 get_summaries 抓取選中的摘要。
• 替換舊呼叫：把原本的 mem_search guided/auto 與 flash_search 呼叫改走 Smart workflow；確定只需要淺層查詢時，明確選用 dumb_search。
• 刷新 MCP 連線：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 前綴，後續讀取不會因編號相同而選到不同種類的記錄。
• 文件與指引統一：installer prompts、公開文件、整合說明與產生的記憶指引都採用同一套 Smart-first 政策。

此外，release notes 的「Other changes since v14.0.1」一節列出多項變更：新增 Hermes Agent 記憶支援與安裝（含既有 YAML 設定的安全處理）、Anthropic API key 與 Claude subscription 間的 fallback（含 quota 分類、在 message boundary 回到主要 provider）、local context 讀取期間 worker HTTP 請求保持回應與移除 quadratic tag-stripping 卡頓、多項記憶正確性與隱私收緊修復、橫跨 Windows/macOS/Conda/Qoder/Goose/OpenCode/Antigravity/Codex/TeamBrain 的安裝與執行期穩定性改善，以及選用的跨專案 context CLAUDE_MEM_CONTEXT_PROJECTS=all 等。

v15.0.1：merged project alias 的 scope 一致性

v15.0.0 發布後不到一小時，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。
• 保留 Smart 預設三步工作流與選用的 dumb_search——「No API or schema migration is required.」

回歸測試涵蓋在 15.0.0 上失敗、隨此修復通過的真實 HTTP/SQLite 案例，以及相關的 scope-isolation 檢查。

v15.0.2：observer 的 reasoning 不再吃掉輸出預算

v15.0.2（2026-10-23 發布）是 observer 的修復版，官方定位「Ships the observer repair from #5029.」——問題出在推理型 provider 的 reasoning tokens 佔滿輸出預算，導致某些 session 一個 observation 都收不到。

空回應的處理也一併收緊：

• 以長度上限結束的空回應會重試：「An empty reply with finish_reason=length is logged and retried once with reasoning forced off.」——這類空回應會被記錄，並在強制關閉 reasoning 的情況下重試一次；重試計入既有的 paid-send budget，且受 per-attempt timeout 約束。
• 計費如實反映兩次嘗試：「Billed usage keeps the retry’s prompt size and adds completion tokens and cost from both attempts.」——保留重試的 prompt 大小，completion tokens 與成本則合計兩次。
• 以 stop 結束的空回應維持接受：「Empty replies that finish with stop stay accepted.」重試只針對 finish_reason=length。

其他修復：

• Health status 點名憑證：「Health status names the active OpenRouter credential, including a custom OPENROUTER_BASE_URL.」——健康狀態會指出目前作用中的 OpenRouter credential，包含自訂 base URL。
• OpenAI 的 Unsupported parameter：遇到這個回應時改為丟棄 reasoning 欄位並記住該 endpoint；強制 reasoning（mandatory-reasoning）與無效 effort 的拒絕維持原樣（「Mandatory-reasoning and invalid-effort refusals are left in place.」）。

動手升級檢查清單

延伸閱讀

• 官方 v15.0.0 release notes
• 官方 v15.0.1 release notes
• 官方 v15.0.2 release notes
• 前一課：v1340-v1401-teambrain-and-my-work——TeamBrain 與 My Work