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 倉庫