Web UI의 Settings → Models 에서 DeepSeek 카드에 API key(https://platform.deepseek.com/ 에서 발급)를 입력하고 저장. 공식 원문: "The model route becomes usable immediately without restarting the server"(저장 즉시 적용, 재시작 불필요)
api · key_storage
providers.md 원문: "Keys are write-only. The page receives a redacted descriptor after saving, never the literal secret. The key is stored in `$DSH_HOME/.credentials.yaml`". 모델 정의는 $DSH_HOME/settings.yaml 에 저장
api · catalog_providers
Anthropic
api · catalog_providers
OpenAI
api · catalog_providers
Bedrock
api · catalog_providers
Vertex
api · catalog_providers
Azure
api · catalog_providers
Codex
api · catalog_config
Add provider → 제공사 선택 → API key 입력 → 저장. Bedrock/Vertex/Azure/Codex는 각각 AWS 자격 증명+region, ADC project, api-version, OAuth를 사용
Add a custom provider: Provider ID(소문자, 변경 불가), 표시 이름, base URL, API 프로토콜, 자격 증명, 모델 최소 1개를 입력. Fetch available models 로 OpenAI 호환 GET /models 를 호출해 모델 목록을 자동으로 가져올 수 있고, 지원하지 않는 엔드포인트는 모델명을 직접 입력
local · ollama
ollama launch dsh 명령 하나로 완전히 로컬에서 실행되고 Ollama web search 플러그인이 기본 설치됨(Ollama 공식 설명 기준)
① Settings → Models 에서 DeepSeek API key 입력 → ② Choose workspace 로 작업 디렉터리 선택(공식 원문: "The session composer remains unavailable until a workspace is selected") → ③ 세션을 열고 작업 요청
dsh --profile headless "job" — 공식 설명: "Run one fresh persisted session, print the final answer, and exit"
terminal · profile
dsh --profile <name> — "Boot the named profile under $DSH_HOME/profiles/<name>". web과 headless 두 profile은 첫 사용 시 템플릿에서 자동 초기화되고, 나머지 profile은 dsh plugin 을 통해 만들어야 함
README, apps/cli/README.md, docs 사용자 가이드 어디에도 업그레이드/제거 명령이 없음(하나씩 대조한 결과 ABSENT). 커뮤니티 토론에는 npx 캐시를 지우는 방법(rm -rf ~/.npm/_npx, #49/#897 참고)이 있으나 이는 문제 해결 수단이지 공식 업그레이드 절차는 아님
추천 많은 해법: ① pacman -Syu base-devel 로 컴파일 도구 설치. ② Bun으로 전환: bun add --global @deepseek-ai/dsh(node-pty가 Bun 화이트리스트에 있음). ③ npm을 고수하려면 캐시를 지운 뒤 빌드 스크립트를 허용: rm -rf ~/.npm/_npx && npx --allow-scripts=node-pty @deepseek-ai/dsh@0.1.0-rc.6 web. 다른 방법: npm config set allow-scripts=@deepseek-ai/dsh-subprocess-local,koffi,node-pty,@google/genai,protobufjs --location=user
근본 원인: node-pty v1.1.0에 Linux x64(Node 24/ABI 137)용 사전 빌드 산출물이 없어 npm 설치 스크립트가 조용히 실패. 수동 우회: node-pty 디렉터리로 들어가 npx node-gyp rebuild 를 실행해 누락된 pty.node 생성. 해당 게시물에 공식 답변 없음(답글 0)
