前言¶
在 DeepSeek Harness(DSH)Web 或桌面端里,自带的工作区浏览器通常是扁平或有限层级的列表。当你需要把一个大项目按子目录拆成多个工作区,又希望在同一棵树里直接新建会话、并把常用会话钉在所属文件夹最前面时,原生侧边栏往往不够用。维护者 CIBUDAYI3906 发布的客户端插件 dsh-workspace-nest(当前版本 0.1.0,MIT 许可证)专门替换侧边栏「工作区」区域:用多级树展示父工作区与子工作区,并在 DSH 0.2.x 上支持会话置顶。本文依据仓库 README 与 package.json 说明定位、安装与用法;社区目录见 SkillHub 插件页,源码见 GitHub。
这是什么¶
dsh-workspace-nest 属于 DSH 插件生态中的客户端类扩展:通过 Cordis patch 注入 Web 客户端,在侧边栏用自定义树组件替代自带工作区浏览器。层级由磁盘上的目录祖先关系推导,子工作区仍是普通 DSH 工作区;停用插件后,自带浏览器会立即恢复,已建子目录不会消失。
核心功能¶
下面几项均来自官方 README,无额外推断。
多级子工作区¶
在任意工作区行悬停菜单中选择「新增子工作区」,会在该工作区目录下创建子文件夹并注册为工作区。想展开几层完全取决于你的目录结构。
每一级都能建会话¶
父行既可以挂会话,也可以挂下级文件夹。行菜单中的「新建会话」会把会话建在当前这一级,而不是被迫退回到根级列表。
会话置顶¶
会话行菜单中的「置顶」将该会话排到所属最近一级文件夹的会话列表最前面,行尾显示图钉标记。置顶集合由 DSH Host 持久化,刷新或重启后不丢。该能力依赖 DSH 0.2 的 Host 接口;更旧的客户端上置顶入口不会出现,而不是点击后报错。
与自带浏览器一致的行操作¶
重命名、删除、归档、分叉、会话搜索等仍走真实服务,行为与停用插件前的自带工作区浏览器一致。
Host 半边:补全「建目录」¶
浏览器侧的组合目录选择器在许多部署(例如部分 macOS 原生选择器)只有 pick、没有 createDirectory,仅客户端无法可靠完成「新增子工作区」。插件因此带有 Host 半边:提供一条本地 JSON POST 路由,路由名必须是单个路径段,落点必须在父工作区目录内;创建目录后写入空的 .dsh-workspace-nest 标记文件。若 Host 路由不可达,客户端会退回浏览器侧的 createDirectory。
兼容性与构建¶
package.json 声明 engines.dsh 为 >=0.2.0-rc.1 <0.3.0,node 为 >=20。客户端 bundle 通过 build.mjs 中的 requireAny / pickIcon 兼容两代符号命名(图标与 store 包名)。
安装与启用¶
官方安装命令如下(须使用 web profile):
dsh plugin --profile web add dsh-workspace-nest
安装后重启 dsh web。侧边栏工作区区域会由本插件渲染;若不想使用,停用或卸载该插件即可,自带工作区浏览器会立刻回来。
卸载命令:
dsh plugin --profile web remove dsh-workspace-nest
卸载后已创建的子工作区目录与普通工作区一样,仍会出现在自带浏览器中。
典型用法¶
按 README 描述,日常操作都集中在侧边栏树与行菜单上,无需单独配置文件。
- 在目标父工作区行打开悬停菜单,点「新增子工作区」,输入单段文件夹名,确认后在树中展开新子级。
- 在任意一级行菜单点「新建会话」,在该级目录下开始对话。
- 对需要常开的会话使用行菜单「置顶」,在同文件夹的会话列表顶部查看图钉标记。
- 需要整理时照常使用重命名、归档、分叉等菜单项。
界面示意见仓库 screenshot-1-tree。
适用场景与注意¶
适合谁: 在 DSH 0.2.x Web 或桌面端上,用目录层级组织多个相关项目或子模块,并希望在同一侧边栏树里管理会话与置顶的智能体开发者。
数据与隐私(README 原文要点): Host 仅在父工作区目录内创建子目录并写空标记文件,不删除目录;无遥测、无外部网络请求;置顶状态由 DSH workspace 注册表保存,插件不另存副本。
安全与权限: 插件以当前 dsh 进程的权限运行,Host 路由会在你的工作区路径下创建文件夹。安装前建议阅读 源码仓库 与 MIT 许可证,确认与部署环境匹配。
生态说明: DSH 奉行「一切皆插件」;SkillHub 等社区目录为独立站点,与 DeepSeek / 幻方无官方从属关系,本文不把该插件描述为官方应用商店内置能力。
结尾¶
dsh-workspace-nest 把侧边栏工作区收成一棵可嵌套的树,并用 Host 补齐子目录创建,在 0.2.x 上顺带提供文件夹级会话置顶。若你的痛点是扁平工作区列表不够用,可按上文命令安装并重启 dsh web 试用。