面向 Windows 的开源 Grok API 桌面客户端。
直连 xAI 官方 API 或自定义兼容 API。
聊天与 DeepSearch，开箱即用。
社区维护的非官方项目，与 xAI 无关联。中文 · English
Grok API Desktop 把 Grok 聊天和联网搜索带到独立的 Windows 应用中。无需网页登录，也不接管浏览器会话：填写自己的 API 地址和 API Key，即可使用专注、快速、数据留在本机的桌面体验。
前往 Latest Release 获取最新版本。
| 版本 | 适用场景 | 下载 |
|---|---|---|
| Windows 安装程序 | 推荐；可选择安装位置，并创建开始菜单与桌面快捷方式 | 下载 Setup.exe |
| Windows 便携版 | 解压后直接运行，不写入系统安装信息 | 下载 ZIP |
当前构建面向 Windows 10/11 x64。项目尚未配置商业代码签名证书，首次下载时 Windows SmartScreen 可能显示提示；请只从本仓库的 Releases 页面获取安装包，并在运行前核对来源。
- Grok 聊天：支持 Markdown、代码块、表格和 SSE 流式响应，可随时停止生成。
- DeepSearch：调用 API 提供商的联网搜索能力，整理引用来源并通过系统浏览器打开。
- 多标签会话：同时保留多个对话上下文，在标签栏中快速切换。
- 本地历史记录：搜索、重命名、继续或删除过往会话，内容保存在当前 Windows 用户目录。
- 双连接方式：内置 xAI 官方 API 配置，同时支持 OpenAI Responses 或 Chat Completions 兼容 API。
- 连接与模型设置：分别指定聊天模型和搜索模型，并在设置中随时更新连接。
- Windows 原生分发：提供可选安装路径的安装程序和免安装便携 ZIP。
当前版本专注于主聊天与搜索，不包含代码代理、终端、插件、图像生成或语音功能。
首次打开应用时会直接进入连接页面。选择服务类型，输入 API 请求地址和 API Key，再设置聊天与搜索模型；验证成功后即可进入主界面。
| 连接方式 | API 基础地址 | 协议与搜索 |
|---|---|---|
| xAI 官方 | https://api.x.ai/v1 |
Responses API；DeepSearch 使用 web_search 工具 |
| 自定义兼容 API | 由服务提供商给出的 HTTPS 基础地址 | OpenAI Responses 或 Chat Completions；搜索能力取决于提供商实现 |
保存前，应用会通过 GET /v1/models 验证连接并读取可用模型。自定义地址应填写 API 基础地址，例如 https://api.example.com/v1，不要填写完整的 /responses 或 /chat/completions 路径。
Note
“OpenAI 兼容”不代表提供商一定实现联网搜索或相同的引用格式。Chat Completions 的 search_parameters 是兼容扩展，不属于 OpenAI 标准字段；提供商不支持时请使用普通聊天，或切换到其支持的 Responses 搜索协议。
xAI 官方连接固定使用 Responses API。普通聊天请求发送到 /v1/responses；DeepSearch 请求会额外携带：
{ "tools": [{ "type": "web_search" }] }自定义 API 支持：
| 协议 | 请求端点 | 搜索参数 |
|---|---|---|
| OpenAI Responses | /v1/responses |
tools: [{ "type": "web_search" }] |
| Chat Completions | /v1/chat/completions |
search_parameters.mode: "auto" |
自定义连接可选择 Authorization: Bearer 或 x-api-key 鉴权。
- API Key 只在 Electron 主进程中解密和使用，不暴露给页面渲染进程。
- API Key 通过 Electron
safeStorage保存，在 Windows 上由当前用户的 DPAPI 保护。 - 对话历史保存在 Electron 用户数据目录的 IndexedDB 中，不上传到项目服务器。
- 远程 API 地址必须使用 HTTPS；HTTP 只允许
localhost、127.0.0.1和[::1]。 - API 请求拒绝 HTTP 重定向，避免鉴权头被转发到其他主机。
- 外部链接仅允许 HTTP/HTTPS，并交给系统默认浏览器打开。
- 应用不使用 WebView；渲染进程关闭 Node.js 集成，并启用上下文隔离与沙箱。
应用会把请求内容发送到你配置的 API 服务。相应服务的日志、保留和隐私规则由该服务提供商决定。
默认数据目录由 Electron 根据 Windows 用户生成。开发或便携测试时可以覆盖：
$env:GROK_API_DESKTOP_DATA_DIR = "E:\GrokApiDesktopData"
pnpm dev不要把真实 API Key、connections.json 或用户数据提交到 Git。
需要 Windows 10/11、Node.js 24 和 pnpm 10 或更高版本。
git clone https://github.com/Gambit-Checkmate/grok-api-desktop.git
cd grok-api-desktop
pnpm install
pnpm typecheck
pnpm test
pnpm dev仓库包含一个仅监听本机的模拟 API，可在没有真实密钥时验证完整流程：
pnpm mock-api然后在应用中选择“自定义 API”，填写 http://127.0.0.1:4317/v1、测试密钥 test-key，协议选择 OpenAI Responses。
pnpm build
pnpm package:dir
pnpm dist:win产物会写入 release/。
src/main/ Electron 主进程、配置存储、API 请求和流适配
src/preload/ 严格白名单 IPC 桥接
src/renderer/ React 界面和本地对话历史
src/shared/ 主进程与页面共享的数据契约
scripts/ 构建清理、模拟 API 和界面验收工具
提交代码前请阅读 CONTRIBUTING.md。安全问题请按 SECURITY.md 中的方式报告，不要在公开 Issue 中提交真实 API Key 或敏感日志。
Grok API Desktop 是社区维护的非官方开源项目，与 xAI 无隶属、合作或背书关系。Grok、SuperGrok、xAI 及相关名称和标识属于其各自权利人，仅用于说明兼容性和产品界面。MIT License 只适用于本项目代码，不授予任何商标权。
本项目代码基于 MIT License 开源。