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")를 호출할 수 있도록 합니다.

주요 기능

기능	기능 설명
전역 설치	`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 에이전트에서 사전 처리해야 합니다.

설치 및 최초 설정

사전 요구 사항 – macOS 또는 Windows, Python 3.11+, 설치된 Codex 데스크톱 앱, DeepSeek API 키.
위에 표시된 전역 설치 명령어를 실행합니다.
Codex를 재시작하고, 새 채팅을 시작한 후 다음을 입력합니다:
```
帮我把 DeepSeek 配置成 Codex 的原生子 Agent。
```
프롬프트에 따라 원하는 DeepSeek 모델을 선택합니다.
키가 필요하면 작은 UI(노드 22+ 필요)가 열리며, 키를 붙여넣고 시스템 자격 증명 저장소에 저장합니다.
스킬이 status: ready라고 보고하면, 다시 Codex를 재시작합니다. 이후에는 단순히 다음을 입력하면 됩니다:
```
用 DeepSeek 子 Agent 检查这个项目。
```
그러면 Codex는 DeepSeek 서브에이전트를 호출합니다.

통합 관리

Windows에서는 동등한 py -3 명령어를 사용할 수 있습니다. Codex 실행 파일이 자동으로 발견되지 않으면 CODEX_DESKTOP_BIN을 codex.exe의 경로로 설정하세요.

보안 및 롤백

라이선스

자세한 정보

이 설명은 리포지토리의 README에 기반하며, 추가 기능은 추측되지 않았습니다.