帮助中心功能说明原型与验收
原型与验收
功能说明

原型与验收

这是什么

原型是界面的样子:先画出来,你点头了,再照着做。做完拿原型对照,验收时看「原型」和「做出来的」并排截图,一眼看出对没对上。

验收是会话做完后,你看一眼对不对:对了点「做完了」,改动合进正式代码;不对点「退回」,说哪里不对,会话接着改。

什么时候用

  • 要改界面:先原型、定稿、再实现。界面对不对,最难用文字说清;改原型比改代码便宜得多。
  • 没有界面的事(后端、命令行工具、写文档):不用原型,直接做、直接验收。

第一次用时设一下

接原型(项目设置 › 原型 › 接原型):选原型所在的文件夹。要先构建的原型,填一条构建命令,批准一次。批的是命令原文和它直接调用的脚本,命令或脚本改了会再问你。

登记开发版(项目设置 › 运行和预览):登记项目跑起来的启动命令,比如 pnpm dev,批准一次。会话要起开发版、截图和原型并排对照,就靠这一条;没批的命令起不来。你也可以让会话读完仓库起草好,你只点「批准」。

选需求怎么走(项目设置 › 规矩 › 需求怎么走):见下面「需求:好几步串着做」。

怎么用

看原型

按 ⌘\ 打开右侧栏。

  • 页面栏里点一页就换过去;能切情况(比如空状态、出错时)、切深色。
  • 能放到中间按设计尺寸看,也能单独开一个窗口。
  • 版本那里能看「已提交」的和「没提交的改动」;构建坏了照样显示上一次成功的。
  • 原型在另一台电脑上时,那台构建好以后同步到这台;那台不在线也能看已经存好的那一版。

改原型

  1. 在右侧栏下半截点「开一个原型会话」,它开在原型目录里。
  2. 直接跟它说改哪里。你发的话会带上你正在看哪一页、哪个情况。
  3. 想指着说:点「选元素」,再点原型上要改的地方,它就知道你说的是哪块。
  4. 它改了不用提交,半分钟内右侧栏自己刷新。

定稿

改满意了,点右侧栏原型下面的「定稿」。原型会话这时才提交这一版。已定稿的那一版写着你几点定的。

原型会话不会每轮自己提交,所以开发拿到的一定是你定稿的那一版。任务上写着照原型的哪一版、哪个情况做;原型后来又改了会提示。

需求:好几步串着做

要好几步串着做的事(比如先画原型、再实现)叫「需求」。左栏里同一需求的会话归成一组,右边写「2 / 3 步」。

每个项目选一种走法(项目设置 › 规矩 › 需求怎么走),小去建需求时照着挑;单个需求跟小去说一声能换:

走法适合
看有没有原型有原型的要原型,没有的直接做(大多数项目选这个)
要原型的原型 → 实现 → 原型会话对照 → 你验收
直接做 → 验收没有界面的后端、命令行项目
只调研不改代码,交一份结论

同一页还有两项「谁替你看」,关着时这一步问你:

  • 小去核过就定稿:原型对得上你当初的原话就定稿,交给要改的会话;你原话里没说的照样问你。
  • 原型会话代你看界面:会话做完,先交原型会话对照原型。对不上打回去改,最多 2 轮;还对不上就交给你定。

每一步都做完,「等你」里出一件「整个需求做完了」,可以一起验,也能单个点开看。

验收

打开「等你」里的任务,最上面一屏就是验收:

  • 原型和做出来的截图并排(没有界面的项目不放截图)。点开能铺满窗口看:并排、上下或只看一边,⌘ 加滚轮缩放,← → 换一边。
  • 测试、验收标准、改了多少,写成一行。
  • 小去先看过的,他的建议也写在上面。
  • 下面是「做完了 / 退回 / 打开会话」。

退回时写一句哪里不对,截图可以直接贴进来,会话接着改。也可以直接跟小去说「QS-13 退回,按钮要放右下角」(QS-13 是任务编号)。

系统先替你挡了这些,不用你操心:

  • 测试没过、合并有冲突的,不算做完,任务留在「等你」写清原因。
  • 会话交验收前,QU 先拿它的改动试着合一次(不真合,只看合不合得上);合不上让会话当场解掉。
  • 还没合的几件之间会冲突的,也提前告诉负责的会话。
  • 写文档的任务要是改了代码,会标出来,不能直接验收。

小去建议通过的几件,可以在「等你处理」里一起验收。

小去直接验(默认关)

小改动可以让 QU 替你验收并合进去。在「项目设置 › 小去直接验」里打开、选哪几类任务。下面几条全满足才替你验:

  • 验收标准至少一条,而且都勾了;
  • 最后一次改代码后测试全过(有 PR 的,CI 也过了);
  • 要先看计划的,计划你同意过;
  • 改动不大:不超过 5 个文件、150 行(生成的和测试文件不算);
  • 小去看过,建议通过。

改了界面、部署、数据库的,默认照样等你,要放开得单独勾。客户项目、改了依赖、删了文件、改了图片字体、改了 CI 配置的,一直等你。一天最多 10 个,验过的你随时能撤回(已经合进去的不会自动撤掉)。

常见问题

没有原型能用 QU 吗? 能。没有界面的事直接做、直接验收;验收时没有并排截图,看测试、验收标准和改动。

验收时一定要一个个截图比对吗? 不用。并排截图会话已经截好了,你看一眼就行;要细看再点开放大。

原型会话和普通会话有什么不同? 原型会话开在原型目录里,只改原型;你点「定稿」它才提交。