前言¶

DeepSeek Harness（DSH）桌面版左下角有一条账号行：点头像、再从菜单里选「设置」，才能打开设置面板。对经常改模型、插件或偏好的人来说，这一步多了一层菜单。社区插件 dsh-settings-companion（维护者 AspirinEny）在账号行右侧加一栏「齿轮 + 设置」，点一下直接打开设置，仍走官方 shortcuts 的 settings.open，不是模拟按键。

下面介绍它做什么、怎么装、使用时要注意什么。插件归类为客户端；目录页见 SkillHub，源码与说明见 GitHub 仓库。DSH 生态强调「一切皆插件」；SkillHub 等社区目录与 DeepSeek / 幻方无官方从属关系，本文仅作技术介绍，不是官方应用商店文案。

这是什么¶

dsh-settings-companion 给 DSH 桌面版侧边栏账号行增加第二栏：左边仍是头像 + 账号名（行为与官方一致），右边是齿轮图标和「设置」文字。简介原文：Adds a gear + Settings column beside the DSH desktop sidebar account row.

Host 侧几乎是空壳；逻辑在 Client bundle 的 lib/client.js 里，通过槽位与 portal 把 UI 嵌进官方账号行，而不是替换 settings.launcher 槽位（该槽为 single 型，官方 AccountMenu 已占满）。

核心功能¶

经 README 核实，当前版本（package 中为 0.2.1）主要能力如下。

一键进设置¶

点击 companion 栏时调用 shortcuts 服务的 settings.open，语义与菜单里点「设置」一致：

ctx.get("shortcuts").registry.invoke("settings.open", { target, region: "page", modal: null })

modal: null 表示打开面板，而不是切换开关状态。

外观与文案¶

• 运行时读取账号按钮的 CSS-module 类名并复用，高度、圆角、hover、折叠为 36×36、未登录 32px 等尽量与官方一致；类名对不上时回退插件自带样式，视觉可能退化但不会崩。
• 注册 settings.companion 命名空间（en / zh），切换语言即时生效。
• 齿轮路径复制自官方 IconSettingsOutlineMedium，与账号菜单里的「设置」图标同源。

依赖与平台¶

• 零依赖：不 require Harness Client 包，也无第三方运行时依赖。
• MIT 许可；仓库 badge 标明平台为 DSH desktop · web client，但 Web 版没有账号行，插件静默跳过，不渲染内容。

安装与启用¶

安装对象必须是 DSH 桌面版（左下角有账号行）。改的是客户端 bundle，装完后须完全退出并重启 DSH；仅 Ctrl+R 重载页面不会重载 JS 模块。

方式 A：界面从本地目录安装¶

1. 下载 Release 中的 dsh-settings-companion-<version>.zip，或拿到源码目录，解压到之后不会移动的位置，例如 D:\DSH-Plugins\dsh-settings-companion。
2. DSH → 设置 → 插件 → 从本地安装 → 选择 package.json 所在目录。
3. 重启 DSH。

pnpm 会以 link: + 目录联接（Junction）记录路径；源目录移动或删除后插件失效，适合本地改代码迭代。

方式 B：命令行安装 tarball（推荐分发）¶

Windows 下使用默认安装路径中的 CLI（README 原文）：

& "$env:LOCALAPPDATA\Programs\DeepSeek Harness\resources\runtime\cli\bin\dsh.cmd" `
  plugin --profile desktop add "C:\path\to\dsh-settings-companion-0.2.0.tgz"

tarball 会被复制到 ~/.dsh/profiles/desktop/node_modules/，与源文件脱钩。自行打包：

node scripts/pack.mjs   # 产出 dist/dsh-settings-companion-<version>.tgz

方式 C：Release tarball 链接（本机无 git 时）¶

在「从本地安装 / 安装插件」输入框粘贴（永远指向最新 Release）：

https://github.com/AspirinEny/dsh-settings-companion/releases/latest/download/dsh-settings-companion.tgz

锁定版本可改为例如 …/releases/download/v0.2.1/dsh-settings-companion-0.2.1.tgz。不要只贴仓库根 URL，否则 pnpm 可能按 git 依赖解析并调用 git ls-remote，未安装 Git 时会报 ERR_PNPM_GIT_RESOLVE_FAILED。

方式 D：从源码目录（开发）¶

& "$env:LOCALAPPDATA\Programs\DeepSeek Harness\resources\runtime\cli\bin\dsh.cmd" `
  plugin --profile desktop add "C:\path\to\dsh-settings-companion"

改 lib/client.js 后重启 DSH 即可看效果，无需重装。

卸载¶

& "$env:LOCALAPPDATA\Programs\DeepSeek Harness\resources\runtime\cli\bin\dsh.cmd" `
  plugin --profile desktop remove dsh-settings-companion

或在 设置 → 插件 中移除 bundle 后重启。

典型用法¶

安装并重启后，无需额外配置项：侧边栏账号行应呈现左右两栏，右侧为齿轮 +「设置」（或英文 Settings）。点击右侧栏即打开设置面板；点击左侧仍进入原有账号菜单。

仓库 README 注明暂无界面截图，请以本机实际效果为准。

适用场景与注意¶

适合谁：主要在 DSH 桌面版日常调设置、不想每次从头像菜单进「设置」的用户。

兼容性要点（README 原文）：

• 依赖槽位名 settings.launcher 与账号按钮 CSS-module 后缀（*_trigger / *_label）；上游改动时样式可能回退，功能仍应可用。
• 未在 DSH 之外的其他客户端验证。

安全与信任：插件以当前 DSH 进程权限运行，会参与 Client 侧 DOM 与 shortcuts 调用。安装前建议阅读 源码 与 MIT LICENSE，自行判断是否适合你的环境。

开发侧若改仓库内容，提交前可跑：

node scripts/verify.mjs

结尾¶

dsh-settings-companion 用 companion 栏补一条直达设置的路径，实现上通过 sidebar.footer.action 拿生命周期、portal 进账号行，并 invoke 官方 settings.open。若你在桌面版频繁改偏好，可以按上文任选一种安装方式试用。

• 目录页：https://www.skillhub.cn/plugins/AspirinEny/dsh-settings-companion
• GitHub：https://github.com/AspirinEny/dsh-settings-companion