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

18 lines
1.5 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

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