跳转到主要内容
本文档由 AI 自动翻译。如有任何不准确之处，请参考 英文原版。
登录后，difyctl 会保存你的工作空间，并对它执行每一条命令。完整的解析顺序参见 difyctl 如何选择工作空间。 difyctl get workspace 会显示你所属的工作空间，并接受 全局标志。

​
显示工作空间

difyctl get workspace [flags]

​
标志

标志类型默认值说明
-o <format>stringnone输出格式：json、yaml、name 或 wide。省略此标志则使用默认表格。

​
示例

查看你的工作空间： 
difyctl get workspace
获取 JSON 格式，便于脚本处理： 
difyctl get workspace -o json
仅打印工作空间 ID： 
difyctl get workspace -o name

​
输出

格式stdout 输出内容
default对齐的表格。CURRENT 列以 * 标记当前激活的工作空间，ROLE 列为你的角色。
-o wide相同的列。工作空间没有仅在 wide 格式下显示的列。
-o json、-o yaml一个 workspaces 数组，每个条目包含 id、name、role、status 和 current。
-o name工作空间 ID。
默认表格： 
ID                                    NAME       ROLE    STATUS  CURRENT
b4e8d2a6-7c3f-4a1e-9d5b-8f2c6e0a4d7b  Acme Team  owner   normal  *
-o json： 
{
  "workspaces": [
    {
      "id": "b4e8d2a6-7c3f-4a1e-9d5b-8f2c6e0a4d7b",
      "name": "Acme Team",
      "role": "owner",
      "status": "normal",
      "current": true
    }
  ]
}

​
退出码

退出码含义
0成功
1网络或服务器错误
2用法错误，例如不支持的 -o 值
4认证失败
7触发限流（HTTP 429）
完整方案参见 输出格式与退出码。

​
difyctl 如何选择工作空间

应用只属于一个工作空间，因此每条命令都对某一个工作空间执行。通常就是你登录时保存的那个。difyctl 按以下顺序解析，取首个找到的值：
  1. DIFY_WORKSPACE_ID 环境变量，一个可选的覆盖项。
  2. 你存储的默认值，登录时写入配置目录下的 hosts.yml。
如果两者都未指定工作空间，命令以退出码 2 失败。 工作空间 ID 是 UUID，因此请使用 get workspace 返回的 ID，而非工作空间名称。非 UUID 的值会作为用法错误失败。
最后修改于 2026年6月25日