` 内部，否则 HyperFrames 渲染器无法管理视频播放，**视频将冻结在第一帧**。\n\n```html\n\n
\n
\n\n\n
\n```\n\n```html\n\n
\n \n
\n```\n\n**视频标签必备属性清单：**\n\n| 属性 | 说明 |\n|------|------|\n| `id` | 唯一标识，如 `v-scene1`（缺少则渲染冻结） |\n| `class=\"clip bg-video\"` | `clip` 让框架管理可见性，`bg-video` 应用视频样式 |\n| `muted playsinline` | HyperFrames 接管播放，严禁加 `autoplay` 或 `loop` |\n| `data-start` | 视频在时间轴上的起始秒数 |\n| `data-duration` | 视频播放时长 |\n| `data-track-index` | 设为 `3`（与音频轨 0、场景轨 1/2 错开） |\n\n**全局装饰层（模式 B 推荐）：**\n```html\n
\n
\n```\n\n### 3.3B CSS 规范 — 模式 B（文字叠加排版）\n\n**核心 CSS 铁律：**\n```css\n.bg-video {\n position: absolute; inset: 0;\n width: 100%; height: 100%;\n object-fit: cover;\n opacity: 1; /* 👈 必须！覆盖 .clip 的默认 opacity: 0 */\n}\n\n.dim-overlay {\n position: absolute; inset: 0;\n background: rgba(0, 0, 0, 0.55); /* 确保文字可读 */\n}\n\n.bottom-gradient {\n position: absolute; bottom: 0; left: 0; right: 0;\n height: 600px;\n background: linear-gradient(to top, rgba(10,10,10,0.95) 0%, transparent 100%);\n z-index: 1;\n}\n```\n\n**文字叠加组件库：**\n\n| 组件 | CSS 类 | 用途 |\n|------|--------|------|\n| 大标题金句 | `.headline` | 核心冲击句 |\n| 超大数字 | `.headline--huge` | 数据对比 |\n| 正文旁白 | `.body-text` | 常规叙述 |\n| 小字说明 | `.caption-text` | 补充信息 |\n| 强调色 | `.accent` | 关键词高亮 |\n| 不等号卡 | `.neq` + `.text-card` | 「A ≠ B」对比卡片 |\n| 分屏对比 | `.split-compare` | 错误 vs 正确对比 |\n\n**文字定位方式：**\n- `.text-layer--bottom`：底部三分之一（大多数叙述场景）\n- `.text-layer--center`：垂直居中（金句升华、数字冲击）\n\n### 3.4 静态验收（加入动画前的检查）\n\n用浏览器打开 `index.html`，截图确认：\n\n模式 A：\n- [ ] 每张图片完整显示，无裁切，无偏移\n- [ ] 图片在 1920×1080 的黑色背景内居中\n\n模式 B：\n- [ ] 视频背景可见（非黑屏），文字叠加清晰可读\n- [ ] `dim-overlay` 暗化效果适当（文字不被视频干扰）\n- [ ] 全屏文字卡（如「A ≠ B」）显示正确\n\n**✅ Stage 3 退出标准：**\n- [ ] 纯静态下所有视觉素材（图片或视频）100% 正确显示\n- [ ] `data-composition-id`、`data-width`、`data-height` 已正确设置\n- [ ] 模式 A：字幕通过 `textContent` 注入；模式 B：文字叠加 DOM 结构完整\n- [ ] `npx hyperframes lint .` 报 **0 error(s)**\n\nFile v1.0.0:resources/stages/stage_4_animation.md\n\n# Stage 4：动画集成与预检发版\n\n### 4.1 加入 GSAP 动画\n\n在静态验收通过后，才可加入动效。可用动画菜单：\n\n| 动效 | 代码模板 | 适用场景 |\n|------|---------|--------|\n| Ken Burns 缩放 | `fromTo(img, {scale:1.0}, {scale:1.06, ease:\"none\"})` | 所有场景默认 |\n| Ken Burns 平移 | `fromTo(img, {x:-20}, {x:0, ease:\"none\"})` | 宽场景横向扫描 |\n| 字幕淡入 | `from(sub, {opacity:0, y:20, duration:0.8, ease:\"power2.out\"})` | 所有场景可选 |\n| 场景交叉淡化 | `to(div, {opacity:0, duration:0.5}, start+duration-0.25)` | 场景过渡 |\n| 光晕脉冲 | `to(glow, {opacity:0.4, repeat:-1, yoyo:true, duration:2})` | 火焰/光源场景 |\n\n### 4.1.1 情绪驱动转场匹配\n\n场景之间的转场不应千篇一律。根据**下一幕的情绪档位**选择对应转场：\n\n| 下一幕情绪档位 | 转场方式 | GSAP 代码 | 视觉效果 |\n|-------------|---------|----------|--------|\n| 1（舒缓叙事） | 慢溶解 | `fromTo(next, {opacity:0}, {opacity:1, duration:1.2, ease:\"power1.inOut\"})` | 平静过渡，如水墨晕染 |\n| 2（紧张蓄力） | 标准交叉淡化 | `fromTo(next, {opacity:0}, {opacity:1, duration:0.5, ease:\"none\"})` | 默认节奏 |\n| 3（高潮爆发） | 硬切 + 微缩放 | `tl.set(next, {opacity:1}); fromTo(next, {scale:1.05}, {scale:1.0, duration:0.3})` | 冲击感 |\n| 4（沉默留白） | 淡入黑 → 淡出黑 | `先 to(prev, {opacity:0, duration:0.8}), 延迟 0.5s, 再 fromTo(next, {opacity:0}, {opacity:1, duration:1.0})` | 呼吸感，给观众消化时间 |\n\n### 4.2 强制预检（渲染前的最后防线）\n\n```bash\nexport PATH=./bin:$PATH\nnpx hyperframes@latest inspect YYYYMMDD/\n```\n\n**✅ Stage 4 退出标准（必须全部满足，才允许执行 render）：**\n- [ ] `inspect` 命令退出码为 0（无报错）\n- [ ] 控制台输出的 `totalDuration` 与 Stage 2.1 测量的音频时长误差 < 0.2 秒\n- [ ] 无任何 `StaticGuard` 警告\n\n### 4.3 渲染导出\n\n```bash\nexport PATH=./bin:$PATH\n# 强制渲染到项目renders目录下\nnpx hyperframes@latest render YYYYMMDD/ -o YYYYMMDD/renders/promo_video.mp4 --force-new\n```\n\nFile v1.0.0:resources/stages/stage_5_publish.md\n\n# Stage 5：发布与归档\n\n### 5.1 视频脚本元数据与多平台宣发策划补充\n\n在 `视频脚本.md` 中补充技术元数据与 **「小红书/短视频爆款宣发策划」**，确保视频具备出厂即可一键分发的高效爆款能力。\n\n#### 1. 技术参数补充（脚本底部）\n```markdown\n## 技术参数\n- **声纹**：VoxCPM2 用户克隆 / Kokoro am_adam\n- **实测时长**：{ffprobe 实测值}s\n- **BGM**：{BGM 名称} by {BGM 作者} (CC BY 4.0)\n- **YouTube**：{URL}\n```\n\n#### 2. 小红书/短视频宣发策划（脚本最下方）\n在 `视频脚本.md` 的最底部，**强制追加**小红书专属的宣发案策划，包含：\n1. **爆款标题推荐**（至少 3-4 个）：\n - *写作公式 1 (痛点直击)*：`[痛点表情] + 痛点揭露/反差怪象 + 为什么会这样？`（例如：🤯 职场怪象：为什么招的人越贵，公司反而越慢？）\n - *写作公式 2 (认知颠覆)*：`[警示表情] + 戳破某种常见幻觉/认知错误！`（例如：🚫 戳破老板的幻觉：个体优秀 ≠ 组织高效！）\n - *写作公式 3 (具体数字)*：`[下降/冲突表情] + 极端数字对比 + 场景重现`（例如：📉 协同内耗：本来3人能决定的事，为什么变成了13人讨论？）\n2. **封面/配图文字建议**：设计大字冲击的主副标题，做首屏抓手。\n3. **小红书正文文案**：\n - 使用丰富的 **Emoji** 进行段落排版，提升可读性。\n - 包含：**痛点共情**（点明现状） + **干货输出**（列出 3 点精辟洞察或引述视频金句） + **互动钩子**（引导评论区分享见解，如“你们公司也是这样吗？”） + **精准热门标签**（如 `#职场那些事儿 #组织架构 #管理思维 #职场内耗`）。\n\n*规范模板示例：*\n```markdown\n## 5. 小红书宣发策划\n\n### 爆款标题推荐\n1. [小红书标题 1]\n2. [小红书标题 2]\n3. [小红书标题 3]\n\n### 封面/配图文字建议\n- **主标题**：[极简有力]\n- **副标题**：[点题/对比]\n\n### 小红书正文文案\n[带有丰富 Emoji、干货条理明晰、包含互动提问和小红书热门 Tag 的 300-500 字社交文案]\n```\n\n### 5.2 README 更新\n\n在 `README.md` 的「演示作品」表格中追加新作品条目（中英文双语部分均需更新）。\n\n### 5.3 Git 归档\n\n**仅 commit，不自动 push。** 推送时机由用户决定。\n\n```bash\ngit add YYYYMMDD/ README.md\ngit commit -m \"feat: Add {video_title} project\"\n# git push 由用户按需执行，不自动推送\n```\n\n**✅ Stage 5 退出标准：**\n- [ ] `视频脚本.md` 包含完整元数据（声纹、时长、BGM、YouTube 链接）以及小红书爆款标题与宣发策划文案\n- [ ] `README.md` 中英双语演示作品表格已更新\n- [ ] `git commit` 成功\n\nFile v1.0.0:resources/style_bible.md\n\n# 🎨 视觉风格指南 (FableForge Visual Style Bible)\n\n本指南是 FableForge 视频生成流水线的官方视觉规范，提供各题材、文化背景下的生图公式与排除规则，确保 AI 生成图像的风格自洽和文化准确度。\n\n---\n\n## 1. 风格决策原则\n\n- **动态适配**：视觉风格必须完全服务于故事。可选国风写意、现代极简、蒸汽朋克、赛博朋克或电影感实拍风格。\n- **自洽性**：全片所有图片的色调、光影和元素必须统一，严禁跨时空混搭（除非剧情要求）。\n- **文化锚点优先于美感**：当「好看」和「文化准确」冲突时，选文化准确。一张唐代故事里出现的日式庭院，再好看也是错误。\n\n---\n\n## 2. 常见文化与体裁锚点速查表\n\n| 文化/体裁设定 | 场景/建筑关键词 | 元素/服饰关键词 | 常见误导（必须排除） |\n|-------------|---------------|---------------|-------------------|\n| **现代商务 (Analytical)** | Modern glass office, boardroom, high-rise, minimalist workspace | Business suit, smart casual, laptop, abstract charts | 奇幻元素, 杂乱背景, 古代物品 |\n| **极简数据 (Analytical)** | Abstract data visualization, glowing nodes, dark background | Neon lines, geometric shapes, HUD elements | 具体人物, 复杂实景建筑 |\n| 唐宋中国 (Narrative)| Dougong brackets, grey tiles, wooden beams, moon gate | Round-collar robe, Hanfu, Mingguang armor | 鸟居, 和服, 榻榻米, 哥特尖拱 |\n| 明清中国 (Narrative)| Upturned eaves, red lacquer columns, courtyard houses | Changshan, Qipao, Mandarin collar | 和服, 韩服, 维多利亚裙 |\n| 日本和风 (Narrative)| Torii gate, tatami, shoji screens, engawa | Kimono, hakama, geta sandals | 斗拱, 汉服, 旗袍 |\n| 中世纪欧洲 (Narrative)| Gothic arches, stone castle, stained glass | Chainmail, surcoat, leather boots | 东方建筑, 丝绸长袍 |\n| 赛博朋克 (Narrative)| Neon signs, holographic ads, megastructures | LED-trimmed jacket, visor, cybernetic limbs | 古典建筑, 自然光 |\n\n---\n\n## 3. 图片提示词工程\n\n- **公式**：`[画幅指令] + [文化锚点] + [本幕内容] + [色调光影] + [质量后缀] + [排除清单]`\n- **质量后缀**：`hyper-realistic details, cinematic lighting, masterpiece, 8K`\n- **排除清单格式**：`No [culture A] elements, no [culture B] elements, no modern objects.`\n- **中文文字生成**（架构图/概念图专用）：`A [style] visualization with Chinese labels. Main node: \"核心词\". Sub-nodes: \"关联词1\", \"关联词2\". Professional design, glowing connections.`\n\n---\n\n## 4. 风格圣经模板示例\n\n### 4.1 古代中国唐代水墨风提示词\n```\nCinematic vertical shot, 9:16 aspect ratio. Ancient Chinese Tang Dynasty style.\nA young monk in grey round-collar robes holds a bronze oil lamp in a temple courtyard\nwith Dougong bracket architecture and grey tile roofing.\nInk-wash atmosphere, warm golden lamplight against dark shadows, subtle rice-paper texture.\nhyper-realistic details, cinematic lighting, 8K.\nNo Japanese elements, no Western elements, no modern objects.\n```\n\nFile v1.0.0:resources/template/script-template.md\n\n# FableForge — Storyboard Script Template\n\n## Project Info\n\n- **Topic**: (Management / leadership concept, e.g.: Zero-sum game, Principal-Agent problem)\n- **Target Duration**: 60 seconds\n- **Scene Count**: (Fill in, recommended 8–12)\n- **Narration Tone**: (Calm storytelling / Dramatic tension / Warm reflection)\n\n---\n\n## Allegory Story\n\n(Paste the full allegory story here for narration reference)\n\n---\n\n## Scene-by-Scene Storyboard\n\n> **Spec Constraints:**\n> - Narration per scene: 30–60 words\n> - Scene duration: 5–8 seconds (finalized from audio measurement)\n> - Image naming: `scene{N}.png` — strictly 1:1 with scene number\n> - Emotional gear must be tagged for each scene\n\n---\n\n### Scene 1 — [Scene Name]\n\n- **Time (draft estimate)**: 0 ~ 6 seconds\n- **Emotional Gear**: 1 (Slow Narration — opening, world-building)\n- **Narration**: (30–60 word narration text)\n- **Visual Description**: (English image generation prompt — include style, subject, lighting, mood)\n- **Voice Pacing Note**: (Any `…` pause markers needed?)\n\n---\n\n### Scene 2 — [Scene Name]\n\n- **Time (draft estimate)**: 6 ~ 12 seconds\n- **Emotional Gear**: 1\n- **Narration**: (Narration text)\n- **Visual Description**: (Image prompt)\n- **Voice Pacing Note**:\n\n---\n\n### Scene 3 — [Scene Name]\n\n- **Time (draft estimate)**: 12 ~ 18 seconds\n- **Emotional Gear**: 2 (Building Tension — conflict starts)\n- **Narration**: (Narration text)\n- **Visual Description**: (Image prompt)\n- **Voice Pacing Note**:\n\n---\n\n### Scene 4 — [Scene Name]\n\n- **Time (draft estimate)**: 18 ~ 24 seconds\n- **Emotional Gear**: 2\n- **Narration**: (Narration text)\n- **Visual Description**: (Image prompt)\n- **Voice Pacing Note**:\n\n---\n\n### Scene 5 — [Scene Name]\n\n- **Time (draft estimate)**: 24 ~ 31 seconds\n- **Emotional Gear**: 2\n- **Narration**: (Narration text)\n- **Visual Description**: (Image prompt)\n- **Voice Pacing Note**:\n\n---\n\n### Scene 6 — [Scene Name]\n\n- **Time (draft estimate)**: 31 ~ 38 seconds\n- **Emotional Gear**: 3 (Peak Intensity — key turning point)\n- **Narration**: (Narration text — should be shorter)\n- **Visual Description**: (Image prompt)\n- **Voice Pacing Note**:\n\n---\n\n### Scene 7 — [Scene Name]\n\n- **Time (draft estimate)**: 38 ~ 44 seconds\n- **Emotional Gear**: 3\n- **Narration**: (Narration text)\n- **Visual Description**: (Image prompt)\n- **Voice Pacing Note**:\n\n---\n\n### Scene 8 — [Scene Name]\n\n- **Time (draft estimate)**: 44 ~ 50 seconds\n- **Emotional Gear**: 4 (Silence & Space — pause before conclusion)\n- **Narration**: (≤ 15 words — let the weight sink in)\n- **Visual Description**: (Image prompt)\n- **Voice Pacing Note**: Add `…` between every phrase\n\n---\n\n### Scene 9 — [Scene Name]\n\n- **Time (draft estimate)**: 50 ~ 56 seconds\n- **Emotional Gear**: 4 → 1 (Resolution landing)\n- **Narration**: (≤ 20 words — fewest words, biggest insight)\n- **Visual Description**: (Image prompt)\n- **Voice Pacing Note**:\n\n---\n\n(Copy the format above to add more scenes if needed)\n\n---\n\n## Full Narration (Combined)\n\n(Concatenate all scene narrations in order — paste directly into `generate.py` as `TARGET_TEXT`)\n\n```\nScene 1: [narration]\n\n||| Scene 2: [narration]\n\n||| ...\n```\n\n---\n\n## Publishing Metadata\n\n### Title Options\n1. (Option 1)\n2. (Option 2)\n3. (Option 3)\n\n### Cover Tagline\n(One punchy line, ≤ 15 words)\n\n### Tags / Topics\n(Keywords for social platforms, e.g.: leadership, management, fable, AI-video)\n\nFile v1.0.0:resources/template/视频脚本.md\n\n# 视频脚本模板\n\n## 基本信息\n\n- **主题**：（填写管理学/领导力概念，例：零和博弈、委托代理问题）\n- **视频时长目标**：60 秒\n- **分镜数量**：（填写幕数，建议 8～12）\n- **配音风格**：（沉稳叙事 / 紧张戏剧 / 温和启发）\n\n---\n\n## 寓言故事\n\n（在此处填写完整的寓言故事，供旁白参考）\n\n---\n\n## 分镜头剧本\n\n> 规格约束：\n> - 每幕旁白 30～60 字\n> - 每幕时长 5～8 秒（以音频实测为准）\n> - 图片命名：`scene{N}.png`，与幕序号严格一一对应\n\n---\n\n### 分镜 1 — 【幕名】\n\n- **时间（草稿估算）**：第 0 ～ 6 秒\n- **旁白**：（30～60字的旁白文本）\n- **画面描述**：（英文 AI 绘图提示词，需包含画风、主体、光影、氛围）\n\n---\n\n### 分镜 2 — 【幕名】\n\n- **时间（草稿估算）**：第 6 ～ 12 秒\n- **旁白**：（旁白文本）\n- **画面描述**：（提示词）\n\n---\n\n### 分镜 3 — 【幕名】\n\n- **时间（草稿估算）**：第 12 ～ 18 秒\n- **旁白**：（旁白文本）\n- **画面描述**：（提示词）\n\n---\n\n（复制上方格式，按需添加至 scene{N}）\n\n---\n\n## 完整旁白合并文本\n\n（将以上所有分镜旁白按顺序合并，直接用于 TTS 生成）\n\n---\n\n## 标题建议（用于发布）\n\n1. （标题方案 1）\n2. （标题方案 2）\n3. （标题方案 3）\n\n## 推荐封面文案\n\n（一句话点睛，20 字以内）","readmeExcerpt":"Skill: Fableforge Owner: lucas-kay8 Summary: FableForge 通用视频生成流水线 SOP。支持两种生产模式（图片流、视频 B-roll 流）和三种体裁（叙事寓言、商业分析、产品宣发）。包含从概念生成、剧本创作、TTS 配音、素材采集、到 HyperFrames 视频渲染的完整工业化 SOP，以及视觉风格指南与技术陷阱手册。v1.2.0 新增 VAD 物... Tags: latest:1.2.0 Version history: v1.2.0 | 2026-05-22T03:04:08.772Z | user v1.2.0: 引入VAD声学平铺匹配、语速自动健康度审计门禁、大分镜GSAP变量解耦与生命周期控制 v1.1.0 | 2026-05-20T11:21:51.456Z | user FableForge 技能升级至 v1.1.0，新增全局禁令、素材新鲜度校验、渲染前集成检","codeSnippets":[],"executableExamples":[{"language":"text","snippet":"旁白总字数 = 原始故事中【不可删减要素】的合计字数（见 0.3）\n预估时长(秒) = 旁白总字数 ÷ 3.5（中文语速）\n根据预估时长选择对应档位"},{"language":"text","snippet":"/YYYYMMDD/\n ├── index.html (核心时间轴，Stage 3/4 产物)\n ├── assets/\n │ ├── scene_cover.png (封面图，纯文字海报)\n │ ├── scene1.png ~ sceneN.png\n │ ├── scene_end.png (结尾图，纯文字海报)\n │ ├── narration.wav (TTS 配音)\n │ ├── bgm.mp3 (背景配乐，Stage 1.7 产物)\n │ └── transcript.json (Whisper 时间戳，Stage 2.2 产物)\n ├── 视频脚本.md (剧本，Stage 1.2 产物)\n └── promo_video.mp4 (最终成品，Stage 4.3 产物，Git 豁免名单)"},{"language":"text","snippet":"/YYYYMMDD_{project_name}/\n ├── index.html (核心时间轴，竖屏 1080×1920)\n ├── style.css (独立样式表，文字叠加组件库)\n ├── download_and_process.py (B-roll 自动化下载/裁剪脚本)\n ├── assets/\n │ ├── scene1.mp4 ~ sceneN.mp4 (裁剪后的 B-roll 视频，1080×1920，无音轨)\n │ ├── narration.wav (TTS 配音)\n │ └── bgm.mp3 (背景音乐)\n ├── 视频脚本.md (剧本 + B-roll 素材规划表)\n └── renders/\n └── {project}_YYYY-MM-DD_HH-MM-SS.mp4 (渲染成品)"},{"language":"text","snippet":"大家好，我在录制自己的声音样本。这段录音将作为我的声纹模板，\n帮助 AI 精确还原我的音色和情感。现在是[你的名字]，感谢收听。"},{"language":"bash","snippet":"# 安装 Audacity\nbrew install --cask audacity"},{"language":"text","snippet":"voice-model/01_samples/my_voice.wav"}],"parameters":null,"dependencies":[],"permissions":[],"extractedFiles":[{"path":"SKILL.md","content":"---\nname: ai-video-studio\nversion: 1.2.0\ndescription: FableForge 通用视频生成流水线 SOP。支持两种生产模式（图片流、视频 B-roll 流）和三种体裁（叙事寓言、商业分析、产品宣发）。包含从概念生成、剧本创作、TTS 配音、素材采集、到 HyperFrames 视频渲染的完整工业化 SOP，以及视觉风格指南与技术陷阱手册。v1.2.0 新增 VAD 物理声学平铺匹配、语速自动健康度审计（防脱节门禁）、大分镜 GSAP 变量解耦与生命周期显隐控制。\n---\n\n# 🔨 FableForge · 视频生成工业流水线 AI Agent SOP\n\n本 Skill 是一份**命令级可执行 SOP**，而非经验教训集。每个 Stage 均包含**具体执行命令**和**退出验收标准**，严禁跳步或在退出标准未满足时进入下一阶段。\n\n### ⛔ 全局禁令（违反任意一条即判定为生产事故）\n\n1. **严禁复用旧集素材**：每一集的 `assets/` 目录下的所有文件（视频、音频、图片、BGM）必须为本次任务全新生成或下载。严禁从其他 `episodes/` 目录复制任何媒体文件。唯一例外是 `narration.wav`（由 TTS 脚本生成）和模板代码结构（非媒体文件）。\n2. **严禁跳过退出标准**：每个 Stage 的退出标准中的所有检查项必须逐一验证并标记为通过，才能进入下一个 Stage。\n3. **严禁无字幕渲染**：无论模式 A 还是模式 B，最终视频必须包含与配音同步的逐字滚动字幕。\n4. **严禁无封面/封底渲染**：所有视频必须包含封面标题幕（`#scene_cover`）和封底互动幕（`#scene_end`）。\n5. **严禁复用旧集 BGM**：每集的背景音乐必须根据本集剧本的情绪主题全新搜索并下载，不得复用历史集的 `bgm.mp3`。\n\n---\n\n## 0. 视频规格与体裁定义（内容优先定档制）\n\n**核心原则：内容的可理解性永远优先于时长限制。**\n\n视频时长不是预设的固定值，而是由内容倒推得出的。错误的做法是「先定 60 秒，然后把内容往里塞」；正确的做法是「先确认内容讲完需要多少字，再据此选档」。\n\n### 0.0 视频体裁系统 (Genre)\n\n本流水线支持三种核心体裁。在构思内容前，**必须首先确定体裁**：\n\n| 体裁 (Genre) | 特征与核心要求 | 适用场景 | 常用视觉模式 |\n|-------------|-----------|---------|---------|\n| **Genre X: 叙事/隐喻 (Narrative)** | 有角色、有冲突。旁白重感受轻动作，追求悬念与结局升华。 | 寓言故事、历史重现、管理隐喻 | + 模式 A (图片) |\n| **Genre Y: 分析/科普 (Analytical)** | 论点驱动、逻辑递进。追求清晰的结构拆解和痛点直击。 | 商业分析、职场洞察、技术科普 | + 模式 B (B-roll) |\n| **Genre Z: 宣发/展示 (Promotional)**| 产品中心、利益点明确。强节奏感与转化引导 (CTA)。 | 产品宣发、网站转视频、功能展示 | 混合模式 |\n\n### 0.1 三档体系\n\n| 档位 | 适用场景 | 旁白总字数 | 预估时长 | 分镜数 |\n|------|---------|-----------|---------|-------|\n| S · 短片 | 单一概念解释、痛点直击、高密度短平快 | 150～450 字 | 45～120 秒 | 1+5~12+1 |\n| M · 标准 | 完整叙事、多维度拆解、深度论证 | 450～900 字 | 120～270 秒 | 1+12~20+1 |\n| L · 长篇 | 复杂案例剖析、连续剧集 | 900～1500 字 | 270～420 秒 | 1+20~30+1 |\n\n> 超过 1500 字的内容必须拆成上下集（每集独立成片，各自包含封面和结尾）。\n\n### 0.2 定档公式\n\n```\n旁白总字数 = 原始故事中【不可删减要素】的合计字数（见 0.3）\n预估时长(秒) = 旁白总字数 ÷ 3.5（中文语速）\n根据预估时长选择对应档位\n```\n\n### 0.3 不可删减要素（内容完整性红线）\n\n不同体裁有不同的不可删减要素。如果被删除，观众将无法理解视频的核心价值。**剧本转化阶段（Stage 1.2）严禁删除这些要素：**\n\n| 体裁 (Genre) | 核心不可删减要素 | 删除后果 |\n|-------------|----------------|----------|\n| **Narrative (叙事类)** | 因果链、角色动机、关键对话、认知翻转事件、结局因果闭环 | 观众不知道“为什么”，悬念消失，结论像硬塞的 |\n| **Analytical (分析类)**| 痛点现象描述、核心矛盾拆解、数据对比/逻辑支撑、金句结论 | 视频变成空洞的说教，缺乏说服力 |\n| **Promotional(宣发类)**| 目标受众痛点、核心利益点 (Benefit)、差异化价值、明确的 CTA | 看完后不知道自己能得到什么，无法转化 |\n\n**可以精简的要素：**\n- 重复的环境描写或冗长的数据罗列（保留首次，后续可省略）\n- 纯装饰性的形容词堆叠\n- 不影响主线的次要信息\n- 已被画面传达的信息（如「山很高」——画面已经表达了）\n\n### 0.4 通用规格（所有档位共享）\n\n| 规格项 | 标准值 | 说明 |\n|--------|--------|------|\n| 每幕旁白字数 | 中文 30～80 字 / 英文 20～50 词 | 中文约 3.5 字/秒，英文约 2.5 词/秒 |\n| 每幕预估时长 | 5 ～ 15 秒 | 最终以音频实测为准 |\n| 分镜编号格式 | `scene_cover`, `scene1`~`scene{N}`, `scene_end` | 与 `assets/` 下的图片名严格一一对应 |\n| 旁白与分镜对应 | 1 幕 == 1 张图 == 1 段旁白 | 封面通常对应标题旁白，结尾对应金句旁白 |\n\n---\n\n## 0.5 质量门禁（三重内容验收）\n\n视频质量的上限由三个核心因素决定。**每一重门禁未通过，不得进入下一阶段。**\n\n### 门禁一：概念与大纲验收（概念生成后、停机确认前执行）\n\nAI 容易生成\"结构正确但洞察平庸\"的内容。在向用户展示前，必须根据体裁完成自检：\n\n**强制自检（全部通过方可提交用户确认）：**\n- [ ] **反常识测试 (通用)**：这个洞察/角度是\"大家都知道\"还是\"大家都经历但从没被命名\"的？前者没传播价值，重写。\n- [ ] **Genre X (叙事) 专属**：结局是否让人感到轻微不适或醍醐灌顶？隐喻是否太直白（能在前10秒猜到结局）？\n- [ ] **Genre Y (分析) 专属**：逻辑链条是否严密？是否提出了具有实操性的认知升华？\n- [ ] **"},{"path":"resources/voice-model/README.md","content":"# 声音样本录制指南\n\n## 为什么需要录制声音样本？\n\n本项目使用 **VoxCPM2** 声纹克隆模型。它的工作原理是：\n1. 你提供一段 **15 秒**的自己的声音\n2. 模型学习你的**音色、语调、情感特征**\n3. 之后，模型就能用**你的声音**朗读任何文字\n\n效果就像你亲自配音，但实际上是 AI 在模拟你。\n\n---\n\n## 录音要求\n\n| 项目 | 标准 |\n|------|------|\n| 时长 | **15 秒**（过短效果差，过长会截断） |\n| 格式 | WAV（不要 MP3，会丢失音质） |\n| 采样率 | 44100 Hz 或以上 |\n| 语速 | 正常语速，不要刻意放慢 |\n| 内容 | 朗读下方指定文本（必须与 `PROMPT_TEXT` 一致） |\n\n---\n\n## 推荐朗读文本\n\n将下方文字复制到 `generate.py` 的 `PROMPT_TEXT` 参数，并**朗读同样的内容**：\n\n```\n大家好，我在录制自己的声音样本。这段录音将作为我的声纹模板，\n帮助 AI 精确还原我的音色和情感。现在是[你的名字]，感谢收听。\n```\n\n你也可以自定义这段文字，但要确保录音内容和 `PROMPT_TEXT` **完全一致**。\n\n---\n\n## 录音步骤（Mac）\n\n### 方法 A：使用 QuickTime（最简单）\n\n1. 打开 QuickTime Player\n2. 菜单栏 → 文件 → 新建音频录制\n3. 点击录制按钮，朗读文本，停止\n4. 导出 → 音频 → 保存为 WAV\n\n### 方法 B：使用 Audacity（质量更好）\n\n```bash\n# 安装 Audacity\nbrew install --cask audacity\n```\n\n1. 选择麦克风（推荐有线耳机）\n2. 点击录制，朗读文本\n3. 导出为 WAV，采样率 44100\n\n---\n\n## 保存路径\n\n录音完成后，将文件保存为：\n```\nvoice-model/01_samples/my_voice.wav\n```\n\n> ⚠️ **隐私提示**：此文件包含你的声纹信息，`.gitignore` 已自动排除 `01_samples/` 目录，不会被提交到 GitHub。\n\n---\n\n## 录音质量检验\n\n一个好的声音样本应该：\n- [ ] 没有明显的背景噪音（空调声、键盘声等）\n- [ ] 没有爆音（P、B 音爆声）\n- [ ] 没有回声（不要在浴室或空旷房间录制）\n- [ ] 语速自然，情感投入（不要像机器人一样朗读）\n\n---\n\n下一步：参考 [README.md 阶段一第 4 步](../README.md#阶段一录制你的声音首次必做一劳永逸) 运行 `generate.py` 测试效果。"},{"path":"_meta.json","content":"{\n \"ownerId\": \"kn70kae1g9r73x5v5vn83saj7h86yevd\",\n \"slug\": \"fableforge\",\n \"version\": \"1.2.0\",\n \"publishedAt\": 1779419048772\n}"},{"path":"resources/stages/stage_0_env.md","content":"# Stage 0: 自动化环境部署 (Scaffolding)\n\n当用户在一个空文件夹中首次要求“初始化项目”或“初始化 FableForge”时，**必须且仅需执行一次**本阶段。如果你发现当前目录已经有了 `template/` 和 `bin/`，则说明已初始化过，请直接跳过。\n\n**0.1 复制模板与模型资源**\nFableForge 的项目模板与语音模型代码已打包在 Skill 目录中。请执行以下命令：\n\n```bash\n# 复制 HTML 模板与脚本模板\ncp -r .agents/skills/fableforge/resources/template ./template\n\n# 复制语音模型脚手架\ncp -r .agents/skills/fableforge/resources/voice-model ./voice-model\n```\n\n**0.2 自动下载 FFmpeg 环境**\n本流水线强烈依赖 `ffmpeg` 与 `ffprobe`。请自动为用户下载静态构建版：\n\n```bash\ncurl -L https://evermeet.cx/ffmpeg/get/zip -o ffmpeg.zip && unzip -o ffmpeg.zip\ncurl -L https://evermeet.cx/ffmpeg/get/ffprobe/zip -o ffprobe.zip && unzip -o ffprobe.zip\nmkdir -p bin && mv ffmpeg bin/ && mv ffprobe bin/ && chmod +x bin/*\nrm ffmpeg.zip ffprobe.zip\n```\n\n**0.3 自动配置 VoxCPM2 Python 环境**\n执行以下命令为用户的语音克隆模型创建隔离环境并安装依赖：\n\n```bash\npython3 -m venv voice-model/venv\nsource voice-model/venv/bin/activate\npip install voxcpm soundfile torch numpy\n```\n\n**0.4 引导用户录制声纹样本**\n执行完毕后，请暂停并提示用户：\n> \"FableForge 环境已初始化完毕！请您用手机或电脑录制一段 15 秒的声音（朗读任意文本），将其导出为 `.wav` 格式，并放置在 `voice-model/01_samples/my_voice.wav`。准备好后请告诉我，我们就可以开始做视频了！\"\n\n**✅ Stage 0 退出标准：**\n- [ ] 当前工作区包含 `template/`、`voice-model/` 和 `bin/` 目录。\n- [ ] 用户确认已准备好声纹样本。"},{"path":"resources/stages/stage_1_creatives.md","content":"# Stage 1：概念、剧本与物料生成\n\n### 1.1 概念与大纲生成（须停机等待用户确认）\n\n根据确定的体裁 (Genre)，使用对应的提示词框架生成内容大纲：\n\n**对于 Genre X (叙事类)：**\n> \"请你从[指定领域]里，选择一个深度的概念。然后写一个寓言/历史故事，用间接的方式把这个概念讲清楚。不要一开始就说答案，到故事快结束时反转。最后解释概念及隐喻。\"\n\n**对于 Genre Y (分析类)：**\n> \"请你从[指定领域]里，挖掘一个反直觉的痛点现象。先描绘这个现象，然后拆解背后的核心矛盾/系统性崩溃原因，最后给出具有实操性的商业洞察或管理金句。\"\n\n**对于 Genre Z (宣发类)：**\n> \"请根据[产品/功能描述]，提取最核心的用户痛点和利益点，以短视频节奏输出一段极具转化率的宣发文案框架（痛点直击 -> 价值展示 -> CTA）。\"\n\n**去重检查**：生成前扫描工作空间内所有 `YYYYMMDD/视频脚本.md`，确保主题不与历史作品重复。\n\n⛔ **此步完成后必须停机，将生成的大纲/故事完整展示给用户，等待明确确认。未经确认严禁继续。**\n\n### 1.2 内容定档（用户确认大纲后立即执行）\n\n在动手写剧本之前，必须先完成内容定档。这是防止「好内容变烂视频」的关键步骤。\n\n**步骤：**\n\n1. **标记不可删减要素**：逐段扫描用户确认的内容大纲，用以下标签标记（见 0.3）：\n - `[因果/逻辑]` — 逻辑链节点\n - `[转折/对比]` — 认知翻转或数据对比\n - `[核心金句]` — 结论闭环\n\n2. **计算最低旁白字数**：将所有标记要素的文本合适，得出「不可压缩下限」。\n\n3. **选档**：根据合计字数，在 §0.1 三档体系中选择对应档位。\n\n4. **输出定档报告**（写入 `视频脚本.md` 头部）：\n ```markdown\n ## 内容定档\n - **原始内容字数**：{X} 字\n - **不可删减要素字数**：{Y} 字\n - **选定档位**：{S/M/L}\n - **预估旁白总字数**：{Z} 字\n - **预估视频时长**：{Z ÷ 3.5} 秒\n ```\n\n⛔ **如果不可删减要素字数 > 450（S 档上限），严禁使用 S 档强行压缩。必须升档。**\n\n### 1.3 剧本转化\n\n将内容按选定档位的规格拆解为分镜剧本，写入 `YYYYMMDD/视频脚本.md`。\n\n**内容完整性自检（剧本写完后必须执行，全部通过才能进入下一步）：**\n\n- [ ] **盲测**：让一个没读过原文的人只看剧本旁白，能否独立理解核心价值（故事结局/分析结论）？如果不能，说明删多了。\n- [ ] **因果/逻辑链完整**：每个「结论」都有对应的「事件/数据」作为铺垫，没有凭空冒出的道理。\n- [ ] **Genre X 专属**：角色有动作有对话，不能只靠旁白概括。\n- [ ] **Genre Y 专属**：痛点现象的铺垫是否足以推导出最终的解决方案和金句？\n\n剧本格式模板：\n```markdown\n## 分镜 scene_cover — 封面/标题幕\n- **情绪档位**：1\n- **旁白**：{通常为视频标题或引导句}\n- **画面描述**：{高吸引力、悬念感强的提示词}\n\n## 分镜 {N} — {幕名}\n- **时间（草稿估算）**：第 {X} ～ {Y} 秒\n- **情绪档位**：{1/2/3/4}\n- **旁白**：{中文30~80字}\n- **画面描述**：{图片提示词，中英文均可}\n\n## 分镜 scene_end — 结尾/升华幕\n- **情绪档位**：4\n- **旁白**：{点题金句，不超过 20 字}\n- **画面描述**：{意境深远、呼应主题的提示词}\n```\n\n### 1.4 TTS 语音生成\n\n**声纹选择（优先意识）：**\n- **默认原则**：优先检查 `/语音模型/voxenv` 环境。若存在，**必须**使用用户的声纹克隆生成旁白。\n- **降级方案**：仅在用户明确要求或克隆环境不可用时，才使用 Kokoro 等通用模型。\n\n**语音节奏优化：**\n\nVoxCPM2 的情绪输出相对平稳，需要在文本层面手动注入戏剧感。处理规则：\n\n- 在核心关键词前插入 `……`，让模型自动降速放重音\n- 超过 130 字的段落用 `|||` 在语气转折处手动分段\n- 档位 4（沉默留白幕）的旁白每个词组之间都加 `……`\n\n```\n❌ 平铺直叙：\n\"你以为选出了战将，其实你只选出了最擅长残杀队友的屠夫。\"\n\n✅ 有停顿感的版本：\n\"你以为……选出了战将。|||其实，你只筛选出了——最擅长残杀队友的……屠夫。\"\n```\n\n在项目目录下执行：\n\n```bash\n# 使用本地 VoxCPM2 模型生成语音（必须使用虚拟环境的 Python）\n# 1. 复制并编辑生成脚本（每个项目独立一份）\ncp /Users/lucas/Work/09.Antigravity/语音模型/generate_cantillon.py \\\n /Users/lucas/Work/09.Antigravity/语音模型/generate_{project_name}.py\n# 2. 编辑 TARGET_TEXT、OUTPUT_FILE 等变量\n# 3. 运行\n/Users/lucas/Work/09.Antigravity/语音模型/voxenv/bin/python3 \\\n /Users/lucas/Work/09.Antigravity/语音模型/generate_{project_name}.py\n```\n\n### 1.5A 图片素材生成（模式 A）\n\n> ℹ️ 仅模式 A（纯图片）执行此步。模式 B 跳转至 §1.5B。\n\n按剧本中每幕的\"画面描述\"逐一生成图片，命名严格遵循 `scene1.png`、`scene2.png` ... `scene{N}.png`，保存至 `YYYYMMDD/assets/`。\n\n**批量生成策略（应对 API 配额限流）：**\n\n图片生成 API 通常有速率限制（如每窗口期 5 张）。为避免流程阻塞，采用以下策略：\n\n1. **先批量准备提示词**：在生成前，将全部场景的提示词按风格圣经公式组装完毕，写入剧本。\n2. **分批生成 + 穿插其他工作**：每批生成到限流后，立即切换到其他 Stage 的工作（如音频分析、HTML 搭建），不要干等。\n3. **生成即归档**：每张图生成后立即 `cp` 到 `assets/` 目录并验证文件名，避免最后批量操作时遗漏。\n4. **断点续传**：用 `ls assets/scene*.png | wc -l` 检查进度，只生成缺失的图片。\n\n### 1.5B 视频 B-roll 素材采集与裁剪（模式 B）\n\n> ℹ️ 仅模式 B（视频 + 文字叠加）执行此步。模式 A 跳转至 §1.5A。\n\n**步骤 1 — B-roll 关键词策划：**\n\n根据每幕的情绪和主题，在 `视频脚本.md` 中列出搜"}],"languages":[],"docsSourceLabel":"CLAWHUB","editorialOverview":"FableForge 通用视频生成流水线 SOP。支持两种生产模式（图片流、视频 B-roll 流）和三种体裁（叙事寓言、商业分析、产品宣发）。包含从概念生成、剧本创作、TTS 配音、素材采集、到 HyperFrames 视频渲染的完整工业化 SOP，以及视觉风格指南与技术陷阱手册。v1.2.0 新增 VAD 物... Skill: Fableforge Owner: lucas-kay8 Summary: FableForge 通用视频生成流水线 SOP。支持两种生产模式（图片流、视频 B-roll 流）和三种体裁（叙事寓言、商业分析、产品宣发）。包含从概念生成、剧本创作、TTS 配音、素材采集、到 HyperFrames 视频渲染的完整工业化 SOP，以及视觉风格指南与技术陷阱手册。v1.2.0 新增 VAD 物... Tags: latest:1.2.0 Version history: v1.2.0 | 2026-05-22T03:04:08.772Z | user v1.2.0: 引入VAD声学平铺匹配、语速自动健康度审计门禁、大分镜GSAP变量解耦与生命周期控制 v1.1.0 | 2026-05-20T11:21:51.456Z | user FableForge 技能升级至 v1.1.0，新增全局禁令、素材新鲜度校验、渲染前集成检","editorialQuality":{"score":100,"threshold":65,"status":"ready","wordCount":554,"uniquenessScore":61,"reasons":[]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-10-11T14:32:52.266Z","emptyReason":"No screenshots, media assets, or demo links are available."},"primaryImageUrl":null,"mediaAssetCount":0,"assets":[],"demoUrl":null},"ownerResources":{"evidence":{"source":"unclaimed","verified":false,"confidence":"low","updatedAt":"2026-10-11T14:32:52.266Z","emptyReason":"This page has not been claimed by the agent owner."},"hasCustomPage":false,"customPageUpdatedAt":null,"customLinks":[],"structuredLinks":{"docsUrl":null,"demoUrl":null,"supportUrl":null,"pricingUrl":null,"statusUrl":null},"customPage":null},"relatedAgents":{"evidence":{"source":"protocol-neighbors","verified":false,"confidence":"medium","updatedAt":"2026-10-11T17:43:37.944Z","emptyReason":null},"items":[{"id":"8ebccd8e-3863-4187-8355-c3f14e1f9edf","entityType":"agent","canonicalPath":"/agent/iofficeai-aionui","slug":"iofficeai-aionui","name":"AionUi","description":"Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!","url":"https://github.com/iOfficeAI/AionUi","homepage":"https://www.aionui.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-10-09T19:11:12.944Z","createdAt":"2026-02-25T03:38:16.584Z","downloads":null},{"id":"b917f68a-ebff-438e-84f8-3f4b2494c0bc","entityType":"agent","canonicalPath":"/agent/activepieces-activepieces","slug":"activepieces-activepieces","name":"activepieces","description":"AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents","url":"https://github.com/activepieces/activepieces","homepage":"https://www.activepieces.com","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-15T02:22:12.426Z","createdAt":"2026-02-25T03:38:12.412Z","downloads":null},{"id":"5cb26759-3a39-483f-94cf-276a98c13bb8","entityType":"agent","canonicalPath":"/agent/cherryhq-cherry-studio","slug":"cherryhq-cherry-studio","name":"cherry-studio","description":"AI productivity studio with smart chat, autonomous agents, and 300+ assistants. Unified access to frontier LLMs","url":"https://github.com/CherryHQ/cherry-studio","homepage":"https://cherry-ai.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-11T14:38:40.986Z","createdAt":"2026-02-25T03:38:19.379Z","downloads":null},{"id":"6f6582d0-5d76-4f0f-b81d-86520247950b","entityType":"agent","canonicalPath":"/agent/copilotkit-copilotkit","slug":"copilotkit-copilotkit","name":"CopilotKit","description":"The Frontend for Agents & Generative UI. React + Angular","url":"https://github.com/CopilotKit/CopilotKit","homepage":"https://docs.copilotkit.ai","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-03-25T09:50:57.846Z","createdAt":"2026-02-25T03:39:14.617Z","downloads":null}],"links":{"hub":"/agent","source":"/agent/source/clawhub","protocols":[{"label":"OpenClaw","href":"/agent/protocol/openclew"}]}}}