diff --git a/apps/mobile-shell/scripts/check-config.mjs b/apps/mobile-shell/scripts/check-config.mjs index 2c21132e7..2a4eddfa8 100644 --- a/apps/mobile-shell/scripts/check-config.mjs +++ b/apps/mobile-shell/scripts/check-config.mjs @@ -1718,13 +1718,16 @@ for (const snippet of [ if ( !hapticsSource.includes('normalizeHostBridgeHapticsImpactStyle(rawStyle)') || !hapticsSource.includes('type HapticsImpactPayload') || - !hapticsSource.includes('runMobileHostBridgeHapticsImpact(payload: unknown)') || - !hapticsSource.includes('(payload as HapticsImpactPayload | undefined)?.style') || + !hapticsSource.includes('type HostBridgeRequest') || + !hapticsSource.includes('runMobileHostBridgeHapticsImpact(') || + !hapticsSource.includes('request: HostBridgeRequest') || + !hapticsSource.includes('(request.payload as HapticsImpactPayload | undefined)?.style') || !hapticsSource.includes("invalidRequest('haptics impact style must be light, medium, or heavy')") || !hapticsSource.includes('Haptics.ImpactFeedbackStyle.Heavy') || !hapticsSource.includes('Haptics.ImpactFeedbackStyle.Medium') || !hapticsSource.includes('Haptics.ImpactFeedbackStyle.Light') || - !hapticsSource.includes('await Haptics.impactAsync(toExpoImpactStyle(style))') + !hapticsSource.includes('await Haptics.impactAsync(toExpoImpactStyle(style))') || + !hapticsSource.includes('ok(request, true)') ) { throw new Error( 'mobile shell haptics bridge must normalize impact style with the shared HostBridge boundary', @@ -1737,7 +1740,8 @@ if ( dispatchSource.includes('Haptics.ImpactFeedbackStyle') || dispatchSource.includes('HapticsImpactPayload') || dispatchSource.includes('haptics impact style must be light, medium, or heavy') || - !dispatchSource.includes('runMobileHostBridgeHapticsImpact(request.payload)') + dispatchSource.includes('ok(request, await runMobileHostBridgeHapticsImpact') || + !dispatchSource.includes('runMobileHostBridgeHapticsImpact(request)') ) { throw new Error( 'mobile shell dispatch must delegate haptics payload and IO to haptics.ts', diff --git a/apps/mobile-shell/src/host-bridge/dispatch.ts b/apps/mobile-shell/src/host-bridge/dispatch.ts index 3b049c85f..11944c169 100644 --- a/apps/mobile-shell/src/host-bridge/dispatch.ts +++ b/apps/mobile-shell/src/host-bridge/dispatch.ts @@ -82,7 +82,7 @@ export async function dispatchMobileHostBridgeRequest( case 'file.exportAudio': return ok(request, await exportAudioFile(request.payload)); case 'haptics.impact': - return ok(request, await runMobileHostBridgeHapticsImpact(request.payload)); + return runMobileHostBridgeHapticsImpact(request); case 'notification.showLocal': return ok( request, diff --git a/apps/mobile-shell/src/host-bridge/haptics.ts b/apps/mobile-shell/src/host-bridge/haptics.ts index 31d501319..b701a38ad 100644 --- a/apps/mobile-shell/src/host-bridge/haptics.ts +++ b/apps/mobile-shell/src/host-bridge/haptics.ts @@ -2,10 +2,11 @@ import * as Haptics from 'expo-haptics'; import { type HapticsImpactPayload, + type HostBridgeRequest, normalizeHostBridgeHapticsImpactStyle, type HostBridgeHapticsImpactStyle, } from '../../../../packages/shared/src/contracts/hostBridge'; -import { invalidRequest } from './protocol'; +import { invalidRequest, ok } from './protocol'; function toExpoImpactStyle(style: HostBridgeHapticsImpactStyle) { return style === 'heavy' @@ -25,11 +26,13 @@ export async function runMobileHapticsImpact(rawStyle: unknown) { return true; } -export async function runMobileHostBridgeHapticsImpact(payload: unknown) { - const style = (payload as HapticsImpactPayload | undefined)?.style; +export async function runMobileHostBridgeHapticsImpact( + request: HostBridgeRequest, +) { + const style = (request.payload as HapticsImpactPayload | undefined)?.style; if (!(await runMobileHapticsImpact(style))) { throw invalidRequest('haptics impact style must be light, medium, or heavy'); } - return true; + return ok(request, true); } diff --git a/docs/project-memory/shared-memory/decision-log.md b/docs/project-memory/shared-memory/decision-log.md index a85cc18f3..7ed039f47 100644 --- a/docs/project-memory/shared-memory/decision-log.md +++ b/docs/project-memory/shared-memory/decision-log.md @@ -44,7 +44,7 @@ - 2026-06-19 微信壳路由一致性门禁:`npm run check:native-shells` 必须反查 `miniprogram/app.json.pages`、`miniprogram/host-bridge/protocol.js`、H5 `src/services/host-bridge/hostBridge.ts` 小程序页面常量、H5 `src/services/wechatMiniProgramSubscribe.ts` 订阅授权页面常量、`miniprogram/host-bridge/webView.js` 分享入口 / 分享消息类型、`miniprogram/config.js` source query / 域名格式、`miniprogram/shell/webView.js` 请求头来源标记、H5 runtime parser 和 H5 路由保留字段。新增或调整小程序页面、登录派生 URL、支付页、九宫切图页、订阅页、WebView 来源标记、H5 入口域名、API base URL 或宿主上下文 query 字段时,必须同步这几处常量并保持生产 / 开发域名都显式配置为纯 HTTPS domain;运行时开发域名回退生产域名只作为异常兜底。 - 2026-06-18 登录 / 支付能力禁伪声明:`auth.requestLogin` 和 `payment.request` 保留在共享 HostBridge 契约中供未来真实接入,但 Expo / Tauri 壳在真实 SDK、渠道流程和后端契约落地前不得声明这些 capability,也不得把它们写入入口 URL `hostCapabilities`;两端检查脚本会拒绝伪声明,请求实际到达壳层时必须返回明确 `unsupported_method` 并让 H5 fallback,两端壳测试直接覆盖这两个 method。 - 2026-06-18 移动壳触觉反馈边界:`haptics.impact` 只接受 `light`、`medium`、`heavy` 三档 impact style,缺省为 `light`;未知值必须返回 `invalid_request`,不得静默降级成真实设备触觉反馈。桌面壳不声明该 capability,H5 继续按 HostBridge fallback 处理。 -- 2026-06-19 移动壳触觉反馈模块边界:Expo `haptics.impact` 的 HostBridge payload 解析、共享 style 归一、`light` / `medium` / `heavy` 到 `Haptics.ImpactFeedbackStyle` 的映射和真实 `Haptics.impactAsync(...)` 调用统一收口在 `apps/mobile-shell/src/host-bridge/haptics.ts`;`dispatch.ts` 只负责把 `request.payload` 委托给 `runMobileHostBridgeHapticsImpact(...)`,不得直接导入 `expo-haptics`、读取 `HapticsImpactPayload` 或调用 `Haptics.impactAsync`。移动壳配置检查会覆盖该模块结构、共享 style 边界和 dispatch 委托关系,避免触觉反馈能力散落到分发层。 +- 2026-06-19 移动壳触觉反馈模块边界:Expo `haptics.impact` 的 HostBridge payload 解析、共享 style 归一、`light` / `medium` / `heavy` 到 `Haptics.ImpactFeedbackStyle` 的映射、真实 `Haptics.impactAsync(...)` 调用和成功响应包装统一收口在 `apps/mobile-shell/src/host-bridge/haptics.ts`;`dispatch.ts` 只负责把完整 request 委托给 `runMobileHostBridgeHapticsImpact(...)`,不得直接导入 `expo-haptics`、读取 `HapticsImpactPayload`、调用 `Haptics.impactAsync` 或包装触觉反馈成功响应。移动壳配置检查会覆盖该模块结构、共享 style 边界和 dispatch 委托关系,避免触觉反馈能力散落到分发层。 - 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` 到共享契约 `HOST_BRIDGE_BADGE_COUNT_MAX` 之间的整数并在宿主未声明时静默 fallback;Expo 壳只在 iOS 声明并通过 React Native `PushNotificationIOS` 设置应用图标角标,Android 不声明、不伪造成功;Tauri 壳通过主窗口 `set_badge_count` 设置任务栏角标,底层平台不支持时返回真实错误。 - 2026-06-18 草稿生成未读角标:平台壳层把“可见作品架里未读的草稿生成完成更新”同步到 `app.setBadgeCount`;同一草稿的 work/profile/session 等多个恢复 ID 只计 1,已读、失败、生成中和不可见草稿不计入。该角标只消费已有 HostBridge 能力,宿主不支持或设置失败不影响 H5 红点、作品架或后端状态。