dsh-archive-restore

归档管理插件：把 DSH Web GUI 里"归档的会话"拿回来。

原名 dsh-archive-manager（npm 已被占用），发布名改为 dsh-archive-restore。

快速开始（npm 安装）

dsh plugin --profile web add dsh-archive-restore

然后重启 dsh web 服务（关闭 start-harness 窗口重新运行），刷新浏览器即可。

使用入口

设置页 → Agent 预设下方 →「归档管理」（归档箱图标）

更新

dsh plugin --profile web update dsh-archive-restore

卸载

dsh plugin --profile web remove dsh-archive-restore

需要 dsh（npm 全局）与 pnpm。安装后由 dsh plugin 自动把插件 加入 profile 的 bundles 层，无需手改配置。

功能

• 设置页新增「归档管理」大菜单（位于 Agent 预设下方，归档箱图标）。
• 右侧面板列出所有已归档会话，显示标题（会话 ID 作为次要信息），支持多选。
• 点击「恢复所选并重启」：宿主端先把所选会话从归档名单中移除（写入 ~/.dsh/storages/workspace.json，与归档操作走同一条持久化通道），然后关闭 Web GUI、用原命令行重启服务，并在端口就绪后自动打开浏览器。

原理

归档只是把会话 id 记入 workspace 域的 archivedSessionIds 集合（~/.dsh/storages/workspace.json）；会话日志与工作区槽位原样保留。本插件的宿主半在 webServer 上注册两个路由：

• POST /__dsh-archive-manager/unarchive — 仅取消归档（不重启）。
• POST /__dsh-archive-manager/restore — 取消归档 + 重启 + 自动打开浏览器。

重启由一个 detach 的 trampoline 进程驱动：等待旧进程退出 → 用 process.argv[1] 与剩余参数重建原命令行 → 在新控制台窗口启动 → 轮询端口后打开浏览器。日志写在 %TEMP%\dsh-archive-manager-restart.log。

可选：设置菜单归档箱图标补丁

DSH 设置导航的图标是硬编码映射（dsh-client-ui-settings-general），未知菜单项会落到默认齿轮。 为让「归档管理」显示归档箱图标，运行仓库内的补丁脚本（幂等，可重复执行）：

node patch-nav-icon.cjs
# 或指定 bundle 路径：
node patch-nav-icon.cjs --file <path-to-dsh-client-ui-settings-general/lib/client.js>

该补丁修改的是 node_modules 里的文件，DSH 升级后如被还原，重新运行一次即可。 不运行也不影响功能，只是菜单显示默认齿轮图标。

项目结构

dsh-archive-restore/
├── package.json          双半声明（client inject slots/sessions/workspaces）
├── cordis.patch.yml      host 行注入 webServer/workspaceRegistry
├── patch-nav-icon.cjs    设置图标补丁脚本
├── test-spawn-forms.cjs  trampoline argv 形式测试
└── lib/
    ├── index.js          host 半：两条路由 + trampoline 重启驱动
    └── client.js         browser 半：归档管理设置区块

本地开发

# 1. cd 到 web profile，在 package.json 的 dependencies 加入
#    "dsh-archive-restore": "link:<本机仓库路径>"
#    并在 dsh.profile.bundles 加入 "dsh-archive-restore"
# 2. 在 profile 目录执行 pnpm install
# 3. 重启 Web GUI（dsh web）

详细设计与实现见 docs/实施文档.md。

License

MIT