mwilljx-web/dsh-plugin-wallpaper

dsh-plugin-wallpaper

一个 DeepSeek Harness（dsh）网页端插件：
给界面加上赛博朋克皮肤与自定义背景图，全部在设置 → 通用里管理。

功能

设置里新增一行「界面皮肤」，分两段。

主题风格

| 控件 | 效果 |
|---|---|
| 默认 | 原生外观（背景图仍由下面的开关单独控制） |
| 赛博朋克 | 侧边栏霓虹描边 + 青→品红渐变、小图标按钮霓虹描边、悬停品红辉光、选中项高亮 |

背景图片

| 控件 | 效果 |
|---|---|
| 预览缩略图 | 当前背景 |
| 启用 / 关闭 | 开关背景图层 |
| 选择图片 | 本地图片（自动缩放到 ≤1920 宽、转 JPEG，按浏览器保存） |
| 恢复默认 | 回到内置默认背景 |
| 图片网址 | 粘贴 https:// 图片链接 |
| 暗度 | 0–0.9，压暗以保证文字可读 |
| 模糊 | 0–20px |
| 填充方式 | 铺满 / 完整显示 |

所有选择保存在 localStorage（dsh-wallpaper/v1）：只影响当前浏览器，不向任何服务器发送数据。

前置条件

- 带网页端的 DeepSeek Harness（dsh web），且该 profile 支持插件 bundle（dsh plugin）。
- 原版网页外壳（其客户端模块表提供 react 与 @deepseek-ai/dsh-client-store，本插件依赖这两者）。

安装

dsh plugin --profile web add /path/to/dsh-plugin-wallpaper

然后重启网页服务（dsh web）：插件 bundle 在启动时组装，必须重启才会加载。之后打开界面进入
设置 → 通用 → 界面皮肤。

卸载：

dsh plugin --profile web remove dsh-plugin-wallpaper

实现要点

- 背景：一个 position: fixed; z-index: -1 的图层位于应用最底层；把应用自身又高又画着底色的容器
（最外层框架、对话列、侧边栏）设为透明，让图层透出来。判定按高度（≥50% 视口高），
所以窄而高的侧栏在任何分辨率下都命中；矮小的卡片/输入框/按钮保留自己的不透明底色，文字对比度不受影响。
- 皮肤：不硬编码会随版本变化的哈希类名，而是运行时给元素打标——侧栏列容器、以及所有小图标按钮
（≤46px，或匹配稳定的 _iconButton / _tool / _panelRow / _button 后缀）——再由插件自有的
html[data-dsh-skin="cyber"] … 作用域样式上色。
- 自愈：每 2 秒轻量自检图层、透明与打标是否还在；每第 5 次（10 秒）全量重扫整棵树。SPA 重渲染与主题切换会被自动处理。
- 干净卸载：关闭背景即移除图层、样式表与所有内联覆盖。

自定义默认图

发布版内置的默认值是生成的渐变，因此不再分发任何第三方图片。要换成自己的图：

node scripts/set-default-image.mjs ./my-wallpaper.jpg
node scripts/set-default-image.mjs --gradient   # 还原成渐变

请先把图片压到合适尺寸（约 1600×900 足够）：脚本以内联 data URI 方式嵌入，不会帮你缩放。

开发

没有构建步骤。lib/client.js 直接以网页外壳的加载器格式书写——
window.__ModuleLoader__.load({ id, factory }) + CommonJS 风格 require——正是宿主从 /plugins 提供的格式。

npm test        # 结构测试 + 表面/皮肤测试，零依赖

由于宿主在启动时把插件 bundle 缓存进内存，改动 lib/client.js 后必须重启 dsh web 才会生效。

注意事项

- 设置按浏览器保存（localStorage）。
- 按设计只把又高又画底色的容器变透明。若某个版本把背景画在别处，只会"少显示一点壁纸"；
如果底色令牌一个都没匹配上，插件会退化为"任意大面积不透明容器"。
- 已在 dsh 0.1.5-rc.2 网页包上验证。

许可证

MIT，见 LICENSE。内置默认值是生成的渐变；你自行添加的图片由你自己负责授权。