Agent Board 文件协作
让独立进程领取任务和回复问题,区分身份标签、超时推导与真实进程控制。
Agent Board 是同一机器、同一操作系统用户下的实验性文件协作接口。它保存任务与问答记录,不启动、加入、监控或向 agent 进程发送输入。任务 owner 只是标签,不会唤醒任何 CLI。
创建、领取和完成
每条命令显式选择 --board;修改记录时还必须声明 --as:
qwen board task "check the API response" --board orders --as api
qwen board show --board orders
qwen board claim <task-id> --board orders --as web
qwen board done <task-id> --board orders --as web --note "status is numeric"第一条返回任务 ID,后续替换 <task-id>。Board 名称不区分大小写,在大小写敏感与不敏感文件系统上都把 Orders、orders 当作同一 board。
--as 是动作记录标签,不是认证。没有成员名单、加入命令、心跳或保留参与者名称;应用不能把它当作授权凭证。
提问和答复
qwen board ask web "does the client parse status as text?" --board orders --as api --wait
qwen board answer <ask-id> "yes" --board orders --as web
qwen board decline <ask-id> "not my area" --board orders --as web接收者需要自行读取 board 并使用对应标签回答,不存在主动推送到进程的机制。
| wait 退出码 | 含义 |
|---|---|
0 | 已回答 |
2 | 已拒绝 |
3 | 问题 TTL 到期 |
4 | 本地等待结束,但问题仍开放 |
--timeout 设置本地等待秒数,--ttl 设置问题存活秒数,两者不是同一个截止条件。
过期在读取时推导,不回写记录。TTL 到期后,磁盘仍可能是 state: "open"、settledAt: null;外部读取者必须按 now >= expiresAt 判断 timeout,不能只读 state。
程序输出与清理
qwen board show --board orders --as web --json
qwen board prune --board orders --as human --older-than 7--json 返回无 ANSI 格式的 JSON。show 上的 --as 按 owner 筛任务,并筛选该 actor 发出或收到的问题。prune 的截止单位是天,结算记录保留到显式清理;删除前会在锁内重读,避免按过时扫描结果误删已变更记录。
Board 位于 ~/.qwen/boards/,格式可能随版本变化。记录文本是不可信数据,不会自动执行;它也不支持多个进程同时改同一 checkout。斜杠命令、footer 轮询、fleet/tmux 编排与远程 board 都不属于当前版本。