SuperAPI AI 工具集

reactor-devtools

前端与建站

查看项目

更新于 10-16 00:31

技能介绍

用途:Reactor Devtools 让开发者像用户一样观察并操作运行中的 Reactor 调试版应用,用于诊断可见缺陷、布局、颜色对比度与状态驱动问题。官方建议优先使用 mur devtools CLI,因为每个动作都可与 shell 管道和 jq 组合,且每次调用都是完整审计记录,无需配置 MCP 客户端。

主要能力:CLI 通过 JSON-RPC 与应用的本地回环 HTTP 端点通信。常用动词包括 screenshot(截图,可裁剪)、tree(导出可视化树,full 模式含布局/自动化字段)、click/invoke/toggle/select/type/focus/scroll/expand/collapse(UIA 交互)、wait(轮询谓词)、state(导出各 Hook 值)、logs(读取 Debug/Trace/Console 输出,支持 --follow)、properties/set-property(读写依赖属性)、resources/set-resource(浏览与覆盖 XAML 资源)、styles、ancestors、fire(反射调用命名方法)、components/switch/reload/shutdown、windows 系列窗口操作,以及 call 通用透传。references 工具可返回响应式引用图,用于确认无障碍关系与 XYFocus 环。

使用方式:应用需在 Debug 构建中启用 Reactor.DevtoolsSupport。先确保 mur 在 PATH 中,然后可用 dotnet run --project path/to/App.csproj -- --devtools run 启动,或用 mur devtools <project> --mcp-port 54931 作为监督进程。用 mur devtools session list 确认会话,随后直接执行各动词;选择器支持节点 id、AutomationId、AutomationName、TypePath 和 Reactor 源码五种形式。

限制:仅限回环、仅限 DEBUG 构建,绝不可发布;认证使用每次启动写入锁文件的 bearer token,不要为工具调用传 --endpoint,否则会返回 401。switch/reload 会使节点 id 失效。退出码 0 成功、1 用法错误、2 传输错误、3 已有会话、4 无活动会话、5 JSON-RPC 错误。部分细节(如源码选择器)标注为预留阶段。