侧栏设置入口 Nishikinov/dsh-sidebar-settings-button

dsh-sidebar-settings-button

DSH 插件：在侧边栏头部放一行 Settings，紧挨 Plugins 之前，一键打开原生设置面板。

┌─ sidebar ─────────────────┐
│ ⚙ Settings ← new row
│ ⊛ Plugins
│ ⏱ Schedules
└───────────────────────────┘

它做什么

在侧边栏自己的 sidebar.panellist 座位注册一个条目，order: -10（Plugins 是 0，Schedules 是 10），所以这行排在最前，由随附的侧边栏绘制：原生几何、悬停、焦点环、折叠栏图标与提示、本地化标签。点击打开的面板和 Ctrl+, / ⌘+, 一样。

它怎么工作

点击被拦截。 sidebar.panellist 是主面板的座位——ui-sidebar 把每个条目变成一个按钮，其 onClick 调用 ctx.layout.selectPanel(id)，而这个 id 必须指向布局键控 main 槽里的组件。Settings 不是面板，而是 ui-settings-general 拥有的模态框，selectPanel 遇到未知键会抛错。所以在 document 上挂一个捕获阶段监听器，在 React 根之上接管点击（React 18 委托到容器），改为打开 Settings。每次点击都重新解析该行所在的 button，所以图标、标签和按钮内边距都算作这一行。

Settings 通过快捷键注册表打开。 settings.open 是唯一的程序化入口：面板的打开状态是 ui-settings-general 私有的，而接收 openSettings 的 settings.launcher 座位是 single 槽，已被账户菜单占用。ctx.shortcuts.registry.invoke(id, context) 是原生 Electron 菜单用来在不触发按键绑定的情况下运行命令的路径。调用时故意传 modal: null——否则只要有任何 [role="menu"] 挂载，注册表的模态守卫就会吞掉这次调用，而该动作是幂等的（open: true），所以面板不会被误关。

没有静默失败。 每条降级路径都返回简短原因，显示在 Toast 里并记录到控制台。DevTools 可用 F12 打开。

安装

Windows, using the app's own CLI:
& "$env:LOCALAPPDATA\Programs\DeepSeek Harness\resources\runtime\cli\bin\dsh.cmd"
plugin --profile desktop add <path-to-folder-or-tgz>

dsh plugin --profile desktop remove dsh-sidebar-settings-button # uninstall

dsh plugin add 就是在配置档里执行 pnpm add，再加一次 dsh.profile.bundles 对账，所以声明了 dsh.bundle 的包会自动加入层列表。文件夹安装是 link:，因此这份检出始终是唯一事实来源。

验证

node test/bundle.test.mjs # 6 tests: registration, order, whole-row click, Toast, degradations
node --check src/index.js; node --check client/bundle.js

实时检查——客户端槽位检查器必须在 plugins 之前列出我们的条目：

cordis_inspect_query(platform: "client", provider: "Slots",
method: "listSubTree", input: { root: "sidebar.panellist" })

限制

- 头像菜单里的「Settings」项保留 —— 它属于另一个插件的 React 树。标题行是额外增加的、始终可见的入口。
- 这一行的 id 不指向任何主面板；只有点击拦截在阻止 selectPanel 抛错。如果 ui-sidebar 哪天改用 onClickCapture，这个拦截就得重做（测试只覆盖我们这一侧）。
- 侧边栏传入 { size, active }；只用到 size，这一行永远不会高亮 —— Settings 不是面板。

布局

没有构建步骤：浏览器那一半是普通的经典脚本，调用 window.__ModuleLoader__.load({ id, factory })。它只 require 平台模块（react、@deepseek-ai/dsh-client-ui-primitives），所以 dsh.client.inject / dsh.client.external 都不需要。

src/index.js host half — no-op stub; exists so dsh-client-modules finds the browser bundle client/bundle.js the entire feature cordis.patch.yml inserts the Loader entry into the profile composition test/bundle.test.mjs