视频号挂车爆单短视频脚本生成

解决什么问题

在微信视频号进行商品推广时，创作者需要频繁产出短视频脚本，尤其是结合商品链接的“挂车”视频。手动撰写脚本不仅耗时，还难以保证内容能捕捉到平台爆款的规律，导致转化效果不稳定。该技能通过自动化方式生成高质量脚本，降低内容创作门槛，专注于提升视频脚本的相关性和吸引力。

核心能力与工作流程

鉴权与环境准备

技能调用远端付费 API，需要有效的 API Key 进行鉴权。Key 优先从 config.json 的 LY_API_KEY 字段读取，若无则回退到环境变量 LY_API_KEY。如果遇到 SSL 证书验证错误，可设置 LY_SKIP_SSL_VERIFY=1 环境变量临时绕过，但请注意中间人攻击风险。鉴权失败时，需重新获取 Key 并更新配置。

信息收集与参数映射

生成脚本前需收集必要参数，技能采用两步流程确保用户友好：

1. 拉取配置选项：先调用 API 获取所有枚举字段的可选值，以中文标签形式向用户展示，例如创作方向的「达人带货」或「品牌账号」。
2. 用户选择与映射：用户选择后，将中文标签映射回英文 value 传给后端，避免 400 错误。关键参数包括：

- mode：创作模式，支持 creation（原创）和 recreation（二创）。
- direction：创作方向，如达人带货、IP账号等。
- industry 和 purpose：行业与营销目的，至少填一个。
- platform：默认 channels（视频号）。
- product：创作模式下，当方向为达人带货时必填，需提供包含商品名称、价格、卖点和目标用户的对象。
- source_video：二创模式下必填，必须是微信视频号的分享链接，通过 --share-url 传入。

任务创建与轮询

脚本 generate_script.py 负责完整流程：

• 组装请求体，注入 origin 和 origin_method 标识，自动校验参数合规性。
• 发送 POST 请求创建任务，获取 script_task_id，并启动轮询监控状态。
• 按固定间隔轮询，检查 data.status 字段（如 completed 或 failed），进度输出到标准错误流，最新响应实时保存到 JSON 文件以防超时丢失。

结果交付与计费

任务完成后，脚本 render_report.py 解析响应中的 data.result.markdown 字段，生成 Markdown 报告。交付时：

• 显示实际扣点，从标准输出的 ===POINTS_USED=== 标记块提取，若为空则以账户记录为准。
• 提供报告文件路径（===MD_PATH===）和正文预览（===OVERVIEW_MD===），建议直接打开 Markdown 文件查看完整内容。
• 失败时统一返回点数，并提示可通过 --task-id 参数续传已创建的任务，避免重复计费；例如超时或任务失败均按网络原因安抚用户。

适用边界与注意点

• 二创源限制：仅支持微信视频号的分享链接，不接受本地视频文件上传，用户需提供有效的 share_url。
• 付费模型：每次任务消耗 API 点数，预估约 98 点，实际以账户扣点为准。创建任务前必须向用户确认预估点数，并在成功或失败后回执实际扣点。
• 参数严格性：枚举值必须使用英文 value（如 direction 的 influencer），后端拒绝中文标签。校验失败时会以中文标签（英文 value）形式提示合法值。
• 错误处理：根据退出码采取不同策略，例如退出码 8 表示 Key 无效需重新获取，退出码 5 表示超时可续传。统一话术避免向用户透传后端错误细节。
• 报告原样输出：最终 Markdown 报告直接来自后端响应，不应手动修改内容；如需调整，应修改输入参数（如 account_brief 或 additional_requirements）重新生成任务。