{"slug":"video-cut","title":"\u957f\u89c6\u9891\u5207\u7247","description":"\u6309 agent \u9009\u62e9\u7684\u539f\u7247\u533a\u95f4\u628a\u957f\u89c6\u9891\u526a\u6210\u77ed\u7247\uff0c\u8bfb\u53d6\u526a\u8f91\u8ba1\u5212\u6267\u884c\u3002","category":"\u526a\u8f91\u4e0e\u5305\u88c5","tags":["\u526a\u8f91","\u5207\u7247"],"author":"PiteChen","source_url":"https://github.com/zenstory-ai/video-recap-skills/blob/main/skills/video-cut/SKILL.md","license":"MIT","status":"published","verification":"source_reviewed","verification_notes":"\u6765\u6e90 zenstory-ai/video-recap-skills\uff08skills/video-cut/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:27+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-cut","skill_url":"https://shiliuai.cn/api/v2/skills/video-cut/files/SKILL.md","download_url":"https://shiliuai.cn/api/v2/skills/video-cut/download","install_url":"https://shiliuai.cn/api/v2/skills/video-cut/install","files":[{"path":"SKILL.md","bytes":11734,"url":"https://shiliuai.cn/api/v2/skills/video-cut/files/SKILL.md"},{"path":"references/shot-review.md","bytes":5570,"url":"https://shiliuai.cn/api/v2/skills/video-cut/files/references/shot-review.md"},{"path":"scripts/cut.py","bytes":169,"url":"https://shiliuai.cn/api/v2/skills/video-cut/files/scripts/cut.py"},{"path":"scripts/cut_cli.py","bytes":11648,"url":"https://shiliuai.cn/api/v2/skills/video-cut/files/scripts/cut_cli.py"},{"path":"scripts/cut_contract.py","bytes":12842,"url":"https://shiliuai.cn/api/v2/skills/video-cut/files/scripts/cut_contract.py"},{"path":"scripts/cut_qc.py","bytes":2674,"url":"https://shiliuai.cn/api/v2/skills/video-cut/files/scripts/cut_qc.py"},{"path":"scripts/cut_render.py","bytes":13582,"url":"https://shiliuai.cn/api/v2/skills/video-cut/files/scripts/cut_render.py"},{"path":"scripts/frame_grid.py","bytes":10854,"url":"https://shiliuai.cn/api/v2/skills/video-cut/files/scripts/frame_grid.py"},{"path":"scripts/lib.py","bytes":4556,"url":"https://shiliuai.cn/api/v2/skills/video-cut/files/scripts/lib.py"},{"path":"scripts/media_geometry.py","bytes":16360,"url":"https://shiliuai.cn/api/v2/skills/video-cut/files/scripts/media_geometry.py"},{"path":"scripts/narrative_selection.py","bytes":8972,"url":"https://shiliuai.cn/api/v2/skills/video-cut/files/scripts/narrative_selection.py"},{"path":"scripts/sentence_boundaries.py","bytes":27827,"url":"https://shiliuai.cn/api/v2/skills/video-cut/files/scripts/sentence_boundaries.py"},{"path":"scripts/sentence_gate.py","bytes":8766,"url":"https://shiliuai.cn/api/v2/skills/video-cut/files/scripts/sentence_gate.py"},{"path":"scripts/shot_review.py","bytes":17087,"url":"https://shiliuai.cn/api/v2/skills/video-cut/files/scripts/shot_review.py"}],"content":"---\nname: video-cut\nuser-invocable: false\ndescription: \u628a\u957f\u89c6\u9891\u6309 Agent \u9009\u62e9\u7684\u539f\u7247\u533a\u95f4\u526a\u6210\u77ed\u7247\u3002\u4f5c\u4e3a\u4e24\u9636\u6bb5\u521b\u4f5c\u6d41\u7a0b\u4e2d\u7684\u526a\u8f91\u73af\u8282\uff0c\u8bfb\u53d6 clip_plan.json \u4e0e\u6e90\u89c6\u9891\uff0c \u8f93\u51fa edited_source.mp4\uff1b\u968f\u540e Agent \u6309\u8f93\u51fa\u65f6\u95f4\u7ebf\u5199 narration.json\u3002\u652f\u6301\u5355\u89c6\u9891\u4e0e\u591a\u89c6\u9891\uff08sources manifest\uff09\u62fc\u526a\uff0c \u672c\u5de5\u5177\u4e0d\u8bfb\u53d6\u3001\u4e0d\u6620\u5c04\u65c1\u767d\u3002 \u89e6\u53d1\u8bcd\uff1a\u89c6\u9891\u526a\u8f91\u3001\u526a\u8f91\u5f0f\u89e3\u8bf4\u3001video cut\u3001clip plan\u3001\u62fc\u526a\u3002\n---\n\n## 1. \u5b9a\u4f4d\n\n\u672c\u6280\u80fd\u53ea\u6267\u884c Agent \u5df2\u7ecf\u505a\u51fa\u7684\u526a\u8f91\u51b3\u5b9a\uff1a\n\n1. \u6821\u9a8c\u5e76\u8865\u5168 `clip_plan.json`\uff0c\u5199\u51fa\u5e26 `clip_id`\u3001\u539f\u7247/\u8f93\u51fa\u65f6\u95f4\u4e0e\u65f6\u957f\u7684 `clip_plan_validated.json`\u3002\n2. \u5148\u907f\u5f00\u539f\u7247\u786c\u5207\u9644\u8fd1\u7684\u95ea\u5e27\u98ce\u9669\uff0c\u518d\u628a\u8fb9\u754c\u5438\u9644\u5230\u53ef\u9760\u53e5\u672b/\u81ea\u7136\u505c\u987f\uff1b\u58f0\u97f3\u5b8c\u6574\u6027\u62e5\u6709\u6700\u7ec8\u4f18\u5148\u7ea7\u3002\n3. \u628a\u6bcf\u4e2a\u5165\u70b9\u5bf9\u9f50\u5230\u6e90\u89c6\u9891\u5e27\u7f51\u683c\u3001\u6bcf\u6bb5\u65f6\u957f\u5bf9\u9f50\u5230\u6574\u6570\u4e2a\u8f93\u51fa\u5e27\uff08\u4e0d\u8db3\u4e00\u5e27\u7684\u79fb\u52a8\uff0c\u4f18\u5148\u9009\u53e5\u754c\u95e8\u7981\u4ecd\u5224\u4e3a\u5b89\u5168\u3001\u4ecd\u5728\u505c\u987f\u5185\u7684\u4e00\u4fa7\uff1b\u4e24\u4fa7\u540c\u6837\u5b89\u5168\u65f6\u9009\u4e0d\u8de8\u8fc7\u539f\u7247\u786c\u5207\u7684\u4e00\u4fa7\uff0c\u907f\u514d\u95ea\u4e00\u5e27\uff09\uff0c\u53e5\u754c\u95e8\u7981\u68c0\u67e5\u7684\u662f\u5bf9\u9f50\u540e\u7684\u8fb9\u754c\u3002\n4. \u62fc\u63a5\u9009\u5b9a\u533a\u95f4\uff0c\u8f93\u51fa\u6052\u5b9a\u5e27\u7387\u7684 `edited_source.mp4`\uff0c\u5e27\u6570\u4e0e `clip_plan_validated.json` \u8bb0\u5f55\u7684\u4e00\u81f4\u3002\n5. \u5230\u6b64\u505c\u6b62\uff0c\u7531 Agent \u6309\u771f\u5b9e\u8f93\u51fa\u65f6\u95f4\u7ebf\u5199 `narration.json`\uff1b\u672c\u5de5\u5177\u4e0d\u8bfb\u53d6\u65c1\u767d\uff0c\u4e5f\u4e0d\u505a\u539f\u7247\u2192\u8f93\u51fa\u6620\u5c04\u3002\n\n\u6e32\u67d3\u7f13\u5b58\u6309\u8f93\u5165\u4e0e\u8bbe\u7f6e\u590d\u7528\u3002`edited_source.mp4.meta.json` \u8bb0\u5f55\u6807\u51c6\u5316 clips\u3001\u6e32\u67d3\u8bbe\u7f6e\u548c\u6bcf\u4e2a\u6e90\u6587\u4ef6\u7684 `size`/`mtime_ns`\uff1b\u4e09\u8005\u4e0e\u5f53\u524d\u4e00\u81f4\u4e14 `edited_source.mp4` \u5b58\u5728\u975e\u7a7a\u624d\u590d\u7528\uff0c\u4efb\u4e00\u4e0d\u540c\u5373\u91cd\u6e32\u67d3\u3002\u53ea\u6709 sidecar \u800c\u6ca1\u6709\u5a92\u4f53\u6587\u4ef6\u4e0d\u590d\u7528\u3002\n\n## 2. \u8f93\u5165\u5951\u7ea6\n\n`work_dir/clip_plan.json` \u53ef\u4ee5\u662f\u6570\u7ec4\uff0c\u4e5f\u53ef\u4ee5\u662f `{\"clips\": [...]}`\uff1a\n\n```json\n{\"start\": 12.0, \"end\": 28.5, \"reason\": \"b02 | turn | power: A\u2192B | POV=\u5973\u4e3b | \u4fdd\u7559\u53cd\u5e94 | \u5165\u70b9=\u95ee\u9898\u843d\u4e0b | \u51fa\u70b9=\u6c89\u9ed8\u7ed3\u675f\"}\n```\n\n- `start` / `end` \u662f\u539f\u7247\u79d2\u6570\uff1b\u4e5f\u63a5\u53d7 `source_start` / `source_end` \u6216 `in` / `out`\u3002\n- \u9876\u5c42\u53ef\u9009 `target_duration`\uff0c\u4f8b\u5982 `\"10m\"`\u3002\n- \u591a\u89c6\u9891\u9879\u76ee\u7684\u6bcf\u4e2a\u7247\u6bb5\u8fd8\u5fc5\u987b\u586b\u5199 `source_id`\uff08\u4e0d\u63a5\u53d7 `id` \u4ee3\u66ff\uff09\uff0c\u5e76\u7528 `--sources-manifest` \u4f20\u5165\u6765\u6e90\u6e05\u5355\uff08\u5f62\u72b6\u89c1\u4e0b\uff09\u3002\n- `speech_boundary_anchors.json` \u4e0e ASR \u65f6\u95f4\u6bb5\u7531\u7406\u89e3\u9636\u6bb5\u63d0\u4f9b\uff1bAgent \u5148\u5199\u5927\u81f4\u533a\u95f4\uff0c\u5de5\u5177\u4f1a\u5c1d\u8bd5\u5438\u9644\u5e76\u628a\u4ecd\u5728\u8bb2\u8bdd\u533a\u95f4\u5185\u7684\u5165/\u51fa\u70b9\u4f5c\u4e3a blocker \u8fd4\u56de\u3002\u53ea\u542b\u8bed\u6c14\u8bcd\u6216 ASR \u6742\u97f3\u7684\u7a97\u53e3\uff08\"\u554a\uff01\"\u3001\"Hi.\"\uff09\u4e0d\u7b97\u8bb2\u8bdd\u533a\u95f4\uff0c\u53ea\u5728\u7d27\u6328\u771f\u5b9e\u5bf9\u767d\u7684\u4e00\u4fa7\u4fdd\u7559 1 \u79d2\u4fdd\u62a4\u3002\u53ea\u6709\u6807\u70b9\u7684\u7a97\u53e3\uff08\"\u2026\u2026\"\uff09\u4ecd\u7b97\u8bb2\u8bdd\u3002\n\n\u591a\u89c6\u9891\u6765\u6e90\u6e05\u5355\u53ea\u63a5\u53d7\u4e00\u79cd\u5f62\u72b6\uff0c\u5176\u4ed6\u5f62\u72b6\u76f4\u63a5\u62a5\u9519\u5e76\u5199\u660e\u671f\u671b\u5f62\u72b6\uff1a\n\n```json\n{\"sources\": [{\"source_id\": \"ep1\", \"source_path\": \"/media/ep1.mp4\", \"duration\": 1520.0, \"source_work_dir\": \"sources/ep1\"}]}\n```\n\n`duration` \u53ef\u7701\u7565\uff08\u7701\u7565\u65f6\u7528 ffprobe \u8bfb\u53d6\uff09\uff1b`source_work_dir` \u53ef\u7701\u7565\uff0c\u586b\u5199\u65f6\u76f8\u5bf9 `--work-dir`\uff0c\u7528\u4e8e\u8bfb\u53d6\u8be5\u6765\u6e90\u7684\u9759\u97f3\u3001\u53e5\u672b\u951a\u70b9\u4e0e ASR\u3002\u5176\u4ed6\u952e\u5ffd\u7565\u3002\n\n## 3. \u526a\u8f91\u610f\u56fe\u5951\u7ea6\n\nAgent \u5199\u7247\u6bb5\u524d\u5148\u786e\u8ba4\u526a\u8f91\u610f\u56fe\uff0c\u5e76\u8ba9\u6bcf\u4e2a\u533a\u95f4\u6620\u5c04\u5230 `recap_story_plan.json` \u7684\u4e00\u4e2a beat\uff1b\u5de5\u5177\u8d1f\u8d23\u6267\u884c\u4e0e\u6821\u9a8c\u3002\n\n\u4f7f\u7528\u73b0\u6709\u81ea\u7531\u6587\u672c `reason` \u4fdd\u5b58\u7b80\u6d01\u51b3\u5b9a\uff1a\n\n```text\nbeat_id | function | change | POV | preferred moment | \u5165\u70b9 reason | \u51fa\u70b9 reason\n```\n\n\u4e0d\u8981\u56e0\u4e3a\u201c\u4e8b\u4ef6\u91cd\u8981\u201d\u5c31\u4fdd\u7559\u6574\u6bb5\uff1b\u8981\u4fdd\u7559\u6700\u80fd\u8ba9 change \u6210\u7acb\u7684\u5177\u4f53\u8868\u6f14\u3001\u53cd\u5e94\u3001\u52a8\u4f5c\u6216\u63ed\u793a\u3002\u7406\u89e3\u4e0e\u60c5\u7eea\u5141\u8bb8\u65f6\u665a\u8fdb\u65e9\u51fa\uff0c\u540c\u65f6\u4fdd\u8bc1\u53f0\u8bcd\u3001\u52a8\u4f5c\u548c\u6280\u672f\u8fb9\u754c\u5b8c\u6574\u3002\n\n\u5bf9\u4e0d\u80fd\u5220\u53bb\u7684\u95ee\u7b54\u3001\u53cd\u5e94\u6216\u52a8\u4f5c\u5151\u73b0\uff0c\u5148\u6838\u6e90\u8bc1\u636e\uff0c\u518d\u5728\u540c\u4e00 `clip_plan.json` \u767b\u8bb0\u7cbe\u786e\u533a\u95f4\uff1a\n\n```json\n{\n  \"clips\": [{\"start\": 12, \"end\": 18}],\n  \"required_evidence\": {\n    \"nodes\": [\n      {\"id\": \"refusal\", \"source\": \"/media/episode.mp4\", \"start\": 12.25, \"end\": 14.5, \"track\": \"audio\", \"content\": \"\u5bf9\u65b9\u62d2\u7edd\u8bf7\u6c42\"},\n      {\"id\": \"response\", \"source\": \"/media/episode.mp4\", \"start\": 15, \"end\": 17.5, \"track\": \"video\", \"content\": \"\u542c\u5230\u62d2\u7edd\u540e\u7684\u53cd\u5e94\u4e0e\u51b3\u5b9a\"}\n    ],\n    \"before\": [[\"refusal\", \"response\"]]\n  }\n}\n```\n\n`source` \u4f7f\u7528\u5b9e\u9645\u6e90\u6587\u4ef6\u7edd\u5bf9\u8def\u5f84\uff0c`start/end` \u662f\u539f\u7247\u79d2\uff1b\u591a\u6e90\u53ef\u53e6\u586b `source_id` \u6d88\u6b67\u3002\u53ea\u767b\u8bb0\u786e\u5b9e\u9700\u8981\u4fdd\u7559\u7684\u5177\u4f53\u65f6\u523b\uff0c\u4e0d\u5c06\u6574\u4e2a beat \u9ed8\u8ba4\u9501\u6b7b\u3002`before` \u53ea\u767b\u8bb0\u672c\u7247\u5fc5\u9700\u7684\u5148\u540e\u5173\u7cfb\uff1b\u65e0\u9700\u7ea6\u675f\u987a\u5e8f\u65f6\u5199 `before: []`\u3002\n\n\u5de5\u5177\u5728\u5168\u90e8\u753b\u9762/\u53e5\u754c\u5438\u9644\u540e\u68c0\u67e5\u6bcf\u4e2a\u5fc5\u4fdd\u65f6\u523b\u81f3\u5c11\u6709\u4e00\u5904\u5b8c\u6574\u8fde\u7eed\u4fdd\u7559\u3001\u6765\u6e90\u548c\u5148\u540e\uff1b\u97f3\u9891\u8282\u70b9\u8fd8\u68c0\u67e5\u6e90\u97f3\u8f68\u662f\u5426\u5b58\u5728\u3002\u6bcf\u6b21\u7ed3\u679c\u51fa\u73b0\uff08\u5305\u62ec\u5c40\u90e8\u7247\u6bb5\uff09\u90fd\u9700\u6ee1\u8db3\u5176\u58f0\u660e\u7684\u524d\u63d0\uff0c\u4e0d\u80fd\u7528\u540e\u9762\u7684\u5b8c\u6574\u6bb5\u66ff\u5f00\u5934\u7f3a\u524d\u63d0\u7684\u7247\u6bb5\u8fc7\u5173\u3002\u7ed3\u679c\u5199\u5165 `clip_plan_validated.json.qc.required_evidence`\uff1b\u7f3a\u6bb5\u3001\u9519\u5e8f\u6216\u65e0\u6548\u58f0\u660e\u4f1a\u5728\u9884\u68c0\u3001\u7f13\u5b58\u590d\u7528\u548c\u6e32\u67d3\u524d\u963b\u65ad\uff0c\u65f6\u957f\u653e\u5bbd\u9009\u9879\u4e0d\u4f1a\u8df3\u8fc7\u3002\u8be5\u7ed3\u679c\u9a8c\u8bc1\u9009\u6bb5\u4fdd\u7559\uff0c\u5b9e\u9645\u8bed\u4e49\u4e0e\u6700\u7ec8\u6df7\u97f3\u4ecd\u6309\u5ba1\u7247\u6b65\u9aa4\u6838\u5bf9\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\n\n## 4. \u8fd0\u884c\u547d\u4ee4\n\n```bash\npython3 scripts/cut.py <video> --work-dir <work_dir> [--clip-plan <clip_plan.json>] \\\n  [--sources-manifest <sources.json>] [--target-duration 10m] [--allow-overlap] \\\n  [--allow-duration-drift] [--normalize-only] \\\n  [--review-shots [--shot-scene-threshold 0.35] [--shot-roi X Y W H]]\n```\n\n- `--clip-plan`\uff1a\u526a\u8f91\u8ba1\u5212\u8def\u5f84\uff0c\u9ed8\u8ba4 `<work_dir>/clip_plan.json`\u3002\n\n- `--sources-manifest`\uff1a\u591a\u6e90\u526a\u8f91\u7684\u6765\u6e90\u6e05\u5355 `{\"sources\": [{\"source_id\", \"source_path\"[, \"duration\", \"source_work_dir\"]}]}`\uff1b\u7247\u6bb5\u7528 `source_id` \u6307\u660e\u6765\u6e90\uff0c\u5e76\u6309\u81ea\u5df1\u7684\u6765\u6e90\u5438\u9644\u53e5\u754c\u4e0e\u753b\u9762\u5207\u70b9\u3002\n- `--target-duration`\uff1a\u76ee\u6807\u65f6\u957f\u3002\u5b9e\u9645\u65f6\u957f\u4e0e\u76ee\u6807\u4e4b\u6bd4\u5728 0.85\u20131.15 \u4e4b\u5916\u8bb0 warning\uff0c\u5728 0.60\u20131.40 \u4e4b\u5916\u963b\u65ad\u3002\n- `--allow-duration-drift`\uff1a\u53ea\u653e\u884c\u65f6\u957f\u504f\u5dee\u963b\u65ad\uff08\u8bb0\u4e3a `allowed: true` \u7684 warning\uff09\uff0c\u4e0d\u653e\u884c\u53e5\u754c\u6216\u5fc5\u4fdd\u8bc1\u636e\u963b\u65ad\u3002\n- `--normalize-only`\uff1a\u53ea\u6807\u51c6\u5316\u3001\u5438\u9644\u5e76\u68c0\u67e5\u8ba1\u5212\uff0c\u5199\u51fa `clip_plan_validated.json` \u540e\u9000\u51fa\uff0c\u4e0d\u6e32\u67d3\u3002\n- `--review-shots`\uff1a\u5728\u6e32\u67d3\u6216\u590d\u7528\u7684 `edited_source.mp4` \u4e0a\u53ec\u56de\u77ed\u955c\u4e0e\u5bc6\u96c6\u5207\u70b9\u5019\u9009\uff0c\u53ea\u62a5\u544a\u3001\u4e0d\u4fee\u590d\uff1b`--shot-scene-threshold` \u662f\u53ec\u56de\u9608\u503c\uff08\u9ed8\u8ba4 0.35\uff0c\u4e0d\u662f\u9a8c\u6536\u6807\u51c6\uff09\uff0c`--shot-roi` \u53ea\u626b\u63cf\u8be5\u50cf\u7d20\u77e9\u5f62\uff08\u6709\u9ed1\u8fb9\u6216\u5305\u88c5\u65f6\u7528\uff09\uff0c\u4e0d\u88c1\u753b\u9762\u3002\n\ncut \u963b\u65ad\u65f6\u4ee5\u975e\u96f6\u72b6\u6001\u9000\u51fa\uff0c\u5e76\u628a\u539f\u56e0\u5199\u5165 `clip_plan_validated.json` \u7684 `qc.blocking`\uff0c\u6bcf\u9879\u5e26 `code`\uff1a\n\n- `unsafe_clip_sentence_boundary`\uff1a\u7247\u6bb5\u8fb9\u754c\u4ecd\u5728\u539f\u58f0\u8bb2\u8bdd\u5185\uff1b\u9010\u8fb9\u754c\u5224\u5b9a\u89c1 `qc.boundary_status.sentence_checks`\u3002\u88ab\u963b\u65ad\u7684\u8fb9\u754c\u5e26 `nearest_safe: {\"before\", \"after\"}`\uff1a\u524d\u540e 5 \u79d2\u5185\u6700\u8fd1\u7684\u5b89\u5168\u8fb9\u754c `{time, reason, delta}`\uff08\u539f\u7247\u79d2\uff1b`delta` \u4e3a\u76f8\u5bf9\u5f53\u524d\u8fb9\u754c\u7684\u79d2\u6570\uff0c\u6ca1\u6709\u5219\u4e3a `null`\uff1b\u5df2\u662f\u539f\u7247\u5e27\u7f51\u683c\u4e0a\u7684\u843d\u70b9\u5e76\u590d\u6838\u8fc7\uff1b\u91cd\u8dd1\u65f6\u5207\u955c\u5934\u907f\u8ba9\u82e5\u628a\u5b83\u62c9\u56de\u8bb2\u8bdd\u5185\uff0c\u8fd9\u6b21\u907f\u8ba9\u4f1a\u88ab\u64a4\u56de\uff0c`qc.boundary_status.shot_snaps` \u8bb0 `reverted_unsafe`\uff0c\u6240\u4ee5\u539f\u6837\u5199\u56de\u4e0d\u4f1a\u518d\u56e0\u53e5\u754c\u88ab\u963b\u65ad\uff09\uff0c\u6309\u5b83\u6539 `clip_plan.json` \u7684 `start`/`end` \u540e\u91cd\u8dd1\u3002\u5165\u70b9\u5f80\u524d\uff08`before`\uff09\u662f\u591a\u4fdd\u7559\u3001\u5f80\u540e\uff08`after`\uff09\u662f\u88c1\u6389\uff0c\u51fa\u70b9\u76f8\u53cd\uff1b\u5148\u786e\u8ba4\u6539\u52a8\u4e0d\u4f1a\u5207\u6389\u5fc5\u4fdd\u5185\u5bb9\u6216\u4e0e\u76f8\u90bb\u7247\u6bb5\u91cd\u53e0\u3002\u4e24\u4fa7\u90fd\u662f `null` \u8bf4\u660e\u9644\u8fd1\u6ca1\u6709\u505c\u987f\uff0c\u8981\u6362\u533a\u95f4\u800c\u4e0d\u662f\u5fae\u8c03\u3002\n- `target_duration_drift`\uff1a\u65f6\u957f\u504f\u5dee\u8d85\u51fa\u963b\u65ad\u9608\u503c\uff1b\u660e\u7ec6\u89c1 `qc.target_duration`\u3002\n- `REQUIRED_EVIDENCE_INVALID` / `REQUIRED_EVIDENCE_MISSING` / `REQUIRED_EVIDENCE_ORDER` / `REQUIRED_EVIDENCE_AUDIO_UNAVAILABLE`\uff1a\u5fc5\u4fdd\u8bc1\u636e\u58f0\u660e\u65e0\u6548\u3001\u7f3a\u6bb5\u3001\u9519\u5e8f\u6216\u6e90\u65e0\u97f3\u8f68\uff1b\u660e\u7ec6\u89c1 `qc.required_evidence`\u3002\n\n## 5. \u8f93\u51fa\u5951\u7ea6\n\n- `clip_plan_validated.json`\uff1a\u6807\u51c6\u5316\u7247\u6bb5\uff0c\u5305\u542b `clip_id`\u3001`source_start/end`\u3001`output_start/end`\u3001`duration` \u4e0e `frame_count`\uff08\u8be5\u7247\u6bb5\u6e32\u67d3\u7684\u5e27\u6570\uff09\u3002`qc.frame_grid` \u8bb0\u5f55\u8f93\u51fa\u5e27\u7387 `output_frame_rate`\uff08\u5355\u6e90\u6cbf\u7528\u6e90\u5e27\u7387\uff0c\u591a\u6e90\u7528\u753b\u5e03\u5e27\u7387\uff0cNTSC \u5199\u6210 `30000/1001`\uff09\u3001\u603b\u5e27\u6570\u4e0e\u5404\u6e90\u5e27\u7387\uff1b\u6bcf\u6b21\u5e27\u5bf9\u9f50\u7684\u524d\u540e\u65f6\u95f4\u5199\u5728 `qc.boundary_status.frame_snaps`\u3002\n- `edited_source.mp4`\uff1a\u6309\u8ba1\u5212\u62fc\u63a5\u540e\u7684\u6052\u5b9a\u5e27\u7387\u77ed\u89c6\u9891\uff0c\u5e27\u6570\u7b49\u4e8e `qc.frame_grid.frame_count`\u3002\n- `shot_review.json`\uff1a\u4ec5 `--review-shots` \u5f00\u542f\u540e\u751f\u6210\u7684\u5b9e\u9645\u89c6\u9891\u77ed\u955c/\u5bc6\u96c6\u5207\u955c\u5019\u9009\uff1b\u4e0d\u4f1a\u66f4\u6539\u8ba1\u5212\u3002\n\n\u4e0b\u6e38\u628a `edited_source.mp4` \u5f53\u4f5c\u89c6\u9891\uff0c\u628a Agent \u6309\u8f93\u51fa\u65f6\u95f4\u5199\u7684 `narration.json` \u5f53\u4f5c\u65c1\u767d\u3002\n\n## 6. \u8fb9\u754c\u4e0e\u65f6\u95f4\u7ebf\u89c4\u5219\n\n- `clip_plan.json` \u4f7f\u7528\u539f\u7247\u65f6\u95f4\uff1b`narration.json` \u76f4\u63a5\u4f7f\u7528\u526a\u540e\u8f93\u51fa\u65f6\u95f4\uff0c\u4e0d\u5b58\u5728\u539f\u7247 \u2192 \u8f93\u51fa\u7684\u65c1\u767d\u6620\u5c04\u3002\u8f93\u51fa\u65f6\u95f4\u4ee5 `clip_plan_validated.json` \u4e3a\u51c6\uff1a\u5e27\u5bf9\u9f50\u4f1a\u628a\u8fb9\u754c\u79fb\u52a8\u4e0d\u5230\u4e00\u5e27\uff0825fps \u4e0b\u4e0d\u8d85\u8fc7 40 ms\uff09\uff0c\u5199\u65c1\u767d\u524d\u8bfb validated \u8ba1\u5212\uff0c\u4e0d\u8981\u7528\u81ea\u5df1\u5199\u7684\u539f\u59cb\u533a\u95f4\u63a8\u7b97\u3002\n- \u8fb9\u754c\u4e0d\u5728\u5e27\u7f51\u683c\u4e0a\u65f6\uff0cconcat \u4f1a\u5728\u6bcf\u4e2a\u63a5\u70b9\u4e22\u6389\u4e00\u4e2a\u5e27\u4f4d\uff0825fps \u4e0b\u753b\u9762\u505c\u987f 80 ms\uff0c\u6210\u7247\u53d8\u6210\u53ef\u53d8\u5e27\u7387\uff09\uff0c\u6240\u4ee5\u5e27\u5bf9\u9f50\u65e0\u6cd5\u5173\u95ed\u3002\u6e90\u5e27\u7387\u672a\u77e5\uff08`r_frame_rate` \u4e3a `0/0` \u6216\u5927\u4e8e 120\uff09\u65f6\u5165\u70b9\u4e0d\u52a8\uff0c\u65f6\u957f\u4ecd\u5bf9\u9f50\u5230\u6574\u6570\u8f93\u51fa\u5e27\u3002\n- \u9ed8\u8ba4\u7981\u6b62\u91cd\u53e0\u6216\u91cd\u590d\u539f\u7247\u533a\u95f4\uff1b`--allow-overlap` \u5f00\u542f\u540e\u624d\u5141\u8bb8\u3002\n- \u7247\u6bb5\u8d77\u70b9\u53ea\u80fd\u4f4d\u4e8e\u6e90\u5934\u3001\u53ef\u9760\u53e5\u672b/\u9759\u97f3\u7a97\uff0c\u6216\u4e0e\u4e0a\u4e00\u7247\u6bb5\u6784\u6210\u65e0\u635f\u540c\u6e90\u8fde\u7eed\u8fde\u63a5\uff1b\u7247\u6bb5\u7ec8\u70b9\u540c\u7406\u3002ASR \u5224\u5b9a\u4ecd\u5728\u8bb2\u8bdd\u4e14\u65e0\u6cd5\u5438\u9644\u65f6\u5199\u5165 `unsafe_clip_sentence_boundary` \u5e76\u963b\u65ad\u3002\n- `SCENE_CUT_SNAP` \u9ed8\u8ba4\u5f00\u542f\uff1a\u5148\u6309\u753b\u9762\u628a source start \u5411\u540e\u3001source end \u5411\u524d\u5438\u9644\u5230\u9644\u8fd1\u786c\u5207\uff0c\u968f\u540e\u53e5\u672b\u5438\u9644\u518d\u505a\u6700\u7ec8\u4fee\u6b63\uff0c\u907f\u514d\u89c6\u89c9\u4fee\u6b63\u91cd\u65b0\u5236\u9020\u534a\u53e5\u539f\u58f0\uff1b\u9644\u8fd1\u6ca1\u6709\u505c\u987f\u3001\u53e5\u672b\u5438\u9644\u4fee\u4e0d\u56de\u6765\u65f6\uff0c\u628a\u8fb9\u754c\u79fb\u8fdb\u8bb2\u8bdd\u7684\u90a3\u6b21\u907f\u8ba9\u4f1a\u88ab\u64a4\u56de\uff08\u539f\u4f4d\u7f6e\u80fd\u8fc7\u95e8\u7981\u65f6\uff09\u3002\u9ed8\u8ba4\u8303\u56f4\u4e3a `SCENE_CUT_SNAP_MARGIN=0.5` \u79d2\uff0c\u68c0\u6d4b\u9608\u503c\u4e3a `SCENE_CUT_DETECT_THRESHOLD=0.4`\u3002\n- scene-change score \u53ea\u63d0\u4f9b\u63a5\u70b9\u5019\u9009\uff0c\u4e0d\u8bc1\u660e\u63a5\u70b9\u81ea\u7136\u3002\u5148\u68c0\u67e5\u77ed\u65f6\u95f4\u7a97\u5185\u662f\u5426\u51fa\u73b0\u5bc6\u96c6\u5019\u9009\uff0c\u518d\u533a\u5206\u6765\u6e90\uff1a\u539f\u7247\u81ea\u5e26\u7684\u65e0\u5173\u77ed\u955c\u5934\u6574\u6bb5\u5220\u9664\uff1b\u76f8\u5173\u4f46\u77ed\u5230\u50cf\u95ea\u5e27\u7684\u955c\u5934\u901a\u8fc7\u6269\u5c55 IN/OUT \u4fdd\u7559\u5b8c\u6574\u52a8\u4f5c\u3001\u53cd\u5e94\u6216\u53f0\u8bcd\uff0c\u4e0d\u7528\u5b9a\u683c/\u6162\u653e\u4f2a\u9020\u65f6\u957f\uff1b\u7531\u672c\u6b21\u62fc\u63a5\u5236\u9020\u7684\u5207\u70b9\u5219\u4f18\u5148\u79fb\u52a8\u8fb9\u754c\u3001\u6062\u590d\u540c\u6e90\u8fde\u7eed\u8fd0\u52a8\u3001\u5408\u5e76\u76f8\u90bb\u7247\u6bb5\u6216\u6539\u7528\u66f4\u81ea\u7136\u7684\u8fde\u63a5\uff0c\u5c3d\u91cf\u6d88\u9664\u3002\u6210\u7247\u540e\u4ecd\u8981\u9010\u4e2a\u64ad\u653e\u63a5\u70b9\u524d\u540e\u7ea6 0.5\u20131 \u79d2\uff1b\u767d\u95ea\u6216\u66dd\u5149\u53e0\u5316\u518d\u7ed3\u5408\u9010\u5e27\u4eae\u5ea6\u5b9a\u4f4d\uff0c\u4e0d\u80fd\u4e3a\u4e86\u901a\u8fc7\u89c6\u89c9\u68c0\u6d4b\u5207\u65ad\u5b8c\u6574\u53f0\u8bcd\uff0c\u4e5f\u4e0d\u80fd\u7528\u8f6c\u573a\u906e\u63a9\u574f\u63a5\u70b9\u3002\n- \u4fee\u77ed\u6b8b\u955c\u65f6\u4e0d\u5f97\u4ec5\u4e3a\u538b\u4f4e scene \u5206\u6570\u800c\u5bf9\u63a5\u70b9\u9644\u8fd1\u65bd\u52a0\u4e0e\u6240\u5c5e\u955c\u5934\u4e0d\u8fde\u7eed\u7684\u6781\u7aef\u653e\u5927\u6216\u4f4d\u79fb\uff1b\u53d6\u666f\u590d\u6838\u4e0e\u4fee\u590d\u9a8c\u8bc1\u6d41\u7a0b\u89c1 `references/shot-review.md`\u3002\n- \u8fde\u7eed\u540c\u6e90\u7247\u6bb5\u7684\u65e0\u635f\u8fde\u63a5\u4e0d\u505a\u53e5\u4e2d\u53cc\u4fa7\u97f3\u9891\u6de1\u51fa\uff1b\u975e\u8fde\u7eed\u7247\u6bb5\u4ecd\u5728\u5b89\u5168\u505c\u987f\u5185\u505a\u9632\u7206\u97f3\u6de1\u5165\u6de1\u51fa\u3002\n\n\u9700\u8981\u68c0\u67e5\u77ed\u65f6\u95f4\u9891\u7e41\u5207\u955c\u65f6\uff0c\u5148\u7528 ffmpeg scene filter \u53ec\u56de\u5019\u9009\u65f6\u95f4\uff1a\n\n```bash\nffmpeg -i input.mp4 -vf \"select='gt(scene,0.35)',showinfo\" -an -f null -\n```\n\n`0.35` \u662f\u8d77\u59cb\u9608\u503c\uff0c\u4e0d\u662f\u8d28\u91cf\u5224\u636e\uff1b\u5927\u5e45\u8fd0\u52a8\u3001\u95ea\u767d\u548c\u53e0\u5316\u90fd\u53ef\u80fd\u8bef\u62a5\u3002\u628a\u5019\u9009\u6620\u5c04\u56de\u539f\u7247 shot \u4e0e\u672c\u6b21\u62fc\u63a5\u8fb9\u754c\u540e\uff0c\u6309\u4e0a\u9762\u7684\u6765\u6e90\u5206\u7c7b\u5904\u7406\uff0c\u5e76\u4ee5\u6b63\u5e38\u901f\u5ea6\u64ad\u653e\u51b3\u5b9a\u662f\u5426\u4fdd\u7559\u3002\n\n\u9700\u8981\u7cbe\u786e\u5230\u5b9e\u9645\u5e27\u3001\u68c0\u67e5\u957f\u533a\u95f4\u5185\u90e8\u6b8b\u955c\u5e76\u8bb0\u5f55\u6240\u7528\u8ba1\u5212\u8def\u5f84\u65f6\uff0c\u4f7f\u7528\n`scripts/shot_review.py` \u6216 `cut.py --review-shots`\uff08\u6709\u9ed1\u8fb9\u6216\u5305\u88c5\u65f6\u52a0 `--roi` / `--shot-roi`\uff09\uff1b\n\u8be6\u89c1 `references/shot-review.md`\u3002\n\n## 7. \u80fd\u529b\u8fb9\u754c\n\n- \u4e0d\u505a\u8bed\u4e49\u7406\u89e3\uff0c\u4e0d\u5199\u65c1\u767d\uff0c\u4e0d\u66ff Agent \u9009\u62e9\u7247\u6bb5\uff1bscene filter \u53ea\u627f\u62c5\u6280\u672f\u8fb9\u754c\u5019\u9009\u68c0\u6d4b\u3002\n- \u53ea\u505a\u751f\u6210 `edited_source.mp4` \u6240\u9700\u7684\u526a\u5207\u3001\u62fc\u63a5\u4e0e\u4e00\u6b21\u4e2d\u95f4\u7f16\u7801\uff0c\u4e0d\u627f\u62c5\u5b57\u5e55\u5305\u88c5\u6216\u6700\u7ec8\u4ea4\u4ed8\u538b\u7f29\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"}