前言¶
在 DeepSeek Harness（DSH）里跑 Claw Agent 时，多轮对话往往依赖上下文窗口；窗口一满就要压缩，压缩前若没把该留的信息落盘，Agent 容易「忘事」。通用会话记忆和工作区注入也会和 Claw 专属记忆混在一起，不利于按 Agent 隔离。下面介绍独立记忆插件 dsh-agent-memory（社区目录条目 dsh-claw-memory）：为每个 Claw Agent 维护 USER / MEMORY 金库与按日日记，在回合后做回顾，并在官方压缩开始时把该写入金库的内容冲洗进去；不拦截其它工具，也不承担 HEARTBEAT 巡检。
这是什么¶
dsh-agent-memory 是 DSH 的 Claw 持久记忆插件，维护者为 xingyingyuzhui，分类为「记忆」。当前 package 版本 0.1.10，许可证 MIT，要求 Node.js >= 20。
插件通过 Cordis patch 把 memory 工具挂到 Claw 会话（agent/created，需 DSH 0.1.6+ 串行初始化）。工作区会话与官方会话不注入 Claw 记忆；Claw 会话只读自己的金库。
核心功能¶
金库与日记¶
每个 Claw Agent 对应独立数据目录（slug 区分）：
- USER.md、MEMORY.md：长期 USER / MEMORY 金库
- memory/YYYY-MM-DD.md：按日日记
路径位于 ~/.dsh/DSclaw/<slug>/ 下。
memory 工具¶
memory 工具仅出现在 Claw 会话中，供 Agent 读写上述金库与日记。插件不拦截 DSH 其它工具调用。
回合后回顾¶
回合结束后，插件按 settings.json 中的开关决定是否做回顾（具体行为以实现为准，开关在配置里）。
压缩前冲洗¶
插件监听官方 session/event 的 compaction/start。压缩一开始，就把「该写入金库」的内容立刻落盘，降低因压缩丢上下文的风险。
写入策略与审批¶
设置支持「自由写」或「需审批」。待审批项在 DSH Web 界面 Claw Agent → 记忆 tab 中处理。全局设置文件：
~/.dsh/agent-memory/settings.json（审批、回顾开关）。
安装与启用¶
建议先安装 dsh-agent-registry、dsh-agent-identity，再装本插件。安装后重启 dsh web。
dsh plugin --profile web add github:xingyingyuzhui/dsh-agent-memory
本地开发时，可用 link 指向源码目录（路径换成你的绝对路径）：
dsh plugin --profile web add link:/abs/path/to/dsh-agent-memory
典型用法¶
1、按上面命令安装并重启 dsh web。
2、创建或打开 Claw Agent 会话，确认会话类型为 Claw（非工作区 / 非官方会话），此时应能看到 memory 工具。
3、按需编辑 ~/.dsh/agent-memory/settings.json，配置是否需审批、是否开启回合后回顾。
4、Agent 通过 memory 维护金库与日记；若启用审批，到 Claw Agent → 记忆 tab 处理待审批项。
5、长对话触发压缩时，插件在 compaction/start 时执行冲洗，无需额外手动步骤。
卸载插件后，磁盘上的 ~/.dsh/DSclaw/ 与 settings 文件仍会保留，但不再注入记忆、不再回顾，memory 工具也会消失。
适用场景与注意¶
适合：需要为单个 Claw Agent 做隔离、可文件化审计的长期记忆；希望在 DSH 官方压缩流程前自动把该存的内容写入金库的团队或个人。
注意：
- 本插件不负责 HEARTBEAT 巡检；若需要心跳类能力，应另装对应插件。
- DSH 插件在 当前 dsh 进程权限 下运行，安装前请自行查看 GitHub 仓库 源码与 MIT 许可证，确认符合你的安全与合规要求。
- 社区插件目录 SkillHub 条目 与 DeepSeek / 幻方无官方从属关系；DSH 生态遵循「一切皆插件」，以仓库 README 与 package 为准。
经过上面的步骤，你可以为 Claw Agent 建立与压缩流程衔接的持久记忆，而不把工作区或其它会话的记忆混在一起。更多细节见 GitHub：xingyingyuzhui/dsh-claw-memory 与 SkillHub 插件页。
