侧栏折叠 moophone/dsh-sidebar-fold

dsh-sidebar-fold

把 DSH 侧边栏里那一长串全局面板行（插件、终端、容器、记忆、今日值得读……）折叠成单独一行「插件大全」，把被挤掉的工作区高度还给会话列表。

纯客户端插件：零依赖、零构建链，安装即用。

效果

折叠前，侧边栏上半部分被 11 个面板行占满（本机实测）：

泡泡猫的影视工具 / 今日值得读 / 全局搜索 / 终端 / 容器 / 插件 / 插件市场自动化任务 / 上下文洞察 / 论衡运行 / 记忆 ← 工作区被压成一条缝 ──────────────────────────────── 工作区（会话列表）

折叠后只剩一行，点它打开「插件大全」面板：

📁 插件大全 ← 一行 ──────────────────────────────── 工作区（会话列表） ← 高度回来了

面板里列出全部面板项（带各自的图标），点任意一项直接跳过去；也提供一个开关，可以随时把侧边栏临时展开回全貌。原来插件的功能一个都没丢，只是换了个入口。

| 侧边栏：11 行收成 1 行 | 面板：点进去直接跳 |
| 折叠后的侧边栏 | 插件大全面板 |

安装

前置：已安装 dsh CLI。

dsh plugin --profile <name> add dsh-sidebar-fold

其他形式：

GitHub 源码安装（会自动跑 prepare；本包无需构建，pnpm 不会要求授权）
dsh plugin --profile <name> add github:moophone/dsh-sidebar-fold

本地开发
dsh plugin --profile <name> add link:/abs/path/to/dsh-sidebar-fold

预打包 tarball（无需任何构建授权）
dsh plugin --profile <name> add ./dsh-sidebar-fold-0.4.0.tgz

dsh plugin add 会自动完成三处登记，不需要手改任何 profile 文件：

| 位置 | 内容 |
| <profile>/package.json → dependencies | "dsh-sidebar-fold": "..." |
| <profile>/package.json → dsh.profile.bundles | 追加 "dsh-sidebar-fold" |
| <profile>/cordis.patch.yml | 本包的 insert 层 |

卸载：

dsh plugin --profile <name> remove dsh-sidebar-fold

重要：客户端 bundle 在 DSH 启动时加载，改完插件或装完插件后必须完整重启 DSH，只刷新浏览器页面不生效。

它是怎么做到的

不改 DSH 宿主源码，全部走官方插件契约：

1. 注册一对席位 —— sidebar.panellist（侧边栏那一行，order: -1000 排在最前）+ main key dsh-sidebar-fold（「插件大全」面板本体）。
2. 折叠靠 DOM，不靠 slot 注册表 —— 给自己那一行渲染一个图标，带唯一类名 dsh-fold-glyph，从它出发 closest('nav') 找到侧边栏那个 nav，把其余行收起来。
3. 两类行一起收 —— DSH 侧边栏其实有两种面板行：一种走 sidebar.panellist 渲染成 nav 里的 ；另一种是插件绕过 slot、自己造一个元素插进侧边栏容器（泡泡猫的影视工具、今日值得读、全局搜索、终端、容器都是这一种）。后者用一个特征识别：元素 dataset 里有 /^dsh.Entry$/ 形状的键（dsh-tty-entry、dsh-docker-entry、dshRssEntry……）。按特征识别，而不是按插件名写死，将来新插件照同样约定插进来也能自动收进来。
4. 面板内容也读 DOM —— 直接读侧边栏实时渲染出的行（含图标与标签），不读 slots.entriesOfSlot() 快照：后者取的是注册那一刻的列表，晚到几百毫秒的插件会被漏掉。点击时直接 .click() 真实按钮，所以第三方那种自带弹层的入口也能正常打开。
5. 不靠任何脆弱的定位 —— 不用 CSS Modules 的编译期哈希类名（重构即废），也不用 aria-label（会随界面语言变）。唯一锚点是自己的类名和 data- 约定。
6. 折叠用属性 + !important 样式 —— 写成 data-dsh-fold-hidden 属性，而不是 inline display:none：终端/容器/今日值得读这些插件各自都有 MutationObserver 盯自己那一行的 style，直接改 display 会把它们反复唤醒、来回打架。
7. 持续自适应 —— MutationObserver 监听 document.body（子节点 + style/aria-label），面板行增删、React 重渲染、界面语言切换都会重新应用折叠；用 requestAnimationFrame 合并高频回调，写入前比对当前值避免自激。
8. 状态可持久 —— 展开/折叠存 localStorage，重启不丢。
9. 退场干净 —— 插件被卸载/禁用时恢复所有被隐藏的行、注销两个席位、若主区正停在自己的面板上先 selectPanel(null) 切走，不会留一块空白。

兼容性

- 纯客户端（dsh.client.platform: 'web'），Host 侧只有一个空 apply 占位（cordis 要求 exports["."] 指向真实文件）。
- 只 require('react') 且只用 createElement（不依赖 jsx-runtime），ES5 风格源码，浏览器直接执行。
- 不读取、不上传任何数据；除 localStorage 里那一个开关状态外不写任何持久化。

排障

装上重启后没反应，先看浏览器控制台：失效安全（v0.4.0 起）：折叠前会先确认能认出「插件大全」自己那一行；认不出就一行都不隐藏并放弃折叠。宁可没效果，也绝不把侧边栏清空。

插件还会把运行状态写进 localStorage 的 dsh-sidebar-fold:diag 键（一段 JSON），不开控制台也能事后取证：

{"v":"0.4.0","expanded":false,"navRows":7,"injectedRows":5,"rootFound":true,
"rows":["泡泡猫的影视工具","今日值得读","全局搜索","终端","容器","插件大全","插件"]}

rows 里带 的是它自己那一行，navRows + injectedRows 应等于 rows.length。这个键根本不存在 = 插件没被加载，问题在安装/捆绑层，不在折叠逻辑。

- 启动约 4 秒后会打印一行自检日志：[dsh-sidebar-fold] active: expanded=false navRows=7 injectedRows=5 rootFound=true。navRows 是走 slot 的行数，injectedRows 是插件直接插进侧边栏的行数，rootFound 表示有没有找到侧边栏内部容器。哪个数字是 0，问题就出在哪一层。
- 看到 [dsh-sidebar-fold] host has no slots service — panel folding disabled：宿主没提供 slots 服务（DSH 版本过旧），插件已主动放弃而不是静默失效。
- 什么都没有：确认改的是 dsh 正在跑的那个 profile（dsh --profile <name>），以及确实重启过 GUI。
- 只折了一部分：说明有插件换了插入手法（不再用 data-dsh--entry 约定）。把那个元素的外层 HTML（document.querySelector('[data-pane="sidebar"]').innerHTML 里带 Entry 的那几行）发 issue。

开发

node --check host/index.js
node --check client/client.js

改 client/client.js 后必须重启 DSH 才会重新加载。

更新记录

- 0.4.0 — 失效安全：认不出自己那一行就一行都不折叠；运行状态写入 localStorage['dsh-sidebar-fold:diag']，便于事后取证。
- 0.3.0 — 折叠插件绕过 slot 直接注入的侧边栏行（影视工具、今日值得读、全局搜索、终端、容器），按 data-Entry 特征识别；隐藏改用属性 + !important，避免与那些插件自带的 MutationObserver 互相打架。
- 0.2.0 — 改为直接读侧边栏实时 DOM，面板列表不再漏掉后注册的插件；点击走真实按钮。
- 0.1.0 — 首版。

License

MIT