@RoundtableSpace: 一位开发者在发布15天后将Grok Bot 0.18重构为可读的TypeScript，并将其转化为一个shell，该shell r…

一位开发者在发布15天后将Grok Bot 0.18重构为可读的TypeScript，并将其改造为通过Claude Code、Codex、Cursor和OpenRouter处理任务的外壳，同时保留所有现有插件和MCP工具正常运作。→ 重构了Electron应用、宿主、协调器、运行时和协议层 → Claude Code和Codex可以使用现有本地认证，无需强制设置新API → 本地Docker沙箱在您的机器上运行执行，令牌使用情况本地追踪 → 打包成独立的macOS应用，不替换官方Grok Bot安装 Github: https://github.com/b-nnett/grok-bot-0.18-reconstructed… — # b-nnett/grok-bot-0.18-reconstructed 来源: https://github.com/b-nnett/grok-bot-0.18-reconstructed # Grok Bot 0.18 — 重构与扩展 Grok Bot路由设置，选中Codex并显示本地使用总量 本仓库是对公开发布的Grok Bot 0.18.0 macOS应用的非官方、源代码导向重构。该项目始于理解桌面应用如何构建的尝试。目前包含了其Electron、宿主、协调器、本地执行、协议和渲染器边界的可读TypeScript实现，以及将这些源代码重新组合为可工作macOS应用的确定性工具链。项目还添加了一些实用实验： - 面向Cursor、Claude Code、Codex和OpenRouter的推理路由器； - 在路由提供商间共享Grok Bot插件/MCP工具； - 路由推理的本地使用追踪； - 可选的本地Docker沙箱替代远程执行盒； - 集成到精美发布UI中的重构设置界面。这是个黑客研究项目，非Anysphere原始代码库，也不是官方Grok Bot发布版。从编译应用推断的名称和模块边界可能与原始源代码不同。 ## 仓库包含什么？ 签入的文件树包含经过审查的重构代码、测试、清单、构建脚本，以及通过Git LFS保存的原始macOS arm64和Windows x64安装程序。项目刻意不提交提取的上游应用、构建输出、本地凭证或大型取证恢复工作区。公开的Grok Bot 0.18.0应用被视为固定构建输入。在引导过程中，工具链会下载它、验证SHA-256标识，并提取组装重构所需的部分。最终应用设计为混合模式： - 应用运行时从source/下的可读源代码编译； - 精美的发布渲染器保留为UI基准； - 一个窄范围的确定性转换添加重构的路由器设置UI； - 原始和修补的渲染器块哈希被记录和验证； - 最终应用使用独立的bundle标识符和临时签名。机器上已安装的上游应用从不被覆盖。 ### 为何保留发布渲染器？ 发布的应用不包含原始前端源代码或源代码映射。它包含优化的、压缩的生产JavaScript和CSS块——足以检查行为和恢复契约，但无法获得创作的React组件、命名、注释、文件结构或设计系统源代码。用相同精美度和行为重建完整前端将是另一个更庞大的逆向工程项目。对于周末构建来说不现实。因此实际选择是重构运行时和控制平面代码、保留校验和固定的发布渲染器，并仅做必要的最小可审计UI补丁来添加路由器设置。frontend/是可读的部分重构和设计工作区，有助于理解UI契约和实验清晰组件，但不应被误认为是Anysphere缺失的原始前端源代码或对打包渲染器的像素级替代。 ## 保留的原始安装程序 精确0.18.0安装程序的研究副本位于research-archives/original/0.18.0/并通过Git LFS存储： | 平台 | 文件 | SHA-256 | | — | — | — | | macOS arm64 | macos-arm64/Grok_Bot_0.18.0.dmg | a253ccd8aab01e083f9812a0264354c5034d8ba7f0610bbb557e82ae77d203eb | | Windows x64 | windows-x64/Grok_Bot_0.18.0_Setup.exe | 464079a15ef5fa8b61ccea8fffcc78f63cfcf6df65fb0ad5e725d8b95f7e437e | 详见research-archives/README.md获取源URL、大小、验证命令和机器可读的制品清单。 ## 当前功能 ### 推理路由器 打开设置→路由器选择用于新对话回合的后端： | 提供商 | 认证方式 | 工具支持 | | — | — | — | | Cursor | 现有Grok Bot/Cursor会话 | 原生Grok Bot工具和插件 | | Claude Code | 现有Claude Code登录 | 路由的Grok Bot MCP工具 | | Codex | 现有本地ChatGPT/Codex登录 | 直接响应传输配合Grok Bot工具 | | OpenRouter | 通过桌面密钥桥保存的API密钥 | Grok Bot工具执行循环 | Cursor是默认选项。当本地客户端已认证时，Claude Code和Codex无需单独API密钥。应用在路由对话中保持流式响应、思考状态、反应、丰富插件提及和MCP工具执行。使用情况与计费显示本地记录的返回使用数据提供商的请求和令牌总量。这些数据是活动记录，并非权威提供商账单。 ### 本地Docker沙箱 路由器页面还有使用本地Docker虚拟机开关。启用后，Grok Bot在拥有的本地容器中运行其执行盒主机和守护进程，而非连接远程沙箱。该容器： - 仅绑定到回环端口； - 以只读方式挂载内容寻址的宿主机和守护进程制品； - 在需要时重用用户现有的提供商认证； - 在协调器连接前进行验证； - 通过相同设置生命周期停止或替换。需要运行Docker Desktop或其他兼容的本地Docker守护进程。远程模式仍是默认选项。 ## 要求 - Apple Silicon上的macOS - Node.js 26.5.x - Xcode命令行工具 - Git LFS - Docker Desktop（可选，仅用于本地沙箱） - 用于路由器选择的本地Claude Code或Codex认证 ## 快速开始 sh git clone cd grok-bot-0.18-reconstructed git lfs install git lfs pull npm ci npm run bootstrap npm run check npm run package open "dist/Grok Bot 0.18 Reconstructed.app" npm run bootstrap首先使用固定0.18.0 DMG的Git LFS保留副本。若该存档不存在，则回退到原始公开URL；也可通过GROK_BOT_018_APP指向现有应用副本。引导过程验证DMG和app.asar、缓存匹配的Electron运行时，并填充被忽略的src/app/dist构建输入。 npm run package编译重构的运行时、应用窄范围的渲染器/设置转换、创建应用包、分配重构的bundle标识符、临时签名并验证结果。输出写入： text dist/Grok Bot 0.18 Reconstructed.app 重构包在打包边界禁用上游更新器，并默认关闭上游Sentry和遥测发送。明确提供的环境配置仍会被尊重。 ## 架构 text 精美发布渲染器 │ │ 桌面预加载/RPC ▼ Electron主进程 │ ├── 设置、密钥、认证和插件生命周期 ├── 远程执行盒连接器 └── 拥有的本地Docker连接器 │ ▼ 协调器 + 宿主 │ 推理路由器 ┌───────────┼───────────┐ Cursor Claude Codex / OpenRouter │ Grok Bot MCP工具 主要源代码区域： - source/electron-main/ — 桌面生命周期、设置、认证、执行盒连接器、协调器所有权和RPC处理器； - source/electron-preload/ — 暴露给UI的窄范围可信桥； - source/host/ — 推理、工具、MCP、设置和回合执行； - source/node-agent-coordinator/ — 对话记录路由、流式活动、反应和路由的MCP桥； - source/shared/ — 共享契约、设置、协议和提供商辅助程序； - frontend/ — 可读的React/TypeScript渲染器重构和设计工作区； - scripts/ — 引导、编译、渲染器修补、打包、签名和验证； - tests/ — 发布和路由器回归测试。详见docs/ARCHITECTURE.md。 ## 开发命令 sh npm test # 专注的回归测试 npm run typecheck # 渲染器TypeScript npm run source:typecheck # 运行时TypeScript npm run frontend:build # 构建可读的渲染器重构 npm run package # 构建、签名并验证macOS应用 npm run verify # 验证现有打包应用 npm run smoke # 有界原生冒烟测试 npm run publication:check # 证明新鲜历史导出无损 生成的目录包括.cache、.build、dist、src/app/dist、recovered、recovery和本地探针根目录均被忽略。 ## 项目状态 应用可启动，核心重构流程可用，包括路由推理、已连接插件和本地Docker沙箱。这仍是实验性重构：针对固定macOS/arm64版本，依赖外部提供商会话，不保证与未来Grok Bot版本兼容。变更请阅读CONTRIBUTING.md。干净历史导出流程见docs/PUBLISHING.md。技术来源和保留的上游边界描述于PROVENANCE.md和NOTICE.md。