余也鱼
一个入口、两种制作模式。视频画幅固定16:9，默认1920×1080。运行于Windows或macOS的本地WorkBuddy；需文件读写和终端执行能力。
开始
- 理解选题、受众和本轮范围。用户说白板/边画边讲时走白板；调查/商业消费长片走调查；两者均可时只问一次风格。不要因用户只要稿件或精修而执行完整生产。
- 首次执行
node scripts/esmodules/setup-fonts.js安装并校验OFL字体（发布ZIP仅含文本，无字体二进制）；然后读 references/setup.md，检查依赖及密钥是否已配置。仅报告配置项是否存在，禁止输出密钥、复制凭证到项目或发布包。缺凭证时先推进查证、稿件和静帧。 - 工作目录使用用户指定位置，源工程、缓存、视频和图片不要写进技能安装目录。Windows默认 D:/Codex/yuyeyu-projects；macOS默认 ~/Movies/yuyeyu。写入前检查目标和可用空间。默认自动将项目和构建产物分别放进工作目录的episodes/和build/。用户指定其他位置时设置YUY_WORKSPACE环境变量，或在config.json中明确指定dirs。字体下载到技能字体目录；依赖安装和运行缓存可在技能 .runtime 内。
- 品牌为空，无强制水印。技能名不代表使用者账号名，按用户提供的品牌配置。
白板讲解
先读 modules/whiteboard-video/references/dsl.md、scene-patterns.md；需要贴纸时读 references/image-api.md。仅允许Cloudflare云端文生图；不得使用参考图、图生图或本地生图模型。原模块文档是画面和编排参考；运行命令一律使用这里的跨平台入口，不运行 Bash，不调用 Codex。
node scripts/setup.js whiteboard安装依赖（首次需要联网与空间，见setup）。node scripts/wb.js new "标题"建立一期；编辑生成的scenes.js，先旁白再画面。node scripts/wb.js stills "标题"生成静帧，逐张检查后再配音。node scripts/wb.js image "标题" item="英文描述"生图并抠白底。最多四张贴纸拼成一张云端生成图后本地切分；不接受--ref或--likeness。node scripts/wb.js tts "标题"使用火山TTS。node scripts/wb.js build "标题"出片、SRT及封面；缺依赖、音频或有效画面应停止并报告，不制作假完成产物。
默认2分钟左右不作为硬性时长；按用户要求和实际配音调整。底部字幕区及品牌区不得遮挡。视频16:9，封面默认也16:9；用户明确要求其他封面比例时仅改封面。
调查长片
先读 modules/investigation-video/references/long-form-workflow.md、pipeline-playbook.md、editorial-and-materials.md 与 modules/video-common/references/fact-check.md。沿用素材覆盖、真实证据、配音时间戳和验收规则，但上游个人路径、署名、已认可作品和案例数字不代表本用户已批准，不能直接作为本片事实。
node scripts/setup.js investigation安装固定版本Remotion依赖；Python需Pillow，FFmpeg/ffprobe需在PATH。- 每期独立工程。将modules/investigation-video/template/remotion复制到工作目录（不复制node_modules），在项目安装依赖。模板仅演示16:9合成，不是自动调查成品。制作真实动态拼贴与图解时阅读modules/investigation-video/references/visual-code-reference.md中的上游代码技巧，按本期事实和真实素材改写；不要把环境演示模板当成完整长片视觉方案。
- 先查证写稿，再做逐段素材覆盖表，实拍缺口解决后编排Remotion。真实品牌、新闻证据不得用AI伪造。AI图仅作明确标识的概念示意或封面。
- 配音：
node scripts/esmodules/tts-investigation.js "文本" "输出.wav"，同时输出时间戳JSON与SRT；长稿分段合成并按实际时长建立时间轴，拼接时按各段实际起点平移字幕，不能把各段零起点SRT直接拼在一起。 - 生图/封面：
node scripts/esmodules/image-api.js "提示词" "输出.png"，输出1920×1080：模型原图在本地等比缩放加白边，不承诺原生16:9。AI封面中文字与品牌可以在本地另行合成，检查可读性。 - 使用
node scripts/investigation.js still "工程目录" "静帧.png"检查，node scripts/investigation.js render "工程目录" "无声视频.mp4"渲染；之后node scripts/esmodules/mix-investigation.js "无声视频.mp4" "旁白.wav" "成片.mp4" [配乐.mp3]。 - 发布文案可使用modules/investigation-video/assets/check-publish-copy.py校验。不要运行旧的mix-bgm.sh、tts-s20.js和硬编码个人工程路径的脚本；如需旧算法先按本期工程路径调整。
交付
成片、SRT、封面、发布文案、事实和素材来源台账，以及实际检查结果。读 modules/video-common/references/delivery-qa.md。完整解码、抽帧、字幕与声音检查需报告各自结果；静态检查不等于观看通过。没有公开发布指令不发布。
外部服务与限制
旁白与文本发送给火山引擎；仅生图提示词发送给Cloudflare Workers AI。由每位使用者自己配置账户并承担服务费用。不内置共享密钥。生图固定@cf/black-forest-labs/flux-1-schnell，使用CLOUDFLARE_ACCOUNT_ID和CLOUDFLARE_API_TOKEN，不复用旧供应商或TTS密钥。保持Workers Free套餐；额度或限流错误后停止本UTC日请求，不重试、不转付费、不部署Worker、不使用AI Gateway预付费或其他模型。
包体小于10,000,000字节。依赖和运行产物不包含在技能ZIP内；安装后的占用会更大。Windows开发机可执行的验证与macOS/WorkBuddy客户端实测必须分开报告。上架审核结果由平台决定。
