oil-oil/codex-deepseek-subagent

配置和维护桌面应用中的原生子 Agent,支持选择模型、检查路由、修复、停用和卸载。

codex‑deepseek‑subagent – Codex デスクトップアプリに DeepSeek をネイティブなサブエージェントとして追加

何であるか

  • Codex デスクトップアプリ(OpenAI の ChatGPT/Codex プロダクトに同梱される UI)用の スキル(プラグイン)。このスキルは DeepSeek の大規模言語モデル API を、Codex アプリが直接呼び出せる ネイティブなサブエージェント として登録します。
  • これは 設定、健全性チェック、修復のみ を行います。通常のコーディングや生成タスクは行いません。

なぜ必要か

  • Codex は他の LLM プロバイダー上で実行されるサブエージェントを起動できます。このスキルがなければ、設定ファイルを手動で編集し、API キーを管理し、DeepSeek モデルが正しく接続されているかを確認する必要があります。
  • このスキルは、インストール、DeepSeek モデルの選択(Flash または Pro)、OS の資格情報ストアを介した API キーの入力、検証セッションの実行、そして通常のタスクで spawn_agent(agent_type="DeepSeek") を呼び出すように Codex に指示するまで、すべてのワークフローを自動化します。

主な機能

機能 機能内容
グローバルインストール npx skills add oil-oil/codex-deepseek-subagent -g -y で、マシン上のすべての Codex ユーザーにスキルを登録します。
モデル選択 最初の設定時に deepseek‑v4‑flash(安価で高速)または deepseek‑v4‑pro(より強力)のどちらかを選択できます。
資格情報の取り扱い macOS では API キーは Keychain に、Windows では Credential Manager に保存されます。スキルはチャットでキーを送信しません。
ステータス/テスト/修復コマンド CLI スクリプト(`codex_deepseek.py status
自動バックアップ&ロールバック 設定ファイルやモデルファイルを書き込む前にバックアップが作成され、失敗時には以前の状態が自動的に復元されます。
互換性チェック 親の Codex モデルが選択された DeepSeek モデルと一致しているか、返されたトークン NATIVE_DEEPSEEK_OK が存在するかを検証します。
視覚的入力なし DeepSeek はテキストのみを処理します。画像/動画は、メインの Codex エージェントで事前に処理する必要があります。

インストールと初回設定

  1. 前提条件 – macOS または Windows、Python 3.11+、インストール済みの Codex デスクトップアプリ、および DeepSeek API キー。
  2. 上記のグローバルインストールコマンドを実行します。
  3. Codex を再起動し、新しいチャットを開始して、以下の内容を入力します:
    帮我把 DeepSeek 配置成 Codex 的原生子 Agent。
    
  4. プロンプトに従って希望する DeepSeek モデルを選択します。
  5. キーが必要な場合、小さな UI(Node 22+ 必須)が開きます。キーやを貼り付けて、システムの資格情報ストアに保存します。
  6. スキルが status: ready と報告したら、再度 Codex を再起動します。以降は単に以下の内容を入力するだけで済みます:
    用 DeepSeek 子 Agent 检查这个项目。
    
    これにより Codex は DeepSeek サブエージェントを呼び出します。

統合の管理

  • ステータス: python3 scripts/codex_deepseek.py status --json
  • テスト(孤立した受入テストを実行): ... test --json
  • 修復/モデル切り替え: ... repair --model deepseek-v4-pro --json
  • 無効化: ... disable --json
  • アンインストール: ... uninstall --json

Windows では同等の py -3 コマンドを使用できます。Codex の実行可能ファイルが自動検出されない場合は、CODEX_DESKTOP_BINcodex.exe のパスに設定してください。

セキュリティとロールバック

  • API キーはコンソールに表示されず、チャットで送信されることもありません。OS が提供する安全なストアにのみ保存されます。
  • すべての書き込みはトランザクショナルです。失敗時には自動的にバックアップが復元されます。
  • スキルはメインの Codex モデルやログイン方法を変更しません。DeepSeek サブエージェントの設定のみを操作します。

ライセンス

  • MIT ライセンスの下で配布されています。

詳細情報の入手先

  • 互換性とルーティングの詳細: codex-deepseek-subagent/references/compatibility.md
  • スキル実行ルール: SKILL.md
  • API キー UI ガイド: references/api-key-setup.md
  • 公式 DeepSeek モデル一覧および Codex インストールスクリプトのリンクは、README に参考として記載されています。

この説明はリポジトリの README に基づいており、追加の機能は推測されていません。

関連

  • プロジェクト
  • プロジェクト
  • プロジェクト