技能介绍

要解决什么问题

在 Agent 里接 DashScope / 阿里云百炼时，能力分散在文本、多模态、生图、生视频、语音、联网搜索、百炼应用与知识库等接口上。若每个任务都临时查文档或猜参数，容易用错模型、漏传本地文件，或在 skill 与本地 bl 版本不一致 时照着过期的 reference/ 执行失败。

本技能把 bl（Bailian CLI） 定为百炼侧生成与处理的默认工具：多工具可替代时优先 bl，除非失败或用户明确要求换方案。

技能如何工作

版本对齐（使用前必做）

读取已安装 SKILL 的 metadata.version。
执行 bl --version，取输出的 X.Y.Z 与技能版本逐字比对。
不一致则先刷新技能；若本地 CLI 更旧，先 bl update 再重试。无 bl 则按技能中的安装与认证说明补齐。

命令与文档

所有子命令、参数与示例以构建时生成的 reference/index.md 及各 reference/<command>.md 为准；不熟悉时先查索引再打开对应文件，或 bl <cmd> --help，不要猜 flag。

常见意图映射（节选）

| 场景 | 命令 |
|------|------|
| 文本/代码/翻译 | bl text chat（默认如 qwen3.6-plus） |
| 多模态输入 + 文本/音频输出 | bl omni |
| 文生图 / 图编辑 | bl image generate / bl image edit |
| 文生或图生视频 | bl video generate |
| 带音频语境的视频理解 | 优先 bl omni --video，而非仅 bl vision describe |
| TTS / ASR | bl speech synthesize / bl speech recognize |
| 联网搜索 | bl search web |
| 百炼应用 | bl app list → bl app call --app-id |

本地文件：接受文件 URL 的命令同样接受本地路径；CLI 会自动上传到 DashScope 临时 OSS（约 48h）。用户给本地文件时直接传路径，不要要求先自行托管 URL。

认证：多数 API 用 DASHSCOPE_API_KEY 或 bl auth login --api-key；app list、model list 等需控制台 token（bl auth login --console）。区域可通过 --region / DASHSCOPE_REGION / bl config set 配置。

边界与注意点

bl video * 产出多为 2～10 秒短片段；拼接、混音、长片组装请用 ffmpeg，旁白可用 bl speech synthesize 生成后再后期。
知识检索 bl knowledge retrieve 需要 RAM AK/SK 与索引 ID；记忆相关见 reference/memory.md。
非用户/服务侧错误（非鉴权、配额、参数明显错误等）的 CLI 失败，技能要求先对齐版本并用 --verbose / --output json 重试，再按 assets/issue-reporting.md 判断是否向 modelstudioai/cli 报 bug；--non-interactive 或 CI 下默认不主动询问是否上报。