收口移动剪贴板响应边界

将 Expo 剪贴板读写成功响应收口到 clipboard 模块

让移动 dispatch 只委托剪贴板请求

同步移动壳配置门禁和共享记忆
This commit is contained in:
2026-06-20 00:24:45 +08:00
parent 6ecfc89233
commit d780d354ba
4 changed files with 21 additions and 12 deletions
+7 -3
View File
@@ -1692,8 +1692,10 @@ if (
dispatchSource.includes('Clipboard.setStringAsync') ||
dispatchSource.includes('Clipboard.getStringAsync') ||
dispatchSource.includes('ClipboardWriteTextPayload') ||
!dispatchSource.includes('writeMobileHostBridgeClipboardText(request.payload)') ||
!dispatchSource.includes('readMobileHostBridgeClipboardText()')
!dispatchSource.includes('writeMobileHostBridgeClipboardText(request)') ||
!dispatchSource.includes('readMobileHostBridgeClipboardText(request)') ||
dispatchSource.includes('ok(request, await writeMobileHostBridgeClipboardText') ||
dispatchSource.includes('ok(request, await readMobileHostBridgeClipboardText')
) {
throw new Error(
'mobile shell dispatch must delegate clipboard IO to clipboard.ts',
@@ -1702,9 +1704,11 @@ if (
for (const snippet of [
'writeMobileHostBridgeClipboardText',
'type ClipboardWriteTextPayload',
'request: HostBridgeRequest',
'ok(request, true)',
'writeMobileClipboardText(text)',
'readMobileHostBridgeClipboardText',
'readMobileClipboardText()',
'ok(request, await readMobileClipboardText())',
]) {
if (!clipboardSource.includes(snippet)) {
throw new Error(`mobile shell clipboard module is missing ${snippet}`);
+11 -6
View File
@@ -4,9 +4,10 @@ import {
type ClipboardReadTextResult,
type ClipboardWriteTextPayload,
type HostBridgeError,
type HostBridgeRequest,
normalizeHostBridgeClipboardText,
} from '../../../../packages/shared/src/contracts/hostBridge';
import { invalidRequest } from './protocol';
import { invalidRequest, ok } from './protocol';
export async function writeMobileClipboardText(rawText: unknown) {
const clipboardText = normalizeHostBridgeClipboardText(rawText);
@@ -18,17 +19,21 @@ export async function writeMobileClipboardText(rawText: unknown) {
return true;
}
export async function writeMobileHostBridgeClipboardText(payload: unknown) {
const text = (payload as ClipboardWriteTextPayload | undefined)?.text;
export async function writeMobileHostBridgeClipboardText(
request: HostBridgeRequest,
) {
const text = (request.payload as ClipboardWriteTextPayload | undefined)?.text;
if (!(await writeMobileClipboardText(text))) {
throw invalidRequest('text is required');
}
return true;
return ok(request, true);
}
export function readMobileHostBridgeClipboardText() {
return readMobileClipboardText();
export async function readMobileHostBridgeClipboardText(
request: HostBridgeRequest,
) {
return ok(request, await readMobileClipboardText());
}
export async function readMobileClipboardText(): Promise<ClipboardReadTextResult> {
@@ -60,9 +60,9 @@ export async function dispatchMobileHostBridgeRequest(
case 'network.status':
return getMobileHostBridgeNetworkStatus(request);
case 'clipboard.writeText':
return ok(request, await writeMobileHostBridgeClipboardText(request.payload));
return writeMobileHostBridgeClipboardText(request);
case 'clipboard.readText':
return ok(request, await readMobileHostBridgeClipboardText());
return readMobileHostBridgeClipboardText(request);
case 'file.exportText':
return ok(request, await exportTextFile(request.payload));
case 'file.importText':
@@ -88,7 +88,7 @@
- 2026-06-18 草稿生成完成 / 失败通知:平台壳层的 `markDraftReady` / `markDraftFailed` 统一收口会在原生壳声明 `notification.showLocal` 时请求即时本地通知;通知 payload 只包含生成完成 / 失败标题和草稿来源正文,按草稿来源去重,同一草稿重新进入生成中后才允许再次通知。该能力不替代现有完成 / 错误弹窗、作品架红点、队列概览或后端状态回读,通知失败不阻断主流程。根级原生壳门禁必须覆盖平台壳同步层通过真实 HostBridge transport 发出 `notification.showLocal`,避免只测模型文案。
- 2026-06-19 草稿生成 HostBridge 消费门禁:`PlatformEntryFlowShellImpl` 只负责派生草稿通知和未读数量,实际宿主同步经 `platformHostBridgeSync.ts` 调用 `showHostLocalNotification` / `setHostAppBadgeCount``npm run check:native-shells` 必须运行该同步层的真实 Tauri transport 测试,并继续覆盖通知模型、未读计数模型、音频导入和文档导入等 H5 HostBridge 消费测试。
- 2026-06-18 剪贴板读取能力:新增 `clipboard.readText` HostBridge capabilityH5 只能读取纯文本结果,契约限制返回文本最多 100000 字符;Expo 壳通过 `expo-clipboard` 读取系统剪贴板文本,Tauri 壳通过 Rust 侧 `tauri-plugin-clipboard-manager` 读取文本且不开放插件 JS guest API。该能力不读取图片、HTML、文件列表或剪贴板监听事件,宿主未声明或读取失败时由 H5 视作失败并保留原流程。
- 2026-06-19 移动壳剪贴板边界:Expo `clipboard.writeText` / `clipboard.readText` 的系统剪贴板读写、共享 100000 字符归一、payload 校验和响应边界统一收口在 `apps/mobile-shell/src/host-bridge/clipboard.ts``dispatch.ts` 只负责把 HostBridge request 委托给 `writeMobileHostBridgeClipboardText(...)` / `readMobileHostBridgeClipboardText()`,不得直接导入 `expo-clipboard`调用 `Clipboard.setStringAsync` / `Clipboard.getStringAsync`。移动壳配置检查会覆盖该模块结构、共享文本边界和 dispatch 委托关系,避免剪贴板能力散落到分发层。
- 2026-06-19 移动壳剪贴板边界:Expo `clipboard.writeText` / `clipboard.readText` 的系统剪贴板读写、共享 100000 字符归一、payload 校验和 HostBridge 成功 / 失败响应边界统一收口在 `apps/mobile-shell/src/host-bridge/clipboard.ts``dispatch.ts` 只负责把 HostBridge request 委托给 `writeMobileHostBridgeClipboardText(request)` / `readMobileHostBridgeClipboardText(request)`,不得直接导入 `expo-clipboard`调用 `Clipboard.setStringAsync` / `Clipboard.getStringAsync` 或包装剪贴板成功响应。移动壳配置检查会覆盖该模块结构、共享文本边界和 dispatch 委托关系,避免剪贴板能力散落到分发层。
- 2026-06-19 桌面壳剪贴板边界:Tauri `clipboard.writeText` / `clipboard.readText` 的系统剪贴板读写、共享 100000 字符归一、payload 校验和响应边界统一收口在 `apps/desktop-shell/src-tauri/src/host_bridge/clipboard.rs``dispatch.rs` 只负责把 HostBridge request 委托给 `write_desktop_host_bridge_clipboard_text(...)` / `read_desktop_host_bridge_clipboard_text(...)`,不得直接承接剪贴板文本截断、payload 解析或插件读写细节;桌面 share fallback 仍可调用底层写剪贴板函数复制分享文本。桌面壳配置检查会覆盖该模块结构、共享文本边界和 dispatch 委托关系,避免剪贴板能力散落到分发层。
- 2026-06-19 桌面壳本地通知边界:Tauri `notification.showLocal` 的 payload 清洗、权限状态检查、prompt 权限请求和系统通知发送统一收口在 `apps/desktop-shell/src-tauri/src/host_bridge/notifications.rs``dispatch.rs` 只负责把 HostBridge request 委托给 `show_desktop_local_notification(...)` 并映射响应,不得直接调用 `app.notification()``NotificationExt``PermissionState`。桌面壳配置检查会覆盖该模块结构、权限语义和 dispatch 委托关系,避免本地通知能力散落到分发层。
- 2026-06-18 文本文件导入能力:新增 `file.importText` HostBridge capabilityH5 统一通过 `importHostTextFile()` 读取宿主返回的纯文本内容;Expo 壳通过 `expo-document-picker` 打开系统文档选择器,Tauri 壳通过系统文件选择框读取真实文本文件。两端只接受 `text/plain``text/markdown``text/csv``application/json` 或对应扩展名,单次不超过 5 MiB,成功只返回清洗后的文件名、MIME、UTF-8 文本内容和字节数,不暴露设备 URI / 本机绝对路径,也不开放通用文件系统。