dsh-agentmemory：DSH 會話持久化記憶插件

前言¶

DSH 會話具有短暫性。一旦會話結束，Agent 所做的工具調用、錯誤恢復以及最終決策，都會隨之消失。agentmemory 是一個本地、自託管的記憶守護進程，提供跨會話、跨 Harness 的持久化能力。dsh-agentmemory 插件是 DSH 側的連接器，它負責將 DSH 的活動寫入守護進程，在適當時候將記憶讀回模型，並暴露顯式的記憶工具。

插件概覽¶

定位：DSH Cordis 插件，爲每個 DSH 會話提供持久化、可搜索的記憶。
維護者：Yiipu
類別：記憶
許可證：MIT

核心能力¶

該插件提供三個層面的功能，將 DSH 與 agentmemory 生態打通：
* 寫入：觀察橋接。將 DSH 事件映射爲 agentmemory 的標準鉤子類型，確保數據能被守護進程的壓縮管道、搜索索引和查看器讀取。
* 讀取：上下文注入。通過 agent/pre-step 水流，在會話開始時注入項目召回窗口，並在壓縮前重新注入記憶。
* Agent 工具：提供 memory_recall 和 memory_remember 工具，供 Agent 顯式、精確地調用。

安裝與啓用¶

在安裝插件前，必須先啓動 agentmemory 守護進程（默認 REST 端口爲 3111）。插件要求 Node.js 版本 >= 20。

安裝插件：

    dsh plugin --profile web add github:Yiipu/dsh-agentmemory

在 cordis.yml 中掛載配置行。配置項 baseUrl 指向守護進程地址，enabled 控制啓用狀態：

    - insert:
        - id: agentmemory-bridge
          name: "dsh-agentmemory"
          config:
            baseUrl: http://localhost:3111
            enabled: true

典型用法¶

使用官方推薦的遷移命令，將現有的記憶數據遷移到新的連接器下：

agentmemory connect dsh --with-hooks

注意事項¶

已棄用：該插件已不再維護。agentmemory 0.9.29+ 版本內置了官方的 DSH 連接器，覆蓋了自動捕獲、MCP 工具以及 dsh-hooks-claude-code 的鉤子橋接功能。建議遷移至官方方案。
硬依賴：agentmemory 是硬依賴。插件會在加載時檢查守護進程的 /agentmemory/livez 接口，如果守護進程不可達或狀態異常，插件將無法加載。
去重限制：agentmemory 的去重機制無法合併兩個連接器產生的數據流，因此同一 Daemon 下只能啓用一種連接方式（不要同時運行舊插件和官方連接器）。

生態背景¶

DSH 的核心理念是“一切皆插件”。該插件託管在社區目錄，與 DeepSeek 或官方應用商店無從屬關係。開發者可在 SkillHub 查看目錄詳情，或在 GitHub 獲取源碼。