zclaw_openfang/docs/INTEGRATION_TEST_REPORT_20260414.md

ZCLAW 三端联调测试报告 2026-04-14

测试类型: 系统性联调测试（SaaS + Admin V2 + Tauri 桌面端） 测试方法: 真实 API curl + Chrome DevTools UI 操作 + Tauri MCP 桌面端操作 + 数据一致性交叉验证 测试时间: 2026-04-14 09:40 ~ 11:00 测试环境: Windows 11 Pro / SaaS :8080 / Admin V2 :5173 / Tauri Dev :1420 / PostgreSQL

---

总览

维度	结果
SaaS 后端 API	30+ 端点测试，27 正常，3 异常
Admin V2 页面	16 页面测试，14 正常，2 有问题
Tauri 桌面端	核心功能 8 项测试，6 正常，2 异常
数据一致性	5 项交叉验证，3 一致，2 不一致
P0 问题	1 个
P1 问题	3 个
P2 问题	3 个
P3 问题	3 个

与上次测试 (2026-04-13) 对比

变化	详情
P0-1 模型不存在	已修复 — deepseek-chat 正常工作
P0-2 中文编码损坏	已修复 — Plans/Roles/Config 中文正确
P1-3 UI 模型选择器	已修复 — Tauri 端模型选择生效
P1-4 Industries 404	根因定位 — SaaS 二进制未重编译
P1-7 用量限额不一致	仍存在 — plan=100, usage.max=2000
P1-8 用量未执行	仍存在 — input_tokens 6.77x 超限
P2-9 Token 计数为零	仍存在 — 17 个任务中 5 个 tokens=0
P2-10 Tauri Token 统计	仍存在 — 桌面端显示"总 Token: 0"

---

P0 CRITICAL

P0-NEW-01: SaaS 运行二进制严重过期

• 现象: 运行中的 zclaw-saas.exe 构建于 2026-04-11 22:38，但代码自 2026-04-12 起有多项关键变更未反映到运行服务中
• 影响范围:
  • Industries API 全部 404（路由在 04-12 添加到 main.rs）
  • Knowledge Phase A 功能不可用（04-12 变更）
  • 任何 04-12 之后提交的修复均未生效
• 证据:
  • 二进制修改时间: 2026-04-11 22:38:20
  • 代码最新影响 main.rs 的提交: c3593d3 2026-04-12 18:36:05
  • git log -- crates/zclaw-saas/src/main.rs 确认有 2 个提交未编译
• 修复: cargo build -p zclaw-saas && 重启 SaaS 服务

---

P1 HIGH

P1-04: Industries API 路由未注册（二进制过期导致）

• 现象: GET /api/v1/industries 返回 HTTP 404
• 根因: P0-NEW-01 — Industry 路由在 5d1050b (2026-04-12) 添加到 main.rs，但二进制未重编译
• 影响:
  • Admin V2 行业配置页面空
  • Tauri 账号编辑弹窗"授权行业"下拉框永久 loading
  • 行业知识域/管家技能优先级不可用
• 代码验证: industry/mod.rs 路由定义正确，main.rs:363 .merge() 注册正确
• 修复: 重编译 SaaS 二进制

P1-07: 用量限额数据不一致

• 现象: Plan 定义 max_relay_requests_monthly=100，但 usage 对象返回 max_relay_requests=2000
• API 证据:

  GET /billing/plans → plan-free.limits.max_relay_requests_monthly = 100
  GET /billing/subscription → usage.max_relay_requests = 2000
  

• UI 影响: Admin V2 计费管理页面 — 免费版卡片显示 "100 次/月"，当前用量显示 "2,000"
• 影响: 用户和 Admin 看到矛盾数据，计费系统不可信

P1-08: 用量限制未执行

• 现象: admin 账户 input_tokens=3,386,978，是 free plan 限额 500,000 的 6.77 倍，无任何拦截
• 影响: 用户可无限使用超出计划限制的资源
• 修复方向: 在 relay 请求前检查 usage 是否超限

---

P2 MEDIUM

P2-09: 29% Relay 任务 token 计数为零

• 现象: 17 个已完成 relay 任务中 5 个 input_tokens=0, output_tokens=0
• 证据:

  5b85b045... completed tokens=0/0
  644134f4... completed tokens=0/0
  25820499... completed tokens=0/0
  a37669b0... completed tokens=0/0
  539b26a8... completed tokens=0/0
  

• 修复方向: 检查 relay 完成后 token 统计逻辑，某些路径可能跳过了 token 累加

P2-10: Tauri 端 Token 统计为 0

• 现象: 详情面板"用量统计"显示"总 Token: 0"，但 SaaS relay 有真实 token 使用记录 (3,386,978 input + 197,420 output)
• 影响: 桌面端用户无法看到自己的 token 消耗
• 修复方向: Tauri 端应从 SaaS API 获取 usage 数据而非本地累计

P2-14: Subscription 为 null

• 现象: admin 账号的 billing.subscription 为 null，使用默认 free plan
• 影响: 无法区分"主动订阅"和"默认计划"

---

P3 LOW

P3-19: Admin API 密钥页面路由指向 ModelServices 组件

• 现象: 侧边栏 "API 密钥" 按钮 (/api-keys) 加载了 ModelServices 组件，而非独立的 API 密钥管理页面
• 代码: admin-v2/src/router/index.tsx:29 懒加载 ModelServices 用于 api-keys 路径
• 可能是设计如此（Provider 管理 = Key 池管理），但页面标题与内容不匹配

P3-15: antd Modal destroyOnClose 废弃

• Admin V2 多个页面使用 destroyOnClose，antd 新版应使用 destroyOnHidden

P3-16: onSearch React DOM 属性警告

• 知识库页面 Unknown event handler property onSearch

---

已验证正常的功能

SaaS 后端 API (27/30 正常)

模块	端点	状态	数据验证
Auth	login/refresh/me/password/totp-setup	✅	JWT+rotation 正常，TOTP secret 生成正确
Accounts	CRUD/搜索/状态切换	✅	30 个账号，分页正常
Providers	CRUD	✅	3 Provider (DeepSeek/Kimi/zhipu)，Key 池正常
Models	CRUD/列表	✅	3 模型 (deepseek-chat/GLM-4.7/kimi-for-coding)
Relay Chat	流式+非流式	✅	核心链路正常，真实 LLM 响应
Relay Tasks	列表	✅	17 个真实任务
Billing Plans	列表	✅	3 计划，中文正确
Billing Usage	查询	✅	详细用量统计
Roles	列表	✅	3 角色，权限列表正确
Agent Templates	列表	✅	10 模板（含 4 行业）
Knowledge	CRUD/搜索	✅	6 分类/6 条目，搜索返回带分值结果
Knowledge Analytics	overview	✅	统计数据完整
Config	items/analysis	✅	62 配置项，8 分类
Dashboard Stats	聚合	✅	30 账号/3 Provider/3 模型
Operation Logs	列表	✅	2,047 条日志
Provider Keys	Key 池	✅	RPM/TPM/cooldown 追踪正常
Prompts	列表	✅	3 内置提示词
Scheduler	任务列表	✅	路径正确 (/api/v1/scheduler/tasks)

Admin V2 管理后台 (14/16 正常)

页面	数据来源	交互验证
仪表盘	✅ API 实时数据	30 账号/3 Provider/3 模型/14 tokens 全部与 API 一致
计费管理	✅ Plans + Usage	3 计划卡片正确，用量进度条准确
账号管理	✅ 30 账号	编辑弹窗/搜索/分页/状态切换全部正常
角色权限	✅ 3 角色	权限列表正确，模板 tab 为空（符合预期）
模型服务	✅ 3 Provider	展开 Provider 显示 Key 池和模型
Agent 模板	✅ 10 模板	列表/筛选正常
知识库	✅ 6 分类/6 条目	5 个 tab 全部有数据
用量统计	✅ 30 用户统计	图表渲染正常
中转任务	✅ 9 任务	全部显示 completed
操作日志	✅ 2,039 条	分页/筛选正常
系统配置	✅ 62 配置项	6 个 tab 分类清晰
提示词管理	✅ 3 提示词	列表正常
同步日志	✅ 空（符合预期）	页面正常渲染
定时任务	✅ 空（符合预期）	页面正常渲染

Tauri 桌面端 (6/8 正常)

功能	状态	验证结果
Gateway 连接	✅	saas-relay 模式，http://127.0.0.1:8080
模型选择	✅	deepseek-chat 正确匹配 SaaS 白名单
聊天发送/接收	✅	发送"你好"→ 收到"你好！很高兴为你服务"
对话历史	✅	7 个对话，114 条消息，时间戳正确
设置页面	✅	19 个设置页全部可访问，Gateway 状态正确
简洁/专业模式	✅	切换按钮正常，管家快捷操作可见
用量统计	❌	总 Token 显示 0（P2-10）
行业下拉框	❌	编辑账号时"授权行业"永久 loading（P1-04）

---

数据一致性交叉验证

验证项	SaaS API	Admin V2	Tauri	一致?
账号总数	30	30	-	✅
Provider 数	3	3	3	✅
模型数	3	3	3	✅
Relay 请求数	561	553	-	✅ (差 8 = 测试期间新增)
Operation Logs	2,047	2,039	-	✅ (差 8 = 并发写入)
当前模型	deepseek-chat	-	deepseek-chat	✅
Plan max_relay	100	100	-	✅
Usage max_relay	2,000	2,000	-	❌ 与 Plan 不一致

---

测试环境信息

项目	值
SaaS 后端	http://localhost:8080 (zclaw-saas.exe PID=10976, build 2026-04-11)
Admin V2	http://localhost:5173 (Vite dev server)
Tauri Dev	http://localhost:1420 (saas-relay 模式)
PostgreSQL	localhost:5432/zclaw
Admin 账号	admin / admin123 / super_admin
截图位置	tests/screenshots/admin-*.png

---

修复优先级建议

1. 立即: 重编译 SaaS 二进制 → 解决 P0-NEW-01 + P1-04
2. 发布前: 修复 P1-07 (用量限额不一致) + P1-08 (用量未执行)
3. 发布后: P2-09 (token 计数) + P2-10 (Tauri 统计) + P2-14 (subscription null)