DeepSeek Harness
DeepSeek Harness Alpha.2：Worktrees とアップグレードチェック
DeepSeek-V4 Team · 2026年10月8日 · 17 min read
Keywords: DeepSeek Harness, Alpha.2, Git Worktrees, SDK 移行
Published: 2026年10月8日 Author: DeepSeek-V4 Team
DeepSeek Harness dsh-v0.2.1-alpha.2 は 2026 年 10 月 9 日にリリースされ、エージェントが独立した Git チェックアウトを作成できるようになりました。カスタムランタイムで使う一部のインターフェースも変更されています。すでに 10 月 3 日の alpha.1 を使用している場合、必要な機能や修正を基準に判断できます。Worktrees を使いたいのか、特定の不具合を解消したいのか、新しい SDK の動作が必要なのかを確認しましょう。
このガイドは最初に alpha.1 向けに公開され、現在は alpha.2 を含んでいます。これは公式 alpha.2 リリースノート とバージョン固定されたドキュメントに基づいています。以下は、お使いの環境で行う受け入れ確認の提案です。複数の環境でのベンチマーク結果ではなく、Harness デスクトップ版を実行して検証したものでもありません。
作業に影響する変更から始める
新しい Git Worktrees プラグインにより、エージェントはブランチと個別のチェックアウトを作成し、そこでセッションを続行できます。これは実験的な機能であり、最初は無効になっています。まずは小さな作業で試すと、動作を確認しやすくなります。エージェントにメインの作業ディレクトリから離れた小さなドキュメントファイルを編集させ、変更された差分を確認してください。
Alpha.2 はまた、プラグインを通じて実験的な推論翻訳を追加します。リリースには Bing と Google 翻訳、さらに有料の DeepSeek Flash オプションが記載されています。これは推論コンテンツの表示に関するものであり、新しいベースモデルのリリースや、推論精度の向上の証拠ではありません。実際に読む翻訳、技術識別子が誤って翻訳されていないかも確認してください。
既存のワークフローに関わる不具合修正もあります。レスポンスストリームが停止した場合にアイドルタイムアウトを適用できるようになり、読み取れないプラグインメタデータはリクエスト全体をブロックしなくなり、バックグラウンドタスクは親ターンが終了しただけで中断されたとして表示される可能性が低くなります。これらはリリースノートの主張です。解決されたと宣言する前に、自分の環境で起きていた不具合を再現してください。
| あなたの状況 | 最初に評価すべきこと | 保持すべき証拠 |
|---|---|---|
| エージェントの編集がローカル作業と衝突する | Git Worktrees | ディレクトリ、ブランチ、ベースライン、差分 |
| バックグラウンドジョブが中断されたように表示される | アップグレード後の同じジョブ | 実際の結果と最終タスク状態 |
| カスタム SDK ランタイムを維持している | 移行要件 | 統合テストとイベント処理 |
| 現在のワークフローが安定している | 小規模な回帰テスト | 同じタスク、同じ期待結果 |
Worktrees はファイルを分離するが、権限は分離しない
alpha.2 Worktrees ドキュメント は、ローカル Git リビジョンから作成されたチェックアウトについて説明しています。元のチェックアウトにある未コミットの変更は一緒に移動しません。エージェントがエディターにのみ存在する変更を必要とする場合、ワークツリーを開いてもその変更は利用可能になりません。
この操作はまた、セッションの既存のファイルポリシーを保持します。新しいパスは新しいセキュリティ境界ではなく、制限されている場所 への書き込み権限を付与しません。宛先と共有 Git 管理ディレクトリの両方は、既存のポリシーの下で書き込み可能である必要があります。
返されたパスは、編集前に確認すべきものとして扱ってください。デフォルトのプールは現在のチェックアウトの下に存在するため、既存のリンクされたチェックアウト内で開始すると、そこにネストされたプールが作成されます。ディレクトリを離れると、チェックアウトとブランチの両方が保持されます。Worktrees 初回実行ガイド は、小さなタスクを通じて、これらの確認手順を説明しています。
カスタム統合は移行要件を別途確認する
最も重要な alpha.2 の変更は、通常のインターフェースでは目に見えない可能性があります。サブエージェントツールは 今回から子セッション ID を即座に返します。カスタム SDK ランタイムは session/wait をサポートする必要があります。最初の結果を完了した作業として扱ったコードは、新しい完了チェックが必要です。
リリースはまた、both ツール表示値を削除し、native と ptc を残します。Python PTC は 今回からセッションファイルシステムサンドボックスを使用します。カスタム構成はサンドボックスとサンドボックスポリシーサービスを提供する必要があります。これらは設定とライフサイクルの変更であり、一致する単語を含むすべてのファイルで無差別に置き換える設定ではありません。
エージェントチームメッセージングは、対象受信トレイへの直接配信に変更されます。以前のアウトボックス、自動リトライ、または再送信重複排除に依存するカスタムプラグインは、移行ノートと照合する必要があります。送信時に例外が出なかっただけでなく、受信側で期待した結果が得られたかを確認してください。
最後に、共有エージェントディレクトリは AGENTS.md を受け入れ、DSH_AGENTS_HOME がオーバーライドとして利用可能です。これとは別に、エージェント指示の各設定行にあった dshHome オプションは削除され、プロセスレベルの DSH_HOME の既定値を使うようになりました。既存のデプロイをレビューする際、この2つの設定を混同しないようにしてください。
より良いタスクラベルでも結果チェックが必要
修正されたバックグラウンドタスク表示は、失敗を診断しやすくするため有用です。しかし、タスクの要求された出力が存在することを証明するものではありません。レポート作成ジョブの場合はレポートを検査し、コード変更の場合は差分とテスト結果を検査してください。表示状態と実際の結果を一緒に記録してください。
たとえば、ジョブはあなたが期待したディレクトリとは異なるディレクトリにレポートを書き込みながら完了する可能性があります。完了状態と欠落したファイルは、プロセスが実行された場所を確立するまで矛盾しない観察結果です。Alpha.2 の working_directory ツールと SDK ディレクトリ操作は、セッションの作業場所を明示的に確認できます。
既存のスケジュール実行でも、同じように確認します。リマインダーの配信を、リマインダーによって要求された作業とは別にチェックしてください。自動化受け入れチュートリアル はその区別をカバーしており、表示修正後も関連性があります。
alpha.1 と alpha.2 の変更を区別する
10 月 3 日 alpha.1 リリース は、プラグイン作成エントリー、組み込み Web 自動化、実験的な Claude Code Mods 互換性を導入しました。これらは古いビルドからアップグレードする読者にとって有用な背景ですが、10 月 9 日の追加機能ではありません。
プラグインを維持している場合は、以前の移行ノートをスキップせずに、両方のリリースをチェックしてください。Alpha.1 はランタイムの invariant プラグインを削除し、メッセージ入力ボックスの統計を activity と usage に分割しました。インストーラーはまた、インストールされたバージョンをより明確に報告し始め、リリースエイジポリシーが古いパッケージを選択した場合も含めます。要求されたバージョンとインストールされたバージョンは別々の事実のままです。
初期セットアップについては、ローカルクイックスタートガイド から開始してください。プラグイン作成については、Creator チュートリアル を使用してください。どちらのワークフローも、すべての実験的な機能を同じアップグレードテストの一部として扱う必要はありません。
範囲を絞ったセッションでアップグレードを判断する
現在の Harness バージョンを記録し、依存している設定とセッションデータを保持してください。既知の期待結果を持つ通常のタスクを選択し、アップグレード後にそれを繰り返してください。そのベースラインが機能した後でのみ、必要な実験的なプラグインを有効にするか、変更した統合をテストしてください。
Worktrees の場合、受け入れとは既知のコミット、新しいブランチ、正しいカレントディレクトリ、およびレビューされた差分を意味します。SDK 統合の場合、子タスクの実際の完了を確認し、使用するインターフェースをテストすることを意味します。どちらの利点もあなたの作業に関係ない場合、alpha ラベルは試用を日常のセットアップから分離しておく妥当な理由です。