From 12ab5ef064d4b95bc12d0025ebf8067d9f58e9d2 Mon Sep 17 00:00:00 2001
From: kdletters <kdletters@qq.com>
Date: Sat, 20 Jun 2026 12:27:45 +0800
Subject: [PATCH] =?UTF-8?q?=E9=94=81=E5=AE=9A=E6=A1=8C=E9=9D=A2=E5=89=AA?=
 =?UTF-8?q?=E8=B4=B4=E6=9D=BF=E4=B8=8D=E5=8F=AF=E7=94=A8=E5=93=8D=E5=BA=94?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

桌面剪贴板写入失败转为稳定 host_error

桌面剪贴板读取失败转为稳定 host_error

桌面分享写入剪贴板失败复用稳定不可用响应

桌面壳配置检查反查剪贴板不可用边界
---
 apps/desktop-shell/scripts/check-config.mjs   |  5 ++
 .../src-tauri/src/host_bridge/clipboard.rs    | 52 ++++++++++++++++++-
 .../src-tauri/src/host_bridge/share.rs        |  6 ++-
 3 files changed, 59 insertions(+), 4 deletions(-)

diff --git a/apps/desktop-shell/scripts/check-config.mjs b/apps/desktop-shell/scripts/check-config.mjs
index f6433f93e..774e8fe1c 100644
--- a/apps/desktop-shell/scripts/check-config.mjs
+++ b/apps/desktop-shell/scripts/check-config.mjs
@@ -1921,9 +1921,14 @@ for (const snippet of [
   'write_desktop_clipboard_text(app, text)',
   'read_desktop_clipboard_text(app)',
   'normalize_clipboard_text(&text)',
+  'clipboard_write_unavailable_response',
+  'clipboard_read_unavailable_response',
   'required_string_payload(request, "text")',
   'truncated.chars().count()',
   '"text": text',
+  '"clipboard write unavailable"',
+  '"clipboard read unavailable"',
+  'clipboard_unavailable_responses_are_stable',
 ]) {
   if (!desktopHostBridgeClipboardSource.includes(snippet)) {
     throw new Error(`desktop shell clipboard module is missing ${snippet}`);
diff --git a/apps/desktop-shell/src-tauri/src/host_bridge/clipboard.rs b/apps/desktop-shell/src-tauri/src/host_bridge/clipboard.rs
index 3658e251a..38ea6d041 100644
--- a/apps/desktop-shell/src-tauri/src/host_bridge/clipboard.rs
+++ b/apps/desktop-shell/src-tauri/src/host_bridge/clipboard.rs
@@ -27,6 +27,26 @@ pub(crate) fn read_desktop_clipboard_text(app: &tauri::AppHandle) -> Result<Stri
         .map_err(|error| error.to_string())
 }
 
+pub(crate) fn clipboard_write_unavailable_response(
+    request: &HostBridgeRequest,
+) -> HostBridgeResponse {
+    failed(
+        request.id.clone(),
+        "host_error",
+        "clipboard write unavailable",
+    )
+}
+
+pub(crate) fn clipboard_read_unavailable_response(
+    request: &HostBridgeRequest,
+) -> HostBridgeResponse {
+    failed(
+        request.id.clone(),
+        "host_error",
+        "clipboard read unavailable",
+    )
+}
+
 pub(crate) fn write_desktop_host_bridge_clipboard_text(
     app: &tauri::AppHandle,
     request: &HostBridgeRequest,
@@ -38,7 +58,7 @@ pub(crate) fn write_desktop_host_bridge_clipboard_text(
 
     match write_desktop_clipboard_text(app, text) {
         Ok(()) => ok(request.id.clone(), json!(true)),
-        Err(error) => failed(request.id.clone(), "host_error", error),
+        Err(_) => clipboard_write_unavailable_response(request),
     }
 }
 
@@ -53,7 +73,7 @@ pub(crate) fn read_desktop_host_bridge_clipboard_text(
                 "text": text,
             }),
         ),
-        Err(error) => failed(request.id.clone(), "host_error", error),
+        Err(_) => clipboard_read_unavailable_response(request),
     }
 }
 
@@ -92,4 +112,32 @@ mod tests {
             })
         );
     }
+
+    #[test]
+    fn clipboard_unavailable_responses_are_stable() {
+        let write_response = clipboard_write_unavailable_response(&HostBridgeRequest {
+            bridge: "GenarrativeHostBridge".to_string(),
+            version: 1,
+            id: "clipboard-write".to_string(),
+            method: "clipboard.writeText".to_string(),
+            payload: None,
+        });
+        let read_response = clipboard_read_unavailable_response(&HostBridgeRequest {
+            bridge: "GenarrativeHostBridge".to_string(),
+            version: 1,
+            id: "clipboard-read".to_string(),
+            method: "clipboard.readText".to_string(),
+            payload: None,
+        });
+
+        assert!(!write_response.ok);
+        let write_error = write_response.error.expect("clipboard write error");
+        assert_eq!(write_error.code, "host_error");
+        assert_eq!(write_error.message, "clipboard write unavailable");
+
+        assert!(!read_response.ok);
+        let read_error = read_response.error.expect("clipboard read error");
+        assert_eq!(read_error.code, "host_error");
+        assert_eq!(read_error.message, "clipboard read unavailable");
+    }
 }
diff --git a/apps/desktop-shell/src-tauri/src/host_bridge/share.rs b/apps/desktop-shell/src-tauri/src/host_bridge/share.rs
index 2f51bf42a..af0283016 100644
--- a/apps/desktop-shell/src-tauri/src/host_bridge/share.rs
+++ b/apps/desktop-shell/src-tauri/src/host_bridge/share.rs
@@ -1,4 +1,6 @@
-use crate::host_bridge::clipboard::write_desktop_clipboard_text;
+use crate::host_bridge::clipboard::{
+    clipboard_write_unavailable_response, write_desktop_clipboard_text,
+};
 use crate::host_bridge::protocol::{failed, ok, HostBridgeRequest, HostBridgeResponse};
 use crate::shell::webview::WEB_APP_ORIGIN;
 use serde_json::json;
@@ -194,7 +196,7 @@ pub(crate) fn open_desktop_host_bridge_share(
                 "action": "copied_to_clipboard"
             }),
         ),
-        Err(error) => failed(request.id.clone(), "host_error", error),
+        Err(_) => clipboard_write_unavailable_response(request),
     }
 }