前言¶
如果你需要在電腦上運行 DSH，同時希望手機或外網也能繼續查看會話、切換模型、控制運行，常見做法是自備公網 IP、註冊隧道服務、配置證書、修改端口。
dsh-web-remote 把這幾件事合併爲一個 DSH 插件：它提供免配置的 Cloudflare Quick Tunnel、局域網 HTTPS 直連、自定義公網鏈接/端口，以及微信和飛書機器人。
這是什麼¶
dsh-web-remote 是 godchen520 維護的 DeepSeek Harness（DSH）插件，許可證爲 MIT。
它解決的核心問題是：讓本地運行的 DSH Web 可以被手機、外網、微信或飛書訪問和控制。
核心能力¶
- 公網訪問：使用 Cloudflare Quick Tunnel，無需公網 IP、無需註冊；
cloudflared缺失時自動下載。 - 局域網直連：支持 HTTP + HTTPS 直連；HTTPS 自動生成自簽名證書，零配置。
- 安全認證：每次啓動生成隨機令牌；使用 HttpOnly Cookie；局域網可免 token。
- 性能加速：反向代理自動 gzip 壓縮，大歷史會話加載更快。
- 側邊欄圖標：手機快捷按鈕常駐左下角，刷新不消失。
- 自定義公網鏈接：支持填寫自定義公網 URL，例如 ngrok；可在面板編輯或清除，重啓後生效。
- 自定義端口：局域網模式下可修改 HTTPS 端口號，帶端口占用檢測。
- 微信機器人：通過 iLink 協議直連微信，支持 AI 對話、會話控制、模型切換。
- 飛書機器人：通過 WebSocket 長連接，支持命令控制、會話監聽通知。
- 會話監聽：使用
/監聽命令，Agent 思考完畢後自動通過微信或飛書通知。
安裝與啓用¶
資料中列出了多種安裝與啓用方式，可按本地 DSH 環境選用。
通過 DSH 對話安裝¶
可把下面這句話發給 DSH：
請幫我安裝 dsh-web-remote 遠程訪問插件（https://github.com/godchen520/dsh-web-remote），裝完告訴我如何重啓 DSH Web。
命令行安裝¶
執行：
dsh plugin --profile web add github:godchen520/dsh-web-remote && dsh web
GitHub 包安裝¶
先進入 web profile 目錄：
cd $DSH_HOME/profiles/web
pnpm add github:godchen520/dsh-web-remote
再在 package.json 的 dsh.profile.bundles 數組中添加 "dsh-web-remote"，然後重啓 DSH。
手動 patch¶
把包放入 profile 的 node_modules，在 cordis.patch.yml 追加 web-remote 條目。
bundle 方式需要重啓；cordis.patch.yml 方式會被 HMR 熱加載。
啓動後如何訪問¶
- 啓動後，在 DSH 頁面左下角查看手機圖標。
- 點擊圖標，打開遠程面板。
- 在手機上打開面板給出的公網或局域網鏈接。
公網訪問使用 Cloudflare Quick Tunnel，無需自備公網 IP，也無需註冊。若本機缺少 cloudflared，首次啓動需要聯網下載約 10MB，之後複用緩存。
局域網訪問使用 HTTP/HTTPS 直連；HTTPS 自動生成自簽名證書。局域網來源默認可免 token。
微信與飛書¶
微信機器人¶
dsh-web-remote 支持通過 iLink 協議直連微信，用於 AI 對話、會話控制和模型切換。
資料列出以下命令：
/鏈接
/停止遠程
/監聽
/會話列表
/選擇 N
/切換模型
/選強度 N
/監聽 用於開啓或關閉會話監聽；Agent 思考完畢後會自動向微信或飛書發送通知。
微信綁定的 token 會自動持久化恢復。
飛書機器人¶
飛書機器人支持 WebSocket 長連接，用於命令控制和會話監聽通知。
綁定步驟：
- 打開 DSH Web 面板。
- 進入“機器人”標籤頁，選擇“飛書”。
- 填寫
App ID和App Secret。 - 點擊綁定。
注意¶
- 配置全部可選，不配置即可使用。
- 每次啓動會生成隨機令牌；遠程訪問依賴 HttpOnly Cookie。
- 局域網模式允許私網來源免 token。
- HTTPS 爲自簽名證書，瀏覽器可能提示不安全；按提示繼續訪問。Edge 需要關閉“增強安全性”。
- 公網隧道每次重啓會生成新地址；微信綁定的 token 會自動持久化恢復。
- 自定義公網鏈接，例如 ngrok，可在面板編輯或清除，重啓後生效。
- 局域網 HTTPS 端口可修改，並帶端口占用檢測。
- 插件以當前
dsh進程權限運行；安裝前應檢查源碼與許可證。
鏈接¶
- GitHub: https://github.com/godchen520/dsh-web-remote
- 許可證：MIT
