B-TQ/dsh-wallpaper

---

🎛️ 设置界面

插件安装后，进入 设置 → 动态壁纸，即可完整控制壁纸的展示与效果：

所有改动自动保存，永久生效。

✨ 功能特性

🚀 安装

前置：已装好 DeepSeek Harness（dsh web 能正常打开），Node.js ≥ 22.19。

一键安装

插件自带 dsh.bundle manifest，一条命令即可自动注册，无需再改任何配置：

dsh plugin --profile web add "github:B-TQ/dsh-wallpaper"

未安装 git 时，可直接用 GitHub 打包的源码 tarball：

dsh plugin --profile web add "https://codeload.github.com/B-TQ/dsh-wallpaper/tar.gz/refs/heads/main"

发布到 npm 后，也可直接按包名安装（scoped 名归作者账号所有，不会与其他同名插件冲突）：

dsh plugin --profile web add @b-tq/dsh-wallpaper

安装完成后 强制刷新浏览器（Ctrl + Shift + R）即可在 设置 → 动态壁纸 中看到插件。

手动安装（备选）

1. 把插件源码放到 ~/.dsh/plugins/dsh-wallpaper

2. 建立链接（Windows 用 junction）：

   mklink /J "%USERPROFILE%\.dsh\profiles\web\node_modules\dsh-wallpaper" "%USERPROFILE%\.dsh\plugins\dsh-wallpaper"
   

3. 在 ~/.dsh/profiles/web/package.json 的 dependencies 添加：

   "dsh-wallpaper": "link:C:/Users/<你的用户名>/.dsh/plugins/dsh-wallpaper"
   

4. 在 ~/.dsh/profiles/web/cordis.patch.yml 末尾追加：

   - insert:
       - id: wallpaper
         name: dsh-wallpaper
   

5. 重启 dsh，浏览器打开 http://127.0.0.1:3080

🎮 使用

进入 设置 → 动态壁纸：

• 开关：一键开启 / 关闭壁纸，关闭后界面完全还原
• 壁纸库：列出 ~/.dsh/wallpapers 下所有媒体，「使用」立即切换，「删除」移除文件
• 上传本地文件…：选择本地视频 / 图片，自动入库并设为当前壁纸
• 扫描工坊…：扫描 Wallpaper Engine 工坊，点击「导入」复制入库
• 效果调节：遮罩暗度、面板透明度、缩放模式，改动实时生效

所有改动自动保存，永久生效。

🛠️ 配置工坊目录

默认扫描 D:\steam\steamapps\workshop\content\431960（Steam 默认位置）。Steam 库在别处时，启动 dsh 前设置环境变量：

# PowerShell
$env:DSH_WALLPAPER_WORKSHOP_ROOT = "D:\SteamLibrary\steamapps\workshop\content\431960"

# macOS / Linux
export DSH_WALLPAPER_WORKSHOP_ROOT="$HOME/.steam/steam/steamapps/workshop/content/431960"

🗑️ 卸载

1. 删除 ~/.dsh/profiles/web/cordis.patch.yml 中的 wallpaper insert 条目
2. 删除 ~/.dsh/profiles/web/package.json 中的 dsh-wallpaper 依赖行
3. 删除链接与 ~/.dsh/plugins/dsh-wallpaper 源码目录
4. （可选）删除 ~/.dsh/wallpapers 与 ~/.dsh/wallpaper-config.json（如需保留壁纸文件请先移走）

❓ 常见问题

🛠️ 开发

npm run check   # 校验三个入口文件的语法

📄 许可

MIT © dsh-wallpaper contributors