# CokeeMesh

**Repository Path**: cokee/CokeeMesh

## Basic Information

- **Project Name**: CokeeMesh
- **Description**: 无网应急通讯 · 手机 BLE 自组网（仅发布 APK，源码不在此仓库）
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-10-12
- **Last Updated**: 2026-10-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# CokeeMesh · 无网应急通讯

手机在**无公网、无路由器、无基站**的情况下，通过 BLE 自组网互相通信；
需要传图片等大文件时，用 Wi-Fi 本地热点作为补充通道。

> 本仓库**只发布 APK**，用于分发与更新；源码不在此仓库。

## 下载

| 版本 | 说明 | 直链 |
| --- | --- | --- |
| **v0.2.0** | 全新视觉（当前推荐） | [CokeeMesh-v0.2.0.apk](https://gitee.com/cokee/CokeeMesh/releases/download/v0.2.0/CokeeMesh-v0.2.0.apk) · 75 KB |
| v0.1.0 | 首个可安装版本 | [CokeeMesh-v0.1.0.apk](https://gitee.com/cokee/CokeeMesh/releases/download/v0.1.0/CokeeMesh-v0.1.0.apk) · 916 KB |

```bash
curl -L -o CokeeMesh-v0.2.0.apk https://gitee.com/cokee/CokeeMesh/releases/download/v0.2.0/CokeeMesh-v0.2.0.apk
adb install -r CokeeMesh-v0.2.0.apk
```

两个版本使用同一签名，可直接覆盖安装，本机编号与称呼会保留。

## 安装要求

| 项目 | 要求 |
| --- | --- |
| 系统 | Android 8.0（API 26）及以上 |
| 硬件 | 支持 BLE 4.0+，且需支持 BLE 广播才能被其他节点发现 |
| 权限 | 蓝牙 / 附近设备 / 通知；**Android 12 以下还需定位权限，且系统定位开关要打开**（BLE 扫描的系统要求） |

## 怎么用

1. 两台手机都装上本 App，填写称呼并保存；
2. 授权弹窗全部允许，打开蓝牙，点「开始组网」；
3. 十几秒后主页会显示「直连 N」；
4. 「附近节点」看邻居，「报文会话」收发短报文，「一键求救 SOS」发告警；
5. 「自组网拓扑」看多跳关系：内圈是直连，外圈是只能经中继到达的节点。

> 演示"无网"最有力的方式：**拔掉 SIM 卡、关掉 Wi-Fi**，通信依然可用。

## 技术要点

- **BLE 双角色**：每个节点同时是 Peripheral（广播 + GATT Server）和 Central（扫描 + 连接 + 写入）
- **连接去重**：只有节点编号较小的一方主动建连，保证每对节点恰好一条链路
- **两级分片**：报文级 CHUNK 重组 + 字节级流式分帧（含失步自恢复，兼容只协商到 20 字节 MTU 的机型）
- **泛洪 + 去重 + TTL**：LRU 512 条去重，TTL 初始 4；SOS 在发送队列中插队
- **自绘拓扑图**：不依赖 GPS 与离线地图，规避地图审图号合规问题

## 已知状态

- 协议层 85 项自动化断言全部通过（分片重组、三节点中继、多路径去重、TTL 耗尽、四节点三跳、字节流分帧）
- APK 已真实编译通过并产出
- **尚未在真机上完成多机联调**；Wi-Fi 热点传文件通道未在真机验证
- 不支持 iOS（两端都使用同一 Android 应用是刻意取舍）

## 构建环境

AGP 9.3.0 + Gradle 9.7.0 + JDK 21，`compileSdk 36 / targetSdk 34 / minSdk 26`，
纯 Java + XML，**零第三方依赖**（已关闭 AGP 9 默认注入的 kotlin-stdlib 与框架 API 存根）。