DeepSeek Harness：npx 失敗とポート 3080 の切り分け

これは別のクイックスタートではない

npx クイックスタート は npx @deepseek-ai/dsh web がやがて URL を出す前提です。本稿は初回トラフィックのもう半分向け：端末が固まる、3080 が応答しない、UI は開くがチャットがすべて API エラーで死ぬ。トラブルシュート の検索可能な一覧と併用し、ここでは 確認の順番 を説明します。変数を三つ同時に触らないためです。

正確なフラグは上流のものです。README と本頁が食い違えば README が勝ちます。

梯子 1 — DSH に触る前に Node を証明する

上流プレビューは Node.js ^22.19.0 または >=24.0.0 を求めます。npx を打つ 同じ シェルで node -v と npm -v。別窓の nvm/fnm は数えません。

エンジン違いの症状：取得は始まるが engines 検査で落ちる、あるいは node 自体がない。PATH を直し、端末を開き直してから再試行。「固まっている npx の中で Node を上げる」はやめてください。

梯子 2 — @deepseek-ai/dsh を取得可能にする

初回は大きな依存ツリーを落とします。失敗はタイムアウト、404、古い rc のキャッシュに見えます。

1. スコープを確認：@deepseek-ai/dsh——打ち間違いは半日を溶かします。
2. 社内ミラーが古いなら --registry=https://registry.npmjs.org で再試行。
3. ネットワークとスコープ typo を潰してから、毒化した npx キャッシュを消す。

端末は開いたまま。途中で殺すと半書きのキャッシュを相手にします。

梯子 3 — ポート 3080 はローカルソケットの問題

Web UI はよく http://127.0.0.1:3080/ にバインドします。別プロセスが 3080 を握っていると、プロセスは動いてもブラウザに DSH が出ません。

• 占有者を探す（OS 次第で netstat / lsof / リソースモニタ）。
• 止めるか、上流が示すポートフラグで起動（コミュニティでは dsh web に --port が多い）。
• 初回は localhost。0.0.0.0 は便利ワザではなくセキュリティ判断です。

端末は健全なのに白紙：拡張がローカルスクリプトを止めることがあるので、きれいなプロファイルを試してください。

梯子 4 — UI はあるがチャットが死ぬ（キーと資格情報）

ローカル UI は多くの場合 制御面 であり、オフライン重みではありません。DeepSeek 経由の呼び出しにはプラットフォーム API キーが要ります。モデル id、枠、貼り付け時の余分な空白を確認。

ヘッドレス／CLI は $DSH_HOME/.credentials.yaml（多くは ~/.dsh/.credentials.yaml）を読むことがあります。Unix で権限が緩いとランタイムが拒否します——chmod 600 が定番です。当独立サイトはキーを発行しません。

梯子 5 — プラグイン登場時に pnpm がない

npx で起動しても dsh plugin add はしばしば pnpm を呼び出します。グローバル pnpm 欠如は「UI は動いたのに install 失敗」に見えます。pnpm を入れ、bin を PATH に載せ、再試行——プラグインガイド。

やってはいけないこと

• ポート切り分け中に、最初のワークスペースをホーム全体にしない。
• 3080 が不安定なうちにコミュニティプラグインを三つ積まない。
• 先週のブログを CLI の法としない——評価時はプレビュー版をピン留め。

次に行く場所

1. 健全な導入の物語：npx クイックスタート。
2. OS 一行メモ：インストール。
3. 症状別一覧：トラブルシュート。
4. 動いたらパッケージの海に沈む前に モード を選ぶ。