展开本页目录
开始前准备什么
- 独立练习目录及Python 3.14;系统与Node依赖以README为准。
- 离线重放无需Key;新请求使用自己的apizt Key,先核对模型权限和当前价格。
- 原创合成材料,不需要登录第三方平台账号。
- 先看文件
- 按步骤操作
- 对照真实结果
- 离线或模型复跑
默认离线重放;包含完整失败尝试与本地检查,不含Key。
1. 核对本例材料与目标文件
原生文件生成、回读和独立检查均可重放;模型结果与文件处理分开验收。
先下载合成材料在独立目录练习。原始文件、模型输入与验收答案分别保留;本地核对答案不发送给模型。
input.json(节选)
{
"style": "Use short action labels in English."
}2. 按顺序完成这项具体操作
本次实际使用Python 3.14,依赖版本固定在资料包。需要LibreOffice或Node的案例请先按README安装对应运行时。python run.py读取真实旧响应完成本地处理;只有显式--live才发新请求。
- 1. 保存含三个真实超链接的DOCX
- 2. 只让API改写显示标签
- 3. 按现有关系ID更新文字
- 4. 重新读取链接目标与关系ID
- 5. 渲染对照标签与地址
独立练习目录 · 默认仅离线复核
python3 -m venv .venv
source .venv/bin/activate
python -m pip install -r requirements.txt
python run.py3. 对照真正发送的请求
只处理给定原创虚构材料。只输出JSON,不补未提供的事实。输出labels对象,键link1/link2/link3,值依次为Read guide、View schedule、Open checklist。
网页实验台只执行这一步模型字段检查。原生文件写入、坐标/公式/格式回读及负例验收由下载包负责。
request-1.json(图片Base64省略,原文件在下载包)
{
"model": "gemini-2.5-flash-lite",
"messages": [
{
"role": "system",
"content": "严格只输出单个JSON对象,不要Markdown代码围栏,不要解释。只处理给定原创虚构材料。只输出JSON,不补未提供的事实。输出labels对象,键link1/link2/link3,值依次为Read guide、View schedule、Open checklist。"
},
{
"role": "user",
"content": "任务约束(只输出JSON对象,不用代码围栏):\n只处理给定原创虚构材料。只输出JSON,不补未提供的事实。输出labels对象,键link1/link2/link3,值依次为Read guide、View schedule、Open checklist。\n待处理合成材料:\n{\"style\": \"Use short action labels in English.\", \"links\": [{\"id\": \"link1\", \"label\": \"guide\"}, {\"id\": \"link2\", \"label\": \"schedule\"}, {\"id\": \"link3\", \"label\": \"checklist\"}]}"
}
],
"temperature": 0,
"max_tokens": 1200,
"provider": {
"sort": "success_rate"
},
"response_format": {
"type": "json_object"
}
}4. 查看原生处理代码与实际文件
下面节选来自本次实际执行的workflow.py分支,需要结合完整脚本运行。模型输出不能代替文件解析器或业务验算。
具体产物:rewritten.docx、render-rewritten/rewritten.pdf、render-rewritten/rewritten-page-1.png、result.json、checks.json。
workflow.py · 本例分支节选
d = Document(f / 'source.docx')
before = json.loads((f / 'links-before.json').read_text())
found = []
for i, p in enumerate(d.paragraphs, 1):
for link in p._p.findall(qn('w:hyperlink')):
texts = link.findall('.//' + qn('w:t'))
texts[0].text = str(output.get('labels', {}).get('link' + str(i), ''))
for other in texts[1:]:
other.text = ''
d.save(f / 'rewritten.docx')
r = Document(f / 'rewritten.docx')
for i, p in enumerate(r.paragraphs, 1):
for link in p._p.findall(qn('w:hyperlink')):
rid = link.get(qn('r:id'))
found.append({'id': 'link' + str(i), 'label': ''.join((x.text or '' for x in link.findall('.//' + qn('w:t')))), 'rid': rid, 'target': r.part.rels[rid].target_ref})
ck('三个链接的关系ID与目标未改', [(r['rid'], r['target']) for r in found] == [(r['rid'], r['target']) for r in before])
ck('模型改写标签实际写入', [r['label'] for r in found] == ['Read guide', 'View schedule', 'Open checklist'])
result = {'before': before, 'after': found}
add_native(f / 'rewritten.docx')5. 对照真实结果和检查表
实测2026-10-25T07:49:29.559163+00:00,HTTP200;请求gemini-2.5-flash-lite,返回gemini-2.5-flash-lite。本次3/3项检查通过,指本例执行及验收机制通过,不代表所有模型字段零误差。
最后一次返回用量209tokens;1份尝试记录的已知用量合计209。失败记录保留,用量缺失不按0计,本文不推算实际金额。
| 实际检查 | 结果 |
|---|---|
| 真实apizt API响应HTTP200 | 通过 |
| 三个链接的关系ID与目标未改 | 通过 |
| 模型改写标签实际写入 | 通过 |
- 实际检查
- 真实apizt API响应HTTP200
- 结果
- 通过
- 实际检查
- 三个链接的关系ID与目标未改
- 结果
- 通过
- 实际检查
- 模型改写标签实际写入
- 结果
- 通过
result.json · 原生处理后实际结果
{
"before": [
{
"id": "link1",
"label": "guide",
"rid": "rId9",
"target": "https://example.invalid/guide"
},
{
"id": "link2",
"label": "schedule",
"rid": "rId10",
"target": "https://example.invalid/schedule"
},
{
"id": "link3",
"label": "checklist",
"rid": "rId11",
"target": "https://example.invalid/checklist"
}
],
"after": [
{
"id": "link1",
"label": "Read guide",
"rid": "rId9",
"target": "https://example.invalid/guide"
},
{
"id": "link2",
"label": "View schedule",
"rid": "rId10",
"target": "https://example.invalid/schedule"
},
{
"id": "link3",
"label": "Open checklist",
"rid": "rId11",
"target": "https://example.invalid/checklist"
}
]
}6. 替换输入前,先确认这些边界
本例只验证合成小样与本地文件;没有登录第三方SaaS,打印预览不等于物理打印。
修改材料后应重新制定事实断言和反例。识别错误率、混淆矩阵或拒答类教程允许保留模型实际错误;检查通过指计算和处理正确。没有调用视频模型。
怎样确认已经完成
- 真实apizt API响应HTTP200
- 三个链接的关系ID与目标未改
- 模型改写标签实际写入
常见问题
AI Word 超链接 保留怎么开始?
保存含三个真实超链接的DOCX按本页顺序继续,先用下载包离线重放,再替换自己的材料。
网页试跑和下载包有什么区别?
网页只复跑模型字段,不生成全部原生文件;资料包包含实际原生处理和本地验收。
这次通过结果适用于其他材料吗?
本例只验证合成小样与本地文件;没有登录第三方SaaS,打印预览不等于物理打印。



