接入 Tauri 桌面剪贴板能力

新增 Tauri clipboard-manager 依赖并通过 HostBridge 写入系统剪贴板

同步桌面壳能力清单和真实品牌图标配置

补充桌面壳配置守门、测试和宿主壳文档记忆

apps/desktop-shell/scripts/check-config.mjs

@@ -9,6 +9,7 @@ const capabilityPath = new URL(
 const capability = JSON.parse(fs.readFileSync(capabilityPath, 'utf8'));
 const buildScriptPath = new URL('../src-tauri/build.rs', import.meta.url);
 const buildScript = fs.readFileSync(buildScriptPath, 'utf8');
+const iconPath = new URL('../src-tauri/icons/icon.png', import.meta.url);
 
 if (config.build?.frontendDist !== '../../../dist') {
   throw new Error('desktop shell must package the root H5 dist');
@@ -23,13 +24,17 @@ if (!mainWindow || mainWindow.create !== false) {
   throw new Error('desktop shell must create the main window from Rust setup');
 }
 
+if (!config.bundle?.icon?.includes('icons/icon.png')) {
+  throw new Error('desktop shell must use the real brand icon asset');
+}
+
 const requiredUrlParts = [
   'clientRuntime=native_app',
   'clientType=native_app',
   'hostShell=tauri_desktop',
   'hostPlatform=unknown',
   'bridgeVersion=1',
-  'hostCapabilities=host.getRuntime,app.openExternalUrl',
+  'hostCapabilities=host.getRuntime,app.openExternalUrl,clipboard.writeText',
 ];
 
 for (const part of requiredUrlParts) {
@@ -46,6 +51,10 @@ const requiredPermissions = [
   'allow-host-bridge-request',
 ];
 const requiredBuildCommands = ['host_bridge_request'];
+const requiredMainSnippets = [
+  'tauri_plugin_clipboard_manager::init()',
+  '"clipboard.writeText"',
+];
 
 for (const permission of requiredPermissions) {
   if (!capability.permissions?.includes(permission)) {
@@ -62,3 +71,17 @@ for (const command of requiredBuildCommands) {
 if (buildScript.includes('resolve_desktop_shell_runtime')) {
   throw new Error('desktop shell build manifest exposes an unused runtime command');
 }
+
+const icon = fs.readFileSync(iconPath);
+if (icon.length < 10000) {
+  throw new Error('desktop shell icon must use a real brand asset');
+}
+
+const mainPath = new URL('../src-tauri/src/main.rs', import.meta.url);
+const main = fs.readFileSync(mainPath, 'utf8');
+
+for (const snippet of requiredMainSnippets) {
+  if (!main.includes(snippet)) {
+    throw new Error(`desktop shell Rust host bridge missing ${snippet}`);
+  }
+}

apps/desktop-shell/src-tauri/Cargo.toml

@@ -11,4 +11,5 @@ tauri-build = { version = "2.6.2", features = [] }
 serde = { version = "1", features = ["derive"] }
 serde_json = "1"
 tauri = { version = "2.11.2", features = [] }
+tauri-plugin-clipboard-manager = "2.3.2"
 tauri-plugin-opener = "2.5.4"

apps/desktop-shell/src-tauri/src/main.rs

@@ -1,5 +1,6 @@
 use serde::{Deserialize, Serialize};
 use serde_json::{json, Value};
+use tauri_plugin_clipboard_manager::ClipboardExt;
 use tauri_plugin_opener::OpenerExt;
 
 const HOST_BRIDGE_PROTOCOL: &str = "GenarrativeHostBridge";
@@ -57,7 +58,11 @@ fn desktop_platform() -> &'static str {
 }
 
 fn capabilities() -> Vec<&'static str> {
-    vec!["host.getRuntime", "app.openExternalUrl"]
+    vec![
+        "host.getRuntime",
+        "app.openExternalUrl",
+        "clipboard.writeText",
+    ]
 }
 
 fn ok(id: String, result: Value) -> HostBridgeResponse {
@@ -97,6 +102,24 @@ fn validate_request(request: &HostBridgeRequest) -> Option<HostBridgeResponse> {
     None
 }
 
+fn required_string_payload<'a>(
+    request: &'a HostBridgeRequest,
+    field: &'static str,
+) -> Result<&'a str, HostBridgeResponse> {
+    request
+        .payload
+        .as_ref()
+        .and_then(|value| value.get(field))
+        .and_then(Value::as_str)
+        .ok_or_else(|| {
+            failed(
+                request.id.clone(),
+                "invalid_request",
+                format!("{} is required", field),
+            )
+        })
+}
+
 fn resolve_host_bridge_request(request: HostBridgeRequest) -> HostBridgeResponse {
     if let Some(response) = validate_request(&request) {
         return response;
@@ -132,13 +155,9 @@ async fn host_bridge_request(
 
     match request.method.as_str() {
         "app.openExternalUrl" => {
-            let Some(url) = request
-                .payload
-                .as_ref()
-                .and_then(|value| value.get("url"))
-                .and_then(Value::as_str)
-            else {
-                return failed(request.id, "invalid_request", "url is required");
+            let url = match required_string_payload(&request, "url") {
+                Ok(url) => url,
+                Err(response) => return response,
             };
 
             match app.opener().open_url(url, None::<&str>) {
@@ -146,12 +165,24 @@ async fn host_bridge_request(
                 Err(error) => failed(request.id, "host_error", error.to_string()),
             }
         }
+        "clipboard.writeText" => {
+            let text = match required_string_payload(&request, "text") {
+                Ok(text) => text,
+                Err(response) => return response,
+            };
+
+            match app.clipboard().write_text(text) {
+                Ok(()) => ok(request.id, json!(true)),
+                Err(error) => failed(request.id, "host_error", error.to_string()),
+            }
+        }
         _ => resolve_host_bridge_request(request),
     }
 }
 
 fn main() {
     tauri::Builder::default()
+        .plugin(tauri_plugin_clipboard_manager::init())
         .plugin(tauri_plugin_opener::init())
         .setup(|app| {
             let window_config = app.config().app.windows.get(0).cloned();
@@ -210,4 +241,17 @@ mod tests {
         assert!(!response.ok);
         assert_eq!(response.error.expect("error").code, "invalid_request");
     }
+
+    #[test]
+    fn invalid_string_payload_is_rejected() {
+        let mut invalid = request("clipboard.writeText");
+        invalid.payload = Some(json!({ "text": 123 }));
+
+        let response = required_string_payload(&invalid, "text").expect_err("invalid payload");
+
+        assert!(!response.ok);
+        let error = response.error.expect("error");
+        assert_eq!(error.code, "invalid_request");
+        assert_eq!(error.message, "text is required");
+    }
 }

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",
+    "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",
     "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",
+        "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",
         "title": "Genarrative",
         "width": 1280,
         "height": 820,
@@ -29,6 +29,6 @@
   "bundle": {
     "active": true,
     "targets": "all",
-    "icon": []
+    "icon": ["icons/icon.png"]
   }
 }

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/`。首轮壳只声明并实现真实可用能力；登录、支付、桌面剪贴板等未接入真实 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/`。壳只声明并实现真实可用能力；桌面壳已通过 Tauri clipboard-manager 接入 `clipboard.writeText`，登录、支付、桌面分享等未接入真实 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`。

docs/【前端架构】ExpoReactNative与Tauri宿主壳方案-2026-06-17.md

@@ -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 插件执行，不把 opener 插件直接暴露给前端；首轮真实能力为 `host.getRuntime` 和 `app.openExternalUrl`。剪贴板、分享面板、登录和支付未接入真实插件 / 渠道前不声明支持，不返回 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`、`app.openExternalUrl` 和 `clipboard.writeText`。分享面板、登录和支付未接入真实插件 / 渠道前不声明支持，不返回 mock 成功。
 
 ### Phase 4：宿主能力扩展