{"slug":"video-recap","title":"\u89c6\u9891\u89e3\u8bf4\u6210\u7247","description":"\u4ece\u89c6\u9891\u751f\u6210\u4e2d\u6587\u89e3\u8bf4\u6210\u7247\u6216\u539f\u58f0\u5267\u60c5\u77ed\u7247\uff0c\u81ea\u52a8\u7406\u89e3\u7d20\u6750\u5e76\u5b8c\u6210\u89e3\u8bf4\u4e0e\u526a\u8f91\u3002","category":"\u526a\u8f91\u4e0e\u5305\u88c5","tags":["\u89c6\u9891","\u89e3\u8bf4","\u6210\u7247"],"author":"PiteChen","source_url":"https://github.com/zenstory-ai/video-recap-skills/blob/main/skills/video-recap/SKILL.md","license":"MIT","status":"published","verification":"source_reviewed","verification_notes":"\u6765\u6e90 zenstory-ai/video-recap-skills\uff08skills/video-recap/SKILL.md\uff09\uff0c\u672c\u5730\u6253\u5305\u4e0a\u4f20\uff1b\u672a\u6267\u884c\u5305\u5185\u811a\u672c\u3002","revision":"91b4384f15264b298d5723bfc39b9bb8","created_at":"2026-10-28T08:54:26+00:00","updated_at":"2026-10-28T08:54:50+00:00","source_repo":"","source_path":"","source_commit":"","source_updated_at":"","stars":0,"proxy_score":null,"score":null,"grade":null,"dimensions":{},"evaluation":{},"installs":0,"platforms":[],"formats":[],"category_slug":"packaging","category_name":"\u526a\u8f91\u4e0e\u5305\u88c5","usage_guide":{},"read_url":"https://shiliuai.cn/api/v2/skills/video-recap","skill_url":"https://shiliuai.cn/api/v2/skills/video-recap/files/SKILL.md","download_url":"https://shiliuai.cn/api/v2/skills/video-recap/download","install_url":"https://shiliuai.cn/api/v2/skills/video-recap/install","files":[{"path":"SKILL.md","bytes":17221,"url":"https://shiliuai.cn/api/v2/skills/video-recap/files/SKILL.md"},{"path":"assets/dashboard/app.js","bytes":17178,"url":"https://shiliuai.cn/api/v2/skills/video-recap/files/assets/dashboard/app.js"},{"path":"assets/dashboard/index.html","bytes":923,"url":"https://shiliuai.cn/api/v2/skills/video-recap/files/assets/dashboard/index.html"},{"path":"assets/dashboard/styles.css","bytes":33502,"url":"https://shiliuai.cn/api/v2/skills/video-recap/files/assets/dashboard/styles.css"},{"path":"assets/dashboard/tokens.css","bytes":9064,"url":"https://shiliuai.cn/api/v2/skills/video-recap/files/assets/dashboard/tokens.css"},{"path":"assets/dashboard/views.js","bytes":38959,"url":"https://shiliuai.cn/api/v2/skills/video-recap/files/assets/dashboard/views.js"},{"path":"references/audio-routing.md","bytes":7245,"url":"https://shiliuai.cn/api/v2/skills/video-recap/files/references/audio-routing.md"},{"path":"references/config-playbook.md","bytes":13079,"url":"https://shiliuai.cn/api/v2/skills/video-recap/files/references/config-playbook.md"},{"path":"references/data-schema.md","bytes":36172,"url":"https://shiliuai.cn/api/v2/skills/video-recap/files/references/data-schema.md"},{"path":"references/resource-library.md","bytes":10146,"url":"https://shiliuai.cn/api/v2/skills/video-recap/files/references/resource-library.md"},{"path":"scripts/dashboard/__init__.py","bytes":159,"url":"https://shiliuai.cn/api/v2/skills/video-recap/files/scripts/dashboard/__init__.py"},{"path":"scripts/dashboard/data.py","bytes":21024,"url":"https://shiliuai.cn/api/v2/skills/video-recap/files/scripts/dashboard/data.py"},{"path":"scripts/dashboard/io.py","bytes":7274,"url":"https://shiliuai.cn/api/v2/skills/video-recap/files/scripts/dashboard/io.py"},{"path":"scripts/dashboard/runs.py","bytes":15941,"url":"https://shiliuai.cn/api/v2/skills/video-recap/files/scripts/dashboard/runs.py"},{"path":"scripts/dashboard/templates.py","bytes":7443,"url":"https://shiliuai.cn/api/v2/skills/video-recap/files/scripts/dashboard/templates.py"},{"path":"scripts/dashboard_server.py","bytes":9570,"url":"https://shiliuai.cn/api/v2/skills/video-recap/files/scripts/dashboard_server.py"},{"path":"scripts/doctor.py","bytes":13727,"url":"https://shiliuai.cn/api/v2/skills/video-recap/files/scripts/doctor.py"},{"path":"scripts/final_qc.py","bytes":15918,"url":"https://shiliuai.cn/api/v2/skills/video-recap/files/scripts/final_qc.py"},{"path":"scripts/lib.py","bytes":10357,"url":"https://shiliuai.cn/api/v2/skills/video-recap/files/scripts/lib.py"},{"path":"scripts/library.py","bytes":27579,"url":"https://shiliuai.cn/api/v2/skills/video-recap/files/scripts/library.py"},{"path":"scripts/materials.py","bytes":14006,"url":"https://shiliuai.cn/api/v2/skills/video-recap/files/scripts/materials.py"},{"path":"scripts/recap.py","bytes":183,"url":"https://shiliuai.cn/api/v2/skills/video-recap/files/scripts/recap.py"},{"path":"scripts/recap_cli.py","bytes":9088,"url":"https://shiliuai.cn/api/v2/skills/video-recap/files/scripts/recap_cli.py"},{"path":"scripts/recap_inspect.py","bytes":18630,"url":"https://shiliuai.cn/api/v2/skills/video-recap/files/scripts/recap_inspect.py"},{"path":"scripts/recap_review.py","bytes":2894,"url":"https://shiliuai.cn/api/v2/skills/video-recap/files/scripts/recap_review.py"},{"path":"scripts/recap_runner.py","bytes":28906,"url":"https://shiliuai.cn/api/v2/skills/video-recap/files/scripts/recap_runner.py"},{"path":"scripts/recap_runtime.py","bytes":12639,"url":"https://shiliuai.cn/api/v2/skills/video-recap/files/scripts/recap_runtime.py"},{"path":"scripts/recap_source.py","bytes":9263,"url":"https://shiliuai.cn/api/v2/skills/video-recap/files/scripts/recap_source.py"},{"path":"scripts/recap_stage_qc.py","bytes":2828,"url":"https://shiliuai.cn/api/v2/skills/video-recap/files/scripts/recap_stage_qc.py"},{"path":"scripts/recap_timeline.py","bytes":29321,"url":"https://shiliuai.cn/api/v2/skills/video-recap/files/scripts/recap_timeline.py"},{"path":"scripts/resources/__init__.py","bytes":200,"url":"https://shiliuai.cn/api/v2/skills/video-recap/files/scripts/resources/__init__.py"},{"path":"scripts/resources/lock.py","bytes":7157,"url":"https://shiliuai.cn/api/v2/skills/video-recap/files/scripts/resources/lock.py"},{"path":"scripts/resources/project_binding.py","bytes":15347,"url":"https://shiliuai.cn/api/v2/skills/video-recap/files/scripts/resources/project_binding.py"}],"content":"---\nname: video-recap\ndescription: \u4ece\u8f93\u5165\u89c6\u9891\u751f\u6210\u4e2d\u6587\u89e3\u8bf4\u6210\u7247\u6216\u539f\u58f0\u5267\u60c5\u77ed\u7247\u3002\u7528\u6237\u63d0\u4f9b .mp4 / .mov / .mkv / .webm\uff0c\u5e76\u8981\u6c42\u526a\u8f91\u3001\u6dfb\u52a0\u65c1\u767d\u3001 \u914d\u97f3\u3001\u603b\u7ed3\u3001\u77ed\u5267/\u7535\u89c6\u5267/\u7535\u5f71/\u7eaa\u5f55\u7247/\u79d1\u666e\u89e3\u8bf4\u65f6\u4f7f\u7528\u3002\u8d1f\u8d23\u7f16\u6392 video-* \u6280\u80fd\u94fe\uff1a\u89c6\u9891\u7406\u89e3 \u2192 Agent \u5236\u5b9a\u6545\u4e8b\u4e0e\u89c6\u542c\u65b9\u6848 \u2192 \u526a\u8f91 \u2192 \u914d\u97f3 \u2192 \u5408\u6210\u3002\u89e6\u53d1\u8bcd\uff1a\u89c6\u9891\u89e3\u8bf4\u3001\u89c6\u9891\u65c1\u767d\u3001\u751f\u6210\u89e3\u8bf4\u3001 \u89c6\u9891 recap\u3001video recap\u3001voiceover\u3001narration\u3001auto-dub\u3001recap\u3002\n---\n\n## 1. \u5b9a\u4f4d\u4e0e\u6d41\u7a0b\n\n\u672c\u6280\u80fd\u662f\u4e94\u4e2a\u72ec\u7acb\u6280\u80fd\u7684\u8f7b\u91cf\u7f16\u6392\u5668\u3002\u5404\u6280\u80fd\u53ea\u901a\u8fc7 `work_dir` \u4e2d\u7684 JSON / MP4 \u4ea7\u7269\u901a\u4fe1\uff0c\u4e0d\u5171\u4eab\u4ee3\u7801\uff1a\n\n```text\nvideo-understanding \u2500\u25b6 Agent \u6309 video-script \u5236\u5b9a\u65b9\u6848\u5e76\u5199\u7a3f \u2500\u25b6 [video-cut] \u2500\u25b6 video-voiceover \u2500\u25b6 video-assemble\n```\n\n\u628a\u6210\u7247\u62c6\u6210\u5236\u4f5c\u53c2\u8003\u4e0d\u662f\u751f\u4ea7\u8def\u5f84\u3002\u7528\u6237\u8981\u6c42\u65f6\uff1a\u5bf9\u6210\u7247\u8dd1 video-understanding\uff08\u5efa\u8bae `ASR_SEGMENT_SECONDS=5`\uff09\uff0c\n\u518d\u7528 video-reference \u505a measure\u3001\u6807\u6ce8\u3001check\u3001export\uff0c\u628a\u5bfc\u51fa\u7684 `production_reference.json` \u590d\u5236\u8fdb\u4e0b\u4e00\u6b21\u8fd0\u884c\u7684\n`work_dir`\uff0c\u6216\u767b\u8bb0\u6210\u8d44\u6e90\u5e93\u7684 `production_reference` \u6a21\u677f\u3001\u91c7\u7eb3\u540e\u7ecf `--project` \u7ed1\u5b9a\u3002recap \u4e0d\u4f1a\u81ea\u52a8\u8fd0\u884c\u5b83\uff0c\u4e5f\u4e0d\u62ff\u65b0\u6210\u7247\u4e0e\u53c2\u8003\u505a\u6bd4\u5bf9\u3002\n\n\u6d41\u7a0b\u652f\u6301\u65ad\u70b9\u7eed\u8dd1\uff1a\u5199\u597d `narration.json` \u540e\u91cd\u590d\u540c\u4e00\u6761\u547d\u4ee4\u5373\u53ef\u7ee7\u7eed\u3002\u7b2c\u4e8c\u9636\u6bb5\u4f1a\u6bd4\u5bf9\n`recap_run_manifest.json` \u8bb0\u5f55\u7684\u6e90\u89c6\u9891\u8def\u5f84\u3001\u6587\u4ef6\u5927\u5c0f/\u4fee\u6539\u65f6\u95f4\u4e0e\u8fd0\u884c\u53c2\u6570\uff0c\u62d2\u7edd\u590d\u7528\u6765\u81ea\u5176\u4ed6\u6e90\u89c6\u9891\u6216\u5176\u4ed6\u53c2\u6570\u7684\u65e7\u5de5\u4f5c\u76ee\u5f55\uff1b\u89c6\u9891\u7406\u89e3\u4ea7\u7269\u4e5f\u53ea\u5728\u6765\u6e90\u4e00\u81f4\u65f6\u590d\u7528\u3002\n\u6682\u505c\u65f6\u6253\u5370\u7684\u7eed\u8dd1\u547d\u4ee4\u5c31\u662f\u539f\u547d\u4ee4\uff1a\u4fdd\u7559\u539f\u6765\u7684\u5199\u6cd5\uff0c\u89c6\u9891\u4e0e\u8def\u5f84\u53c2\u6570\u8f6c\u6210\u7edd\u5bf9\u8def\u5f84\uff0c\u8865\u4e0a `--work-dir` \u548c\u6765\u81ea\u73af\u5883\u53d8\u91cf\u7684\u8bbe\u7f6e\uff0c\u4ece\u4efb\u4f55\u76ee\u5f55\u90fd\u80fd\u76f4\u63a5\u8fd0\u884c\uff1b\u540c\u4e00\u4efd\u53c2\u6570\u5199\u5728 manifest \u7684 `argv`\u3002\n\n\u753b\u9762\u6d41\u7a0b `--edit-mode full|cut|dub` \u4e0e\u58f0\u97f3\u7b56\u7565 `--audio-mode` \u662f\u4e24\u4e2a\u72ec\u7acb\u5f00\u5173\uff1b\n`narration` \u4fdd\u7559\u4e0a\u8ff0\u89e3\u8bf4\u6d41\u7a0b\uff0c`source-mix` \u4e0d\u505a\u914d\u97f3\uff0c`adopted-packet-copy` \u51bb\u7ed3\u5f53\u524d\u8f93\u5165\u7684\u5df2\u91c7\u7528 AAC \u97f3\u8f68\u3002\n\u7ec4\u5408\u53ea\u6709\u4e0b\u9762\u51e0\u6761\u8def\u5f84\uff0c\u5176\u4f59\u7ec4\u5408\u5728\u542f\u52a8\u65f6\u76f4\u63a5\u62a5\u9519\uff1a\n\n| \u8f93\u5165 | `--edit-mode` | `--audio-mode` | Agent \u6682\u505c\u70b9 | \u6d41\u7a0b | \u8be6\u89c1 |\n|---|---|---|---|---|---|\n| \u5355\u89c6\u9891 | full | narration | 1\uff1a`narration.json` | \u7406\u89e3 \u2192 \u5199\u7a3f \u2192 \u6821\u9a8c \u2192 \u914d\u97f3 \u2192 \u5408\u6210 | \u00a74 |\n| \u5355\u89c6\u9891 | cut | narration | 2\uff1a`clip_plan.json`\uff0c\u518d\u5bf9\u7740\u6210\u7247\u5199 `narration.json` | \u7406\u89e3 \u2192 \u526a\u8f91 \u2192 \u91cd\u5efa\u8f93\u51fa\u65f6\u95f4 brief \u2192 \u5199\u7a3f \u2192 \u914d\u97f3 \u2192 \u5408\u6210 | \u00a74 |\n| \u591a\u89c6\u9891 | cut | narration | 2\uff1a\u540c\u4e0a\uff0cclip \u5fc5\u987b\u5e26 `source_id` | \u9010\u6e90\u7406\u89e3 \u2192 \u526a\u8f91 \u2192 \u5199\u7a3f \u2192 \u914d\u97f3 \u2192 \u5408\u6210 | \u00a74.3 |\n| \u5355\u89c6\u9891 | full | source-mix / adopted-packet-copy | \u65e0 | \u76f4\u63a5\u5408\u6210\u5f53\u524d\u6574\u6bb5 | \u00a74.7 |\n| \u5355 / \u591a\u89c6\u9891 | cut | source-mix / adopted-packet-copy | 1\uff1a`clip_plan.json` | \u7406\u89e3 \u2192 \u526a\u8f91 \u2192 \u5408\u6210\uff0c\u4e0d\u5199\u7a3f | \u00a74.7 |\n| \u5355\u89c6\u9891 | dub | narration | 1\uff1a`dub_script.json` | \u82f1\u6587\u8f6c\u5199 \u2192 \u8bd1\u7a3f \u2192 \u514b\u9686\u97f3\u8272\u6574\u8f68\u66ff\u6362 | \u00a75 |\n| \u5df2\u526a\u597d\u7684\u6bcd\u7248 | full | narration + \u4e09\u4e2a\u91c7\u7528 JSON | \u65e0 | \u53ea\u505a\u4e25\u683c\u5408\u6210 | \u4e0b\u6587 |\n\n\u6240\u6709 full/cut \u8def\u5f84\u5171\u7528\u540c\u4e00\u6bb5\u6536\u5c3e\uff1a\uff08\u6709\u65c1\u767d\u65f6\uff09\u8bc4\u5ba1 \u2192 TTS \u2192 \u5408\u6210 \u2192 \u6210\u7247 QC\u3002\u4f7f\u7528\u539f\u58f0\u6a21\u5f0f\u65f6\u8bfb\n`references/audio-routing.md`\u3002\n\n\u5df2\u6709\u9884\u5236\u753b\u9762\u548c\u672c\u5730\u91c7\u7528\u7684\u5b8c\u6574\u58f0\u97f3\u4e09\u4ef6\u5957\u65f6\uff0c\u53ef\u8d70\u4e25\u683c assembly-only \u8def\u5f84\uff1a\n\n```bash\npython3 scripts/recap.py picture.mp4 --edit-mode full --work-dir NEW_WORK \\\n  --output-dir DELIVERY \\\n  --tts-meta tts_meta.json \\\n  --narration-adoption narration_adoption.json \\\n  --audio-mix-adoption audio_mix_adoption.json\n```\n\n\u4e09\u4e2a JSON \u53c2\u6570\u5fc5\u987b\u540c\u65f6\u51fa\u73b0\u3002\u8be5\u5165\u53e3\u53ea\u63a5\u53d7\u5355\u89c6\u9891\u3001full\u3001narration\u3001\u97f3\u8f68 0\u3001\u65b0\u5de5\u4f5c\u76ee\u5f55\u548c\u672a\u5b58\u5728\u7684\n\u4ea4\u4ed8\u6587\u4ef6\uff1b\u4e0d\u8fd0\u884c\u7406\u89e3\u3001\u5199\u7a3f\u3001\u89e3\u8bf4\u8bc4\u5ba1\u3001TTS\u3001cut \u6216\u526a\u6620\u5bfc\u51fa\u3002\u8bed\u4e49\u4e0e\u5a92\u4f53\u5f62\u72b6\u4ecd\u7531\nvideo-assemble \u4e25\u683c\u9a8c\u8bc1\uff0crecap \u53ea\u6838\u5bf9\u5b50\u6280\u80fd\u7ed1\u5b9a\u8bb0\u5f55\u5f15\u7528\u7684\u662f\u540c\u4e00\u6279\u91c7\u7528\u6587\u4ef6\u4e0e\u6bcd\u7248\u8def\u5f84\uff0c\u4e0d\u628a\u8c03\u7528\u65b9\n\u91c7\u7528\u7684\u58f0\u97f3\u6216\u6df7\u97f3\u58f0\u660e\u6210\u81ea\u52a8\u521b\u4f5c\u6216\u53d1\u5e03\u6279\u51c6\u3002\u8be6\u89c1 `references/audio-routing.md`\u3002\n\n\u8fd9\u91cc\u7684\u5355\u89c6\u9891\u662f**\u5df2\u7ecf\u526a\u597d\u7684\u6bcd\u7248**\u3002\u91cd\u526a\u540e\u53ef\u4ee5\u590d\u7528\u672a\u6539\u52a8\u7684 WAV \u4e0e `tts_meta.json`\uff0c\u4f46\u5fc5\u987b\u6309\u65b0\u6bcd\u7248\n\u91cd\u65b0\u5199\u6df7\u97f3\u91c7\u7528\u6587\u4ef6\u91cc\u7684\u843d\u70b9\u4e0e\u51c6\u5907\u597d\u7684\u97f3\u5e8a\uff1b\u8854\u63a5\u6b65\u9aa4\u89c1 `references/audio-routing.md` \u7684 \u201cKeep adopted voice after a cut\u201d\u3002\n\n## 2. \u521b\u4f5c\u804c\u8d23\n\nAgent \u8d1f\u8d23\u672c\u6b21\u521b\u4f5c\u3002\u5148\u5224\u65ad\u672c\u8f6e\u7684**\u521b\u4f5c\u63a7\u5236\u6a21\u5f0f**\uff08CREATE / DIRECTED / REVISION\uff0c\u4e0e `--edit-mode` \u5206\u522b\u9009\u62e9\uff09\uff0c\u518d\u5728\u914d\u97f3\u548c\u6e32\u67d3\u524d\u5b8c\u6210\u4e94\u6b21\u5224\u65ad\uff1a\n\n1. **\u5bfc\u6f14\u5224\u65ad**\uff1a\u89c2\u4f17\u627f\u8bfa\u3001POV\u3001\u620f\u5267\u95ee\u9898\u3001\u60c5\u7eea\u7ec8\u70b9\u4e0e\u63ed\u793a\u8282\u594f\u3002\n2. **\u6545\u4e8b\u7f16\u8f91**\uff1abeat \u5b9a\u4e49\u4e3a\u201c\u53d1\u751f\u4e86\u4ec0\u4e48\u53d8\u5316\u201d\uff0c\u4e0d\u662f\u573a\u666f\u6458\u8981\u3002\n3. **\u753b\u9762\u526a\u8f91**\uff1a\u9009\u62e9\u771f\u6b63\u503c\u5f97\u4fdd\u7559\u7684\u5177\u4f53\u65f6\u523b\u3001\u53cd\u5e94\u3001\u5165\u70b9\u4e0e\u51fa\u70b9\u3002\n4. **\u58f0\u97f3/\u65c1\u767d**\uff1a\u5148\u5206\u914d\u753b\u9762\u3001\u539f\u58f0\u3001\u6c89\u9ed8\u548c\u65c1\u767d\u7684\u4efb\u52a1\uff0c\u518d\u5199\u89e3\u8bf4\u8bcd\u3002\n5. **\u89c2\u4f17\u590d\u6838**\uff1a\u5206\u522b\u68c0\u67e5\u65e0\u65c1\u767d\u3001\u53ea\u542c\u58f0\u97f3\u548c\u7b2c\u4e00\u6b21\u89c2\u770b\u7684\u4f53\u9a8c\u3002\n\n\u4e09\u79cd\u63a7\u5236\u6a21\u5f0f\u7684\u5b9a\u4e49\u3001REVISION \u7684\u4fee\u6539/\u51bb\u7ed3\u89c4\u5219\u3001\u521b\u4f5c\u65b9\u6cd5\u4ee5\u53ca `recap_story_plan.json` / `visual_audio_board.json` / `style_card.json` \u7684\u5199\u6cd5\uff0c\u5168\u90e8\u6309 `video-script` \u6267\u884c\uff1b\u5b83\u4f1a\u8981\u6c42\u5148\u8bfb\u521b\u4f5c\u624b\u518c\u3002\u8fd9\u4e9b\u6587\u4ef6\u53ea\u8bb0\u5f55\u53ef\u5ba1\u8ba1\u7684\u5f53\u524d\u51b3\u5b9a\uff0c\u4e0d\u589e\u52a0\u670d\u52a1\u6216\u6e32\u67d3\u4f9d\u8d56\u3002\n\n## 3. \u73af\u5883\u4e0e\u811a\u672c\u8def\u5f84\n\n```bash\n# ffmpeg: brew install ffmpeg | apt install ffmpeg | choco install ffmpeg\nexport MIMO_API_KEY=***\n```\n\n\u540c\u4e00\u4e2a MiMo key \u9a71\u52a8\uff1a\n\n- ASR\uff1a`mimo-v2.5-asr`\n- VLM\uff1a`mimo-v2.5`\n- TTS\uff1a`mimo-v2.5-tts`\n\nTTS \u4f9b\u5e94\u5546\u7531 `--tts-provider mimo-tts|fish-audio|index-tts`\uff08\u6216 `TTS_PROVIDER`\uff09\u900f\u4f20\u7ed9\u914d\u97f3\u6280\u80fd\uff1bFish Audio \u4e0e\u81ea\u6258\u7ba1 index-tts \u5404\u81ea\u7684\u73af\u5883\u53d8\u91cf\u3001\u9ed8\u8ba4\u97f3\u8272\u548c\u80fd\u529b\u9650\u5236\u89c1\u8be5\u6280\u80fd\u3002ASR/VLM \u59cb\u7ec8\u4f7f\u7528 MiMo\u3002`--doctor` \u53ea\u505a\u79bb\u7ebf\u914d\u7f6e\u68c0\u67e5\u3002\n\n`tp-*` Token Plan \u5bc6\u94a5\u9ed8\u8ba4\u4f7f\u7528\u4e2d\u56fd\u533a\u96c6\u7fa4\uff0c\u53ef\u7528 `MIMO_TOKEN_PLAN_CLUSTER` \u8986\u76d6\u3002\n\n\u53ef\u9009\u80fd\u529b\uff1a\n\n- `--mimo-video-overview`\uff1a\u6309\u573a\u666f\u5757\u8865\u5145 MiMo \u89c6\u9891\u7406\u89e3\u3002\n\n\u53ef\u8986\u76d6\u914d\u7f6e\u89c1 `references/config-playbook.md`\uff0c`final_qc.json` \u7684\u5b57\u6bb5\u89c1 `references/data-schema.md`\u3002\n\n\u4e0b\u9762\u7684 `scripts/...` \u5747\u76f8\u5bf9\u4e8e\u672c\u6280\u80fd\u76ee\u5f55\u3002\u82e5\u6267\u884c\u5668\u4ece\u4ed3\u5e93\u6839\u76ee\u5f55\u542f\u52a8\uff0c\u8bf7\u7ed9\u811a\u672c\u8def\u5f84\u52a0\u4e0a\u672c\u6280\u80fd\u7684\u7edd\u5bf9\u76ee\u5f55\u3002\u7f16\u6392\u811a\u672c\u4ece\u540c\u4e00\u6280\u80fd\u6839\u76ee\u5f55\u5b9a\u4f4d\u6240\u9700\u9636\u6bb5\uff1b\u5b89\u88c5\u65f6\u9700\u8ba9\u4e94\u4e2a\u9636\u6bb5\u6280\u80fd\u4e0e\u672c\u6280\u80fd\u4f4d\u4e8e\u540c\u4e00\u5c42\u3002\n\n## 4. \u6807\u51c6\u89e3\u8bf4\u6d41\u7a0b\uff08audio-mode narration\uff09\n\n### 4.1 \u80cc\u666f\u8c03\u7814\n\n\u82e5\u80fd\u8bc6\u522b\u5f71\u7247\u3001\u5267\u96c6\u6216\u4e3b\u9898\uff0c\u5148\u6309 video-understanding \u6280\u80fd\u7684\u8c03\u7814\u6307\u5357 `research-guide.md` \u8c03\u7814\u5e76\u5199\u5165\n`work_dir/background_research.json`\u3002\u89c6\u9891\u7406\u89e3\u4f1a\u628a\u4eba\u7269\u540d\u548c\u5267\u60c5\u80cc\u666f\u6298\u5165 VLM \u4e0a\u4e0b\u6587\uff0c\u907f\u514d\u53ea\u5f97\u5230\u201c\u9ed1\u8863\u7537\u5b50\u201d\u4e00\u7c7b\u6a21\u7cca\u63cf\u8ff0\u3002\u65e0\u6cd5\u8bc6\u522b\u6765\u6e90\u65f6\u53ef\u8df3\u8fc7\u3002\n\u591a\u89c6\u9891\u8fd0\u884c\u540c\u6837\u5199\u5728\u9879\u76ee `work_dir` \u4e0b\uff1arecap \u5728\u6bcf\u4e2a\u6765\u6e90\u7406\u89e3\u524d\u628a\u5b83\u590d\u5236\u5230 `sources/<source_id>/`\uff08\u6765\u6e90\u76ee\u5f55\u91cc\u6ca1\u6709\u3001\u6216\u6bd4\u9879\u76ee\u6587\u4ef6\u65e7\u65f6\u624d\u590d\u5236\uff0c\u6240\u4ee5\u67d0\u4e00\u96c6\u9700\u8981\u5355\u72ec\u7684\u8c03\u7814\u65f6\uff0c\u5728\u9879\u76ee\u6587\u4ef6\u4e4b\u540e\u5199\u5165\u8be5\u6765\u6e90\u76ee\u5f55\u5373\u53ef\uff09\u3002\n\n### 4.2 \u5206\u6790\u5e76\u6682\u505c\u521b\u4f5c\n\n```bash\npython3 scripts/recap.py <video> --work-dir <work_dir> --context \"\u80cc\u666f\"\n```\n\n\u547d\u4ee4\u5b8c\u6210\u89c6\u9891\u7406\u89e3\u3001\u5199\u51fa `agent_narration_brief.md`\uff0c\u7136\u540e\u6682\u505c\u3002\u6b64\u65f6\u6309\u4ee5\u4e0b\u987a\u5e8f\u6267\u884c `video-script`\uff1a\n\n1. \u67e5\u770b\u521b\u4f5c brief \u4e0e\u539f\u7247\u6545\u4e8b\u677f\u3002\n2. \u5199 `recap_story_plan.json` \u548c `visual_audio_board.json`\u3002\n3. full \u6a21\u5f0f\u5199 `narration.json`\uff1bcut \u6a21\u5f0f\u7b2c\u4e00\u9636\u6bb5\u53ea\u5199 `clip_plan.json`\u3002\n4. cut \u6a21\u5f0f\u7b2c\u4e8c\u9636\u6bb5\u67e5\u770b\u526a\u540e\u6545\u4e8b\u677f\uff0c\u8865\u5145\u8f93\u51fa\u65f6\u95f4\u4e0e\u58f0\u97f3\u5206\u5de5\uff0c\u518d\u5199 `narration.json`\u3002\n\n\u4e0d\u8981\u4ece\u6807\u9898\u6216\u65c1\u767d\u53e5\u5b50\u5f00\u59cb\uff1b\u5148\u9501\u5b9a\u6545\u4e8b\u4f53\u9a8c\u548c\u7d20\u6750\u9009\u62e9\u3002\n\n\u65f6\u95f4\u7ebf\u6709\u4e24\u6761\u4e0d\u53ef\u964d\u7ea7\u7684\u786c\u7ea6\u675f\uff1a\u539f\u58f0\u53ea\u80fd\u5728\u53ef\u9760\u53e5\u672b/\u9759\u97f3\u8fb9\u754c\u88ab\u5207\u5165\u3001\u5207\u51fa\u6216\u6062\u590d\uff1b\u65c1\u767d\u5fc5\u987b\u4f7f\u7528\n\u5b8c\u6574\u9010\u6bb5\u97f3\u9891\uff0c\u4efb\u4f55 clip \u6620\u5c04\u88c1\u6bb5\u3001TTS \u88c1\u5c3e\u6216\u526a\u6620\u5f15\u7528\u66f4\u957f\u7684\u52a0\u901f\u524d\u7d20\u6750\u90fd\u963b\u65ad\u3002Agent \u6536\u5230\n`interrupts_source_sentence` / `unsafe_clip_sentence_boundary` / `no_safe_fit` /\n`timeline_audio_mismatch` \u65f6\uff0c\u5e94\u79fb\u52a8\u8fb9\u754c\u3001\u7f29\u77ed\u6574\u53e5\u6216\u5220\u9664\u8be5\u5757\uff0c\u800c\u4e0d\u662f\u589e\u52a0\u62a2\u65ad override\uff1b\n`unsafe_clip_sentence_boundary` \u9644\u5e26\u7684 `nearest_safe` \u7ed9\u51fa\u524d\u540e\u6700\u8fd1\u7684\u5b89\u5168\u8fb9\u754c\u65f6\u95f4\u3002\n\n### 4.3 \u591a\u89c6\u9891\u4e0e\u7d20\u6750\u5e93\n\n\u591a\u89c6\u9891\u53ea\u652f\u6301 cut \u6a21\u5f0f\u3002\u9879\u76ee brief \u4f1a\u5217\u51fa\u7a33\u5b9a\u7684 `source_id`\uff0c`clip_plan.json` \u4e2d\u6bcf\u4e2a\u7247\u6bb5\u90fd\u5fc5\u987b\u586b\u5199\u6765\u6e90\uff1a\n\n```bash\npython3 scripts/recap.py ep1.mp4 ep2.mp4 --edit-mode cut --target-duration 10m --work-dir work_dir_multi_ep\n```\n\n\u7b2c\u4e8c\u9636\u6bb5\u4e0e\u5355\u89c6\u9891\u4e00\u6837\u751f\u6210\u526a\u540e\u6545\u4e8b\u677f `storyboard/edited_storyboard.*`\uff0c\u53d6\u81ea\u5404\u6765\u6e90 `sources/<source_id>/frames/`\uff0cbrief \u9876\u90e8\u5217\u51fa `S1`/`S2`\u2026 \u5bf9\u5e94\u7684 `source_id`\uff1b\u7d20\u6750\u5e93\u6062\u590d\u7684\u6765\u6e90\u6ca1\u6709\u62bd\u5e27\uff0c\u8fd9\u4e9b\u7247\u6bb5\u4e0d\u51fa\u73b0\u5728\u6545\u4e8b\u677f\u91cc\uff0c\u7528 `inspect clip-map` \u6838\u5bf9\u3002\n\n\u53ef\u9009\u6587\u4ef6\u7cfb\u7edf\u7d20\u6750\u5e93\uff1a\n\n```bash\npython3 scripts/recap.py ep1.mp4 --material-library-dir .video-materials --save-materials\npython3 scripts/recap.py ep1.mp4 ep2.mp4 --edit-mode cut --material-library-dir .video-materials --use-materials\n```\n\n\u7d20\u6750\u68c0\u7d22\u53ea\u662f\u5bf9 JSON / MD / JSONL \u505a grep\uff0c\u4f8b\u5982 `grep -R \"keyword\" .video-materials`\u3002\u5f53\u524d\u7248\u672c\u4e0d\u590d\u5236\u539f\u59cb\u5a92\u4f53\uff0c\u4e5f\u4e0d\u63d0\u4f9b\u6570\u636e\u5e93\u3001\u5411\u91cf\u6216\u8bed\u4e49\u641c\u7d22\u3002\n\n\u540c\u4e00\u6839\u76ee\u5f55\u8fd8\u53ef\u4ee5\u767b\u8bb0\u53ef\u590d\u7528\u7684\u8d44\u6e90\uff08BGM\u3001\u97f3\u6548\u3001\u97f3\u8272\u3001\u5b57\u4f53\u3001\u56fe\u7247\uff09\u3001\u5e26\u7248\u672c\u4e0e\u91c7\u7528\u8bb0\u5f55\u7684\u6a21\u677f\uff08\u5b57\u5e55\u6837\u5f0f\u3001\u5305\u88c5\u56fe\u5c42\u3001\u5236\u4f5c\u53c2\u8003\uff09\u548c\u6837\u7247\u3002\n\u683c\u5f0f\u4e0e `scripts/library.py check|list|show` \u53ea\u8bfb\u5de5\u5177\u89c1 `references/resource-library.md`\u3002\u7528 `--project recap_project.json` \u628a\u5df2\u91c7\u7528\u7684\u5b57\u5e55\u6837\u5f0f\u3001\u5305\u88c5\u3001\u5236\u4f5c\u53c2\u8003\u3001\u97f3\u8272\u4e0e BGM \u7ed1\u5b9a\u5230\u8fd9\u6b21\u8fd0\u884c\uff1b\n\u6bcf\u6b21 full / cut \u5408\u6210\u540e `work_dir/resource_lock.json` \u8bb0\u4e0b\u5b9e\u9645\u7528\u5230\u7684\u8d44\u6e90\u4e0e\u6388\u6743\u72b6\u6001\u3002\n\n### 4.4 \u7ee7\u7eed\u751f\u6210\u6210\u7247\n\n\u5199\u597d\u6240\u9700\u4ea7\u7269\u540e\uff0c\u91cd\u590d\u540c\u4e00\u6761\u547d\u4ee4\uff1a\n\n```bash\npython3 scripts/recap.py <video> --work-dir <work_dir>  # \u53ef\u8ffd\u52a0 --edit-mode cut / --no-burn-subtitles\n```\n\n\u6d41\u7a0b\u4f1a\u6821\u9a8c\u5f53\u524d\u9636\u6bb5\u7684\u786c\u8f93\u5165\uff08`clip_plan.json` / `narration.json`\uff09\uff1b\u4e24\u4efd\u521b\u4f5c\u8ba1\u5212\u4ecd\u662f Agent \u4e0e\u5efa\u8bae\u578b\u8bc4\u5ba1\u4f7f\u7528\u7684\u5de5\u4f5c\u8bb0\u5f55\uff0c\u4e0d\u662f\u6e32\u67d3\u95e8\u7981\u3002cut \u6a21\u5f0f\u968f\u540e\u751f\u6210 `edited_source.mp4`\uff0c\u518d\u5408\u6210\u65c1\u767d\u5e76\u8f93\u51fa `recap_<name>.mp4`\u3002\n\n\u6821\u9a8c\u4ece\u4e0d\u6539\u5199\u89e3\u8bf4\u7a3f\uff08\u53ea\u66f4\u65b0\u5b9e\u6d4b\u7684 `overlaps_speech`\uff09\uff1bfull \u6a21\u5f0f\u4e0b\u6587\u672c\u88c5\u4e0d\u4e0b\u65f6\u95f4\u7a97\u4f1a\u4ee5 `over_budget` error \u9000\u56de\u7ed9 Agent\u3002\u5df2\u6709\u6279\u51c6\u89e3\u8bf4\u7a3f\u65f6\u52a0 `--preserve-approved-text`\uff0cTTS \u4e5f\u539f\u6837\u4fdd\u7559\u6279\u51c6\u7a3f\uff0c\u88c5\u4e0d\u4e0b\u65f6\u95f4\u7a97\u5373\u5931\u8d25\uff0c\u4e0d\u7f29\u7a3f\u3001\u4e0d\u964d\u7ea7\u4e3a\u90e8\u5206\u6210\u529f\u3002\n\n### 4.5 \u5b57\u5e55\u4e0e\u514b\u9686\u65c1\u767d\n\n\u82e5\u8981\u628a\u65c1\u767d\u5b57\u5e55\u56fa\u5b9a\u5728\u539f\u7247\u5b57\u5e55\u533a\u57df\uff0c\u5148\u6d4b\u91cf\u4f4d\u7f6e\u3002\u5b8c\u6574\u6e90\u7801\u5b89\u88c5\u53ef\u5728\u4ed3\u5e93\u6839\u76ee\u5f55\u8fd0\u884c\u4ee5\u4e0b\u5de5\u5177\uff1b\u5355\u72ec\u5b89\u88c5\u6280\u80fd\u65f6\uff0c\u7531 Agent \u67e5\u770b\u89c6\u9891\u5e27\u6d4b\u51fa\u540c\u4e00\u663e\u793a\u753b\u5e03\u4e0a\u7684\u4e0a\u4e0b\u8fb9\u754c\uff1a\n\n```bash\npython3 tools/measure_subtitle.py <video>\n```\n\n\u518d\u4f20\u5165\u6d4b\u5f97\u7684 `--subtitle-y-top/--subtitle-y-bot`\u3002\u5750\u6807\u57fa\u4e8e ffmpeg \u81ea\u52a8\u65cb\u8f6c\u540e\u7684\u663e\u793a\u753b\u5e03\uff0c\u533a\u95f4\u4e3a\u534a\u5f00 `[top, bot)`\uff0c\u5e76\u8981\u6c42\u5e95\u5bf9\u9f50 ASS \u6837\u5f0f\uff1b\u663e\u5f0f\u8bbe\u7f6e\u540e\uff0c\u8be5\u533a\u57df\u9ed8\u8ba4\u4f7f\u7528\u4e0d\u900f\u660e\u7684\u65c1\u767d\u7a97\u53e3\u906e\u7f69\uff1b\u53ef\u7528 `SUBTITLE_MASK_OPACITY` \u8c03\u6574\u3002\n\n\u89e3\u8bf4\u6a21\u5f0f\u5982\u9700\u514b\u9686\u53c2\u8003\u58f0\u97f3\uff0c\u4f7f\u7528 `--voice-ref <audio>`\uff1b\u5b83\u4e0e dub \u6a21\u5f0f\u4e0d\u540c\u3002\n\n### 4.6 \u6700\u7ec8\u89c2\u770b\u4e0e\u4ea4\u4ed8\u590d\u6838\n\n\u811a\u672c\u3001\u63a5\u70b9\u68c0\u6d4b\u3001\u6837\u5e27\u548c QC \u62a5\u544a\u90fd\u4e0d\u80fd\u66ff\u4ee3\u89c2\u770b\u3002\u6bcf\u8f6e\u51c6\u5907\u4ea4\u4ed8\u524d\uff0c\u5fc5\u987b\u68c0\u67e5**\u672c\u8f6e\u5b9e\u9645\u8981\u4ea4\u4ed8\u7684\u6700\u7ec8\u6587\u4ef6**\uff0c\u800c\u4e0d\u662f\u65e7\u522b\u540d\u3001\u65e0\u5b57\u5e55\u6bcd\u7248\u6216\u4e2d\u95f4\u4ee3\u7406\uff1a\n\n1. \u6b63\u5e38\u901f\u5ea6\u5b8c\u6574\u64ad\u653e\u4e00\u6b21\u77ed\u7247\uff0c\u4e0d\u8fb9\u770b\u8fb9\u6539\uff1b\u5148\u8bb0\u5f55\u771f\u5b9e\u89c2\u770b\u95ee\u9898\u3002\n2. \u64ad\u653e\u6bcf\u4e2a\u62fc\u63a5\u70b9\u524d\u540e\u7ea6 0.5\u20131 \u79d2\uff0c\u68c0\u67e5\u95ea\u5e27\u3001\u539f\u7247\u53e0\u5316\u88ab\u622a\u65ad\u3001\u52a8\u4f5c\u8df3\u53d8\u548c\u534a\u53e5\u539f\u58f0\u3002\n3. \u5b8c\u6574\u53ea\u542c\u58f0\u97f3\u4e00\u6b21\uff0c\u68c0\u67e5\u65c1\u767d\u662f\u5426\u788e\u6210\u4e00\u53e5\u4e00\u505c\u3001\u573a\u666f\u95f4\u58f0\u97f3\u662f\u5426\u63a5\u5f97\u4e0a\u3001\u5173\u952e\u539f\u58f0\u662f\u5426\u5b8c\u6574\u3002\n4. \u5355\u72ec\u590d\u770b\u5f00\u5934\u3001\u6838\u5fc3\u60c5\u7eea/\u8868\u6f14\u70b9\u548c\u7ed3\u5c3e\uff0c\u786e\u8ba4\u8fdb\u5165\u65f6\u673a\u3001\u56de\u62a5\u505c\u7559\u548c\u6536\u675f\u90fd\u6210\u7acb\u3002\n5. REVISION \u5206\u522b\u9a8c\u8bc1\u672c\u8f6e\u4fee\u6539\u9879\u5df2\u7ecf\u6539\u53d8\u3001\u51bb\u7ed3\u9879\u6ca1\u6709\u610f\u5916\u53d8\u5316\uff1b\u7136\u540e\u518d\u505a\u89e3\u7801\u3001\u65f6\u957f\u3001\u97f3\u753b\u89c4\u683c\u7b49\u673a\u68b0\u68c0\u67e5\u3002\n\nscene score\u3001\u4eae\u5ea6\u7edf\u8ba1\u3001contact sheet \u4e0e\u81ea\u52a8 QC \u53ea\u8d1f\u8d23\u5b9a\u4f4d\u5019\u9009\u95ee\u9898\uff1b\u6700\u7ec8\u5224\u65ad\u4ee5\u771f\u5b9e\u64ad\u653e\u4e3a\u51c6\u3002\u5bc6\u96c6\u5207\u70b9\u7684\u6765\u6e90\u5224\u65ad\u4e0e\u5904\u7406\u89c4\u5219\u6309\u526a\u8f91\u6280\u80fd\u6267\u884c\u3002\u4fee\u590d\u5931\u8d25\u65f6\u56de\u5230\u526a\u70b9\u3001\u58f0\u97f3\u6216\u6587\u6848\u5c42\uff0c\u4e0d\u7528\u66f4\u591a\u5305\u88c5\u63a9\u76d6\u3002\n\nfull/cut \u4ea4\u4ed8\u5982\u9700\u8ba9\u786e\u5b9a\u6027\u7684\u6700\u7ec8\u68c0\u67e5\u5f71\u54cd\u547d\u4ee4\u9000\u51fa\u72b6\u6001\uff0c\u663e\u5f0f\u4f20\n`--require-final-qc`\u3002\u53ea\u6709 `final_qc.json` \u7684\u6458\u8981\u4e3a `ok: true` \u4e14\u6574\u6570\n`blocker_count: 0` \u624d\u6253\u5370\u5b8c\u6210\u5e76\u8fd4\u56de\u6210\u529f\uff1b\u7f3a\u5931\u3001\u7578\u5f62\u6216 blocker\n\u4f1a\u4fdd\u7559\u62a5\u544a\u548c\u5df2\u6e32\u67d3\u8bca\u65ad\u5a92\u4f53\uff0c\u4f46\u547d\u4ee4\u975e\u96f6\u9000\u51fa\u4e14\u4e0d\u6253\u5370\u5b8c\u6210\u3002\u9ed8\u8ba4\u4ecd\u662f\u4ec5\u62a5\u544a\u3001\u4e0d\u963b\u65ad\u3002\n\u8be5\u53c2\u6570\u4e0d\u652f\u6301 `--edit-mode dub`\uff1bdub \u672a\u4f20\u8be5\u53c2\u6570\u65f6\u7684\u51c6\u5907\u548c\u6e32\u67d3\u884c\u4e3a\u4e0d\u53d8\u3002\n\n\u4ea4\u4ed8\u65f6\u8bfb `final_qc.json` \u7684 `metadata.warnings`\uff0c\u6709\u5185\u5bb9\u5c31\u539f\u6837\u544a\u8bc9\u7528\u6237\uff0c\u4e0d\u80fd\u53ea\u62a5\u201c\u5b8c\u6210\u201d\u3002`subtitle_burn_degraded`\n\u8868\u793a ffmpeg \u7f3a libass\u3001\u9ed8\u8ba4\u70e7\u5f55\u88ab\u964d\u7ea7\uff1a\u65b0\u5b57\u5e55\u4fdd\u5b58\u5728\u6210\u7247\u65c1\u7684\u540c\u540d `.srt`\uff0c\u539f\u7247\u5df2\u6709\u786c\u5b57\u5e55\u4ecd\u4fdd\u7559\u3002\u7528\u6237\u8981\u70e7\u5f55\u5b57\u5e55\uff0c\u5c31\u8bf7\u4ed6\u88c5\u5e26 libass \u7684\nffmpeg \u540e\u91cd\u8dd1\uff1b\u663e\u5f0f\u4f20 `--burn-subtitles` \u65f6\u7f3a libass \u4f1a\u5728\u5f00\u8dd1\u524d\u62a5\u9519\u3002\u65c1\u767d\u91cc\u5199\u4e86 `visual_overlays` \u800c ffmpeg \u7f3a\ndrawtext \u65f6\uff0c\u6d41\u7a0b\u5728\u914d\u97f3\u524d\u505c\u4e0b\uff0c\u6309\u62a5\u9519\u5220\u6389\u53e0\u52a0\u6216\u6362 ffmpeg \u540e\u7eed\u8dd1\u3002\n\n### 4.7 \u4e0d\u9700\u8981\u89e3\u8bf4\u7684\u7247\u5b50\n\n```bash\n# \u5bf9\u5f53\u524d\u6574\u6bb5\u8f93\u5165\u76f4\u63a5\u5408\u6210\uff1b\u4e0d\u9690\u5f0f\u8dd1\u7406\u89e3/ASR/TTS\npython3 scripts/recap.py locked_picture.mp4 --work-dir source_work --audio-mode source-mix\n# \u526a\u8f91\u8ba1\u5212\u4ecd\u6309 cut \u6d41\u7a0b\u4ea7\u751f\uff0c\u526a\u5b8c\u4e0d\u518d\u6682\u505c\u7b49\u5f85 narration.json\npython3 scripts/recap.py ep1.mp4 ep2.mp4 --edit-mode cut --work-dir cut_work --audio-mode source-mix\n# \u53ea\u6362\u5305\u88c5\u65f6\u51bb\u7ed3\u5f53\u524d\u6574\u7247 AAC\uff1b\u4e0d\u5141\u8bb8\u540c\u65f6\u52a0 BGM/TTS\npython3 scripts/recap.py adopted.mp4 --work-dir packaging_work --audio-mode adopted-packet-copy\n```\n\n`source-mix` \u4ecd\u4f1a\u6df7\u97f3\u548c\u91cd\u7f16\u7801\uff1b`cut + adopted-packet-copy` \u51bb\u7ed3\u7684\u662f\u526a\u540e\u4e2d\u95f4\u7247\u7684\u58f0\u97f3\uff0c\u4e0d\u662f\u539f\u7247\u7684 AAC \u5305\u3002\n\u5f53\u524d\u4e25\u683c\u5b57\u5e55\u8f68\u53ea\u652f\u6301 adopted \u6a21\u5f0f\uff1b\u5176\u4ed6\u5b57\u5e55\u6765\u6e90\u6ca1\u6709\u56e0\u6b64\u53d8\u6210\u7cbe\u786e\u5bf9\u9f50\u3002\u5207\u6362\u58f0\u97f3\u6a21\u5f0f\u987b\u65b0\u5de5\u4f5c\u76ee\u5f55\uff0c\u4e0d\u5f97\u628a\u65e7 TTS\u3001QC \u6216\u81ea\u52a8\u751f\u6210\u7684\u89e3\u8bf4\u82b1\u5b57\u6df7\u5165\u672c\u8f6e\u539f\u58f0\u751f\u4ea7\u3002\u7ec6\u8282\u89c1 `references/audio-routing.md`\u3002\n\n## 5. \u82f1\u8bd1\u4e2d\u539f\u58f0\u590d\u523b\u6a21\u5f0f\n\n`--edit-mode dub` \u662f\u5b9e\u9a8c\u529f\u80fd\uff1a\u628a\u82f1\u6587\u89c6\u9891\u7ffb\u8bd1\u4e3a\u4e2d\u6587\uff0c\u5e76\u7528\u539f\u8bf4\u8bdd\u8005\u7684\u514b\u9686\u97f3\u8272\u66ff\u6362\u4eba\u58f0\uff1b\u5b83\u4e0d\u662f\u5728\u538b\u4f4e\u539f\u58f0\u4e0a\u53e0\u52a0\u89e3\u8bf4\u3002\u53ea\u5728\u7528\u6237\u660e\u786e\u8981\u6c42\u82f1\u8bd1\u4e2d\u914d\u97f3\u65f6\u4f7f\u7528\u3002\n\ndub \u4f1a\u628a\u6e90\u89c6\u9891\u97f3\u8f68\u5206\u7a97\u53d1\u7ed9 MiMo ASR \u8f6c\u5199\uff0c\u5e76\u628a\u622a\u53d6\u7684\u7ea6 10 \u79d2\u539f\u8bf4\u8bdd\u4eba\u58f0\u97f3\u4f5c\u4e3a\u53c2\u8003\uff0c\u8fde\u540c\u6bcf\u53e5\u8bd1\u6587\u53d1\u7ed9 MiMo voiceclone\u3002\u56e0\u6b64\u5fc5\u987b\u5e26 `--confirm-voice-rights`\uff1a\u5148\u5411\u7528\u6237\u786e\u8ba4\u4ed6\u6709\u6743\u4f7f\u7528\u8fd9\u6bb5\u89c6\u9891\u4e0e\u97f3\u9891\u3001\u4e14\u8bf4\u8bdd\u4eba\u540c\u610f\u88ab\u514b\u9686\u58f0\u97f3\uff0c\u786e\u8ba4\u540e\u624d\u52a0\u8fd9\u4e2a\u53c2\u6570\uff1b\u7f3a\u5c11\u65f6\u542f\u52a8\u5373\u62a5\u9519\uff0c\u4e0d\u62bd\u97f3\u9891\u3001\u4e0d\u53d1\u8bf7\u6c42\u3002\u8be5\u53c2\u6570\u53ea\u7528\u4e8e dub\uff0c\u5176\u4ed6\u6a21\u5f0f\u4f20\u5165\u4f1a\u62a5\u9519\u3002\n\n```bash\npython3 scripts/recap.py <video> --edit-mode dub --confirm-voice-rights --work-dir <work_dir>\n```\n\n\u51c6\u5907\u9636\u6bb5\u4f1a\u8f6c\u5199\u82f1\u6587\u3001\u63d0\u53d6\u4e00\u6bb5\u53c2\u8003\u97f3\u9891\uff0c\u5e76\u5199\u51fa `dub_brief.md` \u4e0e `dub_transcript.json`\u3002Agent \u6309 `dub_brief.md` \u91cc\u7684\u7ffb\u8bd1\u8981\u6c42\uff08\u9010\u53e5\u5fe0\u5b9e\u3001\u65f6\u95f4\u7a97\u3001\u8bed\u901f\uff09\u5199 `dub_script.json`\uff1a\n\n```json\n[{\"start\": 0.0, \"end\": 2.0, \"zh\": \"\u4e2d\u6587\u8bd1\u6587\"}]\n```\n\n\u91cd\u590d\u540c\u4e00\u547d\u4ee4\u540e\u5148\u505a\u786e\u5b9a\u6027 lint\uff08`dub_lint.json`\uff0c\u7a7a\u884c\u3001\u91cd\u53e0\u3001\u8d8a\u754c\u5373\u4e2d\u6b62\uff09\uff0c\u518d\u8f93\u51fa `dub_<name>.mp4`\u3002\u6bcf\u53e5\u5355\u72ec\u514b\u9686\u5e76\u8d34\u56de\u539f\u65f6\u95f4\u7ebf\uff1b\u53ea\u6709\u5373\u5c06\u8986\u76d6\u4e0b\u4e00\u53e5\u65f6\u624d\u5c40\u90e8\u52a0\u901f\u3002\u5f53\u524d\u7248\u672c\u53ea\u652f\u6301\u5355\u8bf4\u8bdd\u8005\u3001\u6574\u8f68\u66ff\u6362\uff0c\u4e0d\u5206\u79bb\u80cc\u666f\u97f3\u4e50\u3002\n\n## 6. \u81ea\u68c0\u4e0e\u53ea\u8bfb dashboard\n\n```bash\npython3 scripts/recap.py --doctor\n```\n\n### 6.1 \u53ea\u8bfb dashboard\n\n```bash\npython3 scripts/dashboard_server.py --root <\u76ee\u5f55> [--port 0] [--open]\n```\n\n\u524d\u53f0\u8fd0\u884c\u5e76\u6253\u5370\u672c\u673a\u5730\u5740\uff08\u53ea\u7ed1\u5b9a 127.0.0.1\uff0cAgent \u542f\u52a8\u65f6\u653e\u5230\u540e\u53f0\uff09\u3002\u5b83\u5728 `--root` \u4e0b\u6309 `library.json`\u3001`recap_project.json`\u3001\n`recap_run_manifest.json` \u53d1\u73b0\u8d44\u6e90\u5e93\u3001\u9879\u76ee\u4e0e\u8fd0\u884c\uff0c\u6309\u9636\u6bb5\u663e\u793a\u526a\u8f91\u8282\u594f\u3001\u65c1\u767d\u3001\u6210\u7247\u4e0e\u65f6\u95f4\u7ebf\u3001QC \u548c `resource_lock.json`\u3002\n\u4e25\u683c\u53ea\u8bfb\uff1a\u53ea\u63a5\u53d7 GET / HEAD\uff0c\u4e0d\u5199\u4efb\u4f55\u6587\u4ef6\uff1b\u9875\u9762\u4e0a\u7684\u300c\u590d\u5236\u7ed9\u52a9\u624b\u300d\u53ea\u590d\u5236\u4e00\u53e5\u8bf7\u6c42\uff0c\u6539\u52a8\u56de\u5230\u5bf9\u8bdd\u91cc\u505a\u3002\n\n## 7. \u8f93\u51fa\u4e0e\u53c2\u6570\n\n\u4e3b\u8981\u8f93\u51fa\uff1a\n\n- `recap_<video>.mp4`\uff1a\u6700\u7ec8\u6210\u7247\u3002\n- `subtitles.srt` / `subtitles.ass`\uff1a\u5b57\u5e55\u3002\n- `work_dir/`\uff1a\u5168\u90e8\u4e2d\u95f4\u4ea7\u7269\uff0c\u5951\u7ea6\u89c1 `references/data-schema.md`\u3002\n- `work_dir/recap_story_plan.json` / `visual_audio_board.json`\uff1aAgent \u521b\u4f5c\u610f\u56fe\u4e0e\u526a\u8f91\u51b3\u5b9a\u3002\n\n\u5b8c\u6574\u53c2\u6570\u5217\u8868\u4ee5 `python3 scripts/recap.py --help` \u4e3a\u51c6\u3002`--style` \u662f\u539f\u6837\u4f20\u7ed9 Agent \u7684\u81ea\u7531\u6587\u672c\u6307\u5bfc\uff0c\u4e0d\u662f preset\u3001\u679a\u4e3e\u3001\u5f00\u5173\u6216\u6709\u9650\u98ce\u683c\u5206\u7c7b\u3002\n\n## 8. \u80fd\u529b\u8fb9\u754c\n\n- \u8bed\u4e49\u8bc4\u5ba1\u9ed8\u8ba4\u5efa\u8bae\u578b\u3001\u5931\u8d25\u5f00\u653e\uff1b\u53ea\u6709\u8c03\u7528\u65b9\u663e\u5f0f\u542f\u7528\u4e25\u683c\u89e3\u8bf4\u8bc4\u5ba1\u65f6\uff0c\u4e8b\u5b9e\u77db\u76fe\u3001\u6b8b\u53e5\u6216\u8bc4\u5ba1\u4e0d\u53ef\u7528\u624d\u4f1a\u5728 TTS \u524d\u963b\u65ad\u3002\u786e\u5b9a\u6027\u6821\u9a8c\u9636\u6bb5\u59cb\u7ec8\u8d1f\u8d23\u786c\u6821\u9a8c\u3002\n- \u5ba3\u53d1\u6807\u9898\u3001\u82b1\u5b57\u6216\u5916\u90e8\u6587\u6848\u56de\u586b\u4ea4\u7ed9 `video-script`\uff0c\u7531\u5b83\u8bfb\u53d6\u81ea\u5df1\u7684\u5ba3\u53d1\u53c2\u8003\u3002\n","usage":"\u8bfb\u53d6 SKILL.md\uff0c\u5e76\u6309\u9700\u8bfb\u53d6\u914d\u5957\u6587\u4ef6\uff1b\u4e0b\u8f7d ZIP \u83b7\u53d6\u5b8c\u6574\u5305\u3002\u6280\u80fd\u662f\u4efb\u52a1\u65b9\u6cd5\uff0c\u4e0d\u6388\u4e88\u65b0\u589e\u8d26\u6237\u3001\u4ed8\u8d39\u6216\u7cfb\u7edf\u6743\u9650\u3002"}