dsh-workbuddy-connect: DeepSeek Harness에 WorkBuddy 무료 모델을 직결하는 오픈소스 플러그인
로컬 WorkBuddy 데스크톱의 로그인 세션을 읽어 GLM, DeepSeek-V4, Kimi 등 모델을 DeepSeek Harness(DSH)에서 바로 호출하는 오픈소스 플러그인 dsh-workbuddy-connect의 기능과 설치 주의사항을 소개합니다.
로컬 개발 환경에서 다양한 파운데이션 모델을 통합 관리하는 딥시크 하네스(DeepSeek Harness, DSH) 생태계에 새로운 확장 도구가 등장했습니다. 개발자이자 AI 크리에이터인 @aehyok이 공개한 오픈소스 플러그인 'dsh-workbuddy-connect'는 로컬 PC에 설치된 워크버디(WorkBuddy) 데스크톱 클라이언트의 로그인 상태를 읽어와, 워크버디가 제공하는 다양한 대규모 언어 모델(LLM)을 DSH 환경에서 직접 호출할 수 있도록 연결합니다.

이미지 출처: X @aehyok
별도의 복잡한 API 키 발급이나 프록시 서버 설정 없이, 로컬 데스크톱에 활성화된 세션 정보를 활용해 GLM, DeepSeek-V4, Kimi 등 주요 모델들을 단일 하네스 작업 환경으로 통합할 수 있는 간결한 접근 방식이 개발자들의 주목을 받고 있습니다.
로컬 데스크톱 세션 연동 메커니즘과 다중 모델 라인업
dsh-workbuddy-connect의 핵심 아키텍처는 로컬 PC에 상주하는 WorkBuddy 데스크톱 앱의 인증 세션을 비공식 클라이언트 인터페이스로 감지하여 DSH의 런타임에 직접 주입하는 구조입니다.
- 지원 모델 라인업: GLM 시리즈, DeepSeek-V4, 키미(Kimi), 미니맥스(MiniMax), 텐센트 훈위안(Hunyuan) 등 중국 현지 주요 파운데이션 모델 라인업이 폭넓게 연동됩니다.
- 중국 현지판 및 글로벌판 동시 지원: WorkBuddy의 중국 현지 버전과 글로벌(해외) 버전을 모두 지원하며, 시스템에 두 버전이 함께 설치되어 있는 경우 DSH 내에서 별도의 두 그룹으로 자동 분리되어 병존합니다.
- 단일 작업창 내 모델 전환: 사용자는 DSH의 통합 인터페이스 안에서 코딩, 분석, 문서 작성 등 작업 성격에 맞추어 여러 벤더의 모델을 즉각 전환하며 워크플로우를 이어갈 수 있습니다.
외부 웹 브라우저를 오가며 수동으로 세션을 유지할 필요 없이, 데스크톱에 설치된 정식 클라이언트의 로그인 상태만으로 복수의 모델 카탈로그를 DSH에 동기화할 수 있는 점이 실질적인 편의성을 제공합니다.
포인트 배율 표기 체계와 3단계 설치 절차
플러그인이 연동되면 DSH의 모델 선택 드롭다운 목록에서 각 모델명 옆에 실시간 포인트 배율(Multiplier)이 직관적으로 표기됩니다.
- 프로모션 무료 배율(x0.00): 목록에서 'x0.00'으로 표시된 모델은 WorkBuddy 측의 한시적 프로모션 이벤트가 적용된 상태로, 계정의 추가 포인트 차감 없이 호출할 수 있습니다.
- 유료 차감 모델의 배율 확인: 배율이 0보다 큰 모델의 경우 해당 숫자에 비례하여 포인트가 소모되므로, 작업자는 작업량과 예산에 맞춰 가성비가 높은 모델을 선별하여 활용할 수 있습니다.
- 직관적인 3단계 설치 경로:
- PC에 WorkBuddy 데스크톱 클라이언트(중국 현지판 또는 글로벌판)를 설치하고 계정에 로그인합니다.
- DSH 데스크톱의 플러그인 관리자(Plugin Manager) 메뉴에서
dsh-workbuddy-connect를 검색해 설치합니다(또는 프로젝트 README의 설치 안내 프롬프트를 DSH에 직접 입력해 자동 설치를 진행합니다). - DSH를 완전히 재시작한 뒤, 모델 목록의 'WorkBuddy' 그룹에서 원하는 모델(x0.00 프로모션 모델 등)을 선택해 작업을 시작합니다.
커널 버전 일치 요구사항과 계정 안전성 주의사항
dsh-workbuddy-connect를 실제 작업 파이프라인에 적용하기 전, 개발자가 반드시 점검해야 할 기술적 제약과 운영 리스크가 존재합니다.
- DSH 내부 커널 버전 엄격 일치: 플러그인의 빌드 버전은 DSH 앱의 내부 커널 버전과 정확히 일치해야 합니다. 버전이 일치하지 않을 경우 DSH 프로그램 자체가 정상적으로 기동되지 않는 오류가 발생하므로, 데스크톱 앱의 '정보(About)' 페이지에서 확인한 내장 커널 버전과 프로젝트 README의 버전 호환표를 대조한 후 설치해야 합니다.
- 비공식 클라이언트 인터페이스 활용과 계정 리스크: 공식 공개 API가 아닌 로컬 데스크톱 클라이언트의 비공식 인터페이스를 통해 세션을 읽어오므로, 서비스 제공업체의 운영 정책이나 보안 패치에 따라 계정 이용 제한(차단) 등의 제재가 가해질 위험이 있습니다.
- 한시적 프로모션 변동성: 'x0.00' 무료 배율 표기는 WorkBuddy 본사의 이벤트 정책에 종속되어 있어 언제든지 유료 과금 배율로 환원될 수 있으며, 상업적 대량 트래픽보다는 개인 연구 및 개발 용도의 적정 사용이 권장됩니다.
출처
- X @aehyok: dsh-workbuddy-connect 오픈소스 플러그인 릴리즈 소식