壁纸静态原图提取 rmyou/wallpaper-engine-static

wallpaper-engine-static

一个 DeepSeek Harness skill，用于把 Wallpaper Engine 动态壁纸里的静态原图提取出来，这样你就可以把它当作普通桌面壁纸使用，不必让 Wallpaper Engine 一直挂在后台运行。

Wallpaper Engine 的 Scene 类壁纸本质是一个 .pkg 压缩包。作者使用的那张图以全分辨率 PNG 或 JPEG 的形式存放在包里，后面跟着它的 mip 链，以及给着色器采样的压缩副本。这个 skill 会找出其中最大的原始图像并逐字节导出 —— 不重新编码、不放大、不损失画质。

wallpaper-engine-static/
├── SKILL.md
└── scripts/
└── extract_static.py

安装

直接克隆到你的用户级 skill 目录：

Windows
git clone https://github.com/rmyou/wallpaper-engine-static "$env:USERPROFILE\.dsh\skills\wallpaper-engine-static"

macOS / Linux
git clone https://github.com/rmyou/wallpaper-engine-static ~/.dsh/skills/wallpaper-engine-static

不想用 git 的话，手工放两个文件也可以：

mkdir "$env:USERPROFILE\.dsh\skills\wallpaper-engine-static\scripts" -Force
然后把 SKILL.md 放到目录根部，extract_static.py 放到 scripts\ 下

重启 DSH 会话后，wallpaper-engine-static 就会出现在 skill 列表里。

也支持项目级安装 —— 放到 <项目>/.dsh/skills/ 下即可，优先级高于用户级副本。

使用

在 Wallpaper Engine 里右键点击已安装的壁纸，选择 在资源管理器中打开，把打开的文件夹路径传给脚本：

python scripts/extract_static.py "<壁纸文件夹>" -o "<输出文件夹>"

脚本也接受 .pkg 文件路径，或者纯 workshop id（它会读取 libraryfolders.vdf 自动发现你的 Steam 库位置，所以没有硬编码任何路径）：

python scripts/extract_static.py 3730433720

| 参数 | 作用 |
| -o DIR | 输出文件夹（默认 ./wallpaper_static） |
| --list | 只列出候选纹理及其尺寸，不导出 |
| --top N | 额外导出次大的 N 张图（默认只导出 1 张） |
| --keep-masks | 不再对遮罩/特效纹理降权 |

需要 Python 3.8+。Pillow 是可选的 —— 只有极少数纹理只以 LZ4 压缩的 BC1/BC3 块形式存在时才需要它。内嵌的 PNG/JPEG 载荷是直接原样拷出来的，不需要任何解码器。

实现原理

三个细节决定了解析 pkg 的结果是一张壁纸还是一堆乱码：

1. 目录表里的偏移量是相对于目录表末尾的，不是相对文件开头。这一点搞错，后面每一条记录都会错位。
2. TEXB 头部布局并不稳定。 TEXB0003 和 TEXB0004 的字段排布不同，而在实测的 143 个纹理里有 137 个是 0003。按固定偏移解析字段会静默得出错误的尺寸。扫描 PNG/JPEG 魔术字节与版本无关，在测试过的所有壁纸上都有效。
3. TEXI 里的宽高是补齐后的画布尺寸，不是图片尺寸。 一个纹理可以声明 8192×4096，实际只装了 4099×2562 的图。所以 TEXI 只被当作上界用来排除像素数据里的假魔术字节，绝不直接作为结果。

排序依据是真实像素面积，同时对 masks/、effects/、particles/ 等工具纹理降权，面积相同时以字节数为准 —— 一个 9 KB 的「1920×1080」条目是空图层，不是壁纸。

验证结果

在真实 Steam 库中的 17 个 Scene 壁纸和 15 个 Video/Web 壁纸上测试，17/17 全部提取出有效图像：

| 壁纸 | 输出 |
| 雨骑-重置版-2k | 2560×1440 PNG，7.06 MB |
| 赛博color-水墨三玄色-绿动 | 5824×3264 PNG，20.2 MB |
| Black Hole 2 | 7680×2176 PNG（LZ4 + BC 解码） |
| Elaina (X-Ray) | 4950×7875 JPEG，14.9 MB |
| [Azur Lane-Anchorage] | 5504×2851 JPEG |
| 另外 12 个 | 1920×1080 … 8192×1536 |

局限

- 只有背景层。 动态叠加元素 —— 雨滴、车窗框、时钟、音频条、粒子贴图 —— 都是独立的纹理，不会被合成进来。如果某个壁纸的背景被前景层遮盖得比较多，提取结果和实际动态画面会有差异。
- Video 类壁纸没有 .pkg。 画面就是一个 .mp4；脚本会打印一条 ffmpeg 抽帧命令，在没有 ffmpeg 时回退到 preview.jpg。
- Web 类壁纸根本没有图片。 preview.jpg 是唯一的静态图。
- Scene 壁纸旁边的 preview.jpg 是压缩过的创意工坊缩略图，绝不会被当作提取结果输出。

许可

MIT