tmui-cli 2.0.0 → 2.0.2

package/data/tmui4x/10./346/217/222/344/273/266/345/272/223/xMoreshareS /346/233/264/345/244/232/345/210/206/344/272/253/351/235/242/346/235/277.md"

@@ -0,0 +1,155 @@
+# x-moreshare-s 更多分享面板
+
+从底部弹出的「更多 / 分享」面板，视觉对齐头条菜单更多：可选标题 + 宫格（图标或图片）+ cell 列表 + 取消。宫格支持单行横滑或自动断行；两区都可空，有才显示。
+
+详细规划见同目录 [PLAN.md](./PLAN.md)。
+
+**微信内使用官方 `uni.showActionSheet` 降级，图标、图片、横滑、断行不生效，仅保留标题和文案。**
+
+### 兼容性
+
+| Harmony | IOS | Android | WEB | 小程序 |
+| --- | --- | --- | --- | --- |
+| 支持 | 支持 | 支持 | 支持 | 支持（官方菜单降级） |
+
+### 调用
+
+```ts
+import { showMoreShare, hideMoreShare, XMoreShareOptions, XMoreShareGridItem, XMoreShareCellItem } from "@/uni_modules/x-moreshare-s"
+
+showMoreShare({
+  title: "分享到",
+  grids: [
+    { id: "wechat", title: "微信", icon: "F2B6" } as XMoreShareGridItem,
+    { id: "copy", title: "复制", icon: "ECD5" } as XMoreShareGridItem
+  ] as XMoreShareGridItem[],
+  cells: [
+    { id: "link", title: "复制链接", icon: "EEB8" } as XMoreShareCellItem,
+    { id: "report", title: "举报", icon: "ED3B" } as XMoreShareCellItem
+  ] as XMoreShareCellItem[],
+  gridClick: (index : number, item : XMoreShareGridItem) => {
+    console.log("宫格", index, item.title)
+  },
+  cellClick: (index : number, item : XMoreShareCellItem) => {
+    console.log("列表", index, item.title)
+  },
+  cancel: () => {
+    console.log("取消")
+  },
+  close: () => {
+    console.log("已关闭")
+  }
+} as XMoreShareOptions)
+```
+
+主动关闭：
+
+```ts
+hideMoreShare()
+```
+
+### 参数
+
+`XMoreShareGridItem`
+
+| 字段 | 说明 | 默认 |
+| --- | --- | --- |
+| id | 条目标识 | `g` + 索引 |
+| title | 下方标题 | `""` |
+| image | 图片地址，有则优先于 icon | `""` |
+| icon | Remix unicode，如 `F2B6` | `""` |
+| iconBgColor | 圆角矩形背景 | `#F5F5F5` |
+| iconColor | 图标色 | `#333333` |
+| iconSize | 图标字号 px | `24` |
+| iconBoxSize | 方块边长 px | `52` |
+| iconBoxRound | 方块圆角 px | `12` |
+| titleColor | 标题色 | `#666666` |
+| titleSize | 标题字号 px | `11` |
+| disabled | 禁用 | `false` |
+
+`XMoreShareCellItem`
+
+| 字段 | 说明 | 默认 |
+| --- | --- | --- |
+| id | 条目标识 | `c` + 索引 |
+| title | 文案 | 必填语义 |
+| icon | Remix，无框 | `""` |
+| iconColor | 图标色 | `#333333` |
+| iconSize | 图标字号 px | `18` |
+| titleColor | 文案色 | `#111111` |
+| titleSize | 文案字号 px | `16` |
+| showArrow | 右箭头 | `true` |
+| disabled | 禁用 | `false` |
+
+`XMoreShareOptions`
+
+| 字段 | 说明 | 默认 |
+| --- | --- | --- |
+| title | 顶栏标题，空则不显示 | `""` |
+| showTitle | 是否显示标题（标题为空时仍不显示） | `true` |
+| grids | 宫格数组 | `[]` |
+| gridMode | `scroll` 横滑 / `wrap` 断行 | `scroll` |
+| cells | 列表数组 | `[]` |
+| showCancel | 是否显示取消 | `true` |
+| cancelText | 取消文字 | `取消` |
+| cancelColor | 取消文字色 | `#333333` |
+| overlayClick | 点击遮罩关闭 | `true` |
+| itemClickClose | 点击条目后关闭 | `true` |
+| space | 非通栏时面板相对屏幕左右留白；`false` 为通栏贴边。中间内容区（宫格 + cell）左右 10px，标题和取消通栏；标题到内容、取消到内容各 10px。宫格区域块与 cell 列表块 12px 圆角 | `true` |
+| round | 圆角 px | `16` |
+| maxHeight | 内容最大高度 px，0 为屏高 80% | `0` |
+| maskBgColor | 遮罩色 | `rgba(0,0,0,0.35)` |
+| contentBgColor | 面板间隙色 | `#f5f5f5` |
+| cellBgColor | 条目底色 | `#ffffff` |
+| titleColor | 标题色 | `#888888` |
+| arrowColor | 右箭头色 | `#C8C8C8` |
+| duration | 动画 ms | `350` |
+| gridClick | 点击宫格 | - |
+| cellClick | 点击列表 | - |
+| cancel | 取消 / 遮罩 / 手势返回 | - |
+| close | 关闭完成 | - |
+| success | 点了宫格或 cell，含 `type/index/id/title` | - |
+| fail | 取消或失败 | - |
+| complete | 结束（成功或失败都会走） | - |
+
+### 平台差异
+
+1. 微信小程序：`uni.showActionSheet`，最多 6 条，宫格标题在前、cell 标题在后；图标、图片、横滑、断行、内容区内间距不生效。`hideMoreShare` 为空实现。
+2. 关闭箭头与宫格图标使用插件内独立字体 `x-moreshare-remixicon.ttf`。Web 字体族名为 `x-moreshare-remixicon`，文件走全局 `/static/tmui4xLibs/static/remixicon.ttf`。
+
+### 版本
+
+版权归https://xui.tmui.design你不得修改及二次开发，仅供TMUI4会员商用使用。不得转给非VIP会员使用，一经查实数倍赔偿，并追究法律责任。
+
+## 更新日志
+
+### 1.0.9（2026-08-17）
+* iOS 宫格去掉多余顶距并按字体行高算高度，恢复底部 10px 内边距；cell 标题改回靠左跟图标对齐。
+
+### 1.0.8（2026-08-17）
+* 安卓单行宫格按文字实际行高撑开，避免标题底部被裁几个像素。
+
+### 1.0.7（2026-08-17）
+* wrap 宫格高度按实际行高收紧，避免标题/取消与内容之间被撑出大空隙。
+
+### 1.0.6（2026-08-17）
+* 原生单行宫格左对齐；wrap 按容器比例分列铺满，避免右边空一大块。
+
+### 1.0.5（2026-08-17）
+* Web 单行宫格改为横向滚动且不收缩挤叠，并隐藏滚动条。
+
+### 1.0.4（2026-08-17）
+* 标题/取消到内容的间距与内容左右 10px 对齐；wrap 按可用宽度等分列，避免 3 个就断行和高度虚高。
+
+### 1.0.3（2026-08-17）
+* 宫格区域块四角圆角；cell 列表作为一组，上左右 / 下左右圆角。
+
+### 1.0.2（2026-08-17）
+* 只有中间内容区（宫格 + cell）左右缩 10px，标题和取消仍通栏；标题到内容、取消到内容各 10px。
+
+### 1.0.1（2026-08-17）
+* 宫格 wrap 断行增加 8px 行距。微信官方菜单无法改布局。
+
+### 1.0.0（2026-08-17）
+* 新增 x-moreshare-s：头条风格底部更多面板，可选标题 + 宫格（横滑/断行）+ cell 列表 + 取消。
+* App 三端使用独立字体 `x-moreshare-remixicon.ttf`；微信官方 ActionSheet 降级。

package/data/tmui4x/10./346/217/222/344/273/266/345/272/223/xMqttS MQTT/346/266/210/346/201/257.md"

@@ -0,0 +1,129 @@
+# x-mqtt-s MQTT消息
+
+进程级单连接 MQTT。`new xMqtt()` 只是门面，全局只保持一条活连接；再次 `create` 会断开旧连接，**监听保留**。
+
+**微信仅 WSS，且必须是 WebSocket 网关。** Web / 微信不支持自定义证书，`applyTls` 为空实现。
+
+### 兼容性
+
+| Harmony | IOS | Android | WEB | 小程序 |
+| --- | --- | --- | --- | --- |
+| 支持 | 支持 | 支持 | 支持 | 支持 |
+
+### 调用
+
+```ts
+import { xMqtt, MQTT_SUBSCRIBE, MQTT_PUBLISH_TOPIC, MQTT_CONNECT_OPTS } from "@/uni_modules/x-mqtt-s"
+
+const mqtt = new xMqtt()
+
+mqtt.addEventListener("message", (_type, topic, str) => {
+  console.log(topic, str)
+})
+
+mqtt.create({
+  protocol: "wss",
+  path: "/mqtt",
+  clientId: "tmui4x-" + Date.now(),
+  server: "broker.emqx.io",
+  port: 8084,
+  useSSL: true,
+  keepAliveInterval: 60,
+  timeout: 30,
+  reconnect: true,
+  clean: true,
+  rejectUnauthorized: true
+} as MQTT_CONNECT_OPTS)
+
+mqtt.connect()
+mqtt.subscribe([{ topic: "xui/hi", qos: 1 }] as MQTT_SUBSCRIBE[])
+mqtt.publish({
+  topic: "xui/hi",
+  qos: 0,
+  message: "hello",
+  retained: false
+} as MQTT_PUBLISH_TOPIC, (_ok) => {})
+```
+
+### 方法
+
+| 名称 | 参数 | 说明 |
+| --- | --- | --- |
+| create | `MQTT_CONNECT_OPTS` | 配置并替换当前连接，不自动 connect |
+| connect | 无 | 连接服务器 |
+| subscribe | `[{ topic, qos }]` | 订阅；未连上会在连上后补订 |
+| unsubscribe | `topics: string[]` | 取消订阅 |
+| publish | `{ topic, message, qos, retained }` + `(isSuccess) => void` | 推送 |
+| disconnect | 无 | 断开，保留监听 |
+| destroy | 无 | 断开并清空监听 |
+| addEventListener | `open` / `disconnect` / `dissconnect` / `error` / `message` | 返回监听 id |
+| removeEventListener | `id` | 按 id 移除 |
+| getState | 无 | `wait` / `opening` / `open` / `dissconnect` / `error` |
+| applyTls | `MQTT_TLS_OPTS` | 写入证书配置，下次 create 生效。Web / 微信空实现 |
+
+`dissconnect` 与 `disconnect` 等价，旧监听名继续可用。
+
+### 证书
+
+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`。`allowUntrustCACertificate: true` 仍兼容，等价于关闭校验 |
+| serverName | SNI，默认 `server` |
+
+仓库自带示例 `ca.crt`（公共根 CA）。私有 CA / mTLS 请替换同名文件后重新出包。Web / 微信走系统信任链，自定义证书无效。
+
+### 协议
+
+- Android / iOS / Harmony：`ws`、`wss`；Android / iOS 额外支持 `tcp`、`ssl`
+- Web：`ws`、`wss`
+- 微信：仅 `wss`
+
+### 错误码
+
+| 码 | 含义 |
+| --- | --- |
+| 1001 | 系统错误 |
+| 1002 | 参数错误 |
+| 1005 | 连接超时 |
+| 1008 | 当前平台不支持此协议或证书 |
+| 1010 | 尚未 create |
+| 1011 | 证书加载失败 |
+| 1012 | 证书校验失败 |
+
+`error` 事件的 `str` 为 `errCode:errMsg`。
+
+### 版本
+
+版权归 https://xui.tmui.design 你不得修改及二次开发，仅供 TMUI4 会员商用使用。不得转给非 VIP 会员使用，一经查实数倍赔偿，并追究法律责任。
+
+## 更新日志
+
+### 1.1.1（2026-08-16）
+* 鸿蒙 type 字段 retained 改为可选，避免 @default 被编译成带初始值的确定赋值
+### 1.1.0（2026-08-16）
+* 改为进程级单连接：再次 create 自动断开旧实例，监听保留
+* 新增 destroy / getState / applyTls；证书从各端资源目录加载
+* 鸿蒙去掉 HAR，改为原生 WebSocket + MQTT 3.1.1
+* 统一 clean / will / timeout / retained，并修复微信二次连接与取消监听
+### 1.0.4（2026-04-07）
+* 修复ios连接wss失败的问题
+### 1.0.3（2025-08-17）
+* 兼容 原生鸿蒙 Next
+### 1.0.2（2025-02-13）
+* 兼容微信
+### 1.0.1（2024-09-13）
+* ios补充取消订阅的方法。
+### 1.0.0（2024-09-05）
+首次发布

package/data/tmui4x/10./346/217/222/344/273/266/345/272/223/xMusicnotifyS /351/200/232/347/237/245/346/240/217/351/237/263/344/271/220/346/222/255/346/224/276/345/231/250.md"

@@ -0,0 +1,128 @@
+# x-musicnotify-s 通知栏音乐播放器
+
+系统媒体控件。把正在播放的封面、标题、副标题和时间线同步到通知栏、锁屏、控制中心或鸿蒙播控中心，并回传播放、暂停、停止、上一首、下一首、拖进度。
+
+本插件**不解码音频**。真正播放请用业务播放器或 `x-mediaplay-s`，再把进度喂给本插件。
+
+### 兼容性
+
+| Harmony | iOS | Android | WEB | 微信小程序 |
+| --- | --- | --- | --- | --- |
+| 支持 | 支持 | 支持 | 部分支持 | 部分支持 |
+
+### 调用
+
+```ts
+import {
+  show,
+  update,
+  setProgress,
+  setPlaying,
+  hide,
+  onAction,
+  offAction,
+  getState,
+  XMusicNotifyShowOptions
+} from "@/uni_modules/x-musicnotify-s"
+
+onAction((res) => {
+  if (res.action == "pause") {
+    setPlaying({ playing: false })
+  }
+})
+
+show({
+  title: "晴天",
+  subtitle: "周杰伦",
+  album: "叶惠美",
+  cover: "/static/x-musicnotify/default-cover.png",
+  durationMs: 269000,
+  positionMs: 0,
+  playing: true,
+  success: (res) => {
+    console.log(res.errMsg)
+  }
+} as XMusicNotifyShowOptions)
+```
+
+### 方法
+
+| 名称 | 说明 |
+| --- | --- |
+| show | 展示或重建媒体通知，`title` 必填 |
+| update | 更新标题、副标题、专辑、封面、时长、进度、倍速、强调色 |
+| setProgress | 只更新时间线，适合跟播放器 `onInfo` |
+| setPlaying | 只切换播放/暂停外观 |
+| hide | 关闭通知并释放系统会话 |
+| onAction | 监听系统控件操作，后注册覆盖前一次 |
+| offAction | 取消监听 |
+| getState | 当前展示快照 |
+| isShowing | 通知是否仍在 |
+
+### 参数
+
+`XMusicNotifyShowOptions`
+
+| 字段 | 说明 | 默认 |
+| --- | --- | --- |
+| title | 歌名 | 必填 |
+| subtitle | 歌手 | 空 |
+| album | 专辑 | 空 |
+| cover | 本地绝对路径 / `file://` / `http(s)` / `/static` | 内置默认封面 |
+| durationMs | 总时长 ms，大于 0 才画时间线 | 0 |
+| positionMs | 当前进度 ms | 0 |
+| playing | 是否显示为播放中 | true |
+| speed | 倍速 | 1 |
+| showPrev / showNext / showStop | 按钮显隐 | true |
+| canSeek | 是否允许拖时间线 | true |
+| color | 强调色 `#RRGGBB`，主要影响 Android | `#31C27C` |
+
+`XMusicNotifyAction.action`：`play` / `pause` / `stop` / `prev` / `next` / `seek` / `close` / `click`。`seek` 时 `positionMs` 为目标进度。
+
+错误码：`1001` 系统错误，`1002` 参数错误，`1003` 通知服务不可用，`1004` 通知权限被拒绝，`1007` 当前环境无法显示控件，`1008` 平台不支持，`1009` 尚未 show。
+
+### 平台差异
+
+**Android**
+
+- `MediaSessionCompat` + `NotificationCompat.MediaStyle` + `mediaPlayback` 前台服务。
+- Android 13+ 需运行时授予 `POST_NOTIFICATIONS`，插件会先申请再展示。
+- Android 13+ 系统媒体通知的进度条来自 session 的 duration / position，不必自己画 RemoteViews。
+- 修改 `config.json` 后需重新打自定义基座。
+
+**iOS**
+
+- `MPNowPlayingInfoCenter` + `MPRemoteCommandCenter`。
+- 插件会把 `AVAudioSession` 设为 `playback`。锁屏控件在有真实音频在播时最稳定，建议同时用 `x-mediaplay-s`。
+- 宿主需允许后台音频：插件已声明 `UIBackgroundModes: audio`。
+
+**HarmonyOS**
+
+- `AVSession`，类型 `audio`。至少注册一条控制命令后播控中心才会出现。
+- 进度按官方建议节流，后台播放保活仍取决于你的播放器长时任务。
+- 宿主 `entry/module.json5` 建议声明 `backgroundModes: ["audio"]`。
+
+**Web**
+
+- `navigator.mediaSession`。Chrome 等通常要页面里有真实媒体在播，通知栏才会出现。
+- Safari 支持有限，不支持时 `fail` 1008。
+
+**微信小程序**
+
+- 只更新 `BackgroundAudioManager` 的 title / singer / coverImgUrl / epname，并转发 onPlay / onPause / onStop / onPrev / onNext。
+- 封面建议用 `https`。没有后台音频在播时，系统通知栏可能不出现。
+
+### 资源
+
+插件内置默认封面（黑胶 + 音符，QQ 绿强调）和播放 / 暂停 / 停止 / 上一首 / 下一首 / 关闭矢量图标。
+
+- 演示页封面：`/static/x-musicnotify/default-cover.png`
+- 原生回退封面：Android `assets/x_musicnotify_cover.png`、iOS `Resources/x_musicnotify_cover.png`、鸿蒙 `rawfile/x_musicnotify_cover.png`
+
+业务封面传 `cover` 即可覆盖。HTTP 封面建议用 `https`。
+
+## 更新日志
+
+### 1.0.0（2026-08-17）
+* 新增通知栏音乐播放器 API 插件：封面、标题、副标题、时间线、播放/暂停/停止/上一首/下一首。
+* Android MediaSession + MediaStyle 前台服务；iOS Now Playing；鸿蒙 AVSession；Web Media Session；微信后台音频元数据。

package/data/tmui4x/10./346/217/222/344/273/266/345/272/223/xNetworkstatusS /347/275/221/347/273/234/347/212/266/346/200/201.md"

@@ -0,0 +1,114 @@
+# x-networkstatus-s 网络状态
+
+网络类型、弱网变化、局域网 IP。函数与类型均加 `x` 前缀，避免与官方同名冲突。一次性 API 使用 DCloud `success / fail / complete`。
+
+### 兼容性
+
+| Harmony | iOS | Android | WEB | 微信小程序 |
+| --- | --- | --- | --- | --- |
+| 支持 | 支持 | 支持 | 部分支持 | 支持 |
+
+Web 端 `xGetLocalIPAddress` 因浏览器限制返回 `fail 1008`。弱网在 App / Web 为近似判断，微信端走官方弱网能力。
+
+### 调用
+
+```ts
+import {
+  xGetNetworkType,
+  xGetLocalIPAddress,
+  xOnNetworkStatusChange,
+  xOffNetworkStatusChange,
+  xOnNetworkWeakChange,
+  xOffNetworkWeakChange,
+  XGetNetworkTypeOptions,
+  XGetLocalIPAddressOptions
+} from "@/uni_modules/x-networkstatus-s"
+
+xGetNetworkType({
+  success: (res) => {
+    console.log(res.networkType, res.weakNet, res.signalStrength)
+  }
+} as XGetNetworkTypeOptions)
+
+xGetLocalIPAddress({
+  success: (res) => {
+    console.log(res.localip, res.netmask)
+  }
+} as XGetLocalIPAddressOptions)
+
+const statusId = xOnNetworkStatusChange((res) => {
+  console.log(res.isConnected, res.networkType)
+})
+const weakId = xOnNetworkWeakChange((res) => {
+  console.log(res.weakNet, res.networkType)
+})
+
+xOffNetworkStatusChange(statusId)
+xOffNetworkWeakChange(weakId)
+```
+
+### 方法
+
+| 名称 | 说明 |
+| --- | --- |
+| xGetNetworkType | 获取当前网络类型与弱网/代理信息 |
+| xGetLocalIPAddress | 获取局域网 IP 与子网掩码 |
+| xOnNetworkStatusChange | 监听联网状态与类型变化，返回监听 id |
+| xOffNetworkStatusChange | 移除状态监听；不传 id 则移除本插件全部状态监听 |
+| xOnNetworkWeakChange | 监听弱网变化，返回监听 id |
+| xOffNetworkWeakChange | 移除弱网监听；不传 id 则移除本插件全部弱网监听 |
+
+### 网络类型
+
+`wifi` / `2g` / `3g` / `4g` / `5g` / `unknown` / `none`
+
+`XGetNetworkTypeResult` 固定包含 `signalStrength`（dbm，未知为 0）、`hasSystemProxy`、`weakNet`。
+
+错误码：`1001` 系统错误，`1002` 参数错误，`1003` 无法获取局域网 IP，`1008` 当前平台不支持。
+
+### 平台差异
+
+**Android**
+
+- `ConnectivityManager` + `NetworkCallback`。
+- 蜂窝制式优先 `TelephonyManager`，失败时按下行带宽近似。
+- 局域网 IP 走 `NetworkInterface`，优先 Wi-Fi。
+- 需 `ACCESS_NETWORK_STATE`、`ACCESS_WIFI_STATE`。
+
+**iOS**
+
+- `NWPathMonitor` 监听路径；蜂窝制式走 `CTTelephonyNetworkInfo`。
+- 弱网：`isConstrained` 或 `2g`。
+- 局域网 IP 走 `getifaddrs`，优先 `en0`。
+
+**HarmonyOS**
+
+- `@kit.NetworkKit` 的 `createNetConnection` + `getNetCapabilities`。
+- 蜂窝制式走 `@kit.TelephonyKit` 的 `radio.getSignalInformation`。
+- Wi-Fi IP 走 `wifiManager.getIpInfo`，失败再读连接属性。
+- 需 `ohos.permission.GET_NETWORK_INFO`、`ohos.permission.GET_WIFI_INFO`。宿主 `entry/module.json5` 也应声明。
+
+**Web**
+
+- 在线状态走 `navigator.onLine` 与 `window` 的 `online` / `offline`。
+- 网络类型走 `navigator.connection`（含 `mozConnection` / `webkitConnection`）：优先 `type`（`wifi` / `ethernet` / `cellular`），蜂窝再映射 `effectiveType`。
+- Safari 等未实现 Network Information API 的浏览器：在线为 `unknown`，离线为 `none`；状态变化仍可监听。
+- `effectiveType` 表示估算速率，Wi-Fi 上也可能是 `4g`。
+- 不支持读取局域网 IP（`fail 1008`）。
+
+**微信小程序**
+
+- 直接转发 `wx.getNetworkType`、`wx.getLocalIPAddress`、`wx.onNetworkStatusChange`、`wx.offNetworkStatusChange`、`wx.onNetworkWeakChange`、`wx.offNetworkWeakChange`。
+
+### 版本
+
+版权归 https://xui.tmui.design 你不得修改及二次开发，仅供 TMUI4 会员商用使用。不得转给非 VIP 会员使用，一经查实数倍赔偿，并追究法律责任。
+
+## 更新日志
+
+### 1.0.1（2026-08-17）
+* 修复 Web 端 `navigator.get is not a function`：改为读取 `navigator.connection` 属性，不再把 `navigator` 当 `UTSJSONObject`。
+* 修复 Web 端首次 `online` / `offline` / `connection.change` 被基线逻辑吞掉。
+
+### 1.0.0（2026-08-16）
+* 新增 x-networkstatus-s：xOnNetworkStatusChange、xOffNetworkStatusChange、xOnNetworkWeakChange、xOffNetworkWeakChange、xGetNetworkType、xGetLocalIPAddress。

package/data/tmui4x/10./346/217/222/344/273/266/345/272/223/xNotifyS /346/234/254/345/234/260/351/200/232/347/237/245.md"

@@ -0,0 +1,104 @@
+# x-notify-s 本地通知
+
+弹出本地系统通知。参数与回调对齐 DCloud `success / fail / complete`。对外方法名加 `x` 前缀，避免和系统或微信同名冲突。
+
+这是标准 `-s` API 插件，页面里 `import` 后直接调用。通知以标题为主，**副标题和右侧图都是可选参数**，不传就不会显示。右侧图可以是 `http(s)` 远程地址，也可以是 `/static`、`file://`、绝对路径等本地地址。图片下载或解码失败时，仍会弹出文字通知。
+
+### 兼容性
+
+| Harmony | iOS | Android | WEB | 微信小程序 |
+| --- | --- | --- | --- | --- |
+| 支持 | 支持 | 支持 | 支持 Notification API 的浏览器 | 不支持 |
+
+### 调用
+
+```ts
+import { xShowNotify, XNotifyShowOptions } from "@/uni_modules/x-notify-s"
+
+xShowNotify({
+  title: "订单已发货",
+  subtitle: "您的包裹正在配送中",
+  success: (res) => {
+    console.log(res.notifyId, res.errMsg)
+  },
+  fail: (err) => {
+    console.log(err.errCode, err.errMsg)
+  }
+} as XNotifyShowOptions)
+```
+
+需要右侧图时再传 `image`，不传则只有文字：
+
+```ts
+xShowNotify({
+  title: "订单已发货",
+  subtitle: "您的包裹正在配送中",
+  image: "https://example.com/icon.png"
+} as XNotifyShowOptions)
+```
+
+取消指定通知或全部通知：
+
+```ts
+import { xCancelNotify } from "@/uni_modules/x-notify-s"
+
+xCancelNotify({ notifyId: 1 })
+xCancelNotify(null)
+```
+
+### 方法
+
+| 名称 | 说明 |
+| --- | --- |
+| xShowNotify | 弹出本地系统通知 |
+| xCancelNotify | 取消一条或全部本地通知 |
+| xRequestNotifyPermission | 申请通知权限 |
+| xIsNotifyEnabled | 查询通知是否已授权 |
+
+### 参数
+
+`XNotifyShowOptions`
+
+| 字段 | 说明 | 默认 |
+| --- | --- | --- |
+| title | 标题，必填 | - |
+| subtitle | 副标题，可选 | 空 |
+| image | 右侧图，可选。远程 URL 或本地路径，不传不显示 | 空 |
+| notifyId | 通知编号，不传则自动递增 | 自动 |
+| sound | 是否播放提示音 | true |
+| success | 成功，`errMsg` 为 `xShowNotify:ok` | - |
+| fail | 失败 | - |
+| complete | 结束 | - |
+
+`xShowNotify` 在未授权时会先申请通知权限，授权后再弹出。
+
+### 错误码
+
+| 码 | 含义 |
+| --- | --- |
+| 1001 | 系统错误 |
+| 1002 | 参数错误，例如标题为空 |
+| 1003 | 通知服务未开启 |
+| 1004 | 通知权限被拒绝 |
+| 1008 | 当前平台不支持此功能 |
+
+### 平台差异
+
+1. Android 13+ 动态申请 `POST_NOTIFICATIONS`，右侧图走 `NotificationCompat.setLargeIcon`。
+2. iOS 使用 `UNUserNotificationCenter`，副标题对应 `subtitle`，右侧图为 `UNNotificationAttachment`。前台也会横幅展示。
+3. HarmonyOS 使用 `notificationManager.publish`，右侧图走 `notificationIcon`。
+4. Web 走浏览器 `Notification`，图标字段为 `icon`。
+5. 微信小程序没有本地系统通知，统一返回 1008。
+6. 点击通知会回到当前应用。图片仅支持常见位图（png / jpg / webp / gif），不支持 svg。
+
+### 版本
+
+版权归 https://xui.tmui.design 你不得修改及二次开发，仅供 TMUI4 会员商用使用。不得转给非 VIP 会员使用，一经查实数倍赔偿，并追究法律责任。
+
+## 更新日志
+
+### 1.0.0（2026-08-17）
+
+- 新增本地系统通知：`xShowNotify` / `xCancelNotify` / `xRequestNotifyPermission` / `xIsNotifyEnabled`
+- 支持标题、副标题、右侧图（远程 URL 或本地路径）
+- 覆盖 Android / iOS / HarmonyOS / Web，微信小程序返回不支持