口播视频自动剪辑 · 本地免费体检 / 云端一键出片

它解决什么

🎯 人脸禁区探测

先算出人脸所在的安全区，再反推哪些带状区域可以放卡片。放不下就如实报"需复核"，不硬塞。

✂️ 智能断句

按词边界切分，不把词切断。输出可直接喂给剪辑工具的分段结果。

🔊 音频验收

削波、增益、时序三项体检，音画不同步当场抓出来，而不是等成片才发现。

🖼️ 构图与 PIP

卡片矩形是否遮挡人脸禁区、PIP 落位与覆盖、字幕轴向同步，一次验完。

免费 vs 付费

能力	本地体检（开源，免费）	云端出片（Pay Skill）
人脸禁区 / 断句 / 构图 / 音画	✅ 查出来	✅ 查出来并自动避让布点
产出"编辑剧本"	✅ 预览	✅ 预览 + 渲染成片
出片渲染	❌ 需自备剪辑工具	✅ 前 3 条免费，之后 ¥2.90/条
视频是否离开本机	✅ 完全不出本机	☁️ 仅出片环节上云

体检结果可以直接喂给云端出片

本地跑完的人脸禁区、分段、验收清单，正是云端排版所需的输入——不用重跑一遍。两条入口同源：同一收款主体、同一计费口径、额度共享。

🎬 云端出片 · 前 3 条免费对比看细节

接 MCP 端点（给开发者 / 智能体）

云端出片能力同时以标准 MCP（Model Context Protocol） 服务暴露，任何支持自定义 MCP 的客户端（Claude Code / Cursor / Cline / Glama 等）都能直接调用。

端点: https://www.qianshi.cool/thapi/mcp（Streamable HTTP + JSON-RPC 2.0）
鉴权: Authorization: Bearer <平台颁发的 API Key>
工具: generate_recut_plan → render_recut_video → get_recut_job
计费: 按次计费，前 3 条免费，与 SkillHub 付费链路同源

连接示例（.mcp.json）：

{
  "mcpServers": {
    "th-recut": {
      "type": "http",
      "url": "https://www.qianshi.cool/thapi/mcp",
      "headers": { "Authorization": "Bearer ${TH_RECUT_API_KEY}" }
    }
  }
}

已被收录于 MCP 官方 Registry （cool.qianshi/th-recut-mcp v1.0.0，status active）与 Glama 连接器（rated B，endpoint responding）。

本地跑起来

装依赖：Python 3.8+ 与 ffmpeg（需在 PATH 中）。numpy / opencv / jieba 为可选依赖，缺了仅相关脚本不可用。
体检：python scripts/doctor.py --video your.mp4，一次性汇总构图 + 音频。
按需单项：detect_faces.py / split_sentences.py / check_card_layout.py / check_pip.py 等，每个都支持 --help。

关于合规：本仓库以 CC BY-NC 4.0 发布，禁止商用。商用请走云端出片付费链路，或联系作者（105920869@qq.com · 千视科技（深圳）有限公司）。