VS Code - Background Cover

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

Background Cover Studio preview

🚀 3.7.1 主要更新

🎬 修复新版 VS Code 视频背景：Electron 43+ / Chromium 150 因 CSP 收紧导致视频无法播放，改为「vscode-file: 资源转 blob 播放 + 自动放行内核 CSP 的 blob: data: 媒体源」，安装/卸载自动打补丁与还原（含 Agent Sessions 独立窗口）。
🔄 修复在线随机图自动轮播失效：旧目录配置不再阻断在线源轮换，在线单图只在仍启用时参与轮换，并恢复「在线记录缺失 → 定时刷新」的启动兜底。
🪟 多窗口独立模式状态隔离：定时自动换图只更新当前窗口内存态，不再回写全局记录串扰其他窗口。
📋 新增「Background Cover」输出通道：自动换图、恢复、清理等关键事件可查看诊断日志。

🌟 功能特性

Studio 配置面板：首页、本地图库、在线图库、高级设置、装饰效果集中管理。
界面主题：支持默认主题和守望主题，可在面板右上角切换。
顶部小宠物：内置多款可爱宠物，支持同步 ~/.codex/pets / CODEX_HOME/pets 中的 Codex 宠物，并可自定义多行冒泡文案。
图片/视频背景：支持本地图片、网络图片、本地视频、在线视频；本地路径支持 ~、${ENV}、$ENV 变量和文件夹（自动随机取一张）。
热更新：切换背景即刻生效，无需重启 VS Code。
多窗口独立背景：每个窗口可显示各自的背景图，也可切回全部窗口共用。
AgentView 支持：支持 VS Code AgentView / Agent Sessions 独立窗口背景显示。
自动轮播：多张图片/视频可定时自动切换，换图前预加载 + 淡入淡出过渡，不再闪烁。
粒子动画：集成鼠标跟随粒子特效，支持数量、透明度、预设颜色、自定义颜色和帧率上限（高刷屏可降低 GPU 占用）。
在线缓存管理：在线图片自动缓存到本地并去重，可设置缓存上限，超出后自动清理最旧的文件。
本地图库：支持文件夹图片预览、最近使用记录、分页浏览和拖拽设置背景。
在线入口：在线页顶部支持输入 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.7.1 (2026/09/29)

修复新版 VS Code 视频背景失效：内核 CSP 收紧后 media-src 不再放行 blob/data，改为「vscode-file: 视频转 blob 对象 URL 播放」，并在安装/卸载时自动补丁/还原内核 HTML 的 CSP blob: data: 媒体源。
修复自动随机在线图片不换图：本地随机目录配置不再阻断在线源轮换，在线单图源仅在仍启用时参与轮换（#237 by @Aierlanta）。
修复在线源记录缺失时重启不再自动刷新：恢复「启动时记录缺失 → 定时刷新」兜底。
多窗口独立背景模式：定时自动换图仅更新当前窗口内存态，不再回写全局记录，窗口状态互相隔离。
新增「Background Cover」输出通道：自动换图/恢复/清理等关键事件输出诊断日志。

ver 3.7.0 (2026/09/12)

新增补丁状态自检：按实际内核文件内容判定补丁状态（缺失/旧版/最新），VS Code 同版本重装、手动还原 workbench 文件等场景会自动提示重新应用（借鉴 shalldie/vscode-background 的补丁状态机）。
「安装似乎损坏」校验和提示自动屏蔽：内置 16 种语言匹配规则，首次安装/更新不再需要手动点「不再提示」。
混合模式 auto 改为纯 CSS 变量 + :has() 主题感知：切换深浅主题即时生效，不再弹窗确认 + 重载窗口。
背景源支持 ~ / ${ENV} / $ENV 路径变量与文件夹（自动递归扫描随机取图）。
换图预加载 + 淡入淡出过渡动画（新增「过渡动画」开关，默认开；尊重系统「减少动态效果」）。
修复 backgroundCover.blendModel 默认值不在枚举内的问题（cover → auto）。