difyctl 持有一个受限会话,代表你在公司 Dify 主机上的企业身份。它只携带管理员授予你的访问权限。
你能做什么
- 查看你有权运行的应用。
difyctl get app列出管理员允许你访问的应用,而非主机上的全部应用。 - 检视应用的输入。
describe app显示已授权应用的类型及其期望的输入,便于你构造正确的调用。 - 运行已授权的应用。
run app会调用该应用并打印响应,与账户用户的方式相同。 - 恢复已暂停的工作流。 当你运行的工作流 暂停以等待人工输入 时,
resume app可让其继续。 - 本地操作。
auth whoami、version和help无需任何特殊权限。
你不能做什么
运行授予你的应用是会话的全部权限范围。difyctl 的其余功能均无法触及:
- 无工作空间。 外部 SSO 会话不与任何工作空间绑定,因此
get workspace和use workspace不适用,--workspace标志同样如此。 - 无法浏览已授权应用之外的内容。
get app仅返回管理员授予的应用,-A(所有工作空间)不适用。你无法列出或访问主机上的其他应用。 - 无法导出或导入应用。
- 无法管理工作空间或成员。
权限错误的呈现方式
当你尝试超出权限范围的操作时,服务器会以 HTTP 403 拒绝,difyctl 将其报告为 server_4xx_other 错误,退出码为 1。
这与登录被拒绝不同:access_denied(退出码 4)指授权本身在浏览器步骤中被拒,而非某条命令超出了权限范围。完整方案详见 输出格式与退出码。