CLI
管道
在下一个工具的 flag 里直接引用上游 stdout 的值。
任何 flag 都可以从上一段 stdout 取值。引用在调用 API 之前解析完成，因此串联工具时不需要在 shell 里解析 JSON。
引用语法
| Token | 含义 |
|---|---|
- | 自动 —— 标量 flag 取第一个 output 的 primary value，数组 flag 取所有 outputs 的 primary values |
@<n> | 第 n 个 output 的 primary value（@0 = 第一个） |
@<n>.<path> | 第 n 个 output 内部的 jsonpath（如 @0.url、@1.meta.fps、@0.text） |
@* | 所有 outputs 的 primary value 组成的数组 |
@stdin | 完整的上游信封 |
@stdin:<path> | 整个信封内部的 jsonpath（如 @stdin:result.usage.creditsCost） |
primary value 的定义：媒体取 url、文本取 text、JSON 取 value。引用解析逻辑见 packages/cli/src/lib/refs.ts。
示例
# 1) 单图 → 视频，自动取 URL
dlazy gpt-image-2 --prompt "侦探侧脸" \
| dlazy veo-3.1 --firstFrame - --prompt "雨夜推镜头"
# 2) 从 4 张批量结果里取第二张
dlazy gpt-image-2 --prompt "霓虹小巷" --batch 4 \
| dlazy veo-3.1 --firstFrame @1.url --prompt "缓慢推近"
# 3) 数组 flag —— 把上游 URL 列表展开到下游数组里
dlazy gpt-image-2 --prompt "..." --batch 4 \
| dlazy image-replicate --images -不调 API 验证引用
任意工具加 --dry-run 即可只打印解析后的入参，不消耗积分也不发网络请求 —— 调试 @stdin:... 路径很合适。
dlazy gpt-image-2 --prompt "..." --dry-run