Grok Bot 架构总览
整体架构、进程拓扑与源码目录地图
导读：Grok Bot 源码解读
本目录是对 Grok Bot 0.18 重构版（source/）的系统解读。源码仓库：github.com/b-nnett/grok-bot-0.18-reconstructed
。文档之间互相引用，但如果你第一次读，建议按下述顺序。
推荐阅读顺序
- ARCHITECTURE.md —— 先建立全局观：分层拓扑、源码目录地图、构建模型。内容最短，5 分钟。
- CORE-FLOW.md —— 理解「一条用户消息如何变成一次模型回复 + 工具执行」的完整生命周期（turn 循环、工具执行、总结、重试）。
- PROMPTS.md —— 理解发给模型的 prompt 是怎么拼出来的（prompt-jsx 渲染器、SAND system prompt、UserInfo）。
- CHARACTER.md —— 理解 Grok Bot「为什么这样说话/做事」：简洁、证据充分、有自己的逻辑和坚持，各自的约束来源。
- EXECUTION.md —— 理解「工作在哪里真正发生」：沙箱 vs 本机 vs 后端服务器，以及网页访问与验证应对。
- SAFETY.md —— 理解防护层：隐私分级、Auto-review 安全检查、防循环、文件并发锁。
- AGENTS.md —— 理解智能体生态：推理路由、多 agent 协作、桌面/浏览器自动化。
- RUNTIME.md —— 理解长期运行基础设施：记忆、自动化（Routines）、沙箱生命周期。
按目标阅读
| 你想了解… | 直接读 |
|---|---|
| 整体架构长什么样 | ARCHITECTURE → CORE-FLOW |
| 代码执行流程（turn/工具/总结） | CORE-FLOW |
| prompt 如何组装、有哪些规则 | PROMPTS |
| 它为什么简洁、有主见、不编数据 | CHARACTER |
| 沙箱 vs 本机、网页访问、验证码 | EXECUTION |
| 隐私/安全/防失控机制 | SAFETY |
| 多模型后端切换、agent 协作、桌面自动化 | AGENTS |
| 记忆、定时任务、沙箱自愈 | RUNTIME |
文档地图
| 文档 | 一句话 | 标签 |
|---|---|---|
| ARCHITECTURE.md | 整体架构、进程拓扑与源码目录地图 | architecture |
| CORE-FLOW.md | 从用户消息到模型回复的完整运行流程 | architecture, agent-loop |
| PROMPTS.md | System Prompt 与 UserInfo 的组装体系 | prompt |
| CHARACTER.md | 行为特点与「性格」约束来源 | prompt, behavior |
| EXECUTION.md | 沙箱与本机的分工、网页访问与验证应对 | sandbox, web |
| SAFETY.md | 隐私分级、安全检查、防循环与并发锁 | security, privacy |
| AGENTS.md | 推理路由、多智能体协作与桌面自动化 | multi-agent, routing |
| RUNTIME.md | 记忆、自动化与沙箱生命周期 | memory, automation |
阅读约定
- 文中所有路径均为仓库内相对路径，可直接对照源码。
- 每个文档结尾都有「相关文档」互链，读完一篇可按兴趣跳转。
- 各文档已带 Hugo frontmatter（title/date/draft/description/tags/weight），可直接作为 Hugo content 使用。