learn
DeepSeek Harness 使い方ガイド｜インストール・設定・プラグイン開発
ユーザーとプラグイン開発者のための実践ガイド。ハーネスの起動、プロファイルとプリセットの理解、安全なプラグインのインストール方法、自作プラグインの作り方までをカバーします。
グローバルにインストールして Web プロファイルを起動し、API キーを貼り付けます（環境変数に設定済みならスキップ）。あとはすべてプラグインです。
この dsh ガイドでわかること
DeepSeek Harness（dsh）は、DeepSeek 公式のオープンソース エージェントランタイムです。モデルが脳、ハーネスが体、その体のすべてのパーツがプラグイン。このガイドは DeepSeek Harness の「欠けていたマニュアル」です。宣伝も余計な飾りもなく、ハーネスが実際にどう組み合わさっているかだけを解説します。
初めての方はガイドを順番に進めるのがおすすめです。必要なセクションに直接飛ぶこともできます。
- /01dsh を動かす — インストール、最初のタスク、4 つのモード
- /02組み立てを理解する — バンドル、プロファイル、パッチ、プリセット
- /03安全に使う — サンドボックス階層、承認、シークレット
- /04エコシステムに参加する — プラグインを探す・インストールする・公開する
guides
まずはここから
ハーネスとは何か、そして 5 分の初回実行。
DeepSeek Harness とは
エージェント = モデル + ハーネス。プロファイルとパッチ、プリセット、4 つのモードを解説します。
dsh プラグインとは
dsh プラグインとは何か、何を変えられるのか、プラグインツリーがどう構成されるのかを解説します。
クイックスタート：5 分で dsh を動かす
DeepSeek Harness のインストール、Web UI の起動、最初のタスクの実行、適切なモードの選び方まで。
DeepSeek Harness：10 ステップの完全ツアー
git clone から headless モードまで——インストール、プロバイダー接続、プリセット、Creator モードでのプラグイン生成、サンドボックスと Trajectory を 1 本のガイドで。
dsh CLIチートシート
インストールと起動、モード対照、プラグイン管理、設定の確認、バージョン固定——手元に置きたい dsh コマンドをすべて、公式ドキュメント照合済みでまとめました。
要件定義からリリースまで、DSH で本物のプロジェクトを完走
要件の徹底ヒアリングで CONTEXT.md と ADR を固め、PRD に整理し、GitHub の issue に分割。あとはタスクごとに開発・マージ・実機検収まで。
DeepSeek Harness サブエージェントとマルチエージェント実践
5つのサブエージェントを並列実行：ヘッダーから各子を監視し、完了レポートを確認し、サブエージェントごとにモデルを指定。スクリーンショット付きの手順
dsh セッション履歴の再生と振り返り
Trajectory パネルを開き、構造化されたレシートを読み、ターン単位で失敗を特定し、任意のステップから分岐して再実行。スクリーンショット付き解説
dsh セッションのバックアップと移行：隔離レーン実践
dsh インストールを専用 HOME とポートを持つ隔離レーンに複製し、セルフチェックで検証してからインプレース更新、会話はレーン単位でバックアップ——検証済みスクリーンショット 7 枚。
DeepSeek Harness Windows インストールガイド
実機スクリーンショットでたどる 10 ステップ:Node.js、npm のグローバルインストール、ポート 3080 の Web UI、API キー。WSL 不要で Windows 10/11 に対応。
Mac に DeepSeek Harness をインストール
スクリーンショット付きで検証済みの macOS インストール手順。npx コマンド 1 つ、API キー不要、第 7 ステップでプロバイダー接続まで。
DeepSeek Harness Linux インストール
実フレーム検証済みの Linux インストールガイド：Node.js、npx コマンド 1 つ、プロバイダー設定。Windows ユーザー向けの WSL 手順つき。
DeepSeek Harness デスクトップアプリ：公式 vs コミュニティ製
公式 Web UI、DSHDesktop などのコミュニティ製クライアント、そして安全なダウンロードのチェックリスト。
DSH Desktop を手順どおりに導入
スター数最多のコミュニティクライアントを 13 枚のスクリーンショットで追う検証済み手順：実際のダウンロード先、macOS の DMG と Windows の NSIS ウィザード、初回起動、そして入手したファイルの 4 点確認。
Ollama & 無料モデル
DeepSeek Harness を OpenRouter の無料モデルやローカル Ollama につなげば、有料 API キーなしでセッションを実行できます。
dsh を無料モデルで：OpenRouter 実践
DeepSeek キーをスキップし、設定から OpenRouter の :free モデルを追加、実際の README タスクで検証する——スクリーンショット付き解説。
モデル切り替えとカスタムプロバイダー
セッション途中でのモデル切り替え、NVIDIA NIM や Ollama をカスタムプロバイダーとして追加し、実際に話しているモデルを検証する方法。
dsh のトークン使用量と料金
リクエストごとの使用量レシートの読み方、Trajectory でコンテキストの浪費元を特定、モデルのティア見直しとプラグインでコスト削減。
DSH とプラグインの更新
検証済みの更新コマンド：バージョン確認、dsh CLI のアップグレード、ターミナルまたは Web UI マーケットからのプラグイン更新、そして安全なロールバック。
dsh プラグインのアンインストールと削除
プラグインの削除から dsh 本体のアンインストール、~/.dsh の完全クリアまで。実際のターミナル出力で検証済み。
スマホからリモート操作
ngrok の無料トンネルで Web UI を公開 URL に。外出先のブラウザーから自宅のエージェントを操作、アプリ不要の全8ステップ。
DSH Web UI 立ち上げからスマホまで
dsh web の1コマンドで Web UI を起動し、3080 ワークスペース・スラッシュスキル・モデル設定を押さえたら、dsh-web エコシステムでスマホからも操作——実録スクリーンショット 9 ステップ
LAN アクセスとポート
http://<あなたのIP>:3080 が自分の PC からしか開かない理由、--port の使い方、そして dsh-LAN プラグインでファイアウォールごと Web UI をスマホに開放する手順。
dsh-pocket：DSH をポケットに
PC の dsh web をスマホの QR コードでペアリング：LAN 直接接続か Cloudflare 無料トンネルで同じ画面をリアルタイム同期、スマホ側からも操作可能——フレーム単位で検証した 7 枚のスクリーンショット。
DSH のよくあるエラーと修復実践
症状と照らし合わせてトラブルを切り分けます。インストール失敗、プラグイン起動クラッシュ、更新後の不調——すべて実録スクリーンショット付きで、コマンドは公式 Discussions と照合済み。
dsh で研究データ分析
101,766 行の EHR テーブルを渡せば、前処理・Cox 回帰・ジャーナル級図表・Word の Results 章までをワンセッションで——全コマ確認済みスクリーンショット。
DeepSeek Harness の巻き戻し：ワンクリックで元に戻す
dsh-undo-savepoint を導入し、Web UI のボタン・Ctrl+Alt+Z・チャットで取り消し。スナップショット管理とクラッシュ復旧を図解。
dsh-dafeiyu：DeepSeek Harness にデスクトップペットを住まわせる
コマンド 1 つで「大肥魚」デスクトップペットを導入し、エージェントの実際のタスク状態に合わせて動く——全スクリーンショットを 1 コマずつ照合済み。
dsh のスキン変更：client ui テーマ導入とカスタマイズ
dsh Web UI スキン導入の画像付きガイド。Firefly テーマをワンクリックで導入するか、dsh-client-ui-custom で壁紙・すりガラス・6種のプリセットを自在に設定。即時反映、元に戻すコマンド付き。
dsh 本体のアップグレード：更新・検証・ロールバック
プラグイン更新ガイドの本体編：バージョン確認、npm コマンド 1 つでアップグレード、changed packages のレシートの読み方、トラブル時はバージョン指定で戻す方法。
dsh 酒場プラグイン dsh-tavern:SillyTavern を dsh へ
キャラカード(PNG/JSON)をそのまま取り込み、シナリオで開幕、Guide で誘導、1 ターンだけ再生成、ワンタップ挿絵、/debug-card の自己診断まで——フレーム検証済み 12 枚のスクショで、各ステップが元動画に深リンク。
dsh 記憶プラグイン meow-memory:dsh に長期記憶を
コマンド 1 発で meow-memory を導入し、初回の一括注入、memory_* ツールの自動呼び出し、空き時間の dream 整理を図解。プラグイン比較と費用の落とし穴も——検証済みスクリーンショット 8 枚、各ステップに出典動画へのリンク付き。
dsh QQ ボットプラグイン:dsh を QQ につなぐ
2 ルート・フレーム検証済み 9 枚:dsh-im プラグインは QQ ほか 9 プラットフォームを QR で接続、NapCat プロトコル側はグループ Bot を実現——各ステップが元動画に深リンク。
dsh agent loop 解説
dsh の 1 ターンはこう動く:turn のライフサイクル、プラグインのフックポイント、セッション暴走を防ぐ loop guard。
4 つのモード：Standard・PTC・Minimal・Creator
各エージェントプリセットの中身、得意な場面、そして Creator モードで独自プリセットを作る方法。
計画モード:/plan で計画・レビュー・承認
DeepSeek Harness の /plan コマンドを実機検証。オレンジの計画マーカー、exit_plan_mode の承認カード、直接実行との違いを10枚のスクリーンショットで解説。
dsh vs Claude Code — AI コーディングエージェント比較 2026
オープン性、料金、モデルの自由度、拡張性を正直に横並びで比較します。
DeepSeek Harness vs OpenClaw 徹底比較
どちらも MIT のオープンソース。一方は自分で組み立てるコーディングエージェント基盤、もう一方はチャットアプリの中に住むアシスタント。6 項目の比較と結論。
DeepSeek Harness 対 Cursor
エディタ対ハーネスの正直な比較：料金、モデルの自由度、プラグイン、そして併用のやり方。
DeepSeek Harness 対 Gemini CLI
無料で 100 万トークンのコンテキスト vs モデルを差し替えられるプラグイン方式：6つの観点で比較し、使い分けと併用方法を解説
Claude Code 代替（無料）ツール一覧
料金ゼロで使えるオープンソースのエージェンティック コーディングツールと、dsh の位置づけ。
プラグイン vs スキル:違いがわかる
ハーネスの能力を入れ替えるのがプラグイン、エージェントにやり方を教えるのがスキル。実機スクリーンショットと2つの実例で一目で比較。
スキル導入の実践ガイド
mkdir から trajectory の記録まで、検証済み 7 ステップ:.dsh/skills の作成、SKILL.md の作成、カタログ注入の確認——再起動は不要です。
まず入れるべき dsh スキルのおすすめ
どのスキルを入れるべきか、有効化すると何ができるかを、実際の画面とともに 1 つずつ解説
DeepSeek Harness で AI 小説執筆ワークベンチを構築
コマンド 1 つで 3 ペインの執筆ワークベンチを導入:プロット展開、本文執筆、キャラ追跡、AI 調の校正。草稿はすべてローカルに保存。
小説をショートドラマ化、絵コンテも自動生成
小説を複数エピソードに分解し、セリフとどんでん返しを自動執筆。ショットごとの絵コンテと Midjourney/動画モデル向けプロンプトを生成して構造化データで書き出し。
DSH に画像を認識させる2つの方法
ルート1は DSH に GLM ビジョンモデルを接続、ルート2は無料の dsh-vision-router プラグインを導入——スクリーンショットを貼るだけで本物の回答が返ってきます。
DSH を WeChat・Feishu につなぐ
dsh-im を入れて QR コードをスキャンすれば、WeChat や Feishu から harness とそのままチャット——カウントダウンからスマホ側の承認、ボットの返信まで実画面で解説。
DSH のオフィス活用：一言で PPT を作る
dsh-univer-office を入れて市況データの資料を一言で依頼——調査から6枚のスライド生成、レビュー、再生までの全工程を収録。
プロンプト1つでExcelシートを統合
3部門の経費シート、1,800行。ルール・マッピング・検収を1つのプロンプトに——図解付き実録ガイド。
DeepSeek Harness でミニゲーム
ミニゲームパネルを入れて、モデルの待ち時間にテトリス。残高モニターも一緒に。
会話だけでプラグインを作る（コード不要）
アイデアひとことで → 仕様の共同作成 → Creator モードで開発 → バージョン承認。プラグインの誕生実録。
dsh をサーバーに常駐させて 24 時間動かす
スクリーンショット検証済みの13ステップ。空の VPS から常時稼働の DeepSeek Harness へ — SSH とブラウザターミナル、コンテキストウィンドウ付きのカスタムモデル、タブを離れずにプラグイン導入、ビルド結果には公開 URL を返させる。
調整済みのワークフローを dsh スキルにする
スクリーンショット検証済みの7ステップ。ちょうど動くようになった手順から SKILL.md へ — ファイルの置き場所、name・description・whenToUse の書き方、偽の秘密情報を仕掛けての検証まで。
業務Agentをカスタマイズ：要件から検収まで全手順
12 ステップを実録解説：検収基準を先に書き、プラグインを用意し、権限を1回承認、1,800行の集計を項目別に検証。
コンテキスト圧縮と長時間タスク
80% しきい値、/compact、ツール結果の切り詰めが連動するしくみ
dsh TUI ターミナル入門
ターミナルで dsh を動かす：profile 切替、SKILL 管理、バックグラウンドジョブの実録
音声プラグイン2シーン入門
AI に話す（ローカル音声入力）と、AI に話させる（TTS）の両方を実写で解説
dsh プラグインの探し方（図解）
マーケット・awesome ディレクトリサイト・公式管理画面、3つの探し方をフレーム単位で検証
Obsidian を dsh ナレッジベースに(図解)
API キー → ワークスペース → AGENTS.md 骨格 → ライブラリの文体で執筆。7 ステップ、全フレーム元動画にリンク
dsh + ComfyUI 全自動動画生成(図解)
プロンプトテンプレートがスキル化され、ComfyUI ワークフローが 15 秒の縦型動画を生成。GPU メモリ解放もバックグラウンドで——全フレーム検証済み
dsh raw-html レンダリング:回答を見える化(図解)
raw-html プラグインが平文の回答を HTML カード・チャート・アニメーション・スタイルシステムに変換。信頼モードの安全性も解説
クジラ娘ウィジェットで dsh の残高を見る
dsh-whale-widget を web プロファイルに link し、DeepSeek の残高・今日の使用額・更新カウントダウンを出す隅の吹き出しを設定します。
AI で dsh を着せ替える
wallpaper-plugin 図解ガイド：外観の 3 状態スイッチ、プリセットスタジオのレイヤー合成壁紙、そしてひとことで AI に明暗両対応のテーマを作ってもらうまで。
dsh 必須プラグインを実践で
必須リストの図解版：検索できるマーケットを管理パネルに入れ、スター数とスクリプト監査で見極め、ビジョン・サイドバー・バックグラウンドタスクのプラグインまで——全ステップに検証済みスクリーンショット。
検証できるアーキテクチャ図
使い捨てのスケッチではなく、レビューに出せるシステム図を agent に描かせる：archify スキルを入れて一文で依頼し、9/9 の検証レポートを読んでから図を信じる。
dsh Creator モード：会話からプリセットを作る
プリセットの切替からサンドボックス承認・マウント検証、コーヒーショップ分析と Excel の数式監査まで——Creator モードの全工程を検証済みスクリーンショット 9 枚で。
dsh 自動コードレビュー：プリセットとワークベンチ
読み取り専用の風控レビュープリセット、プリフライトとテストをゲートに持つコーディングプリセット、README とランタイムの乖離を検出するプラグインワークベンチ——レビューループを検証済みスクリーンショット 8 枚で。
dsh 無限キャンバス：ThoughtDAG でコンテキストを分岐
質問はノードに、線は要約か全文コンテキストを注入、PDF は枝を伸ばし、古い Claude Code セッションは読み取り専用で取り込み——キャンバスワークフローのスクリーンショット解説。
設定とビルド
プロファイル、プリセット、自作プラグインの作成。
プロファイル・パッチ・プリセット
dsh プロセスが積み重ね設定レイヤーからどう組み立てられるか、そして自分仕様にする方法。
カスタム DSH Agent プリセットを作る
Creator モードで自分だけの DeepSeek Harness プリセットを設計。プラグインの組み合わせ、書き込みの承認、ワンクリック切り替えまで —— 1 コマずつ検証した実践ガイド。
プラグイン開発入門
Cordis プラグインの作り方・公開・掲載まで。公式アンカーつきで解説します。
自分の DSH プラグインを作る
開発の全工程をウォークスルー。最小契約、Config Schema、profile へのインストール、そして動作を確かめる MCP Apps の実演まで。
トラブルシューティング・エラー百科
症状 → 原因 → 対処法：インストール失敗、pnpm workspace allowlist エラー、cordis.patch.yml 競合、bundle 形式エラー、Profile が反映されない問題。
DeepSeek Harness に MCP サーバーを接続する
dsh に MCP を組み込む手順：Claude Code / Codex からのフィールド対応表、登録済みサーバーのカード一覧、貼り付ける mcpServers 設定、そして dsh セッションが実際に高徳地図 MCP を呼ぶ記録。
ACP で dsh を Zed につなぐ
dsh の Agent Client Protocol 実践ガイド：公式 automation-only サーバーとコミュニティのインタラクティブ版の選び方、Zed settings.json の書き方、その他の ACP クライアント向けアダプター目録まで。
安全性とエコシステム
サンドボックス、信頼できるプラグイン、広がる dsh の世界。
サンドボックス・承認・シークレット
dsh の安全モデル：3 段階のサンドボックス、承認ポリシー、ガード、シークレットの扱い。
DeepSeek Harness 使い方：dsh プラグインの入れ方・インストール方法
dsh でのプラグイン インストールの実際の仕組みと、サードパーティコードを見極めるチェックリスト。
必須 dsh プラグイン — おすすめ 12選
最初に入れたい 12 のプラグイン。全カタログ・全カテゴリから厳選しました。
dsh プラグイン エコシステム
公式パッケージ、コミュニティ org、dsh-plugin トピック、そしてこの DeepSeek Harness プラグイン カタログの鮮度維持の仕組み。
プラグイン API と RSS
プラグインカタログの公開読み取り専用 JSON API と RSS フィード。API キーは不要です。
中国語チュートリアル
中国語の体系的チュートリアル
コミュニティで育った体系的な中国語学習リソース。本サイトのチュートリアルと併せて、DeepSeek Harness の概念・インストール・プラグイン体系をゼロから理解できます。
体系的な中国語チュートリアル リポジトリ
ht426 がメンテナンスする章立ての中国語チュートリアル：インストールからコア概念、プラグイン体系まで、DSH を端から端まで学べます。
ガイドを読む超丁寧な入門解説ガイド
JingHao-Leon による手取り足取りガイド：平易な言葉で DeepSeek Harness のメンタルモデルと学習パスを整理。エージェント系ツールが初めての方に最適。
ガイドを読むDSH ブルーブック ドキュメントサイト
dsh.hicyou.com のブルーブック ドキュメントサイト：機能クイックリファレンス、実践ノート、応用テクニックを新バージョンに合わせて継続更新。
ガイドを読むDeepSeek Harness：10 ステップの完全ツアー
git clone から headless モードまで——インストール、プロバイダー接続、プリセット、Creator モードでのプラグイン生成、サンドボックスと Trajectory を 1 本のガイドで。
ガイドを読むfaq
よくある質問
DeepSeek Harness ガイドで誰もが探す、短い答え。
DeepSeek Harness とは？
DeepSeek Harness（dsh）は、DeepSeek 公式のオープンソース エージェントフレームワークです。モデルを、ファイルを読み、コマンドを実行し、Web を検索できるエージェントへと変えるランタイム。最大の特徴は、ツール、モデルアダプター、UI、メインループに至るまで、すべてがプラグインであるという設計思想です。
ガイドを読むDeepSeek Harness は無料ですか？
ハーネス本体はオープンソース（MIT）です。モデルの利用料は別途かかります。DeepSeek API など、ご自身のプロバイダーを接続し、トークン料金はそのプロバイダーに直接支払います。コミュニティ プラグインも大半がオープンソースです。各リポジトリのライセンスをご確認ください。
インストール方法は？
CLI をグローバルにインストール（npm install -g @deepseek-ai/dsh）し、dsh --profile web で Web UI を開き、ページ上で API キーを貼り付けます（環境変数に設定済みならスキップ）。ヘッドレス CLI、Python・TypeScript SDK、ACP サーバーも利用できます。
ガイドを読むdsh プラグインの入れ方は？
dsh では通常、プロファイルかパッチ設定にエントリを 1 行追加するのがインストールです。手順は各プラグインの README に記載されています。プラグインはプラグインツリーに読み込まれ、その行を消せば登録されたものはすべて外れます。
ガイドを読むdsh は Claude Code や Codex と同じですか？
少し違います。Claude Code や Codex は完成品のエージェントを提供しますが、DeepSeek Harness はプラグインであらゆる部分を差し替え・拡張できる、自分で組み立てるエージェントランタイムです。同じ仕事の系統で、哲学が異なります。
自作プラグインを掲載するには？
公開リポジトリに dsh-plugin トピックを付け、このディレクトリが同期するコミュニティ リストに PR を出してください。トピック経由なら自動で拾われます。キュレーション掲載ではカテゴリと説明文が付きます。
ガイドを読む