返回目錄

ChenJun25/dsh-console-plugin

精選清單收錄

chenjun25/dsh-console-plugin

為 DeepSeek Harness 提供遠端控制能力的控制台外掛。

前往 GitHub
$ dsh plugin --profile web add dsh-console-hm

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`——套件裡已經帶了,重複寫會讓外掛載入兩次
  • 選用:公網存取服務,只在手機和電腦不在同一個網路時才需要

安裝步驟

  1. 01

    執行 `dsh plugin --profile web add dsh-console-hm`,把 `web` 換成你自己的 profile 名(`web` 是預設值)。

    $ dsh plugin --profile web add dsh-console-hm

  2. 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

  3. 03

    也可以在套件頁安裝:DSH 側欄 → 外掛 → 「添加插件」 → 選 `dsh-console-hm-<版本>.tgz`。

  4. 04

    開發時改用連結:把 `"dsh-console-hm": "link:<你的外掛目錄絕對路徑>"` 寫進 profile 的 `package.json` 相依,再把 `"dsh-console-hm"` 加進 `dsh.profile.bundles` 陣列,然後跑一次 `pnpm install`。

  5. 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 外掛,套件名 `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。
2026-10-182026-11-13ffmpeg-2026-11-09

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,所以外掛正常執行時也能跑。

08資料與來源

  • 作者聲明github.coma2f18d5d4343…

    dsh plugin --profile web add dsh-console-hm

  • 作者聲明github.coma2f18d5d4343…

    挂在 **设置 → 导航列表 → DSH控制台**,也挂在**插件页**的配置区,侧栏底部还有两个入口。

  • 作者聲明github.coma2f18d5d4343…

    前缀 `/api/dsh-console`,走 DSH 自己的 `connection.fetch.register`,

  • 作者聲明github.coma2f18d5d4343…

    **带 DSH 的浏览器认证层**,所以裸 curl 会 401 —— 这是对的,不是 bug。

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

🏆

最佳 DeepSeek Harness 外掛

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

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

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