tmui-cli 5.3.1 → 5.3.3

package/data/uni-app-x-docs/static/bluetooth-general-flow.svg

@@ -0,0 +1,69 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="720" height="1272" viewBox="0 0 720 1272" role="img" aria-labelledby="title description">
+  <title id="title">蓝牙通用接口使用流程</title>
+  <desc id="description">注册监听后初始化蓝牙适配器。初始化失败时根据原因处理，条件恢复后重试；初始化成功后扫描，通过设备发现事件获取目标设备，停止扫描，再连接和通信。使用结束后移除监听，不再使用蓝牙时关闭适配器。</desc>
+  <defs>
+    <marker id="arrow" viewBox="0 0 10 10" refX="9" refY="5" markerWidth="7" markerHeight="7" orient="auto-start-reverse">
+      <path d="M 0 0 L 10 5 L 0 10 Z" fill="#526780"/>
+    </marker>
+  </defs>
+  <rect width="720" height="1272" rx="16" fill="#ffffff"/>
+  <g fill="none" stroke="#526780" stroke-width="2" stroke-linejoin="round" marker-end="url(#arrow)">
+    <path d="M 360 152 V 190"/>
+    <path d="M 360 278 V 310"/>
+    <path d="M 252 358 H 180 V 440"/>
+    <path d="M 468 358 H 540 V 440"/>
+    <path d="M 180 556 V 586 H 360 V 620"/>
+    <path d="M 360 738 V 780"/>
+    <path d="M 360 868 V 910"/>
+    <path d="M 360 998 V 1040"/>
+    <path d="M 360 1128 V 1170"/>
+  </g>
+  <g font-family="Arial, 'PingFang SC', 'Microsoft YaHei', sans-serif" text-anchor="middle" fill="#24364b">
+    <rect x="40" y="24" width="640" height="128" rx="12" fill="#eef6ff" stroke="#a7c9ee"/>
+    <text x="360" y="58" font-size="23" font-weight="600">注册事件监听</text>
+    <text x="360" y="90" font-size="18">uni.onBluetoothAdapterStateChange</text>
+    <text x="360" y="118" font-size="18">uni.onBluetoothDeviceFound</text>
+    <text x="360" y="140" font-size="15" fill="#53677f">分别监听适配器状态与设备发现事件</text>
+
+    <rect x="40" y="190" width="640" height="88" rx="12" fill="#eef6ff" stroke="#a7c9ee"/>
+    <text x="360" y="225" font-size="23" font-weight="600">初始化蓝牙适配器</text>
+    <text x="360" y="255" font-size="18">uni.openBluetoothAdapter</text>
+
+    <path d="M 360 310 L 468 358 L 360 406 L 252 358 Z" fill="#eef6ff" stroke="#a7c9ee"/>
+    <text x="360" y="365" font-size="21" font-weight="600">初始化成功？</text>
+    <text x="154" y="400" font-size="18" fill="#356c50">是</text>
+    <text x="566" y="400" font-size="18" fill="#946124">否</text>
+
+    <rect x="40" y="440" width="280" height="116" rx="12" fill="#eef6ff" stroke="#a7c9ee"/>
+    <text x="180" y="473" font-size="23" font-weight="600">开始扫描</text>
+    <text x="180" y="505" font-size="17">uni.startBluetoothDevicesDiscovery</text>
+    <text x="180" y="534" font-size="16" fill="#53677f">等待设备发现事件</text>
+
+    <rect x="400" y="440" width="280" height="140" rx="12" fill="#fff7eb" stroke="#dfbf8b"/>
+    <text x="540" y="473" font-size="22" font-weight="600">根据失败原因处理</text>
+    <text x="540" y="505" font-size="18">检查蓝牙开关、授权</text>
+    <text x="540" y="532" font-size="18">及平台是否支持</text>
+    <text x="540" y="560" font-size="16" fill="#805d2d">条件恢复后重新初始化</text>
+
+    <rect x="40" y="620" width="640" height="118" rx="12" fill="#eef6ff" stroke="#a7c9ee"/>
+    <text x="360" y="654" font-size="23" font-weight="600">获取目标设备的 deviceId</text>
+    <text x="360" y="686" font-size="18">通过 uni.onBluetoothDeviceFound 接收发现的设备</text>
+    <text x="360" y="716" font-size="17" fill="#53677f">可选：uni.getBluetoothDevices 查询已发现的设备列表</text>
+
+    <rect x="40" y="780" width="640" height="88" rx="12" fill="#eef6ff" stroke="#a7c9ee"/>
+    <text x="360" y="815" font-size="23" font-weight="600">发现目标设备后停止扫描</text>
+    <text x="360" y="845" font-size="18">uni.stopBluetoothDevicesDiscovery</text>
+
+    <rect x="40" y="910" width="640" height="88" rx="12" fill="#edf7f1" stroke="#a6cbb5"/>
+    <text x="360" y="945" font-size="23" font-weight="600">连接设备并通信</text>
+    <text x="360" y="975" font-size="18">详见「蓝牙-低功耗中心设备」文档</text>
+
+    <rect x="40" y="1040" width="640" height="88" rx="12" fill="#eef6ff" stroke="#a7c9ee"/>
+    <text x="360" y="1075" font-size="23" font-weight="600">使用结束后移除自身注册的监听</text>
+    <text x="360" y="1105" font-size="18">调用对应的 off* 接口</text>
+
+    <rect x="40" y="1170" width="640" height="78" rx="12" fill="#eef6ff" stroke="#a7c9ee"/>
+    <text x="360" y="1201" font-size="22" font-weight="600">不再使用蓝牙时，关闭适配器</text>
+    <text x="360" y="1230" font-size="18">uni.closeBluetoothAdapter</text>
+  </g>
+</svg>

package/data/uni-app-x-docs/static/bluetooth-le-central-flow.svg

@@ -0,0 +1,102 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="960" height="1510" viewBox="0 0 960 1510" role="img" aria-labelledby="title description">
+  <title id="title">BLE 中心设备连接与通信流程</title>
+  <desc id="description">使用蓝牙通用接口扫描得到设备 ID，注册连接状态和特征值变化监听后连接设备。连接成功后发现服务与特征值，根据特征值属性分别选择读写或通知操作；可按需查询 RSSI 和最大可写长度。结束时按需关闭通知、断开连接并移除监听。连接断开后重新连接，并重新发现服务与特征值。</desc>
+  <defs>
+    <marker id="arrow" viewBox="0 0 10 10" refX="9" refY="5" markerWidth="7" markerHeight="7" orient="auto">
+      <path d="M 0 0 L 10 5 L 0 10 Z" fill="#526780"/>
+    </marker>
+    <marker id="arrow-dashed" viewBox="0 0 10 10" refX="9" refY="5" markerWidth="7" markerHeight="7" orient="auto">
+      <path d="M 0 0 L 10 5 L 0 10 Z" fill="#8b6b35"/>
+    </marker>
+  </defs>
+  <rect width="960" height="1510" rx="16" fill="#ffffff"/>
+
+  <g fill="none" stroke="#526780" stroke-width="2" stroke-linejoin="round" marker-end="url(#arrow)">
+    <path d="M 480 106 V 132"/>
+    <path d="M 480 224 V 260"/>
+    <path d="M 480 352 V 390"/>
+    <path d="M 480 490 V 540"/>
+    <path d="M 480 650 V 670 H 340 V 700"/>
+    <path d="M 340 790 V 820 H 260 V 850"/>
+    <path d="M 340 790 V 820 H 700 V 850"/>
+    <path d="M 260 988 V 1010 H 480 V 1040"/>
+    <path d="M 700 988 V 1010 H 480 V 1040"/>
+    <path d="M 480 1140 V 1190"/>
+    <path d="M 480 1310 V 1360"/>
+    <path d="M 640 440 H 690"/>
+    <path d="M 795 500 V 530 H 920 V 306 H 900"/>
+  </g>
+  <g fill="none" stroke="#8b6b35" stroke-width="2" stroke-linejoin="round" stroke-dasharray="7 5" marker-end="url(#arrow-dashed)">
+    <path d="M 620 745 H 660"/>
+    <path d="M 780 800 V 1000 H 700 V 1040"/>
+    <path d="M 900 1360 V 235 H 900"/>
+  </g>
+
+  <g font-family="'PingFang SC', 'Microsoft YaHei', Arial, sans-serif" text-anchor="middle" fill="#24364b">
+    <rect x="60" y="28" width="840" height="78" rx="12" fill="#eef6ff" stroke="#a7c9ee"/>
+    <text x="480" y="61" font-size="20" font-weight="600">准备已扫描发现的 deviceId</text>
+    <text x="480" y="88" font-size="15" fill="#53677f">设备初始化与扫描见「蓝牙-通用」</text>
+
+    <rect x="60" y="132" width="840" height="92" rx="12" fill="#eef6ff" stroke="#a7c9ee"/>
+    <text x="480" y="168" font-size="20" font-weight="600">注册连接状态与特征值变化监听</text>
+    <text x="480" y="199" font-size="15">uni.onBLEConnectionStateChange · uni.onBLECharacteristicValueChange</text>
+
+    <rect x="60" y="260" width="840" height="92" rx="12" fill="#eef6ff" stroke="#a7c9ee"/>
+    <text x="480" y="296" font-size="20" font-weight="600">连接目标设备</text>
+    <text x="480" y="327" font-size="16">uni.createBLEConnection(deviceId)</text>
+
+    <path d="M 480 390 L 640 440 L 480 490 L 320 440 Z" fill="#f2f7ff" stroke="#a7c9ee"/>
+    <text x="480" y="447" font-size="18" font-weight="600">连接成功？</text>
+    <text x="510" y="514" font-size="14" fill="#356c50">是</text>
+    <text x="660" y="430" font-size="14" fill="#805d2d">否</text>
+
+    <rect x="690" y="380" width="210" height="120" rx="12" fill="#fff7eb" stroke="#dfbf8b"/>
+    <text x="795" y="414" font-size="16" font-weight="600">连接失败</text>
+    <text x="795" y="442" font-size="13" fill="#805d2d">按失败说明排查</text>
+    <text x="795" y="467" font-size="13" fill="#805d2d">处理后重新调用连接</text>
+
+    <rect x="60" y="540" width="840" height="110" rx="12" fill="#eef6ff" stroke="#a7c9ee"/>
+    <text x="480" y="576" font-size="20" font-weight="600">发现服务与特征值</text>
+    <text x="480" y="608" font-size="16">uni.getBLEDeviceServices → uni.getBLEDeviceCharacteristics</text>
+    <text x="480" y="635" font-size="14" fill="#53677f">按返回的 UUID 定位目标服务和特征值，并检查 properties</text>
+
+    <rect x="60" y="700" width="560" height="90" rx="12" fill="#f2f7ff" stroke="#a7c9ee"/>
+    <text x="340" y="736" font-size="20" font-weight="600">按特征值 properties 选择需要的操作</text>
+    <text x="340" y="766" font-size="15" fill="#53677f">读、写、notify / indicate 可按业务需要分别执行</text>
+
+    <rect x="660" y="700" width="240" height="100" rx="12" fill="#f4f1fb" stroke="#c8b9e2"/>
+    <text x="780" y="728" font-size="16" font-weight="600">可选查询</text>
+    <text x="780" y="752" font-size="13">RSSI / 最大可写长度</text>
+    <text x="780" y="775" font-size="12" fill="#53677f">getBLEDeviceRSSI · getBLEMTU</text>
+    <text x="780" y="793" font-size="11" fill="#53677f">setBLEMTU 按平台支持调用</text>
+
+    <rect x="60" y="850" width="400" height="138" rx="12" fill="#eef6ff" stroke="#a7c9ee"/>
+    <text x="260" y="887" font-size="19" font-weight="600">按需读取或写入</text>
+    <text x="260" y="919" font-size="14">read → uni.readBLECharacteristicValue</text>
+    <text x="260" y="948" font-size="14">write → uni.writeBLECharacteristicValue</text>
+    <text x="260" y="973" font-size="13" fill="#53677f">读取前先注册监听；结果由事件返回，无需开启通知</text>
+
+    <rect x="500" y="850" width="400" height="138" rx="12" fill="#edf7f1" stroke="#a6cbb5"/>
+    <text x="700" y="887" font-size="19" font-weight="600">需要时开启通知</text>
+    <text x="700" y="919" font-size="14">notify / indicate</text>
+    <text x="700" y="946" font-size="13">uni.notifyBLECharacteristicValueChange</text>
+    <text x="700" y="971" font-size="13">由 uni.onBLECharacteristicValueChange 接收</text>
+
+    <rect x="60" y="1040" width="840" height="100" rx="12" fill="#eef6ff" stroke="#a7c9ee"/>
+    <text x="480" y="1076" font-size="19" font-weight="600">继续按业务需要收发数据</text>
+    <text x="480" y="1107" font-size="15" fill="#53677f">读、写、通知和可选查询完成后，进入资源清理</text>
+    <text x="480" y="1130" font-size="13" fill="#53677f">GATT 失效或操作报错时重新发现；断线后重新连接再发现</text>
+
+    <rect x="60" y="1190" width="840" height="120" rx="12" fill="#fff7eb" stroke="#dfbf8b"/>
+    <text x="480" y="1226" font-size="19" font-weight="600">通信结束后清理资源</text>
+    <text x="480" y="1257" font-size="14">如已开启通知，先关闭 → uni.closeBLEConnection</text>
+    <text x="480" y="1284" font-size="13">再移除自身注册的连接状态和特征值变化监听</text>
+
+    <rect x="60" y="1360" width="400" height="74" rx="12" fill="#f5f7fa" stroke="#c7d0dc"/>
+    <text x="260" y="1404" font-size="17">正常结束</text>
+
+    <rect x="500" y="1360" width="400" height="74" rx="12" fill="#fff7eb" stroke="#dfbf8b"/>
+    <text x="700" y="1392" font-size="17" font-weight="600">连接断开后重新连接</text>
+    <text x="700" y="1416" font-size="13" fill="#805d2d">重新发现服务、特征值并按需开启通知</text>
+  </g>
+</svg>

package/data/uni-app-x-docs/tutorial/compliance.md

@@ -482,7 +482,7 @@ App一键登录为了支持“中国电信”运行商，要用到“电信（
   </view>
 </template>
 
-<script setup lang="uts">
+<script setup lang="ts">
   // #ifdef APP
   import { openSchema } from '@/uni_modules/uts-openSchema'
   // #endif
@@ -578,8 +578,8 @@ App一键登录为了支持“中国电信”运行商，要用到“电信（
 在应用的 [onLaunch](../collocation/app.md#onlaunch) 生命周期中调用 [uni.getPrivacySetting](../api/privacy.md#getprivacysetting) 判断用户是否已经同意隐私政策，如果没有同意则通过 [uni.openDialogPage](../api/dialog-page.md#opendialogpage) 弹出“个人信息保护指引”（或“用户协议和隐私政策概要”）提示框，否则跳过。
 
 示例代码如下：
-```uts
-<script setup lang="uts">
+```vue
+<script setup lang="ts">
   onLaunch((res : OnLaunchOptions) => {
     // #ifdef APP
     // 获取是否同意隐私政策
@@ -625,7 +625,7 @@ App首次启动调用 [uni.openDialogPage](../api/dialog-page.md#opendialogpage)
 
 以下是 `app.uvue` 页面添加 `isAgreePrivacy` 保存状态的示例：  
 ```vue
-<script setup lang="uts">
+<script setup lang="ts">
   defineOptions({
     globalData: {
       isAgreePrivacy: false
@@ -662,7 +662,7 @@ App首次启动调用 [uni.openDialogPage](../api/dialog-page.md#opendialogpage)
 
 在页面或组件中通过 `getApp().globalData` 访问 `isAgreePrivacy`：  
 ```vue
-<script setup lang="uts">
+<script setup lang="ts">
   const myTestPrivacyAPI = () => {
     if(getApp().globalData.isAgreePrivacy){
       //用户已经同意隐私政策，这时可以使用涉及个人信息的功能
@@ -750,7 +750,7 @@ App首次启动调用 [uni.openDialogPage](../api/dialog-page.md#opendialogpage)
   </scroll-view>
 </template>
 
-<script setup lang="uts">
+<script setup lang="ts">
   const title = '用户“同意”《隐私政策》前不能使用涉及采集个人信息的组件（如map、camera、ad等）及API，此页面演示“同意”/“不同意”《隐私政策》后显示/隐藏相关组件、使用相关API进行提示的示例'
   const isAgreePrivacy = ref(false) //保存同意隐私政策状态
   let callbackId = 0

package/data/uni-app-x-docs/tutorial/debug/devtools.md

@@ -8,7 +8,7 @@ uni-app x DevTools 是 HBuilderX 内置的 uni-app x 蒸汽模式运行时检查
 
 目前提供以下功能：
 
-1. 在 Elements 中查看页面、Element 和自定义组件组成的节点树，以及属性、组件 props、计算样式和盒模型。
+1. 在 Elements 中查看页面、Element 和自定义组件组成的节点树，以及属性、组件 props、计算样式和盒模型；也可以将所选节点添加到 uni-agent 聊天。
 2. 在 Network 中查看通过 `uni.request`、`uni.uploadFile` 和 `uni.downloadFile` 发起的请求。
 3. 在 Storage 中查看和维护应用通过 uni Storage API 保存的数据。
 
@@ -42,14 +42,24 @@ HBuilderX 会打开独立的 DevTools 窗口。应用尚未连接时，窗口会
 
 ![](https://web-ext-storage.dcloud.net.cn/uni-app-x/devtools/devtools-component-props.png)
 
-右键点击节点可以使用以下操作：
+### 节点右键菜单@elements-context-menu
 
-- **展开所有子节点**：递归展开该节点下的所有内容。
-- **收起子级**：收起该节点下已经展开的内容。
-- **在 HBuilderX 中打开**：打开页面或自定义组件对应的源码文件。该菜单只在能定位源码的页面和自定义组件节点上显示。
+右键点击节点可以使用以下操作：
 
 ![](https://web-ext-storage.dcloud.net.cn/uni-app-x/devtools/devtools-elements-context-menu.png)
 
+1. **将所选节点添加到 uni-agent 聊天**：打开 uni-agent，将当前页面和节点路径添加到输入框；支持截图时还会添加所选节点的截图。
+
+   > HBuilderX 5.31+、uni-agent v1.8.8.261012094+ 支持。
+
+   DevTools 不会自动发送消息。请在 [uni-agent](https://doc.dcloud.net.cn/uni-app-x/ai/) 输入框中补充需要排查的问题，再手动发送。uni-agent 可以根据节点引用继续读取相关属性、组件 props、计算样式和盒模型，用于排查布局、样式或数据问题。
+
+   ![](https://web-ext-storage.dcloud.net.cn/uni-app-x/devtools/devtools-uni-agent.png)
+
+2. **在 HBuilder 中打开**：打开页面或自定义组件对应的源码文件。该菜单只在能定位源码的页面和自定义组件节点上显示。
+3. **展开所有子节点**：递归展开该节点下的所有内容。
+4. **收起所有子节点**：收起该节点下已经展开的内容。
+
 ::: warning 当前限制
 Elements 当前使用页面快照，页面内新增、删除或修改节点后不会自动同步。请点击窗口左上角的刷新按钮查看最新内容。切换页面不需要手动刷新。
 
@@ -132,6 +142,6 @@ Network 只记录 DevTools 建立连接后，通过 `uni.request`、`uni.uploadF
 
 公开 uni Storage API 产生的变化会自动同步。UTS 插件绕过公开 API 包装器写入数据时，请切换到 Storage 标签并点击左上角的刷新按钮。
 
-### 节点右键菜单中没有“在 HBuilderX 中打开”
+### 节点右键菜单中没有“在 HBuilder 中打开”
 
 该菜单只对能够定位源码的页面和自定义组件显示，Element 不显示此菜单。

package/data/uni-app-x-docs/tutorial/store.md

@@ -147,7 +147,7 @@ export const setGlobalNum = (num: number) => {
 </template>
 
 // 组合式 API
-<script setup lang="uts">
+<script setup>
 	import { state, setGlobalNum } from '@/store/index.uts'
 
 	const globalNum = computed(() => state.globalNum)

package/data/uni-app-x-docs/uniapptox.md

@@ -43,9 +43,28 @@ uni-app迁移到uni-app x，是一个大型工程。
 
 ### 5. 构造uni-app x项目
 
-新建`uni-app x`项目，勾选`manifest.json`中的蒸汽模式。把老项目的页面、组件、uni_modules、静态资源复制过来。所有`vue`或`nvue`页面组件文件，批量重命名为`uvue`。`main.js`改名为`main.uts`（蒸汽模式下，`main.uts`里也支持`js/ts`写法）。可以保留之前的appid和包名。
+新建`uni-app x`项目，选择蒸汽模式。
+可以保留之前的appid和包名，在manifest.json源码视图里改成之前的appid。
 
-之前如果有`nativeplugins`目录，就不用带来过了，uni-app x只支持uni_modules下的uts插件。原本的插件需要换新，或者临时mock掉。如果插件市场没有同款uts插件替代，可以让uni-agent重新封装一个uts原生插件，不懂原生也可以指挥ai完成（别选智商低的模型）。对于app.vue，不建议整体文件改名替换uni-app x的app.uvue。而是挑选部分代码复制过来。因为uni-app x 的app.uvue有2个变化：
+manifest的结构，在uni-app x中与uni-app略有不同。需要把原来manifest的信息按新的规范填一遍。关于三方sdk的key信息，只要包名和签名不变，key可以复用。[详见](./collocation/manifest.md)
+
+如果使用云端证书打包，只要appid、账户不变，证书可以复用。
+
+把老项目的页面、组件、uni_modules、静态资源复制到新项目中。
+之前如果有`nativeplugins`目录，就不用带来过了，uni-app x只支持uni_modules下的uts插件。
+原本的插件需要换新，或者临时mock掉。
+如果插件市场没有同款uts插件替代，可以让uni-agent重新封装一个uts原生插件，不懂原生也可以指挥ai完成（别选智商低的模型）。
+
+所有`vue`或`nvue`页面组件文件，批量重命名为`uvue`。
+
+在HBuilder 5.31以前，推荐把独立的js/ts文件的后缀名改成uts（蒸汽模式页面引用的uts文件也是弱类型，可以写js/ts语法）。
+5.31起不需要改文件后缀了。
+
+老项目的pages.json可以直接挪过来使用。结构没有差别，只是uni-app x的pages.json中不再支持plus，多支持了一些新的页面style和tabbar的属性。[详见](./collocation/pagesjson.md)
+
+老项目的`main.js`和`app.vue`，挑选内容复制到新项目中对应的新文件中。
+
+uni-app x 的app.uvue对比老 uni-app 有2个变化：
 	
 #### 5.1 应用退出方式
 
@@ -60,7 +79,9 @@ uni-app迁移到uni-app x，是一个大型工程。
 如果你之前有web版和微信小程序，那么改造后首先运行到 `uni-app x` 的web和微信小程序上，看看是否正常。
 
 同时注意uni-app x的 [web开发注意](./web/README.md) 和 [小程序开发注意](./mp/README.md)
-	
+
+uni-app x 的 app.uvue 文档[详见](./collocation/app.md)
+
 ### 6. 再次适配css
 
 之前在uni-app中适配过一次css，但[css样式重置](./css/README.md#css-reset)、[样式隔离策略2.0](./css/common/style-isolation.md)，这2个在uni-app下没有，还得在uni-app x环境中再次适配。
@@ -73,9 +94,10 @@ uni-app x在编译时，会在控制台提示不支持的css，可以让uni-agen
 
 ### 7. 适配UniApp对象重构
 
-HBuilderX 4.31+ 重构了应用对象，迁移时需要检查`getApp()`的相关代码：
-
-* `getApp()`改为返回[UniApp对象](./api/get-app.md)，Vue实例通过`vm`属性提供。调用`App.uvue`中定义的全局方法时，需要把`getApp().methodName()`改为`getApp().vm?.methodName()`；`globalData`仍通过`getApp().globalData`访问。`UniApp`可在uts插件和uvue页面中使用，但`vm`和`globalData`仅支持在uvue页面中使用。
+uni-app x 的 `getApp()` 改为返回[UniApp对象](./api/get-app.md)。
+Vue实例需通过`vm`属性提供。
+调用`App.uvue`中定义的全局方法时，需要把`getApp().methodName()`改为`getApp().vm?.methodName()`（ts需要?，js去掉?）。
+`globalData`仍通过`getApp().globalData`访问。
 
 如果要改造为App，继续往下。
 
@@ -87,29 +109,30 @@ uni-app x不支持plus。
 * 如果在pages.json里使用了plus，推荐改用 uni-ui x 的 [uni-nav-bar 自定义导航栏组件](./component/uni-ui-x/uni-nav-bar.md) 和 [uni-tab-bar自定义tabbar组件](./component/uni-ui-x/uni-tab.md) 来替代。
 
 另外如果项目使用了subNVue，需要改成[dialogPage](./api/dialog-page.md)
+
+页面中如果有 app-plus 的条件编译，建议改为 app 。uni-app x 中也支持独立的 app-android、app-ios、app-harmony 的条件编译。
 	
-### 9. 改造组件库
+### 9. 升级或改造前端库
 
-* 如果使用了uni ui，那么迁移指南在这篇文档的底部：[uni-ui x](./component/uni-ui-x/README.md)
+* 如果使用了uni ui，那么迁移指南在这篇文档的底部：[uni-ui x](./component/uni-ui-x/README.md#uniuiupgrade)
 * 如果使用其他组件库，需要咨询组件作者是否有 uni-app x 版本。如果没有的话，推荐用[uni-ui x](./component/uni-ui-x/README.md)重构。
 
-uni-app x 相比 uni-app 多了不少内置组件，比如`list-view`复用长列表、`waterflow`瀑布流、`page-container`弹框、`sticky`吸顶、`match-media`宽屏适配、loading加载中、native-view对接原生view。对于内置组件已经满足需求的情况就没必要使用三方组件了。
+uni-app x 相比 uni-app 多了不少内置组件，比如`list-view`复用长列表、`waterflow`瀑布流、`page-container`弹框、`sticky`吸顶、`match-media`宽屏适配、loading加载、native-view对接原生view。对于内置组件已经满足需求的情况就没必要使用三方组件了。
+
+* 升级uni_modules，比如官方的uni-id-pages、uni-starter、uni-pay、升级中心等库，需要升级到支持蒸汽模式的最新版本。
 
 ### 10. 改造wxs和renderjs为Element API
 
-uni-app x的app平台不再支持wxs和renderjs。uni-app x的逻辑层和渲染层虽然还是2层，但并没有明显的通信成本。
+uni-app x的app平台不再支持wxs和renderjs。
 
-uni-app x 提供了全端统一的UNIElement API，它在编译到微信小程序时会自动编译成wxs。写法跨端且高性能。[详见](./api/dom/README.md)
+uni-app x 提供了全端统一的UNIElement API，它在编译到微信/支付宝小程序时会自动编译成wxs/ajs。写法跨端且高性能。[详见](./api/dom/README.md)
 
 包括moveable组件的使用，也推荐改成UNIElement的操作。
 	
-### 11. mock掉App原生插件（非uts原生插件）的输入输出，在iOS和鸿蒙上验证
+### 11. mock掉App原生插件（非uts原生插件）的输入输出
 
 如果你使用了老的App原生插件，先让uni-agent把App原生插件的输入输出mock掉，后续步骤再处理原生插件，先对前几步的工作进行验证。
 
-- iOS和鸿蒙，使用的是js驱动，arkts是js的强化版，可以运行标准的js。
-- Android的vdom模式是uts驱动，需要强类型。对于uni-app开发者而言，推荐改用没有强类型约束的蒸汽模式，并且性能比vdom更高。
-
 这一步要再处理一件事，检查组件库是否适配了[样式隔离策略2.0](./css/common/style-isolation.md)。uni-app x 的蒸汽模式，仅支持[样式隔离策略2.0](./css/common/style-isolation.md)。
 
 ### 12. 替换App原生插件和uts兼容模式组件
@@ -130,11 +153,18 @@ uni-agent让普通前端开发者具备了写原生插件的能力，官方的
 
 完成后继续在iOS和鸿蒙上验证。
 
-### 13. 使用HBuilderX 5.23以上适配Android
+注意部分uts插件使用了uni-app的特性，导致没有适配uni-app x，这种情况需要插件作者升级适配。
 
-直接打开 `uni-app x` 的蒸汽模式，该模式兼容js/ts写法。且性能比`uni-app x` Android版VDOM模式、比Android原生开发的性能都会好非常多。[详见](./app-vapor.md)
+uni-app 的 Android平台整个应用只有一个activity，每个page是view。而uni-app x 的 Android 平台，每个页面都是一个activity。有的uts插件可能未区别这种差异。
 
-js驱动将避免开发者改造uts代码，并且兼容广泛的npm js生态。
+### 13. 处理uts/js/ts的差异
+
+在 HBuilder 5.31以前，蒸汽模式下uts/js/ts都是按uts2js编译。此时script中的lang不能设置，需要置空。同时外部文件后缀需要为uts。
+但此时的uts，不编译为强类型的kt、swift，可以在里面写普通的js/ts代码。
+
+从 5.31+ ，蒸汽模式下支持独立设置uts/js/ts。[详见](./vue/README.md#lang)。
+
+推荐uni-app的老应用升级时选择5.31+。
 	
 ### 小结
 
@@ -143,6 +173,7 @@ js驱动将避免开发者改造uts代码，并且兼容广泛的npm js生态。
 这十几步的每一步都应该新起一个会话。有必要传给下一个会话的内容，让AI总结到md里，让下一个会话在有必要时读取这个md。
 
 **一个AI使用经验：**
+
 AI很擅长从0到60，这一步很快。但再往上，要不投入更多优秀人力review、要不投入更多和更高智商的AI算力做交叉验证和自动化测试。
 
 高智商的AI算力虽然贵，但在代码翻译这件事上，其实性价比是远超过投入优秀的人时的。