概述
dlazy-execute 是 dLazy AI 平台的核心 CLI 执行引擎，用于端到端运行扁平化的 shape 工作流列表。该工具通过解析 shape://name:<X> 引用自动计算依赖拓扑，按顺序调度每个节点调用 /api/ai/tool 完成推理任务。
核心用法
执行流程采用"状态驱动"设计：仅当 props.status === "idle" 时节点才会真正运行；其他状态（completed/failed/processing）均视为已完成，直接复用现有 props.url 作为下游输入。这一机制天然支持断点续跑——失败后将目标节点重置为 idle，可选修改 props.input，再次调用即可从失败位置恢复。
关键特性包括：
- 依赖自动注入：上游产物的 URL 自动替换到下游 input 对应字段
- prompt 引用拼接：
promptRefs引用的文本自动前置到消费者 prompt - 会话追踪：通过
--sessionId关联多次重试日志 - 异步模式：
--no-wait立即返回generateId，支持后台轮询
显著优点
1. 容错恢复机制：状态机设计让长流程故障恢复零成本
2. 云原生架构：媒体文件自动上传至 files.dlazy.com，无需本地 GPU
3. 灵活引用系统：支持 stdin 管道、@N 输出索引、JSONPath 提取等多种参数注入方式
4. 成本可控：--dry-run 预演 payload 与费用估算
潜在局限
- SaaS 依赖：核心推理完全依赖 dLazy 云端服务，离线不可用
- 版本锁定：技能元数据固定 CLI 版本为
1.2.0，可能滞后于上游更新 - 组织级计费：API key 与组织信用额度绑定，个人开发者需预充值
- 调试透明度：复杂依赖链的中间状态需通过额外 API 查询
适合人群
- 需要编排多步骤 AI 生成工作流的自动化开发者
- 追求故障可恢复、可审计的企业级 AI 集成场景
- 无本地算力、偏好 SaaS 推理模式的团队
常规风险
| 风险类型 | 说明 |
|---------|------|
| 余额耗尽 | `insufficient_balance` 错误会直接中断流程 |
| 凭证泄露 | API key 存储于 `~/.dlazy/config.json`，需确保文件权限正确 |
| 内容审核 | 云端安全策略可能拦截特定 prompt，返回 504 错误 |
| 供应商锁定 | 工作流定义与 dLazy 平台深度耦合，迁移成本较高 |
安全建议
建议通过 dlazy login 设备码流完成认证，避免手动键入 API key；生产环境应配置密钥轮换策略，并启用 --sessionId 实现执行链路追踪。