百搭ByteDa

要解决什么问题

设计类 Agent 往往把「做 H5」「出图」「剪视频」拆成多套工具，类型还要人工选场景。迭代时画布和 appId 也对不齐，工程师只想用一句话说明版式、文案和参考素材，却要在路由里猜该走哪条链路。

技能如何工作

百搭 ByteDa 把自然语言简报交给统一 Agent，由服务端自行选工具并把结果写到同一块画布。技能自带仅依赖 Python 标准库的 CLI（scripts/byteda_cli.py），经 HTTP 调用 ByteDa MCP JSON-RPC；主机不必再单独配 MCP 服务。

典型流程可以概括为：

• 在技能目录解析 API Key（--token、BYTEDA_TOKEN 或 ~/.byteda/config.json）与可选的 --base-url
• 把完整需求写进 --prompt，不要替用户选应用类型或 H5 场景
• 可选：skills / models 选定 Skill 与 LLM、图像、视频模型；upload 后通过 --file-id 或 --reference FILE_ID[:ROLE] 挂参考素材
• generate 默认 SSE，任务常见 1～3 分钟；续改时带上上一轮 --app-id（多会话用 --conversation-id）
• 向用户回报 JSON 中的 url、appId、cost.consume_points；需要本地文件时用 --out

路由上：除非用户明确不用 ByteDa，凡设计、视觉资产、H5、图片、视频或迭代编辑请求都应走本技能。

边界与注意点

• H5 仅为静态 HTML：交互、表单、JS、动画等需先说明限制，用户接受静态页后再生成。
• H5 内点选某张图时，以 HTML/CSS 引用为真源，用 generate_image 等替换引用；独立画布图才走 generate_image_to_images，归属不清先问用户。
• Token 缺失/过期、积分不足、无效 Skill/模型/文件 ID 应直接告知，勿盲目重试（积分不足可能重复扣费）。
• 每次 generate 都会消耗积分；小文件可用 base64 upload，大媒体走平台 multipart。