前言¶
在 DeepSeek Harness(DSH)里长期挂着多个工作区时,侧边栏会越来越长。内置的「删除工作区」并不删磁盘上的文件夹和会话,但心智上是「移出列表」——想再看见,得重新添加路径。更麻烦的是:若只把工作区从列表里摘掉,它名下的会话往往会掉进侧边栏的「未分组」,变成一堆无主条目。
下面介绍社区插件 dsh-workspace-hide(维护者 SUZUNAMI,分类:客户端)。它在设置里用开关控制「哪些工作区出现在侧边栏」,隐藏时把相关会话收进归档而不是散进未分组;全程纯本地、可逆,不删除数据。
这是什么¶
dsh-workspace-hide 是 DSH 的客户端插件,当前 npm 版本为 0.2.1(MIT 许可)。一句话定位:在 设置 → 工作区显示 里决定侧边栏显示哪些工作区;被隐藏的工作区沉到列表底部,其会话归档收起,而不是溢出到「未分组」。
插件清单持久化在浏览器 localStorage 的 dsh-workspace-hide.hidden.v2(自 v1 自动迁移)。若本机已安装 @michengai/dsh-archive-manager,插件会走宿主层的真归档与撤销;未安装时退化为纯显示层,不会对会话做真归档(DSH 内核本身没有反向操作,详见仓库 DESIGN.md)。
核心功能¶
侧边栏与归档联动¶
隐藏某个工作区后:
- 侧边栏不再出现该工作区;
- 它名下的会话不会变成「未分组」条目,而是进入归档(在具备 archive-manager 时是真归档);
- 再次显示该工作区时,只有因这次隐藏才被归档的会话会回来;隐藏之前就已经归档的会话,不会被这次隐藏/恢复碰到。
设置页「工作区显示」¶
安装并重启 DSH Desktop 后,设置 左侧会出现 工作区显示(排在「归档会话」之后)。导航栏标签较短,面板内标题为「侧边栏显示的工作区」。
- 每行右侧一个开关:打开 = 在侧边栏显示,关掉 = 隐藏并归档其会话;
- 关掉后该行自动沉到列表底部,并显示「已归档 N 个会话」;
- 顶部统计:「共 N 个 · 显示 N 个 · 隐藏 N 个」;点 全部显示 可一键清空隐藏清单并批量恢复(仅在有隐藏项时可用)。
被隐藏的工作区不会从设置页消失——设置页读的是未过滤列表,否则无法撤销。新装插件时开关默认均为「打开」,所有工作区默认仍在侧边栏,不存在「新工作区默认消失」的情况。
失效项与恢复提示¶
设置页支持 canRestore 类提示、失效项「移除记录」、取消归档失败后的「重试恢复」等(见 0.1.2 起的行为说明)。卸载或清空清单前,README 建议先点一次 全部显示,否则被归档的会话可能仍留在「归档」页。
安装与启用¶
推荐从 npm 安装(只依赖 registry.npmjs.org):
dsh plugin add dsh-workspace-hide@0.2.1
也可从 GitHub 发布 tarball 安装(不经过 git clone):
dsh plugin add https://codeload.github.com/SUZUNAMI/dsh-workspace-hide/tar.gz/refs/tags/v0.2.1
dsh plugin add 会在 profile 目录(~/.dsh/profiles/web)执行依赖安装,并把包名写入 dependencies 与 dsh.profile.bundles。装完后重启 DSH Desktop,再在设置里确认出现「工作区显示」。
手动安装时,在 ~/.dsh/profiles/web/package.json 的 dependencies 与 dsh.profile.bundles 两处加入 dsh-workspace-hide@0.2.1,并在该目录执行 pnpm install。
说明:README 实测 dsh plugin add github:SUZUNAMI/dsh-workspace-hide#v0.2.1 可能被 pnpm 解析为 git+ssh://,未配置 GitHub SSH 的机器容易失败;第三方插件建议钉 tag(如 0.2.1),不要跟随上游 main。
本插件零 npm 依赖、无构建步骤;lib/client.js 由 DSH 运行时注入 react 与 UI primitives,不应把 react 写进 profile 的 dependencies。
典型用法¶
- 执行上述安装命令之一,重启 DSH Desktop;
- 打开 设置,进入 工作区显示;
- 对暂时不用、又不想删数据的工作区,将该行开关关掉——侧边栏隐藏,会话归档,行沉底并显示归档数量;
- 需要时再打开开关,或点 全部显示 批量恢复。
适用场景与注意¶
适合谁: 本地挂了多个实验性或历史工作区、希望侧边栏保持简洁,又需要保留文件夹与会话、且希望隐藏后会话不要堆在「未分组」里的 DSH Desktop 用户。
权限与安全: 插件以当前 DSH 进程/浏览器 profile 的权限运行,读写本机 localStorage 与 DSH 客户端 API。安装前可在 GitHub 仓库 查看源码与 MIT 许可证,自行判断是否纳入 profile。
生态说明: DSH 社区插件目录托管在独立站点(如 SkillHub 目录页),与 DeepSeek / 幻方无官方从属关系;本文安装命令与行为以仓库 README 为准。
结尾¶
dsh-workspace-hide 用「显示/隐藏」替代「删列表项」的心智负担:侧边栏可收束,会话有归档归宿,恢复路径集中在设置里。进一步了解设计与边界见仓库 DESIGN.md。
- 目录页:https://www.skillhub.cn/plugins/SUZUNAMI/dsh-workspace-hide
- GitHub:https://github.com/SUZUNAMI/dsh-workspace-hide