DeepSeek Harness (DSH) adopts a plugin-based architecture, which makes system extension flexible. When handling Android devices, if an agent needs to operate the device directly, a connection must be established through the ADB protocol. dsh-adb-ultimate is a plugin designed for this scenario, integrating complete ADB device management capabilities into DSH.

Plugin Positioning

The plugin is maintained and belongs to the “Workflow” category. Its core role is to enable DeepSeek Harness to directly control Android devices, supporting screen monitoring, performance data reading, and app/file operations.

Core Features

The plugin embeds a complete device management panel in the DSH interface, mainly including the following capabilities:

  • Device Panel

    • Screen Monitoring: Supports real-time screen viewing, with a refresh interval of 1 second.
    • Performance Monitoring: Displays memory (RAM), CPU, and battery status (level, temperature, health) in real time.
    • Device Information: Displays basic information such as device model, Android version, and serial number.
    • App Management: Supports browsing and searching apps, and viewing app details (version, permissions).
    • Log Viewing: Outputs Logcat logs in real time, with filtering by V/D/I/W/E levels.

  • Device Connection

    • Supports direct WiFi connection and pairing verification.
    • Records connection history for quick reconnection.
    • Supports managing multiple devices simultaneously.

  • Device Control

    • Supports operations such as screenshots, turning the screen on/off, tapping, swiping, and text input.
    • Supports app installation, uninstallation, launching, and force stopping.
    • Supports file pushing and pulling.

  • System Debugging

    • Supports querying system commands such as Logcat output, Dumpsys, and Getprop.
    • Supports direct execution of Shell commands.

Installation and Enablement

Before installing, ensure your environment meets the following dependency requirements:
* Node.js >= 18.0.0
* @deepseek-ai/cordis >= 3.0.0

Use the following command to install the plugin:

dsh plugin --profile web add github:newborne/dsh-adb-ultimate

Typical Usage

  1. Connect Device: First, enable WiFi ADB debugging on the Android device, then connect to the device’s IP address using the panel provided by the plugin.
  2. Real-Time Monitoring: After a successful connection, the device panel automatically refreshes the screen view (1-second interval) and performance data.
  3. Agent Operation: You can use natural language instructions to have the Agent help you install the plugin, for example: “Help me install this plugin: https://github.com/newborne/dsh-adb-ultimate”.
  4. App Management: Browse installed apps in the Apps tab of the panel, or install/uninstall apps through commands.

Applicable Scenarios and Notes

This plugin is suitable for developers, testers, and technology enthusiasts who need to control or monitor Android devices with AI.

Security Note: The plugin runs with the privileges of the current DSH process. Before installing third-party plugins, it is recommended to check their source code and license (MIT).