DeepSeek Harness チュートリアル:インストールから headless まで

スクリーンショットで検証済みの 10 ステップ。真っ新しいインストールから Agent プリセット、Creator モードのプラグイン、headless 実行まで——DSH の完全ツアー。

最終更新: 2026-09-14

DeepSeek Harness(DSH)は DeepSeek がオープンソース化したエージェントハーネスで、公開 1 週間で GitHub スター 169,000 を記録しました。ワークスペース、プラグイン、ツール、サブエージェント、差し替え可能なモデル——そして UI まで作り直せる。このガイドは、現時点で最も完成度の高い動画ウォークスルーを、スクリーンショット検証済みの 10 ステップに整理したものです。クリーンインストールからプリセット、プラグイン、サンドボックス、headless 実行まで一気にたどります。

1 ページで読み切れる完全ツアーです。各ステップから元動画の該当シーンへディープリンク。プラグイン導入・モデル切り替え・Agent プリセットといった深掘りテーマは、ページ末尾の専用ガイドへどうぞ。

10 ステップで巡る DSH 全体像

  1. 1

    ハーネスをインストールし、ダッシュボードを起動する

    DeepSeek Harness(DSH)は、モデルに手を与えるオープンソースのハーネスです。ファイルツール、シェル、メモリ、権限。公式ドキュメントの導入方法は 2 つ——npx のワンライナーか、リポジトリの完全 clone(動画は clone を選択)。あとは 1 コマンドで Web UI が起動し、ローカル URL(動画では 127.0.0.1:3080)が表示されます。初回起動時には DeepSeek API キーを求めるダイアログが出ます。

    $git clone https://github.com/deepseek-ai/deepseek-harness
    $pnpm dsh web
    DeepSeek Harness 公式ドキュメントの「Try it now or install from source」ページ。npx のクイックスタートと、リポジトリ全体を clone する git clone コマンドが並んでいます。
    インストールは 2 択:npx ワンライナーか clone——動画は clone を選びました。1:15 に見る
    clone した deepseek-harness フォルダの macOS ターミナルで pnpm dsh web と打ち込むところ。DSH の Web UI を起動するコマンドです。
    1 コマンドで Web UI が起動し、ローカル URL が表示されます。1:38 に見る
  2. 2

    任意のモデルプロバイダーを接続する——DeepSeek だけが選択肢じゃない

    頭脳は DeepSeek である必要はありません。Settings → Models を開き、Add provider をクリック、リストから選択(ドロップダウンは amazon-bedrock から groq まで)、API キーを貼り付けて Apply。動画の作者は OpenRouter を接続し、どのモデルが最適かを試し、タスクごとに簡単に切り替えられるようにしています。プロバイダーが公開しているモデルは、すべてコンポーザーのモデルセレクターに現れます。

    DeepSeek Harness の Settings → Models 画面。プロバイダーのドロップダウンが展開され、amazon-bedrock から groq まで並び、下に API キー欄と Apply ボタン。
    Add provider、選択、キーを貼り付け、Apply——設定はこれ一度きり。2:05 に見る
    DeepSeek Harness のコンポーザーにあるモデルセレクターが展開され、OpenRouter の Claude Opus 5 (Fast)、Claude Sonnet 5 などが並び、一番下に Auto。
    プロバイダーをつなげば、そのモデルがすべてコンポーザーに現れます。2:13 に見る
  3. 3

    何かを頼む前にワークスペースを追加する

    DSH で意味のあるアクションを取るには、フォルダを渡すことが前提です。サイドバーの Add workspace ボタン、またはコンポーザーのワークスペースドロップダウンから追加します。エージェントのセッションはそのフォルダにスコープされる——これは「1 つの仕事に集中する」のと「PC 全体を放し飼いにする」の分岐点です。セッションは永続的で、今日閉じて明日開けば、前の仕事がそのまま残っています。

    DeepSeek Harness のコンポーザー上のワークスペースドロップダウン。.hermes、content-vault-dsh、content-vault-2、dsh-test のフォルダと Add workspace… が見えています。
    まずフォルダを選ぶ——すべてのセッションはそこにスコープされます。2:30 に見る
  4. 4

    すべてはプラグイン——コアに見える部分さえも

    DeepSeek が冒頭で掲げる言葉です。モデルと対話する部分、ツールリスト、何が起きたかのログ、さらにはエージェントの次の一手を駆動するループ——すべてプラグイン。保護されたコアは存在しないので、DSH には永続的なものがなく、何もあなたを縛れません。Settings → Plugins を開けば実感できます。ストレージも、セッションも、承認も、web サーバーさえも Enabled バッジ付きのプラグイン。エコシステムには既にコネクタが揃いつつありますが、DSH は開発者プレビューで、readme も破壊的変更がありうると明言しています。車輪の再発明の前にプラグインディレクトリを確認し、作ったものはプロトタイプとして扱いましょう。

    DeepSeek Harness 開発者プレビューの「Everything is a plugin」バナー。モデル、ツール、Skills、セッション、サンドボックス、ストレージ、スケジューリング、UI のすべてが差し替え可能だと説明しています。
    DeepSeek 自身の言葉:DSH に永続的なものは何もない。4:15 に見る
    DeepSeek Harness の Settings → Plugins 画面。storage-json、workspace、approval、web-server といった内蔵機能が、Enabled バッジ付きのプラグインとして並んでいます。
    ストレージも、承認も、web サーバーも——このリストではただのプラグインです。4:25 に見る
  5. 5

    仕事に合う実行モードを選ぶ

    Settings → Agent presets には、組み込みの再構成が並びます。Standard モードはフルセット:ファイル編集、検索、シェル、Skills、計画、サブエージェント。Code モードは同じツールを公開しつつ、1 つずつ呼び出す代わりに、それらを連結する 1 本のプログラムをモデルに書かせます。Minimal モードはターミナルとファイルエディタの 2 ツールのみ。動画では同一タスク(200 ファイルのリネーム)をベンチマークし、Standard モードは 30 ラウンドトリップ、Code モードは 3 回でした。同じツールでもコストは 3 通り——仕事を終えられる最も安いモードを選びましょう。

    DeepSeek Harness の Agent presets 画面。Standard、Code、Minimal、Creator の 4 枚のモードカードが並び、使用中のプリセットには Set as active ボタンが付いています。
    組み込みプリセットは 4 種類——複製して改造するか、Creator モードに起草させます。5:22 に見る
    DeepSeek Harness のベンチマークグラフ。同一タスク「200 ファイルのリネーム」で、Standard モードは 30 ラウンドトリップ、Code モードは 3 回。
    同じ 200 ファイルのリネーム:Standard は 30 回、Code モードは 3 回。5:32 に見る
  6. 6

    プラグインを説明すれば、Creator モードが作る

    Creator モードは、自分の稼働環境を調べ、メモリ上で新しい部品を試し、あなたが普通の言葉で説明している間に能力を作り上げます。デモのプロンプトはこれだけ:エージェントの中に pong 風のミニゲームを作って。DSH は操作説明を整え、プラグインパッケージを定義し、ゲームはチャット上のフローティングウィンドウとして描画されます。ツール呼び出しの合間も動き続けます。人が書いたコードは 1 行もありません。DSH のカスタマイズは会話であり、プロジェクトではありません。

    DeepSeek Harness の Creator モードが「The Pong game is now live!」と告げ、ネオン色の Pong ウィンドウがチャット上に浮かぶ。ツール呼び出しは裏で継続中。
    1 文で説明して、フローティングウィンドウで稼働——書いたコードはゼロ。6:05 に見る
    DeepSeek Harness の Pong 構築に関する Trajectory サマリーパネル。「Plugin defined: pong-1/pkg-1」とリクエスト時間・トークン統計が表示されています。
    レシート完備:プラグイン定義済み、リクエスト計測済み、トークン集計済み。6:25 に見る
  7. 7

    Trajectory のレシートを読みながら進める

    モデルが見たもの、やったことのすべては追記専用のログに書き込まれ、Trajectory タブがそれを読み返せる画面です。システムプロンプト、コンテキスト注入、推論、すべてのツール呼び出しと結果。問題を起こしたとき、何を伝えられていたかを正確に確認できます。この画面はツールの目録でもあります——bash、skill などが行動範囲のすべてで、リストにないことは起きません(Creator モードで追加は可能)。

    DeepSeek Harness セッションの Trajectory タブ。Duration · 7 Turns · 8 Calls のヘッダー下に、SYSTEM・CONTEXT・USER・ASSISTANT・TOOL の行が並んでいます。
    システムプロンプト、コンテキスト注入、ツール呼び出し——レシートは追記専用のままで。9:28 に見る
  8. 8

    手綱を締める:サンドボックスレベルと承認

    3 つのサンドボックス設定がすべてのセッションを制御します。Read-only は見るだけで触れず、Workspace write はプロジェクトフォルダ内のみ変更でき、Full access は文字通りの全権——OS が下層で強制します。動画では read-only セッションが index.md のコピーを承認まで拒否——作者は拒否ボタンを押しました。「常に許可」の選択肢はありません。Full access は確認ステップを減らす代わりに、警告ダイアログでリスクに同意してから意図的にオンにするものです。普段は workspace write、full access は慎重に。

    DeepSeek Harness の read-only サンドボックスがファイルコピーを拒否し、「the user rejected escalating this command to workspace-write」のエラーを出したところ。
    read-only は見るだけ:コピーはそもそも実行されていません。8:06 に見る
    DeepSeek Harness の「Enable Full access?」確認ダイアログ。フルアクセスは確認ステップを減らす旨の警告とリスク同意のチェックボックス、Cancel / Enable Full access ボタンが見えます。
    フルアクセスは慎重な決断:警告とチェックボックス、そして取り消しはできません。9:05 に見る
  9. 9

    何かに触る前に、計画を提示させる

    Plan モードを使えば、DSH は何もする前にやることを言語化します。コンポーザーで /plan と入力し、タスクを説明、計画を読んでから解放する。計画を読むのは 1 分もかかりません。間違った 40 件のファイル編集の取り消しは数週間に及びかねません。2、3 ファイルを超える仕事には、まず計画を。

    DeepSeek Harness のコンポーザーで /plan と入力すると、「describe your task to generate plan」の補完ヒントが出ます。作業開始前に計画を。
    計画を読んでから、エージェントを解放する。9:55 に見る
  10. 10

    教える、委任する、そして headless で走らせる

    Skills は手順を書き留めた指示ファイルで、プロジェクトに入れることもグローバルにインストールすることもできます——動画では Claude Code のグローバルスキルが自動的に取り込まれました。ゴール(/goal)はセッションにフィニッシュラインを取り付け、結果にたどり着くまで走り続けさせます。ゴールは具体的に。組み込みのスケジューラはありませんが、Creator モードは定期タスクのプラグインを起草してくれます——セッションを閉じると停止しますが。長時間の仕事はサブエージェントに委任され、各自がクリーンなコンテキストを持ちます。あるいはエージェントが使い捨てのワークフロープログラムを書き、成果を追いかけます。最後に headless モード:1 コマンドで答えを表示して終了——ウィンドウもポートもなし。コマンドを実行できるものは、何でもエージェントを動かせます。

    $pnpm dsh --profile headless "<one-off task>"
    DeepSeek Harness のスラッシュコマンドのスキルピッカー。cordis-plugin-development、find-skills、higgsfield 系列のスキルが用途のヒント付きで並んでいます。
    Skills は一度書けば繰り返し使える指示——プロジェクト単位でもグローバルでも。10:35 に見る
    macOS のターミナルで DeepSeek Harness を headless 実行:pnpm dsh --profile headless に続けて引用符で囲んだ 1 回限りのタスクを渡すところ。
    ウィンドウもポートもなし:1 コマンド入れて、1 つの答えを受け取る。13:30 に見る

DeepSeek Harness チュートリアル:FAQ

このツアーによく寄せられる質問。

DeepSeek Harness を最も速くインストールする方法は?

公式ドキュメントには 2 つの方法があります。Web UI を直接起動する npx ワンライナーか、動画のように git リポジトリを clone する方法。どちらでも、1 コマンド(clone したリポジトリでは pnpm dsh web)でダッシュボードがローカル URL(ウォークスルーでは 127.0.0.1:3080)で起動し、初回起動時に API キーを求められます。

DSH を使うのに DeepSeek の API キーは必須ですか?

いいえ。初回起動のポップアップはキーを求めますが、Settings → Models → Add provider ではリスト上の任意のプロバイダーのキーを受け付けます。ウォークスルーでは OpenRouter を使用し、公開されているすべてのモデルをコンポーザーのモデルセレクターからタスクごとに試せます。

どの実行モードから始めるべきですか?

Standard モードです。ファイル編集、検索、シェル、Skills、計画、サブエージェントを備えたフルセットです。安価な繰り返し作業は Minimal モードへ、数十回のラウンドトリップが必要な作業は Code モードへ。動画の 200 ファイルリネームのベンチマークでは、Code モードは 3 回で完了し、Standard は 30 回でした。

DeepSeek Harness は、エージェントがファイルを壊すのをどう防ぎますか?

サンドボックス設定はプロンプトではなく OS が強制します。read-only は見るだけ、workspace write はプロジェクトフォルダ内のみ変更可能、full access は何でもできます。ウォークスルーでは read-only セッションが明示的な承認までファイルのコピーを拒否しました。「常に許可」のオプションはありません。full access は警告ダイアログ経由で意図的に有効化するものであり、既定にすべきではありません。

DSH は本当に自分自身のプラグインを作れるのですか?

はい、Creator モードの仕事です。欲しい能力を普通の言葉で説明すると、稼働環境を調べ、メモリ上で部品を試し、プラグインパッケージを定義します。動画では 1 文でチャット内で動く Pong ゲームを作り、後半では定期タスクのプラグインを起草させていました——セッションが生きている間だけ動く点に注意です。

Web UI なしで DeepSeek Harness を実行できますか?

headless モードは、タスクを渡す 1 コマンドで答えを表示して終了します。ウィンドウもポートもリスナーもなし。だからこそスクリプトやスケジュールタスク、他のエージェントツールがターミナルから DSH を呼べます。コマンドを実行できるものは、何でもエージェントを動かせます。

関連ガイド

このツアーの各ピースを、さらに深く。

ソースとクレジット

本ページのスクリーンショットはすべて、下記の公開画面録画から取得したもので、各画像から撮影された瞬間へディープリンクで戻れます。内容は公式ドキュメントと突き合わせて確認しています。

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

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