QRazyBox 二维码修复完整指南从损坏图像中重建可扫描二维码的实用教程【免费下载链接】qrazyboxQR Code Analysis and Recovery Toolkit项目地址: https://gitcode.com/gh_mirrors/qr/qrazybox场景重现你刚刚扫描一张破损的二维码手机提示无法识别。放大图片后发现定位方块少了一角、格式信息区域模糊成一片、数据区还有几十个模块被污渍覆盖。传统扫描器到此为止但这张码真的没救了吗未必。QRazyBoxQR Code Analysis and Recovery Toolkit就是为这类场景而生的免费开源 Web 工具它允许你像用画图软件一样逐模块重建二维码再借助格式信息暴力破解与里德-所罗门纠错算法把扫不出来的码一步步救回来最高支持版本 40177×177 模块。一句话定位它不是扫描器而是二维码的手术台QRazyBox 与普通扫码工具的本质区别在于普通解码器遇到错误就停机报错而 QRazyBox 假定二维码注定是坏的它的整套流程围绕分析损坏程度→手动/自动修复→纠错解码展开。先看几个关键数字核心指标数值支持版本范围版本 1 至 4021×21 到 177×177 模块纠错等级L / M / Q / H 全部支持格式信息暴力破解组合数4 种纠错等级 × 8 种掩码 32 种已知错误位置擦除纠正时的恢复上限可达损坏数据的 60%Level H运行方式纯浏览器本地运行零安装、零依赖结论先行只要二维码的核心结构定位标记、时序线能被重建剩余的数据区哪怕缺失 30%~60%QRazyBox 都有机会靠算法补全。这正是它区别于一切一键扫描工具的价值所在。先懂原理再动手二维码到底在什么地方藏信息要修复一个损坏的二维码首先得知道哪些模块碰不得哪些模块可以赌。标准二维码ISO/IEC 18004由三类区域构成功能图形固定不可改三个角的定位标记、时序线、以及版本 ≥2 时的校正图形它们是解码器找方向的锚点必须手工重建完整。格式信息15 位记录纠错等级与掩码模式分布在定位标记附近。它只占很少模块却是解码的钥匙。数据与纠错码区域真正承载内容的主体按蛇形顺序填充末尾追加里德-所罗门纠错码字。上图来自项目帮助文档可以看到功能图形与数据区如何交错排布修复时需优先保证功能图形完整。修复者必须掌握两条底层规则规则一格式信息只有 32 种可能。格式信息由纠错等级4 种 掩码模式8 种编码而成外面再套一层 BCH 纠错。这意味着即使格式信息区域完全损毁也只需穷举 32 种组合逐一尝试总有一组能对上——这就是后续暴力破解工具的数学基础。规则二里德-所罗门纠错分错误和擦除两种模式。错误指位置未知的坏数据擦除指位置已知的坏数据。当你能标出损坏模块的具体坐标时纠错能力直接翻倍纠错等级未知位置可恢复比例错误纠正已知位置可恢复比例擦除纠正Level L约 7%约 14%Level M约 15%约 30%Level Q约 25%约 50%Level H约 30%约 60%用公式表达就是2 × 错误数 擦除数 ≤ 纠错码字数。这就是 QRazyBox 的核心策略修复过程中凡是你确认损坏的模块都标记为擦除把宝贵的纠错预算全部用在未知错误上。对应源码可参考 js/reedsolomon.js 与 js/qr.js。快速上手10 秒启动一个本地二维码修复环境QRazyBox 无需构建、无需包管理器克隆后直接打开即可git clone https://gitcode.com/gh_mirrors/qr/qrazybox然后用浏览器打开项目根目录的index.html等待加载动画结束即进入主界面。全部计算都在本地浏览器完成断网也能用。编辑器主界面左侧工具箱切换画笔/橡皮擦/填充中间画布负责逐模块绘制右侧历史面板支持任意撤销与重做。建议先走一遍新手三连来熟悉手感点击顶部菜单New新建项目通过 /- 按钮把版本调到目标值如版本 1 对应 21×21。用画笔工具黑/白/橡皮擦在画布上自由绘制感受模块粒度的编辑方式。画完后点击Decode触发解码观察灰色模块提示——灰色代表解码器认为这些模块可能有误是后续修复的重要线索。功能模块地图一个工具集五类武器QRazyBox 的能力以主编辑器 子工具的形式组织全部入口在顶部Tools菜单中功能作用项目位置像素级画笔逐模块绘制/擦除/填充重建损坏图形js/main.jsExtract QR Information强行解析二维码输出版本、纠错等级、掩码、缺失字节数与可读消息help/extension-tools/extract-qr-information.htmlBrute-force Format Info穷举 32 种格式信息组合自动匹配正确的纠错等级与掩码help/extension-tools/brute-force-format-info-pattern.htmlReed-Solomon Decoder执行错误纠正、擦除纠正及混合纠正help/extension-tools/reed-solomon-decoder.htmlPadding Bits Recovery利用终止符0000与填充字节11101100/00010001 交替的固定规律自动补位help/extension-tools/padding-bits-recovery.htmlData Masking对数据区执行 8 种掩码模式的 XOR 运算用于人工分析help/extension-tools/data-masking.html此外还有项目导入导出支持图片与文本、.qbb项目保存/加载、以及基于历史记录的撤销重做详见 help/getting-started/ 下的入门文档。实战案例修复一张缺失 39 字节的版本 3 二维码下面用项目自带的基础示例sample/basic-example.png完整走一遍问题→步骤→验证的修复链路这也是所有修复任务的通用套路。问题描述目标二维码丢失了大量模块连定位标记和校正图形都不完整普通扫描器直接拒绝识别。第一步手工重建功能图形。由于定位标记缺失无法直接导入图片自动对齐需要先用画笔按版本 3 的规格手工画出三个定位标记、时序线与校正图形具体尺寸可参考 help/getting-started/about-qr-code.html。第二步确定格式信息。仅右上角残留少量格式信息模块此时打开Brute-force Format Info工具并解码。工具在 32 种组合中命中ECC Level M Mask Pattern 1至此解码钥匙到手。第三步量化损伤。运行Extract QR Information它不会像普通解码器那样中途报错而是继续解析并输出关键诊断数据诊断结果给出关键数字当前缺失 39 字节。而版本 3、Level M 的二维码最多只能靠擦除纠正恢复约 26 个码字缺口明显超标。第四步用填充位恢复白赚字节。数据位串末尾的终止符与填充字节有固定模式0000 与 11101100/00010001 交替出现Padding Bits Recovery能自动识别并补全这部分缺失模块绿色模块即工具自动补全的填充位本次操作直接让缺失字节从 39 降到 25落入可纠正范围。第五步擦除纠正收尾。再次运行 Extract QR Information 确认缺失字节数已降至 25≤26 上限后打开Reed-Solomon Decoder执行擦除纠正——因为我们清楚知道缺失位置纠错预算翻倍使用。验证结果解码器成功输出完整原文YOU CAN DO ANYTHING BUT NOT EVERYTHING。整条链路证明了核心方法论先把硬伤功能图形补好再赌格式信息32 选 1然后用规则化补位填充位降低缺失量最后把纠错预算全部交给擦除纠正。完整分步截图可对照 help/examples/basic-example.html。修复效率调优参数与工作流建议工具默认参数偏向通用实际项目中按以下建议调整可获得更高修复成功率与更顺手的操作体验调优项推荐值说明模块大小Module Size10~15 像素兼顾编辑精度与整体视野模块过小易误触解码前标记擦除尽量多标记把确认损坏的模块设为灰色/擦除纠错能力翻倍修复顺序功能图形 → 格式信息 → 填充位 → 纠错优先级由不可替代性决定切勿先修数据区历史记录使用每步关键操作后检查用 History 面板回退失败尝试避免推倒重来项目保存每完成一个阶段保存.qbb不同阶段的备份可对比策略差异多次解码每次补位后立即验证缺失字节数是硬指标随时用 Extract 量化进度应用场景与拓展方向QRazyBox 的适用面远超修一张旧照片档案数字化抢救历史文档、旧包装上的老化二维码重建因纸张泛黄而模糊的标识码。CTF 与安全研究项目自带的qr-v7-damaged.png、sample-rs.png等样本本身就是逆向与隐写题的经典素材配合 help/misc/qr-code-samples.html 可搭建练习题库。质量分析生产线上的二维码打印不良率分析判断是墨水扩散还是模块变形。技术教学把解码失败变成可观测的中间过程是讲解里德-所罗门纠错与数据掩码的绝佳教具。拓展方向上核心算法js/reedsolomon.js、js/qr.js均为模块化 JS 实现可封装为 Web API 或批处理流水线引入机器学习做自动识别损坏区域并推荐修复策略是明显的演进方向届时擦除标记甚至可以全自动生成。学习资源与进阶路径帮助文档help/index.html 是全站索引按入门 → 编辑器 → 扩展工具 → 示例分层组织建议顺序阅读 help/getting-started/ 与 help/extension-tools/。完整案例help/examples/basic-example.html基础版与 help/examples/advanced-example.html进阶版覆盖从轻损到重度损坏的全过程。示例样本sample/ 目录内置多个练习文件basic-example.png适合入门qr-v7-damaged.png适合挑战版本 7 的修复。源码研读顺序先读 js/qr.js 理解编码布局与掩码再读 js/reedsolomon.js 掌握 GF(256) 域运算与伴随式计算最后对照 js/main.js 看界面与算法的衔接。快捷键参考help/misc/shortcut-keys.html 收录了空格切换工具、CtrlZ 撤销等高频操作。常见问题答疑FAQQ1二维码损坏到连版本都看不清还能修吗能但需要先试。新建项目后逐版本对照尺寸特征如定位标记间距判断版本号再用 Extract QR Information 验证版本信息缺失时也可借助格式信息暴力破解顺带锁定版本。Q2Extract QR Information 和普通 Decode 有什么区别普通解码器遇到第一个错误就停止Extract 会忽略错误继续解析输出缺失字节数、RS 块划分和尽力而为的可读消息。它永远是修复工作的第一站。Q3为什么优先用 Padding Bits Recovery 而不是手动画填充位遵循固定交替模式工具能一次补全成片缺失且零误差手工逐格绘制既慢又容易引入新错误。只有当填充位区域本身也被破坏时才考虑手工。Q4擦除标记标错了会怎样把好模块误标为擦除等于人为制造错误会白白消耗纠错预算。所以标记应保守——只有确认损坏的模块才标擦除拿不准的留给错误纠正。Q5修复结果能导出吗可以。既能以图片形式导出成品二维码也能保存.qbb项目文件保留全部编辑状态方便日后继续调整。下一步行动清单克隆仓库并用浏览器打开index.html花 10 分钟熟悉画笔与版本切换。用 sample/basic-example.png 完整跑一遍上文的五步流程重点体会缺失字节数这个关键指标的变化。对照 help/extension-tools/extract-qr-information.html 学会读懂诊断输出。挑战 sample/qr-v7-damaged.png练习版本信息缺失场景下的版本判定。通读 js/reedsolomon.js 源码理解2 × 错误数 擦除数 ≤ 码字数这条不等式在代码里的实现位置。当你能独立把一张缺失三成模块的二维码修复到可扫描你就真正掌握了二维码容错机制的底层逻辑——而这个过程QRazyBox 已经把门槛降到了会画图就会修。【免费下载链接】qrazyboxQR Code Analysis and Recovery Toolkit项目地址: https://gitcode.com/gh_mirrors/qr/qrazybox创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考