v10.3 Phase1-3: 项目隔离(去全部项目)+平台全称显示+Tooltip分区+平台前置检查+设备连接检测+多平台API

Author: zcj220

Untitled

@@ -0,0 +1,92 @@
+我对你需求的理解（请你确认）
+A. 项目选择层
+不要“全部项目”这个选项。
+项目必须是独立边界，不应跨项目批跑。
+下拉只显示“单个项目列表”，用户一次只选一个项目。
+项目显示名用：项目全名 + 平台全称（不简写）。
+B. 项目命名显示规则
+你希望类似：
+甲项目（Web）
+乙项目（Windows桌面）
+丙项目（Android）
+丁项目（iOS）
+戊项目（微信小程序）
+即：不使用 W / 小图标简写，直接中文全称，清晰第一。
+C. 全局蓝本与局部蓝本
+“全局蓝本”仅作用于当前项目，表示“测试本项目下全部蓝本”。
+勾选全局后，局部蓝本禁用是可以的，但提示文案要更智能：
+鼠标在复选框区域：显示“已启用全局，如需局部请选择先取消全局”
+鼠标在蓝本内容描述区域：仍显示该蓝本的功能说明（不是一刀切覆盖）
+D. 设备连接提示（重点）
+当项目平台需要设备时，系统应主动引导：
+选中 Android/iOS 项目：提示先连接手机（并展示连接状态）
+未连接时禁止开始测试，给明确原因
+已连接时显示“设备已连接，可开始测试”
+小程序项目要提示“微信开发者工具/automator状态”
+你问的“现在命名规则是什么？”（当前现状）
+你现在看到的行为是：
+下拉里有一个默认项：全部项目（N个蓝本）
+各项目项目前面带平台图标（🌐 �� 等），后面是蓝本数量
+项目名优先取蓝本里的 app_name，没有就取目录名
+平台显示是“图标+名称”，不是你要的“全称平台文字”
+所以你感觉“不直观、会混项目”，这个判断完全正确。
+我给你的最中肯建议（产品/工程都稳）
+方案原则（建议你定为产品规范）
+项目隔离优先：永不跨项目批跑（去掉“全部项目”）
+平台透明优先：显示全称平台，不用缩写
+运行前置检查优先：先检查环境，再允许点击“开始测试”
+提示分层优先：操作提示与内容提示分离，不互相覆盖
+平台显示标准（建议定稿）
+统一平台标签（全称）：
+Web
+Windows桌面
+Android
+iOS
+微信小程序
+项目显示格式建议：
+{项目名}（{平台全称}）
+示例：FreshMart 生鲜超市（微信小程序）
+“开始测试”前的专业引导流（强烈建议）
+1) Web / Windows桌面
+检查引擎连接 + 蓝本可用即可。
+未通过：按钮置灰 + 原因提示。
+2) Android / iOS
+增加“设备状态行”：
+未检测 / 未连接 / 已连接（设备名）
+未连接：
+“开始测试”置灰
+给动作提示：“请先连接设备并点击‘检测设备’”
+已连接：
+显示绿色状态
+允许开始
+3) 微信小程序
+增加两项状态：
+微信开发者工具
+automator端口（如 9420）
+任一未就绪：禁止开始并提示一键启动建议
+都就绪：允许开始
+你提的 Tooltip 交互，我建议这样落地（非常合理）
+你说得对，应该“按鼠标停留区域显示不同信息”：
+悬停在局部蓝本复选框/前导区域：
+提示“当前已启用全局蓝本，如需局部选择请先取消全局蓝本”
+悬停在蓝本标题/描述内容区域：
+始终显示该蓝本的描述、场景数、步骤数、路径
+这叫“操作提示”和“内容说明”分离，用户体验会明显更好。
+实施计划
+Phase 1（信息架构）
+删除“全部项目”选项
+下拉只保留项目列表
+项目文案改为“项目名（平台全称）”
+Phase 2（蓝本交互）
+全局蓝本仅当前项目内生效
+全局勾选时，局部禁用
+Tooltip分区：复选框区显示操作提示；内容区显示蓝本详情
+Phase 3（平台前置检查）
+新增“运行前检查器”（按平台）
+Android/iOS：设备连接检测 + 阻断逻辑
+小程序：开发者工具 + automator检测 + 阻断逻辑
+状态通过后才允许“开始测试”
+Phase 4（文案与可视化）
+状态文案标准化（未连接/已连接/待处理）
+错误提示可执行化（告诉用户下一步做什么）
+记录最近一次失败原因（便于重试）

extension/src/engineClient.ts

@@ -123,14 +123,41 @@ export class EngineClient {
     return this._get<unknown[]>(`/api/v1/memory/history${qs ? "?" + qs : ""}`);
   }
 
-  /** 蓝本模式测试（v2.3） */
+  /** Web 蓝本模式测试 */
   async startBlueprintTest(params: {
     blueprint_path: string;
     base_url?: string;
   }): Promise<TestReportResponse> {
     return this._post<TestReportResponse>("/api/v1/test/blueprint", params);
   }
 
+  /** 手机蓝本测试（Android/iOS） */
+  async startMobileBlueprintTest(params: {
+    blueprint_path: string;
+    base_url?: string;
+    mobile_session_id: string;
+  }): Promise<TestReportResponse> {
+    return this._post<TestReportResponse>("/api/v1/test/mobile-blueprint", params);
+  }
+
+  /** 小程序蓝本测试 */
+  async startMiniprogramBlueprintTest(params: {
+    blueprint_path: string;
+    base_url?: string;
+    project_path?: string;
+  }): Promise<TestReportResponse> {
+    return this._post<TestReportResponse>("/api/v1/test/miniprogram-blueprint", params);
+  }
+
+  /** 桌面蓝本测试 */
+  async startDesktopBlueprintTest(params: {
+    blueprint_path: string;
+    base_url?: string;
+    window_title?: string;
+  }): Promise<TestReportResponse> {
+    return this._post<TestReportResponse>("/api/v1/test/desktop-blueprint", params);
+  }
+
   /** 蓝本自动生成（v10.1） */
   async generateBlueprint(params: {
     url: string;
@@ -159,6 +186,32 @@ export class EngineClient {
     return this._get<TestStatus>("/api/v1/test/status");
   }
 
+  /** 列出已连接移动设备 */
+  async listMobileDevices(): Promise<{ devices: Array<Record<string, unknown>>; count: number; error?: string }> {
+    return this._get<{ devices: Array<Record<string, unknown>>; count: number; error?: string }>("/api/v1/mobile/devices");
+  }
+
+  /** 列出活动移动会话 */
+  async listMobileSessions(): Promise<{ sessions: Array<Record<string, unknown>>; count: number }> {
+    return this._get<{ sessions: Array<Record<string, unknown>>; count: number }>("/api/v1/mobile/sessions");
+  }
+
+  /** 创建移动会话 */
+  async createMobileSession(params: {
+    device_name?: string;
+    app_package?: string;
+    app_activity?: string;
+    app_path?: string;
+    permissions?: string[];
+  } = {}): Promise<{ session_id: string; message: string; device?: Record<string, unknown> }> {
+    return this._post<{ session_id: string; message: string; device?: Record<string, unknown> }>("/api/v1/mobile/session/create", params);
+  }
+
+  /** 检查小程序开发者工具状态 */
+  async getMiniprogramDevtoolsStatus(): Promise<{ found: boolean; path?: string; message?: string }> {
+    return this._get<{ found: boolean; path?: string; message?: string }>("/api/v1/miniprogram/devtools/status");
+  }
+
   /** 测试控制：暂停/继续/停止（v2.0） */
   async controlTest(action: string): Promise<{ action: string; success: boolean; state: string }> {
     return this._post<{ action: string; success: boolean; state: string }>(