北杭Touch

北杭Touch / Getting started

第一次使用，也很从容。

安装 App，连接设备，再开启需要的功能。
本指南对应 Mac 0.8.44、Windows 0.8.36、Linux 0.1.0-test10 与 P8 固件 0.3.21。

01 / 安装 App

从下载中心选择你的电脑系统。

  1. Mac 0.8.44 / build 52：解压 ZIP，运行 ZIP 内的「北杭Touch-0.8.44-安装或更新.pkg」，自行完成 macOS 管理员验证。安装器包含 App 和配套组件，可按需选择系统设置、Chrome 指纹功能或「恢复上次安装」。未勾选的可选功能保留原设置。
  2. 安装完成后，从「应用程序」打开北杭Touch。已有配对、指纹、钥匙串条目和锁屏设置保留，无需重新配对；按提示确认辅助功能、钥匙串等权限。若安装器要求注销或重启，请先保存工作。
  3. Windows 0.8.36：解压后保留完整文件夹，运行 BeihangKey.exe，不要只移动 exe 文件。便携包自带运行时，适用于 Windows 10 build 19041 及以上的 x64 系统。
  4. Linux 0.1.0-test10：面向 Ubuntu 24.04 LTS / GNOME / amd64，提供自带运行时的 .deb。安装、可选授权与 Chrome 扩展请按Linux 测试版指南操作。
Mac App 使用开发签名，安装包尚未签名与 Apple 公证；Windows 包尚未进行发布者签名。确认下载来源及 SHA-256 一致后，若 Mac 仅提示「无法验证开发者」或「Apple 无法检查是否包含恶意软件」，可先尝试打开，再到「系统设置 → 隐私与安全性」对该 App 选择「仍要打开」。不要关闭全局安全保护；若提示损坏或包含恶意软件，请停止打开并反馈。

02 / 连接与实物配对

  1. 让设备保持供电、外壳合上，开启电脑蓝牙。USB-C 用于充电，App 通过蓝牙通信。
  2. Mac：在「概览」中找到设备并连接，按「连接与配对」引导完成设备身份认证。首次配对按 App 提示长按 SW1 约 3 秒并松开，再完成配对。
  3. Windows：在 App「概览」搜索并连接设备。发现 BHKEY 服务、弹出提示后，再长按 SW1 约 3 秒并松开；指示灯闪烁时点「已闪灯，继续配对」，完成 Windows 系统配对，再按 App 引导完成设备绑定。

同一台设备，连接两台 Mac

  1. 两台 Mac 更新到当前 App，设备使用 P8 固件 0.3.21。第一台保持连接与身份已验证。
  2. 第一台进入「电脑绑定与恢复」，点「添加第二台电脑」，完成一次已录入指纹验证；出现按键提示后，先松开 SW1，再按住约 3 秒并松开。
  3. 在 60 秒邀请倒计时内，用第二台连接设备，按提示选择空闲电脑槽并建立配对。第一台保持连接。
  4. 两台分别确认身份已验证，并在各自的「解锁与授权」配置锁屏。第二台不会继承第一台的电脑权限或登录密码。

最多同时连接两台已授权电脑，一次指纹操作只处理一个请求；另一台提示忙后重试。日常重连直接使用已有配对，不用再次添加电脑或按 SW1。固件 0.3.12 及更早版本一次只连接一台。

03 / 录入并验证指纹

  1. 在「指纹」页选择「添加指纹」或「录入第一个空槽」。
  2. 用同一根手指按提示完成六次采集；提示移开时完全抬起，再重新触碰。
  3. 等待保存完成，刷新列表，确认新指纹已出现。
  4. 点击「验证一次」，触碰后查看结果。基础验证成功后，再开启截图或解锁功能。

04 / 检查 App 与固件更新

  1. Mac 打开「设置 → App 与固件更新」，Windows 打开「设置 → App 与固件更新」，点击「检查更新」。
  2. 分别查看 App 和设备固件版本。设备未连接或版本尚未读取时，固件显示待确认。
  3. 在官网下载对应文件。Mac 更新仍运行统一安装器；固件在 App「固件升级」选择 .bhfw，完成签名检查、指纹和按键确认，保持稳定供电。

Mac 与 Windows 的检查更新只读取公开版本清单，不自动下载安装或刷写。App 与固件分别更新，只安装新版 App 不会更新设备固件。Linux 当前尚未接入在线检查更新或设备 OTA，请从Linux 下载区手动获取安装包。

Mac 0.8.44 会保留升级前验证失败的具体原因。失败时先按提示处理，再重新连接发起新的验证，不需要为提示问题删除配对。

固件升级前先核对 P8 / CH592F 与兼容 BOOT。.bhfw 要求匹配开发公钥及兼容启动器，不用于首次线刷。健康确认后受反回滚限制，不能通过 OTA 降级到旧版；有线回退需匹配的完整镜像与保留设备数据的操作方案。保留旧文件不等于可以直接无线降级。

Mac 解锁与 Chrome 指纹

在「设置 → 解锁与授权」分别管理锁屏、系统授权和 Chrome。锁屏需要你主动保存本机登录密码，并完成辅助功能与钥匙串授权；系统授权需要安装器中已启用对应组件，同时开启「接收本机系统授权请求」。

设置 Chrome

  1. 进入「Chrome 指纹」，按分步助手继续。打开 Chrome 密码管理器，手动点开一个已有条目；出现系统验证框后取消，不必输入密码。
  2. 回到助手点「读取授权入口一次」。它只读取固定授权入口，不读取网页、密码、窗口文字、截图或日志，也不自动轮询。
  3. 点「继续到安装与功能管理…」，在统一安装器选择 Chrome 功能并完成管理员验证。仅缺少支持的入口时，Chrome 可保持待启用，其他已选功能继续配置。
  4. 按提示重新打开 App；需要时注销或重启。确认系统请求接收已开启，再点「重新检查安装记录」，最后在 Chrome 实际验证一次。

Chrome 使用原生 Touch ID / LocalAuthentication 时，本功能不能替代该通道。合盖不保证改变路径，开盖后也可能恢复原生验证；请保留原密码或 Touch ID 回退，不把安装记录当成指纹验证成功。

需要恢复时，在统一安装器选择「恢复上次安装」。不要手动覆盖固定 App，或通过删除配对来修复组件问题。

Linux 0.1.0-test10 测试版

目标系统为 Ubuntu 24.04 LTS、GNOME 桌面及 Intel / AMD 64 位（amd64）。已有验证来自 UTM 中的 Ubuntu 24.04.5、GNOME 46.2、Wayland 环境；Linux 真机、其他发行版或桌面及 ARM64 尚未验收。

安装与首次连接

  1. 从Linux 下载区下载 .deb，用 sha256sum 文件路径 比对页面摘要。在安装包所在目录运行 sudo apt install ./beihang-touch_0.1.0-test10_amd64.deb，由 Ubuntu 软件源安装依赖；包内已含 .NET 运行时，无需安装开发 SDK。
  2. 从应用列表打开「北杭Touch」。安装会启用设备管理服务；全新安装的锁屏、系统授权与 sudo 入口均默认关闭，升级保留此前主动启用的配置。
  3. 在「设备 → 连接与配对」搜索 BHKEY 设备。空白测试板选择空闲电脑槽，按提示长按 SW1 约 3 秒并松开，再建立配对和身份认证；已有本机配对直接重连。
  4. 录入同一根手指的六次采集，再完成一次新验证。真机属于新的电脑身份；旧虚拟机占用的设备槽不会随删除虚拟机自动清除，请使用空闲槽或已有配对恢复流程，不要复制虚拟机密钥。

按需开启锁屏、系统授权与 sudo

进入「设置 → 解锁与授权」，分别启用需要的入口。每项启用需要系统管理员授权和新的设备指纹，之后每次授权也需要新指纹。「恢复原配置」会恢复并停用对应入口，不会顺便启用其他功能。

GNOME 锁屏只覆盖已有本地会话；重启首次登录和磁盘解密仍使用原方式。图形系统授权（polkit）与交互式 sudo 仅面向当前活动、已解锁的本地图形会话同一账户，不覆盖 SSH、其他账户或非交互 sudo。

实现保留原密码认证回退，sudo / polkit 的密码回退与三个入口完整启用、停用、恢复循环仍待真机验收。先逐项测试并确认原密码可用；一次普通指纹验证不能代替某个系统授权窗口的验收。

Chrome 独立账号填充

安装包集成 Chrome 扩展 0.1.1 及本机通信组件。安装后完全退出并重开官方 Google Chrome stable，在 chrome://extensions 检查「北杭Touch」已启用；浏览器可能要求确认外部扩展来源。本包尚未上架 Chrome Web Store，不保证所有管理策略下自动启用，也不会自动安装 Chrome。

  1. 先在 App 连接并认证设备，保持 Linux 会话解锁。使用假账号，在所需 HTTPS 登录页面打开扩展并创建本机账号库。
  2. 按扩展提示，用新的指纹保存账号；关闭重开后检查条目，再用一次新指纹填充。仅支持顶层页面可见且唯一的一组登录输入框，不覆盖 iframe、多密码框或注册表单。
  3. 填充后由你决定是否提交网站登录。扩展不会自动提交；填入网页的账号密码可被该网页读取。

这是独立的本机加密账号库，不读取 Chrome 内置密码管理器，也不经 Chrome 同步或剪贴板。假账号保存、重开后的持久性与指纹填充已有虚拟机实测；恢复码交付、加密备份、恢复及取消完整流程尚待验收。

桌面工具与当前限制

支持指纹备注、手动截图、诊断导出与可选登录自启。自启默认关闭，开启后只启动 App 界面，不自动连接或授权。供电显示仅为既有电压快照，不代表准确电量或充电状态。

截图在早期 test5 曾完成保存和查看；2026 年 10 月 19 日的 test10 录屏中，GNOME 已生成文件，但 App 提示未完成且「查看最新截图」不可用，此状态与导入异常尚未修复。蓝牙普通重连仍有间歇失败，真机与长期运行稳定性待验证。

当前未接入设备 OTA、在线更新、触摸唤醒、三次触摸截图、TOTP / API 工具、自动重连或多用户快速切换。Linux 已有设备实测使用固件 0.3.8，不代表当前其他固件组合均已验收。查看 Linux 版本记录 ↗

所有电脑断开后的设备休眠

P8 0.3.21 在最后一条实际蓝牙连接断开满 5 分钟后，等待当前任务结束，停止广播并进入保留 RAM 的低功耗休眠。另一台电脑仍连接时不触发。仅退出 App 时，操作系统可能保留 HID 连接，因此并不一定开始计时。

轻触并完全移开，或短按 SW1，即可恢复广播与新的 5 分钟连接窗口。电脑开启自动连接后可重连，也可以手动点击连接；重新认证后，解锁可能需要再触摸一次。无需删除配对或恢复出厂。

该功能唤醒的是北杭Touch设备，不能启动已关机的电脑。仍保留每 5 秒电压检测与估算充电；不是完全断电，实际待机电流及续航收益未独立测量。当前发布包沿用测试板配置，未启用开壳检测。

Mac 查看电量与充电状态

在「设置 → 帮助与诊断」的设备信息中点击「刷新电量」。前台查看时，每约 2 秒尝试读取一次，最多持续 24 秒；离开页面、隐藏窗口、锁屏或断开后停止快查。设备忙时优先处理指纹或升级，稍后可再刷新。

电量百分比按电压平滑估算；固件 0.3.21 独立观察充电电压变化，持续有效读数支持时保留红灯，确认回落后退出，其他操作灯效优先。

充电状态是估算：负载回弹可能误判，插着 USB 不一定显示充电，也不能准确判断充满。明显升压后 5–10 秒是合成输入下的响应目标，实际速度取决于设备状态；实际充电时序、功耗与长期稳定性未作独立量化。

功能与适用范围

  • 截图：Mac 需 macOS 14+ 与屏幕录制权限；可从 App 或状态栏截图。三次触摸需固件 0.3.7+ 并主动开启，图片保存到本机「下载」文件夹。
  • 系统集成：不等同于 Apple Touch ID 或 Windows Hello，不支持 FileVault 开机前解锁或 Apple Pay，也不保证适配所有授权窗口。
  • 受保护存储：指纹模板保存在设备中，Mac / Windows 的验证码与 API 密钥采用本机受保护存储。Mac 开发签名下的真实密钥存储与备份恢复仍需正式签名授权验收。查看隐私说明 ↗

还没有设备时，可先看首页演示配图熟悉界面；配图使用模拟数据，功能位置以实际 App 为准。版本改动与验证详情 ↗

常见问题

Mac 锁屏可以，系统设置或 Chrome 没有指纹弹窗？

这些功能使用不同通道。先在「设置 → 解锁与授权」查看对应状态；如果组件未启用，打开「安装与功能管理」完成配置，再确认系统请求接收开关与权限。Chrome 原生 Touch ID 通道仍使用原生验证。反复切换辅助功能或删除设备配对不能代替组件配置。

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

检查设备电量、电脑蓝牙和 App 蓝牙权限，靠近设备再搜索。已有配对直接重连；第二台按上方邀请流程添加。Windows 首次配对先在 App 连接，出现提示后再操作 SW1，不要搜索前提前打开配对窗口。详细状态可在「帮助与诊断」查看。

Mac mini 或 Intel Mac 可以使用吗？

Universal 包面向 macOS 13 及以上的 Apple Silicon 与 Intel Mac，包括具备可用蓝牙的 Mac mini；实体 Intel Mac 的完整设备验收仍待完成。Windows 版面向 x64，Windows 11 的完整实机验证仍待完成。

如何核对文件是否完整？

下载页提供 SHA-256。Mac 可运行 shasum -a 256 文件路径，Windows PowerShell 可运行 Get-FileHash 文件路径 -Algorithm SHA256，Linux 可运行 sha256sum 文件路径 后比对。

返回下载中心