@zfqh/uniapp 0.2.31 → 0.3.1

package/CHANGELOG.md

@@ -3,6 +3,33 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [0.3.1](http://10.10.10.16/caoben/front-end/compare/@zfqh/uniapp@0.3.0...@zfqh/uniapp@0.3.1) (2026-07-08)
+
+**Note:** Version bump only for package @zfqh/uniapp
+
+
+
+
+
+# [0.3.0](http://10.10.10.16/caoben/front-end/compare/@zfqh/uniapp@0.2.32...@zfqh/uniapp@0.3.0) (2026-07-07)
+
+
+### Features
+
+* 增加permission组件 ([0161786](http://10.10.10.16/caoben/front-end/commits/0161786fb3d1ec98ff4fb3251ce4c05adc11e14c))
+
+
+
+
+
+## [0.2.32](http://10.10.10.16/caoben/front-end/compare/@zfqh/uniapp@0.2.31...@zfqh/uniapp@0.2.32) (2026-07-07)
+
+**Note:** Version bump only for package @zfqh/uniapp
+
+
+
+
+
 ## [0.2.31](http://10.10.10.16/caoben/front-end/compare/@zfqh/uniapp@0.2.30...@zfqh/uniapp@0.2.31) (2026-07-02)
 
 **Note:** Version bump only for package @zfqh/uniapp

package/docs/api/configs/cdn.md

@@ -8,6 +8,7 @@ CDN 静态资源配置。发布路径：`@zfqh/uniapp/lib/configs/cdn`
 | `staticUrl` | `string` | `''` | 静态站点路径。 |
 | `ossUrl` | `string` | `''` | 阿里 OSS 资源路径。 |
 | `cosUrl` | `string` | `''` | 腾讯 COS 资源路径。 |
+| `isAccelerate` | `boolean` | `false` | 是否启用 COS 全球加速，upload 配置会据此自动切换 region 为 `accelerate`。 |
 
 ## 基本使用
 
@@ -33,3 +34,18 @@ export function normalizeArticleImage(path: string) {
   return `${config.cdn.baseUrl}/${path.replace(/^\/+/, '')}`;
 }
 ```
+
+## COS 全球加速
+
+当项目使用腾讯云 COS 全球加速时，设置 `isAccelerate: true`，upload 配置会自动将 region 切换为 `accelerate`，updater 配置会将 prod 环境的 COS 链接转为 `acc-static` 域名：
+
+```ts
+// env/.env.prod.ts
+import { defineEnvConfig } from '@zfqh/uniapp';
+
+export default defineEnvConfig({
+  cdn: {
+    isAccelerate: true,
+  },
+});
+```

package/docs/api/configs/index.md

@@ -100,7 +100,7 @@ export default defineEnvConfig({
 | --- | --- | --- |
 | `env` | `configs/env.ts` | 当前环境信息，自动读取环境文件。 |
 | `api` | `configs/api.ts` | `baseUrl` 接口地址。 |
-| `cdn` | `configs/cdn.ts` | `baseUrl`、`staticUrl`、`ossUrl`、`cosUrl`。 |
+| `cdn` | `configs/cdn.ts` | `baseUrl`、`staticUrl`、`ossUrl`、`cosUrl`、`isAccelerate`。 |
 | `log` | `configs/log.ts` | 请求/响应日志开关。 |
 | `mp` | `configs/mp.ts` | 小程序相关配置。 |
 | `app` | `configs/app.ts` | 应用 code、名称、主题色、AppId、渠道。 |
@@ -115,6 +115,7 @@ export default defineEnvConfig({
 | `toast` | `configs/toast.ts` | 自定义 Toast 适配。 |
 | `web` | `configs/web.ts` | Web 资源配置。 |
 | `storage` | `configs/storage.ts` | 本地存储 key 前缀。 |
+| `updater` | `configs/updater.ts` | 版本检查请求函数，默认处理 APK 静态域名转换。 |
 
 ## app
 

package/docs/api/configs/updater.md

@@ -0,0 +1,34 @@
+# updater
+
+更新配置。发布路径：`@zfqh/uniapp/lib/configs/updater`
+
+| 字段 | 类型 | 默认值 | 说明 |
+| --- | --- | --- | --- |
+| `request(params)` | `function` | 内置调用 `getLastVersion` | 版本检查请求；默认会将 `.apk` 的 COS 链接转为静态域名地址；当 `cdn.isAccelerate` 为 `true` 时处理所有 COS 链接，且 prod 环境使用 `acc-static` 域名。 |
+
+`params` 参数：
+
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| `version` | `number` | 当前版本号。 |
+| `appId` | `string` | 应用 ID。 |
+| `type` | `number` | 查询类型。 |
+| `platform` | `string` | 平台标识。 |
+
+## 基本使用
+
+默认行为已满足大多数场景，无需额外配置。如需自定义版本检查逻辑，可覆盖 `request`：
+
+```ts
+import { defineConfig } from '@zfqh/uniapp';
+
+defineConfig({
+  updater: {
+    async request(params) {
+      // 自定义版本检查逻辑
+      const res = await myCustomApi(params);
+      return res;
+    },
+  },
+});
+```

package/docs/api/configs/upload.md

@@ -4,7 +4,7 @@
 
 | 字段 | 类型 | 默认值 | 说明 |
 | --- | --- | --- | --- |
-| `request(params)` | `function` | `Promise<null>` | 获取上传凭证；COS 上传会以 { mode: "cos" } 调用。 |
+| `request(params)` | `function` | 内置调用 `getTencentToken` | 获取上传凭证；COS 上传会以 { mode: "cos" } 调用。 |
 
 COS 上传需要 `request` 返回：
 
@@ -20,25 +20,19 @@ COS 上传需要 `request` 返回：
 
 ## 基本使用
 
-患者端和商户端上传图片时，通常从后端获取腾讯云临时密钥，并映射成 COS 工具需要的字段。
+默认已内置调用 `getTencentToken` 获取腾讯云临时密钥，通常无需额外配置。如需启用 COS 全球加速，在 cdn 配置中设置 `isAccelerate: true` 即可。
+
+仅当需要完全自定义请求逻辑时才需覆盖 `request`：
 
 ```ts
 import { defineConfig } from '@zfqh/uniapp';
-import { getTencentToken } from '@zfqh/uniapp/lib/apis';
 
 defineConfig({
   upload: {
     async request() {
-      const { data } = await getTencentToken();
-      return {
-        secret_id: data.tmpSecretId,
-        secret_key: data.tmpSecretKey,
-        session_token: data.sessionToken,
-        create_time: data.createTime,
-        expire_time: data.expirationTime,
-        bucket: data.bucket,
-        region: data.region,
-      };
+      // 自定义上传凭证逻辑
+      const res = await myCustomApi();
+      return res;
     },
   },
 });

package/docs/components/g-permission.md

@@ -0,0 +1,61 @@
+# g-permission 权限控制
+
+::: tip 组件名
+`g-permission`
+
+发布路径：`@zfqh/uniapp/lib/components/g-permission/g-permission.vue`
+:::
+
+根据当前用户的菜单权限（`state.app.info.perms`）条件渲染插槽内容，用于按权限控制按钮、菜单项等 UI 元素的显示。
+
+## 平台兼容性
+
+| App（vue） | App（nvue） | H5 | 小程序 | Vue 2 | Vue 3 |
+| --- | --- | --- | --- | --- | --- |
+| √ | √ | √ | √ | - | √ |
+
+## 使用前提
+
+- 已安装并注册 `@zfqh/uniapp` 插件。
+- 已按 [项目接入](./usage) 配置 easycom，或手动从构建产物导入组件。
+- Store 中已注册 `app` 模块（提供 `state.app.info.perms` 数据）。
+
+## 工作原理
+
+组件从 `uni.$store.state.app.info.perms` 读取权限列表，筛选 `isSelect` 为 `true` 的项，判断其 `menuName` 是否与 `include` 匹配。`include` 支持传入单个字符串或字符串数组，满足任一匹配即渲染插槽内容，否则不渲染。
+
+权限数据为异步加载，`perms` 变化时组件会自动重新计算，响应权限更新。
+
+## 基本使用
+
+```vue
+<template>
+  <!-- 单个权限 -->
+  <g-permission include="门店二维码">
+    <button>门店二维码</button>
+  </g-permission>
+
+  <!-- 多个权限（满足任一即显示） -->
+  <g-permission :include="['会员管理']">
+    <button>管理功能</button>
+  </g-permission>
+</template>
+```
+
+## API
+
+### Props
+
+| 属性 | 类型 | 默认值 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `include` | `String \| Array` | - | 是 | 需要匹配的权限名称（`menuName`），支持单个字符串或字符串数组。 |
+
+### Events
+
+无。
+
+### Slots
+
+| 插槽 | 说明 |
+| --- | --- |
+| `default` | 有权限时渲染的内容。 |

package/docs/components/index.md

@@ -78,6 +78,7 @@ Options API 组件可使用 `this.$store`。普通 TS 模块中使用 `uni.$stor
 | [`g-popup`](./g-popup) | 通用弹窗，封装 uv-popup 的标题、内容、底部按钮、关闭、确认和样式配置。 |
 | [`g-mask`](./g-mask) | 遮罩层组件，支持层级、缩放动画、点击关闭能力和默认插槽内容。 |
 | [`g-float`](./g-float) | 悬浮操作按钮，滚动时可自动淡出，点击后可跳转或抛出 goto 事件。 |
+| [`g-permission`](./g-permission) | 权限控制组件，根据 `perms` 中 `isSelect` 为 true 的 `menuName` 条件渲染插槽内容。 |
 | [`g-permission-popup`](./g-permission-popup) | 权限申请辅助弹层，监听 requestPermission 事件展示授权原因。 |
 | [`g-back-button`](./g-back-button) | 自定义返回/首页按钮，适合透明导航栏、沉浸式页面或小程序胶囊左侧区域。 |
 

package/docs/components/usage.md

@@ -39,7 +39,7 @@
 | 基础展示 | `g-icon`、`g-dot-text`、`g-money`、`g-more`、`g-skeleton`、`g-skeleton-view` | 图标、状态文本、金额、查看更多、骨架屏。 |
 | 表单输入 | `g-search`、`g-checkbox-list`、`g-tag-editor`、`g-upload` | 搜索、选择、标签编辑、文件上传。 |
 | 图片布局 | `g-grid-image`、`g-grid-swiper`、`g-waterfall`、`g-render-image` | 图片网格、宫格轮播、瀑布流、海报渲染。 |
-| 弹层反馈 | `g-mask`、`g-popup`、`g-permission-popup`、`g-float` | 遮罩、弹窗、权限提示、悬浮入口。 |
+| 弹层反馈 | `g-mask`、`g-popup`、`g-permission`、`g-permission-popup`、`g-float` | 遮罩、弹窗、权限控制、权限提示、悬浮入口。 |
 | 分享 | `g-share-view`、`g-share-photo`、`g-share-weixin` | 分享面板、保存图片、微信分享。 |
 | 音视频/图表 | `g-trtc`、`g-trtc-room`、`g-trtc-tui`、`g-polyline-view`、`g-polyline-chat`、`g-timer` | TRTC、TUI 通话、折线展示、计时器。 |
 | 调试 | `g-back-button` | 自定义返回/首页按钮。 |

package/lib/components/g-permission/g-permission.vue

@@ -0,0 +1,25 @@
+<template>
+  <slot v-if="hasPermission"></slot>
+</template>
+
+<script>
+export default {
+  props: {
+    include: {
+      type: [String, Array],
+      required: true,
+    },
+  },
+  computed: {
+    permNames() {
+      const perms = this.$store?.state?.app?.info?.perms || [];
+      // 只取 isSelect 为 true 的 menuName
+      return perms.filter(p => p.isSelect).map(p => p.menuName);
+    },
+    hasPermission() {
+      const list = Array.isArray(this.include) ? this.include : [this.include];
+      return list.some(v => this.permNames.includes(v));
+    },
+  },
+};
+</script>

package/lib/configs/cdn.d.ts

@@ -8,6 +8,8 @@ declare const cdn: {
     ossUrl: string;
     /** 腾讯COS静态资源路径 */
     cosUrl: string;
+    /** 是否启用COS全球加速 */
+    isAccelerate: boolean;
 };
 export type CdnConfig = Partial<typeof cdn>;
 export default cdn;

package/lib/configs/cdn.js

@@ -8,5 +8,7 @@ const cdn = {
     ossUrl: '',
     /** 腾讯COS静态资源路径 */
     cosUrl: '',
+    /** 是否启用COS全球加速 */
+    isAccelerate: false,
 };
 export default cdn;

package/lib/configs/index.d.ts

@@ -1,4 +1,5 @@
 import { ColorConfig } from './color';
+import { CdnConfig } from './cdn';
 import { VerConfig } from './ver';
 import { AppConfig } from './app';
 import { TabbarConfig } from './tabbar';
@@ -6,6 +7,7 @@ import { PathConfig } from './path';
 import { PageConfig } from './page';
 import { LinkConfig } from './link';
 import { UploadConfig } from './upload';
+import { UpdaterConfig } from './updater';
 import { NavigateConfig } from './navigate';
 import { ToastConfig } from './toast';
 import { DefineEnvConfig } from './env';
@@ -27,8 +29,12 @@ export interface DefineBaseConfig {
     navigate?: NavigateConfig;
     /** 上传配置 */
     upload?: UploadConfig;
+    /** 更新配置 */
+    updater?: UpdaterConfig;
     /** 版本配置 */
     ver?: VerConfig;
+    /** CDN配置 */
+    cdn?: CdnConfig;
     /** toast配置 */
     toast?: ToastConfig;
     /** 存储配置 */
@@ -52,6 +58,7 @@ declare const conf: {
         staticUrl: string;
         ossUrl: string;
         cosUrl: string;
+        isAccelerate: boolean;
     };
     /** 日志配置 */
     log: {
@@ -125,6 +132,8 @@ declare const conf: {
     };
     /** 上传配置 */
     upload: UploadConfig;
+    /** 更新配置 */
+    updater: UpdaterConfig;
     /** 导航配置 */
     navigate: {
         loginType: import("./navigate").NavigateType;

package/lib/configs/index.js

@@ -11,6 +11,7 @@ import path from './path';
 import page from './page';
 import link from './link';
 import upload from './upload';
+import updater from './updater';
 import navigate from './navigate';
 import toast from './toast';
 import web from './web';
@@ -42,6 +43,8 @@ const conf = {
     page,
     /** 上传配置 */
     upload,
+    /** 更新配置 */
+    updater,
     /** 导航配置 */
     navigate,
     /** 版本配置 */

package/lib/configs/updater.d.ts

@@ -0,0 +1,15 @@
+/** 更新配置参数 */
+export type UpdateParams = {
+    version: number;
+    appId: string;
+    type: number;
+    platform?: string;
+};
+/** 更新配置 */
+export type UpdaterConfig = {
+    /** 版本检查请求，客户端可根据业务自行覆盖 */
+    request: (params: UpdateParams) => Promise<any>;
+};
+/** 更新配置 */
+declare const Updater: UpdaterConfig;
+export default Updater;

package/lib/configs/updater.js

@@ -0,0 +1,33 @@
+import { getLastVersion } from '../apis/core';
+import cdn from './cdn';
+/** 将 COS 链接转为静态域名链接 */
+function convertCosUrl(url) {
+    if (!url)
+        return url;
+    const isAccelerate = !!cdn.isAccelerate;
+    // 非加速模式仅处理 .apk
+    if (!isAccelerate && !/\.apk$/i.test(url))
+        return url;
+    const match = url.match(/^https?:\/\/([^.]+)\.cos\.[^.]+\.myqcloud\.com(\/.+)/);
+    if (!match)
+        return url;
+    const [, bucket, path] = match;
+    const envMatch = bucket.match(/^([a-z]+)[-_]/);
+    const envPrefix = envMatch ? envMatch[1] : '';
+    if (envPrefix) {
+        return `https://${envPrefix}-static.qihuang-ai.com${path}`;
+    }
+    return `https://${isAccelerate ? 'acc-' : ''}static.qihuang-ai.com${path}`;
+}
+/** 更新配置 */
+const Updater = {
+    /** 版本检查请求，默认调用 getLastVersion 并处理 COS 链接 */
+    request: async (params) => {
+        const res = await getLastVersion(params, { custom: { message: false } });
+        if (res?.data?.fileUrl) {
+            res.data.fileUrl = convertCosUrl(res.data.fileUrl);
+        }
+        return res;
+    },
+};
+export default Updater;

package/lib/configs/upload.js

@@ -1,7 +1,19 @@
-// 变量大写开头，否则小程序会报错，奇怪...
+import { getTencentToken } from '../apis/core';
+import cdn from './cdn';
 /** 上传配置 */
 const Upload = {
-    /** 上传请求，例如获取Token */
-    request: () => Promise.resolve(null),
+    /** 上传请求，默认调用 getTencentToken 获取腾讯云临时密钥 */
+    request: async () => {
+        const { data } = await getTencentToken();
+        return {
+            secret_id: data.tmpSecretId,
+            secret_key: data.tmpSecretKey,
+            session_token: data.sessionToken,
+            create_time: data.createTime,
+            expire_time: data.expirationTime,
+            bucket: data.bucket,
+            region: cdn.isAccelerate ? 'accelerate' : data.region,
+        };
+    },
 };
 export default Upload;

package/lib/mixins/webview.js

@@ -4,6 +4,7 @@ import { PLATFORM_CODE, IS_WEBVIEW_ENV, SYSTEM_INFO, TYPES } from '../utils/cons
 import app from '../configs/app';
 import { requestPermission } from '../utils/permit';
 import web from '../configs/web';
+import cdn from '../configs/cdn';
 import link from '../configs/link';
 import path from '../configs/path';
 import { base64ToPath } from '../utils/file';
@@ -38,6 +39,7 @@ export default {
                 safeTop: SYSTEM_INFO.safeAreaInsets.top,
                 safeBottom: SYSTEM_INFO.safeAreaInsets.bottom,
                 locale: uni.$i18n?.global?.locale,
+                accelerate: cdn.isAccelerate ? 1 : undefined,
             };
             if (query.primary) {
                 if (String(query.primary).startsWith('#')) {

package/lib/utils/update.js

@@ -1,9 +1,9 @@
 import app from '../configs/app';
 import env from '../configs/env';
 import ver from '../configs/ver';
+import updater from '../configs/updater';
 import { SYSTEM_INFO, IS_WEBVIEW_ENV, TYPES } from './consts';
 import { postMessage } from './index';
-import { getLastVersion } from '../apis/core';
 const { platform, brand } = SYSTEM_INFO;
 let _installMessageHandler = null;
 // #ifdef APP
@@ -66,12 +66,12 @@ export async function checkVersion(options) {
             type = 1;
             plat = { android: '1', ios: '2', harmony: '3', windows: '4', macos: '5' }[platform];
         }
-        const res = await getLastVersion({
+        const res = await updater.request({
             version,
             appId,
             type,
             platform: plat,
-        }, { custom: { message: false } });
+        });
         latest = res?.data;
         if (latest) {
             // #ifdef APP

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zfqh/uniapp",
-  "version": "0.2.31",
+  "version": "0.3.1",
   "description": "uniapp公共模块",
   "author": "yinjiazeng@163.com",
   "license": "MIT",
@@ -46,5 +46,5 @@
     "@types/qs": "^6.9.16",
     "@types/url-parse": "^1.4.11"
   },
-  "gitHead": "2cecb9d1420fd349d575a04d61b8d72b6d083d91"
+  "gitHead": "e8db2e5a9fe9900f05fd763304bbd787f70a1fc1"
 }