v0.1.0-rc.5

What's new in 0.1.0-rc.5

This is a backward-compatible prerelease of the pixelforge CLI, not a 2.0. Prefer the v0.1.0-rc.5 tag over GitHub latest until a stable release exists.

Product skills now live at repository-root skills/ (#155): these are bundled CLI skills, not Cursor repo-maintenance skills, so they no longer belong under .cursor/skills. The layout matches official larksuite/cli. A packaged pixelforge embeds SKILL.md and references/**/*.md at compile time from skills/, and does not depend on .cursor or a git checkout. pixelforge skills list and pixelforge skills read are unchanged.

The six bundled skills are pixelforge, pixelforge-draw, pixelforge-sprite-4dir, pixelforge-layers, pixelforge-critique, and pixel-art-craft.

pixelforge skills list
pixelforge skills list pixel-art-craft
pixelforge skills list pixel-art-craft/references
pixelforge skills read pixelforge
pixelforge skills read pixel-art-craft references/beginner.md
pixelforge skills read pixel-art-craft/references/beginner.md
pixelforge skills read pixel-art-craft --json

skills list always prints JSON (--json is accepted and is a no-op). skills read NAME prints raw SKILL.md on stdout (a tip goes to stderr). --json wraps the file in an object. This repository does not copy product skills into .cursor/skills/, .agents/skills/, or .claude/skills/, and it does not publish an npx skills install path. After a checkout, use the CLI or open skills/ directly; Cursor will not auto-load these product skills from the repo.

Convert, palette strategies, and the known limits from v0.1.0-rc.4 are unchanged. See known-limits. Structural validation is not aesthetic approval (aestheticApproval: false).

这一版的新内容（0.1.0-rc.5）

这是 pixelforge CLI 的向后兼容预发布，不是 2.0。正式版之前请用 v0.1.0-rc.5 标签，不要依赖 GitHub latest。

产品 skill 现放在仓库根目录 skills/（#155）：它们是随 CLI 打包的产品技能，不是 Cursor 用来维护本仓库的开发 skill，因此不再放在 .cursor/skills。布局与官方 larksuite/cli 一致。已安装的 pixelforge 在编译期从 skills/ 嵌入 SKILL.md 和 references/**/*.md，不再依赖 .cursor 或仓库检出。pixelforge skills list 与 pixelforge skills read 的用法不变。

六个打包 skill：pixelforge、pixelforge-draw、pixelforge-sprite-4dir、pixelforge-layers、pixelforge-critique、pixel-art-craft。

pixelforge skills list
pixelforge skills list pixel-art-craft
pixelforge skills list pixel-art-craft/references
pixelforge skills read pixelforge
pixelforge skills read pixel-art-craft references/beginner.md
pixelforge skills read pixel-art-craft/references/beginner.md
pixelforge skills read pixel-art-craft --json

skills list 始终打出 JSON（--json 可写，没有额外效果）。skills read NAME 默认把 SKILL.md 原文打到 stdout，提示在 stderr；加 --json 则包一层对象。仓库不会把产品 skill 再复制到 .cursor/skills/、.agents/skills/ 或 .claude/skills/，也不提供 npx skills 安装路径。检出仓库后请用 CLI 或直接打开 skills/；Cursor 不会从本仓库自动加载这些产品 skill。

convert、调色板策略以及 v0.1.0-rc.4 的已知限制没有变化。详见 能力边界。结构校验不等于审美通过（aestheticApproval: false）。

Install pixelforge 0.1.0-rc.5

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/starcloud530/pixelforge-ai/releases/download/v0.1.0-rc.5/pixelforge-cli-installer.sh | sh

Install prebuilt binaries via powershell script

powershell -ExecutionPolicy Bypass -c "irm https://github.com/starcloud530/pixelforge-ai/releases/download/v0.1.0-rc.5/pixelforge-cli-installer.ps1 | iex"

Download pixelforge 0.1.0-rc.5

File	Platform	Checksum
pixelforge-cli-aarch64-apple-darwin.tar.gz	Apple Silicon macOS	checksum
pixelforge-cli-x86_64-apple-darwin.tar.gz	Intel macOS	checksum
pixelforge-cli-x86_64-pc-windows-msvc.zip	x64 Windows	checksum
pixelforge-cli-x86_64-unknown-linux-gnu.tar.gz	x64 Linux	checksum

v0.1.0-rc.4

What's new in 0.1.0-rc.4

This is a backward-compatible bugfix prerelease of the pixelforge CLI, not a 2.0. Prefer the v0.1.0-rc.4 tag over GitHub latest until a stable release exists.

Packaged CLI can list and read bundled agent skills (#153): skills already lived in .cursor/skills, but a prebuilt or installed pixelforge had no way for an external agent to discover or read them. This cut embeds SKILL.md and references/**/*.md at compile time from those same sources, so a standalone binary works without the git checkout.

The six bundled skills are pixelforge, pixelforge-draw, pixelforge-sprite-4dir, pixelforge-layers, pixelforge-critique, and pixel-art-craft.

pixelforge skills list
pixelforge skills list pixel-art-craft
pixelforge skills list pixel-art-craft/references
pixelforge skills read pixelforge
pixelforge skills read pixel-art-craft references/beginner.md
pixelforge skills read pixel-art-craft/references/beginner.md
pixelforge skills read pixel-art-craft --json

skills list always prints JSON (--json is accepted and is a no-op). skills read NAME prints raw SKILL.md on stdout (a tip goes to stderr). --json wraps the file in an object. This repository does not publish an npx skills install path.

Convert, palette strategies, and the known limits from v0.1.0-rc.3 are unchanged. See known-limits. Structural validation is not aesthetic approval (aestheticApproval: false).

这一版的新内容（0.1.0-rc.4）

这是 pixelforge CLI 的向后兼容 bugfix 预发布，不是 2.0。正式版之前请用 v0.1.0-rc.4 标签，不要依赖 GitHub latest。

已安装的 CLI 可自助列出并读取打包 skill（#153）：技能本来就在 .cursor/skills，但预编译 / 已安装的 pixelforge 无法让外部 Agent 发现或读取它们。这一版在编译期从同一套源码嵌入 SKILL.md 和 references/**/*.md，独立二进制不再依赖仓库检出。

六个打包 skill：pixelforge、pixelforge-draw、pixelforge-sprite-4dir、pixelforge-layers、pixelforge-critique、pixel-art-craft。

pixelforge skills list
pixelforge skills list pixel-art-craft
pixelforge skills list pixel-art-craft/references
pixelforge skills read pixelforge
pixelforge skills read pixel-art-craft references/beginner.md
pixelforge skills read pixel-art-craft/references/beginner.md
pixelforge skills read pixel-art-craft --json

skills list 始终打出 JSON（--json 可写，没有额外效果）。skills read NAME 默认把 SKILL.md 原文打到 stdout，提示在 stderr；加 --json 则包一层对象。仓库不提供 npx skills 安装路径。

convert、调色板策略以及 v0.1.0-rc.3 的已知限制没有变化。详见 能力边界。结构校验不等于审美通过（aestheticApproval: false）。

Install pixelforge 0.1.0-rc.4

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/starcloud530/pixelforge-ai/releases/download/v0.1.0-rc.4/pixelforge-cli-installer.sh | sh

Install prebuilt binaries via powershell script

powershell -ExecutionPolicy Bypass -c "irm https://github.com/starcloud530/pixelforge-ai/releases/download/v0.1.0-rc.4/pixelforge-cli-installer.ps1 | iex"

Download pixelforge 0.1.0-rc.4

File	Platform	Checksum
pixelforge-cli-aarch64-apple-darwin.tar.gz	Apple Silicon macOS	checksum
pixelforge-cli-x86_64-apple-darwin.tar.gz	Intel macOS	checksum
pixelforge-cli-x86_64-pc-windows-msvc.zip	x64 Windows	checksum
pixelforge-cli-x86_64-unknown-linux-gnu.tar.gz	x64 Linux	checksum

v0.1.0-rc.3

What's new in 0.1.0-rc.3

This is a prerelease of the pixelforge CLI. Prefer the v0.1.0-rc.3 tag over GitHub latest until a stable release exists.

Convert any-size PNG to an editable indexed frame (#149): pixelforge convert / Tool API convertPng writes a version 1 indexed project you can paint, undo, and export. Five deterministic engines: center-sample, dominant, kmeans, contrast-outline, and grid-snap. The reserved id pixelforge-native returns EngineUnavailable and does not fall back.

Palette strategies (#150):

• source keeps the image palette (snapshot mode: keep)
• limit caps opaque colors (snapshot mode: limit)
• project maps onto a palette this project already chose

An unknown strategy id errors and does not switch. source and limit return PaletteInUse when another frame or layer still has ink. project against the built-in default palette, including a new --output file, is PaletteDefault and writes no file.

Docs-site dependency upgrades (#151) are also in this cut. They do not change CLI behavior.

Known limits

See known-limits. Convert is a sampler, not a quality score; the quality benchmark is #127 and is not in this release. A source edge above 4096 is refused. The target stays inside 1..=256. Alpha below 128 becomes index 0, so partial alpha is not stored. There is no dither. Upscaling is nearest-neighbor and does not invent detail. features are stored on the transform snapshot and are not applied. When grid-snap finds no edge it still returns that image, with report.detected false, using center sampling inside that engine. A tileset converts only at the tile size. Structural validation is not aesthetic approval (aestheticApproval: false).

这一版的新内容（0.1.0-rc.3）

这是 pixelforge CLI 的预发布。正式版之前请用 v0.1.0-rc.3 标签，不要依赖 GitHub latest。

任意尺寸 PNG 转为可编辑索引帧（#149）：pixelforge convert / Tool API convertPng 写出仍可绘制、撤销和导出的 version 1 索引工程。五个确定引擎：center-sample、dominant、kmeans、contrast-outline、grid-snap。保留 id pixelforge-native 返回 EngineUnavailable，不回退。

三种调色板策略（#150）：

• source 沿用原图色板（快照 mode: keep）
• limit 限制不透明色数量（快照 mode: limit）
• project 映射到工程已经选过的色板

未知策略 id 直接报错，不换策略。其它帧或层还有墨水时，source 和 limit 返回 PaletteInUse。对内置默认色板（包括 --output 新建的文件）使用 project 时是 PaletteDefault，不建文件。

文档站依赖升级（#151）也包含在这一刀，不改变 CLI 行为。

已知限制

详见 能力边界。convert 是采样器，不打质量分；质量基准是 #127，本版未做。源图每边最大 4096，目标边长仍是 1..=256。alpha 小于 128 写成索引 0，半透明不留在格子里。不抖动。放大是最近邻，不补细节。features 只记在 transform 快照，这一版不参与采样。grid-snap 找不到边缘时仍返回结果，report.detected 为 false，并在该引擎内改用中心采样。图块集只能转到与图块相同的尺寸。结构校验不等于审美通过（aestheticApproval: false）。

Install pixelforge 0.1.0-rc.3

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/starcloud530/pixelforge-ai/releases/download/v0.1.0-rc.3/pixelforge-cli-installer.sh | sh

Install prebuilt binaries via powershell script

powershell -ExecutionPolicy Bypass -c "irm https://github.com/starcloud530/pixelforge-ai/releases/download/v0.1.0-rc.3/pixelforge-cli-installer.ps1 | iex"

Download pixelforge 0.1.0-rc.3

File	Platform	Checksum
pixelforge-cli-aarch64-apple-darwin.tar.gz	Apple Silicon macOS	checksum
pixelforge-cli-x86_64-apple-darwin.tar.gz	Intel macOS	checksum
pixelforge-cli-x86_64-pc-windows-msvc.zip	x64 Windows	checksum
pixelforge-cli-x86_64-unknown-linux-gnu.tar.gz	x64 Linux	checksum

v0.1.0-rc.2

Install pixelforge 0.1.0-rc.2

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/starcloud530/pixelforge-ai/releases/download/v0.1.0-rc.2/pixelforge-cli-installer.sh | sh

Install prebuilt binaries via powershell script

powershell -ExecutionPolicy Bypass -c "irm https://github.com/starcloud530/pixelforge-ai/releases/download/v0.1.0-rc.2/pixelforge-cli-installer.ps1 | iex"

Download pixelforge 0.1.0-rc.2

File	Platform	Checksum
pixelforge-cli-aarch64-apple-darwin.tar.gz	Apple Silicon macOS	checksum
pixelforge-cli-x86_64-apple-darwin.tar.gz	Intel macOS	checksum
pixelforge-cli-x86_64-pc-windows-msvc.zip	x64 Windows	checksum
pixelforge-cli-x86_64-unknown-linux-gnu.tar.gz	x64 Linux	checksum

v0.1.0-rc.1

Install pixelforge 0.1.0-rc.1

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/starcloud530/pixelforge-ai/releases/download/v0.1.0-rc.1/pixelforge-cli-installer.sh | sh

Install prebuilt binaries via powershell script

powershell -ExecutionPolicy Bypass -c "irm https://github.com/starcloud530/pixelforge-ai/releases/download/v0.1.0-rc.1/pixelforge-cli-installer.ps1 | iex"

Download pixelforge 0.1.0-rc.1

File	Platform	Checksum
pixelforge-cli-aarch64-apple-darwin.tar.gz	Apple Silicon macOS	checksum
pixelforge-cli-x86_64-apple-darwin.tar.gz	Intel macOS	checksum
pixelforge-cli-x86_64-pc-windows-msvc.zip	x64 Windows	checksum
pixelforge-cli-x86_64-unknown-linux-gnu.tar.gz	x64 Linux	checksum