前言¶

DeepSeek Harness 的插件生态允许用户扩展功能。默认的界面风格固定，长期使用容易产生审美疲劳。dsh-bg-switcher 专注于解决背景更换的问题，允许用户使用预设或自定义图片，快速调整界面氛围。

是什么¶

这是一个用于 DeepSeek Harness 的插件，由 Bainianzzz 维护。它将侧边栏底部「设置」按钮上方的区域改造为「背景」入口。用户可以选择 6 个预设色卡，或输入自定义图片 URL，将背景铺满窗口并保存选择。

核心功能¶

插件将入口注册在 sidebar.footer.action 插槽。

由于按钮展开时约 220px、收起时 56px，受限于侧边栏宽度，无法在原位置直接展开面板。因此，选择面板是一个 position:fixed 的浮层，根据按钮位置测量后贴在侧边栏右侧，窗口缩放时会自动重新定位。

背景图直接绘制在 html 标签上。--dsw-alias-bg-base 经 ctx.theme.overrideTokens 置为 transparent，底层透明后，通过遮罩层保持前景不透明。亮暗色各配一层遮罩，暗色由 html:has(body[data-ds-dark-theme]) 跟随。

选择保存在 localStorage（dsh.bg-switcher.selection）中，重装或升级插件都不影响。

安装与启用¶

使用 plugin_manager 工具进行安装：

安装 DSH 插件 https://github.com/Bainianzzz/dsh-bg-switcher：
1. 克隆仓库到 ~/dsh-plugins/dsh-bg-switcher；
2. plugin_manager 工具，action=install_bundle，target 填该目录绝对路径；
3. 确认 application 为 applied，否则把 warnings 与 error 报给我；
4. cordis_inspect_query 查客户端 sidebar.footer.action 插槽，确认出现 id 为 bg-switcher 的条目。

安装完成后，在侧边栏选中插件，点击启用。

典型用法¶

1. 在侧边栏底部找到「背景」按钮（位于「设置」按钮上方）。
2. 点击按钮，从 6 个预设色卡中选择，或粘贴自定义图片地址。
3. 窗口背景会立即铺满并记住选择。

技术细节¶

• 渲染顺序：外壳先渲染该槽位、再渲染 sidebar.settings，所以按钮落在「设置」上方。
• 清理机制：样式标签与 token 层在 ctx.effect 里创建并返回清理函数，停用即回到主题默认。
• 主题适配：亮暗色遮罩确保在不同主题下前景内容可读。

参考资源¶

• 插件目录：https://www.skillhub.cn/plugins/Bainianzzz/dsh-bg-switcher
• GitHub 仓库：https://github.com/Bainianzzz/dsh-bg-switcher