AI 提供商設定參考

開啟 Notomo → 設定 → AI → Providers 管理提供商。Notomo 將賬戶憑證和 API Key 儲存在 macOS 鑰匙串中；只有已連線且啟用的提供商才會出現在模型選擇器中。

Account 提供商

ChatGPT Account

1. 在 Account 區域按一下 Sign in with ChatGPT。
2. 按登入視窗提示完成授權。
3. 登入成功後保持 ChatGPT 開關啟用。

退出賬戶會從模型選擇器中移除 ChatGPT 模型。連線過程不依賴本地 CLI。

xAI Account

1. 在 Account 區域按一下 Sign in with xAI。
2. 按登入提示使用 SuperGrok 或 X Premium 賬戶完成授權。
3. 登入成功後保持 xAI 開關啟用。

連線過程不依賴本地 CLI。登入狀態失效時，回到此頁面重新登入。

API 提供商

按一下 Add API Provider，選擇服務並填寫所需欄位：

提供商	必填設定	其他設定
OpenAI API	API Key	—
Google Gemini API	API Key	—
OpenRouter API	API Key	可取得或手動新增模型
DeepSeek API	API Key	—
GLM Coding Plan	API Key	Region：Global 或 China
Cloudflare Workers AI	Account ID、API Token	可取得或手動新增模型
OpenAI-compatible API	Provider Name、API Base URL	API Key 可選；可取得或手動新增模型

填寫完成後：

1. 按一下 Verify 測試憑證和服務地址。
2. 對支援動態模型清單的服務，按一下 Fetch Models 並選擇要使用的模型。
3. 如果目標模型未列出，按一下 Custom 手動填寫模型 ID。
4. 儲存設定並確認該提供商已啟用。

GLM Coding Plan 的 Region 只切換 API endpoint，不會更改已填寫的 API Key 或驗證狀態。

OpenAI-compatible API 注意事項

• Provider Name 必須唯一，用於在設定和模型選擇器中區分服務。
• 優先使用 https:// Base URL。
• Notomo 允許指向本機服務的 http:// URL。
• 使用其他普通 HTTP 地址時，請注意請求內容和 API Key 不會被加密。
• 某些本地服務不需要 API Key，此時可以留空。

模型 ID

手動新增模型時，應填寫服務 API 實際接受的模型 ID，而不是隻填寫展示名稱。模型 ID 錯誤通常會在傳送第一個請求時才被服務拒絕。

Antigravity

Antigravity 透過 Agent Client Protocol（ACP）在本機執行 Google 官方的 Antigravity 代理程式，不需要終端機或 agy CLI。

1. 開啟 Providers → Local Agents，按一下 Install。Notomo 會從 Google 下載代理程式並驗證 Google 的程式碼簽署。
2. 按一下 Sign in with Google，在瀏覽器中完成登入。
3. 開啟 Antigravity 開關。代理程式安裝、登入並啟用後，它的 Gemini 模型會出現在模型選擇器中。

在 Antigravity 列中按一下檢查更新，即可在有新版本時安裝更新。

當網頁搜尋設為「自動」或「開啟」時，Notomo 會允許 Antigravity 使用原生 search_web 工具。Notomo 會拒絕代理程式發出的所有其他工具請求，因此 Antigravity 無法修改你 Mac 上的檔案。

編輯或停用提供商

• 關閉提供商開關會隱藏其模型，但不會立即刪除憑證。
• 按一下已設定的 API 提供商可重新驗證、調整模型或更新憑證。
• Account 提供商使用 Sign Out 斷開連線。
• 刪除 API 設定前，請確認沒有需要繼續使用的自訂模型。

如果模型沒有出現，請依次確認：提供商連線成功、開關已啟用、模型已經新增，以及 Account 登入或 CLI 會話仍然有效。更多排查方法參閱常見問題。