tmui-cli 2.0.1 → 2.0.3

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,191 @@
+# 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`。
+
+## 更新日志
+
+### 0.1.5（2026-08-28）
+
+- 修复 APP 端 `native-view` 拿不到高度导致内容区空白：宿主原本靠 `flex: 1` 撑开，而原生层拿不到由 flex 分配出来的尺寸，现改为把 `props.height` 直接写成固定像素挂在 `native-view` 上。根节点高度已固定，body 是唯一的在流子层，链接条是 `position: absolute` 不占高，因此两者相等
+- 同一条规则下 `flex: 1` 隐含的 `flex-basis: 0%` 会盖掉 `height`，APP 端补一段条件编译把 `flex-grow` / `flex-shrink` / `flex-basis` 一并退回，确保写上去的像素值生效。本仓其余 native-view 插件（swiper / 天地图 / 相机 / pdf / 人脸 / skia / html / model3d）用的都是固定像素或 `100%`，只有这里是 flex
+
+### 0.1.4（2026-08-27）
+
+- `reflowAfterResize` 里的强制排版从 `containerRef?.layoutIfNeeded()` 收窄为 `scrollHost?.layoutIfNeeded()`。对 `bindIOSView` 绑定的宿主调 `layoutIfNeeded` 会把 uni-app x 的页面布局拽进一次计划外的同步排版，与它自己驱动的 frame 布局撞车。宿主直接子层的 frame 已在 `layoutHostChildren` 中同步摆好，这里只需让滚动容器内部的宽度约束落地
+
+### 0.1.3（2026-08-27）
+
+- 修复 iOS 反复进出后**整页**空白（导航栏还在、内容区永久不恢复）：宿主的直接子层（滚动容器、占位 label、图片手柄层、底部静态工具条）全部改回手排 frame，由 `XEditorHostView.layoutSubviews` 每趟按当前 `bounds` 重排。`bindIOSView` 绑定的视图由 uni-app x 的布局引擎按 frame 摆放，在它身上激活 Auto Layout 约束会把宿主拽进约束引擎、与外层 frame 布局打架，整页内容因此塌掉。0.1.1 把这几处从 frame 改成约束正是这个问题的来源，症状也从「重进就好」恶化成「永不恢复」
+- 更深层自成一体的子树（滚动容器内的 `UIStackView`、工具条内部排布）不碰宿主，保持约束布局不变
+- 宿主补 `clipsToBounds`
+
+### 0.1.2（2026-08-27）
+
+- 修复 iOS 偶发整块空白的主因：文本视图改为在创建时就装配 TextKit 1 排版栈（`UITextView(frame:textContainer:)` + 显式 `NSTextStorage` / `NSLayoutManager` / `NSTextContainer`）。本实现整体建立在 `textStorage` / `layoutManager` / `boundingRect(forGlyphRange:in:)` 之上，而 iOS 16+ 的 `UITextView` 默认起 TextKit 2，首次访问这些属性会触发运行时降级（原生日志：`UITextView ... is switching to TextKit 1 compatibility mode because its layoutManager was accessed`）。降级会把已建好的排版栈整个换掉，落在已上屏、正在布局的视图上就是一块空白；降级时机取决于哪条代码路径先访问，所以表现为偶发
+
+### 0.1.1（2026-08-27）
+
+- 修复 iOS 反复进出页面后整块空白：`XEditorHostView.layoutSubviews` 在 `onLayout` 尚未绑定时也会把尺寸记进 `lastSize`。`attach` 是在 `bindIOSView` 之后才挂回调的，中间只要跑过一次布局，这次尺寸就被吞掉，而之后尺寸不再变化就永远不会再回调，正文块一直停在零宽排出来的版上且不可恢复。现在回调未绑定时不记 `lastSize`，同时把 `onLayout` 提到 `attach` 最前面绑定
+- 补齐 `attach` 时宿主已有尺寸的分支：原来只发 `ready` 不重排，现在走完整的 `reflowAfterResize`
+- 修复销毁不彻底：`destroy()` 原本只清了 9 个回调里的 6 个，漏掉的 `onMentionCallback` / `onTableCallback` / `onToolbarCallback` 会留下 `XEditorU → XEditorNative → 闭包 → XEditorU` 的循环引用，`UTSiOS.destroyInstance` 只摘桥接表、断不了这一环
+- `destroy()` 主动收键盘，避免带焦点离开页面时正文块仍是 first responder；`textViewDidEndEditing` 增加 destroyed 守卫，不再向已卸载的 uvue 抛 blur
+- `destroy()` 清空 `_options`（内含 keepAlive 住的 uvue 回调）

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