@zfqh/uniapp 0.3.0 → 0.3.1

package/CHANGELOG.md

@@ -3,6 +3,14 @@
 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)
 
 

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/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.3.0",
+  "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": "2527c90194ae48b8d23817b248f53cd6435fd3a0"
+  "gitHead": "e8db2e5a9fe9900f05fd763304bbd787f70a1fc1"
 }