视频号口播种草脚本生成器

解决的问题

微信视频号运营中，口播种草脚本是推广产品或内容的常见形式。手动编写此类脚本耗时且缺乏结构化支持，尤其当需要基于热门视频进行二次创作时，流程更为繁琐。该技能针对这一痛点，通过远端付费 API 实现自动化生成，覆盖从零创作到迭代改写的需求。

如何工作

技能的核心能力分为 创作 和 二创 两种模式：

• 创作模式：根据用户指定的参数（如方向、行业、营销目的），从零生成口播种草脚本。支持枚举字段的中文展示与英文映射，确保参数合规。
• 二创模式：以微信视频号分享链接为骨架，改写生成新脚本。仅支持通过 --share-url 传入链接，不处理本地文件。

关键步骤包括：

1. 鉴权：从技能目录下的 config.json 读取 LY_API_KEY，或回退至环境变量。请求头使用裸 key（不带 Bearer）。若缺失，引导用户前往指定页面获取并写入配置。
2. 信息收集：采用两步流程：先拉取配置选项（如 mode、direction 等枚举值），以中文标签向用户展示；用户选择后，映射回英文 value 传给后端。脚本类型固定为 oral_seeding，无需用户选择。
3. 任务创建与轮询：组装请求体（自动注入埋点参数），调用远端 API 创建任务。通过 --poll-interval 轮询状态（如 running、completed），中间结果落盘到响应文件。
4. 结果交付：任务完成后，解析响应中的 data.result.markdown 字段，原样输出为 Markdown 报告。交付时回执实际扣点（通过 ===POINTS_USED=== 标记块），并提示报告路径。

适用边界与注意点

• 二创限制：仅支持微信视频号分享链接，不支持本地视频上传。用户提供的链接必须通过 --share-url 原样传入，不要索要或猜测 video_id。
• 计费模型：每个任务扣点，预估约 98 点（仅提示值，实际以账户记录为准）。任务失败时点数已返还，支持 --task-id 续传同一任务，避免重复计费。
• 参数校验：枚举字段必须使用英文 value 传后端，中文标签仅用于用户展示；传中文会导致 400 错误。脚本类型固定为 oral_seeding，不可覆盖。
• 错误处理：有明确退出码（如码 8 为鉴权失败、码 5 为轮询超时）。统一用网络原因安抚用户，引导重试或续传，不透传后端错误细节。
• 配置依赖：依赖远端 API 可用性。若配置接口失败，可使用 --skip-config 跳过枚举校验，但需用户自行承担风险。