tmui-cli 2.0.0 → 2.0.2

package/data/tmui4x/10./346/217/222/344/273/266/345/272/223/xCryptoS /345/212/240/350/247/243/345/257/206.md"

@@ -0,0 +1,212 @@
+# x-crypto-s 加解密
+
+### 开发文档
+[TMUI4.0文档](https://xui.tmui.design/)
+[TMUI4.0组件库](https://ext.dcloud.net.cn/plugin?id=16369)
+
+加密插件
+
+### 说明
+这是tmui4.0|XUI的原生插件附赠插件，提供了多种加密算法的实现，包括MD5、Base64、SHA系列、AES、DES、RSA、RC4 以及国密 SM2/SM3/SM4。国际算法与 CryptoJS 对齐；国密默认与 sm-crypto / 微信小程序对齐，五端可交叉加解密和验签。
+
+### 兼容性
+
+| Harmony | IOS | Android | WEB | 小程序 |
+| --- | --- | --- | --- | --- |
+| 支持 | 支持 | 支持 | 支持 | 支持 |
+
+### API说明
+
+#### MD5加密
+```ts
+function md5(str: string): string
+```
+- 参数：
+  - str: 待加密的字符串
+- 返回值：MD5加密后的字符串
+
+#### Base64编解码
+```ts
+function base64Encode(str: string): string
+function base64Decode(str: string): string
+```
+- 参数：
+  - str: 待编码/解码的字符串
+- 返回值：Base64编码/解码后的字符串
+- 注意：在Web端加密中文字符时，需要先使用encodeURI处理
+
+#### SHA系列加密
+```ts
+function sha256(str: string): string
+function sha512(str: string): string
+function sha1(str: string): string
+function hmacSha256(key: string, data: string): string
+function hmacSha512(key: string, data: string): string
+```
+- 参数：
+  - str/data: 待加密的字符串
+  - key: HMAC加密的密钥
+- 返回值：对应算法加密后的字符串
+
+#### AES加密
+```ts
+function aesEncrypt(key: string, data: string, mode: string = "ECB", iv: string|null = null, keySize: number|null = null): string
+function aesDecrypt(key: string, data: string, mode: string = "ECB", iv: string|null = null, keySize: number|null = null): string
+```
+- 参数：
+  - key: 加密密钥（UTF-8字符串，根据keySize截取和补足）
+  - data: 待加密/解密的数据（base64字符串）
+  - mode: 加密模式，支持ECB和CBC
+  - iv: 初始化向量
+  - keySize: 密钥长度（16=128位, 24=192位, 32=256位）
+- 返回值：加密(经过base64字符串)/解密后的字符串
+
+#### DES加密
+```ts
+function desEncrypt(key: string, data: string, mode: string = "ECB", iv: string|null = null): string
+function desDecrypt(key: string, data: string, mode: string = "ECB", iv: string|null = null): string
+```
+- 参数：
+  - key: 加密密钥
+  - data: 待加密/解密的数据
+  - mode: 加密模式，支持ECB和CBC
+  - iv: 初始化向量
+- 返回值：加密/解密后的字符串
+
+#### RSA加密
+```ts
+function generateRSAKeyPair(keySize: number = 2048): RSARANDOMKEY
+function rsaEncrypt(publicKey: string, data: string): string
+function rsaDecrypt(privateKey: string, data: string): string
+```
+- 参数：
+  - keySize: RSA密钥长度
+  - publicKey: 公钥
+  - privateKey: 私钥
+  - data: 待加密/解密的数据
+- 返回值：
+  - generateRSAKeyPair: 返回包含publicKey和privateKey的对象
+  - rsaEncrypt/rsaDecrypt: 加密/解密后的字符串
+
+#### RC4加密
+```ts
+function rc4Encrypt(key: string, data: string): string
+function rc4Decrypt(key: string, data: string): string
+```
+- 参数：
+  - key: 加密密钥
+  - data: 待加密/解密的数据
+- 返回值：加密/解密后的字符串（hex格式）
+
+#### 国密 SM3
+```ts
+function sm3(str: string): string
+function hmacSm3(key: string, data: string): string
+```
+- 参数：
+  - str/data: 待摘要的 UTF-8 字符串
+  - key: HMAC 密钥（UTF-8）
+- 返回值：小写 hex。`sm3("abc")` 固定为 `66c7f0f462eeedd9d1f2d46bdc10e4e24167c4875cf2f7a2297da02b8f4ba8e0`
+
+#### 国密 SM4
+```ts
+function sm4Encrypt(key: string, data: string, mode: string = "ECB", iv: string|null = null): string
+function sm4Decrypt(key: string, data: string, mode: string = "ECB", iv: string|null = null): string
+```
+- 参数：
+  - key/iv: UTF-8 字符串，按字节补 0 或截断到 16 字节（与 AES 相同）
+  - data: 加密为明文；解密为 **hex 密文**
+  - mode: `ECB` 或 `CBC`
+- 返回值：加密为小写 hex（注意：不是 AES 的 Base64）；解密为 UTF-8 明文
+- 填充：PKCS7，密钥长度固定 128 位
+
+#### 国密 SM2
+```ts
+function generateSM2KeyPair(): SM2RANDOMKEY
+function sm2Encrypt(publicKey: string, data: string, cipherMode?: number): string
+function sm2Decrypt(privateKey: string, data: string, cipherMode?: number): string
+function sm2Sign(privateKey: string, data: string, userId?: string): string
+function sm2Verify(publicKey: string, data: string, signHex: string, userId?: string): boolean
+```
+- 密钥：`publicKey` 为未压缩 `04||X||Y`（130 hex），`privateKey` 为 64 hex
+- 密文：裸 hex，默认 `cipherMode=1` 即 C1C3C2，与 sm-crypto 一致；C1 为 `X||Y`（128 hex，**无 04**）。`0` 为 C1C2C3。解密时若带 `04` 前缀会自动去掉
+- 签名：`r||s` 裸 hex（128 hex），`userId` 默认 `1234567812345678`
+- 失败返回 `""` / `false`，不抛异常
+
+### 使用示例
+
+```ts
+import {
+  md5, sha256, sha512, sha1, hmacSha256, hmacSha512,
+  base64Encode, base64Decode,
+  aesEncrypt, aesDecrypt,
+  desEncrypt, desDecrypt,
+  rsaEncrypt, rsaDecrypt,
+  rc4Encrypt, rc4Decrypt,
+  generateRSAKeyPair,
+  sm3, hmacSm3, sm4Encrypt, sm4Decrypt,
+  generateSM2KeyPair, sm2Encrypt, sm2Decrypt, sm2Sign, sm2Verify
+} from '@/uni_modules/x-crypto-s'
+
+// MD5加密
+const md5Result = md5("TMUI4.0X")
+
+// Base64编解码
+const base64Result = base64Encode("TMUI4.0X")
+const decodedText = base64Decode(base64Result)
+
+// SHA系列加密
+const sha256Result = sha256("TMUI4.0X")
+const hmacResult = hmacSha256("密钥", "TMUI4.0X")
+
+// AES加密（CBC模式）
+const aesResult = aesEncrypt(
+  "1234567890abcdef",
+  "TMUI4.0X",
+  "CBC",
+  "1234567890abcdef"
+)
+const aesDecrypted = aesDecrypt(
+  "1234567890abcdef",
+  aesResult,
+  "CBC",
+  "1234567890abcdef"
+)
+
+// RSA加密
+const rsaKeys = generateRSAKeyPair()
+const encrypted = rsaEncrypt(rsaKeys.publicKey, "TMUI4.0X")
+const decrypted = rsaDecrypt(rsaKeys.privateKey, encrypted)
+
+// 国密 SM3 / SM4 / SM2
+const sm3Hex = sm3("abc")
+const sm4Hex = sm4Encrypt("1234567890abcdef", "TMUI4.0X", "CBC", "1234567890abcdef")
+const sm4Plain = sm4Decrypt("1234567890abcdef", sm4Hex, "CBC", "1234567890abcdef")
+const sm2Keys = generateSM2KeyPair()
+const sm2Hex = sm2Encrypt(sm2Keys.publicKey, "TMUI4.0X")
+const sm2Plain = sm2Decrypt(sm2Keys.privateKey, sm2Hex)
+const signHex = sm2Sign(sm2Keys.privateKey, "TMUI4.0X")
+const pass = sm2Verify(sm2Keys.publicKey, "TMUI4.0X", signHex)
+```
+
+更多使用示例和在线加密对比工具：
+- MD5/SHA对比：https://www.mklab.cn/utils/md5
+- DES对比：https://www.mklab.cn/utils/des
+
+## 更新日志
+
+### 1.1.0（2026-08-16）
+* 五端补齐国密 SM2 / SM3 / SM4，默认对齐 sm-crypto：SM3/HMAC-SM3 小写 hex，SM4 密文 hex + PKCS7，SM2 裸 hex C1C3C2（C1 无 04 前缀）、签名 r||s，userId 默认 1234567812345678。
+* iOS 不再依赖 GMObjC CocoaPods，改为内置 SM3/SM4/SM2 实现，避免本机 trunk 找不到 pod。
+### 1.0.5（2026-03-15）
+* 鸿蒙端aes加密ecb模式修复加密内容为空的问题。
+### 1.0.4（2026-01-31）
+* 根据网友反馈的自己搭的环境打包修改了两行代码兼容。如果你是云打包，可以不升级，因为云打包是没问题的。只是他们部分人自己搭的环境打包不了。
+### 1.0.3（2025-08-17）
+*  兼容支持鸿蒙 Next
+### 1.0.2（2025-03-15）
+* 更新所有端都支持同样的加密方案。
+### 1.0.1（2025-02-28）
+* 补齐hmacSha512,sha512,aesEncrypt,aesDecrypt增加keySize加密位,增加了generateRSAKeyPair生成RSA密钥对.
+### 1.0.0（2024-12-24）
+* 常用 加密 三端可用.暂不支持sm2,sm3,sm4,下个版本提供.

package/data/tmui4x/10./346/217/222/344/273/266/345/272/223/xDesktopcardS /346/241/214/351/235/242/345/215/241/347/211/207/344/270/216/345/256/236/345/206/265.md"

@@ -0,0 +1,70 @@
+# x-desktopcard-s 桌面卡片与实况
+
+桌面卡片与实况的 **API 服务插件**。没有 uvue 组件，也不用 `native-view`。页面只 `import` 函数推数据。
+
+第一期模板：
+
+- `info`：标题 / 副标题 / 图
+- `progress`：标题 / 进度 / 状态
+
+### 兼容性
+
+| Harmony | iOS | Android | WEB | 小程序 |
+| --- | --- | --- | --- | --- |
+| 卡片 + 实况（实况需华为权益） | 不支持 | 卡片 AppWidget；实况 ongoing 通知，16+ 可提升 | 1008 | 1008 |
+
+### 调用
+
+```ts
+import { updateCard, requestPinCard, startLive, updateLive, endLive, getCardSupport } from "@/uni_modules/x-desktopcard-s"
+
+updateCard({
+  cardId: "home-info",
+  kind: "info",
+  title: "今日待办",
+  subtitle: "还剩 3 项",
+  cardHeight: 0,
+  success: (res) => {
+    console.log(res.errMsg, res.cardId)
+  }
+})
+
+startLive({
+  cardId: "order-1",
+  kind: "progress",
+  title: "配送中",
+  progress: 40,
+  status: "骑手已取餐",
+  progressColor: "#317AF7",
+  progressStartImage: "/static/live-start.png",
+  progressEndImage: "/static/live-end.png",
+  progressIndicatorImage: "/static/live-pin.png"
+})
+```
+
+### 方法
+
+卡片：`isCardSupported`、`getCardSupport`、`updateCard`、`requestPinCard`、`getPinnedCards`
+
+实况：`isLiveSupported`、`isLiveEnabled`、`startLive`、`updateLive`、`endLive`
+
+### 各端注意
+
+- Android：长按桌面或 `requestPinCard` 加卡片。桌面进度卡与鸿蒙对齐：标题 + 进度条 + 状态；信息卡是标题 + 副标题。卡片默认 2 行高，已钉成 1 行的请拖高或删掉重加，否则状态会被裁掉。实况是通知，不是主屏卡片。进度实况只用自定义通知行（左图 / 进度条 / 右图，中间指示叠在条上），不再叠加系统 `setProgress` 底栏。Android 12+ 折叠态自定义区只有 48dp，折叠/横幅用矮布局（标题+一行进度），展开才带状态文案。进度条与三张图在同一行垂直居中。
+- iOS：卡片和实况都不支持。需要独立 Widget Extension、App Group，以及给扩展单独出一份描述文件，流程偏复杂，先不做。调用会走 `1008`。
+- 鸿蒙：服务卡片放在工程 `harmony-configs/entry` 的 `FormExtensionAbility`。刷新走 `getPublishedRunningFormInfos` + `updateForm`。实况走 `@kit.LiveViewKit`，`event=DELIVERY`，没申请华为即时配送权益或没打开实况窗开关会 `1003`，文案里带 `ohos=` 原始码。左右节点、中间指示、进度颜色与 Live View Kit 最对齐；图空时仍用系统蓝点/蓝针。
+- 实况进度外观参数（Android / 鸿蒙同一字段）：`progressStartImage`、`progressEndImage`、`progressIndicatorImage` 为正方形 PNG（本地路径或 `https`），`progressColor` 为 `#RGB` / `#RRGGBB` / `#AARRGGBB`。空图时鸿蒙回退生成图标，Android 左右用色块圆点。请优先 `https`。
+- `cardHeight`（vp）：桌面卡片**内容**高度。`0` 按内容自适应，不再撑满格子。桌面格子本身由系统规格决定，已钉卡片不能改格子。鸿蒙新加默认 `1*2`（矮卡），仍可选 `2*2` / `2*4`。Android 新卡默认 1 行高，可拖高。实况窗高度不能改。
+- 不能程序化从桌面卸卡片。
+
+### 错误码
+
+`1001` 系统错误，`1002` 参数错误，`1003` 服务未开启，`1004` 权限被拒绝，`1008` 当前平台不支持，`1009` 实况未开始。
+
+## 更新日志
+
+### 1.0.0（2026-08-17）
+- 新增桌面卡片与实况 API：info / progress 两套模板
+- Android AppWidget + ongoing / Live Update 通知
+- iOS ActivityKit + Widget Extension 源码
+- HarmonyOS Form 服务卡片 + LiveViewKit

package/data/tmui4x/10./346/217/222/344/273/266/345/272/223/xEditorU /345/257/214/346/226/207/346/234/254/347/274/226/350/276/221.md"

@@ -0,0 +1,162 @@
+# x-editor-u 富文本编辑
+
+多端富文本编辑容器。接口对齐微信 [`editor`](https://developers.weixin.qq.com/miniprogram/dev/component/editor.html) / [`EditorContext`](https://developers.weixin.qq.com/miniprogram/dev/api/media/editor/EditorContext.html)，内容走自有受限 HTML（不跟微信 Delta 对齐）。
+
+### 兼容性
+
+| Harmony | IOS | Android | WEB | 小程序 |
+| --- | --- | --- | --- | --- |
+| 支持 | 支持 | 支持 | 支持 | 支持 |
+
+App：系统编辑控件。Web：宿主 DIV 挂 Quill。微信：官方 `editor`。
+
+### 调用
+
+```vue
+<x-editor-u
+  ref="editorRef"
+  placeholder="请输入"
+  :height="280"
+  @ready="onReady"
+  @input="onInput"
+  @statuschange="onStatus"
+  @linkchange="onLink"
+></x-editor-u>
+```
+
+```uts
+const proxy = getCurrentInstance()!.proxy!
+
+function getEditor() : XEditorUComponentPublicInstance | null {
+	return proxy.$refs["editorRef"] as XEditorUComponentPublicInstance | null
+}
+
+const editor = getEditor()
+if (editor == null) return
+editor.format("bold", "true")
+const htmlOpts : XEditorSetContentsOptions = { html: "<p>hello</p>" }
+editor.setContents(htmlOpts)
+const readOpts : XEditorGetContentsOptions = {
+	success: (res : XEditorContents) : void => {
+		console.log(res.html, res.text)
+	}
+} as XEditorGetContentsOptions
+editor.getContents(readOpts)
+```
+
+### 参数
+
+对齐微信 `<editor>` 属性。
+
+| 字段 | 说明 | 默认 |
+| --- | --- | --- |
+| placeholder | 占位文字 | `请输入` |
+| readOnly | 只读 | `false` |
+| dark | 深色 | `false` |
+| height | 整体高度 px（含内置工具栏） | `350` |
+| html | 初始 / 受控 HTML | `""` |
+| showToolbar | 是否显示内置工具栏 | `true` |
+| showLinkToolbar | 光标在链接上时显示编辑条。微信小程序无 `insertLink`，工具栏链接入口仅该端隐藏 | `true` |
+| showImgSize | 点选图片显示宽高 | `true` |
+| showImgToolbar | 点选图片显示删除 | `true` |
+| showImgResize | 点选图片拖角缩放（鸿蒙为放大/缩小按钮）。App 端点选图片自动收键盘方便拖手柄，已选中的图片再点一下取消选中 | `true` |
+| enterkeyhint | 键盘回车键文案 | `enter` |
+| confirmHold | 回车是否保持键盘 | `true` |
+
+### 事件
+
+对齐微信 `bindready` / `bindfocus` / `bindblur` / `bindinput` / `bindstatuschange`。
+
+| 名称 | 说明 |
+| --- | --- |
+| ready | 内核就绪 |
+| focus / blur | `{ html, text }` |
+| input | `{ html, text }` |
+| statuschange | 当前光标/选区样式，供工具栏高亮。含 `bold` `italic` `underline` `strike` `link` `linkText` `linkIndex` `linkLength` 等 |
+| linkchange | 进入或离开链接时触发，`{ href, text, index, length }`，方便自绘工具栏填链接 |
+| mentionclick | 点击提及芯片时触发，`{ id, name }`。微信端提及为纯文本，不触发 |
+| tableclick | 点击表格时触发，`{ id, rows, cols, cells }`。目前仅 Web 端触发（App 端表格为行内编辑，点击即进入单元格）；微信端不支持表格，不触发 |
+| chooseimage | 内置工具栏点插图。宿主选图、上传后调用 `insertImage({ src })` |
+| error | 失败 |
+
+### 方法
+
+对齐微信 `EditorContext`：
+
+`format` `setContents` `getContents` `insertImage` `insertText` `insertDivider` `insertLink` `updateLink` `removeLink` `insertMention` `insertTable` `updateTable` `removeTable` `undo` `redo` `clear` `removeFormat` `blur` `scrollIntoView` `getSelectionText` `getHistoryState` `getSelection` `setSelection` `deleteText` `getBounds`
+
+另提供同步读取：`getHtml` `getText`。
+
+不实现微信 `insertCustomBlock`（自定义区块仅官方内核支持）。`delta` 不作为跨端数据。微信端 `getSelection` / `setSelection` / `deleteText` / `getBounds` 受官方类型限制，能力以各端内核为准。
+
+### format
+
+名对齐微信 `EditorContext.format`：
+
+`bold` `italic` `underline` `strike` `ins` `script` `color` `backgroundColor` `fontSize` `fontWeight` `fontStyle` `align` `direction` `header` `list` `indent` `textIndent` `letterSpacing` `lineHeight` `textDecoration` `margin` `marginTop` `marginBottom` `marginLeft` `marginRight` `padding` `paddingTop` `paddingBottom` `paddingLeft` `paddingRight`
+
+另支持历史别名 `background`（等于 `backgroundColor`）和 `link`。kebab-case 写法（如 `margin-left`）会自动归一。
+
+margin / padding 为段落级样式，再次应用相同值会取消。各端能力：
+
+| 名称 | 微信 | Web | iOS | Android | 鸿蒙 |
+| --- | --- | --- | --- | --- | --- |
+| marginLeft / paddingLeft | 原生 | 支持 | 支持 | 支持（缩进实现） | 支持（缩进实现） |
+| marginTop / paddingTop | 原生 | 支持 | 支持（段前距） | 不支持 | 不支持 |
+| marginBottom / paddingBottom | 原生 | 支持 | 支持（段后距） | 不支持 | 不支持 |
+| margin / padding（四向简写） | 原生 | 支持 | 不支持 | 不支持 | 不支持 |
+
+`list` 取值：`ordered` / `bullet` / `check`（待办）。`indent` 取值：`-1` / `+1`。`script` 取值：`sub` / `super`。再点同一样式会取消（与微信一致）。微信官方只有 `check` 一种待办，且基础库 3.9.3+ 常画成黑点（与无序相同），小程序工具栏因此只保留有序/无序。
+
+列表按整行加前缀，回车自动续写（有序 `1.` → `2.`）。空列表项再回车退出列表。
+
+### insertMention
+
+插入提及芯片 `@名字`，整体删除（退格从中间删会整块删掉），点击触发 `mentionclick`。
+
+```uts
+const opts : XEditorInsertMentionOptions = {
+	name: "张三",
+	id: "1001",
+	color: "#1677ff",        // 可选，文字色
+	background: "#e6f3ff",   // 可选，背景色
+	radius: "4px"            // 可选，圆角；Android/iOS 绘制为方角，仅参与 HTML 回写
+}
+editor.insertMention(opts)
+```
+
+HTML 回写为 `<span data-mention-id="1001" data-mention-name="张三" style="color:...;background-color:...;border-radius:...">@张三</span>`，`setContents` 灌入同构 HTML 会还原成芯片。微信端降级为纯文本 `@名字`（官方内核无自定义节点），无样式、无点击事件。
+
+### 表格（insertTable / updateTable / removeTable）
+
+类 iOS 备忘录的表格交互：
+
+- 工具栏表格按钮直接插入 2x2 空表，不弹输入框。App 端插入后不自动聚焦格子、不弹键盘，用户自行点格子开始输入。
+- 表格在正文里行内直接编辑（全端一致，无弹层）：点格子即打字。
+- 光标在某格时，该列顶部、该行左侧出现 `•••` 手柄：点一下选中整列/整行（高亮）并收起键盘，选中态再点弹出菜单——删除列/右侧加一列、删除行/下方加一行。
+- 光标在最后一格再按回车，自动在下方续一行。
+
+```uts
+const opts : XEditorInsertTableOptions = {
+	rows: 2,
+	cols: 2,
+	cells: [["姓名", "分工"], ["张三", "前端"]]  // 可选，缺省为空格子
+}
+editor.insertTable(opts)
+// 之后可用 updateTable({ id, cells }) 改内容，removeTable({ id }) 删除
+```
+
+HTML 回写为 `<table class="x-table"><tr><td>…</td></tr></table>`，`setContents` 灌入同构 HTML 会还原。上限 20 行 x 8 列，单元格为纯文本。各端形态：
+
+| 端 | 呈现 | 编辑方式 |
+| --- | --- | --- |
+| Web | Quill 原生表格 | 表格内直接打字 + 行内 `•••` 手柄增删行列 + 末格回车加行 |
+| Android / iOS | 行内真实网格（块式内核：正文与表格块混排） | 格内直接打字 + `•••` 手柄增删行列 + 末格回车加行 |
+| 鸿蒙 | 行内真实网格（块式内核：多 RichEditor 文本块 + 表格块混排） | 同上 |
+| 微信 | 不支持（官方内核无表格），工具栏隐藏按钮，API 走 `fail`（错误码 3006） | - |
+
+`insertImage` 对齐微信：`src` `alt` `width` `height` `nowrap` `extClass` `data`。默认插图后换行，`nowrap: true` 不换行。
+
+点选图片后出现尺寸、删除和缩放，对齐微信 `show-img-size` / `show-img-toolbar` / `show-img-resize`。App / Web 自绘浮层；微信走官方控件；鸿蒙因无可靠坐标，用编辑区顶栏放大、缩小、删除。设为 `false` 可关闭。
+
+内置工具栏默认显示，布局、配色和 Remix 图标对齐 tmx-ui `x-editor`（`x-icon` / `x-popover`）。字号、颜色、标题用同样的气泡菜单。多出来的缩进、上下标、分割线、插图、链接、撤销重做、去格式沿用同一组按钮样式。微信小程序没有可用的 `insertLink`，该端隐藏链接按钮和编辑条；App / Web 正常显示。光标落在已有样式上时对应按钮高亮。点进链接会出现编辑条。点插图会触发 `chooseimage`，由宿主选图、上传后调用 `insertImage({ src })`，插件不内置上传。`:show-toolbar="false"` 后只留编辑面。工具栏用 `view` 点击，避免抢焦点丢掉选区。需要工程里已有 `tmx-ui`。

package/data/tmui4x/10./346/217/222/344/273/266/345/272/223/xFacedetectAlibabaS /351/230/277/351/207/214/344/272/221/345/256/236/344/272/272/350/256/244/350/257/201.md"

@@ -0,0 +1,63 @@
+# x-facedetect-alibaba-s 阿里云实人认证
+
+阿里云实人认证。先向阿里云后台换 `certifyId`，再调起原生核身。
+
+### 兼容性
+
+| Harmony | IOS | Android | WEB | 小程序 |
+| --- | --- | --- | --- | --- |
+| 支持 | 支持 | 支持 | 不支持 | 不支持 |
+
+### 调用
+
+```ts
+import { getMetaInfos, xFaceVerify } from "@/uni_modules/x-facedetect-alibaba-s"
+
+getMetaInfos({
+  success: (res) => {
+    console.log(res.value)
+  }
+})
+
+xFaceVerify({
+  certifyId: "从服务端获取",
+  success: (res) => {
+    console.log(res.code, res.reason)
+  },
+  fail: (res) => {
+    console.log(res)
+  }
+})
+```
+
+### 方法
+
+| 名称 | 需要 | 说明 |
+| --- | --- | --- |
+| getMetaInfos | 可选 `success` / `fail` / `complete` | 取设备元信息 `res.value`，交给服务端换 `certifyId` |
+| xFaceVerify | `certifyId`，可选 `useMsgBox`、`extParams` | 调起原生核身，成功返回 `code` / `reason` |
+
+### 参数
+
+`xFaceVerify`
+
+| 字段 | 说明 | 默认 |
+| --- | --- | --- |
+| certifyId | 认证 ID，与 metaInfos 二选一 | - |
+| useMsgBox | 是否用系统提示框 | - |
+| extParams | 扩展参数 | - |
+| success / fail / complete | 回调 | - |
+
+`XFaceDetectResult`：`code`、`reason`。
+
+H5 核身需自行接阿里云 Web 方案，本插件不覆盖。
+
+### 版本
+
+版权归https://xui.tmui.design你不得修改及二次开发，仅供TMUI4会员商用使用。不得转给非VIP会员使用，一经查实数倍赔偿，并追究法律责任。
+
+## 更新日志
+
+### 1.0.0（2026-07-31）
+
+- 支持安卓 ，Ios，HarmonyOs

package/data/tmui4x/10./346/217/222/344/273/266/345/272/223/xFacerecU /347/246/273/347/272/277/344/272/272/350/204/270/350/257/206/345/210/253.md"

@@ -0,0 +1,164 @@
+# x-facerec-u 离线人脸识别
+
+离线人脸识别：检测、入录、图片 / 相机帧 1:N 匹配，并提供嵌入式实时识别 UI 组件。可选用内置模型，不必自备。
+
+### 兼容性
+
+| Harmony | IOS | Android | WEB | 小程序 |
+| --- | --- | --- | --- | --- |
+| 支持 | 支持 | 支持 | 不支持 | 不支持 |
+
+### 组件（推荐）
+
+`<x-facerec-u>` 是标准 UI 组件，直接嵌入页面即可实时识别：相机采集、SCRFD 检测、ArcFace 1:N、跟踪、人脸框绘制全在原生层闭环，帧不跨插件搬运。命中底库绘绿框标「人名 可信度%」，未命中绘橙框标「未识别」。识别依赖 `loadModels` 先就绪（组件与 API 共享同一原生单例与底库）。
+
+```html
+<x-facerec-u ref="facerecRef" style="width:100%;height:320px"
+  :auto-open="true" camera-position="front" :detect-interval="120" :draw-box="true"
+  @ready="onReady" @recognize="onRecognize" @capture="onCapture" @error="onError"></x-facerec-u>
+```
+
+| 属性 | 说明 | 默认 |
+| --- | --- | --- |
+| camera-position | `front` / `back`，运行中改值热切换 | `front` |
+| torch | 闪光灯（前置通常不支持） | `false` |
+| detect-interval | 相邻两次识别最小间隔 ms，框由原生插值平滑跟随 | `120` |
+| draw-box | 是否绘制人脸框与人名标签 | `true` |
+| auto-open | 视图初始化后自动请求权限并开流 | `true` |
+
+| 事件 | 说明 |
+| --- | --- |
+| @ready | 相机开流成功（含切换镜头重开） |
+| @recognize | 识别结果（`faces`：`trackId`/`name`/`score`/`recognized`/`box`） |
+| @capture | `takePhoto()` 抓拍完成，含 `imagePath` 与最近识别结果 |
+| @error | 权限/相机/抓拍错误 |
+
+组件方法（`ref` 调用）：`open()` / `close()` / `takePhoto()` / `setTorch(on)` / `setDetecting(on)` / `isDetecting()` / `switchCamera()`。开相机即开始检测，`setDetecting(false)` / `close()` 都会关掉相机，不再保留「预览在、识别停」的中间态。
+
+### 调用
+
+```ts
+import { loadModels, enroll, recognizeImage, recognizeFrame } from "@/uni_modules/x-facerec-u"
+
+loadModels({
+  detModel: "det_500m",
+  recModel: "w600k_mbf",
+  similarityThresh: 0.4,
+  confidenceThresh: 0.5,
+  maxFaces: 1,
+  success: (res) => {
+    console.log(res.gallerySize)
+  }
+})
+
+enroll({
+  userId: "u1001",
+  name: "张三",
+  imagePath: facePath,
+  success: (res) => {
+    console.log(res.quality)
+  }
+})
+
+recognizeImage({
+  imagePath: probePath,
+  success: (res) => {
+    if (res.matches.length > 0) {
+      console.log(res.matches[0].userId, res.matches[0].score)
+    }
+  }
+})
+
+recognizeFrame({
+  width: 640,
+  height: 480,
+  format: "nv21",
+  frameBuffer: data,
+  rotation: 90,
+  success: (res) => {
+    console.log(res.matches)
+  }
+})
+```
+
+实时识别优先用上方 `<x-facerec-u>` 组件或 `openCamera` 弹层，二者均在原生层闭环，无需自己搬帧。
+
+### 方法
+
+| 名称 | 需要 | 说明 |
+| --- | --- | --- |
+| loadModels | `detModel?`、`recModel?`、`modelRoot?`、阈值等，见下方 | 加载模型，不传 `modelRoot` 用内置 |
+| unloadModels | 可选回调 | 卸载模型 |
+| detectFaces | `imagePath` | 只检测人脸框和关键点，不比对底库 |
+| enroll | `userId`、`imagePath`，可选 `name`、`replace` | 入录到底库；`replace=true` 覆盖该用户旧样本 |
+| recognizeImage | `imagePath` | 用图片做 1:N 识别，返回 `matches` / `unknownFaces` |
+| recognizeFrame | `width`、`height`、`format`、`frameBuffer` 或 `frameBase64`、`rotation?` | 用相机帧做 1:N 识别 |
+| listUsers | 可选回调 | 列出底库用户 |
+| removeUser | `userId` | 删除指定用户 |
+| clearGallery | 可选回调 | 清空底库 |
+| setOptions | `confidenceThresh?`、`similarityThresh?`、`livenessThresh?`、`maxFaces?` | 运行中改阈值 |
+| openCamera | `cameraPosition?`、`torch?`、`detectInterval?`、`drawBox?`、事件回调 | 打开原生全屏弹层实时识别（不想改页面布局时用） |
+| getRuntimeInfo | 无 | 同步返回运行时与是否已就绪 |
+| getState | 无 | 返回 `idle` / `loading` / `ready` / `error` |
+
+### 参数
+
+`loadModels`
+
+| 字段 | 说明 | 默认 |
+| --- | --- | --- |
+| modelRoot | 自定义模型目录，空则用内置 | 内置 |
+| detModel | `det_500m` / `det_2.5g` / `det_10g` | `det_500m` |
+| recModel | `w600k_mbf`；`w600k_r50` 需自备 | `w600k_mbf` |
+| confidenceThresh | 检测阈值 | `0.5` |
+| similarityThresh | 识别阈值 | `0.4` |
+| livenessThresh | 活体阈值 | `0.5` |
+| enrollMinQuality | 入录最低质量 | `0.6` |
+| maxFaces | 每帧最多人脸 | `1` |
+| galleryDir | 底库目录 | 应用私有目录 |
+
+`recognizeFrame`：`width` / `height` / `format`（`nv21` / `bgra` / `rgba`）/ `frameBuffer` 或 `frameBase64` / `rotation` / `orientation`。
+
+### 平台差异
+
+1. 无 Web / 微信。
+2. 帧格式与 `x-camrea-u` 对齐：Android `nv21`，iOS `bgra`，鸿蒙 `rgba`。前置镜头注意 `mirrored` / `orientation`。
+
+### 版本
+
+版权归https://xui.tmui.design你不得修改及二次开发，仅供TMUI4会员商用使用。不得转给非VIP会员使用，一经查实数倍赔偿，并追究法律责任。
+
+## 更新日志
+
+### 0.3.0（2026-08-20）
+
+- 模块更名 `x-facerec-s` → `x-facerec-u`：由 API 插件升级为「标准 UI 组件 + API」双形态
+- 新增 `<x-facerec-u>` 嵌入式组件：相机预览 + 人脸框 overlay 直接嵌页面，
+  采集/检测/识别/跟踪/绘框全在原生层闭环，不再依赖 `x-camrea-u` 跨插件搬帧
+- 组件属性 `camera-position` / `torch` / `detect-interval` / `draw-box` / `auto-open`，
+  事件 `@ready` / `@recognize` / `@capture` / `@error`，
+  方法 `open` / `close` / `takePhoto` / `setTorch` / `setDetecting` / `switchCamera`
+- 原有全部 API（loadModels / enroll / recognizeImage / recognizeFrame / openCamera 等）保留，组件与 API 共享同一原生单例与底库
+- 修复 Android 打开测试页闪退、鸿蒙实时识别延迟大且检不出人：
+  移除 ORT XNNPACK 执行提供器（Android 上建会话原生段错误、鸿蒙上反而更慢），回归纯 CPU EP（NEON），与 iOS 63ms 同款配置
+- 原生库更名 `libx_facerec_u.so`，JNI/NAPI 符号与 Kotlin 包名同步更新
+- 修复 Android / Harmony 实时检得出人脸却对不上底库、检测框反着跑：
+  前摄不再把镜像写进推理像素（与相册录入同朝向），只在 overlay 水平翻转框
+- Android 实时分析帧不再开 CameraX 输出旋转：该选项会裁掉 FOV 且打乱 YUV 平面，导致预览在、检不出人
+- 修复 Android 嵌入式检测框偏小（只框到眼嘴）：自行按预览尺寸建 ViewPort（native-view 里 getViewPort 常为空），
+  分析帧 16:9 + cropRect；嵌入式 TextureView；CSS 盒×像素比校正 overlay 尺度
+
+### 0.2.0（2026-08-08）
+
+- 接入 ONNX Runtime 真实推理（SCRFD 检测 + 5 点对齐 + ArcFace 特征）
+- 三端各自准备 ORT：Android Maven 1.28 / iOS xcframework 1.28 / Harmony OHOS 1.27
+- 构建脚本步骤 `[0]` 调用 `third_party/onnxruntime/prepare_*.sh`（不再从 sherpa 顺手抽库）
+- 内置模型：`det_500m` / `det_2.5g` / `det_10g` + `w600k_mbf`（约 35MB）
+- `loadModels()` 可不传 `modelRoot`，自动使用内置模型
+- Android aar / Harmony har / iOS Frameworks 均含对应平台 ORT + 模型
+
+### 0.1.0（2026-08-08）
+
+- 初版框架：Android / iOS / HarmonyOS 三端骨架
+- 共享 C++ 核心 + JSON Bridge；交叉编译脚本
+- API：loadModels / enroll / detectFaces / recognizeImage / recognizeFrame / 底库管理