侧栏紧凑导航 dyguests/dsh-compact-panel-nav

dsh-compact-panel-nav

一个 DeepSeek Harness Web UI 插件，用来压缩侧边栏顶部：插件 / 自动化任务 / 更多 从三行堆叠收成一行，新会话 离开自己独占的整行，变成品牌行最右端的图标。两项加起来，给工作区列表腾出约 130px。

压缩侧边栏顶部的 DeepSeek Harness 客户端插件：「插件 / 自动化任务 / 更多」三行合并成一行，「新会话」从整行按钮收成图标放到品牌行最右侧 —— 一共给下面的工作区列表腾出约 130px 高度。

侧边栏：新会话变成品牌行右侧的图标，插件 / 自动化任务 / 更多排成一行

它做了什么

- 展开态：三行合成一行，32px 高、三等分、图标与文字居中。
- 新会话：离开文档流，变成品牌行最右端的 28×28 纯图标控件（与右上角收起按钮同规格），tooltip 里仍然有「新建会话 ⌘N」。
- 收起态（56px 图标栏）：完全不动 —— 导航保持竖排图标，新会话回到它在窄栏里的原位。
- 其余一律不动：品牌标识、顺序、hover/选中态、焦点样式、键盘可达性、More 菜单。

实现方式

导航 —— 纯 CSS。 规则按无障碍名称定位导航地标，侧边栏从自己的 panels.label 字典里取这个名字（中文语言包是 全局面板，英文是 Global panels）。:has() 守卫要求行内同时存在图标和标题，只有展开态侧边栏才会渲染出这一对，所以收起态的图标栏保持原布局。

新会话 —— 不搬 DOM。 按钮留在 React 放它的位置；脚本只把这一个元素切成 position: absolute，以按钮自己的父元素为基准量一次品牌条，然后把几何参数（28×28、垂直居中、右对齐）写成行内样式。品牌行和其他节点上什么都不写，所以量尺寸永远不会挤压品牌标识。

动手之前先检查全部前置条件：侧边栏处于展开态、按钮是紧挨在导航前面的兄弟节点、它上方的条是一个自身不含按钮的 div（这一条会排除 macOS 窗口控制条）、按钮里含有图标。任何一项不通过，按钮就保持原样。收起侧边栏或禁用插件，会还原保存下来的行内样式文本。
「只留图标」的外观——隐藏文字与 inline ⌘N 提示，加上主题 token 里的 hover 底色——都挂在脚本自己写的 data 属性上，所以绝不会误伤无关元素。

导航行 —— 纯 CSS。 选择器只认导航容器的无障碍名称（侧边栏自己的 panels.label：中文「全局面板」、英文「Global panels」），再用 :has() 判断行内是否出现「图标 + 标题」——只有展开态成立，因此收起态保持原样。

新会话 —— 不搬家。 按钮仍在 React 放的位置，脚本只把这一个元素改成 position: absolute，以它自己的父元素为基准量一次品牌行，把几何值（28×28、垂直居中、右对齐）写成内联样式。品牌行与其它任何节点的内联样式一个都不碰，所以「量错就把品牌挤没」那种事故在结构上不可能发生。

动手前逐条校验：必须展开态、按钮必须是导航前一个兄弟、它上面那条必须是「自身不含 button」的 div（用来排除 macOS 窗口控制条）、按钮里必须有图标。任一条不成立就原样保留。收起侧边栏或停用插件时，恢复此前保存的 cssText。

Install / 安装

这是一个 profile bundle：package.json 里声明 dsh.bundle.patch，浏览器侧由 ./client 模块提供。已发布到 npm：dsh-compact-panel-nav，所以有两条路。

走 npm（不用 clone）。 把已发布的包装进 profile，然后在设置 → 插件里确认已启用：

dsh plugin --profile web add dsh-compact-panel-nav

让 Harness 智能体来做，同一步就能完成安装和 bundle 选择：

plugin_manager action=install_bundle target=dsh-compact-panel-nav

走本仓库（这里验证过的方式）。

1. clone 到固定位置（profile 通过 link 引用该目录——移动或删除它都会弄坏插件）。

git clone https://github.com/dyguests/dsh-compact-panel-nav.git

2. 把 bundle 装进当前 Harness profile。让 Harness 智能体把这个目录作为 bundle 安装——插件管理器的调用是 install_bundle，target 写 clone 下来的目录：

plugin_manager action=install_bundle target=/absolute/path/to/dsh-compact-panel-nav

它会安装包、在 profile 里选中该 bundle 并激活；profile 随后通过 link 引用这个目录。

3. 到设置 → 插件里查看这个 bundle——标题 Compact Sidebar Nav / 侧边栏导航压缩。装完即时生效；如果侧边栏没变化，刷新一次页面（Cmd+R）。

Compatibility and known limits / 兼容性与已知限制

- 已在 DeepSeek Harness 0.2.1-rc.3（Desktop，macOS）、中文界面下验证。package.json 声明 engines.dsh 为 >=0.2.1-rc.3 <0.3.0，宿主加载前会检查。
- 依赖面板导航的无障碍名称（全局面板 / Global panels）。将来版本若改了这处文案，或新增第三种界面语言，插件会「不生效」，而不是把布局弄坏。
- 「新会话」移位依赖 macOS 的品牌条形态：按钮上方是一条拖拽条，自身不含任何 button。Windows/Linux 布局里品牌行本身就是按钮，这项校验会按设计失败，只生效「一行导航」。
- 单元格三等分，侧边栏很窄时较长文案（如 自动化任务）会省略。拉宽侧边栏即可看全。
- 配色走主题变量（--dsw-radius-、--dsw-alias-），深色和浅色主题都跟随宿主。

- 在 DeepSeek Harness 0.2.1-rc.3（桌面端 / macOS、中文界面）上验证；package.json 的 engines.dsh 写的是 >=0.2.1-rc.3 <0.3.0，宿主会在装载前校验。
- 依赖导航容器的无障碍名称；将来改文案或换成第三种语言时，插件会「不生效」而不是把布局弄坏。
- 「新会话进品牌行」依赖 macOS 的品牌条形态（按钮上方是一条自身不含 button 的拖拽条）。Windows/Linux 的品牌行本身是按钮，该项校验会按设计失败 —— 那里只生效「一行导航」。
- 三等分单元格：侧边栏很窄时较长文案（如「自动化任务」）会省略；拉宽即可完整显示。
- 配色走主题变量，深/浅色模式都跟随宿主。

Uninstall / 卸载

在插件列表里停用或移除即可：样式表随之移除，脚本把按钮的内联样式还原，侧边栏恢复三行 + 整宽的新会话按钮。

Version history / 版本

- 1.3.3 — 声明 engines.dsh（>=0.2.1-rc.3 <0.3.0），宿主会在装载前校验运行时版本。仅清单改动，client.js 不变。
- 1.3.2 — 仅文档：npm 徽章、dsh plugin … add 安装命令，以及给 DSH Plugin Hub 用的 docs/hub-submission.md。运行时无改动。
- 1.3.1 — 「新会话」收成品牌行里的纯图标控件。1.3.0 已经放到位，但没隐藏 inline ⌘N 提示：它和图标一起挤 28px，两者都被裁掉；1.3.1 隐藏该提示（tooltip 仍列快捷键），并让图标容器铺满按钮。
- 1.2.0 — 撤回「按测量给品牌行加 padding」的那版实验（那次把品牌标识挤成 0 宽）。导航回到纯 CSS，并附带一次性清理残留。
- 1.0.0 — 首个版本：三行合并为一行。

License

MIT — see LICENSE.