展开本页目录
开始前准备什么
- 独立练习目录及Python 3.14；系统与Node依赖以README为准。
- 离线重放无需Key；新请求使用自己的apizt Key，先核对模型权限和当前价格。
- 原创合成材料，不需要登录第三方平台账号。
- 先看文件
- 按步骤操作
- 对照真实结果
- 离线或模型复跑
默认离线重放；包含完整失败尝试与本地检查，不含Key。
1. 核对本例材料与目标文件
区别通用联系人去重/前导零，本篇产物是可导入的vCard通讯录文件及多值/折行语法验证。需人工重叠复核。
先下载合成材料在独立目录练习。原始文件、模型输入与验收答案分别保留；本地核对答案不发送给模型。
input.json（节选）
{
"text": "姓名：林桥；公司：青禾,设备；电话：+86-100-1111、+86-100-2222；备注第一行：周二联系\n备注第二行：分机;需确认"
}
实际输入、原始文件和本例操作约束的浏览器截图
2. 按顺序完成这项具体操作
本次实际使用Python 3.14，依赖版本固定在资料包。需要LibreOffice或Node的案例请先按README安装对应运行时。python run.py读取真实旧响应完成本地处理；只有显式--live才发新请求。
- 1. 查看 input.json 的合成名片，逐项标出姓名、含逗号的公司名、两个电话，以及包含换行和分号的两行备注。
- 2. 通过 apizt 提取字段，保留 output-1.txt 原文；该次模型保留了备注第一行/第二行标签，事实内容和两个电话均完整。
- 3. 查看 result.json 的model_original和model_normalization，仅移除与源文完全匹配的两处备注字段标签；保留备注正文、换行、逗号、分号与电话加号。
- 4. 生成 contact.vcf，再用独立vCard解析器重新读取，核对两条TEL、组织名逗号和备注换行/分号均往返一致。
- 5. 检查本地源文限定适配的负例：把周二改成周三、漏掉第二行或改变值内标点都应被拒绝；兼容标签形式不等于接受内容变化。
独立练习目录 · 默认仅离线复核
python3 -m venv .venv
source .venv/bin/activate
python -m pip install -r requirements.txt
python run.py3. 对照真正发送的请求
只处理给定原创虚构材料，只输出JSON。提取name、organization、phones数组、note；原文的分号、逗号和换行都要保留为实际字符串，电话保留+。 输出结构：{"name": "string", "organization": "string", "phones": ["string"], "note": "string"}
网页实验台只执行这一步模型字段检查。原生文件写入、坐标/公式/格式回读及负例验收由下载包负责。
request-1.json（图片Base64省略，原文件在下载包）
{
"model": "gemini-2.5-flash-lite",
"messages": [
{
"role": "system",
"content": "严格只输出单个JSON对象，不要Markdown代码围栏，不要解释。只处理给定原创虚构材料，只输出JSON。提取name、organization、phones数组、note；原文的分号、逗号和换行都要保留为实际字符串，电话保留+。 输出结构：{\"name\": \"string\", \"organization\": \"string\", \"phones\": [\"string\"], \"note\": \"string\"}"
},
{
"role": "user",
"content": "任务约束（只输出JSON对象，不用代码围栏）：\n只处理给定原创虚构材料，只输出JSON。提取name、organization、phones数组、note；原文的分号、逗号和换行都要保留为实际字符串，电话保留+。 输出结构：{\"name\": \"string\", \"organization\": \"string\", \"phones\": [\"string\"], \"note\": \"string\"}\n待处理合成材料：\n{\"text\": \"姓名：林桥；公司：青禾,设备；电话：+86-100-1111、+86-100-2222；备注第一行：周二联系\\n备注第二行：分机;需确认\"}"
}
],
"temperature": 0,
"max_tokens": 1024,
"provider": {
"sort": "success_rate"
},
"response_format": {
"type": "json_object"
}
}4. 查看原生处理代码与实际文件
下面节选来自本次实际执行的workflow.py分支，需要结合完整脚本运行。模型输出不能代替文件解析器或业务验算。
具体产物：contact.vcf、result.json、checks.json、preview.html。
workflow.py · 本例分支节选
import vobject
def esc(s):
return s.replace('\\', '\\\\').replace('\n', '\\n').replace(';', '\\;').replace(',', '\\,')
text = 'BEGIN:VCARD\r\nVERSION:4.0\r\nFN:' + esc(output['name']) + '\r\nN:' + esc(output['name']) + ';;;;\r\nORG:' + esc(output['organization']) + '\r\n' + ''.join(('TEL;VALUE=uri:tel:' + x + '\r\n' for x in output['phones'])) + 'NOTE:' + esc(output['note']) + '\r\nEND:VCARD\r\n'
(folder / 'contact.vcf').write_text(text, newline='')
artifacts.append('contact.vcf')
r = vobject.readOne(text)
phones = [str(x.value).removeprefix('tel:') for x in r.contents['tel']]
check('独立vCard解析器保留两个电话', phones == output['phones'])
check('组织名逗号转义往返', r.org.value == [output['organization']])
check('中文换行和分号往返', r.note.value == output['note'])
result = {'name': r.fn.value, 'organization': r.org.value, 'phones': phones, 'note': r.note.value}5. 对照真实结果和检查表
实测2026-10-25T07:50:54.201926+00:00，HTTP200；请求gemini-2.5-flash-lite，返回gemini-2.5-flash-lite。本次5/5项检查通过，指本例执行及验收机制通过，不代表所有模型字段零误差。
最后一次返回用量306tokens；1份尝试记录的已知用量合计306。失败记录保留，用量缺失不按0计，本文不推算实际金额。
| 实际检查 | 结果 |
|---|---|
| 真实apizt API响应HTTP200 | 通过 |
| 模型结构化事实与原始材料一致 | 通过 |
| 独立vCard解析器保留两个电话 | 通过 |
| 组织名逗号转义往返 | 通过 |
| 中文换行和分号往返 | 通过 |
- 实际检查
- 真实apizt API响应HTTP200
- 结果
- 通过
- 实际检查
- 模型结构化事实与原始材料一致
- 结果
- 通过
- 实际检查
- 独立vCard解析器保留两个电话
- 结果
- 通过
- 实际检查
- 组织名逗号转义往返
- 结果
- 通过
- 实际检查
- 中文换行和分号往返
- 结果
- 通过
result.json · 原生处理后实际结果
{
"name": "林桥",
"organization": [
"青禾,设备"
],
"phones": [
"+86-100-1111",
"+86-100-2222"
],
"note": "周二联系\n分机;需确认",
"model_original": {
"name": "林桥",
"organization": "青禾,设备",
"phones": [
"+86-100-1111",
"+86-100-2222"
],
"note": "备注第一行：周二联系\n备注第二行：分机;需确认"
},
"model_normalization": {
"model_original": {
"name": "林桥",
"organization": "青禾,设备",
"phones": [
"+86-100-1111",
"+86-100-2222"
],
"note": "备注第一行：周二联系\n备注第二行：分机;需确认"
},
"normalized_fields": {
"name": "林桥",
"organization": "青禾,设备",
"phones": [
"+86-100-1111",
"+86-100-2222"
],
"note": "周二联系\n分机;需确认"
},
"rules": [
{
"field": "note",
"original": "备注第一行：周二联系\n备注第二行：分机;需确认",
"normalized": "周二联系\n分机;需确认",
"rule": "Only remove the exact two metadata labels present in this source; preserve every value character and newline."
}
]
}
}
本例实际产物与原始响应的浏览器截图；本地检查和模型答案分开记录
6. 替换输入前，先确认这些边界
本例只验证合成材料和本地原生文件；不连接真实客户数据，不代表第三方SaaS已运行。
修改材料后应重新制定事实断言和反例。识别错误率、混淆矩阵或拒答类教程允许保留模型实际错误；检查通过指计算和处理正确。没有调用视频模型。
怎样确认已经完成
- 真实apizt API响应HTTP200
- 模型结构化事实与原始材料一致
- 独立vCard解析器保留两个电话
- 组织名逗号转义往返
- 中文换行和分号往返
常见问题
AI 联系人 导出 VCF vCard怎么开始？
查看 input.json 的合成名片，逐项标出姓名、含逗号的公司名、两个电话，以及包含换行和分号的两行备注。按本页顺序继续，先用下载包离线重放，再替换自己的材料。
网页试跑和下载包有什么区别？
网页只复跑模型字段，不生成全部原生文件；资料包包含实际原生处理和本地验收。
这次通过结果适用于其他材料吗？
本例只验证合成材料和本地原生文件；不连接真实客户数据，不代表第三方SaaS已运行。