核心用法
dlazy-plan 是 dLazy 官方提供的命令行视频规划工具，面向 CLI 用户与外部智能体。用户通过自然语言描述视频创意（--prompt），工具会驱动内部 Agent 返回两份关键输出：一份带 map/when 控制结构的逻辑规划模板，以及一份已展开的扁平化节点列表，后者可直接通过 drawToCanvas 落位到画布。
主要工作流：
1. 身份认证：运行 dlazy login 完成设备码授权，自动保存 API key；或手动 dlazy auth set <key>。
2. 发起规划：dlazy plan --prompt "你的视频创意" --scenario [场景] --style [风格]。
3. 获取结果：同步等待返回完整规划 JSON；若加 --no-wait 则返回 generateId，后续用 dlazy status --wait 轮询。
4. 解析输出：result.outputs 包含可直接渲染的 shape 节点，支持通过引用语法（-、@N、@* 等）与上游工具链串联。
显著优点
- 官方背书：源码托管于
github.com/dlazyai/cli，npm 包@dlazy/cli版本锁定，供应链可追溯。 - Agent 原生：专为外部智能体设计，输出格式标准化（含完整错误码表），便于自动化集成。
- 灵活场景：内置 9 种规划场景（
idea2video、storyboard、music_video等）与 10 种视觉风格枚举，覆盖从概念到分镜的全流程。 - 管道友好：支持 stdin 引用与 JSONPath 提取，可嵌入复杂工作流。
- 异步友好：支持
--no-wait异步模式与超时控制，适合长时任务。
潜在缺点与局限性
- 强依赖云服务：所有推理与媒体上传均走
api.dlazy.com/files.dlazy.com，无离线能力，网络波动或服务端故障会直接导致失败。 - 计费门槛：需预购 dLazy 平台 credits，余额不足（
insufficient_balance）时任务中断，且错误处理需人工介入充值。 - 闭源模型：核心规划模型为 dLazy 私有，无法本地微调或审计推理过程。
- 权限敏感：API key 存储于本地
~/.dlazy/config.json，虽限制 OS 用户权限，但在多用户环境或 CI 中仍需额外注意密钥隔离。 - 版本漂移风险：技能元数据声明
1.2.0，但文档中仍出现1.0.9、1.1.2等版本号，需确认实际安装的 CLI 版本与技能期望一致。
适合人群
- 需要将自然语言创意快速转化为结构化视频规划的内容创作者、分镜师、广告策划；
- 正在构建自动化视频生产管线（AIGC workflow）的开发者或 MLOps 工程师；
- 已在使用 dLazy 生态、希望通过 CLI 批量触发规划任务的高级用户。
常规风险
| 风险类别 | 说明 |
|---------|------|
| **供应链** | npm 包与 GitHub 源由单一组织维护，虽为官方渠道，但需关注版本签名与 lockfile 完整性。 |
| **数据隐私** | 本地媒体文件需上传至 `files.dlazy.com`，敏感素材需评估云存储合规性。 |
| **账号安全** | API key 泄露可能导致 credits 被盗刷，建议定期轮换（支持 dashboard 一键 revoke）。 |
| **服务可用性** | 依赖 dLazy SaaS 稳定性，建议对关键任务实现异步轮询与失败重试机制。 |
| **内容安全** | 后端可能因提示词触发安全策略而拒绝服务（`Prompt violates safety policy`），需预留人工审核节点。 |