展开本页目录
开始前准备什么
- 独立练习目录及Python 3.14;系统与Node依赖以README为准。
- 离线重放无需Key;新请求使用自己的apizt Key,先核对模型权限和当前价格。
- 原创合成材料,不需要登录第三方平台账号。
- 先看文件
- 按步骤操作
- 对照真实结果
- 离线或模型复跑
默认离线重放;包含完整失败尝试与本地检查,不含Key。
1. 核对本例材料与目标文件
真实生成错误摘要、label、aria-describedby和焦点脚本;只处理合成表单,不发送邮件或提交真实报名。
先下载合成材料在独立目录练习。原始文件、模型输入与验收答案分别保留;本地核对答案不发送给模型。
input.json(节选)
{
"email": "invalid-demo",
"visit_date": "",
"allowed_fields": [
"email",
"visit_date"
]
}2. 按顺序完成这项具体操作
本次实际使用Python 3.14,依赖版本固定在资料包。需要LibreOffice或Node的案例请先按README安装对应运行时。python run.py读取真实旧响应完成本地处理;只有显式--live才发新请求。
- 1. 准备invalid-demo邮箱与空到访日期,允许字段限定email和visit_date。
- 2. 让模型为这两个字段分别返回一条错误,不接受未知字段或重复条目。
- 3. 生成有label、aria-invalid与aria-describedby的输入框,并将摘要链接指向对应id。
- 4. 在preview.html点击两条错误摘要,检查焦点到达对应输入框;本例只演练本地表单,不提交真实报名。
独立练习目录 · 默认仅离线复核
python3 -m venv .venv
source .venv/bin/activate
python -m pip install -r requirements.txt
python run.py3. 对照真正发送的请求
输入均为原创虚构演示数据。只输出JSON,errors数组。email无@需一项,visit_date为空需一项。每项field与message;field只能为email或visit_date。
网页实验台只执行这一步模型字段检查。原生文件写入、坐标/公式/格式回读及负例验收由下载包负责。
request-1.json(图片Base64省略,原文件在下载包)
{
"model": "gemini-2.5-flash-lite",
"messages": [
{
"role": "system",
"content": "严格只输出单个JSON对象,不要Markdown代码围栏,不要解释。输入均为原创虚构演示数据。只输出JSON,errors数组。email无@需一项,visit_date为空需一项。每项field与message;field只能为email或visit_date。"
},
{
"role": "user",
"content": "任务约束(只输出JSON对象,不用代码围栏):\n输入均为原创虚构演示数据。只输出JSON,errors数组。email无@需一项,visit_date为空需一项。每项field与message;field只能为email或visit_date。\n待处理合成材料:\n{\"email\": \"invalid-demo\", \"visit_date\": \"\", \"allowed_fields\": [\"email\", \"visit_date\"]}"
}
],
"temperature": 0,
"max_tokens": 512,
"provider": {
"sort": "success_rate"
},
"response_format": {
"type": "json_object"
}
}4. 查看原生处理代码与实际文件
下面节选来自本次实际执行的workflow.py分支,需要结合完整脚本运行。模型输出不能代替文件解析器或业务验算。
具体产物:preview.html、result.json。
workflow.py · 本例分支节选
errors = output.get('errors', [])
allowed = {'email', 'visit_date'}
check('错误字段严格限定白名单', {x.get('field') for x in errors} == allowed and len(errors) == 2)
body = '<nav aria-label="表单错误摘要"><h2>请先处理以下问题</h2><ul>' + ''.join(('<li><a href="#' + html.escape(x['field']) + '">' + html.escape(x['message']) + '</a></li>' for x in errors if x.get('field') in allowed)) + '</ul></nav><form>'
for field in ['email', 'visit_date']:
msg = next((x.get('message', '') for x in errors if x.get('field') == field), '')
body += '<label for="' + field + '">' + ('邮箱' if field == 'email' else '到访日期') + '</label><input id="' + field + '" aria-invalid="true" aria-describedby="' + field + '-error" value="' + html.escape(case['input'][field]) + '"><p id="' + field + '-error">' + html.escape(msg) + '</p>'
body += '</form><script>document.querySelectorAll("nav a").forEach(a=>a.addEventListener("click",e=>{e.preventDefault();document.getElementById(a.hash.slice(1)).focus()}))</script>'
soup = BeautifulSoup(body, 'html.parser')
check('每条摘要能定位真实输入框', all((soup.select_one('input' + a['href']) for a in soup.select('nav a'))))
check('每个输入框有label和错误说明', all((soup.find('label', attrs={'for': x['id']}) and soup.find(id=x['aria-describedby']) for x in soup.select('input'))))
(folder / 'preview.html').write_text(_shell(case['title'], body))
artifacts.append('preview.html')5. 对照真实结果和检查表
实测2026-10-25T07:45:43.934802+00:00,HTTP200;请求gemini-2.5-flash-lite,返回gemini-2.5-flash-lite。本次4/4项检查通过,指本例执行及验收机制通过,不代表所有模型字段零误差。
最后一次返回用量216tokens;1份尝试记录的已知用量合计216。失败记录保留,用量缺失不按0计,本文不推算实际金额。
| 实际检查 | 结果 |
|---|---|
| 真实apizt API响应HTTP200 | 通过 |
| 错误字段严格限定白名单 | 通过 |
| 每条摘要能定位真实输入框 | 通过 |
| 每个输入框有label和错误说明 | 通过 |
- 实际检查
- 真实apizt API响应HTTP200
- 结果
- 通过
- 实际检查
- 错误字段严格限定白名单
- 结果
- 通过
- 实际检查
- 每条摘要能定位真实输入框
- 结果
- 通过
- 实际检查
- 每个输入框有label和错误说明
- 结果
- 通过
result.json · 原生处理后实际结果
{
"errors": [
{
"field": "email",
"message": "Email is invalid"
},
{
"field": "visit_date",
"message": "Visit date cannot be empty"
}
]
}6. 替换输入前,先确认这些边界
真实生成错误摘要、label、aria-describedby和焦点脚本;只处理合成表单,不发送邮件或提交真实报名。
修改材料后应重新制定事实断言和反例。识别错误率、混淆矩阵或拒答类教程允许保留模型实际错误;检查通过指计算和处理正确。没有调用视频模型。
怎样确认已经完成
- 真实apizt API响应HTTP200
- 错误字段严格限定白名单
- 每条摘要能定位真实输入框
- 每个输入框有label和错误说明
常见问题
AI 表单 错误提示 无障碍怎么开始?
准备invalid-demo邮箱与空到访日期,允许字段限定email和visit_date。按本页顺序继续,先用下载包离线重放,再替换自己的材料。
网页试跑和下载包有什么区别?
网页只复跑模型字段,不生成全部原生文件;资料包包含实际原生处理和本地验收。
这次通过结果适用于其他材料吗?
真实生成错误摘要、label、aria-describedby和焦点脚本;只处理合成表单,不发送邮件或提交真实报名。



