@coboot/headless 0.2.2-rc.8 → 0.2.2-rc.9

package/README.md

@@ -6,7 +6,7 @@ Headless 业务运行时要求 Node.js 20+；当入口检测到 Node.js 18/19
 首次启动只需一次性设备 token：
 
 ```bash
-npx -y @coboot/headless@0.2.2-rc.8 '<device-token>'
+npx -y @coboot/headless@0.2.2-rc.9 '<device-token>'
 ```
 
 Siboot 和 Coboot 都继承入口进程的运行身份：入口是 root 就以 root 运行，入口是普通用户就以该用户运行。
@@ -38,10 +38,10 @@ detached daemon 并退出。不需要设置 `BACKEND_URL`、`CLIENT_UID`。终
 并重新启动旧 client，不会让两个 Headless 进程争抢同一台物理机的 Driver 锁。
 
 ```bash
-npx -y @coboot/headless@0.2.2-rc.8 status
-npx -y @coboot/headless@0.2.2-rc.8 logs
-npx -y @coboot/headless@0.2.2-rc.8 restart
-npx -y @coboot/headless@0.2.2-rc.8 stop
+npx -y @coboot/headless@0.2.2-rc.9 status
+npx -y @coboot/headless@0.2.2-rc.9 logs
+npx -y @coboot/headless@0.2.2-rc.9 restart
+npx -y @coboot/headless@0.2.2-rc.9 stop
 ```
 
 更新到 npm `latest` 并重启：
@@ -53,6 +53,25 @@ npx -y @coboot/headless@latest update
 `update` 会先完成 Node.js 版本、设备凭证和新包完整性预检，再停止旧进程并切换版本；新版本启动失败时
 会自动恢复并重启旧版本。`restart` 只重启已经安装的版本，不再隐式替换运行时。
 
+
+页面下发更新时，端侧 updater 使用显式包名和可执行文件调用：
+
+```bash
+npx -y --package=@coboot/headless@<target-version> coboot-headless update
+```
+
+这样不会把 Node.js 18/19 引导遗留的 `npm_config_package=node@22` 当成更新包，避免出现
+`sh: @coboot/headless@<version>: No such file or directory`（退出码 127）。更新失败且仍在旧版本时，
+只有本次调用日志明确记录 `runtime_replace phase=rolled_back` 才上报已回滚；安装前失败上报失败，
+当天历史日志中的回滚记录不作为本次回滚证据。
+
+该修复需要重新发布 npm 包；仅合入源码不会修复已安装的 updater。旧版本应先使用上面的显式命令
+安装包含修复的新版本，再验收后续页面更新。测试环境继续传入匹配的 endpoint 覆盖变量，
+并保持同一运行账号、数据根和工作目录。验收时核对 `.coboot/current/manifest.json` 的版本、
+`run/status.json` 的 `client_ready` 与 `client_version`，以及 `run/runtime-update-state.json`
+的 `phase` 和 `actual_version`；日志位于 `.coboot/logs/update/`。
+
+
 一般不需要修改数据目录。确需放到其他位置时，用 `COBOOT_DATA_ROOT` 指定一个当前用户可写的绝对路径。
 
 
@@ -66,8 +85,8 @@ Coboot 将安装位置写入用户默认应用目录的 `installation.json`（
 Agent 默认工作目录可在首次绑定或重启时单独指定，必须是已存在的绝对目录：
 
 ```bash
-npx -y @coboot/headless@0.2.2-rc.8 '<device-token>' --workspace-dir /home/demo/project
-npx -y @coboot/headless@0.2.2-rc.8 restart --workspace-dir /home/demo/another-project
+npx -y @coboot/headless@0.2.2-rc.9 '<device-token>' --workspace-dir /home/demo/project
+npx -y @coboot/headless@0.2.2-rc.9 restart --workspace-dir /home/demo/another-project
 ```
 
 该设置会保存；任务明确选中的本机目录优先于安装默认值。Bash cwd 和相对文件路径使用同一默认值，
@@ -85,13 +104,13 @@ Coboot daemon 默认禁用 updater 和浏览器预热，第一次调用 `browser
 
 ```bash
 HEADLESS_BROWSER_EXECUTABLE=/absolute/path/to/chrome \
-  npx -y @coboot/headless@0.2.2-rc.8 '<device-token>'
+  npx -y @coboot/headless@0.2.2-rc.9 '<device-token>'
 ```
 
 需要安装浏览器时，由用户执行：
 
 ```bash
-npx -y @coboot/headless@0.2.2-rc.8 install-browser
+npx -y @coboot/headless@0.2.2-rc.9 install-browser
 ```
 
 该命令不需要设备 token，也不要求 root。它会先检查现有浏览器并执行启动验证；浏览器已经可用时
@@ -129,7 +148,7 @@ dnf/yum 先试仓库中的 `chromium`，x86_64 回退到官方 RPM 并关闭 wea
 自动化或排障需要显式表达重新注册时，也可以使用：
 
 ```bash
-npx -y @coboot/headless@0.2.2-rc.8 --force-enroll '<device-token>'
+npx -y @coboot/headless@0.2.2-rc.9 --force-enroll '<device-token>'
 ```
 
 当本地已经存在设备身份时，该命令与再次传入 positional token 使用同一套事务式替换流程。
@@ -166,7 +185,7 @@ HTTP 与 WebSocket 必须同域并与设备 token 匹配：
 HEADLESS_ALLOW_ENDPOINT_OVERRIDE=1 \
 BACKEND_URL=https://example.com \
 WS_URL=wss://example.com/wsschat \
-npx -y @coboot/headless@0.2.2-rc.8 '<device-token>'
+npx -y @coboot/headless@0.2.2-rc.9 '<device-token>'
 ```
 
 WebSocket 覆盖变量名是 `WS_URL`，不是 `WSS_URL`。
@@ -180,7 +199,7 @@ endpoint 覆盖同样不会写入配置；后续执行 `restart` 时必须再次
 CU_EDITION=coboot \
 PKG_NAME=@coboot/headless \
 PKG_BIN_NAME=coboot-headless \
-PKG_VERSION=0.2.2-rc.8 \
+PKG_VERSION=0.2.2-rc.9 \
 pnpm build:headless:npm
 ```
 
@@ -188,8 +207,8 @@ pnpm build:headless:npm
 
 ```bash
 npm pack --dry-run --json ./dist-headless
-tar -xOf dist-headless/coboot-headless-0.2.2-rc.8.tgz package/package.json
-sha256sum dist-headless/coboot-headless-0.2.2-rc.8.tgz
+tar -xOf dist-headless/coboot-headless-0.2.2-rc.9.tgz package/package.json
+sha256sum dist-headless/coboot-headless-0.2.2-rc.9.tgz
 ```