@steerable/agent-shell-web 0.6.52 → 0.6.55

package/src/lib/app-release.ts

@@ -1,3 +1,4 @@
+import { t } from '@/i18n';
 import type { AppReleasePhase, AppReleaseSnapshot } from './electron-bridge';
 
 export interface AppReleaseView {
@@ -20,21 +21,25 @@ export function sidebarUpdateLabel(
   if (!snap.enabled || snap.phase === 'disabled') return null;
   switch (snap.phase) {
     case 'checking':
-      return '检查中';
+      return t('Checking');
     case 'downloading':
-      return typeof snap.percent === 'number' ? `下载 ${Math.round(snap.percent)}%` : '下载中';
+      return typeof snap.percent === 'number'
+        ? t('Downloading {percent}%', { percent: Math.round(snap.percent) })
+        : t('Downloading…');
     case 'ready':
-      return snap.availableVersion ? `升级 ${snap.availableVersion}` : '升级';
+      return snap.availableVersion
+        ? t('Update to {version}', { version: snap.availableVersion })
+        : t('Update');
     case 'installing':
-      return '正在安装';
+      return t('Installing');
     case 'error':
-      return '重试';
+      return t('Retry');
     case 'idle':
-      if (snap.availableVersion) return `发现 ${snap.availableVersion}`;
+      if (snap.availableVersion) return t('{version} available', { version: snap.availableVersion });
       if (snap.message) return snap.message;
-      return confirmedCurrent ? '已是最新' : '检查更新';
+      return confirmedCurrent ? t('Up to date') : t('Check for updates');
     default:
-      return '检查更新';
+      return t('Check for updates');
   }
 }
 
@@ -43,9 +48,9 @@ export function sidebarUpdateTitle(snap: AppReleaseSnapshot): string | undefined
     return snap.message;
   }
   if (snap.phase === 'ready' && snap.availableVersion) {
-    return `重启并安装 ${snap.availableVersion}`;
+    return t('Restart and install {version}', { version: snap.availableVersion });
   }
-  if (snap.phase === 'downloading') return '正在下载更新';
+  if (snap.phase === 'downloading') return t('Downloading update');
   return undefined;
 }
 

package/src/lib/attachments.ts

@@ -9,6 +9,7 @@
  *   - BS/browser：File 没有路径，这里把字节读成 base64 走 HTTP 端点落盘。
  * 返回的落盘路径会重写消息正文里的文件引用与图像附件元数据。
  */
+import { t } from '@/i18n';
 import { getElectronBridge } from './electron-bridge';
 
 export interface AttachmentFile {
@@ -19,6 +20,14 @@ export interface AttachmentFile {
   file?: File;
 }
 
+/** 宿主拖放 / 粘贴只给出绝对路径时，用最后一段作为展示名。 */
+export function attachmentFromPath(path: string): AttachmentFile {
+  const trimmed = path.trim();
+  const parts = trimmed.split(/[/\\]/).filter((part) => part.length > 0);
+  const name = parts[parts.length - 1] ?? trimmed;
+  return { name, path: trimmed };
+}
+
 const IMAGE_EXTENSIONS = new Set(['.png', '.jpg', '.jpeg', '.gif', '.webp', '.bmp']);
 
 /** 扩展名是否为图像（renderer 侧预过滤，后端 image-attachment 会二次校验）。 */
@@ -101,7 +110,7 @@ export async function saveChatAttachments(
         kept.push(file);
         return;
       }
-      failures.push({ name: file.name, error: entry?.error || '上传失败', file });
+      failures.push({ name: file.name, error: entry?.error || t('Upload failed'), file });
     });
     return { files: kept, failures };
   } catch (err) {
@@ -115,13 +124,21 @@ export async function saveChatAttachments(
   }
 }
 
-/** 把失败项拼成一条给用户看的中文提示（供各提交入口复用）。 */
+/** 把失败项拼成一条给用户看的提示（供各提交入口复用）。 */
 export function formatAttachmentFailures(failures: AttachmentSaveFailure[]): string {
   if (failures.length === 0) return '';
-  const detail = failures.map((f) => `${f.name}（${f.error}）`).join('；');
+  const detail = failures
+    .map((f) => t('{name} ({error})', { name: f.name, error: f.error }))
+    .join(t('; '));
   return failures.length === 1
-    ? `文件「${failures[0].name}」未能上传，本条消息未包含它：${failures[0].error}`
-    : `${failures.length} 个文件未能上传，本条消息未包含它们：${detail}`;
+    ? t('File "{name}" failed to upload and is not included in this message: {error}', {
+        name: failures[0].name,
+        error: failures[0].error,
+      })
+    : t('{count} files failed to upload and are not included in this message: {detail}', {
+        count: failures.length,
+        detail,
+      });
 }
 
 /**
@@ -134,8 +151,8 @@ export function appendAttachmentRefs(rawText: string, files: AttachmentFile[]):
   if (files.length === 0) return rawText;
   const refs = files.map((f) => `- \`${f.path}\``).join('\n');
   return rawText
-    ? `${rawText}\n\n---\n关联文件:\n${refs}`
-    : `关联文件:\n${refs}`;
+    ? `${rawText}\n\n---\n${t('Related files:')}\n${refs}`
+    : `${t('Related files:')}\n${refs}`;
 }
 
 /**

package/src/lib/browser-dev-electron-mock.ts

@@ -97,33 +97,33 @@ function createInitialState(): BrowserMockState {
     {
       id: 'coach',
       slug: 'coach',
-      name: '行动教练',
+      name: 'Action coach',
       icon: null,
       color: '#2563eb',
-      description: '把目标拆成可执行计划，适合调试标准聊天路径。',
-      rolePrompt: '你是一个行动教练。',
+      description: 'Breaks a goal into an executable plan. Useful for debugging the standard chat path.',
+      rolePrompt: 'You are an action coach.',
       isBuiltin: true,
       sortOrder: 1,
     },
     {
       id: 'tool-demo',
       slug: 'tool-demo',
-      name: '工具演示专家',
+      name: 'Tool demo',
       icon: null,
       color: '#7c3aed',
-      description: '模拟本地工具调用和执行摘要，适合调试工具卡片。',
-      rolePrompt: '你是工具演示智能体。',
+      description: 'Simulates local tool calls and execution summaries. Useful for debugging tool cards.',
+      rolePrompt: 'You are the tool-demo agent.',
       isBuiltin: true,
       sortOrder: 2,
     },
     {
       id: 'writer',
       slug: 'writer',
-      name: '文案顾问',
+      name: 'Writing advisor',
       icon: null,
       color: '#16a34a',
-      description: '偏长文本回复样例，适合调试 markdown 与滚动。',
-      rolePrompt: '你是一个文案顾问。',
+      description: 'Longer text replies, for debugging markdown and scrolling.',
+      rolePrompt: 'You are a writing advisor.',
       isBuiltin: true,
       sortOrder: 3,
     },
@@ -132,14 +132,14 @@ function createInitialState(): BrowserMockState {
   const chats = [
     createChatRecord({
       id: 'chat-browser-demo',
-      title: '浏览器 UI 调试样例',
+      title: 'Browser UI debug sample',
       agentId: 'coach',
       minutesAgo: 8,
       isPinned: true,
     }),
     createChatRecord({
       id: 'chat-tool-demo',
-      title: '工具调用卡片预览',
+      title: 'Tool-call card preview',
       agentId: 'tool-demo',
       minutesAgo: 64,
     }),
@@ -155,14 +155,14 @@ function createInitialState(): BrowserMockState {
           chatId: 'chat-browser-demo',
           role: 'assistant',
           content:
-            '可以在这里调试普通浏览器里的聊天 UI。这个回复来自 dev mock bridge，不依赖 Electron IPC。',
+            'You can debug the chat UI in a normal browser here. This reply comes from the dev mock bridge and does not use Electron IPC.',
           minutesAgo: 7,
         }),
         createMessage({
           id: 'msg-demo-user-1',
           chatId: 'chat-browser-demo',
           role: 'user',
-          content: '我想在浏览器里调试聊天界面。',
+          content: 'I want to debug the chat UI in the browser.',
           minutesAgo: 8,
         }),
       ],
@@ -171,7 +171,7 @@ function createInitialState(): BrowserMockState {
           id: 'msg-tool-assistant-1',
           chatId: 'chat-tool-demo',
           role: 'assistant',
-          content: '我已经模拟执行了一次本地命令，并把结果展示在工具卡片里。',
+          content: 'I simulated a local command and put the result in a tool card.',
           minutesAgo: 63,
           messageMetadata: JSON.stringify({
             executedActions: [
@@ -187,7 +187,7 @@ function createInitialState(): BrowserMockState {
           id: 'msg-tool-user-1',
           chatId: 'chat-tool-demo',
           role: 'user',
-          content: '帮我看一下最近的工具调用记录。',
+          content: 'Show me the recent tool-call records.',
           minutesAgo: 64,
         }),
       ],
@@ -201,9 +201,9 @@ function createInitialState(): BrowserMockState {
       maxTotalTokens: 60_000,
     },
     skills: [
-      { name: 'tool-demo', description: '模拟查询与回放工具。', builtin: true },
-      { name: 'local-exec', description: '模拟本地命令执行。', builtin: true },
-      { name: 'anti-deferred', description: '模拟防拖延执行策略。', builtin: true },
+      { name: 'tool-demo', description: 'Simulates query and replay tools.', builtin: true },
+      { name: 'local-exec', description: 'Simulates local command execution.', builtin: true },
+      { name: 'anti-deferred', description: 'Simulates the anti-deferral execution policy.', builtin: true },
     ],
     activeStreams: new Map(),
     source: 'fallback',
@@ -235,8 +235,8 @@ function createStateFromFixture(fixture: BrowserDevFixture): BrowserMockState |
       Array.isArray(fixture.skills) && fixture.skills.length > 0
         ? fixture.skills
         : [
-            { name: 'tool-demo', description: '查询与回放工具。', builtin: true },
-            { name: 'local-exec', description: '本地命令执行。', builtin: true },
+            { name: 'tool-demo', description: 'Query and replay tools.', builtin: true },
+            { name: 'local-exec', description: 'Local command execution.', builtin: true },
           ],
     activeStreams: new Map(),
     source: 'fixture',
@@ -318,7 +318,7 @@ async function request<T>(input: LocalBackendRequestInput): Promise<T> {
     const agent: LocalChatAgent = {
       id,
       slug: null,
-      name: (body.name || '新助手').trim() || '新助手',
+      name: (body.name || 'New assistant').trim() || 'New assistant',
       icon: null,
       color: body.color ?? '#4f46e5',
       description: body.description ?? null,
@@ -392,10 +392,10 @@ async function request<T>(input: LocalBackendRequestInput): Promise<T> {
   if (method === 'GET' && cleanPath === '/api/v2/chat-agents/tools') {
     return {
       tools: [
-        { name: 'local_exec_shell', description: '执行本地 shell 命令。', category: 'local' },
-        { name: 'local_read_file', description: '读取本地文本文件。', category: 'local' },
-        { name: 'local_write_file', description: '写入本地文件。', category: 'local' },
-        { name: 'web_search', description: '联网搜索。', category: 'local' },
+        { name: 'local_exec_shell', description: 'Run a local shell command.', category: 'local' },
+        { name: 'local_read_file', description: 'Read a local text file.', category: 'local' },
+        { name: 'local_write_file', description: 'Write a local file.', category: 'local' },
+        { name: 'web_search', description: 'Search the web.', category: 'local' },
       ],
     } as T;
   }
@@ -404,7 +404,7 @@ async function request<T>(input: LocalBackendRequestInput): Promise<T> {
     const body = input.body as { path?: string } | undefined;
     const name = body?.path?.split(/[\\/]/).filter(Boolean).pop() || 'browser-skill';
     if (!state.skills.some((skill) => skill.name === name)) {
-      state.skills.push({ name, description: '浏览器预览中导入的 mock skill。' });
+      state.skills.push({ name, description: 'Mock skill imported in the browser preview.' });
     }
     return { success: true, name } as T;
   }
@@ -444,7 +444,7 @@ async function request<T>(input: LocalBackendRequestInput): Promise<T> {
     const chatId = `chat-browser-${Date.now()}`;
     const chat = createChatRecord({
       id: chatId,
-      title: '新会话',
+      title: 'New chat',
       agentId,
       minutesAgo: 0,
     });
@@ -515,7 +515,7 @@ async function startStream(
   }
 
   const body = input.body as { message?: string } | undefined;
-  const message = body?.message?.trim() || '请演示一下浏览器 mock 回复。';
+  const message = body?.message?.trim() || 'Please demo a browser mock reply.';
   const streamId = `browser-stream-${Date.now()}`;
   state.activeStreams.set(streamId, []);
 
@@ -530,10 +530,10 @@ async function startStream(
   state.messagesByChatId[chatId] = [...(state.messagesByChatId[chatId] ?? []), userMessage];
 
   const reply =
-    `这是浏览器 dev mock 的流式回复。你刚才输入的是：「${message}」。` +
-    ' 这里可以调试消息气泡、滚动、停止按钮、工具执行卡片和后续状态。';
+    `This is a streaming reply from the browser dev mock. You wrote: "${message}".` +
+    ' Use it to debug message bubbles, scrolling, the stop button, tool cards, and later status.';
   const chunks = reply.match(/.{1,8}/g) ?? [reply];
-  const reasoning = '先调用一次 mock 工具，再把回复按调用流程交错显示。';
+  const reasoning = 'Call one mock tool, then interleave the reply with that call.';
   const mockAction = {
     id: 'browser-mock-1',
     tool: 'browser_mock',
@@ -580,7 +580,7 @@ async function startStream(
           { type: 'text', content: reply },
         ],
         durationMs: 1_200,
-        suggestedReplies: ['继续完善这份结果', '换一种呈现方式', '告诉我下一步怎么做'],
+        suggestedReplies: ['Keep improving this result', 'Try another presentation', 'Tell me the next step'],
       }),
     });
     assistantMessage.createdAt = new Date().toISOString();
@@ -593,7 +593,7 @@ async function startStream(
     pushSse(onEvent, '[DONE]');
     onEvent({ type: 'end', status: 200 });
     state.activeStreams.delete(streamId);
-    const suggestions = ['继续完善这份结果', '换一种呈现方式', '告诉我下一步怎么做'];
+    const suggestions = ['Keep improving this result', 'Try another presentation', 'Tell me the next step'];
     for (const listener of suggestedReplyListeners) {
       listener({ chatId, messageId: assistantMessage.id, suggestions });
     }
@@ -625,7 +625,7 @@ export function installBrowserDevElectronMock() {
       // 浏览器 dev 模式没有 Electron capturePage/clipboard，如实返回失败。
       captureScreenshot: async () => ({
         success: false as const,
-        error: '浏览器开发模式不支持窗口截图（需要 Electron 运行时）',
+        error: 'Browser dev mode cannot capture a window screenshot (it needs the Electron runtime).',
       }),
     },
     localBackend: {

package/src/lib/chat-title.ts

@@ -5,8 +5,9 @@
  * automation.py:_AUTOMATION_TITLE_PREFIX), so the same parser works for both.
  */
 
-export const AUTOMATION_TITLE_PREFIX = '[自动化] ';
-const BARE_BRACKET_PREFIX = '[自动化]';
+// 与后端 automation.py 的标题前缀是同一条持久化约定，不能按界面语言改写。
+export const AUTOMATION_TITLE_PREFIX = '[自动化] '; // i18n:allow
+const BARE_BRACKET_PREFIX = '[自动化]'; // i18n:allow
 
 export interface ParsedChatTitle {
   displayTitle: string;

package/src/lib/chat-transport.ts

@@ -53,6 +53,7 @@ import {
 } from '@steerable/agent-ui/state';
 import type { SSEEvent } from '@steerable/agent-protocol';
 import { getElectronBridge } from './electron-bridge';
+import { t } from '@/i18n';
 import {
   appendDelta,
   freezeReasoningDurations,
@@ -372,7 +373,7 @@ export async function regenerateChatMessage(
         if (frame.event !== 'error' || !frame.data) return;
         const parsed = parseSSEData(frame.data);
         const message = (parsed as { message?: unknown } | null)?.message;
-        refusal = typeof message === 'string' && message ? message : '重新生成失败';
+        refusal = typeof message === 'string' && message ? message : t('Regeneration failed');
       },
     });
     bridge.localBackend
@@ -388,7 +389,10 @@ export async function regenerateChatMessage(
             parser.end();
             settle(
               payload.status >= 400
-                ? new Error(refusal ?? `重新生成失败（HTTP ${payload.status}）`)
+                ? new Error(
+                    refusal ??
+                      t('Regeneration failed (HTTP {status})', { status: payload.status }),
+                  )
                 : undefined,
             );
           } else if (payload.type === 'error') settle(new Error(payload.error));

package/src/lib/date-groups.ts

@@ -1,34 +1,42 @@
 /**
  * Date-group helpers used by AgentSidebar to label chat groups
- * ("今天" / "昨天" / "N天前" / "M月D日" / "YYYY年M月D日"). Lifted verbatim
- * from `deeppath/apps/web/src/app/agent/AgentSidebar.tsx` so the visual
+ * ("Today" / "Yesterday" / "N days ago" / "M/D" / "M/D/YYYY"). Lifted from
+ * `deeppath/apps/web/src/app/agent/AgentSidebar.tsx` so the visual
  * grouping stays in lockstep.
  *
  * priority is used for ordering groups: smaller = newer = listed first.
+ * 标签走 t()，排序只看日期，不解析标签文本。
  */
+import { t } from '@/i18n';
 
-export function getDateGroupLabel(date: Date): string {
+function dayBuckets(date: Date): { diffDays: number; target: Date; today: Date } {
   const today = new Date();
   today.setHours(0, 0, 0, 0);
   const target = new Date(date);
   target.setHours(0, 0, 0, 0);
   const diffDays =
     (today.getTime() - target.getTime()) / (1000 * 60 * 60 * 24);
-  if (diffDays === 0) return '今天';
-  if (diffDays === 1) return '昨天';
-  if (diffDays < 4) return `${Math.floor(diffDays)}天前`;
-  const m = target.getMonth() + 1;
-  const d = target.getDate();
+  return { diffDays, target, today };
+}
+
+export function getDateGroupLabel(date: Date): string {
+  const { diffDays, target, today } = dayBuckets(date);
+  if (diffDays === 0) return t('Today');
+  if (diffDays === 1) return t('Yesterday');
+  if (diffDays < 4) return t('{count} days ago', { count: Math.floor(diffDays) });
+  const month = target.getMonth() + 1;
+  const day = target.getDate();
   if (target.getFullYear() !== today.getFullYear()) {
-    return `${target.getFullYear()}年${m}月${d}日`;
+    return t('{month}/{day}/{year}', { year: target.getFullYear(), month, day });
   }
-  return `${m}月${d}日`;
+  return t('{month}/{day}', { month, day });
 }
 
-export function getDateGroupPriority(label: string): number {
-  if (label === '今天') return 1;
-  if (label === '昨天') return 2;
-  if (label.endsWith('天前')) return 2 + parseInt(label, 10);
-  if (label.includes('年')) return 1000;
+export function getDateGroupPriority(date: Date): number {
+  const { diffDays, target, today } = dayBuckets(date);
+  if (diffDays === 0) return 1;
+  if (diffDays === 1) return 2;
+  if (diffDays < 4) return 2 + Math.floor(diffDays);
+  if (target.getFullYear() !== today.getFullYear()) return 1000;
   return 100;
 }

package/src/lib/electron-bridge.ts

@@ -1,11 +1,8 @@
 /**
  * Host-neutral bridge used by the renderer in desktop and browser modes.
  *
- * This file MUST stay a subset / aligned shape with `ElectronAPI` in
- * `../../../src/preload.ts`. We intentionally don't TypeScript-reference that
- * file across workspaces — it would drag the whole main-process source tree
- * into the renderer's compile graph. Treat this as a contract surface and
- * extend it lazily as apps/web starts using new bridge methods.
+ * Implementations are `tauri-bridge.ts` (desktop) and `http-bridge.ts`
+ * (browser server); both must satisfy {@link HostBridge}.
  *
  * `window.electron` and `getElectronBridge()` remain compatibility aliases for
  * existing products. New integrations should use `window.steerableHost` and
@@ -184,6 +181,8 @@ export interface HostBridge {
    * to clear the listener (otherwise multiple AgentSidebar mounts
    * during HMR would queue up duplicate callbacks).
    */
+  /** 把当前界面语言告诉主进程，以便重建应用菜单。浏览器预览里没有。 */
+  setLocale?: (locale: string) => void;
   onMenuNewChat?: (callback: () => void) => void;
   offMenuNewChat?: () => void;
   /**
@@ -197,10 +196,24 @@ export interface HostBridge {
   /**
    * App menu IPC — `Cmd+V` / 编辑 → 粘贴 fires `menu:paste`.
    * WKWebView does not expose that pasteboard to the page, so the renderer
-   * reads it through `readClipboardText`.
+   * reads it through `readClipboard`.
    */
   onMenuPaste?: (callback: () => void) => void;
   offMenuPaste?: () => void;
+  /**
+   * OS pasteboard. `files` are copied paths or a screenshot PNG.
+   * Text is empty when the pasteboard holds files, so the path is not
+   * inserted into the composer as well.
+   */
+  readClipboard?: () => Promise<{
+    text: string;
+    files: Array<{
+      name: string;
+      path?: string;
+      dataBase64?: string;
+      mime?: string;
+    }>;
+  }>;
   /** Plain text from the OS pasteboard. Empty when the clipboard has no text. */
   readClipboardText?: () => Promise<string>;
   /**

package/src/lib/host-file-drop.ts

@@ -0,0 +1,68 @@
+/**
+ * Tauri consumes OS file drags before they become HTML5 drop events.
+ * The webview reports paths through `onDragDropEvent` instead.
+ *
+ * macOS labels AppKit points as a physical position. Windows reports device
+ * pixels. Checking both against the composer rectangle accepts the drop on
+ * either scale.
+ */
+import { getCurrentWebview, type DragDropEvent } from '@tauri-apps/api/webview';
+
+export interface HostFileDrop {
+  type: 'enter' | 'over' | 'drop' | 'leave';
+  paths: string[];
+  x?: number;
+  y?: number;
+}
+
+export function hostFileDropAvailable(): boolean {
+  return typeof window !== 'undefined' && window.__TAURI_INTERNALS__ != null;
+}
+
+export function dropPointHitsRect(
+  position: { x: number; y: number },
+  rect: { left: number; right: number; top: number; bottom: number },
+  devicePixelRatio: number,
+): boolean {
+  const scale = devicePixelRatio > 0 ? devicePixelRatio : 1;
+  return (
+    contains(rect, position.x, position.y) ||
+    contains(rect, position.x / scale, position.y / scale)
+  );
+}
+
+/** Subscribe while a composer is mounted. The returned function removes it. */
+export function listenHostFileDrop(onEvent: (event: HostFileDrop) => void): () => void {
+  if (!hostFileDropAvailable()) return () => {};
+  let unlisten: (() => void) | undefined;
+  let cancelled = false;
+  const pending = getCurrentWebview().onDragDropEvent((event) => {
+    onEvent(hostFileDropFrom(event.payload));
+  });
+  void pending.then((stop) => {
+    if (cancelled) stop();
+    else unlisten = stop;
+  });
+  return () => {
+    cancelled = true;
+    unlisten?.();
+  };
+}
+
+function contains(
+  rect: { left: number; right: number; top: number; bottom: number },
+  x: number,
+  y: number,
+): boolean {
+  return x >= rect.left && x <= rect.right && y >= rect.top && y <= rect.bottom;
+}
+
+function hostFileDropFrom(payload: DragDropEvent): HostFileDrop {
+  if (payload.type === 'leave') return { type: 'leave', paths: [] };
+  return {
+    type: payload.type,
+    paths: payload.type === 'over' ? [] : payload.paths,
+    x: payload.position.x,
+    y: payload.position.y,
+  };
+}

package/src/lib/host-paste.ts

@@ -1,8 +1,20 @@
 /**
- * WKWebView paste does not carry clipboard text into the page. The Edit menu
- * shortcut emits `menu:paste`; this module reads the OS pasteboard and writes
- * it into the focused field.
+ * WKWebView paste does not carry clipboard text or files into the page. The
+ * Edit menu shortcut emits `menu:paste`; this module reads the OS pasteboard
+ * and writes it into the focused field.
  */
+
+export interface HostClipboardFile {
+  name: string;
+  path?: string;
+  dataBase64?: string;
+  mime?: string;
+}
+
+export interface HostClipboard {
+  text: string;
+  files: HostClipboardFile[];
+}
 import { getHostBridge } from './electron-bridge';
 
 let pending = false;
@@ -25,12 +37,18 @@ export function installHostPaste(): void {
 
 /** Read the OS pasteboard and insert it into `target` or the focused field. */
 export function requestHostPaste(target?: HTMLElement | null): void {
-  const read = getHostBridge()?.readClipboardText;
-  if (!read || pending) return;
+  const bridge = getHostBridge();
+  const readClipboard = bridge?.readClipboard;
+  const readText = bridge?.readClipboardText;
+  if ((!readClipboard && !readText) || pending) return;
   pending = true;
-  void read()
-    .then((text) => {
-      if (text) insertHostText(text, target ?? null);
+  const read = readClipboard
+    ? readClipboard()
+    : readText!().then((text) => ({ text, files: [] as HostClipboardFile[] }));
+  void read
+    .then((clip) => {
+      if (clip.files.length > 0) insertHostFiles(clip.files, target ?? null);
+      if (clip.text) insertHostText(clip.text, target ?? null);
     })
     .catch((error: unknown) => {
       console.warn('[host-paste] clipboard read failed', error);
@@ -41,7 +59,10 @@ export function requestHostPaste(target?: HTMLElement | null): void {
 }
 
 export function hostClipboardAvailable(): boolean {
-  return typeof getHostBridge()?.readClipboardText === 'function';
+  const bridge = getHostBridge();
+  return (
+    typeof bridge?.readClipboard === 'function' || typeof bridge?.readClipboardText === 'function'
+  );
 }
 
 function isEditable(target: EventTarget | null): target is HTMLElement {
@@ -58,6 +79,14 @@ function focusedEditable(): HTMLElement | null {
   return null;
 }
 
+function insertHostFiles(files: HostClipboardFile[], preferred: HTMLElement | null): void {
+  const el = preferred?.isConnected ? preferred : focusedEditable();
+  if (!el) return;
+  if (el.isContentEditable || el.getAttribute('contenteditable') === 'true') {
+    el.dispatchEvent(new CustomEvent('hostpastefiles', { detail: files, cancelable: true }));
+  }
+}
+
 function insertHostText(text: string, preferred: HTMLElement | null): void {
   const el = preferred?.isConnected ? preferred : focusedEditable();
   if (!el) return;

package/src/lib/http-bridge.ts

@@ -23,6 +23,7 @@ import type {
   TerminalSession,
   TerminalSpawnOptions,
 } from './electron-bridge';
+import { t } from '@/i18n';
 
 interface BsBootstrap {
   platform: NodeJS.Platform;
@@ -225,7 +226,9 @@ export function createHttpBridge(): ElectronBridge {
       },
       captureScreenshot: async () => ({
         success: false as const,
-        error: '浏览器模式不支持窗口截图，请用系统截图工具。',
+        error: t(
+          'Browser mode cannot capture window screenshots. Use your system screenshot tool.',
+        ),
       }),
     },