渐进式教程¶
这一组教程按“从能跑到能上线”的路径组织。每一章只引入一个主要能力,并在结尾留下 一个可以自查的 checkpoint。你不需要先理解全部架构,再开始写插件。
学习路线¶
- 1. 跑通终端 Runtime
建立
Adapter、Event、Plugin和Context的直觉。- 2. 加入命令、规则与权限
让 Runtime 开始有选择地响应消息,并把匹配结果交给 handler。
- 3. 引入状态、会话与中间件
支持多轮交互、持久化状态和横切处理。
- 4. 进入 Webhook 与生产化
补上鉴权、验签、出站回调和观测能力。
- 5. 编写真实适配器
把 Telegram 长轮询适配器拆成配置、接收、归一化、发送和测试。
- 6. 发布到社区商店
走完整的表单、GitHub issue、维护者审核和 registry 合入流程。