归档清理器 MS666666/dsh-archive-manager

dsh-archive-manager-plus

归档管理：在设置页列出已归档会话，并提供真正的删除（会话日志、归档标记、投影缓存一并清理）。

npm
GitHub
License: MIT

cover

特性

- 设置页新增「归档管理」标签页（官方 settings.section slot 机制，与「通用」「模型」等同级）
- 列出所有已归档会话：标题、创建时间、日志是否仍在磁盘
- 每条右侧删除按钮，二次确认后彻底删除
- 安全设计：仅接受同源 POST、sessionId 严格校验、写后由 Node 自校验、失败自动回滚备份
- 跨 PowerShell 版本无 BOM 隐患（Windows PowerShell 5.1 与 PowerShell 7 行为一致）

背景

DSH 的「归档会话」只是把会话从分组视图隐藏：session.jsonl.zstd 日志与记账原样保留，且官方 UI 没有删除入口。本插件补齐「真删除」能力——归档只是隐藏，需要真正清理磁盘时可以在这里完成。

工作原理

双半插件（与官方插件生态一致的形态）：

| 半 | 位置 | 职责 |
| host 半 | lib/ | 挂载两条 HTTP 路由：GET /dsh-archive-manager-plus/list 列出归档会话；POST /dsh-archive-manager-plus/delete 删除（会话目录 + workspace 记账 + 投影缓存） |
| 浏览器半 | client/ | 注册 settings.section 页面，渲染列表 + 删除按钮（先 confirm 二次确认，再调用 host 路由） |

删除动作的落盘范围：

1. workspace.json 的 global.archivedSessionIds 移除该 id
2. 各 workspace 的 sessionIds 移除该 id
3. 删除 /sessions/// 目录
4. session_projcache.json 中该会话条目清除

不清理 cost-meter/ledger.json（费用流水属历史记录，予以保留）。

安装

方式一：npm（推荐，社区标准）

npm install dsh-archive-manager-plus

npm 会把包装进当前项目/全局 node_modules；DSH 插件需要注册进 profile 的 bundle 层：

1. 在 /package.json 的 dependencies 加入："dsh-archive-manager-plus": "^0.1.0"
2. 在 dsh.profile.bundles 尾部加入："dsh-archive-manager-plus"
3. npm install（或 pnpm install）后在 profile 里确认包已落位，重启 DSH 并刷新页面

方式二：一键安装脚本（本地开发调试）

powershell -ExecutionPolicy Bypass -File .\install.ps1

脚本自定位插件根目录（可从任意位置运行），自动完成：白名单复制发布物 → 注册依赖与 bundle → Node 自校验（无 BOM / JSON 合法 / 条目齐全）→ 失败回滚备份。

| 参数 | 说明 |
| -ProfileDir | 显式指定 profile 目录（优先于自动探测） |
| -ProfileName | profile 名，默认 web |
| -DSHHome | 指定 DSH home（默认取 $env:DSH_HOME，其次 ~/.dsh） |
| -DryRun | 只预览，不写入 |
| -SkipCopy | 跳过复制，只更新 manifest |

.\install.ps1 -DryRun # 预览 .\install.ps1 -DSHHome # 指定安装位置

方式三：手动

1. 复制 lib/、client/、cordis.patch.yml、LICENSE、README.md、package.json 到 /node_modules/dsh-archive-manager-plus/
2. 在 /package.json 的 dependencies 加入："dsh-archive-manager-plus": ""
3. 在 dsh.profile.bundles 尾部加入："dsh-archive-manager-plus"
4. 保存（务必 UTF-8 无 BOM）后重启 DSH，并刷新页面

⚠️ BOM 陷阱：package.json 若带 UTF-8 BOM 会导致 DSH 启动报 Unexpected token ''。
推荐用 npm 安装或一键脚本（已内置无 BOM 写入与 Node 校验）。

使用

1. 侧边栏任一会话行 ⋯ 菜单 → 归档会话（归档 1–2 个会话备用）
2. 打开 设置（齿轮）→ 归档管理
3. 列表展示已归档会话：标题 / 创建时间 / 日志是否在盘
4. 点击右侧 删除 → 确认 → 该项消失，磁盘日志一并清除

隐私与安全

- 删除范围仅限已归档会话；运行中的会话不应执行删除（由调用方负责判断）
- 删除会移除磁盘日志文件与关联记账；费用流水保留
- 宿主内存态（如 session.list 残留行）在删除后到下次重连/刷新间可能短暂可见——文件与注册表层始终是一致且持久的
- 网关侧仅接受同源请求，sessionId 有严格的格式白名单（session- + 十六进制/连字符），杜绝路径穿越
- 本 README 中的路径均为占位符（、…），请勿在 issue / 讨论中粘贴本机绝对路径、用户名或会话 id

开发

- 浏览器半为纯手写 CJS bundle（无构建步骤）：改 client/client.js 后刷新页面可见（HMR 生效）
- host 半为纯 ESM：改 lib/ 后重启 DSH
- 版本号改动后重新运行 install.ps1 即可同步 manifest（无需改脚本）

发布新版本（npm）

1. 在 package.json 提升 version（遵循 SemVer）
2. 本地验证：node --check lib/*.js client/client.js + npm publish --dry-run
3. 发布：npm publish --registry=https://registry.npmjs.org/
4. 生成新的 GitHub release / tag（v），保持仓库与 npm 版本同步

许可

MIT