前言¶
用 DeepSeek Harness（DSH）做长期对话或智能体开发时，记忆往往是一堆自己维护的 Markdown 文件：路径分散、改完不知道下一轮会不会进系统提示、全文检索要靠编辑器或命令行。向量库和语义检索是另一条路线；若你明确要管的是本地 Markdown 文件（索引、编辑、备份、回收站），社区插件 dsh-memory-console（维护者 Reyzhiai，分类：记忆）把这类文件做成可浏览、可改、可搜的网页，并把「每轮必读的文件」以可编辑清单的形式稳定注入每次对话。
下面介绍它的定位、能力、安装配置与使用注意。
这是什么¶
dsh-memory-console 是面向 DeepSeek Harness 的记忆管理插件。README 写明：它不是向量数据库，也不做语义检索；管的是你自己写的 Markdown——索引、摘要、备份、回收站，全是普通文件。
Host 侧通过 systemPrompt.section() 注册一个段落，每轮重新求值，把必读清单里启用的文件拼进系统提示（带 ━━━ 名字 ━━━ 小标题，带 mtime/size 缓存）。改清单或改文件内容，下一轮对话即生效，无需重启。插件还会在 UI 里展示宿主 systemPrompt.assemble() 算出的「真实提示词顺序」与各段字数；顺序对模型是软约束，靠前更有分量，不是硬开关。
- 目录页：https://www.skillhub.cn/plugins/Reyzhiai/dsh-memory-console
- 源码：https://github.com/Reyzhiai/dsh-memory-console
- 当前 package 版本：0.5.0，许可证 MIT，要求 Node ≥ 20，兼容 DSH ≥ 0.2.1。
核心功能¶
README 中的能力表可概括为：
| 能力 | 说明 |
|---|---|
| 分组列表 | 根目录、project/、decision/ 等，显示标题、摘要、路径、修改时间、字数 |
| 查看与编辑 | Markdown 渲染阅读；源码编辑；保存前逐行 diff，保存后自动备份 |
| 新建 | 按模板生成 # 标题 + > 摘要：…，文件名可用 话题_YYYYMM |
| 删除 | 先进 .trash/，不真删；可恢复，也可二次确认后清空 |
| 搜索 | 全文搜索所有 .md，命中行高亮 |
| 索引 | 只读展示 INDEX.md，一键重建 |
| 健康检查 | 缺摘要、超 90 天没动、索引与磁盘不一致、疑似重复条目 |
| 必读清单 | 可增删、可排序、可启停；实时显示真实提示词顺序与各段字数，改完下一轮生效 |
浏览器端为纯 React 工厂模块，不引第三方依赖；Windows / Linux / macOS 均可使用。
安装与启用¶
先做安装，再重启 DSH（README 说明 Host 半需要重启才生效），侧栏会出现「记忆管理」。
从插件源安装：
dsh plugin --profile <profile> add dsh-memory-console
或从本地目录安装：
dsh plugin --profile <profile> add /path/to/dsh-memory-console
配置¶
在插件根目录放置 config.json（可参考仓库内 config.example.json），所有字段都可省略：
| 字段 | 默认值 | 说明 |
|---|---|---|
memoryRoot |
~/.dsh/memory |
记忆目录，插件只在此目录内读写 .md |
indexScript |
空 | 指向你自己的索引生成脚本（如 PowerShell）；留空则用内置生成器 |
stateDir |
<memoryRoot>/.console-state |
必读清单等运行状态 |
personaFile |
<memoryRoot>/PERSONA.md |
必读清单的默认条目 |
powershell |
Windows 自带 PowerShell / pwsh |
仅在配置了 indexScript 时使用 |
环境变量可覆盖：DSH_MEMORY_ROOT、DSH_MEMORY_INDEX_SCRIPT、DSH_MEMORY_CONSOLE_STATE、DSH_MEMORY_CONSOLE_CONFIG。
索引格式¶
INDEX.md 的格式由你决定。若配置了 indexScript，插件只负责调用脚本，不自行拼索引。若未配置，内置生成器输出与常见的 mem-index.ps1 一致：首行 # 记忆索引 INDEX，分组标题「根目录 / 项目与事实 / 决策留档」，每条 - \relative/path.md` — 标题｜摘要`，UTF-8 带 BOM。
典型用法¶
- 安装并重启 DSH 后，在侧栏打开「记忆管理」，在默认或配置的
memoryRoot下浏览分组列表。 - 在「必读清单」中增删、排序、启停条目；观察 UI 中的真实提示词顺序与字数，下一轮对话即反映变更。
- 需要统一入口时，维护或一键重建
INDEX.md；用健康检查发现缺摘要、长期未改、索引与磁盘不一致、疑似重复等问题。 - 编辑单篇记忆：渲染阅读或改源码，保存前看 diff；删除先进回收站，需要时再恢复或二次确认清空。
安全边界与适用注意¶
插件对路径做 resolve + realpath 校验，只接受 memoryRoot 内的 .md；拒绝 ..、绝对路径、符号链接越界，以及向 .backup、.trash、INDEX.md、README.md 写入。保存会先备份到 .backup/<原名>.<时间戳>.md 再原子写入；删除移动到 .trash/<时间戳>/<相对路径>。
适用对象：已在 DSH 中用 Markdown 目录做记忆、并希望 Web 管理 + 可控「每轮必读」注入的开发者。
注意：插件以当前 DSH 进程权限读写 memoryRoot；安装前请自行查看 GitHub 仓库 源码与 MIT 许可证。DSH 生态是「一切皆插件」；SkillHub 目录页 为社区站点，与 DeepSeek / 幻方无官方从属关系。
结尾¶
dsh-memory-console 把 Markdown 记忆从「文件夹 + 手工拼 prompt」变成可点、可改、可搜的管理台，并用必读清单每轮注入系统提示。需要细节与截图时，见仓库 README 与上述目录页、GitHub 链接。
