dsh-memory-archiver

给 DSH 加四个免审批的记忆归档工具，把可写范围硬限制在记忆目录内。

为什么需要它

DSH 的文件沙箱只有三档（read-only / workspace-write / danger-full-access），不支持额外可写根；审批策略只有 ask / never，没有 allow-always。所以"只让记忆归档免审批、其余照旧审批"没法用配置表达。

本插件的做法：用插件自己的代码写文件（走 node:fs，不经过 ctx.fs，因此不进文件沙箱、也不触发审批），同时把可写范围硬编码校验在 allowedRoots 内——越界（含 ..、junction、symlink 逃逸）一律拒绝。其余操作仍然走 workspace-write + ask，照旧弹审批。

工具

工具	作用
`memory_archive`	写一个记忆文件（`dir` + `file` + `content`，默认拒绝覆盖；覆盖前自动备份；UTF-8 无 BOM）
`memory_index`	往索引文件追加/按锚点插入一行（保持原 BOM 与换行；重复行跳过）
`memory_patch`	就地替换一段文本（替换前自动备份；要求唯一匹配或显式 `replaceAll`）
`memory_supersede`	一次完成"写新文件 + 旧文件标 `status: superseded` + 备份"，不删除任何文件

默认根与配置

默认只允许一个根：~/.dsh/memory（~ 解析为 USERPROFILE / HOME）。

要加更多根，二选一：

环境变量 DSH_MEMORY_ROOTS（用系统路径分隔符分隔：Windows ;，类 Unix :）：
```
DSH_MEMORY_ROOTS=C:/work/memory;D:/notes/memory
```

在 profile 的 cordis.patch.yml 里按 id 覆盖：

- id: memory-archiver
  name: dsh-memory-archiver
  config:
    allowedRoots:
      - 'C:/Users/you/.dsh/memory'
      - 'D:/work/memory'

配置优先于环境变量，环境变量优先于默认值。

备份保留策略

覆盖/更正产生的备份在 <记忆目录>/.backup/，每次写新备份后自动清理：

配置键	默认	作用
`backupRetentionDays`	`30`	删除超过 N 天的旧备份；`<= 0` 关闭时间清理
`backupMaxBytes`	`0`	备份目录总大小上限（字节）；`0` 表示不设上限，超限时从最旧删

只清理 .backup/ 里的 .md 备份，不碰任何记忆正文。

- id: memory-archiver
  name: dsh-memory-archiver
  config:
    backupRetentionDays: 30
    backupMaxBytes: 52428800

安装

从源码打包：

npm pack
dsh plugin --profile <profile> add file:<tgz 的绝对路径>

或直接指向源码目录：

dsh plugin --profile <profile> add file:<repo 目录>

装完重启 DSH，并新开一个会话（工具在会话创建时绑定）。

配套插件

本插件负责写，dsh-kb-lite 负责读：kb-lite 把同一批记忆根索引起来、带引用地检索，memory_supersede 写下的 status: superseded 会在 kb-lite 的检索里降权。两个插件可以单独用；一起装则“写入 + 检索”完整。

验证

npm test          # node --test test/core.test.mjs，16 项
node test/smoke.mjs

0.2.x 的变化

覆盖/就地更正前，旧文件自动备份到同目录 .backup/<原名>.<时间戳>.md，返回值多 backup 字段。
旧备份按保留策略自动清理：默认保留 30 天，可设 backupMaxBytes 总大小上限（默认不设）。
新增 memory_supersede。
默认根改为通用（~/.dsh/memory），不再硬编码任何机器上的路径。
仍然没有删除工具（清理只发生在 .backup/ 内的旧备份上）。

安全边界

只能写 .md，且必须落在 allowedRoots 内；参数非法、锚点找不到、文件已存在（未声明 overwrite）都会拒绝。
插件运行在 DSH 主进程内，不受文件沙箱约束——这是 DSH 的设计（沙箱防的是模型，不是插件）。本插件把该能力收窄成"只能写记忆目录里的 .md"。
不写凭据、不联网、不 spawn 子进程。

卸载

dsh plugin --profile <profile> remove dsh-memory-archiver

License

MIT，见 LICENSE。

dsh-memory-archiver

安装

README