AIエージェントの試作では、モデルへの接続、画面、ツール連携が一つの実装に絡まりがちやで。必要な機能を部品として扱う設計を調べたいとき、実行基盤の構成が参考になるで。
deepseek-ai/deepseek-harness はDeepSeek AIが公開する、プラグイン中心のAIエージェント実行基盤やで。この記事は公式READMEとライセンスを確認した紹介で、実機での性能評価やないで。
Harnessとプラグインの役割
独自エージェントやツール連携を検討する開発者が対象やで。Cordisを基盤に、機能をプラグインとして構成する設計を採ってるで。モデルそのものを配布するリポジトリとは役割が違うで。
READMEは開発者プレビューと明記し、互換性を壊す変更を予告してるで。完成済みの業務サービスとして扱うより、小さな検証環境でアーキテクチャを学ぶ用途に向いてるで。
今回のゴールと環境
ローカルのWeb UIを開き、練習用メモを読んで要点を返すところまで試す。
確認した範囲：2026年10月24日に公式READMEや導入資料を読み直して、以下の手順を具体化したで。この改訂でアプリのインストールから最終結果までを実機で通したわけやない。成功の目安は、手元で試すときのチェックとして使ってな。
準備
ここではWindows 11 x64とPowerShellで進めるで。スタートで「PowerShell」を検索して開いてな。Node.js公式ダウンロードで24系LTS・Windows・x64のInstaller（.msi）を選び、ダウンロードしたファイルを開いて画面に沿って入れてな。入れ終わったらPowerShellを開き直すんや。
node --version
npm.cmd --version両方にバージョンが出たら準備OKや。以下ではWindowsのスクリプト実行ポリシーで止まりにくいnpm.cmdとnpx.cmdを使うで。インストール済みなら入れ直す必要はないで。
公式リポジトリのNode要件は24.9.0以上や。SAFETY.mdも先に読んでな。
使い方
New-Item -ItemType Directory -Force "$env:USERPROFILE\github-practice\deepseek-harness" | Out-Null
Set-Location "$env:USERPROFILE\github-practice\deepseek-harness"'これは練習用のメモです。青い箱を3個用意します。打ち合わせは第2会議室です。' | Set-Content memo.txt -Encoding UTF8
(Get-Location).Path
npx.cmd @deepseek-ai/dsh web- 起動したPowerShellは閉じず、ブラウザーで
http://127.0.0.1:3080を開いてな。URLが違うときは起動ログに出たURLを使うで。 - Settings → Modelsを開き、DeepSeekの公式プラットフォームで用意したAPIキーを入力して保存するんや。アカウント、利用可能なモデル、料金・残高を先に確認してな。
- Choose workspaceで、上のGet-Locationが表示した練習フォルダーを追加して選択してな。workspaceを選ぶまで入力欄が使えへん構成や。
- セッションを開始し、「memo.txtを読み、内容を2点にまとめて。ファイルの編集や外部操作はせんといて」と送ってな。読み取りの承認が出たら、対象ファイルが練習用メモか確認するんや。
成功の目安：メモにある「青い箱3個」「第2会議室」が分かる応答が返ることや。文章は固定やないで。公式Web UIガイドで、画面の導線を確認したで。
仕組みとデータの流れ
トラブルシューティング
| 困ったこと | 確認すること |
|---|---|
| 入力欄が使えない | Choose workspaceでフォルダーを追加・選択したか確認してな。 |
| モデルが応答しない | Settings → Modelsの保存状態とAPIキー、残高、起動ログのエラーを確認してな。 |
終了と再開
サーバーを動かしているPowerShellでCtrl+Cを押して停止するで。再開は同じフォルダーで起動コマンドを実行し直すんや。
公式READMEと最新の導入案内も確認してな。配布版や外部サービスの変更で、手順が変わることがあるで。
構成の考え方
試作で一度に多数の連携を足すと、失敗の原因が追いにくくなるで。最小構成から一つずつ増やすと、変更の影響を確認しやすくなるで。
| これまでの作業 | 導入後に目指せる進め方 |
|---|---|
| モデル接続や画面、ツールを同時に変更し、原因の特定に迷う。 | 基盤を起動して確認し、部品を段階的に追加する。 |
開発版を使うときの注意
更新時の互換性変更、プラグインの権限、外部APIへのデータ送信、モデルの費用を確認してな。実行基盤のライセンスがMITでも、利用するモデルやAPIの条件は別やで。
評価では起動の再現性、設定の復元、不要なプラグインを外したときの挙動を確認してな。この記事は公式の起動手順と設計を確認した紹介であり、本番での安全性や性能を保証するものやないで。
公式資料と利用条件
本体はMITライセンスやで。第三者依存関係はTHIRD_PARTY_NOTICES.mdに整理されてるで。
確認日：2026年10月23日。本文は公式情報をもとに独自に構成し、図解は本記事用に制作したで。公式の画像・動画やREADMEの長文転載は使ってへんで。記事中の利用例・改善の比較は想定例であり、性能や成果の保証やないで。