展开本页目录
开始前准备什么
- 独立练习目录及Python 3.14；系统与Node依赖以README为准。
- 离线重放无需Key；新请求使用自己的apizt Key，先核对模型权限和当前价格。
- 原创合成材料，不需要登录第三方平台账号。
- 先看文件
- 按步骤操作
- 对照真实结果
- 离线或模型复跑
默认离线重放；包含完整失败尝试与本地检查，不含Key。
1. 核对本例材料与目标文件
实际输出带scope、id、headers关系的HTML表格；验证结构关系，不声称做完所有辅助技术兼容测试。
先下载合成材料在独立目录练习。原始文件、模型输入与验收答案分别保留；本地核对答案不发送给模型。
input.json（节选）
{
"columns": [
"日期",
"项目",
"金额（元）"
],
"rows": [
[
"2026-10-20",
"演示文具",
"18.50"
],
[
"2026-10-21",
"演示纸张",
"32.00"
]
]
}
实际输入、原始文件和本例操作约束的浏览器截图
2. 按顺序完成这项具体操作
本次实际使用Python 3.14，依赖版本固定在资料包。需要LibreOffice或Node的案例请先按README安装对应运行时。python run.py读取真实旧响应完成本地处理；只有显式--live才发新请求。
- 1. 保留原表columns与两行金额，只让模型返回date/item/amount列名映射。
- 2. 保存每次原始响应；第一轮结构不符被拒绝，明确对象结构后重新请求，不覆写失败记录。
- 3. 按模型实际列名生成带id与scope的表头，为每个td写headers关联。
- 4. 在preview.html查看多级表头和两行金额，独立核对每个headers都引用存在的th，金额单位不丢失。
独立练习目录 · 默认仅离线复核
python3 -m venv .venv
source .venv/bin/activate
python -m pip install -r requirements.txt
python run.py3. 对照真正发送的请求
输入均为原创虚构演示数据。只输出JSON对象，严格形状为{"labels":{"date":"日期列的原始列名","item":"项目列的原始列名","amount":"金额列的原始列名"}}。从columns选择列名，不返回rows，不改动单位。
网页实验台只执行这一步模型字段检查。原生文件写入、坐标/公式/格式回读及负例验收由下载包负责。
request-2.json（图片Base64省略，原文件在下载包）
{
"model": "gemini-2.5-flash-lite",
"messages": [
{
"role": "system",
"content": "严格只输出单个JSON对象，不要Markdown代码围栏，不要解释。输入均为原创虚构演示数据。只输出JSON对象，严格形状为{\"labels\":{\"date\":\"日期列的原始列名\",\"item\":\"项目列的原始列名\",\"amount\":\"金额列的原始列名\"}}。从columns选择列名，不返回rows，不改动单位。"
},
{
"role": "user",
"content": "任务约束（只输出JSON对象，不用代码围栏）：\n输入均为原创虚构演示数据。只输出JSON对象，严格形状为{\"labels\":{\"date\":\"日期列的原始列名\",\"item\":\"项目列的原始列名\",\"amount\":\"金额列的原始列名\"}}。从columns选择列名，不返回rows，不改动单位。\n待处理合成材料：\n{\"columns\": [\"日期\", \"项目\", \"金额（元）\"], \"rows\": [[\"2026-10-20\", \"演示文具\", \"18.50\"], [\"2026-10-21\", \"演示纸张\", \"32.00\"]]}"
}
],
"temperature": 0,
"max_tokens": 512,
"provider": {
"sort": "success_rate"
},
"response_format": {
"type": "json_object"
}
}4. 查看原生处理代码与实际文件
下面节选来自本次实际执行的workflow.py分支，需要结合完整脚本运行。模型输出不能代替文件解析器或业务验算。
具体产物：preview.html、result.json。
workflow.py · 本例分支节选
labels = output.get('labels', {})
table = '<table><thead><tr><th id="group" colspan="3">演示支出</th></tr><tr>' + ''.join(('<th id="' + k + '" scope="col">' + html.escape(labels.get(k, '')) + '</th>' for k in ['date', 'item', 'amount'])) + '</tr></thead><tbody>'
for row in case['input']['rows']:
table += '<tr>' + ''.join(('<td headers="group ' + k + '">' + html.escape(v) + '</td>' for k, v in zip(['date', 'item', 'amount'], row))) + '</tr>'
table += '</tbody></table>'
soup = BeautifulSoup(table, 'html.parser')
ids = {x['id'] for x in soup.select('th[id]')}
check('每个单元格引用存在的表头', all((set(x['headers']).issubset(ids) for x in soup.select('td'))))
check('列标题含原始金额单位', labels.get('amount') == '金额（元）')
check('两行原数据完整保留', len(soup.select('tbody tr')) == 2 and '18.50' in soup.text)
(folder / 'preview.html').write_text(_shell(case['title'], table))
artifacts.append('preview.html')
result = {'labels': labels, 'headerIds': sorted(ids), 'dataCells': len(soup.select('td'))}5. 对照真实结果和检查表
实测2026-10-25T07:44:24.842454+00:00，HTTP200；请求gemini-2.5-flash-lite，返回gemini-2.5-flash-lite。本次4/4项检查通过，指本例执行及验收机制通过，不代表所有模型字段零误差。
最后一次返回用量249tokens；2份尝试记录的已知用量合计712。失败记录保留，用量缺失不按0计，本文不推算实际金额。
| 实际检查 | 结果 |
|---|---|
| 真实apizt API响应HTTP200 | 通过 |
| 每个单元格引用存在的表头 | 通过 |
| 列标题含原始金额单位 | 通过 |
| 两行原数据完整保留 | 通过 |
- 实际检查
- 真实apizt API响应HTTP200
- 结果
- 通过
- 实际检查
- 每个单元格引用存在的表头
- 结果
- 通过
- 实际检查
- 列标题含原始金额单位
- 结果
- 通过
- 实际检查
- 两行原数据完整保留
- 结果
- 通过
result.json · 原生处理后实际结果
{
"labels": {
"date": "日期",
"item": "项目",
"amount": "金额（元）"
},
"headerIds": [
"amount",
"date",
"group",
"item"
],
"dataCells": 6
}
本例实际产物与原始响应的浏览器截图；本地检查和模型答案分开记录
6. 替换输入前，先确认这些边界
实际输出带scope、id、headers关系的HTML表格；验证结构关系，不声称做完所有辅助技术兼容测试。
修改材料后应重新制定事实断言和反例。识别错误率、混淆矩阵或拒答类教程允许保留模型实际错误；检查通过指计算和处理正确。没有调用视频模型。
怎样确认已经完成
- 真实apizt API响应HTTP200
- 每个单元格引用存在的表头
- 列标题含原始金额单位
- 两行原数据完整保留
常见问题
AI HTML 表格 无障碍 表头怎么开始？
保留原表columns与两行金额，只让模型返回date/item/amount列名映射。按本页顺序继续，先用下载包离线重放，再替换自己的材料。
网页试跑和下载包有什么区别？
网页只复跑模型字段，不生成全部原生文件；资料包包含实际原生处理和本地验收。
这次通过结果适用于其他材料吗？
实际输出带scope、id、headers关系的HTML表格；验证结构关系，不声称做完所有辅助技术兼容测试。