DeepSeek Harness トラブルシュート
初回失敗の多くは環境です。Node → 取得 → ポート → 資格情報 → ワークスペースの順で見てください。
node がない / engines
公式プレビューは Node ^22.19.0 または >=24。同じシェルでバージョンを合わせてから npx。
npx が遅い・404
公式レジストリを指定し、パッケージ名 @deepseek-ai/dsh を確認。
pnpm がない
プラグイン操作は pnpm を呼ぶことが多いです。
3080 が開かない
占用プロセスを止めるか --port を公式ドキュメントどおりに。初回は localhost。
API エラー
ローカル UI は既定でローカル推論ではありません。キーとクォータ、Unix なら credentials の権限。
ファイルが見えない
ワークスペース根を選び直し、ホーム全体を指定しない。
plugin add 失敗
README のコマンドと起動ターミナルの Cordis ログを見る。
アップグレードで壊れた
プレビューは破壊的変更があります。評価ではバージョンを固定。
まだ動かない
エラー全文で GitHub Discussions を検索。インストールとコミュニティプラグインへ戻る。
関連する DeepSeek Harness ページ
インストールをやり直し、ツール挙動がおかしければモードを確認。ハーネスを替える前に FAQ も。