前言¶

在 DSH 插件化使用中，長期記憶常見的問題是：檢索到的記憶會被直接帶入上下文，模型可能把低置信、過期或不相關記憶當成有效線索。dsh-memory-gate 針對“檢索到 ≠ 注入”這個問題，在記憶進入上下文前執行 CBDC（Claim → Belief → Decision → Consumption）門控，輸出可解釋的 use / verify / ignore 決策。

它面向需要本地長期記憶、但希望控制注入邊界、保留審計路徑的 DeepSeek Harness 開發者。

這是什麼¶

dsh-memory-gate 是 DeepSeek Harness 的社區記憶插件，維護者爲 GIT121995，許可證爲 MIT。它不屬於 DeepSeek 官方項目。

當前版本爲 0.11.2，目標 Harness 版本爲 0.1.2-alpha.1，兼容 0.1.0-rc.6 起的 Harness；運行環境要求 Node.js >=22.5。

它把記憶保存爲可解釋的條目，並在注入前做權威門控。默認以 assist 模式啓動，最多注入 3 條、1200 字符相關記憶，不增加第二次模型調用。

核心功能¶

注入前裁決¶

每條記憶進入上下文前，插件都會執行 CBDC 門控：

• Claim：保存爲可追蹤的記憶條目
• Belief：依據已有信息形成置信度
• Decision：輸出 use、verify 或 ignore
• Consumption：決定是否進入本次模型調用上下文

這意味着記憶不是“檢索到就用”，而是先經過裁決。

使用後反饋¶

使用後的反饋會反向更新記憶質量：

• helped：提升記憶可用性，並把當次查詢的區分性詞項學進觸發詞
• harmful：降低置信度，並觸發隔離
• stale：標記過期風險，並觸發隔離

其中，helped 反饋只保存區分性詞項，不保存查詢原文。

近重複處理¶

寫入時，如果新記憶與同作用域已有記憶的詞項重疊達到 60% 以上，舊條目會自動標記爲 superseded。這樣可以減少相近表達反覆堆疊成多條記憶的問題。

作用域與存儲¶

插件支持三種作用域：

• session
• workspace
• global

其中 workspace 路徑只保存哈希鍵。

存儲層使用本地 SQLite + FTS5，不使用 embedding，也不依賴外部記憶 API。API Key、Token、密碼和私鑰樣式內容會在落庫前被拒絕。

如果數據庫或策略出現異常，插件不會阻斷 Agent，只省略本次記憶注入。

運行模式¶

插件支持三種運行模式：

• shadow：只審計，不向模型注入
• assist：默認模式，注入可用記憶，並保留可解釋信息
• enforce：更嚴格地控制注入內容

安裝¶

安裝命令如下：

dsh plugin --profile web add dsh-memory-gate

安裝後，默認以 assist 模式啓動。記憶數據默認保存在：

$DSH_HOME/memory/cbdc.sqlite

如果之後卸載插件，記憶數據仍保留在該文件中；如要徹底清除，刪除該文件即可。

典型用法¶

下面是常見 /memory 命令：

/memory status
/memory list 10
/memory remember --kind preference 我偏好簡潔中文回答
/memory remember --global --kind constraint 不要在回覆中暴露憑據
/memory search 簡潔中文
/memory explain mem_<uuid>
/memory feedback 1 helped
/memory ok
/memory mine 50
/memory consolidate
/memory forget mem_<uuid>
/memory mode assist

幾個命令的作用可以這樣理解：

• /memory status：查看插件狀態
• /memory list 10：查看最近 10 條記憶
• /memory remember：顯式保存一條記憶
• /memory search：按詞項檢索記憶
• /memory explain：查看指定記憶的決策依據
• /memory feedback：對記憶使用效果給出反饋
• /memory ok：對最近注入記憶做 helped 反饋
• /memory mine：從歷史 session 中挖掘可保存的記憶線索
• /memory consolidate：合併近重複記憶
• /memory forget：移除指定記憶
• /memory mode：切換運行模式

適用場景與注意¶

適合以下場景：

• 在 DSH 會話中保存穩定偏好、約束和長期信息
• 希望記憶進入上下文前有可解釋裁決
• 希望反饋能影響後續記憶置信度
• 希望本地存儲，不引入外部記憶 API

使用前需要注意：

• 這是社區插件，不屬於 DeepSeek 官方項目
• 插件以當前 dsh 進程權限運行，安裝前應檢查源碼與 MIT 許可證
• 同義詞和觸發詞召回仍是詞法級，不等價於通用語義檢索
• 繁簡映射覆蓋常見繁體字，但不保證覆蓋所有表達
• 自動提取只識別明顯的“記住、以後、I prefer、always”等表達，偏向保守
• 不回填安裝前的歷史會話，也不重複保存完整 Harness transcript
• Node.js 22 會爲內置 node:sqlite 打印 experimental warning，不影響運行

鏈接¶

GitHub 倉庫：

https://github.com/GIT121995/dsh-memory-gate

社區目錄爲獨立站點，具體條目以實際目錄爲準；可在目錄中按名稱搜索 dsh-memory-gate。