DeepSeek Harness

DeepSeek Harness（コマンドライン名は dsh）は、DeepSeek AI が開発したオープンソースの Agent harness で、AI Agent の実行と管理に使われます。プロジェクトは everything-is-a-plugin（すべてがプラグイン） というアーキテクチャを採用しており、基盤には Cordis を使っています。Cordis の設計思想については、論文「A Programming Paradigm for Spatiotemporal Composability」で紹介されています。

⚠️ 開発者プレビュー版：プロジェクトは急速に更新されており、互換性を損なう変更が入る可能性があります。実行前に、リポジトリ内のセキュリティに関する説明（SAFETY.md）をお読みください。

主な機能

• プラグイン型アーキテクチャ：コア機能はすべてプラグインとして構成されており、拡張や組み合わせが容易です。
• Web UI：dsh web を実行して起動します。デフォルトのアドレスは http://127.0.0.1:3080 です。ローカルで起動した場合はブラウザが自動的に開きます。SSH 経由で起動した場合はアドレスが表示されるだけです。--no-open オプションを付けると、ブラウザを開かずにサーバーだけを起動します。
• プラグインエコシステム：プラグインのリポジトリに dsh-plugin topic を追加すると、GitHub 上で見つけてもらえるようになります。
• デスクトップ版への対応：リポジトリの開発ドキュメントや Make ターゲットでは、Web と Desktop の 2 種類のアプリ形態に言及されています。
• 多言語ドキュメント：README とコントリビューションガイドは、英語版と中国語版が用意されています。

対象ユーザーと利用シーン

• AI Agent の実行フレームワークを構築・研究したい開発者。
• プラグインの仕組みを使って Agent の機能をカスタマイズしたり、dsh のプラグインを開発・共有したりしたいコミュニティの貢献者。
• DeepSeek 公式の Agent ツールチェーンを試してみたい技術者。

インストールと実行

npm から実行する場合（事前に Node.js のインストールが必要です）：

npx @deepseek-ai/dsh web

ソースコードから実行する場合：

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

開発時には pnpm run dev:web が使えます。1 つのターミナルで、ビルドとサーバーの起動を行い、ソースコードの変更後にはクライアントを再ビルドします。

技術要件と注意事項

• Node.js 環境が必要です。ソースコードから実行する場合は、pnpm も必要です。
• リポジトリは主に TypeScript で書かれており、Python と native のディレクトリも含まれています。
• ライセンスは MIT です。サードパーティの依存関係とそのライセンスについては、THIRD_PARTY_NOTICES.md をご覧ください。
• 開発者プレビュー段階のため、API や動作が予告なく変更される可能性があります。安定性が強く求められる本番環境でそのまま使うことはおすすめしません。
• ドキュメントサイト：https://deepseek-harness.github.io/deepseek-harness/ 。コミュニティでの交流には、GitHub Discussions と Discord を利用できます。