tmui-cli 2.0.6 → 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-09-20T01:56:08.175Z",
+  "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-09-20T01:56:08.182Z",
+  "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-09-20T01:56:08.190Z",
+  "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/02./346/233/264/346/226/260/346/227/245/345/277/227.md

@@ -6,6 +6,10 @@ outline: deep
 
 ![tmui4.0|xui](/logo.png)
 
+## 2.0.0（2026-09-29）
+* 【tmui4x vapor 2.0已发布】
+
+
 ## 1.1.23（2026-08-10）
 * 本次更新仅5.23编译，记住是非蒸汽模式（本版本未适配蒸汽）
 * 关于未来规划事宜详见[点此访问](https://xui.tmui.design/01.%E6%95%99%E7%A8%8B/50.TMUI4x%E8%92%B8%E6%B1%BD%E8%AE%A1%E5%88%92)

package/data/tmui4x/01./346/225/231/347/250/213/06./345/216/237/347/224/237/346/217/222/344/273/266/344/275/277/347/224/250/346/214/207/345/215/227.md

@@ -0,0 +1,35 @@
+---
+outline: deep
+---
+
+# 原生插件指南
+
+本项目原生插件众多，包含了各种原生功能场景。
+
+可以为你的AI提供语料支撑，即可以让AI参考我的原生个插件来修改，扩展，以及帮助你写更多的原生插件功能。AI会自动查找本插件库即遥有的
+成功示例和源码协助你修改和新建插件。同时提供SKILL指南及工具
+
+## 使用前的知识
+
+本插件库分为```-u```和```-s```结尾后缀的插件目录名称
+
+使用前需要复制到根目录``` uni_modules/ ```下，并打离线基座，我也为你提供了离线基座的辅助工具，不是帮你打包，只是辅助工具
+需要你自己配置打包环境及下载官方的SDK。方便你们打基座和修改插件，创建新插件并快速验证DEMO之用。
+
+- -u代表标准插件，可以像标签一样直接在页面上渲染和显示。
+- -s代表API插件，可以在任意位置导入直接调用使用。
+
+## 编译和修改
+
+原生插件是由各平台原生语言写成。
+
+如今是AI时代，不需要你懂各平台原生，只要AI在手就行了，通过[技能文档](https://git.tmui.design/)下载
+相关SKILL文档技能，并且下载插件代码仓库，让AI自行学习使用和写插件，不需要你来写。
+
+我提供的插件很多如果出现了 ```native-src```目录表示是C或者汇编编译的包，可能你只有包没有源码，只有一些零散的C文件
+此时你需要联系我提供完整的源码。
+
+因为仓库大小有限制源文件又关联其它依赖库，非常庞大，因此需要编译的插件我可能未提供原始C源码请联系我发送。
+
+同时有些插件插件：端侧大模型，文档校正等需要模型库，你们也可以自己量化模型或者编译，也可以联系我编译好的模型，比如Qwen3.8 0.8b等模型
+是可以在手机上作为客服小助手使用的。如果你需要自己研究和编译其它模型可以自己拿到源码后自己编译。

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

@@ -24,6 +24,8 @@ outline: deep
 [常见问题](/01.教程/20.常见问题) | 
 [vip代码仓库](https://devops.aliyun.com/)
 
+一共包含四个部分：UI代码仓库，原生插件源码仓库，文档仓库，辅助工具仓库
+
 :::
 
 ::: warning 购买源码用户提醒
@@ -58,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,19 +6,20 @@ outline: deep
 
 TMUI4x 2.0即将到来了！蒸汽版本 C 渲染引擎 配上我的C 插件 相得益彰 ！！！
 
-逻辑层由UTS回到了JS层面。让逻辑层编写更为简单，门槛大大降低。
+逻辑层由UTS回到了TS/JS层面。让逻辑层编写更为简单，门槛大大降低。
 
-## 原生X项目与蒸汽对比
+所有页面请使用：TS，包括UVUE标签lang="TS"，请停止使用UTS页面，组件，文件。请改用TS！！！
 
-| 项目 | 非蒸汽 | 蒸汽 | 说明 |
-| --- | --- | --- | --- |
-| 渲染层 | 安卓和鸿蒙纯原生，IOS类似NVUE | 自有C渲染引擎，类似FL，RN | - |
-| 代码层 | UTS，安卓编译至KT，IOS->JS,鸿蒙->JS | JS | 蒸汽后可以全部JS/TS/UTS写 |
-| 严格语法 | UTS安卓严格，鸿蒙和IOS非严格 | 非严格且可随意 | - |
-| 性能 | 一般，但安卓无延迟高效 | 渲染层与代码层分离 | 理论上蒸汽是JS通信渲染层有通信折损，非蒸汽纯原生高效跟手，如何看待就看各位实际感受了 |
-| 插件生态 | 无法使用NPM生态 | 可以使用（有限） | 蒸汽已经是JS了理论上所有NPM生态可用，但自己也考虑兼容，因为它也是有个V8层的 |
-| UTS插件 | 编译自各原生 | 编译自各原生 | 无区别，但非蒸汽没有通信折扣，蒸汽就是类似UNIAPP的JS调用原生API |
-| 平台兼容 | 5端 | 6端(未来有支付宝小程序) | 总体区别不大 |
+
+## UNIAPP-X停止更新
+
+根据官方通报：uniapp-x vdom(UTS)版本，Uniapp两大产品将在年底停止更新。
+
+因此我强制建议大家将tmui4x的1.x版本和预览版本tmui4x 2.0版本升级到 统一的tmui4.0 的2.0.02的正式版本。
+
+HBX版本强制升级为5.31+版本以上。
+
+终止旧版本的维护和更新。
 
 ## TMUI4x的2.0有哪些更新
 
@@ -32,14 +33,17 @@ TMUI4x 2.0即将到来了！蒸汽版本 C 渲染引擎 配上我的C 插件 相
 8. 推出一批纯C底层高性能的插件，比如离线Canvas渲染，这个Dcloud是没有的，可以用来处理图片，绘制，离线UI渲染来自Google Skia源自Flutter同版本核心引擎。不止这一个原生C引擎，还有其它更多C底层引擎插件，花费大量的时间C交叉编译，至三端。
 9. UI组件层尽量使用蒸汽下的最新属性和性能
 
-## 何时发布2.0？
+## 跟上AI时代
+
+新的版本将发布我已经验证很久的技能及系列MCP，打包编译协助工具（不是帮你打包，是协助你配置离线编译的工具包）帮助AI自动化。
+相关工具已经基本测试通过验证，之后你们写插件，页面，打包，发布都可以在对话框中命令AI帮你操作。
 
-这取决于我对Dcloud的蒸汽版本SDK的评估。
+你唯一要操作的是配置好环境，MCP，Skills等就可以在日后工作中使用AI处理这些繁杂事了。当然也可以手动。
 
-## 未来如何走？
 
-随着AI快速的发展，组件的层面意义被无限弱化，甚至可以说不太重要了，因此更新会越来越慢。因为ai可以搞定一切，组件的意义已经不大了。
+## 何时发布2.0？
+
+2026-9底（22-30）即将发布预览 Uts/ts混写。
 
-AI诊断，AI测试，AI编写需求及插件更为顺应时代，但它需要一个更称手SKILL约束及MCP工具。
+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/xSkiaU Skia/347/224/273/345/270/203.md"

@@ -69,7 +69,7 @@ iOS 请用 `new XSkiaRecipe(...)`，不要用工厂函数返回的实例。
 
 | 名称 | 参数 | 说明 |
 | --- | --- | --- |
-| ready | 无 | 画布已可呈现。之后缓冲因尺寸重建被清空时会再发，应在回调里全量重绘 |
+| ready | 无 | 画布已可呈现。首次在业务组件挂载后发出（不会早于模板 ref 可用）；之后缓冲因尺寸重建被清空时会再发，应在回调里全量重绘 |
 
 ### 实时画布方法
 

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//344/272/214/347/273/264/347/240/201 xQrcoder.md"

@@ -38,7 +38,7 @@
 | padding | `边距`<br> | `number` | `2` |
 | mode | `绘制样式：rect/circular/line/rectSmall/xing/vertical`<br> | `string` | `"rect"` |
 | pdRounded | `定位位点是否使用圆角`<br> | `boolean` | `false` |
-| wifi | `生成wifi码`<br> | `UTSJSONObject` | `() : UTSJSONObject => ({} as UTSJSONObject)` |
+| wifi | `生成wifi码`<br> | `Record` | `() : Record<string, any> => ({} as Record<string, any>)` |
 
 
 ## Events 事件
@@ -147,7 +147,7 @@
 	
 </template>
 
-<script setup>
+<script setup lang="ts">
 	const qxqr = ref<XQrcoderComponentPublicInstance|null>(null)
 	const logo = ref('')
 	const text = ref('https://tmui.design')
@@ -156,13 +156,13 @@
 	const auth = ref("WPA")
 	const password = ref("123456")
 	const hidnpassword = ref("true")
-	const wifiQr = computed(():UTSJSONObject=>{
+	const wifiQr = computed(():Record<string, any>=>{
 		return {
 			ssid:ssid.value,
 			auth:auth.value,
 			password:password.value,
 			hidden:hidnpassword.value
-		} as UTSJSONObject
+		} as Record<string, any>
 	})
 	const getImgQr = ()=> {
 		qxqr.value?.getQrImg?.((imgstr:string)=>{

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,8 +2,8 @@
 
 ## 介绍
 
-兼容PC操作，可双指缩放，单指平移，翻转，也可支持电脑端滚轮缩放，鼠标平移，裁剪框四角缩放，功能齐全，操作方便。
-web端裁剪后返回的是Base64数据，其它端是文件连接。
+兼容PC操作，可双指缩放并同时平移，双击恢复初始适配，单指平移，翻转，也可支持电脑端滚轮缩放，鼠标平移，裁剪框四角缩放。
+裁剪绘制与导出使用 x-skia-u 画布（不再使用官方 canvas），确认时通过 toTempFilePath 返回临时文件路径。
 
 ## 平台兼容
 
@@ -37,7 +37,7 @@ web端裁剪后返回的是Base64数据，其它端是文件连接。
 
 | 名称 | 参数 | 说明 |
 | ------ | ---- | ---- |
-| confirm | `filepath: string<br>` | 确认时返回文件<br>ios,安卓返回的是缓存文件路径<br>web返回的是Bolb文件对象<br>微信返回的是base64图片数据 |
+| confirm | `filepath: string<br>` | 确认时返回文件<br>app端返回缓存文件路径(file://)，web/微信端返回 dataURL |
 | cancel | `-` | 取消裁剪时触 |
 
 

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/350/241/250 xEchart.md"

@@ -119,7 +119,7 @@
 			if (data!=null&& typeof data == 'object') {
 				uni.showModal({
 					title: "提醒",
-					content: JSON.stringify(data! as UTSJSONObject),
+					content: JSON.stringify(data! as Record<string, any>),
 					showCancel: false
 				})
 			}
@@ -145,7 +145,7 @@
 					data: [100, 50, 20, 70, 40, 600]
 				}
 			]
-		} as UTSJSONObject
+		} as Record<string, any>
 
 		echart.value?.setOptions?.(opts)
 		
@@ -194,7 +194,7 @@
 					}
 				}
 			]
-		} as UTSJSONObject;
+		} as Record<string, any>;
 
 		echart2.value?.setOptions?.(option)
 	}
@@ -221,7 +221,7 @@
 				}
 			]
 
-		} as UTSJSONObject
+		} as Record<string, any>
 		echart.value?.setOptions?.(opts)
 	}
 </script>