kelai141/dsh-mobile-apk
dsh 安卓壳 APK——WebView UI + 内嵌 Termux 运行时快照（解压即跑）、SAF 目录桥、保活服务、看门狗、运行时在线更新。
安装Install
dsh plugin --profile web add github:kelai141/dsh-mobile-apk把 kelai141/dsh-mobile-apk 加入你的 DSH 配置（web profile）即可启用。
READMEREADME
dsh-mobile-apk — DeepSeek Harness Android Shell APK
dsh-mobile 生态 · dsh-shell-termux（shell）· dsh-client-ui-responsive（移动 UI）· dsh-host-web-compat（浏览器兼容）
Android shell for DeepSeek Harness: WebView UI over an embedded Termux runtime snapshot (extract-and-run, no Termux app needed), SAF directory bridge, keep-alive foreground service, engine watchdog, and online runtime updates. One APK to install: it boots a full dsh web agent that can really execute bash.
Features
- Embedded runtime — ships a ~70MB xz snapshot (node + bash + coreutils + dsh + plugins); first launch extracts in ~10s and starts the engine from the app's own files; fully offline.
- Mobile UI — system WebView over
http://127.0.0.1:3080with the responsive plugin (drawer/sheet on phones). - Built-in console — standalone bash terminal (
assets/console.html+ embedded Termux), usable for diagnostics even when the engine is down. - Keep-alive — foreground service ("dsh 引擎运行中") + 5s watchdog that restarts a dead engine
- 3s UI monitor poll.
- Online runtime updates — manifest-driven snapshot swap (download → sha256 → atomic switch → auto-restart); the running runtime can update itself without an APK update.
- SAF bridge —
pickDirectorymaps the picked tree to a real path (/storage/emulated/0/…). - Device access — All Files Access, optional Shizuku keep-alive boost.
Build
Requirements: JDK 17+, Android SDK (compileSdk 36); Gradle 8.11.1 via wrapper.
# 1. Prepare the runtime snapshot (required, ~70MB, distributed as a Release asset)
# Download snapshot-x86_64.tar.xz from GitHub Releases (pick the arch/pagesize variant you need)
mkdir -p app/src/main/assets
cp snapshot/snapshot.tar.xz app/src/main/assets/snapshot.tar.xz
# 2. Build (fails loudly when the snapshot is missing)
./gradlew assembleDebug
# output: app/build/outputs/apk/debug/app-debug.apk
Bridge protocol v1 (window.androidBridge)
App name DeepCode, package com.dsharnessmobile.shell. androidBridge.version returns the app
version (currently 0.12.4); pages feature-detect on it.
Synchronous
| method | signature | description |
|---|---|---|
version |
() → string | app version (0.12.4) for feature detection |
getSystemDark |
() → boolean | system dark mode (bypasses vendor WebViews whose matchMedia is stuck on light; used by the first-frame theme bridge) |
checkEngine |
() → string | probes 127.0.0.1:3080; JSON {running, latencyMs, error?} |
hasAllFilesAccess |
() → boolean | whether All Files Access is granted (external workspace requirement) |
getPickToken |
() → string | one-shot token for the directory-picker bridge (validated by the engine-side pick endpoint) |
copyText |
(text) → boolean | native clipboard write (WebView clipboard.writeText is always rejected; page falls back to this) |
getDevLogEnabled |
() → boolean | dev debug-log toggle state |
Commands
| method | signature | description |
|---|---|---|
keepScreenOn |
(enable) | screen-on wake lock |
showNotification |
(title, text) | test notification channel (POST_NOTIFICATIONS) |
pickDirectory |
(callbackId) | SAF tree picker; result async via window.__dshBridge.onDirectoryPicked(callbackId, path) |
pickImage |
(callbackId) | SAF image picker; result async via the same callback |
setTextZoom |
(percent) | WebView font scale (50–200; Settings → General slider) |
setImmersiveMode |
(enable) | immersive status bar toggle (true = status bar normally hidden) |
downloadDebugLogs |
() | exports engine logs + environment info (zipped, system download/share dialog) |
requestAllFilesAccess |
() | opens the system All Files Access grant page (special permission) |
restartEngine |
() | restarts the engine process (EngineService watchdog brings it back) |
shutdownToGuide |
() | stops the engine and falls back to the test screen (no auto-restart) |
reloadWebUI |
() | reloads the Web UI |
openConsole |
() | opens the built-in console |
setDevLogEnabled |
(enabled) | sets the dev debug-log toggle (logs go under dshdata/log/ when on) |
The bridge decouples the APK from the dsh version: pages feature-detect on androidBridge.version.
Online update protocol
- App fetches
manifest.json:{url, sha256, size}(defaulthttp://10.0.2.2:8899/manifest.jsonfor emulator testing; production points at a release server); - Downloads the snapshot, verifies SHA-256, extracts to a staging dir (never touching the live tree),
atomically swaps
usr→usr-old→ newusr, then kills the old engine — the watchdog restarts it from the new runtime.
Test trigger: adb shell am start -n com.dsharnessmobile.shell/.MainActivity -a com.dsharnessmobile.shell.action.UPDATE;
status is written to files/update-status.txt. Test server: serve manifest.json + the snapshot from any
local HTTP server (default endpoint http://10.0.2.2:8899/manifest.json maps the host from the emulator).
Permissions
| permission | purpose |
|---|---|
INTERNET |
WebView + engine probe |
POST_NOTIFICATIONS |
notification channel (runtime request on API 33+) |
FOREGROUND_SERVICE + FOREGROUND_SERVICE_DATA_SYNC |
keep-alive foreground service |
MANAGE_EXTERNAL_STORAGE |
All Files Access (external workspace requirement; special permission, user-granted) |
SAF picking needs no permission.
ABI & pagesize
The x86_64 snapshot is verified end-to-end. arm64 snapshots are assembled from the official Termux aarch64 repo (see docs/design.md §ABI); a 16KB-page build must be produced on a 16KB device. APKs are per-ABI (the snapshot inside is arch-specific).
License
MIT. Contains third-party components under their own licenses (see dependency declarations).
Design rationale: docs/design.md.
相关推荐Related
- deepseek-ai/deepseek-harness DeepSeek Harness: Everything is a Plugin.
- deepseek-ai/deepseek-harness DeepSeek Harness (dsh) — 由 DeepSeek AI 开发的开源 agent harness（智能体框架）。一切皆插件：核心 + 插件 + 技能 = 可热插拔的 AI 编程工作台。DeepSeek Harness: …
-
ruvnet/ruflo
🌊 The original agent meta-harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build c…
-
amruthpillai/reactive-resume
A one-of-a-kind resume builder that keeps your privacy in mind. Completely secure, customizable, portable, open-source a…
-
volcengine/OpenViking
Self-evolving Context Database for AI Agents. Unify Agent Memory, Knowledge RAG and Skills.
-
Molunerfinn/PicGo
:rocket: The Ultimate Image Uploader for Efficient Creators. Supports Obsidian, Typora, VS Code etc. and 60+ image hosti…
-
titanwings/colleague-skill
将冰冷的离别化为温暖的 Skill，欢迎加入数字生命1.0！Transforming cold farewells into warm skills? It's giving rebirth era. Welcome to Digital …
-
nocobase/nocobase
NocoBase is an open-source AI + no-code platform for building business systems fast. Instead of generating everything fr…