dsh-sidebar-fold
把 DSH 侧边栏里那一长串全局面板行（插件、终端、容器、记忆、今日值得读……）折叠成单独一行「插件大全」，把被挤掉的工作区高度还给会话列表。
纯客户端插件：零依赖、零构建链，安装即用。
效果
折叠前，侧边栏上半部分被 11 个面板行占满（本机实测）：
泡泡猫的影视工具 / 今日值得读 / 全局搜索 / 终端 / 容器 / 插件 / 插件市场
自动化任务 / 上下文洞察 / 论衡运行 / 记忆 ← 工作区被压成一条缝
────────────────────────────────
工作区（会话列表）
折叠后只剩一行，点它打开「插件大全」面板：
📁 插件大全 ← 一行
────────────────────────────────
工作区（会话列表） ← 高度回来了
面板里列出全部面板项（带各自的图标），点任意一项直接跳过去；也提供一个开关，可以随时把侧边栏临时展开回全貌。原来插件的功能一个都没丢，只是换了个入口。
安装
前置：已安装 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 宿主源码，全部走官方插件契约：
- 注册一对席位 ——
sidebar.panellist（侧边栏那一行，order: -1000 排在最前）+ main key dsh-sidebar-fold（「插件大全」面板本体）。
- 折叠靠 DOM，不靠 slot 注册表 —— 给自己那一行渲染一个带唯一类名
dsh-fold-glyph 的图标，从它出发 closest('nav') 找到侧边栏那个 nav，把其余行收起来。
- 两类行一起收 —— DSH 侧边栏其实有两种面板行：一种走
sidebar.panellist 渲染成 nav 里的 <button>；另一种是插件绕过 slot、自己造一个元素插进侧边栏容器（泡泡猫的影视工具、今日值得读、全局搜索、终端、容器都是这一种）。后者用一个特征识别：元素 dataset 里有 /^dsh.*Entry$/ 形状的键（dsh-tty-entry、dsh-docker-entry、dshRssEntry……）。按特征而不是按插件名写死，将来新插件照同样约定插进来也能自动收进来。
- 面板内容也读 DOM —— 直接读侧边栏实时渲染出的行（含图标与标签），不读
slots.entriesOfSlot() 快照：后者取的是注册那一刻的列表，晚到几百毫秒的插件会被漏掉。点击时直接 .click() 真实按钮，所以第三方那种自带弹层的入口也能正常打开。
- 不靠任何脆弱的定位 —— 不用 CSS Modules 的编译期哈希类名（重构即废），也不用
aria-label（会随界面语言变）。唯一锚点是自己的类名和 data-* 约定。
- 折叠用属性 +
!important 样式 —— 写成 data-dsh-fold-hidden 属性，而不是 inline display:none：终端/容器/今日值得读这些插件各自都有 MutationObserver 盯自己那一行的 style，直接改 display 会把它们反复唤醒、来回打架。
- 持续自适应 ——
MutationObserver 监听 document.body（子节点 + style/aria-label），面板行增删、React 重渲染、界面语言切换都会重新应用折叠；用 requestAnimationFrame 合并高频回调，写入前比对当前值避免自激。
- 状态可持久 —— 展开/折叠存
localStorage，重启不丢。
- 退场干净 —— 插件被卸载/禁用时恢复所有被隐藏的行、注销两个席位、若主区正停在自己的面板上先
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
