docs: 测试体系与 ClipCard 用法文档化 - #48
Merged
Vincentwei1021 merged 1 commit intoAug 25, 2026
Merged
Conversation
合并 Vincentwei1021#42(vitest) / Vincentwei1021#43(demo 冒烟) 后,测试体系在 SKILL.md / demos/README 完全没被提及——用户和代理不知道有这些测试、怎么跑、何时跑。补齐: demos/README: - 新增"真实视频素材(ClipCard)"节:ClipCard 完整参数表(src/caption/size/ muted/startFrom/loopDurationInFrames/durationInFrames 等)、交叉淡化循环 原理、已知坑(必须传 durationInFrames / startFrom 超长自动回退 / 建议 30fps 方形素材)、参考 demo 定位 - 新增"测试与验证"节:类型编译 + 渲染冒烟两层验证,本地全量/子集/列出 的跑法(含 motion-blur 临时装),--subset 指向不存在 demo 时退出码 1 SKILL.md: - 资产清单新增"测试(仓库内自动验证)"条目:纯函数单测(npm test)、 demo 渲染冒烟(smoke-render-demos.py)、CI 已自动跑三层 ClipCard 作为容器组件(非动效镜头)不入 152 卡体系,按用户决策只做文档化。
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
背景
#42(vitest) 和 #43(demo 冒烟)合并后,测试体系在 SKILL.md / demos/README 里完全没被提及——用户和代理不知道有这些测试、怎么跑、何时跑。ClipCard(#39)合并后也只有 SKILL.md 一句话,没有完整用法文档。
改动
demos/README.md
SKILL.md
设计决策
ClipCard 是容器组件(把真实 mp4 包成卡片主体),不是动效镜头——按你的建议不入 152 卡体系,只做文档化(避免污染"152 张镜头卡"的语义)。gallery 无 drift。
验证