跳到正文
FunCoding

搜索

搜索文档、Skill 和 MCP

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 都不属于当前版本。