展开本页目录
开始前准备什么
- 独立练习目录及Python 3.14;系统与Node依赖以README为准。
- 离线重放无需Key;新请求使用自己的apizt Key,先核对模型权限和当前价格。
- 原创合成材料,不需要登录第三方平台账号。
- 先看文件
- 按步骤操作
- 对照真实结果
- 离线或模型复跑
默认离线重放;包含完整失败尝试与本地检查,不含Key。
1. 核对本例材料与目标文件
区别单元格循环/上游公式错误,验收definedName依赖。需人工重叠复核。
先下载合成材料在独立目录练习。原始文件、模型输入与验收答案分别保留;本地核对答案不发送给模型。
input.json(节选)
{
"definitions": {
"Revenue": "#REF!",
"TaxRate": "0.06"
},
"intended_ranges": {
"Revenue": "'Sales'!$B$2:$B$4"
}
}2. 按顺序完成这项具体操作
本次实际使用Python 3.14,依赖版本固定在资料包。需要LibreOffice或Node的案例请先按README安装对应运行时。python run.py读取真实旧响应完成本地处理;只有显式--live才发新请求。
- 1. 读取 source.xlsx 的全局定义名称与Sales表公式,找到Revenue定义中的#REF!,并区分合法的TaxRate常量0.06。
- 2. 把实际定义与预期目标区域交给 apizt,核对模型只提出Revenue需要修复,保留原工作簿作为对照。
- 3. 在副本中把Revenue改为Sales的绝对区域B2:B4,保存 repaired.xlsx;合法的TaxRate定义保持原值。
- 4. 重新读取 repaired.xlsx 的Revenue.destinations,核对它指向Sales的B2:B4;同时对比source.xlsx的SHA,确认原件未改。
- 5. 独立读取区域内100、200、300并用Python算出税额36.00,作为名称依赖检查;openpyxl没有计算Excel公式,此处不将独立验算冒充公式引擎求值。
独立练习目录 · 默认仅离线复核
python3 -m venv .venv
source .venv/bin/activate
python -m pip install -r requirements.txt
python run.py3. 对照真正发送的请求
只处理给定原创虚构材料,只输出JSON。从定义表里列出包含#REF!的bad_names,并按材料给出repair_to;不要改合法常量名称。 输出结构:{"bad_names": ["string"], "repair_to": {"Revenue": "string"}}
网页实验台只执行这一步模型字段检查。原生文件写入、坐标/公式/格式回读及负例验收由下载包负责。
request-1.json(图片Base64省略,原文件在下载包)
{
"model": "gemini-2.5-flash-lite",
"messages": [
{
"role": "system",
"content": "严格只输出单个JSON对象,不要Markdown代码围栏,不要解释。只处理给定原创虚构材料,只输出JSON。从定义表里列出包含#REF!的bad_names,并按材料给出repair_to;不要改合法常量名称。 输出结构:{\"bad_names\": [\"string\"], \"repair_to\": {\"Revenue\": \"string\"}}"
},
{
"role": "user",
"content": "任务约束(只输出JSON对象,不用代码围栏):\n只处理给定原创虚构材料,只输出JSON。从定义表里列出包含#REF!的bad_names,并按材料给出repair_to;不要改合法常量名称。 输出结构:{\"bad_names\": [\"string\"], \"repair_to\": {\"Revenue\": \"string\"}}\n待处理合成材料:\n{\"definitions\": {\"Revenue\": \"#REF!\", \"TaxRate\": \"0.06\"}, \"intended_ranges\": {\"Revenue\": \"'Sales'!$B$2:$B$4\"}, \"formula\": \"=SUM(Revenue)*TaxRate\"}"
}
],
"temperature": 0,
"max_tokens": 1024,
"provider": {
"sort": "success_rate"
},
"response_format": {
"type": "json_object"
}
}4. 查看原生处理代码与实际文件
下面节选来自本次实际执行的workflow.py分支,需要结合完整脚本运行。模型输出不能代替文件解析器或业务验算。
具体产物:repaired.xlsx、result.json、checks.json、preview.html。
workflow.py · 本例分支节选
from openpyxl import load_workbook
source = folder.parent / 'source.xlsx' if (folder.parent / 'source.xlsx').exists() else folder / 'source.xlsx'
before = hashlib.sha256(source.read_bytes()).hexdigest()
wb = load_workbook(source)
bad = [name for name, value in wb.defined_names.items() if '#REF!' in value.attr_text]
check('只列出真实失效名称', bad == output['bad_names'] == ['Revenue'])
for name in bad:
wb.defined_names[name].attr_text = output['repair_to'][name]
wb.save(folder / 'repaired.xlsx')
artifacts.append('repaired.xlsx')
r = load_workbook(folder / 'repaired.xlsx')
check('Revenue回读指向实际单元格', list(r.defined_names['Revenue'].destinations) == [('Sales', '$B$2:$B$4')])
check('TaxRate常量未改', r.defined_names['TaxRate'].attr_text == '0.06')
check('原件SHA保持一致', hashlib.sha256(source.read_bytes()).hexdigest() == before)
values = [r['Sales'][cell].value for cell in ['B2', 'B3', 'B4']]
tax = sum((D(str(x)) for x in values)) * D(r.defined_names['TaxRate'].attr_text)
check('已定义区域对应税额独立验算', tax == D('36.00'))
result = {'bad_names': bad, 'definitions': {k: v.attr_text for k, v in r.defined_names.items()}, 'independent_expected_tax': money(tax), 'formula_calculated_by_openpyxl': False}5. 对照真实结果和检查表
实测2026-10-25T07:50:40.420467+00:00,HTTP200;请求gemini-2.5-flash-lite,返回gemini-2.5-flash-lite。本次7/7项检查通过,指本例执行及验收机制通过,不代表所有模型字段零误差。
最后一次返回用量242tokens;1份尝试记录的已知用量合计242。失败记录保留,用量缺失不按0计,本文不推算实际金额。
| 实际检查 | 结果 |
|---|---|
| 真实apizt API响应HTTP200 | 通过 |
| 模型结构化事实与原始材料一致 | 通过 |
| 只列出真实失效名称 | 通过 |
| Revenue回读指向实际单元格 | 通过 |
| TaxRate常量未改 | 通过 |
| 原件SHA保持一致 | 通过 |
| 已定义区域对应税额独立验算 | 通过 |
- 实际检查
- 真实apizt API响应HTTP200
- 结果
- 通过
- 实际检查
- 模型结构化事实与原始材料一致
- 结果
- 通过
- 实际检查
- 只列出真实失效名称
- 结果
- 通过
- 实际检查
- Revenue回读指向实际单元格
- 结果
- 通过
- 实际检查
- TaxRate常量未改
- 结果
- 通过
- 实际检查
- 原件SHA保持一致
- 结果
- 通过
- 实际检查
- 已定义区域对应税额独立验算
- 结果
- 通过
result.json · 原生处理后实际结果
{
"bad_names": [
"Revenue"
],
"definitions": {
"Revenue": "'Sales'!$B$2:$B$4",
"TaxRate": "0.06"
},
"independent_expected_tax": "36.00",
"formula_calculated_by_openpyxl": false
}6. 替换输入前,先确认这些边界
本例只验证合成材料和本地原生文件;不连接真实客户数据,不代表第三方SaaS已运行。 openpyxl不计算公式,本例回读名称并独立验算36.00,不称Excel公式引擎已求值。
修改材料后应重新制定事实断言和反例。识别错误率、混淆矩阵或拒答类教程允许保留模型实际错误;检查通过指计算和处理正确。没有调用视频模型。
怎样确认已经完成
- 真实apizt API响应HTTP200
- 模型结构化事实与原始材料一致
- 只列出真实失效名称
- Revenue回读指向实际单元格
- TaxRate常量未改
- 原件SHA保持一致
- 已定义区域对应税额独立验算
常见问题
Excel 命名区域 失效 AI怎么开始?
读取 source.xlsx 的全局定义名称与Sales表公式,找到Revenue定义中的#REF!,并区分合法的TaxRate常量0.06。按本页顺序继续,先用下载包离线重放,再替换自己的材料。
网页试跑和下载包有什么区别?
网页只复跑模型字段,不生成全部原生文件;资料包包含实际原生处理和本地验收。
这次通过结果适用于其他材料吗?
本例只验证合成材料和本地原生文件;不连接真实客户数据,不代表第三方SaaS已运行。 openpyxl不计算公式,本例回读名称并独立验算36.00,不称Excel公式引擎已求值。


