dsh-wallpaper-skin

Readme

# dsh-wallpaper-skin

DeepSeek Harness (dsh) Web 界面的壁纸皮肤插件：把应用背景换成一张静态图片或静音循环视频，面板半透明化，让界面通透不遮挡壁纸。路径可在 Settings → Plugins 里随时改，即时生效，无需重启。

> 这是持久化插件（真实 Cordis 插件 + webserver 路由），不是动态插件，装一次永久有效。

## 特性

- 🖼️ 静态壁纸：jpg / png / webp
- 🎬 视频壁纸：mp4 / webm，**静音循环**播放（作为装饰层，不占音频）
- 🎨 右下角悬浮面板：一键换壁纸、开关，实时预览
- ⚙️ 路径可配置：Settings → Plugins → dsh-wallpaper-skin，改完即生效
- 🌓 兼容深色/浅色模式，面板半透明化

## 安装

### 方式一：dsh plugin 命令（推荐）

```bash
dsh plugin --profile web add github:ddbj-hub/dsh-wallpaper-skin
```

装完在 profile 的 `cordis.patch.yml` 里会出现插件行，重启 dsh web 后生效。

### 方式二：手动 patch（无 git 环境时）

在 `<profile>/cordis.patch.yml` 的插件列表里加一行：

```yaml
- insert:
    - id: dsh-wallpaper-skin
      name: dsh-wallpaper-skin
      config:
        path: /absolute/path/to/your/wallpaper.mp4
```

`path` 指向本机壁纸文件的绝对路径（图片或视频均可），支持正斜杠或反斜杠。留空则用默认背景。

### 方式三：本地开发 / 内网分发

```bash
git clone https://github.com/ddbj-hub/dsh-wallpaper-skin.git <本地目录>
# 然后在 profile 的 package.json 的 dependencies 里加：
#   "dsh-wallpaper-skin": "file:<本地目录>"
# 并执行：
corepack pnpm --dir <profile> install
```

> 注意：`file:` 依赖有内容缓存，改源码后需要 `pnpm remove` + `pnpm add` 刷新，`--force` 无效。

## 使用

1. 安装并重启 dsh web。
2. 右下角出现 🎨 悬浮面板，点击可：
   - 打开/关闭壁纸
   - 预览并选择当前配置的壁纸
   - 跳转 Settings → Plugins 修改路径
3. 或在 Settings → Plugins → dsh-wallpaper-skin 直接填壁纸文件路径。

### 壁纸建议

- 图片：推荐 1080p 以上，文件尽量 < 10MB
- 视频：推荐 mp4 (H.264) 或 webm，静音，建议 < 50MB，过长请自行裁剪
- 仓库不含壁纸素材，请使用你自己的图片/视频

## 开发

```text
dsh-wallpaper-skin/
├── package.json        # 插件声明：exports ./client + dsh.client { platform: web, immediately }
├── lib/
│   ├── index.js        # Host：webserver 路由（info/media/config）+ settings 命名空间
│   └── client.js       # Client：右下角悬浮面板，轮询 info 刷新
```

- 客户端打包：`window.__ModuleLoader__.load({ id, factory: (require) => {...} })`，可 `require("react")`，bundle 通过 `exports["./client"]` 暴露，由 webserver 在 `/plugins/<包名>/client.js` 提供。
- 主题：壁纸作为装饰层挂在主框架 `.pI_x6G_frame` 上，配 `!important` 盖过主题 presenter 的内联 token，面板半透明由 CSS 变量控制。
- 配置传参：Cordis 4 里读配置要用 `apply(ctx, config = {})` 的第二个参数，**不要**读 `ctx.config`（会报 `cannot get property "config" without inject`）。

## 许可证

[MIT](./LICENSE)