本文档由 AI 自动翻译。如有任何不准确之处，请参考 英文原版。以下标志适用于各个
difyctl 命令。-v 和 -h 通用，-o 和 --http-retry 则大多数命令支持，但并非全部。某个命令接受哪些标志，参见该命令的 参考文档。
| 标志 | 作用 |
|---|---|
-o, --output <format> | 选择输出格式：json、yaml、name、wide 或 text。 |
-v, --verbose | 在 stderr 上开启详细诊断信息。 |
--http-retry <n> | 设置幂等请求的重试预算。 |
-h, --help | 显示命令帮助，而非执行命令。 |
标志始终跟在命令之后：
difyctl get app -o json 有效；difyctl -o json get app 会被当作未知命令。输出格式
某个命令支持五种格式中的哪几种，查看它的--help 或参考页上的标志表。重复使用该标志时，以最后一个值为准。
-o 还会改变失败信息的呈现方式：在 -o json 下，错误会以机器可读的 JSON 对象形式输出到 stderr。
各格式的结构、默认值和通道规则，详见 输出格式与退出码。
在
export studio-app 上，-o 指的是输出文件路径，而非格式选择器。详细模式
-v 会在 stderr 上增加详细的 HTTP 日志，并在错误输出中包含 raw_response 字段（即原始服务端响应，其中的 bearer token 已脱敏）。
当请求失败、而常规错误信息无法说明原因时使用它。
HTTP 重试
difyctl 会在发生瞬时故障时重试幂等请求（GET、PUT、DELETE）：包括网络错误，以及 HTTP 408、413、500、502、503 和 504 响应。POST 请求永不重试。429（触发限流）单独处理，会以退出码 7 退出，不计入此预算的重试范围。
默认预算为 3 次尝试，采用指数退避（300 ms 起，每次翻倍，上限 30 s）。使用 --http-retry 0 可禁用重试。
DIFYCTL_HTTP_RETRY 环境变量设置的是同一预算；两者同时设置时，以标志为准。