From b93b283b9e379a6d21c7fbe2b97ea40e853480e5 Mon Sep 17 00:00:00 2001 From: srsng Date: Mon, 29 Sep 2025 14:19:38 +0800 Subject: [PATCH 1/3] =?UTF-8?q?=E8=93=9D=E7=89=99=E9=85=8D=E7=BD=91?= =?UTF-8?q?=E5=8D=8F=E8=AE=AE=E6=B7=BB=E5=8A=A0=E5=AF=B9ios=E8=8E=B7?= =?UTF-8?q?=E5=8F=96=E8=AE=BE=E5=A4=87mac=E5=9C=B0=E5=9D=80=E7=9A=84?= =?UTF-8?q?=E9=80=82=E9=85=8D?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/xrobot/platform/blufi-config.md | 15 ++++++++++++++- 1 file changed, 14 insertions(+), 1 deletion(-) diff --git a/docs/xrobot/platform/blufi-config.md b/docs/xrobot/platform/blufi-config.md index 517b522..8dc345d 100644 --- a/docs/xrobot/platform/blufi-config.md +++ b/docs/xrobot/platform/blufi-config.md @@ -172,12 +172,25 @@ sequenceDiagram ### 2.2 设备识别 -**设备名称规则**: 设备名称应匹配以下模式之一： +**设备名称规则**: 设备名称name应匹配以下模式之一： - `DTXZ*` - `BLUFI_DEVICE*` - `ESP_*` +**设备MAC地址获取**: 设备在广播时发送，客户端与设备连接前获取： + +1. 通常可以直接通过广播发现设备时的数据包的deviceId获取 +2. 由于一些[安全机制](https://developers.weixin.qq.com/miniprogram/dev/framework/device/bluetooth.html)，IOS不适用第一条（无法正常获取设备MAC地址） + + 解决方案：约定将设备MAC地址设置在`localName`中，参考[微信小程序文档](https://developers.weixin.qq.com/miniprogram/dev/api/device/bluetooth/wx.onBluetoothDeviceFound.html) + + mac地址格式可以是 + - AA:BB:CC:DD:EE:FF + - AA-BB-CC-DD-EE-FF + - AABBCCDDEEFF + 满足正则`/[0-9A-Fa-f]{2}([-:]?)[0-9A-Fa-f]{2}(?:\1[0-9A-Fa-f]{2}){4}$/`即可，建议直接使用第一种，设备与智能体绑定所使用的mac地址格式也为第一种。 + **连接模式**: - 设备作为外围设备（Peripheral）进行广播 From f65bfa8e3dae6ddb1591a2eb0d935a8e656ede09 Mon Sep 17 00:00:00 2001 From: srsng Date: Mon, 29 Sep 2025 14:20:04 +0800 Subject: [PATCH 2/3] =?UTF-8?q?chore=20=E8=B0=83=E6=95=B4=E9=9F=B3?= =?UTF-8?q?=E4=B9=90=E7=BD=91=E7=9B=98=E7=A4=BA=E4=BE=8B=E6=96=87=E6=A1=A3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/xrobot/mcp/example-music-pan.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/xrobot/mcp/example-music-pan.md b/docs/xrobot/mcp/example-music-pan.md index a3c68aa..d82d821 100644 --- a/docs/xrobot/mcp/example-music-pan.md +++ b/docs/xrobot/mcp/example-music-pan.md @@ -155,7 +155,7 @@ AK 与 SK 是重要隐私，避免泄露给不可信来源。 来到灵矽AI控制台，登录之后，点击左侧的侧边栏选项“自定义MCP”，然后点击“添加自定义MCP”。 -在弹出的对话框中你需要按照表单填写服务名称、简短描述、LOGO、tag，以及接入配置，接入配置填写需要注意，你是以服务提供者的身份填写信息，不是以使用者的身份填写信息： +在弹出的对话框中你需要按照表单填写服务名称、简短描述、LOGO、tag，以及接入配置，接入配置填写需要注意，你是以**服务提供者**的身份填写信息，不是以使用者的身份填写信息： - SSE URL: 需要填写完整的，带有http(s)协议的、可访问的URL，通常还是以/SSE结尾 @@ -184,4 +184,4 @@ AK 与 SK 是重要隐私，避免泄露给不可信来源。 -当前 music-mcp-server SSE URL：`http://121.29.19.158:8000/sse` +当前 music-mcp-server SSE URL：`http://121.29.19.146:8000/sse` From 8077d6773095c6b6e65233c4ad55f10c1cc01aa1 Mon Sep 17 00:00:00 2001 From: srsng Date: Mon, 29 Sep 2025 16:06:45 +0800 Subject: [PATCH 3/3] =?UTF-8?q?chore=20=E5=BE=AE=E8=B0=83=E8=93=9D?= =?UTF-8?q?=E7=89=99=E9=85=8D=E7=BD=91mac=E5=9C=B0=E5=9D=80=E8=8E=B7?= =?UTF-8?q?=E5=8F=96=E6=96=87=E6=A1=A3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/xrobot/platform/blufi-config.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/docs/xrobot/platform/blufi-config.md b/docs/xrobot/platform/blufi-config.md index 8dc345d..1edffa9 100644 --- a/docs/xrobot/platform/blufi-config.md +++ b/docs/xrobot/platform/blufi-config.md @@ -185,11 +185,12 @@ sequenceDiagram 解决方案：约定将设备MAC地址设置在`localName`中，参考[微信小程序文档](https://developers.weixin.qq.com/miniprogram/dev/api/device/bluetooth/wx.onBluetoothDeviceFound.html) - mac地址格式可以是 + MAC地址格式可以是 - AA:BB:CC:DD:EE:FF - AA-BB-CC-DD-EE-FF - AABBCCDDEEFF - 满足正则`/[0-9A-Fa-f]{2}([-:]?)[0-9A-Fa-f]{2}(?:\1[0-9A-Fa-f]{2}){4}$/`即可，建议直接使用第一种，设备与智能体绑定所使用的mac地址格式也为第一种。 + + 满足正则`/[0-9A-Fa-f]{2}([-:]?)[0-9A-Fa-f]{2}(?:\1[0-9A-Fa-f]{2}){4}$/`即可(注意$)，建议直接使用第一种，设备与智能体绑定所使用的MAC地址格式也为第一种。 **连接模式**: