Skip to content
Skills Library
Personal productivity · Tool integration

android-capabilities

/android-capabilities

通过 KNHPlus MCP 使用 Android 专属能力(无障碍 UI 自动化、手势、系统截图、窗口/前台应用、通知栏按钮、媒体会话、全局导航、设备状态、TTS)。当任务需要在手机上操作其他 App、读取手机状态或做截图时使用。

Licence
Apache-2.0
Last repository change
12.11.2026

Assessment and security

90/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content25 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
1
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 12.11.2026, without references to retired models or APIs.

Licence

Apache-2.0, otwarta: można używać i zmieniać, z zachowaniem licencji i informacji o zmianach.

What it does and when to use it

通过 KNHPlus MCP 使用 Android 专属能力(无障碍 UI 自动化、手势、系统截图、窗口/前台应用、通知栏按钮、媒体会话、全局导航、设备状态、TTS)。当任务需要在手机上操作其他 App、读取手机状态或做截图时使用。

Original author description

通过 KNHPlus MCP 使用 Android 专属能力(无障碍 UI 自动化、手势、系统截图、窗口/前台应用、通知栏按钮、媒体会话、全局导航、设备状态、TTS)。当任务需要在手机上操作其他 App、读取手机状态或做截图时使用。

How it works

  1. 工具速查
  2. 使用要点
  3. 权限分级(重要)
  4. 限制
Original SKILL.md headings · 67 lines, 406 words
SKILL.md preview
---
name: android-capabilities
description: 通过 KNHPlus MCP 使用 Android 专属能力(无障碍 UI 自动化、手势、系统截图、窗口/前台应用、通知栏按钮、媒体会话、全局导航、设备状态、TTS)。当任务需要在手机上操作其他 App、读取手机状态或做截图时使用。
whenToUse: 需要跨 App 点击/输入/滚动手势、查找并等待界面元素、读取通知或媒体会话、控制音量亮度、让手机朗读/振动、截图或读设备状态时。
---

# KNHPlus 安卓专属能力

KNHPlus 是内置 MCP 服务(`knhplus`),工具以 `android_*` 命名。全部能力不需要 Root;个别能力需要额外系统授权。

## 工具速查

| 工具 | 作用 | 前置条件 |
|---|---|---|
| `android_screenshot` | 返回当前屏幕 PNG | Android 11+ 用无障碍;低于 11 走 MediaProjection 授权截图 |
| `android_ui` | 界面节点树(文字/id/bounds/状态),`limit` 控制数量 | 无障碍 |
| `android_find` | 按文字/id/desc/class/状态查找元素,返回索引与坐标 | 无障碍 |
| `android_click` | 按文字/id/desc 或坐标点击,`duration>=400` 长按 | 无障碍 |
| `android_gesture` | tap / longpress / swipe / drag / pinch 双指缩放 / two_finger | 无障碍 |
| `android_set_text` | 向输入框写文字并**回读校验**;清空用 `text=""` 或 `clear=true`(可指定 id/desc) | 无障碍 |
| `android_node_action` | click、long_click、focus、set_text、scroll、expand/collapse、select、copy/cut/paste、dismiss、toggle_check | 无障碍 |
| `android_wait_for` | 轮询等待元素出现(默认 10s,最多 15s) | 无障碍 |
| `android_scroll` | 滚动,支持连续次数 | 无障碍 |
| `android_global` | back/home/recents/notifications/quicksettings/power/lock/screenshot | 无障碍(锁屏 9+、截屏 11+;低版本截图用 android_screenshot) |
| `android_foreground` | 当前前台应用、类名、停留时长(**可能返回 IME 窗口**;聚焦应用用 `android_windows`) | 无障碍 |
| `android_windows` | 所有交互窗口(类型/层级/bounds/包名) | 无障碍 |
| `android_open` | 打开应用包或 URL | 无 |
| `android_open_settings` | 直达 wifi/蓝牙/电池/显示/无障碍/通知/usage/app/write_settings 等面板 | 无 |
| `android_notifications` | 通知标题/正文/按钮列表/key | 通知使用权 |
| `android_notification_action` | 点击通知按钮(回复、标记已读等) | 通知使用权 |
| `android_dismiss_notification` | 按 key 清除单条通知 | 通知使用权 |
| `android_dismiss_notifications` | 清除可清除通知 | 通知使用权 |
| `android_status` | 电量、亮屏、音量、亮度、权限、前台应用 | 无 |
| `android_policy` | 查看九项手机能力的 allow / ask / deny(只读) | 修改需在 App 设置页 |
| `android_device` | 型号/系统/ABI/语言时区/电量温度/内存/存储/网络/开机时长 | 无 |
| `android_screen` | 分辨率、密度、刷新率、旋转、锁屏、亮度 | 无 |
| `android_media` | 媒体键(播放/暂停/上下首/停止) | 无 |
| `android_media_session` | 列出媒体会话(应用/标题/歌手/状态)并可 play/pause/next/prev/stop/seek | 通知使用权 |
| `android_volume` | 音量百分比、按格加减、静音 | 无 |
| `android_brightness` | 设置屏幕亮度 | “修改系统设置” |
| `android_speak` / `android_tts_stop` | 系统 TTS 朗读 / 停止 | 无 |
| `android_toast` | 弹出系统 Toast 反馈 | 无 |
| `android_apps` | 列出可启动应用,可按关键词过滤 | 无 |
| `android_clipboard` | 读写剪贴板 | 后台读取可能为空 |
| `android_vibrate` | 振动毫秒或节奏 | 无 |

## 使用要点

- 陌生界面先 `android_ui` 或截图,再 `android_find` 精确定位;能用 id 就不用文字。
- 跨应用流程:`android_open` → `android_wait_for` → `android_node_action`/`android_click`。
- 系统导航优先 `android_global`;坐标直接取节点 `bounds` 中心。
- `android_set_text` 写入后会回读节点树:能读到就 `verified:true`;**WebView 输入框的 `text` 常恒空,此时返回 `ok:true` + `verified:false` + `reason`(这不是失败,不要重试)**,以截图 / 节点结构变化为准。清空输入框用 `text=""` 或 `clear=true`。`android_foreground` 可能拿到 IME 窗口,取聚焦应用请用 `android_windows`。
- 通知/媒体会话未授权时,用 `android_open_settings panel=notification_listener` 直达系统「通知使用权」并勾选 KHA。
- 不要在没有明确指令时锁屏、清通知、打开未知链接或点击有副作用的按钮。

## 权限分级(重要)

- 权限由用户在 App「设置 → 手机权限」按能力配置,每项三档:`allow`(直接执行)、`ask`(每次确认)、`deny`(禁止)。
- 九项能力:读取屏幕、截图、点击与输入、打开应用与系统操作、读取通知、通知操作、媒体与音量亮度、剪贴板、语音与振动。
- 默认:读类为 `allow`,操作类为 `ask`。用户可以随时修改,改完立即生效。
- `ask` 会弹出原生确认框;用户拒绝或 45 秒未确认则本次操作取消。不要自动重试,除非用户明确要求。
- `deny` 表示用户关闭了该能力,工具会直接返回“权限已关闭”。不要尝试换工具或拆分步骤绕过。
- 模型不能修改授权;`android_policy` 只读,用于查看当前各项权限。不要在对话里要求用户提升权限,除非用户主动问。

## 限制

- `android_screenshot`:Android 11+ 走无障碍;低于 11 走 MediaProjection(**首次弹一次系统授权框,允许后同一 App 会话内复用、不再弹框**,直接返回图像,不落盘)。`android_global` 的 `screenshot` 仅 Android 11+,低版本请用 `android_screenshot`。`FLAG_SECURE` 窗口会截成黑屏(系统行为)。`android_status.screenshotSupported` 恒为 true(SDK<30 由 MediaProjection 支撑)。锁屏全局动作仅 Android 9+。
- 无障碍/通知使用权必须用户在系统设置手动开启。
- Android 10+ 后台读剪贴板可能为空。
- 自绘控件可能不暴露可编辑/可点击节点;此时改用坐标手势。
- 亮度需要 WRITE_SETTINGS;Root/Shizuku 特权 shell 不在此 MCP 内。

Versions

The database has no other skills named android-capabilities.

Database snapshot: 13.11.2026 · package version 1bfcdbc456ce (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 86control
    Control an authorized local Android phone or show its real-time read-only video beside the current local Codex task on macOS. Use for phone app tasks and Android UI checks.
  • 95agent-voice-mobile-bridge
    Drive an Android phone (running WakeHermesClaw for Android) through its opt-in Mobile Bridge HTTP API. Use whenever Hermes needs to list installed apps, read the clipboard, fetch device info, or otherwise reach Android capabilities the user has explicitly enabled.
  • 90phone-use
    Use OpenPocket MCP tools to inspect or control an Android emulator, physical Android phone, Android TV, or ADB-backed app. Trigger for phone use, Android automation, mobile UI testing, emulator control, physical-device control, app navigation, screenshots, tapping, typing, and…
  • 93android-inceptor
    See and drive an Android emulator/device (MuMu, LDPlayer, Nox, MEmu, BlueStacks, phone over ADB) through the android-inceptor MCP tools — screenshot, read the UI tree, find elements by text/resource-id/desc/XPath, tap, swipe, scroll, type, press keys, wait for elements,…
  • 95pinky
    Operate the person's real iPhone or Android phone through Pinky's phone_* MCP tools, with the person watching, approving risky steps and able to take over. Use it for any task on their phone.
  • 95phone-control
    Read and drive a real Android phone screen - UI tree as text with real coordinates, tap by visible label, swipe, press keys, type, screenshot, and report whether the screen actually changed. Use when a task needs the phone screen read, changed or verified (open an app, find and…

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.