DeepSeek Harness（DSH）采用插件化架构，通过插件扩展功能。在开发过程中，会话数量增多后，归档、移动、恢复以及查看会话详情会变得繁琐。dsh-sessions-manager 是一个由 TOBYCAI 维护的客户端插件，旨在提供一个统一的会话管理面板，并增强主页侧边栏的功能，解决会话碎片化管理的痛点。
该插件提供统一的视图面板、跨工作区拖拽、批量操作、血缘关系查看以及存储占用分析等功能。
核心功能¶
统一面板与筛选¶
插件在「设置 → 会话管理」中提供了一个统一的会话管理面板，顶部提供「全部 / 活动 / 已归档」三个常驻视图，低频的「已收藏 / 空白 / 回收站」视图则通过箭头按钮横向滑出。支持按标题、会话 ID、工作区搜索，并按工作区筛选和创建时间或标题排序。
工作区与标签管理¶
- 工作区筛选：支持按工作区进行筛选和排序。
- 标签管理：支持为会话打标签（全局标签数 ≤200，单会话 ≤10），并按标签筛选。标签索引跟随本地 DSH 数据目录，而非账号。
- 筛选预设：可以将「视图 + 工作区 + 排序 + 标签」的组合保存为筛选预设（≤20 条），一键应用。
侧边栏增强¶
在主页侧边栏，插件提供了以下增强功能：
- 跨工作区拖拽：直接将侧边栏的会话拖拽到目标工作区标题即可切换工作区。
- 状态圆点：会话左侧显示状态圆点（未读/工作中/等待反馈/完成/出错），颜色直接读取 DSH 原生状态。
- 快捷菜单：通过 ⋯ 菜单可快速执行「标记未读/已读」、「移动会话」或「删除会话」。
会话详情与血缘¶
点击会话行可查看详情，包括磁盘占用、轮次/步骤/消息/工具调用统计、图片附件列表以及 write/edit 文件列表。
- 血缘视图：提供「血缘（折叠分组）」与「平铺」两种视图。在血缘视图下，子代理会话折叠在父会话下（显示为「▸ N 子代理」），分支会话显示绿色「⑂ 分支」标记。
- 空白会话：支持识别空白会话（仅包含生命周期元数据的会话），并在「空白」视图中集中管理。
批量操作与回收站¶
- 批量多选：支持全选，并对选中项进行批量归档、恢复、删除或移动。批量操作栏会吸顶，方便长列表操作。
- 回收站：删除会话会先移入回收站，可在设置面板恢复或彻底删除。回收站支持按时间自动清理（7/30/90天）。
导出与分析¶
- 导出：支持导出会话原始日志（ZIP）和 Markdown 格式。
- 存储占用：提供按工作区聚合的存储占用分析，列出占用最大的 Top 10 会话。
安装与启用¶
使用官方插件安装命令进行安装。
# 安装插件
dsh plugin --profile desktop add "github:TOBYCAI/dsh-sessions-manager"
# 如果使用 Web 端
dsh plugin --profile web add "github:TOBYCAI/dsh-sessions-manager"
安装完成后，重启 DSH 或刷新页面即可在「设置 → 会话管理」和主页侧边栏看到该插件。
典型用法¶
- 统一管理：在「设置 → 会话管理」中查看所有会话，利用筛选栏和预设快速定位目标会话。
- 移动会话：直接在侧边栏将会话拖拽到其他工作区标题，或使用批量操作栏的「移动所选」功能。
- 查看详情：点击任意会话行，查看其磁盘占用、工具使用分布及血缘关系。
- 导出内容：在详情面板底部下载 Markdown 或原始日志。
- 自动归档：在设置面板维护栏中配置自动归档规则（如 30/60/90 天未活跃），自动清理无用会话。
注意事项¶
- 标签索引：标签索引跟随本地 DSH 数据目录，换机迁移时需要备份本地索引。
- 活跃会话移动：对于新版 Runtime 下正在被占用的活跃会话，移动操作不会失败，而是进入排队队列。需要重启 DSH 后才能自动完成移动。
- 删除机制：删除会话会先进入回收站，并非立即物理删除。已彻底删除的会话无法恢复。
- 血缘显示：在血缘视图中，如果父会话被归档或删除，其分支会话会挂在「来源」组头下。
- 空白会话：空白会话需要进入设置面板的「空白」视图中才能查看和清理。
- 兼容性：插件兼容 DSH 0.1.5+ 会话格式 v3。
总结¶
dsh-sessions-manager 通过统一的面板和侧边栏增强，提供了从归档、移动到详情分析的一整套会话管理解决方案。它适合需要精细化管理大量会话、关注工具使用统计以及希望优化工作区结构的 DSH 用户。
