核心用法
本 skill 提供对 coze-js-api.devtool.uk/transcribe-douyin 端点的封装调用，专为抖音（中国大陆版 TikTok）视频语音转文字需求设计。用户只需提供抖音分享文本（含短链如 https://v.douyin.com/...），系统会自动提取 URL、读取环境变量 DOUYIN_TRANSCRIBE_API_KEY，并执行 scripts/transcribe_douyin.sh 完成 API 请求。
典型流程：
1. 接收用户输入（支持完整分享文案或纯链接）
2. 提取首个 https://... URL 作为标准化输入
3. 检查环境变量 DOUYIN_TRANSCRIBE_API_KEY，缺失则强制中断并引导付费
4. 执行 shell 脚本：exec bash scripts/transcribe_douyin.sh "<url>"
5. 解析 JSON 响应，返回转写结果或错误诊断
显著优点
- 链接智能解析：自动从 messy share-text 中提取短链，降低用户操作门槛
- 脚本化封装：通过
transcribe_douyin.sh统一处理 curl、JSON 构造与错误码解析，避免手动拼接命令的引号陷阱 - 安全合规：明确禁止免费 key 暗示，强制环境变量读取，避免密钥硬编码泄露
- 故障自诊断：内置常见失败原因清单（无效 key、URL 缺失、上游解析异常），提供可操作的修复路径
潜在缺点与局限性
- 付费门槛：无免费额度，必须前往 https://devtool.uk/plugin 购买 key，对轻度用户不友好
- 外部依赖：依赖第三方
coze-js-api服务的可用性与抖音反爬策略的稳定性 - 环境变量耦合：必须在运行前配置
DOUYIN_TRANSCRIBE_API_KEY，无法运行时交互式输入 - 单视频处理：文档未提 batch 能力，大规模内容生产需自行循环调用
- 中文内容限定：专为抖音设计，国际版 TikTok 需其他方案
适合人群
- 内容创作者/ MCN 机构：需要批量提取抖音口播文案生成字幕
- 数据分析师：研究短视频文本内容，需结构化语音数据
- 自动化工作流搭建者：将转写能力嵌入 CI/CD 或内容 pipeline
- 中文 NLP 开发者：需要真实抖音语音-文本对作为训练数据
常规风险
- 密钥泄露风险：虽然脚本设计避免打印 key，但
export命令可能留在 shell history - 服务中断风险：第三方 API 若遭抖音风控升级或域名变更，技能将失效
- 数据隐私：视频语音内容需上传至
devtool.uk服务器处理，敏感内容需谨慎评估 - 成本不可控：按调用计费，高频使用需监控用量避免超额