侧栏标签右键增强 zhaoruizhe81/dsh-sidebar-tab-actions

dsh-sidebar-tab-actions

给 dsh Web GUI 右侧栏的标签右键菜单补上该有的那几个操作。装之前菜单里只有一条「关闭」，装之后同一个菜单变成：

关闭 ← 套件自带的 ──────────────── 📌 固定关闭其他关闭右侧关闭左侧关闭全部 ← 危险色

只跟 dsh 0.2.0-rc.2 及之后的版本对齐，只在浏览器半边运行，host 半边是空的。

行为

| 菜单项 | 关掉什么 |
| 固定 / 取消固定 | 切换当前标签的固定状态，按会话持久化 |
| 关闭其他 | 同一分栏里除自己以外的全部标签 |
| 关闭右侧 | 同一分栏里排在自己右边的全部标签 |
| 关闭左侧 | 同一分栏里排在自己左边的全部标签 |
| 关闭全部 | 同一分栏的全部标签，包括自己 |

文案刻意压到两到四字，跟 dsh 自己那套 dock 词汇（关闭／分栏／全屏）同一种语感——菜单里只有套件那条「关闭」是两字、其余都四字以上，读起来会跳。

五条规则，一句话说完：

1. 固定标签不被任何批量关闭动到，四个关闭项都会跳过它。
2. 目标为空的项不出现。右键第一个标签时没有「关闭左侧」，整个分栏只剩一个标签时四个关闭项全不出现。
3. 顺序就是屏幕上看到的顺序。dsh 按分栏自己的标签数组画 chip，所以 DOM 顺序就是布局顺序。
4. 唯一停靠的引导页不算可关闭，那种分栏上只剩下「固定」一项，和 dsh 自己藏掉关闭按钮的规则一致。
5. 固定状态按会话存，键是 dsh.sidebar-tab-actions.pins.v1.<sessionId>，刷新页面和重启应用都还在。

固定的 chip 会在标题左边出一枚图钉。

已知限制

- 固定拦不住单点关闭。 chip 上的 × 和套件自带的「关闭」由 dsh 自己决定，插件没有席位去否决。所以固定的语义是「不被批量关掉」，跟 VS Code、Chrome 的固定标签可以单独关闭是一致的。
- 批量关闭会产生多条撤销记录。 dsh 的 ISidebarRight 只有单个 close(tabId)，关 N 个标签就是 N 步撤销，和手动逐个关闭一样。
- 关掉分栏最后一个标签会让整列收起，这是 dsh 自身规则，「关闭全部」因此可能把右栏收起来。固定一个标签就能避免。
- 固定按标签 id 记，不按内容记。 关掉再重新打开同一个文件，固定会丢——dsh 的 chip 上只有标签 id 可读，而 VS Code 的 pin 也是绑定在 editor 实例上的。
- 图钉是 DOM 装饰。 插件往 chip 上写一个自己拥有的 data-dsh-tab-pinned 属性并注入一张样式表，随插件一起回收。不想要就配 badge: false。

安装

git clone https://github.com/zhaoruizhe81/dsh-sidebar-tab-actions.git
cd dsh-sidebar-tab-actions

先退出 DeepSeek Harness，profile 的 package.json 有文件锁
"/Applications/DeepSeek Harness.app/Contents/Resources/runtime/cli/bin/dsh" \
plugin --profile desktop add link:"$PWD"

装完重新打开 App。dsh 会把包名写进 ~/.dsh/profiles/desktop/package.json 的 dsh.profile.bundles，包里的 cordis.patch.yml 再作为 bundle 层把插件行插进 roster——profile 自己的 cordis.patch.yml 不用动。

两个可能绊到你的地方：

- cli/bin/dsh 没有可执行位，直接跑会 Permission denied，用 sh "<那个路径>" 调。
- ERR_PNPM_IGNORED_BUILDS 会让退出码非零，于是 dsh 跳过自动写 dsh.profile.bundles 那一步。依赖和软链已经装好了，手动把 "dsh-sidebar-tab-actions" 加进 dsh.profile.bundles 数组末尾即可。（那几条被忽略的构建脚本来自 profile 里既有的 @google/genai、protobufjs，跟本插件无关。）

卸载：

"/Applications/DeepSeek Harness.app/Contents/Resources/runtime/cli/bin/dsh" \
plugin --profile desktop remove dsh-sidebar-tab-actions

或者在「设置 → 插件」里直接停用这个 bundle。

配置

在 profile 的 cordis.patch.yml 里用同一个 id 覆盖：

- id: sidebar-tab-actions
name: dsh-sidebar-tab-actions
config:
badge: false # 关掉固定标签的 chip 图钉

改代码

lib/client.js 就是产物本身，没有构建步骤——它是按 dsh 客户端模块系统要求的闭包工厂形状手写的，只 require 模块表里的基线条目（React、dsh-client-store、dsh-client-ui-primitives）。

保存即生效：不用刷新，不用重启，也不用在设置里停用再启用。

host 侧的 dsh-client-hmr 按固定间隔 stat 轮询每个 bundle 的 client.js（刻意用轮询——网络挂载不产生 inotify 事件），mtime / ctime / size 一变就换掉该 row 的 revision，通过 /plugins/events 的 SSE 推给页面，页面随即重新 import 这一行；插件的 effect 先拆再装，新文案直接上屏。实测从写盘到页面拿到新 revision 在秒级。
改动包元数据（package.json 的 dsh.client、cordis.patch.yml）或 profile 的 dsh.profile.bundles 也算数：profile HMR 会监视 profile 的 package.json 与两层 cordis.patch.yml，一有变化就重算补丁并 reconcile 到运行中的 loader，同样不需要重启——本插件第一次加载就是这么上线的（加完 bundles 条目 2 秒后页面就拉到了 bundle）。

npm test # 41 项，纯 node:test，无依赖

测试覆盖纯逻辑（目标集合计算、分栏读取、固定集合读取、图钉样式表）、注册接线、组件渲染出的行与点击顺序，以及在假 DOM 上跑的图钉装饰器安装/标记/回收。

为什么这么写

dsh 右侧栏的标签菜单只有一个扩展位：sidebar.right.tab.menu.item，需要 sidebarRight 服务，并且不允许插件拿到分栏的标签列表——ctx.sidebarRight 上只有 close / focus / openTab 这些动作，没有任何读取接口。

所以这个插件从三个公开契约上取信息：

- 菜单内容走 sidebar.right.tab.menu.item 席位，菜单行用共享原件 MenuItemButton 渲染（它本身就是 role="menuitem"，dsh 靠这个角色判断菜单是不是空的）。
- 分栏里的标签顺序从 chip 的标记读：[data-dockkit-tab] 在 [data-dockkit-strip-tabs] 里的文档顺序，也就是 dsh 自己读自己那一行 chip 的方式。
- 当前会话从 [data-sidebar-right-session] 读，用来定位这个会话自己的固定集合。

固定集合存在插件自己的一个 defineStore 里（会话作用域 + persist），组件通过 store 席位读写，装饰器读自己那个 localStorage 键。