Electricitysheep/dsh-handbook

このプロジェクトとは？

dsh-handbook（DeepSeek Harness 白書）は、DeepSeekが2026年8月13日にリリースした公式エージェントランタイム DeepSeek Harness（略称 dsh）のための、オープンソースでコミュニティ主導型のマニュアルです。dsh はAIエージェントを構築するための「レゴの土台」のようなものだと考えてください。プラグインと呼ばれるコンポーネントを追加・交換することで、AIアシスタントの挙動や使用ツール、システムとの対話方法をカスタマイズできるプラグイン可能な基盤を提供します。

このハンドブックは公式ドキュメントのギャップを埋めるものです。DeepSeekのドキュメントがアーキテクチャに焦点を当てているのに対し、このプロジェクトはゼロからイチへのパス（インストール、使用方法、プラグイン開発、パフォーマンスチューニング、実際のケーススタディ）を提供し、すべてのコマンドは実際のハードウェアでテストされています。主に中国語で書かれていますが、多くの章で英語翻訳も利用可能です。

ハンドブックの内容

このプロジェクトは15章のガイド（および付録）で構成され、5つのフェーズに分かれています：

• フェーズ1（第1〜2章）： 導入と5分間のクイックスタート—dshのインストール、最初の会話の実行、2つのモード（Web UIとヘッドレスCLI）の理解。
• フェーズ2（第3〜4章）： profileとプラグインシステムの詳細—プラグインのマウント方法、機能拡張、最初のプラグインをゼロから書く方法。
• フェーズ3（第5〜6章）： 実際のシナリオとパフォーマンスチューニング—5つのケーススタディ、推論努力（reasoning-effort）戦略、一般的な落とし穴。
• フェーズ4（第7〜9章）： エコシステムとオーケストレーション—MCP（外部ツール接続用プロトコル）との統合方法、サブエージェントの使用、決定論的なワークフローの構築。
• フェーズ5（第10〜15章）： 高度なトピック—複雑なケーススタディ、将来の展望、正直な限界、セキュリティとサンドボックス、コスト/キャッシュエンジニアリング、最終的なエコシステムレポート。

付録には用語集、コマンドチートシート、および同じモデルを使用した dsh と他のエージェント（Claude Code、Codex、OpenCode、Gemini CLI、Kimi CLIなど）のベンチマーク比較が含まれています。

このハンドブックは誰のためのものか？

• 初心者：dshを使ったことがない方—3日間の学習パスに従えば、ゼロから動作環境を構築できます。
• 開発者：クローン可能なプラグインテンプレートや完全な設定リファレンスを探している方。
• 評価者：異なるエージェントフレームワークを比較している方—ハンドブックには能力マトリックスとベンチマーク結果が含まれています。
• パフォーマンスチューナー：推論努力レベル、キャッシュ、コスト最適化について学びたい方（ハンドブックのテストでは97%のキャッシュヒット率を報告）。
• 誰でも：実際の議論、プラグインの例、コミュニティの知見を通じて dsh エコシステムを理解したい方。

主な機能と資産

READMEではいくつかの実用的なツールが強調されています：

• クイックスタート： 1つのコマンド (npx -y @deepseek-ai/dsh web) で http://127.0.0.1:3080 にWeb UIを起動します。
• チートシート と 設定リファレンス—一般的なシナリオのためのコピペ可能な設定。
• プラグインテンプレート—2ステップでプラグインをマウントする方法を示す最小限の例。
• FAQ—5つの一般的な質問（例：「dshはモデルですか？」→いいえ、ランタイムです）。
• 比較マトリックス—他の5つのエージェントとの比較。dsh がオープンソースであり、モデルに依存せず、公式のプラグインシステムを持っていることを示しています。
• ベンチマーク結果：同じモデルを使用した5つのタスクテストにおいて、dsh は130秒でタスクを完了しました（ompは70秒、opencodeは172秒）。すべて45/45の正解率を達成しました。

ハンドブックの使い方

• オンライン読書： https://electricitysheep.github.io/dsh-handbook/
• PDFダウンロード： 中国語版と英語版の完全版が Releases section で入手可能です。
• 読み始める： 3日間の学習パス または 5分間のクイックスタート にジャンプしてください。

コミュニティと貢献

このハンドブックは生きているドキュメントです。GitHubで280以上のスターを獲得し、公式ディスカッションで195以上の返信があり、コミュニティのQ&Aを取り入れるためのフィードバックパイプラインが進行中です。実際のケースを実行した場合は、掲載のために提出することができます（帰属表示あり）。また、推奨されるコミュニティプラグイン（gitパネル、メモリエンジン、コストトラッカーなど）のリストをキュレーションし、他のエコシステムプロジェクトと積極的に連携しています。

ライセンス

コンテンツは CC BY-NC-SA 4.0、サンプルコードは MIT ライセンスです。

---

この解説は、プロジェクトの README で提供された情報のみに基づいています。