DSH WorkBuddy Connect

English | 中文

로그인된 WorkBuddy / WorkBuddy AI 데스크톱 애플리케이션에서 사용 가능한 모델을 DeepSeek Harness에 연결합니다. 두 버전은 각각의 모델 그룹을 표시하며, 각자의 계정 로그인 및 포인트를 유지합니다.

설치

사전 준비 사항: 로컬 컴퓨터에 WorkBuddy (국내판) 또는 WorkBuddy AI 데스크톱 앱이 이미 설치되어 있고 로그인되어 있어야 합니다. 플러그인은 앱의 로그인 상태를 직접 재사용하므로, 계정 전환 시 자동으로 따라가며 두 버전은 서로 영향을 주지 않습니다.

권장 사항: 로컬에 있는 Agent에게 설치를 맡기는 것이 좋습니다. — 터미널 및 파일 조작 능력을 갖춘 모든 비서(DSH Agent, Codex, Claude Code, Cursor 등)가 가능합니다. 다음 내용을 그대로 전달하세요:

요청드립니다: DSH (DeepSeek Harness) 플러그인 dsh-workbuddy-connect를 설치하고 검증해 주세요 (프로젝트 주소: https://github.com/corrinehu/dsh-workbuddy-connect):
먼저 프로젝트 README를 읽고, 제가 실제로 사용하는 인터페이스(Web / Desktop / TUI)와 DSH 코어 버전을 확인해 주세요. 데스크톱 버전은 앱 내장 코어를 기준으로 하며, 독립적인 CLI 버전을 대체해서는 안 됩니다;
그다음 버전 대응 관계에 따라 npm 공식 패키지에서 설치하세요 (0.2.1-rc.2→0.7.8, 0.2.1-rc.1→0.7.7, 0.2.0-rc.2→0.7.6, rc.1→0.7.0, 0.1.5–0.1.7→0.6.5). 가능한 한 로컬에서 지원하는 플러그인 마켓 채널을 이용하세요. 일부 데스크톱 배포판(특히 공식 Electron 버전)의 프로필은 앱이 관리하므로, 각 배포판의 규칙이 다를 수 있습니다. 먼저 사용 중인 배포판을 확인한 후, 규정 준수하는 설치 방법을 탐색해야 하지만, 검증 과정을 우회해서는 안 됩니다;
...

코어 및 플러그인 버전 빠른 확인 (전체 대응표는 본문 끝 '버전 호환성 및 이전 버전' 참조):

# Web (실제 코어 고정 버전에 따라 다름. 예시: 0.2.1-rc.2 → 0.7.8; github:corrinehu/dsh-workbuddy-connect 에서 소스코드 설치도 가능)
dsh plugin --profile web add [email protected]
dsh web
...

TUI 버전 조합: 터미널 셸 @deepseek-harness-tui/dsh-tui는 0.10.0-beta.5 이상이 필요합니다. 더 이전 버전에 이 플러그인을 설치하면 시작 실패(events is not iterable)가 발생할 수 있습니다. 추론 단계의 수동 검사는 Web / Desktop에서만 제공되며, TUI에서는 지원하지 않습니다.

Desktop: 일부 데스크톱 배포판(특히 공식 Electron 버전)의 desktop 프로필은 앱이 관리합니다. 공식 버전은 독립적인 CLI의 --profile desktop을 직접 거부할 것입니다. 다른 배포판의 규칙이 다를 수 있으니, 사용 중인 배포판을 먼저 확인하고 독립적인 CLI의 --profile desktop을 맹목적으로 사용하지 마세요. Agent에게 규정 준수하는 비시장 설치 경로가 있는지 탐색하게 할 수는 있지만, 성공을 보장하지는 않습니다. 앱이 관리하는 디렉토리를 임의로 수정하거나 검증 과정을 우회해서는 절대 안 됩니다.

검증: 해당 인터페이스를 재시작한 후, 모델 선택기에 'WorkBuddy / WorkBuddy AI' 그룹이 나타나는지 확인하세요 (하나만 설치하면 해당 그룹만 보임). 그리고 그 그룹에서 모델 하나를 선택하여 짧은 대화를 완료하고 정상적으로 답변을 받으면 설치가 성공한 것입니다.

기능

• 즉시 사용 가능: 플러그인을 설치하고 활성화하면 DSH 내에서 추가 설정 없이 바로 사용할 수 있습니다.

• 국내판과 국제판 공존: 국내판은 'WorkBuddy' 그룹으로, 국제판(WorkBuddy AI)은 'WorkBuddy AI' 그룹으로 표시됩니다. 두 버전의 모델, 계정 및 포인트는 서로 섞이지 않습니다. 각각 해당 앱의 로그인 상태를 따릅니다: 국제판만 설치하면 WorkBuddy AI만 나타나고, 두 버전을 모두 설치하면 두 그룹이 공존하며, 한 버전을 로그아웃하면 해당 그룹이 사라집니다. 설정에서 두 개의 카드가 각각의 계정 및 잔액을 보여줍니다.

• 이미지 입력: 대부분의 모델은 대화에 이미지를 직접 붙여넣거나 드래그하여 넣는 것을 지원합니다 (GLM-5.3-Flash, DeepSeek-V4 시리즈 등). 소수의 순수 텍스트 모델(예: GLM-5.1, GLM-5.2)의 경우 지원하지 않는다고 명확하게 안내합니다.

• 추론 단계 (推理档位): WorkBuddy가 명시적으로 선언한 단계(예: GLM-5.3 및 GLM-5.3-Flash)는 low / high / max를 선택할 수 있도록 직접 표시됩니다. 단계가 선언되지 않은 모델은 Web과 Desktop의 모델 선택기에서 수동으로 감지할 수 있습니다 (소량의 요청을 보내어 포인트 소모 가능). 감지되지 않았거나 사용 가능한 단계가 없는 모델은 WorkBuddy 기본 단계를 사용합니다.

• 잔액 요약 (余额速览): WorkBuddy / WorkBuddy AI 모델이 선택된 경우, 입력창 하단에 모델 선택기 옆으로 현재 계정의 잔여 포인트(예: WB.3,401（积分）, 국제 버전 WB AI.3,401（积分）)가 표시됩니다. 포인트는 자동으로 조회되지 않습니다 (매번 읽을 때 실제 과금 조회). 플러그인을 로드할 때 한 번 읽으며, 이후에는 포인트 문자 앞의 ↻ 버튼을 눌러 수동으로 새로 고침 할 수 있습니다. 세션을 전환할 때 컴포넌트가 일시적으로 숨겨질 수 있으며, 모델 선택이 준비되면 자동으로 복구됩니다. 모델에 추론 단계 감지 진입점이 없거나 잔액 읽기에 실패해도 새로 고침 버튼은 유지됩니다.

• 정보 확인 및 감지: 설정 → 플러그인 → 해당 카드를 통해 계정, 토큰 만료일, 잔여 포인트, 모델 할인을 확인할 수 있으며, 모델 목록을 수동으로 새로 고치고 현재 목록이 상위(upstream)에서 왔는지 내장 폴백(built-in fallback)에서 왔는지 확인하거나, 감지 가능한 모델의 추론 단계를 수동으로 감지할 수 있습니다. DSH 0.1.5 버전의 진입점은 「설정 → 플러그인」에 있으며, 0.1.6 이상 버전에서는 메인 화면 좌측 사이드바의 「플러그인」 패널(workbuddy-connect → 보기)로 이동했습니다; 「설정 → 모델」 페이지는 두 세대 모두 WorkBuddy 항목을 표시하지 않는 것이 의도된 설계입니다.

• 모델 가시성: 두 카드에 있는 「컨텍스트 창 (上下文窗口)」 탭에서 모델 선택기에 표시할 모델을 체크할 수 있습니다. 숨김 설정은 로그인 계정별로 저장됩니다: 계정을 전환하면 각자의 설정이 자동으로 전환되며, 다시 돌아오면 복구됩니다; 새 계정과 새로 출시된 모델은 기본적으로 표시됩니다. 숨기기는 선택기 내의 선택 가능성만 영향을 미치며, 사용 중인 해당 모델의 기존 세션에는 영향을 주지 않습니다.

동일한 인터페이스가 DSH 0.1.5의 설정 카드에서도 원형 그대로 적용됩니다:

• 기업 계정 포인트: 국내 버전 기업 계정(enterpriseId 비어있지 않음)은 기업 과금 인터페이스를 통해 주기적 한도를 읽으며, 카드는 「기업 할당량」과 주기 재설정 시간을 표시합니다.

• 요율 비율: 각 모델명 뒤에 포인트 배율이 직접 표시됩니다 (예: GLM-5.2 · x0.79, Hy3 · x0.00). /model 팝업 및 입력창의 모델 드롭다운에서 확인할 수 있습니다; 배율은 표시용일 뿐, 실제 요청에는 영향을 주지 않습니다.

• 배지 표시: 프로모션 배지(기간 한정 무료, 야간 할인)는 모델명 바로 뒤에 붙습니다 (예: Hy4 preview · x0.00 · 기간 한정 무료). 설정 카드는 현재 할인이 있는 모델을 취합하며, 데이터는 WorkBuddy 서버를 기준으로 하며 DSH 시작 시마다 동기화됩니다. 국제 버전의 프로모션은 서버 측 modelPromotions에서 가져옵니다 (유효 시간 포함). 만료되면 배지는 자동으로 제거되며; 서버가 할인된 가격을 모델의 배율 필드에 직접 기입하기 때문에 원가를 복원할 수 없어, 이때 해당 모델의 배율은 할인 가격이나 「무료」 대신 「가격 미상 — 새로고침 후 업데이트」로 표시됩니다.

카드를 펼치면 「상태 / 컨텍스트 / 상세 (状态 / 上下文 / 明细)」 세 개의 탭으로 나뉩니다. 상태 페이지는 계정, 토큰 만료일, 총 포인트, 모델 목록 출처 및 추론 단계 감지를 보여줍니다; 컨텍스트 페이지에는 각 모델의 컨텍스트 창이 나열되며, 국제 버전에서는 「상위에서 선언한 최대 컨텍스트 창 사용」을 여기서 끌 수 있습니다 (기본적으로 켜져 있으며, DSH는 상위 최대 창에 따라 컨텍스트 압축을 배치합니다; 끄면 상위 기본 창을 사용하며, 선호도가 영구 저장됩니다); 상세 페이지에는 각 패키지의 잔여량과 모델 할인이 표시됩니다. 국내 버전과 국제 버전 각각 별도의 카드를 가집니다.

추론 단계는 왜 이렇게 설계되었나요

WorkBuddy에서 모델의 추론 단계 정보는 현재 상위 인터페이스와 클라이언트 자체의 사적 UI 로직에 분산되어 있으며, 모델 디렉토리가 빠르게 변화합니다. 만약 플러그인이 경험을 바탕으로 모든 선언되지 않은 모델에 통일된 단계를 보완한다면, 공개되지 않았고 안정적인 계약이 없는 제품 로직을 지속적으로 따라잡아야 합니다.

실제 테스트 결과, 일부 모델은 reasoning_effort 매개변수를 받기는 하지만, 알 수 없는 값을 무시하고 기본 동작으로 되돌릴 수 있음을 발견했습니다; 한 번의 요청이 성공적으로 반환된다고 해서 특정 단계가 실제로 사용 가능한지 증명할 수는 없습니다.

따라서, 단계를 선언하지 않은 모델에 대해서는 Web과 Desktop에서 사용자가 능동적으로 권한을 부여하여 동적으로 단계를 획득하는 방식을 채택했습니다: 먼저 상위 인터페이스가 해당 매개변수를 검증하는지 확인하고, 그 다음 어떤 표준 단계가 수용되는지 항목별로 확인합니다. 감지는 소량의 요청을 보내어 포인트 소모가 발생할 수 있습니다; 결과는 단지 현재 상위 인터페이스가 해당 단계를 수용한다는 것을 의미하며, 이것이 반드시 추론 효과, 속도 또는 포인트 소모를 변경한다고 약속하지 않습니다.

명령줄 (CLI)

dsh plugin --profile <web|dsh-tui> exec dsh-workbuddy-connect status: 로그인 상태 및 잔여 포인트 확인 ( --json은 기계가 읽을 수 있는 형식으로 출력; 추가로 doctor 진단, logout 자격 증명 정리). desktop 프로파일은 일반적으로 데스크톱 앱이 관리하므로 CLI(및 exec)로는 사용할 수 없습니다 (설치 섹션의 Desktop 설명 참조).

기본적으로 국내 버전을 사용하며, --provider workbuddy-ai를 추가하면 국제 버전을 사용합니다.

dsh plugin --profile web exec dsh-workbuddy-connect status --provider workbuddy-ai
dsh plugin --profile web exec dsh-workbuddy-connect doctor --provider workbuddy-ai

logout은 해당 버전 플러그인이 저장한 자격 증명 복사본만 삭제하며, 데스크톱 App 자체의 로그인은 건드리지 않습니다. 또한 모델 그룹이 반드시 사라진다고 보장하지는 않습니다 (App의 자격 증명 파일이 남아있는 한 여전히 유효합니다).

알려진 제한 사항

• macOS의 DSH Web / Desktop / TUI 환경에서 검증을 통과했습니다 (0.3.2부터 0.1.5-rc.1 이상, Node 22+ 요구). TUI는 터미널 인터페이스 플러그인 0.10.0-beta.5 이상이 필요합니다 (설치 섹션 참조). Windows는 Local 및 Roaming AppData를 순차적으로 탐지하며; WSL은 마운트된 Windows 사용자 디렉토리에서 로그인 자격 증명을 우선 읽습니다. Windows와 Linux의 사용자 이름이 다르고 Windows 환경 변수가 WSL로 전달되지 않은 경우, WORKBUDDY_AUTH_FILE (국제 버전의 경우 WORKBUDDY_AI_AUTH_FILE)을 통해 실제 위치를 지정해야 합니다.
• 암호화된 데스크톱 자격 증명 복호화 프로그램 경로 지정: 복호화 프로그램은 macOS와 Windows에서 자동으로 탐지됩니다. Windows의 경우 국내 버전은 기본 경로 %LOCALAPPDATA% extbackslash Programs extbackslash WorkBuddy extbackslash WorkBuddy.exe를 먼저 확인하고, 다음으로 제거 레지스트리 기록을 확인합니다. 국제 버전은 검증된 기본 경로가 없어 레지스트리만 확인합니다. 자동 탐지가 실패할 경우, WORKBUDDY_ELECTRON_BIN (국내 버전) 또는 WORKBUDDY_AI_ELECTRON_BIN (국제 버전)을 사용하여 실행 파일을 명시적으로 지정할 수 있으며, 설정 후에는 DSH를 완전히 종료하고 재시작해야 적용됩니다. Linux는 자동으로 발견할 수 없으므로 명시적인 지정이 필요합니다. WSL 환경에서 Windows 측 복호화 프로그램을 호출할 때, 플러그인은 자식 프로세스 WSLENV 내의 ELECTRON_RUN_AS_NODE 항목을 단일 보안 플래그( /w 포워딩 포함, 경로 변환 없음, 나머지 항목은 원본 유지)로 표준화하며, 수동 설정이 필요 없습니다. 이 변경 사항은 오프라인 회귀 테스트를 통과했지만, 아직 WSL2 / Windows 실제 기기 검증은 완료되지 않았습니다.
• 국제 버전의 모델 디렉토리는 App 인터페이스에서 가져옴: 서버 측에서는 User-Agent에 따라 분배되어 하달되며, 이는 사설 구현입니다. 상위 변경 사항으로 인해 무효화될 수 있습니다. 그 경우 플러그인은 「본 계정 마지막 성공 디렉토리 → 내장 디렉토리」로 다운그레이드하며, 카드에 출처(실시간 / 저장됨 / 내장), 업데이트 시간 및 실패 원인을 표시하지만, 장기적인 호환성을 보장할 수는 없습니다. 국내 버전의 디렉토리는 공식 CLI와 동일한 인터페이스를 사용하므로 영향을 받지 않습니다.
• 국제 버전에서 아직 커버하지 못한 환경: Windows / WSL / Linux 환경에서 국제 버전 App의 버전 읽기는 아직 신뢰할 수 있는 출처를 찾지 못하여, 최근 저장된 버전 또는 내장 값을 반환합니다. macOS에서는 실제 shim을 통해 GPT 계열의 완전한 응답, 도구 호출 및 연속 라운드를 검증했습니다.
• 자격 증명이 없을 때의 동작 변화: 특정 버전 App이 로그인한 적이 없거나 플러그인이 저장한 복사본도 남기지 않은 경우, 해당 버전의 모델 그룹은 더 이상 표시되지 않습니다. 이전에는 국내 버전에서 내장된 안전망 목록을 보여주었으나, 이 모델들을 선택하면 필연적으로 오류가 발생했습니다.
• 기업 계정 포인트는 현재 국내 버전에만 적용: 국제 버전 기업 계정의 과금 인터페이스는 아직 검증되지 않았으며, 개인 버전 인터페이스를 계속 읽습니다. 실측 결론이 나오는 대로 확장할 예정입니다. 기업 계정 기능 분기는 본 기기에서 자체 테스트가 불가능합니다 (개발기는 개인 계정 사용). 공식 App의 인터페이스 계약에 따라 구현되었으니, 기업 계정 사용자분들의 실측 결과를 환영합니다.
• 설정 진입점은 DSH 버전에 따라 다름: 0.1.5 / 0.1.6에서는 플러그인이 authFile / authFileAI 등의 설정 영역을 정상적으로 설치합니다 (settings.yaml 및 TUI /settings 모두 읽기/쓰기 가능). 0.1.7+ / 0.2.0의 설정 서비스는 더 이상 해당 인터페이스를 제공하지 않아, 플러그인은 설정 항목이 없는 provider로 다운그레이드됩니다 — 모델, 선택기, 모델 표시 여부 및 컨텍스트 창은 정상 작동하지만, 「상위에서 선언한 최대 컨텍스트 창 사용」이라는 환경설정은 더 이상 영구 저장할 수 없습니다.
• WorkBuddy 클라이언트 인터페이스에 의존합니다 (공식 공개 API 아님). WorkBuddy가 업데이트되면 플러그인도 그에 맞춰 조정이 필요할 수 있습니다.

버전 호환성 및 이전 버전

플러그인 버전은 DSH 코어와 일치해야 하며, 불일치한 조합은 DSH 시작 실패를 초래합니다. 데스크톱 버전은 내장된 코어를 기준으로 플러그인 버전을 선택합니다. npm의 최신 버전이 반드시 적합한 것은 아니며, 실제 코어와의 매칭 관계를 따르는 것이 중요합니다:

• 0.7.8: DSH 0.2.1-rc.2에 적용; 공식 원자 쓰기 도구를 플러그인에 패키징하여 호스트가 모듈을 노출하는 것에 의존하지 않도록 함; 국내 모델 디렉토리 스냅샷 업데이트, Hy3 / Hy3-X 구분; 추론 감지 결과 표시 최적화, 포인트 새로고침 버튼 위치 조정 및 마우스 오버 팁 수정. @chenpiyanghappy의 PR #156에 감사드립니다.

• 0.7.7: DSH 0.2.1-rc.1 코어 적용: peer를 0.2.1-rc.1로 축소, 플러그인 자체의 @earendil-works/pi-ai가 코어 업그레이드에 따라 1.3.0으로 업데이트됨 (프로필 레벨에서 이월된 0.87.1 오버라이드는 반드시 제거해야 하며, 그렇지 않으면 플러그인이 로드되지 않습니다); 국제 버전과 국내 버전의 추론 등급 감지 시 '감지 미완료'에 머무는 문제 수정 — 상위 계층에서 등급 거부 코드를 invalid_parameter_value로 변경함 (#143 / #148, PR #145); 중국어 Windows 콘솔에서 레지스트리 키 누락 진단이 GBK 인코딩으로 오진되는 문제 수정 (zh-CN 실기 검증).

• 0.7.6: 기업 계정 모델 디렉토리에서 glm-5.3-flashx가 누락된 문제 수정 (#123), 국제 버전 대화 요청이 상위 채널 검증에 의해 차단되는 문제 수정 (#139 / #142).

• 0.7.5: 세션 전환 후 입력창 잔액 및 새로고침 버튼이 사라지는 문제 수정 (#125 / #132), WSL이 Windows 자격 증명 해독 프로그램을 호출할 때 환경 전달 문제 수정 (#133), README에 커뮤니티 프로젝트 추가 (#130).

• 0.7.4: Windows 진단 및 안정성 개선: 레지스트리 자식 프로세스 출력 초과 정확 분류, 크로스 플랫폼 테스트 가정 수정 (#62), 설치 설명 재배열.

• 0.7.3: Windows의 기본 경로가 아닌 위치에서 레지스트리 자동 발견 실패 문제 수정 (#105).

• 0.7.2: pi-ai를 플러그인 자체 종속성으로 변경하고 추론 필드 요청 거부 문제를 수정 (#92); 이 버전은 Windows 레지스트리 회귀가 있으므로 0.7.4 또는 그 이후의 정식 버전을 사용해 주세요.

• 0.7.1: pi-ai 종속성 범위를 축소.

• 0.7.0: DSH 0.2.0에 맞춰 설정 서비스 개조, 0.1.x는 더 이상 지원하지 않음.

• 0.6.5: 0.1.x 라인의 최종 버전입니다.

고정 버전 설치 예시: dsh plugin --profile web add [email protected].

pi-ai 버전은 커널 라인별로 구분되므로 혼용할 수 없습니다: 0.2.1-rc.1 / rc.2 커널 라인(각각 플러그인 0.7.7 / 0.7.8에 해당)이 @earendil-works/pi-ai 1.3.0으로 업그레이드되었습니다 (플러그인이 자체 제공). 프로필 레벨의 이력 잔여물 overrides: {'@earendil-works/pi-ai': '0.87.1'}은 반드시 제거해야 합니다. 그렇지 않으면 플러그인은 구형 pi-ai를 로드하여 시작에 실패합니다. 0.2.0-rc.2 커널 라인(플러그인 0.7.6)의 경우 여전히 ^0.87.1을 요구하므로, 이 라인에서는 프로필 레벨에서 pi-ai를 1.x로 업그레이드하지 마십시오. 서드파티 플러그인 관리자의 '업데이트 가능' 알림은 peer 제약을 검증하지 않으므로 따르지 마십시오 (#86).

면책 조항 (Disclaimer)

• 본 프로젝트는 개인 학습 및 연구 목적으로만 제공되며, 오직 사용자가 자신의 WorkBuddy 계정을 로컬에서 호출하는 용도로만 사용해야 합니다. 상업적 용도나 개인의 합리적인 사용 범위를 벗어나는 시나리오에는 사용하지 마십시오.
• 사용자는 WorkBuddy의 서비스 약관을 준수해야 합니다. 본 프로젝트 사용으로 인해 발생하는 모든 결과(계정 제한, 크레딧 소진, 서비스 중단 등을 포함하되 이에 국한되지 않음)는 사용자 본인이 부담합니다.
• 본 프로젝트 작성자는 이 프로젝트의 사용 또는 오용으로 인해 발생하는 어떠한 직접적 또는 간접적 손실에 대해서도 책임을 지지 않습니다.
• 본 프로젝트는 Tencent, WorkBuddy, DeepSeek과 아무런 관련이 없으며, 그들의 승인이나 인가를 받지 않았습니다. 본문에 언급된 명칭은 호환 관계를 설명하는 데 사용될 뿐이며, 상표권은 각 주체에 귀속됩니다.

관련 프로젝트 / 커뮤니티 생태계 (Related Projects / Community Ecosystem)

• HanaAgent: 독립적인 개인 AI Agent 프로젝트입니다.
• hana-workbuddy-connect: 커뮤니티에서 유지 관리하는 비공식 어댑터 프로젝트로, dsh-workbuddy-connect의 일부 구현을 재사용하여 HanaAgent가 WorkBuddy / WorkBuddy AI 모델에 연결되도록 합니다.

위 프로젝트들은 모두 서드파티가 독립적으로 유지 관리합니다. 그중에서도 hana-workbuddy-connect의 호환성, 보안 및 사용 지원은 해당 유지 관리자가 책임집니다. 수록된 것이 공식적인 보증을 의미하지 않으며, 본 플러그인이 내부 인터페이스에 대한 안정성이나 호환성을 약속한다는 의미도 아닙니다.

감사의 말 (Acknowledgements)

• Sliverkiss/workbuddy2api (MIT) — WorkBuddy 상위 프로토콜의 참조 구현체입니다.
• franksong2702/dsh-codex-connect (Apache-2.0) — DSH 플러그인 구조 및 provider 등록의 참조 자료입니다.

라이선스 (License)

MIT