dsh-memoir：DeepSeek Harness 的持久化记忆 DSH plugin

dsh-memoir 是 DeepSeek Harness（DSH）的持久化记忆插件（DSH plugin），由 Qinling-Melon-Farmers 用 TypeScript 开发，采用 Apache-2.0 协议，最近更新于 2026-08。它解决 DSH 会话「失忆」的问题：新会话不记得上一个会话踩过的坑，导致反复排查同类问题（如控制台中文乱码、终端转义错误）。插件把「记录 → 存储 → 自动注入 → 可视化维护」串成闭环，核心能力包括：每轮有实际工作的回合结束自动提醒归纳（auto-distill）、memoir_record 工具沉淀工作记录/经验教训/行动指南、项目级写入 PROJECT_MEMORY.md（随 git 提交）、全局索引 ~/.dsh/dsh-memoir.json、新会话自动注入记忆到 system prompt，以及侧边栏「记忆」入口的 Web GUI 面板（项目/全局 tab、全文检索、手动记录/删除）。

dsh-memoir 这个 DSH plugin 支持哪些核心能力？

插件提供两个工具：memoir_record(section, title?, content) 记录一条记忆，section 取值 work / lessons / actions / note；memoir_read(scope?, section?, query?) 读取记忆，scope 取值 project（默认）/ global / all。Web 面板（/api/dsh-memoir/*）提供项目记忆 tab（按四类分组，显示时间、标题、正文与会话来源）、全局记忆 tab（所有项目的记忆桶，支持跨项目检索）、搜索框（标题与正文实时模糊过滤）、手动添加记忆（与 agent 写入同一份数据）以及逐条删除（删除后自动重新生成项目记忆文件）。

dsh-memoir 怎么安装和配置？

安装命令如下，安装后重启 DSH（dsh web）生效，侧边栏出现「记忆」入口。

dsh plugin --profile web add github:qinling-melon-farmers/dsh-memoir

在 cordis.patch.yml 中可配置三个开关（默认均为 true）：

- insert:
    - id: memoir
      name: dsh-memoir
      config:
        enabled: true          # 总开关（工具、路由、注入段）
        announceToAgent: true  # system prompt 公告段
        autoDistill: true      # 每轮有实际工作的回合结束自动提醒归纳

dsh-memoir 怎么使用？

默认自动模式下，插件在每轮有实际工作的回合结束自动提醒归纳，agent 按提示调用 memoir_record 即可；手动模式（autoDistill: false）下，任务收尾时按「做了什么 / 踩了什么坑 / 下一步怎么走」分三条调用 memoir_record（work、lessons、actions）。接手项目时，新会话先用 memoir_read 读取项目记忆；跨项目检索用 memoir_read(scope: 'global', query: ...) 或面板全局 tab。典型场景包括：反复出现的环境坑（乱码/转义/路径/权限）记 lessons、项目红线与约定记 actions、难查 bug 的根因记 lessons/work、部署上线固定步骤记 actions。

dsh-memoir 能解决什么，不能解决什么？

它能解决「反复踩同一个坑」：第一次解决后把诊断结论与修复步骤记成 lessons，此后本项目每个新会话都会自动注入这条经验，agent 直接照做；跨项目也能检索到。但它不能「根治」终端或控制台本身的编码缺陷——乱码根因是终端代码页与输出编码不匹配，插件只沉淀「根因 + 修复命令」，不修改终端配置。

查看更多 DSH 插件，访问 dsh-plugin.org