前言¶
DeepSeek Harness (DSH) 允许通过 Web GUI 管理会话，并提供了基础的归档能力。但在实际开发中，归档后的会话往往缺乏有效的管理手段，比如无法重命名、还原或删除。crack-time/dsh-archive 是一个 Session archive plugin for DSH web GUI，它补齐了原生工具在归档会话管理上的缺失，提供了完整的增删改查能力。
功能¶
视图与入口¶
插件在侧边栏“添加工作区”按钮右侧新增了一个 28px 圆形按钮，样式与原生 iconButton 一致，hover 时显示气泡提示。点击该按钮可切换归档视图，布局与原生会话树一致，覆盖原工作区列表区域。
归档视图¶
归档视图按工作区分组，支持分组折叠，列表按时间降序排列。
会话操作¶
每行会话 hover 出现三点菜单，提供以下操作：
- 重命名：使用原生弹窗，支持自动聚焦全选、中文输入法保护、Enter 确认、Escape/遮罩关闭及错误内联提示。
- 还原：将归档会话恢复到原工作区位置。
- 删除：通过原生确认弹窗（红色危险按钮 + 后果说明）执行，会移除日志文件，操作不可恢复。
API 接口¶
插件提供了以下 API 接口供调用：
- GET /api/archived：获取归档会话列表（按工作区分组）。
- POST /api/rename-session：重命名会话。
- POST /api/unarchive：还原归档会话。
- POST /api/delete-session：删除归档会话。
安装与启用¶
本插件需要手动链接本地包并编辑配置文件注册。
- 链接本地包到 DSH web profile（一次性）：
dsh plugin --profile web add "link:E:\path\to\dsh-archive"
- 编辑配置文件注册插件。路径为
C:\Users\<you>\.dsh\profiles\web\cordis.patch.yml，在文件中追加以下内容：
- insert:
- id: archive
name: '@crack/dsh-archive'
- 重启 dsh web。
典型用法¶
- 点击侧边栏新增的归档按钮，切换至归档视图。
- 在归档视图中，通过行菜单对会话进行重命名、还原或删除操作。
注意事项¶
- 删除操作会移除对应的日志文件，不可恢复，操作前请确认。
- 安装时需要手动编辑
cordis.patch.yml文件，请确保路径和配置正确。 - 插件以当前 DSH 进程权限运行，建议安装前检查源码与许可证。
总结¶
crack-time/dsh-archive 通过侧边栏入口和原生风格的交互，为 DSH Web GUI 增加了完整的会话归档管理能力，解决了原生工具在归档后“只能存、不好管”的痛点。更多详情请参考项目目录或 GitHub 仓库。
