安卓调试桥 ToLiveAndLove/dsh-tool-adb

@deepseek-ai/dsh-tool-adb

DeepSeek Harness 插件，把 Android Debug Bridge（adb）操作封装成模型可调用的工具。

功能

| 工具 | 说明 |
| adb_devices | 列出已连接的 Android 设备和模拟器 |
| adb_shell | 在设备上执行 shell 命令 |
| adb_install | 把 APK 文件安装到设备 |
| adb_uninstall | 从设备卸载应用 |
| adb_screenshot | 截取设备屏幕，保存到本地工作区 |
| adb_pull | 把设备上的文件/目录复制到本地 |
| adb_push | 把本地的文件/目录复制到设备 |
| adb_logcat | 抓取 logcat 输出（可选按 tag 过滤） |

安装

前置条件

- Android SDK platform-tools（adb 已在 PATH 中）
- macOS：brew install android-platform-tools
- Linux：sudo apt install android-sdk-platform-tools
- Windows：从 developer.android.com 下载

作为本地插件（开发）

加到你的配置档 cordis.patch.yml：

- insert:
- id: tool-adb
name: /absolute/path/to/packages/android/tool-adb/lib/index.js
config:
devices: true
shell: true
install: true
uninstall: true
screenshot: true
fileTransfer: true
logcat: true
timeoutMs: 30000

或者用补丁文件启动：

dsh web --patch ./adb-plugin-patch.yml

配置

| 选项 | 类型 | 默认值 | 说明 |
| devices | boolean | true | 注册 adb_devices |
| shell | boolean | true | 注册 adb_shell |
| install | boolean | true | 注册 adb_install |
| uninstall | boolean | true | 注册 adb_uninstall |
| screenshot | boolean | true | 注册 adb_screenshot |
| fileTransfer | boolean | true | 注册 adb_pull 和 adb_push |
| logcat | boolean | true | 注册 adb_logcat |
| timeoutMs | number | 30000 | 每条命令的超时时间，单位毫秒 |

使用方式

模型应始终先调用 adb_devices 拿到设备序列号，再把序列号传给其他工具。

示例工作流：
1. adb_devices → 找到序列号 ABC123
2. adb_shell device=ABC123 command=pm list packages | grep com.example
3. adb_screenshot device=ABC123 → 把截图保存到本地
4. adb_logcat device=ABC123 filter=MyApp:D *:S → 抓取过滤后的日志

开发

Typecheck
pnpm --filter @deepseek-ai/dsh-tool-adb exec tsc --noEmit

Build
pnpm --filter @deepseek-ai/dsh-tool-adb exec tsc

Smoke test (requires adb on PATH)
node --import tsx packages/android/tool-adb/tests/smoke.test.ts

协议

MIT