@zfqh/uniapp 0.1.5 → 0.1.7

package/CHANGELOG.md

@@ -3,6 +3,22 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [0.1.7](http://10.10.10.16/caoben/front-end/compare/@zfqh/uniapp@0.1.6...@zfqh/uniapp@0.1.7) (2026-06-19)
+
+**Note:** Version bump only for package @zfqh/uniapp
+
+
+
+
+
+## [0.1.6](http://10.10.10.16/caoben/front-end/compare/@zfqh/uniapp@0.1.5...@zfqh/uniapp@0.1.6) (2026-06-18)
+
+**Note:** Version bump only for package @zfqh/uniapp
+
+
+
+
+
 ## [0.1.5](http://10.10.10.16/caoben/front-end/compare/@zfqh/uniapp@0.1.4...@zfqh/uniapp@0.1.5) (2026-06-15)
 
 **Note:** Version bump only for package @zfqh/uniapp

package/docs/api/apis/request.md

@@ -26,7 +26,7 @@ const request = uni.$uv.http;
 
 | Header | 来源 | 默认值 |
 | --- | --- | --- |
-| `Authorization` | `store.state.login.info.token` | 无 |
+| `Authorization` | `store.state.login.info.accessToken` | 无 |
 | `Tenant-Id` | `store.state.login.info.tenantId` | `1` |
 | `X-Language` | `store.state.system.info.appLanguage` 映射到 `LANGUAGE` | 无 |
 | `Channel` | `query.channel` 或 `config.app.channel` | `config.app.channel` |
@@ -274,7 +274,7 @@ GET('/app-api/demo/check', {}, {
 | 阶段 | 行为 |
 | --- | --- |
 | request | 当 `log.request` 为 true 时打印请求 URL 和配置。 |
-| request | 如果存在 `store.state.login.info.token`，注入 `Authorization: Bearer <token>`。 |
+| request | 如果存在 `store.state.login.info.accessToken`，注入 `Authorization: Bearer <accessToken>`。 |
 | response | 当 `log.response` 为 true 时打印响应数据。 |
 | response | 当 `data.code != 0` 时将其作为错误响应处理。 |
 | error | 补齐非标准错误的 `response`、`status`、`data.msg`。 |
@@ -283,7 +283,7 @@ GET('/app-api/demo/check', {}, {
 `401` 处理依赖：
 
 ```ts
-store.state.login.info.token
+store.state.login.info.accessToken
 store.dispatch('logout')
 ```
 
@@ -293,7 +293,7 @@ store.dispatch('logout')
 import { useStore } from 'vuex';
 
 const store = useStore();
-const token = store.state.login.info.token;
+const accessToken = store.state.login.info.accessToken;
 ```
 
 可通过请求自定义配置关闭：

package/docs/api/modules/login.md

@@ -4,19 +4,19 @@
 
 | 项 | 说明 |
 | --- | --- |
-| `state.info` | 登录信息，包含 token、refreshToken、expiresTime、phone、userId、tenantId、storeId 等。 |
-| `getter isLogin` | Boolean(state.info.token)。 |
-| `mutation setLoginInfo(data)` | 去掉 token 中 bearer 前缀后合并并缓存。 |
+| `state.info` | 登录信息，包含 accessToken、refreshToken、expiresTime、phone、userId、tenantId、storeId 等。 |
+| `getter isLogin` | Boolean(state.info.accessToken)。 |
+| `mutation setLoginInfo(data)` | 去掉 accessToken 中 bearer 前缀后合并并缓存。 |
 | `mutation resetState()` | 重置登录信息并删除缓存。 |
 | `action logout(reLaunch)` | 节流退出；reLaunch 为 true 时重启到登录页，否则走 navigate 登录拦截。 |
 
 ## 基本使用
 
-登录成功后写入 token、用户和租户信息；请求拦截器会从该模块注入请求头。
+登录成功后写入 accessToken、用户和租户信息；请求拦截器会从该模块注入请求头。
 
 ```ts
 store.commit('setLoginInfo', {
-  token: loginResult.accessToken,
+  accessToken: loginResult.accessToken,
   refreshToken: loginResult.refreshToken,
   userId: loginResult.userId,
   tenantId: loginResult.tenantId,
@@ -26,7 +26,7 @@ store.commit('setLoginInfo', {
 const isLogin = store.getters.isLogin;
 
 // 读取登录信息
-const token = store.state.login.info.token;
+const accessToken = store.state.login.info.accessToken;
 const userId = store.state.login.info.userId;
 const tenantId = store.state.login.info.tenantId;
 

package/docs/api/utils/message.md

@@ -30,7 +30,7 @@ import { TYPES } from '@zfqh/uniapp/lib/utils/message';
 
 | 名称 | 说明 |
 | --- | --- |
-| `TYPES.LOGIN` | 登录消息，payload 包含 `token` 和 `referrer` |
+| `TYPES.LOGIN` | 登录消息，payload 包含 `accessToken` 和 `referrer` |
 | `TYPES.SHARE_PAGE` | 分享页面 |
 | `TYPES.GET_LOCATION` | 获取定位，宿主调用 `uni.getLocation` 后回传结果 |
 | `TYPES.OPEN_LOCATION` | 打开地图，宿主调用 `uni.openLocation` 后回传结果 |

package/docs/api/utils/query.md

@@ -28,7 +28,7 @@ import { query } from '@zfqh/uniapp';
 import { query } from '@zfqh/uniapp';
 
 // 访问 query 参数
-console.log(query.token);     // URL 中的 token 参数
+console.log(query.accessToken); // URL 中的 accessToken 参数（兼容 token）
 console.log(query.channel);   // 渠道参数
 console.log(query.platform);  // 平台参数
 ```
@@ -38,7 +38,8 @@ console.log(query.platform);  // 平台参数
 | 属性 | 类型 | 说明 |
 | --- | --- | --- |
 | `platform` | `string` | 平台标识 |
-| `token` | `string` | H5 端 URL 传入的 token |
+| `token` | `string` | H5 端 URL 传入的 token（向后兼容） |
+| `accessToken` | `string` | H5 端 URL 传入的 accessToken（优先于 token） |
 | `primary` | `string` | 主题色覆盖 |
 | `brand` | `string` | 品牌标识 |
 | `app` | `string` | 应用标识 |
@@ -67,9 +68,10 @@ parseQuery('name=%E5%BC%A0%E4%B8%89'); // { name: '张三' }
 ```ts
 import { query, navigate } from '@zfqh/uniapp';
 
-// H5 端通过 URL 传入 token 自动登录
-if (query.token) {
-  store.commit('setLoginInfo', { token: query.token });
+// H5 端通过 URL 传入 token 自动登录（accessToken 优先，兼容 token）
+const queryToken = query.accessToken || query.token;
+if (queryToken) {
+  store.commit('setLoginInfo', { accessToken: queryToken });
 }
 
 // 根据渠道参数决定跳转目标

package/docs/api/utils/request.md

@@ -4,7 +4,7 @@
 `@zfqh/uniapp/lib/utils/request`
 :::
 
-创建请求方法并安装通用拦截器，处理动态 URL、token、错误、401 退出登录。
+创建请求方法并安装通用拦截器，处理动态 URL、accessToken、错误、401 退出登录。
 
 ## 平台兼容性
 
@@ -18,7 +18,7 @@
 import { formatURL, createInterceptors, createRequest } from '@zfqh/uniapp';
 ```
 
-请求工具脱离组件 setup 上下文，拦截器内部会从 store 中读取 token 并处理 `401`。组件或 hooks 中读取 store 时请使用 `useStore()`。
+请求工具脱离组件 setup 上下文，拦截器内部会从 store 中读取 accessToken 并处理 `401`。组件或 hooks 中读取 store 时请使用 `useStore()`。
 
 具体方法、参数语义和返回值以发布包类型为准；下方表格按 `@zfqh/uniapp/lib/utils/request` 的导出整理。
 
@@ -29,6 +29,6 @@ import { formatURL, createInterceptors, createRequest } from '@zfqh/uniapp';
 | 名称 | 签名/声明 | 说明 |
 | --- | --- | --- |
 | `formatURL` | `export function formatURL(url, data) {` | 把 /:id 或 :id 动态片段替换为 data 中的值，并删除已消费字段。 |
-| `createInterceptors` | `export function createInterceptors(req) {` | 给请求实例安装统一请求/响应拦截器，注入 token 并处理 code/401/toast/logout。 |
+| `createInterceptors` | `export function createInterceptors(req) {` | 给请求实例安装统一请求/响应拦截器，注入 accessToken 并处理 code/401/toast/logout。 |
 | `createRequest` | `export function createRequest(req, opts = {}) {` | 基于请求实例生成 GET、DELETE、POST、PUT 方法。 |
 

package/docs/api/utils/storage.md

@@ -27,14 +27,14 @@ import { getStorageSync, setStorageSync, removeStorageSync, storageKeys } from '
 例如 `storage.prefix` 为 `'zfqh'`，当前环境为 `sit`：
 
 ```ts
-setStorageSync('login', { token: 'xxx' });
+setStorageSync('login', { accessToken: 'xxx' });
 // 实际存储 key: 'ZFQH_SIT_LOGIN'
 ```
 
 生产环境不拼接环境名：
 
 ```ts
-setStorageSync('login', { token: 'xxx' });
+setStorageSync('login', { accessToken: 'xxx' });
 // 实际存储 key: 'ZFQH_LOGIN'
 ```
 
@@ -47,7 +47,7 @@ import { storageKeys } from '@zfqh/uniapp';
 | 属性 | 值 | 用途 |
 | --- | --- | --- |
 | `query` | `'query'` | URL query 参数缓存 |
-| `login` | `'login'` | 登录信息（token、userId 等） |
+| `login` | `'login'` | 登录信息（accessToken、userId 等） |
 | `user` | `'user'` | 用户信息 |
 | `open` | `'open'` | 第三方开放平台信息 |
 | `launch` | `'launch'` | 启动参数 |
@@ -55,7 +55,7 @@ import { storageKeys } from '@zfqh/uniapp';
 
 ```ts
 // 保存登录信息
-setStorageSync(storageKeys.login, { token: 'xxx', userId: 1, tenantId: 1 });
+setStorageSync(storageKeys.login, { accessToken: 'xxx', userId: 1, tenantId: 1 });
 
 // 读取登录信息
 const loginInfo = getStorageSync(storageKeys.login);

package/docs/faq/index.md

@@ -5,7 +5,7 @@
 检查：
 
 1. 是否先注册 store，再注册 `@zfqh/uniapp`。
-2. token 是否位于 `store.state.login.info.token`。
+2. accessToken 是否位于 `store.state.login.info.accessToken`。
 
 请求拦截器属于普通 TS 模块，内部会从 store 中读取状态。组件或 hooks 内读取同一份状态时应使用 `useStore()`。
 
@@ -13,7 +13,7 @@
 
 检查：
 
-1. `store.state.login.info.token` 是否存在。
+1. `store.state.login.info.accessToken` 是否存在。
 2. store 是否实现 `dispatch('logout')`。
 3. 请求配置是否设置了 `custom.reLogin: false` 或 `custom.needLogin: false`。
 

package/docs/guide/project-frame.md

@@ -196,7 +196,7 @@ export default defineConfig({
 
 | 路径 | 用途 |
 | --- | --- |
-| `store.state.login.info.token` | 请求拦截器注入 `Authorization`。 |
+| `store.state.login.info.accessToken` | 请求拦截器注入 `Authorization`。 |
 | `store.state.login.info.tenantId` | 业务请求注入 `Tenant-Id`。 |
 | `store.state.system.info.appLanguage` | 业务请求注入 `X-Language`。 |
 | `store.state.system.info.appVersion` | 非 App 环境下读取版本名。 |
@@ -306,5 +306,5 @@ $uv-primary-disabled: #E8D8C9;
 4. 注册 `@zfqh/uniapp`。
 5. 初始化业务配置、路由守卫或业务模块。
 
-顺序错误最常见的表现是请求不带 token、导航无法判断登录态、`401` 无法自动退出。
+顺序错误最常见的表现是请求不带 accessToken、导航无法判断登录态、`401` 无法自动退出。
 

package/docs/index.md

@@ -74,7 +74,7 @@ export function createApp() {
 
 ## 使用约定
 
-- 项目需要提供符合约定的 Vuex store：请求读取 `store.state.login.info.token`，导航读取 `store.getters.isLogin`，`401` 会触发 `store.dispatch('logout')`。
+- 项目需要提供符合约定的 Vuex store：请求读取 `store.state.login.info.accessToken`，导航读取 `store.getters.isLogin`，`401` 会触发 `store.dispatch('logout')`。
 - Store 入口按上下文区分：组件的 Composition API 中使用 `import { useStore } from 'vuex'`，Options API 组件中使用 `this.$store`，普通 TS 模块中使用 `uni.$store`。
 - 多环境配置推荐使用 `@env/.env.<env>.ts`，并通过 `defineEnvConfig` 输出配置。
 - 根入口未导出的 `apis`、`modules`、`mixins` 请按 [深度引用](./api/index.md#深度引用) 从构建产物路径引入。

package/lib/mixins/login.js

@@ -12,7 +12,7 @@ export default {
         if (uni.showAppFromBackground) {
             // #ifdef H5
             // 防止登录后，返回webview页面再次跳转登录页面
-            if (IS_WEBVIEW_ENV && this.$store.state.login?.info?.token == null) {
+            if (IS_WEBVIEW_ENV && this.$store.state.login?.info?.accessToken == null) {
                 return;
             }
             // #endif

package/lib/mixins/redirect.js

@@ -64,13 +64,13 @@ export default {
                 }
                 // #endif
                 // #ifndef MP
-                const { token = '' } = this.loginInfo;
+                const { accessToken = '' } = this.loginInfo;
                 const [, path] = url.split('?');
                 const { url: _url } = parse(path, { decoder: (str) => str });
                 this.postMessage({
                     type: TYPES.LOGIN,
                     payload: {
-                        token,
+                        accessToken,
                         referrer: decodeURIComponent(_url),
                     },
                 });

package/lib/mixins/webview.js

@@ -32,7 +32,7 @@ export default {
             const { loginInfo, queryInfo, appInfo } = this;
             const query = {
                 ...queryInfo,
-                token: loginInfo.token || '',
+                token: loginInfo.accessToken || '',
                 brand: appInfo.brand?.code || '',
                 app: appInfo.app?.code || '',
                 platform: PLATFORM_CODE,

package/lib/modules/login.js

@@ -5,17 +5,18 @@ import Throttle from '../utils/throttle';
 import { getPage } from '../utils/pages';
 const throttle = new Throttle();
 // #ifdef H5
-if (query.token != null) {
+const queryToken = query.accessToken || query.token;
+if (queryToken != null) {
     const store = getStorageSync(storageKeys.login) || {};
-    if (query.token !== store.token) {
-        store.token = query.token;
+    if (queryToken !== store.accessToken) {
+        store.accessToken = queryToken;
         setStorageSync(storageKeys.login, store);
     }
 }
 // #endif
 function getDefaultState() {
     return {
-        token: null,
+        accessToken: null,
         refreshToken: '',
         expiresTime: 0,
         phone: '',
@@ -37,13 +38,13 @@ const store = {
     getters: {
         // 是否已登录
         isLogin(state) {
-            return Boolean(state.info.token);
+            return Boolean(state.info.accessToken);
         },
     },
     mutations: {
         setLoginInfo(state, data) {
-            if (data.token) {
-                data.token = data.token.replace(/^bearer\s+/i, '');
+            if (data.accessToken) {
+                data.accessToken = data.accessToken.replace(/^bearer\s+/i, '');
             }
             state.info = { ...state.info, ...data };
             setStorage(storageKeys.login, state.info);

package/lib/utils/consts.d.ts

@@ -24,7 +24,8 @@ export declare enum MP_ENV_VERSION {
 export declare const LANGUAGE: {
     'zh-Hans': string;
     'zh-Hant': string;
-    'ja-JP': string;
+    ja: string;
     en: string;
     fr: string;
+    es: string;
 };

package/lib/utils/consts.js

@@ -46,7 +46,8 @@ export var MP_ENV_VERSION;
 export const LANGUAGE = {
     'zh-Hans': 'zh-CN',
     'zh-Hant': 'zh-TW',
-    'ja-JP': 'ja-JP',
+    ja: 'ja-JP',
     en: 'en-US',
     fr: 'fr-FR',
+    es: 'es-ES',
 };

package/lib/utils/message.js

@@ -11,15 +11,15 @@ Object.keys(TYPES).forEach((key) => {
     TYPES[key] = key;
 });
 // #ifdef H5
-window.onmessage = (e) => {
+window.addEventListener('message', (e) => {
     try {
         if (e.data.type === 'WEBVIEW_MESSAGE') {
             uni.$emit('WEBVIEW_MESSAGE', e.data.data);
             const { type, payload } = e.data.data;
             switch (type) {
                 case TYPES.LOGIN: {
-                    const { token, referrer } = payload;
-                    uni.$store.commit('setLoginInfo', { token });
+                    const { accessToken, referrer } = payload;
+                    uni.$store.commit('setLoginInfo', { accessToken });
                     uni.$store.dispatch('getInfo');
                     if (referrer) {
                         // 必须使用reLaunch，否则跳转可能无效
@@ -59,5 +59,5 @@ window.onmessage = (e) => {
         }
     }
     catch (e) { }
-};
+});
 // #endif

package/lib/utils/query.d.ts

@@ -1,6 +1,7 @@
 interface Query {
     platform?: string;
     token?: string;
+    accessToken?: string;
     primary?: string;
     brand?: string;
     app?: string;

package/lib/utils/request.js

@@ -29,7 +29,7 @@ function responseReject(response) {
         const { reLogin, needLogin } = config?.custom || {};
         if (reLogin !== false && needLogin !== false && uni.$store != null) {
             throttle.exec(() => {
-                if (uni.$store.state.login?.info?.token != null) {
+                if (uni.$store.state.login?.info?.accessToken != null) {
                     const { message, msg } = data;
                     if (message || msg) {
                         toast.message(message || msg);
@@ -58,9 +58,9 @@ export function createInterceptors(req) {
         const header = {};
         if (uni.$store) {
             const loginInfo = uni.$store.state.login?.info;
-            const { token } = loginInfo || {};
-            if (token) {
-                header.Authorization = `Bearer ${token}`;
+            const { accessToken } = loginInfo || {};
+            if (accessToken) {
+                header.Authorization = `Bearer ${accessToken}`;
             }
         }
         config.header = {

package/lib/utils/uni.js

@@ -6,7 +6,6 @@ import { brand } from '../configs/brand';
 import mp from '../configs/mp';
 import color from '../configs/color';
 import { IS_WEBVIEW_ENV, SYSTEM_INFO } from './consts';
-import { getPage } from './pages';
 import query from './query';
 // #ifndef H5
 uni.webView = uni;
@@ -50,13 +49,6 @@ uni.navigateBack = (options = {}) => {
         // webview内没有上页，则触发原生返回
         uni.webView?.navigateBack(options);
     }
-    else if (!IS_WEBVIEW_ENV &&
-        ((length > 1 && delta >= length) || (length === 1 && !getPage('index')?.includes(pages[0].route)))) {
-        // 非首页返回则跳转到首页
-        uni.reLaunch({
-            url: getPage('index'),
-        });
-    }
     else {
         navigateBack(options);
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zfqh/uniapp",
-  "version": "0.1.5",
+  "version": "0.1.7",
   "description": "uniapp公共模块",
   "author": "yinjiazeng@163.com",
   "license": "MIT",