版本历史

PandaTest 各版本更新记录。

[1.1.6]

发布日期：2026-05-05

站内通知中心

  • 通知收件箱：顶部导航栏新增铃铛图标，点击展开通知面板，按「全部 / 告警 / 任务 / 系统」分 Tab 浏览，支持单条已读、全部已读与清空。
  • 设备告警站内推送：Agent 离线、设备离线、设备高温等告警事件现在会同步生成站内通知（推送给所有 staff 用户），不再仅依赖外部 Webhook。
  • 站内通知模型：后端新增 UserNotification 模型，按用户独立存储、支持已读标记与类型过滤。

iOS 性能采集

  • 完整 iOS 性能链路：性能工作台现在完整支持 iOS 设备（CPU / 内存 / FPS / GPU / 网络 / 电池等），与 Android 图表共享统一组件。
  • 平台分离配置：性能配置面板与工作台按 Android / iOS 拆分为独立组件，各自适配平台特有指标（如 iOS jank / big_jank / thermal_state）。
  • 状态机增强：新增 preparing 状态，等待目标 App 启动时给出明确提示。

iOS 云真机增强

  • Syslog 终端重写：iOS 系统日志终端改用 xterm.js 渲染，支持关键词搜索、暂停/恢复、大日志量流畅滚动。
  • DevTools 自动重连：iOS DevTools WebSocket 连接支持指数退避自动重连（默认 5 次），断线后无需手动刷新。
  • UI 层级树：新增 iOS UI 层级检查能力。
  • WDA 代码补全：脚本编辑器新增 WDA API 自动补全提示。
  • iOS 脚本编辑器：云真机编辑器支持 iOS 设备脚本编写与运行。
  • 工具栏调整：iOS 工具栏移除不常用的左滑/右滑按钮，新增设置与帮助入口。

设备管理增强

  • 资产编号：设备新增 asset_id 字段，可在设备详情查看与编辑。
  • 设备详情页升级：支持一键将设备切换为维护模式（需填写原因）或恢复上线。
  • 设备表格行内编辑：云设备列表支持行内编辑设备名称等字段。
  • 机架布局拖拽：机架视图改用 @dnd-kit 拖拽交互，支持从未分配面板直接拖入机位、机位间移动、拖出移除。

WebSocket 自动重连

  • Android 投屏重连：视频 WebSocket 断线后自动以指数退避策略重连（默认 5 次 / 基础延迟 1.5s），多设备同屏场景更稳定。
  • iOS DevTools 重连：同上，默认 5 次 / 基础延迟 1s。

体验优化与代码清理

  • 统一 AppIcon 组件：新建 AppIcon 组件统一处理应用图标显示，自动按平台加载 APK / IPA 默认占位图。
  • 告警设置页简化：告警配置表单精简冗余字段，改为更紧凑的布局。
  • 移除过时代码：删除 ThemeSwitch、device-border-utils、ui-hierarchy-codegen、ui-hierarchy-xml 等不再使用的模块。
  • 设备边框简化：device-frame 去除冗余边框计算逻辑，渲染更轻量。

[1.1.5]

发布日期：2026-04-27

AI 专项测试（全新模块）

  • 自然语言驱动：在「专项测试 → AI 专项测试」直接用一句话描述测试目标，例如「覆盖主要页面与功能」「测试购物下单流程」「验证登录注册功能」「检测崩溃和 ANR」，平台会驱动真机自动探索并记录结果。
  • 场景生成：可在执行前先让 AI 拆出一组候选用例，勾选后再下发；支持上传 PRD、需求文档、用例 Excel、参考截图作为生成上下文（PDF / DOCX / MD / XLSX / 图片等）。
  • 执行页全新视图：左侧用例 To-do 与每条用例的执行时间线、中间真机投屏与屏幕路径图（节点带重复访问角标、跳转边动态生长）、右侧节点详情与按时间汇总的步骤列表。
  • 运行中追加指令：执行过程中可继续向 AI 发消息，临时调整目标或跳过当前用例。
  • 多设备并行：一次配置可勾选多台真机并行下发；执行结果按设备分别归档。
  • 失败可追溯：每一步都保留模型的思考、动作、截图与设备日志，失败用例自动标红并附失败原因。
  • 多平台：同时支持 Android / iOS / 鸿蒙（HAP） 应用上传与执行。

大模型管理

  • 系统设置 → 模型管理：新增统一的服务商与模型管理界面，支持新增 / 编辑 / 删除、连通性测试与启用开关。
  • 内置常见厂商：开箱即用 OpenAI、DeepSeek、阿里云百炼、火山方舟等模板；任何兼容 OpenAI 协议的服务都可作为自定义服务商接入。
  • 视觉模型：可标记模型是否具备视觉能力，AI 专项测试默认优先使用视觉模型，识别复杂界面更准确。
  • API Key 加密存储：密钥仅在下发到 Agent 时短时解密，控制台与日志中均以掩码展示。
  • 配置即下发：在 AI 专项配置中选择模型即可，Agent 端不再需要单独维护 LLM 凭证。

云真机与构建体验

  • 应用选择器升级：原下拉换成可搜索的 Popover，长列表也能秒速过滤。
  • 云端 UHID 键盘：云真机投屏支持 UHID 标准键盘协议，输入中文 / 特殊符号 / 快捷键的稳定性显著提升。
  • 应用图标更快：列表与选择器中的应用图标改用对象存储预签名 URL，加载更快、不再泄漏内部地址。
  • 构建向导联动：构建创建流程与新版应用选择器对齐，多平台勾选与设备过滤更顺滑。

稳定性与修复

  • 修复「运行卡在 running 永不结束」的问题：完善了租约与心跳超时识别，超时会自动标为失败并写入失败原因，不再出现孤儿运行。
  • 修复首次创建专项运行偶现 500：清理了历史遗留的多余数据库字段，新表结构与代码完全一致。
  • 修复 AI 代理偶发拒绝合法外网域名的问题：放宽并简化了协议校验。
  • 优化 性能图表的提示文案与坐标命名，悬浮信息更直观。
  • 优化 列表批量操作栏样式与若干前端小问题，整体观感更统一。

[1.1.4]

发布日期：2026-04-08

操作审计日志与平台版本管理

  • 操作审计日志：记录全平台关键操作（创建、更新、删除、登录、登出），覆盖 Agent、设备、应用、构建、脚本、模板、项目、用户、角色等所有核心资源，支持按操作类型、资源、用户、时间范围筛选查询。
  • 平台版本管理：自动检查最新版本，管理后台展示升级横幅提示，支持手动检查更新与自动检查开关。
  • 审计日志页面：管理后台 → 系统日志 → 审计日志，表格展示完整操作记录。
  • 关于页面：管理后台 → 系统设置 → 关于，展示当前版本、最新版本与更新日志。

[1.1.3]

发布日期：2026-04-06

构建向导与环境管理重构（前后端）

  • 构建向导：重构为多步向导流程（脚本应用 → 设备环境 → 前置检查），新增 pytest 高级设置、环境矩阵对话框、设备平台选择栏等组件。
  • 环境管理：从 admin 迁移至 agents 模块，新增环境镜像与构建模型、服务层及独立页面。
  • 设备分组：简化分组模型，重构为列表+详情双面板布局，新增创建对话框与设备添加面板。
  • 云真机性能：新增云端性能分析面板与 WebSocket 性能数据通道。
  • 代码质量：修复全部 ESLint 错误，统一批量操作栏样式。
  • 后端：设备标签与分组规则迁移，Agent 任务分发与环境覆盖服务优化。

[1.1.2]

发布日期：2026-03-24

本地控制台与性能分析（前后端）

  • 后端：Agent 模型与实时 WebSocket 通道调整，与会话、性能数据推送及控制台展示对齐。
  • 本地会话与投屏：试用倒计时、会话布局与工具栏优化；修复 Scrcpy 断开后立即重连可能无效等问题，并精简镜像相关工具栏与说明交互。
  • 本地多机：批量工具与多机视图增强；新增批量 GPS 模拟（地图选点）。
  • 本地开发者工具：设备总览与应用、文件、终端等板块改版；移除部分旧入口（独立 UI 层级面板、旧式 Panda Kit 测试弹窗等）。
  • 性能分析：性能图表、侧边栏工作台与截图时间轴等整体重构，采集与数据流更清晰。
  • 工程与其它：Python SDK 与前端/docs 包版本对齐，依赖更新；开发环境可配置试用截止时间；落地页与云真机 DevTools 小幅同步。

[1.1.1]

发布日期：2026-03-22

本地多设备 · 批量管理（前端）

  • 文案：「应用管理」改为「应用程序」；折叠区副标题与页签统一为「程序 · 同步安装其他设备」；「同步安装其他设备」相关按钮与提示文案统一。
  • 同步安装列表：去掉单行卡片样式，改为普通行列表。
  • 快捷键：列表高度随左栏 flex 分配，不再固定视口高度。
  • 目标设备：取消折叠，常显列表。
  • 同步安装页：移除长说明文案。

[1.1.0]

发布日期：2026-03-21

设备连接与状态管理

本版本起，设备是否与 Agent 保持物理连接与当前业务占用情况（空闲、使用中、远程调试等）分开体现，不再用同一套状态混写「掉线」和「占用」，列表与详情更贴近真实现场。

控制台与统计中的 空闲、使用中、其他占用、离线 四类数量与设备总数严格对齐，看板与报表更可对照、更可信。

接口、后台服务与 Agent 实时通道已统一遵循上述规则，同一设备在各入口状态一致。连接异常时的处理与日志也已加强，便于自助排障与运维追溯。

[1.0.1]

发布日期：2026-03-20

前端

  • HTTPS 私有/自签名证书：云端镜像失败遮罩中，打开 Agent 信任页改为小窗；提示文案强调需在浏览器中完成证书认证。
  • 开发：开发模式下根布局提供「DEV · 测证书小窗」调试入口。

Agent

  • GET /：欢迎页展示与健康检查、运行信息内联查看；支持关闭弹窗。
  • Agent 版本 0.14.1。

[1.0.0]

发布日期：2026-03-16

正式发布

PandaTest 1.0 正式发布，为企业团队提供一站式移动端真机测试能力。从设备接入到报告产出，覆盖完整测试链路，支持云端真机与本地设备混合使用，数据可完全掌控于企业内网。

核心能力

  • 设备管理：云端真机集群与本地设备统一接入，支持 Android / iOS 双平台
  • 自动化测试：脚本编排、定时调度、多机并行，贴合日常回归与冒烟场景
  • 测试报告：结果汇总、失败归因、稳定性趋势，便于快速定位与复盘
  • 应用管理：APK/IPA 上传与版本管理，按设备类型筛选下发
  • CI/CD 集成：REST API、Webhook、CLI 工具，与 Jenkins / GitLab CI 等 Pipeline 无缝衔接
  • 私有化部署：前后端与 Agent 均支持 Docker 部署，满足内网与安全合规要求

部署说明

  • 服务端：Docker Compose 一键部署，内置 PostgreSQL、Redis、MinIO
  • Agent：独立容器部署于设备所在环境，负责连接真机并执行测试任务