断言与智能步骤

只录制操作并不等于完成测试。一个可维护的自动化用例，应该明确验证关键结果。

CueCast 支持文本断言、JSON 断言和 AI 自然语言步骤。建议优先使用确定性的断言，AI 步骤用于处理难以稳定录制的复杂操作。

文本断言

文本断言用于验证页面中是否出现预期文案。

适合场景：

• 保存成功后出现「保存成功」。
• 进入工作台后出现「工作台」。
• 列表中出现指定记录名称。
• 表单校验出现预期错误提示。

使用建议：

• 断言稳定文案，不要断言随机数、时间戳或动态数量。
• 如果页面存在多语言，选择当前环境稳定出现的文案。
• 不要只断言按钮名，例如「提交」，这类文本可能本来就存在。

JSON 断言

JSON 断言用于验证页面中的 JSON 响应或结构化数据是否符合预期。CueCast 会按语义比较 JSON，忽略键顺序和格式空白。

适合场景：

• 页面展示接口响应内容。
• 需要验证某个结构化结果字段。
• 响应顺序不稳定，但结构和关键值稳定。

建议只保留关键字段，不要把整段巨大 JSON 都作为期望值。过大的断言会增加维护成本，也会让失败信息难以阅读。

AI 自然语言步骤

AI 自然语言步骤用于描述操作意图，由后端 AI 服务结合当前页面结构规划操作序列。

示例：

在搜索框输入“测试项目”，点击查询按钮，并打开第一条结果详情。

适合场景：

• 页面结构复杂，录制步骤容易失效。
• 操作需要根据页面状态选择目标。
• 流程中有少量人工语言更容易表达的步骤。

不建议用于：

• 核心、稳定、可明确定位的按钮点击。
• 强一致性要求很高的断言。
• AI 服务不可用时仍必须执行的关键链路。

使用顺序建议

推荐优先级：

1. 普通录制步骤。
2. 文本断言或 JSON 断言。
3. 少量 AI 自然语言步骤。

AI 步骤可以提升灵活性，但也会引入外部模型依赖。对发布准入类执行计划，建议将 AI 步骤控制在必要范围内。

失败排查

失败类型	可能原因	建议处理
文本断言失败	文案变化、页面未加载完成、进入了错误页面	检查截图和页面文本，必要时调整断言值或等待时间。
JSON 断言失败	字段值变化、响应结构变化、动态字段未剔除	保留关键字段，移除动态字段。
AI 步骤失败	AI 服务不可用、页面结构不足、指令过于模糊	检查 AI 配置，改写为更明确的指令，或改成录制步骤。