From 8b14c6ebe5ebf13b52701ebdc317b1c8da4d3360 Mon Sep 17 00:00:00 2001 From: kdletters Date: Wed, 17 Jun 2026 22:23:34 +0800 Subject: [PATCH] =?UTF-8?q?=E6=8E=A5=E5=85=A5=E6=A1=8C=E9=9D=A2=E5=A3=B3?= =?UTF-8?q?=E5=88=86=E4=BA=AB=E5=A4=8D=E5=88=B6=E8=83=BD=E5=8A=9B?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Tauri HostBridge 声明 share.setTarget 和 share.open 真实能力 桌面壳将分享 payload 或已同步作品目标整理为非空文本写入系统剪贴板 补充桌面壳分享文本解析测试和配置守卫 更新 Expo React Native 与 Tauri 宿主壳方案及团队共享决策记录 --- apps/desktop-shell/scripts/check-config.mjs | 5 +- apps/desktop-shell/src-tauri/src/main.rs | 185 +++++++++++++++++- apps/desktop-shell/src-tauri/tauri.conf.json | 4 +- .../shared-memory/decision-log.md | 2 +- ...ExpoReactNative与Tauri宿主壳方案-2026-06-17.md | 6 +- 5 files changed, 194 insertions(+), 8 deletions(-) diff --git a/apps/desktop-shell/scripts/check-config.mjs b/apps/desktop-shell/scripts/check-config.mjs index 9d548665..722987a0 100644 --- a/apps/desktop-shell/scripts/check-config.mjs +++ b/apps/desktop-shell/scripts/check-config.mjs @@ -34,7 +34,7 @@ const requiredUrlParts = [ 'hostShell=tauri_desktop', 'hostPlatform=unknown', 'bridgeVersion=1', - 'hostCapabilities=host.getRuntime,app.openExternalUrl,clipboard.writeText', + 'hostCapabilities=host.getRuntime,share.open,share.setTarget,app.openExternalUrl,clipboard.writeText', ]; for (const part of requiredUrlParts) { @@ -53,7 +53,10 @@ const requiredPermissions = [ const requiredBuildCommands = ['host_bridge_request']; const requiredMainSnippets = [ 'tauri_plugin_clipboard_manager::init()', + '"share.open"', + '"share.setTarget"', '"clipboard.writeText"', + '"copied_to_clipboard"', ]; for (const permission of requiredPermissions) { diff --git a/apps/desktop-shell/src-tauri/src/main.rs b/apps/desktop-shell/src-tauri/src/main.rs index ef243499..ca26e134 100644 --- a/apps/desktop-shell/src-tauri/src/main.rs +++ b/apps/desktop-shell/src-tauri/src/main.rs @@ -1,10 +1,12 @@ use serde::{Deserialize, Serialize}; use serde_json::{json, Value}; +use std::sync::Mutex; use tauri_plugin_clipboard_manager::ClipboardExt; use tauri_plugin_opener::OpenerExt; const HOST_BRIDGE_PROTOCOL: &str = "GenarrativeHostBridge"; const HOST_BRIDGE_VERSION: u8 = 1; +const WEB_APP_ORIGIN: &str = "https://app.genarrative.world"; #[derive(Debug, Deserialize)] #[serde(rename_all = "camelCase")] @@ -45,6 +47,11 @@ struct HostBridgeResponse { error: Option, } +#[derive(Debug, Default)] +struct DesktopShareState { + target: Mutex>, +} + fn desktop_platform() -> &'static str { if cfg!(target_os = "macos") { "macos" @@ -60,6 +67,8 @@ fn desktop_platform() -> &'static str { fn capabilities() -> Vec<&'static str> { vec![ "host.getRuntime", + "share.open", + "share.setTarget", "app.openExternalUrl", "clipboard.writeText", ] @@ -120,6 +129,79 @@ fn required_string_payload<'a>( }) } +fn payload_string<'a>(value: &'a Value, field: &str) -> Option<&'a str> { + value + .get(field) + .and_then(Value::as_str) + .map(str::trim) + .filter(|text| !text.is_empty()) +} + +fn share_target_payload(value: &Value) -> &Value { + value.get("target").unwrap_or(value) +} + +fn work_detail_url(work: &str) -> String { + format!("{}/works/detail?work={}", WEB_APP_ORIGIN, work) +} + +fn share_text_from_value(value: &Value) -> Option { + let target = share_target_payload(value); + let payload = target.get("payload").unwrap_or(target); + let title = payload_string(payload, "title"); + let message = payload_string(payload, "message"); + let url = payload_string(payload, "url").or_else(|| payload_string(payload, "href")); + let work_url = payload_string(payload, "work").map(work_detail_url); + let path_url = payload_string(payload, "path") + .or_else(|| payload_string(payload, "targetPath")) + .map(|path| format!("{}{}", WEB_APP_ORIGIN, path)); + let resolved_url = url.map(str::to_owned).or(work_url).or(path_url); + let parts = [title, message, resolved_url.as_deref()] + .into_iter() + .flatten() + .collect::>(); + + if parts.is_empty() { + None + } else { + Some(parts.join("\n")) + } +} + +fn share_text_from_request( + request: &HostBridgeRequest, + share_state: &DesktopShareState, +) -> Result { + if let Some(payload) = request.payload.as_ref() { + if let Some(text) = share_text_from_value(payload) { + return Ok(text); + } + } + + let stored_target = share_state + .target + .lock() + .map_err(|_| { + failed( + request.id.clone(), + "host_error", + "share target lock poisoned", + ) + })? + .clone(); + + stored_target + .as_ref() + .and_then(share_text_from_value) + .ok_or_else(|| { + failed( + request.id.clone(), + "invalid_request", + "share target is required", + ) + }) +} + fn resolve_host_bridge_request(request: HostBridgeRequest) -> HostBridgeResponse { if let Some(response) = validate_request(&request) { return response; @@ -145,8 +227,9 @@ fn resolve_host_bridge_request(request: HostBridgeRequest) -> HostBridgeResponse } #[tauri::command] -async fn host_bridge_request( +fn host_bridge_request( app: tauri::AppHandle, + share_state: tauri::State<'_, DesktopShareState>, request: HostBridgeRequest, ) -> HostBridgeResponse { if let Some(response) = validate_request(&request) { @@ -176,12 +259,46 @@ async fn host_bridge_request( Err(error) => failed(request.id, "host_error", error.to_string()), } } + "share.setTarget" => { + let target = request + .payload + .as_ref() + .and_then(|payload| payload.get("target")); + let Some(target) = target else { + return failed(request.id, "invalid_request", "target is required"); + }; + + match share_state.target.lock() { + Ok(mut current_target) => { + *current_target = Some(target.clone()); + ok(request.id, json!(true)) + } + Err(_) => failed(request.id, "host_error", "share target lock poisoned"), + } + } + "share.open" => { + let share_text = match share_text_from_request(&request, &share_state) { + Ok(text) => text, + Err(response) => return response, + }; + + match app.clipboard().write_text(share_text) { + Ok(()) => ok( + request.id, + json!({ + "action": "copied_to_clipboard" + }), + ), + Err(error) => failed(request.id, "host_error", error.to_string()), + } + } _ => resolve_host_bridge_request(request), } } fn main() { tauri::Builder::default() + .manage(DesktopShareState::default()) .plugin(tauri_plugin_clipboard_manager::init()) .plugin(tauri_plugin_opener::init()) .setup(|app| { @@ -219,6 +336,14 @@ mod tests { assert_eq!(result["shell"], "tauri_desktop"); assert_eq!(result["bridgeVersion"], HOST_BRIDGE_VERSION); assert_eq!(result["capabilities"], json!(capabilities())); + assert!(result["capabilities"] + .as_array() + .unwrap() + .contains(&json!("share.open"))); + assert!(result["capabilities"] + .as_array() + .unwrap() + .contains(&json!("share.setTarget"))); } #[test] @@ -254,4 +379,62 @@ mod tests { assert_eq!(error.code, "invalid_request"); assert_eq!(error.message, "text is required"); } + + #[test] + fn share_text_uses_direct_share_payload() { + let state = DesktopShareState::default(); + let mut open = request("share.open"); + open.payload = Some(json!({ + "title": "测试作品", + "message": "来玩这个作品", + "url": "https://app.genarrative.world/works/detail?work=PZ-1" + })); + + let text = share_text_from_request(&open, &state).expect("share text"); + + assert_eq!( + text, + "测试作品\n来玩这个作品\nhttps://app.genarrative.world/works/detail?work=PZ-1" + ); + } + + #[test] + fn share_text_uses_stored_work_target() { + let state = DesktopShareState::default(); + let mut set_target = request("share.setTarget"); + set_target.payload = Some(json!({ + "target": { + "type": "genarrative:share-target", + "payload": { + "work": "PZ-1", + "title": "测试作品" + } + } + })); + let target = set_target + .payload + .as_ref() + .and_then(|payload| payload.get("target")) + .expect("target"); + *state.target.lock().expect("share target lock") = Some(target.clone()); + + let text = share_text_from_request(&request("share.open"), &state).expect("share text"); + + assert_eq!( + text, + "测试作品\nhttps://app.genarrative.world/works/detail?work=PZ-1" + ); + } + + #[test] + fn share_text_requires_payload_or_stored_target() { + let state = DesktopShareState::default(); + let response = + share_text_from_request(&request("share.open"), &state).expect_err("missing target"); + + assert!(!response.ok); + let error = response.error.expect("error"); + assert_eq!(error.code, "invalid_request"); + assert_eq!(error.message, "share target is required"); + } } diff --git a/apps/desktop-shell/src-tauri/tauri.conf.json b/apps/desktop-shell/src-tauri/tauri.conf.json index 953f2ee1..262cbd62 100644 --- a/apps/desktop-shell/src-tauri/tauri.conf.json +++ b/apps/desktop-shell/src-tauri/tauri.conf.json @@ -6,7 +6,7 @@ "build": { "beforeDevCommand": "npm --prefix ../.. run dev:web", "beforeBuildCommand": "npm --prefix ../.. run build:raw && npm run typecheck", - "devUrl": "http://127.0.0.1:3000/?clientRuntime=native_app&clientType=native_app&hostShell=tauri_desktop&hostPlatform=unknown&hostVersion=0.1.0&bridgeVersion=1&hostCapabilities=host.getRuntime,app.openExternalUrl,clipboard.writeText", + "devUrl": "http://127.0.0.1:3000/?clientRuntime=native_app&clientType=native_app&hostShell=tauri_desktop&hostPlatform=unknown&hostVersion=0.1.0&bridgeVersion=1&hostCapabilities=host.getRuntime,share.open,share.setTarget,app.openExternalUrl,clipboard.writeText", "frontendDist": "../../../dist" }, "app": { @@ -14,7 +14,7 @@ { "create": false, "label": "main", - "url": "index.html?clientRuntime=native_app&clientType=native_app&hostShell=tauri_desktop&hostPlatform=unknown&hostVersion=0.1.0&bridgeVersion=1&hostCapabilities=host.getRuntime,app.openExternalUrl,clipboard.writeText", + "url": "index.html?clientRuntime=native_app&clientType=native_app&hostShell=tauri_desktop&hostPlatform=unknown&hostVersion=0.1.0&bridgeVersion=1&hostCapabilities=host.getRuntime,share.open,share.setTarget,app.openExternalUrl,clipboard.writeText", "title": "Genarrative", "width": 1280, "height": 820, diff --git a/docs/project-memory/shared-memory/decision-log.md b/docs/project-memory/shared-memory/decision-log.md index 7b8eeb04..a5363ff6 100644 --- a/docs/project-memory/shared-memory/decision-log.md +++ b/docs/project-memory/shared-memory/decision-log.md @@ -20,7 +20,7 @@ - 背景：后续需要移动端 App 和桌面端 App，但现有主站、固定玩法 runtime、小程序壳和未来 AI H5 sandbox 已经以 H5 为主线；如果移动端重写 React Native UI、桌面端重写 Rust/Tauri UI，会形成玩法、登录、支付、分享和运行态的多套实现。 - 决策：移动端原生壳采用 `Expo + React Native`，桌面端壳采用 `Tauri`。两者都只作为 `native_app` 宿主壳和 HostBridge adapter，不重写现有 React H5 主站，不把固定内置玩法迁到 React Native / Rust UI，也不让 AI 生成 H5 游戏直接访问完整 HostBridge。Expo 壳通过 `react-native-webview` 承接 H5 与 native 通信，Tauri 壳通过受控 command 和 capabilities 承接桌面能力；新增能力必须先进入 HostBridge 契约和测试。 -- 2026-06-17 首轮落地：新增 `packages/shared/src/contracts/hostBridge.ts`、`src/services/host-bridge/nativeAppHostBridge.ts`、`apps/mobile-shell/` 和 `apps/desktop-shell/`。壳只声明并实现真实可用能力；移动壳使用真实品牌图标资产并支持 `genarrative://`、iOS associated domain、Android app link 到同源 H5 路径，`navigation.openNativePage` 只接受同源 H5 route 并切换 WebView URL，不伪造尚未存在的原生页面；桌面壳已通过 Tauri clipboard-manager 接入 `clipboard.writeText`，登录、支付、桌面分享等未接入真实 SDK / 插件前必须返回 unsupported 并让 H5 fallback，生产代码禁止 mock 成功。 +- 2026-06-17 首轮落地：新增 `packages/shared/src/contracts/hostBridge.ts`、`src/services/host-bridge/nativeAppHostBridge.ts`、`apps/mobile-shell/` 和 `apps/desktop-shell/`。壳只声明并实现真实可用能力；移动壳使用真实品牌图标资产并支持 `genarrative://`、iOS associated domain、Android app link 到同源 H5 路径，`navigation.openNativePage` 只接受同源 H5 route 并切换 WebView URL，不伪造尚未存在的原生页面；桌面壳已通过 Tauri clipboard-manager 接入 `clipboard.writeText`，并将 `share.setTarget` / `share.open` 实现为复制非空分享文本到系统剪贴板；登录、支付、原生系统分享面板等未接入真实 SDK / 插件前必须返回 unsupported 并让 H5 fallback，生产代码禁止 mock 成功。 - 影响范围：`src/services/host-bridge/`、未来 `apps/mobile-shell/`、未来 `apps/desktop-shell/`、移动端支付 / 分享 / 深链 / 推送、桌面端系统能力、AI H5 sandbox 的 GameBridge 边界。 - 验证方式：普通浏览器、小程序、Expo 壳、Tauri 壳都能返回正确 `getHostRuntime()`；未支持能力能回退 H5；固定玩法在各宿主中读取同一作品数据和运行态 snapshot；AI sandbox 无法直接调用 HostBridge；Tauri release 不允许任意远端页面调用桌面命令。 - 关联文档：`docs/【前端架构】ExpoReactNative与Tauri宿主壳方案-2026-06-17.md`、`docs/【前端架构】宿主壳能力统一协议-2026-06-17.md`。 diff --git a/docs/【前端架构】ExpoReactNative与Tauri宿主壳方案-2026-06-17.md b/docs/【前端架构】ExpoReactNative与Tauri宿主壳方案-2026-06-17.md index abd9b137..60eaa2da 100644 --- a/docs/【前端架构】ExpoReactNative与Tauri宿主壳方案-2026-06-17.md +++ b/docs/【前端架构】ExpoReactNative与Tauri宿主壳方案-2026-06-17.md @@ -113,8 +113,8 @@ type HostBridgeEvent = { | `host.getRuntime` | 返回宿主、平台、版本和能力清单 | 支持 | 支持 | | `auth.requestLogin` | 打开宿主登录或账号绑定流程 | 支持 | 可先返回不支持 | | `payment.request` | 发起宿主支付 | 依平台策略接入 | 桌面二维码 / 外部浏览器 | -| `share.setTarget` | 同步当前作品分享目标 | 支持 | 未接入前不声明 | -| `share.open` | 打开系统分享面板 | 支持 | 可先复制链接 / 打开系统分享 | +| `share.setTarget` | 同步当前作品分享目标 | 支持 | 支持 | +| `share.open` | 打开分享动作 | 支持系统分享面板 | 复制分享文本到剪贴板 | | `navigation.openNativePage` | 打开受控宿主页 | 支持同源 H5 route | 支持设置 / 关于等 | | `app.openExternalUrl` | 用系统浏览器打开外链 | 支持 | 支持 | | `clipboard.writeText` | 写剪贴板 | 可选 | 可选 | @@ -249,7 +249,7 @@ GameBridge 禁止： - 实现 runtime、openExternalUrl、clipboard、share fallback、窗口标题同步。 - 验证 macOS / Windows / Linux 至少一条本地 smoke。 -当前状态：已新增 `apps/desktop-shell/`，Tauri dev 直接加载本地主站 Vite，release 打包根 `dist` 主站资产。Rust 侧只把 `host_bridge_request` command 授给主窗口，`app.openExternalUrl` 由 Rust 内部通过 opener 插件执行，`clipboard.writeText` 由 Rust 内部通过 clipboard-manager 插件写入系统剪贴板；不把 opener 或 clipboard 插件命令直接暴露给前端。当前真实能力为 `host.getRuntime`、`app.openExternalUrl` 和 `clipboard.writeText`。分享面板、登录和支付未接入真实插件 / 渠道前不声明支持，不返回 mock 成功。 +当前状态：已新增 `apps/desktop-shell/`，Tauri dev 直接加载本地主站 Vite，release 打包根 `dist` 主站资产。Rust 侧只把 `host_bridge_request` command 授给主窗口，`app.openExternalUrl` 由 Rust 内部通过 opener 插件执行，`clipboard.writeText` 由 Rust 内部通过 clipboard-manager 插件写入系统剪贴板；不把 opener 或 clipboard 插件命令直接暴露给前端。当前真实能力为 `host.getRuntime`、`share.setTarget`、`share.open`、`app.openExternalUrl` 和 `clipboard.writeText`；其中 `share.open` 会把直接传入的分享 payload 或 `share.setTarget` 缓存的作品目标整理成非空分享文本并写入系统剪贴板，返回 `copied_to_clipboard`。原生系统分享面板、登录和支付未接入真实插件 / 渠道前不声明支持，不返回 mock 成功。 ### Phase 4：宿主能力扩展