前言¶
在 DeepSeek Harness(DSH)的 Web 界面里,左侧侧边栏通常同时承载「功能区」(插件、自动化、技能中心等入口)和「工作区」(搜索、项目、会话列表)。入口和列表变长之后,主内容区容易被挤窄;若只想多看一眼对话或编辑区,又未必需要一直展开整块侧边栏。
DSH 生态里不少能力以客户端插件形式挂在 Web 配置上。下面介绍由 Alice-Marx 维护的 dsh-folding-Windows(npm 包名 @ljwei-stak/dsh-folding-windows):在官方侧边栏上增加折叠控制,让功能区与工作区分别展开或收起,并在浏览器里记住各自状态;工作区项目还可置顶,顺序通过 DSH 原生能力持久化。
这是什么¶
dsh-folding-Windows 归类为 DSH 的「用户界面与体验(UI/UX)」类客户端插件,目标平台为 Web(package.json 中 dsh.client.platform 为 web)。它不新增独立配置文件或环境变量,通过插件入口 apply(ctx) 在 DSH 客户端生命周期里挂载增强逻辑。
插件读取并调整 DSH Web 侧边栏 DOM,添加折叠按钮与样式;折叠状态与置顶偏好写在当前浏览器配置的 localStorage 中。项目顺序则通过 DSH 注入的 workspaces 服务调用原生排序保存。此版本不发起网络请求,也不访问文件系统、命令行或凭据。
维护者与源码仓库:Alice-Marx/dsh-folding-Windows。社区目录页:SkillHub - dsh-folding-Windows。许可证为 MIT;当前资料中的版本为 0.3.1。
核心功能¶
功能区与工作区分别折叠¶
安装后侧边栏会出现两个控制:
- 功能区按钮:展开或收起插件、自动化任务、任务看板、技能中心、模型路由、SSH、MV 放映室等入口。
- 工作区按钮:展开或收起整个工作区区域(含搜索、项目、会话列表)。
首次使用时,功能区默认收起,工作区默认展开;两个区域的状态分开保存,刷新页面后仍保留。新增或卸载其他插件时,功能入口数量会随之更新,折叠逻辑会适配动态变化。
收起后,对应入口不会进入 Tab 聚焦顺序;支持 Tab 聚焦按钮后用 Enter 或空格操作。若把整个 DSH 侧边栏收起,功能区开关会隐藏;再次打开侧边栏时恢复原先折叠状态。界面支持中文、英文及 DSH 深浅色主题。
工作区项目置顶¶
在「按工作区」或「按工作区树」视图中,鼠标移到项目行可点击图钉置顶,再次点击取消。也可用 Tab 聚焦图钉后按 Enter 或空格。
多个置顶项按「最近置顶在前」排列,刷新后保留;重命名不影响置顶记录。项目与其所属会话一起参与排序;树形视图在同级项目中优先显示置顶项。取消置顶后恢复插件记录的普通顺序。置顶偏好与两个区域的折叠状态分别保存在浏览器中;项目顺序由 DSH 持久化。纯会话视图没有项目行,需切回工作区视图才能使用图钉。
停用或卸载插件并刷新后,功能入口与工作区区域恢复默认展示;当前项目顺序仍保留在 DSH 中。若 localStorage 不可用,仍可折叠,但刷新后会回到各区域默认状态。
安装与启用¶
需要已安装可运行的 DSH CLI 和 pnpm。插件声明的 DSH 最低版本为 >=0.2.0-rc.2;Node.js 需满足 ^22.19.0 || >=24.0.0(与 package.json 的 engines.node 一致)。
下面命令将插件安装到名为 web 的 DSH Web 配置(若你使用其他配置名,把 web 换成对应名称):
dsh plugin --profile web add @ljwei-stak/dsh-folding-windows
dsh --profile web
若希望从 GitHub 源码安装,可使用:
dsh plugin --profile web add github:Alice-Marx/dsh-folding-Windows
dsh --profile web
重新启动该 DSH Web 配置后插件生效。更新或卸载示例:
dsh plugin --profile web update @ljwei-stak/dsh-folding-windows
dsh plugin --profile web remove @ljwei-stak/dsh-folding-windows
安装后由 DSH 更新该配置的依赖清单与 Bundle 列表;Bundle 通过仓库中的 cordis.patch.yml 将客户端模块并入配置。无需额外配置文件或 API 密钥。清除浏览器对该站点的数据会重置折叠与置顶偏好。
典型用法¶
经过上面的安装并启动 dsh --profile web 后,在 Web 界面左侧即可操作:
- 点击 功能区 旁的折叠控制,在「只看主区」与「需要进插件/技能入口」之间切换。
- 点击 工作区 旁的折叠控制,在「隐藏项目与会话列表」与「照常浏览工作区」之间切换。
- 在工作区相关视图中,对常用项目点图钉置顶,减少在长列表里滚动查找。
README 中记载的实测环境包括 DSH Web 0.2.1-rc.2;对 0.2.0-rc.2 与 0.2.1-rc.2 的侧边栏结构也有浏览器夹具验证。插件依赖 DSH Web 侧边栏的语义标签与 DOM 结构(如「全局面板 / Global panels」「新建会话 / New session」等);若上游调整结构,可能需要等待插件适配更新。
适用场景与注意¶
适合谁: 长期在 Windows 或任意部署上使用 DSH Web 界面、侧边栏入口和工作区列表较长、希望主编辑区更宽或按习惯分别收起两块区域的开发者。不适用于没有 Web 客户端的 headless 或 TUI 配置。
权限与数据: 插件在 DSH Web 客户端进程/页面上下文中运行,会操作侧边栏 DOM 并读写本机浏览器 localStorage,通过 workspaces 服务调整项目顺序。安装前建议阅读仓库源码与 MIT 许可证,确认符合你的环境策略。卸载并刷新后,插件会移除自身样式与按钮。
DSH 社区插件目录(如 SkillHub、dsh-plugin.org 收录页)由社区维护,与 DeepSeek / 幻方无官方从属关系;「一切皆插件」是 DSH 的产品思路,本文介绍的是其中一款 UI 增强插件。
链接与参考¶
- 社区目录:https://www.skillhub.cn/plugins/Alice-Marx/dsh-folding-Windows
- 源码与说明:https://github.com/Alice-Marx/dsh-folding-Windows
- dsh-plugin.org 收录:https://dsh-plugin.org/plugins/alice-marx/dsh-folding-windows
若你已在用 DSH Web 且侧边栏信息密度偏高,可先按官方命令安装 @ljwei-stak/dsh-folding-windows,用功能区与工作区的独立折叠和项目置顶,把注意力留给当前会话与主工作区。