dsh-ui-wallpaper

English | 中文

DeepSeek Harness Web GUI 的壁纸插件，仿照 Wallpaper Engine：把任意本地图片、GIF 或视频设为自己的自定义背景，应用表面转为半透明让壁纸透出，并在设置中提供「壁纸」页面用于选择、预览与管理。

效果图

皮肤由本包拥有的三个独立贡献组成：

• Token 叠加层 — ctx.theme.overrideTokens() 为 --dsw-alias-bg-base 与 --dsw-specific-sidebar-fill 在深浅两套色板各叠加 60% 半透明混合。折叠按 token、按色彩模式进行，用户的深浅色偏好不受影响；卸载插件即恢复原始不透明 token。
• 背景层 — shell.overlay 注册项把固定、点击穿透的媒体面通过 portal 挂到 document.body 并使用负 z-index，因此应用内容绘制在其上，而半透明列 token 让媒体透出。图片与 GIF 支持平铺、填充、适应、拉伸；视频支持填充、适应、拉伸（平铺回退为填充）。
• Host 路由 — POST /dsh-wallpaper/media 将所选文件原子替换存储到 $DSH_HOME/wallpaper，GET /dsh-wallpaper/media 以 nosniff 内容类型回读。路由位于浏览器信任栅栏之后（loopback 加 trustedHosts 配置）；接受的格式即 src/model/wallpaper.ts 里的共享 MIME 白名单。

设置页包含实时预览、四种显示方式、本地文件选择（image/* 加 mp4/webm/ogg 视频）以及关闭/恢复默认操作。持久化偏好是 dsh.wallpaper store；只保存 URL 与显示方式，因此媒体字节落在磁盘而不是 localStorage。默认壁纸仍是 /eva.jpg（外壳静态资源 apps/web/public/eva.jpg），使用填充方式。

两个布局配合项保证染色只有一层：AppFrame 不画背景（body 拥有底色）、SidebarRoot 内容区画透明（布局列画填充色）。没有本皮肤时两者外观与原来完全一致；启用后壁纸从每一列单层透出，不会层层叠加变暗。

内容卡片、代码块、输入框等凸起表面保留自身填充，文字在媒体上仍然可读。

安装

本包是一个 dsh bundle：其 dsh.bundle 清单会把 ui-wallpaper 行插入任何列出该包的 profile，dsh.client 清单与 lib/client.js 携带 Web GUI 的浏览器半边。

最简单的安装方式是交给 agent 完成——DeepSeek Harness 本身，或任何能访问本仓库、且目标机器装有 dsh CLI 并有终端的 agent。把下面这段提示词粘贴给它：

帮我安装 GitHub 上的 dsh-ui-wallpaper 插件（https://github.com/youzhoujiMrLiu/dsh-ui-wallpaper）。

1. 执行 `dsh plugin add github:youzhoujiMrLiu/dsh-ui-wallpaper`（针对特定 profile 加 `--profile `）。
2. pnpm ≥10 首次会拒绝 git 依赖的构建脚本：把 pnpm 打印出的包键复制进该 profile 的 `pnpm-workspace.yaml` 的 `allowBuilds` 块，然后重新执行 add。
3. 验证 `ui-wallpaper` 行出现在 profile 组合里（`dsh --profile  --dump-config`）或 Web GUI 的插件页。
4. Web GUI 刷新页面——「壁纸」页会出现在设置里；服务器重启后请再次刷新。

信任提示：git 安装会在安装机上执行本包的 `prepare` 构建；如需固定版本可锁定提交（`github:youzhoujiMrLiu/dsh-ui-wallpaper#`）。