# ble-mirror

**Repository Path**: code-ape-hc/ble-mirror

## Basic Information

- **Project Name**: ble-mirror
- **Description**: 把远处一个真实蓝牙设备「照镜子」到本地——看起来、连起来、用起来都像真的一样。本地对镜子的操作可反向透传到远端真设备
- **Primary Language**: JavaScript
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-03
- **Last Updated**: 2026-06-09

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# BLE Mirror

远程蓝牙设备镜像系统 —— 把远处一个真实蓝牙设备「照镜子」到本地，连起来用起来都像真的一样。

## 工作模式

| 模式 | 做什么 |
|------|--------|
| **采集模式** | 连接真实 BLE 设备，全量抓取 GATT 结构和广播数据，通过 WebSocket 推送给模拟端 |
| **模拟模式** | 接收设备镜像，用户勾选要模拟的内容，启动 BLE Peripheral 广播让第三方设备可连 |

## 技术栈

| 层 | 选型 |
|------|------|
| 框架 | uni-app (Vue 3) |
| 平台 | Android |
| 采集端 BLE | uni-app 标准 BLE API |
| 模拟端 Peripheral | qy-bleperipheral 插件 |
| 通信 | WebSocket 直连 |
| 数据格式 | JSON（全内存，无持久化） |

## 目录结构

```
ble-mirror/
├── App.uvue                  # 应用入口
├── main.uts                  # 主入口逻辑
├── manifest.json             # 应用配置（权限、插件）
├── pages.json                # 页面路由
├── uni.scss                  # 全局样式
├── pages/
│   ├── index/                # 启动页（模式选择 + WS URL）
│   ├── capture/              # 采集模式页面
│   └── emulate/              # 模拟模式页面
└── static/                   # 静态资源
```

## 快速开始

1. 用 HBuilderX 打开本项目
2. 在插件市场导入 `qy-bleperipheral`（id=22695）
3. 配置 manifest.json 中的蓝牙权限
4. 自定义基座运行

## 验证方式

- **采集端**：一台手机连接真实 BLE 设备
- **模拟端**：另一台手机运行模拟模式
- **验证**：用 nRF Connect 扫描并连接模拟设备，对比 GATT 结构

## 文档

- [需求文档](D:\work\设计\BLE_Mirror\BLE_Mirror_需求文档_v0.1.md)