跳到主要内容

workspace status

workspace status 读取 CLI 登录态文件 workflow-auth.json，输出当前是否保存了 server URL、API Key、用户和过期时间，并用 effective 给出本次参数解析后命令真正会连的服务器及其来源。它不请求 SteamHarness Server，因此不能证明 API Key 仍然有效。

登录态文件和有效目标可能不是同一个服务器。解析顺序是 --server / --token → 环境变量 STEAMHARNESS_SERVER_URL / STEAMHARNESS_SERVER_ADMIN_KEY → 保存的登录 → 内置默认值：命令行参数覆盖环境变量，环境变量覆盖文件。Studio 启动的运行与内置终端会注入自己的会话，所以那里的 steamharness 连的是 Studio 当前登录的服务器，而不是这份文件里可能很旧的登录。要判断「会不会传错服务器」，看 effective 而不是 serverUrl。

命令格式​

pnpm exec steamharness workspace status

参数​

参数说明
无该命令不读取位置参数。

输出字段​

字段说明
loggedInCLI 登录态中同时存在非空 server URL 和 API Key 时为 true。
serverUrlCLI 登录态中保存的 server URL。
user最近一次 device flow 登录得到的用户摘要。
expiresAtAPI Key 过期时间。
expiringSoon距离过期不足 3 天时为 true。
source登录来源，当前为 device_flow 或 manual。
effective.serverUrl本次调用实际会使用的 server URL。
effective.serverSource该 server URL 的来源：env、flag、file 或 default。
effective.tokenSource本次调用会使用的 token 来源：env、flag、file 或 none。

示例输出​

{
  "errCode": 0,
  "errMessage": "",
  "data": {
    "loggedIn": true,
    "serverUrl": "http://localhost:7126",
    "user": {
      "userId": "user-1",
      "email": "user@example.com",
      "displayName": "Normal User"
    },
    "expiresAt": "2026-07-01T00:00:00.000Z",
    "expiringSoon": false,
    "source": "device_flow",
    "effective": {
      "serverUrl": "https://server-alpha.example.com",
      "serverSource": "env",
      "tokenSource": "env"
    }
  }
}

示例​

pnpm exec steamharness workspace status

注意事项​

场景说明
需要验证 server 可用使用 health。
需要验证 token 可用使用 login 重新验证，或执行需要鉴权的命令。
需要知道命令会连哪台服务器看 effective；serverUrl 只是保存的登录，可能已被环境变量或命令行参数覆盖。