同步草稿未读原生角标

平台壳按可见作品架未读完成草稿同步 app.setBadgeCount 新增草稿未读更新计数模型并覆盖多恢复ID去重更新原生壳方案、HostBridge 协议和共享决策记录
2026-06-18 07:18:42 +08:00
parent cdcbaf4cee
commit 20e4e88bd4
6 changed files with 170 additions and 30 deletions
--- 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。
--- 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：宿主能力扩展

 - 移动端接入系统分享、推送、原生登录和渠道支付。
--- 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。宿主不可用或拒绝时回退浏览器外链行为，普通浏览器和小程序保持原有 `<a>` 语义。
 - `navigateHostNativePage()`：受控跳转宿主页，供订阅授权、支付、登录等 adapter 复用。Expo 移动壳首版只接受同源 H5 route 并切换 WebView URL；Tauri 桌面壳同样只接受 `https://app.genarrative.world` 同源 H5 route 并在主窗口内跳转。真正原生页面、登录和支付能力必须等对应 SDK / 页面接入后再声明支持。
--- 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;
--- 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);
  });
 });

--- 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,