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 支持。