顺顺壁纸（dsh-wallpaper）

English | 中文

为 DeepSeek Harness Web UI 提供 GIF 壁纸 与 B站音乐播放器 的一体化插件。

📸 预览

壁纸动效（GIF 原片，非录屏）

| 壁纸全屏效果 | 顺顺壁纸设置页 | 侧栏迷你播放器 | |---|---|---| | | | |

✨ 功能

壁纸

• 全屏 GIF 壁纸（动态飞马图片，大家一起干飞马⭐）
• 主题融合遮罩：亮色主题白色遮罩、暗色主题深色遮罩，层级渐实保证文字可读
• 突出度滑块（0–100%，默认 50%）：控制壁纸从"最不明显"到"完全突出"
• 插件启用/停用开关

音乐

• 随附 5 首内置歌曲（飞在八分前 / 绝不认输 / 天下 / 我会一直顺 / 飞八分钱 PHONK）
• B站链接添加音乐：输入 BV / av / b23.tv 链接，自动获取 30280 档位 AAC 音频流（约 200kbps）并保存为 m4a（重复标题自动拦截）
• 删除歌曲（随附歌曲删后重启不恢复，B站下载歌曲同步删除文件）
• 音量滑块、进度条 + 拖动 seek、播放失败提示
• 三种播放模式：单曲循环 / 列表循环 / 随机播放（随机模式下切歌也随机）
• 默认曲目「飞八分钱 PHONK」，自动连播
• 侧栏迷你播放器（常驻控制：上一首 / 播放暂停 / 下一首 / 当前歌名）
• 关闭设置面板音乐不中断

持久化

• 设置（突出度 / 启用状态 / 音量 / 播放模式 / 当前曲目）自动保存，刷新或重启后恢复
• 播放列表与删除记录保存在 assets/music/playlist.json

📦 安装

方式一：npm 一键安装（推荐 🚀）

已发布到 npm：https://www.npmjs.com/package/dsh-shunshun-wallpaper

dsh plugin --profile web add dsh-shunshun-wallpaper

或（原生 npm 方式）：

npm install dsh-shunshun-wallpaper

安装后重启 DSH（dsh web）即可使用。

方式二：GitHub 源码安装

1. 克隆仓库到本地任意位置：

   git clone https://github.com/Ddamage/dsh-shunshun-wallpaper.git

2. 把插件目录放入 DSH profile（DSH_HOME 默认 ~/.dsh）：

   cp -r dsh-wallpaper ~/.dsh/profiles/web/wallpaper-plugin

3. 在 profile 的 package.json 注册插件（~/.dsh/profiles/web/package.json）：

   {
     "dsh": { "profile": { "bundles": [ /* 追加 */ "dsh-shunshun-wallpaper" ] } },
     "dependencies": { /* 追加 */ "dsh-shunshun-wallpaper": "link:./wallpaper-plugin" }
   }

4. 重启 DSH（dsh web），刷新浏览器即可使用。

机制说明：本包是 profile bundle——package.json 的 dsh.bundle.patch 指向包内 cordis.patch.yml，其中用 insert: 自动挂载插件行（dsh-shunshun-wallpaper），无需手动编辑 profile 的组合文件。profile 顶层 cordis.patch.yml 只用于覆盖已有条目、不能新增插件。

🎵 添加你自己的音乐

• B站：设置 → 顺顺壁纸 → 音乐 → 粘贴链接 → 添加（自动下载 30280 档位 AAC 音频）
• 本地文件：把 .mp3 / .m4a 放入 assets/music/，重启 DSH 自动出现在歌单

🖼️ 更换壁纸

把图片放入 assets/wallpapers/（支持 gif/png/jpg/webp），并修改 lib/client.js 中 WALLPAPER_URL 指向的文件名。

⚠️ 注意

• 仓库内的音乐文件为作者个人整理，发布前请自行确认版权合规
• 需要 DSH Web 模式（dsh web），依赖 webServer 服务
• lib/client.js 必须是 window.__ModuleLoader__.load({...}) 包裹的格式（DSH 浏览器端加载要求）——修改客户端逻辑时请保持该格式，不要改回普通 ESM，否则 DSH 无法启动
• 修改代码后需同步更新安装副本（~/.dsh/profiles/web/wallpaper-plugin/）并重启 DSH 生效