中国红码 · 专用安全识读插件

下载安装即可扫码红码 | 可嵌入扫码枪等硬件

🔴 中国红码 · 专用安全识读插件

用微信、支付宝扫红码时,自动引导安装本插件。安装后即可在本机安全识读红码、核验密钥 HK-xxxx,数据不出本机、不上链。支持扫码枪即插即用,可嵌入收银台、闸机、查验终端等硬件。

⬇ 下载插件(Windows)
v1.1.0 | 约 40KB | 需已安装 Node.js LTS | 无需管理员权限

✨ 为什么需要专用插件

🔐
密钥验真

码元+原文 → 密钥 HK-xxxx,改任一字符密钥即变;指纹 SM3 摘要,离线可二次核验。

🛡️
本地安全

解码、验真全部在本机完成:数据不出本机、不采集位置/身份、载荷不上链。

📟
扫码枪/硬件

键盘楔入扫码枪即插即用;串口枪一键转发;可嵌入收银、闸机、查验终端。

📷
红码本体识别

拍照/选图 → 本地解码,支持破损局部识别,无需服务器。

🚀
微信/支付宝联动

扫红码旁标准二维码 → 自动检测插件 → 未安装即提示下载,形成推广闭环。

🔌
即装即用

一键安装:注册 hongma:// 协议、开机自启、桌面快捷方式,装完即可扫码。

📥 安装步骤(Windows,3 步)

1
下载并解压

点击上方「下载插件」,解压到任意目录(如桌面)。

2
运行 install.bat

双击 install.bat,等待「安装完成」提示。首次使用需先安装 Node.js LTS

3
开始识读

自动打开识读页 http://127.0.0.1:18310/capture。拍照识别红码本体,或让扫码枪扫标准二维码即扫即用。桌面快捷方式「中国红码识读插件」随时可开。

手机用户提示:本插件为 Windows 电脑端程序,手机无法安装运行。手机上请直接使用「拍照识别」(识读页已有此能力);需要安装插件请在电脑上打开本页下载。

📦 独立安装包(智能体 / 多系统终端)

面向智能体与多系统终端部署的独立安装包:免装 Node.js 的单文件可执行程序,覆盖 Windows / macOS / Linux(x64 与 arm64),内置本地识读与密钥验真服务,提供 HTTP API 供智能体调用。

💻
Windows

x64:hongma-reader-win-x64.exe(92MB)| arm64:hongma-reader-win-arm64.exe(82MB)
识读引擎 v1.1.0

🍎
macOS

x64:hongma-reader-macos-x64(68MB)| arm64(Apple Silicon):hongma-reader-macos-arm64(121MB)
识读引擎 v1.1.0

🐧
Linux

x64:hongma-reader-linux-x64(74MB)| arm64:hongma-reader-linux-arm64(123MB)
识读引擎 v1.1.0

🤖
Android 安卓

hongma-reader.apk(独立识读终端 APP,离线可用,当前 v)| 也可用网页版 移动识读终端(v

🍏
苹果 iPhone / iPad

打开 移动识读终端网页版(v)→ Safari 分享 →「添加到主屏幕」,图标如原生 APP,支持离线识读

🚀
华为 / 鸿蒙

打开 移动识读终端网页版(v,鸿蒙全系可用,含鸿蒙 NEXT);鸿蒙 4 及以下也可下载 安卓 APK(v

智能体接入:安装包内置本地服务 http://127.0.0.1:18310,提供 /ping/api/scanner/push/api/decode/matrix 等 HTTP API,数据不出本机、不上链。API 文档见 installers/desktop/README.md

📟 扫码枪 / 硬件接入

① 键盘楔入式(USB/蓝牙键盘模式)—— 即插即用

扫码枪默认按「键盘输入+回车」输出,无需驱动。打开插件识读页,扫码枪对准红码旁的标准二维码扫一下即自动识别验真。

② 串口式(USB转串口 / RS232)

设备管理器确认 COM 口号后运行:powershell -ExecutionPolicy Bypass -File scanner-serial.ps1 -Port COM3 -Baud 9600,扫码数据实时转发到插件本地服务并显示码元/密钥。

③ 硬件嵌入式(闸机 / 收银 / 查验终端)

插件本地服务提供纯 JSON API(POST /api/scanner/pushPOST /api/decode/matrix),任意语言可调用;识读页支持 iframe 嵌入终端软件。

📱 微信 / 支付宝扫码联动(推广闭环)

用微信、支付宝扫中国红码旁的标准二维码 → 进入识读页 → 页面自动检测本机是否安装插件:

未安装

页面顶部显示「下载安装专用安全识读插件」引导条 → 点击跳转本下载页。

已安装

显示「已检测到专用识读插件 vX」→ 一键唤起插件本地识读,密钥验真即时完成。

安全承诺:异常/未安装提示一律灰白+文字,红色永远只代表正品品牌语义;插件本地验真不采集、不上链。

❓ 常见问题

Q:手机上解压/打开下载的文件提示「解压文件错误」怎么办?

A:本插件为 Windows 电脑端程序,手机无法安装使用,请勿在手机上下载。手机上请直接使用「拍照识别」查验红码(识读页已有此能力);如确认需要在电脑上安装,请在电脑浏览器打开本页下载。若电脑上解压报错,请用右键「全部解压缩」或用 7-Zip/WinRAR 解压。

Q:为什么微信/支付宝扫不了红码本体?

A:中国红码是自研码制,通用 App 无法识别。红码旁均印制标准二维码用于引导,安装本插件后即可识读红码本体。

Q:需要联网吗?

A:识读与验真全部本地完成,离线可用;仅在扫码落地页(标准二维码)需要联网跳转。

Q:会采集我的信息吗?

A:不会。载荷最小化、默认不采集位置/身份、不上链,符合个保法/数安法要求。

Q:如何卸载?

A:运行插件目录内 uninstall.bat,一键移除协议注册、自启、快捷方式与文件。