前言¶
DeepSeek Harness (DSH) 採用插件化架構，但在記憶管理上常面臨上下文窗口限制、缺乏長期上下文持久化以及工具調用繁瑣的問題。dsh-memory 插件旨在解決這些問題，爲當前工作區提供長期記憶能力。它對標 Qoder / WorkBuddy / ZCode 的記憶交互，提供索引式簡報、輪末相關召回、版本鏈管理以及按需讀寫的能力。
核心功能¶
工作區長期記憶¶
記憶以當前工作區爲單位落庫。系統會爲每個工作區生成一個帶 8 位 hash 的目錄名，確保同名目錄不會互相污染。
索引式簡報（默認）¶
會話開始時，最重要的記憶以一行一條的索引形式注入系統提示（如 📌 [類別] 標題 #標籤 (id)）。相比全文注入，這種方式能降低 60-70% 的 token 消耗，模型可按需通過工具獲取全文。
輪末相關召回¶
輪次結束後，系統會根據當輪用戶消息做本地檢索，將命中的記憶在下一輪以「相關召回」塊注入。這屬於純本地計算，不產生額外的模型開銷。
memory 工具¶
提供以下命令：save（保存）、search（搜索）、list（列表）、get（獲取）、update（更新）、forget（遺忘）、stats（統計）。
版本鏈與自動提煉¶
支持版本鏈機制（supersedes），推翻舊記憶時歸檔不刪除，支持一鍵回滾。輪次結束可自動提煉記憶，支持 captureMode: draft 模式，將提煉結果放入待審隊列，批准後生效。
記憶管理面板¶
在 DSH 設置 → 記憶中，可查看記憶庫、時間線、健康體檢和審批隊列。
安裝與啓用¶
插件不支持 dsh plugin --profile desktop 安裝，必須使用 PowerShell 腳本。安裝前建議備份 profile 文件。
cd <克隆下來的 dsh-memory 目錄>
pwsh -File install.ps1
安裝完成後需手動重啓 DSH 桌面端。腳本會自動處理墊片、profile 清單和 junction 掛載。
典型用法¶
保存記憶¶
使用 memory 工具保存：
memory save [title] [content]
搜索記憶¶
memory search [query]
草稿審批¶
在配置中開啓 captureMode: draft，提煉結果會進入待審隊列，在設置面板批准。
數據存儲與配置¶
存儲路徑¶
記憶數據默認存儲在 ~/.dsh/storages/dsh-memory/。工作區目錄結構爲 workspaces/<目錄名>-<hash>/memories.json。
倉庫鏡像¶
記憶默認不落在倉庫裏，防止外泄。如需在倉庫中保留副本，可在設置中開啓 mirror 模式，系統會在工作區生成 .dsh-memory/MEMORY.md。
依賴配置注意¶
安裝時需確保依賴鍵、bundles 項、cordis.patch.yml 的 name、客戶端模塊 id 均爲同一個真包名（@bangbang-03/dsh-memory）。如果配置不一致，設置面板裏的界面可能整塊消失。
維護者與許可¶
該插件由 BangBang-03 維護，採用 MIT 許可證。更多細節可參考 GitHub 倉庫。
