# omobook

**Repository Path**: ulong9464/omobook

## Basic Information

- **Project Name**: omobook
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-21
- **Last Updated**: 2026-05-22

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Oh My OpenAgent：权威指南

> **"Human intervention is a failure signal."**
> （人类干预是失败信号。）

欢迎来到 Oh My OpenAgent (OmO) 的世界。这不是一本普通的编程教程，这是一场关于**自主智能体**的革命宣言。

## 关于本书

本书深入剖析 oh-my-openagent 项目的设计哲学、架构原理和源码实现。无论你是想理解 AI Agent 的编排艺术，还是想开发自己的智能体插件，这本书都将为你打开一扇通往未来的大门。

### 目标读者

- **AI Agent 开发者**：想深入理解多智能体编排系统
- **OpenCode 插件开发者**：想扩展 OpenCode 的能力边界
- **架构师**：想学习大规模 TypeScript 项目的架构设计
- **技术好奇者**：想了解 AI 编程助手的内部运作

### 阅读建议

- **初学者**：从 Part 1 开始，按顺序阅读
- **开发者**：重点阅读第四章（智能体篇）和第八篇（插件开发篇）
- **架构师**：重点阅读第二篇（架构篇）和第三篇（核心系统篇）
- **快速入门**：直接跳到第三章（安装）和第十三章（Sisyphus）

---

## 目录

### Part 1: Foundations — [基础篇](./Part1-基础篇/)

| 章节 | 标题 | 简介 |
|------|------|------|
| [Ch1](./Part1-基础篇/A1-欢迎来到革命.md) | 第一章：欢迎来到革命 | OmO 是什么，为什么它与众不同 |
| [Ch2](./Part1-基础篇/A2-自主智能体的哲学.md) | 第二章：自主智能体的哲学 | "人类干预是失败信号"的深层含义 |
| [Ch3](./Part1-基础篇/A3-安装与初次体验.md) | 第三章：安装与初次体验 | 从零开始，完成第一个任务 |
| [Ch4](./Part1-基础篇/A4-智能体会话解剖.md) | 第四章：智能体会话解剖 | 一次完整的智能体交互是如何发生的 |

### Part 2: Architecture — [架构篇](./Part2-架构篇/)

| 章节 | 标题 | 简介 |
|------|------|------|
| [Ch5](./Part2-架构篇/B1-插件架构.md) | 第五章：插件架构 | OpenCode 插件系统的设计与 OmO 的定位 |
| [Ch6](./Part2-架构篇/B2-配置深度解析.md) | 第六章：配置深度解析 | JSONC 配置、优先级、运行时覆盖 |
| [Ch7](./Part2-架构篇/B3-三层MCP系统.md) | 第七章：三层MCP系统 | Built-in + .mcp.json + Skill-embedded |
| [Ch8](./Part2-架构篇/B4-模型选择与路由.md) | 第八章：模型选择与路由 | 如何为不同任务选择最合适的模型 |

### Part 3: Core Systems — [核心系统篇](./Part3-核心系统篇/)

| 章节 | 标题 | 简介 |
|------|------|------|
| [Ch9](./Part3-核心系统篇/C1-规则引擎.md) | 第九章：规则引擎 | 运行时规则注入与 AGENTS.md 解析 |
| [Ch10](./Part3-核心系统篇/C2-AGENTS.md智能.md) | 第十章：AGENTS.md 智能 | 项目知识库的构建与使用 |
| [Ch11](./Part3-核心系统篇/C3-压缩系统.md) | 第十一章：压缩系统 | 上下文窗口管理与智能压缩 |
| [Ch12](./Part3-核心系统篇/C4-状态管理与持久化.md) | 第十二章：状态管理与持久化 | Session、Todo、Boulder 的状态流转 |

### Part 4: Agents — [智能体篇](./Part4-智能体篇/)

| 章节 | 标题 | 简介 |
|------|------|------|
| [Ch13](./Part4-智能体篇/D1-Sisyphus永恒编排者.md) | 第十三章：Sisyphus 永恒编排者 | 主编排器的设计与委托策略 |
| [Ch14](./Part4-智能体篇/D2-Prometheus战略规划者.md) | 第十四章：Prometheus 战略规划者 | 访谈式规划与任务分解 |
| [Ch15](./Part4-智能体篇/D3-Atlas执行至尊.md) | 第十五章：Atlas 执行至尊 | TODO 编排与并行执行 |
| [Ch16](./Part4-智能体篇/D4-Oracle-Librarian-Explore.md) | 第十六章：Oracle、Librarian 与 Explore | 情报检索与深度推理铁三角 |
| [Ch17](./Part4-智能体篇/D5-Hephaestus-Metis-Momus-Looker.md) | 第十七章：Hephaestus、Metis、Momus 与 Multimodal-Looker | 执行辅助四将 |

### Part 5: Hooks & Lifecycle — [钩子与生命周期篇](./Part5-钩子与生命周期篇/)

| 章节 | 标题 | 简介 |
|------|------|------|
| [Ch18](./Part5-钩子与生命周期篇/E1-钩子系统架构.md) | 第十八章：钩子系统架构 | 5 层钩子组合与执行顺序 |
| [Ch19](./Part5-钩子与生命周期篇/E2-预执行钩子.md) | 第十九章：预执行钩子 | 意图检测、权限校验、上下文注入 |
| [Ch20](./Part5-钩子与生命周期篇/E3-后执行与恢复钩子.md) | 第二十章：后执行与恢复钩子 | 错误恢复、结果转换、通知发送 |
| [Ch21](./Part5-钩子与生命周期篇/E4-意图门与关键词检测.md) | 第二十一章：意图门与关键词检测 | 如何理解用户真正想要什么 |

### Part 6: Tools & MCP — [工具与 MCP 篇](./Part6-工具与MCP篇/)

| 章节 | 标题 | 简介 |
|------|------|------|
| [Ch22](./Part6-工具与MCP篇/F1-原生工具实现.md) | 第二十二章：原生工具实现 | 13 个内置工具的实现细节 |
| [Ch23](./Part6-工具与MCP篇/F2-工具注册与门控.md) | 第二十三章：工具注册与门控 | 工具如何被注册、过滤、暴露给智能体 |
| [Ch24](./Part6-工具与MCP篇/F3-MCP工具集成.md) | 第二十四章：MCP 工具集成 | 外部工具如何通过 MCP 协议接入 |

### Part 7: Team Mode — [团队模式篇](./Part7-团队模式篇/)

| 章节 | 标题 | 简介 |
|------|------|------|
| [Ch25](./Part7-团队模式篇/G1-团队模式架构.md) | 第二十五章：团队模式架构 | 多智能体并行协调的基础设施 |
| [Ch26](./Part7-团队模式篇/G2-并行智能体协调.md) | 第二十六章：并行智能体协调 | Mailbox、消息传递、状态同步 |

### Part 8: Plugin Development — [插件开发篇](./Part8-插件开发篇/)

| 章节 | 标题 | 简介 |
|------|------|------|
| [Ch27](./Part8-插件开发篇/H1-编写自定义智能体.md) | 第二十七章：编写自定义智能体 | 从零开发一个专用智能体 |
| [Ch28](./Part8-插件开发篇/H2-构建自定义钩子与工具.md) | 第二十八章：构建自定义钩子与工具 | 扩展 OmO 能力的完整指南 |

### Part 9: Advanced Topics — [高级主题篇](./Part9-高级主题篇/)

| 章节 | 标题 | 简介 |
|------|------|------|
| [Ch29](./Part9-高级主题篇/I1-多Harness架构.md) | 第二十九章：多Harness架构 | 支持 OpenCode、Codex、Pi 的统一抽象 |
| [Ch30](./Part9-高级主题篇/I2-智能体开发的未来.md) | 第三十章：智能体开发的未来 | 趋势预测与设计原则演进 |

---

## 项目信息

- **项目地址**: https://github.com/code-yeongyu/oh-my-openagent
- **官方文档**: https://ohmyopenagent.com
- **Discord 社区**: https://discord.gg/PUwSMR9XNk
- **Sisyphus Labs**: https://sisyphuslabs.ai

---

## 版本信息

- **OmO 版本**: v4.2.3
- **文档生成日期**: 2026-05-21
- **代码库分支**: dev

---

> **"The agent thinks. The agent decides. The agent executes. The human only initiates."**
> （智能体思考。智能体决策。智能体执行。人类只需发起。）思考。智能体决策。智能体执行。人类只是启动者。