Background-Wallpaper-Engine
把 Steam Wallpaper Engine 的壁纸（视频 / 场景 / 网页）以及本地导入的视频、图片渲染成 Trae CN（VS Code 内核 IDE）的背景层。全部在本机运行，不上传任何数据。
版本说明
本扩展面向 Trae CN 与 VS Code 维护，版本号沿用 0.2.x 序列。
- 面向对象：专为 Trae CN 维护，优先保证与 VS Code 同时运行时的端口隔离与稳定性。
- 适用范围：虽然特别面向 Trae CN，VS Code 用户同样可以使用，壁纸自带的音效 / 音乐也已支持。VS Code 默认禁止无手势的有声自动播放，扩展会自动放宽其主窗口的
autoplayPolicy；安装或升级后需要完全退出 VS Code 再重新打开一次才会生效（0.2.14 已在 VS Code 实测：完全退出重启后壁纸音效正常出声，只重载窗口不出声）。
- 与通用版的差异：支持播放壁纸自带的背景音乐（视频音轨 / 场景音效，可静音、可调音量）；状态同步更快，会记住上次可用端口，减少重复注入和「重载窗口」提示。与市场上已发布的 0.2.11 相比，核心新增就是播放背景音乐的功能。
- 下载来源：以 GitHub Releases 里的
*.vsix 为准。Open VSX 与 Releases 包使用同一个扩展 ID，市场页面更新可能滞后；版本不一致时以 Releases 为准。
- 免责声明：本扩展通过修改 IDE 的
workbench.html（VS Code 下还会修改主进程的自动播放策略）实现背景与音频效果，属于非官方实现，可能触发「安装似乎损坏」等完整性提示，使用前请自行评估风险。本扩展与 Trae、Steam、Wallpaper Engine 均无隶属或合作关系；壁纸及音乐版权归原作者所有。
功能特性
- 壁纸面板：点击状态栏右侧的「壁纸」按钮即可打开，顶部显示当前壁纸（缩略图、标题、类型、播放状态），支持暂停 / 刷新 / 清除。
- 缩略图网格：按「视频 / 场景 / 网页 / 图片」筛选，支持关键词搜索，点一下就切换。
- 外部导入：可把任意本地视频、动图、图片当作壁纸，不复制文件，只记录路径；导入项右上角
× 可移除（不会删除源文件）。
- 视觉调节：不透明度、压暗层、模糊、饱和度、缩放方式（铺满 / 完整 / 拉伸）实时生效。
- 播放控制：场景 / 网页壁纸帧率 1–144 可调（滑块拖动或直接输入数字）；窗口失焦时自动暂停以省电。
- 背景音乐：播放视频音轨与场景 / 网页壁纸音效，可一键静音并实时调节音量（0–100%）；系统拒绝有声自动播放时自动退回静音，画面不受影响。VS Code 下需按「安装」第 3 步完全退出重启一次，仅重载窗口不会生效。
- 自动探测 Steam 库：读取注册表与
libraryfolders.vdf，多磁盘库也能找到；也可手动指定 Steam 目录。
- 多窗口共用：第一个窗口启动本地渲染服务，其它窗口自动复用；服务消失后会自动接管。
- 可完整还原：面板底部「移除注入」会把
workbench.html 逐字节还原到注入前状态。
环境要求
- Windows（Steam 探测依赖注册表）
- Trae CN 或 VS Code 1.82 及以上（桌面版）
- 已安装 Steam 与 Wallpaper Engine，并订阅了至少一个壁纸（或直接使用本地导入）
- 可选：系统
ffmpeg（外部导入的视频没有封面图时，用它抽首帧当缩略图；未安装则该卡片不显示封面，不影响播放）
安装
说明：Trae CN 使用自建市场、VS Code 使用官方市场，这两个市场都不收录本扩展；想从市场直接安装请使用 Open VSX（见方式三），其它情况按方式一 / 方式二装 vsix。
方式一：下载 vsix 安装（推荐，Trae CN 与 VS Code 通用）
- 到 Releases 下载
background-wallpaper-engine-0.2.14.vsix；
- 打开 IDE 的扩展面板，点右上角
··· → 从 VSIX 安装，选中刚下载的文件（也可以直接把 vsix 拖进扩展面板）；
- 完全退出 IDE 再重新打开（不是重载窗口），让扩展完成首次注入。
方式二：命令行安装
# Trae CN
& "D:\trae\Trae CN\bin\trae-cn.cmd" --install-extension background-wallpaper-engine-0.2.14.vsix --force
# VS Code
code --install-extension background-wallpaper-engine-0.2.14.vsix --force
方式三：Open VSX（VSCodium / Theia / code-server / Gitpod）
这些编辑器的扩展市场默认走 Open VSX，可以直接搜 tisakonicc，或打开 Open VSX 商店页 安装。
使用
- 点击状态栏右下角的
壁纸 按钮（或按 Ctrl+Shift+P 执行「打开壁纸面板」）。
- 在「壁纸」标签页挑选缩略图，背景立即切换。
- 「外观」「播放」标签页里的滑块可以直接微调观感。
- 想用本地文件：点「导入…」，选择视频或图片，导入后会直接应用。
状态栏的 背景：开 / 关 按钮可以快速暂停或恢复显示，不会撤销注入。
支持的类型
| 类型 |
说明 |
| video |
.mp4 .webm .mov .m4v（.mkv 因 Chromium 不支持 Matroska 会黑屏，未纳入） |
| image |
.gif .apng .webp 以及导入的 .png .jpg .jpeg .bmp .avif |
| web |
壁纸目录中的 index.html |
| scene |
通过 WebGL 运行时（webwallgl）渲染的场景壁纸 |
场景壁纸由第三方运行时解释执行，复杂着色器可能存在兼容性问题；遇到无法渲染的场景壁纸建议换用视频版本。
配置项
| 配置 |
默认 |
说明 |
backgroundWallpaperEngine.enabled |
true |
是否显示背景 |
backgroundWallpaperEngine.wallpaperId |
空 |
当前壁纸 ID（由面板写入，无需手改） |
backgroundWallpaperEngine.steamRoot |
空 |
Steam 安装目录，留空自动探测 |
backgroundWallpaperEngine.opacity |
0.45 |
壁纸不透明度 |
backgroundWallpaperEngine.scrim |
0.45 |
壁纸与 UI 之间的压暗层，保证文字可读 |
backgroundWallpaperEngine.blur |
0 |
模糊半径（0–40 px） |
backgroundWallpaperEngine.saturate |
1 |
饱和度（0 为灰度，最大 3） |
backgroundWallpaperEngine.fit |
cover |
cover / contain / fill |
backgroundWallpaperEngine.fps |
60 |
场景 / 网页壁纸帧率（1–144） |
backgroundWallpaperEngine.muted |
false |
静音壁纸自带背景音乐 |
backgroundWallpaperEngine.volume |
0.6 |
背景音乐音量（0–1） |
backgroundWallpaperEngine.pauseOnBlur |
true |
失焦暂停播放 |
关于“安装似乎损坏”
IDE 会在启动时校验 workbench.html 的哈希，注入背景层后就会提示“安装似乎损坏”。本扩展的处理方式是：从 product.json 的 checksums 中移除 workbench.html 这一项，让该文件不再参与完整性校验。
- 这一操作只影响这一个文件，其余校验项保持不变；
- 校验清单只在 IDE 启动时读取，所以注入后的第一次启动可能仍会提示一次，完全退出再打开后即永久消失；
- 点「移除注入」时会把校验项按还原后的真实内容补回；
- IDE 自身升级覆盖安装目录后，扩展会在下次启动时自动重新注入并再次脱钩。
隐私与安全
- 本地 HTTP 服务只监听
127.0.0.1，端口为 32123–32128，不对外网开放；
- 不收集、不上传任何数据，不访问网络（除加载本机壁纸文件）；
- 只读取 Steam 壁纸目录与导入的文件，不修改、不复制、不删除它们；
- 浏览器的同源限制 + 目录越权检查（403）确保导入项只能读取自己那个文件。
卸载与还原
- 打开面板 → 底部「移除注入」，把
workbench.html 还原；
- 完全退出 IDE；
- 在扩展页卸载本扩展。
还原的备份文件位于 resources/app/out/vs/code/electron-browser/workbench/ 下，形如 workbench.html.backgroundcover-<哈希>.bak。
致谢
| |
