tmui-cli 5.3.1 → 5.3.2

package/README.md

@@ -24,7 +24,7 @@ tmui
 
 按键：`↑/↓` 选择，`Enter` 确认，`Esc` 返回，`Ctrl+C` 退出。
 
-## MCP（给 Cursor / VS Code 等 IDE 用）
+## MCP（给 Cursor、VS Code 这类 IDE 用）
 
 `tmui mcp` 启动 MCP stdio 服务，**不会**打开交互界面。stdout 只走协议。
 
@@ -74,7 +74,7 @@ tmui
 
 | 工具 | 参数 | 说明 |
 | --- | --- | --- |
-| `list_uniappx_docs` | `category?` | 列出文档目录，可按分类过滤（组件 / CSS / API / UTS / Vue / 配置 / 教程 / 原生 / Web …） |
+| `list_uniappx_docs` | `category?` | 列出文档目录，可按分类过滤（组件 / CSS / API / UTS语法 / Vue语法 / 配置 / 教程 / 原生SDK / Web平台） |
 | `query_uniappx_doc` | `doc`、`category?` | 读一篇文档全文（doc 支持中文名/文件名） |
 | `search_uniappx_doc` | `query`、`category?`、`limit?` | 全文检索，返回命中文档与摘要片段 |
 | `query_uniappx_component` | `component` | 查组件：属性表 / 事件 / 子组件 / 兼容性（结构化，最快） |
@@ -91,6 +91,124 @@ tmui
 }
 ```
 
+## MCP · HBuilderX 操作
+
+`tmui HBuilderX`（别名 `tmui hbx` / `tmui hbuilderx`）把本机 HBuilderX CLI 包装成 MCP 工具：项目、文件、账号、配置、设备、运行、日志、截图、发行、云打包、UTS 编译、uniCloud、uni_modules。
+
+工具依赖 HBuilderX 运行。启动时会：
+
+1. 从运行中的 `HBuilderX` 进程定位同目录 `cli`（macOS / Windows / Linux，兼容自定义 `*.app` 名称）；
+2. 找不到进程时读取 `HBUILDERX_CLI_PATH`、`HX_HOME`，再尝试常见安装路径；
+3. 仍未运行则自动执行 `cli open` 并等待就绪。
+
+存在多个 HBuilderX 实例时，先调 `hbuilderx_status` 看 `cli listhost` 结果，再给其他工具传 `host`。
+
+| 工具 | 参数 | 执行的 CLI 命令 |
+| --- | --- | --- |
+| `hbuilderx_status` | `autoStart?` | `cli ver`、`cli listhost`；`autoStart=true` 且未运行时执行 `cli open` |
+| `hbuilderx_app` | `action`、`host?`、`timeoutMs?` | `action=open` 执行 `cli open`；`action=quit` 执行 `cli app quit` |
+| `hbuilderx_help` | `command?`、`json?` | `cli --help`、`cli <command> --help`、`cli uni_modules <子命令> help --json` |
+| `hbuilderx_project` | `action`、`path?`、`host?`、`timeoutMs?` | `cli project list`、`cli project open --path <path>`、`cli project close --path <path>` |
+| `hbuilderx_open_file` | `file`、`line?`、`column?`、`host?`、`timeoutMs?` | `cli open --file <file>[:line[:column]]` |
+| `hbuilderx_user` | `action`、`username?`、`password?`、`global?`、`host?`、`timeoutMs?` | `cli user info`、`cli user login --username <username> --password <password> [--global true]`、`cli user logout` |
+| `hbuilderx_config` | `action`、`key`、`value?`、`type?`、`host?`、`timeoutMs?` | `cli config get --key <key>`、`cli config set --key <key> --value <value> --type <type>` |
+| `hbuilderx_devices` | `platform?`、`host?`、`timeoutMs?` | `cli devices list [--platform android|ios-iPhone|ios-simulator|mp-harmony|app-harmony]` |
+| `hbuilderx_launch` | `platform`、`project?`、`ui?`、`deviceId?`、`iosTarget?`、`playground?`、`customType?`、`packageName?`、`localRepoPath?`、`ipaPath?`、`nativeLog?`、`cleanCache?`、`vaporRenderTarget?`、`compile?`、`continueOnError?`、`runtimeLogFormat?`、`runtimeLog?`、`buildType?`、`pagePath?`、`pageQuery?`、`browser?`、`developerCertificate?`、`provisioningProfile?`、`privateKey?`、`host?`、`timeoutMs?` | `cli launch <platform> --project <project> [参数]`；各 platform 的参数对应关系见工具 description |
+| `hbuilderx_logcat` | `platform`、`project?`、`mode?`、`deviceId?`、`iosTarget?`、`browser?`、`waitForStop?`、`host?`、`timeoutMs?`、`maxChars?` | `cli logcat <platform> [--project <project>] [参数]`；各 platform 的参数对应关系见工具 description |
+| `hbuilderx_screencap` | `platform`、`project?`、`saveFile`、`fullPage?`、`deviceId?`、`browser?`、`returnImage?`、`host?`、`timeoutMs?` | `cli screencap <platform> --project <project> --saveFile <saveFile> [参数]` |
+| `hbuilderx_publish` | `platform`、`type?`、`project?`、`name?`、`exportPath?`、`confuse?`、`upload?`、`appid?`、`subPackage?`、`description?`、`privatekey?`、`version?`、`sourceMap?`、`robot?`、`ssr?`、`ssrHost?`、`ssrProvider?`、`webDomain?`、`webTitle?`、`webHosting?`、`provider?`、`spaceId?`、`host?`、`timeoutMs?` | `cli publish ...`；各 platform 的参数对应关系见工具 description |
+| `hbuilderx_pack` | `action`、`project?`、`config?`、`platform?`、`ticket?`、`certfile?`、`storepassword?`、`iscustom?`、`safemode?`、`sourceMap?`、`dsyms?`、`isconfusion?`、`splashads?`、`rpads?`、`unimpads?`、`ignoreWarnings?`、`precheck?`、`skipPrecheck?`、`async?`、`json?`、`adDomestic?`、`adInternational?`、`adContent?`、`android?`、`ios?`、`host?`、`timeoutMs?` | `cli pack`、`cli pack status`、`cli pack cancel`、`cli pack artifact`、`cli pack certAlias`、`cli pack app-harmony`、`cli pack mp-harmony`；各 action 的参数对应关系见工具 description |
+| `hbuilderx_compile_uts` | `platform`、`project?`、`file?`、`uniModule?`、`host?`、`timeoutMs?` | `cli compile <platform> --project <project> --file <file>` 或 `cli compile <platform> --project <project> --uni_module <uniModule>` |
+| `hbuilderx_cloud` | `action`、`resourceType?`、`project?`、`provider?`、`name?`、`unimod?`、`cloud?`、`force?`、`space?`、`host?`、`timeoutMs?` | `cli cloud functions --list`、`--upload`、`--download`、`--initdatabase`、`--assignspace`；各 action 的参数对应关系见工具 description |
+| `hbuilderx_hosting` | `action`、`space`、`provider`、`project?`、`source?`、`prefix?`、`path?`、`host?`、`timeoutMs?` | `cli hosting deploy`、`cli hosting list`、`cli hosting delete`；各 action 的参数对应关系见工具 description |
+| `hbuilderx_uni_modules` | `action`、`pluginId?`、`template?`、`project?`、`version?`、`extType?`、`force?`、`dryRun?`、`changeLog?`、`imageFile?`、`imageDir?`、`example?`、`json?`、`timeoutMs?` | `cli uni_modules --create`、`--publish`、`--updateInfo`、`--install`、`--validate`、`--download`、`--upgrade`、`--list`；各 action 的参数对应关系见工具 description |
+
+```json
+{
+  "mcpServers": {
+    "hbuilderx": {
+      "command": "npx",
+      "args": ["-y", "tmui-cli", "HBuilderX"]
+    }
+  }
+}
+```
+
+### 参数适用关系
+
+`hbuilderx_launch` 执行 `cli launch <platform> --project <project> [参数]`：
+
+- `platform=app-android`：`ui`、`deviceId`、`playground`、`customType`、`packageName`、`localRepoPath`、`nativeLog`、`cleanCache`、`vaporRenderTarget`、`compile`、`continueOnError`、`runtimeLogFormat`、`pagePath`、`pageQuery`。
+- `platform=app-ios`：`ui`、`deviceId`、`iosTarget`、`playground`、`customType`、`ipaPath`、`nativeLog`、`cleanCache`、`vaporRenderTarget`、`compile`、`continueOnError`、`runtimeLogFormat`、`pagePath`、`pageQuery`、`developerCertificate`、`provisioningProfile`、`privateKey`。
+- `platform=app-harmony`：`ui`、`deviceId`、`nativeLog`、`cleanCache`、`vaporRenderTarget`、`compile`、`continueOnError`、`runtimeLogFormat`、`buildType`、`pagePath`、`pageQuery`。
+- `platform=web`：`ui`、`browser`、`compile`、`continueOnError`、`pagePath`、`pageQuery`。
+- `platform=mp-weixin`、`mp-alipay`、`mp-baidu`、`mp-toutiao`、`mp-qq`、`mp-360`、`mp-jd`、`mp-kuaishou`、`mp-lark`、`mp-xhs`：`ui`、`runtimeLog`、`runtimeLogFormat`、`compile`、`continueOnError`。
+- `platform=mp-harmony`：`ui`、`deviceId`、`cleanCache`、`compile`、`continueOnError`。
+- `platform=quickapp-webview-huawei`、`quickapp-webview-union`：`ui`、`compile`、`continueOnError`。
+
+`hbuilderx_logcat` 执行 `cli logcat <platform> [--project <project>] [参数]`：
+
+- `platform=app-android`：`project`、`deviceId`、`mode`。
+- `platform=app-ios`：`project`、`deviceId`、`iosTarget`、`mode`。
+- `platform=app-harmony`：`project`、`deviceId`、`mode`。
+- `platform=web`：`project`、`browser`、`mode`。
+- `platform=mp-weixin`、`mp-alipay`、`mp-baidu`、`mp-toutiao`、`mp-qq`、`mp-360`、`mp-jd`、`mp-kuaishou`、`mp-lark`、`mp-xhs`：`project`、`mode`。
+- `platform=mp-harmony`：`project`、`deviceId`、`mode`。
+- `platform=pack`：不需要 `project`，不传 `mode`、`deviceId`、`iosTarget`、`browser`、`waitForStop`。
+- `platform=unicloud`：`project`、`waitForStop`。
+
+`hbuilderx_publish` 执行 `cli publish`：
+
+- `platform=APP`：`type` 必填。`type=appResource` 执行 `cli publish --platform APP --type appResource --project <project>`；`type=wgt` 执行 `cli publish --platform APP --type wgt --project <project>`，支持 `name`、`exportPath`、`confuse`。
+- `platform=app-android`、`app-ios`、`app-harmony`：`type` 必填。`type=appResource` 执行 `cli publish <platform> --type appResource --project <project>`；`type=wgt` 执行 `cli publish --platform APP --type wgt --project <project>`，支持 `name`、`exportPath`、`confuse`。
+- `platform=h5`：执行 `cli publish --platform h5 --project <project>`，支持 `ssr`、`ssrHost`、`ssrProvider`、`webDomain`、`webTitle`、`webHosting`、`provider`、`spaceId`、`sourceMap`。
+- `platform=web`：执行 `cli publish web --project <project>`，支持 `ssr`、`ssrHost`、`ssrProvider`、`webDomain`、`webTitle`、`webHosting`、`provider`、`spaceId`、`sourceMap`。
+- `platform=mp-weixin`、`mp-alipay`、`mp-baidu`、`mp-toutiao`、`mp-qq`、`mp-360`、`mp-jd`、`mp-kuaishou`、`mp-lark`、`mp-xhs`、`mp-harmony`：执行 `cli publish --platform <platform> --project <project>`，支持 `name`、`upload`、`appid`、`subPackage`、`description`、`privatekey`、`version`、`sourceMap`、`robot`。`upload=true` 时必须同时传 `appid` 与 `privatekey`；`upload` 与 `subPackage` 不能同时使用；`robot` 仅 `mp-weixin` 支持。
+
+`hbuilderx_pack` 执行 `cli pack`：
+
+- `action=pack`：有 `config` 时执行 `cli pack --config <config>`，不能同时传 `project`、`platform`、`android`、`ios`；无 `config` 时执行 `cli pack --project <project>`，支持 `platform`、`iscustom`、`safemode`、`sourceMap`、`dsyms`、`isconfusion`、`splashads`、`rpads`、`unimpads`、`ignoreWarnings`、`precheck`、`skipPrecheck`、`adDomestic`、`adInternational`、`adContent`、`android`、`ios`、`async`、`json`。
+- `action=status`：`cli pack status --project <project>`。
+- `action=cancel`：`cli pack cancel --project <project> --platform app-android` 或 `cli pack cancel --project <project> --platform app-ios`。
+- `action=artifact`：`cli pack artifact --project <project> --ticket <ticket> [--json <true|false>]`。
+- `action=certAlias`：`cli pack certAlias --certfile <certfile> --storepassword <storepassword> [--json <true|false>]`。
+- `action=app-harmony`：`cli pack app-harmony --project <project>`。
+- `action=mp-harmony`：`cli pack mp-harmony --project <project>`。
+
+`hbuilderx_cloud` 执行 `cli cloud functions`：
+
+- `action=list`：`--list <resourceType> --prj <project> --provider <provider> [--cloud] [--unimod <unimod>]`；`resourceType` 取值 `cloudfunction`、`common`、`db`、`vf`、`action`、`space`。
+- `action=upload`：`--upload <resourceType> --prj <project> --provider <provider> [--name <name>] [--unimod <unimod>] [--force]`；`resourceType` 取值 `cloudfunction`、`common`、`db`、`vf`、`action`、`all`。
+- `action=download`：`--download <resourceType> --prj <project> --provider <provider> [--name <name>] [--unimod <unimod>] [--force]`；`resourceType` 取值 `cloudfunction`、`common`、`db`、`vf`、`action`、`all`；`resourceType=action` 时不支持 `name`。
+- `action=initdatabase`：`--prj <project> --provider <provider> --initdatabase`。
+- `action=assignspace`：`--prj <project> --provider <provider> --assignspace <space>`。
+- `provider` 取值 `aliyun`、`tcb`、`alipay`。
+
+`hbuilderx_hosting` 执行 `cli hosting`：
+
+- `action=deploy`：`cli hosting deploy [--prj <project>] --space <space> --provider <provider> [--source <source>] [--prefix <prefix>]`；未传 `project` 时 `source` 必须是绝对路径。
+- `action=list`：`cli hosting list --space <space> --provider <provider> [--prefix <prefix>]`。
+- `action=delete`：`cli hosting delete --space <space> --provider <provider> --path <path>`；目录路径必须以 `/` 结尾。
+
+`hbuilderx_uni_modules` 执行 `cli uni_modules`：
+
+- `action=create`：`--create <pluginId> --template <template> --project <project> [--dryRun] [--json]`。
+- `action=publish`：`--publish <pluginId> --project <project> [--changeLog <changeLog>] [--imageFile <imageFile>] [--imageDir <imageDir>] [--example] [--dryRun] [--json]`；`imageFile` 可重复，`imageFile` 与 `imageDir` 不能同时使用。
+- `action=updateInfo`：`--updateInfo <pluginId> --project <project> [--example] [--dryRun] [--json]`。
+- `action=install`：`--install <pluginId> --project <project> [--force] [--json]`。
+- `action=validate`：`--validate <pluginId> --project <project> [--json]`。
+- `action=download`：`--download <pluginId> --project <project> [--version <version>] [--extType source|encrypt] [--force] [--json]`。
+- `action=upgrade`：`--upgrade <pluginId> --project <project> [--force] [--json]`。
+- `action=list`：`--list --project <project> [--json]`。
+
+说明：
+
+- `project` 缺省时自动使用当前工作目录（需包含 `manifest.json` 或 `src/manifest.json`）。
+- `hbuilderx_launch`、`hbuilderx_logcat`、`hbuilderx_pack` 这三类长命令可传 `timeoutMs`；到时终止并返回已捕获输出。
+- `password`、`privateKey`、`--android.certpassword`、`--android.storepassword`、`--ios.certpassword` 在命令回显和输出中会脱敏。
+- 不同命令对 HBuilderX 版本有要求（如 launch 5.0+、compile 5.21+），可用 `hbuilderx_help` 确认。
+- 不熟悉某个版本支持哪些参数时，先调 `hbuilderx_help`，它直接返回本机 cli 的帮助。
+
 发布前请先生成文档快照：
 
 ```bash

package/data/components.json

@@ -1,5 +1,5 @@
 {
-  "updatedAt": "2026-10-09T06:18:23.538Z",
+  "updatedAt": "2026-10-21T12:27:27.899Z",
   "source": "/Volumes/app/myProjects/HBuilderProjects/tmui3.2\\src\\uni_modules\\tm-ui\\components",
   "count": 63,
   "components": [

package/data/config.json

@@ -1,5 +1,5 @@
 {
-  "updatedAt": "2026-10-09T06:18:23.543Z",
+  "updatedAt": "2026-10-21T12:27:27.904Z",
   "source": "/Volumes/app/myProjects/HBuilderProjects/tmui3.2\\src\\uni_modules\\tm-ui\\libs\\config.ts",
   "count": 29,
   "config": {

package/data/doc-index.json

@@ -1,5 +1,5 @@
 {
-  "updatedAt": "2026-10-09T06:18:23.546Z",
+  "updatedAt": "2026-10-21T12:27:27.908Z",
   "count": 11,
   "guides": [
     {

package/data/docs/upload-photo.md

@@ -58,6 +58,7 @@ import headertips from '../components/headertips.vue'
 | compressedWidth | string | 'auto' | 压缩后的缩放高，0表示不压缩宽 | 
 | quality | number | 80 | 压缩质量 | 
 | addPos | string | 'after' | 添加图片的位置'before'出现在前面'after'出现在后面 | 
+| align | string | 'left' | 对齐方式'left'左对齐(默认)'right'右对齐 | 
 | mode | string | 'scaleToFill' | 图片展示的缩放模式同官方. | 
 | sortable | boolean | true | 是否允许长按拖拽排序 | 
 

package/data/docs/upload-video.md

@@ -57,6 +57,7 @@ import headertips from '../components/headertips.vue'
 | sourceType | Array\<"album" \| "camera"\> | ()=\>["album","camera"] | 图片来源同官方的sourceType：'album','camera' | 
 | compress | boolean | true | 是否压缩 | 
 | addPos | string | "after" | 添加图片的位置'before'出现在前面'after'出现在后面 | 
+| align | string | "left" | 对齐方式'left'左对齐(默认)'right'右对齐 | 
 | mode | string | "scaleToFill" | 图片展示的缩放模式同官方. | 
 | sortable | boolean | true | 是否允许长按拖拽排序 | 
 

package/data/examples/navbar.vue

@@ -7,9 +7,9 @@
                 <view class="flex flex-row flex-row-center-start relative flex-1" style="height:100%">
                     <tm-input focus-font-color="#ff5416" :focus-highlight="false" placeholder="搜索吧" icon-color="#ff5416"
                         round="76" v-if="ratio > 0" left-icon="search-2-line" dark-bg-color="white"
-                        :style="{ opacity: ratio, width: (ratio * 400) + 'rpx' }" min-height="64">
+                        :style="{ opacity: ratio, width: (ratio * 90) + '%' }" height="64">
                         <template v-slot:rightIcon>
-                            <tm-button color="#ff5416" font-size="28" round="76" class="mr-2" height="56"
+                            <tm-button color="#ff5416" font-size="28" round="76" class="mr-2" height="100%"
                                 width="100">搜索</tm-button>
                         </template>
                     </tm-input>
@@ -22,7 +22,7 @@
                     :color="(isFiexd as boolean) ? 'yellow' : 'white'"></tm-icon>
             </template>
         </tm-navbar>
-        <tm-image src="https://store.tmui.design/api_v2/public/random_picture?random=183"></tm-image>
+        <tm-image src="https://picsum.photos/750/400?random=183"></tm-image>
 
         <tm-sheet :margin="['16']">
             <tm-text font-size="36" class=" text-weight-b">标题导航 tmNavbar</tm-text>

package/data/examples/upload-photo.vue

@@ -19,6 +19,18 @@
                 </tm-sheet>
             </tm-upload-photo>
         </tm-sheet>
+        <tm-sheet>
+            <tm-text font-size="36" class="text-weight-b ">右对齐,加号在后(默认)。add-pos="after" align="right"</tm-text>
+        </tm-sheet>
+        <tm-sheet>
+            <tm-upload-photo v-model="modelvalue3" align="right" :column="4" img-height="200"></tm-upload-photo>
+        </tm-sheet>
+        <tm-sheet>
+            <tm-text font-size="36" class="text-weight-b ">右对齐,加号在前。add-pos="before" align="right"</tm-text>
+        </tm-sheet>
+        <tm-sheet>
+            <tm-upload-photo v-model="modelvalue4" align="right" add-pos="before" :column="4" img-height="200"></tm-upload-photo>
+        </tm-sheet>
         <tm-sheet>
             <tm-text font-size="36" class="text-weight-b">限定一个</tm-text>
         </tm-sheet>
@@ -35,5 +47,7 @@
 import { ref } from 'vue';
 const modelvalue = ref<Array<Record<string, any> | string>>(['https://img-cdn-tx.dcloud.net.cn/stream/plugin_screens/0306ed00-b46d-11ee-800c-6f5e9833f51b_0.jpg?&v=1716952063'])
 const modelvalue2 = ref<Array<Record<string, any> | string>>(['https://img-cdn-tx.dcloud.net.cn/stream/plugin_screens/0306ed00-b46d-11ee-800c-6f5e9833f51b_0.jpg?&v=1716952063'])
+const modelvalue3 = ref<Array<Record<string, any> | string>>(['https://img-cdn-tx.dcloud.net.cn/stream/plugin_screens/0306ed00-b46d-11ee-800c-6f5e9833f51b_0.jpg?&v=1716952063'])
+const modelvalue4 = ref<Array<Record<string, any> | string>>(['https://img-cdn-tx.dcloud.net.cn/stream/plugin_screens/0306ed00-b46d-11ee-800c-6f5e9833f51b_0.jpg?&v=1716952063'])
 
 </script>

package/data/examples/upload-video.vue

@@ -13,6 +13,18 @@
                 </tm-sheet>
             </tm-upload-video>
         </tm-sheet>
+        <tm-sheet>
+            <tm-text font-size="36" class="text-weight-b">右对齐,加号在后(默认)。add-pos="after" align="right"</tm-text>
+        </tm-sheet>
+        <tm-sheet>
+            <tm-upload-video v-model="modelvalue3" align="right" :column="3" img-height="200"></tm-upload-video>
+        </tm-sheet>
+        <tm-sheet>
+            <tm-text font-size="36" class="text-weight-b">右对齐,加号在前。add-pos="before" align="right"</tm-text>
+        </tm-sheet>
+        <tm-sheet>
+            <tm-upload-video v-model="modelvalue4" align="right" add-pos="before" :column="3" img-height="200"></tm-upload-video>
+        </tm-sheet>
         <tm-sheet>
             <tm-text font-size="36" class="text-weight-b d-block mb-n8">限定一个</tm-text>
 
@@ -25,5 +37,7 @@
 import { ref } from 'vue';
 
 const modelvalue2 = ref<Array<Record<string, any> | string>>(['https://interactive-examples.mdn.mozilla.net/media/cc0-videos/flower.mp4'])
+const modelvalue3 = ref<Array<Record<string, any> | string>>(['https://interactive-examples.mdn.mozilla.net/media/cc0-videos/flower.mp4'])
+const modelvalue4 = ref<Array<Record<string, any> | string>>(['https://interactive-examples.mdn.mozilla.net/media/cc0-videos/flower.mp4'])
 
 </script>

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.23（2026-10-15）
+* upload-photo,upload-video新增align属性,支持左对齐(默认)和右对齐,可配合addPos设置+号占位符在前或在后。
 ## 3.2.22（2026-09-14）
 * 修复一些问题
 ## 3.2.21（2026-09-07）

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

@@ -60,7 +60,7 @@ flowchart LR
 
 import App from './App'
 // 源码用户
-import Xui from "@/uni_modules/tmx-ui"
+import xui from "@/uni_modules/tmx-ui"
 import type {Tmui4xOptions} from "@/uni_modules/tmx-ui"
 
 import { createSSRApp } from 'vue'

package/data/tmui4x/01./346/225/231/347/250/213/35.Interface/347/261/273/345/236/213.md

@@ -638,6 +638,11 @@ export type FORM_RULE = {
 	 */
 	trigger ?: "change" | "blur"
 };
+/**
+ * 表单规则集合。key 为字段名，嵌套字段可用 / 或 . ，如 user/id、user.id，两者等价。
+ * x-form 的 rules 推荐用这个对象；旧的 Map<string, FORM_RULE[]> 仍可用。
+ */
+export type FORM_RULES = Record<string, FORM_RULE[]>
 export type FORM_SUBMIT_OBJECT = {
 	errorMessage : string,
 	valid : boolean,

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

@@ -6,7 +6,20 @@ outline: deep
 
 TMUI4x 2.0即将到来了！蒸汽版本 C 渲染引擎 配上我的C 插件 相得益彰 ！！！
 
-逻辑层由UTS回到了JS层面。让逻辑层编写更为简单，门槛大大降低。
+逻辑层由UTS回到了TS/JS层面。让逻辑层编写更为简单，门槛大大降低。
+
+所有页面请使用：TS，包括UVUE标签lang="TS"，请停止使用UTS页面，组件，文件。请改用TS！！！
+
+
+## UNIAPP-X停止更新
+
+根据官方通报：uniapp-x vdom(UTS)版本，Uniapp两大产品将在年底停止更新。
+
+因此我强制建议大家将tmui4x的1.x版本和预览版本tmui4x 2.0版本升级到 统一的tmui4.0 的2.0.02的正式版本。
+
+HBX版本强制升级为5.31+版本以上。
+
+终止旧版本的维护和更新。
 
 ## TMUI4x的2.0有哪些更新
 
@@ -30,4 +43,7 @@ TMUI4x 2.0即将到来了！蒸汽版本 C 渲染引擎 配上我的C 插件 相
 
 ## 何时发布2.0？
 
-2026-9底（22-30）即将发布。
+2026-9底（22-30）即将发布预览 Uts/ts混写。
+
+2026-10月下发布 全量 蒸汽 TS 版本，不再支持页面UTS，完整的TS与UTS切割。
+

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

@@ -1,6 +1,8 @@
 # x-chatmarkdown-u AI聊天Markdown
 
-AI 聊天气泡的 Markdown 渲染。支持 GFM 表格、代码高亮、数学公式和流式追加。思考时间、重试、复制按钮请自己在外层做。
+AI 聊天气泡的 Markdown 渲染。支持 GFM 表格、代码高亮、数学公式、图片/视频和流式追加。思考时间、重试、复制按钮请自己在外层做。
+
+图片宽度默认铺满气泡，高度按原图比例自适应；HTML `<img width height>` 或 `<img width="50%">` 里写了尺寸时按写的输出。视频使用各端系统播放器（Android `VideoView`、iOS `AVPlayer`、鸿蒙 `Video`、Web/小程序 `<video>`），带原生控制条。
 
 ### 兼容性
 
@@ -61,6 +63,7 @@ xChatMarkdownParse(md, {
 | linkclick | `{ href, text }` | 点击链接 |
 | codecopy | `{ lang, code }` | 点击代码块复制 |
 | longpress | `{ text }` | 长按气泡；App 端已复制纯文本 |
+| imageclick | `{ src, alt }` | 点击图片（图片被链接包裹时改为触发 `linkclick`） |
 | rendered | `{ blockCount, parseMs }` | 本次解析渲染完成 |
 | error | `{ errSubject, errCode, errMsg }` | 解析或渲染失败 |
 
@@ -82,6 +85,15 @@ xChatMarkdownParse(md, {
 
 ## 更新日志
 
+### 1.2.0（2026-10-20）
+
+- 新增图片渲染：`![alt](url)`、HTML `<img>` 都解析为块级图片；默认铺满容器宽、按原图比例自适应高，HTML 写了 `width` / `height`（含百分比）时按设定尺寸输出
+- 新增视频渲染：HTML `<video>` 与 `![](xxx.mp4)` 自动识别为视频，Android 用系统 `VideoView`、iOS 用 `AVPlayer`、鸿蒙用 `Video`、Web/小程序用 `<video>`，各端带系统控制条
+- Android 图片复用 uni-app x SDK 同款 Fresco（无需新增图片库），支持远程、file、GIF 与内存缓存
+- 段落内与文字混排的图片会在 IR 层拆成「文本段 + 图片块」，三端渲染器无需处理内联图片；表格单元格中的图片退化为 alt 文本
+- 新增 `imageclick` 事件（`{ src, alt }`）；图片被链接包裹时改为 `linkclick`
+- 图片异步解码完成后自动重新测量高度，`sizechange` 会再次触发，`native-view` 不会出现底部空白
+
 ### 1.1.0（2026-08-04）
 
 - Web / 微信小程序：Emscripten 编译独立 `.wasm` + ES6 glue（`export default`），与 App 共用同一套 IR

package/data/tmui4x/10./346/217/222/344/273/266/345/272/223/xWebviewU /346/267/267/345/220/210WebView.md"

@@ -70,7 +70,7 @@ manager?.checkAppInstall("tmui.app.hybrid").then((res) => {
 | setUserAgent | `ua: string` | 设置 User-Agent |
 | getUserAgent | 无 | 返回 Promise，当前 User-Agent |
 | evaJs | `jsCode: string` | 执行网页 JS。Android 返回结果，其它端为 `null` |
-| getManager | 无 | 返回小程序管理器，可 `checkAppInstall` / `installApp` / `openMiniProgramHostUrl` |
+| getManager | 无 | 返回小程序管理器，可 `checkAppInstall` / `installApp` / `openMiniProgramHostUrl`。仅 App 端可用，Web 返回 `null` |
 
 ### 平台差异
 
@@ -78,6 +78,7 @@ manager?.checkAppInstall("tmui.app.hybrid").then((res) => {
 2. `allowLoadUrl` 拦截 iOS 不支持。
 3. `evaJs`：Android 返回执行结果；其它端为 `null`。
 4. `donwload`：iOS 14.5+。
+5. `getManager` 依赖 `uni.getFileSystemManager`，Web 端没有该 API，调用返回 `null`（页面里判空跳过即可）。
 
 ### 版本
 

package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//345/205/266/345/256/203/347/273/204/344/273/266//345/216/237/347/224/237/345/233/276/350/241/250 Chart.md"

@@ -66,6 +66,12 @@
 ```vue
 <template>
 
+	<!-- #ifdef MP-WEIXIN -->
+	<page-meta :page-style="`background-color:${xThemeConfigBgColor}`">
+		<navigation-bar :background-color="xThemeConfigNavBgColor"
+			:front-color="xThemeConfigNavFontColor"></navigation-bar>
+	</page-meta>
+	<!-- #endif -->
 	<x-cell title="折线图 / 面积图" url="/pages/chart/line"></x-cell>
 	<x-cell title="柱状图系列" url="/pages/chart/bar"></x-cell>
 	<x-cell title="饼图系列" url="/pages/chart/pie"></x-cell>

package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//345/205/266/345/256/203/347/273/204/344/273/266//345/233/276/347/211/207/350/243/201/345/211/252 xImageResizer.md"

@@ -2,7 +2,7 @@
 
 ## 介绍
 
-兼容PC操作，可双指缩放，单指平移，翻转，也可支持电脑端滚轮缩放，鼠标平移，裁剪框四角缩放，功能齐全，操作方便。
+兼容PC操作，可双指缩放并同时平移，双击恢复初始适配，单指平移，翻转，也可支持电脑端滚轮缩放，鼠标平移，裁剪框四角缩放。
 裁剪绘制与导出使用 x-skia-u 画布（不再使用官方 canvas），确认时通过 toTempFilePath 返回临时文件路径。
 
 ## 平台兼容

package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//345/205/266/345/256/203/347/273/204/344/273/266//346/200/235/347/273/264/345/257/274/345/233/276 xTreeFlat.md"

@@ -2,7 +2,7 @@
 
 ## 介绍
 
-平面树 / 思维导图。x-skia-u 绘制：App 整帧 SkiaRecorder 一次 renderFrame；节点 roundRect + fillTextBox；native-view 上手势覆盖层。大数据量时布局缓存子树高/宽与节点尺寸，连线按 id 索引；请保证各节点 id 全局唯一。
+平面树 / 思维导图。画布等于视口，x-skia-u 绘制。单指或鼠标拖动平移，双指或滚轮缩放，双击恢复初始视图。不使用 scroll-view。App 整帧 SkiaRecorder 一次 renderFrame。请保证各节点 id 全局唯一。
 
 ## 平台兼容
 

package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//345/205/266/345/256/203/347/273/204/344/273/266//351/242/234/350/211/262/351/200/211/346/213/251 xColorView.md"

@@ -2,7 +2,7 @@
 
 ## 介绍
 
-精致且方便用户操作移动颜色选择容器,为你的APP增彩,兼容PC端操作。光谱/网格用 x-skia-u 绘制（静态只画一次，拖动按公式/色表取色）。嵌在弹层内时，展示后再挂本组件。
+精致且方便用户操作移动颜色选择容器,为你的APP增彩,兼容PC端操作。色相面板是饱和度×明度方块+色相条（Chrome 同款布局，任何颜色都能精确落点），与网格一起用 x-skia-u 绘制（色相条/网格只画一次，方块随色相重画，拖动按公式/色表取色）。嵌在弹层内时，展示后再挂本组件。
 
 ## 平台兼容
 
@@ -28,7 +28,7 @@
 | ------ | ---- | ---- | ---- |
 | modelValue | `当前显示的颜色值,可以是合法的值,可以v-model双向绑定`<br>`如:颜色名称,hex,rgb,rgba,hsl,hsla等值`<br> | `string` | `""` |
 | format | `输出格式:hex,rgba,hsla`<br>`如果输出hex,那么透明度将丢失`<br> | `string` | `'rgba'` |
-| panel | `默认显示的面板`<br>`hue:光谱,rgb:rgb拖动条,grid:网格面板`<br> | `string` | `'hue'` |
+| panel | `默认显示的面板`<br>`hue:色相方块+色相条,rgb:rgb拖动条,grid:网格面板`<br> | `string` | `'hue'` |
 | showAlpha | `是否展示透明度设置`<br> | `boolean` | `true` |
 | colorList | `默认的底部颜色快速选择.`<br> | `string[]` | `() : string[] => [] as string[]` |
 

package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//345/257/274/350/210/252/347/273/204/344/273/266//345/274/225/345/257/274 xGuid.md"

@@ -2,10 +2,11 @@
 
 ## 介绍
 
-内部只可放置x-guid-item。在app上根节点必须是scroll-view或者list-view等可滚动的页面使用。
-还要设置容器:scroll-with-animation="false"禁止滚去动画。
-且你的元素唯一id必须是容器的直接子节点，否则会无效(安卓会无效，为了所有平台有效，必须是容器的直接第一级子节点)。
-您可以参考我的dmeo页面使用，严格按照demo使用！！！
+内部只可放置x-guid-item，遮罩与提示卡由当前激活的x-guid-item自己渲染。
+目标元素必须有页面内唯一的id、可见、且不被隐藏（不可以封装在会裁切的容器里）。
+蒸汽模式（HBuilderX 5.12+）各端页面默认可滚动，组件会自动把目标滚进可视区；
+若页面在pages.json里配置了disableScroll:true（自定义导航栏/tabbar页面官方推荐），页面不可滚动，
+自动滚动会失败并告警，此时请自行保证目标元素在可视区内，或者设置autoScroll=false。
 
 ## 平台兼容
 
@@ -29,9 +30,17 @@
 
 | 名称 | 说明 | 类型 | 默认值 |
 | ------ | ---- | ---- | ---- |
-| maskColor | ``<br> | `string` | `'rgba(0,0,0,0.4)'` |
+| maskColor | `遮罩颜色`<br> | `string` | `'rgba(0,0,0,0.4)'` |
 | activeId | `如果要双向绑定请使用v-model:active-id,您在子组件上定义的target-id属性，且是唯一的`<br> | `string` | `''` |
-| defaultActiveId | ``<br> | `string` | `''` |
+| defaultActiveId | `初始默认选中的id，为空不自动开始引导`<br> | `string` | `''` |
+| zIndex | `遮罩与提示卡的层级，页面里有更高的固定层（底栏等）时可调大`<br> | `number` | `50` |
+| holePadding | `挖洞区域在目标矩形基础上向外扩的边距（px），目标贴边时更好看`<br> | `number` | `0` |
+| holeRadius | `高亮环圆角（px）；四块矩形遮罩做不出圆角洞，圆角由环呈现，建议ringWidth >= holeRadius x 0.3`<br> | `number` | `0` |
+| ringColor | `高亮环颜色，为空不显示环`<br> | `string` | `''` |
+| ringWidth | `高亮环粗细（px）`<br> | `number` | `2` |
+| duration | `切换步骤时遮罩与提示卡的淡入时长（ms），0为不淡入`<br> | `number` | `250` |
+| autoScroll | `目标不在可视区时，是否自动滚动页面到目标处`<br> | `boolean` | `true` |
+| scrollOffset | `透传给uni.pageScrollTo的offsetTop，用于自定义导航栏留白；`<br> | `number` | `0` |
 
 
 ## Events 事件
@@ -75,8 +84,11 @@
 	<!-- #endif -->
 	<x-sheet>
 		<x-text font-size="18" class="text-weight-b mb-8">引导 xGuid {{activeId}}</x-text>
-		<x-text color="#999999">引导组件，需要定位聚焦的元素必须在页面上不可以在子组件中或者隐藏中，并且必须要设定唯一id标识。</x-text>
+		<x-text color="#999999">引导组件，需要定位聚焦的元素必须在页面上不可以在子组件中或者隐藏中，并且必须要设定唯一id标识。蒸汽模式各端页面默认可滚动，目标不在可视区时组件会自动滚过去；页面若在pages.json里配置了disableScroll:true（自定义导航栏/tabbar），自动滚动会失败并告警，此时请自行保证目标可见或设置autoScroll=false。</x-text>
 	</x-sheet>
+	<view class="pa-12">
+		<x-button color="primary" :block="true" @click="onStart">重新开始引导</x-button>
+	</view>
 	<view style="height:50px"></view>
 	<view id="testId1" class="mx-16 mb-16 pa-16">
 		<x-text font-size="18" class="text-weight-b mb-8">节点1 testId1</x-text>
@@ -103,20 +115,29 @@
 		<x-text font-size="18" class="text-weight-b mb-8">节点4 testId4</x-text>
 		<view class="flex flex-row flex-row-center-end">
 			<view>
-				<x-text color="#999999">testId4</x-text>
+				<x-text color="#999999">testId4（在屏幕外，验证自动滚动定位）</x-text>
 			</view>
 		</view>
 	</view>
 	<view style="height:200px"></view>
-	<x-guid v-model:activeId="activeId" defaultActiveId="testId1">
+	<!--
+	hole-padding：挖洞在目标基础上外扩，目标贴边时更好看
+	ring-color / ring-width / hole-radius：高亮环，四块矩形遮罩做不出圆角洞，圆角由环呈现
+	z-index：遮罩与提示卡的层级，页面有更高的固定层（底栏等）时可调大
+	-->
+	<x-guid v-model:activeId="activeId" defaultActiveId="testId1" :hole-padding="6" ring-color="primary"
+		:ring-width="3" :hole-radius="8">
 		<x-guid-item v-for="(item,index) in 4" :key="item" :order="index" :targetId="`testId${item}`"
 			:title="`标题${item}`" :content="`testId${item}`"></x-guid-item>
 	</x-guid>
 </template>
 
 <script lang="ts" setup>
-	const activeId = ref('')
+	const activeId = ref('')
 	
+	const onStart = () => {
+		activeId.value = 'testId1'
+	}
 </script>
 
 <style lang="scss">

package/data/tmui4x/30./347/273/204/344/273/266/345/272/223//345/257/274/350/210/252/347/273/204/344/273/266//345/274/225/345/257/274/345/255/220/347/273/204/344/273/266 xGuidItem.md"

@@ -2,7 +2,7 @@
 
 ## 介绍
 
-内部只可放置在x-guid内。
+内部只可放置在x-guid内，遮罩、高亮环、提示卡都由它自己渲染。
 
 ## 平台兼容
 
@@ -30,6 +30,15 @@
 | order | `必填；顺序索引，一般循环的index即可。`<br> | `number` | `0` |
 | title | `标题`<br> | `string` | `""` |
 | content | `内容描述`<br> | `string` | `""` |
+| bgColor | `提示卡的背景色`<br> | `string` | `"#000000"` |
+| darkBgColor | `提示卡的暗黑背景色，为空取bgColor`<br> | `string` | `""` |
+| color | `提示卡的文字色`<br> | `string` | `"#ffffff"` |
+| round | `提示卡圆角（px）`<br> | `number` | `12` |
+| maxWidth | `提示卡宽度（px）；超过视口可用宽度时自动收窄`<br> | `number` | `350` |
+| titleSize | `标题字号（px）`<br> | `number` | `18` |
+| contentSize | `内容描述字号（px）`<br> | `number` | `14` |
+| gap | `提示卡与挖洞的间距（px）`<br> | `number` | `12` |
+| edge | `提示卡与屏幕边缘、挖洞的最小间距（px）`<br> | `number` | `12` |
 
 
 ## Events 事件
@@ -70,8 +79,11 @@
 	<!-- #endif -->
 	<x-sheet>
 		<x-text font-size="18" class="text-weight-b mb-8">引导 xGuid {{activeId}}</x-text>
-		<x-text color="#999999">引导组件，需要定位聚焦的元素必须在页面上不可以在子组件中或者隐藏中，并且必须要设定唯一id标识。</x-text>
+		<x-text color="#999999">引导组件，需要定位聚焦的元素必须在页面上不可以在子组件中或者隐藏中，并且必须要设定唯一id标识。蒸汽模式各端页面默认可滚动，目标不在可视区时组件会自动滚过去；页面若在pages.json里配置了disableScroll:true（自定义导航栏/tabbar），自动滚动会失败并告警，此时请自行保证目标可见或设置autoScroll=false。</x-text>
 	</x-sheet>
+	<view class="pa-12">
+		<x-button color="primary" :block="true" @click="onStart">重新开始引导</x-button>
+	</view>
 	<view style="height:50px"></view>
 	<view id="testId1" class="mx-16 mb-16 pa-16">
 		<x-text font-size="18" class="text-weight-b mb-8">节点1 testId1</x-text>
@@ -98,20 +110,29 @@
 		<x-text font-size="18" class="text-weight-b mb-8">节点4 testId4</x-text>
 		<view class="flex flex-row flex-row-center-end">
 			<view>
-				<x-text color="#999999">testId4</x-text>
+				<x-text color="#999999">testId4（在屏幕外，验证自动滚动定位）</x-text>
 			</view>
 		</view>
 	</view>
 	<view style="height:200px"></view>
-	<x-guid v-model:activeId="activeId" defaultActiveId="testId1">
+	<!--
+	hole-padding：挖洞在目标基础上外扩，目标贴边时更好看
+	ring-color / ring-width / hole-radius：高亮环，四块矩形遮罩做不出圆角洞，圆角由环呈现
+	z-index：遮罩与提示卡的层级，页面有更高的固定层（底栏等）时可调大
+	-->
+	<x-guid v-model:activeId="activeId" defaultActiveId="testId1" :hole-padding="6" ring-color="primary"
+		:ring-width="3" :hole-radius="8">
 		<x-guid-item v-for="(item,index) in 4" :key="item" :order="index" :targetId="`testId${item}`"
 			:title="`标题${item}`" :content="`testId${item}`"></x-guid-item>
 	</x-guid>
 </template>
 
 <script lang="ts" setup>
-	const activeId = ref('')
+	const activeId = ref('')
 	
+	const onStart = () => {
+		activeId.value = 'testId1'
+	}
 </script>
 
 <style lang="scss">