Android 无法安装或打开
- 确认系统为 Android 6.0 或更高版本，APK 文件名为
zhuomadashi-android-v1.0.0.apk。 - 只为当前浏览器或文件管理器允许“安装未知应用”，不要关闭全局安全检查。
- 无相机画面时，在系统应用权限中允许卓码大师使用相机。
蓝牙 HID 找不到电脑或无法输入
- 确认 Android 版本不低于 9，并已允许附近设备相关蓝牙权限。
- 首次连接必须先点击“让电脑发现本机”，在电脑和手机两端完成系统蓝牙配对。
- 配对完成后，回到卓码大师并点击“已配对设备”中的电脑名称以启用 HID。
- HID 不适合中文等非标准键盘字符；这类内容请改用 Wi-Fi。
Wi-Fi 扫码连接失败
- 手机与 Mac 必须在同一局域网；访客网络或设备隔离会阻止互联。
- 桌面端应显示服务正在运行，默认监听端口为
9876。 - 允许 macOS 防火墙接收卓码大师桌面端的本地网络连接。
- 扫描二维码失败时，可手动输入桌面端显示的 IP 和端口。
识别、历史或导出异常
- 改善光线、保持完整码图案入镜，反光严重时尝试从相册识别清晰原图。
- 导出的是当前搜索结果；清空搜索框后才能导出全部记录。
- 没有可见记录时不会生成空导出文件。
- 历史记录保存在本机，清空或删除后无法在应用内恢复。
反馈问题前请准备
为了让问题可复现，请记录以下信息，并避免在截图中暴露真实扫码数据、局域网地址或个人设备名称：
- 卓码大师版本号，以及 Android / macOS 的系统版本。
- 连接方式：蓝牙 HID 或 Wi-Fi；如果是 Mac，请注明 Apple 或 Intel 芯片。
- 从打开应用到出现问题的完整操作步骤。
- 界面上的原始错误提示；必要时附经过隐私处理的截图。
- 问题是否每次出现，以及重新启动应用后是否仍能复现。
当前公开发布文件位于官方 GitHub 发布仓库。