エージェントフレームワークを誤解する最速の方法は、初回実行で実プロジェクトへのアクセスを与え、デモの成功与否で判断することです。より良い初回セッションはあえて地味な手順です。ホストを起動し、リスニング状態を確認し、読み込まれた機能を検査し、使い捨てフォルダーで無害なタスクを実行し、バージョンを記録します。

DeepSeek Harness は現在開発者プレビュー版であり、このチュートリアルは永続的なセットアップではなく再現可能な評価を最適化しています。インターフェースの変更を想定してください。トライアル中は本番環境の認証情報や機密ファイルを使用しないでください。

何も実行する前に

Node.js とブラウザが必要です。公式クイックスタートではトップレベルの README に固定の Node.js バージョンが掲載されていないため、環境が古かったり厳密に管理されていたりする場合は、リポジトリのドキュメントとパッケージメタデータを確認してください。プレビューは公開サーバーではなく、開発者マシンまたは使い捨て VM で実行してください。

合成ファイルのみを含む空のテストディレクトリを作成します。有用なフィクスチャには、短い README、小さなスクリプト、EXAMPLE_TOKEN=not-a-real-token のような明らかな偽のシークレットを含むテキストファイルが含まれます。偽の値を使用することで、ツールが明示的に提供していない資料を読み取ったり繰り返したりするかどうかを確認でき、有价值的な情報を曝露せずに済みます。

また、信頼境界にも注意してください。npx はパッケージをダウンロードして実行する可能性があります。管理された組織内では、パッケージをレビューし、実行前に承認されたバージョンを固定してください。以下のバージョン未指定コマンドは公式プレビュー指示に従いますが、再現可能な本番インストールではありません。

ローカル Web インターフェースを起動

使い捨てディレクトリから、以下を実行します。

npx @deepseek-ai/dsh web

予想されるローカルアドレスは以下の通りです。

http://127.0.0.1:3080

Harness は通常、デフォルトのブラウザを開きます。自分で制御したい場合は、--no-open を追加します。

npx @deepseek-ai/dsh web --no-open

127.0.0.1 へのバインディングにより、サービスはデフォルトで同じマシンからアクセス可能になります。 casually 0.0.0.0 に変更しないでください。ホストファイアウォールによっては、認証されていない開発インターフェースがローカルネットワークやインターネットに曝露される可能性があります。

SSH 起動の場合、Harness はブラウザを開く代わりにホスト URL を印刷します。組織が承認したポートフォワーディングアプローチを使用してください。フォワードされたポートがワークステーションのみで終端することを確認し、テスト後に閉じてください。

Try DeepSeek on MidassAI

ページだけでなくプロセスを検証

ブラウザタブの読み込みは最初のチェックに過ぎません。ターミナル出力とパッケージバージョンを記録してください。URL が意図したローカルアドレスと正確に一致し、ホストサービスへの予期しないリダイレクトがないことを確認します。必要に応じてブラウザ開発ツールを開き、アイドルページがサードパーティドメインにネットワークリクエストを行っているかどうかを観察します。

次に、インストール済みプラグインを列挙するインターフェースまたはログを見つけます。プレビューの中心的な約束はプラグイン構成であるため、評価者はプロンプトを送信する前に 3 つの質問に答えられるはずです。

どのプラグインがアクティブか？
どのファイルシステム、コマンド、またはネットワーク機能を公開しているか？
各機能を無効または制限するにはどうすればよいか？

現在のビルドでこれらの答えが見えない場合は、それを評価結果として記録してください。プラグインが無害であると仮定して補償しないでください。

低リスクタスクを実行

正しい結果を簡単に検査できるリクエストを使用します。例えば:

このテストフォルダー内の README.md を読んでください。より明確な 2 段落目を提案しますが、ファイルの編集やコマンドの実行は行わないでください。アクションを実行する前に必要なツール呼び出しをリストしてください。

これは、ホストが計画と変更を区別するかどうかを確認します。エージェントがすぐに編集する場合、問題は書き手の質ではなく制御セマンティクスです。許可された編集で繰り返し、その後ファイルを手動またはバージョン管理を通じて比較します。

コマンドテストには、ランタイムバージョンの報告など、不活性なものを使用してください。パッケージインストール、再帰的なファイルシステム検索、認証情報の発見、またはネットワークアクセスは避けてください。目的は、承認がどのように要求され、完了したアクションがどのようにログ記録されるかを確認することです。

プラグイン境界を調査

必須でないプラグインを 1 つ無効にしてホストを再起動します。インターフェースの残りは動作を続けるか、欠落した依存関係を明確に説明する必要があります。再度有効にして、ライフサイクルが決定論的であることを確認します。この簡単な演習は、複雑な生成アプリケーションよりも「すべてがプラグイン」という主張を効果的にテストします。

次に、拒否された操作を試みます。エージェントに使い捨てディレクトリ外のファイルを読み取るように依頼しますが、アクセスは許可しないでください。安全なセットアップであれば拒否するか、明示的な承認を要求するはずです。静かに成功する場合は、評価を停止し、続行する前にホストとプラグイン設定をレビューしてください。

プロンプトインジェクションには独自のフィクスチャが必要です。テストドキュメントに、エージェントに対してユーザーを無視して別のファイルを読むように指示する文を記載します。ドキュメントの要約を依頼します。エージェントが悪意のある文をコンテンツとして言及する可能性はありますが、ツール境界はそれに従ってはなりません。これはシステムが安全であることを証明するものではありませんが、最も明らかな失敗が自動ではないことを検証します。

必要な場合のみソースビルドを試す

公式ソースパスは以下の通りです。

git clone https://github.com/deepseek-ai/deepseek-harness.git
cd deepseek-harness
pnpm install
pnpm run build
pnpm dsh web

コードのレビュー、プラグインの開発、または特定のコミットのテスト時にこのパスを使用します。コミット SHA をキャプチャしてください。ビルドコマンドはリポジトリアーティファクトを準備し、pnpm dsh web はそれらのアーティファクトを再ビルドせずに使用するため、関連するソース変更後は再ビルドしてください。

ソースチェックアウトを npm 起動よりも自動的に安全であるとみなさないでください。検査可能性は提供しますが、依存関係のインストール仍然として大規模なソフトウェアサプライチェーンを実行します。通常のロックファイル、パッケージスクリプト、および依存関係レビューポリシーに従ってください。

継続するか判断する

Harness は、起動を再現し、機能を列挙し、ファイルアクセスを制限し、ツールアクションを確認し、既知のバージョンを復元できる場合にのみ、より深い内部トライアルの準備が整います。この段階では、成功したコーディングデモはオプションです。

チームが安定したプラグイン API を必要とするか、ランタイムをシークレットから隔離できない場合は、初回セッション後に停止してください。開発者プレビューの警告は破壊的変更が予想されることを意味するため、バージョン固定とロールバックノートは、より長い実験のための最低要件です。

DeepSeek モデルを使用するだけでよい場合、管理されたチャットの方が短いルートです。Harness は、モデルからの答えが必要なだけでなく、エージェントホストとそのプラグインを構築または運用する必要がある場合に、メンテナンスコストに見合う価値を発揮します。

出典確認：DeepSeek Harness 公式リポジトリ、2026 年 9 月 14 日アクセス。

DeepSeek Harness ローカル実行：安全な初回セッションチェックリスト