前言¶
DeepSeek Harness（DSH）把会话当成任务挂在侧边栏。任务一多，默认按工作区平铺，很难按主题或优先级自己排布；同时开多个会话时，也不方便一眼看到哪些还在跑、哪些在等确认、哪些还没读。社区插件 dsh-task-groups（维护者 spike237，分类：客户端）在侧边栏增加自定义任务分组和「活动」铃铛，在不丢掉原有「项目」视图的前提下，用拖拽和视图切换整理会话，并用单独面板集中需要关注的项。
这是什么¶
dsh-task-groups 是 DSH 的客户端插件（npm 包名 dsh-task-groups，当前版本 0.1.1，MIT 许可）。它通过 Cordis patch 注入侧边栏相关 UI 模块，提供两件事：按自定义分组组织任务，以及通过铃铛打开「活动」面板查看运行中、待确认和未读会话。插件在 SkillHub 目录 与 GitHub 仓库 公开维护；目录与 DeepSeek / 幻方无官方从属关系，属于 DSH「一切皆插件」生态里的第三方扩展。
核心功能¶
任务分组¶
下面介绍分组侧的能力，均来自仓库 README 说明。
- 自定义分组：相关会话可放进同一组，命名、换色，折叠或展开。
- 拖拽整理：任务与分组均可拖动排序；拖进分组即归类，拖到组外即移出；分组也可放在未分组任务之间。
- 组内操作：在分组内直接新建任务，或批量标为已读、归档会话。
- 保留项目视图：顶部可在「分组 / 项目」之间切换；项目视图仍按工作区展示任务，并保留「显示更多」等原有行为。
删除分组只会解除任务的分组关系，任务本身仍保留。右键分组可编辑、全部标为已读或批量归档。
活动铃铛¶
点击侧边栏小铃铛进入「活动」面板。运行中、等待确认和未读的会话集中在「优先级」；其余列在「其他」。打开未读会话后，它仍会留在「优先级」，便于来回查看。处理完后，点击活动面板右上角的扫帚（清除已读），可将可清理的会话移入「其他」；运行中或等待确认的会话继续保留。再次点击铃铛返回任务列表。
数据持久化¶
分组、任务归属、排序和视图偏好保存在 $DSH_HOME/task-groups/state.json；未设置 DSH_HOME 时使用用户目录下的 .dsh。由 Host 校验并原子写入，重启后可恢复。卸载 profile 链接时会移除插件配置与目录链接，README 说明分组数据会保留。
安装与启用¶
环境要求：已安装并运行过 DeepSeek Harness，以及 Git 和 Node.js 20.11+（package.json 中 engines.node 为 >=20）。通过 npm 安装需要 DSH 0.2.1+。
先做插件安装，再重启 DSH。以下以 Windows 默认 desktop profile 为例：
dsh plugin --profile desktop add dsh-task-groups
安装脚本 tools/enable-profile.mjs 也可把本地 checkout 链进指定 profile（会备份并修改已有 profile 配置；安装后需保留插件目录，移动目录后需重新设置链接）。指定 profile 或数据目录示例：
node tools/enable-profile.mjs --profile my-profile
node tools/enable-profile.mjs --home "D:\DSH" --profile desktop
未传入 --home 时，脚本优先使用环境变量 DSH_HOME，否则使用 %USERPROFILE%\.dsh。
重启 DSH 后，侧边栏出现「分组 / 项目」切换和小铃铛即可使用。
卸载默认 profile 中的插件后同样需要重启：
node tools/enable-profile.mjs --remove
若安装时用过 --home 或 --profile，卸载时使用相同参数。
典型用法¶
先做分组，再把任务拖进去：在分组区域右键，选择 新建分组，然后将相关任务拖入该组。常用操作如下。
| 想做什么 | 怎么操作 |
|---|---|
| 新建分组 | 右键分组 → 新建分组，或顶部 ⋯ 菜单 |
| 切换整理方式 | 点击顶部「分组 / 项目」 |
| 修改分组名称或颜色 | 点击分组前的彩色 # 图标 |
| 在组内新建任务 | 点击分组右侧的 ⊕ |
| 调整顺序或所属分组 | 拖动任务或分组，按插入线放置 |
| 查看当前活动 | 点击小铃铛；再次点击返回 |
| 清理活动列表 | 点击活动面板右上角的扫帚 |
| 搜索任务 | 顶部 ⋯ → 搜索任务 |
| 更多任务操作 | 右键任务：重命名、置顶、标记未读、分支、移动到分组或归档 |
适用场景与注意¶
适合长期在 DSH 里并行多个会话、希望按主题或优先级自行整理侧边栏的开发者。需要快速扫一眼「谁在跑、谁在等、谁未读」时，活动面板比逐条翻列表更直接。
安装前请自行查看 GitHub 源码 与 MIT 许可证。客户端插件随 DSH 进程与用户权限运行，会读写 $DSH_HOME（或 ~/.dsh）下的状态文件；使用 enable-profile.mjs 时会改 profile 的 package.json 链接，建议在了解脚本行为后再执行。问题反馈可走仓库 Issues。
结尾¶
dsh-task-groups 在 DSH 侧边栏补上分组拖拽与活动集中视图，并保留按工作区的项目视图。安装以 dsh plugin --profile desktop add dsh-task-groups 为主，重启后即可在「分组 / 项目」与铃铛之间切换使用。
- 目录页：https://www.skillhub.cn/plugins/spike237/dsh-task-groups
- GitHub：https://github.com/spike237/dsh-task-groups
