字幕驱动短视频剪辑与竖屏导出
根据用户提供的本地字幕或弹幕定位候选片段，再把经选择的时间段剪成竖屏短视频，映射字幕时间轴，导出并生成可复核的技术报告。它适合访谈、课程、播客、直播回放、知识讲解和剧情素材的短片拆条。
能力边界
- 从 SRT/WebVTT 字幕提取定时文本窗口；可读 Bilibili 兼容 XML 弹幕的时间点，输出弹幕密度等可核对信号。
- 由 Agent 按用户目标理解上下文、比较开头与收尾、提出候选片段；统计数字只是证据，不是“爆款概率”或自动质量评分。
- 对用户选定的同一源视频片段执行精确裁切、画幅适配、字幕烧录或软字幕封装、平台预设导出、媒体质检和联系表抽帧。
- 只访问本地文件；不自动转录、生成画面、下载音乐、访问社媒、上传素材、发布视频、登录第三方平台或调用收费服务。
工作方式
- 提取任务目标、受众、目标平台、期望时长、字幕方式、素材位置和用户已有授权。目标平台缺失且会影响画幅或编码时，先给出建议选项。
- 检查源文件与字幕可读性。优先使用用户提供的字幕/弹幕；没有字幕时只按用户给定的时间码剪辑，不猜测视频对白。没有视觉能力时，不声称检查过画面。
- 对“找高光”请求运行
scripts/analyze_highlights.py，结合字幕原文与上下文提出少量候选，说明每段的主题、起止、完整性、统计信号和可能的误剪风险。不要仅按弹幕数或关键词机械决定。 - 用户要求直接剪辑时，按已给的主题/时间码生成剪辑计划；未选择片段时先提交候选清单，不擅自把整段视频导出成最终成片。
- 用
scripts/render_short.py进行本地渲染。默认使用保留画面的pad；裁切会丢掉画面边缘，用户选crop后须检查主体位置，偏心主体通过crop_anchor指明。 - 对字幕按被选片段重新映射时间轴，再烧录或封装。核对字幕没有落在错误片段、断句没有被裁掉；字幕原文不擅自改写。
- 回读输出报告、检查视频流/分辨率/时长/音轨并查看联系表。技术检查通过不等于内容、版权、平台规则或画面观感已通过；如有任何一项未实际检查，明确写出。
本地依赖
- Python 3.9 或更新版本；只用 Python 标准库。
- FFmpeg 和 FFprobe；剪辑执行器来自随包包含的
vendor/ffmpeg-skill-bundle（MIT）。没有依赖账号、API Key、Node/npm、云模型或平台登录。 - 先运行
python vendor/ffmpeg-skill-bundle/scripts/_contract.py doctor --json检查运行环境；某些滤镜、编码器或字体取决于本机 FFmpeg 构建。
常用入口
生成可读候选：
python scripts/analyze_highlights.py "D:/project/interview.srt" --danmaku-xml "D:/project/comments.xml" --term 预算 --window 25 --stride 12.5 --output "D:/project/candidates.json"
按剪辑计划先预演，再渲染：
python scripts/render_short.py "D:/project/edit-plan.json" --dry-run
python scripts/render_short.py "D:/project/edit-plan.json"
剪辑计划结构、运行结果和错误处理见 工作流与交付。资源筛选、许可、架构与去重记录见 来源与架构评估。平台限制和官方核验入口见 平台交付核验。
交付标准
交付视频文件、*.report.json 和可视联系表。报告必须列出输入文件哈希、选定时间段、输出规格、运行工具、质检结果和未验证事项。渲染失败时不要留下“成功”结论；技术检查失败但有成片时保留文件并标为“需要复核”。原素材不覆盖、不联网传输。音乐、字体、片段和人物素材的使用权由使用者确认。
English summary
Use supplied local SRT/WebVTT subtitles and optional Bilibili-compatible XML danmaku to surface reviewable clip candidates, then cut approved ranges, remap subtitles, export vertical videos, and report technical checks. The bundle runs locally with Python and FFmpeg, requires no login, API key, cloud model, or paid service. It does not invent transcripts, make virality guarantees, upload media, or publish posts.
