mang0cola/adb_dsh_plugin

README 摘要

adb-dsh-plugin adb-dsh-plugin 将本机已有的 Android Debug Bridge（ADB）注册为 DeepSeek Harness 模型工具。插件不启动额外的代理服务，也不在宿主机 shell 中拼接命令；所有 ADB 进程都通过 Harness 的 ctx.subprocess 服务启动，并继承工具调用的取消和超时信号。 能力 工具 能力 adb devices 列出设备、连接状态、型号和 transport id adb device info 获取 Android 版本、SDK、ABI、屏幕及电池信息 adb packages 结构化列出应用，可按系统/第三方、启用状态和用户筛选，并返回 APK 路径、版本码、安装来源及 UID adb system services 列出 Binder 服务及支持 dumpsys 的系统服务 adb service dump 读取单个系统服务的有界 dumpsys 状态快照 adb app info 获取应用版本、APK 路径、权限状态及 activity/service/receiver/provider 组件 adb screenshot 截屏并通过 Harness 附件服务把 PNG 交给支持图片输入的模型 adb ui hierarchy 获取包含文本、resource id、可点击状态和 bounds 的 UI XML； uiautomator 不可用时自动读取可见窗口 View 数据；文本模型也可使用 adb input 点击、滑动、安全 ASCII 文本输入及 keyevent adb app 列出、安装、启动、停止、清理及卸载应用 adb file 在会话工作区与设备之间 push/pull 文件或目录 adb logcat 获取有行数和字节上限的 logcat 快照 adb shell 执行任意设备侧 shell 命令；默认不注册，需要显式启用 未传 serial 时，插件依次使用 defaultSerial 或唯一一个在线且允许的设备。连接多个在线设备时，模型必须明确传入 serial。 本机开发运行 要求与当前 DeepSeek Harness 0.1.0-rc.5 相同：Node.js ^22.19.0 =24 、pnpm，以及 PATH 中可用的 adb 。 在插件目录安装依赖、检查并构建： 已连接并授权一台测试设备时，还可以运行不调用外部模型的本地真机功能测试： 它会测试设备发现、设备信息、UI 层级、截图、无副作用按键码、结构化应用信息、权限与四大组件、系统服务、日志，以及一次位于 /data/local/tmp/adb dsh plugin function test.txt 的文件 push/pull 往返；测试结束会自动清理宿主机和设备上的临时文件…

分类