前言¶
在 DeepSeek Harness（DSH）桌面端里改 API Key、模型或账号相关选项，通常要先点侧边栏底部的账号区域，再在二级菜单里选「设置」。多一步菜单，在频繁调参或排查连接问题时会显得啰嗦。
社区插件 dsh-sidebar-settings（维护者 linguiyii）是 DSH 客户端插件：在侧边栏底部增加一行「⚙ 设置」，点一次即打开设置面板；原有账号菜单里的「设置」和快捷键 Ctrl+, 仍保留。本文介绍其定位、安装方式与使用注意，事实均来自 GitHub 仓库 README 与 package.json。
这是什么¶
- 名称：
dsh-sidebar-settings（npm 包名，仓库 linguiyii/dsh-sidebar-settings） - 分类：客户端（
dsh.client.platform为web，在桌面端 Web UI 中加载） - 版本（资料中明确）：
0.1.0 - 许可证：MIT
插件不做设置页内容本身，只把「打开设置面板」这个动作搬到侧边栏 footer 区，与外壳自带的 sidebar.settings 行并存（README 截图中可见上下两行入口；本插件不删除原生行）。
核心功能¶
侧边栏底部直达设置¶
安装并重启桌面端后：
- 侧边栏底部多出一行「⚙ 设置」，单击打开设置面板（README 示例为「添加 API Key」引导态）。
- 侧边栏折叠为图标栏（rail）时，该行变为居中齿轮图标；悬停提示为「打开设置 (Ctrl+,)」。
与原生入口的关系¶
- 账号菜单中的「设置」、快捷键
Ctrl+,（Windows/macOS 桌面端）仍可用。 - 实现上优先通过
sidebar.settings槽位上的 store 调用actions.open()，与原生齿轮、Ctrl+,走同一 action；较旧外壳无公开 store 时，用基于data-slot的 DOM 点击兜底。插件不通过页面内合成keydown模拟Ctrl+,（README 说明宿主在桌面端处理该快捷键，页面派发无效）。
扩展点¶
按钮注册在 sidebar.footer.action（list 槽，多插件可按 order 共存），位于最底部 sidebar.settings 行之上；样式通过带 data-plugin 的 <style> 注入，配色使用 --dsw-* 主题变量。
安装与启用¶
前置条件¶
- Node.js ≥ 22（
package.json的engines）。 - DeepSeek Harness 桌面端：README 写明曾在 0.1.5-rc.2 的 Web UI 上做过端到端验证。
- 安装需对
<DSH_HOME>/profiles/<profile>有写权限（Windows 默认%USERPROFILE%\.dsh）。
为何不用 dsh plugin add¶
README 说明：dsh plugin --profile desktop ... 会被拒绝，错误为 profile "desktop" is managed exclusively by the Electron application——desktop profile 由 Electron 应用独占管理。因此仓库提供 scripts/install-desktop.mjs，在 profile 层完成与「装插件」等效的三处改动（junction/符号链接、package.json 的 dependencies、dsh.profile.bundles），并为改动文件生成 *.dsh-sidebar-settings.bak 备份。
下面命令来自 README 原文（PowerShell 示例；默认 profile 为 desktop）：
git clone https://github.com/linguiyii/dsh-sidebar-settings
cd dsh-sidebar-settings
node scripts/install-desktop.mjs --dry-run # 先看要改什么
node scripts/install-desktop.mjs # 真正写入
安装完成后重启 DeepSeek Harness 桌面端（客户端 bundle 在启动时装配）。
卸载：
node scripts/install-desktop.mjs --uninstall
其他 DSH_HOME 或 profile 示例：
$env:DSH_HOME = "C:\path\to\.dsh"; node scripts/install-desktop.mjs --profile web
社区目录页：skillhub.cn/plugins/linguiyii/dsh-sidebar-settings。DSH 生态强调「一切皆插件」；该目录为社区站点，与 DeepSeek / 幻方无官方从属关系，安装前请自行查看源码与许可证。
典型用法¶
- 按上一节完成安装并重启桌面端。
- 在侧边栏最底部找到新增的「⚙ 设置」，单击进入设置面板（例如配置 API Key）。
- 若习惯折叠侧栏，在 rail 模式下点齿轮图标即可，效果与展开态一致。
- 仍可使用账号菜单 → 设置，或
Ctrl+,，与插件按钮互不冲突。
适用场景与注意¶
适合谁：经常在 DSH 桌面端里打开设置、希望减少「点头像再点设置」步骤的开发者或日常用户。
已知限制（README「已知限制」）：
- 账号菜单内的「设置」无法被本插件移除（无公开扩展点）；插件只是在更顺手的位置补入口。
- 必须重启桌面端后生效。
- 侧栏折叠时
sidebar.footer.action仅提供wide形态，按钮不根据设置面板是否已打开做状态高亮。
安全与信任：客户端插件随当前 DSH 进程与用户权限运行，会向 profile 写入链接与 bundle 配置。安装前请阅读仓库 src/client.js / lib/client.js 及 MIT 许可证，确认接受维护者 linguiyii 的代码与安装脚本行为。
结尾¶
dsh-sidebar-settings 把设置从账号二级菜单提到侧边栏底部，一键打开与原生相同的设置外壳，且不取代原有快捷键与菜单项。需要安装步骤与实现细节时，以仓库 README 为准。
