Agent Skills
返回列表
🤖

微信公众号 AI Bot 工作流

AI Agent 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中：

请根据 https://skillhub.cn/install/skillhub.md，安装 @user_f12a44b7/wx-service-bot。

技能介绍

要解决什么问题

微信公众号被动回复有 5 秒超时，安全模式下还要做 AES-CBC-256 加解密 和验签。自己从零搭 FastAPI、微信 API、OpenAI 兼容客户端，再配 Nginx、CDN 回源和后台服务器 URL，步骤多且验签、客服消息窗口等细节容易踩坑。

技能如何工作

本 Skill 把「鸿爪派」从 0 到跑通的流程拆成 8 步提示词模板，让 AI 按固定架构产出代码并指导部署：

  • 异步 + 客服消息：回调立刻返回 success，后台异步推理，再用客服消息推送（48 小时窗口）。
  • 模块清单：config、wx_crypto、ai_client、wx_api、conversation、message_handler、可选 lexiang_client、main.py 等，覆盖文本/图片/语音/事件与菜单。
  • 对话上下文：内存字典 + 30 分钟 TTL、超过 20 条裁剪，避免 token 膨胀。
  • 部署与联调：SFTP、systemd、Nginx 反代 /wx-callback，以及微信 IP 白名单、安全模式 URL/Token/EncodingAESKey 的配置顺序说明。

文档里还记录了 GET 验签的 msg_signature、四参数 SHA1、返回解密明文 等实战 Bug，以及 CDN 回源、access_token 缓存等备忘。

适用边界

你需要自备公众号 AppID/AppSecret/Token/EncodingAESKey、可公网访问的域名与服务器，以及 OpenAI 兼容 的 AI API（如 Agnes、OpenAI）。乐享 RAG 为可选能力，需额外 MCP 配置。单进程内存会话适合中小流量；高并发或多实例需自行改 Redis 等存储。

使用场景

  • 已有备案域名与 Linux 服务器，要在微信安全模式下接入 AI 回复，并满足被动回复 5 秒超时约束。
  • 后端需要一次性产出含 `wx_crypto` 验签、对话上下文 TTL 与客服消息推送的 Python 项目并完成远程部署。
  • 希望按 Bot 人设与功能清单（文本/图片/语音/菜单）生成代码，并运行 `setup_menu.py` 创建自定义菜单。
  • 域名走 EdgeOne 等 CDN，需先配 `/wx-callback` 回源与 IP 白名单，再在微信后台启用服务器配置并通过 GET 验签。

适合人员

  • 维护企业服务号智能回复的后端开发，要落地异步回调 + 客服消息架构并对接 OpenAI 兼容 API。
  • 从 0 搭建资讯/社区类公众号 Bot 的全栈工程师，希望用 8 步提示词模板替代分散的多工具流水线。
  • 用宝塔或自建 Nginx 管反代的运维，负责把 `/wx-callback` 代理到 8000 并处理验签与 CDN 418/404 问题。
  • 已申请公众号并拿到 AppID/AppSecret 的技术负责人，需要按文档顺序完成白名单、安全模式与端到端联调。