WeRoBot 1.9.0 微信公众号开发框架文档

《WeRoBot 1.9.0 微信公众号开发框架文档》总结如下： --- ### 1. **框架概述** - **WeRoBot**：一个轻量级的微信公众号开发框架。 - **核心功能**： - 消息处理、自定义菜单、Session管理、消息加解密。 - 提供微信API操作类`WeRoBot.Client`，支持用户管理、素材管理等。 - 支持与Django、Flask、Tornado等Web框架集成。 --- ### 2. **核心功能与配置** - **消息处理**： - 支持文本、图片、链接、地理位置等多种消息类型。 - 通过`@robot.handler`装饰器定义消息处理逻辑，可指定处理特定类型的消息（如`@robot.text`、`@robot.image`）。 - **Session管理**： - 支持通过`SQLiteStorage`或`FileStorage`存储用户会话数据。 - 示例：`session_storage = SQLiteStorage()`，将Session数据存储在SQLite数据库中。 - **消息加解密**： - 配置`APP_ID`和`ENCODING_AES_KEY`后，框架自动处理消息加解密。 - **自定义菜单**： - 通过微信API创建、更新和删除自定义菜单。 --- ### 3. **版本更新与改进** - **Version 1.9.0**： - 完善`werobot.messages`模块，增加对Event的支持。 - 增加`werobot.reply.SuccessReply`、`ImageReply`等新Reply类型。 - 删除过时的`werobot.reply.create_reply()`方法。 - 修复`FileStorage`在PyPy下的兼容性问题。 - **Version 1.0.0**： - 增加对消息加解密的支持。 - 重命名`werobot.messages`中的`id`属性为`message_id`。 - **Version 0.6.0**： - 增加@werobot.filter装饰器，支持过滤指定文本的消息。 - 添加微信支付（`werobot.pay.WeixinPayClient`）支持。 - **Version 0.5.3**： - 修复根路径请求处理问题。 --- ### 4. **部署与集成** - **独立服务器部署**： - 使用`werobot.run()`启动WSGI服务器，支持配置HOST、PORT等参数。 - 示例：`robot.run(host="0.0.0.0", port=80)`。 - **与Web框架集成**： - **Flask**：通过`werobot.contrib.flask.make_view`生成Flask视图。 - **Django**：通过`werobot.contrib.django.make_view`生成Django视图。 - **Bottle**：直接在Bottle应用中集成WeRoBot。 - **SAE部署**： - 支持在百度智能应用引擎（SAE）上部署。 --- ### 5. **快速入门示例** #### Hello World ```python import werobot robot = werobot.WeRoBot(token='tokenhere') @robot.handler def hello(message): return 'Hello World!' robot.run(host='0.0.0.0', port=80) ``` --- ### 6. **其他功能** - **图文回复**：通过`ArticlesReply`和`Article`类构建图文消息。 - 每个`ArticlesReply`最多添加1个`Article`。 - 示例： ```python from werobot.replies import ArticlesReply, Article reply = ArticlesReply() article = Article(title="WeRoBot", description="微信机器人框架") reply.add_article(article) ``` - **微信API操作**： - 支持用户管理、素材管理、模板消息等功能。 --- 以上总结涵盖了WeRoBot框架的核心功能、配置、部署和快速入门内容，着重突出关键信息和使用场景。