DeepSeek Harness の設定

DeepSeek Harness（dsh）はカスタムの OpenAI 互換プロバイダーに対応しており、Chat Completions プロトコルで InOneAPI を呼び出せます。DeepSeek Harness は現在 developer preview で、互換性のない変更が公開される可能性があります。アップグレード後は設定を再確認してください。

インストールと起動

Node.js をインストールすると、次のコマンドをそのまま実行できます：

npx @deepseek-ai/dsh web

Web UI の既定アドレスは http://127.0.0.1:3080 です。リモートホストで実行する場合は --no-open を使い、安全な SSH ポートフォワーディング経由でアクセスしてください。管理ポートを直接公開しないでください。

画面からプロバイダーを追加する

Settings → Models → Add a custom provider を開いて入力します：

フィールド値
Provider IDinoneapi
Display nameInOneAPI
Base URLhttps://api.inoneapi.com/v1
API protocolopenai-completions
API keyInOneAPI のプロジェクト API キー
Modelモデル詳細ページの YOUR_MODEL_ID

モデル詳細ページではこの画面ウィザードを優先して案内するため、資格情報ファイルを自前で書く必要はありません。ウィザードは資格情報を $DSH_HOME/.credentials.yaml に保存し、設定側はそれを参照するだけです。保存後、モデルピッカーで inoneapi 配下のモデルを選び、新しいセッションを開始してください。すでにリクエストを送ったセッションは以前のモデルを使い続けることがあります。モデルの自動検出が失敗しても、リクエストが利用できないとは限りません。モデル ID は手動で追加できます。

任意：設定ファイルを使う

$DSH_HOME/settings.yaml を編集することもできます。既定の DSH_HOME は ~/.dsh です：

llm-pi-ai:
  providers:
    inoneapi:
      displayName: InOneAPI
      apiKeyEnv: INONEAPI_API_KEY
      api: openai-completions
      baseURL: https://api.inoneapi.com/v1
      models:
        - id: "YOUR_MODEL_ID"
          name: "YOUR_MODEL_ID"

資格情報は settings.yaml ではなく ~/.dsh/.env に記述します：

INONEAPI_API_KEY=ioa_sk_...
chmod 600 ~/.dsh/.env

設定は次のリクエスト時に再読み込みされ、通常は再起動が不要です。

モデル機能の宣言

手動で追加したモデルは既定でテキスト専用として扱われます。モデルが入力画像に対応している場合は、明示的に宣言できます：

llm-pi-ai:
  providers:
    inoneapi:
      apiKeyEnv: INONEAPI_API_KEY
      api: openai-completions
      baseURL: https://api.inoneapi.com/v1
      models:
        - id: "YOUR_MODEL_ID"
          input: [text, image]

モデル詳細ページが該当する機能を明示している場合のみ宣言を追加してください。設定では上流が画像を受け付けるかを自動検証しません。

確認とトラブルシューティング

新しいセッションを開始して短いタスクを実行し、InOneAPI Trace を確認します。よくある問題：

  • MISSING_CREDENTIAL または 401：INONEAPI_API_KEY と .env の配置場所を確認します。
  • UNKNOWN_MODEL または 404：正確なモデル ID を手動で追加し、プロジェクトの利用モデル制限を確認します。
  • モデル一覧が空：モデル ID を直接入力します。モデル検出は利便性のための機能にすぎません。
  • 推論モデルのパラメーターが拒否される：まずカスタムの reasoning 宣言を削除してエンドポイントの既定動作を使い、その後で Harness の公式互換フィールドを 1 項目ずつ調整します。

DeepSeek Harness のプラグインと shell はローカルマシン上で操作を実行できます。専用のキー、制限付きの予算、最小限のモデル範囲を使い、ツール自身のサンドボックスと承認設定も維持してください。

CC Switch の現在のプロバイダーインポートプロトコルには DeepSeek Harness が記載されていないため、インポートボタンは提供しません。

公式リファレンス：DeepSeek Harness モデル設定。

DeepSeek Harness · ドキュメント · InOneAPI