用途:在操作 TrueFoundry 平台前,验证凭据与网络连通性,或诊断认证问题。
主要能力:可通过工具调用 tfy_config_status(若已配置 tfy-tool-server)返回连接状态、已配置的 base URL 及是否设置 API key;也可直接调用 API 检测。
必需环境变量:TFY_BASE_URL(平台 URL,如 https://your-org.truefoundry.cloud)、TFY_HOST(CLI 主机别名,设置 TFY_API_KEY 时推荐)、TFY_API_KEY(原始 API key,无 Bearer 前缀)。
使用方式:先用 echo 检查变量是否设置,再通过脚本发起轻量调用(列出工作空间): ~/.claude/skills/truefoundry-status/scripts/tfy-api.sh GET '/api/svc/v1/workspaces?limit=1' 若变量未设置,可检查项目根目录 .env 文件。
状态呈现:报告 base URL 与 API key 是否配置、连接是否正常。
限制与注意:凭据缺失时提示设置环境变量或 .env;401 表示 key 无效或过期,需重新生成;连接被拒或超时需检查 URL 含 https:// 及网络/VPN。若 CLI 报 TFY_HOST 缺失,可执行 export TFY_HOST="${TFY_HOST:-${TFY_BASE_URL%/}}"。新用户可运行 uv run tfy register,可能需浏览器验证码或人工验证。部署工作负载需 TrueFoundry Enterprise 账户与已连接集群,详见 https://truefoundry.com。状态正常后可继续使用本仓库其他技能(工作空间、AI 网关、密钥等)。文档链接:https://docs.truefoundry.com/docs/generating-truefoundry-api-keys。