本文档由 AI 自动翻译。如有任何不准确之处，请参考 英文原版。
环境变量为当前 Shell 会话设置默认值：会话中运行的每条 difyctl 命令都会读取它们。优先级上，命令行参数高于环境变量。环境变量的作用域限于当前 Shell，仅在会话期间有效。
difyctl 读取的变量
| 变量 | 作用 | 默认值 |
|---|
DIFY_CONFIG_DIR | difyctl 存放配置文件（hosts.yml）的位置。 | macOS 和 Linux：~/.config/difyctl（Linux 遵循 XDG_CONFIG_HOME）
Windows：%APPDATA%\difyctl |
DIFY_LIMIT | 列表命令（get app、auth devices list）的默认页大小，取值 1 到 200。优先级上，--limit 参数高于该变量。 | 20 |
DIFY_WORKSPACE_ID | difyctl 命令所针对的工作空间，必须为 UUID。解析顺序详见 difyctl 如何选择工作空间。 | 无 |
DIFYCTL_HTTP_RETRY | 幂等请求遇到瞬时故障时的重试次数（0 表示禁用重试）。--http-retry 会覆盖它。 | 3 |
2），而不会被静默忽略，例如非 UUID 的 DIFY_WORKSPACE_ID。
只有上表中的变量会影响 difyctl 的行为。env list 命令列出的其他变量虽被识别，但目前不起作用。
查看已设置的变量
env list 显示当前 Shell 中每个 difyctl 环境变量的值。它只读取本地环境，从不调用服务器，因此登录前也能使用。
| 标志 | 类型 | 默认值 | 说明 |
|---|
--json | boolean | false | 将清单以 JSON 数组而非表格形式输出。 |
<unset>，敏感变量从不输出其值（只显示 <set> 或 <unset>）。当 DIFY_LIMIT=50 已导出时：
NAME VALUE DESCRIPTION
DIFY_CONFIG_DIR <unset> Override the config-dir resolution (precedes XDG_CONFIG_HOME on Linux).
DIFY_FORMAT <unset> Default output format for list commands (table | json | yaml | wide | name).
DIFY_HOST <unset> Default Dify host (overridden by --host).
DIFY_LIMIT 50 Default page size for list commands (1..200).
DIFY_NO_PROGRESS <unset> Suppress progress spinners. Truthy values: 1, true, yes.
DIFY_PLAIN <unset> Disable ANSI colors and decorative output. Truthy values: 1, true, yes.
DIFY_TOKEN <unset> Bearer token for non-interactive auth.
DIFY_WORKSPACE_ID <unset> Workspace ID used for difyctl commands.
DIFYCTL_HTTP_RETRY <unset> HTTP retry count for GET/PUT/DELETE. 0 disables. Overrides --http-retry flag.
--json 输出一个 JSON 数组，每个变量一项，掩码方式与上面相同：
[
{
"name": "DIFY_CONFIG_DIR",
"description": "Override the config-dir resolution (precedes XDG_CONFIG_HOME on Linux).",
"sensitive": false,
"value": "<unset>"
}
]
退出码
完整方案详见 输出格式与退出码。
