Soodok/Deepseek-Harness-Local-Android

解决的问题

在安卓上运行 AI 智能体传统上需要设置 Termux、安装依赖，或使用带有完整 Linux 发行版的 proot 容器。本项目通过将官方 DeepSeek Harness 引擎、其 Node.js 运行时和 19 个环境工具链打包成一个 APK，消除了这些麻烦。安装后即可立即使用——无需 root、无需 Termux、无需电脑。会话、凭据和工作区完全存储在应用沙箱或应用的私有外部目录中，因此你的数据保留在手机上，除非你明确配置远程模型 API。

工作原理

该应用嵌入了官方 dsh 引擎（固定版本 0.2.1-rc.2）以及一个 bionic（安卓原生）Node.js 运行时。引擎仅监听回环地址 127.0.0.1:3083，所有交互都通过令牌门控的能力桥进行。一个带有指数退避监控的前台服务保持引擎在后台运行。它包含一个扩展中心，你可以一键下载和卸载命令行工具，如 Python、Go、Rust、Git 和 FFmpeg；依赖会被解析、SHA-256 验证并原子化发布。它还附带一个 SSH 远程工作区（通过 @tiphareth/dsh-hardssh 插件），可以绑定远程目录，让你直接从手机在服务器上执行读/写/编辑/bash 命令。屏幕自动化通过一个无障碍服务实现，提供 21 种操作原语（点击、滑动、滚动、拖拽、输入等），并带有本地闭环：选择 → 执行 → 验证 → 重试，使用 OCR 和图标识别等视觉回退。局域网 WebUI 代理允许你使用一次性 6 位代码从电脑访问原生 Web 界面。语音输入使用系统识别，并可选 OpenAI 兼容 API 作为回退。权限模式分为三层：普通（沙箱）、Shizuku（adb 级别）和 root（uid 0），并带有 su 门控和双重确认等安全措施。

适用人群

这面向希望在安卓手机上拥有完全便携式 AI 智能体工作站的开发者和技术爱好者。对于需要在离开桌面时编辑代码、运行测试或监控远程服务器日志的管理员也很有用。默认的普通模式覆盖大多数日常需求；root 或 Shizuku 是可选的高级层级，适用于需要更深层设备控制的用户。

亮点

• 一键安装：所有内容（引擎、运行时、工具链）都预构建在 APK 中；无需初始下载或环境设置。
• 官方 dsh 引擎完全移植，保留了插件系统、WebUI 和工具调用链。
• 19 个环境扩展（Python、Go、Rust、Clang、OpenJDK、Git 等）可按需安装或卸载。
• 内置 SSH 远程工作区，支持 Web 终端、文件上传/下载、本地端口转发和远程命令执行。
• 屏幕自动化，包含 21 种操作原语和本地验证循环（实测每步约 1.45 秒；紧凑验证约 5 毫秒）。
• 局域网 WebUI 代理，带有随机生成的 6 位访问码和持久通知，方便远程桌面访问。
• 语音输入，支持可编辑转录、去重和后台发送。
• 三种权限模式（普通 / Shizuku / root），并配有严格的安全措施；普通模式为默认，无需特殊设置。