DeepSeek Harness (DSH) 的核心架构是“一切皆插件”。在长期使用过程中，历史会话会被归档存储，但这些会话通常只存在于底层数据库或文件系统中，缺乏直观的 Web 管理界面。dsh-archived-list 插件解决了这个问题，它为 Web 设置页面增加了一个专用的“已归档 / Archived”管理入口，允许直接查看、恢复或删除这些会话。
插件定位¶
- 名称：dsh-archived-list
- 维护者：Yiklek
- 类别：记忆
- 许可证：MIT
该插件通过一个独立的 Web 页面覆盖了 workspaceRegistry 的恢复写入路径，使得归档会话的管理操作变得可视化。
核心功能¶
该插件主要提供以下能力：
- 导航与分组：在 Web 设置页面新增“已归档”导航行。列表按工作区分组显示，每组内按时间倒序排列，并显示会话总数。
- 会话信息：每一行显示会话的标题（优先使用日志回溯标题，降级使用客户端列表或目录名）以及完整的 Session ID（支持选中复制）。
- 多选操作：支持单行多选，以及按工作区分组全选。工具栏显示“已选 N 项”，并提供恢复、删除和取消选择操作。
- 恢复机制：点击恢复后，插件会将 Session ID 从
archivedSessionIds集合中移除，会话状态恢复为活跃，但默认不自动打开对话，保持设置页面的开启状态。页面包含两个开关，可配置“恢复后自动打开”和“恢复后关闭设置页”。 - 永久删除：点击删除会触发二次确认。操作顺序为：拒绝实时会话请求 -> 读取持久化头部定位日志 -> 分离会话会计关系 -> 从归档集合中移除 ID -> 删除磁盘上的日志目录。
安装与启用¶
使用官方 CLI 进行安装：
npx @deepseek-ai/dsh plugin --profile web add github:Yiklek/dsh-archived-list
安装完成后，需要重启 DSH 服务（dsh web）以加载插件配置。
可以通过以下命令验证插件是否正确注入配置：
dsh --profile web --dump-config | grep -A2 archived-list
典型用法¶
- 启动
dsh web。 - 在浏览器打开 Web 设置页面。
- 点击左侧导航栏中的“已归档 / Archived”。
- 勾选需要恢复或删除的会话，使用顶部工具栏执行对应操作。
注意事项¶
- 服务端点：远程服务命名空间为
archvList，包含三个端点：archvList/list、archvList/restore和archvList/destroy。 - 依赖检查：确保项目中的
@deepseek-ai/dsh-typert-protocol和@deepseek-ai/cordis包是 DSH 安装目录的符号链接（symlinks）。如果这两个包指向了物理副本而非 DSH 自身，列表中的会话将显示为“(无标题)”。 - 会计逻辑：归档操作仅移除会话 ID，不影响工作区的会计统计；恢复和删除操作则是其逆过程。
该插件适合需要在 Web 界面直接管理历史会话、恢复重要对话上下文的 DSH 用户。更多细节可参考项目目录或源码仓库。
