dsh-plugin-subscriptions

개요 – DeepSeek Harness (DSH) 웹 UI용 플러그인으로, API 키를 입력하지 않고 구독 기반 LLM 제공업체(ChatGPT (Codex), Claude, xAI Grok, GitHub Copilot, Google Antigravity)에 로그인, 관리, 사용할 수 있습니다. OAuth 토큰을 로컬에 저장하고, 사용량 할당량을 표시하며, 제공업체의 모델을 DSH의 모델 선택기에 추가합니다.

---

주요 기능

기능	설명
다중 제공업체 OAuth 로그인	설정 → 구독에서 연결을 클릭합니다. Codex, Grok, Antigravity는 브라우저 흐름을 사용하고, Copilot은 GitHub 기기 코드 흐름을 사용하며, Claude는 Claude Code에서 자격 증명을 가져오거나 브라우저 OAuth로 대체할 수 있습니다.
구독 표시 이름	각 제공업체 또는 모델에 친숙한 이름(≤80자)을 지정합니다. 이름은 provider-settings.json에 저장되며 UI 레이블만 변경하고 라우팅은 변경하지 않습니다.
모델 선택기 통합	로그인한 제공업체는 라이브 카탈로그(모델 ID, 추론 수준, 비전 기능)와 함께 DSH의 기본 모델 선택기에 표시됩니다.
추론 노력 선택기	노력 수준을 노출하는 모델(Codex, Grok 4.5/4.6, Copilot)의 경우 드롭다운에서 원하는 노력을 선택할 수 있으며, 선택 항목은 요청에서 reasoning_effort 또는 reasoning.effort로 전송됩니다.
Codex 속도 토글	Codex 모델의 카탈로그가 "빠른" 등급을 광고하는 경우 작성기에 표준 / 빠른 토글이 나타납니다. /fast 슬래시 명령도 동일한 옵션을 제공합니다.
하위 에이전트 속도 기본값	각 모델은 하위 에이전트에 대한 고유한 기본 속도를 가질 수 있으며, 설정은 다시 시작해도 유지됩니다.
사용량 알약 UI	작성기의 작은 배지에 현재 제공업체의 할당량 사용량(백분율, 재설정 시간)이 표시됩니다. 클릭하면 로그인한 모든 계정 목록이 확장되고 기본 계정이 강조 표시됩니다.
도구 지원	web_search(Codex), x_search(Grok), image_generate, video_generate 도구를 등록합니다. 이미지/비디오 생성은 대화 내에서 인라인으로 작동하며 제공업체별 할당량을 준수합니다.
이미지/비디오 관리	생성된 자산은 ~/.dsh/plugins/subscriptions/images/ 및 …/videos/에 저장되며, 재사용을 위해 경로가 반환됩니다. 이미지 편집은 제공업체별 엔드포인트를 통해 지원됩니다.
자동 카탈로그 새로 고침	시작 시 플러그인은 각 제공업체의 모델 카탈로그를 가져와 5분 동안 캐시한 다음 매시간 새로 고칩니다. 수동 새로 고침 버튼은 즉시 업데이트를 강제합니다.
계정 풀링	제공업체에 여러 계정이 있는 경우 플러그인은 먼저 기본 계정을 시도한 다음, 동일한 세션에서 성공한 계정으로 대체합니다. 풀링은 제공업체별로 비활성화할 수 있습니다.

---

설치

# DSH CLI 사용(웹 프로필)
dsh plugin --profile web add dsh-plugin-subscriptions

또는 GitHub에서:

# 저장소에서 직접 설치
 dsh plugin --profile web add github:V1ki/dsh-plugin-subscriptions

소스에서 설치하는 경우 pnpm이 필요합니다:

git clone https://github.com/V1ki/dsh-plugin-subscriptions.git
cd dsh-plugin-subscriptions
pnpm install && pnpm build
# 빌드된 플러그인을 프로필에 추가
 dsh plugin --profile web add ./dsh-plugin-subscriptions

이 플러그인은 DSH 0.2.x 사전 릴리스 및 안정적인 0.1.x 시리즈에서 작동합니다. 정확한 버전 호환성은 README를 참조하세요.

---

기본 사용 흐름

1. dsh web을 실행하고 브라우저에서 URL을 엽니다.
2. 설정 → 구독을 엽니다.
3. 제공업체에 대해 연결을 클릭하고 OAuth 흐름을 완료합니다(또는 Claude 자격 증명 가져오기).
4. 선택적으로 구독에 친숙한 이름을 지정합니다.
5. 채팅 세션에서 모델 선택기(/model)를 열고 새로 추가된 제공업체 아래에서 모델을 선택합니다.
6. 통합 도구(image_generate, video_generate, web_search, x_search)를 대화에서 직접 사용합니다.

제공업체가 로그인되어 있지 않으면 선택기에서 숨겨지고 해당 제공업체에 대한 요청은 MISSING_CREDENTIAL을 반환하고 설정 페이지로 연결되는 링크를 제공합니다.

---

혜택을 받을 수 있는 사용자

• DSH의 파워 유저로, 여러 LLM 서비스에 유료 구독이 있고 이를 전환하기 위한 단일 UI를 원하는 경우.
• AI 증강 워크플로우를 구축하는 개발자로, API 키를 수동으로 처리하지 않고 제공업체별 도구(이미지/비디오 생성, 웹 검색)에 액세스해야 하는 경우.
• DSH 인스턴스를 공유하는 팀으로, 계정별 관리, 할당량 가시성, 일관된 모델 명명이 필요한 경우.

---

제한 사항 및 참고 사항

• 플러그인은 README에 나열된 제공업체만 지원합니다. 새 제공업체를 추가하려면 코드 변경이 필요합니다.
• Copilot은 사용량 엔드포인트를 노출하지 않으므로 사용량 배지에 할당량 정보가 표시되지 않습니다.
• 모든 토큰 파일은 ~/.dsh/plugins/subscriptions/auth.json에 모드 0600으로 저장됩니다. 기기를 안전하게 유지하세요.
• 이미지/비디오 생성은 각 제공업체의 할당량을 준수하며, 기본 계정에 크레딧이 부족한 경우 로그인한 다른 제공업체로 대체될 수 있습니다.

---

TL;DR – dsh-plugin-subscriptions은 DSH를 멀티 구독 허브로 전환하여 OAuth 로그인, 할당량 표시, 모델 검색, 유용한 생성 도구 세트를 API 키를 복사할 필요 없이 처리합니다.