AI 提供商配置参考
打开 Notomo → 设置 → AI → Providers 管理提供商。Notomo 将账户凭证和 API Key 存储在 macOS 钥匙串中;只有已连接且启用的提供商才会出现在模型选择器中。
Account 提供商
Section titled “Account 提供商”ChatGPT Account
Section titled “ChatGPT Account”- 在 Account 区域点击 Sign in with ChatGPT。
- 按登录窗口提示完成授权。
- 登录成功后保持 ChatGPT 开关启用。
退出账户会从模型选择器中移除 ChatGPT 模型。连接过程不依赖本地 CLI。
xAI Account
Section titled “xAI Account”- 在 Account 区域点击 Sign in with xAI。
- 按登录提示使用 SuperGrok 或 X Premium 账户完成授权。
- 登录成功后保持 xAI 开关启用。
连接过程不依赖本地 CLI。登录状态失效时,返回此页面重新登录。
API 提供商
Section titled “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 可选;可获取或手动添加模型 |
填写完成后:
- 点击 Verify 测试凭证和服务地址。
- 对支持动态模型列表的服务,点击 Fetch Models 并选择要使用的模型。
- 如果目标模型未列出,点击 Custom 手动填写模型 ID。
- 保存配置并确认该提供商已启用。
GLM Coding Plan 的 Region 只切换 API endpoint,不会更改已填写的 API Key 或验证状态。
OpenAI-compatible API 注意事项
Section titled “OpenAI-compatible API 注意事项”- Provider Name 必须唯一,用于在设置和模型选择器中区分服务。
- 优先使用
https://Base URL。 - Notomo 允许指向本机服务的
http://URL。 - 使用其他普通 HTTP 地址时,请注意请求内容和 API Key 不会被加密。
- 某些本地服务不需要 API Key,此时可以留空。
Antigravity
Section titled “Antigravity”Antigravity 通过 Agent Client Protocol(ACP)在本地运行 Google 官方的 Antigravity 代理,不需要终端或 agy CLI。
- 打开 Providers → Local Agents,点击 Install。Notomo 会从 Google 下载代理并校验 Google 的代码签名。
- 点击 Sign in with Google,在浏览器中完成登录。
- 打开 Antigravity 开关。代理安装、登录并启用后,它的 Gemini 模型会出现在模型选择器中。
在 Antigravity 行中点击检查更新,即可在有新版本时安装更新。
当网页搜索设为“自动”或“开启”时,Notomo 会允许 Antigravity 使用原生 search_web 工具。Notomo 会拒绝代理发起的所有其他工具请求,因此 Antigravity 无法修改你 Mac 上的文件。
编辑或停用提供商
Section titled “编辑或停用提供商”- 关闭提供商开关会隐藏其模型,但不会立即删除凭证。
- 点击已配置的 API 提供商可重新验证、调整模型或更新凭证。
- Account 提供商使用 Sign Out 断开连接。
- 删除 API 配置前,请确认没有需要继续使用的自定义模型。
如果模型没有出现,请依次确认:提供商连接成功、开关已启用、模型已经添加,以及 Account 登录或 CLI 会话仍然有效。更多排查方法参阅常见问题。