Overview Version History Q & A Rating & Review
VS Code - Background Cover
让你喜欢的图片或视频铺满 VS Code,支持粒子动画、热更新、视频背景、自动轮播等丰富特性
🚀 3.5.3 主要更新
🐛 修复更新后需手动重启才生效 :VS Code 更新后应用背景补丁,现在会引导完全退出并重启(软重载无法清除核心界面的编译缓存)。
🐛 修复新版 VS Code 下背景不显示 :适配较新 VS Code 的 Trusted Types 安全策略,重构脚本注入方式,修复打补丁后背景 / 宠物 / 粒子不显示的问题。
🖥️ 适配 Cursor Agent Window :支持 Cursor 的 Agent Window(Glass 窗口)背景显示(#214 by @Aierlanta)。
✨ 切换体验优化 :仅切换图片时保留宠物与粒子状态;装饰面板「重启生效」按钮移到顶部。
🌟 功能特性
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.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)。
ver 3.5.1 (2026/05/25)
修复自动随机更换背景时遇到大体积本地图片会弹出确认提示并阻断轮播的问题。
修复 VS Code 更新后重新应用背景的提示文案仍显示 3.0 版本信息的问题。
修复 VS Code 更新后点击确认重新应用背景时未正确触发窗口重载的问题。
致谢
贡献者
默认展示所有贡献者,如需移除请提交 PR。
相关信息
赞助作者
如果插件对你有帮助,欢迎请作者喝杯咖啡~
📄 许可证
本项目采用 MIT 许可证 进行许可。