DeepSeek Harness를 위한 표시 계층 번역.
사고를 읽고, 작업을 따라가고, 답변을 이해하세요. 원문은 보존되며 번역문은 모델 컨텍스트에 들어가지 않습니다.
中文 · English · 日本語 · 한국어 · Español · Français · Deutsch · Русский · Português
· 
· 
· 
· 
---
## 생각이 펼쳐지는 순간
|
|
| 데모 1 · 사고 과정과 답변 번역 |
데모 2 · 더 많은 실제 조작 |
## 공식 번역 플러그인과 비교
이 플러그인과 공식 사고 번역 중 하나만 활성화하세요. 둘 다 사고 화면을 담당합니다.
## 명령 하나로 시작
```bash
dsh plugin --profile web add dsh-think-translate
```
설치 후 DSH Web을 완전히 다시 시작하세요. **설정 → 사고 체인 번역**에서 대상 언어와 제공자를 선택합니다. **사이드바에 번역 항목 표시**를 켜면 번역 설정을 다른 전역 패널 옆에 고정할 수 있습니다. 전용 페이지는 번역 환경설정·서비스·동작 상태를 카드로 묶고, 좁은 창에서는 단일 열 레이아웃으로 전환됩니다. 설정 대화상자는 동일한 항목을 담은 간결한 단일 열 섹션을 사용합니다. 선택은 이 브라우저에 저장되어 페이지를 새로 고치거나 DSH를 다시 시작해도 유지되며, 설정 대화상자나 번역 페이지에서 끄면 고정이 해제됩니다.
GitHub 설치, 업데이트 및 기타 방법
GitHub에서 설치:
```bash
dsh plugin --profile web add github:UncleK/dsh-think-translate
```
npm 버전 업데이트:
```bash
dsh plugin --profile web add dsh-think-translate@latest
```
설치나 업데이트 후 DSH를 완전히 다시 시작하세요. 수동 배포는 패키지를 profile에 연결하고 `cordis.patch.yml`에 등록합니다. 일반적으로 위 명령을 권장합니다.
## 이해해야 할 것은 사고 과정만이 아닙니다
사고를 실시간으로 읽기
전체 사전 번역, 이전 기록 지연 로딩, 펼칠 때만 번역
|
작업과 답변 함께 보기
사고 과정, 작업 카드, 입력 영역 작업 목록. 답변 본문과 자동 검토 거부 사유는 선택 번역
|
검토 사유 이해하기
자동 검토가 도구 호출을 거부하면 원문 옆에 사유 번역을 표시합니다. 기존 결정 버튼은 계속 사용할 수 있습니다.
|
원문과 코드 보존
원문 보존. 번역문은 모델 컨텍스트에 들어가지 않음. Markdown 구성 요소 재사용. 번역 전에 코드, 경로, 명령 보호.
|
필요할 때 로컬 모델 로드
수동 해제, 체크 해제 시 해제, 유휴 후 자동 해제. 다음 번역 시 다시 로드
|
원하는 순서로 제공자 사용
활성화된 순서로 자동 대체. 명백히 잘못된 언어이면 다음 제공자 시도. 대기 후 재시도
|
### 이미 사용하는 제공자 연결
**Ollama · Google · Bing · OpenAI · Anthropic Messages API**
DSH에 설정된 제공자를 검색하므로 엔드포인트와 키를 다시 입력할 필요가 없습니다. 각 행을 개별 테스트하고 목록 순서대로 시도합니다.
```text
첫 번째 제공자 → 다음 활성 제공자 → … → 모두 실패하면 원문 유지
```
사용자 지정 엔드포인트, 인증 및 복구
- OpenAI 호환 `/v1/chat/completions`와 기본 Anthropic Messages API를 지원합니다.
- 현재 DSH profile 및 덮어쓰기 설정에서 제공자를 검색하고 번역 체인에 추가할 수 있습니다.
- `apiKeyEnv`는 요청 시 해석하며 해석한 키를 플러그인 설정에 다시 쓰지 않습니다.
- 실패는 Host 메모리에서 30초간 대기 후 다음 번역 요청에서 재시도합니다. 명백한 언어 오류는 다음 제공자로 넘어갑니다.
- 이미 대상 언어로 인식되는 본문은 건너뜁니다. 제공자 테스트는 실제 요청을 보냅니다.
### 용어집: 일관된 번역
기본 용어와 사용자 용어는 각 영역의 체크박스로 독립적으로 즉시 적용됩니다. 꺼도 내용은 유지됩니다. 기본 목록은 처음에는 꺼져 있으며 영어 AI·프로그래밍 용어와 제품명 60개를 9개 언어로 제공합니다. 활성 사용자 용어가 우선하고 128개 추가 한도는 별도입니다. 저장하지 않은 수정과 다른 언어 초안을 알려 줍니다. 넓은 화면은 좌우 배치와 가로 상태, 좁은 화면과 설정창은 세로 배치입니다.
설정과 사이드바 번역 페이지에서 대상 언어별 용어집을 편집할 수 있습니다. 한 줄에 원문 => 번역을 입력하고 저장하세요. 양쪽을 같게 입력하면 제품명을 유지합니다.
```text
DeepSeek => DeepSeek
agent => 에이전트
reasoning => 추론
```
영어는 대소문자 구분 없이 단어 전체를 일치시키며 긴 용어를 우선합니다. 코드, 경로, 명령은 유지됩니다. 언어별 최대 128개이며 저장 시 이전 번역 캐시가 무효화됩니다. 비활성화해도 용어는 보존됩니다. 실제 번역 본문에만 적용하며 원문을 수정하지 않습니다.
### 로컬 번역 모델: 필요할 때 로드하고 해제
| 사용자 조작 | 플러그인 동작 |
|---|---|
| 번역 또는 테스트 | 필요할 때 서비스를 시작하고 선택한 모델 로드 |
| 모델 메모리 해제 | 진행 중인 번역 후 해제. 파일, 스위치, 순서 유지 |
| 로컬 제공자 체크 해제 | 비활성화하고 선택한 모델 해제 |
| 다시 활성화하거나 설정 열기 | 미리 로드하지 않고 다음 실제 번역 시 로드 |
| 유휴 해제 설정 | 기본 5분. 1 / 5 / 10 / 30 / 60분 또는 끄기 |
시간은 다음 사용부터 적용됩니다. Ollama가 선택한 모델의 유휴 시간을 관리하며 전역 환경 변수는 바꾸지 않습니다. 소프트웨어나 모델이 없으면 준비 버튼을 눌러야 설치·다운로드하며 진행률을 표시합니다.
### 언어 설정도 함께
中文 · English · 日本語 · 한국어 · Español · Français · Deutsch · Русский · Português
번역 대상, 설정 화면, 작업 문구를 포르투갈어 포함 9개 언어로 제공합니다. 새로고침 후에도 선택이 유지됩니다.
## 자주 묻는 질문
설치·업데이트 후 번역 설정이 보이지 않음
`dsh web`을 완전히 다시 시작하세요. 클라이언트 모듈 구성은 프로세스 시작 시 만들어져 새로고침만으로는 부족할 수 있습니다. 설정 하단에 설치된 패키지 버전이 표시됩니다.
로컬 모델 목록이 비어 있음
`ollama list` 또는 `/api/tags`, 실제 모델 경로 및 서비스의 `OLLAMA_MODELS`를 확인하세요. 기존 파일은 다시 다운로드하지 않아도 됩니다.
DSH 업데이트 후 client bundles not found 오류
DeepSeek Harness 저장소에서 `pnpm run build`를 실행한 뒤 DSH Web을 다시 시작하세요.
번역 실패가 대화에 영향을 주나요?
모든 활성 제공자가 실패해도 원문을 유지합니다. 설정에서 개별 제공자를 테스트하고 최근 오류를 확인하세요. 대기 시간이 지나면 다음 번역 요청이 재시도할 수 있습니다.
최근 변경 및 호환성
**1.2.20** 클릭 한 번으로 켜는 기술 용어집을 추가합니다. 60개 용어와 제품명을 9개 언어로 제공하며 사용자 용어가 우선합니다. 추가 한도는 별도이고 미리 보거나 꺼도 사용자 용어는 유지됩니다.
**1.2.19**: 언어별 용어집, DSH 자격 증명 저장소, 설정별 캐시, 공식 플러그인과의 상호 배제, 기술 텍스트 보호 강화 및 Windows/Linux CI를 추가했습니다.
**1.2.18**: 번역 컨트롤을 위한 상시 사이드바 항목을 추가했습니다(설정 대화상자나 번역 페이지에서 전환, 브라우저별 저장). 번역 페이지와 설정 대화상자를 카드형 섹션으로 개편하고 좁은 창에서는 반응형 단일 열 레이아웃으로 전환됩니다.
**1.2.17**: 로드된 Ollama 모델에도 저장한 유휴 시간을 적용하고, 로컬 추론을 최대 120초 기다리며 남은 시간을 표시합니다. issue #17의 재현 가능한 문제를 수정했으며 장시간 메모리 증가는 조사 중입니다.
**1.2.16**: 포르투갈어 번역 대상과 UI 추가. 9개 언어 README와 비교 이미지 갱신, 마켓 이미지 3장 선언.
**1.2.15**: 로컬 모델 메모리 관리 추가. DSH `0.2.2-alpha.2`의 이미지 표시, 사고 묶음 접기, 원문 선택에 대응.
이전 버전: [GitHub Releases](https://github.com/UncleK/dsh-think-translate/releases).
개발 및 동작 원리
- `lib/index.js`: Host 라우트, 제공자, 설정, 메모리 캐시와 로컬 모델 관리.
- `lib/client.js`: 설정, 표시 계층 번역, 스트리밍 분할 및 브라우저 캐시.
- `lib/config.json`: 실행 설정. Git 및 npm에서 제외합니다.
- 추가 빌드 없이 소스가 결과물입니다. Host 수정 후 DSH를 다시 시작합니다.
- 검사: `npm test`. 검색 및 인증 처리는 [유지보수 노트](https://github.com/UncleK/dsh-think-translate/blob/main/docs/maintenance-notes.md)를 참고하세요.
---
dsh-think-translate
문제 제보 · 릴리스 · MIT License