QRazyBox 二维码分析与恢复工具使用教程

QRazyBox 是一个基于网页的二维码分析与恢复工具包，专门用于分析和恢复受损的二维码。它提供了类似画图工具的编辑器，让你可以通过像素级绘制来重建和修复二维码，同时还提供了多个辅助工具来提高分析效率。

项目概述

QRazyBox 是一个功能强大的二维码处理工具，主要特点包括：

• 通过逐像素绘制重建二维码
• 解码和读取无法扫描的二维码
• 保存和加载工作进度
• 支持从图像文件或文本文件导入/导出二维码
• 支持最高版本40（177x177）的二维码
• 使用通用 Reed-Solomon 解码器支持错误和擦除纠正
• 即使从严重损坏的二维码中提取有价值信息
• 模拟数据掩码以进行手动数据分析

项目结构

QRazyBox 项目的目录结构如下：

qrazybox/
├── css/
│   └── style.css
├── font/
│   ├── DroidSans-Bold.ttf
│   ├── DroidSans.ttf
│   ├── FredokaOne-Regular.ttf
│   └── LICENSE.txt
├── help/
│   ├── editor-painter/
│   ├── examples/
│   ├── extension-tools/
│   ├── getting-started/
│   ├── img/
│   ├── introduction/
│   ├── js/
│   ├── misc/
│   └── search.html
├── img/
│   ├── bars.png
│   ├── eraser-tool.png
│   ├── fill-tool.png
│   ├── icon.png
│   ├── minus.png
│   ├── overview.png
│   ├── pixel-black.png
│   ├── pixel-white.png
│   ├── plus.png
│   ├── preloader.gif
│   ├── search.png
│   └── toggle-tool.png
├── index.html
├── js/
│   ├── external/
│   │   ├── jsqr.js
│   │   └── jsqrcode/
│   ├── jquery-migrate.min.js
│   ├── jquery.min.js
│   ├── main.js
│   ├── modernizr-custom.js
│   ├── qr.js
│   ├── reedsolomon.js
│   ├── sqrd.js
│   └── table.js
├── LICENSE
├── README.md
└── sample/
    ├── 10148070824_31b8ab3f30.jpg
    ├── 4838077267_e5a85965df_b.jpg
    ├── 6758457307_7f180aabec_z.png
    └── 其他样本文件...

启动和使用方法

QRazyBox 的启动文件是 index.html，这是一个完整的网页应用，不需要额外的服务器配置。只需在浏览器中打开该文件即可开始使用。

基本操作流程

1. 新建项目：点击界面上的"New"按钮，可以选择创建空白二维码或从图像/文本导入
2. 绘制编辑：使用左侧工具栏的绘图工具修复二维码
3. 版本调整：通过加减按钮调整二维码版本
4. 模块大小：调整二维码模块的显示大小
5. 解码测试：点击"Decode"按钮尝试解码修复后的二维码

核心功能工具

QRazyBox 提供了多个专业工具：

1. 提取二维码信息

强制解码并尽可能多地获取当前二维码的信息，包括错误纠正日志和解码错误信息。

2. Reed-Solomon 解码器

通过解码 Reed-Solomon 块进行错误和擦除纠正，这是二维码纠错的核心算法。

3. 格式信息模式暴力破解

当格式信息损坏时，尝试所有可能的格式信息模式组合进行解码。

4. 数据掩码

模拟数据掩码（XOR）操作，使用掩码模式对数据进行处理。

5. 填充位恢复

通过放置终止符和填充位来恢复缺失的位。

6. 数据序列分析

分析二维码的数据序列结构（实验性功能）。

技术特点

QRazyBox 基于以下技术构建：

• 使用 jQuery 进行 DOM 操作和事件处理
• 集成 jsqrcode 库进行二维码解码
• 实现 Reed-Solomon 纠错算法
• 支持本地存储保存项目进度
• 使用 Canvas 进行图像处理

使用示例

项目中提供了多个样本文件在 sample/ 目录中，可以用来测试工具的功能：

这些样本包含了各种损坏程度的二维码，可以用来练习修复和解码技巧。

浏览器兼容性

QRazyBox 需要现代浏览器支持以下特性：

• Canvas
• 文件输入
• 文件阅读器
• 跨域图像
• JSON
• 本地存储

不支持移动设备浏览器，建议在桌面浏览器中使用。

开发说明

项目采用 MIT 许可证开源，代码结构清晰，主要功能模块在 js/ 目录中：

• main.js - 主应用程序逻辑
• qr.js - 二维码处理核心
• reedsolomon.js - Reed-Solomon 纠错实现
• table.js - 表格渲染功能

如需二次开发或贡献代码，可以克隆项目仓库进行修改。