Twitch 语音片段技能

通过 Twitch 片段 API 创建直播流最后 30–60 秒的视频片段。为防止误操作频繁截图，设有 30 秒冷却时间。

设置

1. 创建 Twitch 应用

1. 访问 https://dev.twitch.tv/console/apps
2. 注册新应用（OAuth 重定向 URL：http://localhost，类别：其他）
3. 复制你的 Client ID 并生成 Client Secret

2. 获取 OAuth 令牌

在浏览器中访问以下链接（将 YOUR_CLIENT_ID 替换为你的 Client ID）：

https://id.twitch.tv/oauth2/authorize?client_id=YOUR_CLIENT_ID&redirect_uri=http://localhost&response_type=token&scope=clips:edit

从跳转后的 URL 中复制 access_token。

3. 设置环境变量

export TWITCH_CLIENT_ID="your_client_id"
export TWITCH_ACCESS_TOKEN="your_access_token"
export TWITCH_BROADCASTER_ID="your_broadcaster_id"  # 数值型用户 ID

获取主播 ID 的方法：

curl -s -H "Authorization: Bearer $TWITCH_ACCESS_TOKEN" \
  -H "Client-Id: $TWITCH_CLIENT_ID" \
  https://api.twitch.tv/helix/users | python3 -c "import json,sys; print(json.load(sys.stdin)['data'][0]['id'])"

使用方法

运行片段创建脚本：

bash scripts/create_clip.sh [duration_seconds]

• 默认持续时间为 30 秒，最大支持 60 秒
• 直播必须处于进行中状态，否则 API 返回 404 错误

冷却机制

两次片段请求之间强制执行 30 秒冷却。若在冷却期间发起请求：

• 脚本以退出码 2 结束，并输出剩余等待时间
• 回复内容：⏳ 冷却中 — 请在 X 秒后重试
• 不要自动重试 — 等待下一次明确的片段请求

触发短语

• “截取这个”
• “截取最近 X 秒”
• “生成一个片段”
• “截一下”

响应格式

成功：

已截取！ 🎬 https://clips.twitch.tv/<clip_id>

冷却中：

⏳ 冷却中 — 请在 X 秒后重试

未直播：

直播已结束 — 当前无法截取

令牌刷新

令牌会过期。若收到 401 错误，请使用设置步骤 2 中的链接重新授权。