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