卓码大师发布包

本仓库用于存放卓码大师的正式发布程序包。卓码大师可将 Android 手机变成扫码枪，识别条形码或二维码后，通过蓝牙 HID 或局域网 Wi-Fi 将内容输入电脑当前光标位置。

系统要求

• Android 6.0 或更高版本。
• 使用蓝牙 HID 连接时，需要 Android 9 或更高版本。
• 使用 Wi-Fi 连接时，手机与电脑必须位于同一局域网，并在电脑上运行卓码大师桌面端。
• 当前桌面端支持 macOS 11 或更高版本的 Apple 芯片和 Intel 芯片 Mac。

安装 Android 版

1. 下载本仓库中的 .apk 安装包。
2. 在 Android 手机上打开安装包。
3. 如果系统阻止安装，请按提示允许当前文件管理器或浏览器“安装未知应用”。
4. 完成安装后打开“卓码大师”，并允许相机权限。

手机已通过 ADB 连接电脑时，也可以在电脑终端执行：

adb install -r <安装包文件名>.apk

安装 macOS 桌面端

1. 根据 Mac 芯片选择 .dmg 安装镜像：Apple 芯片下载 macos-arm64 版本，Intel 芯片下载 macos-x86_64 版本。
2. 将“卓码大师PC端”拖到镜像中的“Applications”快捷入口。
3. 在“应用程序”目录中启动卓码大师PC端。
4. 首次启动时，如果 macOS 阻止打开，请在 Finder 中右键点击应用并选择“打开”；也可以前往“系统设置 > 隐私与安全性”确认打开。
5. 按系统提示授予“辅助功能”权限，以便桌面端将扫码结果输入当前光标位置。
6. 重新启动桌面端，使权限设置生效。

蓝牙 HID 模式

蓝牙 HID 模式会将手机作为蓝牙键盘使用，电脑端无需安装卓码大师。

1. 打开手机端卓码大师，进入蓝牙连接界面。
2. 点击“让电脑发现本机”。
3. 在电脑的蓝牙设置中选择手机，并在手机和电脑两端确认配对。
4. 返回手机端，在“已配对设备”中点击电脑名称以启用 HID。
5. 在电脑上将光标放入需要接收内容的输入框，然后使用手机扫码。

Wi-Fi 模式

1. 安装并打开卓码大师桌面端。
2. 确认手机和电脑已连接到同一局域网。
3. 在桌面端点击“开启服务”，等待连接二维码显示。
4. 使用手机端卓码大师扫描该连接二维码，并确认连接。
5. 在电脑上将光标放入需要接收内容的输入框，然后使用手机扫码。

如果二维码无法显示或识别，可在手机端手动填写桌面端显示的 IP 地址和监听端口。默认端口为 9876。

扫码与记录

• 扫码结果会发送到电脑当前光标所在位置。
• 可在设置中选择是否为扫码内容追加回车或 Tab。
• 手机端和桌面端均可查看扫码历史；记录可导出为 CSV 或 Excel 文件。
• 相机画面在手机本地识别，扫码数据不会经过卓码大师服务器。

常见问题

Wi-Fi 无法连接

• 检查手机和电脑是否处于同一局域网。
• 确认桌面端服务已开启，IP 地址及端口与手机端一致。
• 检查电脑防火墙是否允许卓码大师接收入站连接。
• 访客 Wi-Fi 或启用了客户端隔离的网络可能会阻止设备互相访问。

蓝牙已配对但无法输入

• 确认手机系统为 Android 9 或更高版本。
• 在手机端“已配对设备”列表中再次点击电脑名称，以启用 HID 连接。
• 确认电脑输入光标当前位于可编辑的文本框中。
• 删除两端已有的蓝牙配对记录后重新配对。

Android 安装失败

• 确认安装包下载完整，并允许来源应用安装未知应用。
• 如果已安装签名不同的旧版本，请先备份需要的数据，再卸载旧版本后重新安装。