记忆管理台 · dsh-memory-console
给 DeepSeek Harness 做的一个记忆管理插件：把一堆 Markdown 记忆文件变成能点、能改、能搜的网页，并把「每轮必读的文件」当成一段提示词，稳定地注入每次对话。
它不是向量数据库，也不做语义检索。它管的是你自己写的 Markdown 文件——索引、摘要、备份、回收站，全是普通文件。
必读清单
它能做什么
| 能力 | 说明 |
|---|
| 分组列表 | 根目录 / project/ / decision/ 等，显示标题、摘要、路径、修改时间、字数 |
| 查看与编辑 | Markdown 渲染阅读；源码编辑；保存前逐行 diff，保存后自动备份 |
| 新建 | 按模板生成 # 标题 + > 摘要：…，文件名可用 话题_YYYYMM |
| 删除 | 先进 .trash/，不真删；可恢复，也可二次确认后清空 |
| 搜索 | 全文搜索所有 .md，命中行高亮 |
| 索引 | 只读展示 INDEX.md，一键重建 |
| 健康检查 | 缺摘要、超 90 天没动、索引与磁盘不一致、疑似重复条目 |
| 必读清单 | 可增删、可排序、可启停；实时显示真实提示词顺序与各段字数，改完下一轮生效 |
安装
dsh plugin --profile <profile> add dsh-memory-console
或者从本地目录安装：
dsh plugin --profile <profile> add /path/to/dsh-memory-console
装完重启一次 DSH（Host 半需要重启才生效），侧栏会出现「记忆管理」。
配置
插件根目录放一个 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。
必读清单是怎么进提示词的
Host 半用 systemPrompt.section() 注册一个段落，text 是一个每轮重新求值的函数：
把清单里所有启用文件拼起来（带 ━━━ 名字 ━━━ 小标题），带 mtime/size 缓存。
所以改清单、改文件内容，下一轮对话就变，不用重启。
「真实提示词顺序」来自宿主自己的 systemPrompt.assemble()——插件不猜顺序，只把宿主算出来的结果显示出来。
注意顺序是软的：模型看到的是一段连续文本，位置靠前只是更有分量，不是硬开关。
安全边界
- 所有路径先做
resolve + realpath 校验，只接受 memoryRoot 内的 .md；
拒绝 ..、绝对路径、符号链接越界、.backup / .trash / INDEX.md / README.md 写入。
- 保存 = 先备份到
.backup/<原名>.<时间戳>.md，再原子写（Windows 上 rename 撞锁会自动重试）。
- 删除 = 移动到
.trash/<时间戳>/<相对路径>；恢复时校验冲突；清空需要二次确认，且只删回收站内部。
- 索引重建只调用你的脚本或内置生成器，不碰其它文件。
兼容性
- DSH ≥ 0.2.1：
ctx.connection.fetch.register()（rc.2/rc.3 的 rpc.handle() 对外部插件不可用）。
- 浏览器端是纯 React 工厂模块，不引第三方依赖。
- Windows / Linux / macOS 都能跑；
attrib +h 仅 Windows 使用，其它平台靠点号前缀隐藏。
License
MIT
