前言¶
DeepSeek Harness(DSH)左侧边栏会列出多个全局面板:插件、定时任务、上下文、市场等,每个面板占一行。面板多了之后,侧边栏纵向空间被占满,和「新会话」等固定入口挤在一起,浏览和切换都不够紧凑。
社区插件 dsh-sidebar-panel-fold(维护者 ACGsu,分类:客户端)不改官方包,只在现有面板上增加「收起 / 展开」和浮层切换,默认展开时与原生一致。下面介绍它做什么、怎么装、怎么用,以及安装前需要知道的限制。
这是什么¶
dsh-sidebar-panel-fold 是一个标准 DSH bundle 包,声明了 dsh.bundle.patch,装进 profile 后会自动加入 dsh.profile.bundles,无需手工改配置。
一句话:把 DeepSeek Harness 侧边栏的全局面板列表收进一行;收起后点击该行弹出浮层,可切换面板。当前版本 0.1.0,许可证 MIT。GitHub 星标为 0(以目录页为准)。
Host 侧用 @deepseek-ai/schemastery 做配置 schema(peer,optional);客户端运行时无第三方依赖,不修改 app.asar 或任何官方内置文件。
核心功能¶
展开与收起¶
- 安装后,全局面板列表上方多出一行「收起面板」。
- 点击后,整列面板收纳成一行摘要:图标对应当前激活面板,文字为当前面板名。
- 再次展开可在浮层底部选「展开面板」,或按 README 中「使用」表在展开状态下再点「收起面板」那一行。
收起状态下切换面板¶
点击摘要行弹出浮层,列出全部面板;当前项带标记。点某一项即切换到该面板,浮层关闭,侧边栏仍保持收起。
状态与主题¶
- 状态跨重启保留:通过 DSH Host 侧设置通道持久化
folded,换端口、换端不丢(需正确安装方式,见下文)。 - 窄轨模式:侧边栏整栏收起只剩图标时,本插件一行也只显示图标,浮层仍可用。
- 样式:使用 DSH 设计令牌(如
--dsw-alias-label-primary),适配深浅色主题。
兼容性(资料原文)¶
| 项目 | 说明 |
|---|---|
| DSH 版本 | engines.dsh: ">=0.2.0-rc.2" |
| 验证环境 | DSH 0.2.1-rc.2,Desktop(Windows 11)/ Web |
| 平台 | Web 与 Desktop 共用 dsh.client.platform = "web" |
安装与启用¶
本插件以 bundle patch 在启动时组合进 profile,安装后需要完整退出并重启 DeepSeek Harness(不是仅刷新页面)。
Web profile 从 GitHub 安装:
dsh plugin --profile web add github:ACGsu/dsh-sidebar-panel-fold
桌面端默认 profile,从本地目录安装时 README 推荐使用 file:,不要用 link::
dsh plugin --profile desktop add "file:/path/dsh-sidebar-panel-fold"
也可在「插件」面板选择「从本地路径安装」,指向插件目录;管理器会校验 dsh.bundle 后 reconcile 进 bundles。
装成功后,控制台应出现:
[dsh-sidebar-panel-fold] client loaded v0.1.0
若出现 schemastery is not resolvable 警告,多为使用了 link: 安装;插件仍可运行,但收起状态可能无法跨重启保留,应改用 file: 重装。
安全说明:插件在当前 DSH 进程权限下运行,会向页面注入样式与 DOM。安装前建议在 GitHub 查看源码与 MIT 许可证,自行判断是否信任维护者 ACGsu。
典型用法¶
| 场景 | 操作 |
|---|---|
| 收起面板列表 | 点击「收起面板」这一行 |
| 展开回原样 | 展开状态下再点这一行(显示「收起面板」) |
| 收起状态下切换面板 | 点击摘要行 → 在浮层里选面板 |
| 关闭浮层 | 点击浮层外部、按 Esc、或滚动页面 |
「新会话」等独立按钮不属于全局面板列表,不受本插件收纳逻辑影响。
适用场景与注意¶
适合谁:经常在 DSH Web 或 Desktop 间切换、侧边栏面板较多、希望省出纵向空间的用户。
工作原理概要(便于评估风险):客户端在 [data-slot="sidebar.panellist"] 对应 nav 的前方插入控制行,收起时给 nav 加类 dsh-spf-folded 隐藏子节点;浮层菜单通过触发原有面板按钮的点击交给 DSH 自带逻辑,不绕过官方 selectPanel。
已知限制(README 原文):
- 走 DOM 注入,非官方「包裹整个 nav」的插槽;若上游改掉
nav或[data-slot]锚点,需改src/client.js中的常量。 - 浮层为自绘,未复用 DSH 未对外暴露的 Tooltip 等原语。
- 收起后不能用 Tab 在隐藏列表上遍历面板,需先打开浮层。
- Windows 标题栏窄轨下官方会隐藏面板列表时,本插件一行也会一并隐藏。
卸载:
dsh plugin --profile desktop remove dsh-sidebar-panel-fold
完整重启后,清理函数会移除注入的样式、按钮与监听器。
结尾¶
dsh-sidebar-panel-fold 用一行摘要加浮层,在不动官方包的前提下压缩侧边栏全局面板列表,并尽量把收起状态记在 Host 设置里。需要细节、问题排查与开发说明时,以仓库 README 为准。
- 社区目录页:https://www.skillhub.cn/plugins/ACGsu/dsh-sidebar-panel-fold
- GitHub:https://github.com/ACGsu/dsh-sidebar-panel-fold