展开本页目录
开始前准备什么
- 独立练习目录及Python 3.14;系统与Node依赖以README为准。
- 离线重放无需Key;新请求使用自己的apizt Key,先核对模型权限和当前价格。
- 原创合成材料,不需要登录第三方平台账号。
- 先看文件
- 按步骤操作
- 对照真实结果
- 离线或模型复跑
默认离线重放;包含完整失败尝试与本地检查,不含Key。
1. 核对本例材料与目标文件
不是银行/税务建议,产物是虚构售后账本及分摊检查。需人工重叠复核。
先下载合成材料在独立目录练习。原始文件、模型输入与验收答案分别保留;本地核对答案不发送给模型。
input.json(节选)
{
"policy": "优惠按各商品行原价金额比例分摊;分位余数按商品ID升序补给,退款按行内件数平均分摊。",
"lines": [
{
"id": "A",
"qty": 2,
"unit_price": "10.00"
},
{
"id": "B",
"qty": 1,
"unit_price": "10.00"
}
],
"discount": "1.00",
"return": {
"line": "A",
"qty": 1
}
}2. 按顺序完成这项具体操作
本次实际使用Python 3.14,依赖版本固定在资料包。需要LibreOffice或Node的案例请先按README安装对应运行时。python run.py读取真实旧响应完成本地处理;只有显式--live才发新请求。
- 1. 读取 source-lines.csv,核对A商品2件单价10.00、B商品1件单价10.00,以及整单优惠1.00元和退A中1件的约定。
- 2. 让 apizt 提取按行原价金额比例分摊、分位余数规则与退货件数,保留原政策,不让模型估算退款总额。
- 3. 把所有金额转成整数分,先按原价比例将优惠分为A行67分、B行33分,再按件序把A行优惠分到两件。
- 4. 回读 unit-refund-ledger.csv,逐件核对原价、分摊优惠、净金额和returned标记;本例退A第一件的实际退款为9.66元。
- 5. 验证优惠总分位没有丢失,退款加未退商品对应实付仍等于原订单实付29.00元;不能把整行优惠重复扣到每一件上。
独立练习目录 · 默认仅离线复核
python3 -m venv .venv
source .venv/bin/activate
python -m pip install -r requirements.txt
python run.py3. 对照真正发送的请求
只处理给定原创虚构材料,只输出JSON。提取退款约定:allocation_basis为line_original_amount,rounding为largest_remainder_cent,refund_units正整数。优惠按原价金额比例分摊到商品行,再按行内件数分摊,分位余数给排序更前的行/件。 输出结构:{"allocation_basis": "string", "rounding": "string", "refund_units": "number"}
网页实验台只执行这一步模型字段检查。原生文件写入、坐标/公式/格式回读及负例验收由下载包负责。
request-1.json(图片Base64省略,原文件在下载包)
{
"model": "gemini-2.5-flash-lite",
"messages": [
{
"role": "system",
"content": "严格只输出单个JSON对象,不要Markdown代码围栏,不要解释。只处理给定原创虚构材料,只输出JSON。提取退款约定:allocation_basis为line_original_amount,rounding为largest_remainder_cent,refund_units正整数。优惠按原价金额比例分摊到商品行,再按行内件数分摊,分位余数给排序更前的行/件。 输出结构:{\"allocation_basis\": \"string\", \"rounding\": \"string\", \"refund_units\": \"number\"}"
},
{
"role": "user",
"content": "任务约束(只输出JSON对象,不用代码围栏):\n只处理给定原创虚构材料,只输出JSON。提取退款约定:allocation_basis为line_original_amount,rounding为largest_remainder_cent,refund_units正整数。优惠按原价金额比例分摊到商品行,再按行内件数分摊,分位余数给排序更前的行/件。 输出结构:{\"allocation_basis\": \"string\", \"rounding\": \"string\", \"refund_units\": \"number\"}\n待处理合成材料:\n{\"policy\": \"优惠按各商品行原价金额比例分摊;分位余数按商品ID升序补给,退款按行内件数平均分摊。\", \"lines\": [{\"id\": \"A\", \"qty\": 2, \"unit_price\": \"10.00\"}, {\"id\": \"B\", \"qty\": 1, \"unit_price\": \"10.00\"}], \"discount\": \"1.00\", \"return\": {\"line\": \"A\", \"qty\": 1}}"
}
],
"temperature": 0,
"max_tokens": 1024,
"provider": {
"sort": "success_rate"
},
"response_format": {
"type": "json_object"
}
}4. 查看原生处理代码与实际文件
下面节选来自本次实际执行的workflow.py分支,需要结合完整脚本运行。模型输出不能代替文件解析器或业务验算。
具体产物:unit-refund-ledger.csv、result.json、checks.json、preview.html。
workflow.py · 本例分支节选
lines = data['lines']
gross = {r['id']: D(r['unit_price']) * r['qty'] for r in lines}
total = sum(gross.values())
discount_cents = int(D(data['discount']) * 100)
raw = {k: D(discount_cents) * v / total for k, v in gross.items()}
allocated = {k: int(v) for k, v in raw.items()}
remainder = discount_cents - sum(allocated.values())
for key in sorted(raw, key=lambda k: (-(raw[k] - int(raw[k])), k))[:remainder]:
allocated[key] += 1
rows = []
refund = 0
for line in lines:
base, extra = divmod(allocated[line['id']], line['qty'])
for ordinal in range(1, line['qty'] + 1):
off = base + (ordinal <= extra)
net = int(D(line['unit_price']) * 100) - off
returned = line['id'] == data['return']['line'] and ordinal <= output['refund_units']
if returned:
refund += net
rows.append({'line': line['id'], 'unit': ordinal, 'original_cents': int(D(line['unit_price']) * 100), 'discount_cents': off, 'net_cents': net, 'returned': returned})
paid = int(total * 100) - discount_cents
remaining = sum((r['net_cents'] for r in rows if not r['returned']))
check('优惠总额分位守恒', sum((r['discount_cents'] for r in rows)) == discount_cents)
check('行分摊A67分B33分', allocated == {'A': 67, 'B': 33})
check('退款加剩余货款仍等于实付', refund + remaining == paid)
check('部分退货金额9.66元', refund == 966)
cout('unit-refund-ledger.csv', rows)
result = {'line_discount_cents': allocated, 'refund': money(D(refund) / 100), 'remaining_paid': money(D(remaining) / 100), 'original_paid': money(D(paid) / 100), 'rounding_note': '先分摊优惠到商品行,再把行优惠分摊到各件;相同余数按ID/件序升序。'}5. 对照真实结果和检查表
实测2026-10-25T07:51:32.352498+00:00,HTTP200;请求gemini-2.5-flash-lite,返回gemini-2.5-flash-lite。本次6/6项检查通过,指本例执行及验收机制通过,不代表所有模型字段零误差。
最后一次返回用量381tokens;1份尝试记录的已知用量合计381。失败记录保留,用量缺失不按0计,本文不推算实际金额。
| 实际检查 | 结果 |
|---|---|
| 真实apizt API响应HTTP200 | 通过 |
| 模型结构化事实与原始材料一致 | 通过 |
| 优惠总额分位守恒 | 通过 |
| 行分摊A67分B33分 | 通过 |
| 退款加剩余货款仍等于实付 | 通过 |
| 部分退货金额9.66元 | 通过 |
- 实际检查
- 真实apizt API响应HTTP200
- 结果
- 通过
- 实际检查
- 模型结构化事实与原始材料一致
- 结果
- 通过
- 实际检查
- 优惠总额分位守恒
- 结果
- 通过
- 实际检查
- 行分摊A67分B33分
- 结果
- 通过
- 实际检查
- 退款加剩余货款仍等于实付
- 结果
- 通过
- 实际检查
- 部分退货金额9.66元
- 结果
- 通过
result.json · 原生处理后实际结果
{
"line_discount_cents": {
"A": 67,
"B": 33
},
"refund": "9.66",
"remaining_paid": "19.34",
"original_paid": "29.00",
"rounding_note": "先分摊优惠到商品行,再把行优惠分摊到各件;相同余数按ID/件序升序。"
}6. 替换输入前,先确认这些边界
本例只验证合成材料和本地原生文件;不连接真实客户数据,不代表第三方SaaS已运行。
修改材料后应重新制定事实断言和反例。识别错误率、混淆矩阵或拒答类教程允许保留模型实际错误;检查通过指计算和处理正确。没有调用视频模型。
怎样确认已经完成
- 真实apizt API响应HTTP200
- 模型结构化事实与原始材料一致
- 优惠总额分位守恒
- 行分摊A67分B33分
- 退款加剩余货款仍等于实付
- 部分退货金额9.66元
常见问题
AI 部分退款 分摊怎么开始?
读取 source-lines.csv,核对A商品2件单价10.00、B商品1件单价10.00,以及整单优惠1.00元和退A中1件的约定。按本页顺序继续,先用下载包离线重放,再替换自己的材料。
网页试跑和下载包有什么区别?
网页只复跑模型字段,不生成全部原生文件;资料包包含实际原生处理和本地验收。
这次通过结果适用于其他材料吗?
本例只验证合成材料和本地原生文件;不连接真实客户数据,不代表第三方SaaS已运行。


