SuperAPI AI 工具集

helmor-debug-operate

测试与质量

查看项目

更新于 10-15 21:11

技能介绍

用途:该技能用于操作和调试正在运行的 Helmor 桌面开发构建,通过 Tauri MCP 桥接以尽量少的探索完成验证。它是 helmor-cli 的可视化/运行时对应物:webview UI、截图、CSS、无障碍与 IPC 追踪优先用 Tauri MCP;终端优先的数据检查或工作区编排优先用 helmor-cli。

主要能力:连接并检查 Tauri MCP 桥接状态,获取 webview 截图与 DOM 快照(无障碍或结构),按坐标或选择器交互,执行只读 JS 检查,监控 IPC,并通过点击触发的低层 IPC 辅助器调用 Helmor 应用命令(如 list_workspace_groups、reveal_workspace_in_main_window、debug_list_terminal_buffers)。

必要用法:需使用 debug Tauri 构建,release 构建无桥接;默认端口 9223、windowId 为 main。连接检查用 driver_session { "action": "status", "port": 9223 },未连接时用 start。每次 UI 任务先做截图与快照:webview_screenshot 与 webview_dom_snapshot。ref=eN 句柄每次快照后失效,需重新快照。若选择器工具报 resolveAll/resolveRef 缺失,可安装兼容 shim。ipc_execute_command 当前无法调用普通 Helmor Tauri 命令,需用点击触发的 IPC 辅助器。

适用场景:Helmor 桌面开发构建的 UI 端到端验证、工作区切换/归档/恢复、会话列表与选择、终端缓冲区读取等调试任务。

限制:所有操作视为真实用户输入,不得在未获用户要求时发送提示、关闭会话、归档/删除工作区、停止流或修改设置。不要切换到 Chrome DevTools、Playwright 等其它表面。不要用 webview_execute_js 派发合成用户事件。若启动 ipc_monitor,结束前必须停止。截图或临时日志应保存在 .agent-contexts/<task-slug>/ 下。该技能是操作提示而非权威事实来源,UI 可能领先于配方;同一配方失败三次应停止机械重复,重新截图/快照并从可见 UI 推理。发现更优路径时应记录候选更新并征得用户同意后再修改技能。部分细节(如完整命令清单、更多配方)资料未完整提供。