复合记忆接入 chinwe/dsh-compound-memory

dsh-compound-memory

DeepSeek Harness bundle，用来启动现有的 compound-memory MCP 服务器（uvx --from compound-memory compound-memory-server），挂载随包附带的 skills/compound-memory 技能，并注入一条简短的提醒，每个会话只出现一次。它不重新实现记忆功能，也不新增第六个 MCP 工具，服务器本身依然不含 LLM（ADR-0001）。这个包装层同样不含。没有安装脚本、生命周期脚本或 postinstall 脚本。

package.json 声明 dsh.bundle.patch = ./cordis.patch.yml。该文件插入三行：内置的 @deepseek-ai/dsh-mcp-client 行（mcp-compound-memory）、本包自己的插件（compound-memory-rules → dsh-compound-memory → index.js），以及内置的 @deepseek-ai/dsh-skill-filesystem 行（compound-memory-skill），其唯一的根目录是本包的 skills/。不要自己安装那个客户端：DSH 0.2 已经自带，单独安装的 0.1 客户端会不匹配（讨论 #8202）。本包不声明任何 @deepseek-ai/ 依赖。规则模块不导入 @deepseek-ai/cordis，也不导入 MCP 客户端：Cordis 会调用 apply(ctx)，而发布指南指出，只有当插件必须共享某个包的实例时，才应把该包固定为 peer。engines.dsh 为 >=0.2.0-rc.1 <0.3.0-0，因此当前的 0.2 预发布版能匹配，0.3 预发布版不匹配（发布指南、市场索引）。

| MCP 工具 | 在 DSH 内的名称 |
| memory_search | mcp__compound-memory__memory_search |
| memory_get | mcp__compound-memory__memory_get |
| memory_write | mcp__compound-memory__memory_write |
| memory_link | mcp__compound-memory__memory_link |
| memory_feedback | mcp__compound-memory__memory_feedback |

memory_search 返回一个对象，其 hits 字段是数组。

安装

需要 dsh 命令行，以及启动 dsh 的进程 PATH 上有 uv / uvx。首次运行 uvx 需要联网，从 PyPI 拉取 compound-memory。uv 会提供该工具的 Python，不需要系统 Python。

包版本 0.1.8，在 npm 上发布为 dsh-compound-memory：

bash
dsh plugin --profile web add dsh-compound-memory

从 GitHub 安装： bash
dsh plugin --profile web add github:chinwe/dsh-compound-memory

从本仓库的本地检出安装（指向插件根目录，不是子目录）： bash
dsh plugin --profile web add /absolute/path/to/dsh-compound-memory

用 Git 安装不需要 allowBuilds：这个包没有 prepare 脚本。重启 dsh。dsh --profile web --dump-config 应该能看到 # == dsh-compound-memory 这一层，以及 mcp-compound-memory、compound-memory-rules、compound-memory-skill 三行。

如果存储还不存在： bash uvx --from compound-memory compound-memory init

环境变量

在启动 dsh 的进程上设置这些变量。配置加载时，补丁用 !!js 读取它们。未设置或为空时使用默认值。这里没有敏感信息。stdio 子进程从清理过的父环境启动；配置里的 env 会合并到其上。

| 变量 | 未设置或为空时的默认值 |
| COMPOUND_MEMORY_AGENT_ID | agent-dsh |
| COMPOUND_MEMORY_ROOT | $HOME/.agents/memory（可选；Python 服务端会展开开头的 $HOME 或 ~） |

agent-dsh 是本机的稳定 id。如果这个进程应该作为另一台主机，就在启动 dsh 前设置 COMPOUND_MEMORY_AGENT_ID。后面的补丁层会整体替换 config。要把 command 指向绝对路径的 uvx，就在 ~/.dsh/profiles/web/cordis.patch.yml 里重写这一行（字段相同：serverName、transport、command、args、env、failOnStartupError）。

用法提醒

compound-memory-rules 监听 agent/pre-step，参数为 { prepend: true }。活跃智能体第一次符合条件的 enter（判定为 enter，且步骤信号未被中止）时，它追加一条 user 角色消息。该智能体后续的步骤不会再追加。新智能体对象的会话日志里如果已经有这条提醒（恢复会话，或本进程重启过），就不会再收到一份。监听器不读取记忆存储，也不调用模型（ADR-0001）。

消息文本是 index.js 里的 RULES（356 个字符，在 Claude SessionStart 的 400 字符预算之内）。它说明：

- COMPOUND_MEMORY_AGENT_ID 默认为 agent-dsh（可覆盖）；把同一个 id 作为 source 和 agent 传入
- 做非平凡工作前先 memory_search；采纳命中结果后用 memory_feedback 反哺存储
- 在仓库里，优先使用项目范围的记忆
- 只有五个 MCP 工具，命名为 mcp__compound-memory__memory_；本包不重新实现它们
来源是 { kind: 'plugin:dsh-compound-memory', form: 'instructions' }，消息带有一个全新的 id。会话格式 v4 拒绝已废弃的 { kind: 'plugin', plugin } 包装，并会让整个回合失败（讨论 #8432）。plugin:dsh-compound-memory 是 v3→v4 重写器会为这个包推导出的、由生产者拥有的 kind。不需要静态的 systemPrompt.section：pre-step 接受该消息，注入一次就能让它不进入后续每个步骤。

关闭提醒

只关闭提醒。在配置档补丁（~/.dsh/profiles/web/cordis.patch.yml）或 home 补丁（$DSH_HOME/cordis.patch.yml）中加上： yaml
- id: compound-memory-rules
disabled: true

后面的层按 id 定位这一行。disabled: true 会停掉该 loader 条目。mcp-compound-memory 是另一个 id，仍会启动 uvx。compound-memory-skill 是另一个 id，仍会挂载内置技能。dsh plugin --profile web remove dsh-compound-memory 会移除全部三行。

验证

dsh --profile web --dump-config 会在 # == dsh-compound-memory 下显示 mcp-compound-memory、compound-memory-rules 和 compound-memory-skill。

新建一个会话，发一条消息。记录里应包含一条 user 角色的提醒，其 source.kind 为 plugin:dsh-compound-memory，文本以 compound-memory: 开头。同一会话的后续步骤不应再添加一份。在本仓库运行 node --test 可在不启动 DSH 的情况下检查监听器。

技能

五个工具的用法见 skills/compound-memory/SKILL.md。注入的提醒是简短的硬性规则。技能是详细来源。遇到不简单的任务，先调用 memory_search。命中结果真正用上之后，调用 memory_feedback，把 agent 设为 agent-dsh（或 COMPOUND_MEMORY_AGENT_ID 的值）。只写稳定的事实。

compound-memory-skill 挂载该目录。这一行指定内置的 @deepseek-ai/dsh-skill-filesystem 服务商，providerName: compound-memory，includeDefaultRoots: false，因此该服务商不扫描项目或用户的技能根目录。bundledSkillDir 是一个 !!js 表达式：把 skills 拼接到 createRequire(baseUrl).resolve('dsh-compound-memory/package.json') 所在目录上。baseUrl 是 DSH 配置档，所以路径指向已安装的包，而不是进程 cwd。exports 包含 ./package.json，因为只写 "." 的映射会让该 resolve 抛出 ERR_PACKAGE_PATH_NOT_EXPORTED。exports["."] 仍是 ./index.js。
安装或升级后，重启 dsh。/compound-memory 会加载随包的技能。不再需要手动复制或建软链接。已经放在某个技能根上的可以留着。注册表只保留一个 compound-memory 名字：同一层内排名低的胜出，项目根或用户根（排名 100–500）优先于这个随包根（排名 600）（技能子系统）。提醒不会加载技能，技能也不替代提醒。

这是 DeepSeek Harness 的 bundle，用 uvx --from compound-memory compound-memory-server 拉起 PyPI 上已有的 compound-memory MCP server，挂载随包的 skills/compound-memory 技能，并在每个会话第一次进入模型步骤时注入一段短的使用提醒。不在 JS 里重写记忆，不增加第 6 个 MCP tool。server 内没有 LLM（ADR-0001），这个 wrapper 也不加。没有 install、lifecycle 或 postinstall 脚本。

根上的 package.json 声明 dsh.bundle.patch = ./cordis.patch.yml，插入三行：宿主自带的 @deepseek-ai/dsh-mcp-client（mcp-compound-memory），本包自己的插件（compound-memory-rules → dsh-compound-memory → index.js），以及宿主自带的 @deepseek-ai/dsh-skill-filesystem（compound-memory-skill），它的唯一根是本包的 skills/。不要单独安装这个 client：DSH 0.2 已经带了匹配版本，另装 0.1 会对不上（讨论 #8202）。因此本包不声明任何 @deepseek-ai/ 依赖。规则模块不 import @deepseek-ai/cordis，也不 import MCP client：Cordis 调用 apply(ctx)；发布指南 只要求在必须和宿主共享同一实例时才 pin peer。engines.dsh 为 >=0.2.0-rc.1 <0.3.0-0，当前 0.2 预发布能匹配，0.3 预发布不能（发布指南、市场索引格式）。

DSH 里的工具名是 mcp__compound-memory__memory_search、memory_get、memory_write、memory_link、memory_feedback（前缀相同）。memory_search 的返回体含 hits 数组。

安装

需要 dsh CLI，以及启动 dsh 的那个进程的 PATH 上有 uv / uvx。第一次 uvx 要从 PyPI 拉 compound-memory，需要网络。Python 由 uv 自己准备，不要求系统里先装 Python。

包版本 0.1.8，npm 包名为 dsh-compound-memory： bash
dsh plugin --profile web add dsh-compound-memory

从 GitHub 安装： bash
dsh plugin --profile web add github:chinwe/dsh-compound-memory

用本仓库检出（插件根就是仓库根，不要指子目录）： bash
dsh plugin --profile web add /absolute/path/to/dsh-compound-memory

Git 安装不需要 allowBuilds：没有 prepare 脚本。装完重启 dsh。dsh --profile web --dump-config 应出现 # == dsh-compound-memory 层，以及 mcp-compound-memory、compound-memory-rules、compound-memory-skill 三行。

记忆库还不存在时先初始化： bash uvx --from compound-memory compound-memory init

环境变量写在启动 dsh 的环境里。patch 在加载配置时用 !!js 读取；未设置或空白才用默认值。这里没有密钥。stdio 子进程从清洗过的父环境启动，配置里的 env 再叠上去。

| 变量 | 未设置或空白时的默认值 |
| COMPOUND_MEMORY_AGENT_ID | agent-dsh |
| COMPOUND_MEMORY_ROOT | $HOME/.agents/memory（可选；Python server 会展开开头的 $HOME 或 ~） |

agent-dsh 是这个宿主的稳定 id。这个进程要当成别的宿主时，启动 dsh 之前设置 COMPOUND_MEMORY_AGENT_ID。后一层 patch 会整行替换 config。要把 command 改成 uvx 的绝对路径，就在 ~/.dsh/profiles/web/cordis.patch.yml 里按 id 重写整行（字段仍是 serverName、transport、command、args、env、failOnStartupError）。

使用提醒

compound-memory-rules 以 { prepend: true } 听 agent/pre-step。某个 agent 第一次合格的 enter（决定是 enter，且该步的 signal 未 abort）追加一条 user 消息。这个 agent 之后的步骤不再追加。新的 agent 对象如果会话日志里已经有这条提醒（resume，或进程重启后），不会再追加第二条。监听器不读记忆库，也不调用模型（ADR-0001）。

正文是 index.js 里的 RULES（356 字符，短于 Claude SessionStart 的 400 字符上限）。内容是：COMPOUND_MEMORY_AGENT_ID 默认 agent-dsh（可覆盖），source 和 agent 传同一个 id；非琐碎工作前 memory_search；采纳命中后 memory_feedback 才让记忆库复利；在仓库里优先写项目作用域记忆；只有五个 MCP 工具，DSH 里的名字是 mcp__compound-memory__memory_；本包不重写它们。

source 是 { kind: 'plugin:dsh-compound-memory', form: 'instructions' }，并带新的 id。会话格式 v4 拒绝旧的 { kind: 'plugin', plugin }，整轮会失败（讨论 #8432）。plugin:dsh-compound-memory 是 v3→v4 重写器会给这个包推导出的产方 kind。不需要改成静态 systemPrompt.section：pre-step 能写入这条消息，每会话一次也不会在后续步骤里重复。

只关闭提醒

MCP server 继续跑，只停提醒。在 profile 的 patch（~/.dsh/profiles/web/cordis.patch.yml）或家目录 patch（$DSH_HOME/cordis.patch.yml）里加： yaml
- id: compound-memory-rules
disabled: true

后一层按 id 定位这一行。disabled: true 停掉这个 loader 条目。mcp-compound-memory 是另一个 id，仍会拉起 uvx。compound-memory-skill 也是另一个 id，仍会挂载随包技能。dsh plugin --profile web remove dsh-compound-memory 会三行一起去掉。

核对

dsh --profile web --dump-config 在 # == dsh-compound-memory 下应看到 mcp-compound-memory、compound-memory-rules 和 compound-memory-skill。

开一个新会话发一条消息。记录里应有一条 user 提醒，source.kind 为 plugin:dsh-compound-memory，正文以 compound-memory: 开头。同一会话的后续步骤不应再追加一条。本仓库的 node --test 不启动 DSH，只检查这个监听器。

Skill

五个工具怎么用见 skills/compound-memory/SKILL.md。注入的是短硬规则；skill 是完整用法。非琐碎任务先 memory_search。实际采纳命中后，用 agent agent-dsh（或当前的 COMPOUND_MEMORY_AGENT_ID）调 memory_feedback。只写稳定事实。

compound-memory-skill 挂载这个目录。这一行是宿主自带的 @deepseek-ai/dsh-skill-filesystem，providerName 为 compound-memory，includeDefaultRoots: false，因此这个 provider 不扫描项目或用户技能根。bundledSkillDir 是一段 !!js：对 createRequire(baseUrl).resolve('dsh-compound-memory/package.json') 所在目录再拼上 skills。baseUrl 是 DSH profile，所以路径指向已安装的包，而不是启动进程时的 cwd。exports 增加了 ./package.json；如果映射里只有 "."，这次 resolve 会抛 ERR_PACKAGE_PATH_NOT_EXPORTED。exports["."] 仍是 ./index.js。
安装或升级后重启 dsh，/compound-memory 就会加载随包技能。不再需要手动复制或软链。已经放在某个技能根上的副本可以留着。注册表里同名 compound-memory 只保留一份：同一层里 rank 更小的胜出，项目或用户根（rank 100–500）高于这个随包根（rank 600）（skills 子系统）。提醒不会加载技能，技能也不代替提醒。