refactor(startup): simplify stack to Tauri-managed OpenFang + optional ChromeDriver

- Remove OpenFang CLI dependency from startup scripts
- OpenFang now bundled with Tauri and managed via gateway_start/gateway_status commands
- Add bootstrap screen in App.tsx to auto-start local gateway before UI loads
- Update Makefile: replace start-no-gateway with start-desktop-only
- Fix gateway config endpoints: use /api/config instead of /api/config/quick
- Add Playwright dependencies for future E2E testing

Makefile

@@ -1,7 +1,7 @@
 # ZCLAW Makefile
 # Cross-platform task runner
 
-.PHONY: help start start-dev start-no-browser start-no-gateway desktop desktop-build setup test clean
+.PHONY: help start start-dev start-no-browser desktop desktop-build setup test clean
 
 help: ## Show this help message
 	@echo "ZCLAW - OpenFang Desktop Client"
@@ -13,16 +13,16 @@ help: ## Show this help message
 # === Startup Commands ===
 
 start: ## Start all services (Windows: PowerShell)
-	@pwsh -File ./start.ps1
+	@powershell -ExecutionPolicy Bypass -File ./start-all.ps1
 
 start-dev: ## Start all services in dev mode
-	@pwsh -File ./start.ps1 -Dev
+	@powershell -ExecutionPolicy Bypass -File ./start-all.ps1 -Dev
 
 start-no-browser: ## Start without ChromeDriver
-	@pwsh -File ./start.ps1 -NoBrowser
+	@powershell -ExecutionPolicy Bypass -File ./start-all.ps1 -NoBrowser
 
-start-no-gateway: ## Start without OpenFang gateway
-	@pwsh -File ./start.ps1 -NoGateway
+start-desktop-only: ## Start desktop only (no external services)
+	@powershell -ExecutionPolicy Bypass -File ./start-all.ps1 -DesktopOnly
 
 start-unix: ## Start all services (Unix: macOS/Linux)
 	@chmod +x ./start.sh && ./start.sh
@@ -54,12 +54,6 @@ typecheck: ## Run TypeScript type check
 
 # === Services ===
 
-gateway: ## Start OpenFang gateway
-	@openfang gateway start
-
-gateway-status: ## Check gateway status
-	@openfang gateway status
-
 chromedriver: ## Start ChromeDriver on port 4444
 	@chromedriver --port=4444
 

desktop/pnpm-lock.yaml

@@ -51,6 +51,9 @@ importers:
         specifier: ^5.0.11
         version: 5.0.11(@types/react@19.2.14)(react@19.2.4)
     devDependencies:
+      '@playwright/test':
+        specifier: ^1.58.2
+        version: 1.58.2
       '@tailwindcss/vite':
         specifier: ^4.2.1
         version: 4.2.1(vite@7.3.1(jiti@2.6.1)(lightningcss@1.31.1))
@@ -75,6 +78,9 @@ importers:
       autoprefixer:
         specifier: ^10.4.27
         version: 10.4.27(postcss@8.5.8)
+      playwright:
+        specifier: ^1.58.2
+        version: 1.58.2
       postcss:
         specifier: ^8.5.8
         version: 8.5.8
@@ -345,6 +351,11 @@ packages:
   '@jridgewell/trace-mapping@0.3.31':
     resolution: {integrity: sha512-zzNR+SdQSDJzc8joaeP8QQoCQr8NuYx2dIIytl1QeBEZHJ9uW6hebsrYgbz8hJwUQao3TWCMtmfV8Nu1twOLAw==}
 
+  '@playwright/test@1.58.2':
+    resolution: {integrity: sha512-akea+6bHYBBfA9uQqSYmlJXn61cTa+jbO87xVLCWbTqbWadRVmhxlXATaOjOgcBaWU4ePo0wB41KMFv3o35IXA==}
+    engines: {node: '>=18'}
+    hasBin: true
+
   '@rolldown/pluginutils@1.0.0-beta.27':
     resolution: {integrity: sha512-+d0F4MKMCbeVUJwG96uQ4SgAznZNSq93I3V+9NHA4OpvqG8mRCpGdKmK8l/dl02h2CCDHwW2FqilnTyDcAnqjA==}
 
@@ -786,6 +797,11 @@ packages:
       react-dom:
         optional: true
 
+  fsevents@2.3.2:
+    resolution: {integrity: sha512-xiqMQR4xAeHTuB9uWm+fFRcIOgKBMiOBP+eXiyT7jsgVCq1bkVygt00oASowB7EdtpOHaaPgKt812P9ab+DDKA==}
+    engines: {node: ^8.16.0 || ^10.6.0 || >=11.0.0}
+    os: [darwin]
+
   fsevents@2.3.3:
     resolution: {integrity: sha512-5xoDfX+fL7faATnagmWPpbFtwh/R77WmMMqqHGS65C3vvB0YHrgF+B1YmZ3441tMj5n63k0212XNoJwzlhffQw==}
     engines: {node: ^8.16.0 || ^10.6.0 || >=11.0.0}
@@ -924,6 +940,16 @@ packages:
     resolution: {integrity: sha512-5gTmgEY/sqK6gFXLIsQNH19lWb4ebPDLA4SdLP7dsWkIXHWlG66oPuVvXSGFPppYZz8ZDZq0dYYrbHfBCVUb1Q==}
     engines: {node: '>=12'}
 
+  playwright-core@1.58.2:
+    resolution: {integrity: sha512-yZkEtftgwS8CsfYo7nm0KE8jsvm6i/PTgVtB8DL726wNf6H2IMsDuxCpJj59KDaxCtSnrWan2AeDqM7JBaultg==}
+    engines: {node: '>=18'}
+    hasBin: true
+
+  playwright@1.58.2:
+    resolution: {integrity: sha512-vA30H8Nvkq/cPBnNw4Q8TWz1EJyqgpuinBcHET0YVJVFldr8JDNiU9LaWAE1KqSkRYazuaBhTpB5ZzShOezQ6A==}
+    engines: {node: '>=18'}
+    hasBin: true
+
   postcss-value-parser@4.2.0:
     resolution: {integrity: sha512-1NNCs6uurfkVbeXG4S8JFT9t19m45ICnif8zWLd5oPSZ50QnwMfK+H3jv408d4jw/7Bttv5axS5IiHoLaVNHeQ==}
 
@@ -1277,6 +1303,10 @@ snapshots:
       '@jridgewell/resolve-uri': 3.1.2
       '@jridgewell/sourcemap-codec': 1.5.5
 
+  '@playwright/test@1.58.2':
+    dependencies:
+      playwright: 1.58.2
+
   '@rolldown/pluginutils@1.0.0-beta.27': {}
 
   '@rollup/rollup-android-arm-eabi@4.59.0':
@@ -1615,6 +1645,9 @@ snapshots:
       react: 19.2.4
       react-dom: 19.2.4(react@19.2.4)
 
+  fsevents@2.3.2:
+    optional: true
+
   fsevents@2.3.3:
     optional: true
 
@@ -1707,6 +1740,14 @@ snapshots:
 
   picomatch@4.0.3: {}
 
+  playwright-core@1.58.2: {}
+
+  playwright@1.58.2:
+    dependencies:
+      playwright-core: 1.58.2
+    optionalDependencies:
+      fsevents: 2.3.2
+
   postcss-value-parser@4.2.0: {}
 
   postcss@8.5.8:

desktop/src/App.tsx

@@ -14,16 +14,31 @@ import { useTeamStore } from './store/teamStore';
 import { getStoredGatewayToken } from './lib/gateway-client';
 import { pageVariants, defaultTransition, fadeInVariants } from './lib/animations';
 import { silentErrorHandler } from './lib/error-utils';
-import { Bot, Users } from 'lucide-react';
+import { Bot, Users, Loader2 } from 'lucide-react';
 import { EmptyState } from './components/ui';
+import { isTauriRuntime, getLocalGatewayStatus, startLocalGateway } from './lib/tauri-gateway';
 
 type View = 'main' | 'settings';
 
+// Bootstrap component that ensures OpenFang is running before rendering main UI
+function BootstrapScreen({ status }: { status: string }) {
+  return (
+    <div className="h-screen flex items-center justify-center bg-gray-50">
+      <div className="flex flex-col items-center gap-4">
+        <Loader2 className="w-8 h-8 animate-spin text-blue-500" />
+        <p className="text-gray-600 text-sm">{status}</p>
+      </div>
+    </div>
+  );
+}
+
 function App() {
   const [view, setView] = useState<View>('main');
   const [mainContentView, setMainContentView] = useState<MainViewType>('chat');
   const [selectedHandId, setSelectedHandId] = useState<string | undefined>(undefined);
   const [selectedTeamId, setSelectedTeamId] = useState<string | undefined>(undefined);
+  const [bootstrapping, setBootstrapping] = useState(true);
+  const [bootstrapStatus, setBootstrapStatus] = useState('Initializing...');
   const { connect, connectionState } = useGatewayStore();
   const { activeTeam, setActiveTeam, teams } = useTeamStore();
 
@@ -31,12 +46,61 @@ function App() {
     document.title = 'ZCLAW';
   }, []);
 
+  // Bootstrap: Start OpenFang Gateway before rendering main UI
   useEffect(() => {
-    if (connectionState === 'disconnected') {
-      const gatewayToken = getStoredGatewayToken();
-      connect(undefined, gatewayToken).catch(silentErrorHandler('App'));
+    let mounted = true;
+
+    const bootstrap = async () => {
+      try {
+        // Step 1: Check and start local gateway in Tauri environment
+        if (isTauriRuntime()) {
+          setBootstrapStatus('Checking gateway status...');
+
+          try {
+            const status = await getLocalGatewayStatus();
+            const isRunning = status.portStatus === 'busy' || status.listenerPids.length > 0;
+
+            if (!isRunning && status.cliAvailable) {
+              setBootstrapStatus('Starting OpenFang Gateway...');
+              console.log('[App] Local gateway not running, auto-starting...');
+
+              await startLocalGateway();
+
+              // Wait for gateway to be ready
+              await new Promise(resolve => setTimeout(resolve, 2000));
+              console.log('[App] Local gateway started');
+            } else if (isRunning) {
+              console.log('[App] Local gateway already running');
             }
-  }, [connect, connectionState]);
+          } catch (err) {
+            console.warn('[App] Failed to check/start local gateway:', err);
+          }
+        }
+
+        if (!mounted) return;
+
+        // Step 2: Connect to gateway
+        setBootstrapStatus('Connecting to gateway...');
+        const gatewayToken = getStoredGatewayToken();
+        await connect(undefined, gatewayToken);
+
+        if (!mounted) return;
+
+        // Step 3: Bootstrap complete
+        setBootstrapping(false);
+      } catch (err) {
+        console.error('[App] Bootstrap failed:', err);
+        // Still allow app to load, connection status will show error
+        setBootstrapping(false);
+      }
+    };
+
+    bootstrap();
+
+    return () => {
+      mounted = false;
+    };
+  }, [connect]);
 
   // 当切换到非 hands 视图时清除选中的 Hand
   const handleMainViewChange = (view: MainViewType) => {
@@ -59,6 +123,11 @@ function App() {
     return <SettingsLayout onBack={() => setView('main')} />;
   }
 
+  // Show bootstrap screen while starting gateway
+  if (bootstrapping) {
+    return <BootstrapScreen status={bootstrapStatus} />;
+  }
+
   return (
     <div className="h-screen flex overflow-hidden text-gray-800 text-sm">
       {/* 左侧边栏 */}

desktop/src/lib/gateway-client.ts

@@ -1086,7 +1086,28 @@ export class GatewayClient {
   }
   async getQuickConfig(): Promise<any> {
     try {
-      return await this.restGet('/api/config/quick');
+      // Use /api/config endpoint (OpenFang's actual config endpoint)
+      const config = await this.restGet('/api/config');
+      // Map OpenFang config to frontend expected format
+      return {
+        quickConfig: {
+          agentName: 'ZCLAW',
+          agentRole: 'AI 助手',
+          userName: '用户',
+          userRole: '用户',
+          agentNickname: 'ZCLAW',
+          scenarios: ['通用对话', '代码助手', '文档编写'],
+          workspaceDir: config.data_dir || config.home_dir,
+          gatewayUrl: this.baseUrl,
+          defaultModel: config.default_model?.model,
+          defaultProvider: config.default_model?.provider,
+          theme: 'dark',
+          showToolCalls: true,
+          autoSaveContext: true,
+          fileWatching: true,
+          privacyOptIn: false,
+        }
+      };
     } catch (error) {
       // Return structured fallback if API not available (404)
       if (isNotFoundError(error)) {
@@ -1096,7 +1117,16 @@ export class GatewayClient {
     }
   }
   async saveQuickConfig(config: Record<string, any>): Promise<any> {
-    return this.restPut('/api/config/quick', config);
+    // Use /api/config endpoint for saving config
+    // Map frontend config back to OpenFang format
+    const openfangConfig = {
+      data_dir: config.workspaceDir,
+      default_model: config.defaultModel ? {
+        model: config.defaultModel,
+        provider: config.defaultProvider || 'bailian',
+      } : undefined,
+    };
+    return this.restPut('/api/config', openfangConfig);
   }
   async listSkills(): Promise<any> {
     return this.restGet('/api/skills');

desktop/src/store/connectionStore.ts

@@ -219,6 +219,26 @@ export const useConnectionStore = create<ConnectionStore>((set, get) => {
           } catch {
             /* ignore local gateway preparation failures during connection bootstrap */
           }
+
+          // Auto-start local gateway if not running
+          try {
+            const localStatus = await fetchLocalGatewayStatus();
+            const isRunning = localStatus.portStatus === 'busy' || localStatus.listenerPids.length > 0;
+
+            if (!isRunning && localStatus.cliAvailable) {
+              console.log('[ConnectionStore] Local gateway not running, auto-starting...');
+              set({ localGatewayBusy: true });
+              await startLocalGatewayCommand();
+              set({ localGatewayBusy: false });
+
+              // Wait for gateway to be ready
+              await new Promise(resolve => setTimeout(resolve, 1500));
+              console.log('[ConnectionStore] Local gateway started');
+            }
+          } catch (startError) {
+            console.warn('[ConnectionStore] Failed to auto-start local gateway:', startError);
+            set({ localGatewayBusy: false });
+          }
         }
 
         // Resolve effective token: param > quickConfig > localStorage > local auth

desktop/src/store/gatewayStore.ts

@@ -659,12 +659,34 @@ export const useGatewayStore = create<GatewayStore>((set, get) => {
 
       try {
         set({ error: null });
+
+        // Prepare local gateway for Tauri
         if (isTauriRuntime()) {
           try {
             await prepareLocalGatewayForTauri();
           } catch {
             /* ignore local gateway preparation failures during connection bootstrap */
           }
+
+          // Auto-start local gateway if not running
+          try {
+            const localStatus = await getLocalGatewayStatus();
+            const isRunning = localStatus.portStatus === 'busy' || localStatus.listenerPids.length > 0;
+
+            if (!isRunning && localStatus.cliAvailable) {
+              console.log('[GatewayStore] Local gateway not running, auto-starting...');
+              set({ localGatewayBusy: true });
+              await startLocalGatewayCommand();
+              set({ localGatewayBusy: false });
+
+              // Wait for gateway to be ready
+              await new Promise(resolve => setTimeout(resolve, 1500));
+              console.log('[GatewayStore] Local gateway started');
+            }
+          } catch (startError) {
+            console.warn('[GatewayStore] Failed to auto-start local gateway:', startError);
+            set({ localGatewayBusy: false });
+          }
         }
         // Use the first non-empty token from: param > quickConfig > localStorage
         let effectiveToken = token || get().quickConfig.gatewayToken || getStoredGatewayToken();

desktop/test-results/.last-run.json

@@ -0,0 +1,11 @@
+{
+  "status": "failed",
+  "failedTests": [
+    "ea562bc8f2f5f42dadea-a9ad995be4600240d5d9",
+    "ea562bc8f2f5f42dadea-aa98d5dacb19aae6a62f",
+    "ea562bc8f2f5f42dadea-24005574dbd87061e5f7",
+    "ea562bc8f2f5f42dadea-faee21c3e777f7004b5c",
+    "ea562bc8f2f5f42dadea-27f22490c6765498e906",
+    "ea562bc8f2f5f42dadea-233185470e18cdb79c26"
+  ]
+}

desktop/test-results/functional-scenarios-1-应用启动与初始化-1-1-应用正常启动并渲染所有核心组件-chromium/error-context.md

@@ -0,0 +1,246 @@
+# Page snapshot
+
+```yaml
+- generic [ref=e3]:
+  - complementary [ref=e4]:
+    - tablist [ref=e5]:
+      - tab "分身" [selected] [ref=e6]:
+        - img [ref=e7]
+        - generic [ref=e10]: 分身
+      - tab "Hands" [ref=e11]:
+        - img [ref=e12]
+        - generic [ref=e14]: Hands
+      - tab "工作流" [ref=e15]:
+        - img [ref=e16]
+        - generic [ref=e20]: 工作流
+      - tab "团队" [ref=e21]:
+        - img [ref=e22]
+        - generic [ref=e27]: 团队
+      - tab "协作" [ref=e28]:
+        - img [ref=e29]
+        - generic [ref=e33]: 协作
+    - generic [ref=e37]:
+      - generic [ref=e38] [cursor=pointer]:
+        - img [ref=e40]
+        - generic [ref=e43]:
+          - generic [ref=e44]:
+            - generic [ref=e45]: trader-hand
+            - generic [ref=e46]: 当前
+          - paragraph [ref=e47]: 新分身
+        - button "删除":
+          - img
+      - generic [ref=e48] [cursor=pointer]:
+        - img [ref=e50]
+        - generic [ref=e53]:
+          - generic [ref=e55]: researcher
+          - paragraph [ref=e56]: 新分身
+        - button "删除":
+          - img
+      - generic [ref=e57] [cursor=pointer]:
+        - img [ref=e59]
+        - generic [ref=e62]:
+          - generic [ref=e64]: browser-hand
+          - paragraph [ref=e65]: 新分身
+        - button "删除":
+          - img
+      - generic [ref=e66] [cursor=pointer]:
+        - img [ref=e68]
+        - generic [ref=e71]:
+          - generic [ref=e73]: collector-hand
+          - paragraph [ref=e74]: 新分身
+        - button "删除":
+          - img
+      - generic [ref=e75] [cursor=pointer]:
+        - img [ref=e77]
+        - generic [ref=e80]:
+          - generic [ref=e82]: researcher-hand
+          - paragraph [ref=e83]: 新分身
+        - button "删除":
+          - img
+      - generic [ref=e84] [cursor=pointer]:
+        - img [ref=e86]
+        - generic [ref=e89]:
+          - generic [ref=e91]: lead-hand
+          - paragraph [ref=e92]: 新分身
+        - button "删除":
+          - img
+      - generic [ref=e93] [cursor=pointer]:
+        - img [ref=e95]
+        - generic [ref=e98]:
+          - generic [ref=e100]: test-agent
+          - paragraph [ref=e101]: 新分身
+        - button "删除":
+          - img
+      - generic [ref=e102] [cursor=pointer]:
+        - img [ref=e104]
+        - generic [ref=e107]:
+          - generic [ref=e109]: predictor-hand
+          - paragraph [ref=e110]: 新分身
+        - button "删除":
+          - img
+      - generic [ref=e111] [cursor=pointer]:
+        - img [ref=e113]
+        - generic [ref=e116]:
+          - generic [ref=e118]: 测试助手
+          - paragraph [ref=e119]: 新分身
+        - button "删除":
+          - img
+      - generic [ref=e120] [cursor=pointer]:
+        - img [ref=e122]
+        - generic [ref=e125]: 创建新 Agent
+    - generic [ref=e127]:
+      - generic [ref=e128]: 用
+      - generic [ref=e129]: 用户
+      - button "打开设置" [ref=e130]:
+        - img [ref=e131]
+  - main [ref=e134]:
+    - generic [ref=e136]:
+      - heading "trader-hand" [level=2] [ref=e137]
+      - generic [ref=e138]: Gateway 已连接
+    - generic [ref=e142]:
+      - generic [ref=e145]: 🦞
+      - paragraph [ref=e147]: 你好！ 我是 trader-hand。有什么我可以帮你的吗？
+      - generic [ref=e148]:
+        - generic [ref=e149]:
+          - img [ref=e150]
+          - generic [ref=e152]: 快速开始
+        - button "💡 帮我写一个 Python 脚本处理 Excel 文件" [ref=e153]:
+          - generic [ref=e154]: 💡
+          - generic [ref=e155]: 帮我写一个 Python 脚本处理 Excel 文件
+          - img [ref=e156]
+        - button "📊 分析这个数据集的趋势和关键指标" [ref=e158]:
+          - generic [ref=e159]: 📊
+          - generic [ref=e160]: 分析这个数据集的趋势和关键指标
+          - img [ref=e161]
+        - button "✍️ 帮我起草一份产品需求文档" [ref=e163]:
+          - generic [ref=e164]: ✍️
+          - generic [ref=e165]: 帮我起草一份产品需求文档
+          - img [ref=e166]
+      - paragraph [ref=e168]: 发送消息开始对话，或点击上方建议
+    - generic [ref=e170]:
+      - generic [ref=e171]:
+        - button "添加附件" [ref=e172]:
+          - img [ref=e173]
+        - textbox "发送给 trader-hand" [ref=e176]
+        - generic [ref=e177]:
+          - button "选择模型" [ref=e178]:
+            - generic [ref=e179]: glm-5
+            - img [ref=e180]
+          - button "发送消息" [disabled] [ref=e182]:
+            - img [ref=e183]
+      - generic [ref=e185]: Agent 在本地运行，内容由 AI 生成
+  - complementary [ref=e186]:
+    - generic [ref=e187]:
+      - generic [ref=e188]:
+        - generic [ref=e189]:
+          - img [ref=e190]
+          - generic [ref=e192]: "0"
+        - generic [ref=e193]: 当前消息
+      - tablist [ref=e194]:
+        - tab "Status" [selected] [ref=e195]:
+          - img [ref=e196]
+        - tab "Files" [ref=e198]:
+          - img [ref=e199]
+        - tab "Agent" [ref=e202]:
+          - img [ref=e203]
+        - tab "Memory" [ref=e206]:
+          - img [ref=e207]
+    - generic [ref=e215]:
+      - generic [ref=e216]:
+        - generic [ref=e217]:
+          - generic [ref=e218]:
+            - img [ref=e219]
+            - generic [ref=e223]: Gateway Connected
+          - button "Refresh data" [ref=e224]:
+            - img [ref=e225]
+        - generic [ref=e230]:
+          - generic [ref=e231]:
+            - generic [ref=e232]: 地址
+            - generic [ref=e233]: ws://127.0.0.1:50051/ws
+          - generic [ref=e234]:
+            - generic [ref=e235]: 当前模型
+            - generic [ref=e236]: glm-5
+      - generic [ref=e237]:
+        - heading "当前会话" [level=3] [ref=e238]:
+          - img [ref=e239]
+          - text: 当前会话
+        - generic [ref=e241]:
+          - generic [ref=e242]:
+            - generic [ref=e243]: 用户消息
+            - generic [ref=e244]: "0"
+          - generic [ref=e245]:
+            - generic [ref=e246]: 助手回复
+            - generic [ref=e247]: "0"
+          - generic [ref=e248]:
+            - generic [ref=e249]: 工具调用
+            - generic [ref=e250]: "0"
+          - generic [ref=e251]:
+            - generic [ref=e252]: 总消息数
+            - generic [ref=e253]: "0"
+      - generic [ref=e254]:
+        - heading "分身状态" [level=3] [ref=e255]:
+          - img [ref=e256]
+          - text: 分身状态
+        - generic [ref=e259]:
+          - generic [ref=e260]:
+            - img [ref=e262]
+            - generic [ref=e265]: trader-hand
+          - generic [ref=e266]:
+            - img [ref=e268]
+            - generic [ref=e271]: researcher
+          - generic [ref=e272]:
+            - img [ref=e274]
+            - generic [ref=e277]: browser-hand
+          - generic [ref=e278]:
+            - img [ref=e280]
+            - generic [ref=e283]: collector-hand
+          - generic [ref=e284]:
+            - img [ref=e286]
+            - generic [ref=e289]: researcher-hand
+          - paragraph [ref=e290]: +4 个分身
+      - generic [ref=e291]:
+        - heading "用量统计" [level=3] [ref=e292]:
+          - img [ref=e293]
+          - text: 用量统计
+        - generic [ref=e295]:
+          - generic [ref=e296]:
+            - generic [ref=e297]: 总会话数
+            - generic [ref=e298]: "0"
+          - generic [ref=e299]:
+            - generic [ref=e300]: 总消息数
+            - generic [ref=e301]: "0"
+          - generic [ref=e302]:
+            - generic [ref=e303]: 总 Token
+            - generic [ref=e304]: "0"
+      - generic [ref=e305]:
+        - heading "插件 (3)" [level=3] [ref=e306]:
+          - img [ref=e307]
+          - text: 插件 (3)
+        - generic [ref=e309]:
+          - generic [ref=e310]:
+            - generic [ref=e311]: Chat
+            - generic [ref=e312]: 运行中
+          - generic [ref=e313]:
+            - generic [ref=e314]: Code
+            - generic [ref=e315]: 运行中
+          - generic [ref=e316]:
+            - generic [ref=e317]: File
+            - generic [ref=e318]: 运行中
+      - generic [ref=e319]:
+        - heading "运行概览" [level=3] [ref=e320]:
+          - img [ref=e321]
+          - text: 运行概览
+        - generic [ref=e324]:
+          - generic [ref=e325]:
+            - generic [ref=e326]: 连接状态
+            - generic [ref=e327]: 已连接
+          - generic [ref=e328]:
+            - generic [ref=e329]: Gateway 版本
+            - generic [ref=e330]: "-"
+          - generic [ref=e331]:
+            - generic [ref=e332]: 已加载分身
+            - generic [ref=e333]: "9"
+          - generic [ref=e334]:
+            - generic [ref=e335]: 已加载插件
+            - generic [ref=e336]: "3"
+```

desktop/test-results/functional-scenarios-10-完整用户流程-10-2-完整聊天流程-chromium/error-context.md

@@ -0,0 +1,243 @@
+# Page snapshot
+
+```yaml
+- generic [ref=e3]:
+  - complementary [ref=e4]:
+    - tablist [ref=e5]:
+      - tab "分身" [selected] [ref=e6]:
+        - img [ref=e7]
+        - generic [ref=e10]: 分身
+      - tab "Hands" [ref=e11]:
+        - img [ref=e12]
+        - generic [ref=e14]: Hands
+      - tab "工作流" [ref=e15]:
+        - img [ref=e16]
+        - generic [ref=e20]: 工作流
+      - tab "团队" [ref=e21]:
+        - img [ref=e22]
+        - generic [ref=e27]: 团队
+      - tab "协作" [ref=e28]:
+        - img [ref=e29]
+        - generic [ref=e33]: 协作
+    - generic [ref=e37]:
+      - generic [ref=e38] [cursor=pointer]:
+        - img [ref=e40]
+        - generic [ref=e43]:
+          - generic [ref=e44]:
+            - generic [ref=e45]: trader-hand
+            - generic [ref=e46]: 当前
+          - paragraph [ref=e47]: 新分身
+        - button "删除":
+          - img
+      - generic [ref=e48] [cursor=pointer]:
+        - img [ref=e50]
+        - generic [ref=e53]:
+          - generic [ref=e55]: researcher
+          - paragraph [ref=e56]: 新分身
+        - button "删除":
+          - img
+      - generic [ref=e57] [cursor=pointer]:
+        - img [ref=e59]
+        - generic [ref=e62]:
+          - generic [ref=e64]: browser-hand
+          - paragraph [ref=e65]: 新分身
+        - button "删除":
+          - img
+      - generic [ref=e66] [cursor=pointer]:
+        - img [ref=e68]
+        - generic [ref=e71]:
+          - generic [ref=e73]: collector-hand
+          - paragraph [ref=e74]: 新分身
+        - button "删除":
+          - img
+      - generic [ref=e75] [cursor=pointer]:
+        - img [ref=e77]
+        - generic [ref=e80]:
+          - generic [ref=e82]: researcher-hand
+          - paragraph [ref=e83]: 新分身
+        - button "删除":
+          - img
+      - generic [ref=e84] [cursor=pointer]:
+        - img [ref=e86]
+        - generic [ref=e89]:
+          - generic [ref=e91]: lead-hand
+          - paragraph [ref=e92]: 新分身
+        - button "删除":
+          - img
+      - generic [ref=e93] [cursor=pointer]:
+        - img [ref=e95]
+        - generic [ref=e98]:
+          - generic [ref=e100]: test-agent
+          - paragraph [ref=e101]: 新分身
+        - button "删除":
+          - img
+      - generic [ref=e102] [cursor=pointer]:
+        - img [ref=e104]
+        - generic [ref=e107]:
+          - generic [ref=e109]: predictor-hand
+          - paragraph [ref=e110]: 新分身
+        - button "删除":
+          - img
+      - generic [ref=e111] [cursor=pointer]:
+        - img [ref=e113]
+        - generic [ref=e116]:
+          - generic [ref=e118]: 测试助手
+          - paragraph [ref=e119]: 新分身
+        - button "删除":
+          - img
+      - generic [ref=e120] [cursor=pointer]:
+        - img [ref=e122]
+        - generic [ref=e125]: 创建新 Agent
+    - generic [ref=e127]:
+      - generic [ref=e128]: 用
+      - generic [ref=e129]: 用户
+      - button "打开设置" [ref=e130]:
+        - img [ref=e131]
+  - main [ref=e134]:
+    - generic [ref=e135]:
+      - generic [ref=e136]:
+        - heading "trader-hand" [level=2] [ref=e137]
+        - generic [ref=e138]: 正在输入中
+      - button "开始新对话" [ref=e141]:
+        - img [ref=e142]
+        - text: 新对话
+    - generic [ref=e145]:
+      - generic [ref=e147]:
+        - generic [ref=e148]: 用
+        - generic [ref=e151]: 你好
+      - generic [ref=e153]:
+        - generic [ref=e154]: Z
+        - generic [ref=e156]:
+          - generic [ref=e157]: "⚠️ Request failed: Request failed: Missing API key: No LLM provider configured. Set an API key (e.g. GROQ_API_KEY) and restart, configure a provider via the dashboard, or use Ollama for local models (no API key neede..."
+          - paragraph [ref=e158]: "Request failed: Request failed: Missing API key: No LLM provider configured. Set an API key (e.g. GROQ_API_KEY) and restart, configure a provider via the dashboard, or use Ollama for local models (no API key neede..."
+      - generic [ref=e160]:
+        - generic [ref=e161]: 用
+        - generic [ref=e164]: 请帮我写一个简单的函数
+      - generic [ref=e167]: Z
+    - generic [ref=e173]:
+      - generic [ref=e174]:
+        - button "添加附件" [ref=e175]:
+          - img [ref=e176]
+        - textbox "Agent 正在回复..." [disabled] [ref=e179]
+        - generic [ref=e180]:
+          - button "选择模型" [ref=e181]:
+            - generic [ref=e182]: glm-5
+            - img [ref=e183]
+          - button "发送消息" [disabled] [ref=e185]:
+            - img [ref=e186]
+      - generic [ref=e188]: Agent 在本地运行，内容由 AI 生成
+  - complementary [ref=e189]:
+    - generic [ref=e190]:
+      - generic [ref=e191]:
+        - generic [ref=e192]:
+          - img [ref=e193]
+          - generic [ref=e195]: "4"
+        - generic [ref=e196]: 当前消息
+      - tablist [ref=e197]:
+        - tab "Status" [selected] [ref=e198]:
+          - img [ref=e199]
+        - tab "Files" [ref=e201]:
+          - img [ref=e202]
+        - tab "Agent" [ref=e205]:
+          - img [ref=e206]
+        - tab "Memory" [ref=e209]:
+          - img [ref=e210]
+    - generic [ref=e218]:
+      - generic [ref=e219]:
+        - generic [ref=e220]:
+          - generic [ref=e221]:
+            - img [ref=e222]
+            - generic [ref=e226]: Gateway Connected
+          - button "Refresh data" [ref=e227]:
+            - img [ref=e228]
+        - generic [ref=e233]:
+          - generic [ref=e234]:
+            - generic [ref=e235]: 地址
+            - generic [ref=e236]: ws://127.0.0.1:50051/ws
+          - generic [ref=e237]:
+            - generic [ref=e238]: 当前模型
+            - generic [ref=e239]: glm-5
+      - generic [ref=e240]:
+        - heading "当前会话" [level=3] [ref=e241]:
+          - img [ref=e242]
+          - text: 当前会话
+        - generic [ref=e244]:
+          - generic [ref=e245]:
+            - generic [ref=e246]: 用户消息
+            - generic [ref=e247]: "2"
+          - generic [ref=e248]:
+            - generic [ref=e249]: 助手回复
+            - generic [ref=e250]: "2"
+          - generic [ref=e251]:
+            - generic [ref=e252]: 工具调用
+            - generic [ref=e253]: "0"
+          - generic [ref=e254]:
+            - generic [ref=e255]: 总消息数
+            - generic [ref=e256]: "4"
+      - generic [ref=e257]:
+        - heading "分身状态" [level=3] [ref=e258]:
+          - img [ref=e259]
+          - text: 分身状态
+        - generic [ref=e262]:
+          - generic [ref=e263]:
+            - img [ref=e265]
+            - generic [ref=e268]: trader-hand
+          - generic [ref=e269]:
+            - img [ref=e271]
+            - generic [ref=e274]: researcher
+          - generic [ref=e275]:
+            - img [ref=e277]
+            - generic [ref=e280]: browser-hand
+          - generic [ref=e281]:
+            - img [ref=e283]
+            - generic [ref=e286]: collector-hand
+          - generic [ref=e287]:
+            - img [ref=e289]
+            - generic [ref=e292]: researcher-hand
+          - paragraph [ref=e293]: +4 个分身
+      - generic [ref=e294]:
+        - heading "用量统计" [level=3] [ref=e295]:
+          - img [ref=e296]
+          - text: 用量统计
+        - generic [ref=e298]:
+          - generic [ref=e299]:
+            - generic [ref=e300]: 总会话数
+            - generic [ref=e301]: "0"
+          - generic [ref=e302]:
+            - generic [ref=e303]: 总消息数
+            - generic [ref=e304]: "0"
+          - generic [ref=e305]:
+            - generic [ref=e306]: 总 Token
+            - generic [ref=e307]: "0"
+      - generic [ref=e308]:
+        - heading "插件 (3)" [level=3] [ref=e309]:
+          - img [ref=e310]
+          - text: 插件 (3)
+        - generic [ref=e312]:
+          - generic [ref=e313]:
+            - generic [ref=e314]: Chat
+            - generic [ref=e315]: 运行中
+          - generic [ref=e316]:
+            - generic [ref=e317]: Code
+            - generic [ref=e318]: 运行中
+          - generic [ref=e319]:
+            - generic [ref=e320]: File
+            - generic [ref=e321]: 运行中
+      - generic [ref=e322]:
+        - heading "运行概览" [level=3] [ref=e323]:
+          - img [ref=e324]
+          - text: 运行概览
+        - generic [ref=e327]:
+          - generic [ref=e328]:
+            - generic [ref=e329]: 连接状态
+            - generic [ref=e330]: 已连接
+          - generic [ref=e331]:
+            - generic [ref=e332]: Gateway 版本
+            - generic [ref=e333]: "-"
+          - generic [ref=e334]:
+            - generic [ref=e335]: 已加载分身
+            - generic [ref=e336]: "9"
+          - generic [ref=e337]:
+            - generic [ref=e338]: 已加载插件
+            - generic [ref=e339]: "3"
+```

desktop/test-results/functional-scenarios-11-性能与稳定性-11-4-长时间运行稳定性-chromium/error-context.md

@@ -0,0 +1,243 @@
+# Page snapshot
+
+```yaml
+- generic [ref=e3]:
+  - complementary [ref=e4]:
+    - tablist [ref=e5]:
+      - tab "分身" [selected] [ref=e6]:
+        - img [ref=e7]
+        - generic [ref=e10]: 分身
+      - tab "Hands" [ref=e11]:
+        - img [ref=e12]
+        - generic [ref=e14]: Hands
+      - tab "工作流" [ref=e15]:
+        - img [ref=e16]
+        - generic [ref=e20]: 工作流
+      - tab "团队" [ref=e21]:
+        - img [ref=e22]
+        - generic [ref=e27]: 团队
+      - tab "协作" [ref=e28]:
+        - img [ref=e29]
+        - generic [ref=e33]: 协作
+    - generic [ref=e37]:
+      - generic [ref=e38] [cursor=pointer]:
+        - img [ref=e40]
+        - generic [ref=e43]:
+          - generic [ref=e44]:
+            - generic [ref=e45]: trader-hand
+            - generic [ref=e46]: 当前
+          - paragraph [ref=e47]: 新分身
+        - button "删除":
+          - img
+      - generic [ref=e48] [cursor=pointer]:
+        - img [ref=e50]
+        - generic [ref=e53]:
+          - generic [ref=e55]: researcher
+          - paragraph [ref=e56]: 新分身
+        - button "删除":
+          - img
+      - generic [ref=e57] [cursor=pointer]:
+        - img [ref=e59]
+        - generic [ref=e62]:
+          - generic [ref=e64]: browser-hand
+          - paragraph [ref=e65]: 新分身
+        - button "删除":
+          - img
+      - generic [ref=e66] [cursor=pointer]:
+        - img [ref=e68]
+        - generic [ref=e71]:
+          - generic [ref=e73]: collector-hand
+          - paragraph [ref=e74]: 新分身
+        - button "删除":
+          - img
+      - generic [ref=e75] [cursor=pointer]:
+        - img [ref=e77]
+        - generic [ref=e80]:
+          - generic [ref=e82]: researcher-hand
+          - paragraph [ref=e83]: 新分身
+        - button "删除":
+          - img
+      - generic [ref=e84] [cursor=pointer]:
+        - img [ref=e86]
+        - generic [ref=e89]:
+          - generic [ref=e91]: lead-hand
+          - paragraph [ref=e92]: 新分身
+        - button "删除":
+          - img
+      - generic [ref=e93] [cursor=pointer]:
+        - img [ref=e95]
+        - generic [ref=e98]:
+          - generic [ref=e100]: test-agent
+          - paragraph [ref=e101]: 新分身
+        - button "删除":
+          - img
+      - generic [ref=e102] [cursor=pointer]:
+        - img [ref=e104]
+        - generic [ref=e107]:
+          - generic [ref=e109]: predictor-hand
+          - paragraph [ref=e110]: 新分身
+        - button "删除":
+          - img
+      - generic [ref=e111] [cursor=pointer]:
+        - img [ref=e113]
+        - generic [ref=e116]:
+          - generic [ref=e118]: 测试助手
+          - paragraph [ref=e119]: 新分身
+        - button "删除":
+          - img
+      - generic [ref=e120] [cursor=pointer]:
+        - img [ref=e122]
+        - generic [ref=e125]: 创建新 Agent
+    - generic [ref=e127]:
+      - generic [ref=e128]: 用
+      - generic [ref=e129]: 用户
+      - button "打开设置" [ref=e130]:
+        - img [ref=e131]
+  - main [ref=e134]:
+    - generic [ref=e135]:
+      - generic [ref=e136]:
+        - heading "trader-hand" [level=2] [ref=e137]
+        - generic [ref=e138]: 正在输入中
+      - button "开始新对话" [ref=e141]:
+        - img [ref=e142]
+        - text: 新对话
+    - generic [ref=e145]:
+      - generic [ref=e147]:
+        - generic [ref=e148]: 用
+        - generic [ref=e151]: 测试消息 1
+      - generic [ref=e153]:
+        - generic [ref=e154]: Z
+        - generic [ref=e156]:
+          - generic [ref=e157]: "⚠️ Request failed: Request failed: Missing API key: No LLM provider configured. Set an API key (e.g. GROQ_API_KEY) and restart, configure a provider via the dashboard, or use Ollama for local models (no API key neede..."
+          - paragraph [ref=e158]: "Request failed: Request failed: Missing API key: No LLM provider configured. Set an API key (e.g. GROQ_API_KEY) and restart, configure a provider via the dashboard, or use Ollama for local models (no API key neede..."
+      - generic [ref=e160]:
+        - generic [ref=e161]: 用
+        - generic [ref=e164]: 测试消息 2
+      - generic [ref=e167]: Z
+    - generic [ref=e173]:
+      - generic [ref=e174]:
+        - button "添加附件" [ref=e175]:
+          - img [ref=e176]
+        - textbox "Agent 正在回复..." [disabled] [ref=e179]
+        - generic [ref=e180]:
+          - button "选择模型" [ref=e181]:
+            - generic [ref=e182]: glm-5
+            - img [ref=e183]
+          - button "发送消息" [disabled] [ref=e185]:
+            - img [ref=e186]
+      - generic [ref=e188]: Agent 在本地运行，内容由 AI 生成
+  - complementary [ref=e189]:
+    - generic [ref=e190]:
+      - generic [ref=e191]:
+        - generic [ref=e192]:
+          - img [ref=e193]
+          - generic [ref=e195]: "4"
+        - generic [ref=e196]: 当前消息
+      - tablist [ref=e197]:
+        - tab "Status" [selected] [ref=e198]:
+          - img [ref=e199]
+        - tab "Files" [ref=e201]:
+          - img [ref=e202]
+        - tab "Agent" [ref=e205]:
+          - img [ref=e206]
+        - tab "Memory" [ref=e209]:
+          - img [ref=e210]
+    - generic [ref=e218]:
+      - generic [ref=e219]:
+        - generic [ref=e220]:
+          - generic [ref=e221]:
+            - img [ref=e222]
+            - generic [ref=e226]: Gateway Connected
+          - button "Refresh data" [ref=e227]:
+            - img [ref=e228]
+        - generic [ref=e233]:
+          - generic [ref=e234]:
+            - generic [ref=e235]: 地址
+            - generic [ref=e236]: ws://127.0.0.1:50051/ws
+          - generic [ref=e237]:
+            - generic [ref=e238]: 当前模型
+            - generic [ref=e239]: glm-5
+      - generic [ref=e240]:
+        - heading "当前会话" [level=3] [ref=e241]:
+          - img [ref=e242]
+          - text: 当前会话
+        - generic [ref=e244]:
+          - generic [ref=e245]:
+            - generic [ref=e246]: 用户消息
+            - generic [ref=e247]: "2"
+          - generic [ref=e248]:
+            - generic [ref=e249]: 助手回复
+            - generic [ref=e250]: "2"
+          - generic [ref=e251]:
+            - generic [ref=e252]: 工具调用
+            - generic [ref=e253]: "0"
+          - generic [ref=e254]:
+            - generic [ref=e255]: 总消息数
+            - generic [ref=e256]: "4"
+      - generic [ref=e257]:
+        - heading "分身状态" [level=3] [ref=e258]:
+          - img [ref=e259]
+          - text: 分身状态
+        - generic [ref=e262]:
+          - generic [ref=e263]:
+            - img [ref=e265]
+            - generic [ref=e268]: trader-hand
+          - generic [ref=e269]:
+            - img [ref=e271]
+            - generic [ref=e274]: researcher
+          - generic [ref=e275]:
+            - img [ref=e277]
+            - generic [ref=e280]: browser-hand
+          - generic [ref=e281]:
+            - img [ref=e283]
+            - generic [ref=e286]: collector-hand
+          - generic [ref=e287]:
+            - img [ref=e289]
+            - generic [ref=e292]: researcher-hand
+          - paragraph [ref=e293]: +4 个分身
+      - generic [ref=e294]:
+        - heading "用量统计" [level=3] [ref=e295]:
+          - img [ref=e296]
+          - text: 用量统计
+        - generic [ref=e298]:
+          - generic [ref=e299]:
+            - generic [ref=e300]: 总会话数
+            - generic [ref=e301]: "0"
+          - generic [ref=e302]:
+            - generic [ref=e303]: 总消息数
+            - generic [ref=e304]: "0"
+          - generic [ref=e305]:
+            - generic [ref=e306]: 总 Token
+            - generic [ref=e307]: "0"
+      - generic [ref=e308]:
+        - heading "插件 (3)" [level=3] [ref=e309]:
+          - img [ref=e310]
+          - text: 插件 (3)
+        - generic [ref=e312]:
+          - generic [ref=e313]:
+            - generic [ref=e314]: Chat
+            - generic [ref=e315]: 运行中
+          - generic [ref=e316]:
+            - generic [ref=e317]: Code
+            - generic [ref=e318]: 运行中
+          - generic [ref=e319]:
+            - generic [ref=e320]: File
+            - generic [ref=e321]: 运行中
+      - generic [ref=e322]:
+        - heading "运行概览" [level=3] [ref=e323]:
+          - img [ref=e324]
+          - text: 运行概览
+        - generic [ref=e327]:
+          - generic [ref=e328]:
+            - generic [ref=e329]: 连接状态
+            - generic [ref=e330]: 已连接
+          - generic [ref=e331]:
+            - generic [ref=e332]: Gateway 版本
+            - generic [ref=e333]: "-"
+          - generic [ref=e334]:
+            - generic [ref=e335]: 已加载分身
+            - generic [ref=e336]: "9"
+          - generic [ref=e337]:
+            - generic [ref=e338]: 已加载插件
+            - generic [ref=e339]: "3"
+```

desktop/test-results/functional-scenarios-3-Agent-分身管理-3-1-分身列表显示-chromium/error-context.md

@@ -0,0 +1,246 @@
+# Page snapshot
+
+```yaml
+- generic [ref=e3]:
+  - complementary [ref=e4]:
+    - tablist [ref=e5]:
+      - tab "分身" [selected] [ref=e6]:
+        - img [ref=e7]
+        - generic [ref=e10]: 分身
+      - tab "Hands" [ref=e11]:
+        - img [ref=e12]
+        - generic [ref=e14]: Hands
+      - tab "工作流" [ref=e15]:
+        - img [ref=e16]
+        - generic [ref=e20]: 工作流
+      - tab "团队" [ref=e21]:
+        - img [ref=e22]
+        - generic [ref=e27]: 团队
+      - tab "协作" [ref=e28]:
+        - img [ref=e29]
+        - generic [ref=e33]: 协作
+    - generic [ref=e37]:
+      - generic [ref=e38] [cursor=pointer]:
+        - img [ref=e40]
+        - generic [ref=e43]:
+          - generic [ref=e44]:
+            - generic [ref=e45]: trader-hand
+            - generic [ref=e46]: 当前
+          - paragraph [ref=e47]: 新分身
+        - button "删除":
+          - img
+      - generic [ref=e48] [cursor=pointer]:
+        - img [ref=e50]
+        - generic [ref=e53]:
+          - generic [ref=e55]: researcher
+          - paragraph [ref=e56]: 新分身
+        - button "删除":
+          - img
+      - generic [ref=e57] [cursor=pointer]:
+        - img [ref=e59]
+        - generic [ref=e62]:
+          - generic [ref=e64]: browser-hand
+          - paragraph [ref=e65]: 新分身
+        - button "删除":
+          - img
+      - generic [ref=e66] [cursor=pointer]:
+        - img [ref=e68]
+        - generic [ref=e71]:
+          - generic [ref=e73]: collector-hand
+          - paragraph [ref=e74]: 新分身
+        - button "删除":
+          - img
+      - generic [ref=e75] [cursor=pointer]:
+        - img [ref=e77]
+        - generic [ref=e80]:
+          - generic [ref=e82]: researcher-hand
+          - paragraph [ref=e83]: 新分身
+        - button "删除":
+          - img
+      - generic [ref=e84] [cursor=pointer]:
+        - img [ref=e86]
+        - generic [ref=e89]:
+          - generic [ref=e91]: lead-hand
+          - paragraph [ref=e92]: 新分身
+        - button "删除":
+          - img
+      - generic [ref=e93] [cursor=pointer]:
+        - img [ref=e95]
+        - generic [ref=e98]:
+          - generic [ref=e100]: test-agent
+          - paragraph [ref=e101]: 新分身
+        - button "删除":
+          - img
+      - generic [ref=e102] [cursor=pointer]:
+        - img [ref=e104]
+        - generic [ref=e107]:
+          - generic [ref=e109]: predictor-hand
+          - paragraph [ref=e110]: 新分身
+        - button "删除":
+          - img
+      - generic [ref=e111] [cursor=pointer]:
+        - img [ref=e113]
+        - generic [ref=e116]:
+          - generic [ref=e118]: 测试助手
+          - paragraph [ref=e119]: 新分身
+        - button "删除":
+          - img
+      - generic [ref=e120] [cursor=pointer]:
+        - img [ref=e122]
+        - generic [ref=e125]: 创建新 Agent
+    - generic [ref=e127]:
+      - generic [ref=e128]: 用
+      - generic [ref=e129]: 用户
+      - button "打开设置" [ref=e130]:
+        - img [ref=e131]
+  - main [ref=e134]:
+    - generic [ref=e136]:
+      - heading "trader-hand" [level=2] [ref=e137]
+      - generic [ref=e138]: Gateway 已连接
+    - generic [ref=e142]:
+      - generic [ref=e145]: 🦞
+      - paragraph [ref=e147]: 你好！ 我是 trader-hand。有什么我可以帮你的吗？
+      - generic [ref=e148]:
+        - generic [ref=e149]:
+          - img [ref=e150]
+          - generic [ref=e152]: 快速开始
+        - button "💡 帮我写一个 Python 脚本处理 Excel 文件" [ref=e153]:
+          - generic [ref=e154]: 💡
+          - generic [ref=e155]: 帮我写一个 Python 脚本处理 Excel 文件
+          - img [ref=e156]
+        - button "📊 分析这个数据集的趋势和关键指标" [ref=e158]:
+          - generic [ref=e159]: 📊
+          - generic [ref=e160]: 分析这个数据集的趋势和关键指标
+          - img [ref=e161]
+        - button "✍️ 帮我起草一份产品需求文档" [ref=e163]:
+          - generic [ref=e164]: ✍️
+          - generic [ref=e165]: 帮我起草一份产品需求文档
+          - img [ref=e166]
+      - paragraph [ref=e168]: 发送消息开始对话，或点击上方建议
+    - generic [ref=e170]:
+      - generic [ref=e171]:
+        - button "添加附件" [ref=e172]:
+          - img [ref=e173]
+        - textbox "发送给 trader-hand" [ref=e176]
+        - generic [ref=e177]:
+          - button "选择模型" [ref=e178]:
+            - generic [ref=e179]: glm-5
+            - img [ref=e180]
+          - button "发送消息" [disabled] [ref=e182]:
+            - img [ref=e183]
+      - generic [ref=e185]: Agent 在本地运行，内容由 AI 生成
+  - complementary [ref=e186]:
+    - generic [ref=e187]:
+      - generic [ref=e188]:
+        - generic [ref=e189]:
+          - img [ref=e190]
+          - generic [ref=e192]: "0"
+        - generic [ref=e193]: 当前消息
+      - tablist [ref=e194]:
+        - tab "Status" [selected] [ref=e195]:
+          - img [ref=e196]
+        - tab "Files" [ref=e198]:
+          - img [ref=e199]
+        - tab "Agent" [ref=e202]:
+          - img [ref=e203]
+        - tab "Memory" [ref=e206]:
+          - img [ref=e207]
+    - generic [ref=e215]:
+      - generic [ref=e216]:
+        - generic [ref=e217]:
+          - generic [ref=e218]:
+            - img [ref=e219]
+            - generic [ref=e223]: Gateway Connected
+          - button "Refresh data" [ref=e224]:
+            - img [ref=e225]
+        - generic [ref=e230]:
+          - generic [ref=e231]:
+            - generic [ref=e232]: 地址
+            - generic [ref=e233]: ws://127.0.0.1:50051/ws
+          - generic [ref=e234]:
+            - generic [ref=e235]: 当前模型
+            - generic [ref=e236]: glm-5
+      - generic [ref=e237]:
+        - heading "当前会话" [level=3] [ref=e238]:
+          - img [ref=e239]
+          - text: 当前会话
+        - generic [ref=e241]:
+          - generic [ref=e242]:
+            - generic [ref=e243]: 用户消息
+            - generic [ref=e244]: "0"
+          - generic [ref=e245]:
+            - generic [ref=e246]: 助手回复
+            - generic [ref=e247]: "0"
+          - generic [ref=e248]:
+            - generic [ref=e249]: 工具调用
+            - generic [ref=e250]: "0"
+          - generic [ref=e251]:
+            - generic [ref=e252]: 总消息数
+            - generic [ref=e253]: "0"
+      - generic [ref=e254]:
+        - heading "分身状态" [level=3] [ref=e255]:
+          - img [ref=e256]
+          - text: 分身状态
+        - generic [ref=e259]:
+          - generic [ref=e260]:
+            - img [ref=e262]
+            - generic [ref=e265]: trader-hand
+          - generic [ref=e266]:
+            - img [ref=e268]
+            - generic [ref=e271]: researcher
+          - generic [ref=e272]:
+            - img [ref=e274]
+            - generic [ref=e277]: browser-hand
+          - generic [ref=e278]:
+            - img [ref=e280]
+            - generic [ref=e283]: collector-hand
+          - generic [ref=e284]:
+            - img [ref=e286]
+            - generic [ref=e289]: researcher-hand
+          - paragraph [ref=e290]: +4 个分身
+      - generic [ref=e291]:
+        - heading "用量统计" [level=3] [ref=e292]:
+          - img [ref=e293]
+          - text: 用量统计
+        - generic [ref=e295]:
+          - generic [ref=e296]:
+            - generic [ref=e297]: 总会话数
+            - generic [ref=e298]: "0"
+          - generic [ref=e299]:
+            - generic [ref=e300]: 总消息数
+            - generic [ref=e301]: "0"
+          - generic [ref=e302]:
+            - generic [ref=e303]: 总 Token
+            - generic [ref=e304]: "0"
+      - generic [ref=e305]:
+        - heading "插件 (3)" [level=3] [ref=e306]:
+          - img [ref=e307]
+          - text: 插件 (3)
+        - generic [ref=e309]:
+          - generic [ref=e310]:
+            - generic [ref=e311]: Chat
+            - generic [ref=e312]: 运行中
+          - generic [ref=e313]:
+            - generic [ref=e314]: Code
+            - generic [ref=e315]: 运行中
+          - generic [ref=e316]:
+            - generic [ref=e317]: File
+            - generic [ref=e318]: 运行中
+      - generic [ref=e319]:
+        - heading "运行概览" [level=3] [ref=e320]:
+          - img [ref=e321]
+          - text: 运行概览
+        - generic [ref=e324]:
+          - generic [ref=e325]:
+            - generic [ref=e326]: 连接状态
+            - generic [ref=e327]: 已连接
+          - generic [ref=e328]:
+            - generic [ref=e329]: Gateway 版本
+            - generic [ref=e330]: "-"
+          - generic [ref=e331]:
+            - generic [ref=e332]: 已加载分身
+            - generic [ref=e333]: "9"
+          - generic [ref=e334]:
+            - generic [ref=e335]: 已加载插件
+            - generic [ref=e336]: "3"
+```

desktop/test-results/functional-scenarios-4-Hands-系统-4-1-Hands-列表显示-chromium/error-context.md

@@ -0,0 +1,246 @@
+# Page snapshot
+
+```yaml
+- generic [ref=e3]:
+  - complementary [ref=e4]:
+    - tablist [ref=e5]:
+      - tab "分身" [selected] [ref=e6]:
+        - img [ref=e7]
+        - generic [ref=e10]: 分身
+      - tab "Hands" [ref=e11]:
+        - img [ref=e12]
+        - generic [ref=e14]: Hands
+      - tab "工作流" [ref=e15]:
+        - img [ref=e16]
+        - generic [ref=e20]: 工作流
+      - tab "团队" [ref=e21]:
+        - img [ref=e22]
+        - generic [ref=e27]: 团队
+      - tab "协作" [ref=e28]:
+        - img [ref=e29]
+        - generic [ref=e33]: 协作
+    - generic [ref=e37]:
+      - generic [ref=e38] [cursor=pointer]:
+        - img [ref=e40]
+        - generic [ref=e43]:
+          - generic [ref=e44]:
+            - generic [ref=e45]: trader-hand
+            - generic [ref=e46]: 当前
+          - paragraph [ref=e47]: 新分身
+        - button "删除":
+          - img
+      - generic [ref=e48] [cursor=pointer]:
+        - img [ref=e50]
+        - generic [ref=e53]:
+          - generic [ref=e55]: researcher
+          - paragraph [ref=e56]: 新分身
+        - button "删除":
+          - img
+      - generic [ref=e57] [cursor=pointer]:
+        - img [ref=e59]
+        - generic [ref=e62]:
+          - generic [ref=e64]: browser-hand
+          - paragraph [ref=e65]: 新分身
+        - button "删除":
+          - img
+      - generic [ref=e66] [cursor=pointer]:
+        - img [ref=e68]
+        - generic [ref=e71]:
+          - generic [ref=e73]: collector-hand
+          - paragraph [ref=e74]: 新分身
+        - button "删除":
+          - img
+      - generic [ref=e75] [cursor=pointer]:
+        - img [ref=e77]
+        - generic [ref=e80]:
+          - generic [ref=e82]: researcher-hand
+          - paragraph [ref=e83]: 新分身
+        - button "删除":
+          - img
+      - generic [ref=e84] [cursor=pointer]:
+        - img [ref=e86]
+        - generic [ref=e89]:
+          - generic [ref=e91]: lead-hand
+          - paragraph [ref=e92]: 新分身
+        - button "删除":
+          - img
+      - generic [ref=e93] [cursor=pointer]:
+        - img [ref=e95]
+        - generic [ref=e98]:
+          - generic [ref=e100]: test-agent
+          - paragraph [ref=e101]: 新分身
+        - button "删除":
+          - img
+      - generic [ref=e102] [cursor=pointer]:
+        - img [ref=e104]
+        - generic [ref=e107]:
+          - generic [ref=e109]: predictor-hand
+          - paragraph [ref=e110]: 新分身
+        - button "删除":
+          - img
+      - generic [ref=e111] [cursor=pointer]:
+        - img [ref=e113]
+        - generic [ref=e116]:
+          - generic [ref=e118]: 测试助手
+          - paragraph [ref=e119]: 新分身
+        - button "删除":
+          - img
+      - generic [ref=e120] [cursor=pointer]:
+        - img [ref=e122]
+        - generic [ref=e125]: 创建新 Agent
+    - generic [ref=e127]:
+      - generic [ref=e128]: 用
+      - generic [ref=e129]: 用户
+      - button "打开设置" [ref=e130]:
+        - img [ref=e131]
+  - main [ref=e134]:
+    - generic [ref=e136]:
+      - heading "trader-hand" [level=2] [ref=e137]
+      - generic [ref=e138]: Gateway 已连接
+    - generic [ref=e142]:
+      - generic [ref=e145]: 🦞
+      - paragraph [ref=e147]: 你好！ 我是 trader-hand。有什么我可以帮你的吗？
+      - generic [ref=e148]:
+        - generic [ref=e149]:
+          - img [ref=e150]
+          - generic [ref=e152]: 快速开始
+        - button "💡 帮我写一个 Python 脚本处理 Excel 文件" [ref=e153]:
+          - generic [ref=e154]: 💡
+          - generic [ref=e155]: 帮我写一个 Python 脚本处理 Excel 文件
+          - img [ref=e156]
+        - button "📊 分析这个数据集的趋势和关键指标" [ref=e158]:
+          - generic [ref=e159]: 📊
+          - generic [ref=e160]: 分析这个数据集的趋势和关键指标
+          - img [ref=e161]
+        - button "✍️ 帮我起草一份产品需求文档" [ref=e163]:
+          - generic [ref=e164]: ✍️
+          - generic [ref=e165]: 帮我起草一份产品需求文档
+          - img [ref=e166]
+      - paragraph [ref=e168]: 发送消息开始对话，或点击上方建议
+    - generic [ref=e170]:
+      - generic [ref=e171]:
+        - button "添加附件" [ref=e172]:
+          - img [ref=e173]
+        - textbox "发送给 trader-hand" [ref=e176]
+        - generic [ref=e177]:
+          - button "选择模型" [ref=e178]:
+            - generic [ref=e179]: glm-5
+            - img [ref=e180]
+          - button "发送消息" [disabled] [ref=e182]:
+            - img [ref=e183]
+      - generic [ref=e185]: Agent 在本地运行，内容由 AI 生成
+  - complementary [ref=e186]:
+    - generic [ref=e187]:
+      - generic [ref=e188]:
+        - generic [ref=e189]:
+          - img [ref=e190]
+          - generic [ref=e192]: "0"
+        - generic [ref=e193]: 当前消息
+      - tablist [ref=e194]:
+        - tab "Status" [selected] [ref=e195]:
+          - img [ref=e196]
+        - tab "Files" [ref=e198]:
+          - img [ref=e199]
+        - tab "Agent" [ref=e202]:
+          - img [ref=e203]
+        - tab "Memory" [ref=e206]:
+          - img [ref=e207]
+    - generic [ref=e215]:
+      - generic [ref=e216]:
+        - generic [ref=e217]:
+          - generic [ref=e218]:
+            - img [ref=e219]
+            - generic [ref=e223]: Gateway Connected
+          - button "Refresh data" [ref=e224]:
+            - img [ref=e225]
+        - generic [ref=e230]:
+          - generic [ref=e231]:
+            - generic [ref=e232]: 地址
+            - generic [ref=e233]: ws://127.0.0.1:50051/ws
+          - generic [ref=e234]:
+            - generic [ref=e235]: 当前模型
+            - generic [ref=e236]: glm-5
+      - generic [ref=e237]:
+        - heading "当前会话" [level=3] [ref=e238]:
+          - img [ref=e239]
+          - text: 当前会话
+        - generic [ref=e241]:
+          - generic [ref=e242]:
+            - generic [ref=e243]: 用户消息
+            - generic [ref=e244]: "0"
+          - generic [ref=e245]:
+            - generic [ref=e246]: 助手回复
+            - generic [ref=e247]: "0"
+          - generic [ref=e248]:
+            - generic [ref=e249]: 工具调用
+            - generic [ref=e250]: "0"
+          - generic [ref=e251]:
+            - generic [ref=e252]: 总消息数
+            - generic [ref=e253]: "0"
+      - generic [ref=e254]:
+        - heading "分身状态" [level=3] [ref=e255]:
+          - img [ref=e256]
+          - text: 分身状态
+        - generic [ref=e259]:
+          - generic [ref=e260]:
+            - img [ref=e262]
+            - generic [ref=e265]: trader-hand
+          - generic [ref=e266]:
+            - img [ref=e268]
+            - generic [ref=e271]: researcher
+          - generic [ref=e272]:
+            - img [ref=e274]
+            - generic [ref=e277]: browser-hand
+          - generic [ref=e278]:
+            - img [ref=e280]
+            - generic [ref=e283]: collector-hand
+          - generic [ref=e284]:
+            - img [ref=e286]
+            - generic [ref=e289]: researcher-hand
+          - paragraph [ref=e290]: +4 个分身
+      - generic [ref=e291]:
+        - heading "用量统计" [level=3] [ref=e292]:
+          - img [ref=e293]
+          - text: 用量统计
+        - generic [ref=e295]:
+          - generic [ref=e296]:
+            - generic [ref=e297]: 总会话数
+            - generic [ref=e298]: "0"
+          - generic [ref=e299]:
+            - generic [ref=e300]: 总消息数
+            - generic [ref=e301]: "0"
+          - generic [ref=e302]:
+            - generic [ref=e303]: 总 Token
+            - generic [ref=e304]: "0"
+      - generic [ref=e305]:
+        - heading "插件 (3)" [level=3] [ref=e306]:
+          - img [ref=e307]
+          - text: 插件 (3)
+        - generic [ref=e309]:
+          - generic [ref=e310]:
+            - generic [ref=e311]: Chat
+            - generic [ref=e312]: 运行中
+          - generic [ref=e313]:
+            - generic [ref=e314]: Code
+            - generic [ref=e315]: 运行中
+          - generic [ref=e316]:
+            - generic [ref=e317]: File
+            - generic [ref=e318]: 运行中
+      - generic [ref=e319]:
+        - heading "运行概览" [level=3] [ref=e320]:
+          - img [ref=e321]
+          - text: 运行概览
+        - generic [ref=e324]:
+          - generic [ref=e325]:
+            - generic [ref=e326]: 连接状态
+            - generic [ref=e327]: 已连接
+          - generic [ref=e328]:
+            - generic [ref=e329]: Gateway 版本
+            - generic [ref=e330]: "-"
+          - generic [ref=e331]:
+            - generic [ref=e332]: 已加载分身
+            - generic [ref=e333]: "9"
+          - generic [ref=e334]:
+            - generic [ref=e335]: 已加载插件
+            - generic [ref=e336]: "3"
+```

desktop/test-results/functional-scenarios-8-设置页面-8-3-模型配置-chromium/error-context.md

@@ -0,0 +1,89 @@
+# Page snapshot
+
+```yaml
+- generic [ref=e3]:
+  - complementary [ref=e4]:
+    - button "返回应用" [ref=e6]:
+      - img [ref=e7]
+      - generic [ref=e9]: 返回应用
+    - navigation [ref=e10]:
+      - button "通用" [ref=e11]:
+        - img [ref=e12]
+        - generic [ref=e15]: 通用
+      - button "用量统计" [ref=e16]:
+        - img [ref=e17]
+        - generic [ref=e19]: 用量统计
+      - button "积分详情" [ref=e20]:
+        - img [ref=e21]
+        - generic [ref=e26]: 积分详情
+      - button "模型与 API" [ref=e27]:
+        - img [ref=e28]
+        - generic [ref=e31]: 模型与 API
+      - button "MCP 服务" [ref=e32]:
+        - img [ref=e33]
+        - generic [ref=e35]: MCP 服务
+      - button "技能" [ref=e36]:
+        - img [ref=e37]
+        - generic [ref=e39]: 技能
+      - button "IM 频道" [ref=e40]:
+        - img [ref=e41]
+        - generic [ref=e43]: IM 频道
+      - button "工作区" [ref=e44]:
+        - img [ref=e45]
+        - generic [ref=e47]: 工作区
+      - button "数据与隐私" [ref=e48]:
+        - img [ref=e49]
+        - generic [ref=e51]: 数据与隐私
+      - button "安全状态" [ref=e52]:
+        - img [ref=e53]
+        - generic [ref=e55]: 安全状态
+      - button "审计日志" [ref=e56]:
+        - img [ref=e57]
+        - generic [ref=e60]: 审计日志
+      - button "定时任务" [ref=e61]:
+        - img [ref=e62]
+        - generic [ref=e65]: 定时任务
+      - button "提交反馈" [ref=e66]:
+        - img [ref=e67]
+        - generic [ref=e70]: 提交反馈
+      - button "关于" [ref=e71]:
+        - img [ref=e72]
+        - generic [ref=e74]: 关于
+  - main [ref=e75]:
+    - generic [ref=e76]:
+      - heading "通用设置" [level=1] [ref=e77]
+      - heading "Gateway 连接" [level=2] [ref=e78]
+      - generic [ref=e79]:
+        - generic [ref=e80]:
+          - generic [ref=e81]: 状态
+          - generic [ref=e84]: 已连接
+        - generic [ref=e85]:
+          - generic [ref=e86]: 地址
+          - generic [ref=e87]: ws://127.0.0.1:50051
+        - generic [ref=e88]:
+          - generic [ref=e89]: Token
+          - textbox "可选：Gateway auth token" [ref=e90]
+        - generic [ref=e91]:
+          - generic [ref=e92]: 当前模型
+          - generic [ref=e93]: glm-5
+        - button "断开连接" [ref=e95]
+      - heading "外观与行为" [level=2] [ref=e96]
+      - generic [ref=e97]:
+        - generic [ref=e98]:
+          - generic [ref=e99]:
+            - generic [ref=e100]: 主题模式
+            - generic [ref=e101]: 选择浅色或深色模式。
+          - generic [ref=e102]:
+            - button [ref=e103]
+            - button [ref=e104]
+        - generic [ref=e105]:
+          - generic [ref=e106]:
+            - generic [ref=e107]: 开机自启
+            - generic [ref=e108]: 登录时自动启动 ZCLAW。
+          - button [ref=e109]
+        - generic [ref=e111]:
+          - generic [ref=e112]:
+            - generic [ref=e113]: 显示工具调用
+            - generic [ref=e114]: 在对话消息中显示模型的工具调用详情块。
+          - button [ref=e115]
+```

desktop/tests/e2e/KNOWN_ISSUES.md

@@ -0,0 +1,209 @@
+# E2E 测试已知问题与修复指南
+
+> 最后更新: 2026-03-17
+> 测试通过率: 88% (65/74)
+
+## 当前状态
+
+### 测试结果摘要
+- **总测试**: 74
+- **通过**: 65
+- **失败**: 9
+
+### 快速运行测试命令
+```bash
+cd g:/ZClaw_openfang/desktop
+
+# 运行全部测试
+pnpm exec playwright test --config=tests/e2e/playwright.config.ts --reporter=list
+
+# 仅运行 app-verification (全部通过)
+pnpm exec playwright test --config=tests/e2e/playwright.config.ts tests/e2e/specs/app-verification.spec.ts --reporter=list
+
+# 仅运行 functional-scenarios
+pnpm exec playwright test --config=tests/e2e/playwright.config.ts tests/e2e/specs/functional-scenarios.spec.ts --reporter=list
+```
+
+---
+
+## 问题 1: 聊天输入禁用问题
+
+### 现象
+测试在尝试填写聊天输入框时失败，因为 Agent 正在回复中 (`isStreaming=true`)，导致输入框被禁用。
+
+### 错误信息
+```
+locator resolved to <textarea rows="1" disabled placeholder="Agent 正在回复..." ...>
+element is not enabled
+```
+
+### 影响的测试
+- `10. 完整用户流程 › 10.2 完整聊天流程`
+- `11. 性能与稳定性 › 11.4 长时间运行稳定性`
+
+### 修复方案
+
+#### 方案 A: 在测试中等待 streaming 完成
+```typescript
+// 在 functional-scenarios.spec.ts 中添加等待逻辑
+async function waitForChatReady(page: Page) {
+  const chatInput = page.locator('textarea').first();
+  // 等待输入框可用
+  await page.waitForFunction(() => {
+    const textarea = document.querySelector('textarea');
+    return textarea && !textarea.disabled;
+  }, { timeout: 30000 });
+}
+```
+
+#### 方案 B: 在组件中添加可中断的 streaming
+修改 `ChatArea.tsx` 允许用户在 streaming 时中断并输入新消息。
+
+### 相关文件
+- `desktop/src/components/ChatArea.tsx:178` - `disabled={isStreaming || !input.trim() || !connected}`
+- `desktop/tests/e2e/specs/functional-scenarios.spec.ts:1016` - 失败的测试行
+
+---
+
+## 问题 2: Hands 列表为空
+
+### 现象
+测试期望找到 Hands 卡片，但实际找到 0 个。API `/api/hands` 返回数据正常。
+
+### 错误信息
+```
+Found 0 hand cards
+```
+
+### 影响的测试
+- `3. Agent/分身管理 › 3.1 分身列表显示`
+- `4. Hands 系统 › 4.1 Hands 列表显示`
+
+### 根因分析
+1. Hands 数据从 API 加载是异步的
+2. 测试可能在数据加载完成前就检查 DOM
+3. HandList 组件可能没有正确渲染数据
+
+### 修复方案
+
+#### 方案 A: 在测试中增加等待时间
+```typescript
+// 在 functional-scenarios.spec.ts 中修改
+test('4.1 Hands 列表显示', async ({ page }) => {
+  await navigateToTab(page, 'Hands');
+  await page.waitForTimeout(2000); // 增加等待时间
+  await page.waitForSelector('button:has-text("Hand")', { timeout: 10000 });
+  // ... 继续测试
+});
+```
+
+#### 方案 B: 在 HandList 组件中添加加载状态
+确保组件在数据加载时显示 loading 状态，数据加载后正确渲染。
+
+### 验证 API 返回数据
+```bash
+curl -s http://127.0.0.1:50051/api/hands | head -c 500
+```
+
+### 相关文件
+- `desktop/src/components/HandList.tsx` - Hands 列表组件
+- `desktop/src/store/gatewayStore.ts:1175` - loadHands 函数
+- `desktop/tests/e2e/specs/functional-scenarios.spec.ts:406` - 失败的测试
+
+---
+
+## 问题 3: 模型配置测试失败
+
+### 现象
+测试在设置页面中找不到模型配置相关的 UI 元素。
+
+### 影响的测试
+- `8. 设置页面 › 8.3 模型配置`
+
+### 修复方案
+检查设置页面的模型配置部分是否存在，以及选择器是否正确。
+
+### 相关文件
+- `desktop/src/components/Settings/SettingsLayout.tsx`
+- `desktop/tests/e2e/specs/functional-scenarios.spec.ts:729`
+
+---
+
+## 问题 4: 应用启动测试断言失败
+
+### 现象
+测试期望所有导航标签都存在，但可能某些标签未渲染。
+
+### 影响的测试
+- `1. 应用启动与初始化 › 1.1 应用正常启动并渲染所有核心组件`
+
+### 修复方案
+调整测试断言，使其更灵活地处理异步加载的组件。
+
+---
+
+## API 端点状态
+
+### 正常工作的端点 (200)
+- `/api/status` - Gateway 状态
+- `/api/agents` - Agent 列表
+- `/api/hands` - Hands 列表
+- `/api/config` - 配置读取
+- `/api/chat` - 聊天 (WebSocket streaming)
+
+### 返回 404 的端点 (有 fallback 处理)
+- `/api/workspace`
+- `/api/stats/usage`
+- `/api/plugins/status`
+- `/api/scheduler/tasks`
+- `/api/security/status`
+
+这些 404 是预期行为，应用有 fallback 机制处理。
+
+---
+
+## 测试文件修改记录
+
+### 已修复的选择器问题
+1. **侧边栏导航** - 使用 `getByRole('tab', { name: '分身' })` 替代正则匹配
+2. **发送按钮** - 使用 `getByRole('button', { name: '发送消息' })` 替代模糊匹配
+3. **Strict mode 问题** - 修复多个 `.or()` 选择器导致的 strict mode violation
+
+### 测试配置文件
+- `desktop/tests/e2e/playwright.config.ts` - Playwright 配置
+- `desktop/tests/e2e/specs/app-verification.spec.ts` - 基础验证测试 (28/28 通过)
+- `desktop/tests/e2e/specs/functional-scenarios.spec.ts` - 功能场景测试 (37/46 通过)
+
+---
+
+## 截图位置
+```
+desktop/test-results/screenshots/
+desktop/test-results/functional-scenarios-*-chromium/
+```
+
+## 下一步行动建议
+
+1. **优先级 P0**: 修复聊天输入禁用问题 (影响多个测试)
+2. **优先级 P1**: 修复 Hands 列表渲染问题
+3. **优先级 P2**: 优化模型配置测试
+4. **优先级 P3**: 清理长时间运行稳定性测试
+
+---
+
+## 新会话启动提示
+
+在新会话中，可以使用以下提示快速开始：
+
+```
+我需要继续修复 ZCLAW 桌面应用的 E2E 测试问题。
+
+当前状态:
+- 测试通过率 88% (65/74)
+- 已知问题记录在 desktop/tests/e2e/KNOWN_ISSUES.md
+
+请帮我:
+1. 阅读 KNOWN_ISSUES.md 了解详细问题
+2. 从优先级 P0 (聊天输入禁用问题) 开始修复
+3. 修复后运行测试验证
+```

desktop/tests/e2e/debug.mjs

@@ -0,0 +1,263 @@
+/**
+ * ZCLAW 功能验证脚本 - Playwright CLI (改进版)
+ */
+
+import { chromium } from 'playwright';
+
+const BASE_URL = 'http://localhost:1420';
+const SCREENSHOT_DIR = 'test-results/screenshots';
+
+const results = { passed: [], failed: [], warnings: [], screenshots: [] };
+
+function log(msg) {
+  console.log(`[${new Date().toISOString().slice(11, 19)}] ${msg}`);
+}
+
+async function screenshot(page, name) {
+  try {
+    await page.screenshot({ path: `${SCREENSHOT_DIR}/${name}.png`, fullPage: true });
+    results.screenshots.push(name);
+    log(`📸 ${name}.png`);
+  } catch (e) {
+    log(`⚠️ 截图失败: ${name}`);
+  }
+}
+
+async function test(name, fn) {
+  try {
+    await fn();
+    results.passed.push(name);
+    log(`✅ ${name}`);
+  } catch (e) {
+    results.failed.push({ name, error: e.message });
+    log(`❌ ${name} - ${e.message}`);
+  }
+}
+
+async function main() {
+  log('🚀 ZCLAW 功能验证测试 (改进版)');
+  log(`📍 ${BASE_URL}`);
+
+  const browser = await chromium.launch({ headless: true });
+  const page = await browser.newPage({ viewport: { width: 1920, height: 1080 } });
+
+  const logs = [];
+  page.on('console', msg => logs.push(`[${msg.type()}] ${msg.text()}`));
+  page.on('pageerror', e => logs.push(`[error] ${e.message}`));
+
+  try {
+    // === 套件 1: 应用启动 ===
+    log('\n📋 应用启动与初始化');
+
+    await test('1.1 应用加载', async () => {
+      await page.goto(BASE_URL, { timeout: 10000 });
+      await page.waitForLoadState('domcontentloaded');
+      await page.waitForTimeout(2000);
+      await screenshot(page, '01-app');
+    });
+
+    await test('1.2 左侧边栏', async () => {
+      const sidebar = page.locator('aside').first();
+      if (!await sidebar.isVisible()) throw new Error('左侧边栏不可见');
+      await screenshot(page, '02-sidebar');
+    });
+
+    await test('1.3 主区域', async () => {
+      if (!await page.locator('main').isVisible()) throw new Error('主区域不可见');
+      await screenshot(page, '03-main');
+    });
+
+    await test('1.4 右侧边栏', async () => {
+      const rightPanel = page.locator('aside').last();
+      if (!await rightPanel.isVisible()) throw new Error('右侧边栏不可见');
+      await screenshot(page, '04-right-panel');
+    });
+
+    // === 套件 2: 标签导航 ===
+    log('\n📋 标签导航');
+
+    await test('2.1 分身标签', async () => {
+      const tab = page.locator('button[role="tab"]').filter({ hasText: '分身' });
+      if (await tab.count() > 0) {
+        await tab.first().click();
+        await page.waitForTimeout(500);
+        await screenshot(page, 'tab-clones');
+      } else {
+        throw new Error('分身标签不可见');
+      }
+    });
+
+    await test('2.2 Hands 标签', async () => {
+      const tab = page.locator('button[role="tab"]').filter({ hasText: 'Hands' });
+      if (await tab.count() > 0) {
+        await tab.first().click();
+        await page.waitForTimeout(500);
+        await screenshot(page, 'tab-hands');
+      } else {
+        throw new Error('Hands 标签不可见');
+      }
+    });
+
+    await test('2.3 工作流标签', async () => {
+      const tab = page.locator('button[role="tab"]').filter({ hasText: '工作流' });
+      if (await tab.count() > 0) {
+        await tab.first().click();
+        await page.waitForTimeout(500);
+        await screenshot(page, 'tab-workflow');
+      } else {
+        throw new Error('工作流标签不可见');
+      }
+    });
+
+    await test('2.4 团队标签', async () => {
+      const tab = page.locator('button[role="tab"]').filter({ hasText: '团队' });
+      if (await tab.count() > 0) {
+        await tab.first().click();
+        await page.waitForTimeout(500);
+        await screenshot(page, 'tab-team');
+      } else {
+        throw new Error('团队标签不可见');
+      }
+    });
+
+    await test('2.5 协作标签', async () => {
+      const tab = page.locator('button[role="tab"]').filter({ hasText: '协作' });
+      if (await tab.count() > 0) {
+        await tab.first().click();
+        await page.waitForTimeout(500);
+        await screenshot(page, 'tab-swarm');
+      } else {
+        throw new Error('协作标签不可见');
+      }
+    });
+
+    // === 套件 3: Gateway 状态 ===
+    log('\n📋 Gateway 连接状态');
+
+    await test('3.1 连接状态显示', async () => {
+      const content = await page.content();
+      if (content.includes('Gateway 未连接') || content.includes('Connecting')) {
+        results.warnings.push('Gateway 未连接 - 需启动后端');
+      }
+      await screenshot(page, '05-gateway');
+    });
+
+    // === 套件 4: 设置 ===
+    log('\n📋 设置页面');
+
+    await test('4.1 打开设置', async () => {
+      const btn = page.getByRole('button', { name: /设置|Settings/i });
+      if (await btn.count() > 0) {
+        await btn.first().click();
+        await page.waitForTimeout(500);
+        await screenshot(page, '06-settings');
+      } else {
+        throw new Error('设置按钮不可见');
+      }
+    });
+
+    // === 套件 5: 聊天 ===
+    log('\n📋 聊天功能');
+
+    await test('5.1 聊天输入框', async () => {
+      await page.goto(BASE_URL, { timeout: 10000 });
+      await page.waitForTimeout(1000);
+      const input = page.locator('textarea');
+      if (await input.count() > 0) {
+        if (await input.first().isDisabled()) {
+          results.warnings.push('输入框已禁用 - 需 Gateway 连接');
+        }
+      } else {
+        throw new Error('聊天输入框不可见');
+      }
+      await screenshot(page, '07-chat');
+    });
+
+    await test('5.2 模型选择器', async () => {
+      const selector = page.locator('button').filter({ hasText: /模型|model/i });
+      if (await selector.count() > 0) {
+        await selector.first().click();
+        await page.waitForTimeout(300);
+        await screenshot(page, '08-model-selector');
+      }
+    });
+
+    // === 套件 6: 控制台错误 ===
+    log('\n📋 控制台错误');
+
+    await test('6.1 JS 错误检查', async () => {
+      const errors = logs.filter(l => l.includes('[error]'));
+      const criticalErrors = errors.filter(e =>
+        !e.includes('DevTools') &&
+        !e.includes('extension')
+      );
+      if (criticalErrors.length > 0) {
+        results.warnings.push(`发现 ${criticalErrors.length} 个 JS 错误`);
+        criticalErrors.slice(0, 5).forEach(e => log(`  ${e.slice(0, 100)}...`));
+      }
+    });
+
+    // === 套件 7: 响应式 ===
+    log('\n📋 响应式布局');
+
+    await test('7.1 移动端', async () => {
+      await page.setViewportSize({ width: 375, height: 667 });
+      await page.waitForTimeout(500);
+      await screenshot(page, '09-mobile');
+    });
+
+    await test('7.2 平板', async () => {
+      await page.setViewportSize({ width: 768, height: 1024 });
+      await page.waitForTimeout(500);
+      await screenshot(page, '10-tablet');
+    });
+
+    await test('7.3 桌面', async () => {
+      await page.setViewportSize({ width: 1920, height: 1080 });
+      await page.waitForTimeout(500);
+      await screenshot(page, '11-desktop');
+    });
+
+    // === 套件 8: 性能 ===
+    log('\n📋 性能');
+
+    await test('8.1 加载时间', async () => {
+      const start = Date.now();
+      await page.goto(BASE_URL, { timeout: 10000 });
+      const time = Date.now() - start;
+      log(`加载时间: ${time}ms`);
+      if (time > 5000) results.warnings.push(`加载时间较长: ${time}ms`);
+    });
+
+    await test('8.2 DOM 数量', async () => {
+      const count = await page.evaluate(() => document.querySelectorAll('*').length);
+      log(`DOM 节点: ${count}`);
+      if (count > 3000) results.warnings.push(`DOM 过多: ${count}`);
+    });
+
+  } catch (e) {
+    log(`❌ 执行出错: ${e.message}`);
+  } finally {
+    await browser.close();
+  }
+
+  // 报告
+  console.log('\n' + '='.repeat(60));
+  console.log('📊 ZCLAW 功能验证报告');
+  console.log('='.repeat(60));
+  console.log(`\n✅ 通过: ${results.passed.length}`);
+  results.passed.forEach(n => console.log(`   - ${n}`));
+  console.log(`\n❌ 失败: ${results.failed.length}`);
+  results.failed.forEach(f => console.log(`   - ${f.name}: ${f.error}`));
+  console.log(`\n⚠️ 警告: ${results.warnings.length}`);
+  results.warnings.forEach(w => console.log(`   - ${w}`));
+  console.log(`\n📸 截图: ${results.screenshots.length} 张`);
+
+  const total = results.passed.length + results.failed.length;
+  const rate = total > 0 ? ((results.passed.length / total) * 100).toFixed(1) : 0;
+  console.log(`\n总计: ${total} | 通过: ${results.passed.length} | 失败: ${results.failed.length} | 通过率: ${rate}%`);
+
+  process.exit(results.failed.length > 0 ? 1 : 0);
+}
+
+main().catch(console.error);

desktop/tests/e2e/playwright.config.ts

@@ -0,0 +1,27 @@
+import { defineConfig, devices } from '@playwright/test';
+
+export default defineConfig({
+  testDir: './specs',
+  fullyParallel: true,
+  forbidOnly: !!process.env.CI,
+  retries: process.env.CI ? 2 : 0,
+  workers: process.env.CI ? 1 : undefined,
+  reporter: 'html',
+  use: {
+    baseURL: 'http://localhost:1420',
+    trace: 'on-first-retry',
+    screenshot: 'only-on-failure',
+    video: 'retain-on-failure',
+  },
+  projects: [
+    {
+      name: 'chromium',
+      use: { ...devices['Desktop Chrome'] },
+    },
+  ],
+  webServer: {
+    command: 'pnpm dev',
+    url: 'http://localhost:1420',
+    reuseExistingServer: true,
+  },
+});

desktop/tests/e2e/quick-test.mjs

@@ -0,0 +1,211 @@
+/**
+ * ZCLAW 快速功能验证 - Playwright CLI
+ */
+
+import { chromium } from 'playwright';
+
+const BASE_URL = 'http://localhost:1420';
+const SCREENSHOT_DIR = 'test-results/screenshots';
+
+const results = { passed: [], failed: [], warnings: [], info: [] };
+
+function log(msg) {
+  console.log(`[${new Date().toISOString().slice(11, 19)}] ${msg}`);
+}
+
+async function screenshot(page, name) {
+  try {
+    await page.screenshot({ path: `${SCREENSHOT_DIR}/${name}.png`, fullPage: true });
+    log(`📸 ${name}.png`);
+  } catch (e) {}
+}
+
+async function test(name, fn) {
+  try {
+    await fn();
+    results.passed.push(name);
+    log(`✅ ${name}`);
+  } catch (e) {
+    results.failed.push({ name, error: e.message.slice(0, 100) });
+    log(`❌ ${name}`);
+  }
+}
+
+async function main() {
+  log('🚀 ZCLAW 快速功能验证');
+  log(`📍 ${BASE_URL}`);
+
+  const browser = await chromium.launch({ headless: true });
+  const page = await browser.newPage({ viewport: { width: 1920, height: 1080 } });
+
+  const logs = [];
+  page.on('console', msg => logs.push(`[${msg.type()}] ${msg.text()}`));
+  page.on('pageerror', e => logs.push(`[error] ${e.message}`));
+
+  try {
+    // === 应用加载 ===
+    log('\n📋 应用加载');
+    await page.goto(BASE_URL, { timeout: 10000 });
+    await page.waitForTimeout(2000);
+    await screenshot(page, '01-app');
+
+    // === 页面结构检查 ===
+    log('\n📋 页面结构');
+
+    await test('主区域', async () => {
+      const main = page.locator('main');
+      if (!await main.isVisible()) throw new Error('主区域不可见');
+    });
+
+    await test('左侧边栏', async () => {
+      const sidebar = page.locator('aside').first();
+      if (!await sidebar.isVisible()) throw new Error('左侧边栏不可见');
+    });
+
+    await test('右侧边栏', async () => {
+      const rightPanel = page.locator('aside').last();
+      if (!await rightPanel.isVisible()) throw new Error('右侧边栏不可见');
+    });
+
+    // === 标签检查 ===
+    log('\n📋 标签导航');
+
+    const tabNames = ['分身', 'Hands', '工作流', '团队', '协作'];
+    for (const name of tabNames) {
+      await test(`标签: ${name}`, async () => {
+        const tab = page.getByRole('button', { name: new RegExp(name, 'i') });
+        if (await tab.count() === 0) throw new Error('标签不存在');
+      });
+    }
+
+    await screenshot(page, '02-tabs');
+
+    // === 标签切换测试 (只测前3个) ===
+    log('\n📋 标签切换');
+
+    for (const name of ['分身', 'Hands', '工作流']) {
+      await test(`切换: ${name}`, async () => {
+        const tab = page.getByRole('button', { name: new RegExp(name, 'i') }).first();
+        await tab.click({ timeout: 3000 });
+        await page.waitForTimeout(300);
+      });
+    }
+
+    await screenshot(page, '03-tab-switch');
+
+    // === 设置页面 ===
+    log('\n📋 设置');
+
+    await test('设置按钮', async () => {
+      const btn = page.getByRole('button', { name: /设置|Settings/i });
+      if (await btn.count() === 0) throw new Error('设置按钮不存在');
+    });
+
+    await test('打开设置', async () => {
+      const btn = page.getByRole('button', { name: /设置|Settings/i }).first();
+      await btn.click({ timeout: 3000 });
+      await page.waitForTimeout(500);
+      await screenshot(page, '04-settings');
+    });
+
+    // === 聊天功能 ===
+    log('\n📋 聊天');
+
+    await page.goto(BASE_URL, { timeout: 5000 });
+    await page.waitForTimeout(1000);
+
+    await test('聊天输入框', async () => {
+      const input = page.locator('textarea');
+      if (await input.count() === 0) throw new Error('输入框不存在');
+      if (await input.first().isDisabled()) {
+        results.warnings.push('输入框已禁用 - 需 Gateway 连接');
+      }
+    });
+
+    await test('发送按钮', async () => {
+      const btn = page.getByRole('button', { name: /发送|Send/i });
+      if (await btn.count() === 0) throw new Error('发送按钮不存在');
+    });
+
+    await test('模型选择器', async () => {
+      const selector = page.getByRole('button', { name: /模型|Model/i });
+      if (await selector.count() === 0) throw new Error('模型选择器不存在');
+    });
+
+    await screenshot(page, '05-chat');
+
+    // === Gateway 状态 ===
+    log('\n📋 Gateway 状态');
+
+    await test('连接状态显示', async () => {
+      const content = await page.content();
+      if (content.includes('Connecting') || content.includes('未连接')) {
+        results.info.push('Gateway 状态: 未连接/连接中');
+      } else if (content.includes('已连接')) {
+        results.info.push('Gateway 状态: 已连接');
+      }
+    });
+
+    // === 控制台错误 ===
+    log('\n📋 控制台检查');
+
+    const jsErrors = logs.filter(l => l.includes('[error]') && !l.includes('DevTools'));
+    if (jsErrors.length > 0) {
+      results.warnings.push(`JS 错误: ${jsErrors.length} 个`);
+    }
+
+    // === 响应式 ===
+    log('\n📋 响应式');
+
+    await test('移动端', async () => {
+      await page.setViewportSize({ width: 375, height: 667 });
+      await page.waitForTimeout(300);
+    });
+
+    await test('桌面', async () => {
+      await page.setViewportSize({ width: 1920, height: 1080 });
+      await page.waitForTimeout(300);
+    });
+
+    await screenshot(page, '06-responsive');
+
+    // === 性能 ===
+    log('\n📋 性能');
+
+    await test('DOM 数量', async () => {
+      const count = await page.evaluate(() => document.querySelectorAll('*').length);
+      results.info.push(`DOM 节点: ${count}`);
+      if (count > 3000) results.warnings.push(`DOM 过多: ${count}`);
+    });
+
+  } catch (e) {
+    log(`❌ 执行出错: ${e.message}`);
+  } finally {
+    await browser.close();
+  }
+
+  // 报告
+  console.log('\n' + '='.repeat(60));
+  console.log('📊 ZCLAW 功能验证报告');
+  console.log('='.repeat(60));
+
+  console.log(`\n✅ 通过: ${results.passed.length}`);
+  results.passed.forEach(n => console.log(`   - ${n}`));
+
+  console.log(`\n❌ 失败: ${results.failed.length}`);
+  results.failed.forEach(f => console.log(`   - ${f.name}: ${f.error}`));
+
+  console.log(`\n⚠️ 警告: ${results.warnings.length}`);
+  results.warnings.forEach(w => console.log(`   - ${w}`));
+
+  console.log(`\nℹ️ 信息: ${results.info.length}`);
+  results.info.forEach(i => console.log(`   - ${i}`));
+
+  const total = results.passed.length + results.failed.length;
+  const rate = total > 0 ? ((results.passed.length / total) * 100).toFixed(1) : 0;
+  console.log(`\n📈 通过率: ${rate}% (${results.passed.length}/${total})`);
+
+  process.exit(results.failed.length > 0 ? 1 : 0);
+}
+
+main().catch(console.error);

desktop/tests/e2e/specs/app-verification.spec.ts

@@ -0,0 +1,487 @@
+/**
+ * ZCLAW 前端功能验证测试
+ *
+ * 验证所有核心功能的完整性和可用性
+ */
+
+import { test, expect, Page } from '@playwright/test';
+
+// 测试超时配置
+test.setTimeout(60000);
+
+// 辅助函数：等待组件加载
+async function waitForAppReady(page: Page) {
+  await page.waitForLoadState('networkidle');
+  // 等待主应用容器出现
+  await page.waitForSelector('.h-screen', { timeout: 10000 });
+}
+
+// 辅助函数：截图并保存
+async function takeScreenshot(page: Page, name: string) {
+  await page.screenshot({
+    path: `test-results/screenshots/${name}.png`,
+    fullPage: true
+  });
+}
+
+test.describe('ZCLAW 前端功能验证', () => {
+  test.beforeEach(async ({ page }) => {
+    await page.goto('/');
+    await waitForAppReady(page);
+  });
+
+  test.describe('1. 应用基础渲染', () => {
+    test('应用容器正确渲染', async ({ page }) => {
+      // 检查主容器存在
+      const appContainer = page.locator('.h-screen');
+      await expect(appContainer).toBeVisible();
+
+      // 检查三栏布局 - sidebar 和 main 都应该存在
+      const sidebar = page.locator('aside');
+      const mainContent = page.locator('main');
+
+      // 验证 sidebar 和 main 都存在
+      await expect(sidebar.first()).toBeVisible();
+      await expect(mainContent).toBeVisible();
+
+      await takeScreenshot(page, '01-app-layout');
+    });
+
+    test('页面标题正确', async ({ page }) => {
+      await expect(page).toHaveTitle(/ZCLAW/);
+    });
+  });
+
+  test.describe('2. Sidebar 侧边栏导航', () => {
+    test('侧边栏可见并包含导航项', async ({ page }) => {
+      // 验证侧边栏存在
+      const sidebar = page.locator('aside').first();
+      await expect(sidebar).toBeVisible();
+
+      // 检查导航按钮存在 - 使用 role="tab" 匹配
+      const cloneBtn = page.getByRole('tab', { name: '分身' });
+      const handsBtn = page.getByRole('tab', { name: 'Hands' });
+      const workflowBtn = page.getByRole('tab', { name: '工作流' });
+      const teamBtn = page.getByRole('tab', { name: '团队' });
+      const swarmBtn = page.getByRole('tab', { name: '协作' });
+
+      // 验证所有导航标签都存在
+      await expect(cloneBtn).toBeVisible();
+      await expect(handsBtn).toBeVisible();
+      await expect(workflowBtn).toBeVisible();
+      await expect(teamBtn).toBeVisible();
+      await expect(swarmBtn).toBeVisible();
+
+      await takeScreenshot(page, '02-sidebar-navigation');
+    });
+
+    test('导航切换功能', async ({ page }) => {
+      // 尝试点击不同的导航项
+      const navButtons = page.locator('button').filter({
+        has: page.locator('svg')
+      });
+
+      const count = await navButtons.count();
+      if (count > 1) {
+        await navButtons.nth(1).click();
+        await page.waitForTimeout(500);
+
+        // 验证视图切换
+        await takeScreenshot(page, '03-navigation-switch');
+      }
+    });
+
+    test('设置按钮可用', async ({ page }) => {
+      const settingsBtn = page.getByRole('button', { name: /settings|设置|⚙/i }).or(
+        page.locator('button').filter({ hasText: /设置|Settings/ })
+      );
+
+      if (await settingsBtn.isVisible()) {
+        await settingsBtn.click();
+        await page.waitForTimeout(300);
+        await takeScreenshot(page, '04-settings-access');
+      }
+    });
+  });
+
+  test.describe('3. ChatArea 聊天功能', () => {
+    test('聊天区域渲染', async ({ page }) => {
+      // 查找聊天输入框
+      const chatInput = page.locator('textarea').or(
+        page.locator('input[type="text"]')
+      ).or(
+        page.locator('[contenteditable="true"]')
+      );
+
+      // 检查消息区域
+      const messageArea = page.locator('[class*="flex-1"]').filter({
+        has: page.locator('[class*="message"], [class*="chat"]')
+      });
+
+      await takeScreenshot(page, '05-chat-area');
+
+      // 记录聊天组件状态
+      const inputExists = await chatInput.count() > 0;
+      console.log(`Chat input found: ${inputExists}`);
+    });
+
+    test('消息发送功能', async ({ page }) => {
+      const chatInput = page.locator('textarea').first();
+
+      if (await chatInput.isVisible()) {
+        await chatInput.fill('测试消息');
+
+        const sendBtn = page.getByRole('button', { name: '发送消息' });
+
+        if (await sendBtn.isVisible()) {
+          await sendBtn.click();
+          await page.waitForTimeout(500);
+        } else {
+          // 可能支持回车发送
+          await chatInput.press('Enter');
+        }
+
+        await takeScreenshot(page, '06-message-send');
+      }
+    });
+
+    test('会话列表渲染', async ({ page }) => {
+      const conversationList = page.locator('[class*="conversation"]').or(
+        page.locator('[class*="session"]')
+      ).or(
+        page.locator('ul, ol').filter({ has: page.locator('li') })
+      );
+
+      await takeScreenshot(page, '07-conversation-list');
+    });
+  });
+
+  test.describe('4. Hands 系统UI', () => {
+    test.beforeEach(async ({ page }) => {
+      // 导航到 Hands 视图
+      const handsBtn = page.getByRole('button', { name: 'Hands' });
+
+      if (await handsBtn.isVisible()) {
+        await handsBtn.click();
+        await page.waitForTimeout(1000); // 等待数据加载
+      }
+    });
+
+    test('Hands 列表渲染', async ({ page }) => {
+      const handsList = page.locator('[class*="hand"]').or(
+        page.locator('[class*="capability"]')
+      );
+
+      await takeScreenshot(page, '08-hands-list');
+
+      // 检查是否有 Hand 卡片
+      const handCards = page.locator('[class*="card"]').filter({
+        hasText: /Clip|Lead|Collector|Predictor|Researcher|Twitter|Browser/i
+      });
+
+      const cardCount = await handCards.count();
+      console.log(`Found ${cardCount} hand cards`);
+    });
+
+    test('Hand 触发按钮', async ({ page }) => {
+      const triggerBtn = page.getByRole('button', { name: /trigger|触发|执行|run/i });
+
+      if (await triggerBtn.first().isVisible()) {
+        await takeScreenshot(page, '09-hand-trigger');
+      }
+    });
+  });
+
+  test.describe('5. Workflow/Scheduler 面板', () => {
+    test.beforeEach(async ({ page }) => {
+      const workflowBtn = page.getByRole('button', { name: '工作流' });
+
+      if (await workflowBtn.isVisible()) {
+        await workflowBtn.click();
+        await page.waitForTimeout(500);
+      }
+    });
+
+    test('Scheduler 面板渲染', async ({ page }) => {
+      const schedulerPanel = page.locator('[class*="scheduler"]').or(
+        page.locator('[class*="workflow"]')
+      );
+
+      await takeScreenshot(page, '10-scheduler-panel');
+
+      // 检查定时任务列表
+      const taskList = page.locator('table, ul, [class*="list"]');
+      const hasTaskList = await taskList.count() > 0;
+      console.log(`Task list found: ${hasTaskList}`);
+    });
+
+    test('工作流编辑器', async ({ page }) => {
+      const workflowEditor = page.locator('[class*="editor"]').or(
+        page.locator('[class*="workflow-editor"]')
+      );
+
+      if (await workflowEditor.isVisible()) {
+        await takeScreenshot(page, '11-workflow-editor');
+      }
+    });
+  });
+
+  test.describe('6. Team 协作视图', () => {
+    test.beforeEach(async ({ page }) => {
+      const teamBtn = page.getByRole('button', { name: '团队' });
+
+      if (await teamBtn.isVisible()) {
+        await teamBtn.click();
+        await page.waitForTimeout(500);
+      }
+    });
+
+    test('Team 列表和创建', async ({ page }) => {
+      const teamList = page.locator('[class*="team"]').or(
+        page.locator('[class*="group"]')
+      );
+
+      const createBtn = page.getByRole('button', { name: /create|创建|new|新建|\+/i });
+
+      await takeScreenshot(page, '12-team-view');
+
+      if (await createBtn.first().isVisible()) {
+        console.log('Team create button available');
+      }
+    });
+
+    test('团队成员显示', async ({ page }) => {
+      const members = page.locator('[class*="member"]').or(
+        page.locator('[class*="agent"]')
+      );
+
+      const memberCount = await members.count();
+      console.log(`Found ${memberCount} team members`);
+    });
+  });
+
+  test.describe('7. Swarm Dashboard', () => {
+    test.beforeEach(async ({ page }) => {
+      const swarmBtn = page.getByRole('button', { name: '协作' });
+
+      if (await swarmBtn.isVisible()) {
+        await swarmBtn.click();
+        await page.waitForTimeout(500);
+      }
+    });
+
+    test('Swarm 仪表板渲染', async ({ page }) => {
+      const dashboard = page.locator('[class*="swarm"]').or(
+        page.locator('[class*="dashboard"]')
+      );
+
+      await takeScreenshot(page, '13-swarm-dashboard');
+
+      // 检查状态指示器
+      const statusIndicators = page.locator('[class*="status"]');
+      const statusCount = await statusIndicators.count();
+      console.log(`Found ${statusCount} status indicators`);
+    });
+  });
+
+  test.describe('8. Settings 设置页面', () => {
+    test.beforeEach(async ({ page }) => {
+      const settingsBtn = page.getByRole('button', { name: /settings|设置|⚙/i });
+
+      if (await settingsBtn.isVisible()) {
+        await settingsBtn.click();
+        await page.waitForTimeout(500);
+      }
+    });
+
+    test('设置页面渲染', async ({ page }) => {
+      const settingsLayout = page.locator('[class*="settings"]').or(
+        page.locator('form')
+      );
+
+      await takeScreenshot(page, '14-settings-page');
+
+      // 检查设置分类
+      const settingsTabs = page.locator('[role="tab"]').or(
+        page.locator('button').filter({ hasText: /General|通用|Security|安全|Model|模型/i })
+      );
+
+      const tabCount = await settingsTabs.count();
+      console.log(`Found ${tabCount} settings tabs`);
+    });
+
+    test('通用设置', async ({ page }) => {
+      const generalSettings = page.locator('[class*="general"]').or(
+        page.getByText(/general|通用设置/i)
+      );
+
+      if (await generalSettings.isVisible()) {
+        await takeScreenshot(page, '15-general-settings');
+      }
+    });
+
+    test('模型配置', async ({ page }) => {
+      // 检查设置页面是否有模型相关内容
+      const modelSection = page.getByRole('button', { name: /模型|Model/i }).or(
+        page.locator('text=/模型|Model/i')
+      );
+
+      // 这个测试是可选的，因为模型配置可能在不同的标签页
+      const isVisible = await modelSection.first().isVisible().catch(() => false);
+      if (isVisible) {
+        await takeScreenshot(page, '16-model-settings');
+      } else {
+        // 如果没有找到模型配置，跳过测试
+        console.log('Model settings section not found - may be in a different tab');
+      }
+    });
+  });
+
+  test.describe('9. RightPanel 右侧面板', () => {
+    test('右侧面板渲染', async ({ page }) => {
+      // 查找右侧面板
+      const rightPanel = page.locator('[class*="w-"][class*="border-l"]').or(
+        page.locator('aside').last()
+      );
+
+      if (await rightPanel.isVisible()) {
+        await takeScreenshot(page, '17-right-panel');
+
+        // 检查面板内容
+        const panelContent = rightPanel.locator('[class*="info"], [class*="detail"], [class*="context"]');
+        console.log(`Right panel content found: ${await panelContent.count() > 0}`);
+      }
+    });
+  });
+
+  test.describe('10. 错误处理和边界情况', () => {
+    test('网络错误处理', async ({ page }) => {
+      // 模拟离线
+      await page.context().setOffline(true);
+      await page.waitForTimeout(1000);
+
+      // 检查错误提示
+      const errorMessage = page.locator('[class*="error"]').or(
+        page.locator('[role="alert"]')
+      );
+
+      await takeScreenshot(page, '18-offline-error');
+
+      // 恢复网络
+      await page.context().setOffline(false);
+    });
+
+    test('空状态显示', async ({ page }) => {
+      // 检查空状态组件
+      const emptyState = page.locator('[class*="empty"]').or(
+        page.locator('[class*="no-data"]')
+      );
+
+      if (await emptyState.isVisible()) {
+        await takeScreenshot(page, '19-empty-state');
+      }
+    });
+  });
+
+  test.describe('11. 响应式布局', () => {
+    test('移动端布局', async ({ page }) => {
+      await page.setViewportSize({ width: 375, height: 667 });
+      await page.waitForTimeout(500);
+
+      await takeScreenshot(page, '20-mobile-layout');
+
+      // 检查移动端导航
+      const mobileMenu = page.locator('[class*="mobile"]').or(
+        page.locator('button[aria-label*="menu"]')
+      );
+
+      console.log(`Mobile menu found: ${await mobileMenu.count() > 0}`);
+    });
+
+    test('平板布局', async ({ page }) => {
+      await page.setViewportSize({ width: 768, height: 1024 });
+      await page.waitForTimeout(500);
+
+      await takeScreenshot(page, '21-tablet-layout');
+    });
+
+    test('桌面布局', async ({ page }) => {
+      await page.setViewportSize({ width: 1920, height: 1080 });
+      await page.waitForTimeout(500);
+
+      await takeScreenshot(page, '22-desktop-layout');
+    });
+  });
+
+  test.describe('12. 性能检查', () => {
+    test('页面加载性能', async ({ page }) => {
+      const startTime = Date.now();
+      await page.goto('/');
+      await waitForAppReady(page);
+      const loadTime = Date.now() - startTime;
+
+      console.log(`Page load time: ${loadTime}ms`);
+
+      // 页面加载时间应该小于 5 秒
+      expect(loadTime).toBeLessThan(5000);
+    });
+
+    test('内存使用检查', async ({ page }) => {
+      // 获取页面指标
+      const metrics = await page.evaluate(() => {
+        return {
+          memory: (performance as any).memory?.usedJSHeapSize || 0,
+          domNodes: document.querySelectorAll('*').length,
+        };
+      });
+
+      console.log(`DOM nodes: ${metrics.domNodes}`);
+      console.log(`Memory used: ${Math.round(metrics.memory / 1024 / 1024)}MB`);
+    });
+  });
+});
+
+test.describe('13. 控制台错误检查', () => {
+  test('无 JavaScript 错误', async ({ page }) => {
+    const errors: string[] = [];
+
+    page.on('pageerror', error => {
+      errors.push(error.message);
+    });
+
+    await page.goto('/');
+    await waitForAppReady(page);
+
+    // 执行一些交互
+    await page.click('body');
+    await page.waitForTimeout(1000);
+
+    // 检查是否有严重错误
+    const criticalErrors = errors.filter(e =>
+      !e.includes('Warning:') &&
+      !e.includes('DevTools') &&
+      !e.includes('extension')
+    );
+
+    console.log(`Console errors: ${criticalErrors.length}`);
+    criticalErrors.forEach(e => console.log(`  - ${e}`));
+
+    // 允许少量非严重错误
+    expect(criticalErrors.length).toBeLessThan(5);
+  });
+
+  test('无网络请求失败', async ({ page }) => {
+    const failedRequests: string[] = [];
+
+    page.on('requestfailed', request => {
+      failedRequests.push(request.url());
+    });
+
+    await page.goto('/');
+    await waitForAppReady(page);
+    await page.waitForTimeout(2000);
+
+    console.log(`Failed requests: ${failedRequests.length}`);
+    failedRequests.forEach(r => console.log(`  - ${r}`));
+  });
+});

desktop/vite.config.ts

@@ -29,7 +29,8 @@ export default defineConfig(async () => ({
       ignored: ["**/src-tauri/**"],
     },
     proxy: {
-      // Proxy /api requests to OpenFang (port 50051) or OpenClaw (port 18789)
+      // Proxy /api requests to OpenFang Kernel (port 50051)
+      // OpenFang is managed by Tauri app - started via gateway_start command
       '/api': {
         target: 'http://127.0.0.1:50051',
         changeOrigin: true,

start-all.ps1

@@ -1,9 +1,12 @@
 # ZCLAW Full Stack Start Script
-# Starts: ChromeDriver (optional) -> OpenFang Gateway (optional) -> Tauri Desktop
+# Starts: ChromeDriver (optional) -> Tauri Desktop (manages OpenFang internally)
+#
+# NOTE: OpenFang is bundled with Tauri and managed internally.
+# The frontend uses Tauri commands (gateway_start/gateway_status) to control OpenFang.
+# No external OpenFang CLI installation is required.
 
 param(
     [switch]$NoBrowser,
-    [switch]$NoGateway,
     [switch]$Dev,
     [switch]$Help,
     [switch]$Stop,
@@ -28,16 +31,21 @@ ZCLAW Full Stack Start Script
 Usage: .\start-all.ps1 [options]
 
 Options:
-    -DesktopOnly    Start desktop only (skip all external services)
-    -NoBrowser      Skip ChromeDriver
-    -NoGateway      Skip OpenFang Gateway
+    -DesktopOnly    Start desktop only (skip ChromeDriver)
+    -NoBrowser      Skip ChromeDriver startup
     -Dev            Development mode (hot reload)
     -Stop           Stop all services
     -Help           Show this help
 
+Note:
+    OpenFang is bundled with the Tauri app and managed internally.
+    The app will start OpenFang automatically via Tauri commands.
+    No external OpenFang CLI installation required.
+
 Quick Commands:
     pnpm start           # Start all services
-    pnpm desktop         # Start desktop only
+    pnpm start:dev       # Start in dev mode
+    pnpm start:desktop   # Start desktop only (no browser)
 
 "@
     exit 0
@@ -51,10 +59,14 @@ if ($Stop) {
     Get-Process -Name "chromedriver" -ErrorAction SilentlyContinue | Stop-Process -Force
     ok "ChromeDriver stopped"
 
-    # Stop OpenFang (if running via openfang CLI)
-    if (Get-Command openfang -ErrorAction SilentlyContinue) {
-        openfang gateway stop 2>$null
-        ok "OpenFang Gateway stopped"
+    # Stop any process on port 4200 (OpenFang)
+    $port4200 = netstat -ano | Select-String ":4200.*LISTENING"
+    if ($port4200) {
+        $pid4200 = ($port4200 -split '\s+')[-1]
+        if ($pid4200 -match '^\d+$') {
+            Stop-Process -Id $pid4200 -Force -ErrorAction SilentlyContinue
+            ok "Stopped process on port 4200 (PID: $pid4200)"
+        }
     }
 
     # Stop Tauri/ZClaw
@@ -62,7 +74,7 @@ if ($Stop) {
     Get-Process -Name "desktop" -ErrorAction SilentlyContinue | Stop-Process -Force
     ok "ZCLAW Desktop stopped"
 
-    # Kill any process on port 1420
+    # Kill any process on port 1420 (Vite dev server)
     $port1420 = netstat -ano | Select-String ":1420.*LISTENING"
     if ($port1420) {
         $pid1420 = ($port1420 -split '\s+')[-1]
@@ -98,13 +110,12 @@ function Cleanup {
 trap { Cleanup; break }
 Register-EngineEvent -SourceIdentifier PowerShell.Exiting -Action { Cleanup } | Out-Null
 
-# Skip external services if DesktopOnly
+# Skip ChromeDriver if DesktopOnly
 if ($DesktopOnly) {
     $NoBrowser = $true
-    $NoGateway = $true
 }
 
-# 1. ChromeDriver (optional)
+# 1. ChromeDriver (optional - for Browser Hand automation)
 if (-not $NoBrowser) {
     info "Checking ChromeDriver..."
 
@@ -137,55 +148,21 @@ if (-not $NoBrowser) {
 
 Write-Host ""
 
-# 2. OpenFang Gateway (optional)
-if (-not $NoGateway) {
-    info "Checking OpenFang Gateway..."
-
-    $gatewayUp = $false
-    try {
-        $r = Invoke-WebRequest -Uri "http://127.0.0.1:4200/health" -TimeoutSec 2 -ErrorAction SilentlyContinue
-        if ($r.StatusCode -eq 200) { $gatewayUp = $true }
-    } catch {}
-
-    if ($gatewayUp) {
-        ok "OpenFang Gateway running on port 4200"
+# 2. Check OpenFang Runtime
+info "Checking OpenFang runtime..."
+$runtimePath = "$ScriptDir/desktop/src-tauri/resources/openfang-runtime"
+if (Test-Path "$runtimePath/openfang.exe") {
+    ok "OpenFang runtime found (bundled)"
+} elseif (Test-Path "$runtimePath/openfang") {
+    ok "OpenFang runtime found (bundled)"
 } else {
-        if (Get-Command openfang -ErrorAction SilentlyContinue) {
-            info "Starting OpenFang Gateway..."
-            $proc = Start-Process -FilePath "openfang" -ArgumentList "gateway", "start" -PassThru
-            $Jobs += $proc
-
-            info "Waiting for gateway..."
-            $wait = 0
-            while ($wait -lt 30) {
-                try {
-                    $r = Invoke-WebRequest -Uri "http://127.0.0.1:4200/health" -TimeoutSec 1 -ErrorAction SilentlyContinue
-                    if ($r.StatusCode -eq 200) {
-                        ok "OpenFang Gateway started"
-                        break
-                    }
-                } catch {}
-                Start-Sleep -Seconds 1
-                $wait++
-                Write-Host -NoNewline "."
-            }
-            Write-Host ""
-
-            if ($wait -ge 30) {
-                warn "Gateway did not respond within 30s"
-            }
-        } else {
-            warn "OpenFang CLI not found. Gateway not started."
-            info "The app will run in standalone mode."
-        }
-    }
-} else {
-    info "Skipping OpenFang Gateway"
+    warn "OpenFang runtime not found at $runtimePath"
+    info "Run: cd desktop && pnpm prepare:openfang-runtime"
 }
 
 Write-Host ""
 
-# 3. Tauri Desktop
+# 3. Start Tauri Desktop
 info "Starting ZCLAW Desktop..."
 Set-Location "$ScriptDir/desktop"
 
@@ -202,6 +179,7 @@ if ($port1420) {
 
 if ($Dev) {
     info "Development mode enabled"
+    info "OpenFang will be started by the app via Tauri commands"
     pnpm tauri dev
 } else {
     $exe = "src-tauri\target\release\ZClaw.exe"

start.sh

@@ -1,7 +1,13 @@
 #!/bin/bash
 
 # ZCLAW Unified Start Script for macOS/Linux
-# Usage: ./start.sh [--no-browser] [--no-gateway] [--dev] [--help]
+# Starts: ChromeDriver (optional) -> Tauri Desktop (manages OpenFang internally)
+#
+# NOTE: OpenFang is bundled with Tauri and managed internally.
+# The frontend uses Tauri commands (gateway_start/gateway_status) to control OpenFang.
+# No external OpenFang CLI installation is required.
+#
+# Usage: ./start.sh [--no-browser] [--dev] [--help]
 
 set -e
 
@@ -15,7 +21,6 @@ NC='\033[0m' # No Color
 
 # Parse arguments
 NO_BROWSER=false
-NO_GATEWAY=false
 DEV_MODE=false
 
 while [[ $# -gt 0 ]]; do
@@ -24,10 +29,6 @@ while [[ $# -gt 0 ]]; do
             NO_BROWSER=true
             shift
             ;;
-        --no-gateway|-ng)
-            NO_GATEWAY=true
-            shift
-            ;;
         --dev|-d)
             DEV_MODE=true
             shift
@@ -39,10 +40,13 @@ while [[ $# -gt 0 ]]; do
             echo ""
             echo "Options:"
             echo "  --no-browser, -nb    Skip starting ChromeDriver"
-            echo "  --no-gateway, -ng    Skip starting OpenFang gateway"
             echo "  --dev, -d            Start in development mode"
             echo "  --help, -h           Show this help message"
             echo ""
+            echo "Note:"
+            echo "  OpenFang is bundled with the Tauri app and managed internally."
+            echo "  No external OpenFang CLI installation required."
+            echo ""
             echo "Examples:"
             echo "  ./start.sh                  # Start all services"
             echo "  ./start.sh --no-browser     # Start without ChromeDriver"
@@ -73,7 +77,7 @@ trap cleanup EXIT INT TERM
 
 echo ""
 echo -e "${MAGENTA}═══════════════════════════════════════════${NC}"
-echo -e "${MAGENTA}   🦞 ZCLAW - OpenFang Desktop Client${NC}"
+echo -e "${MAGENTA}   ZCLAW - OpenFang Desktop Client${NC}"
 echo -e "${MAGENTA}═══════════════════════════════════════════${NC}"
 echo ""
 
@@ -110,49 +114,16 @@ fi
 
 echo ""
 
-# 2. Check OpenFang Gateway
-if [ "$NO_GATEWAY" = false ]; then
-    echo -e "${CYAN}[INFO]${NC} Checking OpenFang Gateway..."
+# 2. Check OpenFang Runtime
+echo -e "${CYAN}[INFO]${NC} Checking OpenFang runtime..."
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+RUNTIME_PATH="$SCRIPT_DIR/desktop/src-tauri/resources/openfang-runtime"
 
-    GATEWAY_RUNNING=false
-
-    # Check if gateway is already running
-    if curl -s --connect-timeout 2 http://127.0.0.1:4200/health > /dev/null 2>&1; then
-        GATEWAY_RUNNING=true
-        echo -e "${GREEN}[OK]${NC} OpenFang Gateway already running on port 4200"
-    fi
-
-    if [ "$GATEWAY_RUNNING" = false ]; then
-        if command -v openfang &> /dev/null; then
-            echo -e "${CYAN}[INFO]${NC} Starting OpenFang Gateway..."
-            openfang gateway start &
-            PIDS+=($!)
-
-            echo -e "${CYAN}[INFO]${NC} Waiting for gateway to be ready..."
-            MAX_WAIT=30
-            WAITED=0
-
-            while [ $WAITED -lt $MAX_WAIT ]; do
-                if curl -s --connect-timeout 1 http://127.0.0.1:4200/health > /dev/null 2>&1; then
-                    echo -e "${GREEN}[OK]${NC} OpenFang Gateway started on port 4200"
-                    break
-                fi
-                sleep 1
-                WAITED=$((WAITED + 1))
-                printf "."
-            done
-            echo ""
-
-            if [ $WAITED -ge $MAX_WAIT ]; then
-                echo -e "${YELLOW}[WARN]${NC} Gateway did not respond within ${MAX_WAIT}s"
-            fi
+if [ -f "$RUNTIME_PATH/openfang" ] || [ -f "$RUNTIME_PATH/openfang-x86_64-unknown-linux-gnu" ] || [ -f "$RUNTIME_PATH/openfang-aarch64-apple-darwin" ]; then
+    echo -e "${GREEN}[OK]${NC} OpenFang runtime found (bundled)"
 else
-            echo -e "${YELLOW}[WARN]${NC} OpenFang CLI not found. Gateway not started."
-            echo -e "${CYAN}[INFO]${NC} Install OpenFang: https://github.com/openfang/openfang"
-        fi
-    fi
-else
-    echo -e "${CYAN}[INFO]${NC} Skipping OpenFang Gateway (--no-gateway)"
+    echo -e "${YELLOW}[WARN]${NC} OpenFang runtime not found at $RUNTIME_PATH"
+    echo -e "${CYAN}[INFO]${NC} Run: cd desktop && pnpm prepare:openfang-runtime"
 fi
 
 echo ""
@@ -163,6 +134,7 @@ cd desktop
 
 if [ "$DEV_MODE" = true ]; then
     echo -e "${CYAN}[INFO]${NC} Starting in development mode..."
+    echo -e "${CYAN}[INFO]${NC} OpenFang will be started by the app via Tauri commands"
     pnpm tauri dev
 else
     # Check if built version exists