tmui-cli 2.0.2 → 2.0.3

package/data/guides//346/233/264/346/226/260/346/227/245/345/277/227.md

@@ -14,6 +14,8 @@ import headertips from '../components/headertips.vue'
 
 ### :couplekiss: 更新日志
 
+## 3.2.21（2026-09-07）
+* 优化一些组件及配置
 ## 3.2.20（2026-08-12）
 * 启用了Config全局配置，现在可以全局配置一些关键属性及主题
 * 内置了Vuei18n多语言配置，组件增加至8国语言

package/data/tmui4x/01./346/225/231/347/250/213/01./345/205/263/344/272/216.md

@@ -6,11 +6,15 @@ outline: deep
 
 ## TMUI4.0x
 
+4年磨一剑，从UTS VDOM到如今的蒸汽，再到 AI Coding时代，原生插件的爆发降低编写门槛，跨平台APP变得更原生，性能也更强劲，尽在TMUI4x 2.0蒸汽版本
+
+非蒸汽版本已在数月前终结，引来的是更简单更方便的蒸汽TS/JS的逻辑写法，从繁至简陪伴4年。
+
 一款好的UI/UX，不止是功能，它还应该要有设计感，层次感。注重细微及用户的反馈体验。同时要保留它的高度可扩展性及性能。
-功能的堆叠不是我所追求，也不是我的目标。我追求的是细致，可扩展，精美。不管是IOS，安卓，WEB/H5三端我都朝着这个方向。
+功能的堆叠不是我所追求，也不是我的目标。我追求的是细致，可扩展，精美。不管是IOS，安卓，WEB/H5，小程序我都朝着这个方向。
 让UNIAPPX 开发的商业应用更像商业应用。为让市场的组件审美提高一个档次而做出应有的贡献。
 
-### 2023/204 UTS插件官方赛事一等奖 / 第一名 / 第二名
+### 2023/2024 UTS官方赛事一等奖 / 二等奖获得者
 
 ### 入群讨论(公开群非VIP群)
 
@@ -21,28 +25,14 @@ outline: deep
 
 组件文档为自写的插件自动生成，组件开发时就按照了文档格式的规范写法。因此文档可以自动生成处理。如果遇到问题或者文档有误请联系我。
 
-## 关于组件收费问题
-
-组件tmui4.0 即xui，为收费版本，会一直更新迭代，并修复bug，之前的免费版本维护时间顺应延长，及时性没有这个版本快。我会建立 vip 群。
-付费会员讨论群一起探讨问题。
-
 ## 关于责任义务
 
 付费后我有义务提供稳定版本组件库。**但我没有义务为你解答所有问题及服务于你**。但我会尽量在有限的时间内快速响应你的问题。不管是否是组件问题，我都会回答。
 
 ## 付费后的授权问题？
 
-活动中的VIP种子用户可以不限制项目数量使用本组件及插件（声明包含在内且已授权的）。但你不得公开源码在项目中，你可以编译发现做任意项目数量。
+VIP用户可以不限制项目数量使用本组件及插件（声明包含在内且已授权的）。但你不得公开源码在项目中，你可以编译发现做任意项目数量。
 比如你为甲方做了个项目：如果甲方不要求给源码你编译发行就行，如果甲方要求源码意味着你需要为对方授权购买一份授权费用。
-只要原生插件标明：种子用户可免费使用均不需要二次付费和授权，非种子用户所有原生插件均要单独购买付费。但如果你购买了组件想再次购买插件可优惠。
-
-## 标签使用
-
-虽然是tmui4.0,但不再使用tm-开头的标签，x版本怕与tmui3.0冲突.
-
-因此使用x-开头的标签，但市场中已经有一个xui插件与我重名了。因此使用后，你将不能使用其它重名插件。
+只要原生插件标明：会员用户可免费使用均不需要二次付费和授权，非会员用户所有原生插件均要单独购买付费。但如果你购买了组件想再次购买插件可优惠。
 
-```vue
-<x-button></x-button>
-```
 

package/data/tmui4x/01./346/225/231/347/250/213/10./345/205/245/351/227/250/346/214/207/345/215/227/12./345/256/211/350/243/205.md

@@ -162,6 +162,7 @@ flowchart TB
 	等待窗口显示打包完毕 --> 运行到手机或模拟器 --> 选择你的真机或者模拟器运行 --> 编译运行提示第三方插件更新完成 --> 安卓同意安装完成
 	选择平台预览开发 --> web/h5 --> 运行到浏览器 --> chrome查看web预览
 	选择平台预览开发 --> 微信小程序 --> 运行到微信开发者工具 --> 待编译后自动打开工具
+	选择平台预览开发 --> 支付宝小程序 --> 运行到支付宝开发者工具 --> 待编译后自动打开工具
 	选择平台预览开发 --> 鸿蒙Next --> 配置相关证书及环境 --> 真机或者模拟器运行 --> 选择运行到鸿蒙
 
 ```

package/data/tmui4x/01./346/225/231/347/250/213/50.TMUI4x/350/222/270/346/261/275/350/256/241/345/210/222.md

@@ -4,9 +4,9 @@ outline: deep
 
 # TMUI4x蒸汽计划
 
-在等待官方停滞更新非蒸汽UNIAPPX近半年后。官方终于发布了SDK 5.23版本，将安卓纳入了正式蒸汽适配节点。
+TMUI4x 2.0即将到来了！蒸汽版本 C 渲染引擎 配上我的C 插件 相得益彰 ！！！
 
-官方宣传：蒸汽模式的渲染引擎是自有C引擎渲染排版布局。逻辑层由UTS原生还是回到了JS层面。
+逻辑层由UTS回到了JS层面。让逻辑层编写更为简单，门槛大大降低。
 
 ## 原生X项目与蒸汽对比
 
@@ -15,7 +15,7 @@ outline: deep
 | 渲染层 | 安卓和鸿蒙纯原生，IOS类似NVUE | 自有C渲染引擎，类似FL，RN | - |
 | 代码层 | UTS，安卓编译至KT，IOS->JS,鸿蒙->JS | JS | 蒸汽后可以全部JS/TS/UTS写 |
 | 严格语法 | UTS安卓严格，鸿蒙和IOS非严格 | 非严格且可随意 | - |
-| 性能 | 一般，但安卓无延迟高效 | 所渲染层与代码层分离 | 理论上蒸汽是JS通信渲染层有通信折损，非蒸汽纯原生高效跟手，如何看待就看各位看官感受了 |
+| 性能 | 一般，但安卓无延迟高效 | 渲染层与代码层分离 | 理论上蒸汽是JS通信渲染层有通信折损，非蒸汽纯原生高效跟手，如何看待就看各位实际感受了 |
 | 插件生态 | 无法使用NPM生态 | 可以使用（有限） | 蒸汽已经是JS了理论上所有NPM生态可用，但自己也考虑兼容，因为它也是有个V8层的 |
 | UTS插件 | 编译自各原生 | 编译自各原生 | 无区别，但非蒸汽没有通信折扣，蒸汽就是类似UNIAPP的JS调用原生API |
 | 平台兼容 | 5端 | 6端(未来有支付宝小程序) | 总体区别不大 |
@@ -34,13 +34,12 @@ outline: deep
 
 ## 何时发布2.0？
 
-这取决于我对Dcloud的蒸汽版本SDK的评估，时机到了自然就发布了。目前来看（截止2026-8月初）还不够 成熟 ，还未达到我认为可以商用的成熟度，从会员的反馈来看基础api，列表还有问题需要修复，建议大家再等 ，以我发布为准，未发布前可使用非蒸汽VDOM版本。
+这取决于我对Dcloud的蒸汽版本SDK的评估。
 
 ## 未来如何走？
 
 随着AI快速的发展，组件的层面意义被无限弱化，甚至可以说不太重要了，因此更新会越来越慢。因为ai可以搞定一切，组件的意义已经不大了。
 
-但是：解决方案变得更有意义，比如如何配置AI，如何使用ai自动化写页面，如何使用AI自动化写项目编译，这就是一整套的自动化流程。让ai真正在干活，强者恒强。
+AI诊断，AI测试，AI编写需求及插件更为顺应时代，但它需要一个更称手SKILL约束及MCP工具。
 
-因此未来：我也在变，不在是卖 组件 了，而是具身于AI底层要用到的基础插件和工具，UI层只是一个非常常规的一层了，因为不重要了。
-因此我将会编写各种SKILL和规则让ai协调写项目。欢迎大家支付一定费用支助 我 ，这也将助于你的项目高效化。
+完整的自动化即将到来。

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"

@@ -160,3 +160,32 @@ HTML 回写为 `<table class="x-table"><tr><td>…</td></tr></table>`，`setCont
 点选图片后出现尺寸、删除和缩放，对齐微信 `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/xModel3dU.md

@@ -0,0 +1,88 @@
+# x-model3d-u
+
+5 端静态 glTF 模型查看器。运行时只吃 **GLB 单文件**（无 Draco / meshopt / KTX2）。
+
+### 兼容性
+
+| Harmony | IOS | Android | WEB | 小程序 |
+| --- | --- | --- | --- | --- |
+| 支持 #| 支持 | 支持 | 支持 | 支持 |
+
+### 用法
+
+```uvue
+<x-model3d-u ref="viewerRef" :src="modelUrl" width="100%" height="420"
+  @load="onLoad" @error="onError" @progress="onProgress"></x-model3d-u>
+```
+
+```uts
+viewerRef.value!.fitToScreen()
+viewerRef.value!.resetView()
+viewerRef.value!.load(url)
+```
+
+统一方法：`load` / `fitToScreen` / `resetView` / `setCamera` / `getCamera` / `snapshot` / `getBounds`  
+统一事件：`ready` / `load` / `error` / `progress`
+
+微信小程序要改**两个文件**，少一个都跑不起来。
+
+`pages.json` 里注册原生组件（用到的页面各写一份，或写进 `globalStyle` 全局生效）：
+
+```json
+{
+  "globalStyle": {
+    "usingComponents": {
+      "x-model3d-xr": "/uni_modules/x-model3d-u/wxcomponents/x-model3d-xr/index"
+    }
+  }
+}
+```
+
+`manifest.json` 的 `mp-weixin` 段里打开按需注入：
+
+```json
+{
+  "mp-weixin": {
+    "lazyCodeLoading": "requiredComponents"
+  }
+}
+```
+
+`lazyCodeLoading` 必须写在 `manifest.json`，写进 `pages.json` 不生效。xr-frame 是非 webview 渲染器，微信强制要求整个小程序开启按需注入，漏了会在真机和开发者工具里直接报：
+
+```text
+a render renderer besides `webview` will be accepted only with `lazyCodeLoading` set to `requiredComponents`
+```
+
+OBJ / 散装 glTF 必须先走仓库根目录 `scripts/prepare_model.sh` 转成无扩展纯 GLB。树叶请把 alpha blend 改成 alpha mask。回归树可用 `node scripts/generate_tree_glb.mjs`。
+
+
+### 截图对比清单
+
+| 项 | 约定 |
+|---|---|
+| 模型 | Helmet、tree |
+| 机位 | yaw 30 / pitch 20 / fill 1.15 |
+| 背景 | `#1a1a1e` |
+| 自转 | 关 |
+| 输出 | 各端 `snapshot`（鸿蒙、微信暂不回读像素，用真机截屏） |
+
+### 包体量级
+
+| 端 | 增量 | 备注 |
+|---|---|---|
+| 鸿蒙 | 0 | 系统  3D |
+| 微信 | 0 | 客户端内置  |
+| Web | ~1.2MB | `three.module.js` + addons，随插件走 |
+| Android | ~7MB | 4.7MB，当前只打 arm64-v8a |
+| iOS | ~4.3MB | 预置（ios-arm64） |
+
+帧率 / 内存需真机测：建议 Helmet + tree 各看 10 秒轨道操作，记峰值 RSS 与平均 FPS。
+
+## 更新日志
+
+### 0.1.0（2026-08-27）
+
+- 新增 5 端静态 GLB 查看器：Android Filament、iOS SceneKit+GLTFKit2、鸿蒙 ArkGraphics 3D、Web three.js、微信 xr-frame
+- 统一 API：load / fitToScreen / resetView / setCamera / snapshot
+- 离线管线：`scripts/prepare_model.sh`、`scripts/generate_tree_glb.mjs`

package/data/tmui4x/10./346/217/222/344/273/266/345/272/223/xPreviewMediaS /345/233/276/347/211/207/350/247/206/351/242/221/346/267/267/345/220/210/351/242/204/350/247/210.md"

@@ -0,0 +1,160 @@
+# x-previewMedia-s 图片视频混合预览
+
+全屏预览图片与视频的混合列表，对齐微信 `wx.previewMedia`。横滑翻页、双击与双指缩放、下拉关闭、视频播放、长按菜单。
+
+微信小程序直通 `wx.previewMedia`，其余四端全部原生自绘，不依赖 `uni.previewImage`（它只吃图片）。
+
+
+### 兼容性
+
+| Harmony | iOS | Android | Web | 小程序 |
+| --- | --- | --- | --- | --- |
+| 支持 | 支持 | 支持 | 支持 | 支持（微信） |
+
+### 调用
+
+```ts
+import { previewMedia, closePreviewMedia, XPreviewMediaOptions } from "@/uni_modules/x-previewMedia-s"
+
+previewMedia({
+  sources: [
+    { url: "https://example.com/a.jpg" },
+    { url: "https://example.com/b.mp4", type: "video", poster: "https://example.com/b.jpg" },
+    { url: "/static/local.png" }
+  ],
+  current: 1,
+  showmenu: true,
+  onChange: (res) => {
+    console.log("切到", res.index, res.type, res.url)
+  },
+  onLongPress: (res) => {
+    console.log("长按", res.url)
+  }
+} as XPreviewMediaOptions)
+```
+
+### 方法
+
+| 名称 | 说明 |
+| --- | --- |
+| previewMedia | 打开全屏预览 |
+| closePreviewMedia | 主动关闭当前预览，微信端不支持 |
+
+`previewMedia` 的 `success` 表示预览层已打开，不是关闭时机；要拿关闭时机用 `onClose`。同一时刻只允许一个预览，重复调用返回 `1005`。
+
+### 参数
+
+| 字段 | 默认 | 说明 |
+| --- | --- | --- |
+| sources | 必填 | 资源列表，`url` 为空的项直接丢弃 |
+| current | 0 | 打开时停留的序号，越界会夹到合法区间 |
+| showmenu | true | 长按时是否弹菜单。关掉后 `onLongPress` 照常触发，只是不弹层 |
+| referrerPolicy | no-referrer | 拉远程资源时是否带 `Referer`，`origin` 时带资源自身 origin |
+| indicator | default | `default` 圆点 / `number` 数字 / `none` 不显示，微信端不支持 |
+| loop | false | 首尾循环滑动，微信端不支持 |
+| autoplay | false | 视频切到当前页自动起播，默认与微信一致靠点击起播 |
+| muted | false | 视频静音起播 |
+| menuItems | 空 | 长按菜单文案与顺序，为空则长按只抛事件不弹层，微信端不支持 |
+| menuItemColor | #000000 | 菜单文字颜色，iOS / Android / 鸿蒙 / Web 生效 |
+
+`sources[]` 的字段：
+
+| 字段 | 默认 | 说明 |
+| --- | --- | --- |
+| url | 必填 | 图片或视频地址，支持 `http(s)`、`file://`、本地静态资源 |
+| type | image | `image` / `video`，缺省按扩展名兜底 |
+| poster | 空 | 视频封面，仅 `type` 为 video 时生效，留空用首帧 |
+| liveVideo | 空 | 实况照片配对的 MOV 地址，仅 `type` 为 image 时生效，只有 iOS 渲染 |
+
+`type` 缺省时按扩展名兜底（`mp4 mov m4v 3gp mkv webm avi flv ts m3u8` 判为视频），判不出当图片。
+
+### 实况照片
+
+只有 iOS 支持，走系统原生 `PHLivePhotoView`。`url` 传静图，`liveVideo` 传配对的 MOV：
+
+```ts
+previewMedia({
+  sources: [
+    { url: "/static/live/IMG_0001.HEIC", liveVideo: "/static/live/IMG_0001.MOV" }
+  ]
+} as XPreviewMediaOptions)
+```
+
+交互是**点右上角的 LIVE 徽标播放**，徽标用的是系统 `livePhotoBadgeImage`。系统自带的「按住播放」手势被插件主动关掉了，否则会和长按菜单抢同一个手势；长按行为保持不变，仍然是抛 `onLongPress` 加弹菜单。图片放大或菜单弹着时不响应播放，切页会停掉上一页的播放。
+
+
+### 事件
+
+| 名称 | 触发时机 |
+| --- | --- |
+| onChange | 滑动切换资源后 |
+| onLongPress | 长按发生时，早于菜单弹出 |
+| onMenuTap | 菜单项被点击 |
+| onLoadError | 单项资源加载失败，预览不关闭 |
+| onClose | 预览关闭 |
+
+这些事件在微信端都不触发，微信的预览界面由系统接管，拿不到内部状态。
+
+### 长按菜单
+
+菜单是纯壳子：插件负责弹出、命中、收起，不执行任何动作。文案完全由 `menuItems` 决定，识别码、分享、存相册各接自己已有的插件：
+
+```ts
+previewMedia({
+  sources: [{ url: "https://example.com/qrcode.png" }],
+  menuItems: ["分享", "识别", "保存"],
+  onMenuTap: (res) => {
+    // res.tapIndex 与 menuItems 下标一致，res.itemText 是命中的文案
+    if (res.itemText == "分享") shareByMyPlugin(res.url)
+    if (res.itemText == "识别") scanByMyPlugin(res.url)
+    if (res.itemText == "保存") saveByMyPlugin(res.url)
+  }
+} as XPreviewMediaOptions)
+```
+
+不传 `menuItems` 就只有 `onLongPress`，适合自绘菜单；`showmenu: false` 也是同样效果。菜单弹着时按返回键先收菜单，再按一次才关预览。
+
+### 交互
+
+| 手势 | 行为 |
+| --- | --- |
+| 横滑 | 翻页，非循环时越界有阻尼；距离不够但甩得快也翻页 |
+| 双击 | 图片在 1x 与 2x 之间切换，按落点锚定，视频不响应 |
+| 双指 | 图片缩放，上限 4x，按双指中心锚定；超出 1x～4x 可跟手拉出一段，松手弹回 |
+| 单指拖动 | 放大后平移画面，松手带惯性滑行；拖出边界有阻尼，松手弹回；未放大时下拉关闭 |
+| 单击 | 图片关闭预览；放大状态先复位；视频切换播放 |
+| 长按 | 恒抛 `onLongPress`，`showmenu` 且 `menuItems` 非空时弹菜单 |
+| 返回 | Android 返回键、鸿蒙返回手势、Web 浏览器返回都只关预览这一层 |
+
+### 错误码
+
+| errCode | 说明 |
+| --- | --- |
+| 1001 | 系统错误，预览层创建失败 |
+| 1002 | 参数错误 |
+| 1003 | 资源列表为空 |
+| 1005 | 正在预览中 |
+| 1007 | 当前没有预览，`closePreviewMedia` 专用 |
+| 1008 | 当前平台不支持此功能 |
+| 1009 | 资源加载失败 |
+| 1010 | 实况照片加载失败，已降级为静态图，仅 iOS |
+
+## 更新日志
+
+### 1.0.0（2026-08-27）
+* 新增 previewMedia / closePreviewMedia，五端对齐微信 wx.previewMedia
+* 微信小程序直通 wx.previewMedia，Android / iOS / 鸿蒙 / Web 全原生自绘
+* 图片双击与双指缩放、横滑翻页、下拉关闭、视频播放
+* 预览层四端都用独立窗口层：Android Dialog、iOS 独立 UIWindow、鸿蒙 openCustomDialog、Web 压 history 记录，返回只关预览不退页面
+* 长按恒抛 onLongPress，菜单文案由 menuItems 传入，命中项经 onMenuTap 抛出，保存 / 分享 / 识别码全部由页面实现
+* 插件不落库不分享，不申请相册、存储与分享相关权限
+* Android / iOS 播控条图标用插件内独立 remixicon 副本，鸿蒙与 Web 用系统自带控制条
+* sources[] 新增 liveVideo，iOS 走系统 PHLivePhotoView 渲染实况照片，点右上角 LIVE 徽标播放
+* iOS 关掉系统自带的按住播放手势，避免和长按菜单抢手势；放大或菜单弹出时不响应播放
+* 实况照片配对失败或下载失败退回静态图并抛 1010，其余四端忽略 liveVideo 按静图渲染
+* 新增 onLoadError 事件，接出原生层的单项加载失败（含 1009 与 1010），预览不会因此关闭
+* 放大后拖动松手带惯性滑行，拖出边界跟手变重、松手弹回；双指拉出 1x～4x 区间后松手同样弹回
+* 横滑翻页补速度判定，距离不够但甩得快也翻页
+* 四端惯性跑同一套逐帧衰减公式且参数一致，各端驱动器分别是 CADisplayLink / Choreographer / setInterval / requestAnimationFrame，滑行途中可被新触摸立即接手
+* 修复鸿蒙缩放限位按页面尺寸计算的问题，改用 Image onComplete 回填的实际显示尺寸，竖屏看横图不再能把画面拖进黑边
+* 修复 Web 双指缩放每帧都挂 200ms transition 导致缩放滞后手指的问题