Skip to content

Forge CLI v0.7.0

Choose a tag to compare

View all tags
@github-actions github-actions released this 21 Sep 15:46
· 42 commits to main since this release
v0.7.0
61c9955
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

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 / 便携包、源码与校验

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
时间或模型费用。平台、签名状态与外部素材许可边界保持不变。

Assets 10
Loading