dsh-memoir DSH 插件

dsh-memoir 把会话中做了什么、踩了什么坑、下一步怎么走沉淀为项目持久化记忆。插件在每轮有实际工作的回合结束时自动提醒代理归纳，将结构化数据存储为全局 JSON 索引和 git 友好的 MARKDOWN 文件，并在新会话开始时自动注入项目记忆，使后续代理继承过往经验。Web 面板支持浏览、检索、手动添加和删除记忆。

developer-tools skills-workflows

如何安装 dsh-memoir DSH 插件

dsh plugin --profile web add github:Qinling-Melon-Farmers/dsh-memoir

复制不会执行命令。安装 dsh-memoir DSH 插件前请核对仓库和版本。

dsh-memoir DSH 插件数据来源

dsh-memoir DSH 插件快照日期：2026年8月16日

discovered

dsh-memoir DSH 插件能做什么

自动收尾：监听回合结束事件，在有工具调用的回合自动提示代理记录记忆。
工具：memoir_record 记录（工作、教训、行动、备注），memoir_read 检索（项目/全局/全部）。
持久化存储：全局 JSON 索引 (~/.dsh/dsh-memoir.json) 和每个项目的 PROJECT_MEMORY.md。
自动注入：新会话自动将项目记忆注入系统提示。
Web 面板：侧边栏入口，项目和全局两个视图，全文检索，手动添加/删除。

dsh-memoir DSH 插件适合哪些场景

反复出现的环境坑（乱码、转义错误）——记录一条教训，附带修复命令。
项目红线与约定（禁止 emoji、发布前跑测试）——记入行动指南。
难查 Bug 的根因与结论——记入教训，避免重复排查。
部署/上线的固定步骤清单——记入行动指南，新会话按单执行。
跨项目复用经验——通过面板全局 tab 或 memoir_read 检索。

dsh-memoir DSH 插件适合谁

希望避免跨会话重复排查问题的 DSH 用户。
参与多开发者项目或长期任务的开发者。
需要为 AI 代理维护项目特定知识的团队。

dsh-memoir DSH 插件的限制

无法根治终端或控制台本身的编码缺陷，只能记录根因和修复命令。
项目记忆文件从源 JSON 重新生成，手动编辑 PROJECT_MEMORY.md 可能会丢失（如果源数据没有对应内容）。
仅适用于已安装该插件的 DSH 环境。

dsh-memoir DSH 插件的仓库 README 摘录

以下文字摘自 dsh-memoir DSH 插件的上游仓库 Qinling-Melon-Farmers/dsh-memoir 的 README，版权归原作者，仅作引用。

把「一个会话做了什么 / 踩了什么坑 / 下一步怎么走」沉淀为**项目持久化记忆**，并作为**未来 AGENTS 的行动指南**自动注入后续会话；插件开启后**每轮有实际工作的回合结束时自动提醒 agent 归纳沉淀**，另有 Web GUI 可视化面板浏览、检索与维护记忆。 - **自动收尾（auto-distill）**：监听 `agent/turn-stopping`，一轮有工具调用、且尚未记录过记忆的回合结束时，自动 steer 一句归纳提示，让 agent 用 `memoir_record` 把该轮工作沉淀为项目记忆（无实质工作的回合不打扰、子代理会话不打扰、每回合最多一次）。 - **归纳总结**：`memoir_record` 归纳工作记录、经验教训与行动指南。 - **持久记忆**：项目级写入 `<工作区>/PROJECT_MEMORY.md`（随 git 提交）；结构化源数据存全局索引 `~/.dsh/dsh-memoir.json`（跨项目检索）。 - **自动行动指南**：新会话开始时，插件把本项目的 `PROJECT_MEMORY.md` 自动注入 system prompt，未来 AGENTS 无需手翻文档即可继承既往经验。 - **可视化面板**：侧边栏「记忆」入口，中心面板提供项目 / 全局两个视图、全文检索、手动记录与删除。 ## 设计背景 DSH 的 agent 会话本身是「失忆」的：新会话不记得上一个会话踩过的坑。现实中的典型代价是**反复排查同类问题**——控制台中文乱码要查一次、某个终端的转义错误要查一次、某个工具的环境配置又要查一次；`AGENTS.md` 这类人工维护的说明文件要么没人更新、要么被塞得臃肿。社区已有的记忆类插件各有侧重：`dsh-memory` 侧重无损引用式检索、`dsh-mnemon` 依赖外部 Mnemon 服务、`distill` 自动蒸馏但落成 skill 文件、缺少可视化面板。 dsh-memoir 想补的是一个**开箱即用、纯本地、零外部依赖**的记忆层，把「记录 → 存储 → 自动注入 → 可视化维护」串成闭环： 1. **记录**：agent 在任务收尾调用 `memoir_record`（或插件每轮工作结束自动提醒）； 2. **存储**：结构化 JSON 全局索引为源，`PROJECT_MEMORY.md` 为可读渲染（随 git 提交、人也能看）； 3. **注入**：新会话开始时按项目自动注入记忆，未来 AGENTS 无需手翻文档即继承经验； 4. **维护**：Web 面板可检索、补录、删除，与 agent 写的是同一份数据。 ## 能力 | 工具 | 作用 | | --- | --- | | `memoir_record(section, title?,

阅读完整 README仓库许可: Apache-2.0

dsh-memoir DSH 插件常见问题

如何安装 dsh-memoir？

在终端中运行 `dsh plugin --profile web add github:Qinling-Melon-Farmers/dsh-memoir`，然后重启 DSH (`dsh web`)。可以通过 `dsh --profile web --dump-config` 确认插件已加载。重启后侧边栏会出现“记忆”入口。

代理会自动记住之前的会话吗？

是的，如果自动收尾功能启用（默认开启）。每轮有工具调用的回合结束后，插件会提示代理使用 `memoir_record` 记录记忆。记忆存储在 PROJECT_MEMORY.md 中，并在新会话开始时自动注入系统提示，从而让代理继承过往经验。

我可以手动添加记忆而不通过代理吗？

可以。通过侧边栏“记忆”入口打开 Web 面板，在项目记忆 tab 中点击“添加记忆”，填写分类、标题和正文即可。这将写入与代理工具调用相同的数据源。

如何跨项目搜索记忆？

使用 Web 面板的全局 tab，展示所有项目的记忆桶。也可以使用 `memoir_read` 工具，设置 `scope: 'global'` 并可选 `query` 参数按关键词过滤。

如果我手动编辑 PROJECT_MEMORY.md 会怎样？

该文件是从结构化 JSON 源（`~/.dsh/dsh-memoir.json`）重新生成的。手动编辑 markdown 文件会在下次源数据重新生成时被覆盖。要添加或修改记忆，请使用面板或 `memoir_record` 工具以保持源数据一致。