功能测试

部署完成后，按以下顺序验证服务可用。

一、健康检查

# 单机：一键诊断
./scripts/doctor.sh
./scripts/doctor.sh --all
./scripts/doctor.sh --logs

# K8s：安装后验证
./scripts/verify-k8s-install.sh

# 网关健康
curl http://localhost:26100/health
# AG-UI 服务健康
curl http://localhost:26103/health

更多健康检查命令见 服务健康检查。

二、基础服务连通性

# PostgreSQL（26110）
docker exec chatkit-postgres psql -U postgres -d chatkit -c "SELECT 1;"

# TimescaleDB（26111）
docker exec chatkit-timescaledb psql -U convstore -d convstore -c "SELECT hypertable_name FROM timescaledb_information.hypertables;"

# NATS（26112）
nc -z <host> 26112

# Redis（26114）
docker exec chatkit-redis redis-cli ping

# TEI（26117）
curl http://localhost:26117/embed -H "Content-Type: application/json" -d '{"inputs":"测试"}'

# Restate（26180/26181）
curl http://localhost:26181/health

K8s 下用 kubectl exec 或 kubectl port-forward 替代，命令见 服务健康检查。

三、入站对话链路冒烟

逐跳健康：

curl http://localhost:26100/health   # api-gateway
curl http://localhost:26103/health   # ag-ui-server
curl http://localhost:26102/health   # orchestrator
curl http://localhost:26450/health   # ai-infra-rs

发一条测试对话（通过 AG-UI SDK 或 api-gateway 直接 POST），确认 api-gateway -> ag-ui-server -> orchestrator -> ai-infra-rs -> delivery 链路通。

四、contract 版本握手验证（关键）

curl http://localhost:26450/health | jq .contract_version

预期：返回非 unknown 的版本号（如 1.2.1）。

若返回 unknown：contract 版本号在镜像构建时内嵌，unknown 属异常镜像，请联系凡泰支持。

五、渠道冒烟（可选）

各发一条测试消息到飞书/企业微信/钉钉机器人，确认 connector 收到并投递。

六、管理员注册

见 管理员注册。

七、license 健康检查

curl -s http://localhost:26101/health | jq .deployment_license

预期：status 为 active（expired 表示已过期，到期时间见 expires_at）。