@alicloud/autowonder 0.3.39 → 0.3.41

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -18,10 +18,10 @@ Browser Use 的源码、测试、依赖和发布统一在本 runtime 仓库维
18
18
 
19
19
  ```bash
20
20
  # Qoder CLI(模型使用 provider model ID;Context Window 使用固定档位)
21
- npx -y @alicloud/autowonder@0.3.39 connect --ws-url <wss-endpoint> --token <executor-token> --executor-id <executor-id> --provider qoder --model qmodel_latest --reasoning-effort medium --context-window 260000
21
+ npx -y @alicloud/autowonder@0.3.41 connect --ws-url <wss-endpoint> --token <executor-token> --executor-id <executor-id> --provider qoder --model qmodel_latest --reasoning-effort medium --context-window 260000
22
22
 
23
23
  # Qoder CLI CN
24
- npx -y @alicloud/autowonder@0.3.39 connect --ws-url <wss-endpoint> --token <executor-token> --executor-id <executor-id> --provider qodercn
24
+ npx -y @alicloud/autowonder@0.3.41 connect --ws-url <wss-endpoint> --token <executor-token> --executor-id <executor-id> --provider qodercn
25
25
  ```
26
26
 
27
27
  `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 登录状态。
@@ -55,7 +55,9 @@ daemon 还在协议能力位里声明 `terminal_steer_v1`:服务端可对当
55
55
 
56
56
  daemon 还会响应服务端的 `CONVERSATION_COMMANDS_PROBE` 帧,用独立会话抓取该会话工作目录下可用的斜杠命令,回传 `CONVERSATION_COMMANDS_RESULT` 帧,让会话面板在用户输入 `/` 时列出真实可用的命令。该探测与回合执行完全隔离:任何失败只产生 `FAILED` / `TIMEOUT` 帧,不影响进行中的会话;provider 后端不支持抓取时同样降级为 `FAILED` 帧。帧里的 `executorId` 与本机不一致或非正数时直接忽略,避免在别的执行器工作区里建目录或启动 CLI。daemon 侧给整个探测 25 秒硬上限,刻意长于 agent 侧的 20 秒预算,使 agent 自己的超时先触发并可被归类。
57
57
 
58
- 给 `connect` 追加 `--token-aware-enable` 可开启 qoder / qodercn 的 token 用量采集:CLI 会确保本机存在一个**共享**的本地 HTTPS 转发代理(`bin/token-proxy.js`)——同一用户、同一配置根、同一端口只保留一个实例,监听者属于共享服务而不是某个 daemon,退出某个执行器不会主动停掉它,数据目录为 `~/.autowonder/token-tap/`。代理从 Qoder API 的 SSE 响应流中提取 usage 数据并按 dispatch ID 归属上报。启用的 `connect` 用已安装 daemon 提供的 `token-proxy-helper` 核验监听者身份(系统监听者 owner、用户、进程出生时间、可执行路径与参数、脚本内容、profile),核验不通过的一律拒绝接管,健康响应里的 PID 本身不足以授权终止;健康检查同时验证到回环 echo 服务的 CONNECT 转发,模型/上游错误不触发重启,只有连续三次本地故障观测才在原生锁(macOS/Linux `flock`,Windows 按用户/scope 命名 mutex)下替换进程,且每 60 秒最多 3 次重启。CA 使用不可变 generation 目录加原子 `current.json` 指针,旧版代理的可用 CA 经私有 `takeover-ca.json` 接管,替换进程绑定端口后才消费它。用量日志把旧路径与新路径显式合并并按文件维护偏移。usage 解析失败只丢失计量数据;代理不可用时仅告警并继续。代理端口可用 `TOKEN_PROXY_PORT` 环境变量调整(默认 19876,自定义端口的数据目录为 `~/.autowonder/token-tap/ports/<port>/`)。启用后模型流量经过代理,连接失败由客户端处理重试,不保证自动直连。代理对 TCP 建连和两端 TLS 握手设置 15 秒期限,对无读写活动的连接设置 120 秒空闲期限;超时、报错或任一端关闭时释放两端连接,持续有数据的 SSE 流不受总时长限制,连续静默超过 120 秒的流会断开。平台差异:Linux 恢复依赖 pidfd(Linux 5.3+)且锁目录必须是受支持的本地文件系统(不支持 NFS/virtiofs);Windows 原生恢复只在 amd64 验证,ARM64 与 32 位 Node 未验证;macOS 在发信号前重新核对进程出生时间,但不像 pidfd/进程句柄那样原子。关键生命周期事件写入 `~/.autowonder/token-tap/lifecycle.log`。
58
+ 给 `connect` 追加 `--token-aware-enable` 可开启 qoder / qodercn 的 token 用量采集:CLI 会确保本机存在一个**共享**的本地 HTTPS 转发代理(`bin/token-proxy.js`)——同一用户、同一配置根、同一端口只保留一个实例,监听者属于共享服务而不是某个 daemon,退出某个执行器不会主动停掉它,数据目录为 `~/.autowonder/token-tap/`。代理从 Qoder API 的 SSE 响应流中提取 usage 数据并按 dispatch ID 归属上报。启用的 `connect` 用已安装 daemon 提供的 `token-proxy-helper` 核验监听者身份(系统监听者 owner、用户、进程出生时间、可执行路径与参数、脚本内容、profile),核验不通过的一律拒绝接管,健康响应里的 PID 本身不足以授权终止;健康检查同时验证到回环 echo 服务的 CONNECT 转发,模型/上游错误不触发重启,只有连续三次本地故障观测在原生锁(macOS/Linux `flock`,Windows 按用户/scope 命名 mutex)下确认后才替换进程,且每 60 秒最多 3 次重启。CA 使用不可变 generation 目录加原子 `current.json` 指针,旧版代理的可用 CA 经私有 `takeover-ca.json` 接管,替换进程绑定端口后才消费它。用量日志把旧路径与新路径显式合并并按文件维护偏移。usage 解析失败只丢失计量数据;启动时必须准备好已核验的代理,运行中恢复失败会告警,模型请求仍可能失败。代理端口可用 `TOKEN_PROXY_PORT` 环境变量调整(默认先尝试 19876,其他端口的数据目录为 `~/.autowonder/token-tap/ports/<port>/`)。启用后模型流量经过代理,连接失败由客户端处理重试,不保证自动直连。代理对 TCP 建连和两端 TLS 握手设置 15 秒期限,对无读写活动的连接设置 120 秒空闲期限;超时、报错或任一端关闭时释放两端连接,持续有数据的 SSE 流不受总时长限制,连续静默超过 120 秒的流会断开。平台差异:Linux 恢复依赖 pidfd(Linux 5.3+)且锁目录必须是受支持的本地文件系统(不支持 NFS/virtiofs);Windows 原生恢复只在 amd64 验证,ARM64 与 32 位 Node 未验证;macOS 在发信号前重新核对进程出生时间,但不像 pidfd/进程句柄那样原子。关键生命周期事件写入所选端口数据目录的 `lifecycle.log`。
59
+
60
+ 未显式设置 `TOKEN_PROXY_PORT` 时,如果默认端口已有无法核验的代理(例如其他脚本版本),`connect` 会自动选择独立实例,保留已有进程。候选端口根据配置根与当前脚本内容稳定生成,最多检查 8 个,共用原来的启动时限;并发及重复启动可复用同一个已核验实例。新 daemon 的端口、CA、scope 与用量日志一并切换,仍采集 token 用量。显式指定端口时保留原有报错;已经启动的 daemon 的 watcher 只恢复其原端口,不在运行中换端口。
59
61
 
60
62
  `connect` 支持 `--workspace-root <path>` 指定 dispatch 仓库与任务工作区所在目录(默认 `~/autowonder_workspaces`)。该参数会转发给 daemon,等价于设置 `AUTOWONDER_WORKSPACE_ROOT` 环境变量,适合把工作区放在非默认路径的执行机上(如 Windows 的 `D:\autowonder`)。
61
63
 
@@ -141,7 +143,7 @@ daemon 不会自行追新:后台自动更新策略默认关闭,且没有环
141
143
 
142
144
  升级能力与后台策略是两件事:文件名为 `autowonder-daemon` 的稳定版 daemon 会按当前二进制的真实路径初始化升级器并在心跳里上报远程升级能力,因此平台可以下发指定版本的升级指令。收到 `EXECUTOR_UPGRADE`(或 `EXECUTOR_RESTART` 且 `update=true`)后,daemon 才会按指令解析 npm tarball、校验 SHA-512 SRI、包版本和平台二进制;只有在没有运行/恢复任务且结果 outbox 已收到服务端确认时,才会暂停接单、原子切换二进制并重启。启动失败会恢复上一个二进制。
143
145
 
144
- 自定义安装目录(例如 `~/workspace/<release>/bin/`)同样支持在线升级,无需登记固定路径。开发版本、预发布版本、其他二进制文件名和 Windows 不上报升级能力;安装目录不可写或升级状态无法恢复时,也无法初始化升级器。符号链接按其实际目标处理,目标文件名仍须为 `autowonder-daemon`。
146
+ 自定义安装目录(例如 `~/workspace/<release>/bin/`)同样支持在线升级,无需登记固定路径。开发版本、预发布版本和其他二进制文件名不上报升级能力;安装目录不可写或升级状态无法恢复时,也无法初始化升级器。符号链接按其实际目标处理,目标文件名仍须为 `autowonder-daemon`(Windows 为 `autowonder-daemon.exe`)。
145
147
 
146
148
  ```bash
147
149
  # 使用兼容的 npm registry(仅影响按平台指令解析版本时使用的源)
@@ -153,9 +155,9 @@ npx -y @alicloud/autowonder@latest connect ...
153
155
 
154
156
  支持版本的 Linux/macOS 执行器会声明 `EXECUTOR_LAUNCH_COMMAND_V1`。管理员可在平台“启动命令 → 编辑完整命令”中修改固定发布版本、`--workspace-root`、`--name`、`--debug` 及已有启动参数,保存后在线应用。连接地址、Token、执行器 ID、provider 和 Token 代理参数不可修改,不执行任意 Shell 命令。
155
157
 
156
- 同版本空闲时用新参数 exec;切换到更高稳定版本要求当前稳定版二进制名为 `autowonder-daemon`,其实际安装目录可写且升级器初始化成功,复用 npm tarball SHA-512、包版本、平台二进制和候选自检,再原子切换。失败保留原程序并在支持的故障路径回滚,不支持在线降级。未标记稳定版本的源码构建仅支持保持当前版本的参数应用,Windows 不声明在线应用能力。旧客户端需要先本地安装一次支持版本。
158
+ 同版本空闲时用新参数 exec;切换到更高稳定版本要求当前稳定版二进制名为 `autowonder-daemon`,其实际安装目录可写且升级器初始化成功,复用 npm tarball SHA-512、包版本、平台二进制和候选自检,再原子切换。失败保留原程序并在支持的故障路径回滚,不支持在线降级。未标记稳定版本的源码构建仅支持保持当前版本的参数应用,Windows 通过稳定父进程与受管工作进程执行在线应用。旧客户端需要先本地安装一次支持版本。
157
159
 
158
- 启动命令可携带可选的 `restartMode`,取值为 `WHEN_IDLE` 或 `FORCE`。未提供时仅在本机完全空闲时应用,繁忙时拒绝并回执失败;`WHEN_IDLE` 会立即关闭接单入口,等待运行中任务与会话结束后再重启,等待期间每 30 秒以 `EXECUTOR_RESTART_RESULT` 的 `WAITING_IDLE` 状态回执;`FORCE` 同样立即关闭接单入口,但不等运行中任务,仍要求结果 outbox 可读后立即重启。非法取值会在产生任何重启副作用前被拒绝。Linux/macOS 执行器在心跳中通过 `EXECUTOR_RESTART_POLICY_V1` 声明支持该策略。
160
+ 启动命令可携带可选的 `restartMode`,取值为 `WHEN_IDLE` 或 `FORCE`。未提供时仅在本机完全空闲时应用,繁忙时拒绝并回执失败;`WHEN_IDLE` 会立即关闭接单入口,等待运行中任务与会话结束后再重启,等待期间每 30 秒以 `EXECUTOR_RESTART_RESULT` 的 `WAITING_IDLE` 状态回执;`FORCE` 同样立即关闭接单入口,但不等运行中任务,仍要求结果 outbox 可读后立即重启。非法取值会在产生任何重启副作用前被拒绝。支持该策略的执行器在心跳中通过 `EXECUTOR_RESTART_POLICY_V1` 声明能力。
159
161
 
160
162
  工作目录切换前必须没有运行/恢复任务,且原目录的结果 outbox 已全部确认;默认本地队列仍有待执行或已领取任务时也会拒绝切换。目标目录必须可写;历史任务文件保留在原目录,不自动迁移或删除。未指定目录和名称时在线应用沿用当前值,仅更新其他参数不会移动本地队列。
161
163
 
@@ -165,7 +167,9 @@ daemon 建立连接时和每次心跳定时检查时发出的 `HEARTBEAT` 帧都
165
167
 
166
168
  同一批 `HEARTBEAT` 帧还带上 `model` 字段,取值为 daemon 当前生效的默认模型(`--model` 经 `AUTOWONDER_MODEL` 注入的 `cfg.DefaultModel`,即派单未指定模型时实际使用的取值);该值为空时字段不出现在帧里。服务端据此在执行器列表展示每台执行机当前使用的底层模型,与上面的 `version` 上报同一条通路。对执行机用户同样无新增参数或环境变量。
167
169
 
168
- 同一批 `HEARTBEAT` 帧还带上进程级固定的 `startedAt`(重连不重置)与继承自 re-exec 的 `restartRequestId`,并在能力位里声明 `EXECUTOR_RESTART_V1` 与 `EXECUTOR_RESTART_POLICY_V1`(Windows 均不声明);接入自动更新的 daemon 额外声明 `EXECUTOR_UPDATE_RESTART_V1`。服务端可据此下发 `EXECUTOR_RESTART`(带 `executorId`、`requestId`、ISO UTC `issuedAt` 与布尔 `update`)。本机只接受 `executorId` 与自身一致、未过期且未处理过的请求,不接收任何远端 shell 命令、可执行路径或下载地址,并以 `EXECUTOR_RESTART_RESULT`(`UPDATING` / `WAITING_IDLE` / `RESTARTING` / `FAILED`)回执,真正是否成功以下一次心跳为准。重启走既有的接单闸门:有运行中任务或结果 outbox 未确认可读时不重启,re-exec 失败会重新开放接单;`update=true` 复用既有的 registry、完整性校验、候选 self-check、安装事务与回滚,符合上述条件的稳定版支持远端拉取新版本,已是最新版的请求仍会重启,且该操作不应用平台上保存的启动配置改动。对执行机用户同样无新增参数或环境变量。
170
+ Windows 的支持版本保留原启动进程、终端与标准输入输出,由本机 supervisor 管理实际工作进程。远端升级先关闭接单入口并等待运行中的任务与会话结束,再切换到安装目录内独立的 `generations/<版本>-<SHA256>/autowonder-daemon.exe`,不覆盖占用中的 EXE。启动事务仅在目标工作进程确认初始化完成后提交;目标启动失败时最多回退一次,旧程序与原启动环境保留。共享安装目录使用文件锁协调,失败的跟随执行器不会回滚另一执行器已提交的版本。正常退出或手动停止不会触发自动重启,也不安装系统服务或要求管理员权限。已有不支持升级的 Windows 发布版仍需先在本机安装支持版本,不能靠服务端能力开关升级自身。
171
+
172
+ 同一批 `HEARTBEAT` 帧还带上进程级固定的 `startedAt`(重连不重置)与继承自 re-exec 的 `restartRequestId`,并在能力位里声明 `EXECUTOR_RESTART_V1` 与 `EXECUTOR_RESTART_POLICY_V1`(Windows 由已初始化的本机 supervisor 提供);接入自动更新的 daemon 额外声明 `EXECUTOR_UPDATE_RESTART_V1`。服务端可据此下发 `EXECUTOR_RESTART`(带 `executorId`、`requestId`、ISO UTC `issuedAt` 与布尔 `update`)。本机只接受 `executorId` 与自身一致、未过期且未处理过的请求,不接收任何远端 shell 命令、可执行路径或下载地址,并以 `EXECUTOR_RESTART_RESULT`(`UPDATING` / `WAITING_IDLE` / `RESTARTING` / `FAILED`)回执,真正是否成功以下一次心跳为准。重启走既有的接单闸门:有运行中任务或结果 outbox 未确认可读时不重启,re-exec 失败会重新开放接单;`update=true` 复用既有的 registry、完整性校验、候选 self-check、安装事务与回滚,符合上述条件的稳定版支持远端拉取新版本,已是最新版的请求仍会重启,且该操作不应用平台上保存的启动配置改动。对执行机用户同样无新增参数或环境变量。
169
173
 
170
174
  支持升级的执行器还允许服务端把整批执行机升级到指定的**已发布版本**(不再依赖各台机器安装时选定的版本),能力位为 `EXECUTOR_UPDATE_V1`。服务端下发 `EXECUTOR_UPGRADE`(带 `executorId`、`requestId`、ISO UTC `issuedAt` 与 `targetVersion`),本机只接受 `executorId` 与自身一致、`requestId` 非空且不超过 80 字符、`issuedAt` 在前后 1 分钟以内、且 `targetVersion` 为三段纯数字正式版的请求。升级按 `accepted` → `downloading` → `draining` → `applying` → `success` 逐阶段回执 `EXECUTOR_UPGRADE_RESULT`(含 `requestId`、`phase` 与该进程启动时的 `currentVersion`;新版本以下一个进程的首次心跳为准),失败则以 `failed` 帧带上错误原因——目标版本不受支持、请求过期、本机构建不支持远端升级等都会显式回执而不是静默丢弃。registry 按请求的版本号解析元数据并要求返回值与请求版本严格一致;请求版本低于当前版本时拒绝执行(服务端升级永不回滚整批执行机),已缓存但版本不符的候选不会被采用。`requestId` 会跨 re-exec 传递,服务端重放的同一请求不会触发第二次升级;同一 `requestId` 同时只允许一次尝试在飞,失败后可重试。升级复用既有的接单闸门、完整性校验、候选 self-check、安装事务与回滚。对执行机用户无新增参数或环境变量。
171
175
 
@@ -213,7 +217,7 @@ mv "$queue/.assignment.tmp" "$queue/assignment.json"
213
217
  也可以直接提交到本地 API:
214
218
 
215
219
  ```bash
216
- npx -y @alicloud/autowonder@0.3.39 dispatch ./assignment.json
220
+ npx -y @alicloud/autowonder@0.3.41 dispatch ./assignment.json
217
221
  ```
218
222
 
219
223
  ## 上传工单附件
@@ -221,7 +225,7 @@ npx -y @alicloud/autowonder@0.3.39 dispatch ./assignment.json
221
225
  把本地需求/设计文档直接上传到工单,避免在会话里传递大文件:
222
226
 
223
227
  ```bash
224
- npx -y @alicloud/autowonder@0.3.39 workitem upload --server-url <autowonder-server-url> --workitem-id <id> --file <filepath-1> --file <filepath-2> --json
228
+ npx -y @alicloud/autowonder@0.3.41 workitem upload --server-url <autowonder-server-url> --workitem-id <id> --file <filepath-1> --file <filepath-2> --json
225
229
  ```
226
230
 
227
231
  上传令牌通过 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)。
@@ -231,7 +235,7 @@ npx -y @alicloud/autowonder@0.3.39 workitem upload --server-url <autowonder-serv
231
235
  把工单上已有的需求/设计文档下载到本地目录,再用本地文件工具阅读,避免把大文件或二进制附件搬进会话上下文:
232
236
 
233
237
  ```bash
234
- npx -y @alicloud/autowonder@0.3.39 workitem download --server-url <autowonder-server-url> --workitem-id <id> --file <name-or-id> --output-dir <dir> --json
238
+ npx -y @alicloud/autowonder@0.3.41 workitem download --server-url <autowonder-server-url> --workitem-id <id> --file <name-or-id> --output-dir <dir> --json
235
239
  ```
236
240
 
237
241
  下载令牌通过 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)。
@@ -241,7 +245,7 @@ npx -y @alicloud/autowonder@0.3.39 workitem download --server-url <autowonder-se
241
245
  把需求/设计文档上传到 7x24 定时任务,用法与工单附件一致(同一套上传令牌与预检规则):
242
246
 
243
247
  ```bash
244
- npx -y @alicloud/autowonder@0.3.39 scheduled-task upload --server-url <autowonder-server-url> --scheduled-task-id <id> --file <filepath-1> --file <filepath-2> --json
248
+ npx -y @alicloud/autowonder@0.3.41 scheduled-task upload --server-url <autowonder-server-url> --scheduled-task-id <id> --file <filepath-1> --file <filepath-2> --json
245
249
  ```
246
250
 
247
251
  上传令牌同样通过 `autowonder.workitem_cli_upload_token` 签发(令牌为用户级,对当前可修改的任意定时任务生效),经 `--token` 或 `AUTOWONDER_UPLOAD_TOKEN` 传入;退出码约定与 `workitem upload` 相同。
@@ -249,8 +253,8 @@ npx -y @alicloud/autowonder@0.3.39 scheduled-task upload --server-url <autowonde
249
253
  ## 管理 daemon
250
254
 
251
255
  ```bash
252
- npx -y @alicloud/autowonder@0.3.39 status
253
- npx -y @alicloud/autowonder@0.3.39 stop
256
+ npx -y @alicloud/autowonder@0.3.41 status
257
+ npx -y @alicloud/autowonder@0.3.41 stop
254
258
  ```
255
259
 
256
260
  默认 API 是 `http://127.0.0.1:34989`,日志位于 `~/.autowonder/daemon.log`。npm 包不包含任何 agent、MCP 或服务端凭证。
@@ -273,7 +277,7 @@ daemon 内置独立于工作区 GC 的保留清扫:默认每小时运行一次
273
277
  ## 调试
274
278
 
275
279
  ```bash
276
- npx -y @alicloud/autowonder@0.3.39 connect ... --debug
280
+ npx -y @alicloud/autowonder@0.3.41 connect ... --debug
277
281
  ```
278
282
 
279
283
  `--debug` 会让 CLI 以 `AUTOWONDER_DEBUG=1` 启动 daemon,把完整的 daemon 与 agent 活动(runtime 事件流、provider 事件解码、重试退避与会话门等待、空闲时的阻塞点)同时输出到控制台和会话调试日志。调试日志不做脱敏,仅用于本机排障;不传 `--debug` 时该环境变量不会注入。
@@ -281,3 +285,11 @@ npx -y @alicloud/autowonder@0.3.39 connect ... --debug
281
285
  daemon 把仅用于展示的事件(`text`、`thinking`、`log`、`thinking_started`、`thinking_completed`)放进有界单协程队列(4096 条 / 16 MiB,关闭时最多等待 5 秒排水),与业务事件处理隔离:展示通道变慢或阻塞不会拖住工具、卡片、回执等业务控制事件。排队溢出或未送达只计入丢失量,并以 `provider_observation_delivery_summary` 事件和结果里的 `observationLoss` 元数据上报。诊断/日志写入失败不会把已成功的业务执行变成投递失败,完成边界后的 diagnostic flush 错误也不会凭空创建 completion 投递所有权。该机制对执行机用户无新增参数或环境变量。
282
286
 
283
287
  `--debug` 之外还有一条由服务端驱动的班组调试日志采集通道,两者互不依赖。runtime 在 `protocolFeatures` 中声明 `DEBUG_LOG_V1`,服务端只会给声明了该能力位的 runtime 下发 `debugLog` 策略;策略在打包时冻结进 assignment(`enabled` / `maxBytes` / `uploadUrl`),执行期不再变化。开启后 runtime 会把本轮完整调试日志写到 capsule 内,单轮硬上限默认 200MB(可由 `debugLog.maxBytes` 覆盖),所在卷剩余空间低于 2GB 时停止写入,单条记录超过 8MB 会被截断并打标记。它是旁路设计:写入队列满时丢行而不反压任务热路径,收尾等待最多 5 秒。回合结束时按 `DIRECT`(对象存储预签名 PUT)或 `RELAY`(服务端中转)通道上传,结果以 `debugLog` 段附在 `TASK_RESULT` 上(`status` 为 `UPLOADED` / `FAILED`,含字节数与 SHA-256);报告里的错误文本会把 URL 查询串替换为 `<redacted>`,避免执行器令牌或对象存储签名外泄。
288
+
289
+ ### Windows 在线升级保留边界
290
+
291
+ Windows 通过保持原终端父进程的 supervisor 切换不可变程序目录,空闲排水后启动新版本,启动失败恢复本执行器最后可用版本。已发布的不具备此能力的旧 Windows 程序必须先本地安装支持版本,不能靠服务端能力声明直接升级。
292
+
293
+ 当前实现保留最多 16 个 generation、总计 2 GiB;更新缓存也限制为 16 个版本、2 GiB,并为下载与解压临时文件预留空间,因此可能提前拒绝新升级。达到容量上限会报告明确错误,原程序和任务继续运行。这是容量准入,不是自动清理。维护时应先停止所有使用该安装目录的执行器,再备份或移除确认不用的历史版本;不要在线删除 generation,其他执行器可能已经选择但尚未打开它。
294
+
295
+ supervisor lease 按服务端和执行器身份复用;每个身份保留一份升级收据和一份结果恢复文件,不保存 token 或启动环境。更换执行器身份产生的历史文件由安装目录生命周期管理,不提供无限历史身份自动清理。只读且没有升级 journal 的安装仍可普通启动,但不声明在线升级和远程重启能力。
package/bin/cli.js CHANGED
@@ -507,18 +507,26 @@ async function cmdConnect(args) {
507
507
  // The listener belongs to the shared service, never to an individual daemon.
508
508
  let stopProxyWatch = () => {};
509
509
  if (flags["token-aware-enable"]) {
510
- const { configuration, ensureSharedProxy, watchSharedProxy } = require("./token-proxy-manager");
510
+ const { configuration, ensureConnectProxy, watchSharedProxy } = require("./token-proxy-manager");
511
511
  const proxy = configuration();
512
512
  proxy.debug = Boolean(flags.debug);
513
513
  proxy.helper = DAEMON_BIN;
514
- const ready = await ensureSharedProxy(proxy);
514
+ const requestedProxyPort = proxy.port;
515
+ const ready = await ensureConnectProxy(proxy);
516
+ if (proxy.port !== requestedProxyPort) {
517
+ log(`Existing TokenProxy on ${requestedProxyPort} cannot be reused; using a separate instance on ${proxy.port}`);
518
+ }
515
519
  env.AUTOWONDER_TOKEN_PROXY_PORT = String(proxy.port);
516
520
  env.AUTOWONDER_TOKEN_PROXY_MANAGED = "1";
517
521
  env.AUTOWONDER_TOKEN_PROXY_LEGACY_ALLOWED = "1";
518
522
  env.AUTOWONDER_TOKEN_PROXY_BASE_DIR = proxy.baseDir;
519
523
  env.AUTOWONDER_TOKEN_PROXY_NODE_PATH = process.execPath;
520
524
  env.AUTOWONDER_TOKEN_PROXY_SCRIPT_PATH = path.join(__dirname, "token-proxy.js");
521
- env.AUTOWONDER_TOKEN_PROXY_LEGACY_USAGE_LOG = path.join(proxy.baseDir, "token-usage.jsonl");
525
+ if (proxy.port === requestedProxyPort) {
526
+ env.AUTOWONDER_TOKEN_PROXY_LEGACY_USAGE_LOG = path.join(proxy.baseDir, "token-usage.jsonl");
527
+ } else {
528
+ delete env.AUTOWONDER_TOKEN_PROXY_LEGACY_USAGE_LOG;
529
+ }
522
530
  env.AUTOWONDER_TOKEN_PROXY_USAGE_LOG = path.join(proxy.dataDir, "token-usage.jsonl");
523
531
  env.AUTOWONDER_TOKEN_PROXY_SCOPE = proxy.scope;
524
532
  env.AUTOWONDER_TOKEN_PROXY_STATE_DIR = path.join(proxy.dataDir, "managed");
@@ -15,7 +15,16 @@ function runHelper(cfg, action, { timeoutMs = 25000, stopped = () => false } = {
15
15
  child.stderr.on('data', b => { err = (err + b).slice(-4096); });
16
16
  child.on('close', code => {
17
17
  if (code !== 0) return finish(new Error(`TokenProxy helper failed: ${err.trim() || code}`));
18
- try { const result = JSON.parse(out); if (!result || typeof result.state !== 'string') throw new Error('missing state'); finish(null, result); }
18
+ try {
19
+ const result = JSON.parse(out);
20
+ if (!result || typeof result.state !== 'string') throw new Error('missing state');
21
+ if (result.state === 'unverified-listener') {
22
+ const error = new Error(`TokenProxy helper failed: ${result.reason || 'unverified listener'}`);
23
+ error.code = 'TOKEN_PROXY_UNVERIFIED_LISTENER';
24
+ return finish(error);
25
+ }
26
+ finish(null, result);
27
+ }
19
28
  catch (_) { finish(new Error('Invalid TokenProxy helper response')); }
20
29
  });
21
30
  child.stdin.end(JSON.stringify({ debug: Boolean(cfg.debug), port: cfg.port, dataDir: cfg.dataDir, baseDir: cfg.baseDir, scope: cfg.scope,
@@ -8,14 +8,15 @@ const { spawn } = require('child_process');
8
8
  const HEALTH_PATH = '/__autowonder_token_proxy/health';
9
9
  const SERVICE = 'autowonder-token-proxy';
10
10
  const sleep = ms => new Promise(resolve => setTimeout(resolve, ms));
11
- function configuration({ port = process.env.TOKEN_PROXY_PORT || 19876, dataDir = path.join(os.homedir(), '.autowonder', 'token-tap') } = {}) {
12
- port = Number(port);
11
+ function configuration({ port, dataDir = path.join(os.homedir(), '.autowonder', 'token-tap') } = {}) {
12
+ const explicitPort = port !== undefined || Boolean(process.env.TOKEN_PROXY_PORT);
13
+ port = Number(port === undefined ? process.env.TOKEN_PROXY_PORT || 19876 : port);
13
14
  if (!Number.isInteger(port) || port < 1 || port > 65535) throw new Error('TOKEN_PROXY_PORT must be an integer between 1 and 65535');
14
15
  const baseDir = path.resolve(dataDir);
15
16
  if (port !== 19876) dataDir = path.join(baseDir, 'ports', String(port));
16
17
  fs.mkdirSync(dataDir, { recursive: true, mode: 0o700 });
17
18
  dataDir = fs.realpathSync(dataDir);
18
- return { port, dataDir, baseDir, scope: crypto.createHash('sha256').update(dataDir).digest('hex') };
19
+ return { port, dataDir, baseDir, explicitPort, scope: crypto.createHash('sha256').update(dataDir).digest('hex') };
19
20
  }
20
21
  function probeProxy(cfg) {
21
22
  return new Promise(resolve => {
@@ -95,6 +96,39 @@ async function ensureSharedProxy(cfg, { timeoutMs = 30000, stopped = () => false
95
96
  }
96
97
  throw new Error(`TokenProxy is not ready (${last && last.state || 'unavailable'}); see ${path.join(cfg.dataDir, 'lifecycle.log')}`);
97
98
  }
99
+ // Only select another port before the daemon receives its environment. Moving
100
+ // a live daemon's watcher would leave its model traffic on the original port.
101
+ async function ensureConnectProxy(cfg, { timeoutMs = 30000, stopped = () => false } = {}) {
102
+ const deadline = Date.now() + timeoutMs;
103
+ const ensure = candidate => ensureSharedProxy(candidate, { timeoutMs: Math.max(0, deadline - Date.now()), stopped });
104
+ try {
105
+ return await ensure(cfg);
106
+ } catch (error) {
107
+ if (cfg.explicitPort || error.code !== 'TOKEN_PROXY_UNVERIFIED_LISTENER') throw error;
108
+ }
109
+
110
+ // Stable candidates let concurrent/repeated connects share one verified
111
+ // instance, while different profiles or script revisions stay independent.
112
+ const seed = crypto.createHash('sha256')
113
+ .update(fs.realpathSync(cfg.baseDir)).update('\0')
114
+ .update(fs.readFileSync(path.join(__dirname, 'token-proxy.js')))
115
+ .digest().readUInt32BE(0);
116
+ for (let attempt = 0; attempt < 8 && !stopped() && Date.now() < deadline; attempt++) {
117
+ const port = 20000 + (seed + attempt) % 20000;
118
+ if (port === cfg.port) continue;
119
+ const candidate = configuration({ port, dataDir: cfg.baseDir });
120
+ candidate.helper = cfg.helper;
121
+ candidate.debug = cfg.debug;
122
+ try {
123
+ const ready = await ensure(candidate);
124
+ Object.assign(cfg, candidate);
125
+ return ready;
126
+ } catch (error) {
127
+ if (error.code !== 'TOKEN_PROXY_UNVERIFIED_LISTENER') throw error;
128
+ }
129
+ }
130
+ throw new Error('No compatible TokenProxy port became available within the startup limit');
131
+ }
98
132
  function watchSharedProxy(cfg, log = () => {}, { intervalMs = 2000 } = {}) {
99
133
  let stopped = false, timer, previous = '';
100
134
  const tick = async () => {
@@ -111,4 +145,4 @@ function watchSharedProxy(cfg, log = () => {}, { intervalMs = 2000 } = {}) {
111
145
  timer = setTimeout(tick, intervalMs); timer.unref();
112
146
  return () => { stopped = true; clearTimeout(timer); };
113
147
  }
114
- module.exports = { configuration, probeProxy, ensureSharedProxy, watchSharedProxy, classify, HEALTH_PATH, SERVICE };
148
+ module.exports = { configuration, probeProxy, ensureSharedProxy, ensureConnectProxy, watchSharedProxy, classify, HEALTH_PATH, SERVICE };
@@ -63,11 +63,14 @@ const SNIFF_HOSTS = new Set([
63
63
  ]);
64
64
  const SNIFF_HOST_SUFFIXES = ['.qoder.sh', '.qodercn.com', '.qoder.com.cn', '.qoder.xin'];
65
65
 
66
- // shouldSniffHost matches case-insensitively on the exact list first and then on
67
- // the owned-domain suffixes. A trailing root dot is ignored.
66
+ // Preserve endpoint discovery's upstream certificate: Qoder's native Go helper
67
+ // uses the OS trust store, not NODE_EXTRA_CA_CERTS. This control service has no
68
+ // model usage to inspect. Other API hosts still use the exact/suffix rules.
69
+ // Matching is case-insensitive and ignores a trailing root dot.
68
70
  function shouldSniffHost(hostname, exactHosts = SNIFF_HOSTS, suffixes = SNIFF_HOST_SUFFIXES) {
69
71
  const host = String(hostname || '').trim().toLowerCase().replace(/\.$/, '');
70
72
  if (!host) return false;
73
+ if (host === 'center.qoder.sh') return false;
71
74
  const exact = typeof exactHosts.has === 'function' ? exactHosts.has(host) : exactHosts.includes(host);
72
75
  if (exact) return true;
73
76
  return suffixes.some(suffix => host === suffix.slice(1) || host.endsWith(suffix));
@@ -2,6 +2,7 @@
2
2
  import { parseArgs } from 'node:util';
3
3
  import { createRequire } from 'node:module';
4
4
  import { dirname, join, resolve } from 'node:path';
5
+ import { fileURLToPath } from 'node:url';
5
6
  import { homedir, networkInterfaces } from 'node:os';
6
7
  import { access, mkdir, readFile, stat, writeFile } from 'node:fs/promises';
7
8
  import { constants } from 'node:fs';
@@ -73,16 +74,23 @@ async function shutdown(code = 0) {
73
74
  if (stopping) return;
74
75
  stopping = true;
75
76
  state.ready = false;
76
- const force = setTimeout(() => { child?.kill('SIGKILL'); process.exit(code); }, 5000);
77
+ // Leave MCP's own 15-second watchdog time to finish before forcing exit.
78
+ const force = setTimeout(() => {
79
+ console.error('Browser shutdown timed out; forcing MCP exit. The profile may not have been saved.');
80
+ child?.kill('SIGKILL');
81
+ process.exit(1);
82
+ }, 20000);
77
83
  force.unref();
78
84
  gateway?.closeAllConnections(); gateway?.close();
79
85
  ui?.server.closeAllConnections(); ui?.server.close();
80
- // Explicit close flushes the profile even on Windows, where SIGTERM is abrupt.
81
- await client?.callTool({ name: 'browser_close', arguments: {} }).catch(() => {});
86
+ // browser_close is rejected for shared contexts; shut down the MCP process
87
+ // cooperatively instead so it closes Chromium and flushes the whole profile.
82
88
  await client?.close().catch(() => {});
83
89
  if (child && child.exitCode === null) {
84
90
  const exited = new Promise(resolve => child.once('exit', resolve));
85
- child.kill('SIGTERM');
91
+ child.send({ type: 'shutdown' }, error => {
92
+ if (error && child.exitCode === null) child.kill('SIGTERM');
93
+ });
86
94
  await exited;
87
95
  }
88
96
  clearTimeout(force);
@@ -112,14 +120,13 @@ try {
112
120
  ui = createUI(state);
113
121
  const uiPort = await listen(ui.server, 0, '127.0.0.1');
114
122
  const uiURL = `http://127.0.0.1:${uiPort}${ui.path}`;
115
- const mcpDir = dirname(require.resolve('@playwright/mcp/package.json'));
116
- const args = [join(mcpDir, 'cli.js'), '--host', '127.0.0.1', '--port', String(internalPort), '--allowed-hosts', `127.0.0.1:${internalPort}`,
123
+ const args = [fileURLToPath(new URL('./mcp-runner.js', import.meta.url)), '--host', '127.0.0.1', '--port', String(internalPort), '--allowed-hosts', `127.0.0.1:${internalPort}`,
117
124
  '--user-data-dir', join(dataDir, 'profile'), '--shared-browser-context', '--idle-timeout', '0',
118
125
  '--executable-path', executable,
119
126
  '--image-responses', 'allow', '--output-dir', join(dataDir, 'output')];
120
127
  if (values.headless) args.push('--headless');
121
128
  console.log('正在启动 Playwright MCP 和浏览器…');
122
- child = spawn(process.execPath, args, { stdio: ['ignore', 'pipe', 'pipe'], windowsHide: true });
129
+ child = spawn(process.execPath, args, { stdio: ['ignore', 'pipe', 'pipe', 'ipc'], windowsHide: true });
123
130
  let diagnostics = '';
124
131
  for (const stream of [child.stdout, child.stderr]) stream.on('data', chunk => { diagnostics = (diagnostics + chunk).slice(-6000); });
125
132
  child.on('error', error => { console.error(error.message); shutdown(1); });
@@ -0,0 +1,18 @@
1
+ // Keep shutdown cooperative on Windows: child.kill('SIGTERM') terminates the
2
+ // process there instead of delivering Playwright MCP's graceful signal handler.
3
+ import { createRequire } from 'node:module';
4
+ import { dirname, join } from 'node:path';
5
+
6
+ const require = createRequire(import.meta.url);
7
+ const cli = join(dirname(require.resolve('@playwright/mcp/package.json')), 'cli.js');
8
+ function shutdown() {
9
+ // MCP installs a SIGTERM handler that closes all browser processes and flushes
10
+ // persistent profiles. An early shutdown before it installs has no browser.
11
+ if (!process.emit('SIGTERM')) process.exit(0);
12
+ }
13
+ if (process.send) {
14
+ process.on('message', message => { if (message?.type === 'shutdown') shutdown(); });
15
+ process.on('disconnect', shutdown);
16
+ }
17
+ process.argv[1] = cli;
18
+ require(cli);
@@ -1,12 +1,12 @@
1
1
  {
2
2
  "name": "@alicloud/autowonder",
3
- "version": "0.3.39",
3
+ "version": "0.3.41",
4
4
  "lockfileVersion": 3,
5
5
  "requires": true,
6
6
  "packages": {
7
7
  "": {
8
8
  "name": "@alicloud/autowonder",
9
- "version": "0.3.39",
9
+ "version": "0.3.41",
10
10
  "license": "Apache-2.0",
11
11
  "bin": {
12
12
  "autowonder": "bin/cli.js"
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@alicloud/autowonder",
3
- "version": "0.3.39",
3
+ "version": "0.3.41",
4
4
  "description": "AutoWonder local runtime — execute AI agent dispatch packages on your machine",
5
5
  "bin": {
6
6
  "autowonder": "bin/cli.js"
@@ -4,7 +4,7 @@ const fs = require("node:fs");
4
4
  const path = require("node:path");
5
5
 
6
6
  function verifyBrowserPackage(root) {
7
- for (const file of ["bin/browser.js", "lib/browser/cli.js", "lib/browser/browser.js", "lib/browser/gateway.js", "lib/browser/ui.js", "lib/browser/package.json", "lib/browser/README.md", "npm-shrinkwrap.json"]) {
7
+ for (const file of ["bin/browser.js", "lib/browser/cli.js", "lib/browser/mcp-runner.js", "lib/browser/browser.js", "lib/browser/gateway.js", "lib/browser/ui.js", "lib/browser/package.json", "lib/browser/README.md", "npm-shrinkwrap.json"]) {
8
8
  if (!fs.existsSync(path.join(root, file))) throw new Error(`Missing browser package file: ${file}`);
9
9
  }
10
10
  const pkg = JSON.parse(fs.readFileSync(path.join(root, "package.json"), "utf8"));