前言¶
DeepSeek Harness (DSH) 采用插件化架构，旨在让各种设备能力通过标准接口接入。在安卓开发或自动化场景中，开发者需要实时查看设备屏幕并执行点击、滑动等操作。这里介绍的是 ns-zzj/dsh-android-scrcpy，它作为 DSH 的安卓投屏 provider，负责通过 ADB 和 scrcpy 协议建立连接，将设备画面与操作指令传回宿主。
这是什么¶
这是一个 DSH 的 Provider 包，专门负责安卓平台的“连接”与“传输”。它并不包含界面、AI 工具或逻辑判断，这些由依赖的 dsh-scrcpy-core 提供。
- 角色定位：安卓平台的传输 Provider。
- 依赖关系：必须安装
dsh-scrcpy-core才能激活本包。两者互不自动拉取，需手动安装。 - 传输方式：通过
adb连接，支持 USB 调试或已配对的无线调试。 - 协议：使用 scrcpy-server 4.1 协议，包含 video 和 control 两路 socket。
核心功能¶
本插件在流路径上直接处理画面解包、维护 GOP 缓存并推送给浏览器半区。
- 跨平台多设备支持：支持安卓和鸿蒙设备同时显示，各自独立会话。操作只作用于当前聚焦的设备，不会误触。
- UHID 虚拟外接键盘：将 PC 键盘转化为设备的真实 HID 外设（发送真 HID 报告），而非简单的文本注入。
- 转屏与切页：设备转屏后画面自动跟随，无需重连；切出页面时自动暂停，占用资源少；切回时立刻出画，且支持暂停期间转屏。
- 画质控制：有线和无线连接可分别配置缩放比例与帧率（默认有线 1/2·60fps，无线 1/4·30fps，最高 120fps）。
安装与启用¶
在 DSH 的插件面板中安装两个包，顺序不分先后，但必须都装。
# 1. 安装 Core（含界面与 AI 工具）
@nszzj/dsh-scrcpy-core
# 2. 安装本包（安卓 Provider）
@nszzj/dsh-android-scrcpy
安装完成后，必须完全退出 DSH 再重新打开，宿主侧的改动才能生效。若只装本包不装 Core，插件会因注入不满足而静默不激活。
使用方法¶
- 设备准备：设备端打开 USB 调试（或已配对无线调试），确保
adb devices能识别设备。 - 查看设备：在 DSH 顶部菜单的“设备列表”中，Core 会每 3 秒拉取一次设备信息，本包负责上报。
- 配置连接：进入「连接设置」，配置 ADB 路径（若不在 PATH 中）以及画面参数（有线/无线分别设置缩放与帧率）。
注意事项¶
- 权限与确认：首次连接或出现授权弹窗时，需在设备端手动点击确认，Provider 无法代劳。
- 配置生效：连接中途不能修改缩放和帧率，断开重连才能生效。
- 环境要求：不需要在 PC 端安装 Java，scrcpy-server 会由设备端的
app_process直接运行。 - 断流恢复：断流或切后台后的恢复依赖 GOP 补发机制，若设备端长时间未出关键帧，恢复速度可能会慢一些。
