前言¶

DeepSeek Harness（DSH）把界面能力拆成可组合的插件；日常改模型、账号或偏好时，需要进入设置面板。桌面端可以用快捷键，但用手机通过局域网打开 Web GUI 时没有键盘，默认只能先点左下角账号菜单，再选「设置」，每次两步。维护者 REALOIYO 的客户端插件 dsh-settings-button 在侧边栏账号行旁增加齿轮按钮，一次点击打开设置，桌面与局域网设备行为一致。

这是什么¶

dsh-settings-button 是 DSH 的纯前端客户端插件：在侧边栏账号行右侧（紧挨手机号）显示齿轮，点击后直接打开 DSH 设置对话框。它不新增配置项，安装并列入 profile 的 bundle 列表后即可使用。源码与说明见 GitHub，社区目录页为 SkillHub。许可为 MIT（package 版本 1.0.0）。

核心功能¶

下面介绍 README 中已列出的能力，均可在安装后直接观察：

• 齿轮位于侧边栏账号行右侧，与手机号同一行。
• 一次点击进入设置面板，无需再经账号菜单。
• 桌面端与移动端 Web GUI 行为一致。
• 状态在浏览器侧处理，局域网内其他设备访问同样可用。
• 侧边栏收起为 rail 模式时，按钮缩为图标。
• 不挤占同区域其他插件在该行的控件。

安装与启用¶

本包尚未发布到 npm，需从 GitHub 安装。任选其一：

在 DSH 中执行：

dsh plugin add github:REALOIYO/dsh-settings-button

或在 profile 目录（通常为 ~/.dsh/profiles/desktop）中：

pnpm add github:REALOIYO/dsh-settings-button

安装后确认该包出现在 profile 的 package.json 里 dsh.profile.bundles 数组中；未列入该数组时宿主不会加载。重启 DSH 后生效。将来若发布到 npm，README 注明可简写为 dsh plugin add dsh-settings-button。

卸载时：

pnpm remove dsh-settings-button

并从 dsh.profile.bundles 中移除对应条目，再重启 DSH。

典型用法¶

没有单独的配置文件或环境变量。完成安装并重启后，打开 DSH Web 界面，在侧边栏账号行右侧点击齿轮即可打开设置。桌面端与手机浏览器通过局域网访问时步骤相同。

工作原理（简要）¶

设置面板的打开状态由宿主私有 store 持有，插件不能直接读写。可用入口包括：宿主在 shortcuts 服务上注册的 settings.open 命令，以及 settings.launcher slot 的 openSettings（该 slot 为 single，已被账号菜单占用）。本插件优先通过 ctx.shortcuts.registry.invoke('settings.open', { modal }) 调用命令；若宿主将来收紧 registry 的访问方式，实现会回退为驱动账号菜单打开设置，避免按钮完全失效。面向 DSH 0.2.1-rc.2 开发，不依赖哈希 CSS 类名，也不绑定键盘快捷键。

适用场景与注意¶

适合经常在手机或平板上通过局域网使用 DSH Web 界面、希望少点一步进设置的用户；桌面端也可当作固定入口，与快捷键并存。

插件随 DSH 客户端加载，以当前 DSH 进程及前端 bundle 的权限运行。安装前建议阅读 仓库源码 与 LICENSE，确认符合你的环境与安全要求。DSH 生态强调「一切皆插件」；SkillHub 等社区目录为独立站点，与 DeepSeek / 幻方无官方从属关系。

结尾¶

dsh-settings-button 用一行齿轮补上了 DSH 默认缺少的独立设置入口，尤其减轻局域网移动端的两步菜单操作。需要安装命令与实现细节时，以 GitHub README 为准；浏览插件信息可访问 SkillHub 目录页。