照片壁纸 fl0-0wer/dsh-wallpaper

dsh-wallpaper

English · 简体中文

给 DeepSeek Harness 换一张图片背景的插件 —— 让整个界面后面铺一张照片。

dsh-wallpaper

DSH 的外观只有浅色 / 深色 / 跟随系统三档，主题 token 也只承载颜色，既没有壁纸功能、也没有自定义 CSS 入口。这个插件补上这一块：侧栏、会话区、输入框后面会铺上图片，界面表面变成半透明玻璃，让照片透出来。

它做了什么

- 宿主半侧（lib/index.js）在 DSH 的 web server 上注册一组接口：
- GET /dsh-wallpaper/config.json —— 返回配置文件内容，附带图片的修改时间；
- GET /dsh-wallpaper/image —— 返回图片本身（jpg / jpeg / png / webp / avif / gif / svg）；
- POST /dsh-wallpaper/config —— 把补丁合并进配置（数值会被夹到合理区间）；
- POST /dsh-wallpaper/upload —— 收下上传的照片（校验文件头，上限 40 MB）并把配置指向它。
- 客户端半侧（lib/client.js）注入一个 ，把照片作为固定背景画在 上，再把五个表面 token 换成中性色板的半透明版本： --dsw-alias-bg-base、--dsw-alias-bg-layer-1、--dsw-alias-bg-layer-2、--dsw-alias-bg-layer-3、--dsw-alias-bg-module-platform。
它还会注册设置 → 背景壁纸页面，全部操作都在界面里完成。

遮罩、模态框（--dsw-alias-bg-overlay、--dsw-alias-bg-mask-）刻意不动，保证弹窗始终可读。

所有代码都包在 try/catch 里：客户端入口一旦抛错会终止整个 web boot，桌面端会因此禁用全部第三方插件，所以这里不能有任何异常逃出去。

安装

需要一个支持客户端插件（dsh.client）的 DSH 版本（桌面版或 dsh web），以及一个 profile —— 默认是 desktop。

git clone https://github.com/fl0-0wer/dsh-wallpaper.git
cd dsh-wallpaper

把包复制进 profile、把配置复制到 ~/.dsh/wallpaper：

PROFILE="${DSH_PROFILE:-$HOME/.dsh/profiles/desktop}"
mkdir -p "$PROFILE/node_modules/dsh-wallpaper" "$HOME/.dsh/wallpaper"
cp -r package.json lib "$PROFILE/node_modules/dsh-wallpaper/"
[ -f "$HOME/.dsh/wallpaper/config.json" ] || cp config.json "$HOME/.dsh/wallpaper/"
[ -f "$HOME/.dsh/wallpaper/current.jpg" ] || cp current.jpg "$HOME/.dsh/wallpaper/"

然后往 $PROFILE/cordis.patch.yml 末尾追加：

- insert:
- id: dsh-wallpaper
name: dsh-wallpaper

也可以直接跑 tools/install-wallpaper.sh，它会自动完成上面的复制并先备份 cordis.patch.yml。

不需要重启：loader 会热加载新条目，页面自己就会拿到这个模块。

使用

打开设置 → 背景壁纸：点「选择图片…」挑一张照片，用「关闭壁纸 / 开启壁纸」控制开关，下面的滑杆调遮罩、透明度、模糊和饱和度。每改一次都会立刻保存并在界面后面重新上色 —— 不用重启，也不用刷新。

设置 → 背景壁纸

也可以直接把照片放进 ~/.dsh/wallpaper/，然后修改 config.json：

{
"enabled": true,
"image": "我的照片.jpg", "scrim": 0.45, "blur": 0, "saturation": 1, "translucency": 0.5 }

切到别的窗口再切回来即可 —— 窗口重新获得焦点时插件会重读配置，图片按修改时间自动换缓存，不用刷新页面。

| 字段 | 默认 | 说明 |
| enabled | true | 设为 false 会撤掉图层和样式，相当于临时关掉 |
| image | current.jpg | ~/.dsh/wallpaper/ 里的文件名；不写扩展名时按 jpg → jpeg → png → webp → avif 依次查找 |
| scrim | 0.45 | 压在照片上的黑色遮罩，0–1；觉得字发散就调大 |
| blur | 0 | 模糊半径（px），8–24 是磨砂观感；大于 0 时改用带滤镜的固定图层 |
| saturation | 1 | 0.6 偏灰、1.4 更艳 |
| translucency | 0.5 | 界面表面透出照片的程度；0 = 几乎不透明，1 = 最透 |

浅色 / 深色

插件内置中性色 / 白色两套色板，跟随主题自己的 body[data-ds-dark-theme] 属性切换，所以「设置 → 通用 → 外观」里的浅色、深色、跟随系统都能正常工作。强调色、代码高亮、边框、文字颜色都不受影响的，只有表面颜色被换掉。

如果你还装了玻璃质感主题（比如 Catppuccin），壁纸会接管表面颜色，主题的强调色和文字配色保持不变。

卸载

1. 删掉 $PROFILE/cordis.patch.yml 里的 - insert: dsh-wallpaper 这一段。
2. 删除 $PROFILE/node_modules/dsh-wallpaper/。

~/.dsh/wallpaper/ 可以留着，它本身不会产生任何效果。

目录结构

dsh-wallpaper/
├── lib/index.js 宿主半侧：/dsh-wallpaper/ 路由 ├── lib/client.js 客户端半侧：注入样式、图层与设置页 ├── config.json 默认配置 ├── current.jpg 默认壁纸（由 make-default.py 生成） ├── make-default.py 用 numpy + Pillow 重新生成 current.jpg ├── docs/ README 用的截图 └── tools/ 安装 / 切换脚本与冒烟测试

tools/install-wallpaper.sh 负责装进 profile，tools/toggle-wallpaper.py 可以卸载再加载这个条目，让改过的 lib/ 立即生效而不重启应用，tools/test-client.mjs 与 tools/test-host.mjs 是不依赖第三方库的冒烟测试。

许可

MIT