前言¶

DSH 里做记忆相关插件时，常见的问题是跨会话信息不连续：环境事实、项目约定、工具怪癖，以及用户偏好、沟通风格、工作习惯，如果不能持久化，下一次会话还要重新交代。

dsh-hermes-memory 把 agent 的记忆分成两个独立的库：MEMORY.md 记录关于世界的事实，USER.md 记录关于你的画像。两个库各自独立预算、独立淘汰。下面介绍它的核心能力、安装方式和使用注意。

这是什么¶

dsh-hermes-memory 是 DeepSeek Harness（DSH）的双库记忆插件，维护者为 isheng-eqi，许可证为 MIT。

它把“环境事实 / 项目约定 / 工具怪癖”和“用户偏好 / 沟通风格 / 工作习惯”分开保存，并提供 memory 工具、辅助工具、内置 Web 记忆面板，用于查看、编辑、删除、添加两个记忆库条目。

核心功能¶

两个记忆库¶

• MEMORY.md：记录环境事实、项目约定、工具怪癖，字符上限为 2200 字符。
• USER.md：记录用户偏好、沟通风格、工作习惯，字符上限为 1375 字符。
• 两个库的字符上限是硬编码，不是 token 数；动态 Cordis 形态没有配置通道，如需调整请使用 bundle 安装。

memory 工具¶

memory 工具支持：

• add
• replace
• remove
• batch（全有或全无）

参数使用如下：

• action 为 add / replace / remove / batch
• target 为 memory / user
• replace / remove 使用 oldText 匹配
• batch 使用 operations 数组

匹配策略是精确匹配优先；UI 传完整文本时永远唯一命中，模型子串匹配作为回退。多条命中会报冲突。超限时不静默丢弃，会返回当前条目列表，模型当轮合并后重试；每轮失败上限为 3。

会话注入与提醒¶

• 会话开始时注入冻结快照。
• 会话中途写入不改变已注入快照。
• 连续 10 轮无写入时提醒持久化。

辅助工具¶

• memory_search
• memory_list
• memory_stats
• memory_debug

存储与面板¶

• 存储到 ~/.dsh/storages/hermes_memory.json。
• 写入为原子写，跨会话、跨重启持久。
• 内置 Web 记忆面板，可查看、编辑、删除、添加两个记忆库条目。
• 无 webServer 的环境（TUI/headless）自动跳过面板层，工具与注入不受影响。
• 零外部依赖；工具内部无 LLM，即零 LLM 成本。

安装与启用¶

先确认插件以当前 dsh 进程权限运行，安装前应检查源码和许可证。下面给两种启用方式。

bundle 安装¶

使用安装命令：

dsh plugin --profile web add github:isheng-eqi/dsh-hermes-memory

如果使用本地目录，可以用：

dsh plugin --profile web add /path/to/dsh-hermes-memory

动态 Cordis 形态¶

在任意 DSH 会话中，让模型执行 cordis_define 与 cordis_run。动态插件随进程退出消失，重启后需要重新运行；数据不丢。

典型用法¶

1. 让模型记：直接对模型说“记住 XXX”；新会话开始自动注入记忆快照。
2. 自己查看 / 修改：点击侧边栏「记忆」，在面板查看、编辑、删除、添加条目。
3. 使用 memory 工具时，按目标库选择 target 为 memory 或 user，再根据操作类型填写 action、oldText 或 operations。

适用场景与注意¶

适合希望把 DSH 的环境事实和用户画像分开持久化的场景。它适合需要模型自主维护记忆，同时又需要人工查看和修正两个记忆库的用法。

注意以下事项：

• 字符上限为硬编码：MEMORY 2200 字符、USER 1375 字符。
• 动态 Cordis 形态无配置通道；如需调整请使用 bundle 安装。
• 无 webServer 的环境（TUI/headless）自动跳过面板层，工具与注入不受影响。
• 未实现：write_approval 审批门、提示注入安全扫描、session_search。
• Node engines 为 ^22.19 || >=24。
• 可选 peerDependencies 包括：
• @deepseek-ai/cordis >=4.0.0 <5.0.0
• @deepseek-ai/dsh-tools >=0.1.0-rc.6 <0.2.0
• @deepseek-ai/schemastery >=3.0.0 <4.0.0

链接¶

• 目录页：https://www.skillhub.cn/plugins/isheng-eqi/dsh-hermes-memory
• GitHub：https://github.com/isheng-eqi/dsh-hermes-memory