iamai 文档

iamai 是一个面向插件开发和多平台接入的消息运行时。业务代码写成普通 Python 插件； 适配器负责协议边界；配置、权限、状态、审计和文档都作为工程能力保留下来。

快速开始 · 渐进式教程 · 社区资源

先跑起来

从安装、配置检查和终端 Runtime 开始，确认本地开发链路是通的。 安装与环境 · 快速开始

写业务插件

学命令、规则、权限、状态、会话和中间件，逐步把 Runtime 写成可维护模块。 渐进式教程 · 插件系统

接入平台

理解 Adapter 边界，使用 OneBot11、Telegram、Webhook 或编写自己的适配器。 适配器 · 第五步：编写一个可用适配器

准备上线

检查配置、安全、Webhook 签名、质量门禁、运维和社区发布流程。 运维与安全 · 参考手册

文档路线

新用户

先读 核心概念，再跑 快速开始，随后按顺序完成 渐进式教程。

插件作者

重点看 插件系统、规则参考、状态与会话 和 插件与适配器发布参考。

适配器作者

重点看 适配器、第五步：编写一个可用适配器 和 API 参考里的 iamai.adapter。

社区贡献者

先查看 BLOG 和 社区商店，再按 第六章：发布到社区商店 提交条目。

设计取向

• 插件只关心统一的 Event、Message、Context 和声明式规则。

• 适配器集中处理网络、鉴权、协议字段、重连、回包和平台 API。

• 配置在启动前校验，生产风险通过参考文档和质量门禁显式暴露。

• 社区条目使用静态 registry，适合 GitHub Pages 和 Pull Request 审核流程。