北杭Touch

北杭Touch / Getting started

第一次使用，也很从容。

从安装 App，到完成第一次指纹验证。
以下步骤对应 v0.8.1 开发预览版。

01 / 安装 App

在下载页选择与你的电脑匹配的安装包，并先阅读版本限制。

  • Mac：解压 ZIP，打开 北杭Touch.app。需要 macOS 13 或更新系统。
  • Windows：解压 ZIP，保留整个 Windows-x64 文件夹，运行 BeihangKey.exe，不要只移动 exe 文件。
当前 Mac 包尚未公证，Windows 包尚未进行发布者签名。如果系统阻止打开，请先核对文件来源、SHA-256 与系统提示。不要关闭系统安全保护。

02 / 连接与实物配对

  1. 确认设备已供电，并开启电脑蓝牙。
  2. Mac 进入「开始使用与诊断」，点击「搜索北杭Touch」并连接。Windows 进入「首次使用与诊断」，点击「扫描」，选择设备后「连接所选设备」。
  3. 合上外壳，长按设备按键至少 3 秒后松开。在随后 60 秒的配对窗口内，按界面提示完成系统蓝牙配对与「建立配对」／「实物配对」。
  4. Windows 按界面提示继续「建立安全会话」。连接、配对和安全会话完成后再进行指纹操作。

设备的 USB-C 用于充电，App 通过蓝牙与设备通信。上述流程仍待真实硬件联调验收。

03 / 录入并验证指纹

  1. 在 App 中选择「录入指纹」或「录入第一个空槽」。
  2. 按照提示完成六次采集；需要移开手指时先抬起，再重新触碰。
  3. 刷新指纹列表，确认刚录入的指纹已出现。
  4. 点击「开始新的指纹验证」或「验证一次指纹」，触碰传感器后查看结果。

先确认基础连接与指纹验证正常，再查看验证码、自动填入等功能的当前支持范围。Mac 的辅助功能权限仅在定向填入或可选锁屏集成时需要。

还没有设备？先体验演示。

Mac 打开安装包内的「打开演示.command」，Windows 打开「演示模式.cmd」。演示使用公开模拟数据，可用于熟悉界面和流程。

演示中的连接、指纹或验证码结果不代表实际硬件验收。当前 Mac 开发包的真实验证码 / API 密钥存储与备份恢复，还需正式签名授权后验收。

常见问题

找不到设备，或连接失败？

检查设备电量、电脑蓝牙和 App 的蓝牙权限，靠近设备后重新扫描。需要重新配对时，请按上方流程打开 60 秒实物配对窗口。仍失败可在「开始使用与诊断」或「首次使用与诊断」中查看连接状态。

Mac mini 可以使用吗？

Mac 版构建面向 macOS 13 及以上的 Apple Silicon 与 Intel Mac，包括满足系统要求、蓝牙可用的 Mac mini。当前 Intel Mac 与真实设备的完整实机验证尚未完成。

可以替代 Touch ID 或 Windows Hello 吗？

当前版本不作为系统原生 Touch ID 或 Windows Hello 的替代品。系统认证集成默认关闭；Mac 不支持开机 / FileVault 解锁，Windows 仅针对本地控制台的本地密码账户，不包含 Microsoft / 域账户、RDP 或 UAC。

验证码和指纹数据保存在哪里？

指纹模板保存在设备中；验证码种子与 API 密钥采用电脑上的受保护存储，二维码在本机识别。Mac 当前开发包的真实存储功能受正式签名授权限制。详见隐私说明。

如何检查下载文件是否完整？

下载页的每个安装包都附有 SHA-256 校验值。Mac 可用 shasum -a 256 文件路径，Windows PowerShell 可用 Get-FileHash 文件路径 -Algorithm SHA256 计算并比对。

返回下载页