tmui-cli 2.0.1 → 2.0.2

package/data/tmui4x/10./346/217/222/344/273/266/345/272/223/xMimeS /346/226/207/344/273/266/347/261/273/345/236/213/345/227/205/346/216/242.md"

@@ -0,0 +1,85 @@
+# x-mime-s 文件类型嗅探
+
+按文件头判断真实 MIME，不依赖扩展名。支持路径、base64、二进制；Web 还可传 Blob。
+
+### 兼容性
+
+| Harmony | IOS | Android | WEB | 小程序 |
+| --- | --- | --- | --- | --- |
+| 支持 | 支持 | 支持 | 支持 | 支持 |
+
+### 调用
+
+```ts
+import { sniff } from "@/uni_modules/x-mime-s"
+
+sniff({
+  source: filePath,
+  success: (r) => {
+    console.log(r.mimeType, r.mediaType, r.extension, r.fromSniff)
+  },
+  fail: (e) => {
+    console.log(e.errCode, e.errMsg)
+  }
+})
+
+sniff({ base64: "data:image/png;base64,..." })
+```
+
+### 方法
+
+| 名称 | 需要 | 说明 |
+| --- | --- | --- |
+| sniff | 见下方，来源四选一 | 判断真实 MIME |
+| warmup | 无 | 预热原生 / WASM 核心，可不调，首次 sniff 也会初始化 |
+| getNativeVersion | `(version: string) => void` | 取原生核心版本，微信为空 |
+
+### 参数
+
+`XMimeSniffOptions`（来源四选一，同时传时优先级：`binary` > `blob` > `base64` > `source`）
+
+| 字段 | 说明 | 默认 |
+| --- | --- | --- |
+| source | 文件路径或 URL。App 为本地路径；Web / 微信可为 http(s) | - |
+| base64 | base64，支持 `data:` 前缀 | - |
+| binary | `ArrayBuffer` / `Uint8Array` | - |
+| blob | Web 的 File / Blob；其它端返回 1008 | - |
+| declaredType | 已声明 MIME | - |
+| maxBytes | 读取字节，64~8192 | `1024` |
+| useExtensionHint | 无魔数时用扩展名兜底 | `true` |
+| success | 成功 | - |
+| fail | 失败 | - |
+| complete | 结束 | - |
+
+`XMimeSniffResult`
+
+| 字段 | 说明 |
+| --- | --- |
+| mimeType | 如 `image/png` |
+| mediaType | `image` / `audio` / `video` / `font` / `application` / `text` / `unknown` |
+| extension | 建议扩展名，不含点 |
+| fromSniff | `true` 为内容嗅探，`false` 为扩展名/声明兜底 |
+| bytesChecked | 实际检查字节数 |
+| elapsedMs | 嗅探耗时 |
+
+错误码：`1001`–`1008`（`1008` 为当前平台不支持该输入）。
+
+### 平台差异
+
+1. `blob` 仅 Web。
+2. URL 嗅探：Web / 微信可读远程；App 的 `source` 为本地路径。
+3. 微信无原生核心，`getNativeVersion` 为空。
+
+### 版本
+
+版权归https://xui.tmui.design你不得修改及二次开发，仅供TMUI4会员商用使用。不得转给非VIP会员使用，一经查实数倍赔偿，并追究法律责任。
+
+## 更新日志
+
+### 1.0.0（2026-08-04）
+
+- 首发：五端文件类型嗅探（Android / iOS / HarmonyOS / Web / 微信小程序）
+- 共享 C++ 核心移植 Chromium `mime_sniffer.cc`（WHATWG MIME Sniffing）
+- 支持 `source` / `base64` / `binary` 输入；Web/小程序额外支持 http(s) Range 头部嗅探
+- Web 支持 `blob:` URL 与 `blob`（Blob/File，只 slice 头部字节）
+- 导出 `sniff` / `warmup` / `getNativeVersion`

package/data/tmui4x/10./346/217/222/344/273/266/345/272/223/xMlkitScannigS /345/205/250/345/261/217/346/211/253/347/240/201.md"

@@ -0,0 +1,111 @@
+# x-mlkit-scannig-s 全屏扫码
+
+全屏扫码。打开相机识别，也可扫相册图片。同时只能开一个。
+
+**微信内使用官方 `wx.scanCode`，`close` / `scanImage` 仅保留签名。**
+
+### 兼容性
+
+| Harmony | IOS | Android | WEB | 小程序 |
+| --- | --- | --- | --- | --- |
+| 支持 | 支持 | 支持 | 支持 | 支持（官方扫码） |
+
+### 调用
+
+```ts
+import { open, close, scanImage } from "@/uni_modules/x-mlkit-scannig-s"
+
+open({
+  scanArea: { x: 0.1, y: 0.2, width: 0.8, height: 0.6 },
+  showScanArea: true,
+  success: (r) => {
+    console.log(r.selectedCode?.rawValue, r.texts)
+  }
+})
+
+scanImage({
+  tempFilePath: imagePath,
+  success: (r) => {
+    console.log(r.texts)
+  }
+})
+
+close()
+```
+
+页面内嵌扫码请用 `x-mlkit-scannig-u`。
+
+### 方法
+
+| 名称 | 需要 | 说明 |
+| --- | --- | --- |
+| open | 见下方 `open` 字段 | 打开全屏扫码，同时只能开一个 |
+| close | 可选回调 | 关闭扫码页。微信为空实现 |
+| scanImage | `tempFilePath` | 识别本地图片。微信为空实现 |
+
+### 参数
+
+`open`
+
+| 字段 | 说明 | 默认 |
+| --- | --- | --- |
+| onlyFromCamera | `true` 隐藏相册入口 | `false` |
+| cameraPosition | `front` / `back` | `back` |
+| torch | 闪光灯 | `false` |
+| zoom | 倍率 | `1` |
+| vibrate | 识别成功震动 | `true` |
+| scanInterval | 最小识别间隔 ms | `300` |
+| formats | 码制，如 `qrCode`、`ean13`、`all` | `["all"]` |
+| scanArea | 相对预览的归一化区域 `{ x, y, width, height }` | 全预览 |
+| showScanArea | 是否显示绿色取景框 | `true` |
+| success / fail / complete | 回调 | - |
+
+`XScanningResult`：`source`（`camera` / `album`）、`codes`、`texts`、`selectedCode`、`viewWidth` / `viewHeight`、`scanArea`、`timestamp`。
+
+`scanImage`：`tempFilePath` 必填。
+
+### 平台差异
+
+1. 微信：官方扫码，无码坐标；`close` / `scanImage` 为空实现，`showScanArea` 无效。
+2. 鸿蒙前置相机不可用，`front` 返回 2002。
+3. 重复 `open` 返回 2007。
+
+### 版本
+
+版权归https://xui.tmui.design你不得修改及二次开发，仅供TMUI4会员商用使用。不得转给非VIP会员使用，一经查实数倍赔偿，并追究法律责任。
+
+## 更新日志
+
+### 2.0.1（2026-08-24）
+
+- 增加 `showScanArea`，可关闭绿色取景框。
+
+### 2.0.0（2026-07-31）
+
+- 破坏性更新，统一为Dcloud函数式风格调用
+- 所有端得到增强
+- web也支持多码识别
+
+### 1.1.3（2025-11-30）
+
+- 旧版本增加 HarmonyOS 实现。
+
+### 1.1.1（2025-02-13）
+
+- 旧 Web/微信实现调整图片识别。
+
+### 1.0.9（2024-11-18）
+
+- 增加闪光灯控制。
+
+### 1.0.8（2024-09-12）
+
+- 调整 Android 扫描页面兼容性。
+
+### 1.0.7（2024-08-31）
+
+- 增加仅相机识别选项。
+
+### 1.0.0（2024-01-24）
+
+- 首次发布。

package/data/tmui4x/10./346/217/222/344/273/266/345/272/223/xMlkitScannigU /346/211/253/347/240/201/345/256/271/345/231/250.md"

@@ -0,0 +1,118 @@
+# x-mlkit-scannig-u 扫码容器
+
+页面内嵌扫码。实时出码、区域过滤、码点点击。全屏单例请用 `x-mlkit-scannig-s`。
+
+**微信走官方 camera 扫码，无码坐标，边框、码点点击、`scanImage` 不可用。**
+
+### 兼容性
+
+| Harmony | IOS | Android | WEB | 小程序 |
+| --- | --- | --- | --- | --- |
+| 支持 | 支持 | 支持 | 支持 | 支持（官方扫码） |
+
+### 调用
+
+```vue
+<x-mlkit-scannig-u
+  ref="scannerRef"
+  camera-position="back"
+  :continuous="false"
+  :scan-area="scanArea"
+  :auto-open="false"
+  :show-scan-area="true"
+  :show-code-points="true"
+  @ready="onReady"
+  @scan="onScan"
+  @clickCode="onCodeClick"
+></x-mlkit-scannig-u>
+```
+
+```ts
+const scanArea = { x: 0.1, y: 0.2, width: 0.8, height: 0.6 }
+
+function onScan(result : XScanningResult) : void {
+  console.log(result.codes)
+}
+
+scannerRef.value?.open()
+scannerRef.value?.close()
+```
+
+### 参数
+
+| 字段 | 说明 | 默认 |
+| --- | --- | --- |
+| cameraPosition | `front` / `back` | `back` |
+| torch | 闪光灯 | `false` |
+| zoom | 倍率 | `1` |
+| continuous | `false` 识别一批后暂停 | `false` |
+| vibrate | 识别成功震动 | `true` |
+| scanInterval | 最小识别间隔 ms | `300` |
+| formats | 码制 | `["all"]` |
+| scanArea | 归一化扫描区 | 全预览 |
+| autoOpen | 初始化后自动开相机 | `true` |
+| showScanArea | 显示扫描框 | `true` |
+| showCodePoints | 显示码标记 | `true` |
+
+`scanArea` 相对组件预览，范围 0~1。只有码中心落在区域内才回调。
+
+### 事件
+
+| 名称 | 参数 | 说明 |
+| --- | --- | --- |
+| ready | `{ state, cameraPosition, torchSupported, minZoom, maxZoom }` | 相机就绪 |
+| scan | `XScanningResult`：`source`、`codes`、`texts`、`viewWidth` / `viewHeight`、`scanArea` | 识别到一批码 |
+| clickCode | `{ rawValue, displayValue, format, bounds, cornerPoints }` | 点击页面上的码标记 |
+| stop | `{ state, reason }` | 暂停、关闭或销毁。`reason` 为 `result` / `close` / `destroy` / `error` |
+| error | `{ errSubject, errCode, errMsg }` | 打开或识别失败 |
+
+### 方法
+
+| 名称 | 需要 | 说明 |
+| --- | --- | --- |
+| open | 可选 `success` / `fail` / `complete` | 打开或继续扫描 |
+| close | 可选 `success` / `fail` / `complete` | 暂停扫描 |
+| setTorch | `enabled: boolean` | 开关闪光灯 |
+| setZoom | `zoom: number` | 设置倍率，超出设备范围会被夹住 |
+| scanImage | `tempFilePath: string` | 识别本地图片。微信不可用 |
+| chooseImage | 可选 `success` / `fail` / `complete` | 调相册选图并识别。微信不可用 |
+| getState | 无 | 返回当前状态 |
+
+兼容别名：`openCamera` = `open`，`closeCamera` = `close`，`setFlashModel(enabled)` = `setTorch`。
+
+### 平台差异
+
+1. 微信无码坐标，扫描框和码点点击无效。
+2. `continuous=false` 时识别一批后暂停，再 `open` 继续。
+
+### 版本
+
+版权归https://xui.tmui.design你不得修改及二次开发，仅供TMUI4会员商用使用。不得转给非VIP会员使用，一经查实数倍赔偿，并追究法律责任。
+
+## 更新日志
+
+### 2.0.0（2026-07-31）
+
+- 破坏性更新，统一为Dcloud函数式风格调用
+- 所有端得到增强
+- web也支持多码识别
+
+### 1.1.2（2025-08-17）
+
+- 针对旧 Web/微信实现调整浏览器内核属性。
+
+### 1.1.0（2024-12-18）
+
+- 增加闪光灯初始状态和 `setFlashModel`。
+
+### 1.0.8（2024-08-31）
+
+- 增加相册图片识别。
+
+### 1.0.7（2024-08-11）
+
+- 优化 Android/iOS 识别速率和嵌入尺寸适配。
+
+### 1.0.0（2024-01-24）
+
+- 首次发布。

package/data/tmui4x/10./346/217/222/344/273/266/345/272/223/xMnnkitS /347/253/257/344/276/247/345/244/247/346/250/241/345/236/213.md"

@@ -0,0 +1,119 @@
+# x-mnnkit-s 端侧大模型
+
+端侧 LLM 文本生成。模型用 ZIP 导入后加载，支持 `generate` / `chat` 流式输出。适合本地助手、归纳问答。
+
+ZIP 内只能有一个 `x-mnnkit-manifest.json`（或 `manifest.json`），并声明 `config.json`、`llm_config.json`、`llm.mnn`、`llm.mnn.weight`、`tokenizer.txt`。
+
+### 兼容性
+
+| Harmony | IOS | Android | WEB | 小程序 |
+| --- | --- | --- | --- | --- |
+| 部分支持 | 支持 | 支持 | 不支持 | 不支持 |
+
+### 调用
+
+```ts
+import { prepareModel, loadModel, chat, generate } from "@/uni_modules/x-mnnkit-s"
+
+prepareModel({
+  source: {
+    kind: "remote",
+    archivePath: zipPath,
+    modelId: "qwen-customer-service",
+    version: "1.1.0"
+  },
+  success: (result) => {
+    loadModel({
+      modelPath: result.descriptor.path,
+      temperature: 0.7,
+      topP: 0.8,
+      success: () => {
+        generate({
+          prompt: "你好，请介绍一下自己",
+          maxNewTokens: 256,
+          onToken: (text) => {
+            console.log(text)
+          },
+          success: (res) => {
+            console.log(res.text)
+          }
+        })
+      }
+    })
+  }
+})
+```
+
+多轮：
+
+```ts
+const history = [
+  { role: "system", content: "你是简洁的本地助手。" },
+  { role: "user", content: "介绍一下自己" }
+] as XMNNChatMessageItem[]
+
+chat({
+  messages: history,
+  maxNewTokens: 256,
+  onToken: (text) => {
+    console.log(text)
+  },
+  success: (res) => {
+    history.push({ role: "assistant", content: res.text })
+  }
+})
+```
+
+`source.kind`：`remote` 用已下载 ZIP 的 `archivePath`；`local` 用已解压目录 `path`。
+
+### 方法
+
+| 名称 | 需要 | 说明 |
+| --- | --- | --- |
+| prepareModel | `source`（`kind` / `archivePath` 或 `path` / `modelId` / `version`），可选 `onEvent` | 导入 ZIP 或已解压目录，返回 `requestId` |
+| cancelModelPreparation | `requestId` | 取消正在导入的模型 |
+| getModelState | `modelId`、`version` | 查询某个模型是否已导入 |
+| listModels | 无 | 列出已导入模型 |
+| removeModel | `modelId`、`version` | 删除已导入模型 |
+| loadModel | `modelPath` 或 `bundledModelName`，可选采样参数 | 加载到内存，之后才能 generate / chat |
+| generate | `prompt`，可选 `maxNewTokens`、`onToken` | 单轮生成，`onToken` 收流式增量 |
+| chat | `messages[]`（`role` + `content`），可选 `maxNewTokens`、`onToken` | 多轮对话，历史由调用方自己维护 |
+| stop | 无 | 打断当前生成 |
+| unload | 无 | 卸载已加载模型 |
+
+### 参数
+
+`loadModel`
+
+| 字段 | 说明 | 默认 |
+| --- | --- | --- |
+| modelPath | 模型目录 | - |
+| bundledModelName | 内置模型名 | - |
+| useMetal | iOS Metal，失败回退 CPU | `false` |
+| temperature | 采样温度 | `0.7` |
+| topP | 核采样 | `0.8` |
+| topK | 候选数 | `20` |
+| repetitionPenalty | 重复惩罚 | `1.05` |
+
+`generate`：`prompt`、`maxNewTokens`、`onToken`。`chat`：`messages`（`role` 为 `system` / `user` / `assistant` / `tool` / `json`）、`maxNewTokens`、`onToken`。
+
+### 平台差异
+
+1. 完整能力在 iOS / Android。鸿蒙无内置模型，ZIP 安装受限。
+2. 无 Web / 微信。
+
+### 版本
+
+版权归https://xui.tmui.design你不得修改及二次开发，仅供TMUI4会员商用使用。不得转给非VIP会员使用，一经查实数倍赔偿，并追究法律责任。
+
+## 更新日志
+
+### 1.0.0（2026-07-31）
+- 支持安卓和IOS下的MNN格式的大模型，作者提供提前编译好的Qwen3.6 0.6b模型供下载测试。
+- 新增 iOS UTS API 骨架。
+- 新增模型加载、流式生成、停止、卸载及运行时信息接口。
+- 拒绝直接加载 GGUF，避免与 MNN 模型格式混用。
+- 内置 MNN 3.6.1 iOS arm64 静态 Framework，启用 CPU、Metal 和 LLM。
+- 接入 Objective-C++ 推理层，支持真实模型加载、流式生成、停止和卸载。
+- 完成 iPhone XS Max + Qwen3-0.6B-MNN INT4 真机验证。
+- 针对 A12 Metal Attention 崩溃增加 A14 安全门槛和 CPU 自动回退。

package/data/tmui4x/10./346/217/222/344/273/266/345/272/223/xModalS /345/257/271/350/257/235/346/241/206.md"

@@ -0,0 +1,124 @@
+# x-modal-s 对话框
+
+居中对话框，用来替代 `uni.showModal`。支持自定义按钮、图标、对齐和遮罩，连续调用会自动关掉上一条。
+
+**微信内使用官方 `uni.showModal`，样式字段不生效，仅保留签名。**
+
+### 兼容性
+
+| Harmony | IOS | Android | WEB | 小程序 |
+| --- | --- | --- | --- | --- |
+| 支持 | 支持 | 支持 | 支持 | 支持（官方 Modal） |
+
+### 调用
+
+```ts
+import { showModal, X_MODAL_TYPE } from "@/uni_modules/x-modal-s"
+
+showModal({
+  title: "提醒",
+  content: "这是一条测试消息对话框，默认按钮分离。",
+  confirmText: "确定",
+  cancelText: "取消",
+  isSplitBtn: true,
+  clickMaskClose: true,
+  confirm: () => {
+    console.log("确认")
+  },
+  cancel: () => {
+    console.log("取消")
+  },
+  close: () => {
+    console.log("已关闭")
+  }
+} as X_MODAL_TYPE)
+
+showModal({
+  title: "协议",
+  isHtml: true,
+  content: "<p>请阅读<a href=\"https://xui.tmui.design\">服务协议</a>后继续。</p>",
+  clickLink: (href) => {
+    console.log(href)
+  }
+} as X_MODAL_TYPE)
+```
+
+### 方法
+
+| 名称 | 需要 | 说明 |
+| --- | --- | --- |
+| showModal | `X_MODAL_TYPE` | 弹出对话框，连续调用会关掉上一条 |
+
+### 参数
+
+`X_MODAL_TYPE`
+
+| 字段 | 说明 | 默认 |
+| --- | --- | --- |
+| title | 标题 | `提醒` |
+| content | 内容。`isHtml` 为 true 时按 HTML 解析清洗 | `""` |
+| isHtml | 启用 HTML 渲染与链接回调。App 用内置 Lexbor 清洗，Web 用 UTS 解析器。微信忽略 | `false` |
+| contentAlign | `center` 居中 / `left` 顶左 | `center` |
+| titleColor | 标题色 | `#000000` |
+| contentColor | 内容色 | `#333333` |
+| linkFontColor | 内容链接色 | `rgb(5,121,255)` |
+| confirmText | 确认文字 | `确认` |
+| confirmColor | 确认文字色 | `#FFF` |
+| confirmBgColor | 确认底色 | `#0579FF` |
+| confirmIcon | 确认 Remix 图标 unicode。微信不支持 | `""` |
+| cancelText | 取消文字 | `取消` |
+| cancelColor | 取消文字色 | `#333` |
+| cancelBgColor | 取消底色 | `#f5f5f5` |
+| cancelIcon | 取消 Remix 图标 unicode。微信不支持 | `""` |
+| showCancel | 是否显示取消 | `true` |
+| isSplitBtn | 按钮是否分离 | `true` |
+| lineColor | 不分离时的分割线色 | 透明 |
+| contentBgColor | 面板底色 | `#fff` |
+| maskBgColor | 遮罩色 | `rgba(0,0,0,0.6)` |
+| radius | 圆角 px | `16` |
+| width | 宽度 px | `320` |
+| height | 高度 px | `80` |
+| clickMaskClose | 点击遮罩关闭 | `true` |
+| isBlurMask | 遮罩模糊，目前仅 Web 生效 | `true` |
+| confirm | 点确认 | - |
+| cancel | 点取消 | - |
+| close | 关闭完成 | - |
+| clickLink | 点内容链接。`isHtml` 为 true 时 Android / iOS / 鸿蒙 / Web 均可拦截 | - |
+
+没有 `success` / `fail` / `complete`，只用 `confirm` / `cancel` / `close`。
+
+### 平台差异
+
+1. 微信小程序：`uni.showModal`，仅 `title`、`content`、`confirmText`、`cancelText`、`showCancel` 等基础字段生效，无法主动关闭官方弹层。`isHtml` 与 `clickLink` 不生效。
+2. `isHtml`：Android / iOS / 鸿蒙用内置 Lexbor 依赖包清洗后再画；Web 用 UTS 解析器。都不依赖 `x-html-u`。未开启时按纯文本显示。鸿蒙弹窗是 ETS，不再使用原来的弹窗 HAR。
+3. `isBlurMask`：仅 Web 生效。
+
+### 版本
+
+版权归https://xui.tmui.design你不得修改及二次开发，仅供TMUI4会员商用使用。不得转给非VIP会员使用，一经查实数倍赔偿，并追究法律责任。
+
+## 更新日志
+
+### 1.0.9（2026-08-15）
+* 新增可选参数 `isHtml`：内容层解析清洗 HTML 后再渲染，并支持 `clickLink`。
+* 原生渲染性能强。可以直接代替官方的modal层。
+### 1.0.8（2026-04-21）
+* 修复可能存在的内存泄露风险
+### 1.0.7（2026-01-30）
+* 使用了sdk4.65+推出的接口来避免与官方的弹层冲突导致无法显示。
+### 1.0.6（2025-08-17）
+*  更新支持鸿蒙原生 Next，采用自己编译的 Har 包来支持
+### 1.0.5（2025-04-30）
+* ios,安卓,web内容现在可以渲染html内容,不要太复杂.安卓和web会拦截a标签,ios目前拦截不了会直接跳转外链.
+### 1.0.4（2025-04-13）
+* 安卓端弹层修改布局,现在可以覆盖官方的Dialog-page页面了,并且可以接受安卓的返回键及侧滑关闭弹层了.并且会自动隐藏状态栏,并可以覆盖底部安全区域
+### 1.0.3（2025-02-23）
+* 安卓添加了显示背景遮罩动画,及关闭遮罩动画
+* ios添加了显示背景遮罩动画,及关闭遮罩动画
+* 上述添加后,不管是显示和关闭都更加的自然
+### 1.0.2（2025-02-13）
+* 兼容微信
+### 1.0.1（2024-08-15）
+* 新增contentAlign,可以让内容顶左对齐,还是让内容左右上下居中对齐 .
+### 1.0.0（2024-08-06）
+安卓,ios,web可用。