@qwen-code/arena-agent 0.0.9-dev.14 → 0.0.9-dev.15

package/README.md

@@ -49,6 +49,9 @@ npm ci
 npm run package:binary
 ```
 
+其中 `linux-x64` 产物使用 glibc 2.17 兼容的内嵌 Node.js Runtime，目标机器无需
+安装 Node.js；Alpine/musl 系统请使用独立的 `linux-x64-musl` 产物。
+
 命令会生成 `build/sea/arena`（Windows 为 `arena.exe`），并打出当前平台包和
 `@qwen-code/arena-cli` 的 npm tarball。二进制必须针对目标操作系统、CPU 架构和
 Linux libc 分别构建；不能把 macOS 上生成的文件直接用于 Linux。

package/docs/BINARY_DISTRIBUTION.md

@@ -3,9 +3,9 @@
 Arena 可以使用 Node.js Single Executable Applications（SEA）构建为一个包含
 Node.js 运行时、应用代码和静态资源的可执行文件。目标机器不需要安装 Node.js。
 
-如果业务机只是受安装权限或 Node.js 版本管理限制，这种方式可以绕过安装步骤；
-如果业务机的操作系统本身无法运行 Node.js 20+（例如 glibc 太旧），同一运行时
-封装进二进制后仍然无法运行，需要针对该系统选择兼容的构建机和 Node.js 发行版。
+如果业务机只是受安装权限或 Node.js 版本管理限制，这种方式可以绕过安装步骤。
+Linux x64 glibc 包固定使用 Node.js unofficial-builds 的 glibc 2.17 Runtime，支持
+CentOS 7 / glibc 2.17 及更新的 glibc 系统；低于 glibc 2.17 的系统仍无法运行。
 
 ## npm 安装（业务机有 Node.js 18）
 
@@ -100,9 +100,10 @@ npm run package:binary
 ```
 
 默认命令构建当前 runner 的系统、CPU 和 libc。CI 还支持在 Linux x64 上按 Node
-SEA 跨平台流程生成 `darwin-x64` 和 `linux-x64-musl`。前者下载完全相同版本的
-官方 macOS x64 Runtime，后者下载 Node.js unofficial-builds 的 musl Runtime；
-两者都通过 Aone 可访问的 npmmirror 二进制镜像下载，并校验对应的
+SEA 跨平台流程生成三个关键目标：`linux-x64` 固定下载完全相同版本的 Node.js
+unofficial-builds glibc 2.17 Runtime，`linux-x64-musl` 下载 unofficial-builds
+musl Runtime，`darwin-x64` 下载官方 macOS x64 Runtime。三者都通过 Aone 可访问的
+npmmirror 二进制镜像下载，并校验对应的
 `SHASUMS256.txt`，关闭 code cache/snapshot 后注入 SEA blob。
 macOS 产物再使用固定版本和 checksum 的 `rcodesign` 做 ad-hoc 签名。Aone 从仓库的
 `toolchains/apple-codesign-0.29.0` 工具链分支拉取固定 commit，避免构建时依赖 GitHub
@@ -131,8 +132,9 @@ node scripts/package-binaries.mjs \
 ```
 
 CI 应构建并汇总 `build/npm/packages/<target>`。原生 Runtime 通常应在对应环境中
-构建；禁用 SEA snapshot/code cache 后，`darwin-x64` 和 `linux-x64-musl` 也可以在
-Linux x64 Runner 上使用经过校验的目标 Node Runtime 交叉组装。
+构建；禁用 SEA snapshot/code cache 后，`linux-x64`、`linux-x64-musl` 和
+`darwin-x64` 都可以在 Linux x64 Runner 上使用经过校验的目标 Node Runtime
+组装。
 
 本仓库使用 Aone CI，流水线定义在
 [`/.aoneci/arena-binaries.yaml`](../.aoneci/arena-binaries.yaml)。当前项目没有关联
@@ -191,26 +193,28 @@ npm run publish:binaries -- \
 
 ## 平台与兼容性
 
-SEA 产物内含构建机当前的 Node.js 可执行文件，因此需要为每种目标分别构建：
+SEA 产物内含目标平台的 Node.js 可执行文件，因此需要为每种目标分别构建：
 
 - macOS arm64 与 x64
 - Linux arm64/x64 的 glibc 与 musl
 - Windows x64
 
-除流水线已覆盖的 Linux x64 → macOS x64、Linux x64 glibc → musl SEA 交叉构建
-外，其他目标应在对应操作系统和 CPU 架构的构建机或 CI runner 上执行。
+除流水线已覆盖的三个关键 x64 目标外，其他目标应在对应操作系统和 CPU 架构的
+构建机或 CI runner 上执行。
 
 “业务机不需要 Node.js 20+”不等于“二进制不受 Node.js 20 的系统要求影响”。
 SEA 把 Node.js 可执行文件放进 Arena，运行时仍由操作系统加载这个内嵌运行时：
 
-- glibc 包只能运行在满足该 Node.js 可执行文件最低 glibc 要求的系统上；
+- 当前 Linux x64 glibc 包的最低要求是 glibc 2.17；
 - musl 包用于 Alpine 等 musl 系统，不能代替 glibc 包；
 - 在较新的 Linux 上打包，不能自动获得对更老 glibc 的兼容性。
 
 因此，业务机只有 Node.js 18 通常不是问题；真正需要确认的是它的操作系统、CPU
-架构和 `ldd --version`。如果业务机的 glibc 低于所选 Node.js 发行版的要求，必须
-使用面向旧 glibc 编译的 Node.js 运行时重新制作该平台包，或升级业务系统。仅仅在
-“更老的 Docker 镜像”里复制同一个官方 Node.js 二进制并不能降低其 glibc 下限。
+架构和 `ldd --version`。Linux x64 的 glibc 2.17 兼容性来自构建脚本选择的
+`linux-x64-glibc-217` Runtime，而不是构建 runner 的系统版本。如果业务机低于
+glibc 2.17，仍必须使用更老系统兼容的 Runtime 重新制作平台包，或升级业务系统。
+仅仅在“更老的 Docker 镜像”里复制同一个官方 Node.js 二进制并不能降低其 glibc
+下限。
 
 单文件只消除了目标机器安装 Node.js 的要求，并不会内嵌所有外部程序：
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qwen-code/arena-agent",
-  "version": "0.0.9-dev.14",
+  "version": "0.0.9-dev.15",
   "description": "A four-mode TypeScript agent harness for Arena and Code Arena traces.",
   "type": "module",
   "types": "./dist/sdk.d.ts",