@liujitcn/kratos-taro-app-core 0.0.28 → 0.0.31

package/src/components/PasswordVerifyDialog.scss

@@ -0,0 +1,146 @@
+.password-verify-dialog {
+  position: fixed;
+  z-index: 1000;
+  top: 0;
+  right: 0;
+  bottom: 0;
+  left: 0;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  padding: 32px;
+  background-color: rgba(0, 0, 0, 0.45);
+}
+
+.password-verify-dialog__panel {
+  box-sizing: border-box;
+  width: 100%;
+  max-width: 640px;
+  overflow: hidden;
+  border-radius: 16px;
+  background-color: #fff;
+  box-shadow: 0 20px 64px rgba(0, 0, 0, 0.2);
+}
+
+.password-verify-dialog__header {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  padding: 28px 32px;
+  border-bottom: 1px solid #eee;
+}
+
+.password-verify-dialog__title {
+  color: #222;
+  font-size: 34px;
+  font-weight: 600;
+}
+
+.password-verify-dialog__close {
+  padding: 0 8px;
+  color: #999;
+  font-size: 42px;
+  line-height: 1;
+}
+
+.password-verify-dialog__body {
+  padding: 32px;
+}
+
+.password-verify-dialog__description,
+.password-verify-dialog__label,
+.password-verify-dialog__error {
+  display: block;
+}
+
+.password-verify-dialog__description {
+  margin-bottom: 24px;
+  color: #666;
+  font-size: 26px;
+  line-height: 1.6;
+}
+
+.password-verify-dialog__label {
+  margin-bottom: 12px;
+  color: #333;
+  font-size: 28px;
+}
+
+.password-verify-dialog__input {
+  display: block;
+  box-sizing: border-box;
+  width: 100%;
+  height: 84px;
+  margin: 0;
+  padding: 0 24px;
+  color: #222 !important;
+  font-size: 30px;
+  line-height: 84px;
+  text-align: left;
+  background: #fff;
+  border: 1px solid #ddd;
+  border-radius: 8px;
+  outline: none;
+}
+
+.password-verify-dialog__error {
+  margin-top: 10px;
+  color: #e64340;
+  font-size: 24px;
+}
+
+.password-verify-dialog__footer {
+  display: flex;
+  justify-content: flex-end;
+  gap: 20px;
+  padding: 0 32px 32px;
+}
+
+.password-verify-dialog__button {
+  display: flex;
+  flex: 1 1 0;
+  align-items: center;
+  justify-content: center;
+  box-sizing: border-box;
+  width: 0;
+  min-width: 160px;
+  height: 72px;
+  margin: 0;
+  padding: 0 24px;
+  font-size: 28px;
+  line-height: 72px;
+  text-align: center;
+  border: 0;
+  border-radius: 8px;
+}
+
+.password-verify-dialog__button::after {
+  border: 0;
+}
+
+.password-verify-dialog__button--cancel {
+  color: #555 !important;
+  -webkit-text-fill-color: #555;
+  background-color: #f3f3f3;
+}
+
+.password-verify-dialog__button--confirm {
+  color: #fff;
+  background-color: #27ba9b;
+}
+
+.password-verify-dialog__button[disabled] {
+  opacity: 1;
+}
+
+.password-verify-dialog__button--cancel[disabled] {
+  color: #555 !important;
+  -webkit-text-fill-color: #555;
+  background-color: #f3f3f3;
+}
+
+.password-verify-dialog__button--confirm[disabled] {
+  color: #fff !important;
+  -webkit-text-fill-color: #fff;
+  background-color: #27ba9b;
+}

package/src/components/PasswordVerifyDialog.tsx

@@ -0,0 +1,146 @@
+import { Button, Input, Text, View } from '@tarojs/components'
+import { useEffect, useState } from 'react'
+import { useI18n } from '../locales'
+import { PASSWORD_CRYPTO_SCENE, encryptPassword } from '../utils/passwordCrypto'
+import type { PasswordCryptoScene } from '../utils/passwordCrypto'
+import type { PasswordCrypto } from '../rpc/common/v1/types'
+import './PasswordVerifyDialog.scss'
+
+/** Taro 通用密码验证弹窗属性。 */
+export interface PasswordVerifyDialogProps {
+  /** 弹窗显示状态。 */
+  open: boolean
+  /** 弹窗标题。 */
+  title?: string
+  /** 密码输入前的可选补充说明。 */
+  description?: string
+  /** 密码字段标题。 */
+  passwordLabel?: string
+  /** 密码输入提示。 */
+  passwordPlaceholder?: string
+  /** 确认按钮文案。 */
+  confirmText?: string
+  /** 取消按钮文案。 */
+  cancelText?: string
+  /** 外部业务提交状态。 */
+  confirmLoading?: boolean
+  /** 密码加密场景。 */
+  scene?: PasswordCryptoScene
+  /** 是否允许点击遮罩关闭弹窗。 */
+  closeOnClickModal?: boolean
+  /** 确认并返回加密密码。 */
+  onConfirm: (password: PasswordCrypto) => void | Promise<void>
+  /** 取消验证。 */
+  onCancel: () => void
+}
+
+/** 通用密码验证弹窗，负责收集并加密当前密码。 */
+export default function PasswordVerifyDialog({
+  open,
+  title,
+  description,
+  passwordLabel,
+  passwordPlaceholder,
+  confirmText,
+  cancelText,
+  confirmLoading = false,
+  scene = PASSWORD_CRYPTO_SCENE.PASSWORD_CRYPTO_SCENE_MFA,
+  closeOnClickModal = false,
+  onConfirm,
+  onCancel,
+}: PasswordVerifyDialogProps) {
+  const { t } = useI18n()
+  const [password, setPassword] = useState('')
+  const [errorMessage, setErrorMessage] = useState('')
+  const [encrypting, setEncrypting] = useState(false)
+  const submitting = confirmLoading || encrypting
+
+  useEffect(() => {
+    if (!open) {
+      setPassword('')
+      setErrorMessage('')
+    }
+  }, [open])
+
+  if (!open) return null
+
+  const handleConfirm = async () => {
+    if (submitting) return
+    if (!password.trim()) {
+      setErrorMessage(t('core.crypto.password_required'))
+      return
+    }
+    setErrorMessage('')
+    setEncrypting(true)
+    try {
+      const encryptedPassword = await encryptPassword(password, scene)
+      await onConfirm(encryptedPassword)
+    } catch (error) {
+      setErrorMessage(error instanceof Error ? error.message : t('common.message.request_error'))
+    } finally {
+      setEncrypting(false)
+    }
+  }
+
+  const handleCancel = () => {
+    if (submitting) return
+    onCancel()
+  }
+
+  const handleMaskClick = () => {
+    if (closeOnClickModal) handleCancel()
+  }
+
+  return (
+    <View className='password-verify-dialog' onClick={handleMaskClick}>
+      <View className='password-verify-dialog__panel' onClick={(event) => event.stopPropagation()}>
+        <View className='password-verify-dialog__header'>
+          <Text className='password-verify-dialog__title'>
+            {title || t('core.password.verify_title')}
+          </Text>
+          <Text className='password-verify-dialog__close' onClick={handleCancel}>
+            ×
+          </Text>
+        </View>
+        <View className='password-verify-dialog__body'>
+          {description ? (
+            <Text className='password-verify-dialog__description'>{description}</Text>
+          ) : null}
+          <Text className='password-verify-dialog__label'>
+            {passwordLabel || t('core.password.verify_label')}
+          </Text>
+          <Input
+            className='password-verify-dialog__input'
+            password
+            value={password}
+            placeholder={passwordPlaceholder || t('core.crypto.password_required')}
+            onInput={(event) => {
+              setPassword(event.detail.value)
+              setErrorMessage('')
+            }}
+            onConfirm={() => void handleConfirm()}
+          />
+          {errorMessage ? (
+            <Text className='password-verify-dialog__error'>{errorMessage}</Text>
+          ) : null}
+        </View>
+        <View className='password-verify-dialog__footer'>
+          <Button
+            className='password-verify-dialog__button password-verify-dialog__button--cancel'
+            disabled={submitting}
+            onClick={handleCancel}
+          >
+            {cancelText || t('common.action.cancel')}
+          </Button>
+          <Button
+            className='password-verify-dialog__button password-verify-dialog__button--confirm'
+            loading={submitting}
+            onClick={() => void handleConfirm()}
+          >
+            {confirmText || t('common.action.confirm')}
+          </Button>
+        </View>
+      </View>
+    </View>
+  )
+}

package/src/index.ts

@@ -38,3 +38,5 @@ export * from './utils/file'
 export * from './utils/index'
 export * from './utils/navigation'
 export * from './utils/passwordCrypto'
+export { default as PasswordVerifyDialog } from './components/PasswordVerifyDialog'
+export type { PasswordVerifyDialogProps } from './components/PasswordVerifyDialog'

package/src/locales/README.md

@@ -1,11 +1,12 @@
 # Taro Core 语言包
 
-本目录提供 Taro 应用底座和公共页面使用的稳定文案，包括登录、启动状态、导航、认证、文件处理和网络错误提示。语言包由 `../index.ts` 的 `coreModule` 导入并注册，应用启动时由 `bootstrapKratosTaroApp` 调用 `registerLocaleMessages` 合并；页面、hooks、请求工具通过 `useI18n()` 或 `t()` 使用。
+本目录提供 Taro 应用底座和公共页面使用的稳定文案，包括登录、启动状态、导航、认证、MFA/WebAuthn、文件处理和网络错误提示。语言包由 `../index.ts` 的 `coreModule` 导入并注册，应用启动时由 `bootstrapKratosTaroApp` 调用 `registerLocaleMessages` 合并；页面、hooks、请求工具通过 `useI18n()` 或 `t()` 使用。
 
 | 文件 | 用途 | 使用位置 |
 | --- | --- | --- |
 | `zh-CN.json` | 简体中文固定 UI 默认语言包，也是所有语言键集合和占位符校验基准。 | Taro 固定文案默认语言及缺失翻译回退。 |
 | `zh-TW.json` | 繁体中文 Core 语言包。 | Taro 切换为繁体中文时使用。 |
 | `en-US.json` | 英文 Core 语言包。 | Taro 切换为英文时使用。 |
+| `ja-JP.json` | 日文 Core 语言包。 | Taro 切换为日文时使用。 |
 
 语言包是标准 JSON，不能在文件内直接写注释；公共键使用 `common.` 或 `core.` 命名空间。新增语言后执行仓库根目录的 `make i18n-sync`。语言切换选项固定显示后端 `base_language.native_name`，接口不可用时使用代码内置的原生名称；`common.language.*` 仅用于普通文案和语言迁移初始数据。新增语言的完整文件清单见[国际化语言扩展指南](../../../../../../docs/国际化语言扩展指南.md)。

package/src/locales/en-US.json

@@ -27,6 +27,8 @@
   "core.crypto.password_required": "Password is required",
   "core.crypto.password_too_long": "Password exceeds the supported length",
   "core.crypto.public_key_invalid": "Invalid public key",
+  "core.password.verify_title": "Verify password",
+  "core.password.verify_label": "Current password",
   "core.file.download_failed": "Download failed",
   "core.file.temporary_path_required": "Use a temporary file path when uploading from a Mini Program",
   "core.file.upload_failed": "Upload failed",
@@ -60,6 +62,23 @@
   "core.login.default_sub_title": "Welcome",
   "core.login.login_failed": "Login failed. Try again.",
   "core.login.login_success": "Logged in",
+  "core.login.mfa_title": "Multi-factor authentication",
+  "core.login.mfa_code": "Enter the authenticator code",
+  "core.login.mfa_recovery_code": "Recovery code (optional)",
+  "core.login.mfa_setup_title": "Bind multi-factor authentication",
+  "core.login.mfa_copy_uri": "Copy binding address",
+  "core.login.mfa_copy_success": "Binding address copied",
+  "core.login.mfa_recovery_codes_copied": "Recovery codes copied",
+  "core.login.mfa_recovery_codes_title": "Save MFA recovery codes",
+  "core.login.mfa_recovery_codes_warning": "Each code works once and will not be shown again after this dialog closes.",
+  "core.login.mfa_copy_recovery_codes": "Copy recovery codes",
+  "core.login.mfa_recovery_codes_confirm": "I saved them",
+  "core.login.mfa_setup_success": "Multi-factor authentication enabled. Please sign in again.",
+  "core.login.mfa_webauthn_action": "Use passkey",
+  "core.login.mfa_webauthn_setup_unsupported": "WebAuthn is not supported on this platform. Use TOTP or a recovery code.",
+  "core.login.mfa_webauthn_setup_invalid": "WebAuthn registration did not return a valid credential.",
+  "core.login.mfa_webauthn_login_unsupported": "WebAuthn is not supported on this platform. Use a recovery code.",
+  "core.login.mfa_webauthn_login_invalid": "WebAuthn authentication did not return a valid credential.",
   "core.login.password": "Enter password",
   "core.login.privacy": "Privacy Policy",
   "core.login.protocol_missing": "Terms of Service and Privacy Policy are not configured",
@@ -73,6 +92,7 @@
   "core.login.wechat_bind_tip": "This WeChat account is not linked. Log in to an existing account to link it.",
   "core.login.wechat_failed": "WeChat login failed. Try again later.",
   "core.navigation.home": "Home",
+  "core.navigation.message": "Messages",
   "core.navigation.error.access": "Invalid menu access mode: {access}",
   "core.navigation.error.child_tab": "Only second-level app menus can be tabs: {name}",
   "core.navigation.error.cycle": "Menu parent cycle detected: {name}",
@@ -101,5 +121,9 @@
   "core.status.loading": "Loading",
   "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"
+  "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}"
 }

package/src/locales/index.ts

@@ -119,7 +119,7 @@ export function registerLocaleMessages(modules: KratosTaroModule[]): void {
       }
       const target = localeMessages.get(locale) as LocaleMessages
       Object.keys(messages).forEach((key) => {
-        if (!key.startsWith('common.') && !key.startsWith('core.') && !key.startsWith('system.')) {
+        if (!isAllowedLocaleKey(module.name, key)) {
           throw new Error(`${module.name} 的语言键命名空间无效: ${key}`)
         }
         if (Object.prototype.hasOwnProperty.call(target, key)) {
@@ -132,6 +132,15 @@ export function registerLocaleMessages(modules: KratosTaroModule[]): void {
   })
 }
 
+/** 校验公共键和当前业务模块专属的语言键命名空间。 */
+function isAllowedLocaleKey(moduleName: string, key: string): boolean {
+  const packageName = moduleName.split('/').at(-1) ?? moduleName
+  const moduleNamespace = packageName.split('-').at(-1) ?? packageName
+  return ['common', 'core', 'system', moduleNamespace].some((namespace) =>
+    key.startsWith(`${namespace}.`),
+  )
+}
+
 /** 获取当前语言区域。 */
 export function getCurrentLocale(): SupportedLocale {
   return useLocaleStore.getState().locale

package/src/locales/ja-JP.json

@@ -27,6 +27,8 @@
   "core.crypto.password_required": "パスワードを空にすることはできません",
   "core.crypto.password_too_long": "パスワードの長さが制限を超えています",
   "core.crypto.public_key_invalid": "公開鍵の形式が無効です",
+  "core.password.verify_title": "パスワードの確認",
+  "core.password.verify_label": "現在のパスワード",
   "core.file.download_failed": "ダウンロードに失敗しました",
   "core.file.temporary_path_required": "ミニ プログラムをアップロードするには、一時ファイル パスを使用してください。",
   "core.file.upload_failed": "アップロードに失敗しました",
@@ -60,6 +62,23 @@
   "core.login.default_sub_title": "このアプリケーションへようこそ",
   "core.login.login_failed": "ログインに失敗しました。もう一度お試しください。",
   "core.login.login_success": "ログインに成功しました",
+  "core.login.mfa_title": "多要素認証",
+  "core.login.mfa_code": "認証コードを入力",
+  "core.login.mfa_recovery_code": "リカバリーコード（任意）",
+  "core.login.mfa_setup_title": "多要素認証を設定",
+  "core.login.mfa_copy_uri": "登録アドレスをコピー",
+  "core.login.mfa_copy_success": "登録アドレスをコピーしました",
+  "core.login.mfa_recovery_codes_copied": "リカバリーコードをコピーしました",
+  "core.login.mfa_recovery_codes_title": "MFA リカバリーコードを保存",
+  "core.login.mfa_recovery_codes_warning": "各コードは一度だけ使用でき、ダイアログを閉じると再表示されません。",
+  "core.login.mfa_copy_recovery_codes": "リカバリーコードをコピー",
+  "core.login.mfa_recovery_codes_confirm": "保存しました",
+  "core.login.mfa_setup_success": "多要素認証を設定しました。再度ログインしてください。",
+  "core.login.mfa_webauthn_action": "パスキーを使用",
+  "core.login.mfa_webauthn_setup_unsupported": "このプラットフォームは WebAuthn に対応していません。TOTP またはリカバリーコードを使用してください。",
+  "core.login.mfa_webauthn_setup_invalid": "WebAuthn 登録で有効なクレデンシャルが返されませんでした。",
+  "core.login.mfa_webauthn_login_unsupported": "このプラットフォームは WebAuthn に対応していません。リカバリーコードを使用してください。",
+  "core.login.mfa_webauthn_login_invalid": "WebAuthn 認証で有効なクレデンシャルが返されませんでした。",
   "core.login.password": "パスワードを入力してください",
   "core.login.privacy": "「プライバシー規約」",
   "core.login.protocol_missing": "利用規約とプライバシー規約が設定されていません",
@@ -73,6 +92,7 @@
   "core.login.wechat_bind_tip": "この WeChat アカウントはまだバインドされていません。バインドを完了するには、既存のアカウントにログインしてください。",
   "core.login.wechat_failed": "WeChat ログインに失敗しました。後でもう一度試してください。",
   "core.navigation.home": "ホーム",
+  "core.navigation.message": "メッセージ",
   "core.navigation.error.access": "無効なメニュー アクセス モード: {access}",
   "core.navigation.error.child_tab": "モバイル セカンダリ メニューのみがタブとして使用できます: {name}",
   "core.navigation.error.cycle": "モバイル メニューにはループの親があります: {name}",
@@ -101,5 +121,9 @@
   "core.status.loading": "をロードしています",
   "core.webview.embed_blocked": "現在の H5 ページは、ターゲット サイトによって埋め込みが制限されている可能性があります",
   "core.webview.invalid_url": "有効なリンク アドレスがありません",
-  "core.webview.open_failed": "リンクを開けません"
+  "core.webview.open_failed": "リンクを開けません",
+  "common.value.top_level": "トップレベル",
+  "common.resource.default": "{resource}",
+  "common.action.delete_resource": "{resource}を削除",
+  "common.action.set_field_status": "{field}を設定"
 }

package/src/locales/zh-CN.json

@@ -27,6 +27,8 @@
   "core.crypto.password_required": "密码不能为空",
   "core.crypto.password_too_long": "密码长度超出限制",
   "core.crypto.public_key_invalid": "公钥格式无效",
+  "core.password.verify_title": "验证密码",
+  "core.password.verify_label": "当前密码",
   "core.file.download_failed": "下载失败",
   "core.file.temporary_path_required": "小程序端请使用文件临时路径上传",
   "core.file.upload_failed": "上传失败",
@@ -60,6 +62,23 @@
   "core.login.default_sub_title": "欢迎使用本应用",
   "core.login.login_failed": "登录失败，请重试",
   "core.login.login_success": "登录成功",
+  "core.login.mfa_title": "多因素认证",
+  "core.login.mfa_code": "请输入动态口令",
+  "core.login.mfa_recovery_code": "恢复码（可选）",
+  "core.login.mfa_setup_title": "绑定多因素认证",
+  "core.login.mfa_copy_uri": "复制绑定地址",
+  "core.login.mfa_copy_success": "绑定地址已复制",
+  "core.login.mfa_recovery_codes_copied": "恢复码已复制",
+  "core.login.mfa_recovery_codes_title": "保存 MFA 恢复码",
+  "core.login.mfa_recovery_codes_warning": "每个恢复码只能使用一次，此弹窗关闭后不会再次显示。",
+  "core.login.mfa_copy_recovery_codes": "复制恢复码",
+  "core.login.mfa_recovery_codes_confirm": "我已保存",
+  "core.login.mfa_setup_success": "多因素认证绑定成功，请重新登录。",
+  "core.login.mfa_webauthn_action": "使用 Passkey",
+  "core.login.mfa_webauthn_setup_unsupported": "当前平台不支持 WebAuthn，请使用 TOTP 或恢复码。",
+  "core.login.mfa_webauthn_setup_invalid": "WebAuthn 注册未返回有效凭据。",
+  "core.login.mfa_webauthn_login_unsupported": "当前平台不支持 WebAuthn，请使用恢复码。",
+  "core.login.mfa_webauthn_login_invalid": "WebAuthn 登录未返回有效凭据。",
   "core.login.password": "请输入密码",
   "core.login.privacy": "《隐私协议》",
   "core.login.protocol_missing": "服务条款和隐私协议未配置",
@@ -73,6 +92,7 @@
   "core.login.wechat_bind_tip": "该微信尚未绑定，请登录已有账号完成绑定",
   "core.login.wechat_failed": "微信登录失败，请稍后重试",
   "core.navigation.home": "首页",
+  "core.navigation.message": "消息",
   "core.navigation.error.access": "菜单访问模式无效：{access}",
   "core.navigation.error.child_tab": "只有移动端二级菜单可以作为 tab：{name}",
   "core.navigation.error.cycle": "移动端菜单存在循环父级：{name}",
@@ -101,5 +121,9 @@
   "core.status.loading": "正在加载",
   "core.webview.embed_blocked": "当前 H5 页面可能被目标站点限制嵌入",
   "core.webview.invalid_url": "缺少有效链接地址",
-  "core.webview.open_failed": "链接无法打开"
+  "core.webview.open_failed": "链接无法打开",
+  "common.value.top_level": "顶级节点",
+  "common.resource.default": "{resource}",
+  "common.action.delete_resource": "删除{resource}",
+  "common.action.set_field_status": "设置{field}"
 }

package/src/locales/zh-TW.json

@@ -27,6 +27,8 @@
   "core.crypto.password_required": "密碼不能為空",
   "core.crypto.password_too_long": "密碼長度超出限制",
   "core.crypto.public_key_invalid": "公鑰格式無效",
+  "core.password.verify_title": "驗證密碼",
+  "core.password.verify_label": "當前密碼",
   "core.file.download_failed": "下載失敗",
   "core.file.temporary_path_required": "小程式端請使用檔案臨時路徑上傳",
   "core.file.upload_failed": "上傳失敗",
@@ -60,6 +62,23 @@
   "core.login.default_sub_title": "歡迎使用本應用",
   "core.login.login_failed": "登入失敗，請重試",
   "core.login.login_success": "登入成功",
+  "core.login.mfa_title": "多因素認證",
+  "core.login.mfa_code": "請輸入動態密碼",
+  "core.login.mfa_recovery_code": "恢復碼（可選）",
+  "core.login.mfa_setup_title": "綁定多因素認證",
+  "core.login.mfa_copy_uri": "複製綁定地址",
+  "core.login.mfa_copy_success": "綁定地址已複製",
+  "core.login.mfa_recovery_codes_copied": "恢復碼已複製",
+  "core.login.mfa_recovery_codes_title": "儲存 MFA 恢復碼",
+  "core.login.mfa_recovery_codes_warning": "每個恢復碼只能使用一次，關閉此視窗後不會再次顯示。",
+  "core.login.mfa_copy_recovery_codes": "複製恢復碼",
+  "core.login.mfa_recovery_codes_confirm": "我已儲存",
+  "core.login.mfa_setup_success": "多因素認證綁定成功，請重新登入。",
+  "core.login.mfa_webauthn_action": "使用 Passkey",
+  "core.login.mfa_webauthn_setup_unsupported": "目前平台不支援 WebAuthn，請使用 TOTP 或恢復碼。",
+  "core.login.mfa_webauthn_setup_invalid": "WebAuthn 註冊未回傳有效憑證。",
+  "core.login.mfa_webauthn_login_unsupported": "目前平台不支援 WebAuthn，請使用恢復碼。",
+  "core.login.mfa_webauthn_login_invalid": "WebAuthn 登入未回傳有效憑證。",
   "core.login.password": "請輸入密碼",
   "core.login.privacy": "《隱私協議》",
   "core.login.protocol_missing": "服務條款和隱私協議未配置",
@@ -73,6 +92,7 @@
   "core.login.wechat_bind_tip": "該微信尚未繫結，請登入已有賬號完成繫結",
   "core.login.wechat_failed": "微信登入失敗，請稍後重試",
   "core.navigation.home": "首頁",
+  "core.navigation.message": "消息",
   "core.navigation.error.access": "選單訪問模式無效：{access}",
   "core.navigation.error.child_tab": "只有移動端二級選單可以作為 tab：{name}",
   "core.navigation.error.cycle": "移動端選單存在迴圈父級：{name}",
@@ -101,5 +121,9 @@
   "core.status.loading": "正在載入",
   "core.webview.embed_blocked": "當前 H5 頁面可能被目標站點限制嵌入",
   "core.webview.invalid_url": "缺少有效連結地址",
-  "core.webview.open_failed": "連結無法開啟"
+  "core.webview.open_failed": "連結無法開啟",
+  "common.value.top_level": "頂級節點",
+  "common.resource.default": "{resource}",
+  "common.action.delete_resource": "刪除{resource}",
+  "common.action.set_field_status": "設定{field}"
 }

package/src/navigation.ts

@@ -51,6 +51,24 @@ export interface AppNavigationState {
   tabBar: AppMenuNode[]
 }
 
+/** 移动端菜单未读 badge 状态。 */
+interface AppMenuBadgeState {
+  badges: Record<string, number>
+}
+
+/** 移动端菜单 badge 状态容器。 */
+export const useAppMenuBadges = create<AppMenuBadgeState>(() => ({ badges: {} }))
+
+/** 设置移动端菜单 badge 数量，供业务模块注册未读状态。 */
+export function setAppMenuBadge(viewKey: string, count: number): void {
+  useAppMenuBadges.setState((state) => {
+    const badges = { ...state.badges }
+    if (count > 0) badges[viewKey] = Math.min(Math.floor(count), 99)
+    else delete badges[viewKey]
+    return { badges }
+  })
+}
+
 const ANONYMOUS_CACHE_KEY = 'kratos-taro-app:navigation:anonymous'
 const AUTHENTICATED_CACHE_KEY = 'kratos-taro-app:navigation:authenticated'
 /** 固定移动端菜单根目录编号。 */
@@ -69,6 +87,18 @@ export const defaultAppMenus: AppMenu[] = [
     icon: 'HOME_DEFAULT',
     selectedIcon: 'HOME_SELECTED',
   },
+  {
+    id: 9990904,
+    parentId: APP_MENU_ROOT_ID,
+    name: 'AppMessage',
+    path: 'app/message',
+    viewKey: 'MESSAGE_INBOX',
+    title: '',
+    access: 'AUTHENTICATED',
+    inTabBar: true,
+    icon: 'MESSAGE_DEFAULT',
+    selectedIcon: 'MESSAGE_SELECTED',
+  },
   {
     id: 99909,
     parentId: APP_MENU_ROOT_ID,
@@ -145,6 +175,7 @@ export const defaultAppMenus: AppMenu[] = [
 
 const defaultMenuTitleKeys: Record<string, string> = {
   AppHome: 'core.navigation.home',
+  AppMessage: 'core.navigation.message',
   AppMy: 'core.navigation.my',
   AppLogin: 'common.action.login',
   AppProtocol: 'core.navigation.protocol',
@@ -256,6 +287,26 @@ export function navigateAppRoute(
   void Taro.navigateTo({ url, fail: () => void Taro.reLaunch({ url }) })
 }
 
+/** 按稳定 viewKey 跳转，并将动作参数作为查询参数传递。 */
+export function navigateAppView(viewKey: string, params: Record<string, string> = {}): void {
+  const menu = useAppNavigation.getState().menus.find((item) => item.viewKey === viewKey)
+  if (!menu) {
+    launchAppStatus('NOT_FOUND')
+    return
+  }
+  const remaining = { ...params }
+  const path = menu.path.replace(/:([A-Za-z0-9_]+)/g, (placeholder, key: string) => {
+    if (!(key in remaining)) return placeholder
+    const value = remaining[key]
+    delete remaining[key]
+    return encodeURIComponent(value)
+  })
+  const query = Object.entries(remaining)
+    .map(([key, value]) => `${encodeURIComponent(key)}=${encodeURIComponent(value)}`)
+    .join('&')
+  navigateAppRoute(`${path}${query ? `?${query}` : ''}`)
+}
+
 /** 切换 tab 页面，优先复用已有页面，避免重建页面栈产生空白帧。 */
 function navigateTabRoute(url: string): void {
   const targetRoute = url.slice(1).split('?', 1)[0].replace(/^\/+/, '')