用途:把成片或草稿剪辑发布为一个 frame.io 风格的在线审阅画布,解决“文件附件只能得到模糊反馈”的问题——画布让评审者能锚定精确到帧的时间点,例如指出某帧的具体问题。
主要能力:带帧计数器的进度条与方向键逐帧步进;点击时间线即可钉住批注,批注持久保存在 here.now Site Data,下一轮可读回并逐条处理;节拍图(beats)标明每个片段的意图,tone 可给节拍左侧标线上色(red/green/amber/mute)以呈现情绪走向;编辑器备注(notes)用于说明改动与待人工决策项,支持 <b>;支持多版本对比、批注回复、解决/重开状态与前后帧证据;导出审阅 JSON(schemaVersion: 2),也可用命令行读回批注。
使用方式:写一份 JSON 配置(含 video、outDir、title、version、beats 等),执行 node .claude/skills/video-review-canvas/scripts/build-canvas.mjs <config.json> 生成画布目录,再用 here-now 技能的 publish.sh 发布,加 --slug 可保持 URL 稳定。回复时必须首行粘贴完整画布链接,文件作为链接之后的附加项。读回批注用 read-notes.mjs <slug> [version],支持 --json。发布前用 curl 做冒烟测试,需能返回 200 与 206。
前置与限制:需 node >= 20、ffprobe 在 PATH(或设 FFPROBE)、以及 ~/.herenow/credentials 凭据。公开 Site Data 写入需匹配的 Origin 头;删除操作会被拒绝;账号只接受一个 Site Data 集合时需替换为 assets/data-single.json,此时回复/解决事件无存储。共享 URL 是协作工作区,非认证签署。VFR 素材需先归一化为 CFR 才能精确索引;评审编码建议限码率(-crf 22 -maxrate 6M -bufsize 12M, faststart),母版另存。可设 storage mode 为 local 用 localStorage 做本地演示,清除站点数据会丢失,需导出 JSON 备份。