DeepSeek Harness（DSH）采用插件化架构，这使得扩展系统功能变得灵活。在处理 Android 设备时，若要通过智能体直接操作设备，需要通过 ADB 协议建立连接。dsh-adb-ultimate 正是为这一场景设计的插件，它将完整的 ADB 设备管理能力集成到 DSH 中。
插件定位¶
该插件由维护，属于「工作流」类别。它的核心作用是让 DeepSeek Harness 能够直接控制 Android 设备，实现屏幕监控、性能数据读取以及应用和文件的操作。
核心功能¶
插件在 DSH 界面中嵌入了一个完整的设备管理面板，主要包含以下能力：
-
设备面板
- 屏幕监控：支持实时屏幕查看，刷新间隔为 1 秒。
- 性能监控：实时显示内存（RAM）、CPU、电池状态（电量、温度、健康度）。
- 设备信息：展示设备型号、Android 版本、序列号等基础信息。
- 应用管理：支持浏览、搜索应用，查看应用详情（版本、权限）。
- 日志查看：实时输出 Logcat 日志，支持 V/D/I/W/E 级别过滤。
-
设备连接
- 支持 WiFi 直连及配对验证。
- 记录连接历史，方便快速重连。
- 支持同时管理多台设备。
-
设备控制
- 支持截图、开关屏幕、点击、滑动、文本输入等手势操作。
- 支持应用安装、卸载、启动、强制停止。
- 支持文件推送与拉取。
-
系统调试
- 支持 Logcat 输出、Dumpsys、Getprop 等系统命令查询。
- 支持直接执行 Shell 命令。
安装与启用¶
在安装前，请确保环境满足以下依赖要求：
* Node.js >= 18.0.0
* @deepseek-ai/cordis >= 3.0.0
使用以下命令安装插件：
dsh plugin --profile web add github:newborne/dsh-adb-ultimate
典型用法¶
- 连接设备：首先在 Android 设备上开启 WiFi ADB 调试，然后通过插件提供的面板连接设备 IP 地址。
- 实时监控：连接成功后，设备面板会自动刷新屏幕画面（1秒间隔）和性能数据。
- Agent 操作：你可以通过自然语言指令让 Agent 帮你安装该插件，例如：“Help me install this plugin: https://github.com/newborne/dsh-adb-ultimate”。
- 应用管理：在面板的 Apps 标签页中浏览已安装应用，或通过指令安装、卸载应用。
适用场景与注意¶
该插件适合需要通过 AI 控制或监控 Android 设备的开发者、测试人员以及技术爱好者。
安全提示：插件以当前 DSH 进程的权限运行。在安装第三方插件前，建议检查其源码和许可证（MIT）。
