애플리케이션 아키텍처

Univer Office SDK는 임베디드 편집기와 헤드리스¹ 콘텐츠 처리를 제공하는 Web SDK, 협업과 파일 가져오기·내보내기를 제공하는 Server SDK, 에이전트 워크플로를 제공하는 AI SDK로 구성됩니다.

Univer는 사람과 AI Agent가 같은 Office 콘텐츠를 조작하는 애플리케이션을 만드는 도구 집합입니다. 사람을 위한 Web, AI Agent를 위한 CLI, 둘이 공유하는 Server를 제공하거나 필요한 부분만 사용할 수 있습니다.

SDK 구성

문서는 Web SDK, Server SDK, AI SDK로 나뉘며 편집기, 공동 편집·파일 교환 서비스, AI Agent 콘텐츠 작업을 다룹니다.

AI SDK는 Web SDK의 헤드리스 콘텐츠 기능을 재사용합니다. 이 구성 요소는 주요 개발 진입점과 실행 위치를 나타내며, 독립된 세 기술 스택이나 애플리케이션 코드 없이 배포할 수 있는 완성 제품이 아닙니다.

파일 가져오기·내보내기 통합

Server SDK의 @univerjs-pro/exchange-node는 Office 파일과 Univer 문서 데이터를 변환합니다. 애플리케이션이 변환 모듈을 통합하고 업로드, 변환, 다운로드 API를 제공합니다. Web SDK는 브라우저 상호작용을 담당하고 CLI는 Node.js에서 모듈을 호출할 수 있습니다. 브라우저 설정은 각 제품의 Web SDK 문서에 있습니다.

• 공동 편집 없이: 파일을 문서 스냅샷으로 변환해 브라우저에서 열고 편집합니다. 내보낼 때 최신 스냅샷을 변환 모듈에 전달합니다. 서버 변환은 필요하지만 공동 편집 서비스는 필요하지 않습니다.
• 공동 편집 사용: 가져온 데이터를 공동 편집 문서로 저장합니다. Web과 AI SDK가 문서 ID로 같은 내용을 조작합니다. 내보내기 전에 변경을 동기화하고 최신 데이터를 읽어 변환합니다.

변환만 필요하면 로컬 Node.js 프로세스나 원격 서비스에서 Exchange를 사용할 수 있으며 AI SDK나 공동 편집은 필요하지 않습니다. 흐름은 파일 교환 통합, 모듈 사용은 Office 파일 가져오기 및 내보내기를 참고하세요.

배포 형태

한 장치 또는 클라이언트와 클라우드에 나눠 실행할 수 있습니다. 위치가 역할을 바꾸지는 않습니다. Server가 있다면 Web과 CLI는 이를 통해 공유 콘텐츠와 제품 기능에 접근합니다.

시작점 선택

어떤 경로를 선택할지 모르겠다면 시작하기를 먼저 읽으세요.

Footnotes

1. Headless는 대화형 편집기 UI를 마운트하지 않고 문서 내용을 조작한다는 뜻입니다. 협업, 영구 저장, 파일 변환 서비스가 포함된다는 의미는 아닙니다. ↩