Files
universal-web-api/app/utils/system_clipboard.py
T
2026-11-02 22:54:14 +08:00

111 lines
3.0 KiB
Python

"""
app/utils/system_clipboard.py - 平台原生剪贴板适配
职责:
- 保留 Windows 上的原生文件/图片剪贴板能力
- 为非 Windows 平台提供显式不可用信号,让上层走网页原生上传回退
"""
from __future__ import annotations
import io
import os
import struct
from app.utils.platform import is_windows
class ClipboardUnsupportedError(RuntimeError):
"""当前平台不支持该原生剪贴板能力。"""
class ClipboardDependencyError(RuntimeError):
"""缺少平台剪贴板依赖。"""
def supports_native_file_clipboard() -> bool:
return is_windows()
def supports_native_image_clipboard() -> bool:
return is_windows()
def copy_file_to_native_clipboard(filepath: str) -> None:
"""
使用系统原生文件剪贴板复制文件。
目前仅支持 Windows 的 CF_HDROP。
"""
if not supports_native_file_clipboard():
raise ClipboardUnsupportedError("native file clipboard is only supported on Windows")
try:
import win32clipboard
except ImportError as exc:
raise ClipboardDependencyError("pywin32 is required for the Windows file clipboard backend") from exc
abs_path = os.path.abspath(filepath)
if not os.path.exists(abs_path):
raise FileNotFoundError(abs_path)
file_list = abs_path + "\0"
file_list += "\0"
file_list_bytes = file_list.encode("utf-16-le")
header = struct.pack("IIIii", 20, 0, 0, 0, 1)
data = header + file_list_bytes
cf_hdrop = 15
win32clipboard.OpenClipboard()
try:
win32clipboard.EmptyClipboard()
win32clipboard.SetClipboardData(cf_hdrop, data)
finally:
win32clipboard.CloseClipboard()
def copy_image_to_native_clipboard(image_path: str) -> None:
"""
使用系统原生图片剪贴板复制图片。
目前仅支持 Windows 的 CF_DIB。
"""
if not supports_native_image_clipboard():
raise ClipboardUnsupportedError("native image clipboard is only supported on Windows")
try:
import win32clipboard
except ImportError as exc:
raise ClipboardDependencyError("pywin32 is required for the Windows image clipboard backend") from exc
from PIL import Image
with Image.open(image_path) as image:
with io.BytesIO() as output:
if image.mode != "RGB":
converted = image.convert("RGB")
try:
converted.save(output, "BMP")
finally:
converted.close()
else:
image.save(output, "BMP")
data = output.getvalue()[14:]
win32clipboard.OpenClipboard()
try:
win32clipboard.EmptyClipboard()
win32clipboard.SetClipboardData(win32clipboard.CF_DIB, data)
finally:
win32clipboard.CloseClipboard()
__all__ = [
"ClipboardDependencyError",
"ClipboardUnsupportedError",
"copy_file_to_native_clipboard",
"copy_image_to_native_clipboard",
"supports_native_file_clipboard",
"supports_native_image_clipboard",
]