zenstory-ai/video-recap-skills / skills/video-recap
video-recap
Verified把一段或多集视频做成带画框字幕的中文解说成片或纯原声高光短片。用户提供 .mp4 / .mov / .mkv / .webm,要求做影视解说、短剧二创、加旁白配音、跨集混剪或导出剪映草稿时使用;串联完成看片识台词、定主线与留原声、按台词停顿切镜头、写词检查、TTS 配音与混音加字幕。触发词:视频解说、影视解说、视频旁白、生成解说、视频 recap、video recap、voiceover、narration、recap。
references/index-tts.md
View on GitHub# 自托管 IndexTTS 端点
通过 `--tts-provider index-tts` 或 `TTS_PROVIDER=index-tts` 显式启用用户自行部署的 IndexTTS 协议服务(输入 JSON,返回 WAV)。`auto` 模式不会自动切换到该服务。
## 环境变量配置
```bash
export TTS_PROVIDER=index-tts
export INDEX_TTS_ENDPOINT=http://127.0.0.1:<port>/tts
export INDEX_TTS_VOICE=<authorized-voice-name>
```
- 缺少 `INDEX_TTS_ENDPOINT` 或 `INDEX_TTS_VOICE` 时,程序会在查缓存与发请求前直接报错退出。
- `INDEX_TTS_ENDPOINT` 只接受不带用户名密码(userinfo)、查询参数(query)或锚点(fragment)的 `http://` 或 `https://` 地址,且请求全程禁止 HTTP 重定向,防止已定稿的旁白文本被意外转发到第三方主机。
- 该路径不接受 `--voice-ref`、`--mimo-tts-voice` 或 `--mimo-voice`。
## 请求体契约
请求体固定为 `{"voice": voice, "text": spoken_text}`。若 `narration.json` 段落里带有可选的 `emotion` 字段、额外风格参数或非默认的语速/音高设置,程序会直接报错退出,不会悄悄忽略这些参数继续合成。服务端按自身默认语速生成原始音频,不根据标点、字数或段落位置自动调整语速;原始合成阶段不调速,下游合成阶段仍会按 `NARRATION_SPEED` 与可用时间窗在允许倍率内微调语速。
## 回执与缓存复用
每段合成后都会在 `provider_receipt` 中记录本次调用的 `provider` 与请求的音色名 `requested_voice`(仅标识请求目标音色名,服务端本身不向本地工作目录写入文件)。
命中本地缓存需同时满足三个条件:`tts_segments/cache/` 下存在按朗读正文与配置(含 `index_tts_voice`)算出的缓存项、缓存 WAV 的 `{size, mtime_ns}` 未变、同目录配套回执文件记录的音色与当前请求的 `INDEX_TTS_VOICE` 一致。命中缓存时直接沿用配套回执里保存的原始记录,不会临时拼造新回执。由于客户端无法感知自托管服务端背后的模型权重或部署变更,一旦在服务端更换了声线实现,请手动清空 `tts_segments/cache/` 强制重新合成。
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |