@liujitcn/kratos-taro-app-core 0.0.82 → 0.0.84

package/README.md

@@ -18,6 +18,8 @@
 
 ## 公开入口
 
+登录页返回会清理本次回跳并替换到首页；直接打开登录页清理旧 `lastRoute`，登录成功默认进入首页。主动登录、路由守卫和会话过期重登通过 `redirect=1` 标记保留本次业务目标及查询参数，成功跳转后才清理目标。登录页每次显示都会检查有效登录态，已登录则替换回首页，避免浏览器回退重新停留在登录页。H5 与微信小程序统一使用 `reLaunch` 替换登录入口并重置应用页面栈。
+
 - `@liujitcn/kratos-taro-app-core`：启动、模块、导航、状态和常用工具，包含动态路径使用的 `resolveBundledAsset()`。
 - `@liujitcn/kratos-taro-app-core/static/*`：页面图片等可由 Webpack 静态分析的打包资源。
 - `@liujitcn/kratos-taro-app-core/build`：构建期模块描述和双语构建错误文案格式化器。

package/package.json

@@ -7,7 +7,7 @@
     "type": "git",
     "url": "git@github.com:liujitcn/kratos-admin.git"
   },
-  "version": "0.0.82",
+  "version": "0.0.84",
   "type": "module",
   "files": [
     "dist",

package/src/locales/README.md

@@ -9,4 +9,4 @@
 | `en-US.json` | 英文 Core 语言包。 | Taro 切换为英文时使用。 |
 | `ja-JP.json` | 日文 Core 语言包。 | Taro 切换为日文时使用。 |
 
-语言包是标准 JSON，不能在文件内直接写注释；公共键使用 `common.` 或 `core.` 命名空间。新增语言后执行仓库根目录的 `make i18n`。语言切换选项固定显示后端 `base_language.native_name`，接口不可用时使用代码内置的原生名称；`common.language.*` 仅用于普通文案和语言迁移初始数据。新增语言的完整文件清单见[国际化设计与语言扩展](../../../../../../docs/国际化设计与语言扩展.md)。
+语言包是标准 JSON，不能在文件内直接写注释；公共键使用 `common.` 或 `core.` 命名空间。新增语言后执行仓库根目录的 `make i18n`。语言切换选项固定显示后端 `base_language.native_name`，接口不可用时使用代码内置的原生名称；语言迁移初始名称来自管理端 Core 的 `common.language.*`。新增语言的完整文件清单见[国际化设计与语言扩展](../../../../../../docs/国际化设计与语言扩展.md)。

package/src/locales/en-US.json

@@ -10,16 +10,11 @@
   "common.action.save": "Save",
   "common.action.view": "View",
   "common.field.language": "Language",
-  "common.language.en-US": "English",
-  "common.language.zh-CN": "简体中文",
-  "common.language.zh-TW": "Traditional Chinese",
-  "common.language.ja-JP": "Japanese",
   "common.message.loading": "Loading",
   "common.message.network_error": "Network error. Check your connection and try again.",
   "common.message.request_error": "Request failed",
   "common.message.unknown": "Unable to process this request. Try again later.",
   "common.title.notice": "Notice",
-  "core.auth.login_again": "Log in again",
   "core.auth.session_expired": "Your session has expired. Please log in again.",
   "core.config.missing": "Missing app configuration: {names}",
   "core.crypto.base64_decode_unsupported": "Base64 decoding is not supported in this environment",
@@ -123,12 +118,5 @@
   "core.webview.embed_blocked": "The destination may block embedding on H5",
   "core.webview.invalid_url": "No valid link was provided",
   "core.webview.open_failed": "Unable to open link",
-  "common.value.top_level": "Top level",
-  "common.resource.default": "{resource}",
-  "common.action.delete_resource": "Delete {resource}",
-  "common.action.set_field_status": "Set {field}",
-  "common.action.load_more": "Load more",
-  "common.status.loading": "Loading…",
-  "core.navigation.analytics": "Analytics",
-  "core.navigation.report": "Reports"
+  "common.action.load_more": "Load more"
 }

package/src/locales/ja-JP.json

@@ -10,16 +10,11 @@
   "common.action.save": "保存",
   "common.action.view": "表示",
   "common.field.language": "言語",
-  "common.language.en-US": "英語",
-  "common.language.zh-CN": "簡体字中国語",
-  "common.language.zh-TW": "繁体字中国語",
-  "common.language.ja-JP": "日本語",
   "common.message.loading": "をロード中です",
   "common.message.network_error": "ネットワーク エラー。別のネットワークを試してください",
   "common.message.request_error": "リクエストエラー",
   "common.message.unknown": "は一時的に処理できません。後でもう一度試してください。",
   "common.title.notice": "ヒント",
-  "core.auth.login_again": "再度ログインしてください",
   "core.auth.session_expired": "現在のページは無効です。再度ログインしてください。",
   "core.config.missing": "モバイル端末の設定がありません: {names}",
   "core.crypto.base64_decode_unsupported": "現在の環境は Base64 デコードをサポートしていません",
@@ -123,12 +118,5 @@
   "core.webview.embed_blocked": "現在の H5 ページは、ターゲット サイトによって埋め込みが制限されている可能性があります",
   "core.webview.invalid_url": "有効なリンク アドレスがありません",
   "core.webview.open_failed": "リンクを開けません",
-  "common.value.top_level": "トップレベル",
-  "common.resource.default": "{resource}",
-  "common.action.delete_resource": "{resource}を削除",
-  "common.action.set_field_status": "{field}を設定",
-  "common.action.load_more": "さらに読み込む",
-  "common.status.loading": "読み込み中…",
-  "core.navigation.analytics": "分析",
-  "core.navigation.report": "レポート"
+  "common.action.load_more": "さらに読み込む"
 }

package/src/locales/zh-CN.json

@@ -10,16 +10,11 @@
   "common.action.save": "保存",
   "common.action.view": "查看",
   "common.field.language": "语言",
-  "common.language.en-US": "English",
-  "common.language.zh-CN": "简体中文",
-  "common.language.zh-TW": "繁体中文",
-  "common.language.ja-JP": "日语",
   "common.message.loading": "正在加载",
   "common.message.network_error": "网络错误，换个网络试试",
   "common.message.request_error": "请求错误",
   "common.message.unknown": "暂时无法处理，请稍后重试",
   "common.title.notice": "提示",
-  "core.auth.login_again": "重新登录",
   "core.auth.session_expired": "当前页面已失效，请重新登录",
   "core.config.missing": "移动端配置缺失：{names}",
   "core.crypto.base64_decode_unsupported": "当前环境不支持 Base64 解码",
@@ -123,12 +118,5 @@
   "core.webview.embed_blocked": "当前 H5 页面可能被目标站点限制嵌入",
   "core.webview.invalid_url": "缺少有效链接地址",
   "core.webview.open_failed": "链接无法打开",
-  "common.value.top_level": "顶级节点",
-  "common.resource.default": "{resource}",
-  "common.action.delete_resource": "删除{resource}",
-  "common.action.set_field_status": "设置{field}",
-  "common.action.load_more": "加载更多",
-  "common.status.loading": "加载中…",
-  "core.navigation.analytics": "分析",
-  "core.navigation.report": "报表"
+  "common.action.load_more": "加载更多"
 }

package/src/locales/zh-TW.json

@@ -10,16 +10,11 @@
   "common.action.save": "儲存",
   "common.action.view": "檢視",
   "common.field.language": "語言",
-  "common.language.en-US": "English",
-  "common.language.zh-CN": "簡體中文",
-  "common.language.zh-TW": "繁體中文",
-  "common.language.ja-JP": "日語",
   "common.message.loading": "正在載入",
   "common.message.network_error": "網路錯誤，換個網路試試",
   "common.message.request_error": "請求錯誤",
   "common.message.unknown": "暫時無法處理，請稍後重試",
   "common.title.notice": "提示",
-  "core.auth.login_again": "重新登入",
   "core.auth.session_expired": "當前頁面已失效，請重新登入",
   "core.config.missing": "移動端配置缺失：{names}",
   "core.crypto.base64_decode_unsupported": "當前環境不支援 Base64 解碼",
@@ -123,12 +118,5 @@
   "core.webview.embed_blocked": "當前 H5 頁面可能被目標站點限制嵌入",
   "core.webview.invalid_url": "缺少有效連結地址",
   "core.webview.open_failed": "連結無法開啟",
-  "common.value.top_level": "頂級節點",
-  "common.resource.default": "{resource}",
-  "common.action.delete_resource": "刪除{resource}",
-  "common.action.set_field_status": "設定{field}",
-  "common.action.load_more": "載入更多",
-  "common.status.loading": "載入中…",
-  "core.navigation.analytics": "分析",
-  "core.navigation.report": "報表"
+  "common.action.load_more": "載入更多"
 }

package/src/utils/http.ts

@@ -265,6 +265,7 @@ async function refreshAccessToken(): Promise<void> {
 /** 会话过期弹窗等待时长：H5 端路由切换会自动隐藏模态且 Promise 永不结算，超时释放避免提示永久卡死。 */
 const RELOGIN_PROMPT_TIMEOUT = 60_000
 
+/** 提示会话过期并进入携带本次业务回跳标记的登录页。 */
 async function promptRelogin(): Promise<void> {
   // 401 来自旧会话的在途请求而当前已是有效登录态时直接忽略，避免刚登录成功被弹窗打断。
   if (hasValidToken()) return
@@ -295,7 +296,7 @@ async function promptRelogin(): Promise<void> {
     await new Promise((resolve) => setTimeout(resolve, 80))
     silentClearAuthData()
     saveCurrentRoute()
-    await Taro.reLaunch({ url: '/pages/login/login' })
+    await Taro.reLaunch({ url: '/pages/login/login?redirect=1' })
   } finally {
     isPromptingRelogin = false
   }

package/src/utils/navigation.ts

@@ -1,7 +1,10 @@
 import Taro, { getCurrentPages } from '@tarojs/taro'
+import { hasValidToken } from './auth'
 
 const LAST_ROUTE_KEY = 'lastRoute'
 const LOGIN_PAGE = '/pages/login/login'
+/** 携带本次回跳标记的登录入口。 */
+const LOGIN_REDIRECT_PAGE = `${LOGIN_PAGE}?redirect=1`
 /** 首页 tab 页面路径。 */
 export const homeTabPage = '/pages/index/index'
 
@@ -57,10 +60,27 @@ export function consumeLoginRedirectUrl(): string {
   return url
 }
 
-/** 登录成功后恢复访问目标，并仅在跳转成功后清理保存的地址。 */
+/** prepareLoginPage 清理直接访问的旧目标，已登录时替换回首页。 */
+export function prepareLoginPage(redirect?: string): boolean {
+  if (redirect !== '1') Taro.removeStorageSync(LAST_ROUTE_KEY)
+  if (!hasValidToken()) return true
+  void returnFromLogin()
+  return false
+}
+
+/** returnFromLogin 结束本次登录入口并替换到首页，避免返回受保护页面。 */
+export async function returnFromLogin(): Promise<void> {
+  Taro.removeStorageSync(LAST_ROUTE_KEY)
+  Taro.setStorageSync('SwitchTabIndex', true)
+  await Taro.reLaunch({ url: homeTabPage })
+}
+
+/** restoreLoginRedirect 替换到本次访问目标，跳转成功后才清理保存的地址。 */
 export async function restoreLoginRedirect(): Promise<void> {
   const savedRoute = Taro.getStorageSync<string>(LAST_ROUTE_KEY) || ''
-  const targetRoute = savedRoute ? normalizeRouteUrl(savedRoute) : homeTabPage
+  const normalizedRoute = normalizeRouteUrl(savedRoute)
+  const targetRoute =
+    savedRoute && !normalizedRoute.startsWith(LOGIN_PAGE) ? normalizedRoute : homeTabPage
   if (targetRoute.startsWith(homeTabPage)) Taro.setStorageSync('SwitchTabIndex', true)
   await Taro.reLaunch({ url: targetRoute })
   if (savedRoute && Taro.getStorageSync<string>(LAST_ROUTE_KEY) === savedRoute) {
@@ -73,9 +93,9 @@ export function navigateToLogin(redirectUrl?: string): void {
   if (typeof redirectUrl === 'string' && redirectUrl) saveLoginRedirectUrl(redirectUrl)
   else saveCurrentRoute()
   void Taro.navigateTo({
-    url: LOGIN_PAGE,
+    url: LOGIN_REDIRECT_PAGE,
     fail: () => {
-      void Taro.reLaunch({ url: LOGIN_PAGE })
+      void Taro.reLaunch({ url: LOGIN_REDIRECT_PAGE })
     },
   })
 }
@@ -85,9 +105,9 @@ export function redirectToLogin(redirectUrl?: string): void {
   if (typeof redirectUrl === 'string' && redirectUrl) saveLoginRedirectUrl(redirectUrl)
   else saveCurrentRoute()
   void Taro.redirectTo({
-    url: LOGIN_PAGE,
+    url: LOGIN_REDIRECT_PAGE,
     fail: () => {
-      void Taro.reLaunch({ url: LOGIN_PAGE })
+      void Taro.reLaunch({ url: LOGIN_REDIRECT_PAGE })
     },
   })
 }

package/src/views/pages/login/login.tsx

@@ -1,5 +1,5 @@
 import { Button, Checkbox, Image, Input, Picker, Text, View } from '@tarojs/components'
-import Taro, { useLoad } from '@tarojs/taro'
+import Taro, { useDidShow, useLoad } from '@tarojs/taro'
 import { useEffect, useMemo, useRef, useState } from 'react'
 import defaultLogo from '@liujitcn/kratos-taro-app-core/static/images/logo_icon.png'
 import { defLoginService } from '../../../api/base/v1/login'
@@ -8,7 +8,7 @@ import { navigateAppRoute } from '../../../navigation'
 import { LoginStatus, type LoginRequest, type LoginResponse } from '../../../rpc/base/v1/login'
 import { useSettingStore, useThemeStore, useUserStore } from '../../../stores'
 import { formatSrc } from '../../../utils'
-import { homeTabPage, restoreLoginRedirect } from '../../../utils/navigation'
+import { prepareLoginPage, restoreLoginRedirect, returnFromLogin } from '../../../utils/navigation'
 import { encryptPassword } from '../../../utils/secretCrypto'
 import { createWebAuthnCredential, getWebAuthnAssertion } from '../../../utils/webauthn'
 import MfaRecoveryCodesDialog from '../../../components/MfaRecoveryCodesDialog'
@@ -84,11 +84,9 @@ export default function LoginPage() {
   const settings = useSettingStore((state) => state.data)
   const themeStore = useThemeStore()
 
-  /** 返回上一页；登录页可能是冷启动首页，无上级页面时回主页。 */
+  /** 返回首页并结束本次登录回跳，避免上一页再次要求登录。 */
   const goBack = () => {
-    Taro.navigateBack({
-      fail: () => void Taro.reLaunch({ url: homeTabPage }),
-    })
+    void returnFromLogin()
   }
   const loadSettings = useSettingStore((state) => state.loadData)
   const userStore = useUserStore.getState()
@@ -281,7 +279,12 @@ export default function LoginPage() {
     return settingsPromise.current
   }
 
-  useLoad(() => {
+  const loginRedirect = useRef<string>()
+  useLoad((options) => {
+    loginRedirect.current = options.redirect
+  })
+  useDidShow(() => {
+    if (!prepareLoginPage(loginRedirect.current)) return
     void loadLoginSettings()
   })