dsh-drawai 0.4.2 → 0.4.4

package/lib/motion/shotcraft/upstream/references/final-review.md

@@ -1,121 +1,121 @@
-# final-review — 成片独立终检
-
-独立审查 Agent 使用本清单验证“成片是否符合当前创作模式的制作基准”，并结合
-`aesthetic-rules.md` 检查视觉技术质量。审查 Agent 必须处于干净上下文，不参与
-制作；不要给它制作过程中的理由、辩解、修改历史或预期结论。
-
-## 审查输入
-
-- 最新成片 MP4 和每镜头关键帧；
-- 创作模式：直接使用模板、自主自由创作或共同创作；
-- 产品视频简报与必须展示的功能；
-- 需求到执行决策表；
-- 共同创作中用户确认、自主自由创作中 Agent 记录的视觉方向、品牌 tokens、
-  styleframe（或跳过理由）和禁用风格；模板模式则提供原模板结构与实际替换记录；
-- 功能到镜头映射；
-- 用户指定或 Agent 在设计 spec 中记录的 Gallery 卡名与具体变体；
-- `gallery/api/library.json` 中对应卡片与 `style-key` 记录；
-- 卡片文档定位到的准确 demo TSX 源码；
-- 对应 Gallery 参考样片，或从参考样片抽出的关键帧/contact sheet；
-- 最终分镜、字幕、页面状态和 SFX 计划；
-- 选中的 `references/shots/*.md`；
-- `aesthetic-rules.md`；
-- 数据合规口径。
-
-缺少某项输入时标记“无法验证”，不要自行猜测制作基准。索引、卡片文档、
-demo 源码与 Gallery 参考样片互相冲突时，明确报告冲突来源，不自行挑一个当真相。
-
-## 检查项
-
-### P — 产品目标
-
-- P1：产品定位、目标用户和核心卖点是否清楚；
-- P2：成片是否把注意力放在当前模式确认或记录的功能优先级上；
-- P3：是否出现项目不存在、未经确认或容易误导的功能宣称。
-- P4：需求到执行决策表中的执行选择，是否能在分镜、文案、页面状态、音频和素材中
-  找到对应落地；不得用固定的“受众/用途→风格”刻板映射替代项目依据。
-
-### F — 功能完整性
-
-- F1：每个“必须展示的功能”是否至少有一个清楚可辨的镜头；
-- F2：每镜头是否提供新信息，是否存在重复功能或重复 tagline；
-- F3：页面状态是否能让观众理解功能，而不只是装饰性运动。
-
-### V — 视觉方向
-
-- V1：字体、色板、材质、圆角、光感和信息密度是否符合确认或记录的视觉方向；
-- V2：动效速度、过冲、停留和能量曲线是否符合确认或记录的动效性格；
-- V3：是否偏离制作基准，漂移到 Ink Press、赛博霓虹或其他无关风格；
-- V4：禁用的颜色、效果或品牌特征是否被使用。
-
-### S — 镜头卡与 Gallery 变体
-
-- S1：功能映射中的镜头卡是否实际出现在对应镜头；
-- S2：用户点名 `卡名 · 样式名` 时，`style-key`、准确 demo TSX 和 Gallery
-  参考样片是否指向同一变体，成片是否使用该变体；
-- S3：对照准确 demo TSX 与 Gallery 参考样片，是否保留配方卡/demo 的动作
-  语法、关键时值、缓动关系和遮罩时机；
-- S4：是否违反卡片标注的“已知坑/命门”；
-- S5：适配后的产品截图、坐标和品牌 token 是否自然。
-- S6：标为“仅供参考，需要自定义实现”的样式是否得到用户明确点名，并在报告中标注
-  其实现风险；标为“缺少预览”的样式是否避免声称与动态样片一致。
-
-不要求和 Gallery 样片像素级一致。检查的是运动语法和关键参数是否忠实，同时
-允许为目标产品调整截图、坐标、文案、品牌视觉和必要构图。
-
-### B — 分镜一致性
-
-- B1：镜头顺序、时长和功能信息是否符合确认或记录的最终分镜；
-- B2：主动作、页面状态、素材来源、字幕、转场和 SFX 是否一致；
-- B3：品牌字标 hold 是否至少 1 秒，批量动效收尾是否至少静止 0.5 秒；
-- B4：是否在最终分镜放行后，无依据地删除、替换或增加关键镜头。
-
-### D — 数据与素材安全
-
-- D1：是否遵守真实数据、虚构数据或脱敏口径；
-- D2：是否暴露客户、个人、密钥、内部地址或其他敏感信息；
-- D3：表现真实产品页面时是否使用真实截图，而非低质量手搓复刻；
-- D4：截图状态、字体、图片和动态数据是否完整加载。
-- D5：公开演示数据是否有可复核的公开属性；客户、个人、内部、密钥、实时
-  或其他敏感数据是否已虚构、脱敏或冻结。
-
-### A — 音频与节奏
-
-- A1：BGM 是否符合确认或记录的音频方向，音量是否给 SFX 和可选配音留出空间；
-- A2：SFX 是否钉在真实动作关键帧，是否出现明显错位；
-- A3：强节奏音乐的切点误差是否不超过 3 帧；
-- A4：结尾能量峰值和 riser→impact→sparkle 句式是否成立（若分镜采用，按实际动作选材）；
-- A5：长样本（尤其 >5s 的动作样本）是否都显式给了 `durationInFrames`，有没有音效拖到动作结束后还在响；
-- A6：每条 SFX 在**渲染产物**里是否真的听得见（不看预览——预览把 volume 钳到 1.0）；本身录得轻的素材（峰值 <-12dB）即便给 1.0 仍可能被 BGM 盖住，是否已换素材／预归一化／给足 >1 的增益，且渲染后 max_volume 未削波；
-- A7：UI 类音效是否为适合片种的真实物件质感；合成 tone/bleep/notification 若出现，
-  是否有“系统提示”的叙事理由（sound-design §3.3）。
-- A8：配了 BGM 的片子是否交付了带 BGM / 无 BGM（保留 SFX）两版成片，
-  且两版出自同一时间线（无 BGM 版画面与 SFX 与带 BGM 版逐帧一致）；
-- A9：卡点/SFX 密集片是否对成片实测并补偿了输出音轨偏移与音源峰值
-  滞后（sound-design §4.6），补偿常数是否附实测记录（渲染管线四要素、
-  探针、测法、日期），源分析值与输出偏移是否分开记账（SOURCE_BEAT0
-  未被污染）；渲后回测误差表是否无系统性同向偏移（music-beat-sync §5b）。
-- A10：新制作/换音的 SFX 是否来自 Freesound（用户指定音源除外）；每个实际使用的文件
-  是否有素材页、作者、确切许可 URL/版本、预览或原文件标记、哈希和分析记录；
-  CC BY 是否附可用于发布的署名，未知/BY-NC 许可是否被排除；处理后是否更新记录；
-  Remotion 是否读随工程保存的文件，未将测量或热度冒充试听结论。
-
-### Q — 视觉技术质量
-
-完整执行 `aesthetic-rules.md`。至少检查文字锐度、构图、圆角遮罩、3D 纹理
-清晰度、元素落位、相机抖动、转场接缝、光效廉价感、可读时长和确定性渲染。
-
-## 报告格式
-
-每条结论使用编号，并给问题附帧号或截图：
-
-```text
-P1 ✓ 产品定位和核心卖点清楚。
-F2 ✗ 第 340 帧：已确认的知识图谱功能没有出现在成片。
-V3 ✗ 第 420 帧：大面积琥珀纸张材质偏离已确认的深蓝科技方向。
-S2 ✗ 第 515 帧：用户选择 whip-pan，实际实现为 flash-cut。
-Q2 ✗ 第 615 帧：3D 推近后正文文字发糊，见关键帧 f615.png。
-```
-
-最后按严重程度列出必须修复项、建议优化项和无法验证项。不要用没有证据的
-“整体不错”代替逐项检查，也不要为了报告好看而全部标记通过。
+# final-review — 成片独立终检
+
+独立审查 Agent 使用本清单验证“成片是否符合当前创作模式的制作基准”，并结合
+`aesthetic-rules.md` 检查视觉技术质量。审查 Agent 必须处于干净上下文，不参与
+制作；不要给它制作过程中的理由、辩解、修改历史或预期结论。
+
+## 审查输入
+
+- 最新成片 MP4 和每镜头关键帧；
+- 创作模式：直接使用模板、自主自由创作或共同创作；
+- 产品视频简报与必须展示的功能；
+- 需求到执行决策表；
+- 共同创作中用户确认、自主自由创作中 Agent 记录的视觉方向、品牌 tokens、
+  styleframe（或跳过理由）和禁用风格；模板模式则提供原模板结构与实际替换记录；
+- 功能到镜头映射；
+- 用户指定或 Agent 在设计 spec 中记录的 Gallery 卡名与具体变体；
+- `gallery/api/library.json` 中对应卡片与 `style-key` 记录；
+- 卡片文档定位到的准确 demo TSX 源码；
+- 对应 Gallery 参考样片，或从参考样片抽出的关键帧/contact sheet；
+- 最终分镜、字幕、页面状态和 SFX 计划；
+- 选中的 `references/shots/*.md`；
+- `aesthetic-rules.md`；
+- 数据合规口径。
+
+缺少某项输入时标记“无法验证”，不要自行猜测制作基准。索引、卡片文档、
+demo 源码与 Gallery 参考样片互相冲突时，明确报告冲突来源，不自行挑一个当真相。
+
+## 检查项
+
+### P — 产品目标
+
+- P1：产品定位、目标用户和核心卖点是否清楚；
+- P2：成片是否把注意力放在当前模式确认或记录的功能优先级上；
+- P3：是否出现项目不存在、未经确认或容易误导的功能宣称。
+- P4：需求到执行决策表中的执行选择，是否能在分镜、文案、页面状态、音频和素材中
+  找到对应落地；不得用固定的“受众/用途→风格”刻板映射替代项目依据。
+
+### F — 功能完整性
+
+- F1：每个“必须展示的功能”是否至少有一个清楚可辨的镜头；
+- F2：每镜头是否提供新信息，是否存在重复功能或重复 tagline；
+- F3：页面状态是否能让观众理解功能，而不只是装饰性运动。
+
+### V — 视觉方向
+
+- V1：字体、色板、材质、圆角、光感和信息密度是否符合确认或记录的视觉方向；
+- V2：动效速度、过冲、停留和能量曲线是否符合确认或记录的动效性格；
+- V3：是否偏离制作基准，漂移到 Ink Press、赛博霓虹或其他无关风格；
+- V4：禁用的颜色、效果或品牌特征是否被使用。
+
+### S — 镜头卡与 Gallery 变体
+
+- S1：功能映射中的镜头卡是否实际出现在对应镜头；
+- S2：用户点名 `卡名 · 样式名` 时，`style-key`、准确 demo TSX 和 Gallery
+  参考样片是否指向同一变体，成片是否使用该变体；
+- S3：对照准确 demo TSX 与 Gallery 参考样片，是否保留配方卡/demo 的动作
+  语法、关键时值、缓动关系和遮罩时机；
+- S4：是否违反卡片标注的“已知坑/命门”；
+- S5：适配后的产品截图、坐标和品牌 token 是否自然。
+- S6：标为“仅供参考，需要自定义实现”的样式是否得到用户明确点名，并在报告中标注
+  其实现风险；标为“缺少预览”的样式是否避免声称与动态样片一致。
+
+不要求和 Gallery 样片像素级一致。检查的是运动语法和关键参数是否忠实，同时
+允许为目标产品调整截图、坐标、文案、品牌视觉和必要构图。
+
+### B — 分镜一致性
+
+- B1：镜头顺序、时长和功能信息是否符合确认或记录的最终分镜；
+- B2：主动作、页面状态、素材来源、字幕、转场和 SFX 是否一致；
+- B3：品牌字标 hold 是否至少 1 秒，批量动效收尾是否至少静止 0.5 秒；
+- B4：是否在最终分镜放行后，无依据地删除、替换或增加关键镜头。
+
+### D — 数据与素材安全
+
+- D1：是否遵守真实数据、虚构数据或脱敏口径；
+- D2：是否暴露客户、个人、密钥、内部地址或其他敏感信息；
+- D3：表现真实产品页面时是否使用真实截图，而非低质量手搓复刻；
+- D4：截图状态、字体、图片和动态数据是否完整加载。
+- D5：公开演示数据是否有可复核的公开属性；客户、个人、内部、密钥、实时
+  或其他敏感数据是否已虚构、脱敏或冻结。
+
+### A — 音频与节奏
+
+- A1：BGM 是否符合确认或记录的音频方向，音量是否给 SFX 和可选配音留出空间；
+- A2：SFX 是否钉在真实动作关键帧，是否出现明显错位；
+- A3：强节奏音乐的切点误差是否不超过 3 帧；
+- A4：结尾能量峰值和 riser→impact→sparkle 句式是否成立（若分镜采用，按实际动作选材）；
+- A5：长样本（尤其 >5s 的动作样本）是否都显式给了 `durationInFrames`，有没有音效拖到动作结束后还在响；
+- A6：每条 SFX 在**渲染产物**里是否真的听得见（不看预览——预览把 volume 钳到 1.0）；本身录得轻的素材（峰值 <-12dB）即便给 1.0 仍可能被 BGM 盖住，是否已换素材／预归一化／给足 >1 的增益，且渲染后 max_volume 未削波；
+- A7：UI 类音效是否为适合片种的真实物件质感；合成 tone/bleep/notification 若出现，
+  是否有“系统提示”的叙事理由（sound-design §3.3）。
+- A8：配了 BGM 的片子是否交付了带 BGM / 无 BGM（保留 SFX）两版成片，
+  且两版出自同一时间线（无 BGM 版画面与 SFX 与带 BGM 版逐帧一致）；
+- A9：卡点/SFX 密集片是否对成片实测并补偿了输出音轨偏移与音源峰值
+  滞后（sound-design §4.6），补偿常数是否附实测记录（渲染管线四要素、
+  探针、测法、日期），源分析值与输出偏移是否分开记账（SOURCE_BEAT0
+  未被污染）；渲后回测误差表是否无系统性同向偏移（music-beat-sync §5b）。
+- A10：新制作/换音的 SFX 是否来自 Freesound（用户指定音源除外）；每个实际使用的文件
+  是否有素材页、作者、确切许可 URL/版本、预览或原文件标记、哈希和分析记录；
+  CC BY 是否附可用于发布的署名，未知/BY-NC 许可是否被排除；处理后是否更新记录；
+  Remotion 是否读随工程保存的文件，未将测量或热度冒充试听结论。
+
+### Q — 视觉技术质量
+
+完整执行 `aesthetic-rules.md`。至少检查文字锐度、构图、圆角遮罩、3D 纹理
+清晰度、元素落位、相机抖动、转场接缝、光效廉价感、可读时长和确定性渲染。
+
+## 报告格式
+
+每条结论使用编号，并给问题附帧号或截图：
+
+```text
+P1 ✓ 产品定位和核心卖点清楚。
+F2 ✗ 第 340 帧：已确认的知识图谱功能没有出现在成片。
+V3 ✗ 第 420 帧：大面积琥珀纸张材质偏离已确认的深蓝科技方向。
+S2 ✗ 第 515 帧：用户选择 whip-pan，实际实现为 flash-cut。
+Q2 ✗ 第 615 帧：3D 推近后正文文字发糊，见关键帧 f615.png。
+```
+
+最后按严重程度列出必须修复项、建议优化项和无法验证项。不要用没有证据的
+“整体不错”代替逐项检查，也不要为了报告好看而全部标记通过。