JavaScript 寫的 DSH 外掛,把電話變成這台電腦的遙控器:掃碼 / 6 位碼 / 異地配對碼三種配對方式、監聽 8899 的區域網路服務、異地時自動拉起的 frpc 通道、兩顆狀態燈,以及帶升級與回復的版本卡。倉庫中繼資料未宣告授權條款,README 末尾寫的是 MIT。
DSH 整合
原生執行環境
作者聲明
安全稽核
未稽核
最後核實
2026-11-16
授權條款
作者未說明
01它能幫你完成什麼?
在手機上接手這台電腦的 DSH 工作階段:讀取工作階段清單、收發訊息、看歷史、傳檔案,同一個網路直接連,不在同一個網路也能連
配對後的鴻蒙 App 直接和外掛的 8899 區域網路服務通訊:`/sessions` 讀取工作階段清單,`/cmd` 負責收發、切換模型、瀏覽檔案、外掛清單、佇列與升級,`/attachment` 取附件——都要帶存取碼;手機不在同一個網路時同樣的流量走 frpc 通道
把 DSH 常駐在桌面或雲端主機上、希望不開遠端桌面就能用手機接著操作的人
不用填 IP 就能完成配對,並且把暴露時間壓到最短
QR Code 裡裝的是一次性票據、App 裡輸入 6 位數字讓手機自己在同一個網路裡找電腦,或 DSH 裝在異地時改用 6 位異地配對碼
在家裡或辦公室同一個 WiFi 下配對的人,以及把 DSH 裝在雲端主機、QR Code 裡的區域網路位址根本連不到的人
把 DeepSeek 網頁版對話並排放在工作階段旁邊,不用來回切換視窗
右側欄多一個「网页聊天」分頁,內容是 chat.deepseek.com;載入失敗時該頁顯示「重新加载」按鈕
同時在用網頁版對話、又不想為它多開一個瀏覽器視窗的 DSH 桌面端使用者
02如何將外掛接入 DeepSeek Harness?
先決條件
- 手機端需要鴻蒙 App「DSH控制台」,只在應用程式商店下載——本倉不提供安裝包
- `--profile` 後面必須寫 profile 名:這個參數不能省,省掉會直接回報 `required option '--profile <name>' not specified`
- 不要在 profile 的 `cordis.patch.yml` 裡再寫一遍 `insert`——套件裡已經帶了,重複寫會讓外掛載入兩次
- 選用:公網存取服務,只在手機和電腦不在同一個網路時才需要
安裝步驟
- 01
執行 `dsh plugin --profile web add dsh-console-hm`,把 `web` 換成你自己的 profile 名(`web` 是預設值)。
$ dsh plugin --profile web add dsh-console-hm
- 02
剛發的版本有時會裝到上一個,這時固定版本號並關掉 pnpm 的最小發佈齡策略重試:`dsh plugin --profile web add dsh-console-hm@latest --config.minimumReleaseAge=0`
$ dsh plugin --profile web add dsh-console-hm@latest --config.minimumReleaseAge=0
- 03
也可以在套件頁安裝:DSH 側欄 → 外掛 → 「添加插件」 → 選 `dsh-console-hm-<版本>.tgz`。
- 04
開發時改用連結:把 `"dsh-console-hm": "link:<你的外掛目錄絕對路徑>"` 寫進 profile 的 `package.json` 相依,再把 `"dsh-console-hm"` 加進 `dsh.profile.bundles` 陣列,然後跑一次 `pnpm install`。
- 05
需要調整時(一般不用動)寫在 profile 的 `cordis.patch.yml` 裡,按 `- id: dsh-console` → `config` 覆寫:`port` 是區域網路服務埠,`name` 是面板上顯示的節點名稱(預設取系統主機名),`allowShiftPort` 控制埠被佔用時是否往後順延。
驗證整合成功
- 開啟 设置 → 导航列表 → DSH控制台(或側欄入口)看兩顆燈:DSH 那顆表示這台電腦的工作階段服務通不通,手機那顆灰著只說明還沒配對,不算錯誤。
- 在原始碼倉裡跑 `node test/selftest.mjs`:不需要裝進 DSH,驗 10 組,自我測試自己佔 18777 和 18888、不碰 8899,所以外掛正常執行時也能跑。
- 面板上的版本卡會顯示 npm 上的版本,可用來確認升級是否真的生效。
復原
- 在面板的升級卡上回復:`[ 检测更新 ] [ 升级 ] [ 回滚 ]`。
03DSH 整合程度與能力邊界
DSH 外掛,套件名 `dsh-console-hm`:用 `dsh plugin --profile web add dsh-console-hm` 安裝後,面板掛在 DSH 介面上的 设置 → 导航列表 → DSH控制台,側欄底部再加兩個入口;面板自身路由(`/api/dsh-console/state`、`/newcode`、`/sessions`、`/cmd`)走 DSH 自己的 `connection.fetch.register` 並帶 DSH 瀏覽器驗證,手機端則由另起的 8899 區域網路服務負責
掃碼配對(一次性票據)
`/qr` 產生 QR Code PNG,載荷是 `dsh-console://pair?b=…&k=pt_…&n=…&i=dsh-console&c=…&v=…`,其中 `k` 是一次性配對票據,不是長期存取碼
每次重新整理都會換一張票據、換一個 `v` 值,讓 QR Code 真的重畫長期存取碼不會出現在 QR Code 載荷裡6 位碼與異地碼換取存取碼
`/claim` 換出存取碼——錯碼 403、格式錯 400、超限 429,成功即核銷
碼換成存取碼之後立刻作廢異地配對要先開啟開關,它的 6 位碼每 15 分鐘自動換一個公網存取與 frpc 通道
開通公網存取服務後由外掛自己拉起通道,手機在行動網路也能連回這台電腦
把 `frpc` 下載到 `~/.dsh/frp`(Windows 下是 `frpc.exe`),先對 size 再對 sha256,任何一項不符都不寫入磁碟使用者手放的 frpc 永遠優先,外掛不會覆寫沒開通公網存取服務的使用者不會觸發下載、不會起程序,面板上也不會多出東西兩顆互不干擾的狀態燈
一顆看手機(App 在前景時每 60 秒心跳,最近 10 分鐘內來過請求就算連著),一顆看 DSH(這台電腦行程內能不能拿到工作階段服務)
手機燈灰著是正常狀態,不是錯誤版本卡與升級 / 回復
面板上顯示目前版本,並提供更新檢查、升級與回復三個動作,版號來自 npm 的版本檢測
升級與回復會替換目前安裝的外掛版本
04適合誰?何時不該用?
適合
- 把 DSH 常駐在桌面或雲端主機上、希望不開遠端桌面就能用手機接著操作的人
- 在家裡或辦公室同一個 WiFi 下配對的人,以及把 DSH 裝在雲端主機、QR Code 裡的區域網路位址根本連不到的人
- 同時在用網頁版對話、又不想為它多開一個瀏覽器視窗的 DSH 桌面端使用者
不適合
- 手機端必須是應用程式商店裡的鴻蒙 App「DSH控制台」,本倉不提供安裝包;也沒有網頁版配對頁——`/`、`/pair`、`/web`、`/pet` 一律 403,配對只走手機 App。
- 區域網路服務預設 8899,6 位碼那條路手機側只探 8899,所以埠被佔用時外掛直接啟動失敗並印出該怎麼辦的日誌,不會偷偷挪;要換埠必須連手機端一起改,只有 `allowShiftPort: true` 才恢復往後順延 20 個埠的行為。
- 異地配對必須先開通公網存取服務,且預設關閉;開關開啟期間,任何拿到公網位址的人都能嘗試配對——票據 5 分鐘一次性、異地碼 15 分鐘作廢、公網來源輸錯 20 次鎖 15 分鐘,README 建議配好之後把它關掉。
- 同一個網路裡拿到存取碼的人就能操控這台電腦的 DSH:能操控 DSH 的路由必須帶存取碼,存取碼每次行程重啟都會變,而 `/api/dsh-console` 面板路由帶 DSH 瀏覽器驗證,直接 curl 會得到 401。
05相容性、維護與安全提醒
- 手機端必須是應用程式商店裡的鴻蒙 App「DSH控制台」,本倉不提供安裝包;也沒有網頁版配對頁——`/`、`/pair`、`/web`、`/pet` 一律 403,配對只走手機 App。
- 區域網路服務預設 8899,6 位碼那條路手機側只探 8899,所以埠被佔用時外掛直接啟動失敗並印出該怎麼辦的日誌,不會偷偷挪;要換埠必須連手機端一起改,只有 `allowShiftPort: true` 才恢復往後順延 20 個埠的行為。
- 異地配對必須先開通公網存取服務,且預設關閉;開關開啟期間,任何拿到公網位址的人都能嘗試配對——票據 5 分鐘一次性、異地碼 15 分鐘作廢、公網來源輸錯 20 次鎖 15 分鐘,README 建議配好之後把它關掉。
- 同一個網路裡拿到存取碼的人就能操控這台電腦的 DSH:能操控 DSH 的路由必須帶存取碼,存取碼每次行程重啟都會變,而 `/api/dsh-console` 面板路由帶 DSH 瀏覽器驗證,直接 curl 會得到 401。
README 寫 MIT,倉庫中繼資料未宣告 · 發佈標籤 ffmpeg-2026-11-09 · 僅作者 README 聲明,未經獨立稽核
06常見問題
怎麼把 dsh-console-plugin 裝進 DeepSeek Harness?
執行 `dsh plugin --profile web add dsh-console-hm`——npm 套件名是 `dsh-console-hm`,不是倉庫名——把 `web` 換成你自己的 profile 名。`--profile` 參數不能省,省掉會直接回報 `required option '--profile <name>' not specified`。剛發的版本有時會裝到上一個,這時指定版本號並關掉最小發佈齡策略:`dsh plugin --profile web add dsh-console-hm@latest --config.minimumReleaseAge=0`。
在 DSH 工作階段裡這塊面板出現在哪?
在 设置 → 导航列表 → DSH控制台,也在外掛頁的設定區;側欄底部還有兩個入口:底欄「DSH控制台」開啟這塊面板,有新版本時圖示上會帶「可更新」小徽章;底欄「网页聊天」在右側欄開啟 chat.deepseek.com,只在 DSH 桌面端可用,因為需要宿主提供 webview 通道。
它會帶來哪些網路暴露?
一個監聽 8899 的區域網路 HTTP 服務,請求帶 `?token=<存取碼>` 或 `x-dsh-console-token` 標頭;`/sessions`、`/cmd`、`/attachment` 不帶存取碼無法使用。異地配對預設關閉且需要先開通公網存取服務,公網來源只能走帶存取碼的路由。面板自己的路由在 `/api/dsh-console` 下,走 DSH 的 `connection.fetch.register`,所以直接 curl 拿到的 401 是設計如此。
一定要裝手機 App 嗎?有沒有網頁版配對?
一定要裝:手機端是應用程式商店裡的鴻蒙 App「DSH控制台」,本倉不提供安裝包。也沒有網頁版配對頁——`/`、`/pair`、`/web`、`/pet` 一律 403,配對只走手機 App。
不裝進 DSH 也能驗證它能用嗎?
可以,在原始碼倉裡跑 `node test/selftest.mjs`。它不需要裝進 DSH,驗 10 組(載荷格式、6 位碼一次性、QR Code 真的能產生、`/claim` 通路、配對頁已刪除、401/403 安全邊界、埠被佔用必須報錯、客戶端與宿主端契約、套件清單),自我測試自己佔 18777 和 18888、不碰 8899,所以外掛正常執行時也能跑。
07相關的 DSH 工作流程
ds-harness-remote
作者 liguobao
基於 DeepSeek Harness 外掛機制構建的遠端訪問方案,通過低延遲、端到端加密的 P2P 網路,支援使用 PC、移動端 和 Web 隨時訪問本地裝置上的DSH 、CodeX、Cursor、Claude Code等工作區。 (Built on DeepSeek Harness plugins, this low-latency, end-to-end encrypted P2P solution lets PC, mobile, and web clients access local DSH, Codex, Cursor, and Claude Code workspaces.)
dsh-windows-mcp
作者 hellohub1212
DeepSeek Harness Windows 桌面自動化外掛,將 CursorTouch/Windows-MCP 接入內建 MCP 客戶端橋接。提供預設關閉的 Computer Use 開關和應用內依賴安裝器。
dsh-desktop
作者 anywhere-labs
為 DeepSeek Harness (DSH) 外掛生態打造的現代化桌面端解決方案。萬物皆「外掛」,桌面本身也是「外掛」。
dsh-go
作者 ccch1mneyyy
dsh-go — DeepSeek Harness 裝進口袋:手機本機執行,也能遙控你的電腦。
08資料與來源
dsh plugin --profile web add dsh-console-hm
挂在 **设置 → 导航列表 → DSH控制台**,也挂在**插件页**的配置区,侧栏底部还有两个入口。
前缀 `/api/dsh-console`,走 DSH 自己的 `connection.fetch.register`,
**带 DSH 的浏览器认证层**,所以裸 curl 会 401 —— 这是对的,不是 bug。
此頁面根據專案公開文件、儲存庫中繼資料與 DSH Plugins 的結構化解析所產生;最後核實於 2026-11-16。發現錯誤?提交更正。
最佳 DeepSeek Harness 外掛
從全目錄挑出的 12 個值得優先安裝的外掛,涵蓋各個分類。
