tmui-cli 2.0.0 → 2.0.2

package/data/tmui4x/10./346/217/222/344/273/266/345/272/223/xTipsS /346/266/210/346/201/257/346/217/220/347/244/272.md"

@@ -0,0 +1,86 @@
+# x-tips-s 消息提示
+
+顶部或底部的全局文字提示，不打断当前操作，可自动消失。连续调用会自动关掉上一条。
+
+**微信内使用官方 `uni.showToast`，位置、偏移、自定义图标不生效，仅保留签名。**
+
+### 兼容性
+
+| Harmony | IOS | Android | WEB | 小程序 |
+| --- | --- | --- | --- | --- |
+| 支持 | 支持 | 支持 | 支持 | 支持（官方 Toast） |
+
+### 调用
+
+```ts
+import { showTips, hideTips, XTIPS_TYPE } from "@/uni_modules/x-tips-s"
+
+showTips({
+  title: "顶部提示消息",
+  iconCode: "info",
+  position: "top",
+  offset: 50,
+  duration: 2000
+} as XTIPS_TYPE)
+```
+
+### 方法
+
+| 名称 | 需要 | 说明 |
+| --- | --- | --- |
+| showTips | `XTIPS_TYPE`，`title` 必填 | 弹出顶部或底部提示，连续调用会关掉上一条 |
+| hideTips | 无 | 立刻关闭当前提示 |
+
+### 参数
+
+`XTIPS_TYPE`
+
+| 字段 | 说明 | 默认 |
+| --- | --- | --- |
+| title | 标题，必填 | - |
+| iconCode | Remix 图标 unicode，如 `ED29`；也可用 `warn` / `error` / `success` / `info`。微信不支持 | `F449` |
+| iconColor | 图标颜色 | `rgb(5,121,255)` |
+| iconSize | 图标大小 px | `20` |
+| titleSize | 标题字号 px | `16` |
+| titleColor | 标题色 | `rgb(5,121,255)` |
+| contentBgColor | 内容底色 | `#ffffff` |
+| maskBgColor | 遮罩色 | 透明 |
+| size | 内容宽度 px | `130` |
+| duration | 自动关闭毫秒，`0` 不自动关 | `2000` |
+| position | `top` / `bottom`。微信不支持 | `top` |
+| offset | 距顶/底偏移 px。微信不支持 | `50` |
+| maskDisableClik | 拦截遮罩点击 | `false` |
+| success | 弹出成功 | - |
+| fail | 弹出失败 | - |
+| complete | 调用结束 | - |
+| close | 关闭完成 | - |
+
+### 平台差异
+
+1. 微信小程序：`uni.showToast`，仅 `title`、`duration`、`maskDisableClik`、`close` 生效。
+
+### 版本
+
+版权归https://xui.tmui.design你不得修改及二次开发，仅供TMUI4会员商用使用。不得转给非VIP会员使用，一经查实数倍赔偿，并追究法律责任。
+
+## 更新日志
+
+### 1.1.1（2026-08-14）
+* 配置新增 success / fail / complete 回调，对齐 DCloud 函数风格：弹出成功走 success，失败走 fail，两者之后都会走 complete；原有 close 仍在消失时触发
+### 1.1.0（2026-08-13）
+* 重构为与 x-modal-s 一致的 DCloud 函数风格：showTips(options?) 支持无参调用，五端签名统一
+* 新增微信小程序端降级实现（wx.showToast 对齐 title/duration/close 语义）
+* 性能优化：安卓端 remixicon 字体缓存、代次隔离防止旧定时器关掉新 tips
+* iOS 端修复内容渐显动画被重复添加为缩放动画的问题；hide 后释放视图与回调引用，close 只触发一次
+* web 端修复动画样式因 id 不匹配每次 show 都重复插入 style 标签的问题，字体只加载一次
+### 1.0.4（2026-04-21）
+* 修复可能存在的内存泄露风险
+### 1.0.3（2026-01-30）
+* 使用了sdk4.65+推出的接口来避免与官方的弹层冲突导致无法显示。
+### 1.0.2（2025-07-25）
+*  更新支持鸿蒙原生 Next，采用自己编译的 Har 包来支持
+### 1.0.1（2025-02-23）
+* 更新了动画,并修复了,如果路径页面,上个页面不会自动关闭的问题.
+* ios端添加了显示动画,显示更自然
+### 1.0.0（2024-08-06）
+安卓,ios,web可用。

package/data/tmui4x/10./346/217/222/344/273/266/345/272/223/xToastS /350/275/273/346/217/220/347/244/272.md"

@@ -0,0 +1,98 @@
+# x-toast-s 轻提示
+
+居中弹出的轻提示，用来替代 `uni.showToast`。支持超长文字、自定义图标和颜色，连续调用会自动关掉上一条。
+
+**微信内使用官方 `uni.showToast`，图标、颜色、尺寸等样式字段不生效，仅保留签名。**
+
+### 兼容性
+
+| Harmony | IOS | Android | WEB | 小程序 |
+| --- | --- | --- | --- | --- |
+| 支持 | 支持 | 支持 | 支持 | 支持（官方 Toast） |
+
+### 调用
+
+```ts
+import { showToast, hideToast, XTOAST_TYPE } from "@/uni_modules/x-toast-s"
+
+showToast({
+  title: "保存成功",
+  iconCode: "success",
+  duration: 2000,
+  success: () => {
+    console.log("已弹出")
+  },
+  close: () => {
+    console.log("已关闭")
+  }
+} as XTOAST_TYPE)
+```
+
+### 方法
+
+| 名称 | 需要 | 说明 |
+| --- | --- | --- |
+| showToast | `XTOAST_TYPE`，`title` 必填 | 弹出提示，连续调用会关掉上一条 |
+| hideToast | 无 | 立刻关闭当前提示 |
+
+### 参数
+
+`XTOAST_TYPE`
+
+| 字段 | 说明 | 默认 |
+| --- | --- | --- |
+| title | 标题，必填 | - |
+| iconCode | Remix 图标 unicode，如 `ED29`；也可用 `warn` / `error` / `success` / `info`。微信仅 `success` / `error` / `loading` / `none` | `F449` |
+| iconColor | 图标颜色 | `rgb(5,121,255)` |
+| iconSize | 图标大小 px | `52` |
+| titleSize | 标题字号 px | `14` |
+| titleColor | 标题色 | `rgb(5,121,255)` |
+| contentBgColor | 内容底色 | `#ffffff` |
+| maskBgColor | 遮罩色 | `rgba(0,0,0,0.6)` |
+| size | 内容宽度 px | `130` |
+| duration | 自动关闭毫秒，`0` 不自动关 | `2000` |
+| maskDisableClik | 拦截遮罩点击。微信映射为 `mask` | `true` |
+| success | 弹出成功 | - |
+| fail | 弹出失败 | - |
+| complete | 调用结束 | - |
+| close | 关闭完成 | - |
+
+### 平台差异
+
+1. 微信小程序：`uni.showToast`，仅 `title`、`duration`、`maskDisableClik` 生效；自定义图标码降级为 `none`。
+
+### 版本
+
+版权归https://xui.tmui.design你不得修改及二次开发，仅供TMUI4会员商用使用。不得转给非VIP会员使用，一经查实数倍赔偿，并追究法律责任。
+
+## 更新日志
+
+### 1.1.1（2026-08-14）
+* 配置新增 success / fail / complete 回调，对齐 DCloud 函数风格：弹出成功走 success，失败走 fail，两者之后都会走 complete；原有 close 仍在消失时触发
+### 1.1.0（2026-08-13）
+* 重构为与 x-modal-s 一致的 DCloud 函数风格：showToast(options?) 支持无参调用，五端签名统一
+* 性能优化：安卓端 remixicon 字体缓存（不再每次 show 都读磁盘）、代次隔离防止旧定时器关掉新 toast、Activity 销毁时自动释放弹层防泄漏
+* iOS 端 hide 后释放视图与回调引用，close 回调保证只触发一次
+* web 端修复动画样式因 id 不匹配每次 show 都重复插入 style 标签的问题，字体只加载一次
+* 微信端 options 允许为空，iconCode 非内置图标时自动降级为 none
+### 1.0.8（2026-04-21）
+* 修复可能存在的内存泄露风险
+### 1.0.7（2026-01-30）
+* 使用了sdk4.65+推出的接口来避免与官方的弹层冲突导致无法显示。
+### 1.0.6（2025-08-17）
+* 兼容原生鸿蒙
+### 1.0.5（2025-04-13）
+* xToast在安卓,ios,web布局已更新为宽自动,并设定最大宽(之前宽是固定),方便在平板手机内容超多时自动断行及限定最大宽
+* 在安卓端并且会自动隐藏状态栏,并可以覆盖底部安全区域,还可以覆盖住官方的diaglo-page,做到真正的全覆盖
+* 补上close事件
+### 1.0.4（2025-02-23）
+* 安卓端重新设定了动画参数,让打开显示的更自然.同时关闭逻辑改成了:当页面卸载或者超时跳转页面时,不会自动关闭上页的问题.
+* ios端添加了显示动画,显示更自然
+### 1.0.3（2025-02-13）
+* 兼容微信
+### 1.0.2（2024-09-12）
+* 增加了maskDisableClik事件穿透,false表示允许穿透默认是true禁止事件穿透遮罩.
+### 1.0.1（2024-09-06）
+* 更新支持Uniapp
+### 1.0.0（2024-08-06）
+安卓,ios,web可用。

package/data/tmui4x/10./346/217/222/344/273/266/345/272/223/xUdpS UDP/351/200/232/344/277/241.md"

@@ -0,0 +1,204 @@
+# x-udp-s UDP通信
+
+局域网 UDP 客户端 / 服务端。一个 `xUdp` 实例就是一个 socket，既能 `bind` 固定端口收包当服务端，也能 `send` 单播 / 广播当客户端。自带应用层分段重组、CRC32 校验、单播缺片重传、指纹 + HMAC-SHA256 验签，回调都在主线程。
+
+### 兼容性
+
+| Harmony | iOS | Android | WEB | 微信小程序 |
+| --- | --- | --- | --- | --- |
+| 支持 | 支持 | 支持 | 不支持 | 支持 |
+
+标准浏览器没有原始 UDP（MDN 无 `UDPSocket`，WebTransport 只能连 HTTP/3 服务），Web 端所有方法固定 `fail 1008`，只保留契约占位。真机联调请用「微信小程序 ↔ 手机 App」，两端连同一个 Wi-Fi。
+
+### 调用
+
+```ts
+import { xUdp, XUdpBindResult, XUdpEvent, XUdpFailInfo } from "@/uni_modules/x-udp-s"
+
+const udp = new xUdp()
+
+udp.addEventListener("message", (e : XUdpEvent) => {
+  // e.address / e.port 是数据报源地址，回连以它为准
+  if (e.encoding == "binary") {
+    console.log(e.buffer.byteLength, e.address, e.port)
+    return
+  }
+  console.log(e.data, e.address, e.port, e.verified, e.segmentCount)
+})
+udp.addEventListener("progress", (e : XUdpEvent) => {
+  console.log(e.receivedBytes, e.totalBytes)
+})
+udp.addEventListener("error", (e : XUdpEvent) => {
+  console.log(e.errCode, e.errMsg)
+})
+
+udp.bind({
+  port: 38400,
+  broadcast: true,
+  auth: { enable: true, fingerprint: "dev-a", secret: "shared-secret" },
+  frame: { segmentSize: 1024, assembleTimeout: 30000, maxMessageBytes: 16777216, retry: 3 },
+  success: (res : XUdpBindResult) => {
+    console.log(res.port, res.localip, res.addresses)
+  },
+  fail: (err : XUdpFailInfo) => {
+    console.log(err.errCode, err.errMsg)
+  }
+})
+
+// 广播发现（utf8 文本）
+udp.send({ address: "255.255.255.255", port: 38400, data: "{\"t\":\"discover\"}" })
+// 已有 base64 字符串仍可走 encoding: "base64"，收端 e.data 原样交回
+udp.send({ address: "192.168.1.23", port: 38400, data: base64, encoding: "base64" })
+// 文件：只传路径和编码，插件在各端入口读文件
+udp.send({
+  address: "192.168.1.23",
+  port: 38400,
+  filePath: path,
+  fileName: "font.ttf",
+  encoding: "binary"
+})
+
+udp.close()
+udp.destroy()
+```
+
+### 实例方法
+
+| 名称 | 说明 |
+| --- | --- |
+| bind | 绑定端口开始收包，成功回带实际端口、优选局域网 IP 与全部网卡 |
+| send | 发送完整消息，超过 `segmentSize` 自动分段 |
+| applyAuth | 运行时改验签配置 |
+| applyFrame | 运行时改分段配置 |
+| getLocalAddresses | 枚举本机 IPv4，未 bind 也能调 |
+| getBoundAddress | 返回当前监听端口与优选 IP |
+| addEventListener | 登记事件，返回可用于移除的 id |
+| removeEventListener | 按 id 移除 |
+| getState | `idle` / `listening` / `closed` / `error` |
+| close | 关闭 socket，保留监听器 |
+| destroy | 关闭并清空监听器 |
+
+模块级还导出 `xGetLocalAddresses(options)`，不需要先 bind。
+
+### 事件
+
+`listening` / `message` / `progress` / `error` / `close`，载荷统一是扁平的 `XUdpEvent`，按类型取字段：
+
+- `listening`：`port`
+- `message`：`data`、`buffer`、`encoding`、`address`、`port`、`verified`、`fingerprint`、`totalBytes`、`segmentCount`
+- `progress`：`msgId`、`receivedBytes`、`totalBytes`、`segmentCount`、`address`、`port`
+- `error`：`errCode`、`errMsg`，可能带 `address` / `port` / `msgId`
+- `close`：`port`
+
+### 大消息：这不是 TCP 粘包
+
+UDP 是数据报协议，一次 `recv` 就是一次 `send` 的完整报文，内核按 UDP 头的 length 切边界，不存在粘包。传大数据要处理的是另一件事：**应用层主动分段与重组（SAR）**。
+
+本插件的 XUDP v1 帧头是 ASCII 定序字段，用 `|` 分隔，载荷是第 12 个 `|` 之后的全部内容，所以载荷里出现 `|` 不会破坏解析：
+
+```text
+XUDP1|kind|flags|enc|msgId|totalLen|offset|len|crc|mcrc|sig|fp|payload
+```
+
+- 每个 UDP 数据报只承载一条 segment，绝不把多条业务消息塞进同一个数据报
+- `segmentSize` 钳在 `256..1400`，默认 `1024`，一段必须小于 MTU，禁止依赖 IP 分片
+- 收端按 `msgId + offset` 重组，覆盖完 `[0, totalLen)` 且末段标记到齐、整包 CRC 通过，才触发一次 `message`
+- 单播发现空洞会向来源发 NACK，发送方最多重传 `retry` 次；广播不重传。FIN 丢了也会在空闲后主动要缺片，不只靠 `assembleTimeout`
+- `assembleTimeout` 是空闲超时（默认 30s），不是整包传输总时长
+- `maxMessageBytes` 默认 16MB（binary 按原始字节），钳位到 64MB。这是防整包进内存撑爆的天花板，不是 UDP 限制；5MB 字体直接发即可，更大的在 `bind` 时把 `maxMessageBytes` 调高
+- `encoding` 为 `utf8` 时单段字符预算按 1/3 取值，避免多字节字符撑破 MTU
+- `encoding` 为 `binary` 时优先传 `filePath`（插件读文件）；也可以直接传 `buffer`。收端从 `e.buffer` 取，`e.data` 为空串。带 `fileName` / `filePath` 时收端 `e.fileName` 有值。`totalBytes` 按原始字节计。线上为了走现有文本成帧，载荷仍是该段字节的 base64（帧头 `enc=n`），调用方不用自己编解码
+- `encoding` 为 `base64` 时：调用方已经是 base64 文本，收端 `e.data` 原样交回，不自动转 ArrayBuffer
+
+### 验签：应用层指纹 + HMAC，不是 DTLS
+
+`auth.enable` 打开后，发送方对 `msgId + totalLen + messageCrc + fingerprint` 的规范串做 HMAC-SHA256 并随帧发出，收端用同一 `secret` 复算。签名只覆盖这段短摘要，整包完整性由 CRC-32 承担——大文件在 Android / iOS 上按 Double 语义跑 SHA-256 代价过高。
+
+`allowFingerprints` 非空时只接受列表内的对端。验签不通过按 `1012` 丢弃并抛 `error`。报文本身是明文，不做 DTLS（鸿蒙 TLS 只覆盖 TCP）。
+
+### 本机 IP：发现必须自己报送
+
+`bind(0.0.0.0)` 只表示听所有网卡，不会告诉别人「该连哪个 IP」。所以设备发现要同时用两条地址：
+
+1. **数据报源地址**：`XUdpEvent.address / port`，回包用这个最准，不要信对端自称的 IP
+2. **本机优选局域网 IP**：`bind` 成功回带的 `localip`，写进自己的 announce 报文
+
+插件自己枚举网卡：只报 IPv4，跳过 loopback / 未启用 / 链路本地；优选顺序为 `wlan*` / `wifi` / `en0` > 其它非虚拟网卡 > 第一个可用地址。身份唯一键是 `fingerprint`，不是 IP——局域网 IP 会变，只作可达地址。
+
+### 在线状态：应用层心跳
+
+UDP 无连接，没有「保持连接」这回事。在线是用周期性数据报 + 超时模拟的：客户端广播 `discover`，服务端单播 `announce`；之后服务端按间隔发 `ping`，客户端回 `pong` 或 `report`，超时没应答就标离线。一方主动关闭时应再发一帧 `bye`，对端立刻标离线，不要只靠超时。这些 `type` 是业务约定，走普通 `send`，插件本身只管 socket。
+
+### 错误码
+
+`1001` 系统错误，`1002` 参数错误，`1004` 权限被拒绝，`1008` 当前平台不支持，`1011` 密钥无效，`1012` 验签失败，`1013` 尚未 bind，`1014` 重组超时，`1015` 校验和不一致，`1016` 消息超过上限，`1017` 缺片重传耗尽。
+
+### 平台差异
+
+**Android**
+
+- `DatagramSocket` 收发，收包在后台线程，事件 post 回主线程。
+- 发送走每 socket 一条单线程队列，段间隔约 1.5ms，并把 `SO_SNDBUF` / `SO_RCVBUF` 提到 1MB。不限速时大文件（两千多段）会把对端内核 UDP 缓冲打满，进度停在一半左右。
+- 网卡走 `NetworkInterface` 枚举。
+- 需 `INTERNET`、`ACCESS_NETWORK_STATE`、`ACCESS_WIFI_STATE`、`CHANGE_WIFI_MULTICAST_STATE`。
+
+**iOS**
+
+- BSD socket（`socket` / `bind` / `sendto` / `recvfrom`）。没用 Network.framework 收发：`NWListener` 会给每个对端派生独立 `NWConnection`，而这里要的是「一个 socket 同时收所有来源 + 发广播」，POSIX 语义更直接。
+- 网卡走 `getifaddrs`，收包线程与事件回调都 hop 回主线程。socket 绑到 Wi-Fi 网卡（`IP_BOUND_IF`），避免广播从蜂窝出去变成 `errno 65`。
+- 发送走每 socket 一条后台串行队列：`sendText` 入队即返回，`sendto` 在后台跑、段间隔约 1.2ms，避免并发打满线程、对端收不齐。`SO_SNDBUF` / `SO_RCVBUF` 提到 1MB。
+- 成帧 / Base64 / 整包 CRC / 收包重组在主线程 session 完成（不再像 1.0.3 那样搬后台队列，避免共享状态竞态），但重活都是原生：整包 CRC 走原生 Swift 查表、Base64 走 `uni.arrayBufferToBase64`。发文件时各端 `index.uts` 自己读文件，不要把拼接/切片做成插件公共函数。
+- 发 `255.255.255.255` 时同时打各网卡定向广播（如 `192.168.1.255`），iOS 对有限广播经常直接失败。
+- 需 `NSLocalNetworkUsageDescription` 与 `NSBonjourServices`（`_xudp._udp`）。纯 BSD 收发不会弹本地网络授权，`bind` 时会起一个 `NWBrowser` 把系统弹窗拉出来。首次请点「允许」，设置里也可再开「本地网络」。
+
+**HarmonyOS**
+
+- `@kit.NetworkKit` 的 `socket.constructUDPSocketInstance`。
+- 发送分帧后按批限速交给 `udp.send`（每批 4 帧、批间隔 5ms，约 800 段/秒）：入队即返回，绝不在主线程同步打数千个 `udp.send`。`receiveBufferSize` / `sendBufferSize` 提到 1MB。当客户端发 3.6MB（两三千段）不再打爆缓冲或闪退。
+- 整包 / 分段 CRC 走原生 ArkTS 查表（`XUdpHarmonyNative.crc32Hex`），与 UTS / iOS 的 CRC-32/ISO-HDLC 完全一致；避免 UTS 在主线程对 4MB+ base64 逐字符算导致卡死。
+- `bind` 不支持端口 0 自动分配，传 0 时由插件取一个高位随机端口。
+- 需 `ohos.permission.INTERNET`、`ohos.permission.GET_NETWORK_INFO`。宿主 `entry/module.json5` 也应声明。
+
+**微信小程序**
+
+- `wx.createUDPSocket`，广播由每次 `send` 的 `setBroadcast` 打开；本机 IP 走 `wx.getLocalIPAddress`。
+- 基础库 2.9.0+ 才支持 `255.255.255.255`；单个数据报需小于 4096，所以默认 `segmentSize` 1024。
+- 不能对本机 IP 发包，必须两台设备联调。
+
+**Web**
+
+- 无原始 UDP，`bind` / `send` / `getLocalAddresses` 一律 `fail 1008`；`addEventListener` 可登记但不触发，`getState()` 固定 `idle`。
+
+### 版本
+
+版权归 https://xui.tmui.design 你不得修改及二次开发，仅供 TMUI4 会员商用使用。不得转给非 VIP 会员使用，一经查实数倍赔偿，并追究法律责任。
+
+## 更新日志
+
+### 1.0.4（2026-08-18）
+* `send` 支持 `filePath` + `encoding`（binary / utf8 / base64）：各端 `index.uts` 自己读文件，不再导出拼接/切片公共函数。收端 `event.fileName` 带文件名。
+* 修复 iOS 选文件发送闪退：插件内不能调 `uni.getFileSystemManager()`。iOS 改为 `UTSiOS.convert2AbsFullPath` + 原生 `Data(contentsOf:)` / `ArrayBuffer.fromData`。
+* `xUdpConcatBuffers` / `xUdpSliceBuffer` 不再作为插件公共 API：iOS `?uts-proxy` 不认再导出，Android 整包也会 `找不到名称`。
+* 修复 HarmonyOS 当客户端发 3.6MB 文件闪退：整包 / 分段 CRC 改走原生 ArkTS 查表（`XUdpHarmonyNative.crc32Hex`），分帧按批限速（每批 4 帧、间隔 5ms，约 800 段/秒）交给 `udp.send`，`receiveBufferSize` / `sendBufferSize` 提到 1MB。
+* 撤掉 1.0.3 的「iOS session 全量搬后台队列」——共享状态在多队列下有竞态。session 回主线程，只有原生 `sendto` 在后台串行队列限速；整包 CRC 仍走原生 Swift，`xUdpConcatBuffers` / `xUdpSliceBuffer` 用 `Uint8Array.set` / `ArrayBuffer.slice` 整段拷贝，不逐字节。
+* 三端发送对齐为「主线程成帧（原生 CRC + 原生 Base64）+ 原生异步限速发」，收包都在原生后台线程重组回主线程，`SO_SNDBUF` / `SO_RCVBUF` 均 1MB；无论做服务端还是客户端，收发大文件走同一条路径。
+
+### 1.0.3（2026-08-18）
+* 修复 iOS 发 3MB+ 文件主线程卡死：整包 CRC 走原生 Swift，重组用 `join` 代替反复 `+=`。（本版一度把整个 session 搬到后台队列，1.0.4 已回退为主线程 session。）
+
+### 1.0.2（2026-08-18）
+* 修复 Android 大文件只收到一半：发送限速 1.5ms/段，并加大 socket 收发缓冲。
+* FIN 丢失时也会在空闲后主动 NACK 要缺片，不再干等到重组超时。
+
+### 1.0.1（2026-08-18）
+* `send` 新增 `encoding: "binary"` 与 `buffer: ArrayBuffer`，`readFile` 不传 encoding 的二进制可直接发出。
+* `message` 事件增加扁平字段 `buffer`；binary 时 `data` 为空串，`totalBytes` 按原始字节计。
+* 仍兼容 `utf8` / `base64` 字符串发送。
+* 默认 `maxMessageBytes` 提到 16MB（最大可配 64MB），演示页不再按 1MB 提前拦截；`assembleTimeout` 默认 30s。
+
+### 1.0.0（2026-08-17）
+* 新增 x-udp-s：局域网 UDP 客户端 / 服务端，多实例，回调主线程。
+* 应用层 SAR 分段重组（XUDP v1 成帧）、段与整包 CRC32、单播缺片 NACK 重传。
+* 指纹 + HMAC-SHA256 应用层验签，支持 allowFingerprints 白名单。
+* 插件自带本机 IPv4 网卡枚举，bind 成功回带 localip 与全部地址。
+* Android / iOS / HarmonyOS / 微信小程序为真实现；Web 无原始 UDP，统一 fail 1008。

package/data/tmui4x/10./346/217/222/344/273/266/345/272/223/xUtilsS Base64/344/270/216/346/226/207/344/273/266/344/272/222/350/275/254.md"

@@ -0,0 +1,83 @@
+# x-utils-s Base64与文件互转
+
+Base64、ArrayBuffer、本地文件互转。由原 `x-base64toarraybuff-s`、`x-base642file-s` 合并，接口改为 DCloud 风格 `success / fail / complete`。
+
+### 兼容性
+
+| Harmony | IOS | Android | WEB | 小程序 |
+| --- | --- | --- | --- | --- |
+| 支持 | 支持 | 支持 | 支持 | 支持 |
+
+### 调用
+
+```ts
+import { base64ToArrayBuffer, arrayBufferToBase64, base64ToFile } from "@/uni_modules/x-utils-s"
+
+base64ToArrayBuffer({
+  base64: "SGVsbG8gV29ybGQ=",
+  success: (res) => {
+    console.log(res.data.byteLength)
+  }
+})
+
+arrayBufferToBase64({
+  arrayBuffer: res.data,
+  success: (out) => {
+    console.log(out.base64)
+  }
+})
+
+base64ToFile({
+  base64: "data:image/png;base64,iVBORw0KGgo...",
+  fileName: "demo.png",
+  success: (file) => {
+    console.log(file.tempFilePath, file.size)
+  },
+  fail: (err) => {
+    console.log(err.errCode, err.errMsg)
+  }
+})
+```
+
+### 方法
+
+| 名称 | 说明 |
+| --- | --- |
+| base64ToArrayBuffer | Base64 转 ArrayBuffer，支持 `data:` 前缀 |
+| arrayBufferToBase64 | ArrayBuffer 转 Base64 |
+| base64ToFile | Base64 写入缓存文件。Web 返回 blob URL |
+
+### base64ToFile
+
+| 字段 | 说明 |
+| --- | --- |
+| base64 | 必填，纯 Base64 或 data URI |
+| fileName | 可选。不传则按 mime 生成 `x-utils-时间戳.ext` |
+
+成功结果：`tempFilePath`、`size`、`name`、`mimeType`。
+
+- Android / Harmony：应用缓存目录 `x-utils/`
+- iOS：应用 Caches
+- 微信：`wx.env.USER_DATA_PATH`
+- Web：`blob:` 地址
+
+不再强制重编码为 PNG，按原始字节落盘，扩展名跟 data URI 的 mime 走。
+
+### 错误码
+
+| 码 | 含义 |
+| --- | --- |
+| 1001 | 系统错误 |
+| 1002 | 参数错误 |
+| 1009 | 转换或写入失败 |
+
+### 版本
+
+版权归 https://xui.tmui.design 你不得修改及二次开发，仅供 TMUI4 会员商用使用。不得转给非 VIP 会员使用，一经查实数倍赔偿，并追究法律责任。
+
+## 更新日志
+
+### 1.0.0（2026-08-16）
+* 合并原 x-base64toarraybuff-s、x-base642file-s
+* 统一为 DCloud 风格 success / fail / complete
+* 提供 base64ToArrayBuffer、arrayBufferToBase64、base64ToFile

package/data/tmui4x/10./346/217/222/344/273/266/345/272/223/xVibrateS /351/234/207/345/212/250.md"

@@ -0,0 +1,115 @@
+# x-vibrate-s 震动
+
+设备震动，对齐 DCloud `success / fail / complete` 函数式调用。
+
+### 兼容性
+
+| Harmony | iOS | Android | WEB | 微信小程序 |
+| --- | --- | --- | --- | --- |
+| 支持 | 支持 | 支持 | 部分支持 | 支持 |
+
+### 调用
+
+```ts
+import { vibrate, vibrateShort, vibrateLong, XVibrateOptions } from "@/uni_modules/x-vibrate-s"
+
+vibrate({
+  duration: 50,
+  type: "medium",
+  success: (res) => {
+    console.log(res.errMsg)
+  },
+  fail: (err) => {
+    console.log(err.errCode, err.errMsg)
+  }
+} as XVibrateOptions)
+
+vibrateShort({ type: "light" } as XVibrateOptions)
+vibrateLong({} as XVibrateOptions)
+```
+
+旧写法 `vibrator(50)` 已移除，请改为 `vibrate({ duration: 50 })`。
+
+### 方法
+
+| 名称 | 说明 |
+| --- | --- |
+| vibrate | 自定义时长震动，默认 15ms |
+| vibrateShort | 短震动，约 15ms，`type` 生效 |
+| vibrateLong | 长震动，约 400ms |
+
+### 参数
+
+`XVibrateOptions`
+
+| 字段 | 说明 | 默认 |
+| --- | --- | --- |
+| duration | 时长 ms，仅 `vibrate` 使用，范围 1–10000 | 15 |
+| type | `light` / `medium` / `heavy` | medium |
+| success | 成功 | - |
+| fail | 失败 | - |
+| complete | 结束，成功带结果，失败为 null | - |
+
+错误码：`1001` 系统错误，`1002` 参数错误，`1003` 设备无震动器，`1004` 权限被拒绝，`1008` 当前平台不支持。
+
+### 平台差异
+
+**Android**
+
+- 需 `android.permission.VIBRATE`（普通权限，无需运行时申请）。
+- API 21–25：`Vibrator.vibrate(long)`，忽略 `type`。
+- API 26+：`VibrationEffect.createOneShot`；有振幅控制时 `light=64`、`medium=160`、`heavy=255`。
+- API 31+：通过 `VibratorManager.getDefaultVibrator()` 取马达，低版本仍走 `VIBRATOR_SERVICE`。
+
+**iOS**（deploymentTarget 12）
+
+- 短震动：`UIImpactFeedbackGenerator`（iOS 10+ 即有；本插件最低 12）。
+- `impactOccurred(intensity:)` 仅 iOS 13+。
+- 自定义时长 / 长震动：iOS 13+ 且 `CHHapticEngine.supportsHaptics` 时用连续触感；否则一次系统震动，时长无法精确控制。
+- 不再使用 `Thread.sleep` 循环挡线程。
+
+**HarmonyOS**
+
+- 已去掉本地 HAR，直接使用 `@kit.SensorServiceKit` 的 `vibrator.startVibration`。
+- 需声明 `ohos.permission.VIBRATE`（普通权限，安装授予）。宿主 `entry/module.json5` 也应声明，不要只写在 HAR。
+- 按官方开发指导：`type: 'time'` + `{ id: 0, deviceId: -1, usage: 'alarm' }` + callback。新系统 NAPI 会读 `deviceId`，缺了会 `Vibrate time failed, ret:-1`。
+- 短震在鸿蒙最短 50ms（15ms 会被马达拒绝）；`type` 不区分强度。失败时再试 `deviceId: 0` 和 `haptic.clock.timer`。
+- 错误：201→1004，401→1002，801→1003，14600101→1001；fail.errMsg 带原生错误码。
+
+**Web**
+
+- `navigator.vibrate`。Safari iOS 等不支持时 `fail 1008`。忽略 `type`。
+
+**微信小程序**
+
+- 短震动走 `wx.vibrateShort({ type })`。
+- 长震动或 `duration >= 400` 走 `wx.vibrateLong`。
+- 不支持精确自定义时长。
+
+### 版本
+
+版权归 https://xui.tmui.design 你不得修改及二次开发，仅供 TMUI4 会员商用使用。不得转给非 VIP 会员使用，一经查实数倍赔偿，并追究法律责任。
+
+## 更新日志
+
+### 1.1.4（2026-08-16）
+* 鸿蒙：VibrateAttribute 补 `deviceId`（系统日志 `Can not find deviceId property` 会导致 time 振动 ret:-1）；短震最短 50ms；失败再试 `haptic.clock.timer`。
+### 1.1.3（2026-08-16）
+* 鸿蒙按官方开发指导重写：`startVibration` 使用 callback、`id: 0`、`usage: 'alarm'`、`type: 'time'`；UTS/ETS 用 JSON 回传，避免错误码丢失成 1001 系统错误。
+### 1.1.2（2026-08-16）
+* 鸿蒙震动：`usage` 不再用 `unknown`（触感开关关闭会 14600101→1001）。时长走 `notification`/`alarm`，短震预设先探测再回退 time。
+### 1.1.1（2026-08-16）
+* 鸿蒙 fail.errMsg 改为必填字符串，避免 string | undefined
+### 1.1.0（2026-08-16）
+* 改为 DCloud 函数式 API：`vibrate` / `vibrateShort` / `vibrateLong`，支持 success / fail / complete。
+* 鸿蒙去掉本地 HAR，按系统 `SensorServiceKit.vibrator` 重写。
+* Android 按 API 21/26/31 分支取马达与振幅；iOS 12 以下时长忽略，13+ 用 Core Haptics，去掉线程空转。
+### 1.0.3（2025-07-25）
+* 兼容原生鸿蒙
+### 1.0.2（2025-04-13）
+* IOS端现在支持指定震动频率.
+### 1.0.1（2025-02-10）
+* 兼容微信
+### 1.0.0（2024-06-01）
+使用手机震动
+安卓,ios支持。

package/data/tmui4x/10./346/217/222/344/273/266/345/272/223/xWebviewU /346/267/267/345/220/210WebView.md"

@@ -0,0 +1,93 @@
+# x-webview-u 混合WebView
+
+混合开发 WebView。可加载网页，也可通过 `getManager()` 安装、打开本地小程序包。完整混合方案见 [开发文档](https://xui.tmui.design/70.混合开发/01.关于.html)。
+
+### 兼容性
+
+| Harmony | IOS | Android | WEB | 小程序 |
+| --- | --- | --- | --- | --- |
+| 支持 | 支持 | 支持 | 支持 | 不支持 |
+
+### 调用
+
+```vue
+<x-webview-u ref="wbRef" src="https://x-ui.design" :progressChanged="onProgress" @pageFinish="onFinish"></x-webview-u>
+```
+
+```ts
+wbRef.value?.loadUrl("https://x-ui.design")
+wbRef.value?.navback()
+wbRef.value?.refresh()
+
+const manager = wbRef.value?.getManager()
+manager?.checkAppInstall("tmui.app.hybrid").then((res) => {
+  if (res == null) {
+    manager.installApp(appinfo, null).then((ok) => {
+      if (ok) manager.openMiniProgramHostUrl("tmui.app.hybrid")
+    })
+  } else {
+    manager.openMiniProgramHostUrl("tmui.app.hybrid")
+  }
+})
+```
+
+### 参数
+
+| 字段 | 说明 | 默认 |
+| --- | --- | --- |
+| src | 加载地址 | `https://x-ui.design` |
+| width / height | 尺寸 | `100%` |
+| schema | App 唤起协议白名单 | `[]` |
+| allowLoadUrl | 外链是否放行。iOS 不支持 | 放行 |
+| allowLoadUrlWhite | 外链白名单 | `[]` |
+| showLoadProgress | 进度条 | `false` |
+| loadProgressColor | 进度条颜色 | 主题色 |
+| progressChanged | 加载进度 0~100 | - |
+| callMethod | Web 调宿主 | - |
+| webConfig | 注入 Web 的配置 | `{ sign: 'tmuiJssdk' }` |
+
+### 事件
+
+| 名称 | 参数 | 说明 |
+| --- | --- | --- |
+| init | 无 | 原生视图初始化完成 |
+| pageStart | 当前 url | 开始加载页面 |
+| pageFinish | 当前 url | 页面加载完成 |
+| pageError | 错误信息 | 页面加载失败 |
+| contentheightchange | 内容高度 | 网页内容高度变化 |
+| postMessage | `{ detail: string }` | 网页向宿主发消息 |
+| donwload | `{ url, userAgent, contentDisposition, mimeType, contentLength }` | 触发下载。iOS 14.5+ |
+
+### 方法
+
+| 名称 | 需要 | 说明 |
+| --- | --- | --- |
+| loadUrl | `url: string` | 加载指定地址 |
+| navback | 无 | 后退一页 |
+| forward | 无 | 前进一页 |
+| refresh | 无 | 刷新当前页 |
+| clearCache | 无 | 清除 WebView 缓存 |
+| setUserAgent | `ua: string` | 设置 User-Agent |
+| getUserAgent | 无 | 返回 Promise，当前 User-Agent |
+| evaJs | `jsCode: string` | 执行网页 JS。Android 返回结果，其它端为 `null` |
+| getManager | 无 | 返回小程序管理器，可 `checkAppInstall` / `installApp` / `openMiniProgramHostUrl` |
+
+### 平台差异
+
+1. 无微信实现。Web 为 iframe。
+2. `allowLoadUrl` 拦截 iOS 不支持。
+3. `evaJs`：Android 返回执行结果；其它端为 `null`。
+4. `donwload`：iOS 14.5+。
+
+### 版本
+
+版权归https://xui.tmui.design你不得修改及二次开发，仅供TMUI4会员商用使用。不得转给非VIP会员使用，一经查实数倍赔偿，并追究法律责任。
+
+## 更新日志
+
+### 1.0.2（2026-05-20）
+* 重要更新，三个平台添加的相机和视频声音录制权限。请参考demo实现在网页上直接录制视频抓拍功能。
+### 1.0.1（2026-03-26）
+* 【重要优化】x-webview-u,适配了web端，通过打补丁式引入额外的tmuiJssdkWebPack1.0.0.js来支持web端，即web套web。
+### 1.0.0（2026-02-01）
+* 首次发布webview混合开发插件，三端app支持：鸿蒙，安卓，ios