返回目录

dsh-hermes-memory

精选清单收录维护状态: 活跃

isheng-eqi/dsh-hermes-memory

Hermes 风格持久记忆(MEMORY.md/USER.md):有界、文件存储、冻结快照注入。

前往 GitHub
$ dsh plugin --profile web add dsh-hermes-memory

16

星标

3

Fork

JavaScript

语言

MIT

许可证

2026-08-17

创建于

2026-11-13

最近推送

MIT 开源的 DSH 外挂:把 Hermes 的双记忆库、冻结快照注入、原子策展与有界后台复盘带到 DeepSeek Harness,并给后台改动配一个审批面板。

DSH 适配

原生运行时

作者声明

安全审计

未审计

最后核验

2026-11-14

许可证

MIT

01它能帮你完成什么?

  • 把关于用户与环境的事实跨 DSH 会话留住,而不是每轮都塞进提示词

    两个经过整理、有字符预算的库——`user`(身份、长期偏好、交流方式)与 `memory`(跨任务的环境事实、工具约定、路径)——以冻结快照的形式注入会话

    反复解释同一套偏好与环境事实的 DeepSeek Harness 用户

  • 让 agent 按有界节奏自己保存记忆,又不能自己批准自己的改动

    每 10 个真实用户回合做一次后台复盘(最多 16 次额外模型请求、120 秒预算),新增可直存,旧条目的修改与删除进待审队列,由你在「记忆」面板批准或丢弃

    希望记忆自动积累、但过程可审计可回退的用户

  • 在 DSH 里查看并纠正 agent 记住了什么

    「记忆」面板加 `memory_list` / `memory_search` / `memory_stats` / `memory_debug` 工具,`add` / `patch` / `remove` 在整批落盘前先按预算校验

    需要弄清 agent 为什么这么说、并直接修正而不是新开会话的用户

02如何接入 DeepSeek Harness?

前置条件

  • 一个带 JSON storage backend 以及 `tools`、`timer`、`sessionProjections` 服务的 DSH profile——Web profile 已自带存储组件,不要重复声明
  • 一个已登录的 DSH 网页会话,供记忆面板与 `/hermes-memory/*` 路由使用

安装步骤

  1. 01

    在 DSH 插件管理器里安装或启用这个 bundle,刷新原网页,点击侧栏底部的「记忆」

  2. 02

    或从发布包安装:`dsh plugin --profile web add dsh-hermes-memory`

    $ dsh plugin --profile web add dsh-hermes-memory

  3. 03

    源码安装时改为添加包目录,而不是发布包名

验证接入成功

  • 刷新后侧栏底部出现「记忆」,点开能看到双库内容、后台状态与待审修改
  • 已在 DSH 0.2.2-alpha.2、Node 24.22.2 的当前 v4 会话格式验证——README 说明包的 peer 范围不是运行兼容性保证

03DSH 适配与能力边界

DSH 适配原生运行时

DSH 外挂 bundle(`dsh plugin --profile web add dsh-hermes-memory`):注册 `memory` / `memory_list` / `memory_search` / `memory_stats` / `memory_pending` 工具、冻结快照注入、「记忆」侧栏面板与 `/hermes-memory/*` 网页路由

  • 两个有界的记忆库

    模型用 `add` / `patch` / `remove` 策展的事实,每次调用只写一个库→`user`(默认 1375 字符)与 `memory`(默认 2200 字符)两个库,整批操作先按最终预算校验,再一次性原子写入

    通过 DSH 的 JSON KvUnit 落到 `~/.dsh/storages/hermes_memory.json`一条事实只属于一个库
  • 后台记忆复盘

    触发回合捕获的对话文本,以及当前启用的记忆库→一个有界的模型循环,可以保存有依据的长期事实,也可以判断没有内容值得保存;对旧条目的修改与删除会变成待审提案

    会额外消耗 LLM 额度——默认每次复盘最多 16 次请求、120 秒预算后台循环只能用 `memory` 与 `memory_list` 两个工具
  • 在 DSH 面板里审核提案

    运行时文件里记录的待审提案→只有已登录用户可以批准或丢弃,且批准时会重新校验完整原条目,旧提案无法覆盖新内容

    模型只能列出提案,永远不能批准后台复盘访问不到审批工具
  • 带认证的网页路由

    DSH 网页界面发来的请求→`/hermes-memory/stats`(GET)、`/hermes-memory/ops`(POST:读取双库、直接编辑、列出待审)与 `/hermes-memory/pending`(GET / POST:按 id 列出、批准或丢弃)

    使用 DSH owner 身份认证加 Host/Origin 检查,响应禁止缓存

04适合谁?何时不该用?

适合

  • 反复解释同一套偏好与环境事实的 DeepSeek Harness 用户
  • 希望记忆自动积累、但过程可审计可回退的用户
  • 需要弄清 agent 为什么这么说、并直接修正而不是新开会话的用户

不适合

  • v2.0.0 静态 bundle 默认开启后台复盘,会产生额外 LLM 请求并消耗额度;记忆库字符预算不限制总 token 与费用,关掉复盘后主模型的策展与注入仍然消耗 token。
  • 记忆存在 DSH 的 JSON KvUnit(`~/.dsh/storages/hermes_memory.json`),复盘元数据在 `hermes_memory_runtime.json`;静态与动态形态共用同名存储、只能有一个写入实例,不支持多个 DSH 进程写同一目录,也不支持运行中从外部改文件。
  • 自动复盘只在有真实用户消息、成功结束、最终答复非空且不含工具调用时触发;取消、异常、空答复与含未完成工具调用的回合都不触发,普通子代理也不触发,同一会话只跑一个复盘,重叠的触发直接跳过而不排队。
  • 动态沙箱没有原生请求取消接口,所以只有静态 bundle 提供后台复盘;动态形态只给记忆工具、快照与统计,后台状态显示 `unavailable`。

05兼容性、维护与安全提示

  • v2.0.0 静态 bundle 默认开启后台复盘,会产生额外 LLM 请求并消耗额度;记忆库字符预算不限制总 token 与费用,关掉复盘后主模型的策展与注入仍然消耗 token。
  • 记忆存在 DSH 的 JSON KvUnit(`~/.dsh/storages/hermes_memory.json`),复盘元数据在 `hermes_memory_runtime.json`;静态与动态形态共用同名存储、只能有一个写入实例,不支持多个 DSH 进程写同一目录,也不支持运行中从外部改文件。
  • 自动复盘只在有真实用户消息、成功结束、最终答复非空且不含工具调用时触发;取消、异常、空答复与含未完成工具调用的回合都不触发,普通子代理也不触发,同一会话只跑一个复盘,重叠的触发直接跳过而不排队。
  • 动态沙箱没有原生请求取消接口,所以只有静态 bundle 提供后台复盘;动态形态只给记忆工具、快照与统计,后台状态显示 `unavailable`。
2026-08-172026-11-11v2.0.0

MIT · 仅有 README 证据,最新版本 v2.0.0,未做安全审计

06常见问题

在 DeepSeek Harness 里怎么安装 dsh-hermes-memory?

在 DSH 插件管理器里安装或启用这个 bundle,刷新网页后点侧栏底部的「记忆」;也可以用发布包:`dsh plugin --profile web add dsh-hermes-memory`。它需要 `tools`、`timer`、`sessionProjections` 服务与 JSON storage backend;Web profile 已自带存储,不要再重复声明——缺少存储会直接报错,而不是把旧数据当空库。

它会在 DSH 里额外消耗模型额度吗?

会。v2.0.0 静态 bundle 默认开启后台复盘:每 10 个真实用户回合一次,每次复盘最多 16 次额外模型请求、模型循环预算 120 秒,默认继承触发回合的模型(也可以另配)。把 `backgroundReview.enabled: false` 设上就关掉独立复盘——主模型的策展与记忆注入仍消耗 token,所以不是零用量。

agent 能改写或删除已经记住的内容吗?

只能走审核。后台新增可以直接保存,但对旧条目的修改与删除会进待审队列,由已登录用户在「记忆」面板批准或丢弃;`memory_pending` 只让模型列出提案,永远不能批准,后台复盘也访问不到审批工具。批准时会重新校验完整原条目,旧提案无法覆盖新内容。

为什么当前会话里看不到刚写入的记忆?

当前会话保持首次读取时的冻结快照;新会话才会读到更新后的记忆,需要即时状态可以调 `memory_list`。另外只有真实用户回合、成功结束且最终答复非空无工具调用时才触发复盘,普通子代理不会触发。

记忆存在哪里,有哪些操作不能做?

存在 DSH 的 JSON KvUnit(`~/.dsh/storages/hermes_memory.json`),复盘记录与提案在 `hermes_memory_runtime.json`。静态与动态形态共用存储且只能有一个写入实例:不要让多个 DSH 进程写同一目录,不要在运行中从外部改文件,降级或迁移前要把两个文件一起备份。

08数据与来源

  • 作者声明github.comfa55f4c6a57c…

    将 [Hermes 内置记忆](https://github.com/NousResearch/hermes-agent/tree/c0c4357744d1a6994d332b826aea4c77fcccaf38) 的双库、冻结快照、原子策…

  • 作者声明github.comfa55f4c6a57c…

    dsh plugin --profile web add dsh-hermes-memory

  • 作者声明github.comfa55f4c6a57c…

    在 DSH 插件管理器安装或启用此 bundle,刷新原网页,点击侧栏底部「记忆」。源码安装使用包目录;发布包可使用:

页面基于项目公开文档、仓库元数据和 DSH Plugins 的结构化解析生成;最后核验于 2026-11-14。发现错误?提交更正。

🏆

最佳 DeepSeek Harness 插件

从全目录挑出的 12 个值得优先安装的插件,覆盖各个分类。

DSH Plugins 是独立的 DeepSeek Harness 插件目录,与 DeepSeek 官方无关,也不代表官方背书。第三方插件未经安全审计,安装前请审查源码。

每周获取最新的 DeepSeek Harness 插件,绝不滥发。