快速开始

简介

PyWeWork 是一个 Python 企业微信机器人框架，提供了简洁的事件驱动 API，让你能快速开发企业微信自动化应用。

最小示例

from pywework import WeWork, events

# 初始化，指定企业微信版本
wework = WeWork("5.0.3.6005")

# 监听文本消息事件
@wework.handle(events.TEXT_MESSAGE)
def on_text_message(bot: WeWork, event: dict):
    print(f"收到消息: {event['data']['content']}")

# 启动机器人
wework.run()

工作原理

PyWeWork 通过 DLL 注入方式接管企业微信客户端，实现消息的收发和各类操作。框架内部启动一个本地 HTTP 服务用于与注入的 DLL 通信，并通过事件回调通知应用层。

┌─────────────┐     ┌─────────────┐     ┌─────────────────┐
│  你的代码    │ ←── │  PyWeWork   │ ←── │  企业微信客户端  │
│  (事件处理)  │ ──→ │  (框架核心)  │ ──→ │  (DLL 注入)     │
└─────────────┘     └─────────────┘     └─────────────────┘

下一步

• 安装指南 - 安装 PyWeWork 和依赖
• 版本支持 - 查看支持的企业微信版本
• 事件处理 - 学习如何处理各类事件