Bundle

dsh-wallpaper

Wallpaper skin for the DeepSeek Harness web UI: image background with opacity, mask and blur controls.

Source: RexCue
stars: 3 stars
License: MIT
Updated: Updated 3 hours ago

Readme

# dsh-wallpaper — DeepSeek Harness 图片壁纸皮肤插件

用一张图片作为 DSH Web 界面的窗口背景，并可通过右下角小面板实时控制：

- **图片透明度**（0–100%）
- **面板透明度**（0–100%，越小背景图越透）
- **压暗遮罩**（0–100%，提高文字可读性）
- **背景模糊**（0–40px）

## 原理

- 在 `<body>` 里插入两个固定全屏层：`#dsh-wallpaper-bg`（背景 `<img>`，`object-fit: cover` + `referrerpolicy="no-referrer"` 以绕开防盗链）与 `#dsh-wallpaper-mask`（遮罩），并把应用根节点 `#root` 抬到 `z-index: 1`，图片层垫在应用之下。
- 把 `--dsw-alias-*` 语义 token 用 `color-mix()` 改为半透明（`!important` 压过主题 presenter 的内联 token），让图片从所有面板后面透出来；浅色 / 深色两套底色分别处理。
- 配置存于浏览器 `localStorage`（key: `dsh-wallpaper:v1`）。图片支持本地文件（自动缩放并压缩成 JPEG，稳稳落进 localStorage 配额）或 http(s) 链接（应用前先探测能否加载，失败会在面板提示）。

## 文件

| 文件 | 说明 |
|------|------|
| `package.json` | 包元数据：`dsh.bundle.patch`（可被 `dsh plugin add` 安装）+ `dsh.client.platform=web`、`immediately=true`、`exports["./client"]` |
| `cordis.patch.yml` | bundle patch：把 `dsh-wallpaper` 插入 composition |
| `index.js` | host half（空实现，仅满足 cordis loader 导入） |
| `client.js` | 浏览器 half：`window.__ModuleLoader__.load({ id: "dsh-wallpaper", factory })`，含样式注入、背景层、控制面板 |

## 安装

发布到 npm 后（或直接以 GitHub 仓库 `owner/repo` 形式），一条命令装进 web profile：

```bash
dsh plugin --profile web add dsh-wallpaper     # npm 包名
# 或
dsh plugin --profile web add <owner>/dsh-wallpaper   # GitHub 仓库
```

然后启动 web：

```bash
dsh --profile web
```

> 本机开发时的做法（源码在 `~/Desktop/harness/dsh-wallpaper/`）：改动后把 `client.js index.js package.json cordis.patch.yml` 同步到 `~/.dsh/profiles/web/node_modules/dsh-wallpaper/`，并在 `~/.dsh/profiles/web/cordis.patch.yml` 里保留 `- insert: [{ id: wallpaper, name: 'dsh-wallpaper' }]`，再重启 web 服务。

## 使用

1. 页面右下角出现 🖼 按钮，点开面板：
   - 选本地图片 / 粘贴图片链接 → 应用；
   - 拖动滑块实时调整透明度 / 遮罩 / 模糊；
   - 「移除图片」或「恢复默认」关闭壁纸。
2. 配置自动保存在浏览器本地，刷新 / 重开浏览器仍生效（换浏览器需重新设置）。

## 卸载

```bash
dsh plugin --profile web remove dsh-wallpaper
```

然后重启 web 服务。

## 备注

- 需要较新的浏览器（`color-mix()`，Chrome/Safari/Firefox 2023+ 均支持）。
- 第三方主题（`ctx.theme.register` 注册的皮肤）与壁纸半透明层可共存；壁纸层的 token 覆盖优先级更高。
- 显示不出来的常见原因已做处理：HEIC（iPhone 照片）无法解码会明确提示、过大的本地图会自动压缩、链接失效/防盗链会在面板报错；如仍显示黑色背景，请打开浏览器开发者工具 Console 看 `[dsh-wallpaper]` 开头的报错。

Install

dsh plugin --profile web add github:RexCue/dsh-wallpaper

Profile: web

This source has no pinned commit, so a later push upstream changes what installs. Prefer pinning a commit.

Source