dsh-memory-center（记忆中心）

DSH 的「长期记忆」面板插件：你自己看得见、改得动、决定要不要给模型用。

• 数据位置：自动探测——按「DSH_MEMORY_DIR 环境变量 → 面板里记住的选择 → 已有 store.json 的老目录 → 本机 DSH 数据根 <DSH_HOME>/memory → 各盘符 \dsh-data\memory → ~/.dsh/memory」的顺序找，都不行才落临时目录兜底；面板「存储位置」里可以随时改。没有写死任何盘符。
• 代码位置：本目录（本地 bundle，通过 plugin_manager install_bundle 安装）。
• 依赖：无。不联网、不调外部 API、不需要 token；只有一个本地 JSON 存储。

安装

1. 克隆到本机任意目录：

   git clone https://github.com/LornBerry/dsh-memory-center.git
   

2. 打包成一份固定副本（自测 → 打 tgz）：node dev/release.mjs

3. 用 DSH 的插件管理装这个 tgz：plugin_manager，action=install_bundle，target 填打印出来的 .tgz 绝对路径。 装完 profile 的 package.json 里是一条 file: 依赖，node_modules/dsh-memory-center 是一份真实目录副本。

4. 自检一遍：node dev/doctor.mjs --url http://127.0.0.1:<当前端口>（核对副本、版本、哈希、接口、目录可写）。

5. 刷新 Web GUI：侧栏出现「记忆」，设置里出现「记忆库」。

6. 刷新 Web GUI：侧栏出现「记忆」，设置里出现「记忆库」。

更新与本地开发

装的是固定副本，不是软链——这是有意的：先前用 link: 安装时，源码目录一旦被清空或移动，DSH 下次启动就找不到插件，面板整块消失（2026-10-23 真实发生过）。

更新是显式两步：

node dev/release.mjs            # 自测 + 升版本 + 打包，打印 install_bundle 的 target
# 然后 plugin_manager action=install_bundle target=<新 tgz>

• client.js 改动重新安装后刷新页面即生效；index.js（宿主半）改动需重启 DSH。没有构建步骤。
• 不要直接改 node_modules/dsh-memory-center 里那份副本，下次安装会被覆盖。
• 想发 npm 包：去掉 package.json 的 "private": true → npm version patch → npm publish；市场按 npm latest 展示，与本地 tgz 安装互不影响。
• 每次改完记得 git add -A && git commit && git push，并打 tag（如 v0.4.1）作为回滚点。

加固（v0.2.1）

• 库文件坏了不再让插件永久卡死：第一次请求报错并指出文件路径（文件不动），第二次自动备份成 store.json.corrupt-<时间> 再重建空库；修好文件后无需重启就能读。
• 切换数据目录落到一个已有记忆的目录时改为合并而不是覆盖，先把目标原文件备份成 store.json.pre-switch-<时间>。
• 注入去重同时检查那条 recall 消息是否还在上下文里，被压缩裁掉后会重新注入。
• 面板接口要求 application/json 且同源（或 Origin 缺省 / null），Sec-Fetch-Site 只认 same-origin/none，跨站页面既不能读也不能写。
• 批量启停/移动/删除走一次 item.batch；导入条目顺序连续编号；超长注入按码点截断；Git 命令 30 秒超时、不弹交互式密码提示；会话记录按 180 天清理。
• 自测新增 dev/resilience.test.mjs，dev/host-smoke.mjs 覆盖 415/403、无效 groupId、批量与切换合并。

会话自动归档（v0.3.0）

• 同一个会话里模型写到第 2 条记忆时，自动建一个「与会话标题同名」的文件夹，把这批候选记忆一起放进去；状态仍是「待确认」，还是要你点「转正」才生效。
• 第 1 条留在「未归类」；第 2 条起自动连同前面的同会话条目一起归档，不用手动拖。
• 会话标题优先取宿主给的标题；没有就取本轮第一条用户消息（压空白、超 24 字截断加 …），和 GUI 侧栏标题同源。
• 同名文件夹直接复用；你自己手动拖过的条目不会被覆盖。自测见 dev/memory-write.test.mjs。

锚点：完全 / 仅权重（v0.4.0）

• 每条记忆可以在编辑弹窗里选「锚点」：不启用（默认）、完全锚点、仅权重。
• 完全锚点 = 必须完全照此执行/表达，不得偏离（适合硬规矩，如「只用中文回答」「接口必须带 X 头」）。
• 仅权重 = 只作为输出倾向的权重，影响措辞与优先级、允许偏离（适合语气、风格、偏好）。
• 注入时条目行前会带 〔完全锚点〕 / 〔权重锚点〕 标记，顶部有一行规则说明；面板卡片上也有对应徽标。
• 自测见 dev/anchor.test.mjs。

你会看到什么

位置	组件	作用
左侧栏	「记忆」文字入口	打开「记忆中心」主面板（收起侧栏时这行只有一个「记忆」小牌子）
设置 → 记忆库	设置内页	同一个记忆库的完整管理界面（嵌入版，隐藏「返回对话」）
输入框左侧	「记忆」chip	显示本会话加载了几条；点开弹层可一键切 不加载 / 全部 / 某个文件夹（直接整组带入）
输入框上方	记忆卡片	新会话（还没决定时）出现：「选文件夹…」弹层一下就整组加载，不用一条条勾
主面板	资源管理器式	左栏文件夹、右栏条目；拖拽卡片到文件夹即移动、勾选多选后批量移动/停用/删除、右键或悬停「…」出菜单、顶部面包屑回上级
主面板 →「存储位置」	存储设置	设置页顶部与主面板左栏底部的库路径都可点即复制，旁边「更改…」打开此弹窗；弹窗里路径输入框可直接编辑，旁边有「复制」和「选择…」；改完点「应用」才切换（默认把现有记忆复制过去），选择记在数据目录内的 config.json
主面板 →「云端同步」	同步设置	三选一：不绑定 / Git 仓库 / WebDAV 网盘。默认「不绑定」，记忆只在本机

跨设备（可选，默认关闭）

记忆本体永远在本机的数据目录里，云端只是「多设备共用同一份」。三种选择：

选项	适合谁	代价
不绑定（默认）	只在一台机器用，或者接受手动导出导入	换设备看不到；一个字节都不外发
Git 仓库	有 GitHub / Gitee / 自建 git 的人	需要建一个私有仓库、配一次凭据。换来完整历史、可回滚、冲突按条目合并
WebDAV 网盘	坚果云 / Nextcloud / 群晖用户	没有历史版本，只有一个 store.json；撞车时后写的赢

• 开了之后：打开面板时自动拉取（可关），改动后 4 秒自动上传（可关），也可以随时点「立即同步」。
• 冲突规则：按条目合并——同一条记忆两边都改，updatedAt 新的赢；删除会记墓碑，不会在另一台设备上「复活」。
• 大小：一条记忆几百字节，一万条也就几 MB；Git 侧只存增量，不会越存越满。
• Git 侧的实现细节：数据目录下会多出 .git-sync/repo（影子仓库），config.json 和 sessions.json 不入库（前者含本机凭据，后者只对本机会话有意义）。
• WebDAV 的账号密码存在本机 config.json 里（明文）；.gitignore 已经把 config.json 排除在 Git 之外，但走 WebDAV 时它就在本机文件里。
• 新装第一次打开时，「待确认」里会有一条「跨设备记忆需要开同步」的提醒，说明去哪绑、不绑也能用；它不参与注入，删掉也不会补回，绑定入口一直在面板工具栏和设置页里。

关键行为

1. 像 Windows 文件夹那样整理：左栏点文件夹进入（面包屑可点回「记忆」）；把卡片拖到左栏文件夹 = 移动；勾选多条 = 批量条（移动到 / 停用 / 启用 / 置顶 / 转正 / 加入本会话 / 删除）；文件夹行悬停出「…」、右键也有菜单（带入本会话 / 重命名 / 上移 / 下移 / 删除）。
2. 每个新会话都问一次：没有决定过的会话不会注入任何记忆，输入框上方会出现卡片让你选。选过之后不再问。
3. 按文件夹选：多项目并行时不用一条条挑——新会话卡片「选文件夹…」、输入框「记忆」弹层里的文件夹按钮、面板文件夹行的「带入」，三处都是一下点中整个文件夹（下一轮生效）。
4. 中途导入：chip 弹层「导入记忆…」或面板工具栏「导入」，都支持粘贴 JSON、合并预览、重复跳过。
5. 模型写入需你确认：模型调用 memory_write 写入的条目先落「待确认」；同一会话第 2 条起会自动放进以会话标题命名的文件夹（仍待确认）。点左栏「待确认」页签，顶部有「全部转正 / 存放到…并全部转正 / 全部删除」兜底，单条也可以右键「存放到文件夹」+「转正」。转正后才参与注入。
6. 注入内容可见：每次注入以一条消息出现在对话里（就是你现在看到的这段），面板里也能「预览注入」查看全文。
7. 手动整理：文件夹改名/上移下移/删除（条目移入未归类或一起删）、条目移动文件夹、置顶、停用、标签自由编辑、搜索、导出 JSON / Markdown。

模型侧工具

• memory_search：检索已启用的记忆（标题 / 正文 / 标签子串）。
• memory_write：写入候选记忆。新记忆先落「待确认」，模型不能指定文件夹；同一会话第 2 条起自动放进「会话标题」文件夹（仍待确认）。你在面板里右键条目「存放到文件夹」或点「转正」即可。
• 判断顺序是「关键词为主、自判为辅」：用户明说「记一下」直接写；命中偏好/固定事实/拍板决策的关键词就写（只排除明显只对这一次有效的临时状态）；没命中关键词再四问自判是否跨会话有用。单次对话最多 3 条，标题写结论、正文带具体值与原因。

数据格式（store.json）

{
  "version": 1,
  "groups": [{ "id": "g-xxxx", "name": "项目约定", "order": 0, "createdAt": "..." }],
  "items": [{
    "id": "m-xxxx", "title": "...", "body": "...", "tags": ["约束"],
    "groupId": "g-xxxx", "enabled": true, "pinned": false,
    "status": "active", "source": "manual", "order": 0,
    "createdAt": "...", "updatedAt": "..."
  }]
}

sessions.json 记录每个会话的选择：{ "<sessionId>": { "mode": "none|all|custom", "groupIds": [], "itemIds": [], "decidedAt": "..." } }。

环境变量

变量	默认	说明
DSH_MEMORY_DIR	自动探测	显式指定数据目录（设了就最高优先，面板里锁为只读）
DSH_MEMORY_CONFIG	<数据目录>/config.json	记录面板里选择的配置文件路径（默认就放在数据目录里，切换目录时新老两处都会更新）
DSH_MEMORY_MAX_CHARS	12000	单次注入上限（超出截断）

自动探测的顺序：DSH_MEMORY_DIR → 候选目录里已有的 config.json（记住的选择，不可写则跳过）→ 已经存了 store.json 的老目录 → 已存在的 <盘符>:\dsh-data\memory（本机 DSH 数据在这个盘上就跟它放一起）→ <DSH_HOME>/memory → 各盘符 \dsh-data\memory → ~/.dsh/memory → 系统临时目录。<DSH_HOME> 取环境变量 DSH_HOME，其次从 DSH_PROFILE_DIR 上溯两级，最后退回 ~/.dsh。 想先看看会选到哪，可以跑：node dev/paths.test.mjs；宿主半的读写/切换行为可以跑：node dev/host-smoke.mjs（用临时目录，不碰真实记忆库）。

卸载

plugin_manager → remove_bundle → dsh-memory-center；数据目录自行保留或删除。

开发与自测

• 装进 profile 的是 dev/release.mjs 打出的固定副本；改完源码要重新 release.mjs + install_bundle 才生效。

• 一键发版：node dev/release.mjs（自测 → 升版本 → 打包 → 打印安装命令）；node dev/doctor.mjs --url <端口> 做安装/运行期自检。

• 离线自测（不需要浏览器、不需要 react，Node 22+ 即可）：

  node dev/smoke-client.mjs
  

  它内置一个微型 hook 渲染器，逐个渲染各插槽组件并检查注册拓扑与页面文案，输出 SMOKE OK 表示通过。

• 其余离线测试（都不联网、不碰真实记忆库）：

  node dev/paths.test.mjs    # 数据目录会探测到哪
  node dev/host-smoke.mjs    # 宿主半 API 与目录切换
  node dev/merge.test.mjs    # 两台设备的条目级合并规则
  node dev/sync.test.mjs     # WebDAV 后端（本地假服务器）
  node dev/sync-git.test.mjs # Git 后端（本地裸仓库扮远端，模拟两台设备）
  node dev/anchor.test.mjs   # 完全锚点 / 权重锚点
  node dev/encoding.test.mjs # 无 BOM、无乱码（提交前必跑）
  node dev/memory-write.test.mjs
  node dev/resilience.test.mjs
  

• 接口自测（端口换成你当前 DSH Web GUI 的端口）：

  curl -X POST http://127.0.0.1:<port>/dsh-memory/api -H "content-type: application/json" -d '{"op":"state"}'
  

  可用 op 见 index.js 的 switch (op)：state / group.* / item.* / session.* / import.preview / import.apply / export / search / config.get / config.set / sync.get / sync.set / sync.now。

• 需求与验收标准：见 SPEC.md。