二维码文件验证记录
这里记录本站实际运行的自动化检查，包含成功和失败的对照文件。它帮助你复核方法，不是所有设备的识别保证，也不是第三方认证。
运行时间：（协调世界时） · Halo 产品维护团队 · 人工智能辅助编写与执行检查
输入与方法
编码内容：https://halo.wezzik.app/guide。使用实际应用的矢量渲染器，方形模块、深色前景、中等级容错、无标志、无外框；矩阵为 29 × 29 个模块，每侧留白 4 个模块。图像栅格化后使用独立解码库读取内容，只有与输入完全一致才记为通过。
运行环境：v24.20.0，darwin/arm64；矩阵库 1.5.4，栅格化库 0.34.5，解码器 jsQR 1.4.0。每个条件运行一次，四个结果不是统计性成功率。
实际应用的矢量渲染器，经软件栅格化后自动解码；没有测试浏览器画布下载、手机或纸张。展示图片在测试后放大，原测试尺寸另行记录。
四个真实对照结果
深色模块与白色背景
实际输入：640 × 640 像素；解码内容与输入一致。
展示图统一放大，不是原测试像素尺寸。小图放大不会恢复丢失的数据。
透明文件叠放在白色底板
实际输入：640 × 640 像素；解码内容与输入一致。
展示图统一放大，不是原测试像素尺寸。小图放大不会恢复丢失的数据。
同一透明文件叠放在与模块同色的背景
实际输入：640 × 640 像素；本次解码未读取到目标内容。
展示图统一放大，不是原测试像素尺寸。小图放大不会恢复丢失的数据。
基础版本缩小至三十二像素后再放大
实际输入：32 × 32 像素；本次解码未读取到目标内容。
展示图统一放大，不是原测试像素尺寸。小图放大不会恢复丢失的数据。
复核原文件与结论
白色背景的基础版本及透明文件加白色底板在本次软件检查中通过；同一透明文件叠放在与模块同色的背景、以及缩小至三十二像素的版本未被该解码器读取。结论只适用于这些输入和软件，不应推断所有照片背景都失败或某个固定尺寸一定成功。
独立复核时下载“原测试图片”，在自己的解码工具中检查是否返回同一内容；原始报告包含参数与每份测试图片的文件摘要，可核对文件是否一致。下载矢量文件后若自行选择背景或尺寸，已经是另一项实验，应另记条件。
脚本为开发环境记录，需要配套源码目录和依赖，不能直接在浏览器执行；独立读者无需安装本站工程，也能下载图片进行解码复核。
检查中发现并修正的问题
初次软件栅格化的基础版本未通过：定位图案的底色依赖样式变量，在本次栅格化环境中没有正确呈现；旧“方形”模块还带较大间隙。当前改为明确的定位底色与连续方形模块后，两个正常对照通过。本页公开的是修正后的文件，不能据此声称旧版本在所有手机上都无法扫描。
其他艺术图案仍属于需要单独验收的样式；本次没有得出点、星形、心形、渐变或添加标志的普遍结论。
印刷尺寸如何计算：不是最低尺寸保证
本例矩阵二十九模块，加左右各四模块留白，共三十七模块。若最终含留白的宽度为三十毫米，每模块约为 30 ÷ 37 = 0.811 毫米，每侧留白约 3.24 毫米。三百点每英寸的栅格宽度约为 30 ÷ 25.4 × 300 = 354 像素，实际输出需取整并复测。
这些是几何换算，不是三十毫米一定能扫描的实验结论。内容或容错等级改变后，模块数量可能变化，不能沿用本例。普通二维码每侧四模块留白的依据见二维码开发方说明。
尚未验证与现场验收
尚未进行真实手机、联系人导入、纸张、反光、拍摄距离、平台压缩或浏览器画布下载测试。发布前请测试最终文件与实物，而不是只扫描本页示例。
- 记录手机型号、系统、扫码方式、物料尺寸、纸张、光线、距离与角度。
- 区分未识别、内容错误和目标网页打不开，逐项记录，不只写“成功”。
- 至少用两种真实手机复测，并保留失败样品与人工访问入口。