BLExpert

一款面向嵌入式、IoT、测试与现场支持工程师的 BLE 协议调试工具。

BLExpert 将蓝牙设备连接、原始报文收发、协议解析、业务命令和会话记录放在同一个工作台中。它适合在设备联调、协议验证、现场排障时快速确认：设备是否连通、报文是否正确、字段如何变化，以及某条命令带来了什么响应。

核心功能

连接与设备调试

• 扫描、连接和断开 BLE 设备。
• 浏览 GATT 服务与特征，选择写入、通知和指示特征。
• 支持读、带响应写入、无响应写入、Notify 和 Indicate。
• 为常用设备保存默认服务和特征选择，下次连接时自动恢复。

实时通信控制台

• 集中显示发送、接收、系统事件和错误，保留时间戳、特征和原始 HEX 数据。
• 手动发送 HEX 或文本；输入自动格式化，并清晰展示目标特征、载荷大小和最终发送帧。
• 支持按方向、关键字或 HEX 搜索筛选，快速回到最新消息。
• 点击一条日志即可在 Inspector 中查看完整报文、解析结果和关联事务。

协议与命令配置

• 用工作区保存设备配置、协议规则、脚本、命令和响应映射，方便团队或项目复用。
• 配置固定字段、业务载荷、长度、序号、字节序和 XOR / SUM8 / CRC8 / CRC16 / CRC32 校验。
• 自动处理拆包、粘包、多帧和校验失败后的恢复。
• 创建带参数的业务命令，支持数字、HEX、ASCII、UTF-8、布尔、枚举和时间参数。

响应数据解析

• 从协议解帧结果中的 CMD/DATA 匹配响应，并映射为可读业务字段。
• 支持数值、HEX、文本、布尔、枚举、位域、数组、比例、偏移、单位和字节序。
• 实时查看字段最新值和变化状态，帮助定位设备返回是否符合预期。

调试记录与配置复用

• 本地恢复最近会话，支持筛选、书签和 JSON 导出。
• 导入、导出单个或全部工作区；支持旧版本迁移、预览、替换与合并。
• 发送记录可关联命令、后续响应、脚本日志和映射结果，便于复盘。

AI 协议助手

• 将 TXT 或 Markdown 协议资料交给用户配置的 OpenAI-compatible 模型分析。
• 以“证据提取 → 候选配置 → 本地校验 → 人工审查 → 草案工作区”的方式协助建模协议。
• AI 结果不会自动覆盖当前工作区、启用脚本、连接设备或发送数据。

MCP 外部 AI 调试

• Windows、macOS 和 Linux 桌面端可将当前 BLExpert 调试会话接入支持 MCP 的外部 AI 客户端。
• 设置页可复制 Codex (TOML) 或 Claude Desktop / 通用 JSON 配置；安装版内置 blexpert_mcp bridge，无需安装 Dart。
• AI 可读取当前连接状态、收发和已解码记录、活动工作区、已配置指令与响应映射；发送仍受会话权限、封包逻辑、设备策略、安全确认和日志记录约束。
• AI 创建的工作区只会进入待审查草案，必须在 BLExpert 界面中确认后才会应用。
• 关闭“本地 AI 调试”或退出应用会立即撤销会话，之前复制的配置不能继续访问设备。

完整的客户端配置、首次验证、权限模式和排障说明见 MCP 使用指南。

安全设计

• 原始 BLE 收发始终保留；协议、脚本或映射失败不会隐藏原始数据。
• 导入和 AI 生成的脚本默认禁用，首次启用需确认来源与风险。
• 真实设备写入可经过高风险命令确认、工作区命令白名单和设备发送策略限制。
• MCP 仅在用户显式开启的本地桌面会话中可用，使用回环端点和临时会话凭据；不开放公网访问，也不能扫描、连接或切换设备。
• MCP 不读取模型 API Key 或脚本源码，外部 AI 不能直接覆盖活动工作区。

支持范围

BLExpert 以 BLE Central 为核心，支持 Android、iOS、Windows、macOS、Linux 和 Web。不同平台的可用能力取决于系统蓝牙栈与浏览器权限；Web 端在浏览器支持的前提下，可在受限 sandbox iframe 和可终止 Worker 中执行 JavaScript 协议脚本。Web Bluetooth 仍主要依赖 Chromium 系浏览器、HTTPS 和用户手势。实现边界与跨浏览器回归状态见 Web 脚本运行时方案评估。

当前不包含经典蓝牙 SPP/RFCOMM 和 BLE Peripheral（设备模拟）模式。

进一步了解

• 产品说明：用户场景、范围和核心模型。
• 文档导航：开发、AI 协议助手和发布相关文档。
• MCP 使用指南：外部 AI 客户端配置、首次验证、权限与排障。
• 开发路线图：当前进度、已知限制与后续计划。