文档目录

工作

报告

Worker 推给你的两种页面,怎样归集、回答、撤回和分享。

报告是 Worker 推给你看的页面。两种:

按工作流组织归集

每个工作流组织至多两份报告,名字由组织的名字得出:<组织名>-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 撤回这个会话推的、还在等回答的版本

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。