dream-num/univer-workspace

Univer Workspace – AI 강화 오피스 제품군

소개 – Univer Office SDK를 기반으로 구축된 오픈 소스 셀프 호스팅 오피스 환경입니다. 기존 생산성 도구(시트, 문서, 슬라이드, 관계형 테이블, 보드 등)와 대화형 인터페이스를 통해 문서를 읽고, 편집하고, 검토할 수 있는 AI 에이전트 기능을 결합했습니다.

주요 구성 요소

구성 요소	역할
Workspace Browser	사용자가 Office 형식 파일을 생성, 편집 및 공동 작업하기 위한 웹 UI.
Workspace Server	문서, 권한, 바이너리 데이터를 저장하고 OpenAPI 계약을 실행하는 중앙 서비스.
Workspace Agent	DeepSeek Harness 기반의 로컬 데스크톱 앱. AI 에이전트가 파일에 대해 대화하고, 격리된 Worktree에서 초안을 편집하며, 사람이 검토할 수 있도록 변경 사항을 제시합니다.
Workspace CLI	에이전트나 스크립트가 호출하여 Office 콘텐츠를 프로그래밍 방식으로 로드, 검사, 수정, 검증 및 렌더링하는 명령줄 도구.

작동 방식 – 서버는 모든 데이터의 단일 진실 공급원(Single Source of Truth)입니다. 사용자는 브라우저를 통해 상호 작용하고, 에이전트는 CLI나 에이전트 앱을 통해 상호 작용합니다. 에이전트는 Worktree(격리된 초안) 내에서 편집합니다. 초안이 준비되면 사용자가 브라우저나 에이전트 UI에서 변경 사항을 검토하고 병합하거나 폐기하여 메인 워크스페이스를 깔끔하게 유지합니다.

주요 사용 사례

• 인간 중심의 공동 작업 – 팀이 시트, 문서, 슬라이드, 보드를 공동 편집하며, 세밀한 ACL, 휴지통/최근 항목 보기, 파일 가져오기/내보내기를 지원합니다.
• AI 기반 자동화 – 에이전트가 시트 기반 미니 앱(대시보드, 보고서) 생성, PDF/PNG 렌더링, 레이아웃 검사 수행, 승인 전 다단계 편집 등을 수행할 수 있습니다.
• 자동화 및 스크립팅 – CLI를 통해 기존 LLM(Claude, Codex, Kimi 등)이 Workspace CLI Skill을 호출하여 재현 가능하고 버전 관리되는 방식으로 Office 파일을 조작할 수 있습니다.
• 셀프 호스팅 배포 – 운영자는 단일 브라우저 + 서버 인스턴스를 실행하고, 사용자 지정 인증(비밀번호, GitHub, Discord, OAuth)을 통합하여 제품, 공동 작업 및 바이너리 스토리지를 직접 제어할 수 있습니다.

빠른 시작 (README 참조)

# 사전 요구 사항
node >=24, pnpm 11

# 의존성 설치
pnpm install
cp apps/workspace/.env.example apps/workspace/.env

# 서버 실행
pnpm workspace:dev:server

# 다른 터미널에서 웹 UI 실행
pnpm workspace:dev:web

# 브라우저에서 http://127.0.0.1:5173 접속

서버는 http://127.0.0.1:3020/openapi.yaml에서 OpenAPI 사양도 제공합니다.

AI 에이전트 추가 – apps/agent/README.md에 따라 데스크톱 에이전트를 설치하고, OAuth 콜백을 구성하며, 모델 자격 증명을 제공합니다. 에이전트는 동일한 서버와 통신하여 Worktrees를 생성하고 채팅 창 옆에 문서 미리보기를 표시합니다.

CLI 사용법 – 전역 패키지(npm i -g univer-workspace-cli) 설치 후, 대상 워크스페이스 오리진을 구성하고 univer-workspace-cli login을 실행(OAuth 흐름 따름)한 다음, LLM 기반 에이전트에서 명령이나 제공된 Skill을 호출합니다.

아키텍처 하이라이트

• 권한 서버 – 모든 ID, ACL, 수정 버전 및 바이너리 데이터는 중앙에 저장되며, 클라이언트는 권한의 원천으로 신뢰되지 않습니다.
• 분리된 스토리지 도메인 – 제품 데이터, 공동 작업 상태 및 원시 바이너리 데이터는 독립적으로 관리되지만 멱등성 작업을 통해 조정됩니다.
• 계약 우선 HTTP – OpenAPI 정의가 서버, 브라우저 및 CLI용 타입을 생성하여 단일 진실 공급원을 보장합니다.
• Worktree 워크플로우 – 격리된 초안 편집 → Ready → 사람 검토 → Merge/Reopen → 트렁크.
• 모듈식 패키지 – 핵심 클라이언트, HTML 뷰어, 마크다운 뷰어, 참조 제공자 및 DSH 플러그인은 비공개 패키지로 유지되며, 리포지토리는 이를 구성하기만 합니다.

라이선스 – Apache-2.0 (LICENSE 참조).

---

위의 모든 정보는 리포지토리의 README에서 직접 가져온 것이며, 추가 기능은 추론되지 않았습니다.