# NEO Bot Framework 开发文档

欢迎来到 NEO Bot Framework 的官方开发文档。

这里没有废话，只有干货。这份文档会教你如何驾驭这个基于 Python 3.14 的高性能机器人框架。

## 📖 文档结构

### 1. 基础入门
*   [快速上手](./getting-started.md): 环境配置、安装、启动。别跳过，除非你想报错。
*   [项目结构](./project-structure.md): 了解各个目录是干嘛的。
*   [部署指南](./deployment.md): 怎么在服务器上长期运行。

### 2. 核心概念 (必读)
*   [核心架构](./core-concepts/architecture.md): 了解我们是如何把 Python 性能榨干的。
*   [性能优化](./core-concepts/performance.md): 页面池、JIT、Mypyc...黑科技详解。
*   [事件流转](./core-concepts/event-flow.md): 一条消息是如何在系统里流转的（含详细图解）。
*   [单例管理器](./core-concepts/singleton-managers.md): 掌握 `matcher`, `browser_manager` 等核心组件。

### 3. 插件开发
*   [基础指南](./plugin-development/index.md): 怎么写一个最简单的插件。
*   [指令处理](./plugin-development/command-handling.md): 怎么注册命令、解析参数。
*   [最佳实践](./plugin-development/best-practices.md): **重要！** 避免写出卡死机器人的垃圾代码。

## 🤝 贡献

发现 Bug 了？觉得文档写得烂？
直接提 Issue 或者 PR。代码质量是第一位的，Talk is cheap, show me the code.