voice-batch-runner

语音批处理执行器

适用场景

• 人设、概念和脚本输入均已准备就绪，下一步是托管语音设计、克隆语音片段生成或轮询。
• 语音应作为持久的人设资产，用于多个脚本，而非一次性的音频副产品。

不适用场景

• 任务属于构思、QA 或交接部分中列出的其他已发布技能。
• 缺少必要输入，且猜测会改变结果。
• 语音策略、任务类别、翻译策略或口型同步意图尚未确定。请先使用 audio-generation。

执行边界

• 此执行器负责验证并执行标准化语音请求。不得自行决定创作策略、语音策略或参考素材策略。
• 将工作流拆分为语音配置、可选的语音身份和具体语音片段。脚本文本可以变化，人设语音的连贯性则不应改变。
• 语音设计根据 text、voice_description 和 language 生成符合初始人设的声音。
• 语音克隆用于生成新脚本片段，通过经批准的参考 audio 和可选的 reference_text 保持音色和说话风格。

来源与路径

• 请求应以当前项目的人设注册表、语音基线、脚本文本和视频用途／类别为依据。
• 优先使用当前项目／客户端文件夹；不要假定所有语音工作都以同一个客户端目录为源目录。
• 非用户可见的请求、响应和运行状态应保存在 .postplus 下。最终音频和审核文件应保存在当前语音素材文件夹中，或注明所选工作区路径。

请求边界

• 语音设计根据口述 text、自由文本 voice_description 和可选的 language（默认自动）合成个性化语音。
• 语音克隆根据口述 text、audio 参考素材、可选的 reference_text 转录文本和可选的 language 复现经批准的语音。将本地路径、HTTPS URL、现有 PostPlus 媒体引用或数据 URI 直接传给 --audio。CLI 会在单次托管提交前验证并准备本地媒体；不要预先上传素材，也不要手动构造请求。
• 字段名称、必填性和默认值请通过 postplus media schema --json 和下方生成的示例获取；不要在此处硬编码私有请求封装。

审核与交接

• 生成前，核实人设注册表、语音基线、脚本稳定性、路由（voice_design 或 voice_clone_take）、来源依据和输出路径。
• 生成后，审核真实感、人设契合度、节奏、广告式表达、复用潜力；对于克隆输出，还要检查相较参考素材的音色／口音偏移。
• 如果仍在等待，请保留结果路径，并按照返回的 CLI 操作或恢复命令继续同一操作；不要提交替代任务。到达 CLI 等待／恢复边界时停止并报告。
• 使用 postplus media-file download 保存已完成的语音片段；优先使用已完成结果中的素材引用，否则使用其输出 URL。

停止条件

• 如果缺少必要的用户意图、来源证据或自有输入材料，且猜测会改变结果，则停止。

• 批次隔离：生成一批彼此独立的项目时，针对单个项目的内容／安全拒绝仅影响该项目。仅通过类型化代码 postplus_cli_hosted_media_content_policy_blocked 识别，绝不能通过匹配错误文本来识别；它可能出现在以下任一边界：postplus media create 失败，且其类型化错误 code 为该代码；或者已提交的运行在轮询结果中携带 output.data.status: failed，且 output.data.error.code 设置为该代码。遇到任一情况，都要记录被阻止的项目及其确切原因，跳过该项目，继续提交并轮询其余项目，然后在最后报告未完成的项目。不要重试、弱化或重新提交被阻止的项目——这是禁止的载荷改写。所有其他故障（自有 CLI／脚本命令失败，且其类型化 code 不是该内容政策代码；或者运行的 error.code 不是该内容政策代码——例如身份验证、传输、配额、请求格式错误、服务中断）均属于系统性故障：按上述规则停止。

公共命令边界

• 根据用户输入，选择最匹配且最精简的命令或工作流，并直接运行。

• 就绪状态诊断：postplus doctor --skill voice-batch-runner。

• 轮询待处理的语音片段：仅当返回的操作要求如此时，使用 postplus media poll --handle <output.data.id>；遵守其等待／恢复边界。

• 仅在构造或修复未知请求格式时，使用 postplus media schema --json。

• 使用下方生成的命令运行托管提交；不要使用其他执行接口。

postplus media create voice-design \
  --text "example text" \
  --voice-description "example voice_description" \
  --wait \
  --output ./result.json

遵循 CLI 的结构化结果和报告的下一步操作；不要根据自由文本消息推断恢复方式。 需要明确的用户批准时，先等待批准；某项操作并不代表授权消费、发布或覆盖。 通过返回的检查点或操作恢复同一操作；绝不重新提交状态不确定的工作、重复已耗尽的恢复操作，或切换提供方以绕过故障。

• 如果 CLI 返回报价确认质询，在运行 postplus quote confirm --json --challenge-file <challenge.json> 并使用返回的令牌重试之前，先获取用户对其范围和费用的批准。