DeepSeek Harness モデル設定

DeepSeek Harness は DeepSeek 公式の設定を使用することも、サードパーティのモデルを使用することもできます。

プロバイダータイプ説明認証情報の要件適用シーン
DeepSeekDeepSeek 公式エンドポイントDeepSeek API キー（書き込みのみ）デフォルト、最も早く始められる
ディレクトリプロバイダーインストール済みディレクトリ内のプロバイダー（Anthropic、OpenAI など）各社の API キー；ネイティブ認証にはそれぞれの認証情報が必要収録済みの主要ベンダーに接続
カスタムプロバイダー自作エンドポイント（会社のゲートウェイ、自作サーバーなど）Provider ID、baseURL、プロトコル、認証情報、モデルディレクトリにないエンドポイント

http://127.0.0.1:3080/ を開くと、インターフェース全体は以下のようになります。まず「設定」をクリックして API キーを設定できます：

API キーをまだお持ちでない場合は、https://platform.deepseek.com/api_keys申請できます。

次に設定 → モデルを開き、DeepSeek カードに API キー入力欄があるので、入力して保存するだけです。

ディレクトリプロバイダーを追加

ディレクトリプロバイダーは、dsh のインストール済みディレクトリがエンドポイント、プロトコル、モデルリストを提供します。

プロバイダーの追加を選択し、Anthropic や OpenAI などのプロバイダーを選び、その API キーを入力して保存します。

インストール済みディレクトリが自動的にエンドポイント、プロトコル、モデルリストをもたらすため、手動で入力する必要はありません。

例えば、智谱（Zhipu）の coding plan プランを設定する場合：

設定が完了すると、ダイアログのモデルリストに追加したモデルが表示されます：

ネイティブ認証を使用するプロバイダーにはそれぞれのネイティブ認証情報が必要で、API キー欄に入力するだけでは設定を完了できません。

プロバイダー必要なネイティブ認証情報
BedrockAWS 認証情報とリージョン
VertexADC プロジェクト
Azureapi-version
CodexOAuth

カスタムプロバイダーを追加

会社のゲートウェイや自社サーバーなど、ディレクトリに存在しないエンドポイントは、カスタムプロバイダーで接続します。

カスタムプロバイダーの追加を選択し、次のフィールドを入力します。

フィールド説明必須かどうか
Provider ID小文字、永久的な識別子必須
表示名インターフェースに表示される名前任意
ベース URLエンドポイントの baseURL必須
API プロトコル例: openai-completions必須
認証情報API キーまたは環境変数参照必須
モデル少なくとも 1 つのモデル必須

Provider ID は永久的です。リクエスト、保存済みセッション、モデルのデフォルト値、認証情報の参照がすべてそれを使用するためです。

プロバイダーの名前を変更するには、新しいプロバイダーを追加して古いプロバイダーを削除してください。

表示名、ベース URL、プロトコル、認証情報、モデルは引き続き編集できます。

モデルディレクトリで「利用可能なモデルを取得」を選択すると、フォームに現在表示されているベース URL と認証情報を使用してクエリを実行できます。

候補を選択してもドラフトが更新されるだけで、保存するまでプロバイダーは保存されません。

ディレクトリプロバイダーはインストール済みディレクトリを使用し、ネットワークリクエストを発行しません。

画像入力：視覚モデルにモダリティを宣言する

手動で入力したモデルはデフォルトでプレーンテキストとして扱われます。画像をサポートするには明示的な宣言が必要です。

エンドポイントがどのモダリティを受け付けるかを問い合わせる仕組みがないため、dsh は「先に宣言してから使用する」戦略を採用しています。

このようなモデルに画像を添付すると、送信前に拒否され、そのモデルが指名されます。

カスタムプロバイダー配下の視覚モデルには 1 行追加する必要があります。フォームには対応するフィールドがありません。

$DSH_HOME/settings.yaml でそのモデルに input を追加してください。

# 文件路径：$DSH_HOME/settings.yaml
# 顶层键 llm-pi-ai 是模型路由插件的 id，providers 下按提供方 id 组织
llm-pi-ai:
  providers:
    my-gateway:
      apiKeyEnv: GATEWAY_API_KEY          # 凭据引用：从 GATEWAY_API_KEY 环境变量读取
      api: openai-completions             # API 协议：OpenAI 兼容的补全协议
      baseURL: https://gateway.サンプル.example/v1  # 你的网关端点
      models:
        - id: legacy-chat                 # 纯文本模型，不写 input 即按纯文本对待
        - id: vision-preview              # 视觉模型
          input: [text, image]            # 声明同时接受文本与图片

input は text と image を受け入れ、そのモデルにのみ適用されるため、1 つのルートで 2 種類のモデルを同時に提供できます。

それを省略するか、空のリストとして記述するかは、両方とも同じ意味です。

その場合、インストール済みディレクトリがそのモデルについて記録したモダリティが保持されます。ディレクトリが記述していないモデルは、そのルートの defaultInput にフォールバックします。

手動で入力したモデルがすべて画像を受け付ける場合は、ルート上でフォールバック値を一度設定できます。

# 文件路径：$DSH_HOME/settings.yaml
# defaultInput 是回退值而不是覆盖值，默认为 [text]
llm-pi-ai:
  providers:
    vision-gateway:
      apiKeyEnv: GATEWAY_API_KEY
      api: openai-completions
      baseURL: https://vision.サンプル.example/v1
      defaultInput: [text, image]         # 对本路由下目录未描述的模型生效
      models:
        - id: first-model
        - id: second-model

ディレクトリプロバイダー内の特定のモデルのモダリティを絞り込むには、modelOverrides の下にモデル ID をキーとして記述します。

# 文件路径：$DSH_HOME/settings.yaml
# 目录提供方没有可填写的 models 列表，覆盖走 modelOverrides
llm-pi-ai:
  providers:
    anthropic:
      modelOverrides:
        claude-sonnet-4-5:
          input: [text]                   # 把该模型的图片能力去掉

input と defaultInput はどちらもエンドポイントに対する表明であり、エンドポイントの検査ではありません。

エンドポイントが実際には提供していない画像能力を宣言したモデルは、ここではブロックされず、代わりにプロバイダーがそのリクエストを拒否します。

トラブルシューティング表

モデル設定でエラーが発生すると、dsh は明確なエラーメッセージを表示します。以下の表を参照してトラブルシューティングしてください。

エラー意味解決方法
MISSING_CREDENTIALプロバイダーキーがありませんモデルページでプロバイダーキーを保存するか、参照されている環境変数を提供してください
UNKNOWN_MODELリクエストされたモデルが設定されていません設定済みのモデルを選択するか、カスタムプロバイダーに不足しているモデルを追加してください
利用可能なモデルの取得が 401 を返しましたキーが無効であるか、エンドポイントがモデル検出をサポートしていませんキーを確認してください。モデル検出は OpenAI 互換の GET /models を呼び出します。このエンドポイントを提供しないサービスでは、モデルを手動で入力してください
画像が送信前に拒否されましたモデルが画像モダリティを宣言していませんカスタムプロバイダーのモデルに input: [text, image] を追加してください。DeepSeek 自体のルートはプレーンテキストであり、設定では変更できません
プロバイダーが画像付きのリクエストを拒否しましたモデルがエンドポイントが実際には提供していない画像能力を宣言しています画像能力を付与したリストから image を削除し、新しいセッションを開始してください
その他の拡張