用途:作为 TrueFoundry 平台操作前的预检(preflight check),核验连接与凭据是否可用,并诊断为认证问题。不适用于列出工作区、部署负载或查看运行中的应用等具体操作;这些需要其他技能或 TrueFoundry 企业账户与已连接集群。
所需环境变量:TFY_BASE_URL(平台 URL,如 https://your-org.truefoundry.cloud)、TFY_HOST(CLI 主机别名,设置 TFY_API_KEY 供 CLI 使用时推荐)、TFY_API_KEY(原始 API key,无 Bearer 前缀)。
检查方式:若配置了 tfy-tool-server,可调用 tfy_config_status,返回连接状态、已配置的 base URL 及 API key 是否设置;也可通过直接 API 检查环境变量并发起轻量请求(GET '/api/svc/v1/workspaces?limit=1'),需将此技能 scripts/tfy-api.sh 的完整路径设为 TFY_API_SH;或在未设置环境变量时检查项目根目录的 .env 文件。
状态输出示例:Base URL、API Key 是否配置、连接是否正常(如列出 1 个工作区);若缺失则提示设置 TFY_BASE_URL 和 TFY_API_KEY。新用户可运行 uv run tfy register,该流程可能弹出浏览器进行 CAPTCHA 或人工验证,之后完成邮箱验证并获取 API key。
错误处理:401 表示 key 无效或过期,需重新生成;连接被拒或超时需确认 URL(含 https://)与网络/VPN;缺少变量需通过环境变量或 .env 设置。若 CLI 报 TFY_HOST 缺失,可运行 export TFY_HOST="${TFY_HOST:-${TFY_BASE_URL%/}}"。凭据可通过导出环境变量、创建 .env 或使用 tfy_config_set 持久化。
限制:具体端点、返回字段与工具名称以实际配置为准;未提供的信息此处不展开。