BB10 VoLTE OCTOLAB
English GitHub

完整使用指南 · v0.3.3-r5

从下载到真实通话验收

依次完成准备、连接、预检、安装和通话测试。“注册通过”不代表通话成功：还要用系统拨号器测试呼入、呼出，并确认双方都能听清。

几个词先说明白：Root 是手机的系统管理员权限；预检就是安装前检查；IMS 注册，就是手机连上了运营商的通话服务。

下载 Windows x64 下载 macOS 通用版

当前公开版本为 v0.3.3-r5。下载后请先核对 SHA-256，也可以在 Release 页面查看同名校验文件。

01 · 开始前

准备与风险

先打开手机“设置 → 关于”，记下型号、硬件变体和完整 OS 版本。只看“Q10”“Classic”或“Passport”名称，不能判断能否安装。

  • 手机与系统：必须是 BlackBerry 10 OS 10.3.3.3216、QNX ARM32，且 4 个原生文件的 SHA-256 必须与公开清单完全一致。系统或文件不符就会停止，不能修改配置来跳过。
  • SIM 与运营商：使用有效 USIM，确认运营商已为套餐开通 VoLTE，且 4G 上网正常。当前 USIM 实现不支持 ISIM。可先把同一张卡放入支持 VoLTE 的手机，确认通话时不会降到 2G / 3G。
  • 连接材料：准备稳定的 USB 数据线。已 Root 手机还需要这台手机自己的 Root SSH、个人登录私钥和可信主机密钥；不要借用他人的共用私钥。
  • 电脑：Windows 包面向 Windows 10 / 11 x64，实际打包与启动验证在 Windows 11 x64 完成；macOS 包为通用安装包。两种应用都不要求普通用户另装 Python。
  • 备份与空间：完整备份手机。仅未 Root 的 Q10 首次准备需要互联网或预先缓存的固定材料，并预留约 15 GB 空间；日常预检与安装不需要重复下载 Root 材料。
  • 使用预期：项目仍是实验版。长通话、长期待机、其他机型与运营商、漫游、切换小区及紧急呼叫尚未得到完整验证，不要把一次成功理解为普遍保证。
目前支持到哪一步
设备 / 组合 当前结论
Q10 SQN100-3 / 10.3.3.3216 / 北京联通 460-01 / USIM 无 ISIM 一台设备已完成真实通话和正常重启测试；安装时仍须通过原生文件哈希、LTE、APN 等全部检查。
其他 Q10 变体、Classic（Q20）及未实测运营商配置 须主动开启实验试用，并通过全部技术检查才能继续。每台都要测试通话，关闭自动启动，改用手动启动。
Passport（Q30） 恢复策略尚未验证，暂不允许自动安装、更新、启动或恢复。可以预检、导出报告；开启试用也不能跳过限制。
首次 Root 刷写会清空手机数据。先备份，并保留匹配机型的原版恢复材料。已 Root 但丢失连接文件时，应恢复连接，不要用重新刷写修复密钥问题。Q20 / Q30 严禁刷入本项目的 Q10 Root 镜像。首次刷写仍是实验功能，尚未在未 Root 的手机上完成实际刷写验证。

02 · 获取与启动

Windows / macOS 启动

Windows

  1. 下载当前版本的 bb10-volte-0.3.3-r5-windows-x64.exe 及 Release 中同名 .exe.sha256。
  2. 先按本页 SHA-256 校验核对文件，再双击 EXE。Python、Tcl/Tk、SSH/SCP、运营商模板和手机端载荷均已内置。
  3. 这是单文件便携版，启动时会解压到系统临时目录，正常退出后清理。启动和日常使用不需要管理员权限；首次安装 USB 驱动时会单独出现 Windows UAC 提示。

签名状态：当前 Windows EXE 未做 Authenticode 签名，系统可能显示“未知发布者”。只从项目 Release 获取文件，并确认完整 SHA-256 一致；校验不符时不要运行。

macOS

  1. 下载当前版本的 bb10-volte-0.3.3-r5-macos-universal.dmg 及同名 .dmg.sha256，先核对 SHA-256。
  2. 打开 DMG，将 bb10-volte.app 拖入“应用程序”，再从“应用程序”启动。无需另装 Python、Tk 或 OpenSSH；应用使用 macOS 自带的 SSH/SCP。
  3. 用 USB 数据线连接并解锁手机，允许 Mac 提示的附件连接。没有 USB 网络时，在手机“设置 → 存储和访问 → USB 连接”中核对“连接至 Mac”。

签名与验证范围：当前 Mac 安装包为通用包，并已签名、公证。“通用”表示包含 Apple Silicon 与 Intel 架构，不表示所有 Mac 或 Intel 机型都已实机验证；Intel 目前只有包内架构核验，没有 Intel 实机结论。

不同 Release 支持的首次 Root 方法可能不同。未 Root 手机必须按下载版本的首次使用文档和实际机型操作。后续源码有新界面，不代表旧安装包也支持。

应用和手机服务准备好后，电脑离线也能使用。首次 Root 或安装驱动时，只有你主动进入并确认，才会下载缺少的材料。手机注册 IMS 和实际通话始终需要运营商网络。

03 · 建立可信连接

连接手机

  1. 先建立 USB 网络。用数据线连接并解锁手机。能充电或看到存储盘不等于 USB 网络已经就绪；拔插后如状态未更新，点击重新检查。不要预先安装旧 BlackBerry Link、随意改 IP 或降低主机密钥校验。
  2. 点击主界面的“连接手机”。应用会查找并实际验证已保存的个人连接；连接配置可以留空。旧 q10-root 与当前 bb10-root 别名均可匹配，自定义配置位于“更多 → 高级连接设置”。
  3. 需要处理时进入“连接帮助”。可选择以前刷机的整个文件夹，让应用识别其中唯一一组登录材料；确认来源后才建立本机配置。私钥应留在受保护的个人目录，不要发送到 Issue 或聊天群。
  4. 核对连接结果。确认型号、硬件变体、OS、Root 和现有服务状态。重新打开应用时只会复查上次成功的手机，不会因此自动安装或刷写。开发模式、SSH、Root 与 IMS 是不同层次；已有有效 Root SSH 时不必一直开启开发模式。

按手机现状选择恢复方式

  • 已 Root，有本人的连接文件：导入自己的 ssh_config，同时确保它引用的登录私钥和可信 known_hosts 存在。Windows 的绝对路径不能原样搬到 Mac，应按应用的恢复连接流程补建。
  • 已 Root，没有旧电脑文件：可通过手机已有的有效 Root 终端为这台电脑独立授权。严格按应用显示的编号和步骤传递公开脚本与结果，并在本人确认后输入 PAIR；这会持久追加手机 SSH 公钥。私钥始终留在电脑。
  • 没有材料，也没有有效 Root 终端：不能直接连接。连接失败本身不代表手机未 Root，先确认 Root 和 SSH 状态，不要通过重刷猜测性修复。
  • 主机指纹不符：核对该手机原有的可信材料。不要关闭严格主机校验，也不要把指纹变化直接当作密钥损坏。

仅确认尚未 Root 的 Q10：Windows 首次准备

  1. 进入“连接手机 / 连接帮助”的首次准备。检测 USB 网络；缺少 Windows 驱动时，由向导获取并校验固定材料，确认后通过 UAC 安装。
  2. 进入“首次 Root”，核对实际变体为 SQN100-1 至 SQN100-5，再次确认备份和约 15 GB 可用空间。
  3. 点击“自动准备 Root 镜像”。应用获取并校验固定工具与 Q10 固件，生成这台手机独立的个人密钥和镜像。准备镜像本身不会刷写手机。
  4. 只有再次确认备份、实际机型并明确同意清空数据后，才进入刷写。出现未知退出、中断或未记录的错误时立即暂停并保留现场，不要盲目重试。
  5. 首次开机后完成必要设置，按原 Root 方法启动（可打开一次 BlackBerry World），再回应用验证有效 UID 0。Root 成功不等于 VoLTE 或通话已经通过。

Q20 / Q30 必须使用各自机型匹配的固件和 Root 方法。当前没有可用 Q10 镜像替代这一要求；Passport 的自动 VoLTE 操作也仍然暂缓。

04 · 先检查，再写入

选择配置、预检与安装

  1. 选择与实际运营商匹配的配置。核对 MCC/MNC、数据及 IMS APN、IP 类型和域名。自定义参数会改变安装条件，修改后必须重新预检。未验收机型或运营商组合还需明确开启实验试用，并关闭自动启动、改为手动启动。
  2. 运行预检并阅读全部待处理项。应用检查机型、OS、Root、ARM32、4 个原生文件哈希、SIM 类型、实际 MCC/MNC、LTE、数据 APN、原厂配置、已有服务和安装前状态。折叠已通过的明细不会减少检查。
  3. 先处理阻止项。SIM、Root、LTE 或数据网络未就绪时，处理后重试；身份冲突、OS 不同、原生哈希不符、ISIM 或需要另行适配的身份格式会禁止安装。不要编辑哈希、伪造报告或把“试用”当成绕过开关。
  4. 更新前先恢复旧服务。已有服务正在运行时，兼容性可能通过，但安装前状态不会通过。先挂断电话，在“更多 → 停用并恢复”完成恢复，再重新预检。

预检会将检查模块和配置请求上传到随机临时目录，只给需要运行的脚本执行权限，结束后清理。预检不会安装服务或改写通话配置。断线可能留下临时目录，重连后先查看状态。

如何理解预检结论
结论 含义
符合当前适配条件 仅表示技术条件匹配，不证明运营商已为此卡开通 IMS，也不证明通话成功。
有条件尚未就绪 处理 SIM、Root、LTE、数据网络或现有服务状态后重新检查。
未实测适配 · 可实验试用 只有已开启试用且全部技术条件通过才允许继续；每台设备仍要独立通话验收。
需要适配 / 关键技术条件未通过 停止安装并导出脱敏报告供适配分析；试用开关不能绕过。

确认后执行固定安装流程

预检通过后，确认已备份、此卡已开通 VoLTE、当前没有通话，再点击“安装并验证”。已有可启动服务时按界面选择“启动并验证”；需要更新时先按上文恢复旧服务。

固定流程依次为：校验固定清单 → 连接与上传 → 电脑端最新预检 → 手机上再次预检 → 写入固定版本 → 回读全部文件 → 启动 → 观察注册。默认注册观察时间为 180 秒。保持连接，不要换卡、拨号或同时运行另一安装工具；首次启动可能短暂重载无线网络。

“IMS 注册通过”不代表通话测试通过。工具不会自动拨号。观察超时只表示“注册待确认”，可稍后查看状态，不会也不应通过反复重装来碰运气。必须继续完成下一节的真实通话清单。

05 · 以实际通话为准

真实通话验收

用 BB10 自带的系统拨号器测试，并准备另一部电话配合。逐项记下结果；有任何一项没通过，就不能认为这台手机已通过通话验收。

  1. 等待 IMS 注册通过。若仍显示待确认，先稍后查看状态，不要立即重复安装。
  2. 完成呼出与呼入。分别从 BB10 呼出、从另一部电话呼入并接听，确认双方都能持续听清对方，而不是只检查电话是否接通。
  3. 确认全程保持 4G。通话开始、进行中和结束后都观察网络状态，不能只在拨号前看到 4G。若通话中回落到 2G / 3G，本项不通过。
  4. 拔掉 USB 后重复测试。挂断电话并断开电脑，再完成呼入、呼出、双向声音和全程 4G 检查，确认服务不依赖电脑持续连接。
  5. 从手机电源菜单正常重启。等待 BB10、Root 和 IMS 依次就绪。看到桌面、4G 或 Root 成功提示后仍要继续等待 IMS 注册，再重复双向通话与 4G 检查。
  6. 保留逐项结果。记录项目版本、手机变体、OS、运营商、是否拔线及是否重启。一次短通话不代表长通话或长期稳定性已验证。
一台北京联通 Q10 在 2026-10-28 的正常重启记录中，从系统启动到 IMS 注册约 3 分 48 秒，其中 BB10 和 Root 启动约 3 分钟，随后 IMS 注册约 45 秒。它只是单机参考，不是每台设备的等待承诺；也不要把 45 秒理解为整机开机时间。

06 · 需要停用或更新时

停用并恢复

  1. 先挂断所有电话，保持手机连接，打开“更多 → 停用并恢复”。
  2. 等待流程完成。它会关闭本项目的自动启动、停止本项目服务，并回读原语音策略和清理状态。
  3. 重新查看状态或预检，确认原策略与安装前基线已经恢复。需要更新时，在恢复完成后重新预检，再使用新版本流程。

恢复只处理本项目管理的配置，不会撤销 Root，也不会恢复整机固件。发现外部修改或配置归属冲突时会停止，不要强行覆盖。Passport（Q30）目前仍不允许自动恢复、安装、更新或启动。

安装或刷写中断时，不要盲目再来一次。重新预检并查看状态，保留 install-transaction.json、不完整目录和刷写现场。不要删除恢复记录、覆盖未知状态或重新刷机；当前版本没有任意中断点的自动修复能力，应联系维护者根据私有记录处理。

07 · 运行之前

SHA-256 校验命令

从同一 Release 下载安装包和同名 .sha256 文件。以下命令假设安装包保存在当前用户的“Downloads / 下载”目录；路径不同时请换成实际完整路径。

Windows PowerShell
Get-FileHash "$HOME\Downloads\bb10-volte-0.3.3-r5-windows-x64.exe" -Algorithm SHA256
macOS 终端
shasum -a 256 "$HOME/Downloads/bb10-volte-0.3.3-r5-macos-universal.dmg"

命令会输出 64 位十六进制摘要，必须与 Release 同名校验文件中的 SHA-256 逐位一致（字母大小写不影响比较）。不要只看前几位。摘要不一致、文件来源不同或无法确认时，不要运行；删除后重新从 Release 下载。

Windows 下载地址 macOS 下载地址

08 · 保留证据，安全求助

遇到问题与导出脱敏报告

无法连接手机

依次检查解锁、数据线、USB 模式、USB 网络、SSH 和 Root，不要只凭能否充电判断。Mac 可核对“连接至 Mac”；Windows 首次驱动由向导处理。主机指纹变化时先核实可信材料，不关闭安全校验。

预检不通过或手机不能移动上网

阅读失败项的原因与建议，核对 SIM、LTE、实际 MCC/MNC、数据 APN 和原厂配置。手机无法正常移动上网时不要跳过安装条件，也不要把非默认配置直接认定为损坏。

注册待确认

保持现场，稍后查看状态并确认运营商服务。默认 180 秒观察结束不等于自动安装成功，也不应触发反复重装；只有真实通话清单全部通过才算本机验收。

安装中断或状态未知

保留安装记录和错误提示，重新预检、查看状态，然后联系维护者。不要删除事务记录、强行覆盖或重新 Root；私有安装记录不要直接公开上传。

导出并检查脱敏 JSON 报告

  1. 连接手机并重新执行一次检查，确保报告对应当前状态，然后打开“更多 → 导出检查报告”，将 JSON 保存到自己选择的位置。工具不会自动上传报告。
  2. 报告只保留允许的检查项、结果及必要的机型、系统、MCC/MNC 等信息，不包含完整 IMSI、IMEI、ICCID、PIN、手机号、SSH 密钥、主机地址、配置原文或原始 SIP 日志。
  3. 分享前仍要自行打开检查。确认自定义名称和附加文字中没有个人信息；不要额外上传 private 目录、私钥、ssh_config、known_hosts、私有安装记录或原始通信日志。
  4. 到项目 GitHub Issue 提交报告时，注明 v0.3.3-r5、Windows EXE 或 macOS DMG、电脑系统、手机型号与变体、完整 BB10 OS、运营商与使用地区、是否漫游或携号转网、失败阶段及错误提示。可用结果也请说明呼入、呼出、双向声音、全程 4G、拔 USB 和重启后的逐项结果。

前往 GitHub Issues 反馈可用或不可用结果

09 · 查阅原始说明

官方文档

本页适用于当前公开版本 v0.3.3-r5。仓库主分支可能已有新改动；下载包支持什么，以对应 Release 的附件和说明为准。