Skip to content
FunCoding

Search

Search docs, Skills and MCP

Agent Board 文件协作

让独立进程领取任务和回复问题,区分身份标签、超时推导与真实进程控制。

This page has not been translated into English yet. The original Chinese version is shown below.

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