展开本页目录
开始前准备什么
- 独立练习目录及Python 3.14;系统与Node依赖以README为准。
- 离线重放无需Key;新请求使用自己的apizt Key,先核对模型权限和当前价格。
- 原创合成材料,不需要登录第三方平台账号。
- 先看文件
- 按步骤操作
- 对照真实结果
- 离线或模型复跑
默认离线重放;包含完整失败尝试与本地检查,不含Key。
1. 核对本例材料与目标文件
参见本批TOPIC-RESEARCH.md同编号新增边界,原生小样与负例均独立交付。
先下载合成材料在独立目录练习。原始文件、模型输入与验收答案分别保留;本地核对答案不发送给模型。
input.json(节选)
{
"description": "虚构练习Wi-Fi:SSID为Lab;Guest,密码为p;a\\ss,WPA加密,不隐藏。不要连接真实网络。"
}2. 按顺序完成这项具体操作
本次实际使用Python 3.14,依赖版本固定在资料包。需要LibreOffice或Node的案例请先按README安装对应运行时。python run.py读取真实旧响应完成本地处理;只有显式--live才发新请求。
- 1. 准备只用于演示的Wi-Fi说明,SSID含分号,密码含分号和反斜杠;不读取或连接真实网络。
- 2. 让apizt只抽取ssid、password、security和hidden,逐字核对特殊字符没有被删改。
- 3. 由本地程序按Wi-Fi二维码语法转义反斜杠、分号、冒号、逗号和引号,再生成实际wifi-qr.png。
- 4. 用独立ZXing C++引擎解码该PNG,确认得到的payload与编码字符串一致,而非只比较生成前的文本。
- 5. 再对payload字段反转义,核对SSID与密码回到原字符串,将完整对照保存到qr-roundtrip.json;所有凭据均为虚构练习值。
独立练习目录 · 默认仅离线复核
python3 -m venv .venv
source .venv/bin/activate
python -m pip install -r requirements.txt
python run.py3. 对照真正发送的请求
只输出JSON:ssid、password、security、hidden。逐字提取虚构SSID和密码,保留分号和反斜杠,security为WPA,hidden布尔值。不要生成QR payload,由本地程序转义。
网页实验台只执行这一步模型字段检查。原生文件写入、坐标/公式/格式回读及负例验收由下载包负责。
request-1.json(图片Base64省略,原文件在下载包)
{
"model": "gemini-2.5-flash-lite",
"messages": [
{
"role": "system",
"content": "严格只输出单个JSON对象,不要Markdown代码围栏,不要解释。只输出JSON:ssid、password、security、hidden。逐字提取虚构SSID和密码,保留分号和反斜杠,security为WPA,hidden布尔值。不要生成QR payload,由本地程序转义。"
},
{
"role": "user",
"content": "任务约束(只输出JSON对象,不用代码围栏):\n只输出JSON:ssid、password、security、hidden。逐字提取虚构SSID和密码,保留分号和反斜杠,security为WPA,hidden布尔值。不要生成QR payload,由本地程序转义。\n待处理合成材料:\n{\"description\": \"虚构练习Wi-Fi:SSID为Lab;Guest,密码为p;a\\\\ss,WPA加密,不隐藏。不要连接真实网络。\"}"
}
],
"temperature": 0,
"max_tokens": 1536,
"provider": {
"sort": "success_rate"
},
"response_format": {
"type": "json_object"
}
}4. 查看原生处理代码与实际文件
下面节选来自本次实际执行的workflow.py分支,需要结合完整脚本运行。模型输出不能代替文件解析器或业务验算。
具体产物:wifi-qr.png、qr-roundtrip.json。
workflow.py · 本例分支节选
import qrcode, zxingcpp
from PIL import Image
ssid = 'Lab;Guest'
password = 'p;a\\ss'
check('SSID和密码原字符保留', output.get('ssid') == ssid and output.get('password') == password and (output.get('security') == 'WPA') and (output.get('hidden') is False))
def escape(text):
return ''.join(('\\' + c if c in '\\;,:"' else c for c in text))
payload = 'WIFI:T:' + str(output.get('security', '')) + ';S:' + escape(str(output.get('ssid', ''))) + ';P:' + escape(str(output.get('password', ''))) + ';H:' + str(output.get('hidden', False)).lower() + ';;'
qrcode.make(payload, error_correction=qrcode.constants.ERROR_CORRECT_M, box_size=10, border=4).save(artifact('wifi-qr.png'))
decoded = zxingcpp.read_barcode(Image.open(folder / 'wifi-qr.png'))
check('独立ZXing引擎能解码真实PNG', decoded is not None and decoded.text == payload)
fields = {}
token = ''
key = None
escaped = False
for ch in payload[len('WIFI:'):]:
if escaped:
token += ch
escaped = False
elif ch == '\\':
escaped = True
elif ch == ':' and key is None:
key = token
token = ''
elif ch == ';':
if key is not None:
fields[key] = token
token = ''
key = None
else:
token += ch
check('反转义后网络名密码完全一致', fields.get('S') == ssid and fields.get('P') == password)
result = {'payload': payload, 'decoded': decoded.text if decoded else None, 'roundtrip': fields, 'syntheticCredentialsOnly': True, 'connectedToNetwork': False}
dump(artifact('qr-roundtrip.json'), result)5. 对照真实结果和检查表
实测2026-10-25T07:55:08.026021+00:00,HTTP200;请求gemini-2.5-flash-lite,返回gemini-2.5-flash-lite。本次5/5项检查通过,指本例执行及验收机制通过,不代表所有模型字段零误差。
最后一次返回用量219tokens;1份尝试记录的已知用量合计219。失败记录保留,用量缺失不按0计,本文不推算实际金额。
| 实际检查 | 结果 |
|---|---|
| 真实apizt API响应HTTP200 | 通过 |
| SSID和密码原字符保留 | 通过 |
| 独立ZXing引擎能解码真实PNG | 通过 |
| 反转义后网络名密码完全一致 | 通过 |
| 列出的原生产物实际存在 | 通过 |
- 实际检查
- 真实apizt API响应HTTP200
- 结果
- 通过
- 实际检查
- SSID和密码原字符保留
- 结果
- 通过
- 实际检查
- 独立ZXing引擎能解码真实PNG
- 结果
- 通过
- 实际检查
- 反转义后网络名密码完全一致
- 结果
- 通过
- 实际检查
- 列出的原生产物实际存在
- 结果
- 通过
result.json · 原生处理后实际结果
{
"payload": "WIFI:T:WPA;S:Lab\\;Guest;P:p\\;a\\\\ss;H:false;;",
"decoded": "WIFI:T:WPA;S:Lab\\;Guest;P:p\\;a\\\\ss;H:false;;",
"roundtrip": {
"T": "WPA",
"S": "Lab;Guest",
"P": "p;a\\ss",
"H": "false"
},
"syntheticCredentialsOnly": true,
"connectedToNetwork": false
}6. 替换输入前,先确认这些边界
公开材料为原创合成小样。API模型阶段与本地处理分别验收;通过结构和来源检查不代表通用事实准确率。
修改材料后应重新制定事实断言和反例。识别错误率、混淆矩阵或拒答类教程允许保留模型实际错误;检查通过指计算和处理正确。没有调用视频模型。
怎样确认已经完成
- 真实apizt API响应HTTP200
- SSID和密码原字符保留
- 独立ZXing引擎能解码真实PNG
- 反转义后网络名密码完全一致
- 列出的原生产物实际存在
常见问题
AI WiFi 二维码 特殊字符怎么开始?
准备只用于演示的Wi-Fi说明,SSID含分号,密码含分号和反斜杠;不读取或连接真实网络。按本页顺序继续,先用下载包离线重放,再替换自己的材料。
网页试跑和下载包有什么区别?
网页只复跑模型字段,不生成全部原生文件;资料包包含实际原生处理和本地验收。
这次通过结果适用于其他材料吗?
公开材料为原创合成小样。API模型阶段与本地处理分别验收;通过结构和来源检查不代表通用事实准确率。



