前言¶

在桌面端或網頁端跑 DeepSeek Harness（DSH）時，一次任務往往要經歷較長時間的推理、大量文件讀寫和工具調用。若把整套界面原樣映射到手機，小屏會被中間過程佔滿，外出時你通常只想知道「這一輪是否結束」並下發下一條指令，而不是逐行審工具入參和 diff。

社區插件 dsh-mini-remote（維護者 xingzhen199186）面向上述場景：移動端用瀏覽器打開一個輕量頁，按「單幀 / 聊天 / 完整」三檔控制信息密度；同一插件還在 DSH 桌面端提供「遠程窗口」，在另一臺電腦的 DSH 裏嵌入本機界面。下文按定位、能力、安裝與用法說明，事實均來自 GitHub 倉庫 README 與 npm 包 dsh-mini-remote（當前資料版本 0.2.3）。

這是什麼¶

dsh-mini-remote 是 DSH 的客戶端類插件：在本機起 HTTP 服務，手機掃碼或複製帶口令的 URL 即可遙控當前 DSH 進程；不依賴獨立 App、不經過插件自建賬號體系。README 將其概括爲「將注意力支配權交還給用戶」——默認可屏蔽執行噪聲，需要時再展開完整軌跡。

在 SkillHub 插件目錄 中歸類爲「客戶端」；GitHub 上約 3 stars（以目錄頁統計爲準）。協議爲 MIT。

核心功能¶

三檔呈現模式¶

同一會話可在移動端切換：

1. 單幀：整屏只保留最新結論，減少中間步驟干擾。
2. 聊天：常規氣泡對話流，一屏可見多條歷史。
3. 完整：按原有時序展開工具調用與文件差異，並支持關鍵詞檢索。

頁面爲原生 JavaScript，無前端構建；提供深色（深海墨藍）與淺色（冰藍寶藍）主題。

連接通路¶

依據網絡環境選型（各通道可並存，獨立二維碼與訪問口令）：

訪問地址形如（口令在 URL 中，需妥善保管）：

http://192.168.1.2:3090/mini?token=xxxxxxxxxxxx

移動端與會話治理¶

除底部發消息、執行中隊列與刻度尺外，頁面還支持：斜槓指令列表、Agent 多選答題、權限檔位（read-only / workspace-write / danger-full-access）、會話重命名與置頂、歸檔、從指定輪次 Fork，以及待審批/待回答提示。運行中會展示輕量狀態流（隊列與計時），過濾底層原始推理塊。

安全邊界（README 強調）：接口使用定長口令校驗；1 分鐘內試錯 5 次鎖定 1 分鐘；移動端不得跨目錄讀任意文件；危險命令審批仍須在電腦端 DSH 處理。

桌面端「遠程窗口」¶

在 DSH 桌面端左側欄進入「遠程窗口」，可列出已配對機器並在主面板內嵌另一臺電腦上的 DSH 桌面界面，避免整屏遠程桌面或額外開瀏覽器 tab。配對使用一次性票據（README 截斷處說明憑據不過手、短時有效）。

進階：內嵌完整 DSH 電腦端界面¶

在手機遙控頁設置中開啓「進階設置」（需二次確認）後，可在同一令牌下打開嵌入了完整 DSH 電腦端界面的頁面；默認關閉，因權限面從手機頁擴展到模型、憑據、插件與會話等全設置面。

環境依賴¶

安裝前確認：

• Node.js：^22.19.0 || >=24.0.0
• DSH：>=0.1.5-rc.2 <0.3.0（README 寫明在 0.1.5-rc.2、0.1.7-rc.2、0.2.0-rc.1、0.2.0-rc.2 上做過全量驗證；高於 0.3.0 存在上游接口破壞風險，升級 DSH 前需確認插件已跟進）
• 操作系統：Windows、macOS 或 Linux

安裝與啓用¶

插件在本機以當前用戶權限運行，安裝前應確認來源可信並閱讀源碼與 MIT 許可證。

途徑一：DSH 桌面端圖形化安裝（推薦）¶

1. 頂部「插件」→ 插件管理。
2. 「添加插件」。
3. 輸入包名 dsh-mini-remote，或 github:xingzhen199186/dsh-mini-remote，或本地目錄；安裝源默認 npm 官方源。
4. 點擊「安裝」。

注意：暫不支持自動更新，升級需先卸載再裝新版本。

途徑二：npm 命令行¶

web 爲 DSH 默認 Profile 名，自定義配置檔請替換：

dsh plugin --profile web add dsh-mini-remote

途徑三：GitHub 直接安裝¶

dsh plugin --profile web add github:xingzhen199186/dsh-mini-remote

途徑四：本地目錄（調試）¶

dsh plugin --profile web add C:\path\to\dsh-mini-remote

啓動確認¶

1. 重啓 DSH 服務（關閉並重新運行 dsh web）。
2. 控制台應出現類似日誌：

[dsh-mini-remote] 已啓動：http://127.0.0.1:3090/mini?token=xxxxxxxxxxxx

3. 桌面端「設置 → 手機遙控」查看二維碼與各通道 URL。

手機端僅爲瀏覽器頁面，可「添加到主屏幕」全屏使用；PC 瀏覽器打開同一地址也可操作。

典型用法¶

1. 安裝並重啓 DSH 後，在「設置 → 手機遙控」選合適通道（內網出差用 Tailscale 或飛書；完全無客戶端時用公網隧道並注意 HTTPS 與口令泄露風險）。
2. 手機掃碼進入 /mini?token=...，在設置裏選「單幀 / 聊天 / 完整」與主題。
3. 底部輸入指令；Agent 忙碌時消息自動排隊。
4. 需改模型或裝插件時，僅在信任環境下開啓「進階設置」中的內嵌電腦端界面。
5. 另一臺電腦已跑 DSH 時，在本機桌面端「遠程窗口」配對後於面板內操作對端實例。

package.json 中的 disclosure 補充：內網爲 HTTP；Tailscale 默認可 HTTP 或另開 HTTPS；Cloudflare 隧道爲 HTTPS；公網隧道勿在不可信網絡使用帶 token 的 URL；不收集遙測；啓用公網隧道時流量經 Cloudflare 中轉。

適用場景與注意¶

適合：經常離機但仍要盯 DSH 輪次、下發短指令的用戶；需要在多臺電腦間切換 DSH 界面而不開全屏遠程桌面的場景；希望用飛書做純文本遙控與審批的團隊（需自行配置飛書應用）。

注意：

• 插件與 DSH 同進程權限，勿安裝來源不明的包。
• URL 中的 token 等同遙控口令，勿截圖外傳；可在設置中更換密碼。
• 「完全權限」檔位風險高，移動端無法替代電腦端危險命令審批。
• DSH 版本需落在 >=0.1.5-rc.2 <0.3.0 聲明範圍內。

DSH 生態強調「一切皆插件」；SkillHub 爲社區目錄，與 DeepSeek / 幻方無官方從屬關係。

結尾¶

dsh-mini-remote 把移動端收成「結論優先、過程按需展開」的遙控頁，並用 LAN / Tailscale / Cloudflare / 飛書多條通路適配不同網絡；桌面端「遠程窗口」則把跨機 DSH 操作收進主面板。進一步細節與截圖見倉庫 README。

• 插件目錄：https://www.skillhub.cn/plugins/xingzhen199186/dsh-mini-remote
• GitHub：https://github.com/xingzhen199186/dsh-mini-remote
• npm：https://www.npmjs.com/package/dsh-mini-remote