@zfqh/uniapp 0.3.21 → 0.3.23

package/README.md

@@ -41,4 +41,3 @@ export function createApp() {
 ## 文档
 
 - 完整指南、组件与 API：[docs/index.md](docs/index.md)
-- 变更记录：[CHANGELOG.md](CHANGELOG.md)

package/docs/api/apis/core.md

@@ -4,10 +4,7 @@
 
 | 方法 | HTTP | 路径 | 说明 |
 | --- | --- | --- | --- |
-| `sendSmsCode` | `POST` | `/admin-api/system/auth/send-checkCode` | 发送短信验证码。 |
-| `getTencentToken` | `GET` | `/app-api/infra/file/getTencentToken` | 获取腾讯上传临时 Token。 |
 | `getLastVersion` | `POST` | `/app-api/system/app/version/get-last-version-v2` | 获取最新版本。 |
-| `getCosUrls` | `POST` | `/app-api/infra/cos/getUrls` | 获取 COS 签名后的地址。 |
 | `postRefreshToken` | `POST` | `/app-api/robot/store/auth/refreshToken?refreshToken=:refreshToken` | 刷新 token。 |
 | `getDictData` | `GET` | `/app-api/system/dict-data/type` | 获取字典数据。 |
 | `getAppData` | `GET` | `/admin-api/robot/authority/queryAppDetail` | 获取应用详情（未登录）。 |
@@ -16,19 +13,10 @@
 
 ## 基本使用
 
-上传配置、字典下拉和 token 刷新都可以直接复用公共接口。
+字典下拉、版本检查与 token 刷新都可以直接复用公共接口。
 
 ```ts
-import { getTencentToken, postRefreshToken, getDictData, getLastVersion } from '@zfqh/uniapp/lib/apis';
-
-export async function loadUploadToken() {
-  const { data } = await getTencentToken();
-  return {
-    secret_id: data.tmpSecretId,
-    secret_key: data.tmpSecretKey,
-    session_token: data.sessionToken,
-  };
-}
+import { postRefreshToken, getDictData, getLastVersion } from '@zfqh/uniapp/lib/apis';
 
 export const getCardTypeOptions = () => getDictData({ type: 'system_user_id_type' });
 
@@ -39,49 +27,6 @@ export const checkAppVersion = () => getLastVersion({ appCode: 'merchant' });
 
 ## 接口用法
 
-### sendSmsCode
-
-发送短信验证码。
-
-```ts
-import { sendSmsCode } from '@zfqh/uniapp/lib/apis';
-
-await sendSmsCode({
-  phone: '13800138000',
-});
-```
-
-| 参数 | 类型 | 必填 | 说明 |
-| --- | --- | --- | --- |
-| `data` | `Record<string, any>` | 是 | 请求体。常用字段为手机号，例如 `phone` 或后端约定的手机号字段。 |
-
-| 返回值 | 说明 |
-| --- | --- |
-| `Promise<ApiResponse>` | 成功时 resolve 后端响应对象；失败、非 `code == 0` 或网络异常时 reject 统一错误响应。 |
-
-### getTencentToken
-
-获取腾讯云上传临时 Token，常用于 COS 直传。
-
-```ts
-import { getTencentToken } from '@zfqh/uniapp/lib/apis';
-
-const { data } = await getTencentToken();
-const credentials = {
-  secretId: data.tmpSecretId,
-  secretKey: data.tmpSecretKey,
-  sessionToken: data.sessionToken,
-};
-```
-
-| 参数 | 类型 | 必填 | 说明 |
-| --- | --- | --- | --- |
-| `data` | `Record<string, any>` | 否 | 查询参数；通常不需要传。 |
-
-| 返回值 | 说明 |
-| --- | --- |
-| `Promise<ApiResponse<TencentToken>>` | 成功时 `data` 为后端返回的临时密钥信息。 |
-
 ### getLastVersion
 
 获取 App 最新版本信息，常用于更新弹窗。
@@ -109,28 +54,6 @@ const { data } = await getLastVersion({
 | --- | --- |
 | `Promise<ApiResponse<AppVersion>>` | 成功时 `data` 为版本信息，例如版本号、状态、整包地址、热更新地址等后端字段。 |
 
-### getCosUrls
-
-获取 COS 私有资源签名访问地址。
-
-```ts
-import { getCosUrls } from '@zfqh/uniapp/lib/apis';
-
-const { data: urls } = await getCosUrls({
-  urls: ['/report/2026/05/demo.pdf'],
-});
-
-const firstUrl = urls[0];
-```
-
-| 参数 | 类型 | 必填 | 说明 |
-| --- | --- | --- | --- |
-| `data.urls` | `string[]` | 是 | 需要签名的 COS 路径数组，通常传去掉域名后的路径。 |
-
-| 返回值 | 说明 |
-| --- | --- |
-| `Promise<ApiResponse<string[]>>` | 成功时 `data` 为签名后的 URL 数组。 |
-
 ### postRefreshToken
 
 刷新登录 token。

package/docs/api/apis/index.md

@@ -20,7 +20,7 @@ export const getReportByNo = (no: string) => GET('/app-api/constitution/new/getR
 
 ```ts
 import request, { GET, POST, PUT, DELETE } from '@zfqh/uniapp/lib/apis/request';
-import { getTencentToken, getDictData } from '@zfqh/uniapp/lib/apis/core';
+import { getDictData } from '@zfqh/uniapp/lib/apis/core';
 ```
 
 ## 调用契约
@@ -54,10 +54,7 @@ export const removeItem = (id: number) => DELETE('/app-api/demo/delete?id=:id',
 
 | 接口 | 参数 | 返回值 | 说明 |
 | --- | --- | --- | --- |
-| `sendSmsCode(data)` | `data: Record<string, any>` | `Promise<ApiResponse>` | 发送短信验证码。 |
-| `getTencentToken(data?)` | `data?: Record<string, any>` | `Promise<ApiResponse<TencentToken>>` | 获取腾讯云上传临时 Token。 |
 | `getLastVersion(data?)` | `data?: Record<string, any>` | `Promise<ApiResponse<AppVersion>>` | 获取最新版本。 |
-| `getCosUrls(data)` | `data: { urls: string[] }` | `Promise<ApiResponse<string[]>>` | 获取 COS 签名后的访问地址。 |
 | `postRefreshToken(data)` | `data: { refreshToken: string }` | `Promise<ApiResponse<LoginToken>>` | 刷新登录 token。 |
 | `getDictData(data)` | `data: { type: string }` | `Promise<ApiResponse<DictItem[]>>` | 按字典类型获取字典数据。 |
 | `getAppData(data)` | `data: { appId: string }` | `Promise<ApiResponse<AppDetail>>` | 获取应用详情（未登录）。 |
@@ -65,20 +62,14 @@ export const removeItem = (id: number) => DELETE('/app-api/demo/delete?id=:id',
 
 ```ts
 import {
-  sendSmsCode,
-  getTencentToken,
   getLastVersion,
-  getCosUrls,
   postRefreshToken,
   getDictData,
   getAppData,
   getAppByUser,
 } from '@zfqh/uniapp/lib/apis';
 
-await sendSmsCode({ phone: '13800138000' });
-await getTencentToken();
 await getLastVersion({ version: '1.0.0', packageName: 'uni.UNI07DD08D', type: 2, platform: 1 });
-await getCosUrls({ urls: ['/report/demo.pdf'] });
 await postRefreshToken({ refreshToken: 'refresh-token' });
 await getDictData({ type: 'group_relation' });
 await getAppData({ appId: 'com.qihuangai.patient' });

package/docs/api/configs/index.md

@@ -259,15 +259,16 @@ defineConfig({
 
 ## upload
 
-COS 上传依赖 `upload.request` 获取临时凭证：
+COS 上传依赖 `upload.request` 获取临时凭证，该请求由业务实现（包内不再内置凭证接口）：
 
 ```ts
-import { getTencentToken } from '@zfqh/uniapp/lib/apis';
+import { GET } from '@zfqh/uniapp/lib/apis';
 
 defineConfig({
   upload: {
     async request() {
-      const { data } = await getTencentToken();
+      // 替换为业务后端临时凭证接口
+      const { data } = await GET('/api/upload-token');
       return {
         secret_id: data.tmpSecretId,
         secret_key: data.tmpSecretKey,
@@ -285,12 +286,13 @@ defineConfig({
 如果业务需要腾讯云全球加速，可以按项目状态动态改写 `region`：
 
 ```ts
-import { getTencentToken } from '@zfqh/uniapp/lib/apis';
+import { GET } from '@zfqh/uniapp/lib/apis';
 
 defineConfig({
   upload: {
     async request() {
-      const { data } = await getTencentToken();
+      // 替换为业务后端临时凭证接口
+      const { data } = await GET('/api/upload-token');
       return {
         secret_id: data.tmpSecretId,
         secret_key: data.tmpSecretKey,
@@ -305,7 +307,7 @@ defineConfig({
 });
 ```
 
-`getTencentToken` 是 `@zfqh/uniapp/lib/apis` 内置的 COS 临时密钥接口，对应 `/app-api/infra/file/getTencentToken`。如果业务项目使用自己的接口，可替换请求函数，但需要返回下方字段。
+`upload.request` 必须由业务实现并返回下方字段；示例中的 `/api/upload-token` 仅为占位，请替换为实际后端临时凭证接口。
 
 返回数据需要包含：
 

package/docs/api/configs/upload.md

@@ -1,39 +1,48 @@
-# upload
-
-上传配置。发布路径：`@zfqh/uniapp/lib/configs/upload`
-
-| 字段 | 类型 | 默认值 | 说明 |
-| --- | --- | --- | --- |
-| `request(params)` | `function` | 内置调用 `getTencentToken` | 获取上传凭证；COS 上传会以 { mode: "cos" } 调用。 |
-
-COS 上传需要 `request` 返回：
-
-| 字段 | 说明 |
-| --- | --- |
-| `secret_id` | 腾讯云临时密钥 ID，常由后端 `tmpSecretId` 映射而来。 |
-| `secret_key` | 腾讯云临时密钥 Key，常由后端 `tmpSecretKey` 映射而来。 |
-| `session_token` | 临时 token，常由后端 `sessionToken` 映射而来。 |
-| `create_time` | 临时密钥创建时间，常由后端 `createTime` 映射而来。 |
-| `expire_time` | 临时密钥过期时间，常由后端 `expirationTime` 映射而来。 |
-| `bucket` | COS bucket。 |
-| `region` | COS region；如启用全球加速可传 `accelerate`。 |
-
-## 基本使用
-
-默认已内置调用 `getTencentToken` 获取腾讯云临时密钥，通常无需额外配置。如需启用 COS 全球加速，在 cdn 配置中设置 `isAccelerate: true` 即可。
-
-仅当需要完全自定义请求逻辑时才需覆盖 `request`：
-
-```ts
-import { defineConfig } from '@zfqh/uniapp';
-
-defineConfig({
-  upload: {
-    async request() {
-      // 自定义上传凭证逻辑
-      const res = await myCustomApi();
-      return res;
-    },
-  },
-});
-```
+# upload
+
+上传配置。发布路径：`@zfqh/uniapp/lib/configs/upload`
+
+| 字段 | 类型 | 默认值 | 说明 |
+| --- | --- | --- | --- |
+| `request(params)` | `function` | 无（未配置时调用会抛错） | 获取上传凭证；COS 上传会以 { mode: "cos" } 调用。 |
+
+包内不再内置凭证接口，使用 COS 上传前必须由业务配置 `request`。
+
+COS 上传需要 `request` 返回：
+
+| 字段 | 说明 |
+| --- | --- |
+| `secret_id` | 腾讯云临时密钥 ID，常由后端 `tmpSecretId` 映射而来。 |
+| `secret_key` | 腾讯云临时密钥 Key，常由后端 `tmpSecretKey` 映射而来。 |
+| `session_token` | 临时 token，常由后端 `sessionToken` 映射而来。 |
+| `create_time` | 临时密钥创建时间，常由后端 `createTime` 映射而来。 |
+| `expire_time` | 临时密钥过期时间，常由后端 `expirationTime` 映射而来。 |
+| `bucket` | COS bucket。 |
+| `region` | COS region；如启用全球加速可传 `accelerate`。 |
+
+## 基本使用
+
+在 `defineConfig` 中配置 `upload.request`，把业务后端返回的临时凭证映射成上表字段（示例接口 `/api/upload-token` 仅为占位，请替换为实际后端地址）：
+
+```ts
+import { defineConfig } from '@zfqh/uniapp';
+import { GET } from '@zfqh/uniapp/lib/apis';
+
+defineConfig({
+  upload: {
+    async request() {
+      // 替换为你的后端临时凭证接口
+      const { data } = await GET('/api/upload-token');
+      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, // 启用全球加速时可传 'accelerate'
+      };
+    },
+  },
+});
+```

package/docs/api/index.md

@@ -114,7 +114,7 @@ import {
 `@zfqh/uniapp/lib/apis` 当前提供单独的聚合入口，可用于引入业务请求方法和公共接口：
 
 ```ts
-import { GET, POST, getTencentToken } from '@zfqh/uniapp/lib/apis';
+import { GET, POST } from '@zfqh/uniapp/lib/apis';
 ```
 
 ---
@@ -128,14 +128,14 @@ import { GET, POST, getTencentToken } from '@zfqh/uniapp/lib/apis';
 当前 API 聚合入口位于 `lib/apis`，由 `@zfqh/uniapp/lib/apis` 导出 `request` 和 `core`：
 
 ```ts
-import { GET, POST, PUT, DELETE, getTencentToken, getLastVersion, getDictData, getAppData, getAppByUser } from '@zfqh/uniapp/lib/apis';
+import { GET, POST, PUT, DELETE, getLastVersion, getDictData, getAppData, getAppByUser } from '@zfqh/uniapp/lib/apis';
 ```
 
 也可以按文件深度引用：
 
 ```ts
 import request, { GET, POST, PUT, DELETE } from '@zfqh/uniapp/lib/apis/request';
-import { getTencentToken, getCosUrls, getDictData, getAppData, getAppByUser, sendSmsCode, postRefreshToken } from '@zfqh/uniapp/lib/apis/core';
+import { getDictData, getAppData, getAppByUser, postRefreshToken } from '@zfqh/uniapp/lib/apis/core';
 ```
 
 已有 API 文件：
@@ -144,40 +144,28 @@ import { getTencentToken, getCosUrls, getDictData, getAppData, getAppByUser, sen
 | --- | --- |
 | `apis/index` | 聚合导出 `request` 和 `core`。 |
 | `apis/request` | 业务请求实例和 `GET/POST/PUT/DELETE`。 |
-| `apis/core` | 短信验证码、腾讯上传 Token、版本、COS URL、刷新 token、字典数据、应用详情等公共接口。 |
+| `apis/core` | 版本、刷新 token、字典数据、应用详情等公共接口。 |
 
 ### 内置 API 函数示例
 
 ```ts
 import {
   GET, POST,
-  getTencentToken,
   getLastVersion,
   getDictData,
   getAppData,
-  getCosUrls,
-  sendSmsCode,
   postRefreshToken,
 } from '@zfqh/uniapp/lib/apis';
 
 // 获取字典数据
 const dict = await getDictData({ type: 'order_status' });
 
-// 获取 COS 上传临时密钥
-const token = await getTencentToken();
-
 // 获取最新版本
 const version = await getLastVersion({ platform: 'android' });
 
-// 发送短信验证码
-await sendSmsCode({ mobile: '18888888888' });
-
 // 刷新 token
 await postRefreshToken({ refreshToken: 'xxx' });
 
-// 获取 COS 签名地址
-const urls = await getCosUrls({ keys: ['avatar/1.png'] });
-
 // 获取应用详情（未登录）
 const appDetail = await getAppData({ appId: 'com.qihuangai.patient' });
 

package/docs/api/utils/cos.md

@@ -8,9 +8,9 @@
 
 ## 平台兼容性
 
-| App | H5 | 微信小程序 | 其他小程序 | WebView |
-| --- | --- | --- | --- | --- |
-| √ | √ | √ | 视平台 API 而定 | 视运行容器而定 |
+| App | H5  | 微信小程序 | 其他小程序      | WebView                                                            |
+| --- | --- | ---------- | --------------- | ------------------------------------------------------------------ |
+| √   | √   | √          | 视平台 API 而定 | 宿主注入 `plus.uploader` 时优先 HTML5+ 上传，否则 `uni.uploadFile` |
 
 ## 基本使用
 
@@ -38,18 +38,28 @@ const { url } = await cos.uploadFile(file, { key: 'avatar/user-1.png' });
 
 `uploadFile` 支持多种文件来源：
 
-| 来源 | 字段 |
-| --- | --- |
-| `uni.chooseImage` 的 `tempFiles` | 直接传入 `res.tempFiles[0]`（推荐） |
-| 临时路径对象 | `{ path: '...' }` |
-| H5 File 对象 | 直接传入 File |
-| 自定义文件名 | `{ name: 'photo.jpg', path: '...' }` |
+| 来源                             | 字段                                 |
+| -------------------------------- | ------------------------------------ |
+| `uni.chooseImage` 的 `tempFiles` | 直接传入 `res.tempFiles[0]`（推荐）  |
+| 临时路径对象                     | `{ path: '...' }`                    |
+| H5 File 对象                     | 直接传入 File                        |
+| 自定义文件名                     | `{ name: 'photo.jpg', path: '...' }` |
 
 未指定 `key` 时会自动生成：`<path><yyyymmdd>/<hhMMss><guid>.<ext>`（`yyyymmdd` 用于按日期分目录，`hhMMss` 便于看出日内上传先后）
 
+## 宿主 web-view 内上传
+
+H5 页面被宿主 App 的 `web-view` 嵌入时，如果宿主注入了 HTML5+ 能力，`uploadFile` 会自动优先使用 `plus.uploader` 上传本地文件，业务侧调用方式不变：
+
+- 触发条件：`IS_WEBVIEW_ENV` 为 true（宿主按仓库既有约定标记 webview 环境），且 `plus.uploader` 可用；
+- 仅 `file.path` 为非空字符串时走 plus；满足条件后固定走 `plus.uploader`，不再回退 `uni.uploadFile`；
+- H5 `File` 对象（无 `path`）仍走 `uni.uploadFile`；`blob:` / `data:` 等 HTML5+ 不可读路径会直接失败（reject `{ msg: 'uploadFile:fail' }`）；
+- 普通 H5 浏览器没有 `plus`，不受影响；
+- 走 `plus.uploader` 时，`getTask` 收到的是含 `abort` / `onProgressUpdate` / `offProgressUpdate` 的适配对象（不是原生 `UploadTask`），失败错误带 `code` 字段。
+
 ## 取消上传
 
-传入 `getTask` 可以拿到 `uni.uploadFile` 返回的 `UploadTask` 实例，需要时调用 `task.abort()` 取消本次上传：
+传入 `getTask` 可以拿到上传任务实例，需要时调用 `task.abort()` 取消本次上传：
 
 ```ts
 import { cos } from '@zfqh/uniapp';
@@ -85,12 +95,13 @@ cos.uploadFile({
 
 ### 注意事项
 
-- `getTask` 在**每次** `uni.uploadFile` 调用时都会回调。token 过期（`ExpiredToken`）触发内部重试时会创建新的 task 并再次回调，因此请始终使用**最近一次**回调收到的 task，不要缓存第一次的。
-- 取消会让该次上传的 Promise reject，但各端错误文案不一致：H5 为 `uploadFile:fail abort`，App 为 `uploadFile:fail statusCode: 0`（**不含 `abort` 字样**），微信小程序通常为 `uploadFile:fail abort`。请不要通过匹配错误文案判断是否被取消。
+- `getTask` 在**每次**上传调用时都会回调。token 过期（`ExpiredToken`）触发内部重试时会创建新的 task 并再次回调，因此请始终使用**最近一次**回调收到的 task，不要缓存第一次的。
+- H5 宿主 webview 走 `plus.uploader` 时，`getTask` 收到的是含 `abort` / `onProgressUpdate` / `offProgressUpdate` 的适配对象；进度事件结构为 `{ progress, totalBytesSent, totalBytesExpectedToSend }`，Android 未启用分块上传时进度粒度较粗。
+- 取消会让该次上传的 Promise reject，但各端错误文案不一致：H5 为 `uploadFile:fail abort`，App 为 `uploadFile:fail statusCode: 0`（**不含 `abort` 字样**），微信小程序通常为 `uploadFile:fail abort`。H5 宿主 webview 走 `plus.uploader` 时同样 reject `{ msg: 'uploadFile:fail abort' }`。请不要通过匹配错误文案判断是否被取消。
 - App 端调用 `abort()` 后不保证触发 `fail` 回调，Promise 可能一直 pending，取消后的 UI 状态需要业务自行切换。
 - 取消支持的范围为 App / H5 / 微信小程序。支付宝小程序 `my.uploadFile` 的 `abort` 需要传参对象，无参 `abort()` 可能无效。
 - 上传已完成后再调用 `abort()` 是空操作。
-- H5 端请勿调用 `task.onHeadersReceived` / `task.offHeadersReceived`（H5 实现为直接抛错）。
+- H5 端请勿调用 `task.onHeadersReceived` / `task.offHeadersReceived`（H5 实现为直接抛错）；`plus.uploader` 适配对象不提供这两个方法。
 
 ## 完整上传流程
 
@@ -172,19 +183,19 @@ await checkRefreshToken();
 
 发布路径：`@zfqh/uniapp/lib/utils/cos`
 
-| 名称 | 签名/声明 | 说明 |
-| --- | --- | --- |
-| `checkRefreshToken` | `export async function checkRefreshToken(): Promise<boolean> {` | 调用 upload.request({ mode: "cos" }) 获取并缓存 COS 临时密钥；1 秒内并发上传复用同一个请求。 |
-| `uploadFile` | `export async function uploadFile(file: any, opts: UploadFileOptions = {}): Promise<{ url: string }> {` | 上传文件到腾讯 COS，自动生成 key、刷新过期 token，并返回 https url。 |
+| 名称                | 签名/声明                                                                                               | 说明                                                                                                                                                                                               |
+| ------------------- | ------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `checkRefreshToken` | `export async function checkRefreshToken(): Promise<boolean> {`                                         | 调用 upload.request({ mode: "cos" }) 获取并缓存 COS 临时密钥；1 秒内并发上传复用同一个请求。                                                                                                       |
+| `uploadFile`        | `export async function uploadFile(file: any, opts: UploadFileOptions = {}): Promise<{ url: string }> {` | 上传文件到腾讯 COS，自动生成 key、刷新过期 token，并返回 https url。HTTP 非 200 或网络失败时 reject `{ code, msg }`（H5 宿主 webview 走 `plus.uploader` 时 `code` 为 HTTP 状态码，网络失败为 0）。 |
 
 `UploadFileOptions` 支持的选项：
 
-| 选项 | 类型 | 说明 |
-| --- | --- | --- |
-| `path` | `string` | key 前缀（子目录），如 `'avatar/'`。 |
-| `key` | `string` | 完整 key，传入时忽略自动生成的 key。 |
-| `getTask` | `(task: UniNamespace.UploadTask) => void` | 获取本次上传的 `UploadTask`，可用 `task.abort()` 取消。每次上传尝试（含 token 过期重试）都会回调。 |
-| `cosCompress` | `export function cosCompress(url: string, rule: string, type?: string): string {` | 基于腾讯云 COS `imageMogr2` 拼接图片压缩 URL。`rule` 为尺寸规则（如 `'200x'`、`'200x200'`），`type` 可选 `'cut'`（裁剪）或默认（缩放）。 |
+| 选项          | 类型                                                                              | 说明                                                                                                                                                                                                   |
+| ------------- | --------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `path`        | `string`                                                                          | key 前缀（子目录），如 `'avatar/'`。                                                                                                                                                                   |
+| `key`         | `string`                                                                          | 完整 key，传入时忽略自动生成的 key。                                                                                                                                                                   |
+| `getTask`     | `(task: UniNamespace.UploadTask) => void`                                         | 获取本次上传的任务实例，可用 `task.abort()` 取消。H5 宿主 webview 走 `plus.uploader` 时为含 `abort` / `onProgressUpdate` / `offProgressUpdate` 的适配对象。每次上传尝试（含 token 过期重试）都会回调。 |
+| `cosCompress` | `export function cosCompress(url: string, rule: string, type?: string): string {` | 基于腾讯云 COS `imageMogr2` 拼接图片压缩 URL。`rule` 为尺寸规则（如 `'200x'`、`'200x200'`），`type` 可选 `'cut'`（裁剪）或默认（缩放）。                                                               |
 
 `cosCompress` 常用示例：
 
@@ -230,16 +241,17 @@ const { url } = await cos.uploadFile(file, {
 config.upload.request({ mode: 'cos' });
 ```
 
-需要在 `defineConfig` 中配置：
+需要在 `defineConfig` 中配置（`upload.request` 由业务实现，包内不再内置凭证接口）：
 
 ```ts
 import { defineConfig } from '@zfqh/uniapp';
-import { getTencentToken } from '@zfqh/uniapp/lib/apis';
+import { GET } from '@zfqh/uniapp/lib/apis';
 
 defineConfig({
   upload: {
     async request() {
-      const { data } = await getTencentToken();
+      // 替换为业务后端临时凭证接口
+      const { data } = await GET('/api/upload-token');
       return {
         secret_id: data.tmpSecretId,
         secret_key: data.tmpSecretKey,
@@ -257,12 +269,13 @@ defineConfig({
 门店端如果需要全球加速，可根据业务 store 改写 `region`：
 
 ```ts
-import { getTencentToken } from '@zfqh/uniapp/lib/apis';
+import { GET } from '@zfqh/uniapp/lib/apis';
 
 defineConfig({
   upload: {
     async request() {
-      const { data } = await getTencentToken();
+      // 替换为业务后端临时凭证接口
+      const { data } = await GET('/api/upload-token');
       return {
         secret_id: data.tmpSecretId,
         secret_key: data.tmpSecretKey,
@@ -277,28 +290,28 @@ defineConfig({
 });
 ```
 
-`getTencentToken` 是内置业务接口，来自 `@zfqh/uniapp/lib/apis`，路径为 `/app-api/infra/file/getTencentToken`。如果项目有自定义接口，可以替换请求函数，但必须把响应字段映射成下方 COS 字段。
+`upload.request` 必须由业务实现并映射成下方 COS 字段；示例中的 `/api/upload-token` 仅为占位，请替换为实际后端临时凭证接口。
 
 返回字段：
 
-| 字段 | 说明 |
-| --- | --- |
-| `secret_id` | 临时密钥 ID。 |
-| `secret_key` | 临时密钥 Key。 |
-| `session_token` | 临时 token。 |
-| `bucket` | COS bucket。 |
-| `region` | COS region。 |
-| `create_time` | 创建时间戳，秒。 |
-| `expire_time` | 过期时间戳，秒。 |
+| 字段            | 说明             |
+| --------------- | ---------------- |
+| `secret_id`     | 临时密钥 ID。    |
+| `secret_key`    | 临时密钥 Key。   |
+| `session_token` | 临时 token。     |
+| `bucket`        | COS bucket。     |
+| `region`        | COS region。     |
+| `create_time`   | 创建时间戳，秒。 |
+| `expire_time`   | 过期时间戳，秒。 |
 
 ## 上传文件对象
 
 `uploadFile` 支持：
 
-| 来源 | 字段 |
-| --- | --- |
-| uni 选择文件 | `file.path` |
-| H5 File 对象 | `file` |
+| 来源         | 字段                       |
+| ------------ | -------------------------- |
+| uni 选择文件 | `file.path`                |
+| H5 File 对象 | `file`                     |
 | 自定义文件名 | `file.name` 用于推断扩展名 |
 
 未指定 `key` 时会自动生成：

package/docs/guide/getting-started.md

@@ -84,7 +84,7 @@ import pages from 'virtual:remove-json-comments@/pages.json';
 // #ifndef H5
 import pages from '@/pages.json';
 // #endif
-import { getTencentToken } from '@zfqh/uniapp/lib/apis';
+import { GET } from '@zfqh/uniapp/lib/apis';
 
 defineConfig({
   app: {
@@ -103,7 +103,8 @@ defineConfig({
   },
   upload: {
     async request() {
-      const { data } = await getTencentToken();
+      // 替换为业务后端临时凭证接口
+      const { data } = await GET('/api/upload-token');
       return {
         secret_id: data.tmpSecretId,
         secret_key: data.tmpSecretKey,
@@ -122,7 +123,7 @@ defineConfig({
 
 ```ts
 import { defineConfig } from '@zfqh/uniapp';
-import { getTencentToken } from '@zfqh/uniapp/lib/apis';
+import { GET } from '@zfqh/uniapp/lib/apis';
 
 defineConfig({
   app: {
@@ -142,7 +143,8 @@ defineConfig({
   },
   upload: {
     async request() {
-      const { data } = await getTencentToken();
+      // 替换为业务后端临时凭证接口
+      const { data } = await GET('/api/upload-token');
       return {
         secret_id: data.tmpSecretId,
         secret_key: data.tmpSecretKey,
@@ -164,7 +166,7 @@ defineConfig({
 - H5 端如果 `pages.json` 带注释，可通过 `virtual:remove-json-comments@/pages.json` 导入；其他端直接导入 `@/pages.json`。
 - `path.index`、`path.login`、`path.webview` 是导航、登录拦截和 webview 承载页的核心别名。
 - `upload.request` 需要把业务接口返回的腾讯云字段映射成 `secret_id`、`secret_key`、`session_token`、`bucket`、`region` 等字段。
-- `getTencentToken` 已内置在 `@zfqh/uniapp/lib/apis`，如果项目使用不同接口，可替换成自己的请求函数，但返回字段仍需映射成 COS 工具需要的字段名。
+- 包内不再内置上传凭证接口，`upload.request` 必须由业务实现；示例中的 `/api/upload-token` 仅为占位，请替换为实际后端临时凭证接口。
 
 多环境配置建议放到 `env/.env.dev.ts`、`env/.env.prod.ts`，详见 [环境配置](../api/configs/env.md)。
 

package/docs/guide/project-frame.md

@@ -70,7 +70,7 @@ import pages from 'virtual:remove-json-comments@/pages.json';
 // #ifndef H5
 import pages from '@/pages.json';
 // #endif
-import { getTencentToken } from '@zfqh/uniapp/lib/apis';
+import { GET } from '@zfqh/uniapp/lib/apis';
 
 defineConfig({
   app: {
@@ -89,7 +89,8 @@ defineConfig({
   },
   upload: {
     async request() {
-      const { data } = await getTencentToken();
+      // 替换为业务后端临时凭证接口
+      const { data } = await GET('/api/upload-token');
       return {
         secret_id: data.tmpSecretId,
         secret_key: data.tmpSecretKey,
@@ -108,7 +109,7 @@ defineConfig({
 
 ```ts
 import { defineConfig } from '@zfqh/uniapp';
-import { getTencentToken } from '@zfqh/uniapp/lib/apis';
+import { GET } from '@zfqh/uniapp/lib/apis';
 
 defineConfig({
   app: {
@@ -128,7 +129,8 @@ defineConfig({
   },
   upload: {
     async request() {
-      const { data } = await getTencentToken();
+      // 替换为业务后端临时凭证接口
+      const { data } = await GET('/api/upload-token');
       return {
         secret_id: data.tmpSecretId,
         secret_key: data.tmpSecretKey,
@@ -149,7 +151,7 @@ defineConfig({
 - 推荐用 `createPages(pages)` 从 `pages.json` 自动生成页面集合，减少手写 `needLoginPages`、`tabBarPages` 的维护成本。
 - `path.index`、`path.login`、`path.webview` 分别影响首页、登录拦截和 webview 承载页。
 - `upload.request` 需要把后端字段映射成 COS 上传工具需要的字段名。
-- 内置 COS 临时密钥接口为 `@zfqh/uniapp/lib/apis` 的 `getTencentToken`；如后端接口不同，可以替换请求函数，但返回给 `upload.request` 的字段名需要保持一致。
+- 包内不再内置上传凭证接口，`upload.request` 必须由业务实现；示例中的 `/api/upload-token` 仅为占位，请替换为实际后端临时凭证接口。
 
 ## Vite 配置
 

package/lib/apis/core.d.ts

@@ -1,11 +1,5 @@
-/** 发送短信验证码 */
-export declare const sendSmsCode: (...args: any[]) => any;
-/** 获取腾讯上传临时Token */
-export declare const getTencentToken: (...args: any[]) => any;
 /** 获取最新版本 */
 export declare const getLastVersion: (...args: any[]) => any;
-/** 获取cos签名后的地址 */
-export declare const getCosUrls: (...args: any[]) => any;
 /** 刷新token */
 export declare const postRefreshToken: (...args: any[]) => any;
 /** 获取字典数据 */