@steerable/agent-shell-web 0.6.47 → 0.6.49

package/src/lib/portable.ts

@@ -0,0 +1,229 @@
+/**
+ * 对话包与配置包的渲染层。产品须把 VITE_PORTABLE 打成 'true' 才出现入口。
+ * 界面档位和命令权限存在 localStorage，由这里并进配置包；其余段走本地后端。
+ */
+
+import { getElectronBridge } from '@/lib/electron-bridge';
+import { listChats } from '@/lib/local-api';
+import { persistExecPolicy, readStoredExecPolicy, type ExecPolicy } from '@/lib/exec-policy';
+import {
+  isThinkingDisplayMode,
+  persistThinkingDisplay,
+  readThinkingDisplay,
+  type ThinkingDisplayMode,
+} from '@/lib/show-thinking-content';
+
+export function isPortableEnabled(): boolean {
+  return import.meta.env.VITE_PORTABLE === 'true';
+}
+
+export interface PortablePreviewSection {
+  id: string;
+  label: string;
+  detail: string;
+  clientOnly: boolean;
+  hasSecret: boolean;
+}
+
+export const PORTABLE_CHATS_CHANGED_EVENT = 'steerable-portable-chats-changed';
+
+export interface PortablePreview {
+  kind: 'steerable-config' | 'steerable-chat' | 'steerable-chats';
+  includeSecrets: boolean;
+  sections: PortablePreviewSection[];
+  chat?: {
+    title: string;
+    messageCount: number;
+    attachmentCount: number;
+    omittedAttachmentCount: number;
+    truncated: boolean;
+    count?: number;
+    projectName?: string;
+    projectCount?: number;
+  };
+}
+
+export interface PortableConfigDocument {
+  kind: 'steerable-config';
+  schemaVersion: number;
+  exportedAt: string;
+  includeSecrets: boolean;
+  sections: Record<string, unknown>;
+}
+
+export interface PortableImportResult {
+  applied: string[];
+  skipped: Array<{ id: string; reason: string }>;
+  notes: string[];
+  missingSkills: string[];
+  clientSections: string[];
+}
+
+export interface PortableChatImportResult {
+  chatId: string;
+  title: string;
+  messageCount: number;
+  attachmentsSaved: number;
+}
+
+const CLIENT_SECTION_IDS = ['appearance', 'execPolicy'] as const;
+
+export function portableErrorMessage(err: unknown): string {
+  if (!(err instanceof Error)) return '操作失败';
+  const message = err.message.trim();
+  if (!message) return '操作失败';
+  try {
+    const parsed = JSON.parse(message) as { detail?: unknown; error?: unknown };
+    if (typeof parsed.detail === 'string' && parsed.detail.trim()) return parsed.detail;
+    if (typeof parsed.error === 'string' && parsed.error.trim()) return parsed.error;
+  } catch {
+    // 后端在浏览器模式直接给出文案；桌面模式把 JSON 放进 message。
+  }
+  return message;
+}
+
+export function parsePortableText(text: string): { ok: true; value: unknown } | { ok: false; error: string } {
+  try {
+    return { ok: true, value: JSON.parse(text) as unknown };
+  } catch {
+    return { ok: false, error: '文件不是 JSON' };
+  }
+}
+
+export function safeDownloadName(stem: string, suffix: string): string {
+  const cleaned = stem.replace(/[\\/:*?"<>|]/g, ' ').replace(/\s+/g, ' ').trim().slice(0, 40);
+  return `${cleaned || '导出'}-${suffix}.json`;
+}
+
+export function readLocalSections(): { appearance: { thinkingDisplay: ThinkingDisplayMode }; execPolicy: { policy: ExecPolicy } } {
+  return {
+    appearance: { thinkingDisplay: readThinkingDisplay() },
+    execPolicy: { policy: readStoredExecPolicy() },
+  };
+}
+
+/** 把勾选的本机段并进服务端导出的配置包，并删掉没勾的段。 */
+export function finishConfigDocument(
+  document: PortableConfigDocument,
+  selected: ReadonlySet<string>,
+): PortableConfigDocument {
+  const sections: Record<string, unknown> = {};
+  for (const [id, value] of Object.entries(document.sections)) {
+    if (selected.has(id)) sections[id] = value;
+  }
+  const local = readLocalSections();
+  if (selected.has('appearance')) sections.appearance = local.appearance;
+  if (selected.has('execPolicy')) sections.execPolicy = local.execPolicy;
+  return { ...document, sections };
+}
+
+export function applyClientSections(
+  sections: Record<string, unknown>,
+  selected: ReadonlySet<string>,
+): void {
+  if (selected.has('appearance')) {
+    const appearance = sections.appearance as { thinkingDisplay?: unknown } | undefined;
+    if (isThinkingDisplayMode(appearance?.thinkingDisplay)) {
+      persistThinkingDisplay(appearance.thinkingDisplay);
+    }
+  }
+  if (selected.has('execPolicy')) {
+    const policy = (sections.execPolicy as { policy?: unknown } | undefined)?.policy;
+    if (policy === 'workspace' || policy === 'full') persistExecPolicy(policy);
+  }
+}
+
+export function isClientSection(id: string): boolean {
+  return (CLIENT_SECTION_IDS as readonly string[]).includes(id);
+}
+
+async function request<T>(method: string, path: string, body?: unknown): Promise<T> {
+  const bridge = getElectronBridge();
+  if (!bridge) throw new Error('当前环境没有本地后端');
+  return bridge.localBackend.request<T>(body === undefined ? { method, path } : { method, path, body });
+}
+
+export async function fetchConfigDocument(includeSecrets: boolean): Promise<PortableConfigDocument> {
+  const flag = includeSecrets ? '1' : '0';
+  return request<PortableConfigDocument>('GET', `/api/v2/portable/config?includeSecrets=${flag}`);
+}
+
+export async function fetchChatDocument(chatId: string): Promise<unknown> {
+  return request('GET', `/api/v2/chats/${encodeURIComponent(chatId)}/portable`);
+}
+
+/** 设置页导出对话用。按更新时间分页拉全，避免只导出第一页。 */
+export async function listPortableChats(): Promise<Array<{ id: string; title: string }>> {
+  const rows: Array<{ id: string; title: string }> = [];
+  let page = 1;
+  for (;;) {
+    const res = await listChats({ page, limit: 100 });
+    for (const chat of res.chats) {
+      rows.push({ id: chat.id, title: chat.title.trim() || '未命名对话' });
+    }
+    if (!res.pagination.hasMore || page >= 50) break;
+    page += 1;
+  }
+  return rows;
+}
+
+export async function previewPortableDocument(document: unknown): Promise<PortablePreview> {
+  return request<PortablePreview>('POST', '/api/v2/portable/preview', { document });
+}
+
+export async function importConfigDocument(
+  document: unknown,
+  sections: readonly string[],
+): Promise<PortableImportResult> {
+  return request<PortableImportResult>('POST', '/api/v2/portable/config', { document, sections });
+}
+
+export async function importChatDocument(document: unknown): Promise<PortableChatImportResult> {
+  const result = await request<PortableChatImportResult>('POST', '/api/v2/portable/chats', { document });
+  if (typeof window !== 'undefined') {
+    window.dispatchEvent(new Event(PORTABLE_CHATS_CHANGED_EVENT));
+  }
+  return result;
+}
+
+export async function saveJsonFile(filename: string, data: unknown): Promise<string | null> {
+  const content = `${JSON.stringify(data, null, 2)}\n`;
+  const save = getElectronBridge()?.local?.saveTextFile;
+  if (save) {
+    const saved = await save({ title: '导出', defaultPath: filename, content });
+    if (saved.canceled || !saved.filePath) return null;
+    return saved.filePath;
+  }
+  if (typeof document === 'undefined') return filename;
+  const url = URL.createObjectURL(new Blob([content], { type: 'application/json' }));
+  const link = document.createElement('a');
+  link.href = url;
+  link.download = filename;
+  link.click();
+  URL.revokeObjectURL(url);
+  return filename;
+}
+
+export function pickJsonFile(): Promise<string | null> {
+  return new Promise((resolve) => {
+    if (typeof document === 'undefined') {
+      resolve(null);
+      return;
+    }
+    const input = document.createElement('input');
+    input.type = 'file';
+    input.accept = 'application/json,.json';
+    input.onchange = () => {
+      const file = input.files?.[0];
+      if (!file) {
+        resolve(null);
+        return;
+      }
+      const reader = new FileReader();
+      reader.onload = () => resolve(typeof reader.result === 'string' ? reader.result : null);
+      reader.onerror = () => resolve(null);
+      reader.readAsText(file);
+    };
+    input.click();
+  });
+}

package/src/lib/tauri-bridge.ts

@@ -8,7 +8,11 @@
 import { invoke } from '@tauri-apps/api/core';
 import { listen, type UnlistenFn } from '@tauri-apps/api/event';
 import html2canvas from 'html2canvas';
-import type { HostBridge } from './electron-bridge';
+import type {
+  AppReleaseSnapshot,
+  HostBridge,
+  PythonRunnerSnapshot,
+} from './electron-bridge';
 import { createHttpBridge } from './http-bridge';
 
 type VoidCallback = () => void;
@@ -38,6 +42,7 @@ export function createTauriBridge(): HostBridge {
   const bridge = createHttpBridge();
   const newChatMenu = createMenuSubscription('menu:new-chat');
   const terminalMenu = createMenuSubscription('menu:open-terminal');
+  const pasteMenu = createMenuSubscription('menu:paste');
 
   return {
     ...bridge,
@@ -85,6 +90,61 @@ export function createTauriBridge(): HostBridge {
     offMenuNewChat: newChatMenu.off,
     onMenuOpenTerminal: terminalMenu.on,
     offMenuOpenTerminal: terminalMenu.off,
+    onMenuPaste: pasteMenu.on,
+    offMenuPaste: pasteMenu.off,
+    readClipboardText: () => invoke<string>('host_read_clipboard_text'),
+    app: {
+      snapshot: () => invoke<AppReleaseSnapshot>('app_release_snapshot'),
+      check: () => invoke<AppReleaseSnapshot>('app_release_check'),
+      install: () => invoke<AppReleaseSnapshot>('app_release_install'),
+      onState(callback) {
+        let unlisten: UnlistenFn | undefined;
+        let cancelled = false;
+        const pending = listen<AppReleaseSnapshot>('app-update-state', (event) => {
+          callback(event.payload);
+        });
+        void pending.then((stop) => {
+          if (cancelled) stop();
+          else unlisten = stop;
+        });
+        return () => {
+          cancelled = true;
+          if (unlisten) unlisten();
+          else void pending.then((stop) => stop());
+        };
+      },
+    },
+    pythonRunner: {
+      snapshot: () => invoke<PythonRunnerSnapshot>('python_runner_snapshot'),
+      download: (url) =>
+        invoke<PythonRunnerSnapshot>('python_runner_download', {
+          url: url ?? null,
+        }),
+      cancel: () => invoke<PythonRunnerSnapshot>('python_runner_cancel'),
+      pickLocal: () => invoke<string | null>('python_runner_pick_local'),
+      useLocal: (path) =>
+        invoke<PythonRunnerSnapshot>('python_runner_use_local', { path }),
+      useDefault: () =>
+        invoke<PythonRunnerSnapshot>('python_runner_use_default'),
+      restart: () => invoke<void>('python_runner_restart'),
+      onState(callback) {
+        let unlisten: UnlistenFn | undefined;
+        let cancelled = false;
+        const pending = listen<PythonRunnerSnapshot>(
+          'python-runner-state',
+          (event) => callback(event.payload),
+        );
+        void pending.then((stop) => {
+          if (cancelled) stop();
+          else unlisten = stop;
+        });
+        return () => {
+          cancelled = true;
+          if (unlisten) unlisten();
+          else void pending.then((stop) => stop());
+        };
+      },
+    },
   };
 }
 

package/src/main.tsx

@@ -8,6 +8,7 @@ import { SettingsPage } from './pages/SettingsPage';
 import { getPackRoutes } from './packs/registry';
 import { getBrandLogoUrl, BRAND_NAME } from './brand';
 import { getAppShellGate } from './auth/gate';
+import { installHostPaste } from './lib/host-paste';
 import './styles/index.css';
 
 // 浏览器 dev mock 的安装在 bootstrap() 开头（动态 import + DEV 门）。
@@ -98,6 +99,7 @@ export async function bootstrap(): Promise<void> {
   // （品牌 logo 由包经 setBrandLogoUrl 注入，见 brand.ts）。
   document.title = BRAND_NAME;
   document.querySelector<HTMLLinkElement>('link[rel="icon"]')?.setAttribute('href', getBrandLogoUrl());
+  installHostPaste();
 
   const rootEl = document.getElementById('root');
   if (!rootEl) {

package/src/pages/AgentPage.tsx

@@ -1042,6 +1042,22 @@ function AgentChatView({
     ];
   }, [messages, remoteContent, chatId]);
   const effectiveIsStreaming = isStreaming || remoteStreaming;
+
+  useEffect(() => {
+    if (!chatId) return;
+    window.dispatchEvent(
+      new CustomEvent("chat:streaming-change", {
+        detail: { chatId, isStreaming: effectiveIsStreaming },
+      }),
+    );
+    return () => {
+      window.dispatchEvent(
+        new CustomEvent("chat:streaming-change", {
+          detail: { chatId, isStreaming: false },
+        }),
+      );
+    };
+  }, [chatId, effectiveIsStreaming]);
   const effectiveCurrentTurnActions: ExecutedAction[] = remoteStreaming
     ? ((liveStream.executedActions as ExecutedAction[] | undefined) ?? [])
     : currentTurnActions;
@@ -1101,6 +1117,7 @@ function AgentChatView({
             chatSlots={ctx.chatSlots}
             rightPanel={ctx.rightPanel}
             onToggleChatSlot={ctx.onToggleChatSlot}
+            onToggleRightPanel={ctx.onToggleChatSlot}
           />
         }
         onRegenerate={

package/src/pages/SettingsPage.tsx

@@ -1,9 +1,12 @@
 import { useRef, useState } from 'react';
-import { LuActivity, LuBlocks, LuBot, LuChartBar, LuMonitor, LuNetwork, LuPlug, LuSearch, LuSettings, LuShieldCheck } from 'react-icons/lu';
+import { LuActivity, LuBlocks, LuBot, LuChartBar, LuDownload, LuMonitor, LuNetwork, LuPlug, LuSearch, LuSettings, LuShieldCheck } from 'react-icons/lu';
 import { useOutletContext, useSearchParams } from 'react-router-dom';
 import { isElectron } from '@/lib/electron-bridge';
 import { AgentsSettingsPanel } from '@/components/settings/AgentsSettingsPanel';
 import { AppearanceSettingsPanel } from '@/components/settings/AppearanceSettingsPanel';
+import { AppUpdateSettingsPanel } from '@/components/settings/AppUpdateSettingsPanel';
+import { PortableSettingsPanel } from '@/components/settings/PortableSettingsPanel';
+import { PythonRunnerSettingsPanel } from '@/components/settings/PythonRunnerSettingsPanel';
 import { DiagnoseSettingsPanel } from '@/components/settings/DiagnoseSettingsPanel';
 import { InsightsSettingsPanel } from '@/components/settings/InsightsSettingsPanel';
 import {
@@ -20,6 +23,7 @@ import { UsagePanel } from '@/components/settings/UsagePanel';
 import { WebSearchSettingsPanel } from '@/components/settings/WebSearchSettingsPanel';
 import { getPackSettingsPanels } from '@/packs/registry';
 import { settingsChrome } from '@/lib/host-tools';
+import { isPortableEnabled } from '@/lib/portable';
 import type { AgentOutletContext } from '@/layouts/AgentLayout';
 
 type SettingsSection = 'skills' | 'mcp' | 'agents' | 'general';
@@ -36,7 +40,7 @@ function resolveSection(raw: string | null): SettingsSection {
  *   - `skills`  侧栏「Skill 设置」
  *   - `mcp`     侧栏「MCP 设置」
  *   - `agents`  侧栏「智能体管理」
- *   - 缺省/`general`  侧栏底「设置」（界面 / 模型 / 搜索 / 用量 / 安全 / 洞察 / 遥测）
+ *   - 缺省/`general`  侧栏底「设置」（界面 / 模型 / 搜索 / 用量 / 安全 / 洞察 / 遥测 / 关于）
  *
  * Panel 数据自管理（挂载即拉取），页面本身不持有后端状态。
  */
@@ -216,6 +220,19 @@ export function SettingsPage() {
                   <panel.Component />
                 </section>
               ))}
+
+              {isPortableEnabled() && (
+              <section className="space-y-2" data-testid="settings-section-portable">
+                <h2 className="flex items-center gap-1.5 text-xs font-semibold text-agent-foreground">
+                  <LuDownload className="h-3.5 w-3.5 text-agent-muted-foreground" />
+                  备份与迁移
+                </h2>
+                <PortableSettingsPanel />
+              </section>
+              )}
+
+              <PythonRunnerSettingsPanel />
+              <AppUpdateSettingsPanel />
             </>
           )}
         </div>

package/src/styles/index.css

@@ -164,3 +164,32 @@ body {
 .chat-input-surface:has(.chat-input-editor[data-composing]) .chat-input-mirror {
   visibility: hidden;
 }
+
+/*
+ * Thin scrollbars everywhere. The system "always show" bar is about 15px.
+ * Kept in the base layer so a utility can still hide a scrollbar.
+ */
+@layer base {
+  * {
+    scrollbar-width: thin;
+    scrollbar-color: color-mix(in oklab, var(--color-agent-foreground) 28%, transparent) transparent;
+  }
+
+  *::-webkit-scrollbar {
+    width: 6px;
+    height: 6px;
+  }
+
+  *::-webkit-scrollbar-track {
+    background: transparent;
+  }
+
+  *::-webkit-scrollbar-thumb {
+    background: color-mix(in oklab, var(--color-agent-foreground) 28%, transparent);
+    border-radius: 999px;
+  }
+
+  *::-webkit-scrollbar-thumb:hover {
+    background: color-mix(in oklab, var(--color-agent-foreground) 45%, transparent);
+  }
+}

package/src/vite-env.d.ts

@@ -10,6 +10,8 @@ interface ImportMetaEnv {
   readonly VITE_APPROVAL?: string;
   readonly VITE_CHAT_MODES?: string;
   readonly VITE_SETTINGS?: string;
+  /** `'true'` 才打开对话与配置的导出/导入。缺省关。 */
+  readonly VITE_PORTABLE?: string;
 }
 
 interface ImportMeta {

package/vite.base.js

@@ -58,6 +58,7 @@ export function createProductViteConfig(options) {
             'import.meta.env.VITE_APPROVAL': JSON.stringify(product.approval ?? 'host'),
             'import.meta.env.VITE_CHAT_MODES': JSON.stringify(JSON.stringify(product.chatModes ?? ['agent', 'plan'])),
             'import.meta.env.VITE_SETTINGS': JSON.stringify(JSON.stringify(product.settings ?? {})),
+            'import.meta.env.VITE_PORTABLE': JSON.stringify(product.portable === true ? 'true' : 'false'),
         },
         resolve: {
             alias: {