面板折叠 RiddanceY/dsh-panel-collapse

dsh-panel-collapse

一个很小的 DeepSeek Harness 插件。它在侧边栏页脚加一个按钮，紧挨设置控件，用来折叠或展开全局面板列表（插件、定时任务、上下文洞察、记忆……以及任何其他注册了侧边栏面板的插件）。

折叠后，面板行占用的垂直空间被释放出来，工作区和会话列表就能拿到更多空间。状态按浏览器配置档分别记住，重启后依然保留。

icon

安装

dsh plugin --profile <your-profile> add dsh-panel-collapse

装完重启应用——DeepSeek Harness 只在启动时加载新一代客户端模块，不重启就看不到按钮。

从源码安装

git clone https://github.com/RiddanceY/dsh-panel-collapse.git
dsh plugin --profile <your-profile> add "link:/absolute/path/to/dsh-panel-collapse"

link: 让配置档直接指向克隆目录，而不是复制一份，所以 git pull 就能更新，不用重装。

卸载：

dsh plugin --profile <your-profile> remove dsh-panel-collapse

--profile 必须紧跟在 plugin 后面；写成 dsh plugin add x --profile y 会报错 required option '--profile' not specified。

用法

按钮在侧边栏页脚，位于现有图标按钮的右侧。

- 展开（默认）——显示一对「折叠」箭头；点击后隐藏面板列表。
- 折叠——显示一对「展开」箭头；点击后恢复列表。
- 侧边栏收成窄条时，按钮放大到 36×36，与宿主窄条按钮保持一致。
- 当前状态存在 localStorage 的 dsh.panel-collapse.collapsed 下。

工作原理

插件只有客户端 bundle——index.js 是空的宿主部分，所有逻辑都在 client.js 里，应用通过 window.__ModuleLoader__ 懒加载它。

1. apply(ctx) 把 panel-collapse 语言命名空间（zh、en）注册为上下文副作用，插件卸载时字典随之销毁。
2. 它在 sidebar.footer.action 列表槽位注册一项，id: "panel-collapse"、order: 40，排在内置 Cordis 面板按钮之后。
3. 组件用 React.useState 保存一个布尔值，同步写入 localStorage，折叠时渲染一个 元素：

nav:has([data-slot="sidebar.panellist"]),
nav[aria-label="全局面板"],
nav[aria-label="Global panels"] { display: none !important; }

第一个选择器与语言无关：每个面板行都挂着 sidebar.panellist 出口，所以包含它们的 nav 正好就是面板组。另外两个是兜底，靠宿主自己的无障碍名称匹配。

不导入、不修改、不 monkey-patch 任何宿主代码。按钮只复用公开的 --dsw-alias- / --dsw-radius- / --dsw-focus-ring- 主题 token，因此会跟随浅色与深色主题，以及侧边栏的展开/收起状态。

兼容性

| DeepSeek Harness | >=0.2.0-rc.2 |
| 使用的客户端插槽 | sidebar.footer.action（列表） |
| 运行时依赖 | 无（React 从应用的模块表取用） |

开发

包是纯 ESM，没有构建步骤。client.js 就是发布产物。

node --check client.js
node scripts/smoke.mjs # loads the module with a stub loader + React shim
node scripts/verify.mjs # full static verification (manifest, locale, slot, render tree)

scripts/verify.mjs 还会检查安装状态，前提是包已链接进某个配置档（node_modules/<name> + dsh.profile.bundles）；否则跳过这些检查。设置 DSH_PROFILE_DIR 可以让它指向非默认配置档。

这些脚本只做静态检查。它们不能证明按钮在屏幕上显示正常——那仍然需要人看着运行中的应用来判断。

本地迭代

dsh plugin --profile <your-profile> add "link:/absolute/path/to/dsh-panel-collapse"

link: 让配置档指向这个目录，而不是复制一份，所以改完 client.js 后，下次重启应用就会生效，不用重新安装。

已知限制

- 面板组用 CSS 隐藏，所以宿主仍然认为面板已挂载。这是有意为之——这样切换不依赖宿主内部实现，也不用重新加载就能恢复——但这也意味着收起只是视觉上的。
- :has() 选择器需要较新的 Chromium，桌面应用正是基于它构建的。两个 aria-label 回退方案不依赖它。
- 收起会隐藏面板列表的所有*行，包括其他插件添加的行。这正是该功能的意义所在；没有按行过滤。

许可证

MIT