@steerable/agent-shell-web 0.6.51 → 0.6.53

package/src/components/settings/McpSettingsPanel.tsx

@@ -15,7 +15,7 @@ import { getElectronBridge, isElectron } from '@/lib/electron-bridge';
  * McpSettingsPanel — MCP 服务管理面板（JSON 导入 / 手动增改 / 启停 / 测试 /
  * 删除）。
  *
- * 渲染在 `/settings?section=mcp` 独立页（AgentLayout 右侧内容区）。
+ * 渲染在 `/settings?section=plugins` 的 MCP 分类（AgentLayout 右侧内容区）。
  *
  * 数据与状态完全自管理：挂载时拉一次列表，操作后刷新。后端走
  * local-backend REST（`/api/v2/mcp/servers*`），注册表持久化在 main 进程的
@@ -26,10 +26,15 @@ import { getElectronBridge, isElectron } from '@/lib/electron-bridge';
 export interface McpServerInfo {
   id: string;
   name: string;
-  command: string;
-  args: string[];
-  env: Record<string, string>;
+  transport: 'stdio' | 'streamable-http';
+  command?: string;
+  args?: string[];
+  envKeys?: string[];
   cwd?: string;
+  url?: string;
+  headerNames?: string[];
+  headersFromEnv?: Record<string, string>;
+  bearerTokenEnvVar?: string;
   enabled: boolean;
   serverKey: string;
   toolCount: number;
@@ -46,11 +51,16 @@ export function McpSettingsPanel() {
   const [mcpImportStatus, setMcpImportStatus] = useState<string | null>(null);
   const [mcpFormOpen, setMcpFormOpen] = useState(false);
   const [mcpEditingId, setMcpEditingId] = useState<string | null>(null);
+  const [mcpFormTransport, setMcpFormTransport] = useState<'stdio' | 'streamable-http'>('stdio');
   const [mcpFormName, setMcpFormName] = useState('');
   const [mcpFormCommand, setMcpFormCommand] = useState('');
   const [mcpFormArgs, setMcpFormArgs] = useState('');
   const [mcpFormEnv, setMcpFormEnv] = useState('');
   const [mcpFormCwd, setMcpFormCwd] = useState('');
+  const [mcpFormUrl, setMcpFormUrl] = useState('');
+  const [mcpFormHeaders, setMcpFormHeaders] = useState('');
+  const [mcpFormHeadersFromEnv, setMcpFormHeadersFromEnv] = useState('');
+  const [mcpFormBearerEnv, setMcpFormBearerEnv] = useState('');
   const [mcpSaving, setMcpSaving] = useState(false);
   const [mcpTestingId, setMcpTestingId] = useState<string | null>(null);
   const [mcpDeletingId, setMcpDeletingId] = useState<string | null>(null);
@@ -80,11 +90,16 @@ export function McpSettingsPanel() {
 
   const resetMcpForm = () => {
     setMcpEditingId(null);
+    setMcpFormTransport('stdio');
     setMcpFormName('');
     setMcpFormCommand('');
     setMcpFormArgs('');
     setMcpFormEnv('');
     setMcpFormCwd('');
+    setMcpFormUrl('');
+    setMcpFormHeaders('');
+    setMcpFormHeadersFromEnv('');
+    setMcpFormBearerEnv('');
   };
 
   const parseEnvLines = (raw: string): Record<string, string> => {
@@ -104,13 +119,27 @@ export function McpSettingsPanel() {
     setMcpSaving(true);
     setError(null);
     try {
-      const body = {
-        name: mcpFormName.trim(),
-        command: mcpFormCommand.trim(),
-        args: mcpFormArgs.split('\n').map((s) => s.trim()).filter(Boolean),
-        env: parseEnvLines(mcpFormEnv),
-        cwd: mcpFormCwd.trim() || undefined,
-      };
+      const body = mcpFormTransport === 'stdio'
+        ? {
+            name: mcpFormName.trim(),
+            transport: 'stdio',
+            command: mcpFormCommand.trim(),
+            args: mcpFormArgs.split('\n').map((s) => s.trim()).filter(Boolean),
+            ...(!mcpEditingId || mcpFormEnv.trim()
+              ? { env: parseEnvLines(mcpFormEnv) }
+              : {}),
+            cwd: mcpFormCwd.trim() || undefined,
+          }
+        : {
+            name: mcpFormName.trim(),
+            transport: 'streamable-http',
+            url: mcpFormUrl.trim(),
+            ...(!mcpEditingId || mcpFormHeaders.trim()
+              ? { headers: parseEnvLines(mcpFormHeaders) }
+              : {}),
+            headersFromEnv: parseEnvLines(mcpFormHeadersFromEnv),
+            bearerTokenEnvVar: mcpFormBearerEnv.trim() || undefined,
+          };
       if (mcpEditingId) {
         await getElectronBridge()!.localBackend.request({
           method: 'PUT',
@@ -136,15 +165,22 @@ export function McpSettingsPanel() {
 
   const handleEditMcpServer = (server: McpServerInfo) => {
     setMcpEditingId(server.id);
+    setMcpFormTransport(server.transport ?? 'stdio');
     setMcpFormName(server.name);
-    setMcpFormCommand(server.command);
+    setMcpFormCommand(server.command ?? '');
     setMcpFormArgs((server.args || []).join('\n'));
-    setMcpFormEnv(
-      Object.entries(server.env || {})
-        .map(([k, v]) => `${k}=${v}`)
+    // Stored values never return through the settings API. Blank preserves
+    // the existing env map; entering lines replaces it deliberately.
+    setMcpFormEnv('');
+    setMcpFormCwd(server.cwd || '');
+    setMcpFormUrl(server.url || '');
+    setMcpFormHeaders('');
+    setMcpFormHeadersFromEnv(
+      Object.entries(server.headersFromEnv ?? {})
+        .map(([header, variable]) => `${header}=${variable}`)
         .join('\n'),
     );
-    setMcpFormCwd(server.cwd || '');
+    setMcpFormBearerEnv(server.bearerTokenEnvVar || '');
     setMcpFormOpen(true);
   };
 
@@ -275,6 +311,16 @@ export function McpSettingsPanel() {
           <h4 className="text-xs font-semibold text-agent-foreground">
             {mcpEditingId ? '编辑 MCP 服务' : '手动添加 MCP 服务'}
           </h4>
+          <select
+            value={mcpFormTransport}
+            onChange={(event) =>
+              setMcpFormTransport(event.target.value as 'stdio' | 'streamable-http')
+            }
+            className="h-8 w-full rounded-agent-md border border-agent-border bg-agent-canvas px-3 text-xs text-agent-foreground focus:outline-none focus:ring-2 focus:ring-agent-foreground/30"
+          >
+            <option value="stdio">本地进程（stdio）</option>
+            <option value="streamable-http">远程服务（Streamable HTTP）</option>
+          </select>
           <div className="grid grid-cols-2 gap-2">
             <input
               type="text"
@@ -283,35 +329,73 @@ export function McpSettingsPanel() {
               placeholder="名称，如 filesystem"
               className="h-8 rounded-agent-md border border-agent-border bg-agent-canvas px-3 text-xs text-agent-foreground focus:outline-none focus:ring-2 focus:ring-agent-foreground/30"
             />
-            <input
-              type="text"
-              value={mcpFormCommand}
-              onChange={(e) => setMcpFormCommand(e.target.value)}
-              placeholder="启动命令，如 npx / uvx / node"
-              className="h-8 rounded-agent-md border border-agent-border bg-agent-canvas px-3 text-xs text-agent-foreground focus:outline-none focus:ring-2 focus:ring-agent-foreground/30"
-            />
+            {mcpFormTransport === 'stdio' ? (
+              <input
+                type="text"
+                value={mcpFormCommand}
+                onChange={(e) => setMcpFormCommand(e.target.value)}
+                placeholder="启动命令，如 npx / uvx / node"
+                className="h-8 rounded-agent-md border border-agent-border bg-agent-canvas px-3 text-xs text-agent-foreground focus:outline-none focus:ring-2 focus:ring-agent-foreground/30"
+              />
+            ) : (
+              <input
+                type="url"
+                value={mcpFormUrl}
+                onChange={(e) => setMcpFormUrl(e.target.value)}
+                placeholder="https://example.com/mcp"
+                className="h-8 rounded-agent-md border border-agent-border bg-agent-canvas px-3 text-xs text-agent-foreground focus:outline-none focus:ring-2 focus:ring-agent-foreground/30"
+              />
+            )}
           </div>
-          <textarea
-            value={mcpFormArgs}
-            onChange={(e) => setMcpFormArgs(e.target.value)}
-            placeholder="参数（每行一个），如：&#10;-y&#10;@modelcontextprotocol/server-filesystem&#10;C:/"
-            rows={3}
-            className="w-full rounded-agent-md border border-agent-border bg-agent-canvas px-3 py-2 font-mono text-[11px] text-agent-foreground focus:outline-none focus:ring-2 focus:ring-agent-foreground/30"
-          />
-          <textarea
-            value={mcpFormEnv}
-            onChange={(e) => setMcpFormEnv(e.target.value)}
-            placeholder="环境变量（每行一个 KEY=VALUE，可留空）"
-            rows={2}
-            className="w-full rounded-agent-md border border-agent-border bg-agent-canvas px-3 py-2 font-mono text-[11px] text-agent-foreground focus:outline-none focus:ring-2 focus:ring-agent-foreground/30"
-          />
-          <input
-            type="text"
-            value={mcpFormCwd}
-            onChange={(e) => setMcpFormCwd(e.target.value)}
-            placeholder="工作目录（可选）"
-            className="h-8 w-full rounded-agent-md border border-agent-border bg-agent-canvas px-3 text-xs text-agent-foreground focus:outline-none focus:ring-2 focus:ring-agent-foreground/30"
-          />
+          {mcpFormTransport === 'stdio' ? (
+            <>
+              <textarea
+                value={mcpFormArgs}
+                onChange={(e) => setMcpFormArgs(e.target.value)}
+                placeholder="参数（每行一个）"
+                rows={3}
+                className="w-full rounded-agent-md border border-agent-border bg-agent-canvas px-3 py-2 font-mono text-[11px] text-agent-foreground focus:outline-none focus:ring-2 focus:ring-agent-foreground/30"
+              />
+              <textarea
+                value={mcpFormEnv}
+                onChange={(e) => setMcpFormEnv(e.target.value)}
+                placeholder={mcpEditingId ? '环境变量；留空保留现有值' : '环境变量（每行 KEY=VALUE）'}
+                rows={2}
+                className="w-full rounded-agent-md border border-agent-border bg-agent-canvas px-3 py-2 font-mono text-[11px] text-agent-foreground focus:outline-none focus:ring-2 focus:ring-agent-foreground/30"
+              />
+              <input
+                type="text"
+                value={mcpFormCwd}
+                onChange={(e) => setMcpFormCwd(e.target.value)}
+                placeholder="工作目录（可选）"
+                className="h-8 w-full rounded-agent-md border border-agent-border bg-agent-canvas px-3 text-xs text-agent-foreground focus:outline-none focus:ring-2 focus:ring-agent-foreground/30"
+              />
+            </>
+          ) : (
+            <>
+              <textarea
+                value={mcpFormHeaders}
+                onChange={(e) => setMcpFormHeaders(e.target.value)}
+                placeholder={mcpEditingId ? '普通请求头；留空保留现有值' : '普通请求头（每行 Header=Value）'}
+                rows={2}
+                className="w-full rounded-agent-md border border-agent-border bg-agent-canvas px-3 py-2 font-mono text-[11px] text-agent-foreground focus:outline-none focus:ring-2 focus:ring-agent-foreground/30"
+              />
+              <textarea
+                value={mcpFormHeadersFromEnv}
+                onChange={(e) => setMcpFormHeadersFromEnv(e.target.value)}
+                placeholder="环境变量请求头（每行 Header=ENV_NAME）"
+                rows={2}
+                className="w-full rounded-agent-md border border-agent-border bg-agent-canvas px-3 py-2 font-mono text-[11px] text-agent-foreground focus:outline-none focus:ring-2 focus:ring-agent-foreground/30"
+              />
+              <input
+                type="text"
+                value={mcpFormBearerEnv}
+                onChange={(e) => setMcpFormBearerEnv(e.target.value)}
+                placeholder="Bearer token 环境变量名（可选）"
+                className="h-8 w-full rounded-agent-md border border-agent-border bg-agent-canvas px-3 text-xs text-agent-foreground focus:outline-none focus:ring-2 focus:ring-agent-foreground/30"
+              />
+            </>
+          )}
           <div className="flex justify-end gap-2">
             <button
               type="button"
@@ -323,9 +407,19 @@ export function McpSettingsPanel() {
             <button
               type="button"
               onClick={handleSaveMcpServer}
-              disabled={mcpSaving || !mcpFormName.trim() || !mcpFormCommand.trim()}
+              disabled={
+                mcpSaving ||
+                !mcpFormName.trim() ||
+                (mcpFormTransport === 'stdio'
+                  ? !mcpFormCommand.trim()
+                  : !mcpFormUrl.trim())
+              }
               className={`h-8 px-4 rounded-full text-xs font-medium transition-all ${
-                mcpSaving || !mcpFormName.trim() || !mcpFormCommand.trim()
+                mcpSaving ||
+                !mcpFormName.trim() ||
+                (mcpFormTransport === 'stdio'
+                  ? !mcpFormCommand.trim()
+                  : !mcpFormUrl.trim())
                   ? 'bg-agent-muted text-agent-muted-foreground cursor-not-allowed'
                   : 'bg-agent-foreground text-agent-canvas hover:opacity-90'
               }`}
@@ -386,7 +480,9 @@ export function McpSettingsPanel() {
                     )}
                   </div>
                   <p className="text-[11px] text-agent-muted-foreground font-mono truncate">
-                    {server.command} {(server.args || []).join(' ')}
+                    {server.transport === 'streamable-http'
+                      ? server.url
+                      : `${server.command ?? ''} ${(server.args ?? []).join(' ')}`}
                   </p>
                   {server.lastError && (
                     <p className="text-[10px] text-agent-destructive line-clamp-2">
@@ -453,7 +549,7 @@ export function McpSettingsPanel() {
         )}
       </div>
       <p className="text-[10px] text-agent-muted-foreground">
-        已启用服务的工具会以 mcp__服务名__工具名 的形式直接提供给助手调用；新导入或修改后点「测试连接」即可生效。
+        支持 stdio 与 Streamable HTTP。密钥请填写环境变量名，不要写进普通请求头；已启用服务的工具通过 tool_search 提供给助手。
       </p>
 
       {error && (

package/src/components/settings/SkillsSettingsPanel.tsx

@@ -11,7 +11,7 @@ import { getPackHiddenSlashSkills } from '@/packs/registry';
 /**
  * SkillsSettingsPanel — 本地技能管理面板（导入目录 / 列表 / 卸载）。
  *
- * 渲染在 `/settings?section=skills` 独立页（AgentLayout 右侧内容区）。
+ * 渲染在 `/settings?section=plugins` 的 Skills 分类（AgentLayout 右侧内容区）。
  *
  * 数据与状态完全自管理：挂载时拉一次列表，操作后刷新。后端走
  * local-backend REST（`GET/POST /api/v2/chat-agents/skills*`），无专用 IPC。

package/src/hooks/useProjects.ts

@@ -0,0 +1,82 @@
+/**
+ * 侧栏项目分组和输入框「关联到项目」共用这一份列表。
+ * 任一侧新建、改名或改目录后调用 refresh，其它订阅者一起更新。
+ */
+import { useCallback, useEffect, useSyncExternalStore } from 'react';
+import { isElectron } from '@/lib/electron-bridge';
+import { hostToolChrome } from '@/lib/host-tools';
+import { listProjects, type LocalProject } from '@/lib/local-api';
+
+type ProjectsSnapshot = {
+  projects: LocalProject[];
+  error: string | null;
+};
+
+const EMPTY_SNAPSHOT: ProjectsSnapshot = { projects: [], error: null };
+
+let snapshot: ProjectsSnapshot = EMPTY_SNAPSHOT;
+let requestSeq = 0;
+const listeners = new Set<() => void>();
+
+function emit() {
+  for (const listener of listeners) listener();
+}
+
+export function subscribeProjects(listener: () => void): () => void {
+  listeners.add(listener);
+  return () => {
+    listeners.delete(listener);
+  };
+}
+
+export function getProjectsSnapshot(): ProjectsSnapshot {
+  return snapshot;
+}
+
+/** 重新拉取项目列表并通知所有订阅者。非 Electron 或关掉项目入口时清空。 */
+export async function refreshProjects(): Promise<void> {
+  const seq = ++requestSeq;
+  if (!isElectron() || !hostToolChrome('projects')) {
+    if (snapshot.projects.length > 0 || snapshot.error) {
+      snapshot = EMPTY_SNAPSHOT;
+      emit();
+    }
+    return;
+  }
+  try {
+    const res = await listProjects();
+    if (seq !== requestSeq) return;
+    snapshot = { projects: res.projects ?? [], error: null };
+    emit();
+  } catch (err) {
+    if (seq !== requestSeq) return;
+    const message = err instanceof Error ? err.message : String(err);
+    console.error('获取项目列表失败:', err);
+    snapshot = { projects: snapshot.projects, error: message };
+    emit();
+  }
+}
+
+export function useProjects(): {
+  projects: LocalProject[];
+  error: string | null;
+  refresh: () => Promise<void>;
+} {
+  const current = useSyncExternalStore(
+    subscribeProjects,
+    getProjectsSnapshot,
+    getProjectsSnapshot,
+  );
+  useEffect(() => {
+    void refreshProjects();
+  }, []);
+  const refresh = useCallback(() => refreshProjects(), []);
+  return { projects: current.projects, error: current.error, refresh };
+}
+
+/** 测试隔离：丢掉上一个用例留下的列表，并忽略还在飞的请求。 */
+export function resetProjectsStoreForTests(): void {
+  requestSeq += 1;
+  snapshot = EMPTY_SNAPSHOT;
+  emit();
+}

package/src/lib/attachments.ts

@@ -19,6 +19,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 会二次校验）。 */

package/src/lib/electron-bridge.ts

@@ -48,6 +48,7 @@ export interface ApprovalPromptRequest {
   mode: string;
   category: string;
   round: number;
+  /** 发起审批的对话。缺省时卡片不绑定会话（旧请求）。 */
   chatId?: string;
 }
 
@@ -196,10 +197,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/exec-policy.ts

@@ -2,7 +2,7 @@
  * 会话级命令执行沙箱（类 Codex 的 sandbox_mode）。
  *
  * 作用于下一轮 `chat.stream` 的 `execSandbox`，不是 sidecar 进程沙箱
- * （设置页那一层）。工作区 = 只能写入当前项目或本对话工作区；完整权限
+ * （设置页那一层）。工作区 = 只能写入项目家目录、源文件夹（含各自子目录）或本对话工作区；完整权限
  * = 关闭逐条命令沙箱。工具审批（允许/拒绝）仍按原策略生效。
  */
 

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/local-api.ts

@@ -387,7 +387,7 @@ export interface LocalProject {
   id: string;
   name: string;
   folderPath: string;
-  /** 附加源文件夹（只读）。缺省空。 */
+  /** 附加源文件夹（可读写，含其子目录）。缺省空。 */
   sourceFolders?: string[];
   /** W6-5: 信任后该项目目录里的规则文件才会注入模型上下文。缺省 false。 */
   trusted?: boolean;

package/src/lib/tauri-bridge.ts

@@ -92,6 +92,11 @@ export function createTauriBridge(): HostBridge {
     offMenuOpenTerminal: terminalMenu.off,
     onMenuPaste: pasteMenu.on,
     offMenuPaste: pasteMenu.off,
+    readClipboard: () =>
+      invoke<{
+        text: string;
+        files: Array<{ name: string; path?: string; dataBase64?: string; mime?: string }>;
+      }>('host_read_clipboard'),
     readClipboardText: () => invoke<string>('host_read_clipboard_text'),
     app: {
       snapshot: () => invoke<AppReleaseSnapshot>('app_release_snapshot'),