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

🚀 3.5.1 主要更新
- 🔄 自动轮播修复:自动随机更换背景遇到大体积本地图片时不再弹出确认提示阻断轮播。
- 🖼️ 手动选择保留保护:手动选择大图时仍会提示可能短暂卡顿,避免误操作。
- 🧩 VS Code 更新修复:VS Code 更新后重新应用背景的提示不再显示 3.0 旧版本信息。
- ⚡ 重载行为修复:点击确认重新应用背景后会等待补丁完成并正确触发窗口重载。
🌟 功能特性
- 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.1 (2026/05/25)
- 修复自动随机更换背景时遇到大体积本地图片会弹出确认提示并阻断轮播的问题。
- 修复 VS Code 更新后重新应用背景的提示文案仍显示 3.0 版本信息的问题。
- 修复 VS Code 更新后点击确认重新应用背景时未正确触发窗口重载的问题。
致谢
贡献者
默认展示所有贡献者,如需移除请提交 PR。

相关信息
赞助作者
如果插件对你有帮助,欢迎请作者喝杯咖啡~

📄 许可证
本项目采用 MIT 许可证 进行许可。
| |