前言¶
DSH 的扩展通常通过插件完成。如果 dsh 的 Web profile 中会话越来越多，需要在侧边栏里按分类组织会话，可以考虑 ht719/dsh-session-categories。它把用户可管理的分类树加入 dsh 侧边栏，并且让每个 Workspace 维护自己的分类。
下面介绍它的定位、能力、安装命令、典型用法，以及升级和权限方面的注意事项。
这是什么¶
dsh-session-categories 是 ht719 维护的 DSH 插件，定位为：
Durable Workspace-scoped Session categories for the DeepSeek Harness
它面向当前 dsh 预发布插件 API，并用于未修改的 dsh 安装。安装后，dsh 侧边栏可以按 Workspace 显示分类、会话和层级关系，用户可以对分类和会话做创建、重命名、移动、归档等管理操作。
核心功能¶
该插件提供以下能力：
- 在 dsh 侧边栏中新增用户可管理的分类树。
- 每个 Workspace 维护自己的分类。
- 每个会话最多属于一个分类。
- 可在分类内直接创建会话。
- 可展开或折叠分类，且保留层级。
- 可将会话拖拽到另一个分类。
- 可从 Workspace 操作菜单创建顶级分类。
- 可从分类操作菜单创建子分类、重命名或删除当前分类。
- 可通过“Move to category”操作移动会话。
- 删除分类会递归归档其会话，但不会删除持久日志。
行为与约束¶
插件对变更操作有一组限制：
- 拒绝过期修订。
- 拒绝跨 Workspace 会话 ID。
- 拒绝后代移动。
- 拒绝分配到未知分类。
删除分类时，其下属会话会被递归归档；持久日志不会被删除。
安装与启用¶
先确认 dsh 命令可在 shell 中执行。对普通安装，执行下面的命令安装预构建包，然后启动 dsh Web profile：
dsh plugin --profile web add dsh-session-categories
dsh --profile web
如果你是从源码运行 dsh，使用对应的 package launcher：
pnpm dsh plugin --profile web add dsh-session-categories
pnpm dsh --profile web
如果需要使用未发布的 GitHub 版本，可以直接安装仓库版本：
dsh plugin --profile web add github:ht719/dsh-session-categories
典型用法¶
下面是一个常见的分类管理流程：
- 进入目标 Workspace。
- 从 Workspace 操作菜单创建一个顶级分类。
- 在该分类内创建会话，或将已有会话拖拽到该分类。
- 在分类操作菜单中创建子分类。
- 需要调整时，使用分类操作菜单重命名或删除当前分类。
- 需要移动已有会话时，使用“Move to category”操作。
经过上面的步骤，会话会按你设定的层级显示在 dsh 侧边栏中。删除某个分类时，注意它只会递归归档会话，不会删除会话的持久日志。
适用场景与注意¶
适合以下情况：
- 你在 dsh Web profile 中管理多个 Workspace 会话。
- 你希望按 Workspace 维护一套分类树。
- 你希望用拖拽、展开、折叠、重命名和移动分类来组织会话。
- 你使用未修改的 dsh 安装，并愿意随 dsh 版本同步升级插件。
需要注意：
- 该插件面向当前 dsh 预发布插件 API。
- dsh 不承诺预发布版本间的兼容性。
- 升级时应同时更新 dsh 和本插件。
- 插件以当前 dsh 进程权限运行，安装前应检查源码与许可证。
- 已核实资料未提供许可证信息，不能默认其许可证适合你的使用场景。
- 删除分类会递归归档会话，但不会删除持久日志。
链接¶
GitHub 仓库：
https://github.com/ht719/dsh-session-categories
已核实资料未提供目录页 URL。
