前言¶
在 DeepSeek Harness (DSH) 的开发过程中，会话会被归档以保留上下文。随着使用时间的增长，归档集中的会话数量可能变得庞大，且难以在主界面中快速恢复或彻底清理。dsh-archive-sessions 插件旨在为 DSH 增加一个专门的会话管理入口，让开发者能够直接在设置页面中查看、恢复或永久删除已归档的会话。
插件简介¶
名称：dsh-archive-sessions
所有者：jujiujiang222-cell
许可证：MIT
核心价值：提供归档会话的持久化视图，支持恢复至侧边栏及永久删除（含二次确认）。
核心功能¶
该插件主要解决归档会话的管理问题，具体包括：
1. 会话列表：列出所有具有持久化日志的已归档会话。插件以磁盘文件为准，避免因内存状态不一致导致的脏数据。
2. 信息展示：显示会话标题、创建时间、工作目录以及当前是否在内存中处于打开状态。
3. 恢复会话：将已归档的会话移出归档集，使其重新出现在侧边栏。
4. 永久删除：移除会话的日志文件并解除工作区关联，操作前需在页面内进行二次确认。
安装与启用¶
安装插件需要当前环境具备 DeepSeek Harness 的 Web Profile，并拥有插件市场运行时环境。
官方安装¶
使用以下命令从 GitHub 安装：
dsh plugin --profile web add github:jujiujiang222-cell/dsh-archive-sessions
本地构建安装¶
若需从源码构建，请将包放入依赖集，并确保配置文件中存在以下行：
# cordis.patch.yml
- insert:
- id: dsh-archive-sessions
name: dsh-archive-sessions
安装或更新后，重启应用，打开 设置 → 归档会话 即可使用。
使用说明¶
在设置页面的“归档会话”栏中，你会看到所有磁盘上存在的归档会话列表。
* 恢复：点击恢复后，会话会立即回到侧边栏。
* 删除：点击删除并确认后，插件会尝试移除对应的日志文件。由于安全限制，删除操作需要完全访问权限策略。
注意事项¶
- 删除机制：会话日志采用追加写入模式。永久删除会在归档集中留下“墓碑”标记，直到应用重启后才会完全清除引用。
- 内存会话：如果会话当前在内存中处于活跃状态，删除前必须先停止代理（通常需要约 4 秒）。
- 权限要求：删除应用数据目录中的文件需要完全访问权限策略，沙箱默认 Shell 无法执行此操作。
- 不可逆性：已永久删除的会话无法恢复。
- 依赖项：该插件依赖以下 DSH 客户端库：
@deepseek-ai/dsh-client-connection@deepseek-ai/dsh-client-runtime@deepseek-ai/dsh-client-ui-settings
生态与链接¶
DeepSeek Harness 遵循“一切皆插件”的理念。该插件由社区开发者维护，与 DeepSeek 官方无从属关系。
* GitHub 仓库：jujiujiang222-cell/dsh-archive-sessions
* 插件目录：jujiujiang222-cell/dsh-archive-sessions
