Repository navigation
Releases
0.218.0
状态栏现在会报实际帧率。场景由 Metal 绘制时,后面再带上每帧 GPU 时间和 GPU 占用率,三秒刷新一次。调画质、比较档位,终于有数字可看。
这行读数也让一件事露了出来:工坊里那两张 3D 场景在这台 M4 上只有 18–25 帧(默认帧率上限 60)。原因是这两张壁纸目前走 OpenGL 回退路径,还没接到 Metal 上。
这一版没有改渲染路径,画面行为和 0.217.1 一致。
安装
下载 Wallpaper-Engine-Native-0.218.0-arm64.dmg,拖进「应用程序」,右键点图标选「打开」。没做公证,Gatekeeper 只拦这一次。
sha256 a81947499878eaa441c635233cdb35a05dd5a9f6a2ff7b53fdf00158f2ab95e3
顺带
- 新增
docs/comparison-wallpapermachine.md:和 WallpaperMachine 的逐项对照,GPU 与功能两轴,带实测数据与下一步排序。 - 已知限制没变:Apple Silicon、macOS 14 起;复杂 Scene 的部分脚本、粒子、特效会降级;ad-hoc 签名未公证。
v0.217.1 — 支持 PKGV0024 打包的 Scene 壁纸
0.217.1 修掉一个装不上的壁纸:Unsupported Scene package version: PKGV0024。
问题
创意工坊里用 PKGV0024 打包的 Scene 壁纸(例如 3832644652 Ender Kirua Sky)一律被拒,整个壁纸加载不起来,只报一行版本不支持。
原因
Scene 打包格式的版本号走白名单,0024 是这次新出现的,白名单里没有。实际去看那个 scene.pkg:版本号前缀 + u32 条目数,然后每条 (路径, u32 偏移, u32 长度),表后紧跟数据——和已支持的版本一字不差。102 个条目无缝铺满、没有空洞也没有重叠,内部纹理仍是 TEXV0005/TEXI0001。
所以这一版把 0024 加进白名单。路径安全、越界、重叠这些结构校验一行没动,不是放松解析,只是认了这个版本号。
顺带把拒绝信息改成会把「目前认识的版本」列出来,下次再撞到新格式,报告里直接能看出差在哪。
验证
用编出来的 app 直接跑那张壁纸:
Scene loaded: Ender Kirua Sky (Hunter × Hunter) WUHD (4K), 18 draw groups, GPU Apple M4
18 个 draw group 全部加载,预览窗口截图里人物、星空、云层、前景草叶都在,没有黑块或缺图层。
说明
- 需要 Apple Silicon、macOS 14 起。Intel Mac 跑不了。
- ad-hoc 签名,没有 Developer ID,也没做公证。第一次打开右键「打开」,或者
xattr -d com.apple.quarantine "/Applications/Wallpaper Engine Native.app"。 - 单测覆盖的仍是 Steam 订阅/投票/收藏和本地副本回收;Scene 解析目前只有这种手动实测,没有自动测试。
校验
8f23e51a5f82f57d92b68276e63b81a19613d18b26d6cf38e258db8c309f106e Wallpaper-Engine-Native-0.217.1-arm64.dmg
v0.217.0 — 清理未订阅副本,检查与发布流程补齐
0.217.0 加了一个能收拾硬盘的入口,顺手把检查和发布流程补齐。
清理未订阅的壁纸副本
从创意工坊下的壁纸会留一份本机副本,退订之后它一直躺着。本机实测:18 份副本、1.4 GB,其中 10 项已经退订且没人引用,占 102.8 MB。之前没有任何入口能把它们清掉。
现在状态栏菜单(或应用菜单)有「清理未订阅的壁纸副本…」。它会先问 Steam 要当前订阅列表,再看显示器分配、配置、播放列表、应用规则有没有还指着这些副本,最后把能删的列出来等你点头。取消就一份都不动。
判定的几条底线:
- Steam 没给订阅列表(没登录、掉线、helper 没起来),一份都不删,只弹个提示。
- 被显示器分配、配置、播放列表、应用规则引用的副本保留。宁可留着,不猜。
- 只认
SavedWorkshop/<十进制 id>/<小写 uuid>这种结构、且属主是当前用户的目录;软链和越界路径一律拒绝。
命令行同一个逻辑,默认试运行:
xcrun swiftc -O native/Sources/WallpaperEngineNativeHost/SavedWorkshopReclaim.swift \
tools/reclaim_saved_workshop.swift -o /tmp/we-reclaim
/tmp/we-reclaim --helper synchronizer/build/we-workshop # 只报告
/tmp/we-reclaim --helper synchronizer/build/we-workshop --apply # 真删检查与发布
- 每次 push 和 PR 都会在 arm64 runner 上跑四套检查再全量编译一次:
.github/run_native_checks.sh本地可跑同一套命令,四套共 160 项。 - 新增
SavedWorkshopReclaimChecks24 项,在 TMPDIR 里造假壁纸库,覆盖扫描、判定和删除,确认越界目录、软链、非规范 id 全部被拒。 tools/package_dmg.sh:打 dmg 并挂载回读校验版本号和 Applications 软链,不再靠手工。- 三套 Steam 检查的脚本在 git 里补上了执行权限(之前 README 那条命令会 Permission denied)。
说明
- 需要 Apple Silicon、macOS 14 起。Intel Mac 跑不了。
- ad-hoc 签名,没有 Developer ID,也没做公证。第一次打开右键「打开」,或者
xattr -d com.apple.quarantine "/Applications/Wallpaper Engine Native.app"。 - 手上只有单屏环境。多屏热插拔、睡眠唤醒、跨 Space 依旧没在别的机器上验证过。
校验
7a37d5cf780697512317fcf04b2d55592b16ac6ea600ad48597abaaff328f1fa Wallpaper-Engine-Native-0.217.0-arm64.dmg
v0.216.1 — Steam 接口版本漂移与壁纸切换修复
0.216.1 修了两个问题:Steam 连不上创意工坊,以及选了壁纸桌面不变。
Steam 连不上创意工坊
Steam 客户端 11 月 13 日更新后,libsteam_api.dylib 把 SteamUser 接口从 v023 换到了 v024,旧的导出符号被删掉。代码里原来写死 SteamAPI_SteamUser_v023,dlsym 直接失败:
{"error":"Installed Steam API lacks SteamAPI_SteamUser_v023","status":"unconfirmed"}
订阅同步、浏览、下载、投票、收藏就一起挂了。现在改成列出这份 dylib 里实际导出的版本号,从新往旧试,SteamUGC、SteamUtils、SteamApps 同样处理,Steam 下次升级不用再改代码。本机实测恢复 9 项订阅。
选了壁纸不生效
0.215 加了逐显示器分配以后,在主库里手动点一张壁纸只更新了 lastProject,屏幕上那份分配还留着,桌面继续播旧的那张。
现在手动选默认壁纸时会把已连接屏幕的分配一并清掉,布局和画面在同一个提交里写下去;拔掉的显示器条目保留,插回来还认原来的壁纸。
顺带
补完了 0.216 源码里没写完的截屏请求重构(NativeDesktopWallpaperScreenshotRequest),./native/build.sh 现在能从仓库源码完整编译。
说明
- 需要 Apple Silicon、macOS 14 起。
- ad-hoc 签名,没有 Developer ID,也没做公证。Gatekeeper 会拦,第一次打开右键「打开」,或者
xattr -d com.apple.quarantine "/Applications/Wallpaper Engine Native.app"。 - 手上只验证了单屏。多屏热插拔、睡眠唤醒、跨 Space 还没在别的机器上跑过。
校验
46b3dabfa634cf653dc933f9dc247f5162ea736c84ca25f67895c022cac3e21a Wallpaper-Engine-Native-0.216.1-arm64.dmg
1f5c75288a844388359702f3c66603a150398c8da31668e2b43d0fd0d242a6ef Wallpaper-Engine-Native-0.216.1-macOS-arm64.zip
v0.216.0 — macOS 实验版
首个公开测试版:独立开发的 macOS 原生动态壁纸兼容研究项目,与 Wallpaper Engine、Steam、Valve 及其开发者没有隶属或认可关系。
下载和安装
- 下载
Wallpaper-Engine-Native-0.216.0-arm64-experimental.dmg,打开后将应用拖入 Applications。 - 系统要求:Apple Silicon Mac,macOS 14 或更高版本;不支持 Intel Mac。
- 此构建仅使用 ad-hoc 签名,没有 Developer ID 签名,也没有 Apple 公证。Gatekeeper 可能阻止首次打开。请先确认下载来源与文件哈希,再参考 Apple 的说明 自行决定是否在“系统设置 → 隐私与安全性”中允许打开。
- DMG SHA-256:
57c793ce046345f9493f8658ecacd21c8b315635d5445e403b5ee054c991df6a
范围和限制
包含实验性的原生图形界面、桌面壁纸播放与 Scene、Web、视频支持,以及三张项目自制演示壁纸。工坊兼容、复杂脚本、特效、多屏、桌面合成和 Windows 界面一致性仍在开发中;不承诺所有壁纸可用或 1:1 还原。
本项目不包含 Steam、Wallpaper Engine 的官方二进制或 Workshop 内容;使用个人安装与订阅内容时需要自行具备相应合法授权。项目源码与本次应用包的 249 个构建输入已逐项核对一致;独立源码构建及离屏 GUI/GPU 检查通过。该包尚未在另一台干净 Mac 上验证,也未完成 Apple 公证。