omp（Oh My Pi）是什麼？
omp，也稱為 Oh My Pi，是一個具有內建和自訂模型提供者的終端編碼代理。
本 omp 指南在 models.yml 中聲明了一個與 TokenHub OpenAI 相容的提供者。 API 金鑰是從環境變數解析的，且模型上下文和輸出值必須與所選模型相符。 models.yml 檔案控制提供者傳輸、環境支援的憑證、模型 ID、上下文視窗和最大輸出。 YAML 縮排或複製限制可能會阻止載入或產生無效請求，因此請使用 omp 模型檢查提供者並在將其用於活動工作之前測試一個小型唯讀任務。
omp 将其捆绑目录、~/.omp/agent/models.yml、运行时发现和扩展注册模型合并到一个注册表中。 TokenHub 是自定义 models.yml 提供程序，并被选择为 tokenhub/<model-id>。
第一步：设置一个凭证omp即可解析
export TOKENHUB_API_KEY="sk-..."apiKey 被解析為環境變數名稱或文字值。如果TOKENHUB_API_KEY存在，则omp使用其值；否则它会将该文本作为密钥发送。配置後確認變數存在。
步驟2：編輯~/.omp/agent/models.yml
providers:
tokenhub:
baseUrl: __API_BASE_URL__/v1
api: openai-completions
apiKey: TOKENHUB_API_KEY
authHeader: true
models:
- id: YOUR_TOKENHUB_MODEL_ID
name: TokenHub / YOUR_TOKENHUB_MODEL_ID
contextWindow: 128000
maxTokens: 8192authHeader: true 在每個請求上註入 Authorization: Bearer <key>。将 contextWindow 和 maxTokens 替换为确切的 TokenHub 型号的值。
第 3 步：检查提供程序是否已加载且可用
omp models
omp models find YOUR_TOKENHUB_MODEL_ID模型可以进入 omp 的注册表而不变得可选择。官方的可用性規則是，其提供者不在有效的 disabledProviders 清單中，並且要么是無密鑰的，要么具有可解析的憑證。當 tokenhub 保持停用狀態時，有效金鑰無法還原提供者。
解决omp优先顺序中的凭证冲突
對於一個提供者上的多個憑證，omp 檢查運行時 --api-key、models.yml apiKey、本地身份驗證儲存 API 金鑰、OAuth、提供環境變數，最後檢查自訂。在 models.yml 中固定 TokenHub 的密钥优先于过时的 OAuth，这适用于自定义 Base URL。
對於第一個測試，選擇 tokenhub/YOUR_TOKENHUB_MODEL_ID，執行唯讀任務，並檢查 TokenHub 日誌。如果提供者不存在，請檢查 YAML 和 disabledProviders。如果它存在但不可選擇，請檢查關鍵解析度。對於401，檢查變數和authHeader；對於 400，請檢查功能和令牌限制。
官方參考
如何選擇推薦模型？
omp (Oh My Pi) 提供者常見問題解答
models.yml 中 apiKey 應該包含什麼？
使用 TOKENHUB_API_KEY。當該環境變數存在時，omp 會將其值解析為提供者金鑰。
為什麼我的自訂提供者不可用？
檢查 models.yml 語法，確保提供者不在disabledProviders 中，並確認 API 金鑰變數可用於 omp。
我可以從另一個模型複製上下文值嗎？
否。宣告您選擇的 TokenHub 模型的實際 contextWindow 和 maxTokens。
omp 和 Oh My Pi 是同一個工具嗎？
是的。本頁介紹 Oh My Pi 終端編碼代理程式及其 ~/.omp/agent/models.yml 提供者配置。
如何驗證 omp 正在使用 TokenHub？
運行omp模型，選擇tokenhub/<model-id>，執行唯讀任務，並在TokenHub日誌中確認確切的模型。
參考資料
本頁設定依據 TokenHub 教學與官方資料，最後驗證日期為 2026-09-08。