用途:在真实原生 Hive Desktop 窗口中驱动并审计界面。每个开发构建都编译进 Wails 自带的 MCP 服务器,它在应用内运行并针对真实 WKWebView 执行操作,是到达原生应用页面的唯一途径。
主要能力:DOM 查询与 JavaScript 求值、合成鼠标与键盘输入(带屏幕动画光标)、窗口控制、事件 emit/wait,以及窗口截图。工具包括 app_info、windows_list、dom_query、dom_html、screenshot_dom、js_eval、mouse_click、mouse_move、mouse_drag、mouse_scroll、keyboard_type、keyboard_press、window_control、wait_for_event 等共十六个。
使用方式:prepare 会在工作树根目录写入 launch.env(含 WAILS_MCP_PORT)与 .mcp.json(注册 hive-desktop-ui 服务器)。可用 jq -r '.mcpServers["hive-desktop-ui"].url' .mcp.json 读取 URL,或通过 claude mcp add --transport http hive-desktop-ui <url> 注册。应用需由用户以 mise run desktop:dev 启动,勿在后台启动。每个工作树有独立端口,不会误连已安装的 Hive.app。
适用场景:前端改动宜用无头回路(mise run desktop:serve,门禁 mise run desktop:e2e);真实原生窗口、WebView、shell 集成与用户点击流程用本技能。状态断言交给 desktop-api,事件让 GitHub 说话用 desktop-devserver。
限制:不得调用 call_bound_method,也不得在 js_eval 中 import('/wails/runtime.js'),否则前端 Events.On 监听器会静默失效。抛出的错误会丢失消息,应返回自己的值。原生对话框会阻塞所有求值;托盘、Dock、通知横幅不可达。隐藏窗口会停泊 UI(无帧、过渡卡住、计时器被节流),需先按 pid 提升窗口。输入为合成 DOM 事件,isTrusted 为 false。visible 表示未被遮挡,focused 表示是关键窗口。截图需屏幕录制权限。具体收费与价格暂未提供。