notatestuser/ds4-control

DS4 Control – DeepSeek V4 모델용 macOS 메뉴바 UI (ds4 서버를 통해)

무엇인가요 – DeepSeek V4 (Pro 및 Flash 버전)을 제공하는 로컬 ds4‑server 프로세스를 실행, 모니터링, 상호작용할 수 있는 네이티브 Swift 메뉴바 앱입니다. 이 앱은 추론을 직접 수행하지 않습니다. 외부 서버를 관리하고, 모델 파일을 다운로드하며, 채팅 또는 코딩 에이전트를 빠르게 시작할 수 있는 단축키를 제공합니다.

왜 중요한가요 – Mac에서 100GB 이상의 LLM을 실행하려면 RAM, GPU 연결 메모리 제한, 프로세스 감시를 신중하게 다뤄야 합니다. DS4 Control은 이러한 작업을 자동화하고 실시간 리소스 사용량을 표시하며, 마シン의 Metal 연결 메모리 예산을 초과하는 모델을 시작하는 것을 방지합니다.

핵심 기능

기능	제공되는 기능
서버 라이프사이클	`ds4‑server` 바이너리 시작/정지, stderr에서 `listening on http://…` 라인 감시, `/v1/models`의 상태 확인을 주기적으로 확인하고, 안전하게 종료합니다.
모델 선택기	V4 Pro (0813) 또는 V4 Flash (0731) 를 선택할 수 있습니다. UI는 RAM과 Metal 연결 제한을 확인하고, 수용할 수 없는 옵션은 비활성화합니다.
내장 다운로더	GGUF 모델 파일의 병렬, 재시도 가능한 다운로드와 실시간 진행률 표시기. 외부 도구 필요 없음.
리소스 위젯	메뉴바 팝업에 통합 메모리, GPU, CPU, 전력/ANE 사용량을 나타내는 미니 게이지로, 2초마다 업데이트됩니다.
원클릭 에이전트	실행 중인 모델과 통신하는 채팅 창, Claude Code, Pi(로컬 "에이전트 기반 코딩" 도구)를 시작하는 버튼.
1M 토큰 컨텍스트	최대 100만 토큰까지 설정 가능 (Pro의 기본값; 작은 RAM에서는 Flash용으로 낮은 기본값).
시작 시 통합	macOS 부팅 시 서버를 자동으로 시작할 수 있는 옵션.
안전성 게이트	필요한 Metal 연결 메모리가 초과될 경우, 정확한 `sysctl iogpu.wired_limit_mb=…` 명령어와 도움말 대화상자를 표시합니다.

누구에게 적합한가요

Mac‑silicon 고성능 사용자 – 96 GiB 이상의 RAM을 보유하고 DeepSeek V4를 로컬에서 실행하고 싶은 사용자.
개발자 – 명령줄 스크립트를 다루지 않고도 코딩 지원용 로컬 LLM(Claude Code, Pi)을 빠르게 구동하고 싶은 사용자.
연구자 – 다양한 추론 노력 수준(Standard, Instant, Max Think)을 실험하고 실시간 시스템 영향을 확인하고 싶은 사용자.

설치 (빠른 방법)

brew install --cask ds4-control   # Homebrew Cask가 서명된 .dmg 제공

또는 GitHub 릴리스 페이지에서 최신 서명된 .dmg를 다운로드하거나, Homebrew Cask URL을 통해 설치할 수 있습니다.

소스에서 빌드하기 (기여자용)

상류 ds4 서버를 포함하는 서브모듈 가져오기:
```
git submodule update --init --recursive
```

서버 패치 및 컴파일 (THINK_MAX 기능을 위해 필요):

bash scripts/apply-ds4-patches.sh
make -C external/ds4 -j ds4-server

빌드된 서버와 함께 앱 실행:
```
DS4_DIR="$PWD/external/ds4" swift run
```

배포 가능한 번들 생성:

bash build.sh   # Apple 개발 인증서로 서명하거나, 아드혹 방식으로 대체

내부 동작 방식

SupervisorService – Swift Process 래퍼로, ds4‑server를 시작하고 준비 상태 라인을 분석하며, 상태 엔드포인트를 주기적으로 확인하고, 안전하게 종료합니다.
MetricsManager – Mach, IOKit, 그리고 사적인 IOReport API를 통해 2초마다 CPU, 메모리, GPU, 전력 사용량을 샘플링하여 UI 위젯에 전달합니다.
Feasibility – 선택된 모델이 RAM과 Metal 연결 메모리 제한에 맞는지 계산하고, 안전한 기본 컨텍스트 크기를 도출하며, 필요 시 사용자에게 필요한 sysctl 명령어를 제시합니다.
모든 중량 로직(적합성 계산, 재시도 가능한 청크 다운로더, 상태 머신)은 순수 Swift로 구현되었으며, 단위 테스트로 커버됩니다.

라이선스

MIT – 리포지토리의 LICENSE 파일 참조.

결론 – DS4 Control은 DeepSeek V4를 로컬에서 실행하기 위해 필요한 수동 설정을 제거하고, 모델 시작, 시스템 건강 모니터링, 채팅 또는 코딩 에이전트 실행을 단일 클릭으로 가능하게 하는 정교하고 서명된 macOS 유틸리티입니다.