文档目录
工作
报告
Worker 推给你的两种页面,怎样归集、回答、撤回和分享。
报告是 Worker 推给你看的页面。两种:
- Review Report(评审报告):要你回答问题或做决定。你在页面上作答,回答作为消息回到推送它的会话。
- Presentation Report(展示报告):给你看结果,网页幻灯片。最后一页可以是意见页。
按工作流组织归集
每个工作流组织至多两份报告,名字由组织的名字得出:<组织名>-R 是它的 Review Report,<组织名>-P 是它的 Presentation Report。组织里不管哪个运行、哪一步、哪个 Worker 推送,都追加为对应那一份报告的新版本。
界面的报告下拉栏直接列出报告名,选中一份后按版本切换。
推送
都是会话里的命令行,推送者就是调用它的会话。命令不等你回答,返回报告名、版本号和链接。
| 命令 | 做什么 |
|---|---|
ail report review <目录或文件> --title <标题> |
推一个 Review Report 的版本 |
ail report present <目录或文件> --title <标题> |
推一个 Presentation Report 的版本 |
ail report ask <题目.json> |
一个不用看图的问题:不做页面,Desk 把题目呈现出来 |
ail report preview <目录或文件> |
推一份预览,只有拿到地址的人看得到,保留 24 小时 |
ail report withdraw |
撤回这个会话推的、还在等回答的版本 |
- 内容是一个 HTML 文件,或一个文件夹里的全部文件,合计不超过 64 MiB。
- 内容没变不产生新版本。
- 一个会话推了新版本,它之前推的、还在等回答的版本随之撤回。
ail report ask 的题目是一份 JSON:
{
"title": "导出哪些列",
"ask": "定下导出范围后我接着实现。",
"question": "导出全部列,还是只导出当前可见的列?",
"options": [
{"name": "全部列", "effect": "文件完整,但包含用户隐藏的列"},
{"name": "可见的列", "effect": "和页面一致"}
],
"recommend": "可见的列",
"reason": "和用户在页面上看到的一致"
}
回答
你在 Review Report 页面底部的作答栏作答并提交。Desk 把回答记在这个版本上,并排进推送这个版本的会话的队列;会话忙着时等它这一轮结束再送。不经 Router。
推送者的运行已经结束时,回答照样送到:会话重连后接上,Worker 保留着上下文。
等回答与撤回
一个 Review Report 的版本从推送起在等回答,直到你回答了、跳过了,它被撤回了,或同一个会话推了新版本。等回答的版本在界面上有标记,它的运行在看板上是 waiting。
分享
Desk 启动时带了 --share-listen 才有分享:它另开一个监听,只提供被分享的报告。报告页头的「内网分享」生成一个链接,「停止分享」让链接立即失效。评审者提交的意见只进 Desk,由你整理后再转给 Agent。