kelai141/dsh-mobile-apk

🌐 English README

dsh-mobile 生态 · dsh-shell-termux（shell）· dsh-client-ui-responsive（移动 UI）· dsh-host-web-compat（浏览器兼容）· dsh-mobile（协调仓库，private） 支持开发者：https://d1api.xin/sign-up?aff=mVa0 欢迎大家使用此聚合网站，拥有极低价的国模和不降智的GPT

DeepSeek Harness 的安卓壳：WebView UI 覆盖 内嵌 Termux 运行时快照（解压即跑，无需 Termux app）、SAF 目录桥、保活前台服务、引擎看门狗、 运行时在线更新。一个 APK 装完即用：完整的 dsh web agent，且能真实执行 bash。

应用名 DeepCode（图标文字 DeepSearch）、包名 com.dsharnessmobile.shell、 当前源码版本 0.14.6（versionCode 50）、引擎 @deepseek-ai/dsh 0.2.0-rc.2（本地开发候选，未发布）。

插件市场适配警示：内置市场牵涉大量第三方插件，绝大多数插件在手机端不一定可用、大概率有 bug （移动端与桌面端在 WebView 内核/文件系统/权限模型/运行环境差异大）；移动端适配是长期工程， beta 阶段以「可用性验证与反馈」为主，暂不建议当作生产依赖。 插件报错请到 issues 反馈（附机型/版本/复现步骤）。

• 内嵌运行时：xz 快照内置 node + git + bash + coreutils + dsh + 插件 + pnpm + python/perl/ruby； 首启解压 2-4 分钟（refreshSnapshot），引擎监听 127.0.0.1:3080；完全离线。
• APK 自更新（0.14.6 起为用户面主路径）：查 GitHub latest release、按设备 ABI 匹配资产、镜像链逐级回退下载， 下载后校验 sha256 再拉起系统安装器。入口两处、读同一份状态：健康态可达的「检查更新」与启动页次级按钮； 不自动检查。更新动作不占用相位与主按钮，任何终态必落如实文案（含超时兜底）。
• 运行时快照更新：manifest 驱动的快照替换（下载 → sha256 → 原子切换 → 自动重启）， 运行时可自更新而无需更新 APK。换树是单事务：解压到 staging → 校验完整 → 整体换入， 中断可回滚，且从不触碰用户数据（会话/附件/设置/凭据/工作区）。 注：0.14.6 起用户面入口已切到 APK 更新（见上），快照链不再从引导页触发；adb 联调路径仍在但无超时兜底（见 known-gaps）。
• 保活：前台服务 + 5 秒看门狗（自动重拉挂死引擎）+ 3 秒 UI 轮询 + 崩溃自动回退闸门（UndoGate）。
• 内置控制台：独立 bash 交互终端（assets/console.html），引擎未运行也可排查。

• 右侧栏独立工作台，与主 UI 完全隔离的第二个 WebView；AI 可开页签、多网页同时管理， 人打开即可查看多个页签——UI 是给人看的，AI 走工具直接读信息。
• 分辨率 = CSS 视口（document-start 注入 width=<cssW> + 物理矩形等比 letterbox）， window.innerWidth 精确等于请求值；PC / 手机身份可切换（UA-CH 能力门，WebView 110 degraded 如实上报）。
• 侧栏收起时视口不再塌成 0x0（可见性用 INVISIBLE 而非 GONE，保留布局 + 按上次舞台尺寸给非退化矩形）。
• browser_snapshot 渲染每行 ref（不再只报计数，模型拿得到可点目标）。
• 滚动避让、Edge 式错误页、关闭即销毁、失败渲染兜底。

• 经 Shizuku 特权通道创建虚拟屏，第三方 App 在独立屏幕运行，不挤占用户前台； 单实例上限 1 块，序号复用（virtual-1 恒为「没有屏时新建」的号）。
• 跨屏拉起唯一可行路径：壳侧 Shizuku UserService 的 am start --display <id> -n <component> （固定 argv，先 cmd package resolve-activity）；其余三条路实测均不成立 （monkey --display 无此选项 / shell am start 不稳 / 进程内 setLaunchDisplayId 被 SafeActivityOptions 拒）。 模型侧用法：android_app_launch { pkg, screenId: "virtual-N" }。
• 坐标输入：虚拟屏上用绝对 x/y + screenId（经 input -d <displayId>，真实屏不受影响）； 归一化 nx/ny 在虚拟屏上明确拒绝（分母歧义会静默点到真屏）。
• 截图认屏：android_screenshot { screenId } 的两条通道都落到目标 displayId， 并把分辨率锚点换成该屏自身像素（此前 ADB 回落路径忽略 screenId，抓的是真实屏）。
• 等比适配（按内容宽高比 letterbox 居中，不拉伸）、空闲 10 分钟自动回收、 设置页「手机控制」含强制销毁（三连点确认）。

• 无障碍通道：语义树 / ref 动作 / 虚拟屏语义树；Shizuku 特权通道：uid 2000 执行系统命令 （screencap/uiautomator/dumpsys/input 等只读与输入类；系统配置写面一律拒绝）。
• ref 寻址：dump 时保留节点句柄，重定位不再重走 childPath；建树时钉住窗口 id （焦点变化不再换树）；UI 缓存 TTL 10 分钟。
• screenId 三件套：screenId/displayId/scope 逐条回填；guard() 异步解析别名 （虚拟屏别名 → 动态 displayId 必须问壳侧注册表，同步面做不到）。
• 设置页「手机控制」：Shizuku 状态与引导、屏幕开放范围、虚拟屏档位、浮窗开关、无障碍入口、强制销毁。

• 回形针上拉菜单（DSH 原生视觉）：点回形针出「上传附件 / 上传图片」两项， 单击即出（不再需要点两下）；两项分别走系统文件选择器与系统相册 （显式图片类型分流到 PickMultipleVisualMedia，API 33+ 系统照片选择器）。
• 文件直达会话：「使用其他应用打开 / 分享」→ 自动跳转本应用 → 强制新建临时工作区会话处理文件； 临时工作区 7 天 TTL 自动清理。
• SAF 桥：pickDirectory 把所选目录映射为真实路径。

Release 提供双 ABI 包（另含快照归档、插件包、MANIFEST 校验清单与发布说明）：

adb install -r -t <apk>    # 同签名覆盖安装

ABI 必须与设备匹配。 ABI 不匹配会导致引擎启动即崩——node ELF EM_X86_64 vs EM_AARCH64。 真机选 arm64 包，模拟器选 x86_64 包。

覆盖安装后请等待首次解压完成（快照指纹翻转），期间勿强杀应用。

快照构建与打包在协调仓库（dsh-mobile）完成， 本仓库是壳子仓库。要求：JDK 17+、Android SDK（compileSdk 36）；Gradle 8.11.1 由 wrapper 提供。

# 快照构建（Termux 源 + 依赖闭包 + pnpm + cordis 权威覆盖 + 瘦身）：
node scripts\build-snapshot-013.mjs <arm64|x86_64>

# 一键打包（快照 → 注入 → 门禁 → gradle，双 ABI）：
pwsh scripts\build-apk-013.ps1 -Suffix ""

# dev 档：单 ABI x86_64 + preset 1（产物体积增大，禁发布）
pwsh scripts\build-apk-013.ps1 -Fast

产物：out\v<版本>\dsh-mobile-apk-v<版本>-<abi>.apk。

门禁由 scripts/check-release-gates.mjs 聚合（--list 现数）。任一不过即拒打包， 严格发布档 --run --require 要求 SKIP=0。

壳侧 51 个 @JavascriptInterface 方法；页面按 androidBridge.version 做特性检测， 故 APK 与 dsh 版本解耦。

同步返回

浏览器工作台

虚拟屏

命令

AI 可见的能力全部来自插件，壳侧不直接注册工具。当前 45 个工具，按能力组渐进披露 （先 android_capabilities 解锁，之后工具才出现在列表里）：

• phone（14）：android_ui_dump / android_ui_click / android_ui_input / android_ui_scroll / android_ui_tree / android_ui_detail / android_ui_global / android_screenshot / android_screen_list / android_app_launch / android_device_info / android_act_input / android_web_dump / android_env_prepare
• browser（19）：browser_open / browser_snapshot / browser_click / browser_type / …（17 个）
• virtual-display（3）：android_vdisplay_create / android_vdisplay_destroy / android_vdisplay_status
• 另有 bridge（4）、model-capability（2）、linux-env（2）、file-open（1）

跨屏用法：任何带 screenId 的工具传 "virtual-N" 即在虚拟屏上执行 （android_screen_list 列出当前别名与范围）；缺省 real 表示真实屏。

SAF 目录/图片选择无需权限。虚拟屏与特权 shell 需用户安装、启动并授权 Shizuku。

完整版本历史见 docs/AGENTS/changelog-archive.md（倒序，最新在最上）。 开发地图与坑位库见 AGENTS.md 与 docs/AGENTS/gotchas.md。

MIT。第三方组件按各自许可（见依赖声明）。GPL 合规：copyleft 全文三形态在场——快照 usr/share/LICENSES/、仓库 LICENSES/、APK assets/licenses/。

感谢全体社区成员的反馈与贡献！ 特别致谢：cdwlll（环境问题反馈）、haitunlang（MIUI12 兼容）、 TACONailoong（老 WebView 兼容方案）、X-SCI-TECH（PR 贡献）、Yangerwei（文件竞态反馈）、 gr12-cmd（armv7l 需求）、cmyfqwq（覆盖安装兼容反馈）。

诚邀各位开发者参与：欢迎提交 issue、PR、建议与改进。我们特别需要：Android 兼容性测试 （华为/荣耀/小米等定制 WebView）、armv7l 等更多机型支持、Shizuku 通道完善、插件生态扩展。 开发维护规范见各仓库 AGENTS.md（开发地图）。

欢迎加入 dsh-mobile 用户群反馈：使用问题、机型兼容、功能建议都可以在群里直接提。