# DeepSeek Harness 플러그인

> DeepSeek Harness 대화에서 Office 결과물을 만들고 실시간 미리 보기를 보며 검사·검토·전달합니다.

- Human documentation: [https://docs.univer.ai/ko-KR/overview/examples/deepseek-harness](https://docs.univer.ai/ko-KR/overview/examples/deepseek-harness)

- Agent Markdown: [https://docs.univer.ai/ko-KR/overview/examples/deepseek-harness.md](https://docs.univer.ai/ko-KR/overview/examples/deepseek-harness.md)

- Requested language: `ko-KR`

- Content language: `ko-KR`

- Documentation version: `1.3.0`

- Source: [examples/deepseek-harness.ko-KR.mdx](https://github.com/dream-num/documentation/blob/dev/content/docs/examples/deepseek-harness.ko-KR.mdx)

---

**Univer Office for DeepSeek Harness**(`dsh-univer-office`)는 **[Univer Office SDK](https://docs.univer.ai/ko-KR/overview.md)**로 만든 DSH 플러그인입니다. 자연어로 원하는 결과를 설명하면 에이전트가 표, 문서, 프레젠테이션, 관계형 테이블, 캔버스를 만들거나 수정하고 대화에 시각적 결과를 남깁니다.

[설치 및 연결](#quick-start) · [작업 체험](#first-task) · [Skills와 도구](#skills)

## 설치 및 연결

DeepSeek Harness, 설정된 모델, Node.js 22.19 이상을 준비하세요. 설치 전에 저장소의 [호환성 요구 사항](https://github.com/dream-num/dsh-univer-office#requirements-and-current-limits)에서 검증된 DSH 버전을 확인하세요.

### 플러그인 설치

DSH가 실행 중이면 시작한 터미널에서 Ctrl+C로 종료한 뒤 Web 프로필에 설치합니다.

```bash
dsh plugin --profile web add dsh-univer-office
```

DSH를 다시 시작합니다.

```bash
dsh web
```

시작 후 DSH 브라우저 페이지를 새로고침하고 접근 가능한 프로젝트 폴더에서 새 대화를 시작하세요. 플러그인에 실행 환경, 도구, Skills가 포함되어 별도 Univer CLI 설치가 필요 없습니다. 스크린샷과 레이아웃 검증에는 로컬 Chrome, Chromium 또는 Edge가 필요합니다.

## 바로 체험할 수 있는 작업

```text
Univer Office로 새 팀원을 위한 Project Northstar 영어 소개 슬라이드 3장을 만들어 주세요. 1장은 표지와 한 문장 목표, 2장은 예시 마일스톤 3개, 3장은 다음 행동 3개입니다. 파란색과 녹색의 통일된 색상, 명확한 제목, 편집 가능한 텍스트를 사용하세요.
독립 초안에서 작업하고 각 페이지의 넘침, 겹침, 표시 상태를 검사한 뒤 이 대화에 실시간 미리 보기와 검토 카드를 표시하세요. 승인 전에는 병합하지 말고 PowerPoint는 요청할 때 내보내세요.
```

### 확인할 수 있는 결과

작업 중에는 플로팅 창에서 슬라이드 변화를 보고, 완료 후에도 대화에 검토 카드가 남습니다. 편집 가능한 슬라이드 3장이 생성됩니다. ‘2장을 타임라인으로 바꿔 주세요’처럼 수정한 뒤 초안을 승인하거나 폐기할 수 있습니다.

## Skills와 도구의 연동

DSH는 플러그인에 포함된 [공통 및 제품 Skills](https://github.com/dream-num/dsh-univer-office/tree/main/skills)를 작업에 맞게 불러옵니다. 에이전트는 `univer_api`로 해당 Facade API를 검색하고 `univer_execute`로 편집한 후 데이터 읽기, 스크린샷, `univer_lint`로 검증합니다. Office SDK가 계산, 렌더링, 버전을 제공하고 플러그인은 플로팅 미리 보기와 대화 내 검토 카드를 제공합니다.

## 무엇을 만들 수 있나요

- **만들어지는 과정을 확인:** 작업 중인 실시간 미리 보기 창을 이동·크기 조절·접기·최대화할 수 있습니다.
- **대화에서 검토:** 파일별 미리 보기 카드를 나중에 다시 열고 수정을 이어가거나 초안을 승인·폐기합니다.
- **실제 Office 파일 전달:** 기존 Excel, Word, PowerPoint를 처리하고 수식, 차트, 풍부한 레이아웃을 만든 뒤 해당 형식으로 내보냅니다.
- **에이전트가 결과 검사:** 모델 다시 읽기, 스크린샷, 슬라이드 레이아웃 검사를 조합합니다. 여러 콘텐츠를 같은 파일에 담고 수식과 임베드로 연결합니다.

## Office SDK가 담당하는 부분

DSH는 대화, 세션, 도구 호출을 담당합니다. 플러그인은 Office SDK의 콘텐츠 조작, 계산, 렌더링, Worktree를 여기에 연결합니다. 에이전트는 실제 모델을 편집하고 SDK는 미리 보기와 검토를 지원하며, 플러그인은 떠 있는 창, 대화 카드, 세션 상태를 구현합니다.

## 체험과 소스 코드

[데모 보기](https://www.youtube.com/watch?v=k-2zW_CMiew) · [빠른 시작](https://github.com/dream-num/dsh-univer-office#get-started-in-3-minutes) · [소스 저장소](https://github.com/dream-num/dsh-univer-office)

## 관련 기능 살펴보기

- [문서 로드와 콘텐츠 작업](https://docs.univer.ai/ko-KR/ai/content-operations.md)
- [Worktree](https://docs.univer.ai/ko-KR/overview/features/shared/worktree.md)
- [스크린샷과 시각 검증](https://docs.univer.ai/ko-KR/overview/features/shared/visual-inspection.md)

[모든 예제](https://docs.univer.ai/ko-KR/overview/examples.md)