核心用法
dlazy-start 是面向 AI 编排器（Claude Code、Cursor、Codex、Copilot 等）的 @dlazy/cli 快速上手指南。该技能通过结构化分阶段教学，使 AI Agent 能够驱动 CLI 完成从安装认证到复杂多媒体工具链编排的完整流程。
关键操作路径：
- Phase 0 安装认证：
npm install -g @dlazy/cli+dlazy auth login（设备码流，支持远程 shell），配置位于~/.dlazy/config.json - Phase 1 能力发现：
dlazy tools list枚举 80+ 工具（云端 40+：Seedream、Veo、Kling、ElevenLabs 等；本地 40+：video_compose、audio_mixer、transcribe 等），dlazy tools describe <name>获取输入输出 JSON Schema 与成本形态 - Phase 2 工具调用：支持
--input @file.json文件模式、--output json机器可读输出、--dry-run预验证零成本测试 - Phase 3 异步轮询：云端长时任务返回
generateId，通过dlazy status <id>轮询至succeeded/failed - Phase 4 故障恢复：覆盖 Remotion 安装失败、YouTube 反爬虫、渲染运行时切换等 6 类典型场景
显著优点
1. 零状态设计：CLI 本身无项目工作区或流水线状态机，完全由 Agent 端控制编排逻辑，灵活性极高
2. 统一接口抽象：云端 API 与本地 FFmpeg/Remotion 工具共享同一套 dlazy <tool> 调用范式
3. 成本透明化：hasCosts 字段前置暴露，支持调用前审计日志记录
4. 多模态覆盖：图像/视频/音频/文本生成与后处理工具链一站式集成
5. 防御性设计：DLAZY_DISABLED_TOOLS 环境变量可沙箱化限制工具面，误调用返回结构化 tool_disabled 错误
潜在局限
- 无内置编排语义：复杂流水线（如条件分支、重试策略）需 Agent 自行实现
- 本地运行时依赖：Remotion、yt-dlp 等需额外
dlazy doctor --install， corporate 代理环境需手动配置 npm 代理 - 云服务商锁定：核心云端工具依赖 dlazy.com 基础设施，API 端点不可自定义至其他提供商
- AGPL 传染性：CLI 采用 AGPL-3.0-or-later 协议，衍生集成需合规处理开源义务
适合人群
- 需批量/程序化驱动 AIGC 工具链的开发者与自动化工程师
- 构建视频/音频合成流水线的 AI Agent 编排场景
- 希望统一云端生成与本地 FFmpeg 后处理的技术团队
常规风险
| 风险类别 | 具体表现 | 缓解措施 |
|---------|---------|---------|
| 成本失控 | 云端生成为按调用计费，批量误操作可能导致高额账单 | 强制 `--dry-run` 验证 + 前置 `hasCosts` 审计 |
| 异步任务悬停 | `generateId` 轮询中断导致资源泄漏 | Agent 侧实现指数退避重试 + 超时熔断 |
| 本地运行时污染 | `dlazy doctor --install` 修改全局 npm 包 | 隔离至容器化环境或使用 `npx` 免安装模式 |
| 反爬虫封禁 | YouTube 下载触发人机验证 | 传入 `cookies_from_browser` 参数复用已登录会话 |
| Schema 漂移 | 工具注册表动态更新，硬编码字段可能失效 | 每次会话启动时重新执行 `dlazy tools list` 发现 |