Deepseek-Harness-Local-Android

解决什么问题

想在没有电脑、不想折腾的情况下在手机上跑 DeepSeek Harness Agent，传统做法是在 Termux 里搭一套 Linux 环境，或走 proot + Ubuntu 容器：配置繁琐、首次可用要额外下载数百 MB 到数 GB 的 rootfs，sharp / koffi / node-pty 等原生模块编译失败几乎是常态。

DSH Mobile 把官方 dsh 引擎（锁定 0.2.0-rc.2）与自建的 bionic Node.js 运行时一起打进 APK，装完即用：

• 零外部依赖：不需要 Root、不需要 Termux、不需要电脑；引擎监听 127.0.0.1，会话、凭证、工作区全部留在设备本地
• 扩展中心：Python、Go、Rust、Clang、OpenJDK、Git、FFmpeg、OpenSSH、ADB 等 19 项环境一键安装，依赖闭包自动解析 + SHA-256 校验，国内镜像自动切换；Agent 还能在会话中自助安装环境
• 真实执行力：内置 bash / ripgrep / pnpm / curl，Agent 可读写文件、执行命令、起本地 HTTP 服务并通过 127.0.0.1 链接即时预览成果
• 手机能力桥：读屏、点击、输入、滑动、截屏、通知、震动、TTS 等经 token 门控的本地桥暴露给 Agent
• 三级权限：普通（应用沙箱）/ Shizuku（adb 级命令）/ Root（全盘），默认普通模式，su 闸门拦截 AI 子进程提权
• 数据可迁移：会话与工作区放在内部存储 Documents/dshdata，卸载重装不丢
• 保活与可观测：前台服务 + 监督器扛系统回收，流式悬浮条实时显示 AI 输出与最近工具调用，任务完成发系统通知
• 语音输入与远程终端：悬浮球语音直达当前对话，装 OpenSSH 扩展后可从电脑 SSH 连入终端与传文件

适合谁

• 想随时随地用 DeepSeek Agent 派活、但不想随身带电脑或维护 Termux 环境的开发者
• 需要在手机上直接跑 Python / Node / Rust / Go 工具链，或让 Agent 就地完成编码、检索、起服务预览的人
• 想省掉原生模块编译踩坑、又希望保留 dsh 插件体系与 WebUI 的用户
• 有 Root 或 Shizuku 并希望把设备能力（adb 级操作、全盘读写）交给 Agent 的高级用户

使用前提与边界

• Android 8.0+，系统 WebView 需 Chrome 85+；arm64-v8a / x86_64；建议预留 700MB 以上空间（APK 约 124MB，安装后约 490MB）
• 没有 Linux 桌面环境，视觉产物走本地 HTTP + 内置 WebView 预览
• 无障碍读屏基于节点树，对纯图形/游戏画面无效（半盲点击）
• 上游 dsh 的 WebUI 出于安全设计不支持绑定 0.0.0.0，电脑浏览器无法直接打开手机上的 WebUI，需要图形界面请在手机上看，或用 SSH 做终端操作
• 长任务在用户强杀或极端省电模式下仍可能中断；Root 模式让 AI 具备全盘读写能力，误操作可能损坏系统，请谨慎开启
• 模型推理走你自行配置的 API 服务，本项目本身不是端侧大模型 App，也不自研 Agent 框架