侧栏面板按钮 ruanimal/dsh-sidebar-panel-buttons

dsh-sidebar-panel-buttons

把 dsh Web 侧边栏顶部的全局面板菜单（插件 / 扩展管理 / 定时任务 / IM …）从「竖向文字列表」收起为一排横向图标按钮；要不要收起，是设置 → 通用里的一个选项，侧边栏本身不再多出任何按钮。

| 之前：竖排文字列表 | 之后（默认）：一行图标按钮 |

设置 → 通用（本插件的行排在「字号」之后）：

┌──────────────────────────────────────────────────────────┐
│ 语言 / 主题 / 字号 │ │ ──────────────────────────────────────────────────────── │ │ 侧边栏面板菜单 ┌───────┬────────┐ │ │ 侧边栏顶部的全局面板菜单（插件、扩展 │ 按钮行 │ 列表 │ │ │ 管理、定时任务、IM 等）如何排列。 └───────┴────────┘ │ │ ──────────────────────────────────────────────────────── │ │ 链接打开方式 / 开发者工具 / 快捷键 … │ └──────────────────────────────────────────────────────────┘

效果

| | 之前 | 之后（默认） |
| 该区域 | 4 行「图标 + 文字」，每行 36px 高 | 一行 36×36 图标按钮，横向排列 |
| 文字 | 常显 | 隐藏，悬停显示同名 tooltip |
| 侧边栏窄条（rail） | 图标竖排 | 不变（插件在此阶段不写任何规则） |
| 侧边栏其它部分 | 工作区 / 会话列表 / 底部按钮一律不动，不加任何控件 | 同左 |

在设置 → 通用里选择「按钮行 / 列表」即可切换；选择记在浏览器 localStorage，刷新后保持。默认是按钮行。

安装

方式 1：CLI（推荐，包/锁文件保持一致）

dsh plugin --profile core-020 add /Users/ruan/projects/dsh-home/dsh-sidebar-panel-buttons
若 dsh 不在 PATH 里：
node "/Users/ruan/Library/Application Support/dsh-tauri/dependencies/dsh/node_modules/@deepseek-ai/dsh/lib/bin.js" \
plugin --profile core-020 add /Users/ruan/projects/dsh-home/dsh-sidebar-panel-buttons

这条命令把本包以 link: 写进 profile 依赖、追加到 dsh.profile.bundles，并应用本包 cordis.patch.yml 里的挂载行——与 dsh-tauri-* 这些插件在本机的挂载方式完全一致。

方式 2：手动挂载（不碰 package.json / lockfile）

ln -s /Users/ruan/projects/dsh-home/dsh-sidebar-panel-buttons \
~/.dsh/profiles/core-020/node_modules/dsh-sidebar-panel-buttons

然后在 ~/.dsh/profiles/core-020/cordis.patch.yml 末尾追加：

- insert:
- id: sidebar-panel-buttons
name: dsh-sidebar-panel-buttons

这种方式在下次 pnpm install 清理“多余”符号链接后会失效，届时启动会因为 ERR_MODULE_NOT_FOUND 报错——长期使用请走方式 1。

方式 3：图形界面

侧边栏「插件」页 → 添加插件 → 填上面的绝对路径。

生效

profile 配置默认可热重载，客户端插件变更会被推送到已打开的页面。没变化就刷新页面（⌘R），再不行重启应用。

验证

curl -s http://127.0.0.1:3082/ | grep -c dsh-sidebar-panel-buttons # 宿主启动图里应出现本包

页面上：那排按钮出现、且侧边栏底部没有任何插件的按钮即安装成功；设置（⌘,）→ 通用 里能看到「侧边栏面板菜单」这一行（排在「字号」之后）。控制台里可以看到插件写的两个状态属性：

document.documentElement.dataset.dshPanelButtons // "row"（默认）或 "list"
document.documentElement.hasAttribute("data-dsh-panel-wide") // 侧边栏是否处于展开阶段

卸载 / 回滚

- 方式 1 装的：dsh plugin --profile core-020 remove dsh-sidebar-panel-buttons
- 方式 2 装的：删掉那行 patch 与符号链接
- 只想临时关掉：插件页禁用，或在 设置 → 通用 里切回「列表」（不动配置）

实现

- 目标区域是 sidebar.panellist，由 @deepseek-ai/dsh-client-ui-sidebar 渲染：一个 nav 里每个 slot 入口一个 （图标格 + 文字格）。该区域的几何没有 slot 扩展点（slot 只喂每行的图标），所以插件走样式表 + DOM 打标：
1. 注入一张 ，每一条规则都由 把关——切到 list 或去掉属性，侧边栏立刻恢复原样；
2. 在 DOM 扫描里给容器与行打自己的 data-dsh-panel-nav / data-dsh-panel-row / data-dsh-panel-label 标签，样式表只认这些标签，不依赖 shell 的任何 hash 类名。
- 依赖的「契约」只有稳定项：渲染器在每行里输出的 data-slot="sidebar.panellist" 锚点，以及行上原有的 aria-label（本地化菜单名）。tooltip 就是 content: attr(aria-label)，不需要额外 DOM。
- data-dsh-panel-wide 只在「有文字标签」的展开阶段出现，所以窄条 rail 完全走 shell 原样式。
- 扫描在稳态是 O(行数)：定位到的 nav 会缓存，只有离开文档才重新定位； MutationObserver 负责「插件后注册面板」「侧边栏展开/收起」这些变化。
- 选项注册进 shell 自带的「通用」列表 settings.general.item（kind: list，order: 12，排在「字号」11 与「链接打开方式」14 之间），所以插件不占设置导航的一页，也不再需要自己的标题/说明；行就是列表的一项，控件用 shell 自己的 SegmentedControl。
- 行几何是照 shell 的 DeveloperToolsRow.module.css 原样复刻的（label 左 / 控件右 / gap:24px / padding:16px 0 / 0.5px 分隔线 / 14px 标题 + 12px 灰字说明），并且行根元素就是 slot host 的直接子节点——这样 shell 自己的 [data-slot="settings.general.item"] > :last-child{border-bottom:none} 会照常生效，无论最后一行是不是本插件。

测试

npm test # 零依赖：桩 DOM 跑 apply / 扫描 / 通用设置行 / 卸载（44 项）
npm run check # 语法 + 清单（dsh.client、exports、bundle id、挂载行）
npm install --no-save happy-dom && npm run test:dom
真 DOM：把侧边栏与「通用」里的那一行都渲染出来，验证选择器命中、级联生效、点选项真的切换并落盘（29 项）

test:dom 会加载本机 dsh 自带的侧边栏样式表一起算级联，确认是「覆盖赢了」，而不只是「我们声明了」。伪元素（tooltip）与 border 简写里的 var() 在 happy-dom 里无法计算，这部分只做声明级断言。

限制

- 上游若改写该区域结构（不再有 sidebar.panellist 出口），样式会静默失效，侧边栏回落到原生外观，不会报错或崩页。
- 只改这一处区域，不动工作区列表与窄条 rail；设置里只加一行，不新增页面、不改导航。
- 按钮尺寸（36px）、间距（4px）、tooltip 与设置行样式都在 lib/client.js 的 CSS 字符串里，可直接调。
- 设置项存在浏览器 localStorage（键 dsh-sidebar-panel-buttons:layout），不进宿主 settings.yaml：它是纯浏览器布局偏好，与侧边栏折叠状态同类。
- 需要 dsh 0.2.0-rc.1（dsh.compatibility 已声明）。