应明确指定测试工具、注入结构化测试契约、使用稳定断言锚点、模拟网络响应、添加调试标记。具体包括声明框架与环境约束、定义前置/操作/后置三段式契约、强制data-testid断言、route.fulfill模拟API、插入截图与日志标记。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望使用CodeGeeX辅助编写端到端的Web应用测试脚本，但实际生成的代码无法通过执行验证或与目标框架（如Playwright、Cypress、TestCafe）不兼容，则可能是由于提示词未明确约束技术栈、缺少上下文环境声明或未指定浏览器行为模拟细节。以下是解决此问题的步骤：
一、明确指定测试工具与运行时环境
CodeGeeX本身不执行代码，仅生成文本；其输出需严格匹配所选端到端测试框架的语法规范与API约定。若未在提示中声明框架类型，模型可能混合多种工具风格，导致脚本不可用。
1、在向CodeGeeX提交请求时，首句必须声明目标工具，例如：“请使用Playwright for TypeScript生成一个端到端测试，验证用户登录后跳转至仪表盘页面。”
2、补充关键运行时约束，例如：“使用await/async语法，不使用Page.goto()以外的导航方式，断言使用expect(page).toHaveURL()。”
3、提供最小可验证上下文，包括：基础URL、登录表单字段ID（如#email、#password）、成功跳转后的页面元素选择器（如.main-dashboard）。
二、注入结构化测试契约（Test Contract）
端到端测试脚本需体现业务语义而非纯DOM操作。CodeGeeX缺乏对业务流程的先验理解，必须通过契约式描述强制对齐预期行为，避免生成“点击→等待→断言”等无状态碎片化步骤。
1、用自然语言定义三段式契约：前置条件（如“用户已注册且账户处于激活状态”）、操作序列（如“输入邮箱→输入密码→点击登录按钮”）、后置断言（如“URL包含/dashboard，且显示欢迎标题”）。
2、要求CodeGeeX将每项契约要素映射为对应代码块，例如前置条件生成setup()函数调用，操作序列生成page.fill()与page.click()链式调用，后置断言生成expect().toBeVisible()等。
3、禁止生成硬编码等待（如page.waitForTimeout(2000)），改用条件驱动等待（如page.waitForSelector('.dashboard-header', { state: 'visible' })）。
三、嵌入可验证的断言锚点
CodeGeeX生成的断言常依赖模糊文本匹配（如toContain('Welcome')），易因UI微调失效。必须强制其使用稳定、唯一、非文本的定位器作为断言依据，确保测试鲁棒性。
1、在提示中明确要求：“所有expect断言必须基于data-testid属性，不得使用innerText、textContent或CSS类名。”
CodeGeeX 2.21.0是智谱AI推出的AI编程助手版本，对Inline Chat功能进行了重大优化，包括UI设计升级、支持流式输出以提升响应速度，并新增“查看思路”按钮以便理解代码原理。同时，该版本在编辑器中新增CodeLens控件，支持一键“解释”代码或“添加注释”。目前该工具对个人开发者免费开放。
2、提供示例锚点声明：“登录成功后，页面body元素应包含data-testid='dashboard-loaded'。”
3、指令模型生成对应断言语句：await expect(page.locator('body')).toHaveAttribute('data-testid', 'dashboard-loaded')。
四、隔离网络依赖并模拟响应
真实端到端测试常因后端服务不稳定而失败。CodeGeeX默认不引入请求拦截逻辑，需显式要求其注入路由拦截与响应模拟代码，使测试脱离外部系统耦合。
1、添加约束：“使用Playwright的route.fulfill()模拟/api/auth/login返回200状态及JWT令牌。”
2、指定模拟响应结构：“响应体为JSON，含token字段，值为'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...'。”
3、要求生成完整拦截代码块：await page.route('**/api/auth/login', route => route.fulfill({ status: 200, contentType: 'application/json', body: JSON.stringify({ token: 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...' }) }))。
五、生成带调试标记的可追溯脚本
CodeGeeX输出常缺乏调试支持，当测试失败时难以定位执行断点。需强制其在关键步骤插入可识别的日志标记与截图指令，便于CI环境中快速归因。
1、指令：“每个主要操作后插入page.screenshot({ path: `step-login-filled-${Date.now()}.png` })。”
2、要求添加console.log标记：“在fill邮箱后输出'? EMAIL FIELD POPULATED'，在click登录后输出'? LOGIN BUTTON CLICKED'。”
3、指定截图路径命名规则：路径中必须包含操作阶段标识（如'login-start'、'dashboard-assert'）和毫秒级时间戳。
