前言¶
DeepSeek Harness（DSH）以工作区组织会话。若一个工作区目录里同时放着多个互不相关的项目，侧栏会话列表往往混成一条长链，切换时容易点错上下文。文件夹路径能区分文件，但 DSH 默认并不会按「项目」自动给会话分栏。
下面介绍社区客户端插件 dsh-session-groups（维护者 Zcc50）：在同一工作区内手工划分 session groups，侧栏结构变为「工作区 → 分组 → 会话」，互不相关的项目可以各自归位，而无需为每个项目单独建工作区。
这是什么¶
dsh-session-groups 是仅运行在浏览器端的 DSH 插件（分类：客户端）。简介原文为：Session groups for DeepSeek Harness: split one workspace into unrelated project groups.
分组定义与会话归属保存在本机 localStorage，不写会话日志；与官方 DeepSeek / 幻方无从属关系，安装来源为社区目录或 GitHub 仓库。
- 目录页：https://www.skillhub.cn/plugins/Zcc50/dsh-session-groups
- 源码：https://github.com/Zcc50/dsh-session-groups
- 许可证：MIT（
package.json版本 0.1.0）
核心功能¶
以下能力均来自仓库 README，安装后侧栏全局面板图标区域会出现 Session groups 入口。
侧栏三层结构¶
侧栏会话列表变为 workspace → group → session。分组是手工指定，不是按文件夹自动归类，因此多个项目可以共用同一个工作区目录。
分组管理面板¶
左栏 Session groups 打开管理板：选择工作区，创建、重命名、排序、删除分组，并在分组之间移动会话。
会话行菜单¶
每个会话行「…」菜单提供：Open、Rename、Move to group…、Archive / Unarchive、Copy session ID。README 说明当前未暴露 pin、fork。
默认工作区标题¶
存储键 default-workspace 的标题会渲染为本地化文案「Default workspace」。
本地数据¶
分组与分配保存在浏览器 localStorage，键名 dsh.session-groups.v1，按工作区分键。不向 session log 写入数据。
主题与兼容¶
配色使用 --dsw-alias-* 设计令牌，可随已安装皮肤（含 dsh-claude-style）在调色板层面一致。README 写明在 DeepSeek Harness 0.2.1-rc.3 上构建并验证；依赖若干公开 Client 插槽与 useWorkspaces、useSessions、ctx.uiWorkspace 等扩展点（详见 README Compatibility 节）。
已知限制¶
README 列出的限制包括：无拖拽排序、无 hover 详情卡、无内容搜索、无工作区树形嵌套；归档会话默认隐藏（可切换）；当前空白会话（含当前会话）会显示。
安装与启用¶
插件无运行时依赖、无需构建步骤。官方安装方式为指向插件目录安装 bundle（需使用本机绝对路径）：
# clone or download this repository, then point the harness plugin manager at the directory
plugin_manager install_bundle target: <absolute path to this directory>
也可在 DSH 会话中粘贴上述目录的绝对路径，请智能体代为安装。安装后需重启或刷新页面；侧栏入口出现在侧栏全局面板图标下方。
安装前请自行阅读源码与 MIT 许可证。插件以当前 DSH 进程及浏览器上下文权限运行，分组数据仅存在本机浏览器，换设备或清缓存需自行迁移。
典型用法¶
1、划分分组并移动会话¶
刷新侧栏后，打开 Session groups，选中工作区并创建分组。在侧栏某会话的「…」里选 Move to group…，将会话归入对应分组。无关项目的会话不再混在同一层列表里。
2、归档与 ID¶
同一菜单可 Archive / Unarchive；需要对接脚本或排查问题时可用 Copy session ID。
3、导出与导入分组数据¶
分组按浏览器、按工作区存储。换浏览器或备份时可按 README 在开发者控制台操作：
// export (Console)
copy(localStorage.getItem('dsh.session-groups.v1'))
// import (Console, then reload)
localStorage.setItem('dsh.session-groups.v1', `paste JSON here`);
location.reload();
适用场景与注意¶
适合：同一物理工作区里并行多个独立任务或仓库，希望侧栏按「项目/主题」手工分区，又暂时不想拆成多个 DSH 工作区。
注意：
- 数据仅在当前浏览器的
localStorage；隐私模式、清站点数据会导致分组丢失，重要布局请用上文 JSON 导出备份。 - 与 DSH 小版本、皮肤若 DOM 强绑定官方类名，自定义侧栏列表可能无法被该皮肤完全覆盖（README Compatibility 已说明）。
- 社区插件生态遵循 DSH「一切皆插件」思路；SkillHub 目录为独立社区站点，非官方应用商店。
结尾¶
dsh-session-groups 用轻量本地分组改写了侧栏会话组织方式，适合「一个工作区、多个无关项目」的日常开发。进一步说明与 issue 见 GitHub README；浏览与发现插件可用 SkillHub 目录页：https://www.skillhub.cn/plugins/Zcc50/dsh-session-groups，源码：https://github.com/Zcc50/dsh-session-groups。
