公网实例 yh.hiruiai.com yanghe 服务自检中…

阳合仓储 · 企微会话 AI 归类智能体V1.0

纯后端服务:企微会话存档 → 消息落库 → 大模型归类 → 写入企微智能表格。本页为公网联调环境开发入口,不是业务界面(交付包原首页仅一行占位文字)。

服务拓扑 qiwe_fproxy 状态为实时探测,其余为内网容器

Nginx 入口 当前页面
容器 yanghe-nginx
端口 443 / 80
主机 Nginx 443 → 容器 18080 → qiwe_fproxy:8901,证书 Let's Encrypt 自动续期
会话存档代理 检测中…
容器 yanghe-qiwe
仅本机 127.0.0.1:18901 → 8901
FastAPI:/wag/callback 回调、/sdk/* 拉取、/api/archive/* 归档
智能表格写入 内网 3000
容器 yanghe-tablewrite
端口 不对外暴露
Flask:读 detail_messages → 模型归类 → 写智能表格(定时轮询)
MySQL 8.0 healthcheck 通过
容器 yanghe-mysql
仅本机 127.0.0.1:13306 → 3306
库 my_database,账号 wag,已建 5 张业务表

数据表 init_database() 已执行

表名用途状态
origin_messages企微原始会话消息(seq / msgid 去重)已建
detail_messages解析后的明细消息,归类服务的数据源已建
archive_members会话存档成员已建
archive_groups客户群 / 群聊信息已建
external_contacts外部联系人已建

待补配置 补完才会真正跑通企微与模型链路

优先级文件缺失项影响
P0 config/.env.qiwe_fproxy WECHAT_TOKEN / ENCODING_AES_KEY / CORP_ID
WECHAT_ARCHIVE_SECRET / EXTERNAL_SECRET
回调验签失败、会话拉不到(当前 access_token 报 40013 invalid corpid)
P0 config/.env.wecom_table_write ARK_API_KEY / DASHSCOPE_API_KEY
WECOM_CORP_ID / APP_SECRET / AGENT_ID / WEBHOOK_URL
SMARTSHEET_DOC_ID / SHEET_ID / WEBHOOK_URL
模型归类与写入智能表格不可用
已完成 SSL 证书 Let's Encrypt,有效期至 2027-02-16 acme.sh 自动续期,可直接用于企微回调
P0 企微「可信IP」 需添加 118.196.29.148 未添加则调 gettoken / 拉消息报 IP 白名单错误

常用命令

# 进入部署目录
cd /opt/yanghe

# 查看状态 / 日志
docker compose ps
docker compose logs -f qiwe_fproxy
docker compose logs -f wecom_table_write

# 改完 src/ 源码后重建镜像并替换
docker compose -f docker-compose.yml -f docker-compose.build.yml up -d --build

# 查数据库
docker exec -it yanghe-mysql mysql -uroot -p'toor@4rfv' my_database -e "show tables;"

# 接口自检
curl https://yh.hiruiai.com/status
curl https://yh.hiruiai.com/api/archive/access_token