From 20e4e88bd488f9e355685a15dfaa9a9a58839d86 Mon Sep 17 00:00:00 2001 From: kdletters Date: Thu, 18 Jun 2026 07:18:42 +0800 Subject: [PATCH] =?UTF-8?q?=E5=90=8C=E6=AD=A5=E8=8D=89=E7=A8=BF=E6=9C=AA?= =?UTF-8?q?=E8=AF=BB=E5=8E=9F=E7=94=9F=E8=A7=92=E6=A0=87?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 平台壳按可见作品架未读完成草稿同步 app.setBadgeCount 新增草稿未读更新计数模型并覆盖多恢复ID去重 更新原生壳方案、HostBridge 协议和共享决策记录 --- .../shared-memory/decision-log.md | 1 + ...ExpoReactNative与Tauri宿主壳方案-2026-06-17.md | 4 + ...前端架构】宿主壳能力统一协议-2026-06-17.md | 2 +- .../PlatformEntryFlowShellImpl.tsx | 62 ++++++++-------- .../platformDraftGenerationShelfModel.test.ts | 58 +++++++++++++++ .../platformDraftGenerationShelfModel.ts | 73 +++++++++++++++++++ 6 files changed, 170 insertions(+), 30 deletions(-) diff --git a/docs/project-memory/shared-memory/decision-log.md b/docs/project-memory/shared-memory/decision-log.md index 9ddfe6f3..b3d7d44a 100644 --- a/docs/project-memory/shared-memory/decision-log.md +++ b/docs/project-memory/shared-memory/decision-log.md @@ -29,6 +29,7 @@ - 2026-06-18 原生壳统一验收门禁：根级 `npm run check:native-shells` 统一执行 H5 HostBridge 关键测试、Expo 壳 typecheck / test 和 Tauri 壳 typecheck / cargo test；根级 `npm run check` 会在 lint、主站测试、构建和内容检查后继续执行该门禁，避免 HostBridge 与两端壳验收散落成容易漏跑的单项命令。 - 2026-06-18 分享卡图片导出：新增 `file.exportImage` HostBridge capability，H5 分享卡下载在 native app 中优先把 canvas 生成的 base64 图片交给宿主导出；Expo 壳写缓存图片后交给系统分享 / 保存面板，Tauri 壳通过系统保存对话框写入图片字节。该能力只接受 `image/png` / `image/jpeg` / `image/webp`、单次 5 MiB 内图片数据，成功只返回文件名和字节数，不暴露本机绝对路径；宿主未声明时保留浏览器下载。 - 2026-06-18 应用角标能力：新增 `app.setBadgeCount` HostBridge capability，H5 只传 `0-99999` 整数并在宿主未声明时静默 fallback；Expo 壳只在 iOS 声明并通过 React Native `PushNotificationIOS` 设置应用图标角标，Android 不声明、不伪造成功；Tauri 壳通过主窗口 `set_badge_count` 设置任务栏角标，底层平台不支持时返回真实错误。 +- 2026-06-18 草稿生成未读角标：平台壳层把“可见作品架里未读的草稿生成完成更新”同步到 `app.setBadgeCount`；同一草稿的 work/profile/session 等多个恢复 ID 只计 1，已读、失败、生成中和不可见草稿不计入。该角标只消费已有 HostBridge 能力，宿主不支持或设置失败不影响 H5 红点、作品架或后端状态。 - 2026-06-18 宿主外观只读查询：新增 `appearance.getColorScheme` HostBridge capability，Expo 壳通过 React Native `Appearance.getColorScheme()` 读取系统配色，Tauri 壳通过主窗口 `theme()` 读取窗口主题；该能力只返回 `light` / `dark` / `unknown`，不设置 H5 主题、不覆盖系统主题，也不作为强制 UI 样式入口。 - 2026-06-18 原生壳生命周期事件：新增 `app.lifecycle` HostBridge capability，Expo 壳通过 React Native `AppState` 派发 `active` / `inactive` / `background`，Tauri 壳通过主窗口 focus / blur 派发 `active` / `inactive`；H5 只通过 `subscribeHostAppLifecycle()` 订阅统一状态，后续游戏循环、音频和轮询暂停 / 恢复不得直接依赖 Expo / Tauri 平台细节。 - 2026-06-18 原生壳网络状态：新增 `network.status` 与 `network.statusChanged` HostBridge capability，Expo 壳通过 `expo-network` 查询和订阅真实系统网络状态，Tauri 壳通过短超时连接 `app.genarrative.world:443` 查询主站可达性，并通过 WebView `online` / `offline` 注入变化事件；H5 统一使用 `getHostNetworkStatus()` / `subscribeHostNetworkStatusChange()`，不得直接读取 Expo / Tauri 私有网络 API。 diff --git a/docs/【前端架构】ExpoReactNative与Tauri宿主壳方案-2026-06-17.md b/docs/【前端架构】ExpoReactNative与Tauri宿主壳方案-2026-06-17.md index 5076af61..4f95f3b5 100644 --- a/docs/【前端架构】ExpoReactNative与Tauri宿主壳方案-2026-06-17.md +++ b/docs/【前端架构】ExpoReactNative与Tauri宿主壳方案-2026-06-17.md @@ -264,6 +264,8 @@ GameBridge 禁止： 2026-06-18 追加：H5 的草稿生成完成 / 失败收口开始消费 `notification.showLocal`。Expo 壳仍只发送即时本地通知，不注册远程推送 token、不做定时提醒；H5 按草稿来源对完成和失败通知去重，同一草稿重新进入生成中后才允许再次通知，通知失败不阻断弹窗、作品架和后端状态回读。 +2026-06-18 追加：H5 的作品架未读草稿生成完成更新开始消费 `app.setBadgeCount`。Expo 移动壳仍只在 iOS 声明该能力，Android 不声明、不伪造成功；H5 只同步可见作品架内未读完成草稿数量，同一草稿多恢复 ID 只计 1，宿主不支持或设置失败不影响 H5 红点与作品架状态。 + ### Phase 3：Tauri 桌面壳 MVP - 新增 `apps/desktop-shell/`。 @@ -281,6 +283,8 @@ GameBridge 禁止： 2026-06-18 追加：H5 的草稿生成完成 / 失败收口开始消费 `notification.showLocal`。Tauri 壳仍只通过 Rust 侧 notification 插件发送即时系统通知，不开放插件 JS guest API、远程推送、定时提醒或通知 token；H5 按草稿来源对完成和失败通知去重，同一草稿重新进入生成中后才允许再次通知，通知失败不阻断弹窗、作品架和后端状态回读。 +2026-06-18 追加：H5 的作品架未读草稿生成完成更新开始消费 `app.setBadgeCount`。Tauri 壳仍只通过主窗口受控设置任务栏角标，不开放任意窗口或系统托盘插件 API；H5 只同步可见作品架内未读完成草稿数量，同一草稿多恢复 ID 只计 1，宿主不支持或设置失败不影响 H5 红点与作品架状态。 + ### Phase 4：宿主能力扩展 - 移动端接入系统分享、推送、原生登录和渠道支付。 diff --git a/docs/【前端架构】宿主壳能力统一协议-2026-06-17.md b/docs/【前端架构】宿主壳能力统一协议-2026-06-17.md index 5d7b3085..5e7d5631 100644 --- a/docs/【前端架构】宿主壳能力统一协议-2026-06-17.md +++ b/docs/【前端架构】宿主壳能力统一协议-2026-06-17.md @@ -53,7 +53,7 @@ AI H5 sandbox - `requestHostHapticsImpact()`：原生 App 宿主的受控触觉反馈入口。Expo 移动壳通过 `haptics.impact` 调用 Expo Haptics；H5 运行时点击反馈在 `native_app` 中优先请求宿主触觉，宿主不可用、拒绝或返回 unsupported 时继续回退到浏览器 `navigator.vibrate`。 - `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 视作失败并继续主流程。 +- `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 上下文会卸载。 - `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 / 页面接入后再声明支持。 diff --git a/src/components/platform-entry/PlatformEntryFlowShellImpl.tsx b/src/components/platform-entry/PlatformEntryFlowShellImpl.tsx index fdb2ca26..4a9b9da2 100644 --- a/src/components/platform-entry/PlatformEntryFlowShellImpl.tsx +++ b/src/components/platform-entry/PlatformEntryFlowShellImpl.tsx @@ -190,7 +190,10 @@ import { saveBabyObjectMatchDraft, } from '../../services/edutainment-baby-object'; import { getExternalGenerationQueueOverview } from '../../services/external-generation'; -import { showHostLocalNotification } from '../../services/host-bridge/hostBridge'; +import { + setHostAppBadgeCount, + showHostLocalNotification, +} from '../../services/host-bridge/hostBridge'; import { jumpHopClient, type JumpHopGalleryCardResponse, @@ -481,13 +484,13 @@ import { buildPendingBigFishWorks, buildPendingJumpHopWorks, buildPendingMatch3DWorks, - buildPendingPuzzleClearWorks, buildPendingPuzzleWorks, buildPendingSquareHoleWorks, buildPendingVisualNovelWorks, buildPendingWoodenFishWorks, collectDraftNoticeKeys, collectVisibleDraftNoticeKeys, + countUnreadDraftGenerationUpdates, createPendingDraftShelfState, type DraftGenerationNoticeMap, type DraftGenerationNoticeStatus, @@ -3222,16 +3225,6 @@ export function PlatformEntryFlowShellImpl({ ], [jumpHopWorks, pendingDraftShelfItems], ); - const puzzleClearShelfItems = useMemo( - () => [ - ...buildPendingPuzzleClearWorks( - pendingDraftShelfItems['puzzle-clear'], - puzzleClearWorks, - ), - ...puzzleClearWorks, - ], - [pendingDraftShelfItems, puzzleClearWorks], - ); const woodenFishShelfItems = useMemo( () => [ ...buildPendingWoodenFishWorks( @@ -3298,28 +3291,24 @@ export function PlatformEntryFlowShellImpl({ }), [draftGenerationNotices, pendingDraftShelfItems], ); - const visibleDraftNoticeKeys = useMemo( - () => - collectVisibleDraftNoticeKeys({ - rpgItems: creationHubItems, - bigFishItems: bigFishShelfItems, - jumpHopItems: jumpHopShelfItems, - woodenFishItems: woodenFishShelfItems, - match3dItems: match3dShelfItems, - squareHoleItems: isSquareHoleCreationVisible - ? squareHoleShelfItems - : [], - puzzleItems: puzzleShelfItems, - visualNovelItems: visualNovelShelfItems, - barkBattleItems: barkBattleShelfItems, - babyObjectMatchItems: babyObjectMatchDrafts, - }), + const visibleDraftNoticeSources = useMemo( + () => ({ + rpgItems: creationHubItems, + bigFishItems: bigFishShelfItems, + jumpHopItems: jumpHopShelfItems, + woodenFishItems: woodenFishShelfItems, + match3dItems: match3dShelfItems, + squareHoleItems: isSquareHoleCreationVisible ? squareHoleShelfItems : [], + puzzleItems: puzzleShelfItems, + visualNovelItems: visualNovelShelfItems, + barkBattleItems: barkBattleShelfItems, + babyObjectMatchItems: babyObjectMatchDrafts, + }), [ babyObjectMatchDrafts, barkBattleShelfItems, bigFishShelfItems, jumpHopShelfItems, - puzzleClearShelfItems, woodenFishShelfItems, creationHubItems, isSquareHoleCreationVisible, @@ -3329,6 +3318,18 @@ export function PlatformEntryFlowShellImpl({ visualNovelShelfItems, ], ); + const visibleDraftNoticeKeys = useMemo( + () => collectVisibleDraftNoticeKeys(visibleDraftNoticeSources), + [visibleDraftNoticeSources], + ); + const unreadDraftGenerationUpdateCount = useMemo( + () => + countUnreadDraftGenerationUpdates( + draftGenerationNotices, + visibleDraftNoticeSources, + ), + [draftGenerationNotices, visibleDraftNoticeSources], + ); const hasUnreadDraftUpdates = useMemo( () => hasUnreadDraftGenerationUpdates( @@ -3337,6 +3338,9 @@ export function PlatformEntryFlowShellImpl({ ), [draftGenerationNotices, visibleDraftNoticeKeys], ); + useEffect(() => { + void setHostAppBadgeCount({ count: unreadDraftGenerationUpdateCount }); + }, [unreadDraftGenerationUpdateCount]); const resultViewError = autosaveCoordinator.customWorldAutoSaveError ?? sessionController.customWorldError; diff --git a/src/components/platform-entry/platformDraftGenerationShelfModel.test.ts b/src/components/platform-entry/platformDraftGenerationShelfModel.test.ts index ac511878..a1adfb92 100644 --- a/src/components/platform-entry/platformDraftGenerationShelfModel.test.ts +++ b/src/components/platform-entry/platformDraftGenerationShelfModel.test.ts @@ -14,6 +14,7 @@ import { buildPuzzleResultProfileId, buildPuzzleResultWorkId, collectVisibleDraftNoticeKeys, + countUnreadDraftGenerationUpdates, createPendingDraftShelfState, type DraftGenerationNoticeMap, getGenerationNoticeShelfKeys, @@ -595,6 +596,63 @@ describe('platformDraftGenerationShelfModel', () => { visibleKeys, ), ).toBe(false); + + expect( + countUnreadDraftGenerationUpdates( + { + 'puzzle:puzzle-work-ocean': { + status: 'ready', + seen: false, + }, + 'puzzle:puzzle-profile-ocean': { + status: 'ready', + seen: false, + }, + 'puzzle:puzzle-session-ocean': { + status: 'ready', + seen: false, + }, + }, + { + rpgItems: [], + bigFishItems: [], + jumpHopItems: [], + woodenFishItems: [], + match3dItems: [], + squareHoleItems: [], + puzzleItems: [puzzle], + visualNovelItems: [], + barkBattleItems: [], + babyObjectMatchItems: [], + }, + ), + ).toBe(1); + expect( + countUnreadDraftGenerationUpdates( + { + 'puzzle:puzzle-profile-ocean': { + status: 'failed', + seen: false, + }, + 'puzzle:puzzle-session-other': { + status: 'ready', + seen: false, + }, + }, + { + rpgItems: [], + bigFishItems: [], + jumpHopItems: [], + woodenFishItems: [], + match3dItems: [], + squareHoleItems: [], + puzzleItems: [puzzle], + visualNovelItems: [], + barkBattleItems: [], + babyObjectMatchItems: [], + }, + ), + ).toBe(0); }); }); diff --git a/src/components/platform-entry/platformDraftGenerationShelfModel.ts b/src/components/platform-entry/platformDraftGenerationShelfModel.ts index 4aff6fcd..fdcfe46e 100644 --- a/src/components/platform-entry/platformDraftGenerationShelfModel.ts +++ b/src/components/platform-entry/platformDraftGenerationShelfModel.ts @@ -1111,6 +1111,79 @@ export function hasUnreadDraftGenerationUpdates( }); } +export function countUnreadDraftGenerationUpdates( + notices: DraftGenerationNoticeMap, + sources: PlatformDraftGenerationVisibleShelfSources, +) { + const hasUnreadNotice = (keys: readonly string[]) => + keys.some((key) => { + const notice = notices[key]; + return notice?.status === 'ready' && !notice.seen; + }); + + return [ + ...sources.rpgItems.map((item) => + collectDraftNoticeKeys('rpg', [ + item.workId, + item.sessionId, + item.profileId, + ]), + ), + ...sources.bigFishItems.map((item) => + collectDraftNoticeKeys('big-fish', [item.workId, item.sourceSessionId]), + ), + ...sources.jumpHopItems.map((item) => + collectDraftNoticeKeys('jump-hop', [ + item.workId, + item.profileId, + item.sourceSessionId, + ]), + ), + ...sources.woodenFishItems.map((item) => + collectDraftNoticeKeys('wooden-fish', [ + item.workId, + item.profileId, + item.sourceSessionId, + ]), + ), + ...sources.match3dItems.map((item) => + collectDraftNoticeKeys('match3d', [ + item.workId, + item.profileId, + item.sourceSessionId, + ]), + ), + ...sources.squareHoleItems.map((item) => + collectDraftNoticeKeys('square-hole', [ + item.workId, + item.profileId, + item.sourceSessionId, + ]), + ), + ...sources.puzzleItems.map((item) => + collectDraftNoticeKeys('puzzle', [ + item.workId, + item.profileId, + item.sourceSessionId, + buildPuzzleResultWorkId(item.sourceSessionId), + buildPuzzleResultProfileId(item.sourceSessionId), + ]), + ), + ...sources.visualNovelItems.map((item) => + collectDraftNoticeKeys('visual-novel', [item.profileId]), + ), + ...sources.barkBattleItems.map((item) => + collectDraftNoticeKeys('bark-battle', [item.workId, item.draftId]), + ), + ...sources.babyObjectMatchItems.map((item) => + collectDraftNoticeKeys('baby-object-match', [ + item.profileId, + item.draftId, + ]), + ), + ].filter(hasUnreadNotice).length; +} + export function mergeBigFishWorkSummary( current: BigFishWorkSummary, updated: BigFishWorkSummary,