前言¶
在 DSH 里同时挂着多个项目或任务时，侧栏里的工作区会越堆越长。默认视图按列表展示，找某个仓库、某条会话往往要滚动或搜索。若你按项目、用途或阶段区分工作，列表本身并不提供「分组」这一层结构。
Nestquay（dsh-nestquay）是社区维护的 DSH 客户端插件，在官方侧栏上增加工作区分组：底部切换分组、为组命名和选图标，并把已有工作区归入组。工作区与会话仍走 DSH 原有逻辑，切换分组只影响侧栏里显示哪些工作区，不改变当前打开的会话。
这是什么¶
- 名称：Nestquay（包名
dsh-nestquay） - 维护者：HumXC
- 分类：客户端（
platform: web） - 一句话：为 DSH 侧栏提供工作区分组，便于在多项目场景下查找与管理。
- 目录页：skillhub.cn/plugins/HumXC/dsh-nestquay
- 源码：github.com/HumXC/dsh-nestquay
插件通过 Cordis patch 注入侧栏与工作区相关 UI 模块，在保留 session 与 workspace 服务的前提下扩展分组视图。社区插件目录为独立站点，与 DeepSeek / 幻方无官方从属关系；安装前建议自行查看源码与 MIT 许可证。
核心功能¶
分组视图与归属¶
侧栏标题旁有视图切换，可进入「分组视图」。底部 ＋ 可新建组（名称 + 图标）。工作区 … 菜单中有 Add to group（添加到组），可选多个组；未归组的工作区仍在标准工作区视图中可见。
默认会有一个空组。在分组视图下新建的工作区，会加入创建时当前选中的组。一个工作区可同时属于多个组。
组管理¶
- 当前组标题旁的 …：编辑或删除组（至少保留一个组，最后一个组不能删；删组不删工作区与会话，也不影响该工作区在其他组中的归属）。
- 组内工作区 … → Remove from current group（从当前组移除）：仅从当前组移除。
- 底部组图标可拖拽排序；也可用键盘：聚焦图标后 Alt + 左/右方向键 调整顺序。
- 分组与当前视图会记住；图标顺序保存在当前浏览器，刷新后仍有效。
图标与窄侧栏¶
可选内置图标、在选择器里选 emoji，或直接粘贴 emoji。底部未选中的组图标为灰度，当前组为原色。侧栏变窄时，未选中组会收成圆点；悬停或聚焦可展开并显示组名。组很多时，可在导航条左右边缘悬停以滚动。
会话活动指示¶
底部图标会汇总该组内会话状态；悬停或聚焦可看计数。
| 指示 | 含义 |
|---|---|
| 图标原色扫过或脉动点 | 有会话在运行 |
| 绿点 | 会话已完成且尚未查看 |
| 交互标记 | 会话需要输入或审批 |
绿点只是提醒打开会话，不代表结果已人工验收。系统开启「减少动态效果」时，相关动画会关闭。
与标准行为的关系¶
切换分组只改变侧栏里列出的工作区，不会切换你正在查看的会话。禁用插件后侧栏回到标准工作区视图，工作区与会话数据不受影响。
安装与启用¶
要求 DSH 0.2.0-rc.2（package.json 中 peerDependencies 与此一致）。插件以当前 DSH 进程权限运行，安装前请确认 Release 包来源与仓库内容。
在 web profile 下用 DSH CLI 安装 GitHub Release 包：
dsh plugin --profile web add https://github.com/HumXC/dsh-nestquay/releases/latest/download/dsh-nestquay.tgz
若使用其他 profile，将命令中的 web 换成对应名称。安装完成后重启 DSH，并刷新浏览器页面。
典型用法¶
下面步骤与 README 中的 Getting started 一致，可按顺序操作。
- 点击侧栏标题旁的视图切换，进入分组视图。
- 点击底部 ＋，输入组名并选择图标。
- 打开某个工作区的 … 菜单，选 Add to group（添加到组），勾选目标组。
- 点击底部某一组的图标，侧栏只显示该组内的工作区。
需要把已有工作区纳入分组时，用 Add to group；在分组视图里新建的工作区会自动进入当时激活的组。
适用场景与注意¶
适合：同时在 DSH 里维护多个仓库或任务线，希望按项目、用途或阶段在侧栏里切换「上下文」，而不是在一长串列表里翻找。
注意：
- 仅核实为 Web 客户端插件（
dsh.client.platform: web），安装命令与 profile 需与本地 DSH 配置一致。 - 当前 package 版本为 0.1.15，Node 引擎要求
>=22.15.0（构建侧信息；日常使用以 DSH 与 Release 包为准）。 - 分组状态 partly 依赖浏览器本地存储，换浏览器或清站点数据可能影响图标顺序等偏好。
- 社区目录页的星标、简介可能与 GitHub 不同步；以 README 与 Release 为准。
结尾¶
Nestquay 在 DSH「一切皆插件」的生态里，专门补侧栏工作区分组这一层：多组、多归属、底部切换与会话活动提示，且不改动工作区与会话的核心行为。若要试用或查更新，可看 SkillHub 目录页 与 GitHub 仓库。
