展开本页目录
开始前准备什么
- 独立练习目录及Python 3.14;系统与Node依赖以README为准。
- 离线重放无需Key;新请求使用自己的apizt Key,先核对模型权限和当前价格。
- 原创合成材料,不需要登录第三方平台账号。
- 先看文件
- 按步骤操作
- 对照真实结果
- 离线或模型复跑
默认离线重放;包含完整失败尝试与本地检查,不含Key。
1. 核对本例材料与目标文件
原计划问卷多选分母已与旧文重叠,替换为原生XLSX跨表命名列表和dataValidation回读;不等同041的失效名称修复。
先下载合成材料在独立目录练习。原始文件、模型输入与验收答案分别保留;本地核对答案不发送给模型。
input.json(节选)
{
"policy": "表单部门只允许研发、运营、支持;部门为空允许暂存;“待确认”是非法值,需列入异常。",
"rows": [
{
"id": "F1",
"department": "研发"
},
{
"id": "F2",
"department": ""
},
{
"id": "F3",
"department": "待确认"
}
]
}2. 按顺序完成这项具体操作
本次实际使用Python 3.14,依赖版本固定在资料包。需要LibreOffice或Node的案例请先按README安装对应运行时。python run.py读取真实旧响应完成本地处理;只有显式--live才发新请求。
- 1. 打开 source.xlsx 的Form表,核对三条既有部门记录:研发、空值和待确认;在 input.json 查明部门可选列表来自哪条政策。
- 2. 让 apizt 提取允许的研发、运营、支持三项选项;空值允许暂存,但待确认不能成为允许列表的一项。
- 3. 建立Options工作表与 AllowedDepartments 跨表命名区域,为Form的B2:B4添加原生list数据验证和stop错误提示,保存 validated-form.xlsx。
- 4. 回读 validated-form.xlsx,检查命名区域确实指向Options的A2:A4,验证器绑定B2:B4且allow_blank启用。
- 5. 另行检查已经存在的单元格值,打开 invalid-existing-values.csv 核对F3的待确认被列出;openpyxl保存验证规则,不会自动替用户执行Excel输入拦截。
独立练习目录 · 默认仅离线复核
python3 -m venv .venv
source .venv/bin/activate
python -m pip install -r requirements.txt
python run.py3. 对照真正发送的请求
只处理给定原创虚构材料,只输出JSON。从材料中提取允许的部门选项allowed_departments,保留原顺序;不能把待确认加入允许列表。 输出结构:{"allowed_departments": ["string"]}
网页实验台只执行这一步模型字段检查。原生文件写入、坐标/公式/格式回读及负例验收由下载包负责。
request-1.json(图片Base64省略,原文件在下载包)
{
"model": "gemini-2.5-flash-lite",
"messages": [
{
"role": "system",
"content": "严格只输出单个JSON对象,不要Markdown代码围栏,不要解释。只处理给定原创虚构材料,只输出JSON。从材料中提取允许的部门选项allowed_departments,保留原顺序;不能把待确认加入允许列表。 输出结构:{\"allowed_departments\": [\"string\"]}"
},
{
"role": "user",
"content": "任务约束(只输出JSON对象,不用代码围栏):\n只处理给定原创虚构材料,只输出JSON。从材料中提取允许的部门选项allowed_departments,保留原顺序;不能把待确认加入允许列表。 输出结构:{\"allowed_departments\": [\"string\"]}\n待处理合成材料:\n{\"policy\": \"表单部门只允许研发、运营、支持;部门为空允许暂存;“待确认”是非法值,需列入异常。\", \"rows\": [{\"id\": \"F1\", \"department\": \"研发\"}, {\"id\": \"F2\", \"department\": \"\"}, {\"id\": \"F3\", \"department\": \"待确认\"}]}"
}
],
"temperature": 0,
"max_tokens": 1024,
"provider": {
"sort": "success_rate"
},
"response_format": {
"type": "json_object"
}
}4. 查看原生处理代码与实际文件
下面节选来自本次实际执行的workflow.py分支,需要结合完整脚本运行。模型输出不能代替文件解析器或业务验算。
具体产物:validated-form.xlsx、invalid-existing-values.csv、result.json、checks.json、preview.html。
workflow.py · 本例分支节选
from openpyxl import load_workbook
from openpyxl.workbook.defined_name import DefinedName
from openpyxl.worksheet.datavalidation import DataValidation
wb = load_workbook(folder.parent / 'source.xlsx' if (folder.parent / 'source.xlsx').exists() else folder / 'source.xlsx')
ws = wb['Form']
options = wb.create_sheet('Options')
options.append(['Department'])
for value in output['allowed_departments']:
options.append([value])
wb.defined_names.add(DefinedName('AllowedDepartments', attr_text="'Options'!$A$2:$A$4"))
dv = DataValidation(type='list', formula1='=AllowedDepartments', allow_blank=True)
dv.errorStyle = 'stop'
dv.showErrorMessage = True
dv.error = '请选择列表中的部门'
dv.add('B2:B4')
ws.add_data_validation(dv)
wb.save(folder / 'validated-form.xlsx')
artifacts.append('validated-form.xlsx')
r = load_workbook(folder / 'validated-form.xlsx')
v = list(r['Form'].data_validations.dataValidation)[0]
allowed = set(output['allowed_departments'])
bad = [{'id': x['id'], 'value': x['department'], 'reason': 'not-in-list'} for x in data['rows'] if x['department'] and x['department'] not in allowed]
check('验证器确实绑定B2:B4', str(v.sqref) == 'B2:B4' and v.type == 'list')
check('跨表名称指向真实选项区域', r.defined_names['AllowedDepartments'].attr_text == "'Options'!$A$2:$A$4")
check('空值允许但非法既有值单列', v.allow_blank and bad == [{'id': 'F3', 'value': '待确认', 'reason': 'not-in-list'}])
cout('invalid-existing-values.csv', bad)
result = {'allowed': sorted(allowed), 'invalid_existing': bad, 'native_validation_formula': v.formula1, 'scope_note': 'openpyxl保存规则但不执行Excel输入拦截;本例另做既有值程序检查。'}5. 对照真实结果和检查表
实测2026-10-25T07:48:29.441771+00:00,HTTP200;请求gemini-2.5-flash-lite,返回gemini-2.5-flash-lite。本次5/5项检查通过,指本例执行及验收机制通过,不代表所有模型字段零误差。
最后一次返回用量223tokens;1份尝试记录的已知用量合计223。失败记录保留,用量缺失不按0计,本文不推算实际金额。
| 实际检查 | 结果 |
|---|---|
| 真实apizt API响应HTTP200 | 通过 |
| 模型结构化事实与原始材料一致 | 通过 |
| 验证器确实绑定B2:B4 | 通过 |
| 跨表名称指向真实选项区域 | 通过 |
| 空值允许但非法既有值单列 | 通过 |
- 实际检查
- 真实apizt API响应HTTP200
- 结果
- 通过
- 实际检查
- 模型结构化事实与原始材料一致
- 结果
- 通过
- 实际检查
- 验证器确实绑定B2:B4
- 结果
- 通过
- 实际检查
- 跨表名称指向真实选项区域
- 结果
- 通过
- 实际检查
- 空值允许但非法既有值单列
- 结果
- 通过
result.json · 原生处理后实际结果
{
"allowed": [
"支持",
"研发",
"运营"
],
"invalid_existing": [
{
"id": "F3",
"value": "待确认",
"reason": "not-in-list"
}
],
"native_validation_formula": "=AllowedDepartments",
"scope_note": "openpyxl保存规则但不执行Excel输入拦截;本例另做既有值程序检查。"
}6. 替换输入前,先确认这些边界
本例只验证合成材料和本地原生文件;不连接真实客户数据,不代表第三方SaaS已运行。
修改材料后应重新制定事实断言和反例。识别错误率、混淆矩阵或拒答类教程允许保留模型实际错误;检查通过指计算和处理正确。没有调用视频模型。
怎样确认已经完成
- 真实apizt API响应HTTP200
- 模型结构化事实与原始材料一致
- 验证器确实绑定B2:B4
- 跨表名称指向真实选项区域
- 空值允许但非法既有值单列
常见问题
AI生成Excel下拉校验怎么开始?
打开 source.xlsx 的Form表,核对三条既有部门记录:研发、空值和待确认;在 input.json 查明部门可选列表来自哪条政策。按本页顺序继续,先用下载包离线重放,再替换自己的材料。
网页试跑和下载包有什么区别?
网页只复跑模型字段,不生成全部原生文件;资料包包含实际原生处理和本地验收。
这次通过结果适用于其他材料吗?
本例只验证合成材料和本地原生文件;不连接真实客户数据,不代表第三方SaaS已运行。


