lieflat-code-video-starter 是一个公开的可运行入门项目，用于创建和改编简短的产品宣传片。它属于该项目的公开 starter，而非私有完整生产工作流。
用途与流程：项目引导用户先根据产品描述、目标受众、真实产品界面和预期行动号召确定故事并写出简短大纲，只使用有依据的产品说法，不得把示例中的虚构数据当作真实产品事实。随后在本地打开 lens/index.html 选择镜头或转场参考；这些编号示例是一套词汇，并非可直接互换的生产组件，其中 16 是反例、32 是节奏规则、15 和 37 需要自定义实现。建议选择贯穿镜头的连续对象或动作，例如提示词逐渐长成结果、光标引导镜头、或词语原位变化。
使用方式：将 starter/ 复制到工作项目目录，用 npm ci 安装固定依赖并保留 package-lock.json，运行 npm run studio；要求 Node.js 22 或更高版本。主要文件包括 src/content.ts（产品名、文案、颜色、可选音乐文件名）、src/film.ts（分段、节拍网格、打字、点击与结果时序）、src/Video.tsx（虚构 UI 与合成）、src/kit/（镜头、弹簧、字体、表面、转场与指针）。
主要能力与约束：默认影片为 12 秒、1920×1080、30fps；不要在未适配布局和基于帧的辅助逻辑前更改帧率或宽高比。动画必须由帧驱动，在 Scene 内用 useG() 表达全局帧时序，使用内置缓动与弹簧辅助，避免 CSS 动画、挂钟计时和无种子随机。使用产品自身内容或明确标注的虚构样稿；制作真实产品影片时替换 Acme Notes 名称与示例文案。文字应简洁，界面裁切可读，镜头运动有目的，并确认打字在发送动作前完成。
验证与交付：运行 npm run typecheck 和 npm run check，再用 npm run preview 检查首帧、每次转场、结果状态和结尾的实际画面；仅靠时序检查不能证明视觉质量。替换文案后要检查排版；中文内容需添加合适授权的中文字体，内置拉丁字体不够用。保留可读的片尾时间信息，并在开启运动模糊的情况下审看最终输出。运行 npm run render 输出 1080p H.264 影片到 out/film.mp4。默认样片无声；如需音乐，将用户自有的已授权音轨放入 starter/public/ 并在 src/content.ts 设置 musicFile。可用 npm run events 导出时序提示给外部音频编辑器。交付渲染视频并注明仍存在的视觉或音频限制。原项目的高级采集、自动验证与混音工具不包含在本 starter 中。
许可：随附项目代码与本指南依据 LICENSE.md 提供；超出该许可的商业使用需另行书面授权（larashero3@gmail.com）。第三方依赖与素材保留各自许可，见 USAGE.md 与 THIRD_PARTY_NOTICES.md。