Repository navigation
v1.2.0 — editable pixels and scoped AI workflows
中文说明(本页全文) · 中文版(独立页面) · English notes
v1.2.0 — PNG import, precise edits and component assembly
Create and edit pixel-art icons, sprites and UI from text specifications or short Python examples. Give individual images names in an atlas, or assemble separately drawn components into a scene. Output is PNG; Minecraft styling is optional.
Changes since v1.1.1
- Inspect image dimensions, colors, transparency, connected pixel regions and symmetry, or display a small region as a symbol grid. Reports cap the number of listed items to keep output manageable. Choose review backgrounds and reuse existing atlas layouts.
- Import static 8-bit PNGs without reducing colors, preserving RGB values even in fully transparent pixels. Import a whole image or select one named atlas cell after checking its layout. Replace that cell while keeping the other cells and layout unchanged.
- Compare exact RGBA values before and after an edit to check that changes stay inside allowed regions or masks. Assemble PNG components with explicit crops, permitted overlaps and required coverage; inspect seams in coordinate-labeled previews.
- Use editable Python examples for icons, button states, a 128×128 sprite and component scenes. A bridge example draws the left and right chunks separately, with plank patterns aligned across the join. Guides cover small edits, text inspection, visual review and checks in the actual game or application.
- If the filesystem cannot create hard links, set
PIXELART_PORTABLE_OUTPUT=1once in the terminal for subsequent commands and examples. Per-command options take priority. Overwriting existing files still requires explicit--force.
Compatibility and setup
Python 3.10+ and Pillow >=10.4,<13 are supported. requirements.txt pins Pillow 12.3.0 for reproducibility; the reference environment is Python 3.14.2 / Pillow 12.3.0. Runtime dependencies remain Python and Pillow.
JSON v1 and existing API/command defaults remain compatible. Drawing primitives overwrite RGBA; blits use source-over composition unless an explicit supported alternative is chosen. PNG round trips preserve decoded 8-bit RGBA, not necessarily compressed PNG bytes, layers or original drawing instructions. Animation and unsupported high-bit-depth inputs are rejected.
Extract the ZIP, install its requirements.txt in the task's Python environment, then run from the extracted parent directory:
python deterministic-pixel-art/scripts/pixel_art.py render --spec deterministic-pixel-art/assets/gem-16.json --out output/gem.png --preview output/gem-preview.png
python deterministic-pixel-art/scripts/pixel_art.py inspect --image output/gem.png --gridWhen updating a Skill, keep backups outside the folders the agent scans for Skills, so it does not load both copies. In portable-output mode, another program may read a new file before writing has finished. In any output mode, a program crash or power loss can leave a group of output files only partly updated. After an interruption, check that all expected files are present and complete before using them.
Evidence and limits
The v1.2.0 release passed 165 source tests, 106 isolated package tests and 43 reference-image checks. Repeated builds produced identical packages, and the Skill passed the official format validation. Of its 98 files, 97 match the accepted development package byte for byte; the remaining module changes only its version constant. verification.json records the release commit, its Windows/Ubuntu CI results and the package's source.
External trials cover eight task categories. Records retain LT04's original reversed direction and missing early revisions, and LT08's incomplete early history. These trials do not establish general improvements in image quality, task time or token use. Minecraft game integration, other fonts, artwork drawn directly at 512×512 and drawing by multiple agents remain unverified. Passing automated checks still leaves the image's meaning and appearance to be reviewed.
Distribution
Download attachments are deterministic-pixel-art-v1.2.0.zip, package-manifest.json, verification.json and SHA256SUMS.txt. English and Chinese notes are readable on the Release page. Check the ZIP's SHA-256 against SHA256SUMS.txt before extracting it. The ZIP contains the self-contained Skill, without project coordination records, Python virtual environments or the repository's demo font. MIT covers the code, original artwork and Skill; the repository-only Silkscreen font retains its separate SIL OFL 1.1 license.
2026-10-31 notes update: English and Chinese notes are now readable online, and their wording has been clarified. The two note attachments were removed. SHA256SUMS.txt lists only the ZIP, package manifest and verification record; those three files are unchanged.
2026-10-31 说明更新:中英文说明改为在线阅读,并修正文案。两份说明附件已移除;SHA256SUMS.txt 只列出 ZIP、包清单和验证记录,这三个文件没有变化。
中文说明
v1.2.0 — PNG 导入、局部修改与组件拼接
用 JSON 等文本规格文件或简短的 Python 示例脚本制作、修改像素图标、精灵和 UI;也可以将多张小图放进带名称的图集,或将独立绘制的组件拼成场景。输出为 PNG,Minecraft 风格可按需选用。
相对 v1.1.1 的变化
- 分析图片尺寸、用色、透明度、相连的像素区域和镜像差异,也可将局部像素显示为字符网格。报告限制逐项列出的数量,避免输出过长;检查图片时可指定背景,并复用已有图集布局。
- 无损导入静态 8 位 PNG:不减少颜色,保留全透明像素里的 RGB 值。可以导入整图,也可以按已核对的布局选取图集中某一格;替换这一格时,其余小图和布局不变。
- 核对图片修改前后的 RGBA 值,确认变化都在指定区域或蒙版内。拼接 PNG 组件时,可明确指定裁切范围、允许的重叠和必须填满的区域,并用带坐标的预览检查接缝。
- 附带图标、按钮状态、128×128 像素精灵和组件场景的示例脚本;另有左右两块独立绘制、木板纹理在接缝处对齐的桥梁示例。文档分别说明局部修改、文本分析、看图检查,以及在实际游戏或应用中检查的方法。
- 如果文件系统不支持创建硬链接,可在终端设置一次
PIXELART_PORTABLE_OUTPUT=1,让后续命令和示例脚本使用便携输出模式;单条命令也可单独指定。已有文件仍需明确使用--force才能覆盖。
兼容性与运行
支持 Python 3.10+、Pillow >=10.4,<13。requirements.txt 指定 Pillow 12.3.0,便于得到一致结果;发布时使用的环境是 Python 3.14.2 / Pillow 12.3.0。运行只需 Python 和 Pillow。
继续支持 JSON v1,原有 API 和命令的默认行为不变。基本绘图操作直接替换像素的 RGBA 值;blit 默认按透明度将新图叠加到原图上(source-over),其他支持的合成方式需单独指定。导入 PNG 后再导出,解码后的 8 位 RGBA 像素值保持一致,但压缩后的文件字节可能不同,也无法恢复原图层或绘制步骤。不接受动画和不支持的高位深图片。
解压 ZIP,在任务实际使用的 Python 环境安装包内 requirements.txt,然后从解压后的父目录运行:
python deterministic-pixel-art/scripts/pixel_art.py render --spec deterministic-pixel-art/assets/gem-16.json --out output/gem.png --preview output/gem-preview.png
python deterministic-pixel-art/scripts/pixel_art.py inspect --image output/gem.png --grid更新 Skill 时,请把旧版备份移到 AI 不会扫描加载 Skill 的目录,避免同时加载两份。使用便携输出模式时,其他程序可能读到尚未写完的新文件。无论采用哪种输出模式,如果写入过程中程序崩溃或电脑断电,一组输出文件都可能只完成一部分;中断后请先检查文件是否齐全、内容是否完整,再继续使用。
验证结果与使用限制
v1.2.0 正式版已通过 165 项源码测试、106 项独立安装包测试和 43 张基准图片检查,并验证了重复打包结果一致、Skill 格式合规。包内 98 个文件中,97 个与已验收的开发包逐字节相同,另一个模块仅修改了版本号。verification.json 记录发布对应的提交、Windows/Ubuntu CI 结果和打包来源。
外部试用覆盖八类任务。记录中仍保留 LT04 最初画反方向、缺少早期版本,以及 LT08 早期过程记录不全的问题。这些试用不足以证明工具能普遍改善画质、缩短任务时间或节省 token。Minecraft 游戏内效果、其他字体的适配、512×512 像素的直接绘制和多个 AI 协作绘图仍未验证。自动检查通过后,仍需人工看图,确认图案含义和视觉效果符合要求。
分发内容
下载附件包括 deterministic-pixel-art-v1.2.0.zip、package-manifest.json、verification.json 和 SHA256SUMS.txt;中英文版本说明可在 Release 页面直接阅读。解压前请用 SHA256SUMS.txt 核对 ZIP 的 SHA-256。ZIP 内包含独立 Skill,不含项目协调记录、Python 虚拟环境或仓库演示字体。代码、原创图像和 Skill 使用 MIT 许可;仓库演示使用的 Silkscreen 字体另遵循 SIL OFL 1.1 许可。