Skip to content

Forge CLI v0.6.4

Choose a tag to compare

@github-actions github-actions released this 21 Sep 04:23
· 49 commits to main since this release

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

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 不会自动升级。平台范围与签名状态不变,技术验收不代表美术质量或许可审批。