外观主题
阅读语言

bit-mobile —— BIT 触手怪安卓伴侣端：扫码配对、随身对话与工具审批

软件 本站软件 1天前 更新于 21小时前
https://yxp.hk/p/Ghjn3x

📦 开源仓库：yxpil/bit-mobile

gh-card · yxpil/bit-mobile

📦 仓库名片 · Powered by gh-card

BIT Mobile — BIT 安卓伴侣端

原生 Android（Kotlin + Jetpack Compose）打造的 BIT 移动端伴侣应用：在桌面端触手怪的远程访问页出示连接二维码，用本应用扫码即可配对——随身对话、随时审批 AI 的工具调用。当前对接桌面端 v0.5.14+ 协议。永久免费开源（Apache-2.0），无内购、无订阅、无遥测。

功能特性

  • 扫码配对：二维码内容为 BIT-Crypt v1 加密密文（BIT1: 前缀），仅本应用可解——截图外泄也读不出连接凭据；无摄像头场景支持手动粘贴连接码。
  • 多路连接：按二维码携带的候选自动尝试——局域网直连 → IPv6 直连 → 云中继（对称 NAT 场景），每路候选的探活与认证结果如实呈现。
  • 随身对话：每台设备在桌面端拥有独立会话（remote-<随机>，sidPolicy=device），绝不与桌面激活会话或其它设备串线；对话仅存本机与桌面端。
  • 工具审批：桌面端 Agent 请求执行工具时（ask 模式），手机端实时弹出审批卡片，可允许 / 拒绝，与桌面端审批互为补充。
  • 连接状态诚实呈现：认证失败、候选不可达、中继不可用均给出具体原因，不静默吞错。

安全与隐私

  • 二维码密文使用 BIT-Crypt v1（SHA256-CTR + 内置主密钥），与桌面端 security.rs 同算法、经 node crypto 向量交叉验证（14 个协议层单测全过）。
  • 云中继只转发、不留存任何内容。
  • bitsign-v2 设备签名凭证不出桌面端：经云中继的请求在 v0.5.14 桌面端会被 403 拒绝，应用如实呈现该限制；局域网 / IPv6 直连不受影响，桌面端配套升级后无需改动即可启用中继。

安装使用

从 Releases 下载 APK 安装（Android 9+）：

  1. 桌面端 BIT → 远程访问 → 出示连接二维码
  2. 手机端扫码配对（首次需授权相机）
  3. 对话页发消息；ask 模式下工具请求以卡片弹出供审批

开发

  • 技术栈：Kotlin + Jetpack Compose + CameraX / ML Kit + OkHttp + Coroutines
  • 构建：Android Studio 或 ./gradlew assembleDebug（需 JDK 17）
  • 测试：./gradlew testDebugUnitTest（14 个协议层用例）；全链路 E2E：node e2e/mobile-e2e.cjs 自动拉起真实 BIT 实例（headless + 隔离数据目录 + mock-ai），覆盖扫码→连接→对话→审批允许/拒绝→非法用例 7 个场景

许可

Apache-2.0

📚 文档与链接