my-uniapp-tools 1.0.6 → 1.0.8

package/README.md

@@ -1,446 +1,446 @@
-# My UniApp Tools
-
-一个专为 UniApp 开发设计的实用工具函数库，提供常用的功能模块，帮助开发者快速构建跨平台应用。
-
-## 📦 安装
-
-```bash
-# 使用 npm
-npm install my-uniapp-tools
-
-# 使用 yarn
-yarn add my-uniapp-tools
-
-# 使用 pnpm
-pnpm add my-uniapp-tools
-```
-
-## 🚀 快速开始
-
-```javascript
-// 导入所有工具函数
-import * as Tools from 'my-uniapp-tools'
-
-// 或者按需导入
-import { 
-  useToast, 
-  useBack, 
-  copyText, 
-  setStorageSync, 
-  getStorageSync, 
-  clearStorageSync,
-  useWindowInfo,
-  getPlatform, 
-  getCurrentEnv, 
-  onCheckForUpdate,
-  getStatusBarHeight,
-  getNavHeight,
-  getTopNavBarHeight
-} from 'my-uniapp-tools'
-```
-
-## 📚 API 文档
-
-### 🎨 UI交互工具 (UI)
-
-#### `useToast(title, mask, icon, duration)`
-
-显示消息提示框
-
-**参数:**
-- `title` (string): 提示的内容，默认为空字符串
-- `mask` (boolean): 是否显示透明蒙层，默认为 `false`
-- `icon` (string): 图标类型，可选值：`'none'` | `'success'` | `'loading'` | `'error'` | `'fail'` | `'exception'`，默认为 `'none'`
-- `duration` (number): 提示的延迟时间，默认为 `2000` 毫秒
-
-**示例:**
-```javascript
-// 基础用法
-useToast('操作成功')
-
-// 完整参数
-useToast(
-  '操作成功',           // 提示文字
-  false,               // 是否显示透明蒙层
-  'success',           // 图标类型
-  2000                 // 显示时长(毫秒)
-)
-```
-
-### 🧭 导航工具 (Navigation)
-
-#### `useBack(params)`
-
-返回上一页并支持传递参数给上一页的 init 方法
-
-**参数:**
-- `params` (any): 传递给上一页 init 方法的参数，默认为空字符串
-
-**示例:**
-```javascript
-// 简单返回
-useBack()
-
-// 返回并传递参数
-useBack({ refresh: true, data: 'some data' })
-```
-
-**注意：** 上一页需要暴露 `init` 方法来接收参数
-
-### 📋 剪贴板工具 (Clipboard)
-
-#### `copyText(text)`
-
-跨平台文本复制功能，支持 H5、App、小程序。H5 平台优先使用现代的 Clipboard API，失败时回退到传统方法。
-
-**参数:**
-- `text` (string): 要复制的文本内容
-
-**示例:**
-```javascript
-copyText('要复制的文本内容')
-```
-
-### 🖥️ 系统信息工具 (System)
-
-#### `useWindowInfo()`
-
-获取当前窗口的尺寸、像素比等信息
-
-**返回值:**
-- 窗口信息对象，包含窗口尺寸、像素比等信息
-
-**示例:**
-```javascript
-const windowInfo = useWindowInfo()
-console.log(windowInfo.windowWidth)  // 窗口宽度
-console.log(windowInfo.windowHeight) // 窗口高度
-```
-
-#### `getPlatform()`
-
-获取当前运行平台类型
-
-**返回值:**
-- `string`: 平台类型，可能的值：`'weixin'` | `'web'` | `'app'` | `'alipay'` | `'h5'`
-
-**示例:**
-```javascript
-const platform = getPlatform()
-console.log(platform) // 'weixin' | 'web' | 'app' | 'alipay' | 'h5'
-
-// 根据平台执行不同逻辑
-if (platform === 'weixin') {
-  // 微信小程序特有逻辑
-} else if (platform === 'h5') {
-  // H5 特有逻辑
-}
-```
-
-#### `getCurrentEnv()`
-
-获取小程序账户信息，包含appId、版本、环境等信息
-
-**返回值:**
-- `object`: 小程序账户信息对象
-  - `appId` (string): 小程序appId
-  - `version` (string): 小程序版本号
-  - `envVersion` (string): 小程序环境版本（develop开发版、trial体验版、release正式版）
-  - `accountInfo` (object): 完整的账户信息对象
-
-**示例:**
-```javascript
-const envInfo = getCurrentEnv()
-console.log(envInfo.appId)      // 小程序appId
-console.log(envInfo.version)    // 小程序版本号
-console.log(envInfo.envVersion) // 环境版本
-
-// 根据环境执行不同逻辑
-if (envInfo.envVersion === 'develop') {
-  // 开发版特有逻辑
-} else if (envInfo.envVersion === 'release') {
-  // 正式版特有逻辑
-}
-```
-
-#### `onCheckForUpdate()`
-
-检查小程序版本更新，自动处理版本检查、下载和更新流程
-
-**参数:**
-- 无参数
-
-**功能说明:**
-- 自动检查小程序是否有新版本
-- 发现新版本时静默下载
-- 下载完成后弹窗提示用户是否重启应用
-- 处理下载失败的情况
-- 支持用户选择稍后更新或立即重启
-
-**平台支持:**
-- ✅ 微信小程序
-- ✅ 支付宝小程序
-- ✅ 百度小程序
-- ✅ 抖音小程序
-- ✅ QQ小程序
-- ✅ 快手小程序
-- ✅ 京东小程序
-- ❌ App (App端请使用其他更新方案)
-- ❌ H5 (H5端无需此功能)
-
-**示例:**
-```javascript
-// 在App.vue中使用
-export default {
-  onLaunch() {
-    // 应用启动时检查更新
-    onCheckForUpdate()
-  },
-  onShow() {
-    // 每次从后台切换到前台时检查更新
-    onCheckForUpdate()
-  }
-}
-
-// 或在页面中手动调用
-onCheckForUpdate()
-```
-
-**注意事项:**
-- 建议在App.vue的onLaunch或onShow生命周期中调用
-- 开发版和体验版无法检查版本更新，需要在正式版中测试
-- 在开发者工具中可以通过"模拟更新编译"来测试更新功能
-- 函数内部已处理异常情况，不会影响应用正常运行
-
-#### `getStatusBarHeight()`
-
-获取设备状态栏高度
-
-**返回值:**
-- `number`: 状态栏高度（单位：px）
-
-**示例:**
-```javascript
-const statusBarHeight = getStatusBarHeight()
-console.log(statusBarHeight) // 44 (iPhone) 或其他设备的状态栏高度
-
-// 用于页面布局适配
-const pageStyle = {
-  paddingTop: statusBarHeight + 'px'
-}
-```
-
-#### `getNavHeight()`
-
-获取小程序导航栏总高度，包含状态栏高度和菜单按钮高度
-
-**返回值:**
-- `number`: 导航栏总高度（单位：px）
-
-**示例:**
-```javascript
-const navHeight = getNavHeight()
-console.log(navHeight) // 88 (iPhone) 或其他设备的导航栏总高度
-
-// 用于自定义导航栏高度设置
-const customNavStyle = {
-  height: navHeight + 'px'
-}
-```
-
-#### `getTopNavBarHeight()`
-
-一次性获取应用所需的状态栏和导航栏高度配置信息
-
-**返回值:**
-- `object`: 配置信息对象
-  - `statusBarHeight` (number): 状态栏高度（单位：px）
-  - `navHeight` (number): 导航栏总高度（单位：px）
-
-**示例:**
-```javascript
-const topNavConfig = getTopNavBarHeight()
-console.log(topNavConfig.statusBarHeight) // 状态栏高度
-console.log(topNavConfig.navHeight)       // 导航栏总高度
-
-// 用于全局配置
-const globalConfig = {
-  ...topNavConfig,
-  contentHeight: windowHeight - topNavConfig.navHeight
-}
-```
-
-**注意事项:**
-- 这些函数主要用于小程序平台的界面适配
-- 在不同设备上返回的高度值可能不同
-- 建议在应用启动时获取并存储这些配置信息
-- 如果获取失败，会返回默认值确保应用正常运行
-
-
-
-### 💾 本地存储工具 (Storage)
-
-#### `setStorageSync(key, obj)`
-
-同步设置本地缓存，自动处理对象序列化
-
-**参数:**
-- `key` (string): 缓存键
-- `obj` (unknown): 要缓存的值，可以是任何类型
-
-**示例:**
-```javascript
-// 存储字符串
-setStorageSync('username', 'john')
-
-// 存储对象（自动序列化）
-setStorageSync('userInfo', { name: 'john', age: 25 })
-
-// 存储数组
-setStorageSync('list', [1, 2, 3, 4, 5])
-
-// 存储布尔值
-setStorageSync('isLogin', true)
-```
-
-#### `getStorageSync(key)`
-
-同步获取本地缓存，自动处理对象反序列化
-
-**参数:**
-- `key` (string): 缓存键
-
-**返回值:**
-- 缓存的值。如果存储的是 JSON 字符串，则返回解析后的对象；否则返回原始值
-
-**示例:**
-```javascript
-// 获取字符串
-const username = getStorageSync('username')
-
-// 获取对象（自动反序列化）
-const userInfo = getStorageSync('userInfo')
-
-// 获取数组
-const list = getStorageSync('list')
-
-// 获取布尔值
-const isLogin = getStorageSync('isLogin')
-```
-
-#### `clearStorageSync(key?)`
-
-清理本地缓存，支持清理指定项或全部清理
-
-**参数:**
-- `key` (string, 可选): 缓存键。如果传入则删除对应的缓存项，如果不传入则清除所有缓存
-
-**示例:**
-```javascript
-// 清理指定缓存
-clearStorageSync('username')
-
-// 清理所有缓存
-clearStorageSync()
-```
-
-## 🛠️ 开发使用
-
-### 安装依赖
-```bash
-yarn install
-# 或
-npm install
-```
-
-### 开发脚本
-```bash
-# 开发模式
-yarn dev
-# 或
-npm run dev
-
-# 运行测试
-yarn test
-# 或
-npm test
-```
-
-## 🏗️ 技术栈
-
-- **TypeScript** - 类型安全的 JavaScript
-- **UniApp** - 跨平台应用开发框架
-- **ES6 Modules** - 模块化开发
-
-## 📁 项目结构
-
-```
-my-uniapp-tools/
-├── .augment/           # 增强配置目录
-│   └── rules/
-├── src/
-│   ├── ui/              # UI交互工具函数
-│   │   └── index.ts
-│   ├── navigation/      # 导航相关工具
-│   │   └── index.ts
-│   ├── clipboard/       # 剪贴板工具
-│   │   └── index.ts
-│   ├── system/          # 系统信息工具
-│   │   └── index.ts
-│   ├── localStorage/    # 本地存储工具
-│   │   └── index.ts
-│   └── index.js        # 主入口文件
-├── .gitignore          # Git 忽略配置
-├── package.json        # 项目配置
-├── tsconfig.json       # TypeScript 配置
-├── yarn.lock           # Yarn 依赖锁定文件
-├── README.md           # 项目说明
-└── RECORD.md           # 项目记录
-```
-
-## 🔄 版本信息
-
-当前版本：v1.0.0
-
-## 📄 许可证
-
-ISC
-
-## 🤝 贡献指南
-
-欢迎提交 Issue 和 Pull Request 来完善这个工具库！
-
-### 开发规范
-
-1. 所有函数都应该遵循单一职责原则
-2. 必须添加详细的中文注释
-3. 新增功能需要在 README.md 中更新文档
-4. 保持代码简洁可读
-5. 确保跨平台兼容性
-
-## 📝 更新日志
-
-### v1.0.0
-- 🎯 **初始版本发布**
-- 🏗️ **模块化架构**：按功能类型组织代码结构
-- 📁 **五大核心模块**：
-  - `ui` - UI交互工具（useToast）
-  - `navigation` - 导航工具（useBack）
-  - `clipboard` - 剪贴板工具（copyText）
-  - `system` - 系统信息工具（useWindowInfo, getPlatform, getCurrentEnv, onCheckForUpdate, getStatusBarHeight, getNavHeight, getTopNavBarHeight）
-  - `localStorage` - 本地存储工具（setStorageSync, getStorageSync, clearStorageSync）
-- ✨ **核心功能**：
-  - 📱 跨平台消息提示和导航返回
-  - 📋 跨平台剪贴板操作
-  - 🖥️ 系统信息获取和平台检测
-  - 🔄 小程序版本更新检查
-  - 📏 状态栏和导航栏高度适配
-  - 💾 本地存储数据管理
-- 🛡️ **完善的错误处理机制**，确保函数调用的稳定性
-- 💡 **遵循单一职责原则**，每个函数专注于特定功能
-- 📚 **详细的API文档**，包含使用说明和示例代码
-- 🎯 **支持主流平台**：微信、支付宝、百度、抖音、QQ、快手、京东等小程序平台以及H5、App
-
----
-
+# My UniApp Tools
+
+一个专为 UniApp 开发设计的实用工具函数库，提供常用的功能模块，帮助开发者快速构建跨平台应用。
+
+## 📦 安装
+
+```bash
+# 使用 npm
+npm install my-uniapp-tools
+
+# 使用 yarn
+yarn add my-uniapp-tools
+
+# 使用 pnpm
+pnpm add my-uniapp-tools
+```
+
+## 🚀 快速开始
+
+```javascript
+// 导入所有工具函数
+import * as Tools from 'my-uniapp-tools'
+
+// 或者按需导入
+import { 
+  useToast, 
+  useBack, 
+  copyText, 
+  setStorageSync, 
+  getStorageSync, 
+  clearStorageSync,
+  useWindowInfo,
+  getPlatform, 
+  getCurrentEnv, 
+  onCheckForUpdate,
+  getStatusBarHeight,
+  getNavHeight,
+  getTopNavBarHeight
+} from 'my-uniapp-tools'
+```
+
+## 📚 API 文档
+
+### 🎨 UI交互工具 (UI)
+
+#### `useToast(title, mask, icon, duration)`
+
+显示消息提示框
+
+**参数:**
+- `title` (string): 提示的内容，默认为空字符串
+- `mask` (boolean): 是否显示透明蒙层，默认为 `false`
+- `icon` (string): 图标类型，可选值：`'none'` | `'success'` | `'loading'` | `'error'` | `'fail'` | `'exception'`，默认为 `'none'`
+- `duration` (number): 提示的延迟时间，默认为 `2000` 毫秒
+
+**示例:**
+```javascript
+// 基础用法
+useToast('操作成功')
+
+// 完整参数
+useToast(
+  '操作成功',           // 提示文字
+  false,               // 是否显示透明蒙层
+  'success',           // 图标类型
+  2000                 // 显示时长(毫秒)
+)
+```
+
+### 🧭 导航工具 (Navigation)
+
+#### `useBack(params)`
+
+返回上一页并支持传递参数给上一页的 init 方法
+
+**参数:**
+- `params` (any): 传递给上一页 init 方法的参数，默认为空字符串
+
+**示例:**
+```javascript
+// 简单返回
+useBack()
+
+// 返回并传递参数
+useBack({ refresh: true, data: 'some data' })
+```
+
+**注意：** 上一页需要暴露 `init` 方法来接收参数
+
+### 📋 剪贴板工具 (Clipboard)
+
+#### `copyText(text)`
+
+跨平台文本复制功能，支持 H5、App、小程序。H5 平台优先使用现代的 Clipboard API，失败时回退到传统方法。
+
+**参数:**
+- `text` (string): 要复制的文本内容
+
+**示例:**
+```javascript
+copyText('要复制的文本内容')
+```
+
+### 🖥️ 系统信息工具 (System)
+
+#### `useWindowInfo()`
+
+获取当前窗口的尺寸、像素比等信息
+
+**返回值:**
+- 窗口信息对象，包含窗口尺寸、像素比等信息
+
+**示例:**
+```javascript
+const windowInfo = useWindowInfo()
+console.log(windowInfo.windowWidth)  // 窗口宽度
+console.log(windowInfo.windowHeight) // 窗口高度
+```
+
+#### `getPlatform()`
+
+获取当前运行平台类型
+
+**返回值:**
+- `string`: 平台类型，可能的值：`'weixin'` | `'web'` | `'app'` | `'alipay'` | `'h5'`
+
+**示例:**
+```javascript
+const platform = getPlatform()
+console.log(platform) // 'weixin' | 'web' | 'app' | 'alipay' | 'h5'
+
+// 根据平台执行不同逻辑
+if (platform === 'weixin') {
+  // 微信小程序特有逻辑
+} else if (platform === 'h5') {
+  // H5 特有逻辑
+}
+```
+
+#### `getCurrentEnv()`
+
+获取小程序账户信息，包含appId、版本、环境等信息
+
+**返回值:**
+- `object`: 小程序账户信息对象
+  - `appId` (string): 小程序appId
+  - `version` (string): 小程序版本号
+  - `envVersion` (string): 小程序环境版本（develop开发版、trial体验版、release正式版）
+  - `accountInfo` (object): 完整的账户信息对象
+
+**示例:**
+```javascript
+const envInfo = getCurrentEnv()
+console.log(envInfo.appId)      // 小程序appId
+console.log(envInfo.version)    // 小程序版本号
+console.log(envInfo.envVersion) // 环境版本
+
+// 根据环境执行不同逻辑
+if (envInfo.envVersion === 'develop') {
+  // 开发版特有逻辑
+} else if (envInfo.envVersion === 'release') {
+  // 正式版特有逻辑
+}
+```
+
+#### `onCheckForUpdate()`
+
+检查小程序版本更新，自动处理版本检查、下载和更新流程
+
+**参数:**
+- 无参数
+
+**功能说明:**
+- 自动检查小程序是否有新版本
+- 发现新版本时静默下载
+- 下载完成后弹窗提示用户是否重启应用
+- 处理下载失败的情况
+- 支持用户选择稍后更新或立即重启
+
+**平台支持:**
+- ✅ 微信小程序
+- ✅ 支付宝小程序
+- ✅ 百度小程序
+- ✅ 抖音小程序
+- ✅ QQ小程序
+- ✅ 快手小程序
+- ✅ 京东小程序
+- ❌ App (App端请使用其他更新方案)
+- ❌ H5 (H5端无需此功能)
+
+**示例:**
+```javascript
+// 在App.vue中使用
+export default {
+  onLaunch() {
+    // 应用启动时检查更新
+    onCheckForUpdate()
+  },
+  onShow() {
+    // 每次从后台切换到前台时检查更新
+    onCheckForUpdate()
+  }
+}
+
+// 或在页面中手动调用
+onCheckForUpdate()
+```
+
+**注意事项:**
+- 建议在App.vue的onLaunch或onShow生命周期中调用
+- 开发版和体验版无法检查版本更新，需要在正式版中测试
+- 在开发者工具中可以通过"模拟更新编译"来测试更新功能
+- 函数内部已处理异常情况，不会影响应用正常运行
+
+#### `getStatusBarHeight()`
+
+获取设备状态栏高度
+
+**返回值:**
+- `number`: 状态栏高度（单位：px）
+
+**示例:**
+```javascript
+const statusBarHeight = getStatusBarHeight()
+console.log(statusBarHeight) // 44 (iPhone) 或其他设备的状态栏高度
+
+// 用于页面布局适配
+const pageStyle = {
+  paddingTop: statusBarHeight + 'px'
+}
+```
+
+#### `getNavHeight()`
+
+获取小程序导航栏总高度，包含状态栏高度和菜单按钮高度
+
+**返回值:**
+- `number`: 导航栏总高度（单位：px）
+
+**示例:**
+```javascript
+const navHeight = getNavHeight()
+console.log(navHeight) // 88 (iPhone) 或其他设备的导航栏总高度
+
+// 用于自定义导航栏高度设置
+const customNavStyle = {
+  height: navHeight + 'px'
+}
+```
+
+#### `getTopNavBarHeight()`
+
+一次性获取应用所需的状态栏和导航栏高度配置信息
+
+**返回值:**
+- `object`: 配置信息对象
+  - `statusBarHeight` (number): 状态栏高度（单位：px）
+  - `navHeight` (number): 导航栏总高度（单位：px）
+
+**示例:**
+```javascript
+const topNavConfig = getTopNavBarHeight()
+console.log(topNavConfig.statusBarHeight) // 状态栏高度
+console.log(topNavConfig.navHeight)       // 导航栏总高度
+
+// 用于全局配置
+const globalConfig = {
+  ...topNavConfig,
+  contentHeight: windowHeight - topNavConfig.navHeight
+}
+```
+
+**注意事项:**
+- 这些函数主要用于小程序平台的界面适配
+- 在不同设备上返回的高度值可能不同
+- 建议在应用启动时获取并存储这些配置信息
+- 如果获取失败，会返回默认值确保应用正常运行
+
+
+
+### 💾 本地存储工具 (Storage)
+
+#### `setStorageSync(key, obj)`
+
+同步设置本地缓存，自动处理对象序列化
+
+**参数:**
+- `key` (string): 缓存键
+- `obj` (unknown): 要缓存的值，可以是任何类型
+
+**示例:**
+```javascript
+// 存储字符串
+setStorageSync('username', 'john')
+
+// 存储对象（自动序列化）
+setStorageSync('userInfo', { name: 'john', age: 25 })
+
+// 存储数组
+setStorageSync('list', [1, 2, 3, 4, 5])
+
+// 存储布尔值
+setStorageSync('isLogin', true)
+```
+
+#### `getStorageSync(key)`
+
+同步获取本地缓存，自动处理对象反序列化
+
+**参数:**
+- `key` (string): 缓存键
+
+**返回值:**
+- 缓存的值。如果存储的是 JSON 字符串，则返回解析后的对象；否则返回原始值
+
+**示例:**
+```javascript
+// 获取字符串
+const username = getStorageSync('username')
+
+// 获取对象（自动反序列化）
+const userInfo = getStorageSync('userInfo')
+
+// 获取数组
+const list = getStorageSync('list')
+
+// 获取布尔值
+const isLogin = getStorageSync('isLogin')
+```
+
+#### `clearStorageSync(key?)`
+
+清理本地缓存，支持清理指定项或全部清理
+
+**参数:**
+- `key` (string, 可选): 缓存键。如果传入则删除对应的缓存项，如果不传入则清除所有缓存
+
+**示例:**
+```javascript
+// 清理指定缓存
+clearStorageSync('username')
+
+// 清理所有缓存
+clearStorageSync()
+```
+
+## 🛠️ 开发使用
+
+### 安装依赖
+```bash
+yarn install
+# 或
+npm install
+```
+
+### 开发脚本
+```bash
+# 开发模式
+yarn dev
+# 或
+npm run dev
+
+# 运行测试
+yarn test
+# 或
+npm test
+```
+
+## 🏗️ 技术栈
+
+- **TypeScript** - 类型安全的 JavaScript
+- **UniApp** - 跨平台应用开发框架
+- **ES6 Modules** - 模块化开发
+
+## 📁 项目结构
+
+```
+my-uniapp-tools/
+├── .augment/           # 增强配置目录
+│   └── rules/
+├── src/
+│   ├── ui/              # UI交互工具函数
+│   │   └── index.ts
+│   ├── navigation/      # 导航相关工具
+│   │   └── index.ts
+│   ├── clipboard/       # 剪贴板工具
+│   │   └── index.ts
+│   ├── system/          # 系统信息工具
+│   │   └── index.ts
+│   ├── localStorage/    # 本地存储工具
+│   │   └── index.ts
+│   └── index.js        # 主入口文件
+├── .gitignore          # Git 忽略配置
+├── package.json        # 项目配置
+├── tsconfig.json       # TypeScript 配置
+├── yarn.lock           # Yarn 依赖锁定文件
+├── README.md           # 项目说明
+└── RECORD.md           # 项目记录
+```
+
+## 🔄 版本信息
+
+当前版本：v1.0.0
+
+## 📄 许可证
+
+ISC
+
+## 🤝 贡献指南
+
+欢迎提交 Issue 和 Pull Request 来完善这个工具库！
+
+### 开发规范
+
+1. 所有函数都应该遵循单一职责原则
+2. 必须添加详细的中文注释
+3. 新增功能需要在 README.md 中更新文档
+4. 保持代码简洁可读
+5. 确保跨平台兼容性
+
+## 📝 更新日志
+
+### v1.0.0
+- 🎯 **初始版本发布**
+- 🏗️ **模块化架构**：按功能类型组织代码结构
+- 📁 **五大核心模块**：
+  - `ui` - UI交互工具（useToast）
+  - `navigation` - 导航工具（useBack）
+  - `clipboard` - 剪贴板工具（copyText）
+  - `system` - 系统信息工具（useWindowInfo, getPlatform, getCurrentEnv, onCheckForUpdate, getStatusBarHeight, getNavHeight, getTopNavBarHeight）
+  - `localStorage` - 本地存储工具（setStorageSync, getStorageSync, clearStorageSync）
+- ✨ **核心功能**：
+  - 📱 跨平台消息提示和导航返回
+  - 📋 跨平台剪贴板操作
+  - 🖥️ 系统信息获取和平台检测
+  - 🔄 小程序版本更新检查
+  - 📏 状态栏和导航栏高度适配
+  - 💾 本地存储数据管理
+- 🛡️ **完善的错误处理机制**，确保函数调用的稳定性
+- 💡 **遵循单一职责原则**，每个函数专注于特定功能
+- 📚 **详细的API文档**，包含使用说明和示例代码
+- 🎯 **支持主流平台**：微信、支付宝、百度、抖音、QQ、快手、京东等小程序平台以及H5、App
+
+---
+
 如有问题或建议，请提交 Issue 或联系开发者。感谢您的使用！ 🙏