awesome-deepseek-harness

简体中文 · English · 日本語

DeepSeek Harness の究極ガイド：資料、チュートリアル、プラグイン、ツール

本プロジェクトは「量より質」を重視し、DeepSeek Harness に関する優れた資料を厳選して収集することで、AI 実務者とともにより豊かな Agent エコシステムを築くことを目指しています。

このプロジェクトが役に立ったら、ぜひ ⭐ を付けてください。Agent に関する実践的な情報は、X の @李不凯正在研究 でも発信しています。

目次

• 目次
• クイックスタート
  • Web UI の起動
  • ソースから実行
  • Python SDK の使用
  • プラグインのインストール
• 公式リソース
  • パッケージと連携
  • ソースリポジトリ
  • 公式ドキュメント
  • コミュニティ
• コミュニティリソース
  • 解説とチュートリアル
  • コミュニティでの議論
• サードパーティクライアント
  • デスクトップアプリとディストリビューション
  • ターミナル・モバイル・Web 体験
• 厳選プラグイン
  • ワークフローと Agent
  • コンテキスト・Session・入力
  • ブラウザ・ビジョン・インターフェース
  • サンドボックスと実行
  • テーマとスキン
• 外部連携
• 開発ツール
• 謝辞

クイックスタート

DeepSeek Harness（DSH または dsh）は、DeepSeek AI が公開しているオープンソースの Agent Harness プロジェクトです。Cordis を基盤とし、**Everything is a Plugin（すべてがプラグイン）**というアーキテクチャを採用しています。モデルアダプター、ツール、Session ログ、インターフェース、Agent Loop は、すべてプラグインツリーを通じて組み合わせたり置き換えたりできます。

現在確認できる公式 GitHub Developer Preview の最新版は 0.1.2-rc.1 で、npm latest と next はどちらも 0.1.2-rc.1 です。この RC は Full-history Turn Navigation、正確な Token / Duration 統計、Subagent Model 選択、ACP Standard Control、Schedule、Connection Retry を追加し、一方向の report を継続可能な双方向 send_message に置き換えます。Public WebFetch は SSRF 保護付きで既定 On、SQLite Session Backend は削除され（旧 Data は保持され Export に旧 Version が必要）、DeepSeek Adapter Request は有効な Plugin Package 名と Version を既定で付加します（無効化可能）。Session Log の Incremental Upload は Opt-in で既定 Off のままです。公式 Release は Security Audit 済みではなく、Sandbox、Approval、Permission が完全な隔離を保証しないとも明記しています。以下の DSH Version は作者が示す開発・テスト基準のみで、最新 Preview との互換性を自動的に意味しません。

Web UI の起動

Node.js 22.19.x または 24+（24+ を推奨）をインストールしてから、次を実行します。

npx @deepseek-ai/dsh web

デフォルトでは http://127.0.0.1:3080 にアクセスします。Settings → Models でモデルサービスを設定すると、Session を作成できます。詳しくは公式クイックスタートとモデルサービス設定を参照してください。

ソースから実行

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

Python SDK の使用

公式 Python SDK では、同梱 Runtime を通じて Harness をプログラムから呼び出せるため、システム側に Node.js を用意する必要はありません。現在は Python 3.10+ が必要です。対応状況とプラットフォーム制限については、公式 Python SDK ガイドを参照してください。

python -m venv .venv
. .venv/bin/activate
python -m pip install deepseek-harness-sdk

プラグインのインストール

web と headless はディストリビューションに組み込まれた Profile です。外部プラグインは、dsh.bundle を宣言する Bundle として対象 Profile に追加されます。

dsh plugin --profile web add <package-or-git-spec>
dsh --profile web --dump-config

Git リポジトリからインストールする場合は、commit を固定し、事前にインストールスクリプトを確認してください。pnpm では依存パッケージのビルドスクリプトに明示的な許可が必要になることがあります。このコードは Agent サンドボックスの外で実行されます。詳細は公式プラグインのパッケージ化・インストールガイドを参照してください。

公式リソース

公式プロジェクトは、オープンソースリポジトリ、関連論文、充実したリファレンスドキュメントを提供し、開発者コミュニティを継続的に運営しています。

パッケージと連携

• @deepseek-ai/dsh：公式 CLI と Web UI の npm 起動パッケージ
• deepseek-harness-sdk：DSH をプログラムから利用するための公式 Python SDK

ソースリポジトリ

• GitHub：ソースコード、Issue、リリース、コントリビューター
• Paper：Cordis ベースのプロダクトアーキテクチャを詳しく解説する論文

公式ドキュメント

• 中国語公式サイト：プロダクトの位置付けと主要コンセプト
• ドキュメント：利用方法、プラグイン開発、アーキテクチャリファレンスの入口

コミュニティ

• GitHub Discussions：質問、利用者同士の交流、提案
• DeepSeek Discord：中国語を中心とする公式 Discord コミュニティ
• "DeepSeek Harness"：DSH に関する X のリアルタイム検索結果
• # dsh-plugin：GitHub 上の DSH プラグインプロジェクト

コミュニティリソース

解説とチュートリアル

コミュニティでの議論

公式資料で触れられていない背景や実践の詳細を補う、十分な論述、実践情報、一次的な背景を含む公開長文投稿です。

サードパーティクライアント

以下のプロジェクトは、単一ツールの機能ではなく、独立した UI、配布形態、またはプロダクト化された構成を提供します。

分類について： ディストリビューションや Fork は、完全な DSH Runtime を直接再利用、変更、再パッケージ化するため、dsh plugin ではインストールできず、プラグインには分類されません。独立クライアントは Web、RPC、ACP、または専用ブリッジプラグインを通じて DSH に接続します。いずれも Harness エコシステムの重要な構成要素です。

デスクトップアプリとディストリビューション

ターミナル・モバイル・Web 体験

掲載されていることは、署名済み、公証済み、自己完結型、本番利用可能であることを意味しません。各プロジェクトの README と Releases で最新状況を確認してください。

厳選プラグイン

ワークフローと Agent

• dsh-toolkit：時刻、エンコーディング、JSON、計算、CSV、正規表現、Markdown、Diff などの決定論的ツール集。
• dsh-deep-research：DSH 向けの適応型ディープリサーチオーケストレーター。
• dsh-101：DSH 内で公式ドキュメントを読み、理解するための学習モード。
• dsh-auto-approval：ルールとモデルでツール呼び出しを分類し、allow / deny の自動承認判断を返す。
• mstar-harness：Skill 駆動の Harness / Loop Engineering ワークフロープラグイン。
• dsh-agent-teams：DSH に Agent Teams 機能を追加。
• dsh-automation：新しいルート Agent と Session で独立タスクをスケジュール実行し、定義の改訂履歴、実行履歴、明示的なワークスペースと権限境界を保持。
• dsh-plannotator：Agent の計画をセクションごとに注釈し、構造化フィードバックを送信。下書き分離、バージョン固定、古い計画の拒否に対応。
• dsh-spec-collab：製品の生要件を、Product、Engineering、双方の AI が共同レビューする Git Version 管理の Ready Spec に整理する。AI は Review Item と Candidate Patch の提出に限定され、確認と正式保存は人間が担う。Apache-2.0、npm 0.2.1、DSH 0.1.1-rc.1 互換を表明し Test Suite を備える。ただし同日中も高速に更新され、CI、GitHub Release、独立利用の証拠がないため初期段階。~/.dsh/spec-collab に Collaboration Ledger と独立 Git Repository を書き込み、追加の AI Review Session を起動する。HTTP 管理面は既定で Loopback / Same-origin のみだが、花名は認証ではないため、外部公開時は別途認証と信頼できる Reverse Proxy が必要。
• dsh-context-guard：要件、禁止事項、受入条件、後続修正を Task Contract として保持し、現在の成功 Evidence が現在の Contract と一致する場合だけ Goal / Turn 完了を許可し、Native Session Event から Certificate を再構築・再検証する。Apache-2.0、npm / Release 0.1.0、DSH 0.1.1-rc.2 固定。Repository は 104 Test と macOS / Windows の Native Isolated Acceptance を報告する。Custom Event は追加せず、Sandbox、Memory、Semantic Proof System でもないため、保守的な Command Effect 解析と Evidence Matching は見落とす場合がある。同日初版で独立利用 Evidence もないため初期段階。
• dsh-record-replay：macOS デスクトップワークフローを記録して Skill を生成。現在は Xcode Command Line Tools と、別途用意した open-record-replay のローカルソースが必要。
• dsh-science-workbench：Cell、図、フィードバック、再実行の系譜を Manifest に記録し、環境 Snapshot と入出力 Hash も保存する再現可能な科学ワークベンチ。MIT、v0.1.1 で、まだ初期段階。
• dsh-omicos：OmicOS のバイオインフォマティクス機能を DSH に接続し、永続 Python / R Kernel、Capability Catalog、Background Job、実行状況 View を提供。GPL-3.0-only、npm 0.2.1。分析 Tool は permission_mode: full で動作し、ローカル Kernel を起動する場合がある。Cloud Model と上位 Plan には OmicOS Account が必要。
• dsh-crew：Claude Code または Codex から実際の DSH Worker を Dispatch し、進捗、Status Shard、Tier Policy を提供。MIT、Release / npm next 0.1.0-rc.4。DSH 0.1.1-rc.1 で検証され、MCP と Package の Smoke Check を備える。~/.config/dsh-crew/status.d/ に書き込み、外部 Model Service では API Key が必要になる場合がある。まだ Prerelease で独立した Test CI がないため初期段階。
• dsh-trading：決定論的 Indicator、CSV Provider、対話型 Chart を備えた取引 Research 向け DSH Workbench。MIT、npm @dsh-trading/bundle@0.1.0。注文実行 Interface は公開せず、資金移動 Tool をヒューリスティックに遮断するが、完全な Security Boundary ではないため初期段階。
• oh-story-dsh：13 個の小説 Skills、7 個の専門 Role、短編 Drama 制作 Workflow を DSH ネイティブの Session、Approval、3 Column の Creative Workbench に統合。MIT、npm / Release 0.1.3、Node.js 24+、Peer Dependency は DSH 0.1.1-rc.1 以降。Release は 34 件の自動 Test と Ubuntu / macOS / Windows CI を報告する。本版は公式 Composer の高さを再利用し、Message Stream に Scroll Safety Area と Anchor Geometry の Regression 検証を追加して、展開 Task、Streaming State、移動先 Message が Composer に隠れないようにした。Build は上流の Login / CDP Scraper と独立 Dashboard を除外する。Plugin は Model Credential を読まず独自 Listener も開かないが、呼び出し元 Agent に見える Tool の範囲で Creative Project File を読み書きして専門 Role を呼び出し、DSH Web Server に Host、Origin、Session、Path Containment、Optimistic Concurrency で保護された File Route を追加する。初回 Release は 8 月 21 日で、明示的な検証は DSH rc.1 のみ、長期保守と独立利用の証拠もまだないため初期段階。

コンテキスト・Session・入力

• dsh-context：Web UI の Context Panel と /context Command で、System Prompt、Tool Schema、Message、Injection、Reply、Tool Result の Request ごとの Token 構成を表示し、Compaction、Pruning、Cache-hit も示す。Apache-2.0、npm / Release 0.35.0。新版は任意の深さの Subagent へ移動できる Agent Network を追加し、File Activity は PTC / Code Mode 内の呼び出し、欠損 Log、Read 行範囲も扱う。Host が canOpenPath を明示した場合のみ File 名を System Default Application に渡せ、Workspace 内 Path は Session Root を基準に解決し、Search Pattern など証明できない行は開けない。Peer Dependency は引き続き ^0.1.0-rc.7 以降で、Source Test は File ごとの Coverage Gate と Bundle Smoke を備える。外部 Service は不要だが、UI は npm を最大 1 時間に 1 回確認し、公式 Registry が利用できない場合は npmmirror に Fallback する。
• dsh-profile-settings：Global settings.yaml の上に Profile ごとの settings.patch.yml Overlay を追加し、Recursive Merge、!unset、Source Inspection、Hot Reload、Settings Page 管理を提供しながら既存の ctx.settings Interface を維持する。MIT、npm / Git Tag 0.1.0、Node.js 22.6+、Peer Dependency は DSH 0.1.1-rc.2 系に固定され、15 個の Test File を含む。最新 CI は Source Check、Build、Node 22.6 / 24 / 26 の Release Tarball Smoke Test に成功したが、Registry で 0.1.0 を取得できる状態でも全体 Workflow は npm Publish Step で失敗している。既定で Profile Overlay を書き込み、promote / demote / migrate は Lock、Atomic Replace、Migration Backup の下で Global / Profile Document 間の値も変更できる。同日初回公開で GitHub Release や独立利用の根拠がないため初期段階。
• dsh-context-doctor：AGENTS.md、Skill ディレクトリ、ツール Schema のコンテキスト Token コストと競合を監査。
• dsh-memory-evolve：Session をまたぐ記憶、バックグラウンド進化、ブランチ認識機能。
• dsh-noema：ローカル優先の Noema 長期記憶を DSH に接続し、作業前の想起、設定ページでの管理、Codex / Claude Code / Cursor / Hermes などからの既存記憶インポートに対応。MIT、Release / npm next 0.1.0-rc.3。DSH 0.1.1-rc.1 で検証され、CI と Test もあるが新しいため初期段階。
• EverOS Memory for DSH：User、Assistant、Tool Call、Tool Result の軌跡をローカル EverOS に保存し、後続 Session 前に想起。Apache-2.0、Plugin 0.1.0、DSH >=0.1.0-rc.6 <0.2.0-0 対応。ただし npm 未公開で、遅延抽出は未 Tag の EverOS 機能に依存する。軌跡には Source、Command、Tool Output が含まれ得るため、外部 Model 設定は別途確認が必要。初期段階。
• dsh-at-file：入力欄の @file でワークスペース内のファイルを検索し、内容を添付。
• dsh-shikitor：Composer で # Session、@ Workspace File、$ Skill、/ Command を統合検索し、拡張可能な Workspace File Editor も提供。MIT、npm 1.0.2、DSH >=0.1.0-rc.5 <0.2.0 対応。編集は既定で自動保存され、外観と Path Rule は Browser 側に保存される。
• dsh-message-edit：ブランチ型メッセージ編集、再試行、再生成、バージョンタイムライン。
• dsh-client-auto-retry：error、interrupted、max-tokens の後に既定メッセージ 继续 を元の Session へ自動送信し、猶予時間、クールダウン、連続回数上限で再試行を制御。MIT、npm 0.3.1、互換性表明は DSH 0.1.0-rc.7 のみ。既定では起動時に直近 15 分の中断 Session を走査し、モデル呼び出しと Token 消費を継続する可能性がある。確認できる Test や Release がないため初期段階。
• dsh-prompt-studio：システムプロンプト断片を編集し、リアルタイムプレビューを表示。
• dsh-turn-rewind：永続的な Change Ledger に基づき、会話とワークスペース状態を巻き戻す。
• dsh-filesnap：会話と Workspace File を明示的に選んだ Turn へ戻し、必ず新しい Fork で復元する。最初に Rescue Point を作成し、/redo で巻き戻しを反転でき、Git Branch、Commit、Stash、Worktree は変更しない。Apache-2.0、npm / Release 0.2.1、Node.js ^22.19 または 24+、Linux / macOS / Windows の x64 / arm64 対応。CI は現行 DSH を Source Build し、10 Test File と Client Build を実行する。同梱 Rust filesnap Binary は Binary File、Ignored File、観測済みの Workspace 外 ctx.fs Path も捕捉し、復元は File を上書きするか、明示 Tombstone がある場合だけ削除する。Snapshot は現在 User の Platform Data Directory に暗号化せず保存される。Uninstall 後は Custom Event を含む Captured Session を再び開くまで再インストールが必要。同日初回公開で独立利用の根拠がないため初期段階。
• dsh-compaction-instant：LLM 要約を決定論的コンパイルに置き換え、recall / search で圧縮された内容を復元。内蔵 compactor の置換には npm alias が必要で、Runtime への比較的深い変更となる。
• toolshrink：Test、Diff、JSON、Directory Tree、Log、Install Output の構造を認識して圧縮し、必要に応じて元の出力への参照を保持。MIT 0.1.0。現在は Source Build と Global ~/.dsh/cordis.patch.yml の編集が必要で、保存した原文は 24 時間後に削除されるため初期段階。
• dsh-tool-squeeze：Test、Diff、JSON、Directory Tree、Log、Install、HTML の Tool Output を決定論的かつローカル優先で圧縮。MIT v0.1.0、DSH / dsh-tools 0.1.0-rc.8 に固定対応し、Project は 21 Test と再現可能な Benchmark を報告している。Source Build と Plugin 独自の原文保持が必要な toolshrink と異なり、GitHub Bundle として直接導入でき、追加の Model / Network Call を行わず、完全な原文を公式 Spill Store に委ねる。ただし圧縮は Lossy で、同日初回 Release かつ CI や独立利用の証拠がないため初期段階。
• dsh-whale-report：Session Event Log から日次、週次、月次、年次、任意期間の Report を生成。MIT、Release / npm 0.6.1、Node.js ^22.19 || >=24、DSH Peer は >=0.1.1-rc.2 <0.2.0。0.6.0 は最初の厳密な Allowlist 付き Apply & Verify を追加し、Bash Timeout が繰り返された Evidence と User の明示承認がある場合だけ shell.timeoutMs を 60 秒から 120 秒へ提案・検証・監査・安全に Rollback できる。任意の Setting / Command、Auto-healing、Automatic Rollback は非対応。Release Commit の CI は成功し、Release は 393 Test と実 Package Acceptance を報告する。0.6.1 は過去価格の Effective Date、起動後の新規 Session、Resume Session の集計を修正し、Apply & Verify の境界は不変だが過去の Token / Cost 総額が実質的に変わる場合がある。新しく、制限付きとはいえ Setting 書き込み経路を持つため初期段階。

ブラウザ・ビジョン・インターフェース