bitchat：去中心化蓝牙网状聊天

项目简介

bitchat 是一个去中心化的点对点消息应用，采用「双传输」架构：在附近没有网络时，通过蓝牙 LE 组成本地网状网络（mesh）离线通信；需要连接远方的人时，则通过互联网上的 Nostr 中继进行通信。全程不需要账号、手机号，也不依赖中心服务器。

这是 bitchat 的 Android 实现，二进制协议与 iOS 版本 完全兼容，因此 Android、iOS 与 macOS 设备之间可以互相组成 mesh 聊天。

项目主页：bitchat.free

效果截图

离线 mesh 对话	geohash 地球选择器

主要功能

• 双传输架构：蓝牙 LE mesh 负责离线消息，Nostr 中继负责互联网消息。
• 基于位置的频道：通过 geohash 坐标在 Nostr 中继上建立地理聊天室，可在重设计的地球界面中浏览并加入。
• 智能消息路由：自动选择更合适的传输方式；对端不可达时进入队列并重试。
• 端到端加密：私聊使用 Noise Protocol（XX 模式，X25519 + ChaCha20-Poly1305）。
• 去中心化 mesh 网络：自动发现邻居，并通过蓝牙 LE 进行多跳中继（最多 7 跳）。
• Wi-Fi Aware 传输：在支持的设备上提供更高带宽的本地 mesh。
• 频道聊天：基于主题的群聊，可选密码保护（Argon2id + AES-256-GCM）。
• IRC 风格命令：熟悉 /join、/msg、/who 等指令式操作。
• Tor 支持：内置 Tor（Arti），用于私密的互联网连接。
• 紧急擦除：连按三次即可立即清空全部数据。
• 跨平台：二进制协议与 iOS、macOS 上的 bitchat 兼容。

安装与使用

获取应用

可从 GitHub Releases 下载签名 APK，或从 Google Play 安装。Release 中提供以下安装包：

• bitchat-android-arm64.apk：适用于大多数现代 Android 手机
• bitchat-android-universal.apk：兼容性备选
• bitchat-android-x86_64.apk：x86_64 设备与模拟器
• bitchat-android-wear.apk：用于直接在 Wear OS 上安装

手机版要求 Android 8.0 / API 26 或更高；Wear OS 版要求 API 33 或更高。

从源码构建

需要 Android Studio 与 Android SDK（API 26+）。

git clone https://github.com/permissionlesstech/bitchat-android.git
cd bitchat-android
./gradlew assembleDebug

安装到已连接的设备：

adb install -r app/build/outputs/apk/debug/app-debug.apk

测试

# 单元测试
./gradlew test

# Lint
./gradlew lint

# 仪器测试（需要真机或模拟器）
./gradlew connectedAndroidTest

注意事项

• 应用会在运行时申请蓝牙、位置（BLE 扫描所需）与通知权限；缺少这些权限时 mesh 功能无法正常工作。
• 蓝牙 mesh 依靠前台服务在 Android 后台执行限制内保持连接，因此会常驻一条通知。
• BLE mesh 的射频层行为难以模拟，协议与会话逻辑由单元测试覆盖，实际无线行为需要在真机上验证。
• 私聊在 mesh 不可用时会回退到 Nostr；geohash 区域使用临时密钥。
• 发布版 APK 与 AAB 可在固定的 Linux 容器中逐字节重建，维护者需参考仓库中的发布指南与可复现构建文档。
• 许可证详情见仓库的 LICENSE 文件。

---

本作品整理自 GitHub 开源项目 permissionlesstech/bitchat-android，原作者 @permissionlesstech，许可证 GPL-3.0。中文介绍由 AI 根据项目 README 整理，以原仓库为准。