dsh-workspace-organize
将 DSH 工作区归入命名组，并在侧边栏中浏览组 > 工作区 > 会话。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:GT-610/dsh-workspace-organize#a4e7fbf264b9a4f71d23774d55927facf991e159Workspace Organize 以 dsh-workspace-organize 发布，当前版本为 0.1.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
点击下方 Badge 复制 Markdown，粘贴到 README 即可。
验证 package.json 声明的 GitHub 仓库，即可管理这个公开页面。认领后，Hub 会优先安排当前版本的安全扫描，并在通过后公开展示结果。
认领这个 Plugin →把 DSH 侧栏的工作区归入自定义分组，按 分组 → 工作区 → 会话 三级浏览。分组只是插件自己的一层虚拟归类：工作区登记、会话、归档与置顶集合都不会被它改写。
--dsw-* 设计令牌和同一批官方组件（Menu、Modal、Tooltip、Icon*、StateDot），所以主题切换、右键菜单的模糊与透明都跟随外壳，不需要插件自己维护。$DSH_HOME/storages/，与官方工作区注册表互不干涉；除非你点了重命名/归档/删除，插件不会改动任何工作区或会话。blank），官方侧栏只显示主视图当前持有的那一个并显示为「新会话」。插件遵循同一条规则：历史遗留的草稿不再堆成一行行与工作区同名的会话。contextmenu 阶段声明：如果某个右键菜单插件已经接管了这一行，事件在捕获阶段就被它拦下，插件不会弹出第二个菜单，也不会用 mousedown 绕开仲裁。┌─ DSH Web 外壳 ────────────────────────────────────────────────┐
│ │
│ sidebar.workspaces 槽位（单槽位，按 priority 取最低的条目） │
│ ├─ 官方 WorkspaceBrowser priority 0 （仍然注册） │
│ └─ 本插件 GroupedBrowser priority -100（胜出渲染） │
│ │
│ GroupedBrowser │
│ ├─ 读官方快照：useWorkspaces / useSessions / useSessionStatus
│ ├─ 写官方操作：ctx.get('uiWorkspace' | 'workspaces' | 'sessions')
│ └─ 分组文档 ←→ /api/workspace-organize（Host 路由） │
└──────────────────────────────────────────────────────────────┘
Host 半边（src/index.ts）
GET /api/workspace-organize → 读取分组文档（loopback 可信）
POST /api/workspace-organize → 同源写入，原子落盘
└─ $DSH_HOME/storages/workspace-organize-groups.json
官方条目依然注册在同一个槽位上（priority 0），所以它声明的子槽位继续存在；本插件以更低的 priority 赢得这个单元格的渲染。这也是为什么组件只能拿到 owner 属性与框架标准钩子：官方条目自己的注入面不会转发给一个遮蔽条目，所有业务操作都通过 ctx.get 惰性解析官方服务。
dsh plugin --profile <profile> add dsh-workspace-organize
# 或直接从仓库安装：
dsh plugin --profile <profile> add github:GT-610/dsh-workspace-organize
装好后重启 DSH 让 Host 重新扫描插件表。构建产物 dist/ 随仓库提交，因此从 git 安装不需要给构建脚本开白名单（DSH 默认阻止包执行构建脚本，带 prepare 的包会被直接拒绝安装）。
git clone https://github.com/GT-610/dsh-workspace-organize
cd dsh-workspace-organize
pnpm install # 开发依赖；dist/ 已提交，克隆后可直接软链使用
pnpm build # 改了源码之后再构建 dist/
再把仓库软链进 profile 的 node_modules，重启 DSH：
# Windows
New-Item -ItemType SymbolicLink -Path "$env:USERPROFILE\.dsh\profiles\<profile>\node_modules\dsh-workspace-organize" -Target (Get-Location)
# macOS / Linux
ln -s "$PWD" ~/.dsh/profiles/<profile>/node_modules/dsh-workspace-organize
之后 pnpm dev（tsdown --watch）改完源码刷新页面即可。
| 想要的效果 | 操作 |
|---|---|
| 新建分组 | 标题栏的滑杆按钮 → 新建分组 |
| 重命名 / 解散分组 | 分组行右键或 ⋯ |
| 归档组内全部会话 | 分组行 ⋯ → 归档组内全部会话… |
| 删除组内全部工作区 | 分组行 ⋯ → 删除组内全部工作区… |
| 把工作区移入分组 | 工作区行 ⋯ → 移入分组 → 选分组 |
| 移出分组 | 工作区行 ⋯ → 移出分组 |
| 在此工作区新建会话 | 工作区行 ⋯ 或行尾的 ＋ |
| 展开 / 折叠全部 | 标题栏滑杆按钮 → 展开全部 / 折叠全部 |
| 搜索会话 | 标题栏放大镜 |
$DSH_HOME/storages/workspace-organize-groups.json，以及浏览器 localStorage 里的镜像（断网时先落镜像，恢复后仍以 Host 为准）。rename，并且走一条串行写链，避免并发请求互相覆盖。Sec-Fetch-Site，否则回退比对 Origin 与 Host，两者都没有的请求一律拒绝。src/
├─ index.ts Host 半边：路由、同源校验、原子存储
├─ shared/contract.ts 两侧共用的分组文档类型与校验器
└─ client/
├─ index.tsx apply()、官方服务组装、崩溃边界、槽位注册
├─ contract.ts Client 侧契约（Services / 注入面）
├─ Browser.tsx 三级树、行、菜单、弹窗
├─ select.ts 纯派生：可见行规则、状态汇总、时间分档
├─ groups.ts 分组文档传输与 localStorage 镜像
├─ i18n.ts 中英文案
└─ styles.ts 行布局样式表（只用 --dsw-* 令牌）
tests/
├─ select.spec.ts 纯派生（空白会话规则、汇总、时间分档）
├─ contract.spec.ts 文档校验器与同源写入闸门
├─ browser.spec.tsx jsdom 里挂载组件，验证行与菜单接线
└─ stubs/primitives.tsx 官方组件的替身（原因见下）
pnpm typecheck # tsc --noEmit，对着官方发布的类型检查
pnpm lint # oxlint
pnpm test # vitest（jsdom）
pnpm build # tsdown → dist/
pnpm check # 以上四件事
pnpm dev # tsdown --watch
几点约定，改动前值得先读：
@deepseek-ai/dsh-client-ui-workspace、-ui-slots、-ui-session、-ui-sidebar、-ui-layout、-ui-renderer 以及 @deepseek-ai/dsh-api-* 都作为 devDependency 安装，只用于类型与测试；槽位契约（PropsRuntime<'sidebar.workspaces'>）一旦漂移，pnpm typecheck 会先失败，而不是等侧栏崩掉。dist/ 是提交进仓库的。 DSH 默认阻止插件包执行构建脚本（带 prepare 的 git 安装会被直接拒绝，除非在 profile 的 pnpm-workspace.yaml 里单独放行），所以交付物随仓库提供，dist/ 里就是安装后真正加载的东西；CI 会重新构建并比对，防止它和源码脱节。exports["./client"]，期望它调用 window.__ModuleLoader__.load({ id, factory })；tsdown.config.ts 用 banner/footer 把 CJS 分块包进这个工厂，并用短横线外的基线模块（react、react/jsx-runtime、@deepseek-ai/dsh-client-ui-primitives 等）保持外部依赖。clsx、mdast-*、micromark-*、shiki 语法目录），只有外壳里被预置的那份 bundle 能加载它。因此 jsdom 测试通过 tests/stubs/primitives.tsx 替换它，验证的是插件自己的接线；外观本身由外壳负责。dwo- 前缀。>= 0.2.1-rc.2（package.json 的 engines.dsh，安装时会被检查）。