DeepSeek Harness (DSH) 的核心架构是插件化。要让智能体开发流程覆盖到移动端，需要针对不同平台的 provider。针对鸿蒙设备，本插件提供了一套通过 hdc 连接的解决方案，解决看画面、点/滑、按键、输入文字以及给 AI 看的问题。

定位¶

本包是 DSH 的鸿蒙平台 provider。它只负责“这台设备怎么连、怎么点、怎么出画面”，而界面、AI 工具、焦点逻辑在 dsh-scrcpy-core 中。

核心功能¶

• 连接方式：通过 hdc（USB 调试或 hdc tconn 无线连接）连接设备。
• 基础交互：支持屏幕镜像、触控、按键、文字输入。
• 进程管理：每台设备对应一个 Java 进程（Sidecar），由本包启动以管理视频流与控制。
• 多设备支持：支持多设备同时投屏，安卓和鸿蒙可以共存，互不冲突。
• 华为零售机：支持华为零售机，无需 root、不改系统分区、不需要白名单。
• 转屏支持：转屏后画面自动跟随，无需重连。
• 资源控制：支持暂停/恢复，低资源占用。
• 画质调节：支持缩放、帧率调节。
• AI 工具：截图识别、控件清单、点击/长按/按键/输入等工具在 core 中，作用于当前聚焦的设备。

安装与启用¶

本包依赖 dsh-scrcpy-core，必须完全退出 DSH 后再打开才能生效。

1. 打开 DSH 的插件面板。
2. 安装 @nszzj/dsh-scrcpy-core（包含界面与 AI 工具）。
3. 安装 @nszzj/dsh-hos-scrcpy（鸿蒙 provider）。
4. 完全退出 DSH，重新启动。

典型用法¶

1. 设备准备：设备开启开发者模式 + USB 调试（或使用 hdc tconn 连接）。
2. 确认连接：在终端执行 hdc list targets，确认能看到设备。
3. 投屏操作：DSH 菜单里会出现这台设备，点击该行的「投屏」。
4. 多设备切换：右侧面板会出现对应设备的标签页。多台设备时，点哪行跳哪张标签页。
5. 画质调节：在「连接设置」里调整缩放和帧率。
6. AI 操作：AI 工具作用于当前聚焦（面板可见）的那台设备。

环境要求¶

• DSH：电脑端 DeepSeek Harness（Windows / macOS / Linux）。
• Java 8+：sidecar 的运行环境。
• hdc：DevEco Studio 自带的工具链。
• 鸿蒙设备：已连接。

注意事项¶

• 依赖关系：必须安装 @nszzj/dsh-scrcpy-core，否则本包不会激活。
• 重启生效：宿主半区改动只有重启才生效，安装后需完全退出 DSH。
• 设置限制：连接中途不能改缩放/帧率，需断开重连。
• 日志：不做设备日志流（hilog），面板里的「日志」是插件诊断日志。
• API 限制：SDK 1.0.18 中 requestIDRFrame() 为空方法。
• 零售设备：零售设备走系统服务通路。

参考资料¶

社区目录 | GitHub 仓库