界面壁纸 anqiu599/dsh-wallpaper

dsh-wallpaper

为 DeepSeek Harness（DSH）Web 界面打造的背景/壁纸插件。在 设置 → 通用 中新增「壁纸」设置项，支持渐变、纯色、图片三种壁纸，并让应用界面半透明化，使壁纸透出——浅色/深色主题下都能正常工作。

| ✅ 6 款内置渐变预设 | ✅ 纯色（8 个色板 + 系统取色器） |
| ✅ 图片壁纸（远程 URL，或由插件托管的本地文件） | ✅ 界面透明度滑块 |
| ✅ 图片模糊 / 压暗控制 | ✅ 自动适配浅色/深色主题 |
| ✅ 首页无闪烁预渲染（index bootstrap） | ✅ 设置持久化到 DSH 用户设置 |

浏览器要求：半透明层使用 CSS color-mix()，需要现代浏览器（Chrome/Edge ≥ 111、Safari ≥ 16.2、Firefox ≥ 113）。

安装

自动安装（推荐）

Windows（PowerShell） .\scripts\install.ps1

macOS / Linux
./scripts/install.sh

脚本会把插件复制到 $DSH_HOME/profiles/node_modules/dsh-wallpaper，并在 $DSH_HOME/profiles/web/cordis.patch.yml 中追加 wallpaper 行——默认已开启 aurora 渐变壁纸，重启后立即可见。然后重启 web profile：

dsh web

打开界面 → 设置 → 通用 → 壁纸 可继续调优（或关闭）。

安装脚本不会触碰你的 pnpm 状态，之后执行 dsh plugin --profile web … 也不会破坏插件；万一 profile 重建后插件消失，重新运行一次安装脚本即可。

手动安装

1. 把插件放到 profile 能解析到的位置
cp -r . "$HOME/.dsh/profiles/node_modules/dsh-wallpaper" # Windows 用 robocopy / copy

2. 在 $DSH_HOME/profiles/web/cordis.patch.yml（或任意晚于 web-app bundle 的层）注册行。
注意：新增行必须放在 insert 块里——顶层的 - id: 只能修改「已存在」的行，否则会报 "entry not found" 被拒绝。

- insert:
- id: wallpaper
name: dsh-wallpaper
config:
enabled: true # 安装后立即可见；否则按 schema 默认关闭 mode: gradient gradient: aurora

卸载

.\scripts\install.ps1 -Uninstall # 或：node scripts/install.mjs --uninstall

使用方法

1. 打开 设置 → 通用 → 壁纸（也可通过侧边栏的设置按钮进入）。
2. 打开 启用壁纸 开关。
3. 选择模式：
- 渐变 — 点选 6 款预设之一。
- 纯色 — 点选色板，或用系统取色器自定义。
- 图片 — 点选内置壁纸缩略图，或点 选择本地图片…（自动上传并立即生效），或粘贴远程 URL；再调节 模糊 与 压暗。
4. 调节 界面透明度（50–100%）：越低壁纸透出越明显，建议保持较高数值以保证阅读舒适度。
5. 恢复默认 一键清除你的覆盖值，回到组合默认值。

设置会持久化到 DSH 用户设置（$DSH_HOME/settings.yaml），重启不丢失，并自动跟随浅色/深色主题。

使用自己的本地图片

最简单的用法：图片模式下点 选择本地图片…，文件会自动上传到插件的资源目录（默认上限 20 MB）并立即应用。assetRoot 指向你自己的壁纸文件夹时同样适用。

高级用法仍可手动把图片放进资源目录，用 /plugins/dsh-wallpaper/assets/<文件名> 引用，或在地址栏粘贴任意 https:// 远程图片 URL。

浏览器无法直接读取本地任意路径，所以本地文件走插件的上传/托管路由。

配置项

在 cordis.patch.yml 中可给插件行添加以下配置（均可选）：

- insert:
- id: wallpaper
name: dsh-wallpaper
config:
assetRoot: C:/Users/you/Pictures/wallpapers # 托管在 /plugins/dsh-wallpaper/assets/* 的目录（也是上传目标） maxUploadBytes: 20971520 # 一键上传大小上限（0 表示禁用上传） indexBootstrap: true # 在插件加载前先渲染已启用的壁纸（防闪烁）默认壁纸配置（同时作为设置的 base 层）： enabled: true mode: image imageUrl: /plugins/dsh-wallpaper/assets/photo.jpg blur: 4 dim: 0.2 surfaceAlpha: 0.9

| 字段 | 类型 | 默认值 | 含义 |
| assetRoot | string | 插件自带 assets/ | 托管在 /plugins/dsh-wallpaper/assets/ 的目录（也是上传目标） |
| maxUploadBytes | number | 20971520 | 一键上传大小上限（base64 载荷；0 禁用上传） |
| indexBootstrap | boolean | true | 在应用 index 中注入插件加载前的预渲染脚本 |
| enabled | boolean | false | 总开关 |
| mode | none \| gradient \| image \| color | gradient | 壁纸类型 |
| gradient | string | aurora | 预设 id：aurora、sunset、ocean、midnight、forest、peach |
| color | string | #4f7cf7 | 纯色（十六进制） |
| imageUrl | string | 内置 aurora.svg | 远程 URL 或 /plugins/dsh-wallpaper/assets/<文件> |
| blur | number 0–40 | 0 | 图片模糊（px） |
| dim | number 0–0.9 | 0 | 图片压暗（最大时亮度 0.6） |
| surfaceAlpha | number 0.5–1 | 0.92 | 界面覆盖层的透明度 |

工作原理

DSH 的整个 Web 界面都由 --dsw- 设计变量驱动（如 --dsw-alias-bg-base、--dsw-specific-sidebar-fill 等）。本插件是一个双面（dual-face）Cordis 插件：

- Host 端（lib/index.js）：注册 wallpaper 设置命名空间（持久化到 $DSH_HOME/settings.yaml）；提供带路径穿越防护的资源路由；对 index HTML 做 tap，让已启用的壁纸在客户端插件树激活前就渲染出来（无闪烁）；并提供一个小的状态 API（/plugins/dsh-wallpaper/api），通过 host 端 settings 服务读写命名空间。
- 浏览器端（lib/client.js）：手写的客户端 bundle，经 window.__ModuleLoader__ 加载。它注入一个 ：把壁纸画成固定的 body::before 层（z-index: -2），并用 color-mix() 把设计变量重新混合成半透明（浅色/深色两套调色板），然后向 settings.general.item 槽位注册「壁纸」设置项。设置项的数据走插件自己的状态 API（启动时 GET、每次修改 POST 并带乐观更新）——因为 DSH 的 api-proxy 只向配置客户端暴露一份硬编码的命名空间白名单，白名单之外的命名空间会被 settings-not-exposed 拒绝。

客户端 bundle 无需构建：它只 require 平台模块（react/jsx-runtime、@deepseek-ai/dsh-client-runtime/client），所以直接修改 lib/client.js 后重启 profile 即可生效。

目录结构

├── lib/
│ ├── index.js # Host 端（设置命名空间、资源路由、状态 API、index 预渲染） │ └── client.js # 浏览器端（DOM 样式 + 设置项；无需构建） ├── assets/ # 内置壁纸图片（SVG），经资源路由托管 ├── scripts/ │ ├── install.mjs # 跨平台安装脚本（复制/链接、打补丁、卸载） │ ├── install.ps1 # Windows 包装脚本 │ └── install.sh # macOS/Linux 包装脚本 ├── package.json # npm 包清单（含 dsh.client 声明） └── .github/workflows/ci.yml

开发

npm run check # 语法检查所有 JS 文件
node scripts/install.mjs --link # 开发模式：以目录链接（junction/symlink）方式装入 profile

--link 会在 $DSH_HOME/profiles/node_modules/dsh-wallpaper 与当前仓库之间建立目录链接（Windows 为 junction），并给仓库的 node_modules/@deepseek-ai 建立链接，保证 Host 端依赖可解析。改完仓库里的文件 → 重启 dsh web → 即可看到效果。新增渐变预设时，记得同时更新 lib/index.js 与 lib/client.js 中镜像的预设表。

常见问题

- 设置里没有「壁纸」项 — 插件未加载；重启 dsh web 并检查启动日志中 client-modules 报错（MissingClientBundleError 表示客户端 bundle 路径不对）。
- 壁纸可见但界面仍不透明 — 浏览器版本低于上面列出的 color-mix() 支持版本。
- 插件被 pnpm 清掉了 — 你执行过 dsh plugin --profile web …，它会重新同步 profile 的 pnpm 状态；重新运行 scripts/install.ps1 即可。

许可证

MIT © 2025 dsh-wallpaper 贡献者