如何从零构建 7×24 小时 AI Agent
一本讲 AI Agent 系统设计思想的技术书。从问题出发，教设计原则，用 30 万行真实代码做案例。
🌐 在线阅读：https://book.imwangfu.com · 💬 反馈与讨论：Issues · Discussions
这本书讲什么
本书像《设计模式》一样，用一个真实项目（30 万行 TypeScript，开源 AI Agent 平台）作为贯穿全书的案例，讲 AI Agent 系统从引擎到调度到浏览器自动化的设计思想。每一节从一个具体问题开始——“上下文窗口塞满了怎么压缩才不丢关键信息”“一个 7×24 运行的数字员工，凭什么会越用越聪明而不是越来越笨”——引出设计原则，再用真实代码验证。
你读完能拿走的不是“代码怎么写的”，而是“我的项目遇到类似问题时该怎么想”。
Halo AI 工作站 不是完美的参考实现——书里既展示做得好的设计决策，也展示务实的妥协和它们的代价。后者往往比前者更有教学价值。
覆盖范围
13 章 + 前言 + 附录，从工程地基到 AI 引擎到浏览器自动化：
- 设计基础：运行时 Adapter、声明式能力边界、分层与依赖方向、性能预算、命名空间迁移
- AI 引擎：Agent 循环、上下文压缩、多供应商协议归一化、前缀缓存
- 数字员工平台：App Spec、持久化调度、Escalation 机制、事件路由
- AI 浏览器：Accessibility Tree、反检测、模块化工具体系
- 工程实践：流式渲染、远程访问、稳定性保障、AI 编程方法论
适合谁
想理解 AI Agent 系统设计的开发者。 你有 1-3 年经验，能写业务代码，但没机会接触大型系统的架构决策——不是因为你学不会，是因为工作环境没有这个机会。你想知道：一个真正跑在生产环境的 Agent 系统，从引擎到调度到浏览器自动化，每一层是怎么设计的、为什么这样设计、放弃了什么方案。这本书从问题出发讲设计思想，用真实代码做案例，你读完能把这些思路用在自己的项目里。
正在构建 AI 工具但卡在“从能用到好用”的独立开发者。 你的原型能用了，但启动越来越慢、模块之间依赖混乱、多平台维护成本越来越高。这些不是 AI 特有的问题——它们是任何达到一定规模的系统都会遇到的工程问题。本书每一章讲的设计思想（运行时 Adapter、性能预算、分层隔离、命名空间迁移……）都可以直接应用到你的项目里，不依赖 Halo AI 工作站的具体技术栈。
好奇“一个人加 AI 能做到什么程度”的人。 第十三章专门回答这个问题。不是鸡汤，是方法论：需求澄清的三步螺旋、AI 律法的三层抽象、交叉审查工作流——这些方法是我用来构建整个 Halo AI 工作站的，也是用来写这本书的。
这本书和市面上大多数 AI Agent 书籍的主要区别在于：它是打开引擎盖讲的，不是在引擎盖外面讲的。每章从一个真实的工程问题出发，讲方案怎么来的、备选是什么、放弃了什么。
完整目录
| # | 章节标题 | 状态 |
|---|---|---|
| 序言 | 为什么写这本书 | ✅ |
| 第一章 | 全景 — AI 数字员工是什么 | ✅ |
| 第二章 | 地基 — 三端统一的应用架构 | ✅ |
| 第三章 | 大脑 — AI 引擎的工程化 | ✅ |
| 第四章 | 兼容层 — 让大脑听懂所有语言 | ⏳ |
| 第五章 | 灵魂 — 数字员工的定义与管理 | ⏳ |
| 第六章 | 心脏 — 自主执行引擎 | ⏳ |
| 第七章 | 记忆 — 让数字员工越来越聪明 | ⏳ |
| 第八章 | 双手 — AI 浏览器的构建 | ⏳ |
| 第九章 | 嘴巴 — 通信与通知体系 | ⏳ |
| 第十章 | 面孔 — 前端交互工程 | ⏳ |
| 第十一章 | 盔甲 — 生产环境的稳定性保障 | ⏳ |
| 第十二章 | 市场 — App Store 与生态 | ⏳ |
| 第十三章 | 造物 — 一个人 + AI 如何构建 30 万行代码 | ⏳ |
| 附录 | 关键术语 / 源码导览 | ⏳ |
✅ 已发布 · ⏳ 待发布。Star + Watch 本仓库可订阅更新。
作者
Flynn，人工智能 & 前端 & 后台，前腾讯文档核心工程师，擅长大型软件架构（文档 / IDE / AI 桌面）；2024 年率先在金融领域试点国产通用 Agent——全流程自动化编码和研发，持有多项 AI 专利（Agent Loop、压缩、记忆等）；首个可视化 & 远程 AI Agent 桌面（2025 年 10 月）——Halo AI 工作站 项目作者。
提交反馈
| 类型 | 入口 |
|---|---|
| 📝 错别字 / 技术错误 | 提交勘误 |
| 💡 章节建议 / 内容补充 | 提交建议 |
| 🤔 对内容有疑问 | 提出问题 |
| 💬 自由讨论 | Discussions |
本仓库结构
build-ai-agent-platform/
├── book/ ← 已发布章节的 Markdown 源
│ ├── index.md
│ ├── 00-preface.md
│ ├── about.md
│ └── public/
├── .vitepress/ ← VitePress 配置 + 自定义主题
│ ├── config.ts
│ └── theme/
├── .github/
│ └── ISSUE_TEMPLATE/ ← 反馈模板
├── package.json
├── vercel.json
└── LICENSE
本地预览
npm install
npm run dev # 本地预览,默认 http://localhost:5173
npm run build # 构建静态站
npm run preview # 预览构建产物
部署
已配置 GitHub Pages + Actions 自动部署。
每次推送 main 分支，会自动触发 .github/workflows/deploy.yml，构建并发布到 GitHub Pages，通常 1-2 分钟内上线。
无需任何手动配置。
若未来需要迁移到 Vercel，仓库根目录保留了
vercel.json作为预设配置。
协议
- 书稿内容（
book/下的所有 Markdown）：CC BY-NC-ND 4.0- ✅ 共享、署名
- ❌ 商业使用、禁止演绎
- 代码部分（
.vitepress/配置、主题、构建脚本）：MIT
完整许可见 LICENSE。
参考源码
本书拆解的项目 Halo AI 工作站已完整开源：
https://github.com/openkursar/hello-halo
书中所有源码引用、架构讨论、设计决策均可在该仓库中验证。