tmui-cli 2.0.1 → 2.0.2

package/data/tmui4x/10./346/217/222/344/273/266/345/272/223/xCamreaU /345/216/237/347/224/237/347/233/270/346/234/272.md"

@@ -0,0 +1,106 @@
+# x-camrea-u 原生相机
+
+原生相机预览。拍照、录像、闪光灯、变焦、水印，以及预览帧输出（给人脸 / OCR 等）。
+
+插件目录名是 `camrea`，按这个拼写引用。
+
+### 兼容性
+
+| Harmony | IOS | Android | WEB | 小程序 |
+| --- | --- | --- | --- | --- |
+| 支持 | 支持 | 支持 | 支持 | 支持 |
+
+### 调用
+
+```vue
+<x-camrea-u
+  ref="cameraRef"
+  resolution="medium"
+  device-position="back"
+  flash="off"
+  :auto-open="true"
+  @done="onCameraDone"
+  @frame="onFrame"
+></x-camrea-u>
+```
+
+```ts
+cameraRef.value?.takePhoto({
+  format: "jpg",
+  quality: 85,
+  success: (r) => {
+    console.log(r.tempFilePath)
+  }
+})
+
+cameraRef.value?.startRecord({ withAudio: true })
+cameraRef.value?.stopRecord({
+  success: (r) => {
+    console.log(r.tempFilePath, r.duration)
+  }
+})
+```
+
+### 参数
+
+| 字段 | 说明 | 默认 |
+| --- | --- | --- |
+| resolution | `low` / `medium` / `high` | `medium` |
+| devicePosition | `front` / `back` | `back` |
+| flash | `auto` / `on` / `off` / `torch` | `off` |
+| frameSize | 预览档 `small` / `medium` / `large` | `medium` |
+| autoOpen | 初始化后自动开相机 | `true` |
+| enableFrame | 是否输出预览帧 | `false` |
+| frameThrottle | 帧最小间隔 ms，`0` 不限 | `100` |
+
+### 事件
+
+| 名称 | 参数 | 说明 |
+| --- | --- | --- |
+| done | `{ state, resolution, devicePosition, flash, frameSize, flashSupported, minZoom, maxZoom }` | 相机就绪 |
+| stop | `{ state, reason }` | 关闭、销毁或出错停止。`reason` 为 `close` / `destroy` / `error` |
+| error | `{ errSubject, errCode, errMsg }` | 打开或运行失败 |
+| frame | `{ width, height, format, rotation, mirrored, timestamp, data }` | 预览帧，仅 `enableFrame`。`format`：Android `nv21`，iOS `bgra`，鸿蒙 `rgba` |
+
+### 方法
+
+| 名称 | 需要 | 说明 |
+| --- | --- | --- |
+| open | 可选 `success` / `fail` / `complete` | 打开相机 |
+| close | 可选 `success` / `fail` / `complete` | 关闭相机 |
+| takePhoto | `format?`（jpg/png，默认 jpg）、`compressed?`（默认 true）、`quality?`（1~100，默认 85）、`maxWidth?` / `maxHeight?`（0 不限）、`success` | 拍照，成功返回 `tempFilePath`、宽高、大小 |
+| startRecord | `format?`（mp4）、`withAudio?`（默认 true）、`success` | 开始录像 |
+| stopRecord | 可选 `success` / `fail` / `complete` | 停止录像，成功返回 `tempFilePath`、`duration` |
+| setZoom | `zoom: number`（1 为不缩放） | 设置变焦，成功返回当前 / 最小 / 最大倍率 |
+| setWatermarks | `items[]`：`icon?`、`text?`、`fontSize?`、`color?`、`position?`（四角）、`margin?` | 设置预览和成片水印 |
+| getState | 无 | 返回当前状态：`idle` / `opening` / `ready` / `recording` / `stopped` / `destroyed` |
+
+### 平台差异
+
+1. Web 无真闪光灯和变焦（minZoom=maxZoom=1）。
+2. 鸿蒙图标水印不烧录到成片。
+
+### 版本
+
+版权归https://xui.tmui.design你不得修改及二次开发，仅供TMUI4会员商用使用。不得转给非VIP会员使用，一经查实数倍赔偿，并追究法律责任。
+
+## 更新日志
+
+### 1.1.0（2026-07-31）
+
+- 新增 `setWatermarks` Ref 方法：图标（左）+ 文字（右）水印，支持四角位置、字号、颜色
+- 水印在预览层实时显示，拍照后按「输出图片宽度 / 预览宽度」等比合成，预览与成图占比一致
+- 有水印时拍照跳过未压缩直出快速通道，保证水印必然合成
+
+### 1.0.0
+
+- Android CameraX 原生预览
+- 支持分辨率、摄像头朝向、闪光灯和预览帧尺寸属性
+- 支持相机初始化、终止和错误事件
+- 支持 JPEG/PNG 拍照、压缩质量和目标尺寸
+- 支持 MP4 录像及可选麦克风录音
+- 支持线性相机倍率控制
+- 使用 DCloud 风格 `success/fail/complete` 方法回调
+- 媒体文件保存到应用专属外部目录
+- 无闪光灯摄像头使用 `auto/off` 时可正常初始化
+- 关闭或销毁会取消尚未结束的权限请求，避免旧回调重启相机

package/data/tmui4x/10./346/217/222/344/273/266/345/272/223/xChatmarkdownU AI/350/201/212/345/244/251Markdown.md"

@@ -0,0 +1,102 @@
+# x-chatmarkdown-u AI聊天Markdown
+
+AI 聊天气泡的 Markdown 渲染。支持 GFM 表格、代码高亮、数学公式和流式追加。思考时间、重试、复制按钮请自己在外层做。
+
+### 兼容性
+
+| Harmony | IOS | Android | WEB | 小程序 |
+| --- | --- | --- | --- | --- |
+| 支持 | 支持 | 支持 | 支持 | 支持 |
+
+### 调用
+
+```vue
+<x-chatmarkdown-u
+  ref="bubbleRef"
+  :content="item.content"
+  :dark="false"
+  :font-size="14"
+  @linkclick="onLinkClick"
+  @codecopy="onCodeCopy"
+  @longpress="onLongPress"
+></x-chatmarkdown-u>
+```
+
+流式：
+
+```ts
+bubbleRef.value?.appendChunk(tokenText)
+bubbleRef.value?.finish()
+```
+
+只解析不渲染：
+
+```ts
+import { xChatMarkdownParse } from "@/uni_modules/x-chatmarkdown-u"
+
+xChatMarkdownParse(md, {
+  success: (res) => {
+    console.log(res.plainText, res.ir)
+  }
+})
+```
+
+### 参数
+
+| 字段 | 说明 | 默认 |
+| --- | --- | --- |
+| content | Markdown | `""` |
+| dark | 深色 | `false` |
+| fontSize | 基础字号 px | `15` |
+| reasoningTime | 推理秒数，组件不渲染 | `0` |
+| status | `idle` / `streaming` / `done` / `error`，组件不渲染 | `idle` |
+| errorMsg | 失败文案，组件不渲染 | `""` |
+| showRetry / showCopy | 兼容保留，组件不渲染按钮 | `true` |
+
+### 事件
+
+| 名称 | 参数 | 说明 |
+| --- | --- | --- |
+| sizechange | `{ width, height }` | 内容尺寸变化 |
+| linkclick | `{ href, text }` | 点击链接 |
+| codecopy | `{ lang, code }` | 点击代码块复制 |
+| longpress | `{ text }` | 长按气泡；App 端已复制纯文本 |
+| rendered | `{ blockCount, parseMs }` | 本次解析渲染完成 |
+| error | `{ errSubject, errCode, errMsg }` | 解析或渲染失败 |
+
+### 方法
+
+| 名称 | 需要 | 说明 |
+| --- | --- | --- |
+| setContent | `content: string` | 全量更新 Markdown |
+| appendChunk | `chunk: string` | 流式追加一段文本 |
+| finish | 无 | 结束流式，立刻把剩余内容渲染完 |
+| getContent | 无 | 返回当前原始 Markdown |
+| getPlainText | 无 | 返回纯文本，可用来复制整条 |
+| getIR | 无 | 返回渲染中间层 JSON |
+| xChatMarkdownParse | `md`，可选 `success` / `fail` / `complete` | 只解析不渲染，独立函数 |
+
+### 版本
+
+版权归https://xui.tmui.design你不得修改及二次开发，仅供TMUI4会员商用使用。不得转给非VIP会员使用，一经查实数倍赔偿，并追究法律责任。
+
+## 更新日志
+
+### 1.1.0（2026-08-04）
+
+- Web / 微信小程序：Emscripten 编译独立 `.wasm` + ES6 glue（`export default`），与 App 共用同一套 IR
+- Web：`uni.request` 拉 wasm + `instantiateWasm`（对齐 uni-cmark web）
+- 小程序：`WXWebAssembly.instantiate(包内路径)`（`static/mp-weixin/*.wasm`，对齐 uni-cmark loader）
+- 新增 `x-chatmarkdown-u-node` 递归块节点；数学字体 base64 `@font-face`
+- 重新编译：`bash native-src/web/build_wasm.sh`
+
+### 1.0.0（2026-08-03）
+
+- 首个版本
+- cmark-gfm 0.29.0.gfm.13 C 核心交叉编译三端（Android AAR / iOS Framework / HarmonyOS HAR）
+- GFM 解析：标题、加粗/斜体/删除线、行内代码、链接、引用、有序/无序/任务列表、表格（对齐）、分割线
+- 代码块：语言标签 + 右上角复制 + 通用关键字高亮（kotlin/java/swift/js/ts/python/c/cpp/go/rust/bash/sql/json/dart/ruby/lua/php/html/css 等）
+- 数学公式：块级 `$$...$$` 与 ```math 代码块、行内 `$...$`，LaTeX 符号 Unicode 化渲染（\frac、\sqrt、上下标等）
+- 流式渲染：appendChunk 节流解析 + 块级 hash 缓存复用
+- 交互：长按复制整条气泡、代码块复制、链接点击事件
+- 独立 API `xChatMarkdownParse`：导出 IR 中间件供自行渲染；组件暴露 `getIR/getPlainText/getContent`

package/data/tmui4x/10./346/217/222/344/273/266/345/272/223/xChinesetopinyinS /344/270/255/346/226/207/350/275/254/346/213/274/351/237/263.md"

@@ -0,0 +1,71 @@
+# x-chinesetopinyin-s 中文转拼音
+
+中文转拼音，同时返回无声调和带声调两种结果。
+
+### 兼容性
+
+| Harmony | IOS | Android | WEB | 小程序 |
+| --- | --- | --- | --- | --- |
+| 支持 | 支持 | 支持 | 支持 | 支持 |
+
+### 调用
+
+```ts
+import { toPinyin, XChineseToPinyinResult } from "@/uni_modules/x-chinesetopinyin-s"
+
+toPinyin({
+  char: "你好",
+  success: (res : XChineseToPinyinResult) => {
+    console.log(res.detail)  // ni hao
+    console.log(res.zhuyin)  // nǐ hǎo
+  },
+  fail: (error) => {
+    console.log(error.errCode, error.errMsg)
+  }
+})
+```
+
+### 方法
+
+| 名称 | 需要 | 说明 |
+| --- | --- | --- |
+| toPinyin | `char`，可选 `success` / `fail` / `complete` | 转拼音，成功返回 `detail`（无声调）和 `zhuyin`（有声调） |
+
+### 参数
+
+`XChineseToPinyinOptions`
+
+| 字段 | 说明 | 默认 |
+| --- | --- | --- |
+| char | 待转换字符串，不能为空 | 必填 |
+| success | 成功 | - |
+| fail | 失败 | - |
+| complete | 结束，失败时为 `null` | - |
+
+`XChineseToPinyinResult`
+
+| 字段 | 说明 |
+| --- | --- |
+| char | 原始输入 |
+| detail | 无声调拼音，空格分音节，小写 |
+| zhuyin | 带声调拼音，空格分音节，小写 |
+
+错误码：`1001` 系统错误，`1002` 参数错误（`char` 为空）。
+
+### 版本
+
+版权归https://xui.tmui.design你不得修改及二次开发，仅供TMUI4会员商用使用。不得转给非VIP会员使用，一经查实数倍赔偿，并追究法律责任。
+
+## 更新日志
+
+### 1.1.0（2026-07-31）
+- 统一对外 API 为规范命名 `toPinyin`
+- 删除非规范命名及旧类型定义
+- 统一五端 `success`、`fail`、`complete` 回调行为与结果结构
+- 增加 DCloud 风格公共类型、`UniError` 错误对象和参数校验
+- 修正 HarmonyOS 声调转换逻辑，统一输出格式
+
+### 1.0.1（2025-10-09）
+支持Android,iOS,Harmony,web/h5,小程序
+### 1.0.0（2024-06-1）
+安卓,ios支持。

package/data/tmui4x/10./346/217/222/344/273/266/345/272/223/xChooseFileS /346/226/207/344/273/266/351/200/211/346/213/251.md"

@@ -0,0 +1,77 @@
+# x-chooseFile-s 文件选择
+
+按 `type` 选择图片、视频或任意文件。五端接口对齐，无需额外申请相册/存储权限。
+
+### 兼容性
+
+| Harmony | IOS | Android | WEB | 小程序 |
+| --- | --- | --- | --- | --- |
+| 支持 | 支持 | 支持 | 支持 | 支持 |
+
+### 调用
+
+```ts
+import { chooseFile } from "@/uni_modules/x-chooseFile-s"
+
+chooseFile({
+  type: "image",
+  count: 3,
+  success: (res) => {
+    console.log(res.tempFilePaths)
+    res.tempFiles.forEach((f) => {
+      console.log(f.name, f.size, f.fileType, f.mimeType, f.path)
+    })
+  },
+  fail: (err) => {
+    console.log(err.errCode, err.errMsg)
+  }
+})
+```
+
+### 方法
+
+| 名称 | 需要 | 说明 |
+| --- | --- | --- |
+| chooseFile | `type?`、`count?`、`extension?`、`success` | 打开系统选择器，成功返回 `tempFilePaths` / `tempFiles` |
+
+### 参数
+
+`XChooseFileOptions`
+
+| 字段 | 说明 | 默认 |
+| --- | --- | --- |
+| type | `image` / `video` / `file` / `all`。image、video 走相册；file、all 走文件选择器 | `all` |
+| count | 最多可选。Android 文件选择器无法硬限制，超出截断 | `9` |
+| extension | 扩展名过滤，带不带点均可。仅 `file` / `all`；微信仅 `file` | - |
+| success | 成功 | - |
+| fail | 失败 | - |
+| complete | 结束 | - |
+
+`XChooseFileResult`
+
+| 字段 | 说明 |
+| --- | --- |
+| tempFilePaths | 临时路径列表 |
+| tempFiles | 文件详情 |
+
+`XChooseFileTempFile`
+
+| 字段 | 说明 |
+| --- | --- |
+| path | 临时路径。Android 为 `file://` + `getCacheDir()` 绝对路径（蒸汽模式 `unifile://cache` 也指向这里，不要写 `getExternalCacheDir()`）；iOS 为 `unifile://cache/x-choosefile/...`；Web 为 blob；鸿蒙为带临时授权的 uri |
+| name | 文件名 |
+| size | 字节数，未知为 0 |
+| fileType | `image` / `video` / `file` |
+| mimeType | MIME，未知为空 |
+
+错误码：`1001` 系统错误，`1002` 参数错误，`1004` 权限拒绝，`1005` 正在选择，`1006` 用户取消，`1008` 平台不支持。
+
+### 平台差异
+
+1. `type=all`：App / Web 打开系统文件选择器；微信从聊天会话选文件。
+2. iOS 12–13：图片/视频一次只能选 1 个。选中的文件拷到 `Library/Caches/x-choosefile/`，路径为 `unifile://cache/x-choosefile/...`，给 `uni.getFileSystemManager()` 用。不要再把 `tmp` 绝对路径丢给 `readFile`，iOS 会报「文件路径没有这个文件」。
+3. Web 取消依赖浏览器 `cancel` 事件（Chrome 113+ / Safari 16.4+），旧浏览器取消可能无回调。
+
+### 版本
+
+版权归https://xui.tmui.design你不得修改及二次开发，仅供TMUI4会员商用使用。不得转给非VIP会员使用，一经查实数倍赔偿，并追究法律责任。

package/data/tmui4x/10./346/217/222/344/273/266/345/272/223/xChooseMediaS /345/252/222/344/275/223/351/200/211/346/213/251/345/231/250.md"

@@ -0,0 +1,109 @@
+# x-chooseMedia-s 媒体选择器
+
+从系统相册选择或用系统相机拍摄。`chooseImage` 与 `chooseVideo` 分开，不绘制自定义选择器，不引入第三方库。
+
+微信走 `wx.chooseImage` / `wx.chooseVideo`。
+
+### 兼容性
+
+| Harmony | IOS | Android | WEB | 小程序 |
+| --- | --- | --- | --- | --- |
+| 支持 | 支持 | 支持 | 支持 | 支持 |
+
+### 调用
+
+```ts
+import { chooseImage, chooseVideo, XChooseImageOptions, XChooseVideoOptions } from "@/uni_modules/x-chooseMedia-s"
+
+chooseImage({
+  count: 3,
+  sourceType: ["album", "camera"],
+  sizeType: ["compressed"],
+  outputType: "jpg",
+  quality: 80,
+  success: (res) => {
+    console.log(res.tempFilePaths)
+  }
+} as XChooseImageOptions)
+
+chooseVideo({
+  sourceType: ["camera"],
+  compressed: true,
+  maxDuration: 15,
+  camera: "back",
+  quality: "medium",
+  success: (res) => {
+    console.log(res.tempFilePath, res.duration, res.width, res.height)
+  }
+} as XChooseVideoOptions)
+```
+
+### 方法
+
+| 名称 | 说明 |
+| --- | --- |
+| chooseImage | 选图或拍照，输出 jpg / png |
+| chooseVideo | 选视频或录像，输出 mp4 |
+
+### 来源
+
+| sourceType | 行为 |
+| --- | --- |
+| 仅 `album` | 系统相册 / 照片选择器 |
+| 仅 `camera` | 系统相机 |
+| 同时指定 | 微信走官方双来源；App 用系统 ActionSheet 再进入相机或相册；Web 用 `<input type=file>`（移动端通常会同时提供拍摄与相册） |
+
+相册使用系统选择器，不申请存储/相册权限（iOS 12–13 相册降级除外）。拍摄会申请相机；录像额外申请麦克风。
+
+### 图片
+
+| 字段 | 默认 | 说明 |
+| --- | --- | --- |
+| count | 9 | 最多张数，拍照固定 1 |
+| sizeType | `['compressed']` | `compressed` 压缩；仅 `original` 时只转格式 |
+| outputType | `jpg` | `jpg` / `png` |
+| quality | 压缩 80 / 原图 92 | 1–100，仅 jpg 有效 |
+
+无论源是 heic / webp / 其它格式，最终都写成 jpg 或 png。
+
+### 视频
+
+| 字段 | 默认 | 说明 |
+| --- | --- | --- |
+| compressed | true | 压缩并转为 mp4 |
+| maxDuration | 60 | 拍摄最长秒数，1–60 |
+| camera | back | 仅拍摄 |
+| quality | medium | `low` / `medium` / `high`，对应系统质量档 |
+
+无论源是 mov / 其它封装，最终尽量输出 mp4。
+
+Android 相册视频用系统 `MediaMuxer` 封装为 mp4；码率压缩主要在**拍摄**时由系统相机 `EXTRA_VIDEO_QUALITY` 完成。iOS 用 `AVAssetExportSession`。Harmony 用 `AVTranscoder`。Web 无法在浏览器内稳定转码为 mp4，返回浏览器给出的文件。
+
+### 错误码
+
+| 码 | 含义 |
+| --- | --- |
+| 1001 | 系统错误 |
+| 1002 | 参数错误 |
+| 1004 | 权限拒绝 |
+| 1005 | 正在选择 |
+| 1006 | 用户取消 |
+| 1008 | 平台不支持 |
+| 1009 | 压缩或转码失败 |
+
+### 版本
+
+版权归 https://xui.tmui.design 你不得修改及二次开发，仅供 TMUI4 会员商用使用。不得转给非 VIP 会员使用，一经查实数倍赔偿，并追究法律责任。
+
+## 更新日志
+
+### 1.0.3（2026-08-16）
+* iOS `Info.plist` 增加 `CFBundleDevelopmentRegion` / `CFBundleLocalizations`，相册和相机系统界面跟随中文。
+### 1.0.2（2026-08-16）
+* 修复鸿蒙 ArkTS：静态方法不用 this、对象字面量补类型、packToFile 改传文件 fd
+### 1.0.1（2026-08-16）
+* 修复鸿蒙模块名大小写：`module.json5` 必须与构建生成的 `uni_modules__x_choosemedia_s` 一致
+### 1.0.0（2026-08-16）
+* 新增 chooseImage / chooseVideo，仅使用系统相册、系统相机与系统压缩/转码
+* 图片统一输出 jpg 或 png，视频统一输出 mp4
+* 微信走 wx.chooseImage / wx.chooseVideo

package/data/tmui4x/10./346/217/222/344/273/266/345/272/223/xCorrectS /346/226/207/346/241/243/346/240/241/346/255/243/344/270/216/350/257/206/345/210/253.md"

@@ -0,0 +1,206 @@
+# x-correct-s 文档校正与识别
+
+文档扫描校正存储。内置模型及高效C++算法识别和处理。校正后可选用同一套 ONNX Runtime 跑 PP-OCRv5 mobile，扫完直接出字。
+
+### 兼容性
+
+| Harmony | IOS | Android | WEB | 小程序 |
+| --- | --- | --- | --- | --- |
+| 支持 | 支持 | 支持 | 不支持 | 不支持 |
+
+### 调用
+
+```ts
+import { openCorrect } from "@/uni_modules/x-correct-s"
+
+openCorrect({
+  title: "文档校正",
+  autoConfirm: false,
+  stretch: true,
+  ocr: true,
+  success: (res) => {
+    console.log(res.tempFilePaths)
+    console.log(res.tempFiles[0].text)
+    console.log(res.tempFiles[0].texts)
+  }
+})
+```
+
+`autoConfirm: true` 时不出现拉角和二次确认，适合连拍存档。找不到纸面四角时仍保存原图。`stretch: false` 时不做透视拉正：自动模式直接存原图；手动模式只显示预览图，打勾保存，不出现拉角和识别叠字。手动确认预览时右侧「完成」会隐藏，回到拍照界面再显示。
+
+拍照先冻结当前预览，界面不再跟着实时流走。三端接着用高清拍照口出存档图再拉正；找角和 OCR 按长边缩小。拍照失败才回退预览帧。
+
+`ocr: true` 时每张落盘后用内置 PP-OCRv5 mobile 识别，结果在 `tempFiles.text` / `texts` / `lines`。拼文本 PDF 用无坐标的 `texts`，按页换行连接、页间空一行即可。iOS 取 `texts` 不要用模板字符串，否则会变成 `Optional(文字)`。手动确认（`autoConfirm: false`）时识别完会停在拉正图上，文字盖在对应行上，长按该行可复制。`autoConfirm: true` 仍是连拍，不打断预览。模型没就绪或识别被阈值丢掉时会提示原因。改完请重新编译安装。也可单独调用：
+
+```ts
+import { ocrImage } from "@/uni_modules/x-correct-s"
+
+ocrImage({
+  path: imgPath,
+  success: (res) => {
+    console.log(res.text)
+  }
+})
+```
+
+### 方法
+
+| 名称 | 需要 | 说明 |
+| --- | --- | --- |
+| openCorrect | 可选标题、闪光、自动确认、是否拉伸、张数、ocr | 打开校正弹层；点完成走 `success`，点关闭走 `onClose` |
+| ocrImage | 图片路径 | 对已有图片做 PP-OCRv5 识别，返回 `text` / `lines` |
+
+### 参数
+
+| 字段 | 说明 | 默认 |
+| --- | --- | --- |
+| title | 顶栏标题 | 文档校正 |
+| cameraPosition | `front` / `back` | `back` |
+| torch | 初始闪光灯 | false |
+| autoConfirm | 自动校正并连拍 | false |
+| stretch | 是否透视拉正（矫正拉伸） | true |
+| maxCount | 最多张数 | 20 |
+| outputType | `jpg` / `png` | `jpg` |
+| quality | jpg 质量 | 92 |
+| ocr | 校正后识别文字 | false |
+
+`XCorrectFile`：`path`、`width`、`height`、`source`（`camera` / `album`）、`corrected`、`text`（全文）、`texts`（无坐标行数组）、`lines`（带框）。`ocrImage` 的 `text` 本身就是行数组。
+
+OCR 只处理印刷/手写文本行。竖排会先转成横条再认。表格结构、数学公式要另加版面和专用模型，不能靠 v5 rec 硬认。
+
+## 更新日志
+
+### 0.1.40（2026-08-20）
+- 安卓确认预览叠字按 10–28dp 计算，与 iOS 点、鸿蒙 vp 对齐，避免高分屏把 28 当成 28px。
+### 0.1.39（2026-08-20）
+- 三端增加 `stretch`：false 时自动模式直接存原图，手动模式只预览打勾，不出现拉角和识别叠字。
+- 手动确认预览图时隐藏右侧「完成」，回到拍照预览再显示，避免和打勾确认误触。
+### 0.1.38（2026-08-20）
+- 修复 iOS 拼文本 PDF 每行出现 `Optional(识别文字)`：解析 `texts` 不再用模板字符串，避免 String? 被打成 Optional。
+### 0.1.37（2026-08-20）
+- iOS 识别叠字层改为 `draw(in:)`，不再走 `draw(with:options:)`，避免页上出现 options 字样。
+### 0.1.36（2026-08-20）
+- 安卓 / iOS 与鸿蒙对齐：快门先冻结预览，存档走高清拍照（约 4K）；找角和 OCR 仍按长边缩小。拍照失败才回退预览帧。
+### 0.1.35（2026-08-20）
+- 竖横混排不再只出竖排：横排框不参与纵向合并，列间距按较小框收紧。
+- 鸿蒙快门先冻结预览，再走 PhotoOutput 高清拍照做识别/拉正；拍照失败才回退预览帧。拉角预览不再压到 1600。
+### 0.1.34（2026-08-20）
+- 竖排不再只出单字：连通域先纵向膨胀并合并同一列，瘦高框按 Paddle 那样逆时针转 90° 再送给横排 rec。
+### 0.1.33（2026-08-20）
+- OCR 已经能出字，但 rec 输出本身就是 softmax，再做一次软最大后分数变成 0.0001，被 0.30 阈值全部丢掉，所以只提示未识别到文字。
+- 检测预处理改成 PP-OCRv5 的 `[-1,1]`，框阈值 0.5。
+### 0.1.32（2026-08-20）
+- 鸿蒙 OCR 识别模型按 ORT 1.16 降到 ONNX IR 8。之前 rec 是 IR 10，初始化失败只剩 `ocr model not ready`，校正图上也就没有文本层。
+- 三端 OCR 模型改放到 `ocr2` 缓存目录，避免沿用旧 rec；模型缺失或初始化失败会直接提示原因。
+### 0.1.31（2026-08-20）
+- 拍照先冻结当前预览帧并落盘，再识别/拉正。不再等高质量拍照完成，避免处理中手一动结果变成后面的画面。
+### 0.1.30（2026-08-20）
+- `tempFiles` 增加无坐标 `texts` 行数组，方便按页拼文本 PDF；`text` 仍是换行拼接的全文。
+
+### 0.1.29（2026-08-20）
+- 手动确认且 `ocr: true` 时，拉正识别后在图上叠字；长按该行复制。框坐标按落盘图尺寸缩放，对齐 FIT_CENTER。
+
+### 0.1.28（2026-08-20）
+- 复用已有 ONNX Runtime，内置 PP-OCRv5 mobile。`openCorrect({ ocr: true })` 扫完出字，也可单独 `ocrImage`。
+- 公式和表格仍按文本行识别，不做结构还原。
+
+### 0.1.27（2026-08-18）
+- 鸿蒙底栏相册、完成不再被中间快门层挡住，可正常点击。
+
+### 0.1.26（2026-08-18）
+- 三端去掉取景右侧白平衡、ISO 滑杆和光学防抖开关，相机恢复系统自动参数。
+
+### 0.1.25（2026-08-18）
+- 鸿蒙取景右侧滑杆改为固定竖轨并避开底栏，相册和完成不再被挡住。
+
+### 0.1.24（2026-08-18）
+- 白平衡 / ISO 默认 50 不再改相机自动参数，避免拍照裁切后发红。
+
+### 0.1.23（2026-08-18）
+- 取景右侧改为白平衡、ISO 竖滑杆（中间为自动），底部增加光学防抖开关（默认开，实心圆/空心圆）。三端都走相机实时参数，去掉不能实时生效的降噪和对比度。
+
+### 0.1.22（2026-08-18）
+- iOS 取景预览用 CIColorControls 实时套对比度，滑杆拖动即可看到效果。
+
+### 0.1.21（2026-08-18）
+- iOS / 鸿蒙没有公开的相机降噪参数，取景右侧只保留对比度；降噪滑杆仅安卓显示。
+
+### 0.1.20（2026-08-18）
+- 取景右侧增加降噪、对比度竖滑杆（0–100，默认 50）。安卓优先走相机硬件参数，不支持时与 iOS / 鸿蒙一样在拍照后做软件处理；相册图不改。
+
+### 0.1.19（2026-08-18）
+- 主检测改为 DocAligner LCNet100 热力图（约 4.6MB），四角仍走原有贴边精修；模型不够格时回退传统算法。
+
+### 0.1.18（2026-08-18）
+- 底栏取消/打勾居中后不再被左右裁切，圆钮保持 64 完整显示。
+
+### 0.1.17（2026-08-18）
+- 拉角时取消和打勾作为一组在底栏左右居中，不再把取消挤到相册图标上。
+
+### 0.1.16（2026-08-18）
+- 安卓缩略图拖排序对齐 iOS：浮层跟手，原位留空档，只移动空位，松手后再落图。
+
+### 0.1.15（2026-08-18）
+- 手动确认拉角时，打勾左侧增加同尺寸 X 取消；取消后丢掉本张，回到预览拍照，取消按钮随即隐藏。
+
+### 0.1.14（2026-08-18）
+- iOS 相机改为连续对焦。
+- 三端拍照先落盘再出「处理中」，裁切按最长边 4096 再套预览比例，避免先缩到 2048 后宽只剩 800 多。
+- 拉正输出最长边改为 4096。
+
+### 0.1.13（2026-08-18）
+- 安卓全屏不再被状态栏顶下来：藏起状态栏后只按 insets 让一次顶栏/底栏。
+- 安卓相机改为连续对焦，预览走 1080p Surface，点预览可对焦。
+
+### 0.1.12（2026-08-18）
+- 识别先走约 2MB 的四角小模型（DocCornerNet LEAN），分数够且通过外框校验后贴边精修；模型未加载或不可信时回退 0.1.10 传统算法。
+
+### 0.1.11（2026-08-18）
+- 拍照后按预览 Cover 可视区域居中裁切，识别和拉正只处理当时看到的画面，不再带上预览外的左右杂物。
+
+### 0.1.10（2026-08-18）
+- 识别在现有 C++ 上加 Hough 四边相交、分块拉对比、纸面颜色先验和真 Canny，半张纸和中间纸更稳，仍丢掉贴照片外框的候选。
+
+### 0.1.9（2026-08-18）
+- 识别按扫描器主流管线重做：提对比、闭运算补纸面、轮廓+多团块打分。
+- 丢掉贴照片外框的候选，半张纸会沿边缘外扩，减少框到屏幕边和只框一半。
+
+### 0.1.8（2026-08-18）
+- 识别增加局部明暗自适应，并在找到纸面后把四角贴到边缘，角更准。
+- 三端缩略图条上下加间隙，选中白边不再被裁掉一点。
+
+### 0.1.7（2026-08-18）
+- 三端缩略图长按拖动改为跟手让位：拖着的块浮起，其余块立刻腾出空位，松手后顺序生效。
+
+### 0.1.6（2026-08-18）
+- 识别和拉正改为 RGBA 二进制直传，不再把像素塞进 JSON/Base64。
+- 鸿蒙预览改为显示与识别同一张已校正朝向的图，四角与纸面对齐。
+
+### 0.1.5（2026-08-18）
+- 纸面检测改回亮暗团块四角，收紧对边比例，减少误判成大梯形。
+- 拉正最长边改为 2048，去掉整图锐化，处理更快；鸿蒙不再整包 JSON.parse 大图，避免自动校正闪退。
+- 识别和拉正时显示「处理中...」。
+
+### 0.1.4（2026-08-18）
+- 缩略图条支持长按拖动排序，完成回传按调整后的顺序。
+
+### 0.1.3（2026-08-17）
+- 未识别到纸面时提示「未识别到区域，请重新拍摄」，丢弃本张并继续预览。
+- 三端拍照改为高分辨率，拉正按最长边 4096 取样并轻度锐化，减轻校正后发糊。
+- 纸面检测改为轮廓四边形 + 局部亮暗团块 + 多阈值回退，提高找纸成功率。
+- 安卓快门改为 64dp 正圆容器，避免 TextView 被底栏权重拉成椭圆。
+
+### 0.1.2（2026-08-17）
+- 未识别到纸面时提示重拍并丢弃本张，不再进入拉角。
+- 拉正改为按更高分辨率原图取样，减轻校正后发糊。
+- 纸面检测改为亮暗团块四角 + 边缘回退，并放宽满幅稿面。
+- 安卓快门改为固定 64dp 正圆，避免被底栏权重拉成椭圆。
+
+### 0.1.1（2026-08-17）
+- 安卓 AAR 的 classes.jar 放入占位 class，避免 HBuilderX R8 把空 jar 报成文件不存在。
+- 鸿蒙拍照预览改为沙箱 URI，避免 Image 吃绝对路径黑屏。
+- iOS 缩略图条按内容宽度排布，选中项不再被拉满整行。
+- 三端四角覆盖层提到顶栏/底栏之上，只拦截手柄触摸，标题区也能拖。
+
+### 0.1.0（2026-08-17）
+- 首版：三端原生校正弹层，手动拉角与自动连拍，完成回传临时图片。