录制测试

录制是 CueCast 的核心入口。用户在真实页面中操作，扩展会采集步骤并同步到平台。

录制质量会直接影响后续回放稳定性。建议把录制当成“沉淀测试资产”，而不是一次性的操作回放。

支持的操作

当前主要支持：

• 点击
• 输入
• 复选框勾选/取消
• 下拉选择
• 悬浮
• 文本断言
• JSON 断言
• AI 自然语言步骤

不同操作会保存不同数据。点击和输入会保存目标定位信息，断言会保存期望值，AI 自然语言步骤会保存自然语言指令。

录制建议

• 从稳定的起始 URL 开始。
• 每条用例只覆盖一条清晰路径。
• 操作时等待页面状态稳定后再进行下一步。
• 对关键结果添加断言。
• 避免录制临时调试操作。

录制模式

用例详情页通常会出现两类录制入口：

• 全新录制：适合从头创建用例，或确认要覆盖原有步骤。
• 追加录制：适合页面改版后只补充某一段流程，或在已有步骤之间插入新操作。

如果当前用例已有步骤，全新录制会覆盖旧步骤。执行前请确认旧步骤是否还需要保留。

密码与敏感输入

录制 password 类型输入框（或 name/id 含 password 的字段）时，步骤会标记为脱敏，保存到服务器后加密存储；中台步骤列表与编辑框不显示明文。

若需修改密码：在用例详情中打开该步骤，重新输入新密码并保存。界面会提示：此密码已加密存储，若忘记密码请重新输入新密码并保存。

回放时扩展通过授权接口获取解密后的值并填入页面。请使用测试环境专用密码，请勿录入生产环境真实凭据。

步骤维护

录制完成后，可以在用例详情页继续维护步骤：

• 编辑步骤名称、等待时间、输入值或断言值。
• 拖拽调整步骤顺序。
• 复制单个步骤或批量复制步骤。
• 在当前用例或其他用例中粘贴步骤。
• 删除不必要的步骤。
• 使用撤销恢复上一步编辑。

这些能力适合处理页面小改版。只有当业务路径整体变化时，才建议重新录制整条用例。

截图策略

用例可以选择不同截图策略：

策略	适用场景	注意事项
标准截图	日常录制和回放	体积较小，加载更快。
高清整屏截图	需要完整页面上下文排障	会增加存储和页面加载开销。

下拉框录制

对于 iView、Ant Design、Element 等 Select/Combobox 组件，CueCast 会优先记录组件根节点和上下文候选，减少同类下拉框误定位。

如果左右两个下拉框功能和选项高度相似，建议业务页面尽量提供稳定 class、data-testid 或可区分的结构信息。

可测性建议

为了提升长期稳定性，建议业务系统在关键控件上提供稳定标识：

• 使用稳定的 data-testid、data-cy 或业务语义 class。
• 避免关键按钮只有图标且没有可读文本。
• 下拉框、弹窗、表格行等复杂组件尽量有可区分上下文。
• 页面加载完成后再隐藏 loading，避免自动化误判可操作状态。

常见问题

现象	可能原因	建议处理
录制不到操作	扩展未启用或页面未刷新	检查插件状态，刷新产品页和目标页。
输入步骤过多	输入时多次停顿或焦点切换	编辑步骤，保留最终输入值。
下拉选项回放失败	浮层结构变化或同类组件太多	补充稳定标识，必要时重新录制该段。
回放时未登录	登录态失效	先在目标页面完成登录，再执行用例。