前言¶
DeepSeek Harness (DSH) 是一个插件化架构的平台。默认的深色或浅色界面虽然实用，但在个性化定制上往往比较受限。开发者或用户如果希望改变侧边栏的视觉风格，通常需要修改配置文件或编写额外的样式代码。dsh-plugin-wallpaper 插件提供了一个更直接的解决方案，通过在侧边栏添加选择器，让用户能够快速切换壁纸并调整遮罩浓度。
插件介绍¶
该插件由开发者 shukookie 维护，专注于界面视觉的个性化。它解决的是“如何在不修改核心主题代码的情况下，为 DSH Web 界面增加动态背景和亮度控制”的问题。插件通过侧边栏面板管理壁纸资源，支持本地文件导入和一键切换，旨在降低用户定制 UI 的门槛。
核心功能¶
- 本地图片上传：支持 jpg、png、webp 和 gif 格式。大尺寸图片会在浏览器端被裁剪至 2560px 宽度，以保证界面流畅度。
- 遮罩浓度滑块：提供 0% 到 100% 的滑块控制，步长为 5%。它会在背景图上覆盖一层浅色（浅色模式）或深色（深色模式）遮罩，确保文字内容清晰可见，默认浓度为 60%。
- 一键切换：提供快速切换按钮，无需打开设置面板即可循环切换下一张壁纸。
- 预设资源：内置 7 种渐变壁纸，且每种都针对明暗模式进行了单独调色。
- 主题集成：通过
theme.overrideTokensAPI 修改主题，卸载插件后会自动恢复默认状态。 - 明暗模式适配：遮罩层颜色会根据当前界面的明暗模式自动在白色和黑色之间切换。
安装与启用¶
使用官方 CLI 工具安装该插件。安装后需要刷新页面或重启 dsh web 服务以使插件生效。
dsh plugin --profile web add dsh-plugin-wallpaper
使用方法¶
- 打开壁纸面板：刷新页面后，点击侧边栏底部的 Wallpaper 按钮，打开壁纸选择器。
- 选择壁纸：在面板中点击预设的渐变卡片，或点击上传按钮选择本地图片文件。
- 调整遮罩：在面板中拖动滑块，观察背景与文字的对比度，直至满意。
- 快速切换：点击面板中的 Switch 按钮，直接切换到下一张壁纸，无需再次打开面板。
- 恢复默认：如果需要重置所有设置，点击 Restore default 按钮即可。
注意事项¶
- 内存存储：上传的图片仅在当前页面的内存中保存，刷新页面或重启服务后，本地上传的图片将丢失，不会写入磁盘或上传到网络。
- 实现方式：插件仅通过公开的
theme.overrideTokensAPI 修改主题，不使用 DOM 欺骗等侵入性手段，确保系统稳定性。
总结¶
dsh-plugin-wallpaper 是一个轻量级的视觉定制工具。它通过侧边栏管理器、本地图片支持和实时预览功能，让用户能够快速定制 DeepSeek Harness 的界面风格，且不会对系统性能造成负担。
