dsh-locale-ko

DeepSeek Harness(dsh)의 웹 화면과 데스크톱 앱을 한국어로 바꾸는 언어팩(language pack) 플러그인입니다. 설치하면 설정의 언어 목록에 '한국어'가 추가됩니다. 메뉴와 버튼, 안내 문구, 오류 메시지가 한국어로 표시됩니다.

웹 화면은 dsh 0.2.1-alpha.2, 데스크톱 앱은 dsh 0.2.0-rc.2에서 확인했습니다.

설치

웹 화면(dsh web)과 데스크톱 앱(DeepSeek Harness.app)은 같은 화면을 쓰므로 언어팩도 똑같이 적용됩니다. 쓰는 쪽에 맞춰 설치하세요.

웹 화면(dsh web)

npx @deepseek-ai/dsh plugin --profile web add dsh-locale-ko

설치한 다음 npx @deepseek-ai/dsh web으로 웹 화면을 다시 시작합니다.

데스크톱 앱

언어팩을 설치하기 전에는 화면이 영어이므로 괄호 안의 영어 이름을 찾으면 됩니다.

왼쪽 사이드바에서 플러그인(Plugins)을 엽니다.
플러그인 추가(Add plugin)를 누릅니다.
플러그인 추가(Add plugin) 창의 입력 칸(흐린 글씨로 for example dsh-plugin-whale-pet이 보이는 칸)에 패키지 이름 dsh-locale-ko만 입력하고 설치(Install)를 누릅니다. dsh plugin ...으로 시작하는 명령 전체를 붙여 넣으면 "not a package name" 오류가 납니다.
화면에서 설치한 플러그인은 꺼진 상태로 설치됩니다. 설치가 끝나면 지금 사용(Enable now)을 눌러 켭니다. 다시 시작하라는 안내가 나오면 앱을 다시 시작합니다.

명령줄로 설치할 수도 있습니다. 이때는 앱에 들어 있는 dsh 명령을 씁니다.

앱 메뉴 **DeepSeek Harness > Manage dsh Command…**에서 dsh 명령을 등록합니다.
앱을 완전히 종료합니다.
새 터미널 창에서 다음 명령을 실행합니다.
```
dsh plugin --profile desktop add dsh-locale-ko
```
앱을 다시 엽니다.

언어 선택

시스템이나 브라우저 언어가 한국어라면 따로 고르지 않아도 한국어로 바뀝니다. 데스크톱 앱은 macOS 언어를 따르고 웹 화면은 처음 열 때 브라우저 언어를 따릅니다.

자동으로 바뀌지 않았다면 설정 > 일반 > 언어(Settings > General > Language)에서 한국어를 고르세요. 그 전까지는 화면이 영어로 나옵니다.

다른 플러그인 번역

dsh에 들어 있는 실험 기능(에이전트 팀, 음성 입력, 추론 번역, 세션 로그, NodeJS 검사기)과 아래 플러그인의 화면도 한국어로 나옵니다. 해당 플러그인을 설치했을 때만 적용되며, 따로 설정할 것은 없습니다. 나중에 플러그인이 자체 한국어를 제공하면 언어팩 번역 대신 플러그인의 한국어가 나옵니다. 괄호 안은 번역한 버전입니다.

dshmarket (1.66.8)
@linxin666/dsh-client-ui-git-graph (0.4.5)
@linxin666/dsh-client-ui-skill-explorer (0.4.5)
@linxin666/dsh-client-ui-task-board (0.4.5)
@linxin666/dsh-remote-web-ui (0.4.5)
@linxin666/dsh-ssh (0.4.5)
@michengai/dsh-archive-manager (1.0.11)
@michengai/dsh-codex-ui (1.1.33): 이 플러그인은 dsh 0.2.0-rc.2에서 쓸 수 있고 0.2.1-alpha.2는 지원하지 않습니다.
@michengai/dsh-skills-manager (1.1.9)
@nanmicoder/dsh-agent-teams (0.1.22)
@xmanrui/dsh-im (4.35.1)
dsh-codex-subscription (2.5.2)
dsh-context (0.66.1)
dsh-mnemon (0.5.24)
dsh-pet (0.3.5)
dsh-plugin-model-proxy (0.1.6)
dsh-univer-office (0.3.6)

플러그인을 업데이트하거나 껐다 켠 뒤 화면 일부가 영어로 나오거나 동작하지 않으면 페이지를 새로 고쳐 주세요.

번역되지 않는 부분

dsh 새 버전에서 추가된 문구는 번역하기 전까지 영어로 나옵니다. 위 플러그인의 새 버전에서 추가된 문구도 언어팩이 업데이트될 때까지 영어로 나옵니다.
위 목록에 없는 플러그인 중에는 화면 문구를 dsh의 언어 기능 없이 코드에 직접 넣은 것이 있습니다. 이런 플러그인(dsh-better-sidebar, dsh-cost-meter, dsh-mcp-connector, dsh-free-search 등)은 언어팩으로 번역할 수 없습니다.
플러그인 화면에 나오는 플러그인 이름과 설명은 공식 플러그인을 포함해 모두 영어로 나옵니다. dsh가 이 내용을 각 플러그인의 파일에서 읽어 오고, 다른 플러그인이 대신 넣을 방법을 제공하지 않기 때문입니다.
데스크톱 앱의 macOS 메뉴 막대, 시작 창, 업데이트 대화 상자는 앱이 영어와 중국어만 지원해서 언어팩으로 바뀌지 않습니다.

번역 오류 제보

어색하거나 틀린 번역을 발견하면 GitHub 이슈에 알려 주세요. 화면 위치와 원래 영어 문구를 함께 적어 주시면 고치기 쉽습니다. 용어는 GLOSSARY.md를 기준으로 맞춥니다.

개발

Node.js 24를 사용합니다. npm ci로 개발 도구를 설치한 뒤 npm run check로 포맷, lint와 JavaScript 구문을 검사합니다. npm test는 번역 사전과 플레이스홀더를 확인합니다.

타입 오류를 예외 처리할 때는 @ts-expect-error: <이유>만 허용합니다. lint 예외는 biome-ignore lint/<그룹>/<규칙>: <이유>처럼 한 규칙에 한정해야 합니다. 파일 전체나 규칙 그룹을 끄는 주석은 거부합니다. 번역 사전의 ${...}는 원문 토큰이므로 일반 문자열 안에 그대로 둡니다. source/의 추출 결과와 npm이 생성한 lockfile은 포맷 검사에서 제외합니다.

번역할 원문은 dsh 소스에서 뽑아 source/en.json에 저장합니다. 영어 원문이 기준이고 source/zh.json은 참고용입니다. 태그를 모두 받은 dsh 저장소 clone을 준비하고 아래 명령을 실행합니다.

node scripts/extract.mjs <dsh-checkout> dsh-v0.2.0-rc.2 dsh-v0.2.1-alpha.2

태그를 여러 개 주면 결과를 하나로 합칩니다. 같은 키는 뒤에 적은 태그의 문구를 쓰고 앞 태그에만 있는 키도 그대로 남깁니다. 그래서 데스크톱 앱에 들어 있는 dsh 0.2.0-rc.2와 npm의 dsh 0.2.1-alpha.2를 한 언어팩으로 함께 번역할 수 있습니다. 태그별 소스는 .cache/<태그>에 풀어 두고 다음 실행에서 다시 씁니다.

PR과 main push에서 같은 검사와 테스트 명령을 실행합니다. 요약 검사 CI passed는 두 job이 모두 성공해야 통과합니다. 실패, 취소와 건너뛰기는 모두 실패로 처리합니다.

dsh-locale-ko

Install

Source

Tags

Readme

dsh-locale-ko

설치

웹 화면(dsh web)

데스크톱 앱

언어 선택

다른 플러그인 번역

번역되지 않는 부분

번역 오류 제보

개발

라이선스