微信公众号 AI Bot 工作流

要解决什么问题

微信公众号被动回复有 5 秒超时：若在回调里同步等 LLM，用户收不到回复或后台验签失败。安全模式下还要处理 AES-CBC-256 加解密、GET 验签与 POST 消息两套逻辑，再叠加 access_token、客服消息、菜单与可选 RAG，从零搭一套可上线的 Bot 很容易在多站文档和部署细节里反复踩坑。

技能如何工作

本 Skill 把鸿爪派「从 0 到跑通」的路径收成 8 步工作流，由 Agent 按阶段执行，而不是拆成多个互不连贯的站点：

1. 需求与架构：明确 Bot 人设、功能清单（文本/图片/语音/菜单等）与 AI 服务（OpenAI 兼容 API）；固定 异步 + 客服消息（先返回 success，再推送回复）、对话 30 分钟 TTL / 最多 20 条 裁剪。
2. 一次性生成代码：app/config.py、wx_crypto.py、ai_client.py、wx_api.py、conversation.py、message_handler.py、可选 lexiang_client.py、main.py 及 run.py，附带 .env.example、systemd、Nginx 模板等。
3. 部署与对接：SFTP、pip 依赖、systemd 启动；Nginx 反代 /wx-callback；微信后台 IP 白名单、服务器 URL、Token、EncodingAESKey；文档中记录了 GET 验签 msg_signature / 四参数 SHA1 / 返回解密明文 等实战 Bug。

可选环境变量支持乐享 MCP RAG（LEXIANG_*），无命中时可写入知识库收集未覆盖问题。

适用边界与注意点

• 你需要自行准备 WXAPPID / APPSECRET / TOKEN / EncodingAESKey 与 AIAPI_KEY，并在公众号后台完成人工配置；启用服务器配置后，后台「自动回复」会关闭。
• 客服消息仅在用户发消息后的 48 小时内可主动推送；域名走 CDN 时需先配好 /wx-callback 回源，再在微信后台提交 URL。
• 对话上下文默认 内存字典，单进程够用；多实例或持久化需自行改 Redis。AI 服务需支持 OpenAI 格式的 chat/completions（及按需的 images API）。