Forge CLI v0.7.7

Download / 下载

Choose one installer for your system. The other files are optional.
请按系统选择一个安装文件，无需逐个下载 Assets 中的所有附件。

System / 系统	Recommended download / 推荐下载	Run after download / 下载后操作
macOS Apple Silicon (M1/M2/M3/M4…)	forge-installer.sh	FORGE_VERSION=v0.7.7 sh forge-installer.sh (downloads the verified package / 自动下载并校验完整包)
Windows x64	forge-windows-installer.zip	Extract; open PowerShell in that folder and run powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\install-windows.ps1 / 解压后在该目录运行命令

Windows users need only the installer ZIP, which already contains the full
portable package and checksum. Godot is installed separately. Packages remain
unsigned; macOS is not notarized; Windows support is experimental.
Windows 安装 ZIP 已包含完整便携包和校验文件。Godot 需另行安装；当前安装包未签名，
macOS 未公证，Windows 支持仍为实验性。

Portable archives, source and checksums / 便携包、源码与校验

• macOS portable archive · SHA-256
• Windows portable archive · SHA-256
• Windows installer checksum
• Source, licenses, build recipes, SBOM and verification — optional for installation / 安装时无需下载。

Existing automation-facing archive names and checksum files are preserved.
GitHub-generated source-code ZIP/tar.gz downloads contain Forge source, not installed executables.
旧版自动安装所用文件名与校验文件保持兼容；GitHub 自动提供的 Source code 压缩包不是安装包。

File / 文件	SHA-256
forge-aarch64-apple-darwin.zip	5901d7e62960ac115702b6887bc14274cd09eacdeb595bb16152ac984438df15
forge-aarch64-apple-darwin.zip.sha256	d5c0e76c378044c3809d16201c93b1ccb7022afe4b619de45a914ac6977d2073
forge-installer.sh	b600a8921f8a4608ccffcf1364828025aca5b06501bc379824da3825ccd2856a
forge-x86_64-pc-windows-msvc.zip	837af53f1243af6765d7f36d0637bd7f0d29809d34b9e2b7ba79ffb53fd3a2cc
forge-x86_64-pc-windows-msvc.zip.sha256	69e057ad60b2cd68c3b054062b98e5d3002c98315b5ff4a3cb93cc8e62998257
forge-windows-installer.zip	9d6351876ae5b93f026a1646a766e8002cbf1da3f96916d70c58400c37b67d66
forge-windows-installer.zip.sha256	67438bf71214cea5eeb997f36499b38c33e863349b4955576b8ab2713ee62bf7
forge-source-and-notices.zip	999ed45d35a000b1c617fe4f369b80fe7122d3409c48364dd87fe9e13a6ab227

---

Forge CLI v0.7.7

Forge remains free under MIT; Forge PRO is maintained separately.

Chroma matting now applies despillStrength after edgeColorRecovery when both
are enabled. Previously the recovery option silently suppressed despill,
including on opaque pixels where recovery does nothing. The existing controls
can still be used independently. Alpha computation, defaults, JSON contracts and
Pack formats are unchanged; reprocessing with both options can change RGB.

Regression tests cover soft edges, opaque spill, alpha preservation and
border-connected exclusions. The real fox comparison
separates bright residue from dark fringe: residue stays zero; fringe remains at
strength 1.0, while an additional strength-2.0 candidate has zero fringe hits.
Both candidates require visual review; these parameters are not universal rules.
This fix does not promise complete spill removal on arbitrary artwork.

Existing consumer binary pins and installed skills are not automatically
upgraded. Keep the old executable and its matching lock for existing prepared
runs; prepare a new run with a separately verified upgraded toolchain.

The tag workflow must verify paired macOS Apple Silicon and experimental Windows
x64 packages, public launchers, upgrades, bundled helpers and native Godot before
publication. Packages are unsigned; macOS is not notarized. Local source tests
are distinct from versioned package evidence and artistic approval.

中文说明

本版修复免费 Forge 抠图中的组合开关缺陷：同时启用 edgeColorRecovery 与
despillStrength 时，先恢复边缘颜色，再执行去色溢；完全不透明、颜色恢复不处理
的像素也会去色溢。两项处理仍可单独使用。Alpha、默认参数、JSON 合同与 Pack
格式不变；同时启用两项处理并重新准备素材时，RGB 可能改变。

狐狸实测中亮色残留为 0，强度 1.0 的暗绿描边减少但仍存在；补充实验强度 2.0
的候选描边命中为 0。两者均须视觉审阅，不能把参数作为通用规则或宣称任意素材
都能完全去除描边。
已有项目锁与已安装 skill 不自动升级；旧 run 继续用原 Forge 与对应锁交付，
验证升级后用新工具链准备新的 run。发布须通过 macOS/Windows 安装包、公共启动器、
升级、随包工具与原生 Godot 验证。Forge 保持免费 MIT 许可，不附模型。

Forge CLI v0.7.6

Forge CLI v0.7.6

Forge remains free under MIT; Forge PRO is maintained separately.

Changes

• Embedded offline guidance adds an explicit four-frame, non-looping effect
  example with shared coordinates, canvas/pivot and per-frame durations.
• Scene audio examples distinguish battle/camp loops from one-shot victory audio,
  measured final levels from estimates and native PCM16 delivery from source files.
• Static artwork guidance checks complete weapon silhouettes and game display
  scale before batch production; padding cannot recover clipped artwork.
• Generation, Forge processing, PRO orchestration and consumer review retain
  separate identities and evidence. No model is bundled by these changes.

Read forge guide animation, forge guide audio and forge guide static.
The guidance update is PR #87.
Source/example QA records exact
processing and macOS Godot checks separately from artistic/listening approval.

No processing API or Pack format changed since v0.7.5. Existing consumer binary
pins and installed skills are not automatically upgraded. After a verified CLI
upgrade, check managed skills with forge skill check --project .; an explicit
forge skill install updates the managed bundle.

The tag workflow verifies paired macOS Apple Silicon and experimental Windows x64
packages, installed public launchers, upgrades, bundled helpers and native Godot
before publication. Packages are unsigned; macOS is not notarized. Technical
checks do not establish artistic quality, listening, licensing or device approval.

中文说明

本版内置离线指导加入四帧、非循环的单次特效示例，保留共享坐标、画布、锚点和
逐帧时长；场景音频区分战斗/营地循环与胜利单次播放、最终实测电平与估算值、
源文件与原生 PCM16 交付。静态素材先检查完整武器轮廓和游戏显示比例，补边不能
找回被裁掉的部分。生成、Forge 加工、PRO 编排和游戏审阅分别保留身份与证据。

Forge 继续免费并保持 MIT 许可，不附模型。处理 API、Pack 格式和已有项目锁不变；
二进制更新不自动替换已安装 skill。发布工作流在 macOS 与 Windows 安装包、公共
启动器、升级、随包工具和 Godot 检查通过后配对发布。安装包未签名、macOS 未公证；
技术检查不能替代美术、试听、许可或真机审阅。

Forge CLI v0.7.5

Download / 下载

Choose one installer for your system. The other files are optional.
请按系统选择一个安装文件，无需逐个下载 Assets 中的所有附件。

System / 系统	Recommended download / 推荐下载	Run after download / 下载后操作
macOS Apple Silicon (M1/M2/M3/M4…)	forge-installer.sh	FORGE_VERSION=v0.7.5 sh forge-installer.sh (downloads the verified package / 自动下载并校验完整包)
Windows x64	forge-windows-installer.zip	Extract; open PowerShell in that folder and run powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\install-windows.ps1 / 解压后在该目录运行命令

Windows users need only the installer ZIP, which already contains the full
portable package and checksum. Godot is installed separately. Packages remain
unsigned; macOS is not notarized; Windows support is experimental.
Windows 安装 ZIP 已包含完整便携包和校验文件。Godot 需另行安装；当前安装包未签名，
macOS 未公证，Windows 支持仍为实验性。

Portable archives, source and checksums / 便携包、源码与校验

• macOS portable archive · SHA-256
• Windows portable archive · SHA-256
• Windows installer checksum
• Source, licenses, build recipes, SBOM and verification — optional for installation / 安装时无需下载。

Existing automation-facing archive names and checksum files are preserved.
GitHub-generated source-code ZIP/tar.gz downloads contain Forge source, not installed executables.
旧版自动安装所用文件名与校验文件保持兼容；GitHub 自动提供的 Source code 压缩包不是安装包。

File / 文件	SHA-256
forge-aarch64-apple-darwin.zip	c5c9780a03aec2364a3546230c922234202b1e0ac8ad5581945bf61237389610
forge-aarch64-apple-darwin.zip.sha256	7ccd57bffc71fe5bb4ee1d8ae1f1b026d2f7235afb82517affca0bb67405cd1c
forge-installer.sh	b600a8921f8a4608ccffcf1364828025aca5b06501bc379824da3825ccd2856a
forge-x86_64-pc-windows-msvc.zip	d0f4cd4e77a1c2d714b6e74761083695656f93f36ee6eb9cb39d71cfca86ac93
forge-x86_64-pc-windows-msvc.zip.sha256	38a25a8030bb002bfee236566a953b686744891f123fd67c996e4b464df38098
forge-windows-installer.zip	95dde5ca20de7b718048068b4c70172d916e39d4a53c29a757cbc647599d9221
forge-windows-installer.zip.sha256	242430ec9ad3571b440109280d0bfc53449efd0944018c28208e5680a41818ff
forge-source-and-notices.zip	9c7a8e2046ecfaaf9f1ac6113b764cef951b31efa4e7c50c8d590d72024cba58

---

Forge CLI v0.7.5

Forge remains free under MIT; Forge PRO is maintained separately.

Changes

• Added embedded offline guidance for Godot UI artwork: preserve rectangular
  sources and nine-patch coordinates, separate independent visual layers, keep
  native text and focus states, and bind textures through game-owned controls.
• Clarified the boundary between free texture preparation/delivery and Forge PRO
  beta.4's editable UI/title authoring templates. UI navigation remains game logic.
• Included the bilingual creator-verification homepage link already on main.

No processing API or Pack format changed since v0.7.4. Existing consumer binary
pins and installed skills are not automatically upgraded. Read the selected
executable's forge guide local-static.

The tag workflow checks macOS Apple Silicon and experimental Windows x64 builds,
installed public launchers, upgrades, bundled helpers and native Godot delivery
before publishing both packages together. Packages are unsigned; macOS is not
notarized. Technical checks do not establish visual quality or licensing approval.

中文说明

Forge 继续免费并保持 MIT 许可。本版内置离线指南补充 Godot UI 的原图与九宫格坐标
保留、独立图层、原生文字和焦点状态，以及游戏维护的 Control 包装场景。免费版提供
纹理加工与交付，Forge PRO beta.4 提供可编辑 UI/标题模板；游戏导航仍由游戏实现。
包含 main 已有的中英文创作者认证主页链接。处理 API、Pack 格式及既有项目锁不变。

发布工作流验证 macOS Apple Silicon 和实验性 Windows x64 安装包、公共启动器、
升级、随包工具及 Godot 原生交付后，才配对发布。安装包未签名，macOS 未公证。
结构和运行检查不能替代美术与许可审阅。

Forge CLI v0.7.4

Download / 下载

Choose one installer for your system. The other files are optional.
请按系统选择一个安装文件，无需逐个下载 Assets 中的所有附件。

System / 系统	Recommended download / 推荐下载	Run after download / 下载后操作
macOS Apple Silicon (M1/M2/M3/M4…)	forge-installer.sh	FORGE_VERSION=v0.7.4 sh forge-installer.sh (downloads the verified package / 自动下载并校验完整包)
Windows x64	forge-windows-installer.zip	Extract; open PowerShell in that folder and run powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\install-windows.ps1 / 解压后在该目录运行命令

Windows users need only the installer ZIP, which already contains the full
portable package and checksum. Godot is installed separately. Packages remain
unsigned; macOS is not notarized; Windows support is experimental.
Windows 安装 ZIP 已包含完整便携包和校验文件。Godot 需另行安装；当前安装包未签名，
macOS 未公证，Windows 支持仍为实验性。

Portable archives, source and checksums / 便携包、源码与校验

• macOS portable archive · SHA-256
• Windows portable archive · SHA-256
• Windows installer checksum
• Source, licenses, build recipes, SBOM and verification — optional for installation / 安装时无需下载。

Existing automation-facing archive names and checksum files are preserved.
GitHub-generated source-code ZIP/tar.gz downloads contain Forge source, not installed executables.
旧版自动安装所用文件名与校验文件保持兼容；GitHub 自动提供的 Source code 压缩包不是安装包。

File / 文件	SHA-256
forge-aarch64-apple-darwin.zip	adb708e6ad6439af07043d19cdf46abb8c5dd7f852847929c10a0e88d64aeeba
forge-aarch64-apple-darwin.zip.sha256	f248174e884c64e2447b41aa22b8599d5114d57db3cd83ac5e5f15ede274aa17
forge-installer.sh	b600a8921f8a4608ccffcf1364828025aca5b06501bc379824da3825ccd2856a
forge-x86_64-pc-windows-msvc.zip	d3546506c352302415667a58f8deb4bf1e25aced65ccc8cede01585748abe1e9
forge-x86_64-pc-windows-msvc.zip.sha256	9e6963ea5988d05720080b06f3a91f256eff2c50933790cac505b9c9fabbf16b
forge-windows-installer.zip	baf733bdb306cb0365fae454bdfd47f770aca474bfc95fbc65a71336671e8817
forge-windows-installer.zip.sha256	3135933efd6d0e172d181841eae23584dd9f727431849af549aea2644d25ba23
forge-source-and-notices.zip	3d6ed58800529d0706dcac7e052836b498179b058a6dc07e1a8f55cb3b527f15

---

Forge CLI v0.7.4

Forge remains free under MIT; Forge PRO is maintained separately.

Changes

• Updated the embedded offline guide: review multi-threshold transparent bounds,
  distinguish canvas size from gameplay size, and export a new receipt after
  accepted same-ID artwork replacement while retaining the old receipt.
• Added a forest-scene template with separate prop/background requests and Godot
  layout review. The source artwork must be supplied separately.
• Added the Feishu community invitation to both READMEs.

No processing API or Pack format changed since v0.7.3. Existing consumer binary
pins and installed skills are not automatically upgraded. Read the selected
executable's forge guide.

The release workflow verifies macOS Apple Silicon and experimental Windows x64
packages, installed launchers, upgrades and native Godot delivery before publishing
both together. Packages are unsigned; macOS is not notarized. Technical checks do
not grant artistic or licensing approval. The static trial's visual review was
performed on macOS; it is not a Windows artwork review.

中文说明

Forge 继续免费，保持 MIT 许可。本版更新内置离线指导，补充透明边缘取边、画布与
游戏显示尺寸的区别，以及同 ID 素材更新后导出新收据并保留旧收据的流程；加入森林
场景模板和飞书社区入口。源素材需另行提供，处理 API 与 Pack 格式未改变。

发布工作流须验证 macOS Apple Silicon 与实验性 Windows x64 的安装、升级及 Godot
交付后再发布。安装包未签名，macOS 未公证；原静态素材试作的美术审阅仅在 macOS
完成。既有项目的工具链与 skill 不会自动升级。

Forge CLI v0.7.3

Download / 下载

Choose one installer for your system. The other files are optional.
请按系统选择一个安装文件，无需逐个下载 Assets 中的所有附件。

System / 系统	Recommended download / 推荐下载	Run after download / 下载后操作
macOS Apple Silicon (M1/M2/M3/M4…)	forge-installer.sh	FORGE_VERSION=v0.7.3 sh forge-installer.sh (downloads the verified package / 自动下载并校验完整包)
Windows x64	forge-windows-installer.zip	Extract; open PowerShell in that folder and run powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\install-windows.ps1 / 解压后在该目录运行命令

Windows users need only the installer ZIP, which already contains the full
portable package and checksum. Godot is installed separately. Packages remain
unsigned; macOS is not notarized; Windows support is experimental.
Windows 安装 ZIP 已包含完整便携包和校验文件。Godot 需另行安装；当前安装包未签名，
macOS 未公证，Windows 支持仍为实验性。

Portable archives, source and checksums / 便携包、源码与校验

• macOS portable archive · SHA-256
• Windows portable archive · SHA-256
• Windows installer checksum
• Source, licenses, build recipes, SBOM and verification — optional for installation / 安装时无需下载。

Existing automation-facing archive names and checksum files are preserved.
GitHub-generated source-code ZIP/tar.gz downloads contain Forge source, not installed executables.
旧版自动安装所用文件名与校验文件保持兼容；GitHub 自动提供的 Source code 压缩包不是安装包。

File / 文件	SHA-256
forge-aarch64-apple-darwin.zip	88f68e6e778b7e39b0515e62c9966b6a66a74f4ae8f3ad32ab0b3be03a3d5509
forge-aarch64-apple-darwin.zip.sha256	e6de9981d4f9a19054dce495585d1d81f3520e6d4641a6aff7fe4a58e7369f61
forge-installer.sh	b600a8921f8a4608ccffcf1364828025aca5b06501bc379824da3825ccd2856a
forge-x86_64-pc-windows-msvc.zip	ed0bd7057f6862e93e0a6323262adb571ed14c1b0ddb32384ad282318b800bb2
forge-x86_64-pc-windows-msvc.zip.sha256	b04bf428dc2b72e6c117b66b56f23ee70eb14f3d5ba02208d0d50e336519d8f9
forge-windows-installer.zip	b29df80608c53244e87f14f14d1021e04322916b7571a5f89d8a48e7e9930cea
forge-windows-installer.zip.sha256	7fadd82b408b5c9738122a7c1d7565eb9b511e40ef4d32fb510e924af8e51aec
forge-source-and-notices.zip	e485f0fe0e77ae98cf59bb1f13d5dc832096454f81e52cf2ff00de0621f094f9

---

Forge CLI v0.7.3

Forge remains free under MIT. Forge PRO is a separate private project; existing
Forge commands, examples and licenses remain available.

Changes

• Updated the embedded offline guide for video-derived character animation:
  inspect the entire clip, prefer a later complete continuous cycle when the
  beginning is unusable, preserve original timing, and review actual previews.
• Added the accepted three-view courier example and a side-running Godot turn
  test. A mirrored side view supports left/right; this is not a claim of four
  generated movement directions or automatic gait detection.
• Clarified the free/PRO boundary. Video generation remains external; local
  Forge processing prepares and delivers supplied assets.

Compatibility and verification

No processing API or Pack format changed since v0.7.2. Existing consumer binary
pins and separately installed skills are not automatically upgraded. Run the
selected binary's forge guide for its bundled instructions.

The tag release workflow builds and tests macOS Apple Silicon and experimental
Windows x64 packages before publishing both together. Packages remain unsigned;
macOS is not notarized. Runtime checks do not replace artistic review.

中文说明

Forge 继续免费并保持 MIT 许可，Forge PRO 独立维护；现有命令、案例与许可不变。
本版更新内置视频角色动画指导，并加入已认可的三视图角色、侧向跑动和 Godot
左右转向示例。视频开头不合格时，优先寻找后段完整、连续的动作周期；保持原速，
通过实际预览验收。侧向镜像不等于已经生成四方向移动。

本版未变更处理 API 或 Pack 格式。既有项目的二进制锁定和已安装 skill 不自动更新。
发布工作流须完成 macOS Apple Silicon 与实验性 Windows x64 原生包验证后再一起发布。
安装包仍未签名，macOS 未公证；技术验证不能代替美术验收。

Forge CLI v0.7.2

Download / 下载

Choose one installer for your system. The other files are optional.
请按系统选择一个安装文件，无需逐个下载 Assets 中的所有附件。

System / 系统	Recommended download / 推荐下载	Run after download / 下载后操作
macOS Apple Silicon (M1/M2/M3/M4…)	forge-installer.sh	FORGE_VERSION=v0.7.2 sh forge-installer.sh (downloads the verified package / 自动下载并校验完整包)
Windows x64	forge-windows-installer.zip	Extract; open PowerShell in that folder and run powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\install-windows.ps1 / 解压后在该目录运行命令

Windows users need only the installer ZIP, which already contains the full
portable package and checksum. Godot is installed separately. Packages remain
unsigned; macOS is not notarized; Windows support is experimental.
Windows 安装 ZIP 已包含完整便携包和校验文件。Godot 需另行安装；当前安装包未签名，
macOS 未公证，Windows 支持仍为实验性。

Portable archives, source and checksums / 便携包、源码与校验

• macOS portable archive · SHA-256
• Windows portable archive · SHA-256
• Windows installer checksum
• Source, licenses, build recipes, SBOM and verification — optional for installation / 安装时无需下载。

Existing automation-facing archive names and checksum files are preserved.
GitHub-generated source-code ZIP/tar.gz downloads contain Forge source, not installed executables.
旧版自动安装所用文件名与校验文件保持兼容；GitHub 自动提供的 Source code 压缩包不是安装包。

File / 文件	SHA-256
forge-aarch64-apple-darwin.zip	b927f07bd9462f8e9f2e17d48c0b882be0dbe9240594d57d87ae5a20b0ca2d03
forge-aarch64-apple-darwin.zip.sha256	2b9414436af7249ce8146d377ef00a03346627d66033d6d4ad07d0756845f068
forge-installer.sh	b600a8921f8a4608ccffcf1364828025aca5b06501bc379824da3825ccd2856a
forge-x86_64-pc-windows-msvc.zip	2534acb6ac4fc5e86e2a61dd537ad856ff674bc99138afaa37cb9974cf7b453b
forge-x86_64-pc-windows-msvc.zip.sha256	e152c50cb97747bffc1ebcdd2572573624d1e8ae35ee2b98472924cf4c9745a2
forge-windows-installer.zip	40190e083e1bf0d26c45665663421053814c53dddd7e3f55b157b198740cd922
forge-windows-installer.zip.sha256	bee1d43bf3db95b1a1b3c8487a6f1a70dbdc50aab0af22ffd0d13bb37c8846b6
forge-source-and-notices.zip	d0d7e9fa4b608c9fd6c1cd2b1941003d74152b82cf0d95b6acbc5c9fafd436a9

---

Forge CLI v0.7.2

Codex discovery for every install: skill installation now works on Windows.

v0.7.2 is a focused patch over v0.7.1. forge skill install and
forge skill check previously rejected Windows scopes with an unimplemented
error, so the documented path to let Codex discover Forge failed for Windows
users. The safe install transaction now runs on macOS, Linux and Windows with
the same contract.

What changes

• Windows skill installation: the atomic no-replace commit uses
  MoveFileExW without the replace flag, matching the macOS renameatx_np /
  Linux renameat2 semantics exactly: a target that appears concurrently,
  even an empty directory, is never overwritten. Backups, modification and
  symlink protection are unchanged.
• Correctness fixes behind the new platform: manifest identity keys are
  built with portable separators (an installed skill was previously reported
  as modified on Windows), and reported scope paths use the familiar
  drive-letter form rather than verbatim \\?\ prefixes.
• Recommended setup is now part of installation: the README and the
  installer next-step message recommend forge skill install --project with
  .agents/skills/forge-use/ committed into the game repository, so every
  collaborator's Codex discovers Forge without individual setup; --user
  remains the personal multi-project option. forge guide continues to
  provide the same workflows offline without any installation.

Compatibility and upgrade

Existing installed skills, backups and manifests are untouched; skill check
reports their state exactly as before. The change is confined to the skill
install transaction and its tests; no asset, Pack, catalog or Godot contract
changes. See downloads and Windows installation.

Verification and limitations

Windows skill installation, idempotent updates, backups, modified/unmanaged
preservation and symlink protection run in the Rust suite and in the full
(non-guide-only) CLI acceptance script on Windows CI; unprivileged local
Windows sessions probe and explicitly skip symlink creation while privileged
CI runners exercise it. Workspace clippy runs with -D warnings. See the
release verification record.

macOS Apple Silicon and experimental Windows x64 remain the release targets.
Packages are unsigned and macOS is not notarized. Symlink-protection tests
require a privileged Windows session; all other behavior is identical across
platforms.

中文说明

v0.7.2：每次安装都能让 Codex 发现 Forge——skill 安装现已支持 Windows。

v0.7.1 及更早版本的 forge skill install 在 Windows 上直接报错，文档指引对
Windows 用户不可用。本版本在 Windows 上实现同样的安全安装事务：原子提交
使用不带替换标志的 MoveFileExW，并发出现的任何目标（包括空目录）都不会
被覆盖；备份、修改与符号链接防护不变。同时修复了 Windows 下清单键的路径
分隔符导致装完即被误判为已修改的问题，以及报告路径带 \\?\ 前缀的问题。

README 与安装器下一步提示现在推荐项目级安装：把 .agents/skills/forge-use/
提交进游戏仓库，团队成员的 Codex 全部自动发现；--user 仍是个人跨项目选项。
forge guide 继续离线提供同样内容，不安装 skill 也不受影响。

既有已装 skill、备份与清单保持原样；改动仅限 skill 安装事务及其测试。符号
链接防护测试需要 Windows 特权会话，无权限会话显式探测跳过，CI 完整覆盖。
发布平台、签名状态与许可边界不变。

Forge CLI v0.7.1

Download / 下载

Choose one installer for your system. The other files are optional.
请按系统选择一个安装文件，无需逐个下载 Assets 中的所有附件。

System / 系统	Recommended download / 推荐下载	Run after download / 下载后操作
macOS Apple Silicon (M1/M2/M3/M4…)	forge-installer.sh	FORGE_VERSION=v0.7.1 sh forge-installer.sh (downloads the verified package / 自动下载并校验完整包)
Windows x64	forge-windows-installer.zip	Extract; open PowerShell in that folder and run powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\install-windows.ps1 / 解压后在该目录运行命令

Windows users need only the installer ZIP, which already contains the full
portable package and checksum. Godot is installed separately. Packages remain
unsigned; macOS is not notarized; Windows support is experimental.
Windows 安装 ZIP 已包含完整便携包和校验文件。Godot 需另行安装；当前安装包未签名，
macOS 未公证，Windows 支持仍为实验性。

Portable archives, source and checksums / 便携包、源码与校验

• macOS portable archive · SHA-256
• Windows portable archive · SHA-256
• Windows installer checksum
• Source, licenses, build recipes, SBOM and verification — optional for installation / 安装时无需下载。

Existing automation-facing archive names and checksum files are preserved.
GitHub-generated source-code ZIP/tar.gz downloads contain Forge source, not installed executables.
旧版自动安装所用文件名与校验文件保持兼容；GitHub 自动提供的 Source code 压缩包不是安装包。

File / 文件	SHA-256
forge-aarch64-apple-darwin.zip	1cbd6b7d2b5eb0bc1cd21ab5d3263b3a52ee49b66439462c780330e9d53efe29
forge-aarch64-apple-darwin.zip.sha256	a3c245c31d2509a674528bb2c5c8609aa96680cc557ef62dea0bb5fc8848bda4
forge-installer.sh	27d3c4b604d4c9c779b6c25fff1eead993f4fe6a3a74f2203cdb74e0327ba15d
forge-x86_64-pc-windows-msvc.zip	9437df198c0c084e29b39506741e2e5c45796730d1fb5086de3ff51fcb9c8f42
forge-x86_64-pc-windows-msvc.zip.sha256	3030a4c9eff8a027ba17892852ddbc2fd56b5629a47747aa9074e31e26dd76d4
forge-windows-installer.zip	e241679483a941ac4bf745f2d08695b0dc02d55c83e83fc39dd3d366a0847f47
forge-windows-installer.zip.sha256	0b3f040cb65f23e4ed973a9146fce2015d863c81b0c98a6b0a8baf1e98d559e5
forge-source-and-notices.zip	80b32cd4ee174e9437b655fbe4707e561da46d393c0bbfec40c6ed638c1c097e

---

Forge CLI v0.7.1

Resource library discovery, preview manifests and requirements reconciliation for AI agents.

v0.7.1 is an additive patch over v0.7.0. It makes the local resource library
answer an agent's two recurring questions cheaply: what do I already have, and
what is still missing. All v0.7.0 delivery, diagnostics and preview behavior is
unchanged; existing catalogs, locks, receipts and review evidence carry over
without migration.

What changes for agents

• Vocabulary before guessing: forge asset tags lists the kind/tag/purpose
  vocabulary already in use, with asset and revision counts, so agents compose
  exact filters instead of guessing spellings. It reads catalog metadata only:
  no media bytes are read and no index cache is created or repaired.
• Cheap search for large libraries: forge asset search --metadata-only
  skips source-byte verification and reports status:"unknown". It is rejected
  when combined with --status, and verified searches remain the default
  everywhere else. Pack member lists come from recorded source metadata.
• Preview media manifest: forge asset preview responses and preview.json
  now carry a media array naming each revision's copied files with
  preview-relative paths, original labels and an image/audio/video type, so
  agents can open exact revision media without walking the output directory.
  Animation player frames are included; missing sources stay in issues.
• Requirements reconciliation: forge asset check-requirements compares a
  declared batch (schemas/asset-requirements.schema.json, example in
  examples/asset-library/requirements.json) against the library using the
  verified search contract. Each entry reports covered, needs_review,
  incomplete or missing with up to five hits; a missing icon_set/prop_set
  entry includes a pre-filled local static request skeleton with TODO
  placeholders. The command is read-only, performs no generation or Provider
  call, and covered describes inventory and recorded review state, not
  visual or license approval.

New capability IDs in doctor --json: project_asset_vocabulary,
project_asset_metadata_search, project_asset_preview_media_manifest and
project_asset_requirements_check.

Compatibility and upgrade

Use the recommended installer for your platform in the download table. The
eight release attachment names and the optional source/notices bundle remain
compatible with v0.6.4 automation. See downloads and
Windows installation.

Updating Forge does not update a consumer project's toolchain lock,
previously installed resources or a separately installed Codex skill. Existing
search, preview, review, selection, lock and installation contracts are
unchanged; the new flags and report fields are additive. Requirements batches
are inputs, not stored state; matches per requirement are evaluated in search
order and capped at 1000. Suggested request skeletons are starting points:
their TODO license and path placeholders must be completed before planning.

Verification and limitations

Windows package gates (fresh install, reinstall, historical upgrades, bundled
helpers and installed asset-library workflows) passed on the merged commits.
Rust unit/integration coverage includes the vocabulary, metadata-only search,
preview manifest and all four reconciliation statuses with synthetic fixtures.
Offline CLI contract scripts assert read-only behavior and zero Provider
requests. See the release verification record.

Default features remain empty. The reconciliation report is not semantic
search, does not persist requirement batches, and does not infer tags,
generators or lineage at registration. Animation preparation remains
experimental; structural checks do not certify artistic quality, listening,
licenses or game readiness. This release makes no measured claims about saved
agent time or reduced model costs.

macOS Apple Silicon and experimental Windows x64 remain the release targets.
Godot 4.6.x or 4.7.x is installed separately. Packages are unsigned and macOS is
not notarized. Source media and external tools retain their own license
conditions.

中文说明

v0.7.1：面向 Agent 的资源库发现、预览清单与需求对账。

v0.7.1 是 v0.7.0 之上的增量补丁，让本地资源库低成本回答两个常见问题：库里
已经有什么、场景还缺什么。交付、诊断与预览行为不变，既有目录、锁、回执与
审核证据无需迁移。

• forge asset tags 列出在用的 kind/tag/purpose 词表和计数，先查词表再组合
  精确过滤；纯元数据读取，不触碰媒体字节、不创建索引缓存。
• forge asset search --metadata-only 跳过字节核验并如实报 unknown 状态，
  与 --status 互斥；已核验搜索仍是所有既有路径的默认。
• 预览响应和 preview.json 新增 media 清单，逐个版本列出复制媒体的相对
  路径、原始标签和类型（含动画播放器帧），缺失源仍只进 issues。
• forge asset check-requirements 按已核验搜索语义把需求批与库存对账，输出
  covered/needs_review/incomplete/missing；缺失的图标/道具需求附带
  预填的本地静态请求骨架（TODO 占位）。只读、零 Provider 请求，covered 不
  等于美术或许可批准。

升级 CLI 不修改消费项目锁、已交付素材或单独安装的 skill；新参数与报告字段
均为增量。单需求匹配按搜索排序最多评估 1000 条。发布门槛沿用双平台安装包
验证；默认特性为空，不做语义搜索、需求批持久化或登记时自动推断标签。
平台、签名状态与外部素材许可边界保持不变。

Forge CLI v0.7.0

Download / 下载

Choose one installer for your system. The other files are optional.
请按系统选择一个安装文件，无需逐个下载 Assets 中的所有附件。

System / 系统	Recommended download / 推荐下载	Run after download / 下载后操作
macOS Apple Silicon (M1/M2/M3/M4…)	forge-installer.sh	FORGE_VERSION=v0.7.0 sh forge-installer.sh (downloads the verified package / 自动下载并校验完整包)
Windows x64	forge-windows-installer.zip	Extract; open PowerShell in that folder and run powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\install-windows.ps1 / 解压后在该目录运行命令

Windows users need only the installer ZIP, which already contains the full
portable package and checksum. Godot is installed separately. Packages remain
unsigned; macOS is not notarized; Windows support is experimental.
Windows 安装 ZIP 已包含完整便携包和校验文件。Godot 需另行安装；当前安装包未签名，
macOS 未公证，Windows 支持仍为实验性。

Portable archives, source and checksums / 便携包、源码与校验

• macOS portable archive · SHA-256
• Windows portable archive · SHA-256
• Windows installer checksum
• Source, licenses, build recipes, SBOM and verification — optional for installation / 安装时无需下载。

Existing automation-facing archive names and checksum files are preserved.
GitHub-generated source-code ZIP/tar.gz downloads contain Forge source, not installed executables.
旧版自动安装所用文件名与校验文件保持兼容；GitHub 自动提供的 Source code 压缩包不是安装包。

File / 文件	SHA-256
forge-aarch64-apple-darwin.zip	8afcae9a80087f2bb6519378d26c69e3a2fbaaf258fb77448b0fde31b354cf49
forge-aarch64-apple-darwin.zip.sha256	fa0ecd04fe47aae435134a1c558a17e705a1a5ee22893283e5dbc0141ae07a1b
forge-installer.sh	27d3c4b604d4c9c779b6c25fff1eead993f4fe6a3a74f2203cdb74e0327ba15d
forge-x86_64-pc-windows-msvc.zip	86f0e410fdbb6656af8b6a83082a3244575c25ad69a6394ad3a3e41aa6cdd860
forge-x86_64-pc-windows-msvc.zip.sha256	8bdcaec7e79d2743c5f8988dc5041b42b47a74abe85817751f2bfcbd89addeab
forge-windows-installer.zip	1464d26ebbe6da879b0b81c6dd89e0878c84cbaf4fd4fb6fbe3e04abb43a2e24
forge-windows-installer.zip.sha256	fe63a5b8b235cdd8de9ca9ff9a6d99d38a01e81a687a7a2f5c758c72847c47c3
forge-source-and-notices.zip	bb6a36adeba82afd381f3c9dd73f801c4778d2b4ea73ccb3b1a57f2822d0275f

---

Forge CLI v0.7.0

Resource processing, diagnostics and reliable delivery for AI agents.

Forge's direct users are Codex and other coding agents. This release improves
how they turn existing or generated images, animation frames and audio into
Godot resources, diagnose bad inputs and recover from failed delivery. Creative
generation and game logic remain with the agent and its chosen tools.

What changes for agents

• Lossless sprite delivery: flat animation/character and icon/prop PNGs receive
  explicit Godot import settings that preserve stored RGBA. Installation checks
  the saved native textures against the Pack and rolls back on mismatch. Existing
  texture filtering, shared coordinates, anchors and frame timing remain explicit.
  Look for godot_lossless_sprite_import in doctor --json; this policy does not
  extend to layered/world textures.
• Actionable frame diagnostics: pixel reports identify empty, edge-touching
  and duplicate frames with issue types, severity, certainty, zero-based frame
  indices, report pointers and correction options. Edge contact and repeated
  frames may be intentional; warnings are not automatic artistic rejection.
  Malformed image/audio inputs identify the item and source path; animation
  layout/timing errors identify the relevant action, frame or field.
• Review and correction: the existing offline original-PNG preview supports
  zoom, anchor reference lines and shared-time comparison of versions. Agents can
  replace a specified source frame in a new preparation request and revalidate;
  unchanged frames/timing and old evidence stay independently checkable. A blocked
  local animation can no longer write a misleading accepted review record.
• One documented delivery flow: embedded guides cover animation, static assets
  and audio using existing Plan/Job/Pack/install mechanisms. The delivery example
  now accepts prepare-audio with explicit channels and sample rate. Installation
  failure can be retried from the retained Pack; no regeneration is necessary.
  Audio library previews correctly recommend the auditory review domain.

Use the selected executable's forge guide, forge guide animation-example,
forge guide animation, forge guide audio and forge guide local-delivery-example.
No new orchestration framework or automatic animation generation is introduced.

Compatibility and upgrade

Use the recommended installer for your platform in the download table. The eight
release attachment names and the optional source/notices bundle remain compatible
with v0.6.4 automation. See downloads and
Windows installation.

Updating Forge does not update a consumer project's toolchain lock, previously
installed resources or a separately installed Codex skill. Keep existing verified
pins; select the new executable explicitly in an isolated project, verify the
resources and only then approve that project's upgrade. Reinstallation applies
the new sprite import policy to the targeted resources. Existing source assets,
Pack history and review evidence are preserved; new candidates require their own
applicable review. Audio request defaults remain unchanged; use explicit output
format fields when preserving the source format matters.

Verification and limitations

M1–M3 source changes passed native macOS/Windows checks with Godot 4.6.3 and 4.7.2.
This version's release gate additionally requires the actual packaged public
launchers, fresh installation, reinstall, v0.6.4 upgrade, bundled FFmpeg/FFprobe
and M2/M3 workflows on both native platforms. Historical upgrade coverage remains.
The tag-triggered workflow publishes only after both package jobs and paired
archive verification pass. See the release verification record.
Source CI is not a substitute for installed-package verification.

Default features remain empty. Character/world optional source workflows are not
promoted into the default release. Animation preparation remains experimental:
structural/native checks do not certify artistic quality, listening, licenses,
automatic pose generation or game readiness in every project. M4 real-project
paired benefit observations are pending; this release makes no measured claims
about saved agent time or reduced model costs. Generation costs and local
processing remain separate.

macOS Apple Silicon and experimental Windows x64 remain the release targets.
Godot 4.6.x or 4.7.x is installed separately. Packages are unsigned and macOS is
not notarized. Source media and external tools retain their own license conditions.

中文说明

v0.7.0：面向 Agent 的资源处理、诊断与可靠交付。

Forge CLI 的直接使用者是 Codex 等 Agent。Agent 理解需求、创作素材并编写游戏逻辑；
Forge 负责可重复的加工、诊断、验证和 Godot 交付。

• 平面动画/角色及图标/道具 PNG 使用明确的无损导入设置，保存后核对原生 RGBA，
  不一致则回滚。坐标、锚点、时序和采样设置继续明确保留；该策略不覆盖分层/世界纹理。
• 空帧、触边、重复帧报告包含类型、严重度、确定性、零起算帧索引及修正建议；
  有意触边或停顿不能自动当作美术错误。损坏图片/音频及布局/时长错误更容易定位。
• 既有原始 PNG 预览支持缩放、锚点参考和多版本同步对比；指定输入修正后产生新候选，
  保留历史证据。被阻塞的本地动画不能写入误导性的“已接受”记录。
• 嵌入 guide 统一动画、静态与音频流程；交付示例支持显式声道/采样率的音频准备。
  安装失败可从原 Pack 重试，音频预览推荐正确的试听审核域。

沿用 8 个发布附件和既有安装入口，不新增通用编排或自动动画生成系统。升级 CLI 不会
自动修改消费项目锁、已交付素材或单独安装的 skill；先在隔离副本验证，再单独批准
游戏工具链升级。原素材、历史 Pack 和审核记录保留，音频默认参数不变。

发布门槛覆盖 macOS/Windows 原生安装包、新装、重装、从 v0.6.4 升级、公共启动器、
内置 FFmpeg/FFprobe 与 M2/M3 场景，保留历史升级检查。双平台包与附件核验成功后才
发布。Godot 4.6.3/4.7.2 源码矩阵与实际安装包验证分别记录，不能互相冒充。

默认特性为空，高级角色/世界功能仍为可选源码能力，动画准备仍属实验性。技术通过
不代表美术、试听、许可或真实项目收益通过；M4 实测尚未完成，不宣称已节省 Agent
时间或模型费用。平台、签名状态与外部素材许可边界保持不变。

Forge CLI v0.6.4

Download / 下载

Choose one installer for your system. The other files are optional.
请按系统选择一个安装文件，无需逐个下载 Assets 中的所有附件。

System / 系统	Recommended download / 推荐下载	Run after download / 下载后操作
macOS Apple Silicon (M1/M2/M3/M4…)	forge-installer.sh	FORGE_VERSION=v0.6.4 sh forge-installer.sh (downloads the verified package / 自动下载并校验完整包)
Windows x64	forge-windows-installer.zip	Extract; open PowerShell in that folder and run powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\install-windows.ps1 / 解压后在该目录运行命令

Windows users need only the installer ZIP, which already contains the full
portable package and checksum. Godot is installed separately. Packages remain
unsigned; macOS is not notarized; Windows support is experimental.
Windows 安装 ZIP 已包含完整便携包和校验文件。Godot 需另行安装；当前安装包未签名，
macOS 未公证，Windows 支持仍为实验性。

Portable archives, source and checksums / 便携包、源码与校验

• macOS portable archive · SHA-256
• Windows portable archive · SHA-256
• Windows installer checksum
• Source, licenses, build recipes, SBOM and verification — optional for installation / 安装时无需下载。

Existing automation-facing archive names and checksum files are preserved.
GitHub-generated source-code ZIP/tar.gz downloads contain Forge source, not installed executables.
旧版自动安装所用文件名与校验文件保持兼容；GitHub 自动提供的 Source code 压缩包不是安装包。

File / 文件	SHA-256
forge-aarch64-apple-darwin.zip	fb60caac2e2a8542c6ee716a63958c806300c4aa6f6faa13e4c86a783548b6a2
forge-aarch64-apple-darwin.zip.sha256	62618d16f700ba0379211d158c392201e961e97c4e8c0ed5c57187d4b62aa8ea
forge-installer.sh	27d3c4b604d4c9c779b6c25fff1eead993f4fe6a3a74f2203cdb74e0327ba15d
forge-x86_64-pc-windows-msvc.zip	3312ee63cc2b6592d963f2a390591d22b605f6629c0d831d8ba91d29788f295e
forge-x86_64-pc-windows-msvc.zip.sha256	705eef335aabd824e0ab43f27e5b17c3cbd4416e5f3cea64f81f4ce8572a4c07
forge-windows-installer.zip	752679c8fac31a09427a5cececfddfda83fe25084102ab0c421272adcf5e6636
forge-windows-installer.zip.sha256	253516484b0943dd9802d2b1a3903fff2d97577b93261fabdb4c8aea1f9424fb
forge-source-and-notices.zip	4dec460ae5a4991878cd5267fa72f6e99ebef45a2035f79888b4d35e093d7b21

---

Forge CLI v0.6.4

Forge v0.6.4 makes local asset delivery easier to diagnose and release downloads
easier to choose. It incorporates production feedback from the Survival project.

Local delivery reliability

• forge storage check --path DIR --json probes an existing directory for the
  filesystem operations required by delivery: exclusive publication, overwrite
  protection, replacement, hard links and file locks. Check supported, not just
  ok; unsupported storage such as an incompatible ExFAT volume is diagnosed
  before production without weakening delivery guarantees.
• forge guide local-delivery-example provides an offline Python workflow that
  pins the executable SHA-256, requires reviewed source locks, checks storage and
  capabilities, prepares a Pack, and installs it directly into Godot. It retains
  the Pack, receipts, progress and recovery evidence with zero Provider requests.
• The example submits the validated request snapshot through stdin, preserves
  relative source paths and decodes CLI output as UTF-8 on both platforms.
• Godot toolchain schema validation now agrees with runtime support for 4.6 and
  4.7, including patchless version strings. Mixed preserve_source static
  canvases report the affected item groups; installation failures identify the
  phase and explain where to find logs and recovery instructions.

Simpler downloads

Choose the recommended installer for your system from the download table above.
Uploaded release assets are reduced from 14 to 8. Existing installer, portable
archive and checksum filenames remain compatible with automated downloads.

forge-source-and-notices.zip consolidates pinned FFmpeg/zlib source archives,
licenses, build recipes, native build identities, a macOS-target Rust SBOM and
the paired package verification report. Its internal SHA-256 manifest covers
every included file. It is optional for installation. The Windows installer ZIP
already contains the complete portable package and checksum.

See the download guide and
Windows installation guide. Historical releases retain
their original attachments.

Verification and scope

The delivery changes passed PR #56's nine CI checks, including native macOS and
Windows with Godot 4.6.3 and 4.7.2, Windows package installation/upgrade and
bidirectional resource exchange. The download assembler passed its regression
suite on macOS, Windows and Linux, and was rehearsed against the actual v0.6.3
packages with an isolated macOS installation.

See delivery verification,
review fixes and
download verification. The versioned
v0.6.4 packages must separately pass the paired native release workflow before
publication; source and packaging tests do not replace those installed checks.

macOS Apple Silicon and experimental Windows x64 remain the supported release
targets. Install Godot 4.6.x or 4.7.x separately for native delivery. Packages are
unsigned and macOS is not notarized. Updating Forge does not update a game's
toolchain lock or a separately installed Codex skill. Technical acceptance does
not establish artwork quality or license approval.

中文说明

v0.6.4 根据 Survival 项目的使用反馈，改进本地素材交付的诊断与恢复，并简化发布下载。

• 新增 forge storage check --path DIR --json，检查现有目录是否支持交付所需的
  独占发布、防覆盖、替换、硬链接和文件锁。应检查 supported 字段，不能仅看 ok；
  对不满足要求的 ExFAT 等存储提前给出诊断，不降低交付保证。
• forge guide local-delivery-example 提供离线 Python 示例：固定 CLI 的 SHA-256，
  要求已审核源文件锁，预检存储与能力，加工后直接安装到 Godot，并保留 Pack、回执、
  进度和恢复证据。整个流程不调用 Provider。
• 示例将已经验证的请求快照通过 stdin 提交，保留相对路径，跨平台统一使用 UTF-8。
  Godot 工具链 schema 与 4.6 / 4.7 运行时支持对齐；静态素材画布不一致时列出相关分组，
  安装失败时明确失败阶段和日志、恢复说明的位置。
• 发布附件从 14 个减少为 8 个，推荐下载按系统置顶。安装脚本、便携包和校验文件的
  既有名称保持兼容；Windows 用户只需下载完整安装 ZIP。源码、许可证、构建说明、
  macOS 目标的 Rust SBOM 和双平台包验证报告集中在可选的
  forge-source-and-notices.zip，其内含逐文件 SHA-256 清单。

交付改进已通过 PR #56 的 9 项 CI，覆盖 macOS/Windows、Godot 4.6.3 / 4.7.2、
Windows 安装升级和双向资源交换。附件整合测试已在 macOS、Windows、Linux 通过，
并使用真实 v0.6.3 发布文件完成整合及隔离 macOS 安装演练。v0.6.4 版本化安装包另经
双平台原生发布流程验证后才会发布。历史发布附件保持原样；游戏工具链锁和已安装的
Codex skill 不会自动升级。平台范围与签名状态不变，技术验收不代表美术质量或许可审批。

Forge CLI v0.6.3

Forge CLI v0.6.3

Forge v0.6.3 improves animation review and sharing. Resource-library previews use
original PNG frames, preserving soft transparency and native frame timing, while
shareable MP4 videos are generated separately from those PNGs.

Animation previews

• forge asset preview plays flat animation/character Packs directly from their
  PNG frames, including existing Packs. Select an animation, pause, step through
  frames, and switch between dark, light and checkerboard backgrounds.
• forge pack preview --path effect.gsfpack --out preview.mp4 exports one cycle
  as H.264 MP4. Optional animation/background selection and a verified cache are
  available; reports identify source content, encoder and native/encoded timing.
• Compatibility GIFs now clear previous frames and follow native per-frame
  durations. Low-alpha RGB no longer becomes opaque speckles in newly generated
  GIFs. GIF still has limited colors and binary transparency.
• Windows bundles include Media Foundation H.264 encoding with NV12 input.
  Browser-player CSP hashes work with both LF and Windows CRLF line endings.

Existing source PNGs, Packs, catalog revisions, consumer toolchain locks and
delivery receipts are not rewritten. Old stored GIFs remain unchanged; flat
Packs use the new PNG viewer without regeneration. Layered/world/audio Packs
retain their existing viewers.

MP4 has a baked background, uses normal alpha composition and quantizes timing
to 60 fps. It is a sharing preview, not a transparent game asset. GIF remains a
compatibility artifact required by existing Pack formats. Use Godot for engine
blend modes and layered playback; technical checks do not establish art quality.

Verification and installation

PR #55 passed nine CI checks, including macOS and Windows with Godot 4.6.3 and
4.7.2, native H.264 encode/probe/decode checks, Windows fresh installation and
historical upgrade, the quality matrix and cross-platform resource exchange.
See preview verification for source
identities and limitations. Versioned release packages are built and checked
separately by the paired macOS/Windows release workflow before publication.

macOS Apple Silicon uses forge-installer.sh. Windows x64 users download
forge-windows-installer.zip, extract it and run the included installer. The
Windows encoder requires working operating-system Media Foundation support.
Packages are unsigned; macOS is not notarized; Windows remains experimental.
Upgrading the CLI does not automatically change a game's toolchain lock or an
installed Codex skill. Read forge guide animation after upgrading.

中文说明

v0.6.3 改进了动画预览与分享。资源库直接播放原始 PNG 帧，保留柔和透明边缘和原始
帧时长，支持动画选择、暂停、逐帧查看以及深色、浅色、棋盘格背景切换。已有平面动画
与角色 Pack 也能使用，无需重新生成或修改原始素材。

新增 forge pack preview --path effect.gsfpack --out preview.mp4，从 PNG 直接
导出一轮 H.264 视频，支持指定动画、背景和可校验缓存。Windows 包补齐了 Media
Foundation H.264 编码，并使用 NV12 输入修复像素异常；浏览器预览也兼容 Windows
换行符。新生成的兼容 GIF 修复了前帧残留、低透明像素变为不透明斑点和帧时长问题。

MP4 的背景已合成，时间精度为 60 fps，适合分享，不能代替透明游戏素材；GIF 仍受颜色
数量和二值透明度限制。已有 GIF、Pack、资源库版本、工具链锁和交付回执保持不变。
引擎混合模式和分层效果仍应在 Godot 中检查。

PR #55 的 9 项 CI 全部通过，覆盖 macOS/Windows、Godot 4.6.3 / 4.7.2、原生视频
编码解码、Windows 安装升级、质量矩阵和双向资源交换。版本化安装包另经双平台发布
流程构建和验证后发布。macOS Apple Silicon 与实验性 Windows x64 的安装方式不变；
Windows 编码需要系统具备可用的 Media Foundation 支持。