Grok‑Bot 0.18 非官方重构版本发布:新增推理路由器、Docker本地沙盒,可切换Cursor / Claude Code / Codex / OpenRouter
一份面向 macOS 的 Grok Bot 0.18.0 非官方开源重构项目现已上线。该项目并不是xAI的官方源代码仓库,属于逆向重构后的研究实验项目,使用 TypeScript 重写 Electron、主机服务、协调调度、本地代码执行、通信协议以及渲染层相关运行逻辑,并且配套了一套可复现的构建流水线,能够重新打包生成可用的 macOS 客户端。
- GitHub:https://github.com/b-nnett/grok-bot-0.18-reconstructed
项目还在原版基础之上扩展了多项实验性功能:多后端推理路由器、跨服务商通用 MCP / Grok Bot 插件工具、本地 Token 使用统计、可替代远程执行环境的 Docker 本地沙盒,以及全新重构的设置控制面板。
重要说明:本项目属于黑客研究项目,并非官方版本;逆向推断得到的模块名称、边界划分,有可能和上游原始源码存在出入。
仓库项目构成
代码仓库存放重构源码、单元测试、清单文件、构建脚本;同时利用 Git‑LFS 保存原版 macOS‑arm64、Windows‑x64 安装包备份。
仓库不会上传提取出来的上游程序、编译产物、账号密钥和逆向分析缓存文件。
官方原版 Grok‑Bot 安装包被视作固定的外部构建资源。编译流程启动时,工具链会自动下载安装包,校验 SHA‑256 哈希,提取程序运行所需资源。
最终生成的客户端属于混合打包方案:
- 程序后端运行时,由仓库内可读 TypeScript 源码编译而来
- UI 渲染界面继续沿用原版发布的生产包作为基线
- 仅对 Router 设置页面做最小化、可审计的 UI 补丁扩展
- 原始渲染资源与补丁资源均记录哈希校验值
- 重构产物使用独立应用 ID、临时签名,不会覆盖电脑上已经安装的原版 Grok‑Bot
为什么保留原版渲染器
官方发布客户端并不附带前端源代码与源码映射文件,只有经过压缩混淆的 JS、CSS。仅依靠二进制文件,能够反向推断交互逻辑,但是无法恢复完整 React 组件、注释、文件结构。
从零复刻一套视觉完全一致的前端,工程量巨大。所以本次重构方案优先改造后端运行时、调度控制代码;UI 基线沿用校验锁定的原版渲染包,只给新增的路由功能追加少量界面。
仓库内 frontend 文件夹属于独立的前端试验工作区,方便开发者理解接口契约、试验组件;它并不是官方缺失源代码,也不能直接替换打包后的渲染界面。
新增核心能力
一、推理路由器(Router)
在设置面板‑Router 选项内,可以自由切换对话后端服务商。
| 后端服务商 | 认证方式 | 工具支持能力 |
|---|---|---|
| Cursor | 复用已有 Cursor / Grok‑Bot 会话 | 原生 Grok‑Bot 插件工具 |
| Claude Code | 本机已登录 Claude Code | 路由转发 Grok‑Bot MCP 工具调用 |
| Codex | 本地 ChatGPT / Codex 登录状态 | Responses 通道直传,附带 Grok‑Bot 工具 |
| OpenRouter | 桌面端保存的 API‑Key | 完整 Grok‑Bot 工具执行循环 |
Cursor 为程序默认后端。如果你本机已经登录 Claude Code、Codex,无需额外配置 API‑Key。
路由转发过程完整保留流式输出、模型思考过程、工具反馈、富文本插件唤起以及 MCP 任务执行链路。
配套「使用统计」面板,本地记录每一家服务商消耗的 Token 总量。该数据仅作为参考,不等于服务商官方账单数据。
二、Docker 本地沙盒环境
Router 设置中开启 Use local Docker VM 开关,即可将代码执行沙盒从远程服务器切换至本机 Docker 容器运行。
容器运行规则:
- 端口仅绑定本机环回地址,不对外暴露
- 主机程序、执行守护程序以只读方式挂载进容器
- 复用本机已保存的服务商账号认证信息
- 启动前完成环境校验
- 跟随设置生命周期自动启停替换
想要启用本地沙盒,设备上必须预先安装 Docker‑Desktop。远程沙盒模式依旧是默认选项。
运行环境要求
- Apple‑Silicon 架构 macOS
- Node.js 26.5.x
- Xcode 命令行开发工具
- Git LFS
- Docker Desktop(可选,仅用于本地沙盒)
- 对应后端客户端(Cursor / Claude Code / Codex)提前登录认证















