SipengXie2024/dsh-memory-hermes

README 摘要

dsh-memory-hermes Hermes 式有界策划记忆,做成 DeepSeek Harness(dsh)的用户侧插件。不改 dsh 本体, dsh plugin add 即装即用。 设计蓝本是 Nous Research Hermes Agent 的记忆系统: 小容量、模型自己策划、每 session 冻结注入 。与「越攒越多的记忆库」相反,它逼着模型维护一份精炼的长期事实清单。v2 起,配置、可观测性、检索全部落在 dsh 自己的机制面上(settings 命名空间、storage-domain sidecar、projection、sessionQuery),不再是插件私有轮子。 机制速览 机制 行为 双文件 MEMORY.md (agent 笔记,默认 2,200 字符)+ USER.md (用户画像,默认 1,375 字符),存于 $DSH HOME/memory/ 单工具 memory ,action 枚举 add / replace / remove , 没有 read ——内容已在系统提示里 冻结快照 session 开始时读一次注入系统提示,会话内不再变(prompt-cache 友好);会话内写入落盘、工具结果回显实时态,下个 session 才进快照 定位条目 replace / remove 用唯一子串匹配, 条目全文精确匹配优先 (条目互为子串时的逃生口);0 命中或多命中报错,错误里附 锁内实时盘面 的条目全文(快照可能过期,这是模型的自救通道) 溢出纪律 增长型 超限写入不落盘,报错附当前全部条目,并要求 当轮合并重试、不丢新信息 ;缩小型操作(remove/变短的 replace)总是放行——文件已超限(调小上限/手改)时才能逐步收敛回来 安全扫描 写入时 + 注入渲染时 + 错误载荷 三处同一规则表:不可见 Unicode、注入话术、外传形状;命中即拒/隐藏 审批闸门 approval: true 时每次写弹审批——实现为 dsh 设计的 tools/pre-execute 策略监听器(ask 决策),工具本体无策略;无审批渠道时运行时 fail-closed(默认关) 并发安全 进程内 promise 链串行 + 跨进程 .lock 文件锁 + 原子写(照 dsh settings-file 同款姿势) 后台自省 后台 fork 循环重看会话,双路分流: memory 路 收窄(用户画像/行为期望/当前状态), skill 路 沉淀技术经验进 skill 库;触发:turn 结束(按策略)、compaction 收割、 /memory review [focus] 自省可观测 每次 review 落一条记录进 storage-domain sidecar( memory hermes 域),设置页「活动」页签可查:…

分类