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 获取源码。