dsh-user-memory
自研的 DeepSeek Harness 插件：把你本人编写的分级长期记忆注入到我的系统提示词里，并提供一个中文图形面板让你直接看和改。
- 不是 skill，是宿主插件（Host plugin）——只要 profile 加载它，每轮都在。
- 运行时只读（除非你操作）。它永远不自己写你的记忆：只有两种写入——你在面板里点保存，或你让 AI 用文件工具改。没有任何自动采集、自动总结、后台回写、网络访问。
- AI 只能"提议"，不能"决定"：我可以把一条修改建议放进「待确认」区（
memory_suggest 工具），但只有你在面板里点「采纳」，它才会变成一条通知、让我下一轮去写。见下面「待确认区」。
- 采纳前后都能反悔：卡片上有一个「补充说明」输入框，采纳时它和我的原文一起交给我（冲突时以你的补充为准）；采纳后、我下一轮开跑之前，卡片上会多一个「撤销采纳」，点它就回到待确认，补充还能改。
- 零依赖，只用 Node 内置模块。整个目录拷到哪都能跑。
图形面板（推荐用这个）
重启 DeepSeek Harness 之后，左侧栏会出现一个「长期记忆」入口（和「插件」「上下文洞察」「技能中心」同一列），点开就是面板：
- 五个分页：必须遵守 / 行为设定 / 用户画像 / 可选遵守 / 变更日志——全部中文，不用看文件名。
- 直接改，点「保存这一节」。保存后立即生效，不需要重启。
- 保存后底部会告诉你结果，例如「已生效：这一节会注入（约 320 字）」或「目前这一节是空的（只剩标题或注释），不会注入」——你一眼就知道这次改动到底有没有用。
- 有未保存改动的分页会显示一个小黄点；「放弃改动」可一次性还原。
- 面板只认这五个文件名，其它路径一律拒绝；单个文件上限 256 KB。
待确认区（面板里的「待确认」分页）
这是给我和你之间的一个闸门：
- 我用
memory_suggest 提议一条：目标文件 + 完整措辞 + 理由。这个工具不写任何记忆文件，只在 <DSH_HOME>\memory-suggest.json 里放一条 pending。
- 你打开面板 →「待确认」→ 看到卡片。卡片下方有一个**「补充说明」输入框**（可选）：想额外加的要求、想改的措辞，写在这里。
- 打字不落盘：输入框里的字只在你点「采纳」的那一刻才随这条存下来（存进
userNote），所以犹豫期间磁盘上没有任何痕迹；5 秒一次的自动刷新也不会擦掉你正在打的草稿。
- 采纳后这一条会带着你的补充一起交给我，和我的原文冲突时以你的补充为准。补充上限 1000 字符，会自动去掉首尾空白。
- 点「采纳」或「忽略」。只有采纳之后，你下一次发消息时我才会收到一条
<MEMORY_SUGGESTION_ACCEPTED> 通知（带着你采纳的原文和你的补充）；我到那时才总结措辞、写进记忆文件，并调用 memory_suggest_done 记账。
- 反悔窗口：采纳之后、我下一轮还没开始之前，卡片状态是「已采纳 · 可撤销，等我下一轮写入」，并多出一个「撤销采纳」按钮。点它这条回到
pending，你的补充原样留着，可以改完重新采纳。
- 一旦通知已经交到我手里（状态变成「通知已送达 · 处理中」），撤销按钮就没了，并说明原因——此时改主意直接在对话里跟我说。
- 如果你点撤销的那一刻我刚好开跑，服务端会如实拒绝并告诉你没能撤销（不会出现"看着撤了其实没撤"）。
- 两种例外我会先停下把 diff 摆给你看：我的措辞与你采纳的原文有实质差异；或这条与文件里已有内容重复、冲突。
页签上有数字气泡显示待确认条数；待确认分页每 5 秒自动刷新（可以一边聊天一边看）。沉默 = 放弃：提议完我就回去干手里的活，不催你。
| 工具 | 干什么 | 会不会写记忆 |
|---|
memory_suggest | 提议一条（文件限那五个，正文上限 4000 字符，单条可带一句理由） | 不会 |
memory_suggest_done | 处理完一条后记账：写进了哪个文件，或为什么不写 | 不会 |
记忆库在哪（也可以直接改文件）
C:\Users\Adler\.dsh\memory\
├── rules-must.md 必须遵守（硬性） ← 注入
├── agent.md 我的行为设定 ← 注入
├── profile.md 用户画像 ← 注入
├── rules-should.md 可选遵守（酌情） ← 注入
└── log.md 变更日志 ← 不注入，只给你自己记账
直接记事本改也行，效果与面板完全一样——文件是唯一真相。
注入规则（决定它花多少 token）
| 行为 | 说明 |
|---|
| 注入位置 | 系统提示词的一个段落，order = -500：Harness 身份之后、人格设定之前 |
| 顺序 | 必须遵守 → 行为设定 → 用户画像 → 可选遵守 |
<!-- --> 注释 | 永远不注入。所以模板里的说明文字不占上下文、不干扰我 |
| 只有标题没有正文 | 整节不注入。空文件 = 零开销 |
| 文件都没内容 | 整块不注入，一个字符都不占 |
| token 成本 | 记忆不变时系统提示词逐字节不变 → 吃满 prompt cache；改了才会有一次新快照 |
| 预算 | 默认 6000 字符，超了按节截断并注明「已截断」 |
让 AI 帮你写（两条流程）
- 「记住…」 → AI 把内容整理成条目，先把 diff 摆给你看，你确认后才落盘。
- 「整理记忆」 → AI 把这段时间的沉淀批量整理出来，同样先给你审。
配置
在 profile 的 bundle patch 里（cordis.patch.yml）：
- insert:
- id: user-memory
name: 'dsh-user-memory'
config:
enabled: true # false = 停用注入，不卸载
dir: '' # 空 = <DSH_HOME>/memory
maxChars: 6000 # 注入总预算（含前言与截断提示）
改完需要重启才对 composition 生效；只改记忆文件内容则不需要。
安装位置
D:\AI\dsh-plugins\dsh-user-memory\ ← 插件本体（本目录）
C:\Users\Adler\.dsh\profiles\desktop\node_modules\dsh-user-memory ← Junction 指向上面的目录
自测
node test/selftest.mjs # 27 项：注入与面板
node test/suggest-test.mjs # 44 项：待确认闸门 + 补充框 + 撤销
node test/panel-test.mjs # 20 项：面板 UI（需要 react + jsdom，见下）
selftest.mjs：注入位置与顺序、注释剔除、空节不注入、预算截断、停用行为，以及面板接口（读取、保存、拒绝非法文件名、拒绝非文本、畸形请求体不崩、注入反馈文案）。
suggest-test.mjs 盯的是闸门最要紧的那条不变量：提议绝不碰记忆文件；只有 resolveSuggestion 能改状态；非法决定与未知编号被拒；内部步骤（压缩、起标题等）吃不掉一条采纳，只有带真实用户消息的那一步才送达；注入的是一条 ours 的、冻结的 user 消息；重启后待确认区与编号延续；补充（采纳时写入、去除首尾空白、1000 字截断、空补充不写、编辑后以最新一条为准、随通知原文一起交给我）与撤销（仅 accepted 可撤销 → 回到 pending、保留补充、丢掉 decidedAt；pending 与 delivered 一律 409；未知编号 404）。
panel-test.mjs 在 jsdom + React 里渲染真实的面板组件，像浏览器一样点分页、打字、点「采纳」「撤销采纳」、手动触发 5 秒轮询，断言：待确认卡片有补充框且初始为空、打字不发任何请求、采纳把补充一起发出去、采纳后变成只读展示 + 出现撤销按钮、撤销后回到输入框并保留草稿、轮询不擦草稿、已送达的卡片没有再撤销的入口。
它需要的 react / react-dom / jsdom 故意不是本插件的依赖（本插件零依赖、无构建步骤）。想让面板测试真的跑起来，装到一个临时目录再指给它（没设 UMEM_UI_DEPS 时它会打印 SKIP 并以 0 退出，CI 因此保持无依赖）：
npm install --prefix P:\_temp\umem-deps react@19 react-dom@19 jsdom@26
$env:UMEM_UI_DEPS = 'P:\_temp\umem-deps\node_modules'
node test/panel-test.mjs
改完代码先跑这三个（改了 index.js 或 client.js 还要重启 App 才生效）。
完全卸载 / 回退
plugin_manager remove_bundle dsh-user-memory
插件消失，记忆库 C:\Users\Adler\.dsh\memory\ 不会被删（数据与代码分离）。想彻底清干净就再手删那个目录。
已知边界（必须说清）
- 「必须遵守」不是技术强制。插件只能把规则放进系统提示词的强位置，不能让模型永不失误。写得具体、可判定、够短，比写得多更有效。
- 改代码需要重启。加载器用裸
import()，Node 的 ESM 模块缓存按路径记账且不失效——改 index.js 或 client.js 后必须重启 App。改记忆文件不需要。
- 两个 profile 互相独立。
desktop（桌面版）与 web（网页版）各有自己的 node_modules；这个插件目前只装在 desktop。
- 不改用 locale 服务。界面文案是硬编码中文。这是有意取舍：单语言自用插件，省掉一层 locale 注册。
