本文はdeepseek-harness-sdk==0.1.0rc6とdeepseek-harness-runtime-bin==0.1.0rc6に適用されます。クライアントをアップグレードした後は、下記の読み取り専用ファイルテストを再度実行してください。
サポート範囲
モデルディレクトリは変更される可能性があります。実行前にCoding Plan専用キーを使用してリアルタイムディレクトリを確認してください:
deepseek-v4-pro が含まれていることを確認してください。deepseek-v4-flash を本文のツールモードの同等の代替として使用しないでください;今回の固定バージョン検証では、その多段推論履歴とツール再生は通過しませんでした。
1. 専用キーの準備
コーディングプランアプリを開き、購入したCoding Applicationに入り、そのアプリの専用APIキーを作成またはコピーします。Coding Planは一般的な残高を使用せず、他のアプリのキーはパッケージ権限を代表することはできません。 キーを現在のシェルにのみ配置してください:2. 隔離された作業スペースの作成
HarnessのバンドルされたランタイムにはローカルBashツールが含まれています。最初の検証では実際のプロジェクトやホームディレクトリを指さないでください;秘密のない一時的なディレクトリを作成します:deepseek-harness-runtime-bin が存在することを確認してください。danger-full-access を使用してファイルアクセス範囲を拡大しないでください;本文の例では一時的なディレクトリのみを cwd に渡します。
3. 公式Python SDKの実行
以下の内容を/tmp/deepseek-harness-demo/run.py として保存します:
/v1/chat/completions、SSE、推論内容、ツール呼び出しとツール結果の返却を同時に検証します。完了後は /tmp/deepseek-harness-demo を削除できます;もしセッションディレクトリにプロジェクトコンテキストが含まれている場合は、コードリポジトリと同等の機密レベルで保管する必要があります。
よくある質問
- 401:
ACEDATACLOUD_API_KEYがPythonを実行している同じシェルにエクスポートされているか確認してください。 - 403 またはクォータの提示:キーが現在のCoding Applicationに属し、パッケージが有効で残高があることを確認してください。
- モデルが利用できない:
/v1/modelsを再度確認し、古いスクリーンショットに基づいてモデル名を推測しないでください。 reasoning_content/ ツール再生エラー:SDK/runtimeが本文の固定バージョンであり、deepseek-v4-proを使用していることを確認してください。- ツール実行回数の異常:副作用を引き起こす可能性のあるタスクの実行を停止し、まずは本文の読み取り専用フィクスチャで現在のサービスバージョンを検証してください。
- インストール失敗:Python 3.10+、オペレーティングシステムアーキテクチャが現在のホイールでサポートされていることを確認し、SDK/runtimeのバージョンが一致しているか確認してください。
機能の限界
本文はローカルPython SDKからChat Completionsへのテキストとツールループのみを検証します。画像、Files API、/v1/responses、/v1/messages、リモート作業スペースおよびホスティングされたサンドボックスは本チュートリアルの約束範囲外です;作業スペースの権限とローカルコマンドのリスクは、Harnessを実行するマシンと設定が責任を負います。

