VS Code - Background Cover

让你喜欢的图片或视频铺满 VS Code，支持粒子动画、热更新、视频背景、自动轮播等丰富特性

Background Cover Studio preview

🚀 3.6.1 主要更新

🎨 透明度/模糊度按窗口独立：每个工作区可各自保存并显示不同的透明度与模糊度数值，在一个窗口调透明度/模糊度不再把其他窗口的数值刷成同一个（webview 滑块与树视图均展示当前窗口实际生效的值）。
🧹 设置更干净：独立模式下透明度/模糊度不再回写全局 settings.json，避免多窗口串值；切回「全部窗口共用」后恢复全局共享行为，老用户 settings.json 里的旧值继续作为兜底。

🌟 功能特性

Studio 配置面板：首页、本地图库、在线图库、高级设置、装饰效果集中管理。
界面主题：支持默认主题和守望主题，可在面板右上角切换。
顶部小宠物：内置多款可爱宠物，支持同步 ~/.codex/pets / CODEX_HOME/pets 中的 Codex 宠物，并可自定义多行冒泡文案。
图片/视频背景：支持本地图片、网络图片、本地视频、在线视频。
热更新：切换背景即刻生效，无需重启 VS Code。
多窗口独立背景：每个窗口可显示各自的背景图，也可切回全部窗口共用。
AgentView 支持：支持 VS Code AgentView / Agent Sessions 独立窗口背景显示。
自动轮播：多张图片/视频可定时自动切换。
粒子动画：集成鼠标跟随粒子特效，支持数量、透明度、预设颜色和自定义颜色。
本地图库：支持文件夹图片预览、最近使用记录、分页浏览和拖拽设置背景。
在线入口：在线页顶部支持输入 URL、刷新在线图库和浏览器打开社区图库。
可视化配置：左侧 Studio 面板一键设置，支持中英双语。
透明度/模糊/填充模式：自定义背景透明度、模糊度、填充方式；多窗口模式下每个工作区可各自独立设置透明度与模糊度。
高级解析：支持 JSON API、静态 HTML、图库帖子等多种图片源。
在线图库：内置社区壁纸浏览、上传与一键应用。
跨平台支持：兼容 Windows、MacOS、Linux 及 Code-Server。
自动权限处理：Windows 下自动获取写入权限，无需手动操作。

⚠️ 注意事项

本插件通过修改 VS Code 内部文件实现效果。

首次使用/升级到 3.x：需重新获取权限（Hook），并重启一次 VS Code。
初次安装/更新：如遇“安装损坏”提示，请点击【不再提示】。
背景重叠/异常：升级后如遇背景重叠，请重启 VS Code。
还原方法：如 VS Code 无法打开，请手动还原：
- 路径：Microsoft VS Code\resources\app\out\vs\workbench\
- 将 workbench.desktop.main.js.bak 重命名为 workbench.desktop.main.js

🖼️ 效果展示

在线图库/更多壁纸

⚙️ 配置方式

推荐：点击左侧活动栏的 Background Cover 图标，打开可视化配置面板，所有设置一目了然。

图片/视频源：支持本地文件、文件夹、网络链接。
外观：调整透明度、模糊度、填充模式。
在线：输入 URL、浏览在线图库、刷新社区图库。
装饰：配置粒子特效、顶部小宠物、Codex 宠物同步和宠物冒泡文案。
高级：配置自动轮播、混合模式和缓存目录。

也可通过命令面板 Ctrl + Shift + P -> backgroundCover - start 进入设置

📝 快捷键与使用

切换背景：点击底部状态栏按钮
打开/配置：Ctrl + Shift + P -> backgroundCover - start
重新应用：VS Code 更新后如背景消失，请重新设置

首次升级到 3.x 必须重新授权并重启 VS Code 才能生效！

🗑️ 卸载说明

禁用/卸载插件
重启 VS Code
插件会自动清理残留背景

❓ 常见问题

Q: 安装后无反应？ A: 请确保有管理员权限（右键 VS Code 图标 -> 以管理员身份运行）。

Q: Mac 如何授权？ A: 插件会自动请求密码，或手动 sudo chown 相关文件。

📝 更新日志

完整日志

ver 3.6.1 (2026/08/18)

修复多窗口独立背景模式下，透明度 / 模糊度仍按全局设置共享的问题：每个窗口（工作区）可各自保存并显示不同的透明度与模糊度数值，webview 滑块、树视图与设置面板均展示当前窗口实际生效的值（独立模式下不再回写全局 settings.json；切回「全部窗口共用」后恢复全局共享行为）。

ver 3.6.0 (2026/08/14)

新增多窗口独立背景，每个窗口可显示各自的背景图（可在高级设置中切回全部窗口共用）（#226 by @Aierlanta）。
优化多窗口授权体验，新开窗口不再反复弹出 UAC 授权窗口。
优化自动换图容错，网络失败会静默重试或换图，不再弹窗打断（#225 by @Aierlanta）。感谢 @Aierlanta 的贡献！

ver 3.5.3 (2026/07/06)

修复 VS Code 更新后背景不生效、必须手动关闭再重新打开才生效的问题（现代 VS Code 的核心界面编译缓存由主进程持有，软重载无法清除，现在会引导完全退出并重启）。
修复较新版本 VS Code 安全策略（Trusted Types）下打补丁后背景 / 宠物 / 粒子完全不显示的问题（注入方式重构为「稳定引导 + 外置动态脚本」）。
新增适配 Cursor Agent Window（Glass 窗口）背景显示，复用附加 bundle 机制自动打补丁与卸载还原（#214 by @Aierlanta）。
优化仅切换背景图片时不再重建装饰运行时，宠物位置与粒子状态得以保留。
装饰配置面板「重启生效」按钮移到顶部并优化提示文案。

ver 3.5.2 (2026/06/04)

修复新版本 VS Code（如 1.123.0）因 Node 移除 util.isObject，首次初始化报错 Failed to write CSS file: TypeError: Node.util.isObject is not a function 的问题（将 sudo-prompt 替换为官方维护的 @vscode/sudo-prompt）。