Repository navigation
v0.2.2 and v0.8.0
本次发布包含两个产物
| IDE | 产物 | 版本 |
|---|---|---|
| Trae CN / VS Code | background-wallpaper-engine-0.2.2.vsix |
0.2.2 |
| PyCharm 2024.1 | background-wallpaper-engine-0.8.0.zip |
0.8.0 |
两个产物版本号各自独立:扩展这次只更新了元数据,插件是重写后的新版本。
PyCharm 插件 v0.8.0
把 Wallpaper Engine 的壁纸铺到整个 IDE 窗口——项目树、工具栏、编辑器、状态栏都能透出背景,代码正常显示在上面。
怎么做的
用平台自带的背景图机制 IdeBackgroundUtil.createTemporaryBackgroundTransform(),由 IDEA 自己把界面内容按透明度绘制。不修改任何组件的 opaque 或背景色,背景挂在 Disposable 上——禁用插件或卸载时 dispose 即完全还原(实测禁用前后像素差异 0.02%)。
面板里的调节项(拖动即时生效)
- 不透明度:壁纸透出多少
- 背景虚化:0~60 像素,柔化细节
- 代码区压暗:只压暗代码所在区域,项目树的壁纸照常透出
- 水平位置:0~100,把画面左右挪动
- 填充方式:适应窗口(完整显示)/ 铺满窗口(裁掉边缘)/ 拉伸
兼容性声明
与 Material Theme UI(完整版)存在冲突,请不要同时启用。
Material Theme UI 会接管界面背景与组件绘制的控制权,覆盖本插件的背景层。冲突表现:
- 壁纸不显示,或只在部分区域显示
- 壁纸被主题的深色底整块盖住
- 切换壁纸或改参数后界面闪烁
已在 Material Theme UI 9.3.1 上确认。处理方式二选一:禁用 Material Theme UI,或在「壁纸」面板里关闭壁纸。
Material Theme UI Lite 只调整配色、不接管组件绘制,理论上影响更小,但未逐一验证。
已知限制
- 只能显示静态画面:平台的背景变换在创建时就把图像快照了,替换内容不会刷新。视频 / 场景 / 网页类壁纸统一取其预览帧。
- 首次使用如提示需要重启,重启一次即可(离屏渲染注册表项需要重启生效)。
安装
- 下载
background-wallpaper-engine-0.8.0.zip 设置 → 插件 → ⚙ → 从磁盘安装插件…- 选择这个 zip,重启 IDE
要求 PyCharm 2024.1(build 241)。安装后在右侧「壁纸」工具窗口选壁纸、调参数。
校验
- 文件:
background-wallpaper-engine-0.8.0.zip,58,182 字节 - SHA-256:
e5cbb1a3c7ef16820cdad8f8c97c06a8cc0d160f09a641173b8b3c005d7f1894
Trae CN / VS Code 扩展 v0.2.2
元数据更新,代码与 0.2.1 完全一致(逐文件哈希比对)。正在用 0.2.1 的可以跳过,不会有任何功能差异。
改了什么
- 显示名
Background-Wallpaper-Engine→Background Wallpaper Engine,界面里不再是带连字符的名字 - 搜索关键词 7 → 12:新增
wallpaper-engine、vscode-background、ide background、video wallpaper、trae - 补全
repository/homepage/bugs,详情页的仓库链接现在可用 - 修正
extension.vsixmanifest中的 Publisher,与package.json的tisakonicc保持一致
安装(Trae CN 与 VS Code 通用)
- 下载
background-wallpaper-engine-0.2.2.vsix - 扩展面板右上角
…→ 从 VSIX 安装 - 完全退出 IDE 再打开
Trae CN 扩展市场与 VS Code 官方市场均不收录本扩展,搜名字搜不到。
Open VSX 生态(VSCodium / Theia / code-server)可直接搜tisakonicc。
校验
- 文件:
background-wallpaper-engine-0.2.2.vsix,406,914 字节 - SHA-256:
898dd1d4ed502edbccc8231456aca75da7542d1bdf6a4952639d8935c120adfd
English
This release ships two packages with independent version numbers:
| IDE | Asset | Version |
|---|---|---|
| Trae CN / VS Code | background-wallpaper-engine-0.2.2.vsix |
0.2.2 |
| PyCharm 2024.1 | background-wallpaper-engine-0.8.0.zip |
0.8.0 |
PyCharm plugin 0.8.0
Full-window wallpaper behind the whole IDE, built on the platform's own IdeBackgroundUtil.
No component properties are modified; the background lives on a Disposable, so disabling the
plugin restores the UI exactly (measured pixel diff 0.02%).
Panel controls, all applied live: opacity, blur, editor-area scrim, horizontal position, fit mode.
Compatibility notice — conflicts with Material Theme UI (full version). Do not enable both.
Material Theme UI takes over window background and component painting, which covers the wallpaper
layer: the wallpaper may not show, show only partially, or be fully hidden behind the theme's dark
background. Confirmed on Material Theme UI 9.3.1. Workaround: disable one of them.
Material Theme UI Lite only changes colors and does not take over component painting, so it is
likely unaffected, but this has not been verified individually.
Limitation — static images only: the platform snapshots the image when the transform is created,
so replacing its contents does not refresh. Video / scene / web wallpapers fall back to their preview
frame.
Install — Settings → Plugins → ⚙ → Install Plugin from Disk… → select the zip → restart.
Requires PyCharm 2024.1 (build 241).
VS Code extension 0.2.2
Metadata-only; code identical to 0.2.1 (verified file by file). No functional change — nothing to
upgrade if you already run 0.2.1.
- Display name
Background-Wallpaper-Engine→Background Wallpaper Engine - Keywords 7 → 12 (added
wallpaper-engine,vscode-background,ide background,video wallpaper,trae) - Added
repository/homepage/bugs - Fixed the publisher in
extension.vsixmanifestto matchpackage.json(tisakonicc)
Install — download the .vsix, then Extensions → … → Install from VSIX, and fully restart the
IDE. Not listed on the Trae CN or VS Code marketplaces; search tisakonicc on Open VSX.