中文名：查小特（AI 对话微信公众号/H5 网页服务器）
作者：freebr
- 1.公众号“广州欧讯服科技有限责任公司”
- 2.微信打开 https://freebr.cn/oxf/chat/
- 在微信公众号管理后台获取
APPID,APPSECRET,APPTOKEN,ENCODING_AES_KEY信息，填入config/api-keys.yml.tmpl中的对应字段 - 在微信支付管理后台获取
APIV3_KEY,APPID,CERT_SERIAL_NO,MCHID信息，填入config/wx-pay.yml.tmpl中的对应字段 - 在 OpenAI 账号后台获取 API key，填入
config/config.yml.tmpl的Services.OpenAI - 按照提示修改
config/config.yml.tmpl的其他配置 - 把
config/config.yml.tmpl文件名的.tmpl删除 - 如需使用讯飞 TTS（文本转语音）服务，需在
bin/tts/xf-tts目录下，把main.c中的<appid>替换为讯飞 API key，然后运行make编译xf-tts程序
[chatty_ai]# python src/main.py
[chatty_ai]# . bin/start.sh
- 4核8G环境完整构建时间约
70s
[chatty_ai]# docker compose up -d
正常情况时的日志输出：
2023-03-17 08:37:44,709 - BOT - INFO: 敏感词词典加载成功，数量：17270
2023-03-17 08:37:44,711 - BOT - INFO: 加载服务[PhoneService]成功
2023-03-17 08:37:44,711 - BOT - INFO: 加载服务[WeatherService]成功
2023-03-17 08:37:44,711 - BOT - INFO: 加载服务[ExpressService]成功
2023-03-17 08:37:44,711 - BOT - INFO: 加载服务[IpService]成功
2023-03-17 08:37:44,711 - BOT - INFO: 加载服务成功，数量：4
2023-03-17 08:37:44,757 - USERMGR - INFO: VIP 用户列表加载成功
2023-03-17 08:37:44,757 - AUTOREPLYMGR - INFO: 自动回复消息模板加载成功
2023-03-17 08:37:44,758 - ARTICLEMGR - INFO: 文章 ID 列表加载成功，数量：2
2023-03-17 08:37:44,758 - GROUPCHATMGR - INFO: 群聊 ID 列表加载成功，数量：2
2023-03-17 08:37:44,758 - GROUPCHATMGR - INFO: 加载语音角色信息成功，TTS类型：ms-tts，数量：38，推荐角色数量：5
2023-03-17 08:37:44,759 - CONTROLLER - INFO: 用户 oKXSw6j9Mkw7sRgRSBO3jeRRjZ4Q 发送消息，长度：12
2023-03-17 08:37:44,764 - BOT - INFO: 消息数量：2
2023-03-17 08:37:44,764 - openai - DEBUG: message='Request to OpenAI API' method=post path=https://api.openai.com/v1/chat/completions
- 用
supervisord来监测运行状况，将以上命令写入supervisord.conf或相关配置文件中，实现开机或意外中止时自动运行 - 用
tail logs/*.log -f监测服务运行日志
打开查看
bin: 命令存放目录
tts: TTS 服务
xf-tts: 讯飞 TTS 服务（命令位于
bin子目录）start.sh: 不用容器时，本服务的部署命令
cert: 证书存放目录
wxpay: 微信支付相关证书
client: 微信支付 SSL 证书
key: 微信支付商户证书和私钥
config: 配置文件存放目录
config.yaml.tmpl: 配置文件模板，部署服务器时需将后缀改成
.yaml并修改配置内容方可运行）prompt-free.txt: 嵌入提示文件（适用于免费用户，不支持搜索、浏览网站和总结网页）
prompt-vip.txt: 嵌入提示文件（适用于 VIP 用户）
data: 运行时数据存放目录
images: 图片文件存放目录（所有图片均可通过 API:
image/<type>/clear删除）avatar: 用户头像存放目录（结合网页版使用）
img2img: 图生图输出图片存放目录
markdown: 消息 Markdown 代码内提取图片存放目录
poster: 分享海报图片存放目录
qrcode: 分享/Native支付二维码图片存放目录
upload: 用户上传图片存放目录
sensitive-words: 敏感词典存放目录（自行上传
*.txt格式文件，每行一个词语）tts: 合成语音输出文件存放目录
azure-tts: Azure TTS 合成语音输出文件存放目录
xf-tts: 讯飞 TTS 合成语音输出文件存放目录
users: 用户账号信息存放目录
vip-list.json: VIP 用户 openid 列表
pay-info.yaml: 支付信息列表
docker-files: Docker 镜像构建所需文件
clash-config: Clash 配置文件，应包含
Country.mmdb,config.yamlredis: Redis 配置文件，应包含
redis-stack.conflogs: 日志目录
<日期>.log: 服务器在<日期>启动时创建的日志文件
src: 模块所在目录
controller: 控制器模块
api_controller.py: API 控制器，实现微信消息收发和事件处理、与
bot实例的消息通信、RESTful API 接口等static_controller.py: 静态页面控制器，响应静态页面请求，如环境已部署
nginx,apache等 HTTP 服务器则不必使用websocket_controller.py: Websocket 服务控制器，实现基于 WSS 服务器的消息收发、与
bot实例的消息通信，用于面向支持流式输出的客户端（如 Web 端、小程序、APP）提供服务definition: 全局常量、变量、类定义模块
cls.py: 单例类（
Singleton、AbstractSingleton）定义模块const.py: 全局常量和环境变量定义模块
var.py: 全局变量定义模块
crypt: 微信消息加解密 SDK 目录，[详见官方文档](https: //developers.weixin.qq.com/doc/offiaccount/Message_Management/Message_encryption_and_decryption_instructions.html)
handler: 处理程序模块
code_snippet_handler.py: 代码片段处理程序，实现将消息中代码片段链接到在线调试工具
image_handler.py: 图片处理程序，目前用于实现对图片的裁剪等功能
message_handler.py: 消息内容处理程序，目前用于实现对消息的分段输出、敏感词过滤
wave_handler.py: 波形文件处理程序，实现对
*.wav波形文件到*.amr文件的转换helper: 辅助模块
formatter.py: 格式化模块，包含各种对字符串进行编解码和封装的常用函数
token_counter.py: token 计数器实现模块
wx_menu.py: 微信公众号菜单内容定义模块
manager: 组件模块
article_manager.py: 公众号文章组件模块，实现公众号文章地址的存取查询（推广告用）
autoreply_manager.py: 自动回复组件模块，实现公众号各种情况下的自动回复内容的存取查询
chatgroup_manager.py: 群聊信息组件模块，实现群聊二维码链接的存取查询
feature_manager.py: 特性信息组件模块，实现特性信息的存取查询（AI 支持的各种功能称为特性）
img2img_manager.py: 以图生图组件模块，实现以图生图功能
key_token_manager.py: 密钥令牌组件模块，实现微信公众号及第三方服务的密钥和令牌的存取查询
payment_manager.py: 支付组件模块，实现微信支付功能调用、回调事件中转、支付信息列表的存取查询
poster_manager.py: 分享海报组件模块，实现分享海报的生成
qrcode_manager.py: 二维码组件模块，实现二维码的生成
user_manager.py: 用户信息组件模块，实现用户和账号信息的存取
voices_manager.py: 合成语音组件模块，实现合成语音接口的调用
wx_access_token_manager.py: 微信 access token 组件模块，实现微信公众号 access token 的查询和定时更新
wxjsapi_manager.py: 微信 JSAPI 组件模块，通过调用微信 JSAPI 实现 H5 页面授权的功能，详见[官方文档](https: //developers.weixin.qq.com/doc/offiaccount/OA_Web_Apps/JS-SDK.html)
monitor: 监视模块
user_monitor.py: 用户信息监视模块，实现每日统计信息刷新
service: 服务模块，实现 AI 对话和特性调用的流程
feature: 特性存储引擎和控制逻辑实现模块
memory: 存储引擎实现模块
base.py: 存储引擎类基类定义模块
redismem.py: Redis 存储引擎类定义模块
utils: 控制逻辑实现模块
command_executor.py: 命令中转处理模块
json_parser.py: JSON 对象解析模块，用于处理命令参数
bot_service.py: 实现 OpenAI LLM 接口调用，其他服务依赖此服务
browse_service.py: 实现网页信息浏览和内容摘要提取
exchange_service.py: 实现实时汇率查询
express_service.py: 实现快递物流进度查询
image_service.py: 实现图片生成
ip_service.py: 实现 IP 归属地查询
joke_service.py: 实现笑话查询
movie_service.py: 实现上映电影信息查询
phone_service.py: 实现手机号码归属地查询
search_google.py: JSON 对象解析模块，用于处理命令参数
weather_service.py: 实现实时和预报天气查询
wolfram_service.py: 实现 Wolfram|Alpha 知识引擎信息查询
configure.py: 配置类实现模块
main.py: 程序入口
static: 静态页面存放目录
supervisor: supervisord 服务的配置存放目录
docker-compose.yml: Docker Compose 配置文件
api.Dockerfile: 接口服务器 Docker 镜像配置文件
redis.Dockerfile: Redis 服务器 Docker 镜像配置文件
- 服务模块类似 ChatGPT Plugin 的工作方式，都是通过系统提示的方式向 ChatGPT 提供原来的 LLM 不掌握的信息，不同在于调用服务的决定方是每一个服务而非 ChatGPT 本身。
- 每个服务都提供 2 个方法：
invoke,__real_query，作用如下：invoke: 调用服务得到可用于生成系统提示的结果，由BotService调用__real_query: 服务的核心程序，应以结构化的格式（如list,dict）返回结果，由invoke方法调用
- 加入实时新闻查询组件模块
- 重构敏感词汇过滤模块，提高过滤速度
- 支持其他语种/方言的语音消息识别
- 引入 VisualGPT 模型实现图片信息提取
- ...
- 欢迎提交 PR、提出新功能建议或报告 BUG，以及Star支持一下。程序运行遇到问题优先查看常见问题列表，其次前往 Issues 中搜索。如果你想了解更多项目细节，并与开发者们交流更多关于AI技术的实践，欢迎加入星球：
独立开发不易，觉得项目有用帮到你的话，就请作者喝杯可乐🥤叭🤗
