小魔推拍菜单组品

商家组品流程中的痛点

商家在处理拍菜单 AI 组品时，常面临流程繁琐、Token 管理复杂、结果交付不直观等问题。手动操作不仅耗时，还容易因 Token 失效或图片格式错误导致失败。特别是菜单图片必须为公网 URL，本地文件需额外上传步骤，增加了操作成本。

技能如何简化流程

本技能通过自动化流程解决上述问题：

• 验证码登录与 Token 持久化：首次使用通过 send-code → login 获取 Token，后续复用，避免重复认证。
• 流式查看器与标准产物：serve 命令启动后，生成 viewer.html 流式展示组品进度，最终输出 result.json 和命名规范的静态 HTML（如 郑州市_川菜_团购_20260707_165950.html），便于直接交付或复用。
• 两种组品模式：流式模式（serve）适合需要实时查看的场景；直接组品（group-package）适用于仅需结构化结果的情况。

关键步骤包括：

1. 准备菜单图片公网 URL（本地文件需先部署到 CloudStudio）。
2. 执行 serve 启动流式组品，通过 LOCAL_VIEWER_PATH 展示查看器。
3. 等待 STATIC_HTML_PATH 输出，直接交付或读取 result.json 复用。

适用边界与注意事项

• 图片要求：仅支持 HTTP(S) 公网 URL，多张图片需多次传入 --image-url。
• Token 失效处理：接口返回 401 时，无需检查本地 Token 文件，直接重新 send-code → login。
• 禁止修改技能本体：运行期间仅允许更新本地 .token 和生成 --output-dir 下的运行产物，不得修改脚本、配置或模板。
• 结果定位：若结果丢失，优先检查 STATIC_HTML_PATH 指向的 HTML，再查看 runs/<run_id>/ 目录的 state.json 和 result.json。