在 DeepSeek Harness（DSH）桌面版中，界面风格的个性化往往受限于核心代码。默认的背景图虽然实用，但难以满足用户区分不同会话或提升视觉舒适度的需求。dsh-background 插件通过叠加层技术，允许用户在不修改 DSH 核心逻辑的情况下，直接更换窗口背景并调节遮罩强度，从而实现低成本的个人化定制。
插件定位¶
dsh-background 是一款由 SnoWinKK 维护的趣味换装类插件，专为 DSH 桌面版设计。它通过图片选择、遮罩强度调节及命令操作，实现了对 DSH 桌面 UI 背景的自定义，支持本地配置持久化。
核心功能¶
- 图片选择：支持 PNG、JPG、WebP、GIF 格式，文件大小限制在 8MB 以内。
- 遮罩调节：提供调暗和调亮功能，通过面板按钮或命令菜单调节遮罩强度，以适应不同亮度的图片。
- 快捷命令：支持在聊天框输入
/background调出控制菜单。 - 恢复默认：提供清除按钮或命令，一键恢复初始状态。
- 本地持久化：图片设置通过 localStorage 本地持久化，重启应用不丢失。
- 配置文件：支持通过
~/.config/dsh-background/config.文件预设图片路径和遮罩强度。
安装与启用¶
使用 DSH 的 CLI 工具安装此插件。请将 <profile> 替换为你的配置文件名（通常桌面版为 desktop）。
dsh plugin --profile <profile> add github:SnoWinKK/dsh-background
安装完成后，重启 DSH 即可加载插件。
典型用法¶
- 设置背景图：进入设置菜单的「常规」选项，点击「自定义背景」中的图片选择按钮。
- 命令操作：在聊天框输入
/background调出控制菜单。 - 调节遮罩：点击面板上的调暗（◐）或调亮（◑）按钮，或在
/background菜单中选择。 - 清除背景：点击菜单中的清除按钮，恢复默认背景。
适用场景与注意¶
- 环境要求：该插件仅适用于 DSH 桌面版，不兼容网页版；运行环境要求 Node.js 版本 >= 20。
- 文件限制：上传的背景图片大小不能超过 8MB。
- 配置优先级：若同时存在配置文件和本地存储，配置文件优先级高于 localStorage。
- 许可证：插件采用 MIT 许可证开源。
总结¶
通过 dsh-background，用户可以低成本地实现 DSH 界面的个性化定制。该插件结构清晰，维护活跃，适合希望优化桌面端视觉体验的开发者或用户。
