尚未生成二维码解决的问题
二维码只有在能够读取且内容正确时才有价值
二维码是机器可读的数据表示。静态二维码把最终目标或消息直接写入模块，不依赖 Xephory 跳转、用户账户或持续订阅。因此，它适合菜单、标签、包装、活动资料、联系人卡片和内部说明；图像下载后仍可独立使用。
生成黑白方块并不代表任务完成。裁掉空白边缘、使用低对比度、印刷过小或编码过长的网址，都会使形式正确的矩阵难以扫描。有些服务还会用跟踪网址隐藏真实目标。本工具显示完整载荷，强制采用可读性默认值，并在开放下载前执行第二次独立解码。
最终用途仍由你负责。请在另一台设备上打开文件，使用目标用户常用的相机进行测试，并在最终排版或试印后再次检查。浏览器验证证明二维码在干净数字条件下可读，但不能模拟每种打印机、材质、灯光、相机或受损标签。
七种内容构建方式，一个可检查的结果
每个结构化表单都会生成标准文本载荷，并在预览下方完整显示。普通文本只会去除首尾空白。没有协议的网址会自动添加 https://；包含用户名或密码的网址会被拒绝。
邮件、电话、短信、Wi-Fi 与 vCard 表单可以减少标点格式错误，但接收端应用决定具体行为。例如，一个扫码器可能直接打开邮件草稿，另一个则先显示文本。隐藏网络和旧式 WEP 网络在不同系统上的支持尤其不一致。
| 类型 | 编码形式 | 常见用途 |
|---|---|---|
| 网址 | https://example.com/path | 带有可见 HTTP 或 HTTPS 目标的公开网页。 |
| 文本 | UTF-8 文本 | 短说明、编号、参考信息或多语言内容。 |
| 邮件 | mailto: 地址，可含主题和正文 | 在兼容的邮件应用中准备新邮件。 |
| 电话 | tel:+号码 | 提供拨号操作，但不会自动发起通话。 |
| 短信 | sms:号码?body=消息 | 打开带有可选预填内容的短信草稿。 |
| Wi-Fi | WIFI:T:...;S:...;P:...;; | 向兼容扫码器提供 WPA/WPA2、WEP 或开放网络参数。 |
| vCard | vCard 3.0 | 分享姓名、组织和至少一种联系方式。 |
从内容到文件的可靠流程
- 选择内容类型，只输入收件人应当获得的数据。不要把敏感个人信息放入公开展示的二维码。
- 选择纠错级别。Q 是平衡默认值；L 往往生成较稀疏的符号，H 增加恢复数据但减少内容容量。
- 二维码四周至少保留四个空白模块。如果周围设计复杂，应增大静区。
- 使用深色前景和浅色背景。本工具要求至少 4.5:1 对比度，并阻止反色组合。
- 点击生成。浏览器用 UTF-8 构建矩阵，绘制干净验证图像，再交给独立解码器读取。
- 检查完整载荷和技术指标。普通文档可用 PNG，需要无损缩放的设计与印刷可用 SVG。
- 使用第二台设备扫描下载文件，并在最终设计或试印完成后再次测试。
内置测量示例
经过验证的 Xephory AI Lab 链接
“使用测量示例”会编码 https://xephory.com/ai-lab/，使用 Q 级纠错、四模块静区、#111827 前景和白色背景。该链接为 27 个 UTF-8 字节，生成 QR 版本 3、29 x 29 模块矩阵以及 512 x 512 PNG 设置。
这组颜色的对比度为 17.74:1。在开放下载前，独立解码器读取 1024 像素验证图，并逐字符与 27 字节原始载荷比较。这是可重复的功能示例，并不保证每一种实体复制品都能扫描。
当示例成功而自定义长内容失败时，通常是容量问题。请缩短内容或降低纠错级别，不要通过移除静区来节省空间。
影响扫描可靠性的设置
纠错会添加冗余码字。L、M、Q、H 常见百分比表示对局部损坏的大约恢复能力，并不保证任何形式的损坏都能恢复相同比例。纠错越高，通常需要越密集的矩阵并占用更多容量。
静区是二维码周围的空白区域，用于将定位图案与文字、边框和图形分离。本工具不允许少于四模块。PNG 使用整数像素模块并在画布中居中，避免分数缩放造成的模糊边缘。
颜色会在生成前检查。深色前景、浅色背景以及明显亮度差最可靠。本工具不提供渐变、透明背景、反色二维码或覆盖数据模块的标志，因为这些装饰难以进行可靠验证。
- L：恢复数据最少，通常密度最低。
- M：适合干净数字环境的中等设置。
- Q：适合文档、标签和普通印刷的默认平衡。
- H：为更困难条件提供更多恢复数据，但容量更小、密度更高。
- 256 至 2048 像素 PNG 均使用清晰的整数模块边缘。
- SVG 可无限缩放，但导入软件必须保留 viewBox 和完整静区。
生成与独立验证的工作方式
浏览器把最终载荷转换为 UTF-8 字节，并交给经过实践检验的二维码矩阵生成库。生成器选择能够容纳数据和纠错的最小版本，选择掩模，并把数据与恢复码字写入模块网格。
随后 Xephory 独立渲染网格。SVG 使用整数模块坐标和清晰边缘指令；PNG 直接写入 RGBA 像素缓冲区，而不是截取预览图。颜色、尺寸和静区同时应用于两种格式。
在允许下载前，另一套解码库会读取 1024 x 1024 验证图。解码字符串必须与原始载荷完全一致。这可以在干净条件下发现库未加载、矩阵损坏、中文或其他 UTF-8 编码错误，以及不适合扫描的颜色。
- 工作区最多接受 2,000 个 UTF-8 字节。
- 根据内容与纠错自动选择 QR 版本 1 至 40。
- 静区必须为 4 至 8 模块。
- 对比度至少 4.5:1，且前景必须更暗。
- 使用 1024 x 1024 图像进行本地解码验证。
- 没有服务器端接口接收或转换二维码内容。
为真实标签准备 PNG 或 SVG
当设计软件或印刷流程能够保留矢量时，请选择 SVG；当目标软件更适合位图时，请选择 PNG。不要裁掉浅色边缘，也不要把正方形拉伸为长方形。若软件重新采样 PNG，请检查最终 PDF 或导出图像，而不只是编辑器预览。
实际物理尺寸取决于扫描距离、相机质量、二维码密度、材料和印刷工艺。相同宽度下，版本 3 比密集的版本 20 更容易复制。真实环境中的试扫比一个通用毫米数值更有意义。
- 在内置静区外也保留空间，不要添加贴得很紧的装饰边框。
- 尽量避免折痕、强反光覆膜、弯曲表面和质量差的热敏印刷。
- 除非测试每个生产版本，否则不要在矩阵中心覆盖标志。
- 按最终尺寸试印，并从不同角度、距离和光线下扫描。
- 面向公众时，请测试较新的 iOS 与 Android 设备。
隐私、安全与目标控制
生成和验证都在浏览器内完成。本工具没有上传二维码内容的 API。网站共用的统计与广告脚本由同意系统控制，但生成器不会把工作区中输入的数据发送给这些服务。
二维码不是加密。任何能够看到或拍摄二维码的人都可以读取内容。Wi-Fi 二维码会暴露网络名称和密码，vCard 会暴露所有填写字段。请勿编码访问令牌、恢复码、支付秘密或私人管理网址。
静态二维码不能保护或监控目标。请使用自己控制的域名，保持 HTTPS 有效；如果长期控制很重要，应避免第三方短网址。即使二维码技术上正确，目标页面也可能危险或日后被入侵。
- 下载前检查结果下方显示的完整载荷。
- 不要公开私人或管理 Wi-Fi 网络的访问凭据。
- 只有所有观看者均获授权时，才编码密码或个人信息。
- 持续控制链接域名，并在印刷后维护目标页面。
- 说明扫码后应发生的动作，不要只展示无说明的二维码方块。
本生成器有意不提供的功能
本工具只创建静态符号，不提供下载后修改目标、扫描统计、活动跟踪、托管落地页或链接缩短。这些能力需要持续运行的跳转服务，并会改变隐私与寿命。
内置解码器检查干净的本地图像，而不是最终产品的照片。它不能认证打印机、保证目标未来可用，也不能保证每个扫码应用都支持所有结构化类型。
- 不提供动态跳转或下载后的目标修改。
- 不提供扫描统计、跟踪像素或活动标识。
- 不提供标志覆盖、圆角模块、渐变或透明背景。
- 不保证损坏、裁切、变形或印刷不良的复制品。
- 不验证链接页面的安全性、可用性或所有权。
- 不存储内容，也无法日后恢复以前生成的记录。
常见问题
这个二维码会过期吗？
图像本身没有有效期，并会一直保存同一静态内容。链接页面仍可能迁移、失效或下线，因此长期可用性取决于你控制的目标。
静态二维码与动态二维码有什么区别？
静态二维码直接保存最终值。动态服务通常保存一个可修改或统计的跳转网址。本工具只创建静态二维码，不运营跳转服务。
应该选择哪种纠错级别？
Q 是实用默认值。短内容和干净数字用途可选 L 或 M；H 提供更多恢复数据，但符号更密、容量更小。始终测试最终成品。
为什么禁止低对比度或反色？
许多扫码器针对浅色背景上的深色模块优化。强对比和常规极性可以减少可避免的失败。本工具要求至少 4.5:1。
通过验证是否保证印刷品可用？
不能。验证只确认独立解码器可以读取干净数字图像并还原准确内容。印刷、裁切、反光、曲面、距离和相机仍需要实物测试。
Wi-Fi 密码在二维码中安全吗？
不安全。密码属于可读载荷的一部分。任何看到或拍摄二维码的人都可能获取它。建议使用访客网络，并在密码更改后替换公开标牌。
为什么长内容在 H 级失败？
H 会把更多容量留给恢复码字。同一段文本可能适合 L 或 M，却超过 H 的数据容量。请缩短内容或降低级别，不要移除静区。
应该下载 PNG 还是 SVG？
PNG 适合办公文档、网页和位图软件；SVG 适合可缩放设计与印刷。无论哪种格式，都要保持正方形和完整浅色边缘。