Mars-Sea/dsh-commandcode-provider

Command Code provider plugin for DeepSeek Harness (dsh). Adds Command Code model access, live model catalog, plan-aware model selection, reasoning effort, image input, web search, and multi-account support.

dsh‑commandcode‑provider – 개요

dsh‑commandcode‑provider는 DeepSeek Harness(LLM 기반 에이전트를 위한 "dsh" UI 프레임워크)가 Command Code 대규모 언어 모델 서비스와 통신할 수 있게 해주는 비공식 플러그인입니다. DeepSeek의 내장 모델과 함께 표시되는 commandcode라는 새로운 제공자를 추가하여 Command Code 모델 선택, 사용 할당량 확인, Command Code API를 통한 웹 검색 실행을 가능하게 합니다.

주요 이점

원클릭 통합 – dsh plugin add 명령어로 플러그인을 설치하면 모델 선택기에 제공자가 나타납니다.
전체 UI 지원 – 웹 기반 dsh UI와 터미널 전용 dsh‑TUI 모두에서 설정 페이지를 통해 로그인, 다중 Command Code 계정 관리, 기능 전환(할당량 카드, 데이터 보존 제로, 웹 검색 등)이 가능합니다.
다중 계정 로테이션 – 여러 Command Code 구독을 사용하는 경우, 현재 계정이 할당량에 도달하면 플러그인이 자동으로 다음 계정으로 전환합니다.
플랜 인식 모델 선택기 – 모델에는 플랜 레벨, 무료/유료 배지, 이미지 지원 및 추론 노력 옵션이 표시되며, 플랜 외 모델은 기본적으로 숨겨집니다.
비용 추정 – 토큰 카운터가 모델의 게시된 요율에 따라 각 요청의 대략적인 비용을 표시합니다.
비전 지원 – 비전 지원 Command Code 모델은 이미지를 수락합니다. 선택적 캐시 오프로드 설정을 통해 반복적인 이미지 캐시 비용을 줄일 수 있습니다.
웹 검색 도구 – dsh web_search 도구는 추가 키 없이 Command Code의 /alpha/web‑search 엔드포인트를 활용할 수 있습니다.

설정 방법

설치(dsh 0.2.0‑rc.2 또는 0.2.1‑alpha.1과 호환):
```
dsh plugin --profile web add @mars-sea/dsh-commandcode-provider@latest
```
터미널 UI도 사용하는 경우 dsh‑tui 프로필에 대해서도 설치를 반복하십시오.
Command Code API 키 획득 – 공식 command-code CLI(cmd login)를 사용하거나 설정 페이지의 Sign in to Command Code 버튼을 클릭하여 획득합니다.
키 입력 – Settings → Command Code에 입력합니다(또는 환경 변수 COMMANDCODE_API_KEY 설정).
모델 선택 – 새로운 commandcode 항목이 모델 선택기에 나타납니다. 예:
```
/model commandcode/deepseek/deepseek-v4.1-flash
```
채팅 시작 – 제공자는 dsh 내의 다른 LLM과 동일하게 작동하며 할당량 정보, 비용 추정 및(활성화된 경우) 이미지 처리가 표시됩니다.

기능 요약

기능	내용	설정 위치
플러그인 번들	`commandcode` 제공자 경로 및 라이브 모델 카탈로그를 등록합니다.	`dsh plugin add`
설정 페이지	API 키, 계정 로테이션, 모델 가시성, 개인정보 설정을 관리합니다.	UI → Settings → Command Code
다중 계정 로테이션	할당량이 소진되면 자동으로 다음 계정으로 전환합니다.	Settings → Accounts card
플랜 인식 모델 선택기	구독 등급 외 모델을 숨기고 배지, 컨텍스트 창, 이미지 지원을 표시합니다.	Model picker UI
추론 노력 수준	낮음/중간/높음 노력을 선택할 수 있는 모델을 노출합니다.	Model picker (if model supports)
이미지 입력 및 캐시 오프로드	비전 모델이 이미지를 수락합니다. 선택적 `offloadSeenImagesForCache`는 이전 이미지를 자리 표시자로 대체하여 캐시 급증을 방지합니다.	Settings → Advanced
할당량 카드	현재 5시간 및 주간 사용량, 크레딧 잔액, 재설정 타이머를 표시하는 사이드바 패널.	Settings → Integrations & display → “Show quota card”
세션 비용 추정	토큰 카운터 옆에 표시되는 대략적인 비용 (`≈`).	Composer UI
웹 검색 통합	`web_search` 도구가 Command Code의 `/alpha/web-search` 엔드포인트를 사용합니다.	Settings → Command Code → “Serve dsh web search with Command Code”
데이터 보존 제로 (ZDR)	`x‑cmd‑zdr: 1` 헤더를 전송하여 프롬프트가 저장되거나 학습에 사용되지 않도록 합니다.	Settings → Privacy & security

권장 사용자

dsh 사용자 – dsh 환경을 떠나지 않고 Command Code 모델(최신 DeepSeek 기반 모델 포함)을 실험하려는 분.
여러 Command Code 구독을 가진 팀 – 로테이션 로직을 통해 수동으로 키를 교체하는 번거로움을 줄일 수 있습니다.
비전 기능이 필요한 개발자 – 이미지 지원 모델을 지원하며 비용 제어를 위한 캐시 오프로드 옵션을 제공합니다.
비용 가시성을 원하는 분 – 내장된 비용 추정 및 할당량 카드를 통해 사용량을 예측할 수 있습니다.

제한 사항 / 주의 사항

dsh 0.2.0‑rc.2 또는 0.2.1‑alpha.1에서만 작동합니다 – 이전 dsh 릴리스는 지원되지 않습니다.
pnpm 11 연령 제한 – @latest 사용 시 최근 릴리스가 건너뛰어질 수 있습니다. 최신 빌드가 필요한 경우 정확한 버전을 고정하십시오.
데이터 보존 제로는 기본적으로 꺼져 있습니다 – 개인정보 보호가 중요한 경우 수동으로 활성화해야 합니다.
캐시 오프로드는 선택 사항입니다 – 활성화하면 이미지 캐싱 방식이 변경되어 모델 동작에 영향을 줄 수 있습니다.
공식 Command Code 제품이 아닙니다 – 자체 API 키를 제공해야 하며 Command Code의 이용 약관을 준수해야 합니다.

빠른 참조 명령어

# 웹 UI용 설치
 dsh plugin --profile web add @mars-sea/dsh-commandcode-provider@latest

# 터미널 UI용 설치
 dsh plugin --profile dsh-tui add @mars-sea/dsh-commandcode-provider@0.11.15

# 모델 선택
 /model commandcode/deepseek/deepseek-v4.1-flash

# 계정별 사용량 표시
 /commandcode   # 또는 /commandcode status

요약: dsh‑commandcode‑provider는 Command Code의 LLM 카탈로그, 할당량 관리, 비전 및 웹 검색 기능을 DeepSeek Harness 생태계로 가져오는 커뮤니티 유지 관리 브리지이며, 풍부한 UI와 다중 계정 및 비용 인식 사용을 위한 합리적인 기본 설정을 갖추고 있습니다.