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

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

底层走的仍是官方 git 安装路径：prepare 在安装后从 src/ 构建 lib/，自包含、不依赖 monorepo。

在 deepseek-harness 源码 checkout 内，同一插件位于 packages/client/ui-wallpaper；那里的客户端半边还需要 web-app bundle 依赖与客户端 bundle 重建，随后重启服务器并刷新页面。

Model Experience

无，因为插件只改变浏览器呈现，不注册任何 prompt、工具、schema、会话事件或 provider 请求。

KV Cache 影响

无；本包不组装也不发送任何 provider 请求。

Known Limitations and Deferred Work

• 上传上限 — Host 路由最多接受 maxBytes（默认 64 MiB）。更大的视频需要在挂载它的补丁层 config 中覆盖 maxBytes。
• 视频平铺 — 视频使用 object-fit 渲染，因此不提供平铺；旧偏好里的平铺会解析为填充。
• 启动闪现 — 外壳启动页先于插件 bundle 加载渲染，首帧先是纯色背景，随后才出现壁纸。
• 卸载在组合层完成 — dsh plugin --profile <name> remove dsh-ui-wallpaper 会同时移除依赖与插入的挂载层；暂无运行时开关。用户安装的 bundle 插入的行目前还不会出现在「自定义插件」标签页（该分类当前只识别用户补丁层）。