Nanobot 中文版

本仓库是基于开源 AI Agent 框架 Nanobot 的二次开发与学习版本。我们致力于将其打造为一个对中文开发者和全栈初学者友好的 Agent 学习沙箱。

官方原版说明文档请参见：README_OFFICIAL.md

---

核心改造与亮点

1. 源码注释汉化

我们对项目的大量核心源码英文注释进行了翻译与整理，降低了阅读门槛，帮助你更好地理解 MessageBus、AgentLoop、ToolRegistry 等核心模块的设计与运作。

2. 全套学习教程文档

项目内新增了丰富的保姆级学习文档，包括：

• Python 零基础入门：结合本项目实例，掌握 Python 核心语法与 asyncio 异步编程。
• React 零基础入门：配合本项目的 WebUI 模块，带你从零理解 React 组件、状态管理与流式渲染。
• Nanobot 本身架构学习：深度剖析 Agent 核心工作流、通道管理（Channels）、定时任务（Cron）等系统模块的设计。

3. API 智能限流

新增了基于环境变量配置的 API 请求限流保护，支持 NANOBOT_MIN_REQUEST_INTERVAL_S 环境变量动态调整接口调用间隔，提升了在 QPS 受限网关场景下的安全性和稳定性。

---

适用对象

• AI Agent 开发者：想深入研究工业级 Agent 设计但受阻于英文注释的开发者。
• 全栈初学者：希望通过一个真实的“AI + React 前端 + Python 后端”项目串联技术栈的学习者。