@alicloud/autowonder 0.0.0-stage → 0.3.33
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 +264 -2
- package/bin/cli.js +1113 -0
- package/bin/executor-environment.js +86 -0
- package/bin/process-tree-runner.js +52 -0
- package/bin/qoder-bootstrap.js +1251 -0
- package/bin/qoder-generations.js +79 -0
- package/bin/shared.js +48 -0
- package/bin/token-proxy.js +1129 -0
- package/bin/windows-job-runner.ps1 +129 -0
- package/lib/workitem-download.js +239 -0
- package/lib/workitem-upload.js +324 -0
- package/package.json +40 -4
- package/scripts/build-and-publish.sh +151 -0
- package/scripts/release-build-lib.sh +123 -0
- package/vendor/autowonder-daemon-darwin-amd64 +0 -0
- package/vendor/autowonder-daemon-darwin-arm64 +0 -0
- package/vendor/autowonder-daemon-linux-amd64 +0 -0
- package/vendor/autowonder-daemon-linux-arm64 +0 -0
- package/vendor/autowonder-daemon-win32-amd64.exe +0 -0
- package/vendor/autowonder-daemon-win32-arm64.exe +0 -0
package/README.md
CHANGED
|
@@ -1,3 +1,265 @@
|
|
|
1
|
-
#
|
|
1
|
+
# autowonder
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
AutoWonder 本地 agent runtime。安装后启动 daemon,持续轮询本地 assignment 队列并执行任务包。
|
|
4
|
+
|
|
5
|
+
## 连接 AutoWonder 服务
|
|
6
|
+
|
|
7
|
+
```bash
|
|
8
|
+
# Qoder CLI(模型使用 provider model ID;Context Window 使用固定档位)
|
|
9
|
+
npx -y autowonder@0.3.30 connect --ws-url <wss-endpoint> --token <executor-token> --executor-id <executor-id> --provider qoder --model qmodel_latest --reasoning-effort medium --context-window 260000
|
|
10
|
+
|
|
11
|
+
# Qoder CLI CN
|
|
12
|
+
npx -y autowonder@0.3.30 connect --ws-url <wss-endpoint> --token <executor-token> --executor-id <executor-id> --provider qodercn
|
|
13
|
+
```
|
|
14
|
+
|
|
15
|
+
`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 登录状态。
|
|
16
|
+
|
|
17
|
+
### Qoder 系列 Access Token 认证
|
|
18
|
+
|
|
19
|
+
以下认证规则同时适用于 `connect --provider qoder` 和 `connect --provider qodercn`。runtime 启动时按以下顺序选择认证方式:
|
|
20
|
+
|
|
21
|
+
1. 对应 provider 的命令行参数:`qoder` 使用 `--QODER_PERSONAL_ACCESS_TOKEN`,`qodercn` 使用 `--QODERCN_PERSONAL_ACCESS_TOKEN`;两者都支持 `--KEY=<token>` 和 `--KEY <token>` 形式。
|
|
22
|
+
2. 当前进程中对应的原生环境变量:`QODER_PERSONAL_ACCESS_TOKEN` 或 `QODERCN_PERSONAL_ACCESS_TOKEN`。
|
|
23
|
+
3. 执行器绑定的数字员工当前在线版本中对应的同名 Platform 环境变量。
|
|
24
|
+
4. 均未配置时,沿用现有的浏览器 OAuth 登录。
|
|
25
|
+
|
|
26
|
+
runtime 启动时始终只拉取一次 Platform 环境变量快照,即使已有本地参数或环境变量也不会跳过;拉取或鉴权失败会直接导致启动失败,不会静默降级。命令行参数或当前进程环境变量提供的 token 会按启动需要保留给 daemon;Platform 预取的 token 仅临时用于启动认证,不会保留在 daemon 环境中。实际任务或 conversation 派发时,仍沿用现有机制注入并覆盖最新的 Platform 环境变量快照。
|
|
27
|
+
|
|
28
|
+
出于安全考虑,命令行 token 可能出现在 shell 历史和操作系统进程列表中,建议优先使用环境变量或 Platform 绑定。
|
|
29
|
+
|
|
30
|
+
`connect` 和 `start` 都要求 Qoder CLI / Qoder CLI CN 版本至少为 `1.1.65`。检测到旧版、无法解析的版本,或共享安装被其他进程的安装锁占用时,runtime 不再原位升级共享 CLI,而是安装到独立的私有 generation(`~/.autowonder/qoder-generations/<provider>/gen-*`):先校验候选二进制版本,再原子发布 `current.json` 指向已验证的 generation,启动时直接使用该 generation 的具体路径。候选安装或校验失败不会被选中,上一代保留为回退;旧 generation 不自动删除。显式指定的外部可执行文件(`AUTOWONDER_QODER_CLI` / `AUTOWONDER_QODERCN_CLI`)在校验通过后仍直接使用,runtime 不会原地修改它。daemon 退出与 re-exec 前会取消并等待进行中的 Qoder 安装/升级维护任务,避免遗留共享安装票据让同机其他执行器的版本预检持续失败。所有 Qoder 系列子进程(普通任务、conversation、warm 会话、恢复回退、命令与模型探测)都会强制注入固定的 `QODER_INTEGRATION_ID`,调用方环境不能覆盖该流量归因标识。
|
|
31
|
+
|
|
32
|
+
`qodercn` 是国内版 Qoder CLI。runtime 会在缺少 `qodercn` 时自动把 `@qodercn-ai/qoderclicn` 安装到独立 generation `~/.autowonder/qoder-generations/qodercn/`(旧版本写入的 `~/.autowonder/qoder-cn-cli` 安装仍会被识别),并在尚未登录时打开浏览器登录。它使用自己的配置根(`QODERCN_CONFIG_DIR`,默认 `~/.qoder-cn`),与国际版 `qoder` 不共享可执行文件、凭证和会话。可用 `AUTOWONDER_QODERCN_CLI` 指定自定义可执行文件路径。
|
|
33
|
+
|
|
34
|
+
Qoder 的 Context Window 只能使用 `1000000`、`400000` 或 `260000`,Reasoning Effort 只能使用 `none`、`low`、`medium`、`high`、`xhigh` 或 `max`。`--model` 不再校验固定白名单:取值经 `AUTOWONDER_MODEL` 原样透传给 Qoder CLI,因此服务端上线新模型无需升级本客户端。建议直接复制 AutoWonder 执行器页面生成的命令,避免把模型展示名称误当成 provider model ID。
|
|
35
|
+
|
|
36
|
+
daemon 会响应服务端的 `QODER_MODEL_CATALOG_REQUEST` 帧,用当前 provider 对应的本机 Qoder CLI 发现可用模型目录,只回传 `{id, name}`,让执行器页面展示这台机器真实可选的模型。该请求仅在 `executorId` 与 `provider` 都与本机一致时处理,发现超时 20 秒,并发请求合并为一次发现,`qoder` 与 `qodercn` 的发现互相隔离、不共享配置根。
|
|
37
|
+
|
|
38
|
+
daemon 还在协议能力位里声明 `TASK_MODEL_SELECTION_V1`:服务端可在派单帧中附带任务级模型选择(`modelSelection`,含目标模型、条目计数与阈值、策略版本、原因码)。runtime 只对本次派单应用该模型(覆盖派单原有的 model 取值,不修改执行器保存的默认配置),并在开始执行时把 `dispatchId`、选中模型与原因写入 daemon 日志,便于回溯某个任务因何被升级到另一个模型。该能力对执行机用户无新增参数或环境变量。
|
|
39
|
+
|
|
40
|
+
daemon 建立执行器接入连接时会在 WebSocket URL 上附带本机主机名(取不到时不带该参数,服务端按未上报处理),服务端据此在执行器列表区分同一数字员工在多台机器上的执行器。对执行机用户无新增参数或环境变量。
|
|
41
|
+
|
|
42
|
+
daemon 还在协议能力位里声明 `terminal_steer_v1`:服务端可对当前正在执行的派单下发 `TASK_STEER` 终端插话(含 `guidanceId`、`dispatchId` 与内容)。daemon 只在该派单存在活跃 provider 回合时受理:协作式取消当前回合、等待退出后在同一 agent 会话内携带插话内容继续执行,并经 `TASK_STEER_ACK` 回传受理状态;无活跃回合、回合已结束或接收队列已满时明确返回失败,不影响原任务状态。插话与评论投递、工作流回复路由相互独立(重复投递去重、回执可重放)。该能力对执行机用户无新增参数或环境变量。
|
|
43
|
+
|
|
44
|
+
daemon 还会响应服务端的 `CONVERSATION_COMMANDS_PROBE` 帧,用独立会话抓取该会话工作目录下可用的斜杠命令,回传 `CONVERSATION_COMMANDS_RESULT` 帧,让会话面板在用户输入 `/` 时列出真实可用的命令。该探测与回合执行完全隔离:任何失败只产生 `FAILED` / `TIMEOUT` 帧,不影响进行中的会话;provider 后端不支持抓取时同样降级为 `FAILED` 帧。帧里的 `executorId` 与本机不一致或非正数时直接忽略,避免在别的执行器工作区里建目录或启动 CLI。daemon 侧给整个探测 25 秒硬上限,刻意长于 agent 侧的 20 秒预算,使 agent 自己的超时先触发并可被归类。
|
|
45
|
+
|
|
46
|
+
给 `connect` 追加 `--token-aware-enable` 可开启 qoder / qodercn 的 token 用量采集:CLI 会以 sidecar 方式启动本地 HTTPS 转发代理(`bin/token-proxy.js`),从 Qoder API 的 SSE 响应流中提取 usage 数据并按 dispatch ID 归属上报。usage 解析失败只丢失计量数据;代理启动失败时仅告警并继续。启用后模型流量经过代理,连接失败由客户端处理重试,不保证自动直连。代理端口可用 `TOKEN_PROXY_PORT` 环境变量调整(默认 19876);CA 证书位于 `~/.autowonder/token-tap/ca-cert.pem`。daemon 退出时 sidecar 一并停止。代理对 TCP 建连和两端 TLS 握手设置 15 秒期限,对无读写活动的连接设置 120 秒空闲期限;超时、报错或任一端关闭时释放两端连接。持续有数据的 SSE 流不受总时长限制,连续静默超过 120 秒的流会断开。
|
|
47
|
+
|
|
48
|
+
`connect` 支持 `--workspace-root <path>` 指定 dispatch 仓库与任务工作区所在目录(默认 `~/autowonder_workspaces`)。该参数会转发给 daemon,等价于设置 `AUTOWONDER_WORKSPACE_ROOT` 环境变量,适合把工作区放在非默认路径的执行机上(如 Windows 的 `D:\autowonder`)。
|
|
49
|
+
|
|
50
|
+
## 自主记忆(Qoder 执行器)
|
|
51
|
+
|
|
52
|
+
评论续接已有会话时,Qoder / QoderCN 子进程也会收到本次派单的最新平台记忆投影、当前 `MEMORY.md` 路径与记忆策略,避免复用旧进程的提示或旧 capsule 路径。数字人身份仍为必填;平台记忆内容不能替代缺失或空白的身份配置。
|
|
53
|
+
|
|
54
|
+
Qoder 系列执行器的跨派单记忆由平台托管。服务端在派单里下发记忆快照与同步路径,daemon 按该路径拉取快照,把记忆文档投影到本次任务的 capsule(`state/memory/`),并以 `AUTOWONDER_MEMORY_DIR` 注入 provider 子进程;任务执行期间产生的记忆变更经本地 journal 增量回传服务端,索引整理由服务端下发的维护租约驱动。本机历史遗留的 Qoder 记忆(provider 配置根下的 `AGENTS.md`、`MEMORY.md`、`memories.md`,单文件上限 4 MiB)会在派单执行时经脱敏后导入平台,凭据字段与私钥会被替换为 `[REDACTED]`;该导入是机会式的,失败只记调试日志并延后重试,不影响任务本身。
|
|
55
|
+
|
|
56
|
+
记忆写入被服务端校验拒绝时,runtime 只提取已知的校验码与行号(不夹带服务端响应正文)连同修复方法反馈给模型;只有确实存在待修复写入时才允许一次有界修复,普通业务任务不会因此多出反思回合。隔离维护会话开始时会读取当时最新的 `MEMORY.md`(业务回合可能已修正索引),维护只有在同步队列清空且索引整理目标达成后才算完成。
|
|
57
|
+
|
|
58
|
+
`--memory-mode` 控制该能力,取值为 `platform`(默认)、`provider-local`、`none`:
|
|
59
|
+
|
|
60
|
+
- `platform`:使用上面的平台托管记忆。
|
|
61
|
+
- `provider-local`:沿用 provider 自己的本地记忆目录。**Qoder 系列已不再支持该取值**:以 `--memory-mode provider-local` 启动的 Qoder 执行器会在执行任务时直接报错 `qoder provider-local memory is no longer supported; migrate to platform memory`,需要改用 `platform`(或不需要记忆时用 `none`)并重新生成启动命令;其他 provider 不受影响。使用默认值 `platform` 的执行器无需任何改动。
|
|
62
|
+
- `none`:不读写记忆。
|
|
63
|
+
|
|
64
|
+
记忆文件位于任务 capsule 内,随工作区 GC 一并清理;尚未被服务端确认的记忆变更暂存在 `<workspace-root>/.memory-outbox/` 下,进程重启后可续传。`AUTOWONDER_MEMORY_DIR` 由 runtime 注入,执行机用户不需要自行设置。
|
|
65
|
+
|
|
66
|
+
## 工作区保留与 Git 对象复用
|
|
67
|
+
|
|
68
|
+
daemon 默认启用本地工作区 GC:启动 30 秒后开始检查,之后每 15 分钟开始一次检查。尚有健康的分片工作时每 250 毫秒继续,错误仍按退避重试;每次操作保持有限的节点和时间预算。非会话任务在终态且最后活动时间超过所配置的任务 TTL(默认 48 小时)后符合清理条件;会话目录的 TTL 仍为 720 小时。清理单位是整个 attempt capsule 或 conversation capsule。未知或格式异常、非终态(包括 uploading)、仍在运行、由恢复流程持有、结果仍待确认,或结果状态查询失败的 capsule 都会保留。只有 package 缓存、没有可信终态证据的历史目录不会按目录年龄删除,恢复扫描也不会为它们凭空创建 assigned 状态。
|
|
69
|
+
|
|
70
|
+
磁盘使用率达到 85% 或可用空间低于 10 GiB 时进入压力模式,恢复目标是使用率不高于 75% 且可用空间至少 15 GiB。压力模式还允许清理未满 TTL 的 completed attempt;符合条件的 attempt 按最后活动时间从旧到新清理。近期 failed/cancelled 和会话目录的 TTL 不变。每次实际删除后检查恢复目标,隔离重命名不算释放空间。删除前不为统计额外遍历目录;文件数和逻辑字节估算直接从删除操作取得。
|
|
71
|
+
|
|
72
|
+
工作区 GC 另写独立审计日志 `~/.autowonder/gc/gc_exector_<executorId>.log`(文件名单词拼写如此),每文件上限 50 MiB、共保留 5 个文件,不改变下面托管日志的保留设置。
|
|
73
|
+
|
|
74
|
+
相关环境变量及默认值如下:
|
|
75
|
+
|
|
76
|
+
- `AUTOWONDER_WORKSPACE_GC_ENABLED=true`
|
|
77
|
+
- `AUTOWONDER_WORKSPACE_GC_INITIAL_DELAY=30s`
|
|
78
|
+
- `AUTOWONDER_WORKSPACE_GC_INTERVAL=15m`
|
|
79
|
+
- `AUTOWONDER_WORKSPACE_GC_TASK_TTL=48h`
|
|
80
|
+
- `AUTOWONDER_WORKSPACE_GC_CONVERSATION_TTL=720h`
|
|
81
|
+
- `AUTOWONDER_WORKSPACE_GC_HIGH_WATERMARK_PERCENT=85`
|
|
82
|
+
- `AUTOWONDER_WORKSPACE_GC_LOW_WATERMARK_PERCENT=75`
|
|
83
|
+
- `AUTOWONDER_WORKSPACE_GC_MIN_FREE_BYTES=10737418240`(10 GiB)
|
|
84
|
+
- `AUTOWONDER_WORKSPACE_GC_TARGET_FREE_BYTES=16106127360`(15 GiB)
|
|
85
|
+
|
|
86
|
+
将 `AUTOWONDER_WORKSPACE_GC_ENABLED` 设为 `false` 只会禁用自主 GC;服务端下发的 `WORKITEM_WORKSPACE_CLEANUP` 清理仍按原有生命周期执行。
|
|
87
|
+
|
|
88
|
+
`~/autowonder_workspaces`(可由 `--workspace-root` 或 `AUTOWONDER_WORKSPACE_ROOT` 修改)保存每个任务独立的工作文件和 checkout/worktree;`~/.autowonder/git-object-cache/v1` 保存可供多个任务复用 Git 历史对象的本地 bare mirror。每个任务仍会得到所请求准确 commit 的独立工作区。已缓存的固定 commit 可以不查询远端;允许联网时,`HEAD`、branch 或 tag 等可移动 ref 会在每次 materialization 时向远端解析为准确 commit,仅在 mirror 缺少该对象时 fetch。缓存优化失败时,只有其临时目录已经完成可验证的干净回滚才会回退到原有的远端完整 clone 流程;若无法证明干净回滚,则会保留现场并返回错误,不进入回退。任何路径都不会发布不完整的目标目录;已经存在的任务仓库只做校验,不会被 fetch、reset、clean、checkout 或覆盖。本版本不会自动淘汰 Git 对象缓存,工作区 GC 也不会删除该缓存。
|
|
89
|
+
|
|
90
|
+
任务包 `repos.json` 可为仓库声明继承来源 revision 的回退列表(`sourceRevisionFallbackRefs`):当派单要求的继承 revision 已无法解析为 commit(例如上游分支被删除或强推)时,runtime 会按该列表依次回退物化,命中后以回退 commit 作为该仓库本次使用的来源继续执行,并发出 `repo_source_revision_abandoned` 事件(含仓库、回退 commit 与原因)。只有「ref 无法解析」会触发回退——传输、权限、工作区归属与策略类失败不触发;声明了固定 base commit 的仓库不使用回退。该能力对执行机用户无新增参数或环境变量。来源 revision 产物里的 `checkoutVerification: "required"` 表示远端探测未能确认 HEAD(不等于 HEAD 未发布),下游应在开始验收前物化该精确 HEAD;旧消费方仍按原有远端校验逻辑处理。
|
|
91
|
+
|
|
92
|
+
任务工作区里的仓库工作分支名按派单 ID、attempt 与仓库名确定性生成。仓库名不含可用 ref 字符时(例如纯非 ASCII 名称),runtime 改用基于仓库名的 SHA-256 摘要生成 `repo-<hex>` 后缀,保证分支名合法、稳定且不依赖仓库 URL。Windows 上物化重命名与 GC 清理不再对保留的父目录请求 DELETE 访问,也不再用字节数组承载 `FILE_DISPOSITION_INFORMATION_EX`(4 字节对齐导致的 `STATUS_DATATYPE_MISALIGNMENT`),因此重命名目标父目录不会再因访问冲突失败。
|
|
93
|
+
|
|
94
|
+
任务工作区里的 Git 策略(是否允许提交/推送与工作区边界)由 runtime 安装的自包含钩子强制执行:默认策略不依赖 runtime 二进制或任务配置继续存在,因此历史任务残留不会让普通的 `git commit` / `git push` 失败,策略禁止时分别以退出码 `73` / `74` 拒绝提交与推送,提交还要求 HEAD 位于具名分支(detached 时以 `77` 拒绝)。安装是幂等的,只有确实声明了打包触发的仓库才会链式调用 runtime。daemon 启动时会在 15 秒预算内把本执行器历史 capsule 中可核对的旧版包装脚本迁移为这种自包含形式;模板、配置或元数据不完整的历史一律保留现场,不做全机扫描,也不恢复用户原有的 `hooksPath`。
|
|
95
|
+
|
|
96
|
+
## 中断派单恢复
|
|
97
|
+
|
|
98
|
+
daemon 重启或崩溃后重新接管未完成的派单时,runtime 不会直接把工作区交给恢复执行:先按 capsule 的尝试目录识别并清理上一进程遗留的 provider 进程组,确认没有归属进程组残留后才进入执行;清理结果不确定时保持该派单的恢复归属并按退避重试,不会把工作区让给服务端的替代任务,也不会在遗留进程仍可能写入时确认取消。等待服务端认领期间不占用执行槽位。
|
|
99
|
+
|
|
100
|
+
恢复时只有存在与步骤 attempt 匹配的持久化完成回执(`state/step-uploads/<step>/attempt-N.json`,即该步骤已发布并被远端 ref 代表)才会复用已完成的步骤;只存在于本地进度快照里的「已完成」不再被采信,无法证明的步骤会回退为待执行并重新运行,同时发出 `recovery_unproven_step_completions` 事件。恢复执行与首次派发一样上报步骤与运行事件,保留的完成步骤会显式发出 `step_reused`,时间线不需要客户端从游标推断。
|
|
101
|
+
|
|
102
|
+
恢复执行前会把工作目录规范化为绝对路径并解析符号链接(Qoder 会话按物理目录索引),因此通过符号链接别名派发的任务在重启后仍能找到并续接原会话。
|
|
103
|
+
|
|
104
|
+
完成交付进入 `uploading` 后,永久性上传失败(产物超限、权限拒绝或其他已判定的终态错误)不再被外层自动重试循环持续重投:runtime 记录终态失败、停止该派单的重试,并保留本次业务结果与产物责任等待平台处置;只有可恢复错误才按 30 秒退避继续。取消请求贯穿完成交付与启动恢复——上传阶段的取消会立即把该派单标记为已取消并释放待发布结果,恢复 worker 在启动前或上传重试过程中被取消时不再继续投递,对已进入终态且没有活跃处理器的派单会按幂等成功回应该取消。启动恢复中只做纯上传/发布结果的派单状态显示为 `uploading`,其被拒绝的上传仍以服务端权威所有权栅栏为准,不在本地凭空创建新的业务失败或结果身份。
|
|
105
|
+
|
|
106
|
+
暂停也走同一条持久化回执链路:`TASK_PAUSED` 只有在服务端确认接受后才从结果 outbox 删除,未接受时保留并可重发;服务端再次下发同一派单的暂停指令时,runtime 直接从 capsule 中已落盘的暂停结果(`runtime-result.json`,先校验租户、工单、派单、attempt 与 checkpoint 回执)重放该回执,而不要求暂停协调器仍留在内存里等待,因此 daemon 重启或回执丢失都不会让等待该派单返工的一方永久挂起。
|
|
107
|
+
|
|
108
|
+
派单回合以 Qoder 自报的 `cancelled the prompt` 结束、而 runtime 并未发起取消,且本轮既无助手输出也无工具/提问活动时,不再直接判为失败:runtime 最多做 2 次有界恢复,第二次改用新会话并重建同一 workflow 上下文,重试前按退避等待,期间的暂停请求仍即时生效。只要已产生输出或工具副作用、存在待处理插话,或取消来自外部上下文,就不会重试;由多次调用组合而成的回合也不会授权重放其前置轮次。
|
|
109
|
+
|
|
110
|
+
Qoder 取消会在失败历史里附带 runtime 侧上下文诊断(是否尝试过取消、上下文状态),随 telemetry 一起导出,用于区分「模型自行中止」与「真实取消」。该诊断对执行机用户无新增参数或环境变量。
|
|
111
|
+
|
|
112
|
+
## 会话回合可靠性
|
|
113
|
+
|
|
114
|
+
conversation 回合只有在其结果成功、未被取消且取得 provider 返回的 session id 后,才把会话与该 session 绑定(工作目录内 `.autowonder-conversation-session.json`,含 provider、session id 与 system prompt 摘要)。此前「请求了某个 prompt」不等于 provider 真正采纳了它;绑定缺失、provider 变化、session 变化或 prompt 摘要变化都会重建会话并复用已保存历史。绑定写入失败只记日志,不会把已完成的工具副作用变成可重试的失败回合。对话历史也只在回合成功时追加。
|
|
115
|
+
|
|
116
|
+
人工回答的投递与传输解耦:回答先落盘为 receipt,再进入有界的 ACK 队列(最多 512 条待发提示,写回执优先于发提示),发送失败不阻塞任务,也不起本地重试循环;服务端重投或回合结束后的 receiptOnly 查询以落盘 receipt 为准,冲突的回答只会得到拒绝提示,不会污染已存在的真实回执。等待人工回答超时或回合被取消时,runtime 通过回合上下文停止 provider,而不是回传 ACP「人工拒绝」;回答注册器不可用时回合直接以 FAILED 回执。
|
|
117
|
+
|
|
118
|
+
## 自动更新
|
|
119
|
+
|
|
120
|
+
本桥接版本仍以 `autowonder` 发布,命令和二进制身份保持不变;平台触发升级时,版本元数据及 tarball 从 `@alicloud/autowonder` 获取(最新版本查询使用 `latest`,指定版本查询使用对应版本号)。先让旧客户端升级到旧包中的桥接版本,再发布并指派版本号更高的组织包;新包未发布或查询失败时保留当前版本,不回退查询旧包。组织包必须延续递增版本号,不能用 `0.0.1` 替代已安装的 `0.3.x`。此变更不启用后台自动检查。
|
|
121
|
+
|
|
122
|
+
daemon 不会自行追新:后台自动更新策略默认关闭,且没有环境变量可以重新开启,因此 daemon 不会主动查询 npm 的 `@alicloud/autowonder/latest`、下载、安装或重启。版本由平台决定,见下文的服务端指定版本升级;没有服务端升级指令时,即使本地配置了更短的检查周期也不会产生任何 npm 请求。
|
|
123
|
+
|
|
124
|
+
升级能力与后台策略是两件事:标准安装的正式版 daemon 仍会初始化升级器并在心跳里上报远程升级能力,因此平台可以下发指定版本的升级指令。收到 `EXECUTOR_UPGRADE`(或 `EXECUTOR_RESTART` 且 `update=true`)后,daemon 才会按指令解析 npm tarball、校验 SHA-512 SRI、包版本和平台二进制;只有在没有运行/恢复任务且结果 outbox 已收到服务端确认时,才会暂停接单、原子切换二进制并重启。启动失败会恢复上一个二进制。
|
|
125
|
+
|
|
126
|
+
源码构建、开发版本、非标准安装路径、预发布版本和 Windows 不上报升级能力,也不支持远端升级。
|
|
127
|
+
|
|
128
|
+
```bash
|
|
129
|
+
# 使用兼容的 npm registry(仅影响按平台指令解析版本时使用的源)
|
|
130
|
+
AUTOWONDER_NPM_REGISTRY=https://registry.npmjs.org \
|
|
131
|
+
npx -y autowonder@latest connect ...
|
|
132
|
+
```
|
|
133
|
+
|
|
134
|
+
## 在线应用启动命令
|
|
135
|
+
|
|
136
|
+
支持版本的 Linux/macOS 执行器会声明 `EXECUTOR_LAUNCH_COMMAND_V1`。管理员可在平台“启动命令 → 编辑完整命令”中修改固定发布版本、`--workspace-root`、`--name`、`--debug` 及已有启动参数,保存后在线应用。连接地址、Token、执行器 ID、provider 和 Token 代理参数不可修改,不执行任意 Shell 命令。
|
|
137
|
+
|
|
138
|
+
同版本空闲时用新参数 exec;切换到更高稳定版本要求二进制安装在 `~/.autowonder/bin/autowonder-daemon`,复用 npm tarball SHA-512、包版本、平台二进制和候选自检,再原子切换。失败保留原程序并在支持的故障路径回滚,不支持在线降级。源码构建仅支持保持当前版本的参数应用,Windows 不声明在线应用能力。旧客户端需要先本地安装一次支持版本。
|
|
139
|
+
|
|
140
|
+
启动命令可携带可选的 `restartMode`,取值为 `WHEN_IDLE` 或 `FORCE`。未提供时仅在本机完全空闲时应用,繁忙时拒绝并回执失败;`WHEN_IDLE` 会立即关闭接单入口,等待运行中任务与会话结束后再重启,等待期间每 30 秒以 `EXECUTOR_RESTART_RESULT` 的 `WAITING_IDLE` 状态回执;`FORCE` 同样立即关闭接单入口,但不等运行中任务,仍要求结果 outbox 可读后立即重启。非法取值会在产生任何重启副作用前被拒绝。Linux/macOS 执行器在心跳中通过 `EXECUTOR_RESTART_POLICY_V1` 声明支持该策略。
|
|
141
|
+
|
|
142
|
+
工作目录切换前必须没有运行/恢复任务,且原目录的结果 outbox 已全部确认;默认本地队列仍有待执行或已领取任务时也会拒绝切换。目标目录必须可写;历史任务文件保留在原目录,不自动迁移或删除。未指定目录和名称时在线应用沿用当前值,仅更新其他参数不会移动本地队列。
|
|
143
|
+
|
|
144
|
+
候选版本缓存在 `~/.autowonder/updates/`;当前二进制和单个回滚副本位于 `~/.autowonder/bin/`。`GET /health` 会返回 `daemonVersion`、`updateState`、`updateTarget` 和 `updateError`。
|
|
145
|
+
|
|
146
|
+
daemon 建立连接时和每次心跳定时检查时发出的 `HEARTBEAT` 帧都带上 `version` 字段,取值为该二进制构建时注入的发布版本号(`currentReleaseIdentity().Version`,与 `--self-check` 报告的版本同源);版本为空时该字段不出现在帧里。服务端据此记录每台执行机实际运行的客户端版本并在执行器列表展示,为后续客户端批量升级提供数据基础。对执行机用户无新增参数或环境变量。
|
|
147
|
+
|
|
148
|
+
同一批 `HEARTBEAT` 帧还带上 `model` 字段,取值为 daemon 当前生效的默认模型(`--model` 经 `AUTOWONDER_MODEL` 注入的 `cfg.DefaultModel`,即派单未指定模型时实际使用的取值);该值为空时字段不出现在帧里。服务端据此在执行器列表展示每台执行机当前使用的底层模型,与上面的 `version` 上报同一条通路。对执行机用户同样无新增参数或环境变量。
|
|
149
|
+
|
|
150
|
+
同一批 `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、安装事务与回滚,仅标准安装的正式版支持远端拉取新版本,已是最新版的请求仍会重启,且该操作不应用平台上保存的启动配置改动。对执行机用户同样无新增参数或环境变量。
|
|
151
|
+
|
|
152
|
+
标准安装还支持服务端把整批执行机升级到指定的**已发布版本**(不再依赖各台机器安装时选定的版本),能力位为 `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、安装事务与回滚。对执行机用户无新增参数或环境变量。
|
|
153
|
+
|
|
154
|
+
## 任务环境变量快照
|
|
155
|
+
|
|
156
|
+
平台可在派单(`dispatch` 帧)与会话回合(`CONVERSATION_TURN` 帧)里附带任务级环境变量快照(`environmentVariables`),经已认证的执行器 WebSocket 下发;runtime 会把快照叠加到 provider 子进程环境之上,任务按平台下发的取值运行。同名变量按不区分大小写的方式覆盖,保证同一任务在 Linux/macOS 与 Windows 上取值一致。
|
|
157
|
+
|
|
158
|
+
- 变量名必须是合法标识符(`[A-Za-z_][A-Za-z0-9_]*`),否则派单在执行任何副作用之前失败。
|
|
159
|
+
- runtime 与 provider 自有的变量不接受快照覆盖:`AUTOWONDER_*` 前缀(如 `AUTOWONDER_SCRATCH_DIR`、`AUTOWONDER_WORKSPACE_ROOT`),以及 `CODEX_HOME`、`CLAUDE_CONFIG_DIR`、`QODER_CONFIG_DIR`、`QODERCN_CONFIG_DIR`、`QODER_INTEGRATION_ID`、`QODER_HOST_SERVICE_NAME`。
|
|
160
|
+
- 快照取值不写入本机磁盘:assignment 信封只保留 `ABSENT` / `EMPTY` / `REQUIRED` 状态标记,崩溃恢复时标记为 `REQUIRED` 的派单需要平台重新下发快照;本机历史遗留的明文信封会在读取时被改写为不含取值的标记形式。
|
|
161
|
+
- 会话回合适用同一套规则,并把快照摘要并入 Qoder 进程复用指纹:快照变化时不会复用带旧环境的热进程。
|
|
162
|
+
- 对执行机用户无新增命令行参数或环境变量。
|
|
163
|
+
|
|
164
|
+
## 产物发布边界
|
|
165
|
+
|
|
166
|
+
daemon 默认启用显式发布边界(`explicit_refs_v1`):上传集合由完成请求里的精确引用与平台已知的交付契约推导,不再对 typed 产物目录做整树扫描,目录层级本身不再是发布依据。
|
|
167
|
+
|
|
168
|
+
- `AUTOWONDER_SCRATCH_DIR` 指向当前 capsule 的 `artifacts/scratch/`,用于中间数据、临时命令输出和诊断工作文件;这些文件保持本地,不封存也不上传。
|
|
169
|
+
- `AUTOWONDER_ARTIFACTS_OUTPUT_DIR` 指向 `artifacts/output/`,是候选产物的暂存区:把文件放进该目录不等于它会发布,未被引用的文件不会被读取、哈希、复制或上传,checkpoint 也不会携带。
|
|
170
|
+
- 每一步尝试会把通过 admission 的集合封存为不可变快照(`artifacts/attempts/<step>/attempt-N/publish-manifest.json`);删除文件后重新封存,新快照不再包含它,已由远端 receipt 代表的文件只引用、不重传。
|
|
171
|
+
- 完成请求先过引用预检:提交 `completion_requested` 时,`evidenceRefs` 必须逐条是相对输出目录的 typed 路径(如 `evidence/report.md`)且指向 `artifacts/output/` 或本机 `accepted/` 中真实存在的普通文件;带 `artifacts/output/` 前缀、绝对路径、未分类目录或不存在的引用会被该请求直接拒绝(HTTP 400,并记录步骤提交反馈指明修法),而不是先接受、到封存阶段才失败。预检通过后,封存仍会在接受完成时重新打开并复核每个来源。
|
|
172
|
+
- 超预算的文本证据(如整段原始命令输出)会让步骤以 `fix_required` 结束,并在任何上传请求之前返回 `ARTIFACT_BUDGET_EXCEEDED`、`ARTIFACT_CLASS_REQUIRED`、`ARTIFACT_FILE_TOO_LARGE` 等稳定错误码;正确处置是发布精简报告或改用交付产物路径,而不是放宽本机限制。
|
|
173
|
+
- 服务端可在派单里下发更严格的限制(`artifactProtocolVersion` = 2,以及每请求文件数与字节数、单文件、文本证据单文件与总量上限);字段缺省时 runtime 使用保守默认值,旧服务端与旧执行器组合行为不变。
|
|
174
|
+
- `AUTOWONDER_ARTIFACT_SELECTION_MODE=legacy_all_typed` 仅供平台 operator 在线上事故回滚时使用(设置后需重启 daemon),会恢复旧的目录级收集语义及其资源放大风险,问题解除后应立即移除;不得把它下发给客户 SDLC、Agent、Soul、提示词或 assignment 配置。
|
|
175
|
+
|
|
176
|
+
checkpoint 使用 `autowonder.runtimeCheckpoint.v2`:相同 digest 的已发布字节只保存一份,恢复前在隔离 staging 中完整校验 manifest 与 payload 的对应关系。v2 reader 兼容历史 v1 checkpoint;旧版 runtime 会因 schema 不匹配拒绝 v2,需要回滚旧版时应选择保留的 v1 checkpoint,不能把 v2 改标成 v1。
|
|
177
|
+
|
|
178
|
+
## 发布构建
|
|
179
|
+
|
|
180
|
+
`npm run build` 和发布脚本只接受没有已跟踪或未跟踪改动的 Git worktree。脚本会把准确的 release commit 克隆到仓库外的 detached checkout,再从该目录构建六个平台(darwin/linux/windows × amd64/arm64)的 daemon。
|
|
181
|
+
|
|
182
|
+
每个产物都必须在 Go BuildInfo 中报告相同的完整 commit、`vcs.modified=false` 和目标平台;本机产物的 `--self-check` 还必须与 npm 包版本、短 commit 和平台一致。任一检查失败都会在替换 `vendor` 或执行 `npm publish` 前终止。
|
|
183
|
+
|
|
184
|
+
## 提交 assignment
|
|
185
|
+
|
|
186
|
+
daemon 默认轮询 `~/autowonder_workspaces/assignments/*.json`。队列里放 assignment JSON,不放 package zip;JSON 的 `taskPackageRef.downloadUrl` 应指向可下载的 OSS、HTTP 或本地 package 地址。
|
|
187
|
+
|
|
188
|
+
```bash
|
|
189
|
+
queue="$HOME/autowonder_workspaces/assignments"
|
|
190
|
+
mkdir -p "$queue"
|
|
191
|
+
cp ./assignment.json "$queue/.assignment.tmp"
|
|
192
|
+
mv "$queue/.assignment.tmp" "$queue/assignment.json"
|
|
193
|
+
```
|
|
194
|
+
|
|
195
|
+
也可以直接提交到本地 API:
|
|
196
|
+
|
|
197
|
+
```bash
|
|
198
|
+
npx -y autowonder@0.3.30 dispatch ./assignment.json
|
|
199
|
+
```
|
|
200
|
+
|
|
201
|
+
## 上传工单附件
|
|
202
|
+
|
|
203
|
+
把本地需求/设计文档直接上传到工单,避免在会话里传递大文件:
|
|
204
|
+
|
|
205
|
+
```bash
|
|
206
|
+
npx -y autowonder@0.3.30 workitem upload --server-url <autowonder-server-url> --workitem-id <id> --file <filepath-1> --file <filepath-2> --json
|
|
207
|
+
```
|
|
208
|
+
|
|
209
|
+
上传令牌通过 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)。
|
|
210
|
+
|
|
211
|
+
## 下载工单附件
|
|
212
|
+
|
|
213
|
+
把工单上已有的需求/设计文档下载到本地目录,再用本地文件工具阅读,避免把大文件或二进制附件搬进会话上下文:
|
|
214
|
+
|
|
215
|
+
```bash
|
|
216
|
+
npx -y autowonder@0.3.30 workitem download --server-url <autowonder-server-url> --workitem-id <id> --file <name-or-id> --output-dir <dir> --json
|
|
217
|
+
```
|
|
218
|
+
|
|
219
|
+
下载令牌通过 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)。
|
|
220
|
+
|
|
221
|
+
## 上传定时任务附件
|
|
222
|
+
|
|
223
|
+
把需求/设计文档上传到 7x24 定时任务,用法与工单附件一致(同一套上传令牌与预检规则):
|
|
224
|
+
|
|
225
|
+
```bash
|
|
226
|
+
npx -y autowonder@0.3.30 scheduled-task upload --server-url <autowonder-server-url> --scheduled-task-id <id> --file <filepath-1> --file <filepath-2> --json
|
|
227
|
+
```
|
|
228
|
+
|
|
229
|
+
上传令牌同样通过 `autowonder.workitem_cli_upload_token` 签发(令牌为用户级,对当前可修改的任意定时任务生效),经 `--token` 或 `AUTOWONDER_UPLOAD_TOKEN` 传入;退出码约定与 `workitem upload` 相同。
|
|
230
|
+
|
|
231
|
+
## 管理 daemon
|
|
232
|
+
|
|
233
|
+
```bash
|
|
234
|
+
npx -y autowonder@0.3.30 status
|
|
235
|
+
npx -y autowonder@0.3.30 stop
|
|
236
|
+
```
|
|
237
|
+
|
|
238
|
+
默认 API 是 `http://127.0.0.1:34989`,日志位于 `~/.autowonder/daemon.log`。npm 包不包含任何 agent、MCP 或服务端凭证。
|
|
239
|
+
|
|
240
|
+
## 日志轮转与保留
|
|
241
|
+
|
|
242
|
+
daemon 会话日志、`cli start` 重定向的 `~/.autowonder/daemon.log`、service 的 stdout/stderr 日志以及 token-proxy 诊断日志都会按大小与日期轮转,且每类日志只有一个轮转写入方。轮转采用改名后重开同一路径的方式,不会原地截断,也不会删除仍被其他进程打开的文件;改名失败时继续写当前文件,单次失败不会关闭日志。
|
|
243
|
+
|
|
244
|
+
daemon 内置独立于工作区 GC 的保留清扫:默认每小时运行一次,删除修改时间超过 TTL(默认 72h)的已关闭日志。运行中写入方的活动文件始终排除,单个文件处理失败只记录并继续,符号链接与目录不会被跟随。任务 capsule 内的日志、token 计量数据、CA 证书与 `config.json` 不属于托管日志,不会被自动删除。
|
|
245
|
+
|
|
246
|
+
可用环境变量调整:
|
|
247
|
+
|
|
248
|
+
- `AUTOWONDER_LOG_MAX_BYTES=104857600`(100 MiB):托管日志的轮转阈值
|
|
249
|
+
- `AUTOWONDER_LOG_RETENTION=72h`:保留 TTL,显式设为 `0` 关闭清扫
|
|
250
|
+
- `AUTOWONDER_LOG_SWEEP_INTERVAL=1h`:清扫周期
|
|
251
|
+
- `AUTOWONDER_RAW_LOG_MAX_BYTES=104857600`(100 MiB):`AUTOWONDER_DEBUG=1` 时 token-tap 原始响应抓包的单文件上限,达到上限后停止写入,但不影响隧道继续转发
|
|
252
|
+
|
|
253
|
+
取值格式非法时回落到默认值。
|
|
254
|
+
|
|
255
|
+
## 调试
|
|
256
|
+
|
|
257
|
+
```bash
|
|
258
|
+
npx -y autowonder@0.3.30 connect ... --debug
|
|
259
|
+
```
|
|
260
|
+
|
|
261
|
+
`--debug` 会让 CLI 以 `AUTOWONDER_DEBUG=1` 启动 daemon,把完整的 daemon 与 agent 活动(runtime 事件流、provider 事件解码、重试退避与会话门等待、空闲时的阻塞点)同时输出到控制台和会话调试日志。调试日志不做脱敏,仅用于本机排障;不传 `--debug` 时该环境变量不会注入。
|
|
262
|
+
|
|
263
|
+
daemon 把仅用于展示的事件(`text`、`thinking`、`log`、`thinking_started`、`thinking_completed`)放进有界单协程队列(4096 条 / 16 MiB,关闭时最多等待 5 秒排水),与业务事件处理隔离:展示通道变慢或阻塞不会拖住工具、卡片、回执等业务控制事件。排队溢出或未送达只计入丢失量,并以 `provider_observation_delivery_summary` 事件和结果里的 `observationLoss` 元数据上报。诊断/日志写入失败不会把已成功的业务执行变成投递失败,完成边界后的 diagnostic flush 错误也不会凭空创建 completion 投递所有权。该机制对执行机用户无新增参数或环境变量。
|
|
264
|
+
|
|
265
|
+
`--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>`,避免执行器令牌或对象存储签名外泄。
|