@best-agent/cli-darwin-arm64 0.0.17-beta.1 → 0.0.17-beta.2

package/README.md

@@ -59,8 +59,66 @@ Home 或 chat 的空输入框中，用前缀明确选择是否把结果交给模
 
 ## 安装与发布
 
+无需安装 Node 或 npm：在 [GitHub Releases](https://github.com/Simon-He95/best-agent/releases) 下载当前系统与 CPU 对应的 `best-agent-<version>-<target>.tar.gz`（Windows 为 `.zip`），以及同名 `.sha256`。Linux 当前支持 glibc，不支持 Alpine/musl。
+
+macOS / Linux：先在下载目录校验 `shasum -a 256 -c <archive>.sha256`（Linux 也可用 `sha256sum -c`），然后：
+
+```sh
+tar -xzf best-agent-<version>-<target>.tar.gz
+cd best-agent-<version>-<target>
+sh install.sh
+"$HOME/.local/bin/best-agent" chat
+```
+
+默认安装到 `$HOME/.local/lib/best-agent`，命令位于 `$HOME/.local/bin`；把该 bin 目录加入 PATH 后可直接使用 `best-agent` 或 `b8`。自定义位置使用 `sh install.sh "/absolute/install prefix"`。安装脚本不修改 shell 配置；更新时安装新归档即可，用户配置与聊天记录保留。
+
+Windows：用 `Get-FileHash <archive>.zip -Algorithm SHA256` 与同名 `.sha256` 中的值比对，解压后在 PowerShell 中执行：
+
+```powershell
+powershell -NoProfile -ExecutionPolicy Bypass -File .\install.ps1
+& "$env:LOCALAPPDATA\Programs\best-agent\bin\best-agent.exe" chat
+```
+
+可用 `-Prefix "C:\absolute\install prefix"` 自定义目录；把安装目录的 `bin` 加入 PATH 后可使用 `best-agent` 和 `b8`。
+归档已包含运行时、CPU supervisor 与所需依赖，解压目录可以在安装后删除。由用户配置启动的外部工具（例如依赖 `npx` 的 MCP server）仍需各自的运行环境。
+
 - `npm install -g @best-agent/cli@beta`：安装当前平台的 CLI 包；
-- `pnpm pack:tui`：构建并 smoke-test 当前平台包；
+- `pnpm pack:tui`：构建当前平台 npm 包和独立归档，执行安装与启动验收；
+- `pnpm distribute:cli`：从干净的源码 commit 推送六平台 CI 请求，全部验收通过后分发 GitHub Release，不发布 npm；
 - `pnpm release:cli --artifact-root .tmp/sea --tag beta --dry-run`：验证发布产物。
 
+只打包当前机器的平台，不发布：
+
+```sh
+pnpm install --frozen-lockfile
+pnpm pack:tui
+```
+
+六平台公开分发使用 [best-agent-releases](https://github.com/Simon-He95/best-agent-releases)。先提交源码改动，再运行 `pnpm distribute:cli`：命令会推送当前私有源码 commit，仅将公开构建模板和 commit/version 请求同步到分发仓库并触发 CI。CI 使用源码仓库的只读 deploy key；源码仓库保持 private。
+
+全部六平台的免 Node／不可用旧 Node 安装和真实 PTY／ConPTY 交互、原生依赖及 CPU supervisor 检查通过后，Release 提供六份独立归档、六份平台 npm tarball 和一份完整入口 npm tarball，以及校验值和验收摘要。失败时保留未发布草稿，原始诊断及内部构建报告只以加密形式传输；最终 Release 不携带它们。该命令不发布 npm registry。公开分发的 SEA 仍包含可被分析的程序代码，不提供不可逆向的保证。
+
+在 Apple Silicon Mac 上，产物为：
+
+```text
+.tmp/npm/best-agent-cli-<version>.tgz
+.tmp/npm/best-agent-cli-darwin-arm64-<version>.tgz
+.tmp/sea/darwin-arm64/best-agent-<version>-darwin-arm64.tar.gz
+.tmp/sea/darwin-arm64/best-agent-<version>-darwin-arm64.tar.gz.sha256
+```
+
+npm 分发需要入口包和匹配的平台包两者；可将两个 `.tgz` 一并交给对方，通过 `npm install -g <platform.tgz> <cli.tgz>` 安装，运行依赖仍由 npm 获取。免 Node 的独立分发使用 `.tar.gz`/`.zip`。Intel Mac 在 x64 Mac/runner 上运行同一命令，产物 target 为 `darwin-x64`；不能把 arm64 包重命名为 x64 包。
+
+已有单平台产物时，只做发布预检（不发布）：
+
+```sh
+pnpm release:cli --artifact-root .tmp/sea --targets darwin-arm64 --allow-partial --tag beta --dry-run
+```
+
+其余平台在对应 OS/CPU 环境运行同一条 `pnpm pack:tui`，再收集 `.tmp/sea/<target>/`。构建机需要 `.nvmrc` 中的 Node、pnpm、原生 C 编译器（macOS/Linux 的 clang，Windows 中目标架构与 Node 一致的 Developer PowerShell / MSVC `cl`）；POSIX 验收还需要 Python 3 和 pip。Linux 验收环境使用 Ubuntu 24.04；按需安装的 OCR 原生库要求 glibc ≥2.38，不能把 Debian 12 上的 OCR 失败当成 Node 启动失败。
+
+Linux 构建还需要 binutils 的 `strip`：仅在注入 SEA 前去除 SDK 原生调试信息，保留函数符号；不要对已注入的产物再次执行 strip。
+
+Windows 打包验收会在 `.tmp/standalone-pty-runner` 安装固定版本的 ConPTY 驱动及终端屏幕解析器，POSIX 屏幕解析器放在 `.tmp/standalone-python`；它们都不进入 npm 包或独立归档。最终独立归档的安装和启动不要求用户安装 Node、Python 或编译器。
+
 本地开发使用仓库根目录的 `pnpm build`、`pnpm test:cli` 与相关 capability 测试。

package/bin/best-agent

@@ -1,4 +1,4 @@
 [diffend] Oversized file quarantined before diffing.
 name: package/bin/best-agent
-size: 134430592 bytes
-sha256: 759bbb4e50ab021503edea1fc37fbd6644dfed232e3d15613092c2e8a939619d
+size: 135249664 bytes
+sha256: 9099b164b3c8ff2cdca7c3a2ca0dea943e73b454be2cbe348ac7dcb8a0d2b024

package/package.json

@@ -1,6 +1,10 @@
 {
   "name": "@best-agent/cli-darwin-arm64",
-  "version": "0.0.17-beta.1",
+  "version": "0.0.17-beta.2",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Simon-He95/best-agent-releases.git"
+  },
   "description": "best-agent CLI native executable for darwin-arm64",
   "os": [
     "darwin"