헤드리스 및 서버 계산
Node.js 콘텐츠 작업과 Rust 사전 계산을 결합하여 Agent에 구조화 결과와 시각 정보를 제공합니다.
Headless Univer는 대화 형 편집기 UI없이 Univer 콘텐츠 실행 시간입니다. 브라우저 편집기와 콘텐츠 모델, 명령, 계산 및 Facade API를 공유합니다. 응용 프로그램은 Node.js에서 콘텐츠를 처리하거나 UI가 필요하지 않은 작업을위한 브라우저에서 실행할 수 있습니다. 그것의 기능은 등록 된 제품 및 기능 플러그인에 달려 있습니다.
JavaScript/TypeScript 런타임이 페이지에 설명되어 있으며 univer-rs는 별도의 구현입니다. univer-rs은 서버 측 계산 및 파일 변환을 지원하며, 같은 스냅샷을 통해 헤드리스 워크플로에 참여합니다.
Headless로 할 수 있는 작업
- 내용을 읽고 수정하고 구조. Univer 스냅 샷을 생성하거나로드하고, Facade API를 사용하여 세포, 단락, 페이지, 그래픽 개체 또는 레코드를 읽고 편집하고, 업데이트 스냅 샷을 저장합니다. 이 작업 지원 일괄 처리, 데이터 생성, 콘텐츠 검사 및 에이전트 자동화.
- 등록된 사업 논리를 실행하십시오. 공식 계산, 분류, 필터링, 유효성 검사 및 피벗 플러그인은 이미지, 차트, 모양 및 의견과 같은 리소스를 수정할 수 있습니다. 유효한 가동은 등록한 제품 및 특징 플러그인 및 그들의 의존성에 달려 있습니다.
- 다른 서비스에 연결. Node.js 협업 클라이언트를 추가하여 협업 단위를로드하고 변경 사항을 제출하고 동기화를 기다리십시오. 런타임으로 Server SDK 변환 모듈을 결합하여 Office 파일을 가져 오기 및 내보내기합니다.
Headless는 편집기 UI를 제공하지 않습니다 : 메뉴, 도구 모음, 대화 상자, 마우스 또는 키보드 상호 작용, 스크린 샷, 또는 인쇄. Persistence, 인증, 협업 서버 및 파일 변환은 포함되지 않습니다. save()는 Univer 스냅 샷을 반환합니다. 데이터베이스 또는 XLSX, DOCX 또는 PDF를 내보내지 않습니다. 스크린 샷 및 시각적 레이아웃 체크는 여전히 브라우저를 실행하기 때문에 별도의 렌더링 런타임가 필요합니다.
Headless에 속하는 패키지
애플리케이션이 필요한 컨텐츠 패키지를 선택하면 필요한 제품 플러그인과 의존성을 등록하십시오. Pro 기능은 또한 구성할 수 있는 라이센스가 필요합니다.
콘텐츠 모델
이 패키지는 인스턴스, 콘텐츠 모델, 명령 및 기본 콘텐츠 작업을 제공합니다.
@univerjs/core@univerjs/sheets@univerjs/docs
수식과 숫자 형식
이 패키지는 공식 실행, 시트 공식 통합 및 번호 형식을 제공합니다. 필요한 기능에 따라 오픈 소스 또는 프로 엔진을 선택하십시오.
@univerjs/engine-formula@univerjs/sheets-formula@univerjs/sheets-numfmt@univerjs-pro/engine-formula
시트 데이터와 규칙
시트 데이터 및 규칙 작업은 일반적으로 그들을 동반 한 패널 또는 시각적 상호 작용없이 실행됩니다. 데이터 유효성도 @univerjs/data-validation가 필요합니다.
@univerjs/sheets-filter@univerjs/sheets-sort@univerjs/sheets-conditional-formatting@univerjs/sheets-data-validation@univerjs/sheets-table@univerjs/sheets-hyper-link@univerjs/sheets-note
이미지, 링크, 댓글
이 패키지는 이미지, 링크 및 의견에 대한 모델, 리소스 및 명령을 추가합니다. 디스플레이, 업로드 및 외부 데이터 소스는 필요에 따라 별도로 연결됩니다.
@univerjs/drawing@univerjs/sheets-drawing@univerjs/docs-drawing@univerjs/docs-hyper-link@univerjs/thread-comment@univerjs/sheets-thread-comment@univerjs/docs-thread-comment
고급 시트 기능
피봇, 차트, 모양, 스파클 라인, 개요 및 슬라이서는 자신의 내용과 계산 논리를 제공합니다. 그래픽 의존성은 @univerjs-pro/engine-chart 및 @univerjs-pro/engine-shape를 포함 할 수 있습니다.
@univerjs-pro/sheets-pivot@univerjs-pro/sheets-chart@univerjs-pro/sheets-shape@univerjs-pro/sheets-sparkline@univerjs-pro/sheets-outline@univerjs-pro/sheets-slicer
문서 확장 기능
문서 블록, 테이블, 열, 수식 및 모양 지원 콘텐츠 작업은 아니지만 편집기 컨트롤이 아닙니다.
@univerjs-pro/docs-callout@univerjs-pro/docs-code@univerjs-pro/docs-list@univerjs-pro/docs-quote@univerjs-pro/docs-table@univerjs-pro/docs-column@univerjs-pro/docs-latex@univerjs-pro/docs-formula@univerjs-pro/docs-shape
다른 제품 모델
이 패키지는 다른 제품에 대한 모델과 명령을 제공합니다. pdfs-editor는 PDF 편집기 수명주기와 협업 통합을 구성합니다. 패키지 이름의 단어 편집기는 UI가 아닙니다. 사용 가능한 API는 제품별로 다릅니다.
@univerjs-pro/slides@univerjs-pro/bases@univerjs-pro/boards@univerjs-pro/pdfs@univerjs-pro/pdfs-editor
네트워크, 계산 프로세스, 협업
필요한 경우 인프라를 추가하십시오. @univerjs/network 및 @univerjs/rpc-node는 네트워킹과 Node.js 계산 프로세스를 제공하고 @univerjs-pro/license은 라이센스 통합을 처리합니다. @univerjs-pro/collaboration, @univerjs-pro/collaboration-client와 @univerjs-pro/collaboration-client-node를 사용하면 공동 작업 서버가 아닌 헤드리스 협업 클라이언트를 형성합니다. 로컬 스냅 샷과 함께 작업하면 협업 서비스가 필요하지 않습니다.
콘텐츠 전용 런타임에 포함하지 않는 패키지
@univerjs/ui,@univerjs/design및*-ui패키지는@univerjs/sheets-ui와 같은 제품 또는 기능에 대한 ZXQXZ 포장,@univerjs/docs-ui과@univerjs-pro/slides-ui는 UI, 렌더링 통합 또는 상호 작용을 제공합니다. Node.js 구성에 추가하지 마십시오.@univerjs/sheets-find-replace와@univerjs/sheets-crosshair-highlight에는-ui스프릭스가 없지만@univerjs/sheets-ui에 여전히 의존하므로 패키지 이름은 혼자서 헤드리스 플러그인이 없다는 사실이 아닙니다.- 기본
@univerjs/preset-sheets-core및@univerjs/preset-docs-core사전 설정은 UI 플러그인을 등록하고 Node.js 헤드리스 프리셋이 아닙니다. 그 경우 플러그인 모드를 사용하여 콘텐츠 레이어 의존성을 선택하십시오.
@univerjs/engine-render는 별도의 고려사항을 요구합니다. 현재 Node.js 예제는 렌더링 관리와 같은 공유 의존도를 공급하기 위해 등록합니다. 플러그인을 등록하지 않거나 캔버스를 만들거나 편집기를 마운트하지 않습니다. 그것은 헤드리스 구성에 나타날 수 있지만, 그림, 글꼴 측정 및 스크린 샷 API는 여전히 적절한 렌더링 환경을 필요로합니다. 따라서 패키지의 모든 API가 순수 Node.js에서 사용할 수 없습니다.
Facade는 환경 어댑터가 아닌 운영 API입니다. 사용의 각 콘텐츠 플러그인에 대한, /facade 확장을 가져, 필요한 기능을 구현하는 플러그인을 등록. @univerjs/ui/facade 및 @univerjs/sheets-ui/facade와 같은 UI 확장은 여전히 UI가 필요하므로 메뉴, 스크롤 및 시각적 선택 상호 작용을 제공합니다. 플러그인 의존성을 시험하고 패키지 이름 또는 Facade API의 존재에 의존하는 실제 통화 경로.
Runnable 플러그인 구성은 시트 헤드리스 가이드와 Docs 헤드리스 가이드에서 나타납니다.
프런트엔드의 즉시 계산과 서버의 버전별 계산
공식 엔진은 프론트엔드와 서버 모두에서 실행됩니다. 프론트엔드는 사용자의 편집으로 응답하며 서버는 스냅샷을 생성하거나 파일을 처리할 때 캡처된 콘텐츠 개정을 계산합니다.
- 편집 중, 브라우저는 로컬로 영향을받는 공식을 계산하고, 선택적으로 노동자에서, 그리고 결과를 즉시 표시합니다. 협업 서비스는 이러한 콘텐츠 변경을 기록하고 그들을 동기화합니다.
- 스냅샷이 생성될 때 서버의 스냅샷 정책은 저장 워크플로우를 시작합니다. 서버는 해당 작업에 대한 내용 개정을 캡처하고
univer-rs로 계산하고, 해당 개정의 내용과 결과를 저장합니다. - 문서가 다시 열릴 때, 프론트엔드는 스냅샷에서 유효 결과를 재사용하고, 이후 변경을 적용하고, 전체 재순환을 피하는 계산을 계속합니다.
콘텐츠는 지속적으로 동기화됩니다. 서버 계산은 스냅 샷 세대의 일부로 실행되며 그 내용 개정에 대한 결과가 저장됩니다.
첫 번째 부하에서, 응용 프로그램은 초기 계산이 저장된 결과를 사용하는 방법을 구성:
WHEN_EMPTY: 저장된 수식 값을 재사용하고 누락된 결과만 계산합니다.NO_CALCULATION: 초기 수식 계산을 건너뛰고 애플리케이션이 결과를 제공합니다.FORCED: 저장된 결과를 갱신해야 할 때 모든 수식을 다시 계산합니다.
이 옵션은 초기 로딩만 합니다. 로딩 후, 편집은 프론트엔드에서 계산하고, 서버는 버전 스냅샷이나 프로세스 파일을 생성할 때 수요에 계산합니다. 공식 구성, 의논하기 및 파일 변환를 참조하십시오.
수식 엔진 성능
Univer 녹 공식 엔진 벤치 마크 덮개 10 워크북은 Rust 입력 로딩, 단계 타이밍, 입력 형식 경계 및 워크북 다운로드를 포함합니다.
배열 수식 계산과 확장
지원되는 기능 및 체재 안에, Rust는 Excel의 배열 형태 그리고 유출 semantics를 따릅니다. 그것은 닻과 유출 범위와 함께 산출한 가치를 돌려보내고, 그것은 동적인 배열과 유산 배열 공식의 선언한 범위를 취급합니다.
예를 들어 빈 A1에 =SEQUENCE(3,2)를 입력하면 다음 결과가 나옵니다.
| A | B |
|---|---|
| 1 | 2 |
| 3 | 4 |
| 5 | 6 |
수식은 A1에 남아 있으며, 결과는 occupy A1:B3입니다. 배열 수축이 될 때, 이전 유출 값이 명확합니다. 유출이 차단되면 결과는 #SPILL!이다. 브라우저, 에이전트 및 수출 파이프라인은 모든 계산 된 스냅 샷을 재사용 할 수 있습니다.
해당 기능 및 범위 규칙은 공식 지원 및 Excel 어레이 동작에 있습니다.
Agent 실행 및 검증 연결
기존 모델, 대화 및 툴 오케스트라를 유지하십시오. AI SDK 도구는 해당 에이전트에 사무실 내용 작업을 노출시킵니다.
- 구조를 검사하고 표적 내용을 읽으십시오.
- Facade 변경을 적용하고 헤드리스 런타임에 필요한 계산을 실행합니다.
- 계산을 기다리고, 확인 될 커밋, 그런 다음 업데이트 된 상태를 다시 읽습니다.
- 값과 구조를 확인하고 스크린 샷 또는 레이아웃 체크를 추가하면 시각적 검증이 필요합니다.
콘텐츠 운영 및 시각 검사를 함께 사용하십시오. 사람이 Worktree에서 편집을 먼저 검토해야 할 때 비교하고 합병합니다. Univer 클립는 에이전트가 구동 할 수있는 응용 프로그램에 이러한 기능을 조립하는 방법을 보여줍니다.
연동 방법
| 기능 | 가능한 작업 |
|---|---|
| Node.js 콘텐츠 런타임 | headless Univer로 시작하고 필요한 제품 및 계산 플러그인을 활성화합니다. |
| 백그라운드 파일 처리 | Rust 계산과 Node.js 파일 변환을 결합하고 Snapshot을 저장하거나 반환합니다. |
| 공유 편집과 Agent | 의논하기 및 AI SDK를 연결하여 확인된 내용에 대한 직원과 에이전트 작업을 연결합니다. |
이 가이드는 어떠셨나요?