返回目錄

deepseek-harness-relay

精選清單收錄維護狀態: 活躍

sorsama/deepseek-harness-relay

遠端訪問中繼:TLS、二維碼/口令裝置配對、密碼登入與按裝置吊銷,安全地遠端訪問本機 DSH。

前往 GitHub專案首頁
$ dsh plugin --profile web add https://github.com/sorsama/deepseek-harness-relay

17

星數

6

Fork

TypeScript

語言

MIT

授權條款

2026-08-21

建立於

2026-11-09

最近推送

MIT 授權的 TypeScript 外掛程式,替一個完全不用改動的回路 DeepSeek Harness 加上 HTTPS、密碼登入與 QR 碼 / 8 位數配對碼裝置配對,並提供 mDNS 探索、裝置個別撤銷與兩台電腦之間的一鍵連結。

DSH 整合

原生執行環境

作者聲明

安全稽核

未稽核

最後核實

2026-11-16

授權條款

MIT

01它能幫你完成什麼?

  • 不用把 Harness 開放給整個 Wi-Fi,也能用手機或另一台電腦存取它

    中繼連接埠上的 TLS、密碼驗證與裝置配對,而 Harness 始終留在 127.0.0.1 上——中繼掛掉時 Harness 只是無法連線,而不是被暴露

    在筆電或桌機上執行 Harness 網頁設定、希望手機或平板能用上(或經連接埠轉送從外網存取)、又不想把 Harness 綁到 0.0.0.0 的人

  • 一台一台地配對裝置,之後隨時單獨切斷其中任意一台

    `/relay/devices` 裡帶名稱、持有獨立 token 的裝置,可單獨撤銷的能力,以及會輪換簽章金鑰的「全部登出」按鈕

    把同一個中繼分給手機、平板和第二台電腦使用、希望每台都能單獨撤銷的人

  • 把兩台電腦連結起來,任一台都能一鍵開啟另一台的 Harness

    兩側 Computers 頁面都會列出這條連結,**Open** 會給目前瀏覽器簽發一次性登入,直接進到另一台電腦的 Harness 而不用重打密碼

    同時有桌機和筆電、兩台都裝了 dsh-relay,而且用瀏覽器而非桌面應用程式的人

02如何將外掛接入 DeepSeek Harness?

先決條件

  • 帶網頁設定的 DeepSeek Harness —— 中繼是該設定的外掛程式,桌面應用程式執行的是同一個設定
  • Harness 仍留在回路位址:刪掉 `~/.dsh/profiles/web/cordis.patch.yml` 裡把它綁到 `0.0.0.0` 的那一行,因為中繼不會在一個已經開放至網路上的 Harness 前面啟動
  • `dsh` 在 PATH 上,否則每條指令都改用 `npx @deepseek-ai/dsh ...`
  • 與 Harness 相符的中繼版本 —— Harness 0.1.7-rc.2 到 0.2.x 用 0.3

安裝步驟

  1. 01

    在 Harness 裡:側邊欄 **Plugins** → **Add plugin** → 貼上 `https://github.com/sorsama/deepseek-harness-relay` → **Install**

  2. 02

    pnpm 詢問 git 套件的建置腳本時選擇 **Allow these scripts and retry**;建置完成後選擇 **Enable now**

  3. 03

    終端機方式:`dsh plugin --profile web add https://github.com/sorsama/deepseek-harness-relay`;桌面應用程式改為 `dsh plugin --profile desktop add https://github.com/sorsama/deepseek-harness-relay`

    $ dsh plugin --profile web add https://github.com/sorsama/deepseek-harness-relay

  4. 04

    也可以裝已建置好的套件:`dsh plugin --profile web add dsh-relay` —— 同一份程式碼並帶 `lib/`,不執行任何建置腳本

    $ dsh plugin --profile web add dsh-relay

  5. 05

    在執行 Harness 的那台機器上開啟 `https://127.0.0.1:3443/relay/password` 設定第一個密碼,再到 `https://127.0.0.1:3443/relay/pair` 用 QR 碼或 8 位數配對碼配對手機

驗證整合成功

  • `https://127.0.0.1:3443/relay/health` 在中繼啟動後會有回應
  • Harness 啟動時會印出中繼位址;桌面應用程式在啟用外掛程式後需要結束再重開
  • 配對的手機會帶著你給的名稱出現在 `/relay/devices` 下

03DSH 整合程度與能力邊界

DSH 整合原生執行環境

Harness 網頁設定的原生 DSH 外掛程式 —— 用 `dsh plugin --profile web add https://github.com/sorsama/deepseek-harness-relay` 安裝後,它在 :3443 上自建監聽,並往 Harness 介面加入 **Relay** 操作、一組 `/relay/*` 頁面與 **Plugins → dsh-relay → Configure** 設定頁

  • TLS 終止與密碼登入

    來自網路上手機或瀏覽器的 HTTPS 請求→只有密碼(或已配對裝置的憑證)通過後才建立工作階段;錯誤次數過多會暫時鎖定該位址

    Harness 留在回路位址上,中繼作為它旁邊的第二個監聽埠執行
  • QR 碼 / 8 位數配對碼裝置配對

    掃碼,或在手機上輸入 8 位數配對碼,再給裝置取個名稱→`/relay/devices` 下帶名稱、持有獨立 token 的裝置

    配對後的裝置會記錄在 `/relay/devices`,可以單獨撤銷
  • mDNS 探索(`_dsh._tcp`)

    中繼在 `_dsh._tcp` 上廣播,App 不必掃描網段就能找到它

  • Harness 介面內的 Relay 頁面

    原樣的 Harness 介面,外加角落的 **Relay** 連結與側邊欄底部的 **Relay** 操作

    按 **Relay** 會讓目前應用程式原地切換到中繼的配對、裝置與密碼頁面,仍在同一個視窗裡
  • Computers:兩台電腦之間的一鍵連結

    另一台電腦的位址、配對碼與憑證指紋→兩側 Computers 頁面都列出這條連結,**Open** 用一次性登入把目前瀏覽器送到另一台 Harness

    連結會同時記錄在兩台電腦上,任一側 **Unlink** 都能結束它

04適合誰?何時不該用?

適合

  • 在筆電或桌機上執行 Harness 網頁設定、希望手機或平板能用上(或經連接埠轉送從外網存取)、又不想把 Harness 綁到 0.0.0.0 的人
  • 把同一個中繼分給手機、平板和第二台電腦使用、希望每台都能單獨撤銷的人
  • 同時有桌機和筆電、兩台都裝了 dsh-relay,而且用瀏覽器而非桌面應用程式的人

不適合

  • 中繼只在 Harness 留在回路位址時成立:若發現 Harness 已在網路位址上監聽,它會拒絕啟動;同時它把回路視為你本人,因此在 `127.0.0.1:3443` 前面再加一層回路代理(Tailscale Funnel / Serve、nginx、Caddy)就完全不會要求密碼。
  • 桌面應用程式裡絕不要從 Harness 自己的連接埠加一條指向中繼來源的轉向:應用程式視窗無法完成到中繼自簽憑證的轉向,而這個失敗對應用程式是致命的。桌面應用程式也完全無法載入遠端 Harness。
  • Harness 與中繼的版本必須相符:README 把 Harness 0.1.7-rc.2 到 0.2.x 對應到 dsh-relay 0.3,版本範圍不符時 Harness 會拒絕載入該外掛程式。
  • 0.8.0 之前的 DSH Mobile 完全不送出憑證,中繼只能靠記住手機的網路位址放行——README 明確說這不是真正的驗證。另外那條純 HTTP 監聽(`DSH_RELAY_PLAIN_PORT`)沒有登入與配對頁面,也永遠存取不到 Harness 的設定與憑證。

05相容性、維護與安全提醒

  • 中繼只在 Harness 留在回路位址時成立:若發現 Harness 已在網路位址上監聽,它會拒絕啟動;同時它把回路視為你本人,因此在 `127.0.0.1:3443` 前面再加一層回路代理(Tailscale Funnel / Serve、nginx、Caddy)就完全不會要求密碼。
  • 桌面應用程式裡絕不要從 Harness 自己的連接埠加一條指向中繼來源的轉向:應用程式視窗無法完成到中繼自簽憑證的轉向,而這個失敗對應用程式是致命的。桌面應用程式也完全無法載入遠端 Harness。
  • Harness 與中繼的版本必須相符:README 把 Harness 0.1.7-rc.2 到 0.2.x 對應到 dsh-relay 0.3,版本範圍不符時 Harness 會拒絕載入該外掛程式。
  • 0.8.0 之前的 DSH Mobile 完全不送出憑證,中繼只能靠記住手機的網路位址放行——README 明確說這不是真正的驗證。另外那條純 HTTP 監聽(`DSH_RELAY_PLAIN_PORT`)沒有登入與配對頁面,也永遠存取不到 Harness 的設定與憑證。
2026-08-212026-11-09v0.4.0

MIT · 最新發布 v0.4.0(2026-11-09)· 活躍維護,README 在 Harness 0.1.7-rc.2 到 0.2.x 上實測

06常見問題

怎麼把 dsh-relay 裝進 DeepSeek Harness?

在側邊欄開啟 **Plugins**,選 **Add plugin**,貼上 `https://github.com/sorsama/deepseek-harness-relay` 後按 **Install**。首次安裝會在暫存副本裡建置外掛程式,所以 pnpm 詢問時要選 **Allow these scripts and retry**,完成後選 **Enable now**。終端機裡同一個位址也能用:`dsh plugin --profile web add https://github.com/sorsama/deepseek-harness-relay`(桌面應用程式改用 `--profile desktop`);想要已建置好的套件則用 `dsh plugin --profile web add dsh-relay`,它不會執行建置腳本。

它對應哪個 Harness 版本?

README 的表格把 Harness 0.1.7-rc.2 到 0.2.x 對應到 dsh-relay 0.3(在 0.2.1-rc.3、0.2.0-rc.2 與 0.1.7-rc.2 上實測過)。版本不符時 Harness 會拒絕載入,並告訴你它需要哪個範圍:0.3 依賴 Harness 0.1.7 才有的設定系統,而 0.2 會讓 0.1.7 以後的網頁應用程式卡住。

還沒設密碼時,網路上的人會不會搶先占用中繼?

不會。密碼還不存在時,這個頁面只能從執行 Harness 的那台機器開啟。而那台機器本身也不需要密碼:中繼把回路視為你本人,因為能坐到那個鍵盤前的人本來就有 shell。

配對後的裝置能做什麼,怎麼切斷?

每台配對裝置有自己的 token,會出現在 `/relay/devices` 裡,可以單獨撤銷。配對碼一次性使用、五分鐘後失效,而且只能在執行 Harness 的那台機器上產生。**全部登出** 按鈕會輪換簽章金鑰,一次把所有瀏覽器與裝置登出。

可以放在 Tailscale、nginx 或 Caddy 後面嗎?

不要。這些代理都從回路連進來,而中繼把回路視為你本人,因此不會向任何人要求密碼。要暴露到公網,README 的建議是:只轉送中繼的連接埠、絕不轉送 Harness 的連接埠;用真實憑證;設定 `compat.addressGrants: false` 與 `privilegedMethods: loopback-only`。也不要在 Harness 自己的連接埠上加指向中繼來源的轉向:桌面應用程式視窗無法完成到中繼自簽憑證的轉向,而這個失敗對應用程式是致命的。

08資料與來源

  • 作者聲明github.com62d7315bce02…

    dsh-relay is a plugin for the harness's web profile.

  • 作者聲明github.com62d7315bce02…

    dsh plugin --profile web add https://github.com/sorsama/deepseek-harness-relay

  • 作者聲明github.com62d7315bce02…

    A settings page at **Plugins → dsh-relay → Configure** on the machine running the harness. Changes apply when you press…

此頁面根據專案公開文件、儲存庫中繼資料與 DSH Plugins 的結構化解析所產生;最後核實於 2026-11-16。發現錯誤?提交更正。

🏆

最佳 DeepSeek Harness 外掛

從全目錄挑出的 12 個值得優先安裝的外掛,涵蓋各個分類。

DSH Plugins 是獨立的 DeepSeek Harness 外掛目錄,與 DeepSeek 官方無關,也不代表官方背書。第三方外掛未經安全稽核,安裝前請審查原始碼。

每週取得最新的 DeepSeek Harness 外掛,絕不濫發。