autowonder 0.3.16 → 0.3.18

package/README.md

@@ -6,10 +6,10 @@ AutoWonder 本地 agent runtime。安装后启动 daemon，持续轮询本地 as
 
 ```bash
 # Qoder CLI（模型使用 provider model ID；Context Window 使用固定档位）
-npx -y autowonder@0.3.16 connect --ws-url <wss-endpoint> --token <executor-token> --executor-id <executor-id> --provider qoder --model qmodel_latest --reasoning-effort medium --context-window 260000
+npx -y autowonder@0.3.18 connect --ws-url <wss-endpoint> --token <executor-token> --executor-id <executor-id> --provider qoder --model qmodel_latest --reasoning-effort medium --context-window 260000
 
 # Qoder CLI CN
-npx -y autowonder@0.3.16 connect --ws-url <wss-endpoint> --token <executor-token> --executor-id <executor-id> --provider qodercn
+npx -y autowonder@0.3.18 connect --ws-url <wss-endpoint> --token <executor-token> --executor-id <executor-id> --provider qodercn
 ```
 
 `connect` 会安装当前 npm 包内置的 daemon，并使用页面生成的 WebSocket endpoint、Token 和执行器 ID 建立连接。客户端只支持通过 Qoder 系列 CLI 启动（`qoder` 对应 `qodercli`，`qodercn` 对应 `qodercn`），其他 `--provider` 取值会在启动 daemon 前直接报错拦截并提示 `Unsupported provider`。选择 Qoder CLI 或 Qoder CLI CN 时需要 Node.js 20+；runtime 会在缺少对应 CLI 时自动通过 npm 安装，并在尚未登录时打开浏览器登录。runtime 会继承当前用户的 HOME、环境变量和 CLI 登录状态。
@@ -99,20 +99,26 @@ daemon 重启或崩溃后重新接管未完成的派单时，runtime 不会直
 
 ## 自动更新
 
-安装首个支持自动更新的正式版本后，daemon 会直接查询 npm 的 `autowonder/latest`。首次检查会随机分散在启动后的 30～90 秒，之后约每 5 分钟检查一次并加入随机抖动；npm 临时错误会指数退避，HTTP 429/503 的 `Retry-After` 会被遵循。发现更高的稳定版本时，它会在后台下载 npm tarball，校验 SHA-512 SRI、包版本和平台二进制；只有在没有运行/恢复任务且结果 outbox 已收到服务端确认时，才会暂停接单、原子切换二进制并自动重启。启动失败会恢复上一个二进制。
+daemon 不会自行追新：后台自动更新策略默认关闭，且没有环境变量可以重新开启，因此 daemon 不会主动查询 npm 的 `autowonder/latest`、下载、安装或重启。版本由平台决定，见下文的服务端指定版本升级；没有服务端升级指令时，即使本地配置了更短的检查周期也不会产生任何 npm 请求。
 
-用户不需要再次手工 stop、install 和 start。源码构建、开发版本、预发布版本和 Windows 默认不自动更新。
+升级能力与后台策略是两件事：标准安装的正式版 daemon 仍会初始化升级器并在心跳里上报远程升级能力，因此平台可以下发指定版本的升级指令。收到 `EXECUTOR_UPGRADE`（或 `EXECUTOR_RESTART` 且 `update=true`）后，daemon 才会按指令解析 npm tarball、校验 SHA-512 SRI、包版本和平台二进制；只有在没有运行/恢复任务且结果 outbox 已收到服务端确认时，才会暂停接单、原子切换二进制并重启。启动失败会恢复上一个二进制。
 
-```bash
-# 禁用自动更新
-AUTOWONDER_AUTO_UPDATE=false npx -y autowonder@latest connect ...
+源码构建、开发版本、非标准安装路径、预发布版本和 Windows 不上报升级能力，也不支持远端升级。
 
-# 调整检查周期或使用兼容的 npm registry
-AUTOWONDER_AUTO_UPDATE_INTERVAL=1h \
+```bash
+# 使用兼容的 npm registry（仅影响按平台指令解析版本时使用的源）
 AUTOWONDER_NPM_REGISTRY=https://registry.npmjs.org \
 npx -y autowonder@latest connect ...
 ```
 
+## 在线应用启动命令
+
+支持版本的 Linux/macOS 执行器会声明 `EXECUTOR_LAUNCH_COMMAND_V1`。管理员可在平台“启动命令 → 编辑完整命令”中修改固定发布版本、`--workspace-root`、`--name`、`--debug` 及已有启动参数，保存后在线应用。连接地址、Token、执行器 ID、provider 和 Token 代理参数不可修改，不执行任意 Shell 命令。
+
+同版本空闲时用新参数 exec；切换到更高稳定版本要求二进制安装在 `~/.autowonder/bin/autowonder-daemon`，复用 npm tarball SHA-512、包版本、平台二进制和候选自检，再原子切换。失败保留原程序并在支持的故障路径回滚，不支持在线降级。源码构建仅支持保持当前版本的参数应用，Windows 不声明在线应用能力。旧客户端需要先本地安装一次支持版本。
+
+工作目录切换前必须没有运行/恢复任务，且原目录的结果 outbox 已全部确认；默认本地队列仍有待执行或已领取任务时也会拒绝切换。目标目录必须可写；历史任务文件保留在原目录，不自动迁移或删除。未指定目录和名称时在线应用沿用当前值，仅更新其他参数不会移动本地队列。
+
 候选版本缓存在 `~/.autowonder/updates/`；当前二进制和单个回滚副本位于 `~/.autowonder/bin/`。`GET /health` 会返回 `daemonVersion`、`updateState`、`updateTarget` 和 `updateError`。
 
 daemon 建立连接时和每次心跳定时检查时发出的 `HEARTBEAT` 帧都带上 `version` 字段，取值为该二进制构建时注入的发布版本号（`currentReleaseIdentity().Version`，与 `--self-check` 报告的版本同源）；版本为空时该字段不出现在帧里。服务端据此记录每台执行机实际运行的客户端版本并在执行器列表展示，为后续客户端批量升级提供数据基础。对执行机用户无新增参数或环境变量。
@@ -167,7 +173,7 @@ mv "$queue/.assignment.tmp" "$queue/assignment.json"
 也可以直接提交到本地 API：
 
 ```bash
-npx -y autowonder@0.3.16 dispatch ./assignment.json
+npx -y autowonder@0.3.18 dispatch ./assignment.json
 ```
 
 ## 上传工单附件
@@ -175,7 +181,7 @@ npx -y autowonder@0.3.16 dispatch ./assignment.json
 把本地需求/设计文档直接上传到工单，避免在会话里传递大文件：
 
 ```bash
-npx -y autowonder@0.3.16 workitem upload --server-url <autowonder-server-url> --workitem-id <id> --file <filepath-1> --file <filepath-2> --json
+npx -y autowonder@0.3.18 workitem upload --server-url <autowonder-server-url> --workitem-id <id> --file <filepath-1> --file <filepath-2> --json
 ```
 
 上传令牌通过 MCP 工具 `autowonder.workitem_cli_upload_token` 签发，经 `--token` 或 `AUTOWONDER_UPLOAD_TOKEN` 环境变量传入。`--file` 可重复指定多个文件；`--json` 输出机器可读结果。失败时按错误类型返回不同退出码（401→3、403→4、404→5、409→6、413→7、其他 4xx→8、网络/重定向→9）。
@@ -185,7 +191,7 @@ npx -y autowonder@0.3.16 workitem upload --server-url <autowonder-server-url> --
 把工单上已有的需求/设计文档下载到本地目录，再用本地文件工具阅读，避免把大文件或二进制附件搬进会话上下文：
 
 ```bash
-npx -y autowonder@0.3.16 workitem download --server-url <autowonder-server-url> --workitem-id <id> --file <name-or-id> --output-dir <dir> --json
+npx -y autowonder@0.3.18 workitem download --server-url <autowonder-server-url> --workitem-id <id> --file <name-or-id> --output-dir <dir> --json
 ```
 
 下载令牌通过 MCP 工具 `autowonder.workitem_cli_download_token` 签发（与上传令牌相互独立），经 `--token` 或 `AUTOWONDER_DOWNLOAD_TOKEN` 环境变量传入。`--file` 可重复指定文档名或 artifact id，省略则下载该工单的全部附件；`--output-dir` 默认为当前目录；`--json` 输出机器可读结果，含每个文件的 `id`、`name`、`path`、`size`。退出码约定与 `workitem upload` 相同（401→3、403→4、404→5、409→6、413→7、其他 4xx→8、网络/重定向→9）。
@@ -195,7 +201,7 @@ npx -y autowonder@0.3.16 workitem download --server-url <autowonder-server-url>
 把需求/设计文档上传到 7x24 定时任务，用法与工单附件一致（同一套上传令牌与预检规则）：
 
 ```bash
-npx -y autowonder@0.3.16 scheduled-task upload --server-url <autowonder-server-url> --scheduled-task-id <id> --file <filepath-1> --file <filepath-2> --json
+npx -y autowonder@0.3.18 scheduled-task upload --server-url <autowonder-server-url> --scheduled-task-id <id> --file <filepath-1> --file <filepath-2> --json
 ```
 
 上传令牌同样通过 `autowonder.workitem_cli_upload_token` 签发（令牌为用户级，对当前可修改的任意定时任务生效），经 `--token` 或 `AUTOWONDER_UPLOAD_TOKEN` 传入；退出码约定与 `workitem upload` 相同。
@@ -203,8 +209,8 @@ npx -y autowonder@0.3.16 scheduled-task upload --server-url <autowonder-server-u
 ## 管理 daemon
 
 ```bash
-npx -y autowonder@0.3.16 status
-npx -y autowonder@0.3.16 stop
+npx -y autowonder@0.3.18 status
+npx -y autowonder@0.3.18 stop
 ```
 
 默认 API 是 `http://127.0.0.1:34989`，日志位于 `~/.autowonder/daemon.log`。npm 包不包含任何 agent、MCP 或服务端凭证。
@@ -212,7 +218,7 @@ npx -y autowonder@0.3.16 stop
 ## 调试
 
 ```bash
-npx -y autowonder@0.3.16 connect ... --debug
+npx -y autowonder@0.3.18 connect ... --debug
 ```
 
 `--debug` 会让 CLI 以 `AUTOWONDER_DEBUG=1` 启动 daemon，把完整的 daemon 与 agent 活动（runtime 事件流、provider 事件解码、重试退避与会话门等待、空闲时的阻塞点）同时输出到控制台和会话调试日志。调试日志不做脱敏，仅用于本机排障；不传 `--debug` 时该环境变量不会注入。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "autowonder",
-  "version": "0.3.16",
+  "version": "0.3.18",
   "description": "AutoWonder local runtime — execute AI agent dispatch packages on your machine",
   "bin": {
     "autowonder": "bin/cli.js"