diff --git a/docs/project-memory/shared-memory/decision-log.md b/docs/project-memory/shared-memory/decision-log.md index 9001256a..191f438e 100644 --- a/docs/project-memory/shared-memory/decision-log.md +++ b/docs/project-memory/shared-memory/decision-log.md @@ -2292,6 +2292,7 @@ - 背景：Expo 移动壳和 Tauri 桌面壳都需要一个真实的宿主级刷新入口，供 H5 在检测到资源、登录态或运行态需要重新载入时请求宿主刷新当前容器；该能力不能演变成任意 URL 导航或原生 WebView ref 透传。 - 决策：新增 HostBridge method `app.reloadWebView` 和 H5 facade `reloadHostWebView()`。移动端只调用当前 `react-native-webview` 的 `reload()`，桌面端只调用 Tauri 主 `WebviewWindow.reload()`；该 method 不接受 payload，成功只表示宿主已发起刷新，刷新后当前 H5 上下文会卸载。继续把同源跳转留给 `navigation.openNativePage`，外链离开容器留给 `app.openExternalUrl`。 +- 2026-06-18 追加：`AuthGate` 登录态身份边界刷新改为优先调用 `reloadHostWebView()`，用于登录成功、退出登录或从已登录变为未登录后的主站重新初始化；宿主未声明、返回失败或不可用时再回退浏览器 `window.location.reload()`，普通 token refresh、账号资料更新、主题和音量变化仍不触发整页刷新。 - 影响范围：`packages/shared/src/contracts/hostBridge.ts`、`src/services/host-bridge/hostBridge.ts`、`apps/mobile-shell/`、`apps/desktop-shell/`、原生壳能力检查脚本和 HostBridge 架构文档。 - 验证方式：`npm run check:native-shells`、`npm run typecheck`、`npm run check:encoding`、`git diff --check`。 diff --git a/docs/【前端架构】ExpoReactNative与Tauri宿主壳方案-2026-06-17.md b/docs/【前端架构】ExpoReactNative与Tauri宿主壳方案-2026-06-17.md index 2dfd15cb..0ed36614 100644 --- a/docs/【前端架构】ExpoReactNative与Tauri宿主壳方案-2026-06-17.md +++ b/docs/【前端架构】ExpoReactNative与Tauri宿主壳方案-2026-06-17.md @@ -268,6 +268,8 @@ GameBridge 禁止： 2026-06-18 追加：H5 的平台外部生成队列概览开始消费 `network.status` / `network.statusChanged`。宿主未声明网络能力时继续按原逻辑轮询；宿主明确离线或不可达时暂停概览请求，恢复在线后重新刷新，不改变生成任务、作品架或后端回读事实。 +2026-06-18 追加：H5 账号状态刷新开始消费 `app.reloadWebView`。用户登录成功、退出登录或其它身份边界变化需要整页重新初始化时，`AuthGate` 会优先请求 Expo 壳刷新当前 WebView；宿主未声明或刷新失败时再回退浏览器刷新，避免在移动壳内绕过受控容器刷新入口。 + ### Phase 3：Tauri 桌面壳 MVP - 新增 `apps/desktop-shell/`。 @@ -289,6 +291,8 @@ GameBridge 禁止： 2026-06-18 追加：H5 的作品架未读草稿生成完成更新开始消费 `app.setBadgeCount`。Tauri 壳仍只通过主窗口受控设置任务栏角标，不开放任意窗口或系统托盘插件 API；H5 只同步可见作品架内未读完成草稿数量，同一草稿多恢复 ID 只计 1，宿主不支持或设置失败不影响 H5 红点与作品架状态。 +2026-06-18 追加：H5 账号状态刷新开始消费 `app.reloadWebView`。用户登录成功、退出登录或其它身份边界变化需要整页重新初始化时，`AuthGate` 会优先请求 Tauri 主 WebViewWindow 刷新；宿主未声明或刷新失败时再回退浏览器刷新，Tauri 仍只暴露 `host_bridge_request` 这一受控命令入口。 + ### Phase 4：宿主能力扩展 - 移动端接入系统分享、推送、原生登录和渠道支付。 diff --git a/docs/【前端架构】宿主壳能力统一协议-2026-06-17.md b/docs/【前端架构】宿主壳能力统一协议-2026-06-17.md index ee8be6ec..cc11d5bf 100644 --- a/docs/【前端架构】宿主壳能力统一协议-2026-06-17.md +++ b/docs/【前端架构】宿主壳能力统一协议-2026-06-17.md @@ -54,7 +54,7 @@ AI H5 sandbox - `showHostLocalNotification()`：原生 App 宿主的受控即时本地通知入口。H5 只能传必填 `title` 和可选 `body`，两者都会去除首尾空白、折叠普通空白、限制长度并拒绝控制字符；Expo 移动壳通过 `expo-notifications` 请求通知权限、创建 Android 本地通知 channel 并立刻调度本地通知，Tauri 桌面壳通过 Rust 侧 `tauri-plugin-notification` 发送系统通知。该能力不包含远程推送、token 注册、定时提醒、后台远程通知或任意通知插件透传，宿主未声明、权限拒绝或系统失败时由 H5 视作失败并继续主流程。当前 H5 只在现有草稿生成任务收口为完成或失败时请求即时本地通知；通知按草稿来源去重，同一草稿重新进入生成中后才允许再次通知，不改变队列状态、弹窗、作品架或后端裁决。 - `setHostAppTitle()`：原生 App 宿主的受控窗口标题入口。H5 主站会按当前平台阶段先同步 `document.title`，再通过 `app.setTitle` 请求宿主窗口标题同步；Tauri 桌面壳支持该能力，Expo 移动壳不声明时静默忽略。 - `setHostAppBadgeCount()`：原生 App 宿主的受控应用角标入口。H5 只传 `0-99999` 的整数，`0` 表示清除角标；Expo 移动壳只在 iOS 声明 `app.setBadgeCount` 并通过 React Native `PushNotificationIOS` 设置应用图标角标，Android 不声明该能力；Tauri 桌面壳通过主窗口 `set_badge_count` 设置任务栏角标，底层平台不支持时返回明确错误，由 H5 视作失败并继续主流程。当前 H5 只把“可见作品架里未读的草稿生成完成更新”同步为角标数，同一个草稿有多个恢复 ID 时只计 1，已读、失败、生成中和不可见草稿不计入；宿主不支持或设置失败不改变 H5 红点、作品架或后端状态。 -- `reloadHostWebView()`：原生 App 宿主的受控 WebView 刷新入口。H5 只能请求刷新当前承载主站的宿主 WebView；Expo 移动壳调用当前 `react-native-webview` 的 `reload()`，Tauri 桌面壳调用主 `WebviewWindow.reload()`。该能力不接受 payload，不开放任意 URL 导航、脚本执行、Tauri guest API 或 RN WebView ref；成功只表示宿主已发起刷新，刷新后当前 H5 上下文会卸载。 +- `reloadHostWebView()`：原生 App 宿主的受控 WebView 刷新入口。H5 只能请求刷新当前承载主站的宿主 WebView；Expo 移动壳调用当前 `react-native-webview` 的 `reload()`，Tauri 桌面壳调用主 `WebviewWindow.reload()`。该能力不接受 payload，不开放任意 URL 导航、脚本执行、Tauri guest API 或 RN WebView ref；成功只表示宿主已发起刷新，刷新后当前 H5 上下文会卸载。`AuthGate` 在登录态从未登录变为已登录、或从已登录变为未登录时优先调用该能力刷新当前容器；宿主未声明、返回失败或不可用时再回退浏览器 `window.location.reload()`。 - `openHostExternalUrl()`：原生 App 宿主的受控外链入口。H5 中需要离开主站的外链在 `native_app` 下先通过 `app.openExternalUrl` 请求宿主系统浏览器打开；只允许 `http:`、`https:`、`mailto:`、`tel:`，相对路径会先归一化到当前站点绝对 URL。宿主不可用或拒绝时回退浏览器外链行为，普通浏览器和小程序保持原有 `` 语义。 - `navigateHostNativePage()`：受控跳转宿主页，供订阅授权、支付、登录等 adapter 复用。Expo 移动壳首版只接受同源 H5 route 并切换 WebView URL；Tauri 桌面壳同样只接受 `https://app.genarrative.world` 同源 H5 route 并在主窗口内跳转。真正原生页面、登录和支付能力必须等对应 SDK / 页面接入后再声明支持。 - `exportHostTextFile()`：原生 App 宿主的受控文本导出入口。Expo 移动壳通过 `file.exportText` 写入缓存文本文件并交给系统分享 / 保存面板；Tauri 桌面壳通过 `file.exportText` 打开系统保存对话框并写入用户选择的文件。文件名必须清洗，单次文本不超过 5 MiB，成功只返回文件名和字节数，不把本机绝对路径暴露给 H5；系统分享不可用或用户取消时返回明确错误，由 H5 fallback 承接。 diff --git a/src/components/auth/AuthGate.test.tsx b/src/components/auth/AuthGate.test.tsx index 5cbd66d5..eafccf77 100644 --- a/src/components/auth/AuthGate.test.tsx +++ b/src/components/auth/AuthGate.test.tsx @@ -7,9 +7,15 @@ import { afterEach, beforeEach, expect, test, vi } from 'vitest'; import type { AuthSessionSummary, AuthUser } from '../../services/authService'; import { LEGAL_CONSENT_STORAGE_KEY } from '../common/legalDocuments'; -import { AuthGate, setAuthGateReloadForTest } from './AuthGate'; +import { + AuthGate, + setAuthGateBrowserReloadForTest, + setAuthGateReloadForTest, +} from './AuthGate'; import { useAuthUi } from './AuthUiContext'; +const browserReloadMock = vi.hoisted(() => vi.fn()); + const authMocks = vi.hoisted(() => ({ authEntry: vi.fn(), changePassword: vi.fn(), @@ -84,11 +90,13 @@ const hostBridgeMocks = vi.hoisted(() => ({ miniProgramEnv: null as string | null, })), requestHostLogin: vi.fn(), + reloadHostWebView: vi.fn(), })); vi.mock('../../services/host-bridge/hostBridge', () => ({ getHostRuntime: hostBridgeMocks.getHostRuntime, requestHostLogin: hostBridgeMocks.requestHostLogin, + reloadHostWebView: hostBridgeMocks.reloadHostWebView, })); vi.mock('../../hooks/useGameSettings', () => ({ @@ -131,6 +139,7 @@ beforeEach(() => { window.localStorage.clear(); window.history.replaceState(null, '', '/'); setAuthGateReloadForTest(vi.fn()); + setAuthGateBrowserReloadForTest(browserReloadMock); authMocks.consumeAuthCallbackResult.mockReturnValue(null); authMocks.ensureStoredAccessToken.mockResolvedValue('jwt-existing-token'); authMocks.getStoredAccessToken.mockReturnValue(''); @@ -189,10 +198,12 @@ beforeEach(() => { miniProgramEnv: null, }); hostBridgeMocks.requestHostLogin.mockResolvedValue(true); + hostBridgeMocks.reloadHostWebView.mockResolvedValue(false); }); afterEach(() => { setAuthGateReloadForTest(null); + setAuthGateBrowserReloadForTest(null); }); async function acceptLegalConsent( @@ -780,6 +791,56 @@ test('logout withdraws user context before backend request finishes', async () = expect(reload).toHaveBeenCalledTimes(1); }); +test('auth state reload uses native host webview reload before browser reload', async () => { + const user = userEvent.setup(); + setAuthGateReloadForTest(null); + hostBridgeMocks.reloadHostWebView.mockResolvedValueOnce(true); + authMocks.getCurrentAuthUser.mockResolvedValue({ + user: mockUser, + availableLoginMethods: ['phone'], + }); + + render( + + + , + ); + + expect(await screen.findByText('当前用户：测试玩家')).toBeTruthy(); + + await user.click(screen.getByRole('button', { name: '退出登录' })); + + await waitFor(() => { + expect(hostBridgeMocks.reloadHostWebView).toHaveBeenCalledTimes(1); + }); + expect(browserReloadMock).not.toHaveBeenCalled(); +}); + +test('auth state reload falls back to browser reload when native host cannot reload', async () => { + const user = userEvent.setup(); + setAuthGateReloadForTest(null); + hostBridgeMocks.reloadHostWebView.mockResolvedValueOnce(false); + authMocks.getCurrentAuthUser.mockResolvedValue({ + user: mockUser, + availableLoginMethods: ['phone'], + }); + + render( + + + , + ); + + expect(await screen.findByText('当前用户：测试玩家')).toBeTruthy(); + + await user.click(screen.getByRole('button', { name: '退出登录' })); + + await waitFor(() => { + expect(hostBridgeMocks.reloadHostWebView).toHaveBeenCalledTimes(1); + expect(browserReloadMock).toHaveBeenCalledTimes(1); + }); +}); + test('auth gate shows sms send feedback in the login modal', async () => { const user = userEvent.setup(); diff --git a/src/components/auth/AuthGate.tsx b/src/components/auth/AuthGate.tsx index 5ceb39fa..300a4109 100644 --- a/src/components/auth/AuthGate.tsx +++ b/src/components/auth/AuthGate.tsx @@ -47,6 +47,7 @@ import { } from '../../services/authService'; import { getHostRuntime, + reloadHostWebView, requestHostLogin, } from '../../services/host-bridge/hostBridge'; import { PlatformActionButton } from '../common/PlatformActionButton'; @@ -70,12 +71,31 @@ type AuthStatus = const REQUIRED_LOGIN_METHODS: AuthLoginMethod[] = ['phone', 'password']; -let reloadCurrentPageForAuthStateChange = () => { +let reloadBrowserPageForAuthStateChange = () => { window.location.reload(); }; +function reloadHostPageForAuthStateChange() { + void reloadHostWebView() + .then((handled) => { + if (!handled) { + reloadBrowserPageForAuthStateChange(); + } + }) + .catch(() => { + reloadBrowserPageForAuthStateChange(); + }); +} + +let reloadCurrentPageForAuthStateChange = reloadHostPageForAuthStateChange; + export function setAuthGateReloadForTest(handler: (() => void) | null) { reloadCurrentPageForAuthStateChange = + handler ?? reloadHostPageForAuthStateChange; +} + +export function setAuthGateBrowserReloadForTest(handler: (() => void) | null) { + reloadBrowserPageForAuthStateChange = handler ?? (() => { window.location.reload();