限制与边界

本页说明 CueCast 当前版本的能力边界，帮助团队合理设计用例。产品会持续扩展浏览器、页面类型和测试场景支持，未来版本会覆盖更多使用场景。

浏览器支持

当前版本主要支持 Chrome。录制和回放依赖 Chrome 扩展能力，不建议使用其他浏览器作为主流程。

对于 Chromium 内核浏览器，理论上存在适配可能，但仍需要确认扩展 API、CDP 能力、企业安全策略、下载与安装方式是否兼容。正式使用前建议以 Chrome 作为基准完成验证。

页面类型

适合：

• Web 管理后台。
• 表单、列表、配置、审批、查询类页面。
• SaaS、CRM、ERP、数据平台等业务系统。

不适合：

• 原生移动 App。
• 桌面客户端。
• 非浏览器 UI。
• 需要底层协议压测或接口契约测试的场景。

iframe 场景当前仍属于能力边界。简单 iframe 页面可以作为验证场景尝试，但 iframe 上下文切换、跨域 iframe、iframe 内复杂浮层暂不建议作为正式发布准入用例。

登录态

CueCast 可以控制浏览器执行步骤，但不会替代目标系统的账号体系。回放前需要目标系统处于可访问、可登录状态。

如果目标系统登录态过期，回放可能跳转到登录页并失败。执行计划建议使用「登录准备」：当系统判断未登录时先执行登录用例，已登录时自动跳过。

对于图片验证码、短信验证码、滑块验证码等安全校验，建议优先和业务系统约定测试环境策略，例如测试验证码、白名单、API 前置登录或专用测试账号。智能步骤的图片识别能力适合处理简单图片文本，不应作为绕过真实生产安全机制的方案。

测试数据

自动化用例依赖稳定测试数据。建议：

• 使用测试账号。
• 使用可重复创建或可清理的数据。
• 避免多个用例同时修改同一条记录。
• 对会触发真实通知或外部副作用的流程设置隔离环境。
• 对需要唯一名称、唯一编号的输入字段，优先使用动态输入值。

页面稳定性

以下情况会降低回放稳定性：

• 关键元素没有稳定文本或稳定属性。
• 页面使用大量随机 class。
• 同一页面存在多个几乎相同的下拉框或按钮。
• 加载状态没有明确结束信号。
• 弹窗、遮罩、动画影响点击目标。
• 验证码、滑块、人机校验等强对抗交互。
• 虚拟滚动列表、懒加载列表在没有稳定业务文本或滚动状态时容易产生定位偏差。

建议业务系统为关键控件提供 data-testid 或稳定语义属性。

AI 与视觉能力边界

AI 能力用于辅助步骤执行、图片文字识别和失败分析。它可以提升覆盖面和排障效率，但不保证每一次判断都完全正确。

建议：

• 关键发布路径仍优先使用普通录制步骤和明确断言。
• 智能步骤用于少量复杂交互或辅助场景，不要替代整条长流程。
• 失败分析作为排障入口，最终仍结合截图、错误信息和业务实际状态判断。