用途:把用户带到单一的稳定状态——拥有 TrueFoundry 租户 URL、安装好 TrueFoundry CLI、完成 tfy login --host <tenant-url>,使其他 TrueFoundry 技能可针对该租户运行。完成 CLI 登录验证后即停止,运维配置属于其他 TrueFoundry 技能。
主要能力与用法:
- 检查 CLI:运行 tfy --version 2>/dev/null;失败则用 pip install 'truefoundry==0.5.0' 安装,若没有 pip 而有 uv,则用 uv tool install --python 3.12 'truefoundry==0.5.0',再重跑 tfy --version。
- 检查已有登录:读取 ~/.truefoundry/credentials.json,若同时有 host 与 access_token 或 refresh_token,则打印 tfy login: ok 并停止并告知租户主机。
- 缺少登录时获取租户 URL:提示用户到 https://www.truefoundry.com/register 注册并完成 onboarding 后粘贴租户 URL(如 https://acme.truefoundry.cloud);新租户仅用浏览器注册。
- 登录:让用户执行 tfy login --host "<tenant-url>",该命令可能打开浏览器,等待用户确认成功。
- 验证:再次执行第 2 步的凭据检查;打印 ok 即完成,否则让用户重跑登录并粘贴完整错误信息。
限制与注意:不要猜测常见状态或配置命令,tfy whoami、tfy show-config、tfy status、tfy config ... 对该 CLI 无效。登录成功后不要探测验证命令、不要重新抓取 README 或文档,唯一有效验证是上述 credentials.json 检查。通过 tfy-api.sh 直接调用 REST 辅助可能仍需 TFY_API_KEY;除非确认已设置,否则不要声称存在单独 API 密钥。若安装后找不到 CLI,请用户打开新终端或把 CLI 安装路径加入 PATH。登录打开浏览器但未完成时,让用户重试 tfy login --host "<tenant-url>" 并收集确切错误。租户错误时用正确租户重跑登录。成功标准:用户有租户 URL、tfy --version 可用、~/.truefoundry/credentials.json 含 host 及 access 或 refresh token,且除 CLI 登录外不配置任何内容。资料未提供定价、平台支持范围等信息。