@hyls9527/dsh-memory

面向 DeepSeek Harness 的有界、文件持久化、跨会话自维护记忆插件。忠实移植自 hermes-agent 的 MEMORY.md / USER.md 机制:两个持久化记忆库由模型用一个 memory 工具维护,并在每个会话开始时以冻结快照重新注入。

功能

一个目录下两个记忆库:MEMORY.md(Agent 自己的笔记——环境事实、项目约定、工具怪癖)与 USER.md(Agent 对用户的了解——偏好、沟通风格、工作习惯)。
条目以 § 分隔,并受字符上限约束(而非 token),文件保持人类可编辑,同时迫使模型在达到上限时合并旧条目而不是无限增长。
一个面向模型的 memory 工具,支持 add / replace / remove / batch(多操作全有或全无)。达到上限时,工具会要求模型在同一轮内合并;每轮失败次数有上限,脆弱的重试循环不会饿死用户的回复。
每个会话在第一个被接纳的步骤注入冻结快照。会话中途的写入立即落到文件,但绝不改动已注入的快照,因此整个会话的前缀缓存保持稳定。
连续 nudgeInterval 轮(默认 10)没有写入后,模型会被提醒持久化新知识。
耐久性防护:跨进程文件锁、原子临时文件重命名、拒绝覆盖"存在但读不出来"的文件、外部漂移检测(patch 工具或 shell 编辑导致的内容无法往返解析时,先快照到 .bak. 再拒绝写入)。

dsh plugin --profile web add @hyls9527/dsh-memory

本包是 dsh bundle:dsh plugin 会把它列进 profile 的 dsh.profile.bundles,其 cordis.patch.yml 负责插入插件行。任何字段都可以在 profile 自己的 cordis.patch.yml 中按 id 覆盖。

字段	默认	含义
`memoryEnabled`	`true`	是否持久化并注入 Agent 自己的笔记(`MEMORY.md`)。
`userEnabled`	`true`	是否持久化并注入用户画像(`USER.md`)。
`memoryCharLimit`	`2200`	`MEMORY.md` 条目的字符预算。