@zfqh/uniapp 0.1.2 → 0.1.3

package/docs/api/apis/index.md

@@ -28,7 +28,7 @@ import { getTencentToken, getDictData } from '@zfqh/uniapp/lib/apis/core';
 - `GET` 会把 data 作为 query params。
 - `POST`、`PUT`、`DELETE` 会把 data 作为请求体或方法参数传给底层请求实例。
 - URL 中的 `:id`、`/:id` 会由 `formatURL` 使用 data 同名字段替换，并从 data 中删除该字段。
-- 响应拦截器要求后端成功码为 `code == 0`；失败时会按配置弹 toast，并在 401 时触发 `uni.$store.dispatch('logout')`。
+- 响应拦截器要求后端成功码为 `code == 0`；失败时会按配置弹 toast，并在 401 时触发 `store.dispatch('logout')`。
 
 ## 接口清单
 

package/docs/api/apis/request.md

@@ -26,9 +26,9 @@ const request = uni.$uv.http;
 
 | Header | 来源 | 默认值 |
 | --- | --- | --- |
-| `Authorization` | `uni.$store.state.login.info.token` | 无 |
-| `Tenant-Id` | `uni.$store.state.login.info.tenantId` | `1` |
-| `X-Language` | `uni.$store.state.system.info.appLanguage` 映射到 `LANGUAGE` | 无 |
+| `Authorization` | `store.state.login.info.token` | 无 |
+| `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` |
 
 业务请求的 `baseURL` 来自 `config.api.baseUrl`。
@@ -274,7 +274,7 @@ GET('/app-api/demo/check', {}, {
 | 阶段 | 行为 |
 | --- | --- |
 | request | 当 `log.request` 为 true 时打印请求 URL 和配置。 |
-| request | 如果存在 `uni.$store.state.login.info.token`，注入 `Authorization: Bearer <token>`。 |
+| request | 如果存在 `store.state.login.info.token`，注入 `Authorization: Bearer <token>`。 |
 | response | 当 `log.response` 为 true 时打印响应数据。 |
 | response | 当 `data.code != 0` 时将其作为错误响应处理。 |
 | error | 补齐非标准错误的 `response`、`status`、`data.msg`。 |
@@ -283,11 +283,11 @@ GET('/app-api/demo/check', {}, {
 `401` 处理依赖：
 
 ```ts
-uni.$store.state.login.info.token
-uni.$store.dispatch('logout')
+store.state.login.info.token
+store.dispatch('logout')
 ```
 
-请求拦截器属于普通 TS 模块，不在 Vue 组件 setup 上下文中，因此这里使用 `uni.$store`。如果是在组件或 hooks 中读取同一份登录态，请使用：
+请求拦截器属于普通 TS 模块，不在 Vue 组件 setup 上下文中，因此直接引入 store 实例。如果是在组件或 hooks 中读取同一份登录态，请使用：
 
 ```ts
 import { useStore } from 'vuex';
@@ -322,8 +322,8 @@ const request = uni.$uv.http;
 
 | Header | 来源 |
 | --- | --- |
-| `Tenant-Id` | `uni.$store.state.login.info.tenantId`，默认 `1`。 |
-| `X-Language` | `uni.$store.state.system.info.appLanguage` 映射到 `LANGUAGE`。 |
+| `Tenant-Id` | `store.state.login.info.tenantId`，默认 `1`。 |
+| `X-Language` | `store.state.system.info.appLanguage` 映射到 `LANGUAGE`。 |
 | `Channel` | `query.channel`，没有 query 渠道时回退到 `config.app.channel`。 |
 
 业务请求的 `baseURL` 来自：

package/docs/api/configs/index.md

@@ -283,7 +283,6 @@ defineConfig({
 
 ```ts
 import { getTencentToken } from '@zfqh/uniapp/lib/apis';
-import store from '@/store';
 
 defineConfig({
   upload: {
@@ -296,7 +295,7 @@ defineConfig({
         create_time: data.createTime,
         expire_time: data.expirationTime,
         bucket: data.bucket,
-        region: store.state.storeConfig.isGlobalAccelerate ? 'accelerate' : data.region,
+        region: uni.$store.state.storeConfig.isGlobalAccelerate ? 'accelerate' : data.region,
       };
     },
   },

package/docs/api/hooks/index.md

@@ -10,7 +10,7 @@ import { useStore } from 'vuex';
 const store = useStore();
 ```
 
-`uni.$store` 主要用于请求、导航、权限、webview 消息等普通模块。
+普通 TS 模块中使用 `uni.$store`。
 
 | Hook | 说明 |
 | --- | --- |
@@ -44,7 +44,7 @@ import { useOverlay, usePopup, useVersion, useI18n } from '@zfqh/uniapp';
 
 ## Store 用法
 
-Hooks 运行在组件 setup 上下文中，需要读取 Vuex 时请使用 `useStore()`，不要直接读取 `uni.$store`：
+Hooks 运行在组件 setup 上下文中，需要读取 Vuex 时请使用 `useStore()`：
 
 ```ts
 import { computed } from 'vue';
@@ -57,7 +57,7 @@ export function useUserName() {
 }
 ```
 
-`uni.$store` 主要给请求、导航、权限、webview 消息等非组件上下文的普通模块使用。完整约定见 [Store 使用位置](./../../guide/project-frame#store-使用位置)。
+普通 TS 模块中使用 `uni.$store`。完整约定见 [Store 使用位置](./../../guide/project-frame#store-使用位置)。
 
 ## useOverlay
 
@@ -172,7 +172,7 @@ const { t, locale } = useI18n();
 
 | 平台 | 行为 |
 | --- | --- |
-| APP-NVUE | 使用内部 `inject('t')` 和 `showLocale`。 |
+| APP-NVUE | 使用内部 `inject('t')` 和 `getLocaleMessage`。 |
 | 其他平台 | 透传 `vue-i18n` 的 `useI18n`。 |
 
 ```vue

package/docs/api/index.md

@@ -21,14 +21,19 @@ app.use(uniapp);
 安装逻辑：
 
 - 小程序端混入 `deep`。
-- 将 `app.config.globalProperties.$store` 挂到 `uni.$store`。
 
-`uni.$store` 用于请求、导航、权限、webview 消息等非组件上下文的普通模块。组件的 Composition API 和 hooks 中请使用 Vuex 官方入口：
+Store 使用入口请按上下文区分：
 
 ```ts
+// Composition API / <script setup>
 import { useStore } from 'vuex';
-
 const store = useStore();
+
+// Options API 组件
+this.$store
+
+// 普通 TS 模块
+uni.$store
 ```
 
 ## Hooks

package/docs/api/mixins/app.md

@@ -16,13 +16,12 @@ App.vue 全局生命周期 mixin。发布路径：`@zfqh/uniapp/lib/mixins/app`
 
 ```ts
 import app from '@zfqh/uniapp/lib/mixins/app';
-import store from '@/store';
 
 export default {
   mixins: [app],
   onLaunch() {
     if (store.getters.isLogin) {
-      store.dispatch('getInfo');
+      this.$store.dispatch('getInfo');
     }
   },
 };

package/docs/api/modules/app.md

@@ -20,8 +20,6 @@ const store = createStore({
     app,
   },
 });
-
-uni.$store = store;
 ```
 
 ```ts

package/docs/api/modules/index.md

@@ -2,7 +2,7 @@
 
 模块发布路径为 `@zfqh/uniapp/lib/modules`。根入口没有直接导出这些模块；如果业务项目要复用，请深度引入 `@zfqh/uniapp/lib/modules/<name>` 或从 `@zfqh/uniapp/lib/modules` 取具名导出。
 
-这些模块默认假设项目使用 Vuex 4，并且插件安装后会把 Vuex store 暴露到 `uni.$store`，请求、导航、webview 消息等普通模块会读取它。组件和 hooks 中读取 Vuex 时仍应使用 `useStore()` 或 `this.$store`。
+这些模块默认假设项目使用 Vuex 4。请求、导航、webview 消息等普通模块会从 store 中读取状态。组件和 hooks 中读取 Vuex 时仍应使用 `useStore()` 或 `this.$store`。
 
 ## 基本使用
 

package/docs/api/utils/cos.md

@@ -205,7 +205,6 @@ defineConfig({
 
 ```ts
 import { getTencentToken } from '@zfqh/uniapp/lib/apis';
-import store from '@/store';
 
 defineConfig({
   upload: {
@@ -218,7 +217,7 @@ defineConfig({
         create_time: data.createTime,
         expire_time: data.expirationTime,
         bucket: data.bucket,
-        region: store.state.storeConfig.isGlobalAccelerate ? 'accelerate' : data.region,
+        region: uni.$store.state.storeConfig.isGlobalAccelerate ? 'accelerate' : data.region,
       };
     },
   },

package/docs/api/utils/index.md

@@ -12,7 +12,7 @@
 | [cos](./cos) | 腾讯云 COS 上传与图片压缩 URL。 |
 | [debounce](./debounce) | 防抖类和默认实例。 |
 | [file](./file) | URL、dataURL、base64、File、本地路径互转。 |
-| [locale](./locale) | 当前语言、回退语言和 nvue 文案读取。 |
+| [locale](./locale) | 当前语言、回退语言、vue-i18n 实例创建和 nvue 文案读取。 |
 | [message](./message) | webview 与宿主环境通信的消息类型常量。 |
 | [navigate](./navigate) | 页面跳转、登录拦截、tabBar、webview、自定义协议。 |
 | [pages](./pages) | 根据页面配置生成页面集合。 |

package/docs/api/utils/locale.md

@@ -1,32 +1,68 @@
-# 多语言辅助
-
-::: tip 工具模块
-`@zfqh/uniapp/lib/utils/locale`
-:::
-
-提供当前语言、回退语言和 nvue 可用的简易文案读取方法。
-
-## 平台兼容性
-
-| App | H5 | 微信小程序 | 其他小程序 | WebView |
-| --- | --- | --- | --- | --- |
-| √ | √ | √ | 视平台 API 而定 | 视运行容器而定 |
-
-## 基本使用
-
-```ts
-import { defaultLocale, fallbackLocale, showLocale } from '@zfqh/uniapp';
-```
-
-具体方法、参数语义和返回值以发布包类型为准；下方表格按 `@zfqh/uniapp/lib/utils/locale` 的导出整理。
-
-## API
-
-发布路径：`@zfqh/uniapp/lib/utils/locale`
-
-| 名称 | 签名/声明 | 说明 |
-| --- | --- | --- |
-| `defaultLocale` | `export const defaultLocale = uni.getLocale();` | 默认语言。 |
-| `fallbackLocale` | `export const fallbackLocale = 'zh-Hans';` | 回退语言。 |
-| `showLocale` | `export function showLocale(key, values) {` | nvue 场景下的简易 i18n 文案获取函数。 |
-
+# 多语言辅助
+
+::: tip 工具模块
+`@zfqh/uniapp/lib/utils/locale`
+:::
+
+提供当前语言、回退语言、vue-i18n 实例创建和 nvue 可用的简易文案读取方法。
+
+## 平台兼容性
+
+| App | H5 | 微信小程序 | 其他小程序 | WebView |
+| --- | --- | --- | --- | --- |
+| √ | √ | √ | 视平台 API 而定 | 视运行容器而定 |
+
+## 基本使用
+
+```ts
+import { defaultLocale, fallbackLocale, createI18n, getLocaleMessage } from '@zfqh/uniapp';
+```
+
+具体方法、参数语义和返回值以发布包类型为准；下方表格按 `@zfqh/uniapp/lib/utils/locale` 的导出整理。
+
+## 创建 vue-i18n 实例
+
+在 `locale/index.js` 中调用 `createI18n` 创建实例并导出：
+
+```js
+import { createI18n, defaultLocale, fallbackLocale } from '@zfqh/uniapp';
+import messages from './messages';
+
+export const i18n = createI18n({
+  locale: defaultLocale,
+  fallbackLocale,
+  messages,
+});
+```
+
+`messages.js` 按语言键组织翻译文件：
+
+```js
+import zhHans from './zh-Hans.json';
+import en from './en.json';
+
+export default {
+  'zh-Hans': zhHans,
+  en,
+};
+```
+
+实例创建后可在 App 启动时注册：
+
+```js
+import { i18n } from './locale';
+
+const app = createApp(App);
+app.use(i18n);
+```
+
+## API
+
+发布路径：`@zfqh/uniapp/lib/utils/locale`
+
+| 名称 | 签名/声明 | 说明 |
+| --- | --- | --- |
+| `defaultLocale` | `export const defaultLocale = uni.getLocale();` | 默认语言。 |
+| `fallbackLocale` | `export const fallbackLocale = 'zh-Hans';` | 回退语言。 |
+| `createI18n` | `export function createI18n(opts: I18nOptions)` | 创建 vue-i18n 实例，返回实例。 |
+| `getLocaleMessage` | `export function getLocaleMessage(key: string): string` | 通过 key 获取当前语言文案，nvue 场景下的简易 i18n 文案读取。未匹配时返回 key 本身。 |

package/docs/api/utils/navigate.md

@@ -18,7 +18,7 @@
 import { navigate } from '@zfqh/uniapp';
 ```
 
-导航工具脱离组件 setup 上下文，内部会通过 `uni.$store.getters.isLogin` 判断登录态。组件或 hooks 中判断登录态时请使用 `useStore()`。
+导航工具脱离组件 setup 上下文，内部会通过 `store.getters.isLogin` 判断登录态。组件或 hooks 中判断登录态时请使用 `useStore()`。
 
 ## 常用跳转
 
@@ -192,10 +192,10 @@ navigate.navigateTo({
 登录判断依赖：
 
 ```ts
-uni.$store.getters.isLogin
+store.getters.isLogin
 ```
 
-`navigate` 是普通工具模块，脱离组件 setup 上下文，所以读取 `uni.$store`。如果是在组件或 hooks 中判断登录态，请使用：
+`navigate` 是普通工具模块，脱离组件 setup 上下文，所以直接引入 store 实例。如果是在组件或 hooks 中判断登录态，请使用：
 
 ```ts
 import { computed } from 'vue';

package/docs/api/utils/pages.md

@@ -124,7 +124,7 @@ defineConfig({
 
 `needLogin` 字段控制页面是否需要登录才能访问，默认为 `false`。
 
-当 `needLogin: true` 时，`navigate` 会检查 `uni.$store.getters.isLogin`，如果未登录则自动跳转到 `getPage('login')` 返回的登录页路径。
+当 `needLogin: true` 时，`navigate` 会检查 `store.getters.isLogin`，如果未登录则自动跳转到 `getPage('login')` 返回的登录页路径。
 
 ```json
 {

package/docs/api/utils/request.md

@@ -18,7 +18,7 @@
 import { formatURL, createInterceptors, createRequest } from '@zfqh/uniapp';
 ```
 
-请求工具脱离组件 setup 上下文，拦截器内部会通过 `uni.$store` 读取 token 并处理 `401`。组件或 hooks 中读取 store 时请使用 `useStore()`。
+请求工具脱离组件 setup 上下文，拦截器内部会从 store 中读取 token 并处理 `401`。组件或 hooks 中读取 store 时请使用 `useStore()`。
 
 具体方法、参数语义和返回值以发布包类型为准；下方表格按 `@zfqh/uniapp/lib/utils/request` 的导出整理。
 

package/docs/components/index.md

@@ -41,7 +41,7 @@ import { useStore } from 'vuex';
 const store = useStore();
 ```
 
-Options API 组件可使用 `this.$store`。`uni.$store` 主要给请求、导航、权限、webview 消息等普通 TS 模块使用，不建议作为组件 setup 或 hooks 的首选入口。
+Options API 组件可使用 `this.$store`。普通 TS 模块中使用 `uni.$store`。
 
 ## 组件分类
 

package/docs/components/usage.md

@@ -58,7 +58,7 @@ const isLogin = computed(() => store.getters.isLogin);
 </script>
 ```
 
-如果组件仍使用 Options API，可使用 `this.$store`。`uni.$store` 只推荐在脱离组件上下文的普通 TS 模块中使用，例如请求拦截器、导航工具、权限工具和 webview 消息处理。
+如果组件仍使用 Options API，可使用 `this.$store`。脱离组件上下文的普通 TS 模块中使用 `uni.$store`。
 
 ## 页面骨架示例
 

package/docs/faq/index.md

@@ -5,16 +5,15 @@
 检查：
 
 1. 是否先注册 store，再注册 `@zfqh/uniapp`。
-2. 是否设置了 `app.config.globalProperties.$store = store`。
-3. token 是否位于 `uni.$store.state.login.info.token`。
+2. token 是否位于 `store.state.login.info.token`。
 
-这里检查 `uni.$store` 是因为请求拦截器属于普通 TS 模块。组件或 hooks 内读取同一份状态时应使用 `useStore()`。
+请求拦截器属于普通 TS 模块，内部会从 store 中读取状态。组件或 hooks 内读取同一份状态时应使用 `useStore()`。
 
 ## 401 后没有退出登录
 
 检查：
 
-1. `uni.$store.state.login.info.token` 是否存在。
+1. `store.state.login.info.token` 是否存在。
 2. store 是否实现 `dispatch('logout')`。
 3. 请求配置是否设置了 `custom.reLogin: false` 或 `custom.needLogin: false`。
 
@@ -31,12 +30,12 @@
 
 检查：
 
-1. `uni.$store.getters.isLogin` 是否正确。
+1. `store.getters.isLogin` 是否正确。
 2. `page.needLoginPages` 是否包含目标页。
 3. `getPage('login')` 是否能返回登录页路径。
 4. 当前跳转是否显式传入 `needLogin: false`。
 
-`navigate` 内部读取 `uni.$store.getters.isLogin`。如果页面组件里自己判断登录态，请使用 `import { useStore } from 'vuex'`。
+`navigate` 内部读取 `store.getters.isLogin`。如果页面组件里自己判断登录态，请使用 `import { useStore } from 'vuex'`。
 
 ## tabBar 页面 navigateTo 失败
 

package/docs/guide/getting-started.md

@@ -34,14 +34,14 @@ export function createApp() {
 }
 ```
 
-`@zfqh/uniapp` 插件安装时会把 `app.config.globalProperties.$store` 赋值给 `uni.$store`。请求、导航、权限、登录等能力会读取 `uni.$store`，所以请先挂载 store，再注册本插件。
+请求、导航、权限、登录等能力会读取 store 状态，所以请先挂载 store，再注册本插件。
 
 Store 使用入口请按上下文区分：
 
 - 组件的 Composition API 或 `<script setup>` 中使用 `import { useStore } from 'vuex'`。
 - 自定义 hooks / composables 中也使用 `useStore()`。
 - Options API 组件中可使用 `this.$store`。
-- 请求、导航、权限、webview 消息等普通 TS 模块中使用 `uni.$store`。
+- 普通 TS 模块中使用 `uni.$store`。
 
 详见 [Store 使用位置](./project-frame.md#store-使用位置)。
 
@@ -124,7 +124,6 @@ import { defineConfig } from '@zfqh/uniapp';
 import { app } from '@zfqh/uniapp/lib/configs/app';
 import { brand } from '@zfqh/uniapp/lib/configs/brand';
 import { getTencentToken } from '@zfqh/uniapp/lib/apis';
-import store from '@/store';
 
 defineConfig({
   app: app.merchant,
@@ -149,7 +148,7 @@ defineConfig({
         create_time: data.createTime,
         expire_time: data.expirationTime,
         bucket: data.bucket,
-        region: store.state.storeConfig.isGlobalAccelerate ? 'accelerate' : data.region,
+        region: uni.$store.state.storeConfig.isGlobalAccelerate ? 'accelerate' : data.region,
       };
     },
   },

package/docs/guide/project-frame.md

@@ -110,7 +110,6 @@ import { defineConfig } from '@zfqh/uniapp';
 import { app } from '@zfqh/uniapp/lib/configs/app';
 import { brand } from '@zfqh/uniapp/lib/configs/brand';
 import { getTencentToken } from '@zfqh/uniapp/lib/apis';
-import store from '@/store';
 
 defineConfig({
   app: app.merchant,
@@ -135,7 +134,7 @@ defineConfig({
         create_time: data.createTime,
         expire_time: data.expirationTime,
         bucket: data.bucket,
-        region: store.state.storeConfig.isGlobalAccelerate ? 'accelerate' : data.region,
+        region: uni.$store.state.storeConfig.isGlobalAccelerate ? 'accelerate' : data.region,
       };
     },
   },
@@ -197,13 +196,13 @@ export default defineConfig({
 
 | 路径 | 用途 |
 | --- | --- |
-| `uni.$store.state.login.info.token` | 请求拦截器注入 `Authorization`。 |
-| `uni.$store.state.login.info.tenantId` | 业务请求注入 `Tenant-Id`。 |
-| `uni.$store.state.system.info.appLanguage` | 业务请求注入 `X-Language`。 |
-| `uni.$store.state.system.info.appVersion` | 非 App 环境下读取版本名。 |
-| `uni.$store.state.system.info.appVersionCode` | 非 App 环境下读取版本号。 |
-| `uni.$store.getters.isLogin` | 导航登录拦截判断。 |
-| `uni.$store.dispatch('logout')` | `401` 时触发退出登录。 |
+| `store.state.login.info.token` | 请求拦截器注入 `Authorization`。 |
+| `store.state.login.info.tenantId` | 业务请求注入 `Tenant-Id`。 |
+| `store.state.system.info.appLanguage` | 业务请求注入 `X-Language`。 |
+| `store.state.system.info.appVersion` | 非 App 环境下读取版本名。 |
+| `store.state.system.info.appVersionCode` | 非 App 环境下读取版本号。 |
+| `store.getters.isLogin` | 导航登录拦截判断。 |
+| `store.dispatch('logout')` | `401` 时触发退出登录。 |
 
 推荐在注册插件前完成：
 
@@ -219,9 +218,9 @@ app.use(uniapp);
 | 场景 | 推荐用法 | 说明 |
 | --- | --- | --- |
 | Vue 组件的 Composition API / `<script setup>` | `import { useStore } from 'vuex'` 后调用 `const store = useStore()` | 组件实例处于 Vue 上下文内，应使用 Vuex 官方组合式 API，便于类型推导、测试和组件复用。 |
-| 自定义 hooks / composables | `import { useStore } from 'vuex'` 后在 hook 内调用 `useStore()` | hooks 同样运行在组件 setup 上下文里，不要直接读取全局 `uni.$store`。 |
+| 自定义 hooks / composables | `import { useStore } from 'vuex'` 后在 hook 内调用 `useStore()` | hooks 同样运行在组件 setup 上下文里。 |
 | Options API 组件 | `this.$store` | 组件实例已注入 `$store` 时可使用实例属性；现有 `g-*` 组件源码也采用这种方式读取部分系统状态。 |
-| 请求、导航、toast、权限、webview 消息等普通 TS 模块 | `uni.$store` | 这些模块不在 Vue setup 上下文中，无法调用 `useStore()`，因此通过插件挂载到 `uni.$store` 的全局 store 读取登录态和全局状态。 |
+| 请求、导航、toast、权限、webview 消息等普通 TS 模块 | `uni.$store` | 这些模块不在 Vue setup 上下文中，无法调用 `useStore()`，因此直接引入 store 实例读取登录态和全局状态。 |
 
 组件或 hooks 中推荐写法：
 
@@ -241,16 +240,6 @@ export function useLoginInfo() {
 }
 ```
 
-普通模块中推荐写法：
-
-```ts
-export function getToken() {
-  return uni.$store?.state?.login?.info?.token;
-}
-```
-
-`uni.$store` 是为了让脱离组件树的工具函数能够访问 store，不建议在组件 setup 或 hooks 中把它作为首选入口。
-
 ## 样式接入
 
 `@zfqh/uniapp` 内置的静态样式仅覆盖平台差异类和使用 `$uv-*` SCSS 变量的语义色类，间距、尺寸、字号、圆角、透明度、阴影等通用原子类由 `@gmcb/vite` 的 unocss 插件在构建时动态生成。

package/docs/index.md

@@ -74,7 +74,7 @@ export function createApp() {
 
 ## 使用约定
 
-- 项目需要提供符合约定的 Vuex store：请求读取 `uni.$store.state.login.info.token`，导航读取 `uni.$store.getters.isLogin`，`401` 会触发 `uni.$store.dispatch('logout')`。
-- Store 入口按上下文区分：组件和 hooks 的 Composition API 中使用 `import { useStore } from 'vuex'`，Options API 组件中使用 `this.$store`，请求、导航、权限、webview 消息等普通模块中使用 `uni.$store`。
+- 项目需要提供符合约定的 Vuex store：请求读取 `store.state.login.info.token`，导航读取 `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/hooks/useI18n.js

@@ -1,16 +1,10 @@
-// #ifdef APP-NVUE
-import { ref, inject } from 'vue';
-import { showLocale, defaultLocale } from '../utils/locale';
-// #endif
 // #ifndef APP-NVUE
 import { useI18n as vueUseI18n } from 'vue-i18n';
 // #endif
 let _useI18n;
 // #ifdef APP-NVUE
 _useI18n = function () {
-    const locale = ref(defaultLocale);
-    const t = inject('t', showLocale);
-    return { t, locale };
+    return uni.$i18n.global;
 };
 // #endif
 // #ifndef APP-NVUE

package/lib/index.d.ts

@@ -5,6 +5,7 @@ import cos from './utils/cos';
 import './utils/uni';
 export * from './hooks';
 export * from './utils';
+export * from './utils/locale';
 export * from './utils/file';
 export * from './utils/storage';
 export * from './utils/pages';

package/lib/index.js

@@ -6,6 +6,7 @@ import cos from './utils/cos';
 import './utils/uni';
 export * from './hooks';
 export * from './utils';
+export * from './utils/locale';
 export * from './utils/file';
 export * from './utils/storage';
 export * from './utils/pages';
@@ -25,8 +26,6 @@ const install = (app) => {
     // #ifdef MP
     app.mixin(deep);
     // #endif
-    const { $store } = app.config.globalProperties;
-    uni.$store = $store;
 };
 export default {
     install,

package/lib/utils/locale.d.ts

@@ -1,6 +1,5 @@
+import { I18nOptions } from 'vue-i18n';
 export declare const defaultLocale: string;
 export declare const fallbackLocale = "zh-Hans";
-/**
- * nvue 下 inject 未提供 t 时的回退；第二参数为命名占位 {n} 等
- */
-export declare function showLocale(key: any, values: any): any;
+export declare function createI18n(opts: I18nOptions): import("vue-i18n").I18n<import("vue-i18n").LocaleMessages<import("vue-i18n").VueMessageType>, import("vue-i18n").IntlDateTimeFormats, import("vue-i18n").IntlNumberFormats, boolean>;
+export declare function getLocaleMessage(key: string): string;

package/lib/utils/locale.js

@@ -1,19 +1,10 @@
+import { createI18n as _createI18n } from 'vue-i18n';
 export const defaultLocale = uni.getLocale();
 export const fallbackLocale = 'zh-Hans';
-function applyNamedPlaceholders(str, values) {
-    if (!values || typeof str !== 'string') {
-        return str;
-    }
-    let out = str;
-    for (const k of Object.keys(values)) {
-        out = out.split(`{${k}}`).join(String(values[k]));
-    }
-    return out;
+export function createI18n(opts) {
+    const i18n = _createI18n(opts);
+    return (uni.$i18n = i18n);
 }
-/**
- * nvue 下 inject 未提供 t 时的回退；第二参数为命名占位 {n} 等
- */
-export function showLocale(key, values) {
-    const raw = uni.$messages[uni.getLocale()]?.[key] || uni.$messages[fallbackLocale]?.[key] || key;
-    return applyNamedPlaceholders(raw, values);
+export function getLocaleMessage(key) {
+    return uni.$i18n?.global?.t(key) || key;
 }

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "@zfqh/uniapp",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "uniapp公共模块",
   "author": "yinjiazeng@163.com",
   "license": "MIT",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",
-  "homepage": "https://git.keeprisk.cn/zfqh/front-end/tree/master/packages/uniapp-zfqh",
+  "homepage": "https://git.keeprisk.cn/zfqh/front-end/tree/master/packages/zfqh-uniapp",
   "publishConfig": {
     "access": "public"
   },
@@ -45,5 +45,5 @@
     "@types/qs": "^6.9.16",
     "@types/url-parse": "^1.4.11"
   },
-  "gitHead": "4eadd74fdfef951065e002cb9f65a30a7de03021"
+  "gitHead": "51d155379d352d8507622d2ccb89a6442892b2b2"
 }

package/types/index.d.ts

@@ -1,12 +1,14 @@
 /// <reference path="./virtual.d.ts" />
 
 import type { Uni as UniTypes } from '@dcloudio/types';
+import type { Store } from 'vuex';
+import type { I18n } from 'vue-i18n';
 import color from '../lib/configs/color';
 
 declare global {
   interface Uni extends UniTypes {
-    $store: any;
-    $messages: any;
+    $store: Store;
+    $i18n: I18n;
     $uv: any;
     webView: any;
     showAppFromBackground: boolean;