dsh-better-settings
仓库:https://github.com/W0rry628/dsh-better-settings · 变更记录见 CHANGELOG.md
DeepSeek Harness(DSH)插件:在侧边栏左下角账号栏那一行的右侧加一个设置齿轮按钮,
一键打开设置面板 —— 不必再「点开账号菜单 → 点设置」两步走。
┌─────────────────────────────┐
│ … 会话列表 … │
│ │
│ [头像] 账号名 ⚙ │ ← 这个齿轮是本插件加的
└─────────────────────────────┘
它做了什么
- 挂载后找到侧边栏底部的设置行(ui-settings-general 的
triggerRow),
把齿轮按钮追加到该行最右侧,紧跟在连接状态、更新提示之后。
- 点击时优先复用外壳自己注入的
openSettings(settings.launcher 的注入物,
账号菜单拿到的就是它),因此打开的是原生设置面板,不模拟点击、不闪菜单。
- 跟随界面语言切换
设置 / Settings 文案;tooltip 里带上当前生效的
settings.open 快捷键(如 Ctrl+,)。
- 侧边栏收起成 56px 轨道时自动隐藏(那一行只有 36px 宽,放不下第二个按钮)。
- 如果所在部署里那一行本来就有内置设置按钮(没有账号插件接管
settings.launcher),则不加重复按钮。
为什么用 DOM 挂载而不是 Slot
DSH 的插槽清单里,侧边栏底部只有两个口:
| Slot | 位置 | 说明 |
|---|
sidebar.footer.action | 设置行上方独立的一行 | 「Optional actions beside Settings at the sidebar foot」,footArea 是纵向列 |
sidebar.settings | 账号栏所在的那一行 | single,占用者是 ui-settings-general 的整行;内部没有留给第三方按钮的插槽 |
那一行内部的结构是 [settings.launcher(账号菜单)] [ConnectionIndicator] [DesktopUpdateIndicator],
想把自己的按钮放在账号栏右侧,只能挂到该行末尾。所以这里采用社区插件
(dshmarket、dsh-ui-tweaks)在同类无插槽场景下的做法:认领一个带自有标记的
DOM 节点、用 MutationObserver 跟随重排,并在卸载时完整回收。
如果只想放在「设置行上方那一行」,那把 lib/client.js 里的挂载逻辑换成注册
sidebar.footer.action 插槽即可,那是一条更稳定(但位置不同)的路。
安装
从 GitHub 安装:
dsh plugin --profile desktop add 'github:W0rry628/dsh-better-settings'
也可以直接在 DSH 的插件管理器 / 插件市场里装。
本地开发(把仓库克隆到本机任意目录):
dsh plugin --profile desktop add file:/绝对路径/dsh-better-settings
手工等价操作:
- 在
$DSH_HOME/profiles/<profile>/package.json 的 dependencies 里加:
"dsh-better-settings": "github:W0rry628/dsh-better-settings"(本地开发写
"file:/绝对路径/dsh-better-settings")。
- 把
"dsh-better-settings" 追加到同文件 dsh.profile.bundles 数组末尾
(顺序即 patch 层应用顺序)。
- 在 profile 目录执行
pnpm install。
- 重启 DSH 桌面版(客户端半边是新的模块,热更新只在
dev:web 同时运行时生效)。
结构
| 文件 | 作用 |
|---|
package.json | 包清单:dsh.bundle.patch(bundle 层)+ dsh.client(浏览器半边) |
cordis.patch.yml | bundle patch:把 dsh-better-settings 这一行插进 profile 配置树 |
lib/index.js | 服务端半边:不做任何事,只是为了这一行能被正常加载 |
lib/client.js | 浏览器半边:全部功能都在这里 |
test/client-smoke.mjs | 假 DOM 冒烟测试:验证落位、去重、轨道态隐藏与卸载回收 |
CHANGELOG.md | 版本变更记录 |
测试
node test/client-smoke.mjs
已知限制
- 依赖
triggerRow 的 CSS Module 类名子串与 aria-haspopup 语义来定位行;
DSH 若改掉这两个约定,需要同步更新 findTriggerRow / findLauncher。
- 打开设置时优先走 React fiber 上注入的
openSettings;React 内部结构若变化,
会自动退回「点开账号菜单 → 点设置」的兜底路径。
- 收起轨道态不显示按钮。
License
MIT