tmui-cli 2.0.0 → 2.0.2

package/data/tmui4x/10./346/217/222/344/273/266/345/272/223/xShareS /347/263/273/347/273/237/345/210/206/344/272/253.md"

@@ -0,0 +1,134 @@
+# x-share-s 系统分享
+
+调用系统分享，把文本、链接、图片、音视频或任意文件发给其它应用。参数与回调对齐 DCloud `uni.shareWithSystem`，方法名使用 `xShare`，避免和 `uni.share` 重名。
+
+App 端不需要配置微信 / QQ 等三方 SDK。手机上能接收该类型内容的应用都会出现在列表里。
+
+### 兼容性
+
+| Harmony | IOS | Android | WEB | 小程序 |
+| --- | --- | --- | --- | --- |
+| 支持 | 支持 | 支持 | 文本/链接 | 图片/视频/文件 |
+
+建议单次分享不要超过 30MB，部分机型会卡顿。
+
+### 调用
+
+```ts
+import { xShare } from "@/uni_modules/x-share-s"
+
+xShare({
+  summary: "欢迎使用 x-share-s",
+  success: (res) => {
+    console.log(res.errMsg)
+  },
+  fail: (err) => {
+    console.log(err.errCode, err.errMsg)
+  }
+})
+```
+
+未传 `type` 时按内容自动推断：有图片走 `image`，有 `path` 时按扩展名判断，否则为 `text`。
+
+```ts
+xShare({ summary: "一段文本" })
+xShare({ href: "https://uniapp.dcloud.net.cn" })
+xShare({ imageUrl: "/static/logo.png" })
+xShare({ path: tempFilePath })
+xShare({
+  type: "file",
+  filePaths: [pdfPath],
+  title: "分享文件"
+})
+```
+
+### 方法
+
+| 名称 | 说明 |
+| --- | --- |
+| xShare | 打开分享。App 成功表示已经调起系统面板，不代表用户一定分享成功 |
+
+### 参数
+
+`XShareOptions`
+
+| 字段 | 说明 | 默认 |
+| --- | --- | --- |
+| type | `text` / `image` / `video` / `audio` / `file`。不传则自动推断 | `text` |
+| title | Android 选择器标题；鸿蒙预览标题 | - |
+| summary | 文字内容 | - |
+| href | 链接，需 `http/https` | - |
+| imageUrl | 单张本地图片 | - |
+| imagePaths | 多张本地图片 | - |
+| videoPaths | 本地视频 | - |
+| audioPaths | 本地音频 | - |
+| filePaths | 本地文件 | - |
+| path | 单个本地路径快捷字段 | - |
+| success | 成功 | - |
+| fail | 失败 | - |
+| complete | 结束 | - |
+
+路径支持 `/static/...`、绝对路径、`file://`、Android `content://`。App 只支持本地文件。微信小程序可用本地/临时路径，网络图会先下载到临时文件。
+
+### 错误码
+
+| 码 | 含义 |
+| --- | --- |
+| 1001 | 系统错误 |
+| 1002 | 分享内容为空或 type 非法 |
+| 1003 | 图片路径无效 |
+| 1004 | 链接无效 |
+| 1005 | 视频路径无效 |
+| 1006 | 文件不存在 |
+| 1007 | 音频路径无效 |
+| 1008 | 当前平台不支持 |
+| 1009 | 用户取消 |
+
+### 平台差异
+
+1. Android 分享链接到微信只能以文本发出；同时带图片和链接时，微信通常只收图片。
+2. iOS 可以把链接作为独立项目分享；图片 + 链接时，部分应用会把图片当题图。选图/选文件返回的 tmp 绝对路径不要再走 `convert2AbsFullPath`（那是给 `/static` 用的），否则会报路径无效。
+3. Web 走 `navigator.share`，仅文本和链接。
+4. 微信小程序：图片用 `wx.showShareImageMenu`，视频用 `wx.shareVideoMessage`，文件/音频用 `wx.shareFileMessage`。一次只分享列表中的第一项，且必须是本地或临时路径（`wxfile://`、`http://tmp`、选图/截图返回值）。包内 `/static/...` 会先经 `wx.getImageInfo` 转成本地路径；网络图会先 `wx.downloadFile`。文本和链接请用页面 `onShareAppMessage`。
+5. App 的 `success` 表示系统分享面板已打开。Android / iOS / 鸿蒙无法可靠得知用户最终点了哪个应用。
+6. Android 已内置 FileProvider，一般不用再往工程根目录拷贝清单。
+7. 鸿蒙发起分享不需要在 `module.json5` 配 skills（那是接收分享用的）。选文件/相册拿到的 URI 只有临时权限，Share Kit 读不到，会提示「文本不存在」或「文件不支持分享」。插件会先拷到应用沙箱，再用 `fileUri.getUriFromPath` 转成 `file://<bundleName>/...`，并按后缀填精确 UTD。
+
+### 版本
+
+版权归 https://xui.tmui.design 你不得修改及二次开发，仅供 TMUI4 会员商用使用。不得转给非 VIP 会员使用，一经查实数倍赔偿，并追究法律责任。
+
+## 更新日志
+
+### 1.1.5（2026-08-16）
+* iOS 增加 `info.plist` 语言配置（`zh-Hans` 开发语言 + Localizations），系统分享面板不再固定英文。
+### 1.1.4（2026-08-16）
+* iOS 选图后分享不再转 UIImage，并等相册 dismiss 完再 present，避免一直停在「分享中」。
+### 1.1.3（2026-08-16）
+* iOS 选图/选文件后再分享不再先 `convert2AbsFullPath`：临时绝对路径被当成包内相对路径后会报 1003/1006 路径无效。改为先按原路径/`file://` 检查存在，包内 `/static` 才回退转换。
+### 1.1.2（2026-08-16）
+* 鸿蒙分享文件先拷到沙箱再 `fileUri.getUriFromPath`，避免选文件临时 URI 被 Share Kit 报「文本不存在」
+### 1.1.1（2026-08-16）
+* 修复微信小程序分享图片报 `the type of property "src" is illegal`：只传原始字符串路径，先 `getImageInfo` 再 `showShareImageMenu`
+### 1.1.0（2026-08-16）
+* 重写为 DCloud 风格：`xShare({ type, summary, href, imageUrl, ... })`，带 success / fail / complete
+* 参数规范化，对齐 `uni.shareWithSystem`；可用 `path` 快捷分享单个文件，未传 type 时自动推断
+* 微信小程序支持图片（`wx.showShareImageMenu`）、视频（`wx.shareVideoMessage`）、文件（`wx.shareFileMessage`）
+* 鸿蒙改为系统 Share Kit；Android 内置 FileProvider
+### 1.0.8（2025-08-17）
+* 兼容原生鸿蒙
+### 1.0.6（2024-09-22）
+* 修改可能的文件无法读取的问题,有的用户把文件存在到非缓存目录.可能导致文件无法读取.
+### 1.0.5（2024-08-24）
+* 经过测试可以在uniapp上分享啦。也能在ios上分享，可以分享文本和链接到微信中，具体操作请购买后联系我。
+### 1.0.4（2024-08-06）
+* 安卓端改了下判断逻辑
+### 1.0.3（2024-08-05）
+* 解决uniapp项目无法在安卓上分享本地图片资源问题
+### 1.0.2（2024-07-30）
+IOS支持分享文件，视频，音频，图片到微信。
+### 1.0.1（2024-07-11）
+修改支持本地路径文件，兼容uniapp项目。
+### 1.0.0（2024-06-01）
+分享内容到其它应用
+安卓,ios支持。

package/data/tmui4x/10./346/217/222/344/273/266/345/272/223/xSkiaU Skia/347/224/273/345/270/203.md"

@@ -0,0 +1,115 @@
+# x-skia-u Skia画布
+
+实时 Canvas 2D 组件，以及离线单图 Recipe。两端共用同一套 Skia 内核。
+
+迁官方 canvas、合批、手势、鸿蒙/iOS 上屏等见 [常见问题.md](./常见问题.md)。
+
+离线 Recipe 与实时画布都从本插件导入：
+
+```ts
+import { XSkiaRecipe, getDominantColors, getRuntimeInfo } from "@/uni_modules/x-skia-u"
+import { XSkiaCanvas, XSkiaPath2D } from "@/uni_modules/x-skia-u"
+```
+
+### 兼容性
+
+| Harmony | IOS | Android | WEB | 小程序 |
+| --- | --- | --- | --- | --- |
+| 支持 | 支持 | 支持 | 支持 | 支持 |
+
+### 实时画布
+
+```vue
+<x-skia-u ref="canvasRef" :width="360" :height="360" background="#FFFFFF" @ready="drawFullScene"></x-skia-u>
+```
+
+```ts
+function drawFullScene() : void {
+  const canvas = canvasRef.value!.getContext("2d")
+  canvas!.fillStyle = "#2563eb"
+  canvas!.fillRect(20, 20, 80, 80)
+}
+
+canvasRef.value!.getContext("2d")!.toTempFilePath({
+  success: (res) => {
+    console.log(res.tempFilePath)
+  }
+})
+```
+
+### 离线 Recipe
+
+```ts
+const recipe = new XSkiaRecipe({ imagePath: srcPath })
+recipe.resize(720)
+recipe.filter("blur", { radius: 4 })
+recipe.export({
+  target: "file",
+  dst: outPath,
+  success: (res) => {
+    console.log(res.dst, recipe.offsetWidth, recipe.offsetHeight)
+  }
+})
+
+const colors = getDominantColors(srcPath, 5)
+```
+
+iOS 请用 `new XSkiaRecipe(...)`，不要用工厂函数返回的实例。
+
+### 参数
+
+| 字段 | 说明 | 默认 |
+| --- | --- | --- |
+| width | 宽度 | `320` |
+| height | 高度 | `240` |
+| background | 背景色，空为透明 | `""` |
+| pixelRatio | `≤0` 跟随屏幕 DPR | `0` |
+
+### 事件
+
+| 名称 | 参数 | 说明 |
+| --- | --- | --- |
+| ready | 无 | 画布已可呈现。之后缓冲因尺寸重建被清空时会再发，应在回调里全量重绘 |
+
+### 实时画布方法
+
+组件 ref：
+
+| 名称 | 需要 | 说明 |
+| --- | --- | --- |
+| getContext | `"2d"` | 返回 `XSkiaCanvas` |
+| createPath2D | 无 | 创建独立路径，跨端只传 `nativeHandle` |
+| destroy | 无 | 销毁画布 |
+
+`getContext("2d")` 上的绘制方法与原先一致：`fillRect` / `stroke` / `drawImage` / `toTempFilePath` 等。
+
+### 离线 Recipe 方法
+
+创建：
+
+| 名称 | 需要 | 说明 |
+| --- | --- | --- |
+| new XSkiaRecipe | `{ imagePath }` 或 `{ width, height, background? }` | 创建链式构造器。iOS 必须用 new |
+| xImage | `imagePath` | 从图片创建。iOS 请改用 `new XSkiaRecipe` |
+| xCanvas | `width`、`height`，可选 `background` | 空白画布 |
+
+链式方法（均返回 this，最后 `export`）：`resize` / `flip` / `rotate` / `rotate90` / `rotate180` / `rotate270` / `crop` / `roundClip` / `fillRect` / `strokeRect` / `line` / `circle` / `drawText` / `drawImage` / `filter` / `vignette` / `noise` / `gradient` / `export`。
+
+属性：`offsetWidth` / `offsetHeight`（创建后可用，export 成功后按实际输出刷新）。
+
+同步分析：`getImageInfo` / `getAverageColor` / `getDominantColors(path, count=5)` / `getPixelColor` / `getRuntimeInfo` / `getState`。
+
+Recipe 的整图叠加渐变类型是 `XSkiaOverlayGradient`（`from` / `to` / `colors`）。Canvas 2D 的 `XSkiaGradient` 是另一套（`x0` / `y0` / `stops`），不要混用。
+
+滤镜：`blur` / `brightness` / `contrast` / `grayscale` / `invert` / `opacity` / `saturate` / `sepia` / `hue-rotate` / `drop-shadow` / `sharpen` / `temperature` / `tint` / `blackpoint`。
+
+### 平台差异
+
+1. Path2D 跨边界只能传 `nativeHandle`。
+2. `toTempFilePath`、`registerFont`、画布渐变走 `getContext("2d")`。
+3. App 的 Recipe `dst` 为文件路径；Web 多为 dataURL；小程序为临时路径。后两者不要加 query。
+4. Recipe `target="view"` 会失败，请用实时画布。
+
+### 版本
+
+版权归https://xui.tmui.design你不得修改及二次开发，仅供TMUI4会员商用使用。不得转给非VIP会员使用，一经查实数倍赔偿，并追究法律责任。

package/data/tmui4x/10./346/217/222/344/273/266/345/272/223/xSqliteS SQLite/346/225/260/346/215/256/345/272/223.md"

@@ -0,0 +1,248 @@
+# x-sqlite-s SQLite数据库
+
+## 简介
+x-sqlite-s 是一个用于 uni-appx 的 SQLite 数据库操作插件，支持基本的数据库。
+
+### 兼容性
+
+| Harmony | IOS | Android | WEB | 小程序 |
+| --- | --- | --- | --- | --- |
+| 支持 | 支持 | 支持 | 支持 | x |
+
+## 安装
+在插件市场搜索并导入 x-sqlite-s 插件。
+
+## 特别注意
+配置中的密码等加密功能,未实现,只是一个预设功能.
+
+## web注意事项
+
+请到插件目录内复制static到你的根目录static即可。否则web无法使用。
+
+## 类型定义
+
+### SQLiteConfig 配置项
+**鸿蒙不支持自定义其它目录**为了全平台兼容，不建议设置defaultDirectory，
+在安卓和ios中defaultDirectory它可指定为缓存目录，下载目录，用户目录等等沙盒目录。
+但鸿蒙它是固定在`应用目录/rdb/自定义目录`，下，因为实际上是被固定在了`应用目录/rdb/`下.
+因此差异非常大。故，鸿蒙端defaultDirectory我将不会生效。仅在安卓和ios下生效。就算你写了我也不使用。
+鸿蒙一定要离开页面后关闭。否则再次打开时会失败，鸿蒙端他全局允许打开一个db实例，而且是唯一的
+
+```typescript
+type SQLiteConfig = {
+    password?: string;      // 数据库密码
+    encryption?: boolean;   // 是否启用加密
+    defaultDirectory?: string; // 数据库文件存储目录,鸿蒙不支持，它的目录是固定的加密区目录，无法像安卓,ios那样保存到其它目录：比如用户目录，缓存目录等。
+    locateFile?: (filename: string) => string;  // 自定义文件位置，web专用属性，默认内置
+}
+```
+
+### SQLiteResult 返回结果
+```typescript
+type SQLiteResult = {
+    rows?: any[][];        // 查询结果行数据
+    columns?: string[];    // 列名
+    maps?: any[];         // 查询结果对象数组，可通过列名访问数据
+    changes?: number;      // 影响的行数
+    lastInsertRowid?: number;  // 最后插入的行ID
+    error?: string;        // 错误信息
+}
+```
+
+### SQLiteExecuteBatchParams 批量执行参数
+```typescript
+type SQLiteExecuteBatchParams = {
+    sql: string;           // SQL语句
+    params?: any[];        // 参数列表
+}
+```
+
+## API 说明
+
+### 创建数据库
+```javascript
+createDb(filename?: string): boolean
+// web端是Promise函数,执行时可以await createDb
+// app是同步操作,不是Promise
+```
+创建或打开一个数据库。如果未指定文件名，默认为 "sqlite.db"。
+
+### 执行SQL查询
+```javascript
+run(sql: string, params: any[] = []): SQLiteResult
+```
+执行一条SQL语句，支持参数绑定。
+
+### 查询数据
+```javascript
+query(sql: string, params: any[] = []): SQLiteResult
+```
+执行查询语句并返回结果集。
+
+### 插入数据
+```javascript
+insert(table: string, data: object): SQLiteResult
+```
+向指定表插入数据。
+
+### 更新数据
+```javascript
+update(table: string, data: object, where: string, params: any[] = []): SQLiteResult
+```
+更新表中的数据。
+
+### 删除数据
+```javascript
+delete(table: string, where: string, params: any[] = []): SQLiteResult
+```
+删除表中的数据。
+
+### 事务处理
+```javascript
+beginTransaction(): SQLiteResult  // 开始事务
+commit(): SQLiteResult           // 提交事务
+rollback(): SQLiteResult         // 回滚事务
+```
+
+### 批量执行
+```javascript
+executeBatch(statements: SQLiteExecuteBatchParams[]): SQLiteResult[]
+```
+批量执行SQL语句，支持事务。
+
+### 数据库文件管理
+
+**createDb,loadFromBuffer,loadLocal三个函数**
+**web端是Promise函数**
+**app是同步操作,不是Promise**
+
+```javascript
+createDb(filename?: string): boolean    // 创建一个本地数据库,重命的重复创建不会覆盖,只是读取已有的数据库.
+saveLocal(filename?: string): SQLiteResult    // 保存数据库到本地
+loadLocal(filename: string): SQLiteResult     // 从本地加载数据库
+getDatabasePath(): string | null             // app端获取数据库备份临时文件路径
+getDatabasePath(): Uint8Array | null         // web端返回的是二进制数据
+loadFromBuffer(buffer: Uint8Array):void      // web端专用函数,用来从进制制数据加载远程数据库
+setDefaultDirectory(directory: string): void  // 设置数据库文件存储目录
+setPassword(password: string|null): void      // 设置数据库密码，null或空值表示删除密码
+```
+
+### 表操作
+```javascript
+tableExists(tableName: string): boolean       // 检查表是否存在
+createTable(tableName: string, columns: UTSJSONObject): SQLiteResult  // 创建表
+dropTable(tableName: string): SQLiteResult    // 删除表
+```
+
+## 使用示例
+
+### 基本操作
+```javascript
+import {xSqlite} from "@/uni_modules/x-sqlite-s"
+
+// 创建数据库实例并配置
+const db = new xSqlite({
+    encryption: true,
+    password: "mypassword",
+    defaultDirectory: "/custom/db/path"
+});
+
+// 创建数据库
+db.createDb("mydb");
+
+// 创建表
+db.createTable("users", {
+    "id": "INTEGER PRIMARY KEY AUTOINCREMENT",
+    "name": "TEXT",
+    "age": "INTEGER"
+});
+
+// 插入数据
+db.insert("users", {
+    name: "张三",
+    age: 25
+});
+
+// 查询数据
+const result = db.query("SELECT * FROM users WHERE age > ?", [20]);
+console.log(result.rows);    // 通过数组下标访问：[[1, "张三", 25], [2, "李四", 30]]
+console.log(result.maps);    // 通过列名访问：[{"id": 1, "name": "张三", "age": 25}, {"id": 2, "name": "李四", "age": 30}]
+```
+
+### 事务使用
+```javascript
+// 开始事务
+db.beginTransaction();
+
+try {
+    db.insert("users", { name: "李四", age: 30 });
+    db.insert("users", { name: "王五", age: 35 });
+    db.commit();
+} catch (e) {
+    db.rollback();
+}
+```
+
+### 批量操作
+```javascript
+const statements = [
+    {
+        sql: "INSERT INTO users (name, age) VALUES (?, ?)",
+        params: ["赵六", 40]
+    },
+    {
+        sql: "UPDATE users SET age = ? WHERE name = ?",
+        params: [45, "张三"]
+    }
+];
+
+db.executeBatch(statements);
+```
+
+### 数据库配置管理
+```javascript
+// 更改数据库存储目录
+db.setDefaultDirectory("/new/db/path");
+
+// 更新数据库密码
+db.setPassword("newpassword");
+
+// 移除数据库密码
+db.setPassword(null);
+```
+
+## 注意事项
+1. 在进行数据库操作前，确保已经成功创建/打开数据库
+2. 使用参数绑定来防止SQL注入
+3. 大量数据操作时建议使用事务
+4. 及时关闭不再使用的数据库连接
+5. 加密数据库需要在创建时指定密码
+
+## 更新日志
+
+### 1.0.7（2026-08-20）
+* 安卓：Statement / Cursor 用后关闭；重复 createDb 先关旧连接；未知绑定类型不再静默跳过。
+* iOS：createDb 返回真实成败；绑定文本使用 SQLITE_TRANSIENT；重复打开先关旧连接。
+* 鸿蒙：查询后关闭 ResultSet；修正文件名重复追加 .db；事务中允许查询。
+* Web：修复事务 / 批量被 isInTransaction 拦截；wasm 脚本只加载一次；saveLocal 成功返回结果。
+### 1.0.6（2026-04-21）
+* 修复安卓错误的宽容性。
+### 1.0.5 (2025-11-26)
+* 安卓端优化了两行代码，删除警告。
+### 1.0.4 (2025-10-24)
+* 鸿蒙端增加了部分函数的路径及文件名校验，防止使用者没有按跨平台规范使用。
+### 1.0.3 (2025-09-03)
+* 适配鸿蒙
+### 1.0.2 (2025-05-18)
+* 修复安卓端执行插入数据时，可能会被执行两次。修复安卓/ios端不能使用应用的uni.env.USER_DATA_PATH目录及自定二级目录，在安卓端执行COUNT(*)时类型转换错误。
+### 1.0.1 (2025-05-05)
+* 修复安卓端执行插入数据时，可能会被执行两次。
+### 1.0.0 (2025-03-15)
+### ✨ 新功能
+- 支持基本的SQLite3数据库操作
+  - 数据库的创建、打开和关闭
+  - 表的创建和删除
+  - 数据的增删改查操作
+- 支持数据库加密功能
+- 支持事务处理
+- 支持批量SQL执行

package/data/tmui4x/10./346/217/222/344/273/266/345/272/223/xSseS SSE/346/216/250/351/200/201.md"

@@ -0,0 +1,127 @@
+# x-sse-s SSE推送
+
+进程级单连接 SSE。`new SSEClientApp()` 只是门面，全局只保持一条活连接；再次 `create` 会断开旧连接，**监听保留**。
+
+**微信小程序没有流式 HTTP，`connect` 会报 1008。** Web / 微信不支持自定义证书，`applyTls` 为空实现。
+
+### 兼容性
+
+| Harmony | IOS | Android | WEB | 小程序 |
+| --- | --- | --- | --- | --- |
+| 支持 | 支持 | 支持 | 支持 | x |
+
+鸿蒙需要 `ohos.permission.INTERNET`。
+
+### 调用
+
+```ts
+import { SSEClientApp, xSSEOptions } from "@/uni_modules/x-sse-s"
+
+const sse = new SSEClientApp()
+
+sse.onMessage((msg: string) => {
+  console.log(msg)
+})
+
+sse.create({
+  method: "get",
+  url: "https://testsse.element-ui-x.com/api/sse",
+  header: {},
+  rejectUnauthorized: true
+} as xSSEOptions)
+
+sse.connect()
+```
+
+构造时传入 `xSSEOptions` 等价于立刻 `create`，兼容旧写法：
+
+```ts
+const sse = new SSEClientApp({
+  method: "post",
+  url: "https://testsse.element-ui-x.com/api/sse",
+  header: { token: "token" }
+})
+sse.setBody({ prompt: "hi" })
+sse.connect()
+```
+
+### 方法
+
+| 名称 | 参数 | 说明 |
+| --- | --- | --- |
+| create | `xSSEOptions` | 配置并替换当前连接，不自动 connect |
+| connect | `headers?` | 连接 SSE；可临时合并 header |
+| setBody | `string \| ArrayBuffer \| UTSJSONObject` | POST 时在 connect 前设置请求体 |
+| disconnect | 无 | 断开，保留监听 |
+| destroy | 无 | 断开并清空监听 |
+| isConnected | 无 | 是否已打开 |
+| getState | 无 | `wait` / `opening` / `open` / `closed` / `error` |
+| applyTls | `SSE_TLS_OPTS` | 写入证书配置，下次 create 生效。Web / 微信空实现 |
+| onOpen / onError / onClosed / onMessage | 回调 | 兼容旧 API，换连接时保留 |
+| addEventListener | `open` / `error` / `closed` / `message` | 返回监听 id；`error` / `message` 的 data 为字符串 |
+| removeEventListener | `id` | 按 id 移除 |
+
+`error` 事件的 data 为 `errCode:errMsg`。`onError` 仍无参，兼容旧代码。
+
+### 证书
+
+Android / iOS / Harmony 从**各端插件资源目录**读取证书，更换后重新打包：
+
+| 平台 | 目录 |
+| --- | --- |
+| Android | `utssdk/app-android/assets/` |
+| iOS | `utssdk/app-ios/Resources/` |
+| Harmony | `utssdk/app-harmony/resources/rawfile/` |
+
+| 字段 | 说明 |
+| --- | --- |
+| certName | CA：`ca.crt` / `ca.pem`。若为 `.p12` 则作为客户端证书 |
+| clientCertName | 客户端证书。Android/iOS 用 p12；Harmony 用 pem |
+| clientKeyName | Harmony mTLS 私钥 pem |
+| certPassword | p12 或私钥密码 |
+| rejectUnauthorized | 默认 `true` |
+| serverName | SNI，默认从 url 解析主机名 |
+
+仓库自带示例 `x-sse-ca.crt`（公共根 CA，文件名避开与其它插件冲突）。私有 CA / mTLS 请替换同名文件或改 `certName` 后重新出包。Web / 微信走系统信任链，自定义证书无效。
+
+### 错误码
+
+| 码 | 含义 |
+| --- | --- |
+| 1001 | 系统错误 |
+| 1002 | 参数错误 |
+| 1005 | 连接超时 |
+| 1008 | 当前平台不支持此协议或证书 |
+| 1010 | 尚未 create |
+| 1011 | 证书加载失败 |
+| 1012 | 证书校验失败 |
+
+### 注意事项
+
+使用前一定要打基座才可用，一定要在页面上先引用，再去打基座。
+如果你 mac 开发，ios 可以不用打基座，能直接使用（但前提是你要配置好原生开发环境，否则一样要打包）。
+如果你是开发安卓，不管是 mac、win 电脑都要打包基座才能使用。
+
+### 版本
+
+版权归 https://xui.tmui.design 你不得修改及二次开发，仅供 TMUI4 会员商用使用。不得转给非 VIP 会员使用，一经查实数倍赔偿，并追究法律责任。
+
+## 更新日志
+
+### 1.1.1（2026-08-16）
+* 鸿蒙禁止 for-in，header 遍历改为 UTSJSONObject.keys
+### 1.1.0（2026-08-16）
+* 改为进程级单连接：再次 create 自动断开旧实例，监听保留
+* 新增 destroy / getState / applyTls / addEventListener；证书从各端资源目录加载
+* 鸿蒙去掉 HAR，改为原生 HTTP 流式 SSE
+* Web GET 改为 fetch，支持自定义 header；微信保持同签名并返回 1008
+### 1.0.3（2026-07-27）
+* 安卓和ios事件移到主线程
+### 1.0.3（2026-06-05）
+* 新增支持post,get请求方法，post时允许使用方法setBody来设置向服务器发送body数据体
+### 1.0.2（2025-07-25）
+* 兼容原生鸿蒙
+### 1.0.1（2025-05-22）
+参数修改，支持header
+### 1.0.0（2025-01-07）
+连接sse服务器