ディレクトリに戻る

ChenJun25/dsh-console-plugin

キュレーションリスト掲載

chenjun25/dsh-console-plugin

DeepSeek Harness Desktopに表示したQRコードを読み取り、スマートフォンから操作できるコンソールプラグインです。

GitHub で見る
$ dsh plugin --profile web add dsh-console-hm

スマホをデスクトップのリモコンに変える JavaScript 製 DSH プラグイン。QR / 6 桁 / 遠隔ペアリングコード、8899 番の LAN サービス、別ネットワーク用の frpc トンネル、2 つのステータスランプ、アップグレードとロールバック付きのバージョンカードを備えます。リポジトリのメタデータにライセンス表記はなく、README 末尾は MIT です。

DSH 統合

ネイティブ実行

作者による申告

安全性監査

未監査

最終検証日

2026-11-16

ライセンス

作者は未記載

01どんなタスクに使えるのか?

  • デスクトップの DSH セッションをスマホから操作する — セッション一覧の閲覧、メッセージの送受信、履歴の確認、ファイル転送を、同じネットワークでも別の場所からでも

    ペアリング済みの HarmonyOS アプリがプラグインの 8899 LAN サービスと直接やり取りします。`/sessions` でセッション一覧、`/cmd` で送受信・モデル切り替え・ファイル閲覧・プラグイン一覧・キュー・アップグレード、`/attachment` で添付ファイル(いずれもアクセスコード必須)。スマホが別ネットワークのときは同じ通信が frpc トンネルを通ります

    DSH をデスクトップやクラウドサーバーで常時動かし、リモートデスクトップを開かずにスマホから触りたい人

  • IP アドレスを入力せずにペアリングし、露出する時間を最短にする

    QR コードには使い捨てチケットを格納、6 桁コードをアプリに入れて同じネットワーク内の PC を自動探索、DSH が遠隔地にある場合は 6 桁の遠隔ペアリングコードを使用

    自宅やオフィスの同じ Wi-Fi でペアリングする人、およびクラウドサーバー上の DSH を相手にするため QR コード内の LAN アドレスが届かない人

  • DeepSeek の Web 版チャットをセッションの隣に並べ、ウィンドウを切り替えずに使う

    右サイドバーに「网页聊天」タブが増え、中身は chat.deepseek.com。読み込みに失敗すると「重新加载」ボタンが表示されます

    Web 版チャットも併用していて、そのためだけにブラウザウィンドウを増やしたくない DSH デスクトップ利用者

02DeepSeek Harness への導入方法

前提条件

  • スマホ側には HarmonyOS アプリ「DSH控制台」が必要。配布はアプリストアのみで、このリポジトリはインストーラーを提供しません
  • `--profile` の後ろにプロファイル名が必須です。省略すると `required option '--profile <name>' not specified` で失敗します
  • プロファイルの `cordis.patch.yml` に `insert` を書き足さないでください。パッケージ側に含まれており、重複するとプラグインが 2 回読み込まれます
  • 任意: 「公网访问服务」。スマホと PC が同じネットワークにない場合のみ必要です

インストール手順

  1. 01

    `dsh plugin --profile web add dsh-console-hm` を実行します(`web` は自分のプロファイル名に置き換え。既定値は `web`)。

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

  2. 02

    公開直後のバージョンが 1 つ前にインストールされる場合は、バージョンを固定して 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

    開発時はリンクで入れます: プロファイルの `package.json` の依存に `"dsh-console-hm": "link:<プラグインディレクトリの絶対パス>"` を書き、`dsh.profile.bundles` 配列に `"dsh-console-hm"` を追加してから `pnpm install` を 1 回実行します。

  5. 05

    調整(通常は不要)はプロファイルの `cordis.patch.yml` に `- id: dsh-console` → `config` として書きます: `port` は LAN サービスのポート、`name` はパネルに表示するノード名(既定はシステムのホスト名)、`allowShiftPort` はポートが埋まっているときに後ろへずらすかどうかです。

導入成功の確認

  • 设置 → 导航列表 → DSH控制台(またはサイドバーの入口)を開き、2 つのランプを確認します。DSH 側はこの PC のセッションサービスに届くか、スマホ側がグレーのままであっても未ペアリングというだけでエラーではありません。
  • ソースを取得した状態で `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控制台 にパネルが付き、サイドバー下部に 2 つの入口が加わります。パネル側のルート(`/api/dsh-console/state`、`/newcode`、`/sessions`、`/cmd`)は DSH 自身の `connection.fetch.register` 経由で DSH のブラウザ認証の内側に登録され、スマホ側は別に立てた 8899 の LAN サービスが担当します

  • 使い捨てチケットによる QR ペアリング

    `/qr` が返す QR コード PNG。ペイロードは `dsh-console://pair?b=…&k=pt_…&n=…&i=dsh-console&c=…&v=…` で、`k` は長期アクセスコードではなく使い捨てのペアリングチケットです

    更新のたびに新しいチケットと新しい `v` 値が発行され、QR コードが実際に描き直されます長期アクセスコードは QR コードのペイロードに含まれません
  • 6 桁コード / 遠隔コードの交換

    `/claim` がアクセスコードを返します。コード違いは 403、形式エラーは 400、試行超過は 429、成功した時点でコードは使用済みになります

    アクセスコードに交換された時点でコードは無効になります遠隔ペアリングはスイッチを先にオンにする必要があり、その 6 桁コードは 15 分ごとに切り替わります
  • frpc トンネルによる外部アクセス

    「公网访问服务」を有効にすると、プラグイン自身がトンネルを起動し、モバイル回線のスマホからもこの PC に戻れます

    `frpc` を `~/.dsh/frp`(Windows では `frpc.exe`)へダウンロードし、size と sha256 を順に照合して、どちらかが合わなければ一切書き込みません手動で置いた frpc が常に優先され、プラグインが上書きすることはありません「公网访问服务」を有効にしていない利用者には、ダウンロードもプロセス起動も追加のパネルも発生しません
  • 互いに独立した 2 つのステータスランプ

    スマホ側(アプリが前面にある間は 60 秒ごとにハートビート、直近 10 分にリクエストがあれば接続扱い)と、DSH 側(プロセス内でセッションサービスを取得できるか)の 2 つ

    スマホ側がグレーなのは正常な状態で、エラーではありません
  • バージョンカードとアップグレード / ロールバック

    現在のバージョンと、更新確認・アップグレード・ロールバックのボタンをパネルに表示し、バージョンは npm の版数チェックから取得します

    アップグレードとロールバックはインストール済みのプラグインのバージョンを置き換えます

04誰に向いているのか?使うべきでない場面は?

向いている用途

  • DSH をデスクトップやクラウドサーバーで常時動かし、リモートデスクトップを開かずにスマホから触りたい人
  • 自宅やオフィスの同じ Wi-Fi でペアリングする人、およびクラウドサーバー上の DSH を相手にするため QR コード内の LAN アドレスが届かない人
  • Web 版チャットも併用していて、そのためだけにブラウザウィンドウを増やしたくない DSH デスクトップ利用者

不向きな用途

  • スマホ側はアプリストアで配布される HarmonyOS アプリ「DSH控制台」が必須で、このリポジトリはインストーラーを提供しません。Web のペアリングページも存在せず、`/`、`/pair`、`/web`、`/pet` はすべて 403 を返すため、ペアリングはアプリ経由のみです。
  • LAN サービスは既定で 8899 番を使い、6 桁コードの経路はスマホ側が 8899 しか探しません。そのためポートが埋まっているとプラグインは起動に失敗し、対処方法をログに出します(勝手に移しません)。ポートを変えるならスマホ側も同時に変更が必要で、`allowShiftPort: true` のときだけ 20 ポート後ろへずらす動作が戻ります。
  • 遠隔ペアリングは「公网访问服务」が前提で、既定はオフです。オンにしている間は外部アドレスを知る誰もがペアリングを試せます。チケットは 5 分で失効、遠隔コードは 15 分で失効、外部からの誤入力 20 回で 15 分ロックされ、README はペアリング後にスイッチを切ることを勧めています。
  • 同じネットワーク内でアクセスコードを入手した人は、この PC の DSH を操作できます。DSH を操作するルートは必ずアクセスコードを要求し、コードはプロセス再起動ごとに変わります。`/api/dsh-console` のパネルルートは DSH のブラウザ認証の内側にあるため、素の curl では 401 が返ります。

05互換性・メンテナンス・セキュリティ上の注意

  • スマホ側はアプリストアで配布される HarmonyOS アプリ「DSH控制台」が必須で、このリポジトリはインストーラーを提供しません。Web のペアリングページも存在せず、`/`、`/pair`、`/web`、`/pet` はすべて 403 を返すため、ペアリングはアプリ経由のみです。
  • LAN サービスは既定で 8899 番を使い、6 桁コードの経路はスマホ側が 8899 しか探しません。そのためポートが埋まっているとプラグインは起動に失敗し、対処方法をログに出します(勝手に移しません)。ポートを変えるならスマホ側も同時に変更が必要で、`allowShiftPort: true` のときだけ 20 ポート後ろへずらす動作が戻ります。
  • 遠隔ペアリングは「公网访问服务」が前提で、既定はオフです。オンにしている間は外部アドレスを知る誰もがペアリングを試せます。チケットは 5 分で失効、遠隔コードは 15 分で失効、外部からの誤入力 20 回で 15 分ロックされ、README はペアリング後にスイッチを切ることを勧めています。
  • 同じネットワーク内でアクセスコードを入手した人は、この PC の DSH を操作できます。DSH を操作するルートは必ずアクセスコードを要求し、コードはプロセス再起動ごとに変わります。`/api/dsh-console` のパネルルートは DSH のブラウザ認証の内側にあるため、素の curl では 401 が返ります。
2026-10-182026-11-13ffmpeg-2026-11-09

README は MIT 表記、リポジトリのメタデータには記載なし · リリースタグ ffmpeg-2026-11-09 · README の主張のみで独立監査なし

06よくある質問

DeepSeek Harness への導入方法は?

`dsh plugin --profile web add dsh-console-hm` を実行します(npm パッケージ名はリポジトリ名ではなく `dsh-console-hm`)。`web` は自分のプロファイル名に置き換えてください。`--profile` は必須で、省略すると `required option '--profile <name>' not specified` で失敗します。公開直後のバージョンが 1 つ前にインストールされる場合は、バージョンを固定して最小公開経過時間ポリシーを切ります: `dsh plugin --profile web add dsh-console-hm@latest --config.minimumReleaseAge=0`。

DSH のセッション内ではどこにパネルが出ますか?

设置 → 导航列表 → DSH控制台、プラグインページの設定エリア、そしてサイドバー下部の 2 つの入口です。サイドバーの「DSH控制台」はパネルを開き、新しいバージョンがあるとアイコンに「更新あり」バッジが付きます。サイドバーの「网页聊天」は右側に chat.deepseek.com を開きますが、ホスト側の webview チャネルが必要なため DSH デスクトップ版でのみ動作します。

ネットワーク的な露出はどの程度ですか?

8899 番で待ち受ける LAN の HTTP サービスで、リクエストには `?token=<アクセスコード>` か `x-dsh-console-token` ヘッダーが必要です。`/sessions`、`/cmd`、`/attachment` はコードなしでは動作しません。遠隔ペアリングは既定でオフかつ「公网访问服务」が前提で、外部からのリクエストはコード付きルートしか通りません。パネル自身のルートは `/api/dsh-console` 配下で DSH の `connection.fetch.register` を通るため、素の curl で 401 になるのは仕様どおりです。

スマホアプリは必須ですか?Web のペアリング画面はありますか?

必須です。スマホ側はアプリストアで配布される HarmonyOS アプリ「DSH控制台」で、このリポジトリはインストーラーを提供しません。Web のペアリングページもなく、`/`、`/pair`、`/web`、`/pet` はすべて 403 を返すため、ペアリングはアプリ経由のみです。

DSH に入れずに動作確認できますか?

ソースを取得した状態で `node test/selftest.mjs` を実行します。DSH への導入は不要で、10 グループ(ペイロード形式、6 桁コードの使い捨て、QR コードの実生成、`/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。誤りを見つけた場合は、修正を送信してください。

🏆

dsh プラグイン おすすめ

最初に入れたい 12 のプラグイン。全カタログ・全カテゴリから厳選しました。

DSH Plugins は DeepSeek Harness プラグインの独立したコミュニティ ディレクトリです。DeepSeek との提携・公認はありません。サードパーティ製プラグインはセキュリティ監査を受けていません。インストール前にソースコードをご確認ください。

DeepSeek Harnessの新着プラグインを毎週お届け。スパムはありません。