前言¶

DeepSeek Harness（DSH）默認在本機 Web 端口提供服務，手機或另一臺電腦要連進來，常見做法是改端口轉發、自建反向代理，或單獨配 Cloudflare Tunnel。每一步都要自己管 cloudflared、域名和 HTTPS，還要處理瀏覽器對 Host、Origin、WebSocket 的限制，移動端往往和本機用的不是同一套地址。

下面介紹社區插件 dsh-public-edge（維護者 ArtificialAngels，分類：聯網工具）。它在 DSH 設置裏提供「公網訪問」面板：一鍵啓停 Cloudflare quick tunnel，複製帶 token 的公網鏈接與二維碼；同時內置局域網橋，讓局域網設備與公網入口走同一套轉發邏輯。插件以 MIT 許可發佈，當前資料中的版本號爲 0.2.1，未發佈到 npm，需從 GitHub 安裝。

這是什麼¶

dsh-public-edge 是 DSH 的 host 插件：啓動後在本機監聽可配置的橋端口（默認 8787），把流量轉到 DSH Web 服務，並可選拉起 cloudflared 做免賬號、免域名的 trycloudflare.com 快速隧道。控制面通過 DSH 已鑑權的 /api 通道，設置頁 UI 掛在 頭像菜單 → 設置 → 公網訪問。cloudflared 缺失時會自動下載到 ~/.dsh/dsh-public-edge/；GitHub 直連失敗時可按配置嘗試鏡像前綴。

核心功能¶

一鍵啓停與公網鏈接¶

在設置 → 公網訪問 → 啓動 後，插件運行 Cloudflare quick tunnel（HTTPS 由 Cloudflare 終結）。面板展示形如 https://<隨機>.trycloudflare.com/?token=… 的鏈接，支持一鍵複製；隧道重連域名變化時可用 換地址 刷新。不用時點 停止 即可。

二維碼與本機配對頁¶

面板內可展示二維碼；也可在本機瀏覽器打開 http://127.0.0.1:8788/pair（僅允許本機訪問）掃碼。首次通過帶 token 的鏈接打開後，瀏覽器會獲得 cookie（資料說明有效期 30 天），之後訪問裸隧道地址也可進入。

局域網橋¶

橋默認監聽 0.0.0.0:8787，轉發到 DSH 本機 Web 端口，並自動改寫 Host、剝掉 Origin / Sec-Fetch-*、透傳 WebSocket，便於手機與 PC 在局域網內使用同一入口。經橋訪問的 /pair 返回 404，token 配對頁只在本機迴環端口提供；經隧道的響應會補 Secure cookie 與 HSTS。

工具鏈與安全邊界¶

未指定 cloudflaredPath 時插件自動下載二進制（首次啓動約 55 MB，視網絡約 1–5 分鐘，面板可顯示進度或錯誤）。鏈接中的 token 等同 DSH 進程令牌，具有本機 DSH 的控制能力；公網入口認證依賴該 token，無額外密碼層。Cloudflare 作爲 TLS 終點，流量在 Cloudflare 側爲明文；quick tunnel 無 SLA、域名隨機。需要固定域名或 Cloudflare Access 等能力時，需自行用 Cloudflare 賬號做 named tunnel，本插件不包含該部分。

安裝與啓用¶

本插件沒有發佈到 npm，插件市場內可能搜不到名稱，應使用倉庫地址安裝。裝完後需完全退出 DSH 再打開（host 插件在啓動時加載）。

倉庫地址（複製這一條）：

https://github.com/ArtificialAngels/dsh-public-edge

方式 A：插件頁粘貼地址（推薦）¶

1. 打開 DSH → 左側 插件 → 右上 添加插件；
2. 將上述倉庫地址粘貼到輸入框（支持包名、GitHub 倉庫地址或本地目錄路徑）；
3. 點 安裝；
4. 完全退出 DSH 再打開。

方式 B：命令行¶

dsh plugin 會把參數轉發給 profile 裏的 pnpm：

# Windows / DSH-Portable
E:\DSH-Portable\dsh.exe plugin --profile web add https://github.com/ArtificialAngels/dsh-public-edge

# 固定版本（推薦，避免跟着 main 走）
E:\DSH-Portable\dsh.exe plugin --profile web add github:ArtificialAngels/dsh-public-edge#v0.2.1

非 Portable 安裝時，將可執行文件換成本機的 dsh，--profile 按實際 profile 名（默認 web）。

方式 C：本地 tgz¶

從 Release 下載 dsh-public-edge-0.2.1.tgz（https://github.com/ArtificialAngels/dsh-public-edge/releases/tag/v0.2.1），在插件頁粘貼本地路徑，或：

E:\DSH-Portable\dsh.exe plugin --profile web add file:E:/path/to/dsh-public-edge-0.2.1.tgz

方式 D：手動寫 profile¶

在 <DSH_HOME>\profiles\web 下執行 pnpm add https://github.com/ArtificialAngels/dsh-public-edge，並把 "dsh-public-edge" 加入同目錄 package.json 的 dsh.profile.bundles 數組，重啓 DSH。

啓用：重啓後在 設置 → 公網訪問 點「啓動」。驗證可查看 profile 內 node_modules\dsh-public-edge\package.json 的版本，或在 dsh.stdout.log 中搜索 [public-edge] tunnel url:。

典型用法¶

1. 打開 DSH → 頭像 → 設置 → 公網訪問 → 啓動，待狀態爲「運行中」，記錄面板上的隧道地址與帶 token 的鏈接。
2. 點 複製鏈接，在手機瀏覽器打開；或本機訪問 http://127.0.0.1:8788/pair 掃碼。
3. 首次帶 token 訪問成功後，可依賴 cookie 在短期內直接打開裸地址；域名變更時使用 換地址。
4. 不用公網時點 停止；若 token 可能泄露，重啓 DSH（token 換新）並 換地址。

資料註明：手機端「Helm·DSH」一類 App 目前只認 主機:端口 的局域網地址，公網訪問請用瀏覽器。

配置¶

默認一般無需修改。在 profile 的 cordis.patch.yml 中按 id 覆蓋：

- id: public-edge
  config:
    port: 8787                # 橋端口（局域網訪問端口 = 它）
    autoStart: true           # DSH 啓動時自動開隧道
    cloudflaredPath: ""       # 留空 = 自動；也可指定已有的 cloudflared 可執行文件
    downloadMirrors:          # cloudflared 下載鏡像前綴，按順序嘗試（"" = GitHub 直連）
      - ""
      - "https://gh-proxy.com/"
      - "https://ghfast.top/"

適用場景與注意¶

適合需要在不自備域名的情況下，臨時把本機 DSH 暴露爲 HTTPS 公網入口，並同時讓局域網設備走統一橋接的場景。插件與 DSH 同進程權限運行，安裝前應閱讀 GitHub 倉庫 源碼與 MIT 許可證，自行評估 token 泄露與 Cloudflare 可見性的風險。橋監聽 0.0.0.0 時，Windows 可能彈出防火牆提示；局域網僅在有需要時啓動亦可。

卸載示例：

E:\DSH-Portable\dsh.exe plugin --profile web remove dsh-public-edge

重啓 DSH；可選刪除 ~/.dsh/dsh-public-edge/ 下已下載的 cloudflared。

結尾¶

dsh-public-edge 把 Cloudflare quick tunnel、帶 token 的鏈接/二維碼與局域網橋收進 DSH 設置頁，減少自建隧道與頭字段處理的重複勞動。社區目錄頁：SkillHub · dsh-public-edge；源碼與完整說明：GitHub · ArtificialAngels/dsh-public-edge。