tmui-cli 2.0.1 → 2.0.2

package/data/tmui4x/10./346/217/222/344/273/266/345/272/223/xPhotokitS /345/233/276/347/211/207/346/260/264/345/215/260.md"

@@ -0,0 +1,78 @@
+# x-photokit-s 图片水印
+
+给图片加多行文字水印，支持 5 个位置、压缩和安全边距。
+
+### 兼容性
+
+| Harmony | IOS | Android | WEB | 小程序 |
+| --- | --- | --- | --- | --- |
+| 支持 | 支持 | 支持 | 支持 | 支持 |
+
+### 调用
+
+```ts
+import { addWaterMark } from "@/uni_modules/x-photokit-s"
+
+addWaterMark({
+  path: imagePath,
+  opts: {
+    text: ["ID4656s5fsdf", "编号图片的位置xx", "广东省上海路699号江杨区域"],
+    color: "rgba(32, 36, 255, 1.0)",
+    fontSize: 12,
+    position: "center",
+    compress: 100,
+    prefix: "tmx-",
+    lineSpace: 3,
+    safeOffset: 10
+  },
+  success: (res) => {
+    uni.previewImage({ urls: [res.detail], current: res.detail })
+  }
+})
+```
+
+### 方法
+
+| 名称 | 需要 | 说明 |
+| --- | --- | --- |
+| addWaterMark | `path`、`opts`，可选 `success` | 给图片加水印，成功 `res.detail` 为输出路径 |
+
+### 参数
+
+`xPhotokitSOpts`
+
+| 字段 | 说明 | 默认 |
+| --- | --- | --- |
+| path | 图片路径 | 必填 |
+| opts | 水印配置 | 必填 |
+| success | 成功，`res.detail` 为输出路径 | - |
+| fail | 失败 | - |
+| complete | 结束 | - |
+
+`XPHOTOKIT_ADDWATERMARK_OPTS`
+
+| 字段 | 说明 | 默认 |
+| --- | --- | --- |
+| text | 多行文字 | `[]` |
+| fontSize | 字号，会按图片尺寸缩放 | `12` |
+| color | 颜色，支持 rgb / rgba / Hex / HSL | `#ffffff` |
+| position | `topLeft` / `topRight` / `bottomLeft` / `bottomRight` / `center` | `center` |
+| compress | 压缩 0~100，100 不压缩 | `100` |
+| prefix | 输出文件名前缀 | 时间戳 |
+| lineSpace | 行间距 | `0` |
+| safeOffset | 距边安全距离 | `0` |
+| webOutFileType | Web 输出：`base64` 或 `Blob` | `base64` |
+
+### 平台差异
+
+1. Web 可用 `webOutFileType` 控制返回 base64 或 Blob。
+
+### 版本
+
+版权归https://xui.tmui.design你不得修改及二次开发，仅供TMUI4会员商用使用。不得转给非VIP会员使用，一经查实数倍赔偿，并追究法律责任。
+
+## 更新日志
+
+### 1.0.0（2025-10-15）
+* 针对鸿蒙的兼容,优化web和微信。
+* 针对不同图片大小，智能缩放字号大小让字号不过大也不过小。

package/data/tmui4x/10./346/217/222/344/273/266/345/272/223/xPrintS /347/263/273/347/273/237/346/211/223/345/215/260.md"

@@ -0,0 +1,105 @@
+# x-print-s 系统打印
+
+调用系统打印预览，支持 PDF、文本、图片。
+
+### 兼容性
+
+| Harmony | IOS | Android | WEB | 小程序 |
+| --- | --- | --- | --- | --- |
+| 支持 | 支持 | 支持 | 支持 | 不支持 |
+
+### 调用
+
+```ts
+import { printPdf, printTxt, printImage } from "@/uni_modules/x-print-s"
+
+printPdf({
+  filename: "测试pdf.pdf",
+  filepath: tempFilePath,
+  success: (res) => {
+    console.log(res.errCode)
+  }
+})
+
+printTxt({
+  filename: "测试文本.txt",
+  content: "第一行\n第二行",
+  margin: 20,
+  fontSize: 32,
+  lineSpacing: 1.5,
+  paperSize: "A4"
+})
+
+printImage({
+  filename: "测试图片.jpg",
+  filepath: imagePath
+})
+```
+
+选图后立刻打印时，iOS 需等选择器关闭后再调，可用短延迟。
+
+### 方法
+
+| 名称 | 需要 | 说明 |
+| --- | --- | --- |
+| printPdf | `filepath`，可选 `filename`、`paperSize`、`copies`、`margin` | 打印 PDF，远程地址会先下载 |
+| printTxt | `content`，可选 `filename`、`margin`、`fontSize`、`lineSpacing`、`paperSize` | 打印文本 |
+| printImage | `filepath`，可选 `filename`、`margin`、`paperSize` | 打印图片，等比居中 |
+
+### 参数
+
+公共字段：`filename`、`paperSize`（`A4` / `A5` / `A6` / `B5` / `B6` / `letter`）、`copies`、`success` / `fail` / `complete`。成功时 `errCode` 为 0。
+
+`printPdf`
+
+| 字段 | 说明 | 默认 |
+| --- | --- | --- |
+| filepath | 本地或远程 PDF | 必填 |
+| margin | 页边距 pt，PDF 暂不生效 | - |
+
+`printTxt`
+
+| 字段 | 说明 | 默认 |
+| --- | --- | --- |
+| content | 文本，支持 `\n` | 必填 |
+| margin | 页边距 pt | `20` |
+| fontSize | 字号 pt，`0` 或不传则自适应 | 自适应 |
+| lineSpacing | 行距倍数 | `1.4` |
+
+`printImage`
+
+| 字段 | 说明 | 默认 |
+| --- | --- | --- |
+| filepath | 本地或远程图片 | 必填 |
+| margin | 四周留边 pt，等比居中 | `10` |
+
+远程地址会先下载再打印。
+
+### 平台差异
+
+1. `paperSize` / `copies`：Android / Web 部分生效；iOS 由系统打印面板控制。
+2. PDF 的 `margin` 暂不生效；iOS 图片 `margin` 暂不生效。
+3. 鸿蒙需打印权限（插件已声明）。
+
+### 版本
+
+版权归https://xui.tmui.design你不得修改及二次开发，仅供TMUI4会员商用使用。不得转给非VIP会员使用，一经查实数倍赔偿，并追究法律责任。
+
+## 更新日志
+
+### 1.2.0（2026-08-01）
+- 新增鸿蒙（HarmonyOS NEXT）平台支持：PDF/文本/图片打印，基于系统 print 能力，自动申请 PRINT 权限
+- 新增排版参数：页边距 margin、字号 fontSize、行距 lineSpacing（文本）
+- 新增纸张类型参数 paperSize（A4/A5/A6/B5/B6/letter，Android/Web 生效）
+- 新增份数参数 copies（三端由系统打印面板控制，预留）
+
+### 1.1.0（2026-08-01）
+- 改造成 DCloud 函数式风格 API，统一 `success` / `fail` / `complete` 回调
+- 新增文本（txt）打印，支持自动分页排版
+- 新增图片打印（jpg/png）
+- 新增 Web（H5）端打印支持
+- 新增远程地址自动下载后再打印
+- 新增统一错误码规范（unierror.uts）
+
+### 1.0.0（2024-06-01）
+发布第一版本，双端支持打印 pdf 文件。

package/data/tmui4x/10./346/217/222/344/273/266/345/272/223/xScreenshotS /346/210/252/345/233/276/344/270/216/351/230/262/346/210/252/345/261/217.md"

@@ -0,0 +1,177 @@
+# x-screenshot-s 截图与防截屏
+
+窗口截图、节点截图、系统截屏监测并回传当前页截图、防截屏 / 录屏检测。函数与类型均加 `x` 前缀，避免与官方同名冲突。一次性 API 使用 DCloud `success / fail / complete`。
+
+### 兼容性
+
+| Harmony | iOS | Android | WEB | 微信小程序 |
+| --- | --- | --- | --- | --- |
+| 窗口支持，节点截图不建议 | 支持 | 支持 | 节点截图部分支持 | 监测 / 防截屏部分支持 |
+
+Web 端窗口截图、防截屏返回 `fail 1005 / 1008`。微信端主动截图返回 `fail 1005`，`xOnUserCaptureScreen` 可监听但不回传图片。鸿蒙节点截图见注意事项。
+
+### 调用
+
+```ts
+import {
+  xTakeSnapshot,
+  xTakeElementSnapshot,
+  xOnUserCaptureScreen,
+  xOffUserCaptureScreen,
+  xSetUserCaptureScreen,
+  xGetUserCaptureScreen,
+  xOnScreenCapturedChange,
+  xOffScreenCapturedChange,
+  xIsScreenCaptured,
+  xIsCaptureScreenEnabled,
+  XTakeSnapshotOptions,
+  XTakeElementSnapshotOptions
+} from "@/uni_modules/x-screenshot-s"
+
+xTakeSnapshot({
+  format: "png",
+  success: (res) => {
+    console.log(res.path, res.width, res.height)
+  }
+} as XTakeSnapshotOptions)
+
+const ele = uni.getElementById("shotBox")
+xTakeElementSnapshot({
+  ele: ele,
+  format: "png",
+  success: (res) => {
+    uni.previewImage({
+      current: res.path,
+      urls: [res.path] as string[]
+    })
+  }
+} as XTakeElementSnapshotOptions)
+
+const listenId = xOnUserCaptureScreen((res) => {
+  // res.path 为监测到系统截屏后，插件即时截取的当前窗口图，便于反馈上传
+  console.log(res.path, res.systemPath)
+})
+
+xSetUserCaptureScreen({
+  enable: false
+})
+
+const recordId = xOnScreenCapturedChange((res) => {
+  console.log(res.captured)
+})
+
+xOffUserCaptureScreen(listenId)
+xOffScreenCapturedChange(recordId)
+```
+
+### 方法
+
+| 名称 | 说明 |
+| --- | --- |
+| xTakeSnapshot | 截取当前窗口 |
+| xTakeElementSnapshot | 截取指定节点 |
+| xOnUserCaptureScreen | 监听用户系统截屏，返回监听 id；回调带当前窗口即时截图路径 |
+| xOffUserCaptureScreen | 移除截屏监听；不传 id 则移除本插件全部截屏监听 |
+| xSetUserCaptureScreen | `enable: true` 允许截屏，`false` 禁止截屏 / 录屏 |
+| xGetUserCaptureScreen | 查询当前是否允许系统截屏 |
+| xOnScreenCapturedChange | 监听录屏 / 投屏 / 镜像变化，返回监听 id |
+| xOffScreenCapturedChange | 移除录屏监听；不传 id 则全部移除 |
+| xIsScreenCaptured | 同步查询是否正在被录屏 / 投屏 |
+| xIsCaptureScreenEnabled | 同步查询是否允许系统截屏 |
+
+旧 API `getRootShotImage` / `getElementShotImage` 已移除，请改用 `xTakeSnapshot` / `xTakeElementSnapshot`。
+
+### 参数
+
+`format`：`png`（默认）或 `jpg`。节点 PNG 仅绘制目标 View，并临时去掉目标自身 background 以保留透明底；JPG 会合成父级背景。
+
+`quality`：仅 JPG，范围 1-100，默认 90。
+
+`xSetUserCaptureScreen.enable`：`true` 允许用户截屏，`false` 开启隐私保护。插件主动截图在 Android / iOS 上仍可用，方便应用内反馈。
+
+### 错误码
+
+`1001` 截图失败，`1002` 未知错误，`1003` 元素无效，`1004` 宽高为 0，`1005` 当前平台不支持截图，`1006` 系统版本过低，`1007` format 非法，`1008` 当前平台不支持该能力，`1009` 参数错误，`1010` 防截屏设置失败，`1011` 权限被拒绝。
+
+### 平台差异
+
+**Android**
+
+- 窗口截图：Android 7.0+ 优先 `PixelCopy`，失败或已防截屏时回退 Canvas，并叠加 TextureView 画面。
+- 系统截屏监测：Android 14+ 使用 `registerScreenCaptureCallback`（需 `DETECT_SCREEN_CAPTURE`）。更低版本用 MediaStore / 截屏目录监听，建议授予 `READ_MEDIA_IMAGES` 或 `READ_EXTERNAL_STORAGE`。
+- 防截屏：`FLAG_SECURE`。
+- 录屏检测：Android 15+ `addScreenRecordingCallback`。
+
+**iOS**
+
+- 截图：`drawHierarchy(afterScreenUpdates: true)`。
+- 系统截屏监测：`userDidTakeScreenshotNotification`，系统不提供原图，插件会即时截取当前页。
+- 防截屏：iOS 13+ 安全图层（iOS 15.1 不支持，`fail 1010`）。
+- 录屏 / 投屏：`UIScreen.isCaptured` + `capturedDidChangeNotification`。
+
+**HarmonyOS**
+
+- 窗口截图：`window.snapshot`。
+- 节点截图：鸿蒙不支持按节点查找，见下方注意事项。
+- 系统截屏监测：`window.on('screenshot')`，随后即时截取当前窗口。
+- 防截屏：`setWindowPrivacyMode`，需 `ohos.permission.PRIVACY_WINDOW`。
+- 录屏 / 投屏：`display.on('captureStatusChange')` / `display.isCaptured`。
+
+**Web**
+
+- 节点截图尽量转发元素 `takeSnapshot`。
+- 窗口截图、防截屏、系统截屏监测不可用。
+
+**微信小程序**
+
+- 监听转发 `wx.onUserCaptureScreen`，不回传图片。
+- 防截屏转发 `wx.setVisualEffectOnCapture`。
+- 主动截图不可用。
+
+### 注意事项
+
+使用前请打自定义基座。Android 无论本机系统都要打基座；iOS 在配好原生环境时可免打基座。修改 `config.json` / 权限后需重新打基座。
+
+大尺寸截图占用内存较高，反馈上传后可自行删除缓存文件。
+
+**鸿蒙 `xTakeElementSnapshot`（建议不使用）**：uni-app-x 鸿蒙不支持按节点查找（Vue `id` 落不到 ArkUI `.id()`）。插件会回退为窗口局部截图（按节点矩形裁剪 `window.snapshot`），不是真正的节点绘制。结果会带上叠在该区域上的其它内容，也不会去掉节点自身背景。需要节点截图请用 Android / iOS；鸿蒙请改用 `xTakeSnapshot` 截整窗。
+
+### 版本
+
+版权归 https://xui.tmui.design 你不得修改及二次开发，仅供 TMUI4 会员商用使用。不得转给非 VIP 会员使用，一经查实数倍赔偿，并追究法律责任。
+
+## 更新日志
+
+### 2.0.1（2026-08-20）
+* 修复鸿蒙节点截图 `1001`：不再用全局 `componentSnapshot.get`。改为当前页 `UIContext.getComponentSnapshot()`，找不到 ArkUI id 时按节点矩形裁剪 `window.snapshot`。
+
+### 2.0.0（2026-08-20）
+* **破坏性变更**：改为 DCloud 风格 `x` 前缀 API。`getRootShotImage` / `getElementShotImage` 分别更名为 `xTakeSnapshot` / `xTakeElementSnapshot`。
+* 新增系统截屏监测 `xOnUserCaptureScreen` / `xOffUserCaptureScreen`：检测到用户截屏后即时截取当前窗口并回传路径，方便反馈上传。
+* 新增防截屏 `xSetUserCaptureScreen` / `xGetUserCaptureScreen` / `xIsCaptureScreenEnabled`。
+* 新增录屏 / 投屏检测 `xOnScreenCapturedChange` / `xOffScreenCapturedChange` / `xIsScreenCaptured`。
+* 截图结果增加 `width` / `height`，JPG 支持 `quality`。
+* 鸿蒙去掉缺失的 HAR 依赖，改为 ETS 实现窗口 / 节点截图与隐私模式。
+* 对齐 Android / iOS / HarmonyOS / Web / 微信导出。
+
+### 1.0.5（2026-05-21）
+* 修复 Android 节点 PNG 透明背景被合成白底：png 仅绘制目标 View，不再使用 PixelCopy/根节点裁剪（jpg 仍保留屏幕合成以呈现父级背景）。
+* 进一步：PNG 节点截图绘制时临时清除目标节点自身 background（uni 容器常自带白底），绘制完即时恢复；子节点 background 不受影响。
+
+### 1.0.4（2026-05-21）
+* 修复 PNG 截图白底：iOS 设置 `opaque=false`（jpg 仍为不透明）；节点/窗口均使用 `drawHierarchy(in:bounds)`，避免 `window` 坐标截取导致黑图。
+* Android Canvas 回退路径从根 View 裁剪绘制，保留父级背景色。
+
+### 1.0.3（2026-05-21）
+* 新增 `format` 参数，支持 `png`、`jpg` 保存格式，**默认 png**。
+* 修复节点内含视频/TextureView 等组件时截图黑屏（Android）：优先 `PixelCopy` 窗口拷贝，失败时回退 Canvas 并叠加 TextureView 画面；iOS 保持 `drawHierarchy(afterScreenUpdates:true)` 以保障常规页面截图正常。
+* 新增错误码 `1007`：`format` 参数非法。
+
+### 1.0.2（2026-05-21）
+* **破坏性变更**：API 改为 uni 标准 opts 回调风格
+* 已使用的项目升级前请阅读 readme 示例，不可直接替换旧版回调写法。
+
+### 1.0.1（2025-07-27）
+* 兼容鸿蒙
+### 1.0.0（2024-12-18）
+* 对屏幕截图保存(不需要权限),对指定截图进行保存,安卓,ios支持,web不支持.

package/data/tmui4x/10./346/217/222/344/273/266/345/272/223/xScreentgreyS /345/272/224/347/224/250/347/275/256/347/201/260.md"

@@ -0,0 +1,128 @@
+# x-screentgrey-s 应用置灰
+
+哀悼日等场景把界面置灰。标准 `-s` API 插件，对齐 DCloud `success / fail / complete`。
+
+整 App 与当前页是两套函数：
+
+- `setAppGrey` / `removeAppGrey`：作用在窗口根层，翻到其它页也保持灰色（微信除外）。
+- `setPageGrey` / `removePageGrey`：只灰当前页，其它页不受影响。
+
+旧写法 `setWindowGrey` / `removeWindowGrey` 已移除，请改用上面两套函数。
+
+### 兼容性
+
+| 能力 | Android | iOS | HarmonyOS | WEB | 微信小程序 |
+| --- | --- | --- | --- | --- | --- |
+| 整 App 置灰 | 支持（Activity 根视图 ColorMatrix） | 支持（窗口饱和度叠加层，iOS 13+） | 支持（`setWindowGrayScale`） | 支持（`documentElement` filter） | 仅当前页，需传 `ele`，翻页不保持 |
+| 当前页置灰 | 支持（页面根 View） | 支持（当前页 UIView 叠加层） | 支持（节点 grayscale，否则当前页作用域窗口灰阶） | 支持（当前页 HTML 节点） | 支持，需传 `ele` |
+| amount 0–1 | 支持 | 不支持，大于 0 即全灰 | 支持 | 支持 | 支持 |
+
+Android / iOS 请打自定义基座。iOS 在 Mac 本机编译可不打包；Windows 开发 iOS 需要打包基座。
+
+### 调用
+
+```ts
+import {
+  setAppGrey,
+  removeAppGrey,
+  setPageGrey,
+  removePageGrey,
+  getScreenGreyState,
+  getScreenGreyCapabilities,
+  XScreenGreyOptions,
+  XScreenGreyFailInfo,
+  XScreenGreyResult
+} from "@/uni_modules/x-screentgrey-s"
+
+const caps = getScreenGreyCapabilities()
+
+setAppGrey({
+  success: (res : XScreenGreyResult) => {
+    console.log(res.appGrey)
+  },
+  fail: (err : XScreenGreyFailInfo) => {
+    console.log(err.errCode, err.errMsg)
+  }
+} as XScreenGreyOptions)
+
+setPageGrey({
+  ele: pageRoot, // 微信必传；其它端可省略，自动取当前页根节点
+  amount: 1
+} as XScreenGreyOptions)
+
+removePageGrey({} as XScreenGreyOptions)
+removeAppGrey({} as XScreenGreyOptions)
+```
+
+### 方法
+
+| 名称 | 说明 |
+| --- | --- |
+| setAppGrey | 整 App 置灰。建议在启动页或需要全站哀悼时调用一次 |
+| removeAppGrey | 取消整 App 置灰 |
+| setPageGrey | 仅当前页置灰 |
+| removePageGrey | 取消当前页置灰 |
+| getScreenGreyState | 查询当前开关状态 |
+| getScreenGreyCapabilities | 同步返回平台能力 |
+
+### 参数
+
+`XScreenGreyOptions`
+
+| 字段 | 说明 | 默认 |
+| --- | --- | --- |
+| ele | 目标节点。单页置灰可不传；微信整 App / 单页都建议传当前页根节点 | - |
+| amount | 灰度 0–1。iOS 只能全灰或关闭 | 1 |
+| success | 成功，带 `appGrey` / `pageGrey` | - |
+| fail | 失败 | - |
+| complete | 结束，成功带结果，失败为 null | - |
+
+错误码：`1001` 系统错误，`1002` 参数错误，`1003` 找不到目标节点，`1008` 当前平台不支持。
+
+### 平台差异
+
+**Android**
+
+- 整 App：对当前 Activity `decorView` 以及栈内每个页面的 `getAndroidView()` 做 `ColorMatrix.setSaturation(1 - amount)` + `LAYER_TYPE_HARDWARE`。新页面往往自带硬件层，不会继承窗口根滤镜，因此会拦截路由并在 Activity `onResume` 时重新套上。
+- 当前页：对 `UniPage.getAndroidView()` 或传入节点的原生 View 做同样处理；取消单页置灰时若整 App 仍开着，该页保持 App 灰色。
+- 取消时恢复 `LAYER_TYPE_NONE`。
+
+**iOS**（deploymentTarget 12，置灰需 iOS 13+）
+
+- 使用 `saturationBlendMode` 浅灰叠加层，不拦截触摸。
+- 整 App 加在 keyWindow 上，翻页仍盖住新页面。
+- 当前页加在当前页根 UIView 上。
+- `amount` 不生效，大于 0 即全灰。低于 iOS 13 返回 1008。
+
+**HarmonyOS**
+
+- 整 App：`Window.setWindowGrayScale(amount)`，窗口级，翻页保持。
+- 当前页：鸿蒙 ucss 不支持 CSS `filter`，写 `filter: grayscale()` 不会生效。实现上会尽量给页面节点加 ArkUI `grayscale`，并以当前页作用域的 `setWindowGrayScale` 保证看得见；跳转离开时恢复彩色，返回该页时再置灰。`redirectTo` / `reLaunch` 或返回后页面已销毁则清除单页状态。
+
+**Web**
+
+- 整 App：`document.documentElement` 的 CSS `filter`。
+- 当前页：当前页 HTML 根节点的 CSS `filter`。
+
+**微信小程序**
+
+- 没有窗口级滤镜。`setAppGrey` 与 `setPageGrey` 都作用在传入的 `ele` 上。
+- `appGreyPersist` 为 false：新开页面不会自动变灰，需要在该页再调一次。
+
+### 版本
+
+版权归 https://xui.tmui.design 你不得修改及二次开发，仅供 TMUI4 会员商用使用。不得转给非 VIP 会员使用，一经查实数倍赔偿，并追究法律责任。
+
+## 更新日志
+
+### 1.1.2（2026-08-20）
+* 修复 Android 整 App 置灰只作用于当前页：翻页后新页不再继承 `decorView` 硬件层滤镜。现会记住灰度并在每个页面 View、新 Activity 恢复时重新套上。
+### 1.1.1（2026-08-20）
+* 修复 HarmonyOS 当前页置灰无效：鸿蒙 ucss 不支持 CSS filter，改为节点 grayscale；找不到节点时用当前页作用域的窗口灰阶，跳转时恢复彩色。
+### 1.1.0（2026-08-20）
+* 改为 DCloud 风格 options + success/fail/complete，五端 API 对齐。
+* 拆成整 App 置灰 `setAppGrey` 与当前页置灰 `setPageGrey` 两套函数。
+* 补齐 HarmonyOS 窗口灰阶、Web / 微信滤镜，以及状态与能力查询。
+* 旧 API `setWindowGrey` / `removeWindowGrey` 已移除。
+### 1.0.0（2024-08-31）
+首次发布

package/data/tmui4x/10./346/217/222/344/273/266/345/272/223/xSendsmsS /345/217/221/351/200/201/347/237/255/344/277/241.md"

@@ -0,0 +1,84 @@
+# x-sendsms-s 发送短信
+
+拉起系统短信编辑界面，预填手机号和内容。参数与回调对齐微信 `wx.sendSms` 和 DCloud `success / fail / complete`。对外方法名为 `xSendSms`，类型统一加 `X` 前缀，避免和系统或微信同名冲突。
+
+成功只表示已经打开短信面板，不代表用户一定发送成功。不会在后台静默发短信。
+
+### 兼容性
+
+| Harmony | iOS | Android | WEB | 微信小程序 |
+| --- | --- | --- | --- | --- |
+| 支持 | 支持 | 支持 | 移动端浏览器 | 支持 |
+
+### 调用
+
+```ts
+import { xSendSms, XSendSmsOptions } from "@/uni_modules/x-sendsms-s"
+
+xSendSms({
+  phoneNumber: "10086",
+  content: "查询话费",
+  success: (res) => {
+    console.log(res.errMsg)
+  },
+  fail: (err) => {
+    console.log(err.errCode, err.errMsg)
+  }
+} as XSendSmsOptions)
+```
+
+多个号码用英文逗号分隔：
+
+```ts
+xSendSms({
+  phoneNumber: "10086,10010",
+  content: "你好"
+} as XSendSmsOptions)
+```
+
+### 方法
+
+| 名称 | 说明 |
+| --- | --- |
+| xSendSms | 拉起系统短信编辑界面 |
+
+### 参数
+
+`XSendSmsOptions`
+
+| 字段 | 说明 | 默认 |
+| --- | --- | --- |
+| phoneNumber | 预填手机号，多个用英文逗号分隔 | 空 |
+| content | 预填短信内容 | 空 |
+| success | 成功，`errMsg` 为 `xSendSms:ok` | - |
+| fail | 失败 | - |
+| complete | 结束 | - |
+
+`phoneNumber` 和 `content` 都可空，空值时打开空白短信面板。
+
+### 错误码
+
+| 码 | 含义 |
+| --- | --- |
+| 1001 | 系统错误，或正在拉起短信界面 |
+| 1002 | 参数错误 |
+| 1003 | 当前设备不支持发送短信 |
+| 1008 | 当前平台不支持此功能 |
+
+### 平台差异
+
+1. 微信走官方 `wx.sendSms`，基础库 2.25.0+。
+2. Android 使用 `ACTION_SENDTO` + `smsto:`，不申请 `SEND_SMS`。
+3. iOS 使用系统 `MFMessageComposeViewController`，模拟器通常会返回 1003。
+4. HarmonyOS 通过 `sms:` 协议 `startAbility` 拉起系统短信应用。
+5. Web 仅在移动端浏览器用 `sms:` 链接；桌面端返回 1003。
+
+### 版本
+
+版权归 https://xui.tmui.design 你不得修改及二次开发，仅供 TMUI4 会员商用使用。不得转给非 VIP 会员使用，一经查实数倍赔偿，并追究法律责任。
+
+## 更新日志
+
+### 1.0.0（2026-08-16）
+
+- 新增 `xSendSms`，支持 Android / iOS / HarmonyOS / Web / 微信小程序拉起系统短信面板