DshRemote:把 DSH Web 面板安全穿透到手機與外網

前言

DeepSeek Harness(DSH) 的開發工作多在本地 Web 面板裏完成。離開工位後,若要用手機或外網瀏覽器繼續對話、改文件,常見做法是自建 VPN、配置路由器端口映射,或把面板暴露到公網——步驟多、安全邊界也不清晰。

DshRemote(倉庫名 dsh-remote-plugin)是面向 DSH 的持久化插件包(host + client):在 DSH 側邊欄一鍵開啓遠程訪問,通過 FRP 隧道與本地閘機把本機面板安全穿透出去;官方託管模式下無需自己維護 frps。下文介紹它是什麼、能做什麼,以及如何從倉庫安裝並啓用。

這是什麼

  • 名稱:DSH 遠程助手(DshRemote),npm 包名 dsh-plugin-browserctl,當前版本 1.0.55(見倉庫 package.json)。
  • 維護者:Memorial-coder。
  • 分類:社區目錄歸類爲「聯網工具」;GitHub 約 10 stars(以目錄頁/倉庫頁爲準)。
  • 許可:MIT License · 2026 DshRemote Project。
  • 定位:DSH Web 面板配套工具——掃碼配對、設備管理與 2FA 集中在側邊欄「遠程助手」,AI 對話與文件處理仍在本機 DSH 中執行。

在線體驗入口(README 給出的官方地址):https://remote.ymzcc.com/dsh-remote/。社區插件目錄:https://www.skillhub.cn/plugins/Memorial-coder/dsh-remote-plugin;源碼:https://github.com/Memorial-coder/dsh-remote-plugin。

核心功能

以下能力均來自倉庫 README 功能表與說明,安裝後可在側邊欄面板中操作。

能力 說明
掃碼即連 手機掃二維碼,約 30 秒內完成配對,無需路由器端口映射
一次性 / 長期配對 臨時會話用一次性碼;常用設備用長期配對碼並自動保存
場景配對 支持 iOS / 無 App 設備經 Safari 驗證,30 天免登錄
兩步驗證 2FA TOTP(RFC 6238)+ 30 天 Cookie 設備信任
設備管理 在線設備列表、詳情、一鍵踢下線
IP 黑名單 暴力破解自動封禁,可自定義規則
消息推送 Windows 原生 Toast,安全事件提醒
操作日誌 配對、踢人、驗證等關鍵操作記錄
PWA 可添加到手機主屏幕全屏使用,無需單獨 App
自建 / 託管 默認官方服務器即開即用;也支持自建 frps
多用戶隔離 官方託管下每位用戶專屬入口,設備互不干擾
引導鏈接 一次性引導鏈接,可分享給他人免註冊訪問

數據與傳輸(README「安全性」):對話與文件處理在本機 DSH 運行;手機經 TLS 到官方 frps/Nginx,再經隧道路到本機 browserctl.py 閘機,README 聲明數據不經第三方明文。

架構概要:

手機/外網瀏覽器
  → https://remote.ymzcc.com/dsh-remote/p/<uid>/   (官方託管:每用戶專屬 HTTPS 入口)
  → OpenResty/Nginx(Lua Cookie 簽名門禁)
  → frps(KCP/UDP)
  → frpc 隧道
  → 本機 browserctl.py(2FA + 會話 + 看門狗)
  → DSH Web 面板

官方託管模式下,用戶登錄後擁有穩定路徑 /dsh-remote/p/<uid>/(uid 不變,換端口不斷連)。

安裝與啓用

環境要求

倉庫 package.json 聲明:

  • node: ^22.19.0 || >=24.0.0
  • dsh: >=0.2.1-rc.3

README 說明:一般不需要單獨安裝 Python 或 Node;插件會按序探測 BROWSERCTL_PYTHON、包內 python/、DSH 自帶運行時、PATH;browserctl.py 僅使用 Python 標準庫。lib/ 爲預構建產物,運行時零 npm 依賴。

裝之前確認兩件事

  1. 官方託管需先在 https://remote.ymzcc.com 註冊(README 寫明免費),登錄後服務器才分配專屬端口。
  2. Windows 上 frpc.exe 可能被報 PUA:Win32/FRProxy;解壓後先運行包內 fix-antivirus.bat(或 fix-antivirus.ps1),否則隧道可能無法啓動,手機端出現 502。

從 GitHub 安裝(推薦命令,README 原文)

開發或嚐鮮可直接用 DSH CLI 從倉庫根安裝(倉庫根 package.json 的 dsh.bundle 指向子包,根目錄即爲合法插件包,lib/ 已入庫,無需 npm install):

dsh plugin add github:Memorial-coder/dsh-remote-plugin

也可在 DSH「設置 → 插件 → 添加插件 → 選擇本地目錄」中選中插件包根目錄(含 package.json、cordis.patch.yml、lib/、browserctl.py 等)。發版 zip/tgz 目錄結構與此一致。

官方託管快速步驟(README)

1. 解壓插件包(Windows 先跑一次 fix-antivirus.bat)
2. DSH →「設置」→ 插件頁 →「添加插件」→「選擇本地目錄」→ 選中插件包根目錄 → 重啓 DSH
3. 側邊欄「遠程助手」→ 登錄官方賬號 → 點「開始控制」→ 手機掃二維碼遠程訪問

更細步驟見倉庫內 INSTALL.md。交流羣:QQ 1134820071(README 給出)。

自建服務器:可自行配置 frps;README 寫明密鑰僅保存在本機,不會被提交或上傳。

典型用法

經上述步驟啓用後,日常流程與 README「手機 App:三步連接」一致:

  1. 電腦端在插件面板一鍵生成配對碼(含二維碼)。
  2. 手機掃描二維碼,約 30 秒內完成驗證。
  3. 驗證成功後 30 天內免登錄(場景配對 / Cookie 信任策略以面板爲準),可隨時從手機瀏覽器或 PWA 進入,操作與本地 DSH Web 面板一致(寫代碼、處理文件等)。

面板側還集成設備管理、2FA 設置、黑名單、日誌查看與 Windows 推送開關;需要臨時讓同事訪問時,可使用「引導鏈接」生成一次性鏈接(README 功能表)。

適用場景與注意

適合誰

  • 已在 PC 上跑 DSH,希望出門時用手機或外網繼續同一工作區、同一助手會話的開發者。
  • 不想自己維護公網入口與 frps,可先走官方託管;對合規或內網有要求的團隊,可走自建 frps 路徑。

使用注意

  • 插件與 DSH 同進程權限運行:遠程連上後,能力邊界等於本機 DSH 與閘機配置所允許的範圍。安裝前請閱讀 browserctl.py、INSTALL.md 與 MIT 許可證,確認符合你的安全策略。
  • 聯網與隧道組件(frpc、官方入口)會建立外連;企業環境需評估防火牆與終端安全軟件策略(尤其 Windows 對 frpc.exe 的攔截)。
  • SkillHub 等爲社區插件目錄,與 DeepSeek / 幻方無官方從屬關係;星標與版本以 GitHub / package.json 爲準。

結尾

DshRemote 把「遠程打開本機 DSH 面板」收口到側邊欄:配對、2FA、設備踢出與日誌在一處完成,計算仍留在本機。若要試用界面,可先打開 https://remote.ymzcc.com/dsh-remote/;若要裝進自己的 DSH,使用 dsh plugin add github:Memorial-coder/dsh-remote-plugin 或本地目錄安裝,再按 README 三步掃碼連接。

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜