TikTok短视频字幕与口播文稿提取

解决什么问题

TikTok 视频里的字幕和口播内容散落在音轨与画面中，手动转录既慢又容易出错。当你需要把某条视频的口播整理成可编辑、可引用的文稿时，传统做法是边听边打字，再自己分段、剔除语气词和重复句——这个流程在批量处理或需要溯源时尤其低效。这个技能把「拿到链接 → 得到整理后文稿」压缩成一步，同时保留原始分析结果供复核。

技能如何工作

核心流程围绕 scripts/generate.js 展开，每条链接只请求一次，确保结果可追溯：

• 输入校验：只接受公开的 HTTP(S) TikTok 视频链接，拒绝账号主页、搜索页、私有链接、含凭据的 URL 和本地网络地址。识别后会在输出中保留原始链接。
• 调用与判定：以 --json 和独立的 --output-dir 执行脚本，仅在 success 为 true、summary 或 subtitle 至少一项非空且结果文件存在时继续。
• 整理输出：删除明显重复、空白和无意义碎片，按主题或语义边界分段（不虚构时间戳），输出整理后字幕、段落主题、专有名词和缺失警告。
• 可追溯性：完整原始结果保存在 media-analysis.json，区分视频原始陈述与分析解释，不虚构说话人、时间戳、引文、指标或事实。

参数方面支持 --url（必填）、--output-dir、--timeout、--retries、--json 和 --help。

适用边界与注意点

• 仅处理字幕/口播提取，不用于摘要、营销拆解、账号分析或互动数据请求。
• 结果依赖原始链接公开可访问；服务无法读取时直接报告失败，不做降级猜测。
• 密钥通过 --api-key 或 UNITYCLAW_KEY 提供，两种方式都不在回复、日志或结果文件中回显真实 Key。
• 缺少密钥时，会引导用户获取并配置后重试，而不是直接报错退出。