v0.4.0：断点续编与同版 Composer 运行时

项目构建失败或中断后，重新从同一入口开始会校验并复用已完成编译单元，未完成或损坏的单元从头编译；每次仍重新链接并校验产物。引导提供继续编译、重选项目、全量重建和结束四个选择，CLI 支持 webman-aot build --fresh。

0.4.0 同时发布 Composer 入口及对应的 macOS Apple Silicon / Windows x64 原生运行时、轻量/完整包与 setup。Composer 安装命令保持 composer global require supdger/webman-aot-builder，首次信任后自动进入引导。三种使用方式与前提见 README 和 安装指南。

实际验证：macOS 完整包安装和109单元冷编、普通重试、缓存损坏、源码变化、全量重建通过；Windows 原生 CI通过对应五轮及强制终止后的14/109复用、95单元重编，并发安全拒绝、重新链接和产物校验，任务进程清理为空。独立发行验收通过。用户Windows实机续编、PHP8.1原生链及Linux业务流程仍未完整验收。

下载时选择开发机对应的 setup；离线环境可提前下载完整包。components.zip 用于编译组件准备，自己的项目 Composer 依赖须事先安装。资产大小与摘要以本页及 SHA256SUMS 为准。

固定身份：最终源码/tag 05f33af0ae7b3ea108b25f42140eb41b1617b6af；原生包真实构建源码 f3609c91bdcbb4b51b7edd88aa16ffa51c6ae8ba。最终源码的139项原生源文件与包内逐项同字节，后续提交仅追加真实Composer绑定、说明与测试辅助。SHA256SUMS摘要为 7d293e4ff8bff3d3e4ca42e0cde939aa51002edf872a2e947891f657f7b49710。

v0.3.7 — Composer 安装后自动引导

普通 Composer 安装现在会直接接到组件与项目引导：

composer global require supdger/webman-aot-builder

首次 Composer 询问插件信任时输入 y。本包安装与自动加载完成后自动显示菜单，识别开发机、选择准备组件或导入完整包，随后进入已有项目流程。升级和无变化重复安装也适用。

• Composer 2.5.3+；非交互、CI、拒绝信任、禁用插件/脚本及其他命令不会自动打开菜单，普通入口仍可主动调用。
• 项目流程结果与入口安装分别显示，Composer 后续安全审计照常执行。
• 仅发布轻量 Composer ZIP 与校验清单，不设为 latest；完整运行时继续使用 0.3.2，不替换既有原生资产。
• 已通过隔离 macOS 真实 Composer 安装、升级、菜单和原项目流程的独立验收；Windows 物理执行、PHP 8.1 和首次联网完整包下载尚未验证。

安装细节见 Wiki。

v0.3.6 Composer 首次使用引导

Composer 安装成功后直接进入引导：程序识别开发机、准备对应组件，随后选项目、构建并自动校验；失败可在同一菜单重试或重选。

已安装时运行：

composer global exec -- webman-aot guide

首次安装的完整启动命令见 README。可选择自动准备、导入已有完整包或结束。无参非交互调用只提示启动方式，不隐式下载或安装。

本版仅含 Composer 轻量 ZIP 与 SHA256SUMS；平台完整运行时仍为 0.3.2，原 setup、完整资源和 latest 保持不变。PHP 8.1 与 Windows 实机验证仍未完成；Mac 已通过真实 Composer 入口及完整包导入到菜单的验证，这不表示 Linux 部署和业务验收。

v0.3.5 — Supdger Composer package

Composer包归属更正为 supdger/webman-aot-builder。命名空间、入口帮助和状态所有权同步为Supdger；SaiAdmin表示业务兼容生态，项目仍使用 --profile=saiadmin。

已安装旧包时，先 composer global remove saiadmin/webman-aot-builder，再 composer global require supdger/webman-aot-builder:^0.3.5。取得新的Composer bin目录，从代理完整路径执行 uninstall --list / uninstall，明确清理旧包私有状态及旧原生版本，保留“Composer 全局包（supdger/webman-aot-builder）”。新setup不会接管旧owner；卸载后保留安装锁和额外用户文件，新入口可以重新准备。迁移步骤。

仅发布11文件轻量Composer ZIP和SHA256SUMS，固定运行时仍为v0.3.2；native完整包/latest与所有旧tag/资产不变。

验收：PHP8.4/macOS 19项入口与37项卸载检查通过，独立真实ZIP迁移/自卸载13项通过；包括只移除精确旧包、拒绝自动接管旧状态、显式清理后保留原锁、保留其他工具。Windows实机和PHP8.1未实跑，不声明这两层验收通过。

v0.3.4 — Composer guided uninstall

Composer 入口 0.3.4 新增逐项卸载：先列出发现的版本、安装方式和路径，再逐项确认。删除已确认的活动原生版本会撤销绑定命令，不恢复旧备份；完成后再次显示剩余入口。无法证明归属的文件保留，项目产物、共享工具链与 PATH 保留。

本次只提供轻量 Composer ZIP 和 SHA256SUMS，完整运行时继续固定 v0.3.2；原生完整安装包及 latest 保持不变。现有原生 0.3.2 不会自动得到新卸载命令。请先安装 composer global require saiadmin/webman-aot-builder:^0.3.4，从 Composer bin 目录下的代理完整路径执行 uninstall --list / uninstall；清理旧版本时保留“Composer 全局包”。完整步骤。

验证：PHP 8.4/macOS 18项既有与30项卸载检查通过，独立路径与并发锁9项通过；真实 Mac 原生入口与精确 v0.3.4 ZIP 的 Composer 全局安装、清旧版本保留 Composer、self-remove 保留其他工具通过。PHP 8.1 与 Windows 实机未实跑，本版不声明这两层验收通过。

0.3.3 Composer entry point

Composer 入口与原仓库标签统一为 0.3.3，包名 saiadmin/webman-aot-builder。此补充发行仅包含轻量命令入口 ZIP；完整运行时继续使用已验收、固定摘要的 0.3.2 平台完整包。

通过 Composer 全局安装：

composer global require saiadmin/webman-aot-builder:^0.3.3

可用索引以 Packagist 包页面为准。旧版同名命令用户请将 Composer bin 目录优先放入 PATH，或使用完整代理路径；--version 应显示入口 0.3.3、目标 0.3.2。

本地与独立验收已覆盖真实 Composer source/dist 代理、PSR-4、18 项桥接行为和隔离运行时 doctor。Windows 新入口与 PHP 8.1 真机验证仍未完成，不包含编译断点续跑。

本 Release 不设为 latest：v0.3.2 继续提供原 setup、完整安装包和 SDK 素材；不重打、不改名旧安装包。

Webman AOT Builder v0.3.2

Webman AOT Builder v0.3.2 修复锁定 SaiAdmin 依赖组合的构建问题，并更新编译组件。

• 支持锁定的 Carbon 3.14.1，修复 SaiAdmin 项目因 Carbon 版本拒绝、生成配置选择或生成代码不兼容而中止构建的问题。
• 补齐 DeepClone 1.42.0 编译所需的闭包绑定、引用存储和反射行为，修复类被跳过及生成代码无法编译的问题；保留完整 DeepClone 适配，不通过排除依赖绕过失败。Closure::call() 仍不支持。
• 使用本项目从锁定官方输入重建的 PHPX 静态 SDK，记录来源、补丁、库与头文件摘要，并由编译组件和源码构建入口校验。新增衍生 SDK 素材供维护者重建；普通安装继续使用 setup。
• 本版需要更新安装包及对应编译组件，旧组件不能作为新版 SDK 使用。项目源码保持不变；编译与本机校验通过仍需另行完成 Linux 启动、数据库和业务验收。

第一次安装或更新，请选择与你的开发机匹配的 setup：Windows x64 下载 windows-x86_64-setup.cmd；macOS Apple Silicon 下载 macos-arm64-setup.zip，解压运行其中的 .command。选择轻量包或完整包、确认安装，再输入已完成 Composer 依赖安装的项目根目录。

下载文件	用途
webman-aot-builder-0.3.2-windows-x86_64-setup.cmd	Windows 首选入口。自动下载、校验和安装你选择的包。
webman-aot-builder-0.3.2-macos-arm64-setup.zip	macOS Apple Silicon 首选入口。解压运行 .command，再按菜单操作。
webman-aot-builder-0.3.2-windows-x86_64.zip	Windows 轻量安装包。解压运行 install.cmd；首次准备编译组件需要联网。
webman-aot-builder-0.3.2-macos-arm64.tar.gz	macOS 轻量安装包。解压运行 install.command；首次准备编译组件需要联网。
webman-aot-builder-0.3.2-full-windows-x86_64.zip	Windows 完整安装包。内置编译组件，解压运行 install.cmd。
webman-aot-builder-0.3.2-full-macos-arm64.tar.gz	macOS 完整安装包。内置编译组件，解压运行 install.command。
webman-aot-builder-0.3.2-windows-x86_64-components.zip	Windows 编译组件，由工具自动获取和校验；普通安装不用单独下载，不能独立安装工具。
webman-aot-builder-0.3.2-macos-arm64-components.zip	macOS 编译组件，由工具自动获取和校验；普通安装不用单独下载，不能独立安装工具。
webman-aot-builder-0.3.2-derived-linux-x86_64-sdk.tar.xz	维护者的 Linux x86_64 musl 目标 SDK 素材，用于源码重建。本项目从锁定官方输入打补丁重建，不是 PHPX 官方发行资产；普通用户选择 setup。
SHA256SUMS	上述九项下载资产的 SHA-256 校验清单。setup 自动校验所选安装包。
GitHub 的 Source code (zip) / Source code (tar.gz)	工具源码，供开发或自行构包；直接安装请选择 setup 或安装包。

完整包的离线范围是工具安装和编译组件准备。自己的项目仍需事先备好 Composer 依赖与构建文件。开发机平台与目标平台不同：最终把整个 dist-aot/ 部署到 Linux amd64。

构建时会显示当前阶段和编译器逐文件完成数。较长步骤没有新输出时，会显示进程状态、已用时间和无输出时长，并明确工作进度未知；不会编造整个构建的百分比或预计完成时间。成功会显示产物位置，失败保留原始错误、耗时、退出码和本机日志位置，可按菜单重试或重选项目。

macOS 首次双击 .command 若被拦截，请按 macOS 首次打开的两图说明 检查来源并在系统设置允许打开。

验证范围：macOS 同机隔离的实际 SaiAdmin 副本已通过 2063/2063 单元编译、链接、打包及本机 verify。Windows 无密钥 Webman 夹具通过公共 CMD 入口完成 109 单元编译、构建与校验；闭包/DeepClone 等九组80项语义结果在 Linux amd64/Rosetta 与 PHP 基线一致。这些结果不代表所有 SaiAdmin 版本或插件组合兼容，也不代替 Linux 服务启动、数据库与业务接口验收。

安装与使用 · SaiAdmin 兼容范围 · 源码构建与 SDK 来源

Webman AOT Builder v0.3.1

Webman AOT Builder v0.3.1 改进构建期间的可见状态，并解释下载页中每种包的用途。

• 修复 Windows 与 macOS 安装引导进入项目构建后，阶段和编译日志不能及时显示的问题。现在会持续显示准备阶段、编译器的逐文件进度与真实完成数；没有新输出时显示等待时间，完成或失败时保留耗时、原始错误和退出码。
• 增加锁定 symfony/polyfill-deepclone v1.42.0 对 PHP 8.4 静态目标的适配，修复其条件声明触发的 stray code 构建错误；适配只作用于隔离构建镜像，包版本或源码不匹配时拒绝应用。
• 下载说明逐项解释 setup、轻量包、完整包、编译组件、校验文件及 GitHub 自动源码归档的用途，明确首次安装的推荐入口。
• 构建进度修复已通过 Windows 和 macOS 的真实项目菜单、编译与产物校验；这不代表所有 SaiAdmin 依赖组合或 Linux 业务运行已通过验收。

较长步骤没有新输出时，会显示进程仍在运行、已用时间和无输出时长，并明确工作进度未知。该版不代表所有 SaiAdmin 项目均已编译通过：用户反馈的 SaiAdmin 项目完整构建与业务链仍需验收。verify 检查开发机上产物的结构、完整性及静态属性，Linux 目标机启动、数据库和业务接口需部署后另行验收。

第一次安装，请打开 最新正式版下载页，下载与你的开发机匹配的 setup。
Windows x64 选 windows-x86_64-setup.cmd；macOS Apple Silicon 选 macos-arm64-setup.zip，解压后运行其中的 .command。
setup 会让你选择轻量包或完整包，再自动下载、校验和安装。以下为 v0.3.1 下载页的全部资产：

文件名	用途与适用情况
webman-aot-builder-0.3.1-windows-x86_64-setup.cmd	Windows 首次安装推荐。运行后按提示选择包类型；下载时需要联网。
webman-aot-builder-0.3.1-macos-arm64-setup.zip	macOS Apple Silicon 首次安装推荐。解压运行 .command，按提示选择包类型；下载时需要联网。
webman-aot-builder-0.3.1-windows-x86_64.zip	Windows 轻量安装包；手动解压运行 install.cmd。首次构建时联网下载编译组件。
webman-aot-builder-0.3.1-macos-arm64.tar.gz	macOS Apple Silicon 轻量安装包；手动解压运行 install.command。首次构建时联网下载编译组件。
webman-aot-builder-0.3.1-full-windows-x86_64.zip	Windows 完整安装包；包含编译组件。适合提前下载后复制到离线开发机，解压运行 install.cmd。
webman-aot-builder-0.3.1-full-macos-arm64.tar.gz	macOS Apple Silicon 完整安装包；包含编译组件。适合提前下载后复制到离线开发机，解压运行 install.command。
webman-aot-builder-0.3.1-windows-x86_64-components.zip	Windows 编译组件，由工具自动下载和校验；普通安装无需单独下载，不能独立安装工具。
webman-aot-builder-0.3.1-macos-arm64-components.zip	macOS Apple Silicon 编译组件，由工具自动下载和校验；普通安装无需单独下载，不能独立安装工具。
SHA256SUMS	上述八项资产的 SHA-256 校验清单，用于核对下载文件；setup 会自动校验所选安装包。
GitHub 自动提供的 Source code (zip) / Source code (tar.gz)	对应版本的源码，供开发或自行构包；直接安装请选择上面的 setup 或安装包。

文件名没有 full 的安装包就是轻量包；轻量包和完整包安装后都提供 webman-aot 命令。
完整包的离线范围是工具安装和编译组件准备；自己的项目仍须事先备好 Composer 依赖及构建所需文件。
这些下载包安装在开发机上；Linux 目标机接收构建生成的整个 dist-aot/。

安装和使用指南 · 源码构建指南

macOS 首次打开安装入口

若双击 setup.command 或 install.command 时看到“未打开”或“Apple 无法验证”，请按 macOS 首次打开图解 操作：先点“完成”，再到“系统设置 → 隐私与安全性 → 安全性”为该文件点“仍要打开”，按系统提示确认后继续安装。图解包含首次拦截提示和“仍要打开”位置的两张截图。

Webman AOT Builder v0.3.0

Webman AOT Builder v0.3.0 提供统一引导流程：macOS 运行 build.command，Windows 运行 build.cmd，从一个入口选择轻量或完整包，完成下载、SHA 校验、构包自检和安装，再选择项目目录自动 build + verify。

独立 setup 支持自动下载对应平台安装包，校验大小和 SHA-256 后进入安装与项目流程。安装和下载显示阶段、实际进度、失败原因及解决建议；轻量包联网准备组件，完整包可离线准备。Windows 私有 PHP 支持中文安装与项目路径。

修复任意目录层级 .DS_Store 变化引起的源码快照和镜像误报；真实源码变化仍中止构建。

安装和使用：https://github.com/supdger/webman-aot-builder/wiki/Install
源码构建：https://github.com/supdger/webman-aot-builder/wiki/Build-from-source

选择匹配开发机的 macOS Apple Silicon 或 Windows x64 资产。macOS setup ZIP 解开后运行 .command，Windows 运行 setup.cmd。SHA256SUMS 覆盖八项下载资产；GitHub 自动源码 ZIP 不是安装包。

verify 覆盖构建机结构、完整性及静态属性，不代替 Linux 目标机的启动、数据库和业务接口验收。

Webman AOT Builder v0.2.3

修复

修复 Windows Git 正常将 SaiAdmin 的 support/bootstrap.php 从 LF 检出为 CRLF 后，构建器误报启动源码不兼容的问题。构建器只在隔离构建镜像中规范化已锁定的启动源码换行，原项目文件保持不变；真实内容差异仍拒绝构建。无需修改项目文件或全局 Git 设置。

源码目标：70b1344d18ea137f9d3c72fcee80c2c4b2885282（PR #25）。

下载

安装后的命令为 webman-aot，版本应显示 webman-aot 0.2.3。安装与使用见 Wiki 指南。

开发机	安装包	大小	SHA-256
macOS Apple Silicon	webman-aot-builder-0.2.3-macos-arm64.tar.gz（轻量）	8,524,619 字节	03f2e21112ca70e207f94b9962b7fa542531470cb9b7d9df731e90d22b3cfb52
macOS Apple Silicon	webman-aot-builder-0.2.3-full-macos-arm64.tar.gz（完整）	265,181,452 字节	5784b163aeb6b1c5f9f038c46bdc29eac95ef769fc82439a34a7d206086a9774
Windows x64	webman-aot-builder-0.2.3-windows-x86_64.zip（轻量）	7,864,053 字节	726257b061404debf3502dc26262c15a923124b4a8f5bf728f594fd4288aa95d
Windows x64	webman-aot-builder-0.2.3-full-windows-x86_64.zip（完整）	342,615,119 字节	271e9499fd4042ab031dca675b02ff2fae90ac925d6fcb6660f417ae58182e49

轻量包由 doctor 联网下载对应平台的 -components.zip；完整包已包含组件。两份组件归档、macOS 的 -php-relink-materials.tar.gz 源码与重链接材料，以及覆盖全部七份归档的 SHA256SUMS 一并提供。组件归档和重链接材料不是用户安装包。

验证与边界

• Windows 候选 CI 在 3b0fce0 通过：两种安装包的安装与全局 doctor；官方 SaiAdmin 8f5f6fa 配合锁定的受支持依赖 fixture，真实内容差异被拒绝，正常 CRLF 项目 build/verify 成功，原启动文件的字节和 Git 状态未变。最终 main 的四个产品文件与该通过提交一致。
• 正式四个安装包均以最终 main 构建，七份归档已重新计算 SHA-256 并核对包内清单。macOS 完整包完成离线安装、版本与健康检查；Windows 正式构包 CI 完成两种安装包的安装、版本与全局健康检查。
• 发布后，macOS 四份归档和 Windows 三份归档 的公开下载大小、SHA-256 与正式清单一致。两端轻量包均在全新安装和零组件缓存下，从非项目目录运行普通 webman-aot doctor（不加 --repair），实际从 v0.2.3 URL 自动下载并核验对应组件，显示版本 0.2.3 和 healthy，退出码为 0。macOS 组件核验为 7611/7611，安装的 125 个应用文件与最终 main 一致。
• 上述结果未完成 Linux amd64 目标机的启动、数据库与业务接口验收；请按 Linux 目标机验收 单独验证。

八个公开资产及两端轻量包的空缓存在线组件准备均已核对。