微信服务号一键部署
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_f12a44b7/self-dev-wechat-service-account-deploy。
技能介绍
解决的问题
把微信服务号接入 LLM 客服时,真正的阻力通常不在模型调用,而在服务器校验、Token 刷新、多类型消息处理、菜单同步、OAuth2、模板消息和反向代理等工程环节。这个技能面向已有公网 IP、域名和微信 AppID / AppSecret 的云主机,把生产级后端部署流程拆成可执行阶段,减少重复搭建 FastAPI、Nginx 和 systemd 服务的成本。
工作方式与适用边界
技能会按阶段完成环境准备、核心代码生成、Nginx 配置、systemd 服务、启动验证和微信平台配置。生成内容覆盖 GET /wechat 验签路由、文本、图片、语音、视频、位置、链接和事件处理,并接入 Hermes LLM 客服、自定义菜单、OAuth2 登录、模板消息推送与 Web 管理后台。资料中特别强调:域名必须解析到服务器公网 IP;SSL 应使用 Let's Encrypt 等正式 CA 证书;.env 密钥建议通过终端追加写入,避免内容脱敏导致配置损坏;pydantic_settings 需要 extra="ignore",wechatpy 验签异常也要显式捕获。它适合快速搭建可运维的微信服务号 AI 后端,不适合没有公网可达环境、未完成域名备案或未获得服务号权限的场景。
使用场景
- 已有 Ubuntu 云主机和域名,要把微信服务号消息接入 Hermes LLM 并上线可验证后端。
- 需要配置 /wechat 验签、Token 刷新、多类型消息路由,并同步自定义菜单到微信。
- 要在 mp.weixin.qq.com 设置服务号 URL、Token 和 IP 白名单前,准备 Nginx、systemd 与 HTTPS 服务。
- 要上线微信 OAuth2 登录和模板消息推送,并查看用户、消息与菜单的管理后台。
适合人员
- 有公网 IP、域名和微信服务号凭证的独立开发者,想快速搭建 AI 客服后端。
- 负责企业微信服务号运营的 IT 工程师,要完成 HTTPS、消息路由与管理后台部署。
- 需要把 Hermes Agent 接入微信模板消息和 API 的应用负责人。
- 运维值班人员,要处理 Nginx、systemd 端口占用和 Let's Encrypt 证书配置。