python-wechat-kf/docs/tasks/task_detail_2026_04_27.md

任务执行摘要

会话 ID: 1

• [2026-04-27 16:10:00]
• 执行原因: 实现微信客服 API 网页测试应用，支持监听用户消息、主动/被动发送消息、消息存储到 PostgreSQL
• 执行过程:
  1. 创建项目目录结构（app/models, app/services, app/routes, app/static, app/templates）。
  2. 实现配置层：config.py（pydantic-settings 读取 .env）和 .env.example 模板。
  3. 实现数据库层：database.py（AsyncEngine + session）和 models/message.py（Message ORM）。
  4. 实现微信 API 客户端：token_manager.py（access_token 内存缓存 + asyncio.Lock）和 wechat_client.py（send_msg / sync_msg）。
  5. 实现回调加解密：crypto.py（签名验证、AES-256-CBC 解密、URL 验证、消息解密）。
  6. 实现路由层：webhook.py（GET 验证 / POST 接收回调）、api.py（会话列表/消息查询/发送/同步）、pages.py（Jinja2 模板渲染）。
  7. 实现消息业务层：message_service.py（消息保存去重、会话列表、消息分页、发送并记录）。
  8. 实现前端界面：index.html（左侧会话列表 + 右侧消息气泡 + 底部输入框）和 app.js（原生 JS 交互）。
  9. 实现主入口：main.py（FastAPI 挂载路由 + 静态文件 + lifespan 建表）和 run.py（uvicorn 启动）。
  10. 安装依赖并验证完整导入链和路由注册。
• 执行结果: 项目全部 19 个源文件创建完成，导入链和路由验证通过。用户需创建 .env 文件配置微信参数后即可 python run.py 启动。