跳到主內容
TechSpecs搜尋

Theme / v15.10.0

Claude-Mem

Claude Code 持久化記憶系統

主題首頁GitHub ↗
基礎觀念

v15.1.0～v15.3.0：React My Work、瀏覽器安裝與 Deliverables

🟡 中階｜兩天四版：v15.1.0 以 React My Work viewer 取代 localhost 檢視器（live worker data、每個請求一張卡）；v15.2.0 全新安裝改走瀏覽器六步流程（掃 30 天歷史→上傳 CMEM Cloud 萃取意圖→儲存選擇）；v15.2.1 改用 npm OIDC trusted publishing；v15.3.0 在 My Work 卡片加入 Deliverables——Stop hook 把成果複製到 ~/.claude-mem/deliverables/（content-addressed、上限 50 檔與 512 MiB），另有本機快照 backup/restore 與 Notion 匯出。含互動測驗與檢查清單。

概述

v15.1.0、v15.2.0、v15.2.1 於 2026-10-25、v15.3.0 於 2026-10-26 接連發布——兩天四版，主線是把 Claude-Mem 從「記憶庫」推向「看得見的工作面板」：

  1. v15.1.0：localhost viewer 換成 React My Work viewer，直接讀 live worker data。
  2. v15.2.0：全新安裝改走瀏覽器六步流程，把既有 30 天歷史轉成 Work、Goals 與 Rules。
  3. v15.2.1：npm 發布改用 OIDC trusted publishing（無 runtime 變更）。
  4. v15.3.0：My Work 卡片正面加上 Deliverables——agent 做出的檔案一鍵可取。

v15.1.0：React My Work viewer

官方原文：「The localhost viewer at http://localhost:37777 is replaced by the React My Work viewer on live worker data」——新檢視器的要素（#5010）：

  • 每個人類請求一張卡（one card per human request）
  • 進度表（progress meters）、owner goals、goal alignment
  • shipping velocity 與 build story

My Work 從此永遠 live：更新隨到隨顯，「Show updates」按鈕移除；header 改讀「claude-mem」並連到 Classic viewer（/viewer）與 GitHub stars（#5056）；開啟中的 request drawer 不會在其請求回到 feed 時自行重開。

請求分組與進度檢閱（#5053、#5054）：build story 維持在上限內、story 更新被告知剩餘空間；每個 agent 的 refresh 失敗都會顯示；結束的 subagent 顯示為 finished、可從 agent 卡標記；Claude Code 的 subagent stop 也被記錄。

Server/MCP：server 模式支援 per-prompt semantic injection（#5004）；設定的 embedding model 烤進 Docker image（#5003）；MCP 新增 opt-in loopback HTTP transport 與 per-session workspaces（#5028）。

修復選摘：observer 的 reasoning 有自己的預算、截斷回應如實回報（#5033）；未過濾 timeline 限定在其錨點專案（#5013）；跨來源 loopback 寫入 /api/import 遭拒絕（#5025）；redaction 補上小寫 key 名的 AWS secret keys、PGP private key 區塊與加密 PKCS#8 金鑰（#5014、#5017）；私有 prompt 文字不進 Goals；測試套件分拆為 fast 與 integration 兩線（#5032）。

v15.2.0：安裝走進瀏覽器（六步）

全新安裝（npx claude-mem install）現在會啟動 worker 並打開瀏覽器設定流程（#5031），把最近的實際工作轉成 Work、Goals 與 Rules：

步驟 內容
1. Install 安裝偵測到的 hooks、啟動 worker、開瀏覽器
2. Scan 讀取近 30 天支援的本機 agent 歷史；設定的排除專案與 agent 自撰 prompts 不納入，已存 prompts 去重，private-tag 清理與 redaction 在任何顯示或抽取之前執行
3. Reveal 把過濾後的 owner prompts（gzip）上傳 CMEM Cloud 做托管意圖萃取；匿名安裝取得私有且持久的安裝憑證；回傳的 goals、rules 與 request groups 填入本機 My Work；上傳與萃取錯誤會顯示且可重試；預勾的 product-improvement 核取只影響 improveProduct
4. Storage choice At Home 或 On The Go（後者走既有 pairing/login/checkout）；記憶憑證在 checkout 標記為付費之前啟用
5. Finish Setup 安裝其他選定的本機工具、可匯入既有記憶；設定變更重啟 worker 時，進行中的萃取或匯入會保留
6. What’s next 搜尋已存記憶與 prompts、把結果留成筆記、交棒給 My Work；終端機正常退出

安裝不再因 Cloud 未分組而失敗（#5060）：真實 30 天掃描中，托管模型有時把某些對話排除在所有 group 之外，worker 過去會直接拋錯毀掉安裝；現在 Cloud 回傳的 groups 照存、未分組的對話在 My Work 顯示為自己的請求，留待本機 refresh 日後分組。未知或重複的對話 id 仍然大聲失敗。

需求：Node ^20.19.0 || >=22.12.0；使用 CMEM Cloud 托管歷史匯入與意圖萃取（claude-mem-pro #353、#355、#358）。

v15.2.1：npm 改走 OIDC trusted publishing

#5063：「Publish to npm」GitHub Actions workflow 改以此 repository workflow 簽發的短期 OIDC token向 npm 認證，取代長期 NPM_TOKEN secret——後者自 v13.26.1 起每次 tag 都失敗。Trusted publish 並附帶 npm provenance attestation，把套件連到建置它的 commit 與 workflow。官方明言：「No runtime behavior changes in the plugin or worker; this release exists to ship through the new publishing path.」

v15.3.0：My Work 卡片的 Deliverables

官方定位（#5109）：跟 agent 要一份 deck、報告、HTML 頁面或任何檔案，它在 My Work 該請求卡片正面的 Deliverables 區一鍵可取。

  • Stop hook 複製該 turn 產出的成果到 ~/.claude-mem/deliverables/<project>/，採 content-addressed 命名（如 report-3f9a1c2b.md）——複本活得過 worktree、scratch 資料夾或暫存目錄。agent 透過 work_state_write（work_product、deliverable 或任何「人會打開的檔案」欄位）附上的檔案都算，寫在 source tree 之外的 decks、文件、頁面、圖片、影片與試算表也算；source 檔案絕不用推論複製。SubagentStop 捕捉 subagent 從自己 transcript 做出的東西。
  • worker 記錄並供應每份複本（GET /api/deliverables/:id/:filename），比照 recorded files 的 loopback、same-origin 與 sandbox 規則；markdown 與文字可 inline 開啟。
  • 隱私與上限是明說的：整個 prompt 都是 <private> 的 turn 不留複本也不留紀錄；另一台 host 上的 worker 什麼都不複製（它打不開複本）。每個 Stop 上限 50 個檔案、每檔 512 MiB——碰到上限會回報，絕不靜默。CLAUDE_MEM_DELIVERABLES_ENABLED=false 可整個關掉。
  • SessionStart 的 work-state rule 現在會要求 agent 把成品寫成檔案並以 work_product 附上才算完成。

其他新功能：本機資料庫自動快照與 crash-safe 還原——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 匯出——每則新 observation 存入後即 upsert 到 Notion database，opt-in（CLAUDE_MEM_NOTION_ENABLED＋token＋database id）、永不阻擋 capture（#4799）；Codex subagent 帶記憶 timeline 起跑——新 SubagentStart hook 給新 subagent 與 SessionStart 同級的 context，fork（繼承父歷史）跳過（#4760）；Runcrate preset 供 openai-compatible provider（#5067）。

修復選摘：Antigravity CLI 不再註冊 PreToolUse——它過去自動核准每個 agy tool call 並把每次呼叫排隊兩次（#5085），agy prompts 改為每 turn 記錄一次、agy 讀的檔案有 observation 歷史（#5092）；臨時 AWS 憑證完整 redaction——ASIA access key IDs、session tokens 與 aws sts JSON 輸出裡的 SecretAccessKey（#5066、#5073、#5080）；watcher checkpoints 等到緩衝工作入庫（#5072）、transcript-watch 設定路徑跟隨 CLAUDE_MEM_DATA_DIR（#5070）；Windows launcher 在 bun.exe 位於非 ASCII 路徑時改走 8.3 short path 編譯（#5089）；每個出貨的 plugin manifest 帶同一版本號，由 build 同步、CI 檢查（#5083、#5082、#5075）。

隨堂測驗

v15.3.0 起，一個 prompt 完全是 `<private>` 的 turn，Deliverables 機制會怎麼處理其產出檔案？

💡 想先看個提示？

官方把「隱私與上限」列為明說的設計，不是事後補丁。

動手升級檢查清單

升級 v15.3.0：動手檢查清單

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

0 / 7

延伸閱讀