开发工具

读取 KUI 文档完整 Accessibility（AX）树，包含可访问节点的角色、名称和属性，可用于核对 ARIA 属性与屏幕阅读器兼容性。

读取 selector 指定元素的 content/padding/border/margin 四组四边形坐标，各为从左上角顺时针排列的 8 个浮点数，并返回元素 CSS 像素宽高。

按 kui_breakpoint_set 返回的数字 breakpoint_id 移除断点。

在 source 指定的 Lua 源码名或文件名中设置断点，line 为从 1 开始的行号。condition 可填写 Lua 条件表达式，仅为真时中断；log_message 可设置日志点，只打印、不暂停。

列出全部活动断点及各自的源码、行号和条件。

读取当前 Lua 调用栈，仅在执行暂停时有效；每个栈帧包含源码文件、行号和函数名。

在 KUI 视口相对坐标 x/y 点击，单位为 CSS 像素。button 为 left/middle/right，默认 left；click_count=1 单击、2 双击；modifiers 位为 Alt=1、Ctrl=2、Meta=4、Shift=8。

连接正在运行的 KUI 应用 DevTools。/json 统一发现本机所有进程和窗口，不只返回指定端口上的目标，建议先用 kui_targets 查看。port 默认为 9229，并向后扫描若干端口；target 可用目标 ID 或不区分大小写的标题片段筛选。留空时优先选指定端口上的应用，否则选第一个。

读取 KUI 应用通过 KUI_LOG_INFO/WARN/ERROR 产生的全部控制台消息。

禁用 Lua 脚本调试器并移除全部断点。

启用 Lua 脚本调试器，设置断点前必须先调用；应用必须已经调用 window->attachScriptEngine()。

在暂停栈帧的局部作用域中计算 Lua expression，能够访问局部变量和 upvalue，与 kui_eval 的执行上下文不同。frame_index 指定栈帧，0 为最内层、也是默认值。

读取调试器 running/paused/disabled 状态；暂停时同时返回当前源码文件和行号。

停止当前租约式性能录制，然后断开 DevTools 连接。

向 selector 指定元素派发合成 DOM 事件，event_type 可为 click、input 或自定义事件名。bubbles/cancelable 默认均为 true；detail 可提供 JSON 字符串存入 event.detail，内容不会被 eval 执行。

读取 DOM 树或 selector 匹配元素的属性。selector 留空读取整棵文档树，此时 depth 控制深度，范围 1–10、默认 3。

查找视口相对 CSS 像素坐标 x/y 上最顶层的元素，便于截图后确认某位置的元素，再点击或检查。

在 KUI 脚本引擎中执行 expression 指定的 Lua 表达式并返回结果；应用必须已调用 window->attachScriptEngine()。

读取 selector 指定元素上注册的全部事件监听器。

最多收集 0.5 秒 KUI 推送事件，返回最后 count 条，默认 20。无状态模式会新建连接，只能收集该时间窗口内服务器推送的事件。

配置 Lua 运行时错误的异常断点：mode=none 默认从不中断；uncaught 只在未处理错误上中断；all 在每次错误上中断，包括被 pcall 捕获的错误。

强制 selector 指定元素进入 hover/focus/active/visited 伪状态，可在不实际移动鼠标的情况下检查对应 CSS。

读取 selector 匹配元素的全部已计算 CSS 属性。

向当前聚焦元素发送键盘事件。key 为 DOM 键名，例如 Enter、Escape、Tab、Backspace、Delete、方向键、Home/End、PageUp/PageDown、F1–F12、字母或数字。event_type 为 keyDown/keyUp/char，默认 keyDown；modifiers 位为 Alt=1、Ctrl=2、Meta=4、Shift=8。

读取 KUI 窗口的视口尺寸和内容布局尺寸。

读取 selector 指定元素匹配的全部作者与 UA CSS 规则，并标明内联、样式表索引或继承等来源。

将鼠标移动到视口 CSS 像素坐标 x/y，不执行点击。

读取 KUI 文档已经加载的全部 HTTP 资源，包括图片、脚本等。

读取 selector 匹配元素的 outer HTML，包括元素自身标记；可使用 #main、.card:first-child 等 CSS selector。

读取 KUI 页面的标题、URL、滚动位置和视口尺寸。

请求 Lua 脚本在下一条执行的源码行暂停。

读取性能录制缓冲区占用、丢弃证据数量，以及开销更低的建议模式；session_id 可指定录制，留空使用最后会话。

读取性能数据的精确 schema、模式、限制和 CPU/内存/GPU 提供方可用性，不启动录制。不支持或读取失败会明确标注，不会用数字 0 冒充有效数据。

在一次 WebSocket 调用中录制一次交互：可选先预热同一输入，再启动录制，等待 warmup_ms，输入后等待 settle_ms 并停止；预热后也等待 settle_ms。返回冻结录制中有样式/布局/绘制工作的 compact 帧和累计数据；attribution 还按拓扑迁移结果汇总布局节点，并列出 node_limit 个布局热点。会话 ID 被保留，便于后续逐帧或节点深查。action 可为 click/key/type/none，none 只录 warmup_ms+settle_ms；selector 点击边框盒中心并优先于视口 CSS 像素 x/y；key 为 DOM 键名，发送 keyDown+keyUp，text 用于 type。modifiers 位为 Alt=1/Ctrl=2/Meta=4/Shift=8；mode 为低开销 timeline、attribution 或 deep-trace；warmup_action 决定是否排除冷缓存首用。max_frames 限制帧数，node_limit 限制热点列表。

将已停止的录制导出为单个有大小上限、已脱敏的 JSON。confirm_export 必须为 true，表示用户明确批准导出；max_bytes 限制 UTF-8 大小，范围 1024–4194304 字节。引擎排除 DOM 文字、输入值、URL、令牌、selector、元素 ID/class 和稳定 GPU 适配器/引擎标识。须先停止活动录制，保证导出数据为原子快照；session_id 留空使用最后会话。

按录制中的 frame_id 读取单帧各阶段、工作量、损伤、图层、DOM 和 DisplayList 数据。session_id 留空使用最后会话；detail 默认为 full 原始帧，compact 使用与 kui_perf_record_get 相同的裁剪方式。

按失效、样式、布局、绘制或 DisplayList 工作量给热点节点排序；节点级结果要求 attribution 模式。sort_by 可为 estimatedCost/dirty/style/layout/paint/displayList/raster，其中 raster 统计 DeepTrace 已提交可绘制操作，不代表 GPU 完成。limit 为 1–200。compact 只返回节点身份、非零计数和 layoutTopologyTransfer 结果，full 返回原始页。min_layout_runs>0 会改为布局排序并分页扫描至低于阈值，按节点最后的拓扑迁移结果汇总全部达标节点及布局次数；limit 此时只限制列出的节点，不限制分组范围。session_id 留空使用最后会话。

返回以实际证据支撑的脏标记、样式、布局、绘制、损伤、资源与缓冲区诊断卡片；session_id 可指定录制，留空使用最后会话。

读取 performance_node_id 的有序脏标记事件、相关更新轮次和节点累计数据；可指定 session_id、事件 cursor 和 max_events（默认 200）分页。

显式分页读取保留的录制摘要、工作量和资源采样；服务器不会在后台轮询。hasMore=true 时继续使用返回的 cursor。帧和资源分别使用 cursor/resource_cursor，单页 max_frames/max_resource_samples 均为 1–512，默认 120。session_id 留空使用最后会话。detail=compact 默认保留逐帧时序、非零计数、布局路径/子阶段、拓扑迁移统计及部分渲染字段，删除每个资源样本的内存类别说明，数值不改；full 返回原始数据。layout_frames_only 仅 compact 可用，略过无布局帧并报告 framesOmitted。

启动有容量和时长上限的细粒度渲染录制。每次 MCP 调用使用短连接，因此固定申请 lifecycle=leased，关闭 WebSocket 不会终止录制；须用 kui_perf_record_stop 停止，再用 kui_perf_record_get 读取。单次输入建议用 kui_perf_capture_interaction，避免工具调用间延迟。mode 为 summary/timeline/attribution/deep-trace；max_frames 为 1–4096；max_duration_ms 到期以 timeout 停止，lease_ttl_ms 内无人访问会以 lease-expired 停止，两者默认 120000ms。resource_interval_ms 最少 250ms；gpu_sampling 可选启用 Windows PDH，可能影响尾部延迟。node_details 将 timeline 提升为 attribution；categories 可选 timing/work/render/resources/updatePasses/nodes/trace 子集；max_nodes 与 buffer_size=0 使用引擎默认节点上限及缓冲预算。

显式停止细粒度性能录制并保留证据。session_id 留空使用当前 MCP 进程最后启动的录制。

将录制中的 performance_node_id 解析为会话与文档 epoch 范围内的稳定身份。返回的 backendNodeId 仅在该录制的文档 epoch 内稳定；需要当前 Elements 定位信息时用 kui_perf_reveal_node，不要持久化临时 DFS selector。session_id 留空使用最后会话。

使用新生成的 DOM 定位信息在 Elements 中显示仍然存活的录制节点。performance_node_id 来自热点节点结果；document_epoch 必须与 start/resolveNode 返回值完全一致，session_id 留空使用最后会话，highlight 可显示高亮覆盖层。冻结、已脱离 DOM 或 epoch 不匹配的节点会明确返回不可用，避免使用过期 selector。

分页读取有界 DeepTrace 事件。包含绘制所有者的 DisplayList 区间、具体后端回放回执、操作类型分布、surface 元数据和 present 调用回执。除非后端提供方明确报告，否则不支持确认 GPU/显示完成。可指定 session_id、cursor 和 max_events（默认 200）。

读取帧耗时、布局次数、绘制次数等性能指标。

启动 Lua 脚本分析器；此分析器不测量渲染器或整个进程的 CPU。

停止 Lua 脚本性能分析，返回标注 profileKind=lua 的分析数据。

重新加载 KUI 窗口当前打开的 HTML 文档。

移除 selector 指定元素的 name 属性，例如 disabled 或 class。

移除 selector 指定元素 element.style 中的 prop 内联属性，元素有无 HTML id 均可使用。

读取或实时设置渲染优化。name 留空返回 retainedDLSkip、retainedSurface、layerPromotion、partialDamage、selectiveLayout、ifcAlternateSlot、layerLimit 的当前值和可用性。布尔选项用 enabled，layerLimit 用非负整数 value；关闭 ifcAlternateSlot 会立即释放所有 IFC 结果缓存的第二槽，每槽持有一个已布局的 SkParagraph。

读取绘制/复用帧数、跳帧率、工作 FPS 与提交 FPS、图层 R/C/S 数量、局部损伤开关及最近逐帧模式（full/partial/layer/skipped）。同时报告持续出帧来源：主动画计时器、transition、animation、Lottie、3D 和脚本 rAF；animationTimerActive=false 表示按需渲染生效，不表示跳帧回归。调用会启用逐帧重绘环形记录；window 指定最近帧数，默认 120，上限 240。

按帧编号增量读取重绘矩形，返回 frames（帧号、模式、overflow、矩形列表）与 lastFrame。since_frame=0 读取最近记录；后续传入 lastFrame 只取新帧，可获得 DevTools 绘制闪烁覆盖层所用的数据。

从断点或暂停状态恢复 Lua 脚本执行。

读取指定调用栈帧的局部变量和 upvalue。frame_index 从 0 开始，0 表示最内层栈帧，默认 0。

收集 3 秒连续捕获帧，将每帧保存为 output_dir 下的 frame_0000.png 等编号 PNG。max_frames 限制保存数量，默认 100，避免产生过多文件。

启动连续帧捕获，每隔 every_nth_frame 个已渲染帧推送 Page.screencastFrame。1 表示逐帧，2 表示隔帧，默认 2；间隔越大开销越低。用 kui_events 或 kui_wait_event 接收帧事件。

停止正在运行的连续帧捕获，并发送剩余待处理帧。

截取 KUI 窗口并将 PNG 保存到 output_path，默认 kui_screenshot.png。建议使用绝对路径；相对路径以当前工作目录为基准。

读取调试器已知的全部 Lua 源码文件，返回源码名称、行数及当前是否已加载。

在视口 CSS 像素坐标 x/y 发起滚动。delta_x 为水平像素增量，正数向右；delta_y 为垂直增量，正数向下，默认 120。

读取当前文档的滚动位置和总可滚动高度。

将文档滚动到纵向位置 y，单位为 CSS 像素。

发送任意 CDP 命令并返回原始 JSON 响应，适合专用工具尚未覆盖的命令。method 填 CDP 方法名，例如 DOM.getDocument；params_json 为参数对象的 JSON 字符串，默认 {}。

为 selector 匹配元素设置 HTML 属性。name 为 class、data-active、disabled 等属性名，value 为属性字符串值。

用 html 标记替换 selector 指定元素的 innerHTML。

通过 CSS.addRule 将 selector 和 css_text 组成的新规则追加到文档动态样式表，不覆盖已有规则。css_text 只写声明，不带花括号，例如 color:red; display:none；selector 可包含 :hover 等伪状态。

修改 selector 匹配元素自身 element.style 中的单个内联 CSS 属性，作用等同 DevTools Styles 面板的 element.style 编辑。prop 指定属性名，value 指定 CSS 值，important 决定是否加 !important；这与 kui_set_style 追加样式表规则不同。

将 selector 指定元素的文字内容设置为 text 纯文本。

返回当前连接状态，以及能够发现的全部 KUI 目标。

执行 Lua 单步调试。action=over 越过当前行且不进入函数调用；into 进入函数；out 退出当前函数，默认 over。

清空 KUI 内存中的 localStorage 和 sessionStorage 两类存储。

读取 KUI 内存中的全部存储键值。local=true 默认选择 localStorage，false 选择 sessionStorage。

从 KUI 内存存储中删除 key。local=true 默认选择 localStorage，false 选择 sessionStorage。

在 KUI 内存存储中设置字符串 key/value。local=true 默认选择 localStorage，false 选择 sessionStorage。

列出 localhost 上能发现的 KUI 应用和窗口。利用 /json 的跨进程统一发现，从 port（默认 9229）向后扫描并去重；返回的 ID 或标题可用于 kui_connect 的 target 参数。

读取布局、绘制、合成等性能事件的时间线。

向当前聚焦的 KUI 元素逐字符输入 text 纯文本字符串；不使用转义序列。

等待指定 event_name 的 CDP 推送事件后返回，timeout 为最长等待秒数，默认 5。可等待点击后的 DOM 变化再断言状态，例如 childNodeInserted/Removed、attributeModified、characterDataModified、Console.messageAdded 或 Page.screencastFrame。