完整工具参数目录

本页从 Rust 注册表与派生 JSON Schema 生成，包含已关闭的可选工具和 ima 能力。名称/类型/参数枚举是协议原文；具体可用项用 MCP nl2sh_tools 或 Web 工具页核对。关闭项不能直接调用，常驻协议服务可提供进程生命周期工具。启用不等于批准，风险和平台支持见 工具指南。

下载机器可读 Schema。Schema 中的英文描述来自模型协议，中文行为说明列在各工具下。

Descriptor 是工具组、默认开关、平台/扩展要求、风险下限、调度策略声明与 Schema 的唯一来源。真实可用性由运行时发现决定，声明不授予执行权限。下载完整描述与 Schema。

agent_memory

跨会话读取或更新用户与 Agent 记忆；回答用户姓名、身份、偏好、长期约定或已保存事实前，已知键用 get，未知键用 list。记忆不是 Android 账户或设备资料证据；写操作需确认。

描述项	值
工具组	-
默认启用	true
平台要求	any
连接器能力	-
扩展要求	none
风险下限	read_only
调度策略声明	sequential
生命周期	call

{
  "$defs": {
    "AgentMemoryAction": {
      "description": "Supported private Agent notebook operations exposed in the tool schema.",
      "oneOf": [
        {
          "const": "get",
          "description": "Read one value by key.",
          "type": "string"
        },
        {
          "const": "list",
          "description": "List all stored keys and values.",
          "type": "string"
        },
        {
          "const": "set",
          "description": "Create or replace one value after confirmation.",
          "type": "string"
        },
        {
          "const": "delete",
          "description": "Delete one key after confirmation.",
          "type": "string"
        },
        {
          "const": "clear",
          "description": "Delete all entries after confirmation.",
          "type": "string"
        }
      ]
    }
  },
  "additionalProperties": false,
  "properties": {
    "action": {
      "$ref": "#/$defs/AgentMemoryAction"
    },
    "key": {
      "default": null,
      "type": [
        "string",
        "null"
      ]
    },
    "value": {
      "default": null,
      "type": [
        "string",
        "null"
      ]
    }
  },
  "required": [
    "action"
  ],
  "type": "object"
}

analyze_audio

确定性 WAV/PCM DSP，缺少 PCM 元数据询问用户，不猜测。

描述项	值
工具组	-
默认启用	true
平台要求	any
连接器能力	-
扩展要求	none
风险下限	read_only
调度策略声明	sequential
生命周期	call

{
  "$defs": {
    "RawSampleFormat": {
      "enum": [
        "s16le",
        "s24le",
        "s32le",
        "f32le"
      ],
      "type": "string"
    }
  },
  "additionalProperties": false,
  "properties": {
    "channels": {
      "default": null,
      "format": "uint16",
      "maximum": 65535,
      "minimum": 0,
      "type": [
        "integer",
        "null"
      ]
    },
    "path": {
      "type": "string"
    },
    "sample_format": {
      "anyOf": [
        {
          "$ref": "#/$defs/RawSampleFormat"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "sample_rate": {
      "default": null,
      "format": "uint32",
      "minimum": 0,
      "type": [
        "integer",
        "null"
      ]
    }
  },
  "required": [
    "path"
  ],
  "type": "object"
}

analyze_system_trace

Rust 有界只读解析原始 Perfetto protobuf，报告主线程/RenderThread 调度等待、帧异常、Binder 投递延迟与 CPU/唤醒启发式，明确覆盖与限制。

描述项	值
工具组	-
默认启用	true
平台要求	any
连接器能力	-
扩展要求	none
风险下限	read_only
调度策略声明	parallel
生命周期	call

{
  "additionalProperties": false,
  "properties": {
    "frame_budget_ms": {
      "default": 16.667,
      "description": "Choreographer duration budget, 1–100 ms; default 16.667. Set for the actual refresh rate.",
      "format": "double",
      "type": "number"
    },
    "package": {
      "default": null,
      "description": "Optional exact recorded package name; selects one process, mutually exclusive with pid.",
      "type": [
        "string",
        "null"
      ]
    },
    "path": {
      "default": null,
      "description": "Existing raw protobuf trace file (at most 64 MiB), including externally recorded files.",
      "type": [
        "string",
        "null"
      ]
    },
    "pid": {
      "default": null,
      "description": "Optional target process ID; main thread has tid == pid.",
      "format": "uint32",
      "minimum": 0,
      "type": [
        "integer",
        "null"
      ]
    },
    "threshold_ms": {
      "default": 50,
      "description": "Long wait/slice/Binder delivery threshold, 1–1000 ms; default 50.",
      "format": "uint64",
      "minimum": 0,
      "type": "integer"
    },
    "trace_id": {
      "default": null,
      "description": "Managed trace ID. Provide either trace_id or path.",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "type": "object"
}

android.find_node

按精确文字或 bounds 查找当前唯一节点。

描述项	值
工具组	-
默认启用	true
平台要求	android_shell
连接器能力	-
扩展要求	none
风险下限	read_only
调度策略声明	android_ui
生命周期	call

{
  "additionalProperties": false,
  "properties": {
    "bounds": {
      "default": null,
      "description": "Exact current node bounds for a node tap.",
      "type": [
        "string",
        "null"
      ]
    },
    "text": {
      "default": null,
      "description": "Visible text or content description to match.",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "required": [],
  "type": "object"
}

android.input_text

向焦点控件追加文字，Unicode 需 companion/键盘；replace 仅输入法。

描述项	值
工具组	-
默认启用	true
平台要求	android_shell
连接器能力	-
扩展要求	none
风险下限	dangerous
调度策略声明	android_ui
生命周期	call

{
  "$defs": {
    "TextWriteMode": {
      "description": "How one Unicode write treats the text already in the focused control.\n\nAlso the model-visible `android.input_text` mode: clearing a field needs the companion input\nmethod, because the shell and accessibility paths can only insert characters.",
      "oneOf": [
        {
          "const": "append",
          "description": "Insert the text at the current cursor position.",
          "type": "string"
        },
        {
          "const": "replace",
          "description": "Clear the control first, then write the text.",
          "type": "string"
        }
      ]
    },
    "UiVerification": {
      "additionalProperties": false,
      "description": "Read-only checks to perform after a normally approved Android action.",
      "properties": {
        "expected_package": {
          "description": "Exact package owning the current focused window, not merely a package present in the tree.",
          "type": [
            "string",
            "null"
          ]
        },
        "text_absent": {
          "description": "Exact visible text or content description that must be absent from a complete current viewport tree.",
          "type": [
            "string",
            "null"
          ]
        },
        "text_present": {
          "description": "Exact visible text or content description that must appear.",
          "type": [
            "string",
            "null"
          ]
        },
        "timeout_ms": {
          "description": "Deadline for the baseline read and separately for all post-action observation, 100–10000 ms (default 2000).",
          "format": "uint32",
          "minimum": 0,
          "type": [
            "integer",
            "null"
          ]
        },
        "verify_change": {
          "default": false,
          "description": "Compare complete UI trees immediately before and after dispatch; not proof of business success.",
          "type": "boolean"
        }
      },
      "type": "object"
    }
  },
  "additionalProperties": false,
  "properties": {
    "mode": {
      "anyOf": [
        {
          "$ref": "#/$defs/TextWriteMode"
        },
        {
          "type": "null"
        }
      ],
      "description": "Append to the focused control, or clear it first through the nl2sh keyboard."
    },
    "text": {
      "description": "Visible text or content description to match.",
      "type": "string"
    },
    "verification": {
      "anyOf": [
        {
          "$ref": "#/$defs/UiVerification"
        },
        {
          "type": "null"
        }
      ],
      "description": "Optional read-only verification after an approved UI mutation."
    }
  },
  "required": [
    "text"
  ],
  "type": "object"
}

android.launch_app

确认后启动验证过的包。

描述项	值
工具组	-
默认启用	true
平台要求	android_shell
连接器能力	-
扩展要求	none
风险下限	mutating
调度策略声明	android_ui
生命周期	call

{
  "$defs": {
    "UiVerification": {
      "additionalProperties": false,
      "description": "Read-only checks to perform after a normally approved Android action.",
      "properties": {
        "expected_package": {
          "description": "Exact package owning the current focused window, not merely a package present in the tree.",
          "type": [
            "string",
            "null"
          ]
        },
        "text_absent": {
          "description": "Exact visible text or content description that must be absent from a complete current viewport tree.",
          "type": [
            "string",
            "null"
          ]
        },
        "text_present": {
          "description": "Exact visible text or content description that must appear.",
          "type": [
            "string",
            "null"
          ]
        },
        "timeout_ms": {
          "description": "Deadline for the baseline read and separately for all post-action observation, 100–10000 ms (default 2000).",
          "format": "uint32",
          "minimum": 0,
          "type": [
            "integer",
            "null"
          ]
        },
        "verify_change": {
          "default": false,
          "description": "Compare complete UI trees immediately before and after dispatch; not proof of business success.",
          "type": "boolean"
        }
      },
      "type": "object"
    }
  },
  "additionalProperties": false,
  "properties": {
    "package": {
      "description": "Package name for launch or stop.",
      "type": "string"
    },
    "verification": {
      "anyOf": [
        {
          "$ref": "#/$defs/UiVerification"
        },
        {
          "type": "null"
        }
      ],
      "description": "Optional read-only verification after an approved UI mutation."
    }
  },
  "required": [
    "package"
  ],
  "type": "object"
}

android.press_back

确认后返回。

描述项	值
工具组	-
默认启用	true
平台要求	android_shell
连接器能力	-
扩展要求	none
风险下限	dangerous
调度策略声明	android_ui
生命周期	call

{
  "$defs": {
    "UiVerification": {
      "additionalProperties": false,
      "description": "Read-only checks to perform after a normally approved Android action.",
      "properties": {
        "expected_package": {
          "description": "Exact package owning the current focused window, not merely a package present in the tree.",
          "type": [
            "string",
            "null"
          ]
        },
        "text_absent": {
          "description": "Exact visible text or content description that must be absent from a complete current viewport tree.",
          "type": [
            "string",
            "null"
          ]
        },
        "text_present": {
          "description": "Exact visible text or content description that must appear.",
          "type": [
            "string",
            "null"
          ]
        },
        "timeout_ms": {
          "description": "Deadline for the baseline read and separately for all post-action observation, 100–10000 ms (default 2000).",
          "format": "uint32",
          "minimum": 0,
          "type": [
            "integer",
            "null"
          ]
        },
        "verify_change": {
          "default": false,
          "description": "Compare complete UI trees immediately before and after dispatch; not proof of business success.",
          "type": "boolean"
        }
      },
      "type": "object"
    }
  },
  "additionalProperties": false,
  "properties": {
    "verification": {
      "anyOf": [
        {
          "$ref": "#/$defs/UiVerification"
        },
        {
          "type": "null"
        }
      ],
      "description": "Optional read-only verification after an approved UI mutation."
    }
  },
  "required": [],
  "type": "object"
}

android.press_enter

确认后按 Enter。

描述项	值
工具组	-
默认启用	true
平台要求	android_shell
连接器能力	-
扩展要求	none
风险下限	dangerous
调度策略声明	android_ui
生命周期	call

{
  "$defs": {
    "UiVerification": {
      "additionalProperties": false,
      "description": "Read-only checks to perform after a normally approved Android action.",
      "properties": {
        "expected_package": {
          "description": "Exact package owning the current focused window, not merely a package present in the tree.",
          "type": [
            "string",
            "null"
          ]
        },
        "text_absent": {
          "description": "Exact visible text or content description that must be absent from a complete current viewport tree.",
          "type": [
            "string",
            "null"
          ]
        },
        "text_present": {
          "description": "Exact visible text or content description that must appear.",
          "type": [
            "string",
            "null"
          ]
        },
        "timeout_ms": {
          "description": "Deadline for the baseline read and separately for all post-action observation, 100–10000 ms (default 2000).",
          "format": "uint32",
          "minimum": 0,
          "type": [
            "integer",
            "null"
          ]
        },
        "verify_change": {
          "default": false,
          "description": "Compare complete UI trees immediately before and after dispatch; not proof of business success.",
          "type": "boolean"
        }
      },
      "type": "object"
    }
  },
  "additionalProperties": false,
  "properties": {
    "verification": {
      "anyOf": [
        {
          "$ref": "#/$defs/UiVerification"
        },
        {
          "type": "null"
        }
      ],
      "description": "Optional read-only verification after an approved UI mutation."
    }
  },
  "required": [],
  "type": "object"
}

android.press_home

确认后回到桌面。

描述项	值
工具组	-
默认启用	true
平台要求	android_shell
连接器能力	-
扩展要求	none
风险下限	dangerous
调度策略声明	android_ui
生命周期	call

{
  "$defs": {
    "UiVerification": {
      "additionalProperties": false,
      "description": "Read-only checks to perform after a normally approved Android action.",
      "properties": {
        "expected_package": {
          "description": "Exact package owning the current focused window, not merely a package present in the tree.",
          "type": [
            "string",
            "null"
          ]
        },
        "text_absent": {
          "description": "Exact visible text or content description that must be absent from a complete current viewport tree.",
          "type": [
            "string",
            "null"
          ]
        },
        "text_present": {
          "description": "Exact visible text or content description that must appear.",
          "type": [
            "string",
            "null"
          ]
        },
        "timeout_ms": {
          "description": "Deadline for the baseline read and separately for all post-action observation, 100–10000 ms (default 2000).",
          "format": "uint32",
          "minimum": 0,
          "type": [
            "integer",
            "null"
          ]
        },
        "verify_change": {
          "default": false,
          "description": "Compare complete UI trees immediately before and after dispatch; not proof of business success.",
          "type": "boolean"
        }
      },
      "type": "object"
    }
  },
  "additionalProperties": false,
  "properties": {
    "verification": {
      "anyOf": [
        {
          "$ref": "#/$defs/UiVerification"
        },
        {
          "type": "null"
        }
      ],
      "description": "Optional read-only verification after an approved UI mutation."
    }
  },
  "required": [],
  "type": "object"
}

android.read_screen

返回有界屏幕图片，不保留文件。

描述项	值
工具组	-
默认启用	true
平台要求	android_shell
连接器能力	-
扩展要求	none
风险下限	read_only
调度策略声明	android_ui
生命周期	call

{
  "additionalProperties": false,
  "properties": {},
  "required": [],
  "type": "object"
}

android.screen_dump

读取当前有界 UI 树。

描述项	值
工具组	-
默认启用	true
平台要求	android_shell
连接器能力	-
扩展要求	none
风险下限	read_only
调度策略声明	android_ui
生命周期	call

{
  "additionalProperties": false,
  "properties": {},
  "required": [],
  "type": "object"
}

android.screenshot

有界屏幕图片；显式持久 PNG 路径需确认。

描述项	值
工具组	-
默认启用	true
平台要求	android_shell
连接器能力	-
扩展要求	none
风险下限	read_only
调度策略声明	android_ui
生命周期	call

{
  "additionalProperties": false,
  "properties": {
    "path": {
      "default": null,
      "description": "Absolute screenshot destination.",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "required": [],
  "type": "object"
}

android.scroll

确认后滚动，可自动计算坐标。

描述项	值
工具组	-
默认启用	true
平台要求	android_shell
连接器能力	-
扩展要求	none
风险下限	dangerous
调度策略声明	android_ui
生命周期	call

{
  "$defs": {
    "ScrollDirection": {
      "description": "Direction the screen content should move.",
      "enum": [
        "down",
        "up"
      ],
      "type": "string"
    },
    "UiVerification": {
      "additionalProperties": false,
      "description": "Read-only checks to perform after a normally approved Android action.",
      "properties": {
        "expected_package": {
          "description": "Exact package owning the current focused window, not merely a package present in the tree.",
          "type": [
            "string",
            "null"
          ]
        },
        "text_absent": {
          "description": "Exact visible text or content description that must be absent from a complete current viewport tree.",
          "type": [
            "string",
            "null"
          ]
        },
        "text_present": {
          "description": "Exact visible text or content description that must appear.",
          "type": [
            "string",
            "null"
          ]
        },
        "timeout_ms": {
          "description": "Deadline for the baseline read and separately for all post-action observation, 100–10000 ms (default 2000).",
          "format": "uint32",
          "minimum": 0,
          "type": [
            "integer",
            "null"
          ]
        },
        "verify_change": {
          "default": false,
          "description": "Compare complete UI trees immediately before and after dispatch; not proof of business success.",
          "type": "boolean"
        }
      },
      "type": "object"
    }
  },
  "additionalProperties": false,
  "properties": {
    "direction": {
      "anyOf": [
        {
          "$ref": "#/$defs/ScrollDirection"
        },
        {
          "type": "null"
        }
      ],
      "description": "Content scroll direction when coordinates are omitted."
    },
    "duration_ms": {
      "default": null,
      "description": "Swipe duration in milliseconds.",
      "format": "uint32",
      "minimum": 0,
      "type": [
        "integer",
        "null"
      ]
    },
    "end_x": {
      "default": null,
      "description": "Swipe end horizontal coordinate.",
      "format": "uint32",
      "minimum": 0,
      "type": [
        "integer",
        "null"
      ]
    },
    "end_y": {
      "default": null,
      "description": "Swipe end vertical coordinate.",
      "format": "uint32",
      "minimum": 0,
      "type": [
        "integer",
        "null"
      ]
    },
    "verification": {
      "anyOf": [
        {
          "$ref": "#/$defs/UiVerification"
        },
        {
          "type": "null"
        }
      ],
      "description": "Optional read-only verification after an approved UI mutation."
    },
    "x": {
      "default": null,
      "description": "Start or tap horizontal coordinate.",
      "format": "uint32",
      "minimum": 0,
      "type": [
        "integer",
        "null"
      ]
    },
    "y": {
      "default": null,
      "description": "Start or tap vertical coordinate.",
      "format": "uint32",
      "minimum": 0,
      "type": [
        "integer",
        "null"
      ]
    }
  },
  "required": [],
  "type": "object"
}

android.stop_app

确认后强制停止验证过的包。

描述项	值
工具组	-
默认启用	true
平台要求	android_shell
连接器能力	-
扩展要求	none
风险下限	mutating
调度策略声明	android_ui
生命周期	call

{
  "$defs": {
    "UiVerification": {
      "additionalProperties": false,
      "description": "Read-only checks to perform after a normally approved Android action.",
      "properties": {
        "expected_package": {
          "description": "Exact package owning the current focused window, not merely a package present in the tree.",
          "type": [
            "string",
            "null"
          ]
        },
        "text_absent": {
          "description": "Exact visible text or content description that must be absent from a complete current viewport tree.",
          "type": [
            "string",
            "null"
          ]
        },
        "text_present": {
          "description": "Exact visible text or content description that must appear.",
          "type": [
            "string",
            "null"
          ]
        },
        "timeout_ms": {
          "description": "Deadline for the baseline read and separately for all post-action observation, 100–10000 ms (default 2000).",
          "format": "uint32",
          "minimum": 0,
          "type": [
            "integer",
            "null"
          ]
        },
        "verify_change": {
          "default": false,
          "description": "Compare complete UI trees immediately before and after dispatch; not proof of business success.",
          "type": "boolean"
        }
      },
      "type": "object"
    }
  },
  "additionalProperties": false,
  "properties": {
    "package": {
      "description": "Package name for launch or stop.",
      "type": "string"
    },
    "verification": {
      "anyOf": [
        {
          "$ref": "#/$defs/UiVerification"
        },
        {
          "type": "null"
        }
      ],
      "description": "Optional read-only verification after an approved UI mutation."
    }
  },
  "required": [
    "package"
  ],
  "type": "object"
}

android.swipe

确认后在坐标间滑动。

描述项	值
工具组	-
默认启用	true
平台要求	android_shell
连接器能力	-
扩展要求	none
风险下限	dangerous
调度策略声明	android_ui
生命周期	call

{
  "$defs": {
    "UiVerification": {
      "additionalProperties": false,
      "description": "Read-only checks to perform after a normally approved Android action.",
      "properties": {
        "expected_package": {
          "description": "Exact package owning the current focused window, not merely a package present in the tree.",
          "type": [
            "string",
            "null"
          ]
        },
        "text_absent": {
          "description": "Exact visible text or content description that must be absent from a complete current viewport tree.",
          "type": [
            "string",
            "null"
          ]
        },
        "text_present": {
          "description": "Exact visible text or content description that must appear.",
          "type": [
            "string",
            "null"
          ]
        },
        "timeout_ms": {
          "description": "Deadline for the baseline read and separately for all post-action observation, 100–10000 ms (default 2000).",
          "format": "uint32",
          "minimum": 0,
          "type": [
            "integer",
            "null"
          ]
        },
        "verify_change": {
          "default": false,
          "description": "Compare complete UI trees immediately before and after dispatch; not proof of business success.",
          "type": "boolean"
        }
      },
      "type": "object"
    }
  },
  "additionalProperties": false,
  "properties": {
    "duration_ms": {
      "default": null,
      "description": "Swipe duration in milliseconds.",
      "format": "uint32",
      "minimum": 0,
      "type": [
        "integer",
        "null"
      ]
    },
    "end_x": {
      "description": "Swipe end horizontal coordinate.",
      "format": "uint32",
      "minimum": 0,
      "type": "integer"
    },
    "end_y": {
      "description": "Swipe end vertical coordinate.",
      "format": "uint32",
      "minimum": 0,
      "type": "integer"
    },
    "verification": {
      "anyOf": [
        {
          "$ref": "#/$defs/UiVerification"
        },
        {
          "type": "null"
        }
      ],
      "description": "Optional read-only verification after an approved UI mutation."
    },
    "x": {
      "description": "Start or tap horizontal coordinate.",
      "format": "uint32",
      "minimum": 0,
      "type": "integer"
    },
    "y": {
      "description": "Start or tap vertical coordinate.",
      "format": "uint32",
      "minimum": 0,
      "type": "integer"
    }
  },
  "required": [
    "x",
    "y",
    "end_x",
    "end_y"
  ],
  "type": "object"
}

android.tap

确认后点击坐标。

描述项	值
工具组	-
默认启用	true
平台要求	android_shell
连接器能力	-
扩展要求	none
风险下限	dangerous
调度策略声明	android_ui
生命周期	call

{
  "$defs": {
    "UiVerification": {
      "additionalProperties": false,
      "description": "Read-only checks to perform after a normally approved Android action.",
      "properties": {
        "expected_package": {
          "description": "Exact package owning the current focused window, not merely a package present in the tree.",
          "type": [
            "string",
            "null"
          ]
        },
        "text_absent": {
          "description": "Exact visible text or content description that must be absent from a complete current viewport tree.",
          "type": [
            "string",
            "null"
          ]
        },
        "text_present": {
          "description": "Exact visible text or content description that must appear.",
          "type": [
            "string",
            "null"
          ]
        },
        "timeout_ms": {
          "description": "Deadline for the baseline read and separately for all post-action observation, 100–10000 ms (default 2000).",
          "format": "uint32",
          "minimum": 0,
          "type": [
            "integer",
            "null"
          ]
        },
        "verify_change": {
          "default": false,
          "description": "Compare complete UI trees immediately before and after dispatch; not proof of business success.",
          "type": "boolean"
        }
      },
      "type": "object"
    }
  },
  "additionalProperties": false,
  "properties": {
    "verification": {
      "anyOf": [
        {
          "$ref": "#/$defs/UiVerification"
        },
        {
          "type": "null"
        }
      ],
      "description": "Optional read-only verification after an approved UI mutation."
    },
    "x": {
      "description": "Start or tap horizontal coordinate.",
      "format": "uint32",
      "minimum": 0,
      "type": "integer"
    },
    "y": {
      "description": "Start or tap vertical coordinate.",
      "format": "uint32",
      "minimum": 0,
      "type": "integer"
    }
  },
  "required": [
    "x",
    "y"
  ],
  "type": "object"
}

android.tap_node

确认后复核并点击精确 bounds 唯一节点。

描述项	值
工具组	-
默认启用	true
平台要求	android_shell
连接器能力	-
扩展要求	none
风险下限	dangerous
调度策略声明	android_ui
生命周期	call

{
  "$defs": {
    "UiVerification": {
      "additionalProperties": false,
      "description": "Read-only checks to perform after a normally approved Android action.",
      "properties": {
        "expected_package": {
          "description": "Exact package owning the current focused window, not merely a package present in the tree.",
          "type": [
            "string",
            "null"
          ]
        },
        "text_absent": {
          "description": "Exact visible text or content description that must be absent from a complete current viewport tree.",
          "type": [
            "string",
            "null"
          ]
        },
        "text_present": {
          "description": "Exact visible text or content description that must appear.",
          "type": [
            "string",
            "null"
          ]
        },
        "timeout_ms": {
          "description": "Deadline for the baseline read and separately for all post-action observation, 100–10000 ms (default 2000).",
          "format": "uint32",
          "minimum": 0,
          "type": [
            "integer",
            "null"
          ]
        },
        "verify_change": {
          "default": false,
          "description": "Compare complete UI trees immediately before and after dispatch; not proof of business success.",
          "type": "boolean"
        }
      },
      "type": "object"
    }
  },
  "additionalProperties": false,
  "properties": {
    "bounds": {
      "description": "Exact current node bounds for a node tap.",
      "type": "string"
    },
    "verification": {
      "anyOf": [
        {
          "$ref": "#/$defs/UiVerification"
        },
        {
          "type": "null"
        }
      ],
      "description": "Optional read-only verification after an approved UI mutation."
    }
  },
  "required": [
    "bounds"
  ],
  "type": "object"
}

android.tap_text

确认后复核并点击精确文字唯一节点。

描述项	值
工具组	-
默认启用	true
平台要求	android_shell
连接器能力	-
扩展要求	none
风险下限	dangerous
调度策略声明	android_ui
生命周期	call

{
  "$defs": {
    "UiVerification": {
      "additionalProperties": false,
      "description": "Read-only checks to perform after a normally approved Android action.",
      "properties": {
        "expected_package": {
          "description": "Exact package owning the current focused window, not merely a package present in the tree.",
          "type": [
            "string",
            "null"
          ]
        },
        "text_absent": {
          "description": "Exact visible text or content description that must be absent from a complete current viewport tree.",
          "type": [
            "string",
            "null"
          ]
        },
        "text_present": {
          "description": "Exact visible text or content description that must appear.",
          "type": [
            "string",
            "null"
          ]
        },
        "timeout_ms": {
          "description": "Deadline for the baseline read and separately for all post-action observation, 100–10000 ms (default 2000).",
          "format": "uint32",
          "minimum": 0,
          "type": [
            "integer",
            "null"
          ]
        },
        "verify_change": {
          "default": false,
          "description": "Compare complete UI trees immediately before and after dispatch; not proof of business success.",
          "type": "boolean"
        }
      },
      "type": "object"
    }
  },
  "additionalProperties": false,
  "properties": {
    "text": {
      "description": "Visible text or content description to match.",
      "type": "string"
    },
    "verification": {
      "anyOf": [
        {
          "$ref": "#/$defs/UiVerification"
        },
        {
          "type": "null"
        }
      ],
      "description": "Optional read-only verification after an approved UI mutation."
    }
  },
  "required": [
    "text"
  ],
  "type": "object"
}

android.wait_text

最多等待十秒精确可见文字。

描述项	值
工具组	-
默认启用	true
平台要求	android_shell
连接器能力	-
扩展要求	none
风险下限	read_only
调度策略声明	android_ui
生命周期	call

{
  "additionalProperties": false,
  "properties": {
    "text": {
      "description": "Visible text or content description to match.",
      "type": "string"
    },
    "timeout_ms": {
      "default": null,
      "description": "Maximum wait time in milliseconds.",
      "format": "uint32",
      "minimum": 0,
      "type": [
        "integer",
        "null"
      ]
    }
  },
  "required": [
    "text"
  ],
  "type": "object"
}

android_background_work

有界读取指定应用的 JobScheduler、AlarmManager、待机分组与 DeviceIdle 证据；不修改调度、待机或省电状态。

描述项	值
工具组	-
默认启用	true
平台要求	android
连接器能力	-
扩展要求	none
风险下限	read_only
调度策略声明	parallel
生命周期	call

{
  "additionalProperties": false,
  "properties": {
    "limit": {
      "default": null,
      "description": "Maximum matching lines retained from each Android service.",
      "format": "uint",
      "minimum": 0,
      "type": [
        "integer",
        "null"
      ]
    },
    "package": {
      "description": "Exact Android package whose scheduled background work should be inspected.",
      "type": "string"
    }
  },
  "required": [
    "package"
  ],
  "type": "object"
}

android_clipboard

读取剪贴板，或确认后写入有界文本。

描述项	值
工具组	-
默认启用	true
平台要求	android_shell
连接器能力	-
扩展要求	none
风险下限	read_only
调度策略声明	android_ui
生命周期	call

{
  "additionalProperties": false,
  "properties": {
    "text": {
      "default": null,
      "type": [
        "string",
        "null"
      ]
    }
  },
  "type": "object"
}

android_connectivity

验证公网主机并汇总有界连接性证据。

描述项	值
工具组	-
默认启用	true
平台要求	android
连接器能力	-
扩展要求	none
风险下限	read_only
调度策略声明	sequential
生命周期	call

{
  "additionalProperties": false,
  "properties": {
    "host": {
      "default": null,
      "type": [
        "string",
        "null"
      ]
    }
  },
  "type": "object"
}

android_content_query

有界只读 Content URI 查询，不写入。

描述项	值
工具组	-
默认启用	true
平台要求	android
连接器能力	-
扩展要求	none
风险下限	read_only
调度策略声明	sequential
生命周期	call

{
  "$defs": {
    "ProjectionArg": {
      "anyOf": [
        {
          "description": "Comma- or colon-delimited projection used by older callers.",
          "type": "string"
        },
        {
          "description": "Preferred structured list of projection columns.",
          "items": {
            "type": "string"
          },
          "type": "array"
        }
      ],
      "description": "Backward-compatible content-provider projection accepted as text or columns."
    }
  },
  "additionalProperties": false,
  "properties": {
    "projection": {
      "anyOf": [
        {
          "$ref": "#/$defs/ProjectionArg"
        },
        {
          "type": "null"
        }
      ]
    },
    "uri": {
      "type": "string"
    },
    "where_clause": {
      "default": null,
      "type": [
        "string",
        "null"
      ]
    }
  },
  "required": [
    "uri"
  ],
  "type": "object"
}

android_crash_report

有界 Crash/ANR 证据。

描述项	值
工具组	-
默认启用	true
平台要求	android
连接器能力	-
扩展要求	none
风险下限	read_only
调度策略声明	sequential
生命周期	call

{
  "additionalProperties": false,
  "properties": {
    "limit": {
      "default": null,
      "format": "uint",
      "minimum": 0,
      "type": [
        "integer",
        "null"
      ]
    },
    "package": {
      "default": null,
      "type": [
        "string",
        "null"
      ]
    }
  },
  "type": "object"
}

android_doze

DeviceIdle 与白名单证据。

描述项	值
工具组	-
默认启用	true
平台要求	android
连接器能力	-
扩展要求	none
风险下限	read_only
调度策略声明	sequential
生命周期	call

{
  "additionalProperties": false,
  "type": "object"
}

android_dumpsys

受限只读 dumpsys 服务查询。

描述项	值
工具组	-
默认启用	true
平台要求	android
连接器能力	-
扩展要求	none
风险下限	read_only
调度策略声明	parallel
生命周期	call

{
  "additionalProperties": false,
  "properties": {
    "arguments": {
      "default": null,
      "type": [
        "string",
        "null"
      ]
    },
    "service": {
      "type": "string"
    }
  },
  "required": [
    "service"
  ],
  "type": "object"
}

android_logcat

有界定向 logcat 快照、设备时间窗口和包名/PID 过滤，默认尽力脱敏；缺少目标不回退全局。

描述项	值
工具组	-
默认启用	true
平台要求	android
连接器能力	-
扩展要求	none
风险下限	read_only
调度策略声明	parallel
生命周期	call

{
  "additionalProperties": false,
  "properties": {
    "filter": {
      "default": null,
      "type": [
        "string",
        "null"
      ]
    },
    "lines": {
      "default": null,
      "format": "uint",
      "minimum": 0,
      "type": [
        "integer",
        "null"
      ]
    },
    "package": {
      "default": null,
      "description": "Exact main-process package; fails if no unique running PID can be resolved.",
      "type": [
        "string",
        "null"
      ]
    },
    "pid": {
      "default": null,
      "description": "Explicit process ID; mutually exclusive with package.",
      "format": "uint32",
      "minimum": 0,
      "type": [
        "integer",
        "null"
      ]
    },
    "since_secs": {
      "default": null,
      "description": "Look back on the device clock, 1–3600 seconds; cap the returned matching lines.",
      "format": "uint32",
      "minimum": 0,
      "type": [
        "integer",
        "null"
      ]
    }
  },
  "type": "object"
}

android_media_control

读取媒体状态，或确认后改变播放/音量。

描述项	值
工具组	-
默认启用	true
平台要求	android_shell
连接器能力	-
扩展要求	none
风险下限	read_only
调度策略声明	android_ui
生命周期	call

{
  "additionalProperties": false,
  "properties": {
    "action": {
      "type": "string"
    },
    "level": {
      "default": null,
      "format": "uint8",
      "maximum": 255,
      "minimum": 0,
      "type": [
        "integer",
        "null"
      ]
    }
  },
  "required": [
    "action"
  ],
  "type": "object"
}

android_media_query

有界 MediaStore 图片、视频或音频元数据。

描述项	值
工具组	-
默认启用	true
平台要求	android
连接器能力	-
扩展要求	none
风险下限	read_only
调度策略声明	sequential
生命周期	call

{
  "additionalProperties": false,
  "properties": {
    "created_after_epoch_secs": {
      "default": null,
      "format": "uint64",
      "minimum": 0,
      "type": [
        "integer",
        "null"
      ]
    },
    "limit": {
      "default": null,
      "format": "uint",
      "minimum": 0,
      "type": [
        "integer",
        "null"
      ]
    },
    "media_type": {
      "default": null,
      "type": [
        "string",
        "null"
      ]
    }
  },
  "type": "object"
}

android_netstats

有界网络流量账目。

描述项	值
工具组	-
默认启用	true
平台要求	android
连接器能力	-
扩展要求	none
风险下限	read_only
调度策略声明	sequential
生命周期	call

{
  "additionalProperties": false,
  "properties": {
    "limit": {
      "default": null,
      "format": "uint",
      "minimum": 0,
      "type": [
        "integer",
        "null"
      ]
    },
    "package": {
      "default": null,
      "type": [
        "string",
        "null"
      ]
    }
  },
  "type": "object"
}

android_notification

有界结构化通知快照。

描述项	值
工具组	-
默认启用	true
平台要求	android
连接器能力	-
扩展要求	none
风险下限	read_only
调度策略声明	sequential
生命周期	call

{
  "additionalProperties": false,
  "properties": {
    "limit": {
      "default": null,
      "format": "uint",
      "minimum": 0,
      "type": [
        "integer",
        "null"
      ]
    },
    "package": {
      "default": null,
      "type": [
        "string",
        "null"
      ]
    }
  },
  "type": "object"
}

android_permission_audit

审计指定包或有界应用集合的权限与 AppOps。

描述项	值
工具组	-
默认启用	true
平台要求	android
连接器能力	-
扩展要求	none
风险下限	read_only
调度策略声明	sequential
生命周期	call

{
  "additionalProperties": false,
  "properties": {
    "limit": {
      "default": null,
      "format": "uint",
      "minimum": 0,
      "type": [
        "integer",
        "null"
      ]
    },
    "package": {
      "default": null,
      "type": [
        "string",
        "null"
      ]
    }
  },
  "type": "object"
}

android_settings

读取/列出 system/secure/global 设置，不写入。

描述项	值
工具组	-
默认启用	true
平台要求	android
连接器能力	-
扩展要求	none
风险下限	read_only
调度策略声明	sequential
生命周期	call

{
  "additionalProperties": false,
  "properties": {
    "key": {
      "default": null,
      "type": [
        "string",
        "null"
      ]
    },
    "namespace": {
      "type": "string"
    }
  },
  "required": [
    "namespace"
  ],
  "type": "object"
}

android_storage

文件系统容量及有界应用存储证据。

描述项	值
工具组	-
默认启用	true
平台要求	android
连接器能力	-
扩展要求	none
风险下限	read_only
调度策略声明	sequential
生命周期	call

{
  "additionalProperties": false,
  "properties": {
    "limit": {
      "default": null,
      "format": "uint",
      "minimum": 0,
      "type": [
        "integer",
        "null"
      ]
    },
    "package": {
      "default": null,
      "type": [
        "string",
        "null"
      ]
    }
  },
  "type": "object"
}

android_thermal_power

汇总电池、温控、电源和 DeviceIdle。

描述项	值
工具组	-
默认启用	true
平台要求	android
连接器能力	-
扩展要求	none
风险下限	read_only
调度策略声明	sequential
生命周期	call

{
  "additionalProperties": false,
  "type": "object"
}

android_wifi_eth

汇总 Wi-Fi、以太网、IP、信号与路由。

描述项	值
工具组	-
默认启用	true
平台要求	android
连接器能力	-
扩展要求	none
风险下限	read_only
调度策略声明	sequential
生命周期	call

{
  "additionalProperties": false,
  "type": "object"
}

apply_patch

唯一旧文本替换或新建文件，先展示 diff 并确认。

描述项	值
工具组	-
默认启用	true
平台要求	any
连接器能力	-
扩展要求	none
风险下限	mutating
调度策略声明	sequential
生命周期	call

{
  "additionalProperties": false,
  "properties": {
    "new_text": {
      "description": "Replacement text.",
      "type": "string"
    },
    "old_text": {
      "description": "Exact text that must occur once; empty creates a new empty/non-empty file.",
      "type": "string"
    },
    "path": {
      "description": "Absolute or process-base-relative target file.",
      "type": "string"
    }
  },
  "required": [
    "path",
    "old_text",
    "new_text"
  ],
  "type": "object"
}

capture_android_screen

确认后保存屏幕 PNG。

描述项	值
工具组	-
默认启用	true
平台要求	android_shell
连接器能力	-
扩展要求	none
风险下限	mutating
调度策略声明	android_ui
生命周期	call

{
  "additionalProperties": false,
  "properties": {
    "path": {
      "type": "string"
    }
  },
  "required": [
    "path"
  ],
  "type": "object"
}

create_chart

校验并呈现已取得数值的柱状/折线/饼图，不采集或证明统计数据。

描述项	值
工具组	-
默认启用	true
平台要求	any
连接器能力	-
扩展要求	none
风险下限	read_only
调度策略声明	parallel
生命周期	call

{
  "$defs": {
    "ChartType": {
      "description": "Supported presentation types.",
      "oneOf": [
        {
          "const": "bar",
          "description": "Horizontal comparison bars.",
          "type": "string"
        },
        {
          "const": "line",
          "description": "Ordered values joined by a line.",
          "type": "string"
        },
        {
          "const": "pie",
          "description": "Parts of a nonzero whole.",
          "type": "string"
        }
      ]
    }
  },
  "additionalProperties": false,
  "properties": {
    "chart_type": {
      "$ref": "#/$defs/ChartType",
      "description": "Chart kind supported by both browser and text fallback."
    },
    "labels": {
      "description": "Category labels in display order.",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "source": {
      "description": "Label describing where the numbers came from.",
      "type": "string"
    },
    "title": {
      "description": "Short heading for the chart.",
      "type": "string"
    },
    "unit": {
      "default": "",
      "description": "Optional unit shown next to values.",
      "type": "string"
    },
    "values": {
      "description": "One value for each label.",
      "items": {
        "format": "double",
        "type": "number"
      },
      "type": "array"
    }
  },
  "required": [
    "chart_type",
    "title",
    "source",
    "labels",
    "values"
  ],
  "type": "object"
}

decompile_apk_class

用已安装的 Android DEX helper 经 app_process 反编译精确单类，需强确认；不下载任何内容，缺少 helper 时先用 jadx_install 确认安装后重试。

描述项	值
工具组	jadx
默认启用	false
平台要求	android
连接器能力	-
扩展要求	jadx
风险下限	dangerous
调度策略声明	sequential
生命周期	call

{
  "additionalProperties": false,
  "properties": {
    "class_name": {
      "description": "Exact dotted class name, such as com.example.MainActivity.",
      "type": "string"
    },
    "path": {
      "description": "Path to an existing local APK file.",
      "type": "string"
    }
  },
  "required": [
    "path",
    "class_name"
  ],
  "type": "object"
}

download_url

下载公网有界资源，确认后原子写入。

描述项	值
工具组	-
默认启用	true
平台要求	any
连接器能力	-
扩展要求	none
风险下限	mutating
调度策略声明	sequential
生命周期	call

{
  "additionalProperties": false,
  "properties": {
    "max_bytes": {
      "default": null,
      "format": "uint",
      "minimum": 0,
      "type": [
        "integer",
        "null"
      ]
    },
    "path": {
      "type": "string"
    },
    "url": {
      "type": "string"
    }
  },
  "required": [
    "url",
    "path"
  ],
  "type": "object"
}

execute_shell_command

本地安全检查与必要确认后执行 shell；background=true 返回进程内托管 child_id，需 read_output 查询实际状态、kill 确认停止；不支持后台 su 提权。

描述项	值
工具组	-
默认启用	true
平台要求	any
连接器能力	-
扩展要求	none
风险下限	dynamic_shell
调度策略声明	shell
生命周期	process

{
  "additionalProperties": false,
  "properties": {
    "background": {
      "default": false,
      "description": "Start a process-owned background capture and return child_id immediately; no PTY or stdin.",
      "type": "boolean"
    },
    "background_timeout_secs": {
      "default": 3600,
      "description": "Background runtime limit in seconds, 1–86400 (default 3600).",
      "format": "uint64",
      "minimum": 0,
      "type": "integer"
    },
    "command": {
      "description": "Shell source to assess locally.",
      "type": "string"
    },
    "interactive": {
      "default": false,
      "description": "Model interaction hint; local detection remains authoritative too.",
      "type": "boolean"
    },
    "reason": {
      "default": "",
      "description": "Model explanation, informational only.",
      "type": "string"
    },
    "requires_root": {
      "default": false,
      "description": "Model privilege hint; never directly authorizes root elevation.",
      "type": "boolean"
    }
  },
  "required": [
    "command"
  ],
  "type": "object"
}

find_class_references

查找类在 DEX 声明和直接指令中的引用；不解析反射、动态或原生调用。

描述项	值
工具组	jadx
默认启用	false
平台要求	any
连接器能力	-
扩展要求	none
风险下限	read_only
调度策略声明	parallel
生命周期	call

{
  "additionalProperties": false,
  "properties": {
    "class_name": {
      "description": "Exact dotted class name to find in declarations and direct bytecode references.",
      "type": "string"
    },
    "limit": {
      "default": 50,
      "description": "Maximum returned references, from 1 to 200.",
      "format": "uint",
      "minimum": 0,
      "type": "integer"
    },
    "path": {
      "description": "Existing local APK path.",
      "type": "string"
    }
  },
  "required": [
    "path",
    "class_name"
  ],
  "type": "object"
}

find_method_references

查找精确类/方法的直接 invoke 引用，可按 DEX 原型区分重载。

描述项	值
工具组	jadx
默认启用	false
平台要求	any
连接器能力	-
扩展要求	none
风险下限	read_only
调度策略声明	parallel
生命周期	call

{
  "additionalProperties": false,
  "properties": {
    "class_name": {
      "description": "Exact dotted owner class.",
      "type": "string"
    },
    "limit": {
      "default": 50,
      "description": "Maximum returned direct invoke references, from 1 to 200.",
      "format": "uint",
      "minimum": 0,
      "type": "integer"
    },
    "method_name": {
      "description": "Exact method name, including <init> or <clinit> when applicable.",
      "type": "string"
    },
    "path": {
      "description": "Existing local APK path.",
      "type": "string"
    },
    "prototype": {
      "default": "",
      "description": "Optional exact DEX prototype, such as (Ljava/lang/String;)V; empty matches overloads.",
      "type": "string"
    }
  },
  "required": [
    "path",
    "class_name",
    "method_name"
  ],
  "type": "object"
}

find_native_libs

列出 lib//*.so 条目和有界 ELF 前缀，不解压或加载代码。

描述项	值
工具组	jadx
默认启用	false
平台要求	any
连接器能力	-
扩展要求	none
风险下限	read_only
调度策略声明	parallel
生命周期	call

{
  "additionalProperties": false,
  "properties": {
    "limit": {
      "default": 50,
      "description": "Maximum returned records, from 1 to 200.",
      "format": "uint",
      "minimum": 0,
      "type": "integer"
    },
    "path": {
      "description": "Existing local APK path. Archive contents are never executed.",
      "type": "string"
    },
    "query": {
      "default": "",
      "description": "Literal substring of a method signature, DEX string or native-library path.",
      "type": "string"
    }
  },
  "required": [
    "path"
  ],
  "type": "object"
}

http_post

确认后发送公网有界 JSON POST。

描述项	值
工具组	-
默认启用	true
平台要求	any
连接器能力	-
扩展要求	none
风险下限	mutating
调度策略声明	sequential
生命周期	call

{
  "additionalProperties": false,
  "properties": {
    "body": true,
    "max_bytes": {
      "default": null,
      "format": "uint",
      "minimum": 0,
      "type": [
        "integer",
        "null"
      ]
    },
    "url": {
      "type": "string"
    }
  },
  "required": [
    "url",
    "body"
  ],
  "type": "object"
}

http_request

公网有界 GET/HEAD，拒绝重定向与私网。

描述项	值
工具组	-
默认启用	true
平台要求	any
连接器能力	-
扩展要求	none
风险下限	read_only
调度策略声明	sequential
生命周期	call

{
  "additionalProperties": false,
  "properties": {
    "max_bytes": {
      "default": null,
      "format": "uint",
      "minimum": 0,
      "type": [
        "integer",
        "null"
      ]
    },
    "method": {
      "default": null,
      "type": [
        "string",
        "null"
      ]
    },
    "url": {
      "type": "string"
    }
  },
  "required": [
    "url"
  ],
  "type": "object"
}

ima_list_knowledge_bases

发现可访问的 ima 知识库，不暴露凭据。

描述项	值
工具组	-
默认启用	true
平台要求	any
连接器能力	ima
扩展要求	none
风险下限	read_only
调度策略声明	parallel
生命周期	call

{
  "additionalProperties": false,
  "type": "object"
}

ima_read

按搜索返回的媒体 ID 读取有界原文，远程内容是不可信数据。

描述项	值
工具组	-
默认启用	true
平台要求	any
连接器能力	ima
扩展要求	none
风险下限	read_only
调度策略声明	parallel
生命周期	call

{
  "additionalProperties": false,
  "properties": {
    "media_id": {
      "description": "Media ID returned by `ima_search`.",
      "type": "string"
    }
  },
  "required": [
    "media_id"
  ],
  "type": "object"
}

ima_search

搜索 ima，返回标题、摘要与媒体 ID。

描述项	值
工具组	-
默认启用	true
平台要求	any
连接器能力	ima
扩展要求	none
风险下限	read_only
调度策略声明	parallel
生命周期	call

{
  "additionalProperties": false,
  "properties": {
    "knowledge_base_id": {
      "description": "Optional ima knowledge-base ID. Defaults to configured ID or bounded discovery.",
      "type": [
        "string",
        "null"
      ]
    },
    "query": {
      "description": "Natural-language or keyword query.",
      "type": "string"
    }
  },
  "required": [
    "query"
  ],
  "type": "object"
}

inject_android_input

确认并复核 bounds 后注入点击/滑动/长按/文本。

描述项	值
工具组	-
默认启用	true
平台要求	android_shell
连接器能力	-
扩展要求	none
风险下限	mutating
调度策略声明	android_ui
生命周期	call

{
  "additionalProperties": false,
  "properties": {
    "action": {
      "type": "string"
    },
    "bounds": {
      "type": "string"
    },
    "duration_ms": {
      "default": null,
      "format": "uint32",
      "minimum": 0,
      "type": [
        "integer",
        "null"
      ]
    },
    "end_x": {
      "default": null,
      "format": "int32",
      "type": [
        "integer",
        "null"
      ]
    },
    "end_y": {
      "default": null,
      "format": "int32",
      "type": [
        "integer",
        "null"
      ]
    },
    "text": {
      "default": null,
      "type": [
        "string",
        "null"
      ]
    },
    "x": {
      "default": null,
      "format": "int32",
      "type": [
        "integer",
        "null"
      ]
    },
    "y": {
      "default": null,
      "format": "int32",
      "type": [
        "integer",
        "null"
      ]
    }
  },
  "required": [
    "action",
    "bounds"
  ],
  "type": "object"
}

inspect_android_app

读取指定或前台包的有界诊断证据。

描述项	值
工具组	-
默认启用	true
平台要求	android
连接器能力	-
扩展要求	none
风险下限	read_only
调度策略声明	sequential
生命周期	call

{
  "additionalProperties": false,
  "properties": {
    "package": {
      "default": null,
      "type": [
        "string",
        "null"
      ]
    }
  },
  "type": "object"
}

inspect_android_environment

只读探测系统、ABI、命令、内存及存储。

描述项	值
工具组	-
默认启用	true
平台要求	android
连接器能力	-
扩展要求	none
风险下限	read_only
调度策略声明	sequential
生命周期	call

{
  "additionalProperties": false,
  "type": "object"
}

inspect_android_ui

读取 UI 树、焦点窗口、显示大小与密度。

描述项	值
工具组	-
默认启用	true
平台要求	android_shell
连接器能力	-
扩展要求	none
风险下限	read_only
调度策略声明	android_ui
生命周期	call

{
  "additionalProperties": false,
  "properties": {
    "full": {
      "default": false,
      "type": "boolean"
    }
  },
  "type": "object"
}

inspect_apk

有界读取 APK 大小、归档条目、DEX、Manifest 与原生 ABI，不执行内容。

描述项	值
工具组	jadx
默认启用	false
平台要求	any
连接器能力	-
扩展要求	none
风险下限	read_only
调度策略声明	parallel
生命周期	call

{
  "additionalProperties": false,
  "properties": {
    "path": {
      "description": "Path to an existing local APK file.",
      "type": "string"
    }
  },
  "required": [
    "path"
  ],
  "type": "object"
}

inspect_manifest

有界解析二进制 Manifest 的包、版本、SDK 和应用属性，资源保持 ID。

描述项	值
工具组	jadx
默认启用	false
平台要求	any
连接器能力	-
扩展要求	none
风险下限	read_only
调度策略声明	parallel
生命周期	call

{
  "additionalProperties": false,
  "properties": {
    "limit": {
      "default": 50,
      "description": "Maximum returned records, from 1 to 200.",
      "format": "uint",
      "minimum": 0,
      "type": "integer"
    },
    "path": {
      "description": "Existing local APK path containing Android binary AndroidManifest.xml.",
      "type": "string"
    }
  },
  "required": [
    "path"
  ],
  "type": "object"
}

inspect_tls

校验公网 TLS 证书链。

描述项	值
工具组	-
默认启用	true
平台要求	any
连接器能力	-
扩展要求	none
风险下限	read_only
调度策略声明	sequential
生命周期	call

{
  "additionalProperties": false,
  "properties": {
    "host": {
      "type": "string"
    },
    "port": {
      "default": null,
      "format": "uint16",
      "maximum": 65535,
      "minimum": 0,
      "type": [
        "integer",
        "null"
      ]
    }
  },
  "required": [
    "host"
  ],
  "type": "object"
}

jadx_check

只读报告 Android DEX helper 的来源、认证方式与安装状态，不下载也不运行 helper。

描述项	值
工具组	jadx
默认启用	false
平台要求	android
连接器能力	-
扩展要求	none
风险下限	read_only
调度策略声明	parallel
生命周期	call

{
  "additionalProperties": false,
  "type": "object"
}

jadx_install

按签名策略、固定 URL 与 SHA-256 下载校验并私有缓存 helper，需确认；仅此工具联网。

描述项	值
工具组	jadx
默认启用	false
平台要求	android
连接器能力	-
扩展要求	none
风险下限	mutating
调度策略声明	sequential
生命周期	call

{
  "additionalProperties": false,
  "type": "object"
}

judge_audio_quality

使用当前任务缓存的真实音频特征判断音质。

描述项	值
工具组	-
默认启用	true
平台要求	any
连接器能力	-
扩展要求	none
风险下限	read_only
调度策略声明	sequential
生命周期	call

{
  "additionalProperties": false,
  "properties": {
    "analysis_path": {
      "default": null,
      "description": "Exact path of a completed analysis cached by the current Agent task.",
      "type": [
        "string",
        "null"
      ]
    },
    "features": {
      "default": null
    },
    "purpose": {
      "default": null,
      "type": [
        "string",
        "null"
      ]
    }
  },
  "type": "object"
}

kill

确认后通过托管 child_id 停止后台 shell 进程组并等待回收；仅接受随机句柄，不杀任意 PID，可重复停止保留的已结束项。

描述项	值
工具组	-
默认启用	true
平台要求	any
连接器能力	-
扩展要求	none
风险下限	mutating
调度策略声明	sequential
生命周期	process

{
  "additionalProperties": false,
  "properties": {
    "child_id": {
      "description": "Opaque managed child_id, never an arbitrary PID.",
      "type": "string"
    }
  },
  "required": [
    "child_id"
  ],
  "type": "object"
}

list_android_apps

有界列出应用包名、APK 路径及 UID。

描述项	值
工具组	-
默认启用	true
平台要求	android
连接器能力	-
扩展要求	none
风险下限	read_only
调度策略声明	sequential
生命周期	call

{
  "additionalProperties": false,
  "properties": {
    "limit": {
      "default": null,
      "format": "uint",
      "minimum": 0,
      "type": [
        "integer",
        "null"
      ]
    },
    "scope": {
      "default": null,
      "type": [
        "string",
        "null"
      ]
    }
  },
  "type": "object"
}

list_apk_entries

按可选字面路径前缀列出有界 ZIP 条目，不解压。

描述项	值
工具组	jadx
默认启用	false
平台要求	any
连接器能力	-
扩展要求	none
风险下限	read_only
调度策略声明	parallel
生命周期	call

{
  "additionalProperties": false,
  "properties": {
    "limit": {
      "default": 50,
      "description": "Maximum returned entries, from 1 to 200.",
      "format": "uint",
      "minimum": 0,
      "type": "integer"
    },
    "path": {
      "description": "Path to an existing local APK file.",
      "type": "string"
    },
    "prefix": {
      "default": "",
      "description": "Optional literal ZIP entry prefix.",
      "type": "string"
    }
  },
  "required": [
    "path"
  ],
  "type": "object"
}

list_channel_targets

只读列出当前配置的渠道已知会话及 Markdown、媒体和按钮能力；不返回凭据或 context_token。

描述项	值
工具组	-
默认启用	true
平台要求	any
连接器能力	-
扩展要求	none
风险下限	read_only
调度策略声明	sequential
生命周期	call

{
  "additionalProperties": false,
  "type": "object"
}

list_dex_classes

读取有界 DEX 类名索引，可按字面类名过滤。

描述项	值
工具组	jadx
默认启用	false
平台要求	any
连接器能力	-
扩展要求	none
风险下限	read_only
调度策略声明	parallel
生命周期	call

{
  "additionalProperties": false,
  "properties": {
    "limit": {
      "default": 50,
      "description": "Maximum returned classes, from 1 to 200.",
      "format": "uint",
      "minimum": 0,
      "type": "integer"
    },
    "path": {
      "description": "Path to an existing local APK file.",
      "type": "string"
    },
    "query": {
      "default": "",
      "description": "Optional literal substring of the dotted class name.",
      "type": "string"
    }
  },
  "required": [
    "path"
  ],
  "type": "object"
}

list_dex_methods

有界索引 DEX 方法、类和原型，包含外部方法引用，无需 JADX。

描述项	值
工具组	jadx
默认启用	false
平台要求	any
连接器能力	-
扩展要求	none
风险下限	read_only
调度策略声明	parallel
生命周期	call

{
  "additionalProperties": false,
  "properties": {
    "limit": {
      "default": 50,
      "description": "Maximum returned records, from 1 to 200.",
      "format": "uint",
      "minimum": 0,
      "type": "integer"
    },
    "path": {
      "description": "Existing local APK path. Archive contents are never executed.",
      "type": "string"
    },
    "query": {
      "default": "",
      "description": "Literal substring of a method signature, DEX string or native-library path.",
      "type": "string"
    }
  },
  "required": [
    "path"
  ],
  "type": "object"
}

list_dir

不依赖 shell 列出有界直接子项。

描述项	值
工具组	-
默认启用	true
平台要求	any
连接器能力	-
扩展要求	none
风险下限	read_only
调度策略声明	parallel
生命周期	call

{
  "additionalProperties": false,
  "properties": {
    "path": {
      "description": "Absolute or process-base-relative directory path, or `.`.",
      "type": "string"
    }
  },
  "required": [
    "path"
  ],
  "type": "object"
}

list_exported_components

列出明确/默认导出的组件及需复核的未知暴露，说明 SDK 默认规则。

描述项	值
工具组	jadx
默认启用	false
平台要求	any
连接器能力	-
扩展要求	none
风险下限	read_only
调度策略声明	parallel
生命周期	call

{
  "additionalProperties": false,
  "properties": {
    "limit": {
      "default": 50,
      "description": "Maximum returned records, from 1 to 200.",
      "format": "uint",
      "minimum": 0,
      "type": "integer"
    },
    "path": {
      "description": "Existing local APK path containing Android binary AndroidManifest.xml.",
      "type": "string"
    }
  },
  "required": [
    "path"
  ],
  "type": "object"
}

list_permissions

列出 Manifest 请求与声明的权限，不推断实际授权或 AppOps。

描述项	值
工具组	jadx
默认启用	false
平台要求	any
连接器能力	-
扩展要求	none
风险下限	read_only
调度策略声明	parallel
生命周期	call

{
  "additionalProperties": false,
  "properties": {
    "limit": {
      "default": 50,
      "description": "Maximum returned records, from 1 to 200.",
      "format": "uint",
      "minimum": 0,
      "type": "integer"
    },
    "path": {
      "description": "Existing local APK path containing Android binary AndroidManifest.xml.",
      "type": "string"
    }
  },
  "required": [
    "path"
  ],
  "type": "object"
}

nl2sh_config

查询 nl2sh 当前配置、默认值及磁盘/任务快照；set/reset 经确认保存，安全/Root/工具/网络/审计修改强确认，凭据只显示配置状态且由用户管理，当前任务不热重载。

描述项	值
工具组	-
默认启用	true
平台要求	any
连接器能力	-
扩展要求	none
风险下限	read_only
调度策略声明	sequential
生命周期	call

{
  "$defs": {
    "Action": {
      "enum": [
        "list",
        "get",
        "set",
        "reset"
      ],
      "type": "string"
    }
  },
  "additionalProperties": false,
  "properties": {
    "action": {
      "$ref": "#/$defs/Action",
      "description": "list/get are read-only; set/reset require confirmation."
    },
    "key": {
      "default": null,
      "description": "Exact configuration key; required except for list. Supports tool_groups.jadx and tool_overrides.tailcat_check.",
      "type": [
        "string",
        "null"
      ]
    },
    "value": {
      "default": null,
      "description": "Native JSON value for set (boolean, number, string, array or object). Use reset to remove an override; null is not a set value."
    }
  },
  "required": [
    "action"
  ],
  "type": "object"
}

read_file

有界 UTF-8 文件读取，支持绝对/父目录/符号链接。

描述项	值
工具组	-
默认启用	true
平台要求	any
连接器能力	-
扩展要求	none
风险下限	read_only
调度策略声明	parallel
生命周期	call

{
  "additionalProperties": false,
  "properties": {
    "path": {
      "description": "Absolute or process-base-relative file path.",
      "type": "string"
    }
  },
  "required": [
    "path"
  ],
  "type": "object"
}

read_output

按托管 child_id 与独立 stdout/stderr 字节偏移读取有界输出和实际退出状态；检查 next_offset、truncated、finished 与 error，不接管其他进程或配置。

描述项	值
工具组	-
默认启用	true
平台要求	any
连接器能力	-
扩展要求	none
风险下限	read_only
调度策略声明	parallel
生命周期	process

{
  "additionalProperties": false,
  "properties": {
    "child_id": {
      "description": "Opaque child_id returned by a successful background start, not a PID.",
      "type": "string"
    },
    "max_bytes": {
      "default": 1024,
      "description": "Maximum raw bytes per stream, 1–16384 (default 1024).",
      "format": "uint",
      "minimum": 0,
      "type": "integer"
    },
    "offset": {
      "default": 0,
      "description": "Raw stdout byte offset; follow stdout.next_offset.",
      "format": "uint64",
      "minimum": 0,
      "type": "integer"
    },
    "stderr_offset": {
      "default": 0,
      "description": "Raw stderr byte offset; follow stderr.next_offset independently.",
      "format": "uint64",
      "minimum": 0,
      "type": "integer"
    }
  },
  "required": [
    "child_id"
  ],
  "type": "object"
}

search_dex_strings

按非空字面子串搜索 DEX 字符串，解码修改版 UTF-8。

描述项	值
工具组	jadx
默认启用	false
平台要求	any
连接器能力	-
扩展要求	none
风险下限	read_only
调度策略声明	parallel
生命周期	call

{
  "additionalProperties": false,
  "properties": {
    "limit": {
      "default": 50,
      "description": "Maximum returned records, from 1 to 200.",
      "format": "uint",
      "minimum": 0,
      "type": "integer"
    },
    "path": {
      "description": "Existing local APK path. Archive contents are never executed.",
      "type": "string"
    },
    "query": {
      "default": "",
      "description": "Literal substring of a method signature, DEX string or native-library path.",
      "type": "string"
    }
  },
  "required": [
    "path"
  ],
  "type": "object"
}

search_text

有界递归字面文本搜索，跟随符号链接并检测循环，无工作区限制。

描述项	值
工具组	-
默认启用	true
平台要求	any
连接器能力	-
扩展要求	none
风险下限	read_only
调度策略声明	parallel
生命周期	call

{
  "additionalProperties": false,
  "properties": {
    "path": {
      "default": ".",
      "description": "Absolute or process-base-relative file or directory path.",
      "type": "string"
    },
    "query": {
      "description": "Literal text to search for.",
      "type": "string"
    }
  },
  "required": [
    "query"
  ],
  "type": "object"
}

send_channel_file

审批后向原渠道会话或已发现目标发送本地路径/当前任务附件的图片、音频、视频或文件；发送前固定字节与摘要。

描述项	值
工具组	-
默认启用	true
平台要求	any
连接器能力	-
扩展要求	none
风险下限	mutating
调度策略声明	sequential
生命周期	call

{
  "additionalProperties": false,
  "properties": {
    "attachment_id": {
      "default": null,
      "description": "Opaque ID returned by a tool in this channel task, such as android.screenshot without a path.",
      "type": [
        "string",
        "null"
      ]
    },
    "caption": {
      "default": "",
      "description": "Optional accompanying text (maximum 1000 UTF-8 bytes).",
      "type": "string"
    },
    "kind": {
      "default": "auto",
      "description": "auto, image, audio, video, or file; file preserves arbitrary binary formats.",
      "type": "string"
    },
    "path": {
      "default": null,
      "description": "Existing local file. Provide exactly one of path or attachment_id; no URL is accepted.",
      "type": [
        "string",
        "null"
      ]
    },
    "target": {
      "default": null,
      "description": "Opaque ID from list_channel_targets; omit only in a channel conversation.",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "type": "object"
}

send_channel_message

统一发送文本、Markdown、图片、音频、视频、文件及 QQ 指令按钮；支持原会话或已发现目标，所有发送保留调用入口的审批策略。

描述项	值
工具组	-
默认启用	true
平台要求	any
连接器能力	-
扩展要求	none
风险下限	mutating
调度策略声明	sequential
生命周期	call

{
  "$defs": {
    "Kind": {
      "enum": [
        "text",
        "markdown",
        "image",
        "audio",
        "video",
        "file",
        "auto"
      ],
      "type": "string"
    },
    "MessageButton": {
      "additionalProperties": false,
      "description": "A native command button. Clicking inserts/sends this command through normal intake.",
      "properties": {
        "command": {
          "description": "Text inserted in the conversation, at most 256 bytes.",
          "type": "string"
        },
        "label": {
          "description": "Visible label, at most ten characters.",
          "type": "string"
        }
      },
      "required": [
        "label",
        "command"
      ],
      "type": "object"
    }
  },
  "additionalProperties": false,
  "properties": {
    "attachment_id": {
      "default": null,
      "description": "Reference produced in this channel Agent task; never reusable across MCP calls or tasks.",
      "type": [
        "string",
        "null"
      ]
    },
    "buttons": {
      "default": [],
      "description": "QQ native command buttons; not available in WeChat or media messages.",
      "items": {
        "$ref": "#/$defs/MessageButton"
      },
      "type": "array"
    },
    "kind": {
      "$ref": "#/$defs/Kind",
      "description": "text/markdown use text; image/audio/video/file/auto use exactly one path or attachment_id."
    },
    "path": {
      "default": null,
      "description": "Local regular file; remote URLs are not accepted.",
      "type": [
        "string",
        "null"
      ]
    },
    "target": {
      "default": null,
      "description": "Opaque ID from list_channel_targets; omit only to reply to the originating channel.",
      "type": [
        "string",
        "null"
      ]
    },
    "text": {
      "default": "",
      "description": "Message body, or optional media caption (maximum 1000 bytes for media).",
      "type": "string"
    }
  },
  "required": [
    "kind"
  ],
  "type": "object"
}

session_list

只读分页列出当前配置下已保存的 TUI、Web 与协议会话 ID、标题和时间；不包含未保存的实时状态或共享审计日志。按稳定 ID 排序，使用 next_offset 续查。

描述项	值
工具组	-
默认启用	true
平台要求	any
连接器能力	-
扩展要求	none
风险下限	read_only
调度策略声明	parallel
生命周期	call

{
  "additionalProperties": false,
  "properties": {
    "limit": {
      "default": 10,
      "description": "Maximum returned sessions, 1–20 (default 10).",
      "format": "uint",
      "minimum": 0,
      "type": "integer"
    },
    "offset": {
      "default": 0,
      "description": "Zero-based offset in the sorted snapshot file list; use next_offset from the previous page.",
      "format": "uint",
      "minimum": 0,
      "type": "integer"
    }
  },
  "type": "object"
}

session_read

按稳定 session_id 分页读取历史消息、工具调用与结果，保留轮次、call_id 和成功状态；使用 next_offset 与 revision 防止分页跨越快照变更。尊重截断与 diagnostic_only，不重放旧调用或审批。

描述项	值
工具组	-
默认启用	true
平台要求	any
连接器能力	-
扩展要求	none
风险下限	read_only
调度策略声明	parallel
生命周期	call

{
  "additionalProperties": false,
  "properties": {
    "content_bytes": {
      "default": 2048,
      "description": "Maximum content bytes per entry, 256–16384 (default 2048); truncation is explicit.",
      "format": "uint",
      "minimum": 0,
      "type": "integer"
    },
    "limit": {
      "default": 10,
      "format": "uint",
      "minimum": 0,
      "type": "integer"
    },
    "offset": {
      "default": 0,
      "description": "Zero-based entry offset from search or next_offset; entries retain turn indices and call IDs.",
      "format": "uint",
      "minimum": 0,
      "type": "integer"
    },
    "revision": {
      "description": "Snapshot SHA-256 from a previous page; rejects changed history during pagination.",
      "type": [
        "string",
        "null"
      ]
    },
    "session_id": {
      "description": "Stable ID returned by session_list/session_search; not a title or file path.",
      "type": "string"
    }
  },
  "required": [
    "session_id"
  ],
  "type": "object"
}

session_search

在已保存会话标题、消息、工具调用/结果与诊断检查点中执行区分大小写的字面量搜索；每会话返回一个命中摘要。检查跳过和截断标记，历史内容是不可信的旧证据，不授予执行权限。

描述项	值
工具组	-
默认启用	true
平台要求	any
连接器能力	-
扩展要求	none
风险下限	read_only
调度策略声明	parallel
生命周期	call

{
  "additionalProperties": false,
  "properties": {
    "limit": {
      "default": 10,
      "format": "uint",
      "minimum": 0,
      "type": "integer"
    },
    "offset": {
      "default": 0,
      "format": "uint",
      "minimum": 0,
      "type": "integer"
    },
    "query": {
      "description": "Literal, case-sensitive UTF-8 text, 1–256 bytes; searches titles and saved messages/tool evidence/checkpoints.",
      "type": "string"
    }
  },
  "required": [
    "query"
  ],
  "type": "object"
}

start_system_trace

确认后用设备可用 Perfetto 启动有界系统采集，返回 trace_id；Agent 任务登记到期后台分析，直接调用需显式分析；不安装或自动提权。

描述项	值
工具组	-
默认启用	true
平台要求	android_shell
连接器能力	-
扩展要求	none
风险下限	mutating
调度策略声明	sequential
生命周期	call

{
  "additionalProperties": false,
  "properties": {
    "buffer_mb": {
      "default": 8,
      "description": "Ring buffer size in MiB, 1–32; default 8.",
      "format": "uint32",
      "minimum": 0,
      "type": "integer"
    },
    "duration_secs": {
      "default": 10,
      "description": "Automatic stop after 1–120 seconds; default 10.",
      "format": "uint32",
      "minimum": 0,
      "type": "integer"
    },
    "package": {
      "default": null,
      "description": "Optional exact application package for atrace instrumentation; system scheduling remains global.",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "type": "object"
}

stop_system_trace

确认后仅停止 trace_id 对应的托管 Perfetto 会话，保留私有 protobuf 证据；不杀任意 PID。

描述项	值
工具组	-
默认启用	true
平台要求	android_shell
连接器能力	-
扩展要求	none
风险下限	mutating
调度策略声明	sequential
生命周期	call

{
  "additionalProperties": false,
  "properties": {
    "trace_id": {
      "description": "Opaque ID returned by start_system_trace.",
      "type": "string"
    }
  },
  "required": [
    "trace_id"
  ],
  "type": "object"
}

tailcat_adb_pair

Android 11+ 无线 ADB 配对引导：setup 打开设置并尝试进入配对界面；share 强确认后共享当前配对/连接及可选 Web 端口，返回配对码与对端命令。需 shell/root；不自动配对远端，不替换已有监听器。

描述项	值
工具组	tailcat
默认启用	false
平台要求	android_shell
连接器能力	-
扩展要求	none
风险下限	dangerous
调度策略声明	android_ui
生命周期	process

{
  "$defs": {
    "Action": {
      "enum": [
        "setup",
        "share"
      ],
      "type": "string"
    }
  },
  "additionalProperties": false,
  "properties": {
    "action": {
      "$ref": "#/$defs/Action",
      "description": "setup opens Settings and the pairing dialog; share approves current ports and starts Tailcat."
    },
    "local_connect_port": {
      "default": 13702,
      "description": "Peer-local ADB connection listener used in the generated command. Default 13702.",
      "format": "uint16",
      "maximum": 65535,
      "minimum": 0,
      "type": "integer"
    },
    "local_pair_port": {
      "default": 13701,
      "description": "Peer-local pairing listener used in the generated command. Default 13701.",
      "format": "uint16",
      "maximum": 65535,
      "minimum": 0,
      "type": "integer"
    },
    "local_web_port": {
      "default": 19999,
      "description": "Peer-local optional Web listener used in the generated command. Default 19999.",
      "format": "uint16",
      "maximum": 65535,
      "minimum": 0,
      "type": "integer"
    },
    "web_port": {
      "default": null,
      "description": "Optional existing localhost Web service to share as well, e.g. 9999. Omitted by default.",
      "format": "uint16",
      "maximum": 65535,
      "minimum": 0,
      "type": [
        "integer",
        "null"
      ]
    }
  },
  "required": [
    "action"
  ],
  "type": "object"
}

tailcat_check

检查已配置程序及版本，不下载。

描述项	值
工具组	tailcat
默认启用	false
平台要求	any
连接器能力	-
扩展要求	none
风险下限	read_only
调度策略声明	parallel
生命周期	call

{
  "additionalProperties": false,
  "type": "object"
}

tailcat_install

校验摘要、ABI 与版本后原子安装固定官方版本，需确认。

描述项	值
工具组	tailcat
默认启用	false
平台要求	android_or_linux
连接器能力	-
扩展要求	none
风险下限	mutating
调度策略声明	sequential
生命周期	call

{
  "additionalProperties": false,
  "type": "object"
}

tailcat_receive

在现有目录启动受管文件接收箱，需确认。

描述项	值
工具组	tailcat
默认启用	false
平台要求	any
连接器能力	-
扩展要求	tailcat
风险下限	mutating
调度策略声明	sequential
生命周期	process

{
  "additionalProperties": false,
  "properties": {
    "directory": {
      "type": "string"
    }
  },
  "required": [
    "directory"
  ],
  "type": "object"
}

tailcat_receive_stream

启动一次原始流接收并保存新文件，需确认。

描述项	值
工具组	tailcat
默认启用	false
平台要求	any
连接器能力	-
扩展要求	tailcat
风险下限	mutating
调度策略声明	sequential
生命周期	process

{
  "additionalProperties": false,
  "properties": {
    "path": {
      "type": "string"
    }
  },
  "required": [
    "path"
  ],
  "type": "object"
}

tailcat_send_file

发送现有文件；默认 stream 用于原始接收，显式 copy 需外部 scp，强确认。

描述项	值
工具组	tailcat
默认启用	false
平台要求	any
连接器能力	-
扩展要求	tailcat
风险下限	dangerous
调度策略声明	sequential
生命周期	call

{
  "$defs": {
    "SendMode": {
      "enum": [
        "stream",
        "copy"
      ],
      "type": "string"
    }
  },
  "additionalProperties": false,
  "properties": {
    "address": {
      "type": "string"
    },
    "mode": {
      "$ref": "#/$defs/SendMode"
    },
    "path": {
      "type": "string"
    }
  },
  "required": [
    "path",
    "address"
  ],
  "type": "object"
}

tailcat_serve

把 Tailcat 连接转发到已有 localhost TCP 服务（additional_ports 可增加共享端口）；参数是目标端口，不重复绑定，无需停止服务；缺少程序时先确认安装，共享需强确认。

描述项	值
工具组	tailcat
默认启用	false
平台要求	any
连接器能力	-
扩展要求	tailcat
风险下限	dangerous
调度策略声明	sequential
生命周期	process

{
  "additionalProperties": false,
  "properties": {
    "additional_ports": {
      "default": [],
      "description": "Additional existing localhost TCP service ports to share through the same listener.",
      "items": {
        "format": "uint16",
        "maximum": 65535,
        "minimum": 0,
        "type": "integer"
      },
      "type": "array"
    },
    "port": {
      "description": "Destination port of an existing localhost TCP service; keep that service running.",
      "format": "uint16",
      "maximum": 65535,
      "minimum": 0,
      "type": "integer"
    }
  },
  "required": [
    "port"
  ],
  "type": "object"
}

tailcat_status

读取当前进程的受管监听器状态。

描述项	值
工具组	tailcat
默认启用	false
平台要求	any
连接器能力	-
扩展要求	none
风险下限	read_only
调度策略声明	parallel
生命周期	process

{
  "additionalProperties": false,
  "type": "object"
}

tailcat_stop

确认后停止当前进程监听器。

描述项	值
工具组	tailcat
默认启用	false
平台要求	any
连接器能力	-
扩展要求	none
风险下限	mutating
调度策略声明	sequential
生命周期	process

{
  "additionalProperties": false,
  "type": "object"
}

top_android_apps

按驻留内存排序有界进程快照。

描述项	值
工具组	-
默认启用	true
平台要求	android
连接器能力	-
扩展要求	none
风险下限	read_only
调度策略声明	sequential
生命周期	call

{
  "additionalProperties": false,
  "properties": {
    "limit": {
      "default": null,
      "format": "uint",
      "minimum": 0,
      "type": [
        "integer",
        "null"
      ]
    }
  },
  "type": "object"
}

view_screenshot

为下次模型请求附加 PNG/JPEG/WebP，有界缩放。

描述项	值
工具组	-
默认启用	true
平台要求	any
连接器能力	-
扩展要求	none
风险下限	read_only
调度策略声明	parallel
生命周期	call

{
  "additionalProperties": false,
  "properties": {
    "path": {
      "type": "string"
    }
  },
  "required": [
    "path"
  ],
  "type": "object"
}