用途 ketchup-video 用于在 Pstack 任务中向用户做一次视频形式的进度回顾。当用户请求视频回顾时使用。它以 /ketchup 为基础,但不再输出摘要和视觉画面,而是生成一段带字幕的幻灯片短视频来展示发生了什么。
时间范围 视频的时间窗口从用户写下 /ketchup-video 之前最后一条消息开始,而不是从更早的 /ketchup 之前开始。
回复结构 回复包含四项:ketchup 的开场句;嵌入的视频(宿主无法嵌入时给出文件链接);一行说明还有哪些工作可由你自行完成;以及行动项。视频展示某次调用的选项时,须用视频给出的名称称呼每个选项。若渲染失败,用一行说明,并只给出调用项。
幻灯片
- 素材应使用工作产出的截图、录屏、差异和数据,而不是聊天里对这些内容的文字描述。
- 绘制前先写下用户应带走的一句话,以及每页一行说明;删掉不改变用户认知的幻灯片。
- 最多 10 页,越少越好;这两条笔记不放入回复。
- 每页只讲一个要点;各页在同一张图上变化,而不是切到无关图片;颜色或形状在每页含义一致。
- 用图片展示工作,例如系统如何运作、PR 栈及各 PR 状态、修复前后的对比、并排的选项。用箭头、高亮和动效指向变化。
- 幻灯片不得是项目符号列表、状态列表、表格或没有关联的方框。
- 文字尽量精简;标签放在其所指对象上,用日常词语,而非“Tests: pass”之类标签;不为图片配文字说明,同一事实不在各页之间或字幕中重复。
- 展示用户每项要求的进展及其状态(完成、运行中、失败或未检查);不把仍等待用户的事项显示为已完成;展示途中发现并修复的缺陷。若可见变更没有截图,在该页说明并指出屏幕上改了什么。只依据已有事实绘制,不虚构数字,不绘制未截取的画面。
字幕 每页配一行简短字幕,约十个词,从该页所示内容出发说明要点,表达图片含义而非朗读标签。字幕置于幻灯片下方的条带内,各页条带等高,除字幕外留空,不遮挡幻灯片;字号小但在聊天尺寸播放时清晰可读。
渲染
- 渲染一段无声横屏视频(如 mp4),页间带动效。每一帧都是幻灯片本身,满幅显示在字幕条上方。
- 帧由幻灯片生成,绝不通过录屏获得;每页字幕烧录进该页帧中,使其在整段停留期间显示。
- 停留时间指幻灯片完全在屏的时间,不含进出动效。每页停留需足够读完其新增文字,每三个词至少一秒。一页新增其字幕及此前未出现的每个词,包括被更改的标签;第一页新增其全部文字;截图内的词不计入。
- 嵌入视频前检查渲染文件:以聊天尺寸查看每页的一帧,确认字幕可读且不遮挡内容;用将文件帧与幻灯片匹配的方式测量每页停留时间,而不用静帧检测器(它会把淡入淡出的微弱帧算作静止);对照测得停留时间统计每页新增词数,无法读完的页须修正后重新渲染并再次检查。
适用场景 适用于用户在 Pstack 任务中需要以短视频而非文字摘要了解工作进展的场合。
限制 未提供关于平台支持范围、视频时长上限、价格或收费方式的明确信息。视频须无声、横屏,幻灯片最多 10 页,文字须精简,且不得通过录屏生成帧。