前言¶
在 DeepSeek Harness（DSH）里做多项目或 monorepo 开发时，侧边栏往往平铺多个工作区与会话，切换成本高，也很难一眼看出磁盘上的真实层级。非官方插件的配置、补丁和版本又分散在插件页里，排查问题时常常要在文件与会话之间来回跳。
Workspace Studio（m3159584479/dsh-workspace-studio）是社区维护的客户端类插件，在 DSH 原生工作区能力之上补充真实子工作区、层级导航、折叠/隐藏/专注、健康检查、视图预设，以及面向非官方插件的「插件对话」入口。当前版本为 v1.2.5，要求 DSH >=0.2.1-rc.2，许可证 MIT。本项目为独立社区项目，并非 DeepSeek 官方仓库。
这是什么¶
Workspace Studio 的定位可以概括为：用真实文件夹注册嵌套子工作区，并用同一套侧边栏视图管理显示状态；同时把插件调整问题带进一条带上下文的会话。
维护者为 GitHub 用户 m3159584479。插件通过 Cordis patch 注入客户端 UI（工作区树、插件管理、会话等），Host 侧提供创建、删除、恢复与健康检查的本地路由。安装与运行以当前 DSH 进程权限为准，安装前建议阅读仓库中的 index.js 与许可证。
首次安装：交互式引导¶
第一次加载插件时会启动交互式引导：高亮框指向界面里的真实控件，沿真实路径推进，而不是只显示说明卡片。
- 高亮工作区行，提示点击右侧
…打开菜单。 - 菜单打开后，高亮「新建子工作区」，说明会创建真实文件夹。
- 创建对话框打开后，高亮文件夹名输入框；已有文件夹会被拒绝，子工作区删除不可撤销。
- 高亮侧边栏底部的设置入口。
- 设置打开后，高亮插件。
- 插件页打开后，高亮插件对话标签。
- 高亮插件行上的对话按钮，说明如何用对话调整插件。
第 4–7 步在提示框中显示路径条：设置 › 插件 › 插件对话 › 对话，当前步骤高亮。引导会跟随菜单、对话框和设置页推进，不遮挡要点击的控件；可随时跳过。关闭或跳过后会记住状态，之后可从 Settings → Plugins → 工作区 → 使用教程 重新打开。教程不会修改工作区或插件。升级后若教程未自动出现，多半是浏览器已记录旧版教程；v1.2.2 起使用新的引导记录键，可手动点「使用教程」。
真实嵌套工作区¶
下面介绍子工作区与原生视图如何配合。
- 在任意工作区内可创建真实文件夹，并注册为子工作区。
- 继续使用 DSH 原生的 Workspace Tree 视图，按真实磁盘路径显示层级。
- 「新建子工作区」只创建新目录；已存在的目录不会被自动接管或注册。若要把已有子目录挂进树里，仍可通过 DSH 原生「添加工作区」完成，Workspace Tree 会按路径嵌套显示。
典型步骤：
- 打开工作区行的
…菜单，选择「新建子工作区」，输入目录名并确认。 - 在「视图选项 → 分组 → 按工作区树」查看层级。
折叠、隐藏与专注¶
多项目并行时，侧边栏信息量容易过大。插件提供可持久化的显示状态组合：
- 折叠：收起当前工作区的会话和子工作区，保留工作区行。
- 显示/隐藏子工作区：在菜单的勾选列表中逐个选择要显示的子级（无一键全部显示/隐藏）。
- 隐藏此工作区：将整个工作区移出侧边栏。
- 专注：只显示目标工作区及其父级链、子级链，用于隔离上下文。
隐藏、折叠与专注状态均可持久化。
导航、预设与健康检查¶
快速切换：Ctrl+Shift+K 可搜索工作区、路径和会话。
视图预设：保存隐藏/折叠组合，在「前端开发」「写作」等工作模式之间切换。
工作区健康检查：检查路径不存在、重复注册、非目录、符号链接、空工作区和嵌套过深等问题。
最近移除 / 恢复：记录被移除的工作区注册；恢复父级后，子工作区按路径重新嵌套（从本版本起记录，更早删除的注册可能没有历史）。
隐藏项管理：在 Settings → Plugins → 工作区 集中查看所有显式隐藏的工作区，包括嵌套在子工作区中的条目。
对话式插件调整¶
DSH 插件常由配置、源码和补丁组合而成；在插件页里核对包名、版本和 bundle 并不直观。Workspace Studio 在 Settings → Plugins 中提供「插件对话」：
- 选择要调整的非官方插件，或该插件下的某一行。
- 可填写本次调整说明。
- 点击「对话」。
插件会新建或复用一条带上下文的会话，内容包括插件包名与安装/启用状态、对应 bundle 或 plugin row 身份、可选调整说明、来源与版本及修改前核对步骤、会话标记等。已有对话会直接复用；按住 Shift 点击「对话」可强制新建。
该功能的定位是把插件问题带进一条有上下文的修复/调整会话，不会在后台自动改代码或安装插件；实际改动仍由会话中的 Agent 与你确认。
子工作区文件夹删除¶
仅子工作区提供「删除工作区文件夹」操作：删除前需二次确认；会拒绝删除包含其他注册工作区、符号链接或非目录的路径。顶层工作区仍遵循 DSH 原生「删除工作区」：只移除注册，不删除文件。真实删除不可撤销。
安装与启用¶
从 GitHub 安装（desktop profile）：
dsh plugin --profile desktop add github:m3159584479/dsh-workspace-studio
环境要求（摘自 README）：
- DeepSeek Harness
>=0.2.1-rc.2 - 工作区目录对 Harness 进程可写
- 仅支持本地文件系统；远程/SSH 路径暂不支持
插件以当前 DSH 进程权限运行；Host 侧创建、删除、恢复和健康检查为本地 HTTP 路由并校验本地请求头。社区插件未经 DeepSeek 官方审核，安装前请自行阅读源码与 MIT 许可证。
典型用法速览¶
经过上面的安装步骤后，可按 README 建议串联使用：
- 用
…→「新建子工作区」建立真实嵌套目录。 - 「视图选项 → 分组 → 按工作区树」查看层级。
- 用「专注」隔离一个分支，用「折叠」收起会话与子级。
Ctrl+Shift+K跳转工作区或会话。- Settings → Plugins → 工作区：管理隐藏项、恢复误删、健康检查、保存视图预设。
- Settings → Plugins → 插件对话：为非官方插件打开调整会话。
适用场景与注意¶
适合：本地多仓库/monorepo、需要在 DSH 侧边栏按磁盘层级组织工作区，并希望通过预设与健康检查维持工作区注册一致性的用户；需要以会话方式梳理非官方插件问题时，可使用插件对话入口。
注意：
- 不接管普通目录；移除历史有版本范围限制。
- 子工作区文件夹删除为真实删除，务必确认路径与二次提示。
- 社区目录与 GitHub 仓库均独立于 DeepSeek / 幻方，不属于官方应用商店。
链接¶
- 社区目录页：https://www.skillhub.cn/plugins/m3159584479/dsh-workspace-studio
- 源码与文档：https://github.com/m3159584479/dsh-workspace-studio
Workspace Studio 把「真实目录 + 工作区树 + 显示状态」和「插件对话」放在同一套客户端体验里，适合在 DSH 桌面端长期并行多个项目时使用。
