tmui-cli 2.0.1 → 2.0.3

package/data/tmui4x/10./346/217/222/344/273/266/345/272/223/xMakephoneS /346/213/250/346/211/223/347/224/265/350/257/235.md"

@@ -0,0 +1,59 @@
+# x-makephone-s 拨打电话
+
+拨打电话，对齐 `uni.makePhoneCall` 的跨端调用。
+
+### 兼容性
+
+| Harmony | IOS | Android | WEB | 小程序 |
+| --- | --- | --- | --- | --- |
+| 支持 | 支持 | 支持 | 支持 | 支持 |
+
+### 调用
+
+```ts
+import { makePhone, XMakePhoneOptions } from "@/uni_modules/x-makephone-s"
+
+makePhone({
+  tel: "10086",
+  success: (res) => {
+    console.log(res.errCode)
+  },
+  fail: (err) => {
+    console.log(err.errCode, err.errMsg)
+  }
+} as XMakePhoneOptions)
+```
+
+### 方法
+
+| 名称 | 需要 | 说明 |
+| --- | --- | --- |
+| makePhone | `tel`，可选 `success` / `fail` / `complete` | 调起拨号 |
+
+### 参数
+
+`XMakePhoneOptions`
+
+| 字段 | 说明 | 默认 |
+| --- | --- | --- |
+| tel | 电话号码 | 必填 |
+| success | 成功，`errCode` 为 0 | - |
+| fail | 失败 | - |
+| complete | 结束 | - |
+
+错误码：`1001` 缺少号码，`1002` 不支持或失败，`1003` 拨号权限被拒绝（Android）。
+
+### 平台差异
+
+1. Android 10+ 打开拨号盘；更低版本可能直接拨打。
+2. 微信走 `wx.makePhoneCall`。
+
+### 版本
+
+版权归https://xui.tmui.design你不得修改及二次开发，仅供TMUI4会员商用使用。不得转给非VIP会员使用，一经查实数倍赔偿，并追究法律责任。
+
+## 更新日志
+
+### 1.0.0（2026-07-31）
+
+- 持 Android / iOS / HarmonyOS / Web / 微信小程序

package/data/tmui4x/10./346/217/222/344/273/266/345/272/223/xMediaplayS /345/252/222/344/275/223/346/222/255/346/224/276/344/270/216/345/275/225/345/210/266.md"

@@ -0,0 +1,151 @@
+# x-mediaplay-s 媒体播放与录制
+
+音频播放与录音。播放走系统播放器；录音输出 mp3 / wav。全局单例，新的播放或录音会抢占上一会话。
+
+### 兼容性
+
+| Harmony | IOS | Android | WEB | 小程序 |
+| --- | --- | --- | --- | --- |
+| 支持 | 支持 | 支持 | 支持 | 支持 |
+
+### 调用
+
+```ts
+import { startRecord, stopRecord, play, pause, resume, stop } from "@/uni_modules/x-mediaplay-s"
+
+startRecord({
+  format: "mp3",
+  sampleRate: 16000,
+  channelCount: 1,
+  bitrate: 48,
+  maxDurationMs: 60000,
+  levelInterval: 150,
+  onLevel: (db) => {
+    console.log(db)
+  },
+  onWave: (value) => {
+    console.log(value)
+  },
+  success: (res) => {
+    console.log(res.path, res.durationMs)
+  }
+})
+
+play({
+  url: recordedPath,
+  autoplay: true,
+  volume: 1,
+  infoInterval: 300,
+  onInfo: (info) => {
+    console.log(info.state, info.current, info.total)
+  }
+})
+```
+
+### 方法
+
+| 名称 | 需要 | 说明 |
+| --- | --- | --- |
+| play | `XMediaPlayOptions`，见下方 | 播放音频，会抢占上一会话 |
+| pause | 无 | 暂停 |
+| resume | 无 | 从暂停处继续 |
+| stop | 无 | 停止播放 |
+| seek | `positionMs: number` | 跳到指定毫秒 |
+| setVolume | `volume: number`，0~1 | 设置音量 |
+| getPlayInfo | 无 | 返回 `{ current, total, state, percent }` |
+| isPlaying | 无 | 是否正在播放 |
+| startRecord | `XMediaRecordOptions`，见下方 | 开始录音，会抢占上一会话 |
+| stopRecord | 无 | 停止并保存，走 `success` |
+| cancelRecord | 无 | 取消并丢弃当前录音 |
+| getRecordState | 无 | 返回 `idle` / `recording` / `stopping` |
+| isRecording | 无 | 是否正在录音 |
+| getVersion | 无 | 原生核心版本，微信为空 |
+
+### 参数
+
+`XMediaPlayOptions`
+
+| 字段 | 说明 | 默认 |
+| --- | --- | --- |
+| url | 本地 / http(s) / blob | 必填 |
+| autoplay | 就绪后自动播 | `true` |
+| loop | 循环 | `false` |
+| volume | 音量 0~1 | `1` |
+| startPosition | 起播位置 ms | `0` |
+| infoInterval | `onInfo` 间隔 ms，小于 100 按 100 | `500` |
+| onInfo | 进度与状态 | - |
+| success | 起播成功 | - |
+| fail | 失败 | - |
+| complete | 结束 | - |
+
+`XMediaRecordOptions`
+
+| 字段 | 说明 | 默认 |
+| --- | --- | --- |
+| format | `mp3` / `wav` | `mp3` |
+| sampleRate | 采样率，wav 可用 44100 | `16000` |
+| channelCount | 声道 | `1` |
+| bitrate | mp3 码率 kbps，wav 忽略 | `48` |
+| maxDurationMs | 到点自动 success | `60000` |
+| savePath | 输出路径，Web 忽略 | 各端缓存 |
+| levelInterval | `onLevel` / `onWave` 间隔 ms | `200` |
+| onLevel | 音量 dBFS，[-100, 0] | - |
+| onWave | 波纹峰值，[-1, 1]；微信不回调 | - |
+| success | 正常结束 | - |
+| fail | 失败 | - |
+| complete | 结束 | - |
+
+`XMediaPlayInfo`：`current` / `total`（ms，未知为 -1）、`state`、`percent`（缓冲 0~100）。
+
+`XMediaRecordResult`：`path`、`format`、`durationMs`、`size`、`sampleRate`、`channelCount`。Web 的 `path` 为 blob。
+
+### 平台差异
+
+1. Web 需 HTTPS 或 localhost；`savePath` 忽略；无用户手势时 autoplay 可能失败。
+2. 微信：`onLevel` / `onWave` 不回调（签名保留）；`maxDurationMs` 上限 600000；`getVersion()` 为空；结果为临时路径。
+3. 录音需要麦克风权限。
+
+### 版本
+
+版权归https://xui.tmui.design你不得修改及二次开发，仅供TMUI4会员商用使用。不得转给非VIP会员使用，一经查实数倍赔偿，并追究法律责任。
+
+## 更新日志
+
+### 1.0.3（2026-08-15）
+
+**录制增加 `onWave` 波纹回调**。录制期间按 `levelInterval` 上报当前采集窗的归一化峰值，范围 `[-1, 1]`，方便外部画微信/iOS 式波形。Android / iOS / HarmonyOS / Web 从 PCM 取绝对值最大采样并保留符号；微信小程序无采集帧接口，签名保留但不回调。测试页用不超过 12 根柱循环展示录制波纹。
+
+### 1.0.2（2026-08-05）
+
+**修复单声道 MP3 录音全是噪声（滋滋声）**。共享核心的 `Mp3Encoder` 一律调用
+`lame_encode_buffer_interleaved`，而该接口内部把读取步长写死为 2（`lame_copy_inbuffer(..., jump=2)`），
+只适用于立体声交错数据。单声道缓冲区只有 `frames` 个采样，LAME 却按 `pcm[0], pcm[2], … pcm[2*frames-2]`
+去读，导致两个后果叠加：前半段信号被抽取成二倍频混叠，后半段读到缓冲区之外的堆内存。
+默认录音配置就是单声道，因此 Android / iOS / HarmonyOS / Web 四端的 MP3 录音全部受影响（WAV 为裸拷贝，不受影响）。
+现改为单声道走步长为 1 的 `lame_encode_buffer`，立体声保持 interleaved。
+
+- 四端原生产物（HAR / AAR / framework / wasm）均已重新构建，升级后需重新打包自定义基座。
+- 宿主测试新增 `mono_mp3_fidelity`：编码 1kHz 单声道正弦后用 `afconvert` 解码回 PCM，
+  以 Goertzel 量测 1kHz 与 2kHz 分量。修复前 1kHz 幅度仅 0.75（原始音调消失），修复后为 15565。
+  此前的断言只检查文件魔数与大小，无法发现内容层面的损坏。
+
+### 1.0.1（2026-08-04）
+
+**单例与抢占语义**。插件全局仍只有一个播放器、一个录制会话，但不再要求调用方先 stop 再重新开始：
+
+- 播放：新的 `play()` 抢占旧会话，旧会话必定收到 `onInfo(stop)`；尚未起播成功的再补 `fail(1009)` + `complete(null)`。`stop()` 在起播就绪前调用也会补终态。此前旧 options 的回调会被静默丢弃，调用方永远等不到 `complete`，闭包也一直被 `@UTSJS.keepAlive` 持有。
+- 录制：`startRecord()` 在录制中调用时，先把上一段正常收尾（出文件、旧 `success` 拿到完整结果）再启动新录制，不丢数据；此前直接 `fail(1010)` 拒绝。
+- 五端共用新的 `libs/session.uts` 做会话仲裁，`success`/`fail`/`complete` 严格只触发一次，抢占后立即释放旧回调引用；被抢占会话的迟到事件按会话 id 丢弃。
+- HarmonyOS：`teardown` 改为等 `AudioCapturer` 真正 `stop()` + `release()` 完成后再置 idle 并回调 `onDone`，避免紧接着开新录音时撞上仍被占用的麦克风。
+- 错误码 1009 语义扩展为「操作已取消或被新的请求中断」，具体原因见 `errMsg`。
+
+### 1.0.0（2026-08-04）
+
+首个可用版本，五端（Android / iOS / HarmonyOS / Web / 微信小程序）播放与录制全部落地。
+
+**播放**：各端系统播放器统一到一套状态机与进度回调（`onInfo` + `success/fail/complete`），支持 `pause/resume/seek/setVolume/getPlayInfo`。
+
+**录制**：采集 PCM → C++ 共享核心（声道合并 + 有理数相位重采样 + 流式编码 MP3(LAME)/WAV）。
+Android 走 AudioRecord + JNI，iOS 走 AVAudioEngine + ObjC++，HarmonyOS 走 AudioCapturer + NAPI，
+Web 走 AudioWorklet + WASM，微信小程序走平台 RecorderManager 直出。
+支持时长上限自动停止（默认 60s）、`onLevel` 实时 dBFS 音量回调、`cancelRecord` 丢弃产物。

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 自动回退。