用途:用于对 WordPress.com 转写(transcription)端点进行直接冒烟测试,面向 WordPress Workspace。
主要能力:使用已有脚本 Tools/wpcom-transcribe.sh 调用端点 POST /wpcom/v2/sites/{site}/ai/transcription。支持听写模式与命令模式(--intent command --selected-text "Rewrite this."),可用 --envelope 调试 REST 代理,用 --verbose 及可选 --proxy <url> 做网络调试,用 --app-context '<json>' 传自定义上下文。
使用方式:脚本仅依赖 POSIX shell 与 curl,不要额外引入 jq、Python、本地 OAuth 流程或其他依赖,除非用户明确要求。需提供 bearer token 或 auth 头、站点 ID 或域名、音频文件。示例:WPCOM_BEARER_TOKEN="$TOKEN" Tools/wpcom-transcribe.sh --site 123456 --file ./sample.mp3。切勿打印令牌值,优先用环境变量或脱敏示例。
适用场景:听写与选中文本命令模式共用同一站点级端点;所选站点可能提供 slug 为 transcribe 的服务端 wp_guideline 技能,使已连接应用共享拼写、清理与风格规则;端点首次使用可能创建 Transcription guideline 技能;保存产物由应用请求中的 save_artifact 字段控制,应在所选站点创建 WordPress Guideline 产物。
限制与排查:失败应按层排查,包括本地文件与 MIME 检测、auth 头或 token 权限范围、站点 ID 或域名及所选站点权限、端点响应体与 HTTP 状态、代理或超时或 WordPress.com API 可用性。具体收费、价格与效果暂未提供。