让 Grok Bot 真正“可定制、可审计、可扩展”：macOS 上首个开源重构版推理路由增强器

你是否用过 Grok Bot 0.18（Anysphere 官方发布的 macOS 桌面 AI 编程助手），却苦于它只能绑定自家服务、无法切换模型后端、设置界面封闭、行为不可追溯？b-nnett/grok-bot-0.18-reconstructed 正是为此而生——它不是简单破解，而是一次严谨的「源码级逆向重建」：从官方发布的二进制安装包出发，完整还原 Electron 主进程、通信协议、本地执行沙箱等核心控制层，并注入开发者真正需要的能力：多模型路由、插件跨平台调用、本地化行为追踪与 Docker 沙箱支持。它不替换你的原版 Grok Bot，而是在其基础上叠加一层透明、可控、可验证的智能调度层。

核心功能

四合一推理路由开关：在「设置 → Router」中一键切换当前对话的底层大模型——支持 Cursor（复用现有会话）、Claude Code（免密直连）、本地 Codex（对接 ChatGPT 桌面版）和 OpenRouter（API Key 接入）。解决了“同一个 UI 却被厂商锁定单一服务商”的根本痛点，让 AI 工具回归用户主权。
Grok Bot 插件/MCP 工具全平台兼容：原生 Grok Bot 的代码操作、文件读写、终端执行等工具能力，现在能跨后端运行——在 Claude Code 或 Codex 后端上，仍可调用同一套 Grok Bot 插件逻辑，避免重复开发适配，大幅提升多模型工作流的一致性。
本地化使用追踪与审计：所有路由决策、模型调用、工具触发均记录在本地 SQLite 数据库中，含时间戳、提供商、输入 token 数、响应延迟等字段。无需上传数据，即可清晰回溯“哪次提问走了 Claude？哪次用了 OpenRouter 的 Llama-3？耗时是否异常？”——对隐私敏感者与团队合规场景至关重要。
Docker 沙箱替代远程执行盒：官方 Grok Bot 的“安全执行环境”依赖远程服务器；本项目提供可选的 local-docker-sandbox 模块，将代码执行完全收敛至本地 Docker 容器（预置 Python/Node/Rust 运行时），杜绝网络外泄风险，且支持自定义镜像与资源限制，真正实现“代码即服务，隔离即默认”。
零侵入式 UI 增强：不重写整个前端，而是对官方渲染器（renderer）做最小化、哈希可验证的补丁——仅注入 Router 设置面板，其余 UI（包括动画、主题、布局）100% 保持原厂质感。既保障体验一致性，又确保每次构建结果可审计、可复现。
确定性构建工具链：项目自带完整 CI/CD 脚本，首次运行时自动下载并 SHA-256 校验官方 Grok Bot 0.18.0 macOS arm64 安装包（a253ccd8...03eb），解包提取必要资源，再与 TypeScript 源码编译产物组装成新 App。每一次构建都可回溯到同一份原始二进制，杜绝“黑盒打包”风险。
分离式签名与沙盒隔离：生成的应用使用独立 Bundle ID（com.openklc.grokbot.reconstructed）和 ad-hoc 签名，与系统中原版 Grok Bot 完全隔离，互不干扰。你可同时安装两个版本，对比测试，且无需禁用 Gatekeeper。
前端设计沙盒（frontend/）：虽未替换生产渲染器，但项目内含 React 组件级的 UI 合约分析与可运行原型（如 Settings 页面交互逻辑），供开发者理解状态流转、调试样式、甚至为未来全栈开源铺路——这是真正的“研究友好型”开源实践。

技术亮点

源导向逆向（Source-Oriented Reconstruction）：不同于传统内存 dump 或动态 Hook，项目以官方发行版为“事实锚点”，通过静态分析 JS chunk、重建模块边界、推导类型定义，最终产出可读、可测、可调试的 TypeScript 代码（source/electron/, source/protocol/, source/coordinator/），而非混淆后的胶水代码。
分层可信架构：严格区分“可信层”（官方渲染器，SHA-256 锁定+哈希校验）与“可编程层”（全部 TypeScript 控制逻辑），两者通过精确定义的 IPC 协议通信。任何 UI 行为变更都必须经过协议层透出，杜绝前端脚本越权。
Electron + Rust 边界清晰：本地执行沙箱、Docker 驱动、密钥桥接（secrets bridge）等高权限操作，均由独立 Rust 二进制（host/）承载，通过 Node-API 暴露给 TypeScript 主进程，既保障安全性，又保留 TypeScript 的开发效率。
Git LFS 归档原始证据：项目仓库明确托管经校验的原始安装包（macOS arm64 / Windows x64），路径为 research-archives/original/0.18.0/，附带完整下载来源、大小、校验命令，使整个重建过程具备法律与学术意义上的可证伪性。

适合哪些人用

本项目专为三类用户打造：AI 工具深度使用者（如每天用 Grok Bot 写 500 行代码的工程师）、隐私优先的开源倡导者（拒绝将 prompt、文件内容、执行日志上传至任意云服务）、以及桌面应用逆向研究者（想学习如何系统性地解构现代 Electron 应用）。

真实场景示例：
① 前端团队技术选型会议：工程师 A 在本地启动本项目，依次切换 Cursor/Claude/OpenRouter 后端，实时对比三者对同一段 React 错误日志的诊断质量与修复建议速度，并将本地追踪日志导出为 CSV 提交评审；
② 金融行业内部 AI 编程平台：安全团队要求所有代码执行必须离线，他们基于本项目启用 local-docker-sandbox，定制只含 Python 3.11 + pandas 的轻量镜像，再通过 MCP 插件集成内部风控规则引擎，全程无外网调用。

快速上手

只需终端三步：

克隆仓库：git clone https://github.com/b-nnett/grok-bot-0.18-reconstructed.git && cd grok-bot-0.18-reconstructed
安装依赖：npm ci（需 Node.js 18+、Python 3.11、Docker Desktop 可选）
构建并启动：npm run build:macos && open dist/Grok\ Bot\ Reconstructed.app（首次运行将自动下载并校验官方安装包）

启动后，点击菜单栏 Grok Bot Reconstructed → Settings → Router 即可配置后端。所有设置持久化保存在 ~/Library/Application Support/com.openklc.grokbot.reconstructed/ 下，支持手动备份。

同类对比 / 注意事项

vs 官方 Grok Bot：官方版是封闭黑盒，无设置扩展能力；本项目开放全部控制平面源码，但 UI 渲染层仍依赖官方二进制（这是务实选择，非妥协）。
vs 其他 Electron 逆向项目（如 VS Code 衍生版）：多数项目止步于 patch 二进制或注入 JS；本项目构建了完整的、可测试的 TypeScript 抽象层，支持单元测试（test/ 目录含 127 个用例）与协议变更检测。
注意事项：不支持 macOS Intel 芯片（仅 arm64）；Windows 版本目前仅为归档参考，未提供构建脚本；OpenRouter 需自行申请 API Key 并通过系统钥匙串保存；启用 Docker 沙箱前请确认 Docker Desktop 已运行且用户加入 docker 用户组。