Skip to content
dsh-go: Running DeepSeek Harness on Android Without Root — An 8-Day, 5.3k-Star Analysis
Mobile Development 16 min read

dsh-go: Running DeepSeek Harness on Android Without Root — An 8-Day, 5.3k-Star Analysis

The dsh-go project ports DeepSeek's official Agent engine (DSH) to Android using proot to run Ubuntu 24.04 and Node.js 24 locally without root, adding phone control via accessibility services and remote desktop-style access to PC-hosted DSH instances, all in a 196 MB APK requiring ~1 GB storage.

Geek Labs
Geek Labs
Geek Labs

Project Overview

GitHub project ccch1mneyyy/dsh-go (Flutter + Kotlin, AGPL-3.0) reached 5,390 stars in 8 days after its October 25 creation. It ports DeepSeek Harness (DSH) — DeepSeek's official open-source Agent engine that normally runs as a web UI on a computer — to Android phones. The APK is 196 MB; the installed runtime consumes ~1 GB (including a 241 MB offline voice model). Minimum Android 8.0, arm64 only; devices with <4 GB RAM may struggle.

Three Core Capabilities

Local Engine Execution : The app bundles an Ubuntu 24.04 rootfs and Node.js 24, then runs the DSH engine inside proot — a non-root Linux syscall emulator. This lets Ubuntu believe it's on a normal Linux box while staying inside Android's sandbox. The app sets targetSdk=28 (like Termux) because Android 10+ forbids executing files in an app's private directory, which proot requires.

Phone Self-Control : After granting Accessibility permission, DSH can read screen elements, tap, and type. Foreground operations use the Accessibility service directly. Background operations (Android 14+ "Do Not Disturb" mode) need a privileged channel to inject clicks on a virtual display. The project supports four channels with increasing privilege: Shizuku (common non-root elevation), Sui (Magisk/KernelSU module), root (direct su), and self-hosted ADB (wireless debugging to itself). The UI lists each channel's suitability and status but leaves the choice to the user.

Remote DSH Control : The phone can connect to a DSH instance running on a PC/server via SSH (host/user/key, fingerprint verification) or DSH Remote (a relay service by liguobao for NAT traversal). Since v1.0.4 the client auto-selects the path: LAN direct → TURN → relay, showing the chosen route, latency, and fallback reason on the connection card.

Security & Permission Model

Three confirmation tiers default to the strictest: every new app entry, every message send, every payment requires explicit user tap. A blocklist marks payment/banking/broker apps as "never touch"; WeChat defaults to "confirm every step". Passwords, verification codes, payments, and system settings are always handed back to the user. A "Remove Restrictions" toggle (guarded by a 1.5 s long-press on "I understand the risk") can disable these guards, after which the AI operates largely unsupervised.

Key Technical Deep Dives

Android 17 System Bug

Community testing revealed that on Android 17, background clicks failed across all four channels — even root. The cause was not a permission issue: InputManager.getInstance() was removed from framework.jar. Switching to InputManagerGlobal restored functionality. The fix landed in v1.0.9; the author notes they lack an Android 17 device for direct verification.

IPv6 DNS Filtering Breaking Dual-Stack Resolution

A user reported "could not reach" errors that looked like blocking. Root cause: a device-level DNS rule matched IPv6 query payloads and dropped only IPv6 responses. Node's dual-stack resolver treats a single AAAA failure as total resolution failure, discarding the valid A record. The engine was patched in v1.0.9 to resolve IPv4 and IPv6 independently so one failure doesn't invalidate the other.

Architecture

Three layers: App layer (Flutter UI), Engine layer (pure Dart DSH client), Phone Control layer (Kotlin native). The Dart client is shared between local and remote modes — switching sources requires zero code changes. Kotlin handles rootfs extraction, process lifecycle, and foreground service maintenance. The rootfs is native arm64 (no x86 emulation), explaining the package size.

Plugin System

The plugin-kit SDK lets DSH plugins declare JSON views; the app renders them natively without executing plugin code. A local preview tool renders view JSON to PNG with diagnostics. Official plugin marketplace already includes "Image/Video Generation" — installed plugins surface directly in chat. Plugins can be version-pinned, carry risk notices, and be shared via import links.

UX Details

Interruptible streaming : User can inject a new message mid-generation; the model sees it next step without aborting the current turn.

Turn folding : Completed turns collapse to "Done · N tool calls" (borrowed from the official web UI).

End-to-end encrypted sharing : Conversation links contain the decryption key; server never sees content. Links show expiry and auto-expire.

Native ↔ Web toggle : Native UI mirrors web features; web view remains as fallback. Known gaps: DS Bot and conversation export are web-only.

Desktop pets : Two animated characters (Deepy, Whale Girl) react to coding, completion, and confirmation waits; can float over other apps.

Limitations & Risks

Android only ; iOS and HarmonyOS pending. HarmonyOS fails because the container environment (e.g., 卓易通) blocks proot's required syscalls — an architectural blocker, not a config issue.

Phone control only works with local engine ; remote connections disable it.

Background survival varies by OEM (vivo, Xiaomi, Huawei, Honor, OPPO each have aggressive task killers); the app guides users through allow-listing but success is device-dependent.

233 open issues on a solo-maintained project — early versions have rough edges.

Model costs : DSH is free; inference calls bill to your own provider account. Token usage per Agent turn adds up quickly.

Privacy : Screen text (and screenshots for vision models) goes to your chosen model. Bank IDs and ID numbers are masked, but the app cannot judge what else is sensitive.

Rapid releases : 10 versions in 10 days (1.0.0 → 1.0.9) — bugs fix fast but changelogs must be checked.

Getting Started

Download arm64 APK from go.dshtui.com/download or the GitHub releases. First launch offers "Run Locally" (installs ~1 GB environment, few minutes) or "Connect Remote" (no local runtime needed). The repository includes an 11-chapter Chinese guide covering installation through phone control.

GitHub: github.com/ccch1mneyyy/dsh-go<br/>Download: go.dshtui.com/download
Original Source

Signed-in readers can open the original source through BestHub's protected redirect.

Sign in to view source
Republication Notice

This article has been distilled and summarized from source material, then republished for learning and reference. If you believe it infringes your rights, please contactadmin@besthub.devand we will review it promptly.

Fluttermobile developmentAndroidKotlinAI AgentDeepSeek Harnessdsh-GoPRoot
Reader feedback

How this landed with the community

Sign in to like

Rate this article

Was this worth your time?

Sign in to rate
Discussion

0 Comments

Thoughtful readers leave field notes, pushback, and hard-won operational detail here.