前言¶
DeepSeek Harness（DSH）主要用於本地智能體開發。在開發過程中，常需要在手機上回答 DSH 的提問，或者查看實時的會話輸出。直接通過 SSH 或瀏覽器轉發不夠直觀，且容易丟失上下文。
dsh-mobile-mirror 是一個 DSH 插件，它在局域網內起一個獨立的 HTTPS 服務，讓手機瀏覽器或原生 App 能夠鏡像 DSH 的會話。桌面端的行爲完全不變，不會因爲插件的存在而改變佈局或注入 UI。
插件簡介¶
- 名稱：dsh-mobile-mirror
- 維護者：ImHaoYuan
- 分類：聯網工具
- 許可證：MIT
該插件通過獨立的端口（19388）提供服務，支持查看會話列表、實時逐字輸出、發消息、停止當前輪、新建會話、切換模型與模式，以及直接在手機上回答 DSH 的提問。
環境要求¶
在開始之前，請確認環境滿足以下條件：
- DSH（桌面端）：僅支持 Windows 桌面端 0.2.0-rc.2。其他版本理論上能裝，但未驗證。
- 手機：與電腦在同一局域網連接。
- Node.js：宿主環境需要 Node.js >= 20。
- HyperOS：通知與超級島功能僅在 小米 HyperOS 3 上實測通過。
安裝與啓用¶
安裝該插件需要先克隆倉庫，然後通過 DSH 的插件管理器或手動 Link 的方式引入。
- 克隆倉庫
git clone https://github.com/ImHaoYuan/dsh-mobile-mirror.git
- 通過插件管理器安裝
插件管理器會自動處理依賴鏈接並熱應用配置。
plugin_manager install_bundle target = link:<你克隆到的絕對路徑>
(請將 <你克隆到的絕對路徑> 替換爲實際的絕對路徑，例如 link:D:/plugins/dsh-mobile-mirror)
- 確認安裝成功
安裝完成後，啓動 DSH 的設置面板，應能看到「手機鏡像」這一頁。桌面端日誌中應出現listening on 0.0.0.0:19388。
首次配置：賬號密碼¶
插件默認處於“拒絕登錄”狀態。首次使用需要在電腦端進行初始化。
- 打開
https://127.0.0.1:19388/setup。 - 輸入賬號和密碼（至少 6 位），點擊保存。
- 瀏覽器會提示自簽證書不安全，點擊“繼續訪問”即可。
你也可以直接編輯配置文件 $DSH_HOME/mobile-mirror.json 填入明文密碼，插件啓動時會自動轉換爲哈希值。
手機訪問¶
配置完成後，在手機瀏覽器中訪問：
https://<電腦局域網IP>:19388/
首次訪問會因自簽證書報錯，這是正常現象：
- iOS Safari：點擊「詳細信息」→「訪問此網站」。
- Android Chrome：點擊「高級」→「繼續前往」。
若想消除警告，可在電腦端 /setup 頁面下載 cert.pem 並安裝到手機的系統證書列表中。
兩種客戶端方案¶
該插件提供了三種訪問方式，但核心數據源相同：
| 方式 | 說明 | 包名 | 特點 |
|---|---|---|---|
| 網頁端 | 手機瀏覽器直接訪問 | — | 零安裝，功能完整，支持 Markdown |
| WebView APK | 將網頁封裝進 App | dsh.mirror |
包含通知、超級島支持，體積小 (78 KB) |
| 原生客戶端 | 使用 Kotlin + Compose 重寫 | dsh.mirror.client |
體積較大 (23.8 MB)，原生手感，支持三檔字體 |
建議：同一時刻只安裝其中一支。原生客戶端是 WebView 的超集，推薦使用原生客戶端。
核心功能¶
插件支持以下操作：
- 會話管理：查看會話列表（支持按工作區分組摺疊）、新建會話、長按歸檔空白會話。
- 實時交互：支持 SSE 逐字輸出（切後臺自動補齊）、停止當前輪（二次確認）、發消息（冪等且節流）。
- 模型控制：切換會話的模型（含推理檔位）與模式（標準/PTC/極簡/創造等）。
- 回答提問：手機與桌面誰先答誰生效。在限時提問模式下，手機端會接管等待，不會因切後臺而掉線。
- 內容顯示：支持 Markdown 渲染、長內容不截斷（正文上限 100000 字符）、文件下載。
- 原生獨有：原生客戶端提供「已發消息」清單、輸入框多行擴容、三檔字體設置（界面/正文/等寬）。
安全與端口設計¶
DSH 自帶的 Web 服務僅監聽 127.0.0.1。如果直接將 DSH 的端口改爲 0.0.0.0，相當於將整個桌面 GUI 和 API 暴露到局域網。
dsh-mobile-mirror 的設計思路是：
1. 起一個獨立的 HTTPS 服務，默認端口 19388。
2. 自行簽發自簽證書，不依賴第三方包。
3. 只提供手機鏡像所需的只讀接口和消息發送接口，不暴露 DSH 的原有 Web Server。
注意事項¶
- 版本兼容性：本文檔基於 DSH Windows 0.2.0-rc.2 和 小米 HyperOS 3 測試。其他 DSH 版本、其他 Android ROM 或機型均未驗證。
- 證書信任：由於使用自簽證書，iOS 上需要額外進入「證書信任設置」開啓完全信任；Android 上需安裝 CA 證書。
- 字體文件：原生客戶端的 23.8 MB 體積中，約 20 MB 爲內置字體文件（得意黑、思源黑體、JetBrains Mono）。
