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/ /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

dsh-better-settings

설치

문서

dsh-better-settings

它做了什么

为什么用 DOM 挂载而不是 Slot

安装

结构

测试

已知限制

License