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
安裝步驟
- 01
在 Harness 裡:側邊欄 **Plugins** → **Add plugin** → 貼上 `https://github.com/sorsama/deepseek-harness-relay` → **Install**
- 02
pnpm 詢問 git 套件的建置腳本時選擇 **Allow these scripts and retry**;建置完成後選擇 **Enable now**
- 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
- 04
也可以裝已建置好的套件:`dsh plugin --profile web add dsh-relay` —— 同一份程式碼並帶 `lib/`,不執行任何建置腳本
$ dsh plugin --profile web add dsh-relay
- 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 整合程度與能力邊界
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 的設定與憑證。
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 自己的連接埠上加指向中繼來源的轉向:桌面應用程式視窗無法完成到中繼自簽憑證的轉向,而這個失敗對應用程式是致命的。
07相關的 DSH 工作流程
dsh-im
作者 xmanrui
通過掃碼或機器人憑據把IM機器人接入DeepSeek Harness(支援飛書、微信、釘釘、企業微信、QQ、Slack、Telegram、Discord和WhatsApp)。 Connect IM bots to DeepSeek Harness via QR code or credentials (9 channels).
dsh-aurabot-qq
作者 aureth-labs
讓 DeepSeek Harness 裡的 AI 以「大肥魚」住進 QQ:會聊天、發表情、發語音、記事、發空間、刷 B 站、唱歌。功能都是模組,能開關、能自己寫,還能從模組市場裝更多(SnowLuma / OneBot v11)。
dsh-qqbot
作者 tencent-connect
讓 QQ Bot 接入 DeepSeek Harness(dsh)的官方外掛
dsh-wechat
作者 xcisxc29
DeepSeek Harness 微信頻道
08資料與來源
dsh-relay is a plugin for the harness's web profile.
dsh plugin --profile web add https://github.com/sorsama/deepseek-harness-relay
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 個值得優先安裝的外掛,涵蓋各個分類。
