> ## Documentation Index
> Fetch the complete documentation index at: https://claw-tw.jackle.pro/llms.txt
> Use this file to discover all available pages before exploring further.

# Auth credential semantics

# Auth Credential Semantics（驗證憑證語義）

本文定義在以下範圍使用的正式憑證資格與解析語義：

* `resolveAuthProfileOrder`
* `resolveApiKeyForProfile`
* `models status --probe`
* `doctor-auth`

目標是保持選擇時和執行階段行為的一致性。

## 穩定原因代碼

* `ok`
* `missing_credential`
* `invalid_expires`
* `expired`
* `unresolved_ref`

## Token 憑證

Token 憑證（`type: "token"`）支援內嵌的 `token` 和／或 `tokenRef`。

### 資格規則

1. 當 `token` 和 `tokenRef` 都缺失時，token profile 不符合資格。
2. `expires` 是選用的。
3. 若 `expires` 存在，它必須是大於 `0` 的有限數字。
4. 若 `expires` 無效（`NaN`、`0`、負數、非有限數，或類型錯誤），profile 不符合資格，原因為 `invalid_expires`。
5. 若 `expires` 已過期，profile 不符合資格，原因為 `expired`。
6. `tokenRef` 不會繞過 `expires` 驗證。

### 解析規則

1. 解析器語義與 `expires` 的資格語義一致。
2. 對於符合資格的 profile，token 材料可從內嵌值或 `tokenRef` 解析。
3. 無法解析的 ref 在 `models status --probe` 輸出中產生 `unresolved_ref`。

## 舊版相容訊息

為了腳本相容性，探測錯誤的第一行保持不變：

`Auth profile credentials are missing or expired.`

人類友善的詳情和穩定原因代碼可在後續行中添加。