# NEO Bot Framework 开发文档

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

本文档旨在为开发者提供一个清晰、全面的指南，帮助您理解框架的设计理念、核心功能，并快速上手插件开发。

## 📖 文档结构

本站点的文档分为以下几个主要部分：

*   **基础入门**
    *   [快速上手](./getting-started.md): 从零开始配置和运行您的第一个机器人实例。
    *   [项目结构解析](./project-structure.md): 详细介绍框架的目录和文件结构。

*   **核心概念**
    *   [事件流转](./core-concepts/event-flow.md): 深入理解一个事件从接收到处理的完整生命周期。
    *   [单例管理器](./core-concepts/singleton-managers.md): 了解框架中核心管理器（如 `CommandManager`, `PermissionManager`）的设计与使用。

*   **插件开发**
    *   [基础指南](./plugin-development/index.md): 学习如何创建一个插件，包括元数据定义和热重载工作流。
    *   [指令处理](./plugin-development/command-handling.md): 掌握如何使用 `@matcher.command()` 装饰器注册和处理聊天指令。

*   **部署**
    *   [部署指南](./deployment.md): 了解如何在生产环境中部署和维护机器人。

## 🤝 如何贡献

我们欢迎任何形式的贡献，无论是代码提交、文档修正还是功能建议。

*   **报告问题**: 如果您在使用中遇到任何问题或 Bug，请通过内部渠道提交 Issue。
*   **提交代码**: 请遵循项目的编码规范，并通过 Pull Request 流程提交您的代码。
*   **完善文档**: 如果您发现文档中有任何错误或遗漏，可以直接提出修改建议。

我们希望这份文档能让您的开发之旅更加顺畅。如果您有任何疑问，请随时与我们联系。