dsh-wallpaper-skin

dsh plugin --profile web add dsh-wallpaper-skin

dsh-wallpaper-skin

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

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

特性

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

安装

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

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

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

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

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

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

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

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

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，过长请自行裁剪
• 仓库不含壁纸素材，请使用你自己的图片/视频

开发

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)