侧栏折叠 drscrewdriver/dsh-sidebar-fold

dsh-sidebar-fold

把 DSH 左侧栏的「加项入口」收进宿主的 「更多」行。

左侧栏的「全局面板」列表会随安装变长：自动化任务、agent 团队、插件市场、上下文页……
本插件在宿主「更多」行右端挂一个 28×28 的方形箭头按钮。点一下把这些加项行整体收纳，只剩「更多」一行；箭头由 ▲（可收起）翻成 ▼（可展开），再点复原。

- 非侵入 —— 纯 client 插件，只新增 DOM。不打宿主补丁、不碰 app.asar；卸载后侧边栏与原版逐行一致（自持的 标签与 data-dshsf-* 标记一并清除）。
- 结构化定位头行 —— 头行 = 「全局面板」nav 内带 aria-haspopup="menu" 的 panelRow。
不依赖任何文案，也不依赖插件注册顺序。
- 状态按窗口持久化 —— 折叠/展开记录在 localStorage，刷新后保持。
- 对齐可切换 —— 被管理的入口行（含「更多」行）的文字与图标可整体左对齐 / 居中 / 右对齐；右对齐时折叠钮自动镜像到行左端，不压文字。覆盖层只用宿主的 justify-content 长属性，不动行的 display/gap/高度。
- 可配置 —— 默认态、保持可见的行、行对齐都在插件设置卡里改（宿主 Config + .volatile()，保存即生效，不用重启）。
- 窄栏友好 —— 侧边栏收成 36px 图标栏时自动摘掉按钮并显示全部行：不挤压、不留半隐藏态。
- 静默降级 —— 宿主 DOM 漂移导致锚点找不到时，插件不注入、不改坏侧边栏；控制台会出现 dsh-sidebar-fold: fold installed { mounted: false } 告知未挂载。

截图

展开态（各行居中）—— 折叠钮挂在「更多」行，加项行正常列出：

展开且居中

折叠态 —— 只剩「插件」行与「更多」行：

折叠

安装

npm 通道（发版后）
dsh plugin --profile <profile> add dsh-sidebar-fold

本地构建
npm run build && npm run verify
npm pack --pack-destination .
dsh plugin --profile <profile> add ./dsh-sidebar-fold-0.1.2.tgz

装完把 dsh-sidebar-fold 补进 profile 的 dsh.profile.bundles（或在应用内启用该 bundle）再重启。desktop profile 必须先关停 Electron 应用再改它的 package.json——运行中的桌面端会按自身内存态重写该文件并回滚外部修改。

设置

打开 插件 → dsh-sidebar-fold（配置卡注册在 plugins.bundle.config 席位， key 为包名）：

| 字段 | 含义 | 默认 |
| 默认折叠 | 窗口在没有本地记录时采用的初始状态 | 关 |
| 文字与图标对齐 | 三档分段控件（左 / 居中 / 右）；作用于被折叠管理的入口行，「更多」行跟随同一档 | 左 |
| 保持可见的入口 | 按当前侧边栏实时读出的行逐个开关；打开的行在折叠时保留可见 | 仅 插件 / Plugins |

行清单在打开卡片时从 DOM 读取，所以之后新装的入口会自动出现在列表里；如果全部都打开了，折叠钮会自动置灰并报 aria-disabled="true"，不会出现“箭头动了但什么都没变”。

开发

npm run build # scripts/build-client.mjs -> lib/client.js（模块加载器 bundle）
npm run verify # 门禁：loader id === 包名、双清单同串、无模块请求、
不引宿主 primitives、9 语词典、无机器绝对路径
npm test # node --test，覆盖纯逻辑面（头行/分组划分、nav 回退链）
npm run hosts:check # 与 scripts/hosts.mjs 的枚举漂移检查（--write 修复）

prepack 会串起 build + verify，过期的 lib/client.js 发不出去。

支持宿主

仅 DSH 0.2.1-rc.3。 唯一事实源 scripts/hosts.mjs（三处声明 —— engines.dsh、 peerDependencies、dsh.plugin.json —— 都由它生成，禁止手改）。

为什么不放宽：挂载同时需要侧边栏的面板列表与宿主「更多」行。逐版本实测所有已发布的 dsh-client-ui-sidebar rc：

| 宿主线 | 面板列表 | 「更多」行 |
| 0.1.0-rc.8 / 0.1.1-rc.2 / 0.1.2-rc.1 | 无 | 无 |
| 0.1.5-rc.3 / 0.1.7-rc.2 / 0.2.0-rc.2 | 有 | 无 |
| 0.2.1-rc.1 / 0.2.1-rc.2 | 有 | 无 |
| 0.2.1-rc.3 | 有 | 有 |

没有「更多」行的宿主上，插件按设计静默降级——不注入、不改坏侧边栏；声明这类宿主只会让用户装上一个什么都不做的插件。

宿主换代后先跑浏览器冒烟再扩表：CSS-module hash 每次构建都漂移（rc.2 是 wtg9ga_，rc.3 是 hHd-Xa_），只有片段选择器（_panelList、_panelRow、 _moreAnchor、_collapsed）是稳的。

升级护栏

宿主 CSS-module hash 每次构建都会漂移（rc.2 是 wtg9ga_，rc.3 运行时是 hHd-Xa_），所以所有选择器只匹配片段（_panelList、_panelRow、_moreAnchor、_collapsed）。
宿主换代后必须重跑浏览器冒烟再认定折叠仍在挂载：插件按设计静默降级，回归表现为 “什么都没发生”，不是报错。

目录

src/index.js 宿主半：Config schema + 空 apply（无需构建） src/client/constants.ts 实测锚点、属性标记、注入的样式表 src/client/locales.ts 9 部运行时词典（zh 键集为真理源） src/client/fold.ts nav 定位、头行/分组划分、按钮挂载、折叠状态 src/client/settings-card.ts bundle 详情页配置卡（纯 DOM） src/client/index.ts apply：先装折叠，再各自带守卫地接设置腰 scripts/ build-client / verify / sync-hosts / hosts / gen-locale-meta

许可

MIT