スマホをデスクトップのリモコンに変える 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 が同じネットワークにない場合のみ必要です
インストール手順
- 01
`dsh plugin --profile web add dsh-console-hm` を実行します(`web` は自分のプロファイル名に置き換え。既定値は `web`)。
$ dsh plugin --profile web add dsh-console-hm
- 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
- 03
プラグインページから入れることもできます: DSH サイドバー → 插件 → 「添加插件」 → `dsh-console-hm-<バージョン>.tgz` を選択。
- 04
開発時はリンクで入れます: プロファイルの `package.json` の依存に `"dsh-console-hm": "link:<プラグインディレクトリの絶対パス>"` を書き、`dsh.profile.bundles` 配列に `"dsh-console-hm"` を追加してから `pnpm install` を 1 回実行します。
- 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-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 が返ります。
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 には触れないため、プラグインを動かしたままでも実行できます。
07関連する DSH ワークフロー
ds-harness-remote
by liguobao
DeepSeek Harnessのマルチデバイス遠隔アクセスプラグイン。低遅延・エンドツーエンド暗号化のP2P優先ネットワークで、PC・Android・WebからリモートのHarnessを安全に操作できます。
dsh-windows-mcp
by hellohub1212
CursorTouchとWindows-MCPをDSHにつなぐWindowsデスクトップ自動化ブリッジ。Computer Useは初期オフで、依存関係をアプリ内インストーラーから導入できます。
dsh-desktop
by anywhere-labs
DeepSeek Harness(dsh)プラグインエコシステム向けのモダンなデスクトップクライアント。すべてが「プラグイン」であり、デスクトップそのものもプラグインとして機能します。
dsh-go
by ccch1mneyyy
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。誤りを見つけた場合は、修正を送信してください。
dsh プラグイン おすすめ
最初に入れたい 12 のプラグイン。全カタログ・全カテゴリから厳選しました。
