AyaoJies/dsh-mobile-android-test ↗★ 1

@ayaojies/dsh-mobile-android-test

Upload a mobile APK, run it in a managed Android emulator inside the Harness page, mirror the screen, forward touch and keyboard input, and inspect decrypted HTTPS traffic like DevTools.

패키지
@ayaojies/dsh-mobile-android-test
호환성
미검증
Harness peer 범위
>=0.2.2-rc.1 <0.3.0
버전
1.7.0
라이선스
MIT
최근 업데이트
2026. 11. 19.

설치

$npx -p @deepseek-ai/dsh dsh plugin --profile web add @ayaojies/dsh-mobile-android-test

首次使用

  1. 点开侧栏「移动 App 测试」。页面立即显示「正在检测本机安卓运行时…」。
  2. 如果本机没有 Android SDK/模拟器,会列出缺什么,并给一个**「一键下载并安装」**按钮:
    • 自动下载 commandline-tools(约 146MB)→ sdkmanager 安装 platform-tools / emulator / system-images;android-33;google_apis;x86_64(约 1GB)→ 自动创建并配置 AVD(720×1280 / 320dpi)。
    • 全程有总进度条、实时下载速度、已下载量、剩余时间、步骤条与日志,可随时取消。
    • 实测:约 8 分钟(视网络;支持断点续传、失败重试)。
  3. 就绪后点「启动模拟器」(首次冷启动约 2–3 分钟)。
  4. 在设备区点「上传 APK」,选一个 .apk → 自动安装 → 应用列表里点「启动」。
  5. 点「开始抓包」:插件启动内置 MITM 代理、把设备代理指向本机,并自动 adb root + remount 把自签 CA 装进设备系统信任区(现代 Android 会自动 disable-verity 并重启一次)。之后 App 的 HTTPS 请求就以明文出现在右侧网络面板。

顶栏「停止模拟器」右侧的 ⚙ 按钮随时打开「运行环境管理」:可以查看两套运行时的安装状态、单独下载/重装任意一套、或一键「启动并切换」到另一套。

配置

在 cordis.patch.yml 里改这一行的 config(重启 DSH 或重载 profile 后生效):

- insert:
    - id: dsh-mobile-test
      name: '@local/dsh-mobile-test'
      config:
        dataDir: ''                                            # 默认 %LOCALAPPDATA%\dsh-mobile-test
        sdkDir: ''                                             # 默认 \android-sdk
        systemImage: 'system-images;android-33;google_apis;x86_64'
        avdName: 'dsh-mobile-test'
        avdDevice: 'pixel_5'
        proxyPort: 8899
        screenMaxFps: 4                                        # 投屏帧率上限,越高越吃 CPU
        captureMaxRequests: 3000                               # 抓包内存条数上限
        captureMaxBodyBytes: 262144                            # 单条 body 预览上限(256KB)

数据都落在 dataDir:android-sdk/(SDK)、mitm/(CA 与 mitmproxy 配置)、capture/(venv 与 events.jsonl)、apks/(上传的安装包)。