tmui-cli 2.0.1 → 2.0.3

package/data/tmui4x/10./346/217/222/344/273/266/345/272/223/xActionsheetS /345/272/225/351/203/250/345/212/250/344/275/234/350/217/234/345/215/225.md"

@@ -0,0 +1,96 @@
+# x-actionsheet-s 底部动作菜单
+
+从底部弹出的原生动作菜单，用来替代 `uni.showActionSheet` 的样式受限场景。视觉对齐 tmx-ui 的 `x-action-menu`：灰底白条、遮罩淡入、内容从底向上滑出，并预留底部安全区。
+
+**微信内使用官方 `uni.showActionSheet`，图标、圆角、遮罩色等样式字段不生效，仅保留签名。**
+
+### 兼容性
+
+| Harmony | IOS | Android | WEB | 小程序 |
+| --- | --- | --- | --- | --- |
+| 支持 | 支持 | 支持 | 支持 | 支持（官方菜单） |
+
+### 调用
+
+```ts
+import { showActionSheet, hideActionSheet, XActionSheetOptions, XActionSheetItem } from "@/uni_modules/x-actionsheet-s"
+
+showActionSheet({
+  title: "请选择操作",
+  list: [
+    { id: "share", text: "分享", icon: "F0FD" } as XActionSheetItem,
+    { id: "edit", text: "编辑", icon: "EC86" } as XActionSheetItem,
+    { id: "del", text: "删除", icon: "EC2A", fontColor: "#e54d42" } as XActionSheetItem
+  ] as XActionSheetItem[],
+  itemClick: (index : number, item : XActionSheetItem) => {
+    console.log("点击", index, item.text)
+  },
+  cancel: () => {
+    console.log("取消 / 遮罩 / 手势返回")
+  },
+  close: () => {
+    console.log("已关闭")
+  }
+} as XActionSheetOptions)
+```
+
+主动关闭：
+
+```ts
+hideActionSheet()
+```
+
+### 参数
+
+`XActionSheetItem`
+
+| 字段 | 说明 | 默认 |
+| --- | --- | --- |
+| id | 条目标识 | 索引字符串 |
+| text | 条目文字 | 必填 |
+| icon | Remix 图标 unicode，如 `F0FD`。微信不支持 | `""` |
+| iconColor | 图标颜色 | `#333333` |
+| fontColor | 文字颜色 | `#333333` |
+| fontSize | 字号 px | `16` |
+| disabled | 禁用 | `false` |
+
+`XActionSheetOptions`
+
+| 字段 | 说明 | 默认 |
+| --- | --- | --- |
+| title | 标题 | `请选择` |
+| showTitle | 是否显示标题 | `true` |
+| list | 条目数组 | `[]` |
+| showCancel | 是否显示取消 | `true` |
+| cancelText | 取消文字 | `取消` |
+| cancelColor | 取消文字色 | `#333333` |
+| overlayClick | 点击遮罩关闭 | `true` |
+| cellClickClose | 点击条目后关闭 | `true` |
+| space | 非通栏：相对屏幕左右和底部留间隙（不是内容 padding），四角圆角；`false` 为通栏贴边 | `true` |
+| round | 圆角 px | `16` |
+| maxHeight | 列表最大高度 px，0 为屏高 80% | `0` |
+| maskBgColor | 遮罩色 | `rgba(0,0,0,0.35)` |
+| contentBgColor | 面板底色 | `#f5f5f5` |
+| cellBgColor | 条目底色 | `#ffffff` |
+| titleColor | 标题色 | `#888888` |
+| duration | 动画 ms | `350` |
+| itemClick | 点击条目 | - |
+| cancel | 取消 / 遮罩 / 手势返回 | - |
+| close | 关闭完成 | - |
+
+### 平台差异
+
+1. 微信小程序：`uni.showActionSheet`，最多 6 条，仅 `title`（alertText）、`text`、`fontColor`（itemColor）生效；`hideActionSheet` 为空实现。
+
+### 版本
+
+版权归https://xui.tmui.design你不得修改及二次开发，仅供TMUI4会员商用使用。不得转给非VIP会员使用，一经查实数倍赔偿，并追究法律责任。
+
+## 更新日志
+
+### 1.0.1（2026-08-14）
+* App 三端复制独立字体 `x-actionsheet-remixicon.ttf`（族名同步改名），避免和其它插件的 `remixicon.ttf` 资源冲突。
+* Web 图标字体族名为 `x-actionsheet-remixicon`，文件使用全局 `/static/tmui4xLibs/static/remixicon.ttf`。
+### 1.0.0（2026-08-14）
+* 新增 x-actionsheet-s：App 三端原生全屏弹层，遮罩淡入、内容从底向上弹出，支持手势返回关闭并预留底部安全区。
+* Web 使用自定义 div 节点实现；微信小程序走官方 showActionSheet，不支持的样式字段保留签名。

package/data/tmui4x/10./346/217/222/344/273/266/345/272/223/xAddphonerepeatcalendarS /347/263/273/347/273/237/346/227/245/345/216/206.md"

@@ -0,0 +1,129 @@
+# x-addphonerepeatcalendar-s 系统日历
+
+向系统日历添加单次或重复事件。参数与回调对齐微信 `wx.addPhoneCalendar` / `wx.addPhoneRepeatCalendar` 和 DCloud `success / fail / complete`。
+
+对外方法名为 `xAddPhoneCalendar`、`xAddPhoneRepeatCalendar`，类型统一加 `X` 前缀，避免和官方 `addPhoneCalendar` 同名冲突。
+
+有日历权限时直接写入系统日历；无权限时打开系统新建日程页，用户取消返回 `609`。
+
+### 兼容性
+
+| Harmony | iOS | Android | WEB | 微信小程序 |
+| --- | --- | --- | --- | --- |
+| 支持 | 支持 | 支持 | 不支持 | 支持 |
+
+### 调用
+
+```ts
+import {
+  xAddPhoneCalendar,
+  xAddPhoneRepeatCalendar,
+  XAddPhoneCalendarOptions,
+  XAddPhoneRepeatCalendarOptions
+} from "@/uni_modules/x-addphonerepeatcalendar-s"
+
+xAddPhoneCalendar({
+  title: "项目评审",
+  startTime: Math.floor(Date.now() / 1000),
+  notes: "带上原型稿",
+  location: "会议室 A",
+  success: (res) => {
+    console.log(res.errMsg)
+  },
+  fail: (err) => {
+    console.log(err.errCode, err.errMsg)
+  }
+} as XAddPhoneCalendarOptions)
+
+xAddPhoneRepeatCalendar({
+  title: "健身打卡",
+  startTime: Math.floor(Date.now() / 1000),
+  repeatInterval: "week",
+  repeatEndTime: Math.floor(Date.now() / 1000) + 30 * 24 * 60 * 60
+} as XAddPhoneRepeatCalendarOptions)
+```
+
+### 方法
+
+| 名称 | 说明 |
+| --- | --- |
+| xAddPhoneCalendar | 添加单次日历事件 |
+| xAddPhoneRepeatCalendar | 添加重复日历事件 |
+
+### 参数
+
+`XAddPhoneCalendarOptions` / `XAddPhoneRepeatCalendarOptions`
+
+| 字段 | 说明 | 默认 |
+| --- | --- | --- |
+| title | 标题 | 必填 |
+| startTime | 开始时间 unix 时间戳（秒）。大于 `1e11` 时按毫秒换算 | 必填 |
+| allDay | 是否全天 | `false` |
+| notes | 事件说明。微信端映射为 `description` | 空 |
+| location | 地点 | 空 |
+| endTime | 结束时间 unix 时间戳（秒） | 同开始时间 |
+| path | 小程序路径，仅微信；会拼到说明 | 空 |
+| signature | 路径签名，仅微信 | 空 |
+| repeatInterval | 仅重复 API：`day` / `week` / `month` / `year` | `month` |
+| repeatEndTime | 仅重复 API：重复截止时间戳（秒） | 一直重复 |
+| success | 成功 | - |
+| fail | 失败 | - |
+| complete | 结束，成功带结果，失败为 null | - |
+
+每月重复时，开始日期不能大于 28 日。
+
+### 错误码
+
+| 码 | 含义 |
+| --- | --- |
+| 601 | 标题为空 |
+| 602 | 开始时间无效 |
+| 603 | 结束时间无效或早于开始时间 |
+| 606 | 重复规则无效 |
+| 607 | 日历服务不可用 |
+| 608 | 写入日历失败 |
+| 609 | 用户取消了系统日历创建 |
+| 1001 | 系统错误，或正在添加日历事件 |
+| 1008 | 当前平台不支持（Web） |
+
+### 平台差异
+
+1. 微信走官方 `wx.addPhoneCalendar` / `wx.addPhoneRepeatCalendar`，需用户点击触发，并授权 `scope.addPhoneCalendar`。
+2. Android 申请 `READ_CALENDAR` / `WRITE_CALENDAR` 后直接写入 `CalendarContract`。没有可写日历时先创建本地日历。仅用户拒绝权限时才打开系统新建页。
+3. iOS 使用 EventKit；iOS 17+ 优先写权限。只写权限下列不出真实日历时，改为打开系统 `EKEventEditViewController`，不再返回 607。无权限时同样打开系统新建日程页。
+4. HarmonyOS 使用 Calendar Kit。有权限后直接 `addEvent`；没有本地日历时先 `createCalendar`。仅用户拒绝权限时走 `editEvent`。
+5. 不写入系统「闹钟提醒」。Android 官方只处理 `METHOD_ALERT` 通知，`METHOD_ALARM` 设备不响；国产日历的闹钟开关没有公开 extra。iOS 日历没有对等的闹钟项。
+6. Web 返回 `1008`。
+
+### 版本
+
+版权归 https://xui.tmui.design 你不得修改及二次开发，仅供 TMUI4 会员商用使用。不得转给非 VIP 会员使用，一经查实数倍赔偿，并追究法律责任。
+
+## 更新日志
+
+### 1.0.5（2026-08-17）
+
+- HarmonyOS `index.uts` 的 `catch` 不再标注类型，避免编成 `.ets` 后 hvigor 报 `arkts-no-types-in-catch`
+- 日历权限文案改为插件专属资源名，避免和宿主、其它模块冲突
+
+### 1.0.4（2026-08-17）
+
+- 去掉 `alarm` / `alarmOffset`。Android 官方设备只处理通知提醒，国产日历「闹钟提醒」没有可写 extra；iOS 日历没有对等闹钟项
+
+### 1.0.3（2026-08-17）
+
+- HarmonyOS 对齐 Android/iOS：授权后直接写入，没有日历时创建本地日历并开启 `enableReminder`，不再因写入失败跳系统编辑页
+- 明确 `alarm` / `alarmOffset` 写入系统日历闹钟；鸿蒙日历需先打开提醒开关才会响
+
+### 1.0.2（2026-08-17）
+
+- 修复 Android 申请日历权限时 `The requested permission cannot be empty`，以及授权后因没有可写日历跳到系统新建页、返回后 pending 未清理导致第二次卡在「正在添加日历事件」
+- Android 有权限后直接写入；没有可写日历时先创建本地日历。重复事件改为 `DURATION + RRULE`，不再同时写 `DTEND`
+
+### 1.0.1（2026-08-17）
+
+- 修复 iOS 17+ 只写日历权限下 `defaultCalendarForNewEvents` 为空直接返回 607 的问题；无可用日历时改为打开系统新建日程页
+
+### 1.0.0（2026-08-16）
+
+- 新增 `xAddPhoneCalendar` / `xAddPhoneRepeatCalendar`，支持 Android / iOS / HarmonyOS / 微信小程序写入系统日历

package/data/tmui4x/10./346/217/222/344/273/266/345/272/223/xAppiconS /345/272/224/347/224/250/345/233/276/346/240/207/344/270/216/350/247/222/346/240/207.md"

@@ -0,0 +1,181 @@
+# x-appicon-s 应用图标与角标
+
+类似淘宝：运行时切换**预置桌面图标**，并设置桌面**角标数字 / 小红点**。标准 `-s` API 插件，页面 `import` 后直接调用。
+
+**远程图片不能作为桌面图标。** iOS、Android、HarmonyOS 都要求图标打进安装包（或走应用市场上架的图标管理）。本插件内置 `festival` / `sale` / `newyear` 三套图；要换自己的图，替换插件资源并保持同名即可。
+
+切换图标、角标都要**自定义基座 / 云打包**后才生效。部分桌面不会立刻刷新，回到桌面等几秒，或重新打开桌面。
+
+### 兼容性
+
+| 能力 | Android | iOS | HarmonyOS | WEB | 微信小程序 |
+| --- | --- | --- | --- | --- | --- |
+| 切换桌面图标 | 支持（activity-alias） | 支持（Alternate Icon） | 当前 SDK 不支持本地切换 | 标签页 favicon + Safari 主屏幕 / 程序坞大图标 | 不支持 |
+| 远程图片当图标 | 不支持 | 不支持 | 不支持 | 不支持 | 不支持 |
+| 数字角标 | 支持（通知点 + 厂商通道） | 支持 | 支持 | 标签标题闪烁，如 `(5) 标题` | 不支持 |
+| 纯红点 | 支持（通知点） | 不支持，会显示 1 | 不支持，会显示 1 | 标签标题 `●` 闪烁 | 不支持 |
+
+### 平台差异说明
+
+同一套 API，各端能做到的事不一样。系统没有「任意换桌面图 / 只改角标数字」的统一能力，插件只能对齐各端官方接口。
+
+#### 动态图标
+
+| 端 | 实际改的是什么 | 注意 |
+| --- | --- | --- |
+| Android | 多个 图标内置 |
+| iOS | Alternate Icon | 静默切换，图标内置 |
+| HarmonyOS | 当前工程 SDK 没有本地切图标接口 | `xSetAppIcon` 返回 1008。上架图标管理要走 AGC，且 `alternateIcons` 从 API 26 才有 |
+| Web | 当前页 favicon + Safari `apple-touch-icon` | 不能改操作系统桌面图标。Safari「添加到主屏幕 / 程序坞」用大图；**已经钉在桌面上的图标不会自动变**，要去掉后重新添加 |
+| 微信小程序 | 不支持 | 1008 |
+
+
+#### 角标数字 / 红点
+
+没有全机型通用的「只改桌面数字、不发通知」API。`xSetAppBadge` 成功只表示本端接口调用成功，不保证桌面立刻画出数字。
+
+| 端 | 数字 | 纯红点 | 实际机制 |
+| --- | --- | --- | --- |
+| Android 8+ 原生桌面 | 一般没有，数字在长按菜单里 | 有未读通知就显示圆点 | [Notification badges](https://developer.android.com/develop/ui/views/notifications/badges)，通道需 `setShowBadge(true)` |
+| 小米 / 红米 / HyperOS | 有，跟通知计数走 | 系统设置里可选「仅点 / 数字」，应用侧不能单独指定 | 必须留一条可见通知，并打开应用「桌面角标」。静默 / LOW 通道常常不计数 |
+| 华为 / 荣耀 / OPPO / vivo / 三星 | 厂商接口支持数字 | 看桌面实现 | 走各厂商 ContentProvider / 广播，同时仍发通知作 Android 8+ 兜底 |
+| iOS | 支持 | 没有纯红点，会显示 1 | 需要通知授权（含 badge） |
+| HarmonyOS | 支持 | 没有纯红点，会显示 1 | `notificationManager.setBadgeNumber` |
+| Web | 写在标签标题上闪烁，如 `(5) 标题` | 标题前加 `●` 闪烁 | 改 `document.title`，不是桌面角标 |
+| 微信小程序 | 不支持 | 不支持 | 1008 |
+
+红米还要单独打开「桌面角标」，和通知权限不是一回事：
+
+1. 设置 → 通知管理 → 本应用 → 打开通知
+2. 同一页打开「桌面角标」
+3. 总开关：设置 → 通知与状态栏 → 桌面角标
+
+设置成功后，通知栏会留一条「消息提醒」。这是小米用通知计数画角标，不是失败。
+
+### 调用
+
+```ts
+import {
+  xSetAppIcon,
+  xSetAppBadge,
+  xGetAppIconCapabilities,
+  XSetAppIconOptions,
+  XSetAppBadgeOptions
+} from "@/uni_modules/x-appicon-s"
+
+const caps = xGetAppIconCapabilities()
+
+xSetAppIcon({
+  name: "festival",
+  success: (res) => {
+    console.log(res.name)
+  }
+} as XSetAppIconOptions)
+
+xSetAppBadge({
+  count: 5,
+  success: (res) => {
+    console.log(res.count)
+  }
+} as XSetAppBadgeOptions)
+```
+
+### 预置图标
+
+| name | 说明 |
+| --- | --- |
+| default | 恢复应用原图标 |
+| festival | 节日红金（双 11 风格） |
+| sale | 促销橙 |
+| newyear | 春节红金 |
+
+Android 图标在 `utssdk/app-android/res/mipmap-*`。iOS 图标在 `utssdk/app-ios/Resources/x_appicon_{name}@2x.png` 与 `@3x.png`。
+
+### 方法
+
+| 名称 | 说明 |
+| --- | --- |
+| xSetAppIcon | 切换预置桌面图标。`url` 非空会 fail 1006。Web 改标签页图标和 apple-touch-icon |
+| xResetAppIcon | 恢复默认图标 |
+| xGetAppIcon | 查询当前图标名 |
+| xGetSupportedAppIcons | 可切换图标列表 |
+| xSetAppBadge | 设置角标。`count: 0` 清除；`showDot: true` 尽量只显示红点。Web 写在标签标题上闪烁 |
+| xGetAppBadge | 查询当前角标 |
+| xClearAppBadge | 清除角标 |
+| xGetAppIconCapabilities | 同步返回平台能力 |
+
+### 错误码
+
+| 码 | 含义 |
+| --- | --- |
+| 1001 | 系统错误 |
+| 1002 | 参数错误 |
+| 1004 | 通知 / 角标权限被拒绝 |
+| 1006 | 不支持远程图片作为桌面图标 |
+| 1008 | 当前平台不支持此功能 |
+| 1009 | 未找到 Android 图标别名，需要自定义基座 |
+
+### Android 接入
+
+差异见上文「平台差异说明」。宿主 `AndroidManifest.xml` 必须去掉首页 Activity 的启动入口，只留插件 alias：
+
+```xml
+<activity
+    android:name="io.dcloud.uniapp.UniAppActivity"
+    android:exported="true"
+    tools:node="merge">
+    <intent-filter tools:node="removeAll">
+        <action android:name="android.intent.action.MAIN" />
+        <category android:name="android.intent.category.LAUNCHER" />
+    </intent-filter>
+</activity>
+```
+
+改完后卸载重装。插件 alias：`XAppIconDefault` / `XAppIconFestival` / `XAppIconSale` / `XAppIconNewyear`。
+
+### iOS 说明
+
+本插件走静默切换，不弹系统确认框。
+
+### HarmonyOS 说明
+
+角标走 `notificationManager.setBadgeNumber`。本地 `app.json5 alternateIcons` 从 API 26 才有；上架图标管理需开通 AGC。当前工程 SDK 下切换图标返回 1008。
+
+### Web 说明
+
+浏览器不能改操作系统桌面图标，采用标签站点图标及应用WEBICON切换
+
+## 更新日志
+
+### 1.0.6（2026-08-17）
+
+- 去掉 iOS `showAlert` 参数和演示页「用系统弹层切换」入口，切图标只走静默
+
+### 1.0.5（2026-08-17）
+
+- iOS `Info.plist` 增加 `CFBundleDevelopmentRegion` / `CFBundleLocalizations` / `CFBundleAllowMixedLocalizations`，系统切图标弹层跟随中文
+
+### 1.0.4（2026-08-17）
+
+- iOS 默认静默切换图标，不再弹出系统「已更改图标」；需要官方弹层时传 `showAlert: true`
+
+### 1.0.3（2026-08-17）
+
+- Android：宿主清单去掉 `UniAppActivity` 的 `LAUNCHER`，只留一个 activity-alias，避免桌面出现两个图标、切换只改第二个
+- Android：角标改用可显示通知通道；小米 / 红米 / HyperOS 写入 `extraNotification.setMessageCount`，不再用会被忽略的静默 LOW 通道
+
+### 1.0.2（2026-08-17）
+
+- Web：动态图标改为切换标签页 favicon，并更新 Safari `apple-touch-icon`（主屏幕 / 程序坞大图标）
+- Web：数字角标和小红点改为写在浏览器标签标题上闪烁
+
+### 1.0.1（2026-08-17）
+
+- 修复 HarmonyOS 编译：`catch` 不再标注类型；结果类型里的必填 `boolean` 去掉 `@default`，避免编成 `field!: boolean = false`
+
+### 1.0.0（2026-08-17）
+
+- 新增桌面图标切换：`xSetAppIcon` / `xResetAppIcon` / `xGetAppIcon` / `xGetSupportedAppIcons`
+- 内置节日 / 促销 / 春节三套图标；系统不允许远程图片作为桌面图标
+- 新增桌面角标：`xSetAppBadge` / `xGetAppBadge` / `xClearAppBadge`
+- 覆盖 Android（activity-alias + 厂商角标）/ iOS（Alternate Icon + Badge）/ HarmonyOS（角标）/ Web（Badging API）

package/data/tmui4x/10./346/217/222/344/273/266/345/272/223/xBluetoothS /350/223/235/347/211/231.md"

@@ -0,0 +1,141 @@
+# x-bluetooth-s 蓝牙
+
+对齐微信小程序[蓝牙通用模块](https://developers.weixin.qq.com/miniprogram/dev/api/device/bluetooth/wx.stopBluetoothDevicesDiscovery.html)的 UTS API。函数与类型均加 `x` 前缀，避免与官方同名冲突。一次性接口使用 DCloud `success / fail / complete`。
+
+本插件覆盖适配器初始化、扫描、已发现/已连接设备查询、适配器与设备事件。不包含 BLE 连接、读写特征值等低功耗蓝牙主机接口。
+
+### 兼容性
+
+| Harmony | iOS | Android | WEB | 微信小程序 |
+| --- | --- | --- | --- | --- |
+| 支持 | 支持 | 支持 | 不支持 | 支持 |
+
+微信端走 `wx.*`。Android 使用 `BluetoothLeScanner` + 经典发现，iOS 使用 `CBCentralManager`，HarmonyOS 使用 `@kit.ConnectivityKit` 的 `access` / `ble` / `connection`。扫描会合并后续广播里的设备名，第一包无名时不会把有名结果丢掉。Web 无系统蓝牙通用扫描能力，返回 `fail 10009`。
+
+`xMakeBluetoothPair`、`xIsBluetoothDevicePaired` 支持 Android、iOS、HarmonyOS、微信。Web 返回 `10009`。搜到手机不等于能配对：手机一般不会像耳机那样接受另一台手机的经典配对。
+
+### 调用
+
+```ts
+import {
+  xOpenBluetoothAdapter,
+  xStartBluetoothDevicesDiscovery,
+  xStopBluetoothDevicesDiscovery,
+  xOnBluetoothDeviceFound,
+  xOffBluetoothDeviceFound,
+  xCloseBluetoothAdapter,
+  XBluetoothDevice
+} from "@/uni_modules/x-bluetooth-s"
+
+const foundId = xOnBluetoothDeviceFound((res) => {
+  const list : XBluetoothDevice[] = res.devices
+  console.log(list.length, list[0].deviceId, list[0].RSSI)
+})
+
+xOpenBluetoothAdapter({
+  success: () => {
+    xStartBluetoothDevicesDiscovery({
+      allowDuplicatesKey: false,
+      success: () => {
+        console.log("scanning")
+      }
+    })
+  },
+  fail: (err) => {
+    console.log(err.errCode, err.errMsg, err.state)
+  }
+})
+
+xStopBluetoothDevicesDiscovery({})
+xOffBluetoothDeviceFound(foundId)
+xCloseBluetoothAdapter({})
+```
+
+### 方法
+
+| 名称 | 说明 |
+| --- | --- |
+| xOpenBluetoothAdapter | 初始化蓝牙适配器。其它 API 必须在此之后调用 |
+| xCloseBluetoothAdapter | 关闭适配器并清空搜索缓存 |
+| xGetBluetoothAdapterState | 获取适配器是否可用、是否正在搜索 |
+| xOnBluetoothAdapterStateChange | 监听适配器状态，返回监听 id |
+| xOffBluetoothAdapterStateChange | 移除状态监听；不传 id 则移除全部 |
+| xStartBluetoothDevicesDiscovery | 开始搜索附近蓝牙外围设备 |
+| xStopBluetoothDevicesDiscovery | 停止搜索 |
+| xGetBluetoothDevices | 获取适配器生效期间搜索到的全部设备 |
+| xGetConnectedBluetoothDevices | 按主服务 UUID 获取已连接设备 |
+| xOnBluetoothDeviceFound | 监听新设备，返回监听 id |
+| xOffBluetoothDeviceFound | 移除设备监听；不传 id 则移除全部 |
+| xMakeBluetoothPair | 蓝牙配对。Android / 鸿蒙 / 微信可用 `pin`（Base64）；iOS 走 BLE 连接触发系统配对框，`pin` 无效 |
+| xIsBluetoothDevicePaired | 查询是否已配对。iOS 无法读取系统配对列表，只反映本插件成功配对过或当前已连接 |
+
+### 错误码
+
+对齐微信蓝牙错误码：
+
+| 码 | 含义 |
+| --- | --- |
+| 10000 | 未初始化蓝牙适配器 |
+| 10001 | 当前蓝牙适配器不可用 |
+| 10002 | 没有找到指定设备 |
+| 10008 | 系统错误（含权限被拒绝） |
+| 10009 | 当前平台不支持 |
+| 10012 | 操作超时 |
+| 10013 | 参数无效 |
+
+`xOpenBluetoothAdapter` 失败时 `state` 对齐微信 iOS 状态：`0` 未知 / `1` 重置中 / `2` 不支持 / `3` 未授权 / `4` 未开启。
+
+蓝牙开关关闭时，`xOpenBluetoothAdapter` 仍会完成本地模块初始化，并返回 `10001`。之后可通过 `xOnBluetoothAdapterStateChange` 等待用户打开蓝牙。
+
+### 平台差异
+
+**Android**
+
+- `deviceId` 为 MAC 地址。
+- 扫描需 `BLUETOOTH_SCAN` / `BLUETOOTH_CONNECT`（API 31+）或定位权限（更低版本）。部分机型仍需定位才能扫到设备。
+- `powerLevel`：`low` / `medium` / `high` 对应系统扫描模式。
+
+**iOS**
+
+- `deviceId` 为系统生成的 UUID，不能硬编码。
+- `mode` 仅作兼容参数，本插件按主机模式初始化。
+- 没有经典蓝牙 `createBond`。配对通过连接 BLE 外设并访问需加密特征，由系统弹出配对码/确认框，应用不能注入 PIN。
+- 对端必须是可连接的 BLE 外设。另一台手机的经典可发现记录在 iOS 上扫不到，也无法互配。
+- `xIsBluetoothDevicePaired` 不能读系统配对列表，只记录本插件成功触发过的配对或当前已连接。
+
+**HarmonyOS**
+
+- 需 `ohos.permission.ACCESS_BLUETOOTH`。
+- 扫描走 `ble.startBLEScan`，无服务过滤时同时做经典发现；适配器状态走 `access.getState`。
+- 配对走 `connection.pairDevice`，查询走 `connection.getPairState`。发起配对会先停止搜索，系统会弹确认框。
+- 搜到 iPhone 只说明对方可被发现。iPhone 作为手机一般不接受另一台手机的经典配对，失败时常见对端拒绝或不在线。
+
+**微信小程序**
+
+- 直接转发 `wx.openBluetoothAdapter` 等官方 API。
+- `serviceData` 转为 `{ uuid, data }[]`，便于 UTS 使用。
+
+## 更新日志
+
+### 1.0.4（2026-08-21）
+- iOS 补齐 `xMakeBluetoothPair` / `xIsBluetoothDevicePaired`：通过连接 BLE 外设触发系统配对框，`pin` 无效。
+- iOS 没有经典 `createBond`，配对码由系统弹出；对端必须是可连接且要求加密的 BLE 设备。
+
+### 1.0.3（2026-08-20）
+- 鸿蒙补齐 `xMakeBluetoothPair` / `xIsBluetoothDevicePaired`：走 `connection.pairDevice`、`getPairState`，配对前会先停扫。
+- 搜到 iPhone 仍可能配不上：那是手机互配限制，不是扫描失败。
+
+### 1.0.2（2026-08-20）
+- 扫描名称：第一包常无名，后续广播带名字时会补上并再上报，不再只认第一包。
+- 安卓去掉 `neverForLocation`（会滤掉广播名），并同时做经典蓝牙发现，系统设置里能看到的手机名可以进来。
+- iOS 扫描始终允许重复回调，用 `peripheral.name` 和广播 LocalName 合并。
+- 鸿蒙修正广播 AD 解析与 UTF-8 设备名，并回退 `getRemoteDeviceName` / 经典发现。
+### 1.0.1（2026-08-20）
+- 鸿蒙：带 `@default` 的 boolean 改为 `?:`，保留 iOS 默认值，避免必填字段编成 `!: boolean = false`。
+- 鸿蒙：默认 Options 改为先 `{} as` 再赋值，不再漏写 success / fail / complete。
+
+### 1.0.0（2026-08-16）
+
+- 新增蓝牙通用模块 API，对齐微信 `device/bluetooth` 全部方法
+- 支持 Android / iOS / HarmonyOS / 微信小程序；Web 返回 `10009`
+- `xMakeBluetoothPair` / `xIsBluetoothDevicePaired` 仅 Android / 微信可用

package/data/tmui4x/10./346/217/222/344/273/266/345/272/223/xBlurU /350/203/214/346/231/257/346/257/233/347/216/273/347/222/203.md"

@@ -0,0 +1,65 @@
+# x-blur-u 背景毛玻璃
+
+背景毛玻璃组件，用法接近 `view`。把内容放进默认插槽即可叠在模糊层上。
+
+### 兼容性
+
+| Harmony | IOS | Android | WEB | 小程序 |
+| --- | --- | --- | --- | --- |
+| 支持 | 支持 | 支持 | 支持 | 支持 |
+
+### 调用
+
+```vue
+<view class="blur-top">
+  <x-blur-u class="blur-fill" :blur="20" bgColor="rgba(255,255,255,0.85)">
+    <text>请滚动页面</text>
+  </x-blur-u>
+</view>
+```
+
+```css
+.blur-top {
+  position: fixed;
+  top: 0;
+  left: 0;
+  width: 100%;
+  height: 80px;
+  z-index: 50;
+}
+.blur-fill {
+  width: 100%;
+  height: 100%;
+}
+```
+
+### 参数
+
+| 字段 | 说明 | 默认 |
+| --- | --- | --- |
+| blur | 模糊强度，0~100 | `20` |
+| bgColor | 覆盖色 | `rgba(255,255,255,0.85)` |
+| customStyle | 内部附加样式 | `""` |
+
+默认插槽为模糊层上的内容。改 `blur` / `bgColor` 即更新。
+
+### 事件
+
+无对外事件。
+
+### 方法
+
+无对外方法。
+
+### 平台差异
+
+1. App 三端为原生模糊；Web / 微信为 CSS `backdrop-filter`。
+
+### 版本
+
+版权归https://xui.tmui.design你不得修改及二次开发，仅供TMUI4会员商用使用。不得转给非VIP会员使用，一经查实数倍赔偿，并追究法律责任。
+
+## 更新日志
+
+### 1.0.0（2026-05-20）
+* 5端可用的背景毛玻璃背景模糊插件，使用如view一样简单。