前言¶
DeepSeek Harness（dsh）的 Web 界面默认是官方壳层样式。若你长期在浏览器里跑 dsh web，侧边栏和按钮的视觉往往偏「工具感」，背景也缺少个性化。社区插件可以按 bundle 注入客户端逻辑，在不动核心仓库的前提下改界面表现。下面介绍 dsh-plugin-wallpaper：在 Settings → General 里统一管理「主题皮肤」和「背景图」，数据只落在本机浏览器。
这是什么¶
dsh-plugin-wallpaper 是面向 DeepSeek Harness Web 面的插件，由维护者 mwilljx-web 发布，在社区目录中归类为 趣味换装。一句话定位：给浏览器 UI 提供 Cyberpunk 侧边栏与图标按钮样式，以及 可开关、可换图的背景层，均在设置面板中配置。
- 目录页：https://www.skillhub.cn/plugins/mwilljx-web/dsh-plugin-wallpaper
- 源码：https://github.com/mwilljx-web/dsh-plugin-wallpaper
- 许可证：MIT（
package.json版本 1.0.0）
核心功能¶
设置里对应一行入口，下面分两块能力（README 表述为「One Settings row, two sections」）。
主题样式（Theme style）¶
| 选项 | 效果 |
|---|---|
| Default | 恢复原生外观（背景图是否显示仍由背景区块自己的开关决定） |
| Cyberpunk | 侧边栏霓虹边框、青→品红渐变洗色；小图标按钮霓虹样式；悬停品红光晕；当前行高亮 |
皮肤通过运行时给 DOM 打标，再用插件样式表在 html[data-dsh-skin="cyber"] 下生效，避免硬编码会因 dsh 构建变化的 CSS Module 类名。
背景图（Background image）¶
| 控件 | 效果 |
|---|---|
| 预览缩略图 | 当前背景 |
| enable / disable | 开关背景层 |
| choose image | 本地文件（宽边缩至 ≤1920px、JPEG，按浏览器分别存储） |
| reset | 恢复内置默认 |
| image URL | 粘贴 https:// 图片地址 |
| dim | 0–0.9 暗化遮罩，便于读字 |
| blur | 0–20px |
| fit | cover / contain |
所有选项持久化在 localStorage，键名为 dsh-wallpaper/v1：按浏览器隔离，不上传服务器。
实现要点（便于判断是否适合你的环境）¶
- 背景层：
position: fixed; z-index: -1置于应用后方；对「足够高（≥ 视口高度 50%）且为基础色容器」做透明处理，让壁纸透出，短控件与卡片仍保持不透明以保证对比度。 - 自愈：约 2 秒一次的 watchdog 会复查图层、透明与标签；每第五次 tick 全树重扫，适配 SPA 重渲染与主题切换。
- 关闭背景：会移除图层、样式表及插件写入的内联覆盖，便于干净卸载或禁用。
发行包内置默认图为中性赛博朋克 渐变（不捆绑第三方图库）。若要替换默认图，可在仓库根目录执行：
node scripts/set-default-image.mjs ./my-wallpaper.jpg
node scripts/set-default-image.mjs --gradient # 恢复渐变默认
建议预缩放到约 1600×900；脚本以内联 data URI 写入，不再缩放。
环境与依赖¶
- 需要带 Web 面的 DeepSeek Harness（
dsh web），以及支持插件 bundle 的 profile（dsh plugin）。 - 依赖官方 Web shell 暴露的客户端模块（README 写明需有
react与@deepseek-ai/dsh-client-store）。 - 插件通过
package.json的dsh.client.inject挂接@deepseek-ai/dsh-client-locale、@deepseek-ai/dsh-client-ui-renderer、@deepseek-ai/dsh-client-ui-settings等；无独立构建步骤，客户端入口为lib/client.js。 - README 注明已在 dsh
0.1.5-rc.2Web 包上验证；Node ≥20（engines）。
安装与启用¶
先从 GitHub 获取插件目录到本机（路径以下文 /path/to/dsh-plugin-wallpaper 为例），再执行官方安装命令：
dsh plugin --profile web add /path/to/dsh-plugin-wallpaper
插件 bundle 在 Web 服务启动时 组装，因此安装后需要 重启 dsh web。打开 GUI，进入 Settings → General → Interface skin 即可看到皮肤与背景相关选项。
卸载：
dsh plugin --profile web remove dsh-plugin-wallpaper
开发或修改 lib/client.js 后同样需要重启 dsh web，宿主会在启动时缓存 bundle。
典型用法¶
- 安装并重启
dsh web后，打开 Settings → General → Interface skin。 - Theme style 选 Cyberpunk，观察侧边栏与 ≤46px 图标按钮的霓虹样式与悬停效果；若要原生 UI，选 Default。
- 在 Background image 中开启背景，用 choose image 选本地图，或 image URL 填
https://地址；用 dim / blur / fit 调节可读性与铺放方式。 - 不满意时用 reset 回到内置默认渐变；需要换发行包默认图时，维护者可在源码树用
set-default-image.mjs烘焙后再打包分发。
本地自检（零 npm 依赖）：
npm test
适用场景与注意¶
适合谁：长期在浏览器使用 dsh web、希望界面有赛博朋克皮肤或自定义壁纸，且接受「设置仅保存在当前浏览器」的开发者或自用部署。
权限与安全：插件随当前 dsh Web 进程与用户浏览器上下文 运行；背景 URL 与本地文件由你自行选择。安装前应阅读源码与 MIT 许可证；你添加的图片版权与合规性由你自己负责（README 对嵌入默认渐变与自定义图有说明）。
局限（README Caveats）：
- 设置按浏览器保存在
localStorage，换浏览器或清站点数据会丢失。 - 仅对「足够高的基础色容器」做透明化；若某版 shell 把背景画在非常规节点上，壁纸可见区域可能变少；若无匹配的基础色 token，会回退到「任意足够高的不透明容器」策略。
DeepSeek Harness 生态强调「一切皆插件」；SkillHub 等社区目录为独立站点，与 DeepSeek / 幻方无官方从属关系，本文安装与能力描述均以仓库 README 为准。
结尾¶
dsh-plugin-wallpaper 把 Web 界面的赛博朋克皮肤与可配置背景收到同一设置入口，数据留在本机 localStorage，适合在已有 dsh web 环境里做轻量「趣味换装」。进一步细节与 issue 见 GitHub：https://github.com/mwilljx-web/dsh-plugin-wallpaper；社区条目：https://www.skillhub.cn/plugins/mwilljx-web/dsh-plugin-wallpaper。
