# NEO Bot 开发文档

嘿，朋友，欢迎来到 NEO Bot

这里没那么多规矩。这份文档是我写给你——未来的插件开发者、或者单纯好奇想拆开看看的家伙——的一份地图


## 📖 地图导览

### 1. 准备阶段
*   [快速上手](./getting-started.md): 搭环境、装东西、启动。跟着走一遍，能省不少事。
*   [项目怎么样](./project-structure.md): 看看各个文件夹都是干嘛的，免得迷路。
*   [生产环境](./deployment.md): 怎么把你调教好的 Bot 扔服务器上，让它自己 7x24 小时跑。

### 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. API 参考
*   [API 总览](./api/index.md): 所有 API 的快速导航和调用方式
*   [消息 API](./api/message.md): 发消息、撤回、转发、合并转发
*   [群组 API](./api/group.md): 管群、禁言、踢人、改名片
*   [好友 API](./api/friend.md): 好友列表、点赞、加好友请求
*   [账号 API](./api/account.md): 机器人自己的信息、状态设置
*   [媒体 API](./api/media.md): 图片、语音相关

### 4. 插件开发
*   [插件开发第一步](./plugin-development/index.md): 带你写第一个插件
*   [指南](./plugin-development/command-handling.md): 怎么教你的 Bot 听懂指令和参数。
*   [绝对不要做的事情](./plugin-development/best-practices.md): **（必读！）**

##  贡献

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