Skip to content

Build your own AI office with Univer Office SDK. Bring editing, calculation, collaboration, and file processing into your product for people and AI agents. Built on an extensible open-source core.

docs(readme): refresh multilingual documentation and product visuals (#8082)

Univer161a67cee230
diff --git a/README.md b/README.md
index 2fa62b51c5..ea0b74e1ed 100644
--- a/README.md
+++ b/README.md
@@ -1,156 +1,296 @@
-<div align="center">
+<a id="readme-top"></a>
-<img src="./docs/img/banner.png" alt="Univer SDK" width="800" />
+<p align="center"><img src="./docs/img/readme/hero-banner.png" alt="Univer Office SDK" width="960" /></p>
-**The Office Harness for AI Agents**
+<h1 align="center">Build your own AI office with Univer Office SDK.</h1>
-Spreadsheets · Documents · Presentations · Bases · Boards · PDFs
+<p align="center">Start with open-source Sheets and Docs, then connect your own application or agent.</p>
-High-performance, fully customizable Office SDK
+<p align="center"><a href="#quick-start">🚀 Quick start</a> · <a href="https://docs.univer.ai/">📚 Documentation</a> · <a href="https://univer.ai/compare/">⚖️ Feature comparison</a> · <a href="https://univer.ai/">🌐 Website</a> · <a href="https://docs.univer.ai/showcase">🎮 Showcase</a> · <a href="https://docs.univer.ai/reference/classes/univer">🔧 API Reference</a> · <a href="https://docs.univer.ai/blog">📝 Blog</a></p>
-Build embeddable productivity experiences with a plugin architecture, Canvas-based rendering,
-a formula engine, and one Facade API that works in the browser and on Node.js.
+<p align="center"><strong>English</strong> · <a href="./docs/readme/fr-FR.md">Français</a> · <a href="./docs/readme/de-DE.md">Deutsch</a> · <a href="./docs/readme/es-ES.md">Español</a> · <a href="./docs/readme/zh-CN.md">简体中文</a> · <a href="./docs/readme/zh-TW.md">繁體中文</a> · <a href="./docs/readme/ja-JP.md">日本語</a> · <a href="./docs/readme/ko-KR.md">한국어</a></p>
-English | [简体中文](./docs/readme/zh-CN.md) | [繁體中文](./docs/readme/zh-TW.md) | [日本語](./docs/readme/ja-JP.md) | [한국어](./docs/readme/ko-KR.md) | [Español](./docs/readme/es-ES.md)
+<p align="center">
+ <a href="https://github.com/dream-num/univer/releases"><img src="https://img.shields.io/github/v/release/dream-num/univer?style=flat&amp;labelColor=30363D&amp;color=4F46E5&amp;logo=github&amp;logoColor=white" alt="Release" /></a>
+ <a href="./LICENSE"><img src="https://img.shields.io/github/license/dream-num/univer?style=flat&amp;labelColor=30363D&amp;color=0F766E" alt="License" /></a>
+ <a href="https://github.com/dream-num/univer/actions/workflows/build-packages.yml"><img src="https://img.shields.io/github/actions/workflow/status/dream-num/univer/build-packages.yml?style=flat&amp;labelColor=30363D" alt="Build" /></a>
+ <a href="https://www.codefactor.io/repository/github/dream-num/univer/overview/dev"><img src="https://www.codefactor.io/repository/github/dream-num/univer/badge/dev?style=flat" alt="CodeFactor" /></a>
+ <a href="https://codecov.io/gh/dream-num/univer"><img src="https://img.shields.io/codecov/c/gh/dream-num/univer?token=aPfyW2pIMN&amp;style=flat&amp;labelColor=30363D" alt="Codecov" /></a>
+</p>
-[🌐 Website](https://univer.ai/) | [📖 Documentation](https://docs.univer.ai) | [✨ Showcase](https://docs.univer.ai/showcase) | [📘 API Reference](https://docs.univer.ai/reference/classes/univer) | [📝 Blog](https://docs.univer.ai/blog)
+<p align="center">
+ <a href="https://github.com/dream-num/univer"><img src="https://img.shields.io/github/stars/dream-num/univer?style=flat&amp;labelColor=30363D&amp;color=4F46E5" alt="Stars" /></a>
+ <a href="https://github.com/dream-num/univer/graphs/contributors"><img src="https://img.shields.io/github/contributors/dream-num/univer?style=flat&amp;labelColor=30363D&amp;color=4F46E5" alt="Contributors" /></a>
+ <a href="https://github.com/dream-num/univer/issues"><img src="https://img.shields.io/github/issues/dream-num/univer?style=flat&amp;labelColor=30363D&amp;color=4F46E5" alt="Issues" /></a>
+ <a href="https://github.com/dream-num/univer/commits/dev/"><img src="https://img.shields.io/github/last-commit/dream-num/univer?style=flat&amp;labelColor=30363D&amp;color=4F46E5" alt="Last Commit" /></a>
+</p>
-[![Release](https://img.shields.io/github/v/release/dream-num/univer?style=flat-square)](https://github.com/dream-num/univer/releases)
-[![License](https://img.shields.io/github/license/dream-num/univer?style=flat-square)](./LICENSE)
-[![Build](https://img.shields.io/github/actions/workflow/status/dream-num/univer/build-packages.yml?style=flat-square)](https://github.com/dream-num/univer/actions/workflows/build-packages.yml)
-[![CodeFactor](https://www.codefactor.io/repository/github/dream-num/univer/badge/dev?style=flat-square)](https://www.codefactor.io/repository/github/dream-num/univer/overview/dev)
-[![Codecov](https://img.shields.io/codecov/c/gh/dream-num/univer?token=aPfyW2pIMN&style=flat-square)](https://codecov.io/gh/dream-num/univer)
+<p align="center">
+ <a href="https://discord.gg/z3NKNT6D2f"><img src="https://img.shields.io/discord/1136129819961217077?logo=discord&amp;logoColor=FFFFFF&amp;label=discord&amp;color=5865F2&amp;style=flat&amp;labelColor=30363D" alt="Discord" /></a>
+ <a href="https://twitter.com/univerhq"><img src="https://img.shields.io/badge/%40univerhq-18181B?style=flat&amp;logo=x&amp;logoColor=white" alt="X: @univerhq" /></a>
+ <a href="https://opencollective.com/univer"><img src="https://img.shields.io/opencollective/all/univer?logo=opencollective&amp;style=flat&amp;labelColor=30363D&amp;color=0F766E&amp;label=supporters&amp;logoColor=white" alt="Open Collective" /></a>
+</p>
-[![Stars](https://img.shields.io/github/stars/dream-num/univer?style=flat-square)](https://github.com/dream-num/univer/stargazers)
-[![Contributors](https://img.shields.io/github/contributors/dream-num/univer?style=flat-square)](https://github.com/dream-num/univer/graphs/contributors)
-[![Issues](https://img.shields.io/github/issues/dream-num/univer?style=flat-square)](https://github.com/dream-num/univer/issues)
-[![Last Commit](https://img.shields.io/github/last-commit/dream-num/univer?style=flat-square)](https://github.com/dream-num/univer/commits/dev/)
+<p align="center">
+ <a href="https://trendshift.io/repositories/4376"><img src="https://trendshift.io/api/badge/repositories/4376" alt="Trendshift" /></a>
+</p>
-[![Discord](https://img.shields.io/discord/1136129819961217077?logo=discord&logoColor=FFFFFF&label=discord&color=5865F2&style=flat-square)](https://discord.gg/z3NKNT6D2f)
-[![Twitter](https://img.shields.io/twitter/follow/univerhq?style=flat-square&logo=x)](https://twitter.com/univerhq)
-[![Open Collective](https://img.shields.io/opencollective/all/univer?logo=opencollective&style=flat-square)](https://opencollective.com/univer)
+<details>
+<summary>Table of contents</summary>
+
+- [💡 What is Univer?](#what-is-univer)
+ - [Open-source capabilities](#open-source-capabilities)
+- [🚀 Build on the open-source foundation](#what-you-can-build)
+ - [Quick start: an open-source spreadsheet editor](#quick-start)
+ - [Connect your application to editable content](#connect-your-application-to-editable-content)
+- [🏗️ Explore the open-source architecture](#open-source-architecture)
+ - [Give custom features clear boundaries](#give-custom-features-clear-boundaries)
+ - [Compose cross-feature edits and undo/redo](#compose-cross-feature-edits-and-undoredo)
+ - [Connect applications and agents through Facade APIs and events](#connect-applications-and-agents-through-facade-apis-and-events)
+- [🧩 Extend your application with Univer Office SDK](#open-source-and-commercial-extensions)
+ - [Scope and licensing](#scope-and-licensing)
+- [🌐 Application patterns and ecosystem](#application-patterns-and-ecosystem)
+ - [Univer Workspace: an Office SDK reference application](#univer-workspace-an-office-sdk-reference-application)
+ - [CLI, agent integrations, and developer skills](#cli-agent-integrations-and-developer-skills)
+- [📚 Documentation and contributing](#documentation-and-contributing)
+ - [Runtime compatibility](#runtime-compatibility)
+- [💬 Community](#community)
+- [🔒 Security](#security)
+- [❤️ Sponsors](#sponsors)
+- [📄 License](#license)
+
+</details>
+
+<a id="what-is-univer"></a>
+
+## 💡 What is Univer?
+
+<p align="center"><img src="./docs/img/readme/intro-banner.png" alt="Univer Office SDK: Web, Server, and AI SDKs" width="960" /></p>
+
+**Univer** is an Office SDK for building Office applications inside your own product. It provides Office editing, calculation, collaboration, and file processing for people and existing agents, using your data and permissions. The product family covers spreadsheets, documents, presentations, relational tables, canvases, and PDFs.
+
+Univer Office SDK has three parts:
+
+- **Web SDK** is the foundation: content models, editing, rendering, formula calculation, and Facade APIs (application-facing APIs). Compose its plugins into an embedded editor or your own Office application, and reuse the content models, commands, and calculation for Headless processing without an interactive editor.
+- **Server SDK** adds backend services for real-time collaboration, edit history, and Office file import and export.
+- **AI SDK** connects Office capabilities to existing agents and workflows, with content tools, execution, and review integrations.
+
+**This repository provides the Web SDK's core architecture and engine implementations under Apache-2.0**: content models and snapshot formats, plugin and dependency management, the command system, formula and rendering engines, Facade APIs, UI foundation, and Sheets and Docs editing capabilities. Commercial Web SDK plugins, Server SDK, and commercial AI SDK extensions are distributed and licensed separately.
+
+Agents can use the same open-source APIs; your application supplies the model and tool orchestration. The [quotation example](#connect-your-application-to-editable-content) demonstrates editing, calculation, and saving without an AI SDK dependency.
+
+<a id="open-source-capabilities"></a>
+
+### Open-source capabilities
-[![Trendshift](https://trendshift.io/api/badge/repositories/4376)](https://trendshift.io/repositories/4376)
+<div align="center" style="overflow-x: auto;">
+
+<table align="center" style="display: table; width: auto; margin-left: auto; margin-right: auto;">
+<thead>
+<tr>
+<th>Area</th>
+<th>Selected capabilities</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td><strong>Sheets · Editing and layout</strong></td>
+<td>Cell styles, merged cells, in-cell rich text, freeze panes, floating images, and undo/redo.</td>
+</tr>
+<tr>
+<td><strong>Sheets · Data and calculation</strong></td>
+<td>Formulas, defined names, filtering, sorting, data validation, conditional formatting, hyperlinks, comments, and find and replace.</td>
+</tr>
+<tr>
+<td><strong>Docs</strong></td>
+<td>Rich-text editing, paragraph formatting, lists, hyperlinks, comments, and drawing integration.</td>
+</tr>
+</tbody>
+</table>
</div>
-## ✨ What is Univer?
+Features are composed through plugins and presets; the [quick start](#quick-start) uses only the **Sheets Core preset**. Images use the corresponding drawing plugins. See the [feature comparison](https://univer.ai/compare/) for detailed open-source and commercial coverage.
+
+The demos below showcase the wider **Univer Office SDK**, including commercial capabilities. They show more than the default open-source setup; see [open source and commercial extensions](#open-source-and-commercial-extensions) for scope.
+
+<div align="center" style="overflow-x: auto;">
+
+<table align="center" style="display: table; width: auto; margin-left: auto; margin-right: auto;">
+<tbody>
+<tr>
+ <td width="50%"><a href="https://univer.ai/demo/spreadsheets"><img src="./docs/img/readme/cards/sheets.webp" alt="Sheets — Editing and layout · Data and calculation — Open demo" width="420" /></a></td>
+ <td width="50%"><a href="https://univer.ai/demo/docs"><img src="./docs/img/readme/cards/docs.webp" alt="Docs — Rich-text editing — Open demo" width="420" /></a></td>
+</tr>
+<tr>
+ <td width="50%"><a href="https://univer.ai/demo/web-app"><img src="./docs/img/readme/cards/web-app.webp" alt="Web App — Sheet-powered apps — Open demo" width="420" /></a></td>
+ <td width="50%"><a href="https://univer.ai/demo/universe"><img src="./docs/img/readme/cards/universe.webp" alt="Univer — Composed Office content — Open demo" width="420" /></a></td>
+</tr>
+<tr>
+ <td width="50%"><a href="https://univer.ai/demo/slides"><img src="./docs/img/readme/cards/slides.webp" alt="Slides — Open demo" width="420" /></a></td>
+ <td width="50%"><a href="https://univer.ai/demo/relational-tables"><img src="./docs/img/readme/cards/relational-tables.webp" alt="Relational Tables — Open demo" width="420" /></a></td>
+</tr>
+<tr>
+ <td width="50%"><a href="https://univer.ai/demo/canvases"><img src="./docs/img/readme/cards/canvases.webp" alt="Canvases — Open demo" width="420" /></a></td>
+ <td width="50%"><a href="https://univer.ai/demo/pdf"><img src="./docs/img/readme/cards/pdf.webp" alt="PDF — Open demo" width="420" /></a></td>
+</tr>
+</tbody>
+</table>
-Univer is an open-source SDK for creating office applications inside your own product. It gives you the building blocks for spreadsheet, document, and presentation experiences without forcing you into a hosted app or a fixed UI.
+</div>
-Use Univer when you need to:
+<p align="right"><a href="#readme-top"><img src="https://img.shields.io/badge/%E2%86%91%20Back%20to%20top-30363D?style=flat-square" alt="Back to top" height="20" /></a></p>
+
+<a id="what-you-can-build"></a>
+
+## 🚀 Build on the open-source foundation
+
+<p align="center"><img src="./docs/img/readme/build-banner.png" alt="Build on open source" width="960" /></p>
+
+<div align="center" style="overflow-x: auto;">
+
+<table align="center" style="display: table; width: auto; margin-left: auto; margin-right: auto;">
+<thead>
+<tr>
+<th>Your goal</th>
+<th>Use the open-source foundation</th>
+<th>Start here</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td><strong>Embed Sheets or Docs</strong></td>
+<td>Add an editable Office surface to your application or agent product, and connect your data through Facade APIs.</td>
+<td><a href="#quick-start">Quick start</a></td>
+</tr>
+<tr>
+<td><strong>Process content without an editor</strong></td>
+<td>Reuse content plugins, models, commands, and calculation in Node.js for editing, snapshots, and automated tasks.</td>
+<td><a href="https://docs.univer.ai/guides/sheets/getting-started/node">Headless guide</a></td>
+</tr>
+<tr>
+<td><strong>Develop custom features or editors</strong></td>
+<td>Reuse the engines, UI components, plugin boundaries, dependency injection, and command/undo systems. Follow existing features to extend Sheets and Docs or develop your own editors.</td>
+<td><a href="#open-source-architecture">Open-source architecture</a></td>
+</tr>
+</tbody>
+</table>
-- Embed spreadsheet or document editing into a SaaS product, internal tool, BI workflow, or AI application.
-- Run workbook/document processing on the server with the same architecture used in the browser.
-- Compose only the features you need through plugins or start quickly with presets.
-- Extend behavior through custom plugins, commands, services, UI components, and Facade APIs.
+</div>
-Univer is not a spreadsheet file viewer only. It is a framework for building your own productivity surface.
+**Coordinate edits and undo/redo across features.** Inserting a row inside a filter range changes both the base content and the filter range; undo needs to restore both. Each feature supplies its own changes and undo data, and the command composes their execution and history. The architecture walkthrough explains how to extend these editing workflows.
-Across the [Univer product family](https://univer.ai/), Office tools share a runtime for storage and computation. Content can be composed and embedded across tools, with linked data and references updating together. People and AI agents can work in the same files. See the [capability matrix](https://univer.ai/capabilities) for product coverage and [Open Source and Pro](#-open-source-and-pro) for this repository's scope.
+<a id="quick-start"></a>
-### Build a collaborative tool with Univer Office SDK
+### Quick start: an open-source spreadsheet editor
-[![Build a collaborative tool with Univer Office SDK](https://i.ytimg.com/vi/1p-SMEiK6Kg/maxresdefault.jpg)](https://www.youtube.com/watch?v=1p-SMEiK6Kg)
+In a browser application using a bundler such as Vite:
-[Watch the demo](https://www.youtube.com/watch?v=1p-SMEiK6Kg)
+```bash
+pnpm add @univerjs/presets @univerjs/preset-sheets-core
+```
-## Built with Univer Office SDK
+Create the container before initializing Univer:
-### Featured example: Univer Workspace
+```html
+<div id="app" style="height: 100vh"></div>
+```
-[Univer Workspace](https://github.com/dream-num/univer-workspace) is an open-source, self-hostable workspace built on Univer Office SDK, where people and AI agents create, collaborate on, and review Office content. Developers can use the complete implementation as a reference, learn how to integrate the SDK, and build their own products.
+```ts
+import { UniverSheetsCorePreset } from '@univerjs/preset-sheets-core'
+import UniverPresetSheetsCoreEnUS from '@univerjs/preset-sheets-core/locales/en-US'
+import { createUniver, LocaleType, mergeLocales } from '@univerjs/presets'
+import '@univerjs/preset-sheets-core/lib/index.css'
-[![A Workspace mini-app beside its linked spreadsheet, with metrics, charts, and controls bound to cells](./docs/img/workspace-mini-app.png)](https://github.com/dream-num/univer-workspace)
+const { univerAPI } = createUniver({
+ locale: LocaleType.EN_US,
+ locales: {
+ [LocaleType.EN_US]: mergeLocales(UniverPresetSheetsCoreEnUS),
+ },
+ presets: [
+ UniverSheetsCorePreset({
+ container: 'app',
+ }),
+ ],
+})
-- Agents can generate spreadsheet-based mini-apps, such as decision-making dashboards, interactive reports, and business dashboards.
-- Metrics, charts, and controls on the web page are bound to cells, supporting data reads, writes, and collaborative updates.
+univerAPI.createWorkbook({})
+```
-[Explore Univer Workspace](https://github.com/dream-num/univer-workspace)
+Your page now contains a spreadsheet editor. Use the returned `univerAPI` to work with its content. This example uses open-source packages and needs no commercial Univer license or Server SDK.
-### Other examples
+For component frameworks, retain the `univer` instance returned by `createUniver` and call `univer.dispose()` when the component unmounts. See the [lifecycle guide](https://docs.univer.ai/guides/sheets/getting-started/lifecycle).
-These open-source projects are built with Univer Office SDK:
+Presets compose plugins and register their Facade APIs. For manual control, see the [Plugin Mode example](#manual-plugin-composition) below. The [installation guide](https://docs.univer.ai/guides/sheets/getting-started/installation) covers both modes, peer dependencies, and framework integrations.
-| Project | Description |
-| --- | --- |
-| [Univer Office for DeepSeek Harness](https://github.com/dream-num/dsh-univer-office) | An Office plugin for DeepSeek Harness with connected content, validation, and isolated worktrees for agent collaboration. |
-| [Univer CLI](https://github.com/dream-num/univer-cli) | A local command-line workspace for agents to create, edit, inspect, and deliver Office content. |
-| [Univer Office for WorkBuddy](https://github.com/dream-num/workbuddy-univer-office) | A local Office integration for WorkBuddy with MCP previews and draft review. Development preview. |
-| [Univer Office for OpenClaw](https://github.com/dream-num/openclaw-univer-office) | Tools for creating, reviewing, and delivering Office content in OpenClaw. |
+Keep coordinated `@univerjs/*` packages on the same version. Commercial packages must use the matching release line; independently released packages such as icons follow their declared compatibility. See the [API Stability Policy](./docs/API_STABILITY.md).
-Each project documents its own setup and SDK licensing requirements.
+<a id="connect-your-application-to-editable-content"></a>
-## 🌟 Highlights
+### Connect your application to editable content
-<table>
- <tr>
- <td align="center" width="33%">
- ⚡<br />
- <strong>Built for large surfaces</strong><br />
- <sub>Canvas-based rendering and a dedicated formula engine keep complex workbooks responsive.</sub>
- </td>
- <td align="center" width="33%">
- 🧩<br />
- <strong>Plugin-shaped by default</strong><br />
- <sub>Compose, replace, lazy-load, or extend capabilities without taking the whole stack.</sub>
- </td>
- <td align="center" width="33%">
- 🤖<br />
- <strong>Headless for AI infrastructure</strong><br />
- <sub>Run workbook and document logic in Node.js to power agents, automation, and server-side workflows.</sub>
- </td>
- </tr>
- <tr>
- <td align="center" width="33%">
- 🛠️<br />
- <strong>Product-ready SDK</strong><br />
- <sub>Framework adapters, Facade APIs, presets, and headless runtime fit real integration paths.</sub>
- </td>
- <td align="center" width="33%">
- 🌗<br />
- <strong>Dark-mode ready</strong><br />
- <sub>UI components and the rendering engine both adapt to light and dark themes.</sub>
- </td>
- <td align="center" width="33%">
- 🔌<br />
- <strong>Unified Facade API</strong><br />
- <sub>One consistent API surface for workbooks, ranges, formulas, and documents across browser and Node.js.</sub>
- </td>
- </tr>
-</table>
+Facade APIs are the application-facing interface to workbooks, worksheets, and ranges. Continue from the quick start to populate a quotation, update a quantity from application code, and read the recalculated total:
-## 🚀 Why Univer?
+```ts
+// Wait for formula controllers before editing a newly created workbook.
+await new Promise<void>((resolve) => {
+ if (univerAPI.getCurrentLifecycleStage() >= univerAPI.Enum.LifecycleStages.Steady) {
+ resolve()
+ return
+ }
+ const listener = univerAPI.addEvent(univerAPI.Event.LifeCycleChanged, ({ stage }) => {
+ if (stage === univerAPI.Enum.LifecycleStages.Steady) {
+ listener.dispose()
+ resolve()
+ }
+ })
+})
-- **Isomorphic by design**: run UI apps in browsers and headless processing in Node.js.
-- **Plugin-first architecture**: every capability is delivered as a composable plugin, so features can be added, removed, replaced, or lazy-loaded.
-- **Preset mode for fast integration**: use the curated plugin collections in [`presets/`](./presets) when you want a working app quickly.
-- **Plugin mode for full control**: manually compose packages when you need custom loading, smaller bundles, or deep integration.
-- **Facade API**: work with workbooks, worksheets, ranges, documents, formulas, commands, and events through a higher-level API.
-- **Canvas rendering engine**: support large editable document surfaces with a rendering layer shared across document types.
-- **Extensible UI**: integrate with React, Vue, Web Components, and framework-specific application shells.
+const workbook = univerAPI.getActiveWorkbook()!
+const sheet = workbook.getActiveSheet()
-## 🤖 Office Workflows for AI Agents
+sheet.getRange('A1:D4').setValues([
+ ['Item', 'Quantity', 'Unit price', 'Amount'],
+ ['Seats', 2, 25, '=B2*C2'],
+ ['Support', 1, 100, '=B3*C3'],
+ ['Total', '', '', '=SUM(D2:D3)'],
+])
-Univer's AI and collaboration capabilities connect agent operations with interactive editing and human review:
+// An application control or agent can make the same edit.
+sheet.getRange('B2').setValue(4)
-- **Programmatic editing**: agents inspect and modify Office content through structured APIs.
-- **Output verification**: agents check results through content inspection, rendered screenshots, and layout diagnostics.
-- **Worktree collaboration**: agents work in isolated drafts, then people review their changes and decide what to merge.
+univerAPI.getFormula().onCalculationResultApplied().then(() => {
+ console.log(sheet.getRange('D4').getValue()) // 200
+ localStorage.setItem('quotation', JSON.stringify(workbook.save()))
+}).catch(console.error)
+```
-See the [AI SDK documentation](https://docs.univer.ai/ai) for integration details. Live editing, shared revisions, and Worktree workflows require the corresponding Web SDK and collaboration capabilities; package availability and licensing vary by feature.
+The editor and your application operate on the same workbook; formula changes are recalculated automatically. `workbook.save()` returns a JSON snapshot containing the workbook and its registered plugin data. Your application owns persistence; this example uses browser storage. On a later page load, after initialization, restore the snapshot **instead of creating a blank workbook**:
-## ⚡ Quick Start
+```ts
+const saved = localStorage.getItem('quotation')
+if (saved) {
+ univerAPI.createWorkbook(JSON.parse(saved))
+}
+```
-Use **Plugin Mode** for complete product coverage and precise composition. For supported Sheets, Docs, and Node profiles, **Preset Mode** provides a shorter curated setup.
+This workflow uses only open-source packages. Snapshot persistence is separate from XLSX import and export, which uses the separately distributed file-conversion capabilities. Use public Facade APIs for application integration; the source links below explain internal implementation and extension points. See the [API Stability Policy](./docs/API_STABILITY.md) before depending on an extension point.
-<details open>
-<summary><strong>Plugin Mode</strong></summary>
+<a id="manual-plugin-composition"></a>
-Plugin Mode gives you lower-level control over packages, style imports, locale merging, Facade API registration, and plugin configuration.
+<details>
+<summary>Advanced: compose plugins manually (Plugin Mode)</summary>
+
+Use Plugin Mode when you need precise control over plugin selection, dependencies, or loading. The preset above handles this composition for you.
+
+This alternative initialization uses the same `app` container and the Sheets Core preset's browser plugin stack without a Worker. Use it **instead of** the preset initialization, then run the same quotation example with the returned `univerAPI`.
```bash
-pnpm add @univerjs/core @univerjs/design @univerjs/docs @univerjs/docs-ui @univerjs/engine-formula @univerjs/engine-render @univerjs/sheets @univerjs/sheets-formula @univerjs/sheets-formula-ui @univerjs/sheets-numfmt @univerjs/sheets-numfmt-ui @univerjs/sheets-ui @univerjs/ui
+pnpm add @univerjs/core @univerjs/design @univerjs/docs @univerjs/docs-ui \
+ @univerjs/engine-formula @univerjs/engine-render @univerjs/network \
+ @univerjs/sheets @univerjs/sheets-ui @univerjs/sheets-formula \
+ @univerjs/sheets-formula-ui @univerjs/sheets-numfmt \
+ @univerjs/sheets-numfmt-ui @univerjs/ui
```
```ts
@@ -161,7 +301,9 @@ import { UniverDocsPlugin } from '@univerjs/docs'
import { UniverDocsUIPlugin } from '@univerjs/docs-ui'
import DocsUIEnUS from '@univerjs/docs-ui/locale/en-US'
import { UniverFormulaEnginePlugin } from '@univerjs/engine-formula'
+import FormulaEnUS from '@univerjs/engine-formula/locale/en-US'
import { UniverRenderEnginePlugin } from '@univerjs/engine-render'
+import { UniverNetworkPlugin } from '@univerjs/network'
import { UniverSheetsPlugin } from '@univerjs/sheets'
import SheetsEnUS from '@univerjs/sheets/locale/en-US'
import { UniverSheetsFormulaPlugin } from '@univerjs/sheets-formula'
@@ -175,167 +317,467 @@ import { UniverSheetsUIPlugin } from '@univerjs/sheets-ui'
import SheetsUIEnUS from '@univerjs/sheets-ui/locale/en-US'
import { UniverUIPlugin } from '@univerjs/ui'
import UIEnUS from '@univerjs/ui/locale/en-US'
-
import '@univerjs/design/lib/index.css'
import '@univerjs/ui/lib/index.css'
import '@univerjs/docs-ui/lib/index.css'
import '@univerjs/sheets-ui/lib/index.css'
import '@univerjs/sheets-formula-ui/lib/index.css'
import '@univerjs/sheets-numfmt-ui/lib/index.css'
-
+import '@univerjs/network/facade'
+import '@univerjs/docs/facade'
+import '@univerjs/docs-ui/facade'
import '@univerjs/engine-formula/facade'
-import '@univerjs/ui/facade'
import '@univerjs/sheets/facade'
+import '@univerjs/ui/facade'
import '@univerjs/sheets-ui/facade'
import '@univerjs/sheets-formula/facade'
import '@univerjs/sheets-numfmt/facade'
+import '@univerjs/sheets-formula-ui/facade'
const univer = new Univer({
locale: LocaleType.EN_US,
locales: {
[LocaleType.EN_US]: mergeLocales(
DesignEnUS,
- UIEnUS,
DocsUIEnUS,
+ FormulaEnUS,
SheetsEnUS,
- SheetsUIEnUS,
SheetsFormulaEnUS,
SheetsFormulaUIEnUS,
SheetsNumfmtUIEnUS,
+ SheetsUIEnUS,
+ UIEnUS,
),
},
})
+univer.registerPlugin(UniverNetworkPlugin)
+univer.registerPlugin(UniverDocsPlugin)
univer.registerPlugin(UniverRenderEnginePlugin)
-univer.registerPlugin(UniverFormulaEnginePlugin)
univer.registerPlugin(UniverUIPlugin, { container: 'app' })
-univer.registerPlugin(UniverDocsPlugin)
univer.registerPlugin(UniverDocsUIPlugin)
-univer.registerPlugin(UniverSheetsPlugin)
-univer.registerPlugin(UniverSheetsUIPlugin)
-univer.registerPlugin(UniverSheetsFormulaPlugin)
-univer.registerPlugin(UniverSheetsFormulaUIPlugin)
+univer.registerPlugin(UniverFormulaEnginePlugin)
+univer.registerPlugin(UniverSheetsPlugin, {
+ onlyRegisterFormulaRelatedMutations: false,
+})
+univer.registerPlugin(UniverSheetsUIPlugin, {
+ protectedRangeShadow: true,
+})
univer.registerPlugin(UniverSheetsNumfmtPlugin)
univer.registerPlugin(UniverSheetsNumfmtUIPlugin)
+univer.registerPlugin(UniverSheetsFormulaPlugin)
+univer.registerPlugin(UniverSheetsFormulaUIPlugin)
const univerAPI = FUniver.newAPI(univer)
univerAPI.createWorkbook({})
```
+The Docs plugins support spreadsheet rich-text editing. When adding a feature, include its corresponding Facade extensions, locale bundles, and UI styles. Dispose `univer` when its container is unmounted.
+
</details>
-<details>
-<summary><strong>Preset Mode</strong></summary>
+<p align="right"><a href="#readme-top"><img src="https://img.shields.io/badge/%E2%86%91%20Back%20to%20top-30363D?style=flat-square" alt="Back to top" height="20" /></a></p>
+
+<a id="open-source-architecture"></a>
+
+## 🏗️ Explore the open-source architecture
+
+<p align="center"><img src="./docs/img/readme/architecture-banner.png" alt="" width="960" /></p>
+
+<a id="give-custom-features-clear-boundaries"></a>
+
+### Give custom features clear boundaries
+
+Univer organizes content logic and UI interaction in separate plugins. Feature plugins manage rules and content changes; UI plugins provide the interface and user interactions. For example, `sheets-filter` manages filter ranges and rules, while `sheets-filter-ui` provides panels, menus, and shortcuts.
+
+```mermaid
+%%{init: {'htmlLabels': false, 'theme': 'base', 'themeVariables': {'fontFamily': 'Arial, PingFang SC, Microsoft YaHei, sans-serif', 'fontSize': '17px', 'lineColor': '#64748b'}, 'flowchart': {'htmlLabels': false, 'curve': 'linear', 'nodeSpacing': 28, 'rankSpacing': 45, 'padding': 16, 'wrappingWidth': 270}}}%%
+%% A layered overview, not a complete dependency graph.
+%% Group arrows indicate reuse of the layer below; internal arrows show selected dependencies.
+flowchart TD
+ subgraph FEATURES["Feature Plugins"]
+ direction LR
+ FUI["Filter<br/>UI Plugin"]
+ VUI["Data Validation<br/>UI Plugin"]
+ FILTER["Filter Plugin"]
+ VALIDATION["Data Validation Plugin"]
+ FUI --> FILTER
+ VUI --> VALIDATION
+ end
+
+ subgraph PRODUCTS["Product Plugins"]
+ direction LR
+ SUI["Sheets UI Plugin"]
+ SHEETS["Sheets Plugin"]
+ SUI --> SHEETS
+ end
+
+ subgraph FOUNDATION["Core Framework & Plugins"]
+ direction LR
+ UI["UI Plugin"]
+ FORMULA["Formula Engine Plugin"]
+ RENDER["Render Engine Plugin"]
+ CORE["Core"]
+ UI --> RENDER
+ RENDER --> CORE
+ FORMULA --> CORE
+ end
+
+ FEATURES --> PRODUCTS
+ PRODUCTS --> FOUNDATION
+
+ classDef logic fill:#eff6ff,color:#17365f,stroke:#93b4df,stroke-width:1.5px
+ classDef ui fill:#f0fdf4,color:#17543a,stroke:#91c8a7,stroke-width:1.5px
+ classDef shared fill:#f6f7f9,color:#334155,stroke:#bac3ce,stroke-width:1.5px
+ classDef feature fill:#172d50,color:#ffffff,stroke:#172d50
+ class FUI,VUI ui
+ class FILTER,VALIDATION logic
+ class SUI,SHEETS logic
+ class UI,FORMULA,RENDER,CORE shared
+
+ style FEATURES fill:#f7fcf9,stroke:#b5d8c1,color:#17543a
+ style PRODUCTS fill:#f5f9ff,stroke:#b6cbea,color:#17365f
+ style FOUNDATION fill:#fafbfc,stroke:#cbd2dc,color:#334155
+```
-Presets are curated collections of Univer plugins that include the required Facade API registrations and styles.
+**Figure 1: three plugin layers.** Feature plugins build on product plugins, which reuse the core framework and plugins. Group arrows show dependencies on the layer below; Core provides content models, commands, dependency injection, and lifecycle management. Some plugins and dependencies are omitted.
-```bash
-pnpm add @univerjs/presets @univerjs/preset-sheets-core
-```
+New features keep their rules in their own plugins and cooperate through public services, commands, and defined extension points. UI plugins build on shared UI services and components.
-```ts
-import { UniverSheetsCorePreset } from '@univerjs/preset-sheets-core'
-import UniverPresetSheetsCoreEnUS from '@univerjs/preset-sheets-core/locales/en-US'
-import { createUniver, LocaleType, mergeLocales } from '@univerjs/presets'
+Dependencies are explicit at two levels:
-import '@univerjs/preset-sheets-core/lib/index.css'
+- **Between plugins:** `DependentOn` declares runtime plugin dependencies. The plugin service orders them, and lifecycle stages separate dependency registration, content initialization, and UI initialization.
+- **Inside plugins:** dependency injection connects controllers and services through declared dependencies. Supported overrides let an application replace an implementation, adapt a platform service, or supply a test double. Instance-scoped injectors keep application state separate between Univer instances.
-const { univerAPI } = createUniver({
- locale: LocaleType.EN_US,
- locales: {
- [LocaleType.EN_US]: mergeLocales(UniverPresetSheetsCoreEnUS),
- },
- presets: [
- UniverSheetsCorePreset({
- container: 'app',
- }),
- ],
-})
+Disposable registration also gives commands, listeners, components, and icons a cleanup path when their owner is disposed.
-univerAPI.createWorkbook({})
+The [filter plugin](./packages/sheets-filter/src/plugin.ts) and its [UI plugin](./packages/sheets-filter-ui/src/plugin.ts) show these boundaries in working code.
+
+<details>
+<summary>Inside a feature: Model, Controller, Service, and the UI foundation</summary>
+
+For filtering, `sheets-filter` owns content logic and `sheets-filter-ui` owns UI interaction. Each module has a focused responsibility.
+
+```mermaid
+%%{init: {'htmlLabels': false, 'theme': 'base', 'themeVariables': {'fontFamily': 'Arial, PingFang SC, Microsoft YaHei, sans-serif', 'fontSize': '17px', 'lineColor': '#64748b'}, 'flowchart': {'htmlLabels': false, 'curve': 'linear', 'nodeSpacing': 28, 'rankSpacing': 45, 'padding': 16, 'wrappingWidth': 270}}}%%
+%% Every arrow means contains. This is code organization, not execution order.
+flowchart LR
+ FEATURE["Filter Feature"]
+ LOGIC["Filter Plugin"]
+ UI["Filter UI Plugin"]
+ MODEL["Model"]
+ SERVICE["Service"]
+ CONTROLLER["Controller"]
+ COMMAND["Command / Mutation"]
+ FACADE["Facade API"]
+ VIEW["View"]
+ UICTRL["UI Controller"]
+ UISERVICE["UI Service"]
+ FEATURE --> LOGIC
+ FEATURE --> UI
+ LOGIC --> MODEL
+ LOGIC --> SERVICE
+ LOGIC --> CONTROLLER
+ LOGIC --> COMMAND
+ LOGIC --> FACADE
+ UI --> VIEW
+ UI --> UICTRL
+ UI --> UISERVICE
+
+ classDef logic fill:#eff6ff,color:#17365f,stroke:#93b4df,stroke-width:1.5px
+ classDef ui fill:#f0fdf4,color:#17543a,stroke:#91c8a7,stroke-width:1.5px
+ classDef shared fill:#f6f7f9,color:#334155,stroke:#bac3ce,stroke-width:1.5px
+ classDef feature fill:#172d50,color:#ffffff,stroke:#172d50
+ class FEATURE feature
+ class LOGIC,MODEL,SERVICE,CONTROLLER,COMMAND,FACADE logic
+ class UI,VIEW,UICTRL,UISERVICE ui
```
+**Figure 2: code organization. Arrows mean “contains.”** Both plugins can contain Controllers and Services: logic Controllers coordinate content changes and related features; UI Controllers connect menus, shortcuts, and interactions, with UI Services managing panel state. These responsibilities give new features a consistent structure to implement and test.
+
+The UI foundation follows the same division. **`@univerjs/design`** supplies shared components and styles, **`@univerjs/ui`** provides workbench services such as menus, shortcuts, panels, and component registration, and **`@univerjs/icons`** supplies icons. A feature registers its components and icons, contributes menus, and attaches its rendering through these extension points. Teams can add a panel or toolbar feature while reusing the application's UI infrastructure. See the [UI overview](https://docs.univer.ai/guides/sheets/ui/overview) and the filter plugin's [component and icon registration](./packages/sheets-filter-ui/src/controllers/components.controller.ts).
+
</details>
-Your page needs a container:
+<a id="compose-cross-feature-edits-and-undoredo"></a>
-```html
-<div id="app" style="height: 100vh"></div>
+### Compose cross-feature edits and undo/redo
+
+For example, when rows are inserted inside a filter range, the filter plugin supplies the corresponding range change and its undo data. The row command composes the base edit and participating feature changes, executes them, and records their undo/redo information together. The row insertion feature can use the shared extension mechanism while the filter plugin owns its range-update rules.
+
+The command system distinguishes three kinds of action:
+
+- **Command** orchestrates a business action and the changes it requires.
+- **Mutation** changes content saved in a snapshot, with serializable parameters.
+- **Operation** changes transient state, such as an open panel or the scroll position.
+
+**A shared structure for undo/redo.** For an undoable edit, the feature implementation supplies the forward mutations and corresponding inverse mutations, and the Command records them through `IUndoRedoService`. When one action affects several features, the Command can combine their changes and undo data in a single undo/redo record, so the user can undo and redo the complete action. See [extending commands](https://docs.univer.ai/blog/custom-command).
+
+Features still need to cooperate. **Interceptors and reference-range handlers give that cooperation a defined place.** At supported extension points, plugins contribute checks or related mutations; interceptor priorities control ordering where the API defines it.
+
+<details>
+<summary>Example: commands, callbacks, feature coordination, and undo/redo</summary>
+
+```mermaid
+%%{init: {'htmlLabels': false, 'theme': 'base', 'themeVariables': {'fontFamily': 'Arial, PingFang SC, Microsoft YaHei, sans-serif', 'fontSize': '17px', 'lineColor': '#64748b'}, 'flowchart': {'htmlLabels': false, 'curve': 'linear', 'nodeSpacing': 28, 'rankSpacing': 45, 'padding': 16, 'wrappingWidth': 270}}}%%
+%% Simplified insert-row example. A command composes mutations and records undo after success.
+%% Events may also fire for nested command executions; not every callback is drawn.
+flowchart TD
+ BEFORE["Before execution<br/>Inspect or cancel"]
+ CMD["Insert-row Command"]
+ BASE["Row mutations"]
+ EXT["Feature extension points<br/>Filter range changes"]
+ MODEL["Execute combined mutations"]
+ UNDO["Record undo and redo"]
+ AFTER["After execution<br/>Notify listeners"]
+ BEFORE --> CMD
+ CMD --> BASE
+ CMD --> EXT
+ BASE --> MODEL
+ EXT --> MODEL
+ MODEL --> UNDO
+ UNDO --> AFTER
+ classDef entry fill:#f6f7f9,color:#334155,stroke:#bac3ce,stroke-width:1.5px
+ classDef core fill:#eff6ff,color:#17365f,stroke:#93b4df,stroke-width:1.5px
+ classDef extension fill:#f0fdf4,color:#17543a,stroke:#91c8a7,stroke-width:1.5px
+ class BEFORE,AFTER entry
+ class CMD,BASE,MODEL,UNDO core
+ class EXT extension
```
-Learn more in the [Installation & Basic Usage guide](https://docs.univer.ai/guides/sheets/getting-started/installation), the [`createUniver` reference](https://docs.univer.ai/reference/methods/create-univer), and the [Facade API reference](https://docs.univer.ai/reference/classes/univer).
+This diagram simplifies an insert-row workflow. Nested command executions have their own callbacks; it does not show every event or the separate Operation path. See the [row command](./packages/sheets/src/commands/commands/insert-row-col.command.ts), [filter controller](./packages/sheets-filter/src/controllers/sheets-filter.controller.ts), and [interceptor service](./packages/sheets/src/services/sheet-interceptor/sheet-interceptor.service.ts).
-## 🧩 Preset Mode vs Plugin Mode
+</details>
-| Choose | When to use it | Start here |
-| --- | --- | --- |
-| **Plugin Mode** | You need strict control over packages, configured dependencies, lazy loading, or custom runtime composition. | This repository's [`examples/`](./examples) and [architecture guide](https://docs.univer.ai/guides/recipes/architecture/univer) |
-| **Preset Mode** | You want a working Sheets, Docs, or Node setup with minimal configuration. | This repository's [`presets/`](./presets) and the [getting started guide](https://docs.univer.ai/guides/sheets/getting-started/installation) |
-| **Headless Mode** | You need server-side workbook/document processing, formula calculation, or automation without UI. | [Headless Univer](https://docs.univer.ai/guides/sheets/getting-started/node) |
+These boundaries support a practical testing strategy: test models and services independently, replace external dependencies through DI, and add regression cases for combined actions and undo/redo. The [filter controller tests](./packages/sheets-filter/src/controllers/__tests__/sheets-filter.controller.spec.ts) exercise row and column changes and their effect on filtering.
-Keep the `@univerjs/*` SDK packages in the same coordinated Univer release line on the same version. Independently released packages, including `@univerjs/icons` and `@univerjs/icons-svg`, use the compatible versions declared by package manifests instead of the SDK version. If you use Univer Pro packages, keep `@univerjs-pro/*` aligned with the matching coordinated release line.
+<a id="connect-applications-and-agents-through-facade-apis-and-events"></a>
-For API compatibility expectations, experimental APIs, internal APIs, and deprecation rules, see the [API Stability Policy](./docs/API_STABILITY.md).
+### Connect applications and agents through Facade APIs and events
-## 🧭 Compatibility
+The repository includes the content models, formula engine, and Canvas rendering and layout engine behind the editors. They are shared building blocks: spreadsheet rich text, for example, reuses document layout and rendering. Custom features can build on these engines instead of implementing a separate content stack. Read about the [formula engine architecture](https://docs.univer.ai/blog/formula) and [rendering engine architecture](https://docs.univer.ai/blog/rendering).
-- **Browser runtime**: Univer is compiled with a Chrome 88 target and aims to work on Edge `>=88`, Firefox `>=90`, Chrome `>=88`, Safari `>=14.1`, and Electron `>=12`.
-- **Polyfills**: Univer relies on `Intl.Segmenter`. Add a polyfill such as `@formatjs/intl-segmenter` if your target browser or runtime does not provide it.
-- **Build tools**: We recommend Vite, esbuild, or Webpack 5. If your build tool does not support the `exports` field in `package.json` (common in Webpack 4), you may need extra path mapping.
-- **React**: Univer's view layer is built on React 18, supports React 18 and 19, and provides minimal compatibility support for React 16.9+ and 17.
-- **Node.js runtime**: Headless Univer supports Node.js `>=18.17.0`. Developing this monorepo requires Node.js `>=22.18`.
+Browser editors, Node.js Headless tasks, and appropriately composed Workers can reuse the corresponding content plugins, models, commands, and calculation. See [Headless Univer](https://docs.univer.ai/guides/sheets/getting-started/node) and the [isomorphic architecture](./docs/ISOMORPHIC.md).
+
+`ICommandService` exposes execution callbacks so plugins can observe commands before and after execution. Facade APIs wrap the underlying capabilities in application objects such as `FWorkbook`, `FWorksheet`, and `FRange`.
+
+Each plugin contributes its own Facade extensions, **typed events through `univerAPI.Event`**, and **enums through `univerAPI.Enum`**. Application code can discover event names and constants from one entry point instead of importing private services or repeating strings. For example, `BeforeCommandExecute` can inspect and cancel an execution; `CommandExecuted` reports executions to listeners. Listeners return disposables, and cancellation applies where the event supports it.
+
+Facade extensions stay with their feature packages, so a content API does not have to pull in unrelated UI APIs. See the [Facade design](https://docs.univer.ai/blog/facade), [command callbacks and event bridge](./packages/core/src/facade/f-univer.ts), and [Enum entry point](./packages/core/src/facade/f-enum.ts).
+
+The repository provides working feature implementations and patterns for extending them. Read the [filter implementation walkthrough](https://docs.univer.ai/blog/anatomy) for a complete example, or the [API Stability Policy](./docs/API_STABILITY.md) before depending on an extension point.
+
+<p align="right"><a href="#readme-top"><img src="https://img.shields.io/badge/%E2%86%91%20Back%20to%20top-30363D?style=flat-square" alt="Back to top" height="20" /></a></p>
+
+<a id="open-source-and-commercial-extensions"></a>
+
+## 🧩 Extend your application with Univer Office SDK
+
+<p align="center"><img src="./docs/img/readme/sdk-banner.png" alt="" width="960" /></p>
-## 🛠️ What You Can Build
+When you want more ready-to-integrate capabilities, compose the corresponding **Univer Office SDK** modules: additional content types, advanced editing plugins, collaboration, file conversion, and agent tooling. They extend the same content models, plugin architecture, command system, and Facade design introduced above, so you can build on your existing integration.
-| Area | Open-source capabilities | Univer Pro extensions |
-| --- | --- | --- |
-| **Sheets** | Workbooks, worksheets, ranges, selection, formulas, number formatting, filtering, sorting, data validation, conditional formatting, hyperlinks, comments, find and replace, notes, tables, drawing integration, and extensible UI plugins. | Real-time collaboration, edit history, import/export, printing, charts, pivot tables, sparklines, outlines, shapes, in-cell graphics, data connectors, server-side calculation, and performance-enhanced formula features. |
-| **Docs** | Rich document model, editing UI, lists, hyperlinks, drawing integration, comments, quick insert, and shared document architecture. | Collaboration, import/export, printing, enhanced tables and lists, columns, callouts, code blocks, quotes, shapes, and remote comment resources. |
-| **Slides** | — | Slide model and UI, slide import/export, chart and table model/UI plugins, and shared shape-editing infrastructure. |
-| **Bases** | Build custom structured-data experiences on top of Univer's plugin, command, and model architecture. | Base database model, commands, formula integration, workbench UI, field editors, and render-engine views. |
-| **Runtime** | Browser apps, Node.js headless usage, Web Worker/RPC patterns, multi-instance usage, and server-oriented automation. | Collaboration client/server packages, Node.js collaboration client, Pro server services, SSR, computing delegation, server-side calculation, and changeset replay tooling. |
-| **Integrations** | React, Vue, Web Components, framework templates, theming, localization, and custom plugins. | Pro presets and enterprise deployment packages. |
+<div align="center" style="overflow-x: auto;">
-Sheets, Docs, and Slides provide spreadsheet, document, and presentation editing on Univer's shared architecture, with a consistent plugin system, command system, and Facade API.
+<table align="center" style="display: table; width: auto; margin-left: auto; margin-right: auto;">
+<thead>
+<tr>
+<th>Part</th>
+<th>How it extends the foundation</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td><strong>Open-source Web SDK core · this repository</strong></td>
+<td>Open-source models, engines, plugins, UI foundation, and Sheets and Docs capabilities, with corresponding Headless content operations. Use them in commercial applications under Apache-2.0.</td>
+</tr>
+<tr>
+<td><strong>Commercial Web SDK plugins</strong></td>
+<td>Follow the core's Plugin, dependency injection, Command/Mutation, and Facade extension patterns. Add charts, shapes, pivot tables, SmartArt, and other features for the corresponding content types.</td>
+</tr>
+<tr>
+<td><strong>Server SDK</strong></td>
+<td>Extends the same content models and mutation conventions with real-time collaboration, revision history, and Office file conversion. Integrates with your application's identity, permissions, and storage.</td>
+</tr>
+<tr>
+<td><strong>AI SDK extensions</strong></td>
+<td>Reuse Web SDK Headless and Facade capabilities to provide composable Node.js APIs and CLI building blocks for agents to inspect, edit, and check content, with collaboration and Worktree review integrations.</td>
+</tr>
+</tbody>
+</table>
+
+</div>
+
+<a id="scope-and-licensing"></a>
+
+### Scope and licensing
+
+- **This repository:** Apache-2.0 packages that can be used in commercial applications under that license, including the open-source Headless content capabilities.
+- **Commercial extensions:** Commercial Web SDK plugins, Server SDK, and AI SDK capabilities beyond the open-source foundation are distributed and licensed separately. **Freemium** evaluation includes watermarks and feature limits.
+- **Reference applications:** Open-source applications such as Univer Workspace have their own source licenses. Their SDK dependencies retain their respective licenses.
+
+See the [feature comparison](https://univer.ai/compare/), including its **Open source only** filter, for detailed coverage and [plans and licensing](https://univer.ai/pricing/) for commercial options.
+
+<details>
+<summary>How shared content models connect editing, collaboration, and files</summary>
+
+These capabilities operate on serializable **Unit snapshots**, including Sheets' `IWorkbookData`, Docs' `IDocumentData`, Slides' `ISlideData`, and canvases' `IBoardData` (called **Boards** in the API). These types come from core and the respective product packages; current Slides and Boards capabilities are separately distributed commercial products. The shared Unit conventions let browser editors, backend services, and agents work with the same content.
+
+Commands orchestrate edits; **Mutations describe content changes**. Collaboration packages those mutations into **changesets**, applies **operational transformation (OT)** to concurrent changes, and manages confirmed revisions and snapshots. History can reconstruct a revision from a snapshot and subsequent changesets. Read the [collaboration design](https://docs.univer.ai/blog/ot) and [Collaboration SDK overview](https://docs.univer.ai/server/collaboration/overview).
+
+**Exchange** maps Office file structures to and from Univer content snapshots. For OOXML formats such as **XLSX, DOCX, and PPTX**, it parses the file into the corresponding Sheet, Doc, or Slide data and generates the file representation on export. The converted content can enter the same editing, calculation, collaboration, and agent workflows. See [Office file import and export](https://docs.univer.ai/server/import-export/node).
+
+</details>
+
+<details>
+<summary>How AI SDK gives agents the same content capabilities</summary>
-## 🔓 Open Source and Pro
+AI SDK builds on the Web SDK's **Headless content models, commands, calculation, and Facade APIs**. It exposes structured TypeScript APIs and optional Commander presets that applications can compose into their own Office CLI or agent tools.
-This repository contains Univer's open-source core and first-party OSS plugins. Univer Pro is developed separately as a commercial extension layer for advanced product surfaces, collaboration, server features, and enterprise integrations.
+- **Understand, discover, and edit.** Inspection returns structured content. API Reference helps the agent find Facade symbols and signatures shipped with its SDK. Facade execution distinguishes read and write modes, captures mutations, and works with explicit synchronization and commit results. See [content operations](https://docs.univer.ai/ai/content-operations).
+- **Check the rendered result.** A browser Render Runtime reuses Web SDK rendering for screenshots. Slide layout lint adds structured findings for issues such as off-page or overlapping text, giving the agent evidence for another editing pass. See [visual inspection](https://docs.univer.ai/ai/visual-inspection).
+- **Edit drafts for human review.** With the corresponding collaboration and Web capabilities, agents can edit and verify an isolated Worktree draft over several rounds, then hand it to a person to review, merge, or reopen. The workflow uses the same snapshots, mutations, and revision conventions. See [Worktree](https://docs.univer.ai/ai/worktree).
-| Category | Open source | Univer Pro / commercial |
-| --- | --- | --- |
-| **Foundation** | Core SDK, plugin system, rendering engine, formula engine, Facade API, themes, i18n, and framework adapters. | Pro presets and enterprise deployment packages. |
-| **Sheets** | Core spreadsheet editing, formulas, number formatting, filter/sort, data validation, conditional formatting, notes, tables, hyperlinks, comments, drawing, find and replace. | Collaboration, edit history, import/export, print, charts, pivot tables, sparklines, outlines, shapes, in-cell graphics, data connectors, range preprocessing, and enhanced formula engine features. |
-| **Docs** | Document model and editor UI, lists, hyperlinks, comments, quick insert, and drawing integration. | Collaboration, import/export, print, enhanced tables/lists, columns, callouts, code blocks, quotes, shapes, and remote thread-comment resources. |
-| **Slides** | — | Slide model/UI packages, slide import/export, charts, tables, and reusable shape editor UI. |
-| **Bases** | Extensible plugin architecture for custom data-centric products. | Base database core model, commands, mutations, formula integration, workbench UI, field editors, and render-engine integration. |
-| **Server and runtime** | Node.js headless runtime, RPC/Web Worker patterns, and server-oriented automation primitives. | Collaboration server, Node.js collaboration client, SSR services, computing delegation, server-side calculation, and collaboration changeset replay tooling. |
+For repeated calls, optional [Worker pools and a daemon](https://docs.univer.ai/ai/runtime-architecture) reuse loaded content instances and reduce repeated initialization. Your application owns the root CLI, targets, authorization, and output. Explore the [AI SDK package catalog](https://docs.univer.ai/ai/packages) to select the required capabilities.
-Editor features are documented in the [Web SDK guides](https://docs.univer.ai/guides/sheets). For backend integration, see the Server SDK chapters on [collaboration](https://docs.univer.ai/server/collaboration/overview) and [file import/export](https://docs.univer.ai/server/import-export).
+</details>
-For commercial licensing and purchase enquiries, [contact us](https://univer.ai/#contact). See [license configuration](https://docs.univer.ai/server/license) to configure a license in your application.
+<p align="right"><a href="#readme-top"><img src="https://img.shields.io/badge/%E2%86%91%20Back%20to%20top-30363D?style=flat-square" alt="Back to top" height="20" /></a></p>
-Boundary principles:
+<a id="application-patterns-and-ecosystem"></a>
-- OSS packages in this repository are intended to be useful on their own under the Apache-2.0 license. Univer Pro is optional and is not required to use the public OSS SDK APIs.
-- Bugs, regressions, and security issues in OSS packages should be reported and fixed in the OSS repository, even when a related Pro feature exists.
-- OSS documentation should not imply that Pro-only capabilities are available in public `@univerjs/*` packages. Pro-only APIs, packages, and deployment paths should be named explicitly.
-- When an OSS feature has a Pro enhancement, the OSS behavior should remain documented independently so users can evaluate the open-source surface without reading commercial docs first.
+## 🌐 Application patterns and ecosystem
-## 🌐 Ecosystem
+<p align="center"><img src="./docs/img/readme/ecosystem-banner.png" alt="" width="960" /></p>
-- **Core SDK**: [`dream-num/univer`](https://github.com/dream-num/univer), this monorepo.
-- **Presets**: this repository's [`presets/`](./presets), curated plugin collections for browser and Node.js apps.
-- **AI agent skills**: [`dream-num/univer-sdk-skills`](https://github.com/dream-num/univer-sdk-skills), reusable instructions for AI agents working with Univer integration, Pro features, plugin development, and Node backends. See the [AI Skills guide](https://docs.univer.ai/guides/skills).
-- **Documentation**: [docs.univer.ai](https://docs.univer.ai), including Web SDK, Server SDK, and AI SDK guides and the API reference.
-- **Web SDK**: [embedded editors and headless processing](https://docs.univer.ai/guides/sheets) in the browser and Node.js.
-- **Server SDK**: [collaboration and file conversion](https://docs.univer.ai/server), integrated with your application's storage, identity, and permissions.
-- **AI SDK**: [agent workflows](https://docs.univer.ai/ai) for inspecting, editing, and verifying Office content.
-- **API Reference**: [docs.univer.ai/reference](https://docs.univer.ai/reference/classes/univer), the Facade API and generated API reference.
-- **Examples and showcase**: [Univer Showcase](https://docs.univer.ai/showcase) and this repository's [`examples/`](./examples).
-- **AI-native spreadsheets**: [`dream-num/univer-mcp`](https://github.com/dream-num/univer-mcp), Univer Platform / MCP integration for driving Univer Sheets with natural language.
+<a id="univer-workspace-an-office-sdk-reference-application"></a>
-## 📦 Repository Guide
+### Univer Workspace: an Office SDK reference application
+
+For a complete application reference, start with [Univer Workspace](https://github.com/dream-num/univer-workspace). It shows how to compose Univer Office SDK editors, collaboration, file capabilities, existing agents, and human review into a self-hostable workspace. Follow its integration patterns when building your own Office application or agent workspace.
+
+<div align="center" style="overflow-x: auto;">
+
+<table align="center" style="display: table; width: auto; margin-left: auto; margin-right: auto;">
+ <tr>
+ <td width="50%" valign="top">
+ <a href="https://space.univer.ai/"><img src="./docs/img/readme/workspace.webp" alt="An editable budget spreadsheet in Univer Workspace" width="420" /></a>
+ </td>
+ <td width="50%" valign="top">
+ <a href="https://univer.ai/demo/web-app"><img src="./docs/img/readme/web-app.webp" alt="A Web App with assumption controls beside its connected editable spreadsheet" width="420" /></a>
+ </td>
+ </tr>
+ <tr>
+ <td width="50%" valign="top">
+ <strong>Agents and editable Office content</strong><br />
+ Keep conversations, spreadsheet editing, and Office content in one workspace.<br />
+ <a href="https://space.univer.ai/">Try Workspace</a> · <a href="https://github.com/dream-num/univer-workspace">Workspace source and setup</a>
+ </td>
+ <td width="50%" valign="top">
+ <strong>Web App × Sheet · Experimental</strong><br />
+ Bind controls to cells: the app writes to the sheet, and sheet changes update the app.<br />
+ <a href="https://univer.ai/demo/web-app">Try the sheet-powered app demo</a>
+ </td>
+ </tr>
+</table>
+
+</div>
+
+Workspace is open source; its SDK dependencies follow their respective licenses. See the [Workspace overview](https://univer.ai/workspace/) for connected apps and review workflows.
+
+<p align="center"><a href="https://www.youtube.com/watch?v=1p-SMEiK6Kg"><img src="./docs/img/readme/integration-demo.png" alt="Watch an SDK integration demo" width="720" /></a></p>
+
+[Watch an SDK integration demo](https://www.youtube.com/watch?v=1p-SMEiK6Kg)
+
+<a id="cli-agent-integrations-and-developer-skills"></a>
+
+### CLI, agent integrations, and developer skills
+
+The same SDK capabilities can also be composed into the agents and tools you already use:
+
+<div align="center" style="overflow-x: auto;">
+
+<table align="center" style="display: table; width: auto; margin-left: auto; margin-right: auto;">
+<thead>
+<tr>
+<th>Project</th>
+<th>What it provides</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td><a href="https://github.com/dream-num/univer-cli">Univer CLI</a></td>
+<td>A local command-line workspace for creating, editing, inspecting, and delivering Office content.</td>
+</tr>
+<tr>
+<td><a href="https://github.com/dream-num/dsh-univer-office">Univer Office for DeepSeek Harness</a></td>
+<td>Linked content, result verification, versioned changes, and isolated Worktree collaboration.</td>
+</tr>
+<tr>
+<td><a href="https://github.com/dream-num/workbuddy-univer-office">Univer Office for WorkBuddy</a></td>
+<td>Local Office integration, MCP previews, and draft review. Developer preview.</td>
+</tr>
+<tr>
+<td><a href="https://github.com/dream-num/openclaw-univer-office">Univer Office for OpenClaw</a></td>
+<td>Tools for creating, reviewing, and delivering Office content.</td>
+</tr>
+<tr>
+<td><a href="https://github.com/dream-num/univer-sdk-skills">Univer SDK Skills</a></td>
+<td>Instructions that help coding agents integrate the SDK, develop plugins, and implement backend workflows.</td>
+</tr>
+</tbody>
+</table>
+
+</div>
+
+Each repository documents its setup and SDK dependencies. Explore the [ecosystem](https://univer.ai/ecosystem/) for agent entry points, or the [documentation](https://docs.univer.ai/) to build your own integration.
+
+<p align="right"><a href="#readme-top"><img src="https://img.shields.io/badge/%E2%86%91%20Back%20to%20top-30363D?style=flat-square" alt="Back to top" height="20" /></a></p>
+
+<a id="documentation-and-contributing"></a>
+
+## 📚 Documentation and contributing
+
+Thanks to all [contributors](https://github.com/dream-num/univer/graphs/contributors) who build and improve Univer. Contributions to engines, plugins, tests, documentation, and examples are welcome.
+
+<p align="center"><a href="https://docs.univer.ai/guides/sheets">🧩 Web SDK</a> · <a href="https://docs.univer.ai/server">🖥️ Server SDK</a> · <a href="https://docs.univer.ai/ai">🤖 AI SDK</a> · <a href="https://docs.univer.ai/reference/classes/univer">🔧 API reference</a> · <a href="https://office.univer.ai/">🎮 Live showcase</a></p>
+
+<div align="center" style="overflow-x: auto;">
+
+<table align="center" style="display: table; width: auto; margin-left: auto; margin-right: auto;">
+ <tr>
+ <th align="center"><img src="https://cdnjs.cloudflare.com/ajax/libs/browser-logos/75.0.1/edge/edge_64x64.png" width="32" height="32" alt="" /><br />Edge</th>
+ <th align="center"><img src="https://cdnjs.cloudflare.com/ajax/libs/browser-logos/75.0.1/firefox/firefox_64x64.png" width="32" height="32" alt="" /><br />Firefox</th>
+ <th align="center"><img src="https://cdnjs.cloudflare.com/ajax/libs/browser-logos/75.0.1/chrome/chrome_64x64.png" width="32" height="32" alt="" /><br />Chrome</th>
+ <th align="center"><img src="https://cdnjs.cloudflare.com/ajax/libs/browser-logos/75.0.1/safari/safari_64x64.png" width="32" height="32" alt="" /><br />Safari</th>
+ <th align="center"><img src="https://cdnjs.cloudflare.com/ajax/libs/browser-logos/75.0.1/electron/electron_64x64.png" width="32" height="32" alt="" /><br />Electron</th>
+ </tr>
+ <tr>
+ <td align="center"><code>&gt;=88</code></td>
+ <td align="center"><code>&gt;=90</code></td>
+ <td align="center"><code>&gt;=88</code></td>
+ <td align="center"><code>&gt;=14.1</code></td>
+ <td align="center"><code>&gt;=12</code></td>
+ </tr>
+</table>
+
+</div>
+
+<p align="center">Univer is compiled with a Chrome 88 target and aims to work with the versions listed above.</p>
+
+<a id="runtime-compatibility"></a>
+
+### Runtime compatibility
+
+- **Polyfills**: Univer relies on `Intl.Segmenter`. Add a polyfill such as `@formatjs/intl-segmenter` if your target browser or runtime does not provide it.
+- **Build tools**: We recommend Vite, esbuild, or Webpack 5. If your build tool does not support the `exports` field in `package.json` (common in Webpack 4), you may need extra path mapping.
+- **React**: Univer's view layer is built on React 18, supports React 18 and 19, and provides minimal compatibility support for React 16.9+ and 17.
+- **Node.js runtime**: Headless Univer supports Node.js `>=18.17.0`. Developing this monorepo requires Node.js `>=22.18`.
+
+<details>
+<summary>Developing in this repository</summary>
+
+### Repository layout
```text
.
@@ -348,12 +790,12 @@ Boundary principles:
Package-level READMEs live beside each package under [`packages/`](./packages).
-## 🧑‍💻 Development
+### Local development
Requirements:
- Node.js `>=22.18`
-- pnpm `>=11`
+- pnpm: use the version declared by `packageManager` in `package.json`.
```bash
git clone https://github.com/dream-num/univer.git
@@ -364,63 +806,107 @@ pnpm dev
Useful commands:
-| Command | Purpose |
-| --- | --- |
-| `pnpm dev` | Start the Sheets and Docs workbench with Vite 8 Bundled Dev and HMR. |
-| `pnpm build` | Build workspace packages, excluding internal common packages. |
-| `pnpm test` | Run unit tests through Turbo. |
-| `pnpm typecheck` | Run TypeScript checks through Turbo. |
-| `pnpm lint` | Run ESLint. |
-| `pnpm storybook:dev` | Start Storybook for UI component development. |
+<div align="center" style="overflow-x: auto;">
+
+<table align="center" style="display: table; width: auto; margin-left: auto; margin-right: auto;">
+<thead>
+<tr>
+<th>Command</th>
+<th>Purpose</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td><code class="notranslate">pnpm dev</code></td>
+<td>Start the Sheets and Docs development workbench.</td>
+</tr>
+<tr>
+<td><code class="notranslate">pnpm build</code></td>
+<td>Build workspace packages, excluding internal common packages.</td>
+</tr>
+<tr>
+<td><code class="notranslate">pnpm test</code></td>
+<td>Run unit tests through Turbo.</td>
+</tr>
+<tr>
+<td><code class="notranslate">pnpm typecheck</code></td>
+<td>Run TypeScript checks through Turbo.</td>
+</tr>
+<tr>
+<td><code class="notranslate">pnpm lint</code></td>
+<td>Run ESLint.</td>
+</tr>
+<tr>
+<td><code class="notranslate">pnpm storybook:dev</code></td>
+<td>Start Storybook for UI component development.</td>
+</tr>
+</tbody>
+</table>
+
+</div>
Read [CONTRIBUTING.md](./CONTRIBUTING.md) before opening a pull request.
-## 📝 Contributor Notes
+</details>
-Repository-local notes worth reading before deeper changes:
+<details>
+<summary>Architecture and contributor references</summary>
+
+- [Repository packages](./packages), [presets](./presets), and [examples](./examples).
+- [Building Isomorphic Univer](./docs/ISOMORPHIC.md).
+- [Contributing to Facade API](./docs/CONTRIBUTING-FACADE.md).
+- [API Stability Policy](./docs/API_STABILITY.md).
+- [Naming Convention](./docs/NAMING_CONVENTION.md) and [Fixing Memory Leaks](./docs/FIX_MEMORY_LEAK.md).
+- [Architecture TLDRs](./docs/tldr) and [OLE attachment notes](./packages/drawing/docs/ole-attachments.md).
+
+</details>
+
+<p align="right"><a href="#readme-top"><img src="https://img.shields.io/badge/%E2%86%91%20Back%20to%20top-30363D?style=flat-square" alt="Back to top" height="20" /></a></p>
-- [Building Isomorphic Univer](./docs/ISOMORPHIC.md): how to split browser, Node.js, UI, and shared plugin logic.
-- [API Stability Policy](./docs/API_STABILITY.md): stable, experimental, internal, deprecated, and breaking-change expectations.
-- [Contributing to Facade API](./docs/CONTRIBUTING-FACADE.md): API design expectations for `FUniver`, `FWorkbook`, `FRange`, and related Facade classes.
-- [Naming Convention](./docs/NAMING_CONVENTION.md): file, folder, interface, plugin, command, and dependency injection token conventions.
-- [Fixing Memory Leaks](./docs/FIX_MEMORY_LEAK.md): common leak patterns and debugging workflow for Univer instances.
-- [Architecture TLDRs](./docs/tldr): concise notes for formula engine, web worker, permission, selection, and ref-range behavior.
-- [OLE attachments](./packages/drawing/docs/ole-attachments.md): drawing resources, JSON and online transport, previews, and optional Pro conversion integration.
+<a id="community"></a>
## 💬 Community
-- Ask questions in [GitHub Discussions](https://github.com/dream-num/univer/discussions).
-- Chat with the community on [Discord](https://discord.gg/z3NKNT6D2f).
-- Follow [Twitter / X](https://twitter.com/univerhq) and [YouTube](https://www.youtube.com/@dreamNum).
+Ask questions in [GitHub Discussions](https://github.com/dream-num/univer/discussions), join [Discord](https://discord.gg/z3NKNT6D2f), and follow [X](https://twitter.com/univerhq) or [YouTube](https://www.youtube.com/@dreamNum). Please read the [Code of Conduct](./CODE_OF_CONDUCT.md).
+
+<p align="right"><a href="#readme-top"><img src="https://img.shields.io/badge/%E2%86%91%20Back%20to%20top-30363D?style=flat-square" alt="Back to top" height="20" /></a></p>
-Please read the [Code of Conduct](./CODE_OF_CONDUCT.md) before participating.
+<a id="security"></a>
## 🔒 Security
If you believe you have found a security issue, please follow the [Security Policy](./SECURITY.md).
+<p align="right"><a href="#readme-top"><img src="https://img.shields.io/badge/%E2%86%91%20Back%20to%20top-30363D?style=flat-square" alt="Back to top" height="20" /></a></p>
+
+<a id="sponsors"></a>
+
## ❤️ Sponsors
Univer is supported by the community and sponsors. You can support the project through [Open Collective](https://opencollective.com/univer).
-<a href="https://opencollective.com/univer/sponsor/0/website"><img src="https://opencollective.com/univer/sponsor/0/avatar.svg" alt="Sponsor 0" /></a>
-<a href="https://opencollective.com/univer/sponsor/1/website"><img src="https://opencollective.com/univer/sponsor/1/avatar.svg" alt="Sponsor 1" /></a>
-<a href="https://opencollective.com/univer/sponsor/2/website"><img src="https://opencollective.com/univer/sponsor/2/avatar.svg" alt="Sponsor 2" /></a>
-<a href="https://opencollective.com/univer/sponsor/3/website"><img src="https://opencollective.com/univer/sponsor/3/avatar.svg" alt="Sponsor 3" /></a>
-<a href="https://opencollective.com/univer/sponsor/4/website"><img src="https://opencollective.com/univer/sponsor/4/avatar.svg" alt="Sponsor 4" /></a>
-<a href="https://opencollective.com/univer/sponsor/5/website"><img src="https://opencollective.com/univer/sponsor/5/avatar.svg" alt="Sponsor 5" /></a>
-<a href="https://opencollective.com/univer/sponsor/6/website"><img src="https://opencollective.com/univer/sponsor/6/avatar.svg" alt="Sponsor 6" /></a>
-
-<a href="https://opencollective.com/univer/backer/0/website"><img src="https://opencollective.com/univer/backer/0/avatar.svg" alt="Backer 0" /></a>
-<a href="https://opencollective.com/univer/backer/1/website"><img src="https://opencollective.com/univer/backer/1/avatar.svg" alt="Backer 1" /></a>
-<a href="https://opencollective.com/univer/backer/2/website"><img src="https://opencollective.com/univer/backer/2/avatar.svg" alt="Backer 2" /></a>
-<a href="https://opencollective.com/univer/backer/3/website"><img src="https://opencollective.com/univer/backer/3/avatar.svg" alt="Backer 3" /></a>
-<a href="https://opencollective.com/univer/backer/4/website"><img src="https://opencollective.com/univer/backer/4/avatar.svg" alt="Backer 4" /></a>
-<a href="https://opencollective.com/univer/backer/5/website"><img src="https://opencollective.com/univer/backer/5/avatar.svg" alt="Backer 5" /></a>
-<a href="https://opencollective.com/univer/backer/6/website"><img src="https://opencollective.com/univer/backer/6/avatar.svg" alt="Backer 6" /></a>
+<p>
+ <a href="https://opencollective.com/univer/sponsor/0/website"><img src="https://opencollective.com/univer/sponsor/0/avatar.svg" alt="Become a sponsor" /></a>
+</p>
+
+<p>
+ <a href="https://opencollective.com/univer/backer/0/website"><img src="https://opencollective.com/univer/backer/0/avatar.svg" width="64" height="64" alt="Backer 0" /></a>
+ <a href="https://opencollective.com/univer/backer/1/website"><img src="https://opencollective.com/univer/backer/1/avatar.svg" width="64" height="64" alt="Backer 1" /></a>
+ <a href="https://opencollective.com/univer/backer/2/website"><img src="https://opencollective.com/univer/backer/2/avatar.svg" width="64" height="64" alt="Backer 2" /></a>
+ <a href="https://opencollective.com/univer/backer/3/website"><img src="https://opencollective.com/univer/backer/3/avatar.svg" width="64" height="64" alt="Backer 3" /></a>
+ <a href="https://opencollective.com/univer/backer/4/website"><img src="https://opencollective.com/univer/backer/4/avatar.svg" width="64" height="64" alt="Backer 4" /></a>
+ <a href="https://opencollective.com/univer/backer/5/website"><img src="https://opencollective.com/univer/backer/5/avatar.svg" width="64" height="64" alt="Backer 5" /></a>
+ <a href="https://opencollective.com/univer/backer/6/website"><img src="https://opencollective.com/univer/backer/6/avatar.svg" width="64" height="64" alt="Backer 6" /></a>
+</p>
+
+<p align="right"><a href="#readme-top"><img src="https://img.shields.io/badge/%E2%86%91%20Back%20to%20top-30363D?style=flat-square" alt="Back to top" height="20" /></a></p>
+
+<a id="license"></a>
## 📄 License
Copyright (c) 2021-present DreamNum Co., Ltd.
-Licensed under the [Apache-2.0](./LICENSE) license.
+The open-source packages in this repository are licensed under [Apache-2.0](./LICENSE). Commercial SDK modules are distributed and licensed separately.
+
+<p align="right"><a href="#readme-top"><img src="https://img.shields.io/badge/%E2%86%91%20Back%20to%20top-30363D?style=flat-square" alt="Back to top" height="20" /></a></p>
diff --git a/docs/img/banner.png b/docs/img/banner.png
deleted file mode 100644
index 1de7222ec9..0000000000
Binary files a/docs/img/banner.png and /dev/null differ
diff --git a/docs/img/debug-unit-test.png b/docs/img/debug-unit-test.png
deleted file mode 100644
index 421c7e1414..0000000000
Binary files a/docs/img/debug-unit-test.png and /dev/null differ
diff --git a/docs/img/multi-instances.png b/docs/img/multi-instances.png
deleted file mode 100644
index 5b70039313..0000000000
Binary files a/docs/img/multi-instances.png and /dev/null differ
diff --git a/docs/img/readme/architecture-banner.png b/docs/img/readme/architecture-banner.png
new file mode 100644
index 0000000000..91d558b932
Binary files /dev/null and b/docs/img/readme/architecture-banner.png differ
diff --git a/docs/img/readme/build-banner.png b/docs/img/readme/build-banner.png
new file mode 100644
index 0000000000..4de7557a34
Binary files /dev/null and b/docs/img/readme/build-banner.png differ
diff --git a/docs/img/readme/cards/canvases.webp b/docs/img/readme/cards/canvases.webp
new file mode 100644
index 0000000000..21efabaa10
Binary files /dev/null and b/docs/img/readme/cards/canvases.webp differ
diff --git a/docs/img/readme/cards/docs.webp b/docs/img/readme/cards/docs.webp
new file mode 100644
index 0000000000..1014594512
Binary files /dev/null and b/docs/img/readme/cards/docs.webp differ
diff --git a/docs/img/readme/cards/pdf.webp b/docs/img/readme/cards/pdf.webp
new file mode 100644
index 0000000000..b1529b7174
Binary files /dev/null and b/docs/img/readme/cards/pdf.webp differ
diff --git a/docs/img/readme/cards/relational-tables.webp b/docs/img/readme/cards/relational-tables.webp
new file mode 100644
index 0000000000..6c4770712b
Binary files /dev/null and b/docs/img/readme/cards/relational-tables.webp differ
diff --git a/docs/img/readme/cards/sheets.webp b/docs/img/readme/cards/sheets.webp
new file mode 100644
index 0000000000..d51081ffc7
Binary files /dev/null and b/docs/img/readme/cards/sheets.webp differ
diff --git a/docs/img/readme/cards/slides.webp b/docs/img/readme/cards/slides.webp
new file mode 100644
index 0000000000..9e014cd394
Binary files /dev/null and b/docs/img/readme/cards/slides.webp differ
diff --git a/docs/img/readme/cards/universe.webp b/docs/img/readme/cards/universe.webp
new file mode 100644
index 0000000000..20c82ca1c3
Binary files /dev/null and b/docs/img/readme/cards/universe.webp differ
diff --git a/docs/img/readme/cards/web-app.webp b/docs/img/readme/cards/web-app.webp
new file mode 100644
index 0000000000..24c58ebc58
Binary files /dev/null and b/docs/img/readme/cards/web-app.webp differ
diff --git a/docs/img/readme/ecosystem-banner.png b/docs/img/readme/ecosystem-banner.png
new file mode 100644
index 0000000000..5e3c155a15
Binary files /dev/null and b/docs/img/readme/ecosystem-banner.png differ
diff --git a/docs/img/readme/hero-banner.png b/docs/img/readme/hero-banner.png
new file mode 100644
index 0000000000..de554b0b00
Binary files /dev/null and b/docs/img/readme/hero-banner.png differ
diff --git a/docs/img/readme/integration-demo.png b/docs/img/readme/integration-demo.png
new file mode 100644
index 0000000000..b3c18fee7f
Binary files /dev/null and b/docs/img/readme/integration-demo.png differ
diff --git a/docs/img/readme/intro-banner.png b/docs/img/readme/intro-banner.png
new file mode 100644
index 0000000000..564791c715
Binary files /dev/null and b/docs/img/readme/intro-banner.png differ
diff --git a/docs/img/readme/sdk-banner.png b/docs/img/readme/sdk-banner.png
new file mode 100644
index 0000000000..4c9a12ae88
Binary files /dev/null and b/docs/img/readme/sdk-banner.png differ
diff --git a/docs/img/readme/web-app.webp b/docs/img/readme/web-app.webp
new file mode 100644
index 0000000000..da007b7313
Binary files /dev/null and b/docs/img/readme/web-app.webp differ
diff --git a/docs/img/readme/workspace.webp b/docs/img/readme/workspace.webp
new file mode 100644
index 0000000000..e92d303fa1
Binary files /dev/null and b/docs/img/readme/workspace.webp differ
diff --git a/docs/img/sheet-architecture.png b/docs/img/sheet-architecture.png
deleted file mode 100644
index 26a9daef99..0000000000
Binary files a/docs/img/sheet-architecture.png and /dev/null differ
diff --git a/docs/img/uniscript.png b/docs/img/uniscript.png
deleted file mode 100644
index bf75564264..0000000000
Binary files a/docs/img/uniscript.png and /dev/null differ
diff --git a/docs/img/workspace-mini-app.png b/docs/img/workspace-mini-app.png
deleted file mode 100644
index 0a2c496d88..0000000000
Binary files a/docs/img/workspace-mini-app.png and /dev/null differ
diff --git a/docs/readme/de-DE.md b/docs/readme/de-DE.md
new file mode 100644
index 0000000000..d4631a604d
--- /dev/null
+++ b/docs/readme/de-DE.md
@@ -0,0 +1,912 @@
+<a id="readme-top"></a>
+
+<p align="center"><img src="../../docs/img/readme/hero-banner.png" alt="Univer Office SDK" width="960" /></p>
+
+<h1 align="center">Erstellen Sie Ihr eigenes KI-Büro mit Univer Office SDK.</h1>
+
+<p align="center">Beginnen Sie mit den Open-Source-Versionen von Sheets und Docs und verbinden Sie anschließend Ihre eigene Anwendung oder Ihren Agenten.</p>
+
+<p align="center"><a href="#quick-start">🚀 Schnellstart</a> · <a href="https://docs.univer.ai/">📚 Dokumentation</a> · <a href="https://univer.ai/compare/">⚖️ Funktionsvergleich</a> · <a href="https://univer.ai/">🌐 Website</a> · <a href="https://docs.univer.ai/showcase">🎮 Beispiele</a> · <a href="https://docs.univer.ai/reference/classes/univer">🔧 API-Referenz</a> · <a href="https://docs.univer.ai/blog">📝 Blog</a></p>
+
+<p align="center"><a href="../../README.md">English</a> · <a href="../../docs/readme/fr-FR.md">Français</a> · <strong>Deutsch</strong> · <a href="../../docs/readme/es-ES.md">Español</a> · <a href="../../docs/readme/zh-CN.md">简体中文</a> · <a href="../../docs/readme/zh-TW.md">繁體中文</a> · <a href="../../docs/readme/ja-JP.md">日本語</a> · <a href="../../docs/readme/ko-KR.md">한국어</a></p>
+
+<p align="center">
+ <a href="https://github.com/dream-num/univer/releases"><img src="https://img.shields.io/github/v/release/dream-num/univer?style=flat&amp;labelColor=30363D&amp;color=4F46E5&amp;logo=github&amp;logoColor=white" alt="Release" /></a>
+ <a href="../../LICENSE"><img src="https://img.shields.io/github/license/dream-num/univer?style=flat&amp;labelColor=30363D&amp;color=0F766E" alt="License" /></a>
+ <a href="https://github.com/dream-num/univer/actions/workflows/build-packages.yml"><img src="https://img.shields.io/github/actions/workflow/status/dream-num/univer/build-packages.yml?style=flat&amp;labelColor=30363D" alt="Build" /></a>
+ <a href="https://www.codefactor.io/repository/github/dream-num/univer/overview/dev"><img src="https://www.codefactor.io/repository/github/dream-num/univer/badge/dev?style=flat" alt="CodeFactor" /></a>
+ <a href="https://codecov.io/gh/dream-num/univer"><img src="https://img.shields.io/codecov/c/gh/dream-num/univer?token=aPfyW2pIMN&amp;style=flat&amp;labelColor=30363D" alt="Codecov" /></a>
+</p>
+
+<p align="center">
+ <a href="https://github.com/dream-num/univer"><img src="https://img.shields.io/github/stars/dream-num/univer?style=flat&amp;labelColor=30363D&amp;color=4F46E5" alt="Stars" /></a>
+ <a href="https://github.com/dream-num/univer/graphs/contributors"><img src="https://img.shields.io/github/contributors/dream-num/univer?style=flat&amp;labelColor=30363D&amp;color=4F46E5" alt="Contributors" /></a>
+ <a href="https://github.com/dream-num/univer/issues"><img src="https://img.shields.io/github/issues/dream-num/univer?style=flat&amp;labelColor=30363D&amp;color=4F46E5" alt="Issues" /></a>
+ <a href="https://github.com/dream-num/univer/commits/dev/"><img src="https://img.shields.io/github/last-commit/dream-num/univer?style=flat&amp;labelColor=30363D&amp;color=4F46E5" alt="Last Commit" /></a>
+</p>
+
+<p align="center">
+ <a href="https://discord.gg/z3NKNT6D2f"><img src="https://img.shields.io/discord/1136129819961217077?logo=discord&amp;logoColor=FFFFFF&amp;label=discord&amp;color=5865F2&amp;style=flat&amp;labelColor=30363D" alt="Discord" /></a>
+ <a href="https://twitter.com/univerhq"><img src="https://img.shields.io/badge/%40univerhq-18181B?style=flat&amp;logo=x&amp;logoColor=white" alt="X: @univerhq" /></a>
+ <a href="https://opencollective.com/univer"><img src="https://img.shields.io/opencollective/all/univer?logo=opencollective&amp;style=flat&amp;labelColor=30363D&amp;color=0F766E&amp;label=supporters&amp;logoColor=white" alt="Open Collective" /></a>
+</p>
+
+<p align="center">
+ <a href="https://trendshift.io/repositories/4376"><img src="https://trendshift.io/api/badge/repositories/4376" alt="Trendshift" /></a>
+</p>
+
+<details>
+<summary>Inhaltsverzeichnis</summary>
+
+- [💡 Was ist Univer?](#what-is-univer)
+ - [Open-Source-Funktionen](#open-source-capabilities)
+- [🚀 Auf der Open-Source-Grundlage aufbauen](#what-you-can-build)
+ - [Schnellstart: ein Open-Source-Tabelleneditor](#quick-start)
+ - [Ihre Anwendung mit bearbeitbaren Inhalten verbinden](#connect-your-application-to-editable-content)
+- [🏗️ Die Open-Source-Architektur erkunden](#open-source-architecture)
+ - [Eigene Funktionen klar abgrenzen](#give-custom-features-clear-boundaries)
+ - [Funktionsübergreifende Bearbeitung und Rückgängig/Wiederholen kombinieren](#compose-cross-feature-edits-and-undoredo)
+ - [Anwendungen und Agenten über Facade-APIs und Ereignisse verbinden](#connect-applications-and-agents-through-facade-apis-and-events)
+- [🧩 Ihre Anwendung mit Univer Office SDK erweitern](#open-source-and-commercial-extensions)
+ - [Umfang und Lizenzierung](#scope-and-licensing)
+- [🌐 Anwendungsmuster und Ökosystem](#application-patterns-and-ecosystem)
+ - [Univer Workspace: eine Referenzanwendung für Office SDK](#univer-workspace-an-office-sdk-reference-application)
+ - [CLI, Agentenintegrationen und Skills für Entwickler](#cli-agent-integrations-and-developer-skills)
+- [📚 Dokumentation und Beiträge](#documentation-and-contributing)
+ - [Laufzeitkompatibilität](#runtime-compatibility)
+- [💬 Community](#community)
+- [🔒 Sicherheit](#security)
+- [❤️ Sponsoren](#sponsors)
+- [📄 Lizenz](#license)
+
+</details>
+
+<a id="what-is-univer"></a>
+
+## 💡 Was ist Univer?
+
+<p align="center"><img src="../../docs/img/readme/intro-banner.png" alt="Univer Office SDK: Web, Server, and AI SDKs" width="960" /></p>
+
+**Univer** ist ein Office SDK zum Entwickeln von Office-Anwendungen innerhalb Ihres eigenen Produkts. Es bietet Menschen und bestehenden Agenten Funktionen zur Bearbeitung, Berechnung, Zusammenarbeit und Verarbeitung von Office-Dateien und nutzt dabei Ihre Daten und Berechtigungen. Die Produktfamilie umfasst Tabellenkalkulationen, Dokumente, Präsentationen, relationale Tabellen, Zeichenflächen und PDFs.
+
+Univer Office SDK besteht aus drei Teilen:
+
+- **Web SDK** bildet die Grundlage: Inhaltsmodelle, Bearbeitung, Rendering, Formelberechnung und Facade-APIs (APIs für die Anwendungsintegration). Kombinieren Sie seine Plugins zu einem eingebetteten Editor oder Ihrer eigenen Office-Anwendung. Inhaltsmodelle, Befehle und Berechnungen lassen sich auch für die Headless-Verarbeitung ohne interaktiven Editor wiederverwenden.
+- **Server SDK** ergänzt Backend-Dienste für Zusammenarbeit in Echtzeit, Bearbeitungsverläufe sowie den Import und Export von Office-Dateien.
+- **AI SDK** verbindet Office-Funktionen mit bestehenden Agenten und Workflows und bietet dafür Inhaltswerkzeuge sowie Integrationen für Ausführung und Prüfung.
+
+**Dieses Repository stellt die Kernarchitektur und die Engine-Implementierungen des Web SDK unter Apache-2.0 bereit**: Inhaltsmodelle und Snapshot-Formate, Plugin- und Abhängigkeitsverwaltung, das Befehlssystem, Formel- und Rendering-Engines, Facade-APIs, die UI-Grundlage sowie die Bearbeitungsfunktionen von Sheets und Docs. Kommerzielle Web-SDK-Plugins, das Server SDK und kommerzielle AI-SDK-Erweiterungen werden separat vertrieben und lizenziert.
+
+Agenten können dieselben Open-Source-APIs verwenden; Ihre Anwendung stellt das Modell und die Orchestrierung der Werkzeuge bereit. Das [Angebotsbeispiel](#connect-your-application-to-editable-content) zeigt Bearbeitung, Berechnung und Speicherung ohne Abhängigkeit vom AI SDK.
+
+<a id="open-source-capabilities"></a>
+
+### Open-Source-Funktionen
+
+<div align="center" style="overflow-x: auto;">
+
+<table align="center" style="display: table; width: auto; margin-left: auto; margin-right: auto;">
+<thead>
+<tr>
+<th>Bereich</th>
+<th>Ausgewählte Funktionen</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td><strong>Sheets · Bearbeitung und Layout</strong></td>
+<td>Zellstile, verbundene Zellen, Rich Text in Zellen, fixierte Bereiche, frei positionierbare Bilder sowie Rückgängig/Wiederholen.</td>
+</tr>
+<tr>
+<td><strong>Sheets · Daten und Berechnung</strong></td>
+<td>Formeln, definierte Namen, Filter, Sortierung, Datenvalidierung, bedingte Formatierung, Hyperlinks, Kommentare sowie Suchen und Ersetzen.</td>
+</tr>
+<tr>
+<td><strong>Docs</strong></td>
+<td>Rich-Text-Bearbeitung, Absatzformatierung, Listen, Hyperlinks, Kommentare und Zeichnungsintegration.</td>
+</tr>
+</tbody>
+</table>
+
+</div>
+
+Funktionen werden über Plugins und Presets zusammengestellt; der [Schnellstart](#quick-start) verwendet ausschließlich das **Sheets Core Preset**. Bilder benötigen die entsprechenden Zeichnungs-Plugins. Der [Funktionsvergleich](https://univer.ai/compare/) zeigt den genauen Umfang der Open-Source- und kommerziellen Funktionen.
+
+Die folgenden Demos zeigen den größeren Funktionsumfang von **Univer Office SDK**, einschließlich kommerzieller Funktionen. Sie gehen über die standardmäßige Open-Source-Konfiguration hinaus; den jeweiligen Umfang erläutert der Abschnitt [Open Source und kommerzielle Erweiterungen](#open-source-and-commercial-extensions).
+
+<div align="center" style="overflow-x: auto;">
+
+<table align="center" style="display: table; width: auto; margin-left: auto; margin-right: auto;">
+<tbody>
+<tr>
+ <td width="50%"><a href="https://univer.ai/demo/spreadsheets"><img src="../../docs/img/readme/cards/sheets.webp" alt="Sheets — Bearbeitung und Layout · Daten und Berechnung — Demo öffnen" width="420" /></a></td>
+ <td width="50%"><a href="https://univer.ai/demo/docs"><img src="../../docs/img/readme/cards/docs.webp" alt="Docs — Rich-Text-Bearbeitung — Demo öffnen" width="420" /></a></td>
+</tr>
+<tr>
+ <td width="50%"><a href="https://univer.ai/demo/web-app"><img src="../../docs/img/readme/cards/web-app.webp" alt="Web App — Tabellenbasierte Anwendungen — Demo öffnen" width="420" /></a></td>
+ <td width="50%"><a href="https://univer.ai/demo/universe"><img src="../../docs/img/readme/cards/universe.webp" alt="Univer — Kombinierte Office-Inhalte — Demo öffnen" width="420" /></a></td>
+</tr>
+<tr>
+ <td width="50%"><a href="https://univer.ai/demo/slides"><img src="../../docs/img/readme/cards/slides.webp" alt="Slides — Demo öffnen" width="420" /></a></td>
+ <td width="50%"><a href="https://univer.ai/demo/relational-tables"><img src="../../docs/img/readme/cards/relational-tables.webp" alt="Relational Tables — Demo öffnen" width="420" /></a></td>
+</tr>
+<tr>
+ <td width="50%"><a href="https://univer.ai/demo/canvases"><img src="../../docs/img/readme/cards/canvases.webp" alt="Canvases — Demo öffnen" width="420" /></a></td>
+ <td width="50%"><a href="https://univer.ai/demo/pdf"><img src="../../docs/img/readme/cards/pdf.webp" alt="PDF — Demo öffnen" width="420" /></a></td>
+</tr>
+</tbody>
+</table>
+
+</div>
+
+<p align="right"><a href="#readme-top"><img src="https://img.shields.io/badge/%E2%86%91%20Nach%20oben-30363D?style=flat-square" alt="Nach oben" height="20" /></a></p>
+
+<a id="what-you-can-build"></a>
+
+## 🚀 Auf der Open-Source-Grundlage aufbauen
+
+<p align="center"><img src="../../docs/img/readme/build-banner.png" alt="Build on open source" width="960" /></p>
+
+<div align="center" style="overflow-x: auto;">
+
+<table align="center" style="display: table; width: auto; margin-left: auto; margin-right: auto;">
+<thead>
+<tr>
+<th>Ihr Ziel</th>
+<th>Die Open-Source-Grundlage nutzen</th>
+<th>Einstieg</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td><strong>Sheets oder Docs einbetten</strong></td>
+<td>Ergänzen Sie Ihre Anwendung oder Ihr Agentenprodukt um eine bearbeitbare Office-Oberfläche und verbinden Sie Ihre Daten über Facade-APIs.</td>
+<td><a href="#quick-start">Schnellstart</a></td>
+</tr>
+<tr>
+<td><strong>Inhalte ohne Editor verarbeiten</strong></td>
+<td>Verwenden Sie Inhalts-Plugins, Modelle, Befehle und Berechnungen in Node.js für Bearbeitung, Snapshots und automatisierte Aufgaben.</td>
+<td><a href="https://docs.univer.ai/guides/sheets/getting-started/node">Headless-Leitfaden</a></td>
+</tr>
+<tr>
+<td><strong>Eigene Funktionen oder Editoren entwickeln</strong></td>
+<td>Nutzen Sie Engines, UI-Komponenten, Plugin-Grenzen, Dependency Injection sowie Befehls- und Undo-Systeme. Orientieren Sie sich an bestehenden Funktionen, um Sheets und Docs zu erweitern oder eigene Editoren zu entwickeln.</td>
+<td><a href="#open-source-architecture">Open-Source-Architektur</a></td>
+</tr>
+</tbody>
+</table>
+
+</div>
+
+**Bearbeitung und Rückgängig/Wiederholen über Funktionsgrenzen hinweg koordinieren.** Wird eine Zeile innerhalb eines Filterbereichs eingefügt, ändern sich sowohl der Basisinhalt als auch der Filterbereich. Beim Rückgängigmachen müssen beide wiederhergestellt werden. Jede Funktion liefert ihre eigenen Änderungen und Undo-Daten; der Befehl führt deren Ausführung und Verlauf zusammen. Die Architekturübersicht erläutert, wie sich solche Bearbeitungsabläufe erweitern lassen.
+
+<a id="quick-start"></a>
+
+### Schnellstart: ein Open-Source-Tabelleneditor
+
+In einer Browseranwendung mit einem Bundler wie Vite:
+
+```bash
+pnpm add @univerjs/presets @univerjs/preset-sheets-core
+```
+
+Erstellen Sie den Container, bevor Sie Univer initialisieren:
+
+```html
+<div id="app" style="height: 100vh"></div>
+```
+
+```ts
+import { UniverSheetsCorePreset } from '@univerjs/preset-sheets-core'
+import UniverPresetSheetsCoreEnUS from '@univerjs/preset-sheets-core/locales/en-US'
+import { createUniver, LocaleType, mergeLocales } from '@univerjs/presets'
+import '@univerjs/preset-sheets-core/lib/index.css'
+
+const { univerAPI } = createUniver({
+ locale: LocaleType.EN_US,
+ locales: {
+ [LocaleType.EN_US]: mergeLocales(UniverPresetSheetsCoreEnUS),
+ },
+ presets: [
+ UniverSheetsCorePreset({
+ container: 'app',
+ }),
+ ],
+})
+
+univerAPI.createWorkbook({})
+```
+
+Ihre Seite enthält jetzt einen Tabelleneditor. Verwenden Sie das zurückgegebene `univerAPI`, um mit dessen Inhalt zu arbeiten. Dieses Beispiel nutzt Open-Source-Pakete und benötigt weder eine kommerzielle Univer-Lizenz noch das Server SDK.
+
+Bewahren Sie bei Komponenten-Frameworks die von `createUniver` zurückgegebene `univer`-Instanz auf und rufen Sie beim Unmounten der Komponente `univer.dispose()` auf. Siehe [Lebenszyklus-Leitfaden](https://docs.univer.ai/guides/sheets/getting-started/lifecycle).
+
+Presets stellen Plugins zusammen und registrieren deren Facade-APIs. Für die manuelle Steuerung finden Sie unten ein [Plugin-Mode-Beispiel](#manual-plugin-composition). Der [Installationsleitfaden](https://docs.univer.ai/guides/sheets/getting-started/installation) behandelt beide Modi, Peer-Abhängigkeiten und Framework-Integrationen.
+
+Halten Sie zusammengehörige `@univerjs/*`-Pakete auf derselben Version. Kommerzielle Pakete müssen die passende Release-Reihe verwenden; unabhängig veröffentlichte Pakete wie Icons folgen ihren eigenen Kompatibilitätsangaben. Siehe [Richtlinie zur API-Stabilität](../../docs/API_STABILITY.md).
+
+<a id="connect-your-application-to-editable-content"></a>
+
+### Ihre Anwendung mit bearbeitbaren Inhalten verbinden
+
+Facade-APIs bilden die Anwendungsschnittstelle zu Arbeitsmappen, Tabellenblättern und Bereichen. Führen Sie den Schnellstart fort, um ein Angebot auszufüllen, eine Menge aus dem Anwendungscode zu ändern und die neu berechnete Gesamtsumme auszulesen:
+
+```ts
+// Wait for formula controllers before editing a newly created workbook.
+await new Promise<void>((resolve) => {
+ if (univerAPI.getCurrentLifecycleStage() >= univerAPI.Enum.LifecycleStages.Steady) {
+ resolve()
+ return
+ }
+ const listener = univerAPI.addEvent(univerAPI.Event.LifeCycleChanged, ({ stage }) => {
+ if (stage === univerAPI.Enum.LifecycleStages.Steady) {
+ listener.dispose()
+ resolve()
+ }
+ })
+})
+
+const workbook = univerAPI.getActiveWorkbook()!
+const sheet = workbook.getActiveSheet()
+
+sheet.getRange('A1:D4').setValues([
+ ['Item', 'Quantity', 'Unit price', 'Amount'],
+ ['Seats', 2, 25, '=B2*C2'],
+ ['Support', 1, 100, '=B3*C3'],
+ ['Total', '', '', '=SUM(D2:D3)'],
+])
+
+// An application control or agent can make the same edit.
+sheet.getRange('B2').setValue(4)
+
+univerAPI.getFormula().onCalculationResultApplied().then(() => {
+ console.log(sheet.getRange('D4').getValue()) // 200
+ localStorage.setItem('quotation', JSON.stringify(workbook.save()))
+}).catch(console.error)
+```
+
+Editor und Anwendung arbeiten mit derselben Arbeitsmappe; Formeländerungen werden automatisch neu berechnet. `workbook.save()` gibt einen JSON-Snapshot zurück, der die Arbeitsmappe und die Daten ihrer registrierten Plugins enthält. Ihre Anwendung übernimmt die Persistenz; dieses Beispiel nutzt den Browserspeicher. Stellen Sie bei einem späteren Laden der Seite nach der Initialisierung den Snapshot wieder her, **anstatt eine leere Arbeitsmappe zu erstellen**:
+
+```ts
+const saved = localStorage.getItem('quotation')
+if (saved) {
+ univerAPI.createWorkbook(JSON.parse(saved))
+}
+```
+
+Dieser Ablauf verwendet ausschließlich Open-Source-Pakete. Die Snapshot-Persistenz ist vom XLSX-Import und -Export getrennt; Letztere nutzen die separat vertriebenen Dateikonvertierungsfunktionen. Verwenden Sie öffentliche Facade-APIs für die Anwendungsintegration. Die folgenden Quellcodeverweise erläutern die interne Implementierung und die Erweiterungspunkte. Lesen Sie die [Richtlinie zur API-Stabilität](../../docs/API_STABILITY.md), bevor Sie sich auf einen Erweiterungspunkt verlassen.
+
+<a id="manual-plugin-composition"></a>
+
+<details>
+<summary>Fortgeschritten: Plugins manuell zusammenstellen (Plugin Mode)</summary>
+
+Verwenden Sie Plugin Mode, wenn Sie die Auswahl, Abhängigkeiten oder das Laden von Plugins genau steuern müssen. Das obige Preset übernimmt diese Zusammenstellung für Sie.
+
+Diese alternative Initialisierung verwendet denselben `app`-Container und den Browser-Plugin-Stack des Sheets Core Presets ohne Worker. Verwenden Sie sie **anstelle der** Preset-Initialisierung und führen Sie anschließend dasselbe Angebotsbeispiel mit dem zurückgegebenen `univerAPI` aus.
+
+```bash
+pnpm add @univerjs/core @univerjs/design @univerjs/docs @univerjs/docs-ui \
+ @univerjs/engine-formula @univerjs/engine-render @univerjs/network \
+ @univerjs/sheets @univerjs/sheets-ui @univerjs/sheets-formula \
+ @univerjs/sheets-formula-ui @univerjs/sheets-numfmt \
+ @univerjs/sheets-numfmt-ui @univerjs/ui
+```
+
+```ts
+import { LocaleType, mergeLocales, Univer } from '@univerjs/core'
+import { FUniver } from '@univerjs/core/facade'
+import DesignEnUS from '@univerjs/design/locale/en-US'
+import { UniverDocsPlugin } from '@univerjs/docs'
+import { UniverDocsUIPlugin } from '@univerjs/docs-ui'
+import DocsUIEnUS from '@univerjs/docs-ui/locale/en-US'
+import { UniverFormulaEnginePlugin } from '@univerjs/engine-formula'
+import FormulaEnUS from '@univerjs/engine-formula/locale/en-US'
+import { UniverRenderEnginePlugin } from '@univerjs/engine-render'
+import { UniverNetworkPlugin } from '@univerjs/network'
+import { UniverSheetsPlugin } from '@univerjs/sheets'
+import SheetsEnUS from '@univerjs/sheets/locale/en-US'
+import { UniverSheetsFormulaPlugin } from '@univerjs/sheets-formula'
+import SheetsFormulaEnUS from '@univerjs/sheets-formula/locale/en-US'
+import { UniverSheetsFormulaUIPlugin } from '@univerjs/sheets-formula-ui'
+import SheetsFormulaUIEnUS from '@univerjs/sheets-formula-ui/locale/en-US'
+import { UniverSheetsNumfmtPlugin } from '@univerjs/sheets-numfmt'
+import { UniverSheetsNumfmtUIPlugin } from '@univerjs/sheets-numfmt-ui'
+import SheetsNumfmtUIEnUS from '@univerjs/sheets-numfmt-ui/locale/en-US'
+import { UniverSheetsUIPlugin } from '@univerjs/sheets-ui'
+import SheetsUIEnUS from '@univerjs/sheets-ui/locale/en-US'
+import { UniverUIPlugin } from '@univerjs/ui'
+import UIEnUS from '@univerjs/ui/locale/en-US'
+import '@univerjs/design/lib/index.css'
+import '@univerjs/ui/lib/index.css'
+import '@univerjs/docs-ui/lib/index.css'
+import '@univerjs/sheets-ui/lib/index.css'
+import '@univerjs/sheets-formula-ui/lib/index.css'
+import '@univerjs/sheets-numfmt-ui/lib/index.css'
+import '@univerjs/network/facade'
+import '@univerjs/docs/facade'
+import '@univerjs/docs-ui/facade'
+import '@univerjs/engine-formula/facade'
+import '@univerjs/sheets/facade'
+import '@univerjs/ui/facade'
+import '@univerjs/sheets-ui/facade'
+import '@univerjs/sheets-formula/facade'
+import '@univerjs/sheets-numfmt/facade'
+import '@univerjs/sheets-formula-ui/facade'
+
+const univer = new Univer({
+ locale: LocaleType.EN_US,
+ locales: {
+ [LocaleType.EN_US]: mergeLocales(
+ DesignEnUS,
+ DocsUIEnUS,
+ FormulaEnUS,
+ SheetsEnUS,
+ SheetsFormulaEnUS,
+ SheetsFormulaUIEnUS,
+ SheetsNumfmtUIEnUS,
+ SheetsUIEnUS,
+ UIEnUS,
+ ),
+ },
+})
+
+univer.registerPlugin(UniverNetworkPlugin)
+univer.registerPlugin(UniverDocsPlugin)
+univer.registerPlugin(UniverRenderEnginePlugin)
+univer.registerPlugin(UniverUIPlugin, { container: 'app' })
+univer.registerPlugin(UniverDocsUIPlugin)
+univer.registerPlugin(UniverFormulaEnginePlugin)
+univer.registerPlugin(UniverSheetsPlugin, {
+ onlyRegisterFormulaRelatedMutations: false,
+})
+univer.registerPlugin(UniverSheetsUIPlugin, {
+ protectedRangeShadow: true,
+})
+univer.registerPlugin(UniverSheetsNumfmtPlugin)
+univer.registerPlugin(UniverSheetsNumfmtUIPlugin)
+univer.registerPlugin(UniverSheetsFormulaPlugin)
+univer.registerPlugin(UniverSheetsFormulaUIPlugin)
+
+const univerAPI = FUniver.newAPI(univer)
+univerAPI.createWorkbook({})
+```
+
+Die Docs-Plugins unterstützen die Rich-Text-Bearbeitung in Tabellenkalkulationen. Binden Sie beim Hinzufügen einer Funktion auch die zugehörigen Facade-Erweiterungen, Sprachpakete und UI-Stile ein. Geben Sie `univer` frei, wenn sein Container unmountet wird.
+
+</details>
+
+<p align="right"><a href="#readme-top"><img src="https://img.shields.io/badge/%E2%86%91%20Nach%20oben-30363D?style=flat-square" alt="Nach oben" height="20" /></a></p>
+
+<a id="open-source-architecture"></a>
+
+## 🏗️ Die Open-Source-Architektur erkunden
+
+<p align="center"><img src="../../docs/img/readme/architecture-banner.png" alt="" width="960" /></p>
+
+<a id="give-custom-features-clear-boundaries"></a>
+
+### Eigene Funktionen klar abgrenzen
+
+Univer organisiert Inhaltslogik und UI-Interaktion in getrennten Plugins. Funktions-Plugins verwalten Regeln und Inhaltsänderungen; UI-Plugins stellen die Oberfläche und die Benutzerinteraktionen bereit. Beispielsweise verwaltet `sheets-filter` Filterbereiche und -regeln, während `sheets-filter-ui` Panels, Menüs und Tastenkürzel bereitstellt.
+
+```mermaid
+%%{init: {'htmlLabels': false, 'theme': 'base', 'themeVariables': {'fontFamily': 'Arial, PingFang SC, Microsoft YaHei, sans-serif', 'fontSize': '17px', 'lineColor': '#64748b'}, 'flowchart': {'htmlLabels': false, 'curve': 'linear', 'nodeSpacing': 28, 'rankSpacing': 45, 'padding': 16, 'wrappingWidth': 270}}}%%
+%% A layered overview, not a complete dependency graph.
+%% Group arrows indicate reuse of the layer below; internal arrows show selected dependencies.
+flowchart TD
+ subgraph FEATURES["Feature Plugins"]
+ direction LR
+ FUI["Filter<br/>UI Plugin"]
+ VUI["Data Validation<br/>UI Plugin"]
+ FILTER["Filter Plugin"]
+ VALIDATION["Data Validation Plugin"]
+ FUI --> FILTER
+ VUI --> VALIDATION
+ end
+
+ subgraph PRODUCTS["Product Plugins"]
+ direction LR
+ SUI["Sheets UI Plugin"]
+ SHEETS["Sheets Plugin"]
+ SUI --> SHEETS
+ end
+
+ subgraph FOUNDATION["Core Framework & Plugins"]
+ direction LR
+ UI["UI Plugin"]
+ FORMULA["Formula Engine Plugin"]
+ RENDER["Render Engine Plugin"]
+ CORE["Core"]
+ UI --> RENDER
+ RENDER --> CORE
+ FORMULA --> CORE
+ end
+
+ FEATURES --> PRODUCTS
+ PRODUCTS --> FOUNDATION
+
+ classDef logic fill:#eff6ff,color:#17365f,stroke:#93b4df,stroke-width:1.5px
+ classDef ui fill:#f0fdf4,color:#17543a,stroke:#91c8a7,stroke-width:1.5px
+ classDef shared fill:#f6f7f9,color:#334155,stroke:#bac3ce,stroke-width:1.5px
+ classDef feature fill:#172d50,color:#ffffff,stroke:#172d50
+ class FUI,VUI ui
+ class FILTER,VALIDATION logic
+ class SUI,SHEETS logic
+ class UI,FORMULA,RENDER,CORE shared
+
+ style FEATURES fill:#f7fcf9,stroke:#b5d8c1,color:#17543a
+ style PRODUCTS fill:#f5f9ff,stroke:#b6cbea,color:#17365f
+ style FOUNDATION fill:#fafbfc,stroke:#cbd2dc,color:#334155
+```
+
+**Abbildung 1: drei Plugin-Ebenen.** Funktions-Plugins bauen auf Produkt-Plugins auf, die das Kernframework und seine Plugins wiederverwenden. Gruppenpfeile zeigen Abhängigkeiten von der darunterliegenden Ebene. Core stellt Inhaltsmodelle, Befehle, Dependency Injection und die Lebenszyklusverwaltung bereit. Einige Plugins und Abhängigkeiten sind nicht dargestellt.
+
+Neue Funktionen behalten ihre Regeln in eigenen Plugins und arbeiten über öffentliche Dienste, Befehle und definierte Erweiterungspunkte zusammen. UI-Plugins bauen auf gemeinsamen UI-Diensten und -Komponenten auf.
+
+Abhängigkeiten sind auf zwei Ebenen explizit:
+
+- **Zwischen Plugins:** `DependentOn` deklariert Plugin-Abhängigkeiten zur Laufzeit. Der Plugin-Dienst ordnet sie, und die Lebenszyklusphasen trennen die Registrierung von Abhängigkeiten, die Inhaltsinitialisierung und die UI-Initialisierung.
+- **Innerhalb von Plugins:** Dependency Injection verbindet Controller und Dienste über deklarierte Abhängigkeiten. Unterstützte Überschreibungen ermöglichen es einer Anwendung, eine Implementierung zu ersetzen, einen Plattformdienst anzupassen oder ein Testdouble bereitzustellen. Instanzgebundene Injektoren trennen den Anwendungszustand verschiedener Univer-Instanzen.
+
+Freigebbare Registrierungen ermöglichen außerdem das Aufräumen von Befehlen, Listenern, Komponenten und Icons, wenn ihr Besitzer freigegeben wird.
+
+Das [Filter-Plugin](../../packages/sheets-filter/src/plugin.ts) und sein [UI-Plugin](../../packages/sheets-filter-ui/src/plugin.ts) zeigen diese Grenzen in funktionierendem Code.
+
+<details>
+<summary>Innerhalb einer Funktion: Model, Controller, Service und die UI-Grundlage</summary>
+
+Beim Filtern verantwortet `sheets-filter` die Inhaltslogik und `sheets-filter-ui` die UI-Interaktion. Jedes Modul hat eine klar umrissene Aufgabe.
+
+```mermaid
+%%{init: {'htmlLabels': false, 'theme': 'base', 'themeVariables': {'fontFamily': 'Arial, PingFang SC, Microsoft YaHei, sans-serif', 'fontSize': '17px', 'lineColor': '#64748b'}, 'flowchart': {'htmlLabels': false, 'curve': 'linear', 'nodeSpacing': 28, 'rankSpacing': 45, 'padding': 16, 'wrappingWidth': 270}}}%%
+%% Every arrow means contains. This is code organization, not execution order.
+flowchart LR
+ FEATURE["Filter Feature"]
+ LOGIC["Filter Plugin"]
+ UI["Filter UI Plugin"]
+ MODEL["Model"]
+ SERVICE["Service"]
+ CONTROLLER["Controller"]
+ COMMAND["Command / Mutation"]
+ FACADE["Facade API"]
+ VIEW["View"]
+ UICTRL["UI Controller"]
+ UISERVICE["UI Service"]
+ FEATURE --> LOGIC
+ FEATURE --> UI
+ LOGIC --> MODEL
+ LOGIC --> SERVICE
+ LOGIC --> CONTROLLER
+ LOGIC --> COMMAND
+ LOGIC --> FACADE
+ UI --> VIEW
+ UI --> UICTRL
+ UI --> UISERVICE
+
+ classDef logic fill:#eff6ff,color:#17365f,stroke:#93b4df,stroke-width:1.5px
+ classDef ui fill:#f0fdf4,color:#17543a,stroke:#91c8a7,stroke-width:1.5px
+ classDef shared fill:#f6f7f9,color:#334155,stroke:#bac3ce,stroke-width:1.5px
+ classDef feature fill:#172d50,color:#ffffff,stroke:#172d50
+ class FEATURE feature
+ class LOGIC,MODEL,SERVICE,CONTROLLER,COMMAND,FACADE logic
+ class UI,VIEW,UICTRL,UISERVICE ui
+```
+
+**Abbildung 2: Codeorganisation. Pfeile bedeuten „enthält“.** Beide Plugins können Controllers und Services enthalten: Logik-Controllers koordinieren Inhaltsänderungen und verwandte Funktionen; UI-Controllers verbinden Menüs, Tastenkürzel und Interaktionen, während UI-Services den Panelzustand verwalten. Diese Aufgabenverteilung gibt neuen Funktionen eine einheitliche Struktur für Implementierung und Tests.
+
+Die UI-Grundlage folgt derselben Aufteilung. **`@univerjs/design`** liefert gemeinsame Komponenten und Stile, **`@univerjs/ui`** bietet Dienste für die Arbeitsoberfläche wie Menüs, Tastenkürzel, Panels und Komponentenregistrierung, und **`@univerjs/icons`** liefert Icons. Eine Funktion registriert ihre Komponenten und Icons, ergänzt Menüs und bindet ihr Rendering über diese Erweiterungspunkte ein. Teams können ein Panel oder eine Toolbar-Funktion hinzufügen und dabei die UI-Infrastruktur der Anwendung wiederverwenden. Siehe [UI-Übersicht](https://docs.univer.ai/guides/sheets/ui/overview) und [Komponenten- und Icon-Registrierung](../../packages/sheets-filter-ui/src/controllers/components.controller.ts) des Filter-Plugins.
+
+</details>
+
+<a id="compose-cross-feature-edits-and-undoredo"></a>
+
+### Funktionsübergreifende Bearbeitung und Rückgängig/Wiederholen kombinieren
+
+Wenn beispielsweise Zeilen innerhalb eines Filterbereichs eingefügt werden, liefert das Filter-Plugin die entsprechende Bereichsänderung und die zugehörigen Undo-Daten. Der Zeilenbefehl kombiniert die Basisänderung mit den Änderungen der beteiligten Funktionen, führt sie aus und zeichnet ihre Undo-/Redo-Informationen gemeinsam auf. Die Funktion zum Einfügen von Zeilen kann den gemeinsamen Erweiterungsmechanismus nutzen, während das Filter-Plugin seine Regeln zur Bereichsaktualisierung selbst verantwortet.
+
+Das Befehlssystem unterscheidet drei Arten von Aktionen:
+
+- **Command** orchestriert eine fachliche Aktion und die dafür erforderlichen Änderungen.
+- **Mutation** ändert in einem Snapshot gespeicherte Inhalte mit serialisierbaren Parametern.
+- **Operation** ändert vorübergehenden Zustand, etwa ein geöffnetes Panel oder die Scrollposition.
+
+**Eine gemeinsame Struktur für Rückgängig/Wiederholen.** Für eine rückgängig machbare Bearbeitung liefert die Funktionsimplementierung die vorwärts gerichteten und die entsprechenden inversen Mutationen. Der Command zeichnet sie über `IUndoRedoService` auf. Betrifft eine Aktion mehrere Funktionen, kann der Command deren Änderungen und Undo-Daten in einem einzigen Undo-/Redo-Eintrag zusammenfassen, sodass der Benutzer die vollständige Aktion rückgängig machen und wiederholen kann. Siehe [Befehle erweitern](https://docs.univer.ai/blog/custom-command).
+
+Funktionen müssen weiterhin zusammenarbeiten. **Interceptors und Handler für Referenzbereiche geben dieser Zusammenarbeit einen definierten Ort.** An unterstützten Erweiterungspunkten steuern Plugins Prüfungen oder zugehörige Mutationen bei. Interceptor-Prioritäten bestimmen die Reihenfolge, sofern die API dies vorsieht.
+
+<details>
+<summary>Beispiel: Befehle, Callbacks, Funktionskoordination und Rückgängig/Wiederholen</summary>
+
+```mermaid
+%%{init: {'htmlLabels': false, 'theme': 'base', 'themeVariables': {'fontFamily': 'Arial, PingFang SC, Microsoft YaHei, sans-serif', 'fontSize': '17px', 'lineColor': '#64748b'}, 'flowchart': {'htmlLabels': false, 'curve': 'linear', 'nodeSpacing': 28, 'rankSpacing': 45, 'padding': 16, 'wrappingWidth': 270}}}%%
+%% Simplified insert-row example. A command composes mutations and records undo after success.
+%% Events may also fire for nested command executions; not every callback is drawn.
+flowchart TD
+ BEFORE["Before execution<br/>Inspect or cancel"]
+ CMD["Insert-row Command"]
+ BASE["Row mutations"]
+ EXT["Feature extension points<br/>Filter range changes"]
+ MODEL["Execute combined mutations"]
+ UNDO["Record undo and redo"]
+ AFTER["After execution<br/>Notify listeners"]
+ BEFORE --> CMD
+ CMD --> BASE
+ CMD --> EXT
+ BASE --> MODEL
+ EXT --> MODEL
+ MODEL --> UNDO
+ UNDO --> AFTER
+ classDef entry fill:#f6f7f9,color:#334155,stroke:#bac3ce,stroke-width:1.5px
+ classDef core fill:#eff6ff,color:#17365f,stroke:#93b4df,stroke-width:1.5px
+ classDef extension fill:#f0fdf4,color:#17543a,stroke:#91c8a7,stroke-width:1.5px
+ class BEFORE,AFTER entry
+ class CMD,BASE,MODEL,UNDO core
+ class EXT extension
+```
+
+Dieses Diagramm vereinfacht einen Ablauf zum Einfügen von Zeilen. Verschachtelte Befehlsausführungen haben eigene Callbacks; nicht alle Ereignisse und auch der separate Operation-Pfad sind dargestellt. Siehe [Zeilenbefehl](../../packages/sheets/src/commands/commands/insert-row-col.command.ts), [Filter-Controller](../../packages/sheets-filter/src/controllers/sheets-filter.controller.ts) und [Interceptor-Dienst](../../packages/sheets/src/services/sheet-interceptor/sheet-interceptor.service.ts).
+
+</details>
+
+Diese Grenzen ermöglichen eine praktische Teststrategie: Modelle und Dienste unabhängig testen, externe Abhängigkeiten über DI ersetzen und Regressionstests für kombinierte Aktionen sowie Rückgängig/Wiederholen ergänzen. Die [Tests des Filter-Controllers](../../packages/sheets-filter/src/controllers/__tests__/sheets-filter.controller.spec.ts) prüfen Zeilen- und Spaltenänderungen und deren Auswirkungen auf Filter.
+
+<a id="connect-applications-and-agents-through-facade-apis-and-events"></a>
+
+### Anwendungen und Agenten über Facade-APIs und Ereignisse verbinden
+
+Das Repository enthält die Inhaltsmodelle, die Formel-Engine und die Canvas-Rendering- und Layout-Engine hinter den Editoren. Sie bilden gemeinsame Bausteine: Rich Text in Tabellenkalkulationen verwendet beispielsweise das Dokumentlayout und -rendering wieder. Eigene Funktionen können auf diesen Engines aufbauen, anstatt einen separaten Inhaltsstack zu implementieren. Lesen Sie mehr über die [Architektur der Formel-Engine](https://docs.univer.ai/blog/formula) und die [Architektur der Rendering-Engine](https://docs.univer.ai/blog/rendering).
+
+Browsereditoren, Headless-Aufgaben in Node.js und passend zusammengestellte Worker können die entsprechenden Inhalts-Plugins, Modelle, Befehle und Berechnungen wiederverwenden. Siehe [Headless Univer](https://docs.univer.ai/guides/sheets/getting-started/node) und die [isomorphe Architektur](../../docs/ISOMORPHIC.md).
+
+`ICommandService` stellt Ausführungs-Callbacks bereit, mit denen Plugins Befehle vor und nach ihrer Ausführung beobachten können. Facade-APIs kapseln die zugrunde liegenden Funktionen in Anwendungsobjekten wie `FWorkbook`, `FWorksheet` und `FRange`.
+
+Jedes Plugin steuert eigene Facade-Erweiterungen, **typisierte Ereignisse über `univerAPI.Event`** und **Enums über `univerAPI.Enum`** bei. Anwendungscode kann Ereignisnamen und Konstanten über einen zentralen Einstiegspunkt finden, anstatt private Dienste zu importieren oder Zeichenketten zu wiederholen. Beispielsweise kann `BeforeCommandExecute` eine Ausführung prüfen und abbrechen; `CommandExecuted` meldet Ausführungen an Listener. Listener liefern freigebbare Objekte zurück; ein Abbruch ist möglich, wenn das jeweilige Ereignis ihn unterstützt.
+
+Facade-Erweiterungen bleiben in ihren Funktionspaketen, damit eine Inhalts-API keine sachfremden UI-APIs einbinden muss. Siehe [Facade-Design](https://docs.univer.ai/blog/facade), [Befehls-Callbacks und Ereignisbrücke](../../packages/core/src/facade/f-univer.ts) sowie den [Enum-Einstiegspunkt](../../packages/core/src/facade/f-enum.ts).
+
+Das Repository liefert funktionierende Implementierungen und Muster für deren Erweiterung. Die [Erläuterung der Filterimplementierung](https://docs.univer.ai/blog/anatomy) zeigt ein vollständiges Beispiel. Lesen Sie außerdem die [Richtlinie zur API-Stabilität](../../docs/API_STABILITY.md), bevor Sie sich auf einen Erweiterungspunkt verlassen.
+
+<p align="right"><a href="#readme-top"><img src="https://img.shields.io/badge/%E2%86%91%20Nach%20oben-30363D?style=flat-square" alt="Nach oben" height="20" /></a></p>
+
+<a id="open-source-and-commercial-extensions"></a>
+
+## 🧩 Ihre Anwendung mit Univer Office SDK erweitern
+
+<p align="center"><img src="../../docs/img/readme/sdk-banner.png" alt="" width="960" /></p>
+
+Wenn Sie weitere direkt integrierbare Funktionen benötigen, kombinieren Sie die entsprechenden Module von **Univer Office SDK**: zusätzliche Inhaltstypen, erweiterte Bearbeitungs-Plugins, Zusammenarbeit, Dateikonvertierung und Agentenwerkzeuge. Sie erweitern dieselben Inhaltsmodelle, dieselbe Plugin-Architektur, dasselbe Befehlssystem und dasselbe Facade-Design wie oben beschrieben. So können Sie auf Ihrer bestehenden Integration aufbauen.
+
+<div align="center" style="overflow-x: auto;">
+
+<table align="center" style="display: table; width: auto; margin-left: auto; margin-right: auto;">
+<thead>
+<tr>
+<th>Bestandteil</th>
+<th>Erweiterung der Grundlage</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td><strong>Open-Source-Kern des Web SDK · dieses Repository</strong></td>
+<td>Offene Modelle, Engines, Plugins, UI-Grundlagen sowie Sheets- und Docs-Funktionen mit den entsprechenden Headless-Inhaltsoperationen. Unter Apache-2.0 in kommerziellen Anwendungen nutzbar.</td>
+</tr>
+<tr>
+<td><strong>Kommerzielle Web-SDK-Plugins</strong></td>
+<td>Folgen den Mustern des Kerns für Plugins, Dependency Injection, Command/Mutation und Facade-Erweiterungen. Ergänzen Diagramme, Formen, Pivot-Tabellen, SmartArt und weitere Funktionen für die jeweiligen Inhaltstypen.</td>
+</tr>
+<tr>
+<td><strong>Server SDK</strong></td>
+<td>Erweitert dieselben Inhaltsmodelle und Mutationskonventionen um Zusammenarbeit in Echtzeit, Revisionsverläufe und Office-Dateikonvertierung. Integriert sich in Identität, Berechtigungen und Speicherung Ihrer Anwendung.</td>
+</tr>
+<tr>
+<td><strong>AI-SDK-Erweiterungen</strong></td>
+<td>Verwenden die Headless- und Facade-Funktionen des Web SDK für kombinierbare Node.js-APIs und CLI-Bausteine. Damit können Agenten Inhalte untersuchen, bearbeiten und prüfen, einschließlich Integrationen für Zusammenarbeit und Worktree-Prüfungen.</td>
+</tr>
+</tbody>
+</table>
+
+</div>
+
+<a id="scope-and-licensing"></a>
+
+### Umfang und Lizenzierung
+
+- **Dieses Repository:** Apache-2.0-Pakete, die unter dieser Lizenz in kommerziellen Anwendungen verwendet werden können, einschließlich der offenen Headless-Inhaltsfunktionen.
+- **Kommerzielle Erweiterungen:** Kommerzielle Web-SDK-Plugins, das Server SDK und AI-SDK-Funktionen über die Open-Source-Grundlage hinaus werden separat vertrieben und lizenziert. Die **Freemium**-Evaluierung enthält Wasserzeichen und Funktionseinschränkungen.
+- **Referenzanwendungen:** Open-Source-Anwendungen wie Univer Workspace haben eigene Quellcodelizenzen. Ihre SDK-Abhängigkeiten behalten die jeweiligen Lizenzen.
+
+Der [Funktionsvergleich](https://univer.ai/compare/) mit dem Filter **Open source only** zeigt den genauen Umfang. Kommerzielle Optionen finden Sie unter [Tarife und Lizenzierung](https://univer.ai/pricing/).
+
+<details>
+<summary>Wie gemeinsame Inhaltsmodelle Bearbeitung, Zusammenarbeit und Dateien verbinden</summary>
+
+Diese Funktionen arbeiten mit serialisierbaren **Unit-Snapshots**, darunter `IWorkbookData` für Sheets, `IDocumentData` für Docs, `ISlideData` für Slides und `IBoardData` für Zeichenflächen (in der API **Boards** genannt). Diese Typen stammen aus dem Kern und den jeweiligen Produktpaketen. Die aktuellen Slides- und Boards-Funktionen sind separat vertriebene kommerzielle Produkte. Gemeinsame Unit-Konventionen ermöglichen Browsereditoren, Backend-Diensten und Agenten die Arbeit mit denselben Inhalten.
+
+Befehle orchestrieren Bearbeitungen; **Mutations beschreiben Inhaltsänderungen**. Die Zusammenarbeit bündelt diese Mutationen in **Changesets**, wendet **Operational Transformation (OT)** auf gleichzeitige Änderungen an und verwaltet bestätigte Revisionen und Snapshots. Der Verlauf kann eine Revision aus einem Snapshot und den nachfolgenden Changesets rekonstruieren. Lesen Sie das [Design der Zusammenarbeit](https://docs.univer.ai/blog/ot) und die [Übersicht zum Collaboration SDK](https://docs.univer.ai/server/collaboration/overview).
+
+**Exchange** bildet Office-Dateistrukturen auf Univer-Inhaltssnapshots ab und umgekehrt. Für OOXML-Formate wie **XLSX, DOCX und PPTX** liest es die Datei in die entsprechenden Sheet-, Doc- oder Slide-Daten ein und erzeugt beim Export die Dateidarstellung. Die konvertierten Inhalte können dieselben Abläufe für Bearbeitung, Berechnung, Zusammenarbeit und Agenten durchlaufen. Siehe [Import und Export von Office-Dateien](https://docs.univer.ai/server/import-export/node).
+
+</details>
+
+<details>
+<summary>Wie das AI SDK Agenten dieselben Inhaltsfunktionen bereitstellt</summary>
+
+Das AI SDK baut auf den **Headless-Inhaltsmodellen, Befehlen, Berechnungen und Facade-APIs** des Web SDK auf. Es stellt strukturierte TypeScript-APIs und optionale Commander-Presets bereit, die Anwendungen zu einer eigenen Office-CLI oder zu Agentenwerkzeugen zusammenstellen können.
+
+- **Verstehen, entdecken und bearbeiten.** Die Inspektion liefert strukturierte Inhalte. API Reference hilft dem Agenten, die mit seinem SDK ausgelieferten Facade-Symbole und -Signaturen zu finden. Die Facade-Ausführung unterscheidet Lese- und Schreibmodi, erfasst Mutationen und arbeitet mit expliziter Synchronisierung und Commit-Ergebnissen. Siehe [Inhaltsoperationen](https://docs.univer.ai/ai/content-operations).
+- **Das gerenderte Ergebnis prüfen.** Eine Render Runtime im Browser verwendet das Rendering des Web SDK für Screenshots. Die Layoutprüfung von Folien liefert strukturierte Befunde zu Problemen wie Text außerhalb der Seite oder überlappenden Texten und gibt dem Agenten damit eine Grundlage für einen weiteren Bearbeitungsdurchgang. Siehe [visuelle Prüfung](https://docs.univer.ai/ai/visual-inspection).
+- **Entwürfe zur menschlichen Prüfung bearbeiten.** Mit den entsprechenden Funktionen für Zusammenarbeit und Web können Agenten einen isolierten Worktree-Entwurf über mehrere Runden bearbeiten und prüfen und ihn anschließend einem Menschen zum Prüfen, Zusammenführen oder erneuten Öffnen übergeben. Der Ablauf verwendet dieselben Snapshot-, Mutations- und Revisionskonventionen. Siehe [Worktree](https://docs.univer.ai/ai/worktree).
+
+Bei wiederholten Aufrufen verwenden optionale [Worker-Pools und ein Daemon](https://docs.univer.ai/ai/runtime-architecture) bereits geladene Inhaltsinstanzen erneut und reduzieren wiederholte Initialisierungen. Ihre Anwendung verantwortet die übergeordnete CLI, Ziele, Autorisierung und Ausgabe. Wählen Sie im [Paketkatalog des AI SDK](https://docs.univer.ai/ai/packages) die benötigten Funktionen aus.
+
+</details>
+
+<p align="right"><a href="#readme-top"><img src="https://img.shields.io/badge/%E2%86%91%20Nach%20oben-30363D?style=flat-square" alt="Nach oben" height="20" /></a></p>
+
+<a id="application-patterns-and-ecosystem"></a>
+
+## 🌐 Anwendungsmuster und Ökosystem
+
+<p align="center"><img src="../../docs/img/readme/ecosystem-banner.png" alt="" width="960" /></p>
+
+<a id="univer-workspace-an-office-sdk-reference-application"></a>
+
+### Univer Workspace: eine Referenzanwendung für Office SDK
+
+Eine vollständige Referenzanwendung finden Sie in [Univer Workspace](https://github.com/dream-num/univer-workspace). Sie zeigt, wie sich die Editoren von Univer Office SDK, Zusammenarbeit, Dateifunktionen, bestehende Agenten und menschliche Prüfung zu einem selbst hostbaren Arbeitsbereich kombinieren lassen. Orientieren Sie sich beim Aufbau Ihrer eigenen Office-Anwendung oder Ihres Agentenarbeitsbereichs an diesen Integrationsmustern.
+
+<div align="center" style="overflow-x: auto;">
+
+<table align="center" style="display: table; width: auto; margin-left: auto; margin-right: auto;">
+ <tr>
+ <td width="50%" valign="top">
+ <a href="https://space.univer.ai/"><img src="../../docs/img/readme/workspace.webp" alt="Eine bearbeitbare Budgettabelle in Univer Workspace" width="420" /></a>
+ </td>
+ <td width="50%" valign="top">
+ <a href="https://univer.ai/demo/web-app"><img src="../../docs/img/readme/web-app.webp" alt="Eine Web App mit Reglern für Annahmen neben der verbundenen bearbeitbaren Tabelle" width="420" /></a>
+ </td>
+ </tr>
+ <tr>
+ <td width="50%" valign="top">
+ <strong>Agenten und bearbeitbare Office-Inhalte</strong><br />
+ Gespräche, Tabellenbearbeitung und Office-Inhalte in einem Arbeitsbereich vereinen.<br />
+ <a href="https://space.univer.ai/">Workspace ausprobieren</a> · <a href="https://github.com/dream-num/univer-workspace">Workspace-Quellcode und Einrichtung</a>
+ </td>
+ <td width="50%" valign="top">
+ <strong>Web App × Sheet · Experimentell</strong><br />
+ Steuerelemente mit Zellen verbinden: Die App schreibt in die Tabelle, und Tabellenänderungen aktualisieren die App.<br />
+ <a href="https://univer.ai/demo/web-app">Demo der tabellenbasierten App ausprobieren</a>
+ </td>
+ </tr>
+</table>
+
+</div>
+
+Workspace ist Open Source; seine SDK-Abhängigkeiten unterliegen ihren jeweiligen Lizenzen. Die [Workspace-Übersicht](https://univer.ai/workspace/) erläutert verbundene Anwendungen und Prüfabläufe.
+
+<p align="center"><a href="https://www.youtube.com/watch?v=1p-SMEiK6Kg"><img src="../../docs/img/readme/integration-demo.png" alt="Demo zur SDK-Integration ansehen" width="720" /></a></p>
+
+[Demo zur SDK-Integration ansehen](https://www.youtube.com/watch?v=1p-SMEiK6Kg)
+
+<a id="cli-agent-integrations-and-developer-skills"></a>
+
+### CLI, Agentenintegrationen und Skills für Entwickler
+
+Dieselben SDK-Funktionen lassen sich auch in die Agenten und Werkzeuge einbinden, die Sie bereits nutzen:
+
+<div align="center" style="overflow-x: auto;">
+
+<table align="center" style="display: table; width: auto; margin-left: auto; margin-right: auto;">
+<thead>
+<tr>
+<th>Projekt</th>
+<th>Bereitgestellte Funktionen</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td><a href="https://github.com/dream-num/univer-cli">Univer CLI</a></td>
+<td>Ein lokaler Arbeitsbereich über die Kommandozeile zum Erstellen, Bearbeiten, Untersuchen und Bereitstellen von Office-Inhalten.</td>
+</tr>
+<tr>
+<td><a href="https://github.com/dream-num/dsh-univer-office">Univer Office for DeepSeek Harness</a></td>
+<td>Verknüpfte Inhalte, Ergebnisprüfung, versionierte Änderungen und isolierte Zusammenarbeit mit Worktrees.</td>
+</tr>
+<tr>
+<td><a href="https://github.com/dream-num/workbuddy-univer-office">Univer Office for WorkBuddy</a></td>
+<td>Lokale Office-Integration, MCP-Vorschauen und Entwurfsprüfung. Entwicklervorschau.</td>
+</tr>
+<tr>
+<td><a href="https://github.com/dream-num/openclaw-univer-office">Univer Office for OpenClaw</a></td>
+<td>Werkzeuge zum Erstellen, Prüfen und Bereitstellen von Office-Inhalten.</td>
+</tr>
+<tr>
+<td><a href="https://github.com/dream-num/univer-sdk-skills">Univer SDK Skills</a></td>
+<td>Anleitungen, die Coding-Agenten bei der SDK-Integration, Plugin-Entwicklung und Implementierung von Backend-Workflows unterstützen.</td>
+</tr>
+</tbody>
+</table>
+
+</div>
+
+Jedes Repository dokumentiert seine Einrichtung und SDK-Abhängigkeiten. Einstiegspunkte für Agenten finden Sie im [Ökosystem](https://univer.ai/ecosystem/); für eine eigene Integration nutzen Sie die [Dokumentation](https://docs.univer.ai/).
+
+<p align="right"><a href="#readme-top"><img src="https://img.shields.io/badge/%E2%86%91%20Nach%20oben-30363D?style=flat-square" alt="Nach oben" height="20" /></a></p>
+
+<a id="documentation-and-contributing"></a>
+
+## 📚 Dokumentation und Beiträge
+
+Vielen Dank an alle [Mitwirkenden](https://github.com/dream-num/univer/graphs/contributors), die Univer entwickeln und verbessern. Beiträge zu Engines, Plugins, Tests, Dokumentation und Beispielen sind willkommen.
+
+<p align="center"><a href="https://docs.univer.ai/guides/sheets">🧩 Web SDK</a> · <a href="https://docs.univer.ai/server">🖥️ Server SDK</a> · <a href="https://docs.univer.ai/ai">🤖 AI SDK</a> · <a href="https://docs.univer.ai/reference/classes/univer">🔧 API-Referenz</a> · <a href="https://office.univer.ai/">🎮 Live-Demo</a></p>
+
+<div align="center" style="overflow-x: auto;">
+
+<table align="center" style="display: table; width: auto; margin-left: auto; margin-right: auto;">
+ <tr>
+ <th align="center"><img src="https://cdnjs.cloudflare.com/ajax/libs/browser-logos/75.0.1/edge/edge_64x64.png" width="32" height="32" alt="" /><br />Edge</th>
+ <th align="center"><img src="https://cdnjs.cloudflare.com/ajax/libs/browser-logos/75.0.1/firefox/firefox_64x64.png" width="32" height="32" alt="" /><br />Firefox</th>
+ <th align="center"><img src="https://cdnjs.cloudflare.com/ajax/libs/browser-logos/75.0.1/chrome/chrome_64x64.png" width="32" height="32" alt="" /><br />Chrome</th>
+ <th align="center"><img src="https://cdnjs.cloudflare.com/ajax/libs/browser-logos/75.0.1/safari/safari_64x64.png" width="32" height="32" alt="" /><br />Safari</th>
+ <th align="center"><img src="https://cdnjs.cloudflare.com/ajax/libs/browser-logos/75.0.1/electron/electron_64x64.png" width="32" height="32" alt="" /><br />Electron</th>
+ </tr>
+ <tr>
+ <td align="center"><code>&gt;=88</code></td>
+ <td align="center"><code>&gt;=90</code></td>
+ <td align="center"><code>&gt;=88</code></td>
+ <td align="center"><code>&gt;=14.1</code></td>
+ <td align="center"><code>&gt;=12</code></td>
+ </tr>
+</table>
+
+</div>
+
+<p align="center">Univer wird mit Chrome 88 als Ziel kompiliert und strebt Kompatibilität mit den oben aufgeführten Versionen an.</p>
+
+<a id="runtime-compatibility"></a>
+
+### Laufzeitkompatibilität
+
+- **Polyfills**: Univer benötigt `Intl.Segmenter`. Ergänzen Sie einen Polyfill wie `@formatjs/intl-segmenter`, wenn Ihr Zielbrowser oder Ihre Laufzeit diese Funktion nicht bereitstellt.
+- **Build-Werkzeuge**: Wir empfehlen Vite, esbuild oder Webpack 5. Wenn Ihr Build-Werkzeug das Feld `exports` in `package.json` nicht unterstützt, wie häufig bei Webpack 4, können zusätzliche Pfadzuordnungen erforderlich sein.
+- **React**: Die Ansichtsschicht von Univer basiert auf React 18, unterstützt React 18 und 19 und bietet minimale Kompatibilitätsunterstützung für React 16.9+ und 17.
+- **Node.js-Laufzeit**: Headless Univer unterstützt Node.js `>=18.17.0`. Die Entwicklung dieses Monorepos erfordert Node.js `>=22.18`.
+
+<details>
+<summary>Entwicklung in diesem Repository</summary>
+
+### Repository-Struktur
+
+```text
+.
+├── packages/ Core packages, engines, document types, UI plugins, and feature plugins
+├── examples/ All-in-one Vite workbench used for local browser development
+├── common/ Shared internal tooling, storybook, and utilities
+├── tests/ Additional integration test projects
+└── docs/ Architecture notes, images, and repository-local documentation
+```
+
+Die README-Dateien der einzelnen Pakete liegen jeweils beim Paket unter [`packages/`](../../packages).
+
+### Lokale Entwicklung
+
+Voraussetzungen:
+
+- Node.js `>=22.18`
+- pnpm: Verwenden Sie die in `packageManager` in `package.json` angegebene Version.
+
+```bash
+git clone https://github.com/dream-num/univer.git
+cd univer
+pnpm install
+pnpm dev
+```
+
+Nützliche Befehle:
+
+<div align="center" style="overflow-x: auto;">
+
+<table align="center" style="display: table; width: auto; margin-left: auto; margin-right: auto;">
+<thead>
+<tr>
+<th>Befehl</th>
+<th>Zweck</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td><code class="notranslate">pnpm dev</code></td>
+<td>Die Entwicklungsumgebung für Sheets und Docs starten.</td>
+</tr>
+<tr>
+<td><code class="notranslate">pnpm build</code></td>
+<td>Workspace-Pakete mit Ausnahme der internen common-Pakete bauen.</td>
+</tr>
+<tr>
+<td><code class="notranslate">pnpm test</code></td>
+<td>Unit-Tests über Turbo ausführen.</td>
+</tr>
+<tr>
+<td><code class="notranslate">pnpm typecheck</code></td>
+<td>TypeScript-Prüfungen über Turbo ausführen.</td>
+</tr>
+<tr>
+<td><code class="notranslate">pnpm lint</code></td>
+<td>ESLint ausführen.</td>
+</tr>
+<tr>
+<td><code class="notranslate">pnpm storybook:dev</code></td>
+<td>Storybook für die Entwicklung von UI-Komponenten starten.</td>
+</tr>
+</tbody>
+</table>
+
+</div>
+
+Lesen Sie [CONTRIBUTING.md](../../CONTRIBUTING.md), bevor Sie einen Pull Request eröffnen.
+
+</details>
+
+<details>
+<summary>Referenzen zur Architektur und Mitarbeit</summary>
+
+- [Repository-Pakete](../../packages), [Presets](../../presets) und [Beispiele](../../examples).
+- [Isomorphes Univer entwickeln](../../docs/ISOMORPHIC.md).
+- [Zur Facade API beitragen](../../docs/CONTRIBUTING-FACADE.md).
+- [Richtlinie zur API-Stabilität](../../docs/API_STABILITY.md).
+- [Namenskonventionen](../../docs/NAMING_CONVENTION.md) und [Speicherlecks beheben](../../docs/FIX_MEMORY_LEAK.md).
+- [Architektur-Kurzfassungen](../../docs/tldr) und [Hinweise zu OLE-Anhängen](../../packages/drawing/docs/ole-attachments.md).
+
+</details>
+
+<p align="right"><a href="#readme-top"><img src="https://img.shields.io/badge/%E2%86%91%20Nach%20oben-30363D?style=flat-square" alt="Nach oben" height="20" /></a></p>
+
+<a id="community"></a>
+
+## 💬 Community
+
+Stellen Sie Fragen in [GitHub Discussions](https://github.com/dream-num/univer/discussions), treten Sie [Discord](https://discord.gg/z3NKNT6D2f) bei und folgen Sie uns auf [X](https://twitter.com/univerhq) oder [YouTube](https://www.youtube.com/@dreamNum). Bitte lesen Sie den [Verhaltenskodex](../../CODE_OF_CONDUCT.md).
+
+<p align="right"><a href="#readme-top"><img src="https://img.shields.io/badge/%E2%86%91%20Nach%20oben-30363D?style=flat-square" alt="Nach oben" height="20" /></a></p>
+
+<a id="security"></a>
+
+## 🔒 Sicherheit
+
+Wenn Sie glauben, ein Sicherheitsproblem gefunden zu haben, folgen Sie bitte der [Sicherheitsrichtlinie](../../SECURITY.md).
+
+<p align="right"><a href="#readme-top"><img src="https://img.shields.io/badge/%E2%86%91%20Nach%20oben-30363D?style=flat-square" alt="Nach oben" height="20" /></a></p>
+
+<a id="sponsors"></a>
+
+## ❤️ Sponsoren
+
+Univer wird von der Community und Sponsoren unterstützt. Sie können das Projekt über [Open Collective](https://opencollective.com/univer) fördern.
+
+<p>
+ <a href="https://opencollective.com/univer/sponsor/0/website"><img src="https://opencollective.com/univer/sponsor/0/avatar.svg" alt="Sponsor werden" /></a>
+</p>
+
+<p>
+ <a href="https://opencollective.com/univer/backer/0/website"><img src="https://opencollective.com/univer/backer/0/avatar.svg" width="64" height="64" alt="Unterstützer 0" /></a>
+ <a href="https://opencollective.com/univer/backer/1/website"><img src="https://opencollective.com/univer/backer/1/avatar.svg" width="64" height="64" alt="Unterstützer 1" /></a>
+ <a href="https://opencollective.com/univer/backer/2/website"><img src="https://opencollective.com/univer/backer/2/avatar.svg" width="64" height="64" alt="Unterstützer 2" /></a>
+ <a href="https://opencollective.com/univer/backer/3/website"><img src="https://opencollective.com/univer/backer/3/avatar.svg" width="64" height="64" alt="Unterstützer 3" /></a>
+ <a href="https://opencollective.com/univer/backer/4/website"><img src="https://opencollective.com/univer/backer/4/avatar.svg" width="64" height="64" alt="Unterstützer 4" /></a>
+ <a href="https://opencollective.com/univer/backer/5/website"><img src="https://opencollective.com/univer/backer/5/avatar.svg" width="64" height="64" alt="Unterstützer 5" /></a>
+ <a href="https://opencollective.com/univer/backer/6/website"><img src="https://opencollective.com/univer/backer/6/avatar.svg" width="64" height="64" alt="Unterstützer 6" /></a>
+</p>
+
+<p align="right"><a href="#readme-top"><img src="https://img.shields.io/badge/%E2%86%91%20Nach%20oben-30363D?style=flat-square" alt="Nach oben" height="20" /></a></p>
+
+<a id="license"></a>
+
+## 📄 Lizenz
+
+Copyright (c) 2021-present DreamNum Co., Ltd.
+
+Die Open-Source-Pakete dieses Repositorys stehen unter der [Apache-2.0-Lizenz](../../LICENSE). Kommerzielle SDK-Module werden separat vertrieben und lizenziert.
+
+<p align="right"><a href="#readme-top"><img src="https://img.shields.io/badge/%E2%86%91%20Nach%20oben-30363D?style=flat-square" alt="Nach oben" height="20" /></a></p>
diff --git a/docs/readme/es-ES.md b/docs/readme/es-ES.md
index 8f3aa728fd..3c35035a99 100644
--- a/docs/readme/es-ES.md
+++ b/docs/readme/es-ES.md
@@ -1,156 +1,296 @@
-<div align="center">
+<a id="readme-top"></a>
-<img src="../img/banner.png" alt="Univer SDK" width="800" />
+<p align="center"><img src="../../docs/img/readme/hero-banner.png" alt="Univer Office SDK" width="960" /></p>
-**El Office Harness para agentes de IA**
+<h1 align="center">Crea tu propia oficina con IA con Univer Office SDK.</h1>
-Hojas de cálculo · Documentos · Presentaciones · Bases · Boards · PDF
+<p align="center">Empieza con Sheets y Docs de código abierto y conecta tu propia aplicación o agente.</p>
-Office SDK de alto rendimiento y totalmente personalizable
+<p align="center"><a href="#quick-start">🚀 Inicio rápido</a> · <a href="https://docs.univer.ai/">📚 Documentación</a> · <a href="https://univer.ai/compare/">⚖️ Comparación de funciones</a> · <a href="https://univer.ai/">🌐 Sitio web</a> · <a href="https://docs.univer.ai/showcase">🎮 Showcase</a> · <a href="https://docs.univer.ai/reference/classes/univer">🔧 API Reference</a> · <a href="https://docs.univer.ai/blog">📝 Blog</a></p>
-Univer ayuda a crear experiencias de productividad integrables con una arquitectura de plugins,
-renderizado basado en Canvas, un motor de fórmulas y una Facade API que funciona tanto en el navegador como en Node.js.
+<p align="center"><a href="../../README.md">English</a> · <a href="../../docs/readme/fr-FR.md">Français</a> · <a href="../../docs/readme/de-DE.md">Deutsch</a> · <strong>Español</strong> · <a href="../../docs/readme/zh-CN.md">简体中文</a> · <a href="../../docs/readme/zh-TW.md">繁體中文</a> · <a href="../../docs/readme/ja-JP.md">日本語</a> · <a href="../../docs/readme/ko-KR.md">한국어</a></p>
-[English](../../README.md) | [简体中文](./zh-CN.md) | [繁體中文](./zh-TW.md) | [日本語](./ja-JP.md) | [한국어](./ko-KR.md) | Español
+<p align="center">
+ <a href="https://github.com/dream-num/univer/releases"><img src="https://img.shields.io/github/v/release/dream-num/univer?style=flat&amp;labelColor=30363D&amp;color=4F46E5&amp;logo=github&amp;logoColor=white" alt="Release" /></a>
+ <a href="../../LICENSE"><img src="https://img.shields.io/github/license/dream-num/univer?style=flat&amp;labelColor=30363D&amp;color=0F766E" alt="License" /></a>
+ <a href="https://github.com/dream-num/univer/actions/workflows/build-packages.yml"><img src="https://img.shields.io/github/actions/workflow/status/dream-num/univer/build-packages.yml?style=flat&amp;labelColor=30363D" alt="Build" /></a>
+ <a href="https://www.codefactor.io/repository/github/dream-num/univer/overview/dev"><img src="https://www.codefactor.io/repository/github/dream-num/univer/badge/dev?style=flat" alt="CodeFactor" /></a>
+ <a href="https://codecov.io/gh/dream-num/univer"><img src="https://img.shields.io/codecov/c/gh/dream-num/univer?token=aPfyW2pIMN&amp;style=flat&amp;labelColor=30363D" alt="Codecov" /></a>
+</p>
-[🌐 Sitio web](https://univer.ai/) | [📖 Documentación](https://docs.univer.ai) | [✨ Showcase](https://docs.univer.ai/showcase) | [📘 API Reference](https://docs.univer.ai/reference/classes/univer) | [📝 Blog](https://docs.univer.ai/blog)
+<p align="center">
+ <a href="https://github.com/dream-num/univer"><img src="https://img.shields.io/github/stars/dream-num/univer?style=flat&amp;labelColor=30363D&amp;color=4F46E5" alt="Stars" /></a>
+ <a href="https://github.com/dream-num/univer/graphs/contributors"><img src="https://img.shields.io/github/contributors/dream-num/univer?style=flat&amp;labelColor=30363D&amp;color=4F46E5" alt="Contributors" /></a>
+ <a href="https://github.com/dream-num/univer/issues"><img src="https://img.shields.io/github/issues/dream-num/univer?style=flat&amp;labelColor=30363D&amp;color=4F46E5" alt="Issues" /></a>
+ <a href="https://github.com/dream-num/univer/commits/dev/"><img src="https://img.shields.io/github/last-commit/dream-num/univer?style=flat&amp;labelColor=30363D&amp;color=4F46E5" alt="Last Commit" /></a>
+</p>
-[![Release](https://img.shields.io/github/v/release/dream-num/univer?style=flat-square)](https://github.com/dream-num/univer/releases)
-[![License](https://img.shields.io/github/license/dream-num/univer?style=flat-square)](../../LICENSE)
-[![Build](https://img.shields.io/github/actions/workflow/status/dream-num/univer/build-packages.yml?style=flat-square)](https://github.com/dream-num/univer/actions/workflows/build-packages.yml)
-[![CodeFactor](https://www.codefactor.io/repository/github/dream-num/univer/badge/dev?style=flat-square)](https://www.codefactor.io/repository/github/dream-num/univer/overview/dev)
-[![Codecov](https://img.shields.io/codecov/c/gh/dream-num/univer?token=aPfyW2pIMN&style=flat-square)](https://codecov.io/gh/dream-num/univer)
+<p align="center">
+ <a href="https://discord.gg/z3NKNT6D2f"><img src="https://img.shields.io/discord/1136129819961217077?logo=discord&amp;logoColor=FFFFFF&amp;label=discord&amp;color=5865F2&amp;style=flat&amp;labelColor=30363D" alt="Discord" /></a>
+ <a href="https://twitter.com/univerhq"><img src="https://img.shields.io/badge/%40univerhq-18181B?style=flat&amp;logo=x&amp;logoColor=white" alt="X: @univerhq" /></a>
+ <a href="https://opencollective.com/univer"><img src="https://img.shields.io/opencollective/all/univer?logo=opencollective&amp;style=flat&amp;labelColor=30363D&amp;color=0F766E&amp;label=supporters&amp;logoColor=white" alt="Open Collective" /></a>
+</p>
-[![Stars](https://img.shields.io/github/stars/dream-num/univer?style=flat-square)](https://github.com/dream-num/univer/stargazers)
-[![Contributors](https://img.shields.io/github/contributors/dream-num/univer?style=flat-square)](https://github.com/dream-num/univer/graphs/contributors)
-[![Issues](https://img.shields.io/github/issues/dream-num/univer?style=flat-square)](https://github.com/dream-num/univer/issues)
-[![Last Commit](https://img.shields.io/github/last-commit/dream-num/univer?style=flat-square)](https://github.com/dream-num/univer/commits/dev/)
+<p align="center">
+ <a href="https://trendshift.io/repositories/4376"><img src="https://trendshift.io/api/badge/repositories/4376" alt="Trendshift" /></a>
+</p>
-[![Discord](https://img.shields.io/discord/1136129819961217077?logo=discord&logoColor=FFFFFF&label=discord&color=5865F2&style=flat-square)](https://discord.gg/z3NKNT6D2f)
-[![Twitter](https://img.shields.io/twitter/follow/univerhq?style=flat-square&logo=x)](https://twitter.com/univerhq)
-[![Open Collective](https://img.shields.io/opencollective/all/univer?logo=opencollective&style=flat-square)](https://opencollective.com/univer)
+<details>
+<summary>Índice</summary>
+
+- [💡 ¿Qué es Univer?](#what-is-univer)
+ - [Capacidades de código abierto](#open-source-capabilities)
+- [🚀 Construye sobre la base de código abierto](#what-you-can-build)
+ - [Inicio rápido: un editor de hojas de cálculo de código abierto](#quick-start)
+ - [Conecta tu aplicación al contenido editable](#connect-your-application-to-editable-content)
+- [🏗️ Explora la arquitectura de código abierto](#open-source-architecture)
+ - [Define límites claros para las funciones personalizadas](#give-custom-features-clear-boundaries)
+ - [Combina ediciones y deshacer/rehacer entre funciones](#compose-cross-feature-edits-and-undoredo)
+ - [Conecta aplicaciones y agentes mediante APIs Facade y eventos](#connect-applications-and-agents-through-facade-apis-and-events)
+- [🧩 Amplía tu aplicación con Univer Office SDK](#open-source-and-commercial-extensions)
+ - [Alcance y licencias](#scope-and-licensing)
+- [🌐 Patrones de aplicación y ecosistema](#application-patterns-and-ecosystem)
+ - [Univer Workspace: una aplicación de referencia de Office SDK](#univer-workspace-an-office-sdk-reference-application)
+ - [CLI, integraciones de agentes y skills para desarrolladores](#cli-agent-integrations-and-developer-skills)
+- [📚 Documentación y contribuciones](#documentation-and-contributing)
+ - [Compatibilidad en tiempo de ejecución](#runtime-compatibility)
+- [💬 Comunidad](#community)
+- [🔒 Seguridad](#security)
+- [❤️ Patrocinadores](#sponsors)
+- [📄 Licencia](#license)
+
+</details>
+
+<a id="what-is-univer"></a>
+
+## 💡 ¿Qué es Univer?
+
+<p align="center"><img src="../../docs/img/readme/intro-banner.png" alt="Univer Office SDK: Web, Server, and AI SDKs" width="960" /></p>
+
+**Univer** es un SDK de ofimática para crear aplicaciones de oficina dentro de tu propio producto. Ofrece edición, cálculo, colaboración y procesamiento de archivos de Office para personas y agentes existentes, con tus datos y permisos. La familia de productos abarca hojas de cálculo, documentos, presentaciones, tablas relacionales, lienzos y PDF.
+
+Univer Office SDK consta de tres partes:
+
+- **Web SDK** es la base: modelos de contenido, edición, renderizado, cálculo de fórmulas y APIs Facade (APIs orientadas a la aplicación). Combina sus plugins en un editor integrado o en tu propia aplicación de oficina y reutiliza los modelos de contenido, los comandos y el cálculo para el procesamiento Headless sin un editor interactivo.
+- **Server SDK** añade servicios de backend para colaboración en tiempo real, historial de edición e importación y exportación de archivos de Office.
+- **AI SDK** conecta las capacidades de Office con agentes y flujos de trabajo existentes mediante herramientas de contenido e integraciones de ejecución y revisión.
+
+**Este repositorio proporciona la arquitectura central y las implementaciones de los motores de Web SDK bajo Apache-2.0**: modelos de contenido y formatos de instantáneas, gestión de plugins y dependencias, sistema de comandos, motores de fórmulas y renderizado, APIs Facade, infraestructura de UI y capacidades de edición de Sheets y Docs. Los plugins comerciales de Web SDK, Server SDK y las extensiones comerciales de AI SDK se distribuyen y licencian por separado.
+
+Los agentes pueden utilizar las mismas APIs de código abierto; tu aplicación aporta el modelo y la orquestación de herramientas. El [ejemplo de presupuesto](#connect-your-application-to-editable-content) muestra cómo editar, calcular y guardar sin depender de AI SDK.
+
+<a id="open-source-capabilities"></a>
+
+### Capacidades de código abierto
-[![Trendshift](https://trendshift.io/api/badge/repositories/4376)](https://trendshift.io/repositories/4376)
+<div align="center" style="overflow-x: auto;">
+
+<table align="center" style="display: table; width: auto; margin-left: auto; margin-right: auto;">
+<thead>
+<tr>
+<th>Área</th>
+<th>Capacidades seleccionadas</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td><strong>Sheets · Edición y diseño</strong></td>
+<td>Estilos de celda, celdas combinadas, texto enriquecido en celdas, paneles inmovilizados, imágenes flotantes y deshacer/rehacer.</td>
+</tr>
+<tr>
+<td><strong>Sheets · Datos y cálculo</strong></td>
+<td>Fórmulas, nombres definidos, filtrado, ordenación, validación de datos, formato condicional, hipervínculos, comentarios y búsqueda y reemplazo.</td>
+</tr>
+<tr>
+<td><strong>Docs</strong></td>
+<td>Edición de texto enriquecido, formato de párrafos, listas, hipervínculos, comentarios e integración de dibujos.</td>
+</tr>
+</tbody>
+</table>
</div>
-## ✨ ¿Qué es Univer?
+Las funciones se componen mediante plugins y presets; el [inicio rápido](#quick-start) utiliza únicamente el **preset Sheets Core**. Las imágenes requieren los plugins de dibujo correspondientes. Consulta la [comparación de funciones](https://univer.ai/compare/) para conocer la cobertura detallada de las opciones de código abierto y comerciales.
+
+Las demos siguientes muestran el conjunto más amplio de **Univer Office SDK**, incluidas capacidades comerciales. Van más allá de la configuración de código abierto predeterminada; consulta el alcance en [código abierto y extensiones comerciales](#open-source-and-commercial-extensions).
+
+<div align="center" style="overflow-x: auto;">
+
+<table align="center" style="display: table; width: auto; margin-left: auto; margin-right: auto;">
+<tbody>
+<tr>
+ <td width="50%"><a href="https://univer.ai/demo/spreadsheets"><img src="../../docs/img/readme/cards/sheets.webp" alt="Sheets — Edición y diseño · Datos y cálculo — Abrir demo" width="420" /></a></td>
+ <td width="50%"><a href="https://univer.ai/demo/docs"><img src="../../docs/img/readme/cards/docs.webp" alt="Docs — Edición de texto enriquecido — Abrir demo" width="420" /></a></td>
+</tr>
+<tr>
+ <td width="50%"><a href="https://univer.ai/demo/web-app"><img src="../../docs/img/readme/cards/web-app.webp" alt="Web App — Aplicaciones basadas en hojas — Abrir demo" width="420" /></a></td>
+ <td width="50%"><a href="https://univer.ai/demo/universe"><img src="../../docs/img/readme/cards/universe.webp" alt="Univer — Contenido de Office compuesto — Abrir demo" width="420" /></a></td>
+</tr>
+<tr>
+ <td width="50%"><a href="https://univer.ai/demo/slides"><img src="../../docs/img/readme/cards/slides.webp" alt="Slides — Abrir demo" width="420" /></a></td>
+ <td width="50%"><a href="https://univer.ai/demo/relational-tables"><img src="../../docs/img/readme/cards/relational-tables.webp" alt="Relational Tables — Abrir demo" width="420" /></a></td>
+</tr>
+<tr>
+ <td width="50%"><a href="https://univer.ai/demo/canvases"><img src="../../docs/img/readme/cards/canvases.webp" alt="Canvases — Abrir demo" width="420" /></a></td>
+ <td width="50%"><a href="https://univer.ai/demo/pdf"><img src="../../docs/img/readme/cards/pdf.webp" alt="PDF — Abrir demo" width="420" /></a></td>
+</tr>
+</tbody>
+</table>
-Univer es un SDK de código abierto para crear aplicaciones ofimáticas dentro de tu propio producto. Proporciona los bloques necesarios para experiencias de hojas de cálculo, documentos y presentaciones sin obligarte a usar una aplicación alojada ni una UI fija.
+</div>
-Usa Univer cuando necesites:
+<p align="right"><a href="#readme-top"><img src="https://img.shields.io/badge/%E2%86%91%20Volver%20arriba-30363D?style=flat-square" alt="Volver arriba" height="20" /></a></p>
+
+<a id="what-you-can-build"></a>
+
+## 🚀 Construye sobre la base de código abierto
+
+<p align="center"><img src="../../docs/img/readme/build-banner.png" alt="Build on open source" width="960" /></p>
+
+<div align="center" style="overflow-x: auto;">
+
+<table align="center" style="display: table; width: auto; margin-left: auto; margin-right: auto;">
+<thead>
+<tr>
+<th>Tu objetivo</th>
+<th>Cómo usar la base de código abierto</th>
+<th>Por dónde empezar</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td><strong>Integrar Sheets o Docs</strong></td>
+<td>Añade una superficie de edición de Office a tu aplicación o producto de agentes y conecta tus datos mediante las APIs Facade.</td>
+<td><a href="#quick-start">Inicio rápido</a></td>
+</tr>
+<tr>
+<td><strong>Procesar contenido sin un editor</strong></td>
+<td>Reutiliza plugins de contenido, modelos, comandos y cálculo en Node.js para editar, trabajar con instantáneas y automatizar tareas.</td>
+<td><a href="https://docs.univer.ai/guides/sheets/getting-started/node">Guía de Headless</a></td>
+</tr>
+<tr>
+<td><strong>Desarrollar funciones o editores personalizados</strong></td>
+<td>Reutiliza los motores, componentes de UI, límites entre plugins, inyección de dependencias y sistemas de comandos y deshacer. Sigue las funciones existentes para ampliar Sheets y Docs o desarrollar tus propios editores.</td>
+<td><a href="#open-source-architecture">Arquitectura de código abierto</a></td>
+</tr>
+</tbody>
+</table>
-- Integrar edición de hojas de cálculo o documentos en un SaaS, herramienta interna, flujo de BI o aplicación de IA.
-- Ejecutar procesamiento de libros/documentos en el servidor con la misma arquitectura que se usa en el navegador.
-- Componer solo las funciones que necesitas mediante plugins o empezar rápido con presets.
-- Extender el comportamiento mediante plugins personalizados, comandos, servicios, componentes de UI y Facade APIs.
+</div>
-Univer no es solo un visor de archivos de hojas de cálculo. Es un framework para crear tu propia superficie de productividad.
+**Coordina las ediciones y deshacer/rehacer entre funciones.** Insertar una fila dentro de un rango de filtro modifica tanto el contenido base como el rango de filtro; deshacer debe restaurar ambos. Cada función aporta sus propios cambios y datos para deshacer, y el comando combina su ejecución e historial. El recorrido por la arquitectura explica cómo ampliar estos flujos de edición.
-En la [familia de productos Univer](https://univer.ai/), las herramientas ofimáticas comparten un entorno de ejecución para almacenamiento y cálculo. El contenido se puede combinar e integrar entre herramientas, y los datos y las referencias vinculados se actualizan junto con sus fuentes. Las personas y los agentes de IA pueden trabajar en los mismos archivos. Consulta la [matriz de capacidades](https://univer.ai/capabilities) para conocer los productos y [Open Source y Pro](#-open-source-y-pro) para conocer el alcance de este repositorio.
+<a id="quick-start"></a>
-### Crea una herramienta colaborativa con Univer Office SDK
+### Inicio rápido: un editor de hojas de cálculo de código abierto
-[![Crea una herramienta colaborativa con Univer Office SDK](https://i.ytimg.com/vi/1p-SMEiK6Kg/maxresdefault.jpg)](https://www.youtube.com/watch?v=1p-SMEiK6Kg)
+En una aplicación de navegador con un empaquetador como Vite:
-[Ver la demo](https://www.youtube.com/watch?v=1p-SMEiK6Kg)
+```bash
+pnpm add @univerjs/presets @univerjs/preset-sheets-core
+```
-## Proyectos creados con Univer Office SDK
+Crea el contenedor antes de inicializar Univer:
-### Ejemplo destacado: Univer Workspace
+```html
+<div id="app" style="height: 100vh"></div>
+```
-[Univer Workspace](https://github.com/dream-num/univer-workspace) es un espacio de trabajo de código abierto, creado con Univer Office SDK y que se puede alojar en infraestructura propia, donde las personas y los agentes de IA crean, colaboran y revisan contenido ofimático. Los desarrolladores pueden usar la implementación completa como referencia, aprender a integrar el SDK y crear sus propios productos.
+```ts
+import { UniverSheetsCorePreset } from '@univerjs/preset-sheets-core'
+import UniverPresetSheetsCoreEnUS from '@univerjs/preset-sheets-core/locales/en-US'
+import { createUniver, LocaleType, mergeLocales } from '@univerjs/presets'
+import '@univerjs/preset-sheets-core/lib/index.css'
-[![Una miniaplicación de Workspace junto a su hoja de cálculo vinculada, con métricas, gráficos y controles vinculados a las celdas](../img/workspace-mini-app.png)](https://github.com/dream-num/univer-workspace)
+const { univerAPI } = createUniver({
+ locale: LocaleType.EN_US,
+ locales: {
+ [LocaleType.EN_US]: mergeLocales(UniverPresetSheetsCoreEnUS),
+ },
+ presets: [
+ UniverSheetsCorePreset({
+ container: 'app',
+ }),
+ ],
+})
-- Los agentes pueden generar miniaplicaciones basadas en hojas de cálculo, como paneles para la toma de decisiones, informes interactivos y paneles de negocio.
-- Las métricas, los gráficos y los controles de la página web están vinculados a celdas y permiten leer y escribir datos, así como actualizarlos de forma colaborativa.
+univerAPI.createWorkbook({})
+```
-[Explorar Univer Workspace](https://github.com/dream-num/univer-workspace)
+Tu página ya contiene un editor de hojas de cálculo. Usa el objeto `univerAPI` devuelto para trabajar con su contenido. Este ejemplo utiliza paquetes de código abierto y no necesita una licencia comercial de Univer ni Server SDK.
-### Otros ejemplos
+En frameworks de componentes, conserva la instancia de `univer` devuelta por `createUniver` y llama a `univer.dispose()` cuando se desmonte el componente. Consulta la [guía del ciclo de vida](https://docs.univer.ai/guides/sheets/getting-started/lifecycle).
-Estos proyectos de código abierto están creados con Univer Office SDK:
+Los presets componen plugins y registran sus APIs Facade. Para tener control manual, consulta el [ejemplo de Plugin Mode](#manual-plugin-composition) más abajo. La [guía de instalación](https://docs.univer.ai/guides/sheets/getting-started/installation) cubre ambos modos, las dependencias de pares y las integraciones con frameworks.
-| Proyecto | Descripción |
-| --- | --- |
-| [Univer Office for DeepSeek Harness](https://github.com/dream-num/dsh-univer-office) | Un plugin ofimático para DeepSeek Harness con contenido conectado, validación y worktrees aislados para la colaboración entre agentes. |
-| [Univer CLI](https://github.com/dream-num/univer-cli) | Un espacio de trabajo local en la línea de comandos para que los agentes creen, editen, inspeccionen y entreguen contenido ofimático. |
-| [Univer Office for WorkBuddy](https://github.com/dream-num/workbuddy-univer-office) | Una integración ofimática local para WorkBuddy con vistas previas MCP y revisión de borradores. Versión preliminar de desarrollo. |
-| [Univer Office for OpenClaw](https://github.com/dream-num/openclaw-univer-office) | Herramientas para crear, revisar y entregar contenido ofimático en OpenClaw. |
+Mantén los paquetes coordinados `@univerjs/*` en la misma versión. Los paquetes comerciales deben usar la misma línea de versiones; los paquetes publicados de forma independiente, como los iconos, siguen su compatibilidad declarada. Consulta la [Política de estabilidad de la API](../../docs/API_STABILITY.md).
-Cada proyecto documenta su instalación y los requisitos de licencia del SDK.
+<a id="connect-your-application-to-editable-content"></a>
-## 🌟 Highlights
+### Conecta tu aplicación al contenido editable
-<table>
- <tr>
- <td align="center" width="33%">
- ⚡<br />
- <strong>Preparado para superficies grandes</strong><br />
- <sub>El renderizado Canvas y un motor de fórmulas dedicado mantienen responsivos los libros complejos.</sub>
- </td>
- <td align="center" width="33%">
- 🧩<br />
- <strong>Extensible por plugins</strong><br />
- <sub>Compón, reemplaza, carga bajo demanda o amplía capacidades sin adoptar todo el stack.</sub>
- </td>
- <td align="center" width="33%">
- 🤖<br />
- <strong>Headless para infraestructura de IA</strong><br />
- <sub>Ejecuta lógica de libros y documentos en Node.js para impulsar agentes, automatización y flujos del servidor.</sub>
- </td>
- </tr>
- <tr>
- <td align="center" width="33%">
- 🛠️<br />
- <strong>SDK listo para producto</strong><br />
- <sub>Adaptadores de framework, Facade APIs, presets y runtime headless encajan en integraciones reales.</sub>
- </td>
- <td align="center" width="33%">
- 🌗<br />
- <strong>Dark mode listo</strong><br />
- <sub>Los componentes de UI y el motor de renderizado se adaptan a temas claros y oscuros.</sub>
- </td>
- <td align="center" width="33%">
- 🔌<br />
- <strong>Facade API unificada</strong><br />
- <sub>Una API consistente para libros, rangos, fórmulas y documentos en el navegador y Node.js.</sub>
- </td>
- </tr>
-</table>
+Las APIs Facade son la interfaz de la aplicación para libros, hojas y rangos. Continúa desde el inicio rápido para rellenar un presupuesto, actualizar una cantidad desde el código de la aplicación y leer el total recalculado:
-## 🚀 ¿Por qué Univer?
+```ts
+// Wait for formula controllers before editing a newly created workbook.
+await new Promise<void>((resolve) => {
+ if (univerAPI.getCurrentLifecycleStage() >= univerAPI.Enum.LifecycleStages.Steady) {
+ resolve()
+ return
+ }
+ const listener = univerAPI.addEvent(univerAPI.Event.LifeCycleChanged, ({ stage }) => {
+ if (stage === univerAPI.Enum.LifecycleStages.Steady) {
+ listener.dispose()
+ resolve()
+ }
+ })
+})
-- **Diseño isomórfico**: ejecuta aplicaciones UI en navegadores y procesamiento headless en Node.js.
-- **Arquitectura basada en plugins**: cada capacidad se entrega como un plugin componible, por lo que las funciones se pueden añadir, quitar, reemplazar o cargar bajo demanda.
-- **Preset mode para integración rápida**: usa las colecciones de plugins preparadas en [`presets/`](../../presets) cuando quieras una aplicación funcional rápidamente.
-- **Plugin mode para control total**: compón paquetes manualmente cuando necesites carga personalizada, bundles más pequeños o integración profunda.
-- **Facade API**: trabaja con libros, hojas, rangos, documentos, fórmulas, comandos y eventos mediante una API de alto nivel.
-- **Motor de renderizado Canvas**: soporta superficies editables grandes y comparte la capa de renderizado entre distintos tipos de documento.
-- **UI extensible**: integración con React, Vue, Web Components y shells de aplicación específicos de cada framework.
+const workbook = univerAPI.getActiveWorkbook()!
+const sheet = workbook.getActiveSheet()
-## 🤖 Flujos de trabajo ofimáticos para agentes de IA
+sheet.getRange('A1:D4').setValues([
+ ['Item', 'Quantity', 'Unit price', 'Amount'],
+ ['Seats', 2, 25, '=B2*C2'],
+ ['Support', 1, 100, '=B3*C3'],
+ ['Total', '', '', '=SUM(D2:D3)'],
+])
-Las capacidades de IA y colaboración de Univer conectan las operaciones de los agentes con la edición interactiva y la revisión humana:
+// An application control or agent can make the same edit.
+sheet.getRange('B2').setValue(4)
-- **Edición programática**: los agentes inspeccionan y modifican contenido ofimático mediante APIs estructuradas.
-- **Verificación de resultados**: los agentes comprueban el contenido, las capturas renderizadas y los diagnósticos de diseño.
-- **Colaboración con Worktree**: los agentes trabajan en borradores aislados; después, las personas revisan los cambios y deciden cuáles incorporar.
+univerAPI.getFormula().onCalculationResultApplied().then(() => {
+ console.log(sheet.getRange('D4').getValue()) // 200
+ localStorage.setItem('quotation', JSON.stringify(workbook.save()))
+}).catch(console.error)
+```
-Consulta la [documentación de AI SDK](https://docs.univer.ai/ai) para conocer la integración. La edición en tiempo real, las revisiones compartidas y los flujos de Worktree requieren las capacidades correspondientes de Web SDK y colaboración; los paquetes disponibles y las licencias dependen de cada función.
+El editor y tu aplicación trabajan sobre el mismo libro; los cambios en las fórmulas se recalculan automáticamente. `workbook.save()` devuelve una instantánea JSON que contiene el libro y los datos de sus plugins registrados. Tu aplicación se encarga de la persistencia; este ejemplo usa el almacenamiento del navegador. En una carga posterior de la página, después de la inicialización, restaura la instantánea **en lugar de crear un libro vacío**:
-## ⚡ Inicio rápido
+```ts
+const saved = localStorage.getItem('quotation')
+if (saved) {
+ univerAPI.createWorkbook(JSON.parse(saved))
+}
+```
+
+Este flujo utiliza únicamente paquetes de código abierto. La persistencia de instantáneas es independiente de la importación y exportación de XLSX, que utiliza capacidades de conversión de archivos distribuidas por separado. Usa las APIs Facade públicas para integrar tu aplicación; los enlaces al código fuente siguientes explican la implementación interna y los puntos de extensión. Consulta la [Política de estabilidad de la API](../../docs/API_STABILITY.md) antes de depender de un punto de extensión.
-Usa **Plugin Mode** para obtener una cobertura completa del producto y controlar con precisión la composición. Para los perfiles compatibles de Sheets, Docs y Node, **Preset Mode** ofrece una configuración curada más breve.
+<a id="manual-plugin-composition"></a>
-<details open>
-<summary><strong>Plugin Mode</strong></summary>
+<details>
+<summary>Avanzado: componer plugins manualmente (Plugin Mode)</summary>
+
+Usa Plugin Mode cuando necesites un control preciso sobre la selección, las dependencias o la carga de plugins. El preset anterior se encarga de esta composición por ti.
-Plugin Mode te da control de bajo nivel sobre paquetes, imports de estilos, combinación de locales, registro de Facade API y configuración de plugins.
+Esta inicialización alternativa utiliza el mismo contenedor `app` y la pila de plugins de navegador del preset Sheets Core sin un Worker. Úsala **en lugar de** la inicialización con preset y después ejecuta el mismo ejemplo de presupuesto con el objeto `univerAPI` devuelto.
```bash
-pnpm add @univerjs/core @univerjs/design @univerjs/docs @univerjs/docs-ui @univerjs/engine-formula @univerjs/engine-render @univerjs/sheets @univerjs/sheets-formula @univerjs/sheets-formula-ui @univerjs/sheets-numfmt @univerjs/sheets-numfmt-ui @univerjs/sheets-ui @univerjs/ui
+pnpm add @univerjs/core @univerjs/design @univerjs/docs @univerjs/docs-ui \
+ @univerjs/engine-formula @univerjs/engine-render @univerjs/network \
+ @univerjs/sheets @univerjs/sheets-ui @univerjs/sheets-formula \
+ @univerjs/sheets-formula-ui @univerjs/sheets-numfmt \
+ @univerjs/sheets-numfmt-ui @univerjs/ui
```
```ts
@@ -161,7 +301,9 @@ import { UniverDocsPlugin } from '@univerjs/docs'
import { UniverDocsUIPlugin } from '@univerjs/docs-ui'
import DocsUIEnUS from '@univerjs/docs-ui/locale/en-US'
import { UniverFormulaEnginePlugin } from '@univerjs/engine-formula'
+import FormulaEnUS from '@univerjs/engine-formula/locale/en-US'
import { UniverRenderEnginePlugin } from '@univerjs/engine-render'
+import { UniverNetworkPlugin } from '@univerjs/network'
import { UniverSheetsPlugin } from '@univerjs/sheets'
import SheetsEnUS from '@univerjs/sheets/locale/en-US'
import { UniverSheetsFormulaPlugin } from '@univerjs/sheets-formula'
@@ -175,185 +317,485 @@ import { UniverSheetsUIPlugin } from '@univerjs/sheets-ui'
import SheetsUIEnUS from '@univerjs/sheets-ui/locale/en-US'
import { UniverUIPlugin } from '@univerjs/ui'
import UIEnUS from '@univerjs/ui/locale/en-US'
-
import '@univerjs/design/lib/index.css'
import '@univerjs/ui/lib/index.css'
import '@univerjs/docs-ui/lib/index.css'
import '@univerjs/sheets-ui/lib/index.css'
import '@univerjs/sheets-formula-ui/lib/index.css'
import '@univerjs/sheets-numfmt-ui/lib/index.css'
-
+import '@univerjs/network/facade'
+import '@univerjs/docs/facade'
+import '@univerjs/docs-ui/facade'
import '@univerjs/engine-formula/facade'
-import '@univerjs/ui/facade'
import '@univerjs/sheets/facade'
+import '@univerjs/ui/facade'
import '@univerjs/sheets-ui/facade'
import '@univerjs/sheets-formula/facade'
import '@univerjs/sheets-numfmt/facade'
+import '@univerjs/sheets-formula-ui/facade'
const univer = new Univer({
locale: LocaleType.EN_US,
locales: {
[LocaleType.EN_US]: mergeLocales(
DesignEnUS,
- UIEnUS,
DocsUIEnUS,
+ FormulaEnUS,
SheetsEnUS,
- SheetsUIEnUS,
SheetsFormulaEnUS,
SheetsFormulaUIEnUS,
SheetsNumfmtUIEnUS,
+ SheetsUIEnUS,
+ UIEnUS,
),
},
})
+univer.registerPlugin(UniverNetworkPlugin)
+univer.registerPlugin(UniverDocsPlugin)
univer.registerPlugin(UniverRenderEnginePlugin)
-univer.registerPlugin(UniverFormulaEnginePlugin)
univer.registerPlugin(UniverUIPlugin, { container: 'app' })
-univer.registerPlugin(UniverDocsPlugin)
univer.registerPlugin(UniverDocsUIPlugin)
-univer.registerPlugin(UniverSheetsPlugin)
-univer.registerPlugin(UniverSheetsUIPlugin)
-univer.registerPlugin(UniverSheetsFormulaPlugin)
-univer.registerPlugin(UniverSheetsFormulaUIPlugin)
+univer.registerPlugin(UniverFormulaEnginePlugin)
+univer.registerPlugin(UniverSheetsPlugin, {
+ onlyRegisterFormulaRelatedMutations: false,
+})
+univer.registerPlugin(UniverSheetsUIPlugin, {
+ protectedRangeShadow: true,
+})
univer.registerPlugin(UniverSheetsNumfmtPlugin)
univer.registerPlugin(UniverSheetsNumfmtUIPlugin)
+univer.registerPlugin(UniverSheetsFormulaPlugin)
+univer.registerPlugin(UniverSheetsFormulaUIPlugin)
const univerAPI = FUniver.newAPI(univer)
univerAPI.createWorkbook({})
```
+Los plugins de Docs permiten editar texto enriquecido en hojas de cálculo. Al añadir una función, incluye sus extensiones Facade, paquetes de idioma y estilos de UI correspondientes. Libera `univer` cuando se desmonte su contenedor.
+
</details>
-<details>
-<summary><strong>Preset Mode</strong></summary>
+<p align="right"><a href="#readme-top"><img src="https://img.shields.io/badge/%E2%86%91%20Volver%20arriba-30363D?style=flat-square" alt="Volver arriba" height="20" /></a></p>
+
+<a id="open-source-architecture"></a>
+
+## 🏗️ Explora la arquitectura de código abierto
+
+<p align="center"><img src="../../docs/img/readme/architecture-banner.png" alt="" width="960" /></p>
+
+<a id="give-custom-features-clear-boundaries"></a>
+
+### Define límites claros para las funciones personalizadas
+
+Univer organiza la lógica de contenido y la interacción de UI en plugins separados. Los plugins de funciones gestionan las reglas y los cambios de contenido; los plugins de UI proporcionan la interfaz y las interacciones con el usuario. Por ejemplo, `sheets-filter` gestiona los rangos y las reglas de filtrado, mientras que `sheets-filter-ui` proporciona paneles, menús y atajos.
+
+```mermaid
+%%{init: {'htmlLabels': false, 'theme': 'base', 'themeVariables': {'fontFamily': 'Arial, PingFang SC, Microsoft YaHei, sans-serif', 'fontSize': '17px', 'lineColor': '#64748b'}, 'flowchart': {'htmlLabels': false, 'curve': 'linear', 'nodeSpacing': 28, 'rankSpacing': 45, 'padding': 16, 'wrappingWidth': 270}}}%%
+%% A layered overview, not a complete dependency graph.
+%% Group arrows indicate reuse of the layer below; internal arrows show selected dependencies.
+flowchart TD
+ subgraph FEATURES["Feature Plugins"]
+ direction LR
+ FUI["Filter<br/>UI Plugin"]
+ VUI["Data Validation<br/>UI Plugin"]
+ FILTER["Filter Plugin"]
+ VALIDATION["Data Validation Plugin"]
+ FUI --> FILTER
+ VUI --> VALIDATION
+ end
+
+ subgraph PRODUCTS["Product Plugins"]
+ direction LR
+ SUI["Sheets UI Plugin"]
+ SHEETS["Sheets Plugin"]
+ SUI --> SHEETS
+ end
+
+ subgraph FOUNDATION["Core Framework & Plugins"]
+ direction LR
+ UI["UI Plugin"]
+ FORMULA["Formula Engine Plugin"]
+ RENDER["Render Engine Plugin"]
+ CORE["Core"]
+ UI --> RENDER
+ RENDER --> CORE
+ FORMULA --> CORE
+ end
+
+ FEATURES --> PRODUCTS
+ PRODUCTS --> FOUNDATION
+
+ classDef logic fill:#eff6ff,color:#17365f,stroke:#93b4df,stroke-width:1.5px
+ classDef ui fill:#f0fdf4,color:#17543a,stroke:#91c8a7,stroke-width:1.5px
+ classDef shared fill:#f6f7f9,color:#334155,stroke:#bac3ce,stroke-width:1.5px
+ classDef feature fill:#172d50,color:#ffffff,stroke:#172d50
+ class FUI,VUI ui
+ class FILTER,VALIDATION logic
+ class SUI,SHEETS logic
+ class UI,FORMULA,RENDER,CORE shared
+
+ style FEATURES fill:#f7fcf9,stroke:#b5d8c1,color:#17543a
+ style PRODUCTS fill:#f5f9ff,stroke:#b6cbea,color:#17365f
+ style FOUNDATION fill:#fafbfc,stroke:#cbd2dc,color:#334155
+```
-Los presets son colecciones curadas de plugins de Univer que incluyen los registros de Facade API y estilos necesarios.
+**Figura 1: tres capas de plugins.** Los plugins de funciones se apoyan en los plugins de producto, que reutilizan el framework central y sus plugins. Las flechas entre grupos muestran las dependencias de la capa inferior; Core proporciona modelos de contenido, comandos, inyección de dependencias y gestión del ciclo de vida. Se omiten algunos plugins y dependencias.
-```bash
-pnpm add @univerjs/presets @univerjs/preset-sheets-core
-```
+Las nuevas funciones mantienen sus reglas en sus propios plugins y cooperan mediante servicios públicos, comandos y puntos de extensión definidos. Los plugins de UI se basan en servicios y componentes de UI compartidos.
-```ts
-import { UniverSheetsCorePreset } from '@univerjs/preset-sheets-core'
-import UniverPresetSheetsCoreEnUS from '@univerjs/preset-sheets-core/locales/en-US'
-import { createUniver, LocaleType, mergeLocales } from '@univerjs/presets'
+Las dependencias son explícitas en dos niveles:
-import '@univerjs/preset-sheets-core/lib/index.css'
+- **Entre plugins:** `DependentOn` declara las dependencias de plugins en tiempo de ejecución. El servicio de plugins las ordena, y las etapas del ciclo de vida separan el registro de dependencias, la inicialización de contenido y la inicialización de UI.
+- **Dentro de los plugins:** la inyección de dependencias conecta controladores y servicios mediante dependencias declaradas. Las sustituciones admitidas permiten a una aplicación reemplazar una implementación, adaptar un servicio de plataforma o proporcionar un doble de prueba. Los inyectores con ámbito de instancia mantienen separado el estado de la aplicación entre instancias de Univer.
-const { univerAPI } = createUniver({
- locale: LocaleType.EN_US,
- locales: {
- [LocaleType.EN_US]: mergeLocales(UniverPresetSheetsCoreEnUS),
- },
- presets: [
- UniverSheetsCorePreset({
- container: 'app',
- }),
- ],
-})
+El registro con disposables también permite limpiar comandos, listeners, componentes e iconos cuando se libera su propietario.
-univerAPI.createWorkbook({})
+El [plugin de filtrado](../../packages/sheets-filter/src/plugin.ts) y su [plugin de UI](../../packages/sheets-filter-ui/src/plugin.ts) muestran estos límites en código real.
+
+<details>
+<summary>Dentro de una función: Model, Controller, Service e infraestructura de UI</summary>
+
+En el filtrado, `sheets-filter` se encarga de la lógica de contenido y `sheets-filter-ui` de la interacción de UI. Cada módulo tiene una responsabilidad concreta.
+
+```mermaid
+%%{init: {'htmlLabels': false, 'theme': 'base', 'themeVariables': {'fontFamily': 'Arial, PingFang SC, Microsoft YaHei, sans-serif', 'fontSize': '17px', 'lineColor': '#64748b'}, 'flowchart': {'htmlLabels': false, 'curve': 'linear', 'nodeSpacing': 28, 'rankSpacing': 45, 'padding': 16, 'wrappingWidth': 270}}}%%
+%% Every arrow means contains. This is code organization, not execution order.
+flowchart LR
+ FEATURE["Filter Feature"]
+ LOGIC["Filter Plugin"]
+ UI["Filter UI Plugin"]
+ MODEL["Model"]
+ SERVICE["Service"]
+ CONTROLLER["Controller"]
+ COMMAND["Command / Mutation"]
+ FACADE["Facade API"]
+ VIEW["View"]
+ UICTRL["UI Controller"]
+ UISERVICE["UI Service"]
+ FEATURE --> LOGIC
+ FEATURE --> UI
+ LOGIC --> MODEL
+ LOGIC --> SERVICE
+ LOGIC --> CONTROLLER
+ LOGIC --> COMMAND
+ LOGIC --> FACADE
+ UI --> VIEW
+ UI --> UICTRL
+ UI --> UISERVICE
+
+ classDef logic fill:#eff6ff,color:#17365f,stroke:#93b4df,stroke-width:1.5px
+ classDef ui fill:#f0fdf4,color:#17543a,stroke:#91c8a7,stroke-width:1.5px
+ classDef shared fill:#f6f7f9,color:#334155,stroke:#bac3ce,stroke-width:1.5px
+ classDef feature fill:#172d50,color:#ffffff,stroke:#172d50
+ class FEATURE feature
+ class LOGIC,MODEL,SERVICE,CONTROLLER,COMMAND,FACADE logic
+ class UI,VIEW,UICTRL,UISERVICE ui
```
+**Figura 2: organización del código. Las flechas significan «contiene».** Ambos plugins pueden contener Controllers y Services: los Controllers de lógica coordinan los cambios de contenido y las funciones relacionadas; los Controllers de UI conectan menús, atajos e interacciones, y los Services de UI gestionan el estado de los paneles. Estas responsabilidades ofrecen a las nuevas funciones una estructura coherente para su implementación y pruebas.
+
+La infraestructura de UI sigue la misma división. **`@univerjs/design`** aporta componentes y estilos compartidos, **`@univerjs/ui`** proporciona servicios del entorno de trabajo como menús, atajos, paneles y registro de componentes, y **`@univerjs/icons`** aporta iconos. Una función registra sus componentes e iconos, añade menús y conecta su renderizado mediante estos puntos de extensión. Los equipos pueden añadir un panel o una función a la barra de herramientas reutilizando la infraestructura de UI de la aplicación. Consulta la [descripción general de UI](https://docs.univer.ai/guides/sheets/ui/overview) y el [registro de componentes e iconos](../../packages/sheets-filter-ui/src/controllers/components.controller.ts) del plugin de filtrado.
+
</details>
-Tu página necesita un contenedor:
+<a id="compose-cross-feature-edits-and-undoredo"></a>
-```html
-<div id="app" style="height: 100vh"></div>
+### Combina ediciones y deshacer/rehacer entre funciones
+
+Por ejemplo, al insertar filas dentro de un rango de filtro, el plugin de filtrado aporta el cambio de rango correspondiente y sus datos para deshacer. El comando de filas combina la edición base y los cambios de las funciones participantes, los ejecuta y registra conjuntamente su información de deshacer/rehacer. La función de inserción de filas puede usar el mecanismo de extensión compartido mientras el plugin de filtrado conserva sus reglas de actualización de rangos.
+
+El sistema de comandos distingue tres tipos de acción:
+
+- **Command** orquesta una acción de negocio y los cambios que requiere.
+- **Mutation** modifica contenido guardado en una instantánea, con parámetros serializables.
+- **Operation** modifica estado transitorio, como un panel abierto o la posición de desplazamiento.
+
+**Una estructura compartida para deshacer/rehacer.** Para una edición que se pueda deshacer, la implementación de la función aporta las mutaciones directas y las mutaciones inversas correspondientes, y el Command las registra mediante `IUndoRedoService`. Cuando una acción afecta a varias funciones, el Command puede combinar sus cambios y datos para deshacer en un único registro de deshacer/rehacer, para que el usuario pueda deshacer y rehacer la acción completa. Consulta [cómo ampliar los comandos](https://docs.univer.ai/blog/custom-command).
+
+Las funciones siguen necesitando cooperar. **Los interceptores y los manejadores de rangos de referencia dan un lugar definido a esa cooperación.** En los puntos de extensión admitidos, los plugins aportan comprobaciones o mutaciones relacionadas; las prioridades de los interceptores controlan el orden cuando la API así lo define.
+
+<details>
+<summary>Ejemplo: comandos, callbacks, coordinación de funciones y deshacer/rehacer</summary>
+
+```mermaid
+%%{init: {'htmlLabels': false, 'theme': 'base', 'themeVariables': {'fontFamily': 'Arial, PingFang SC, Microsoft YaHei, sans-serif', 'fontSize': '17px', 'lineColor': '#64748b'}, 'flowchart': {'htmlLabels': false, 'curve': 'linear', 'nodeSpacing': 28, 'rankSpacing': 45, 'padding': 16, 'wrappingWidth': 270}}}%%
+%% Simplified insert-row example. A command composes mutations and records undo after success.
+%% Events may also fire for nested command executions; not every callback is drawn.
+flowchart TD
+ BEFORE["Before execution<br/>Inspect or cancel"]
+ CMD["Insert-row Command"]
+ BASE["Row mutations"]
+ EXT["Feature extension points<br/>Filter range changes"]
+ MODEL["Execute combined mutations"]
+ UNDO["Record undo and redo"]
+ AFTER["After execution<br/>Notify listeners"]
+ BEFORE --> CMD
+ CMD --> BASE
+ CMD --> EXT
+ BASE --> MODEL
+ EXT --> MODEL
+ MODEL --> UNDO
+ UNDO --> AFTER
+ classDef entry fill:#f6f7f9,color:#334155,stroke:#bac3ce,stroke-width:1.5px
+ classDef core fill:#eff6ff,color:#17365f,stroke:#93b4df,stroke-width:1.5px
+ classDef extension fill:#f0fdf4,color:#17543a,stroke:#91c8a7,stroke-width:1.5px
+ class BEFORE,AFTER entry
+ class CMD,BASE,MODEL,UNDO core
+ class EXT extension
```
-Consulta más detalles en la [guía de instalación y uso básico](https://docs.univer.ai/guides/sheets/getting-started/installation), la [referencia de `createUniver`](https://docs.univer.ai/reference/methods/create-univer) y la [referencia de Facade API](https://docs.univer.ai/reference/classes/univer).
+Este diagrama simplifica un flujo de inserción de filas. Las ejecuciones de comandos anidados tienen sus propios callbacks; no muestra todos los eventos ni la ruta separada de Operation. Consulta el [comando de filas](../../packages/sheets/src/commands/commands/insert-row-col.command.ts), el [controlador de filtrado](../../packages/sheets-filter/src/controllers/sheets-filter.controller.ts) y el [servicio de interceptores](../../packages/sheets/src/services/sheet-interceptor/sheet-interceptor.service.ts).
+
+</details>
+
+Estos límites permiten una estrategia práctica de pruebas: probar modelos y servicios de forma independiente, sustituir dependencias externas mediante DI y añadir casos de regresión para acciones combinadas y deshacer/rehacer. Las [pruebas del controlador de filtrado](../../packages/sheets-filter/src/controllers/__tests__/sheets-filter.controller.spec.ts) ejercitan los cambios de filas y columnas y su efecto en el filtrado.
+
+<a id="connect-applications-and-agents-through-facade-apis-and-events"></a>
+
+### Conecta aplicaciones y agentes mediante APIs Facade y eventos
+
+El repositorio incluye los modelos de contenido, el motor de fórmulas y el motor de renderizado y diseño en Canvas que utilizan los editores. Son elementos compartidos: el texto enriquecido en hojas de cálculo, por ejemplo, reutiliza el diseño y el renderizado de documentos. Las funciones personalizadas pueden basarse en estos motores en lugar de implementar una pila de contenido independiente. Lee sobre la [arquitectura del motor de fórmulas](https://docs.univer.ai/blog/formula) y la [arquitectura del motor de renderizado](https://docs.univer.ai/blog/rendering).
+
+Los editores de navegador, las tareas Headless de Node.js y los Workers compuestos adecuadamente pueden reutilizar los plugins de contenido, modelos, comandos y cálculo correspondientes. Consulta [Headless Univer](https://docs.univer.ai/guides/sheets/getting-started/node) y la [arquitectura isomórfica](../../docs/ISOMORPHIC.md).
+
+`ICommandService` expone callbacks de ejecución para que los plugins observen los comandos antes y después de ejecutarse. Las APIs Facade encapsulan las capacidades subyacentes en objetos de aplicación como `FWorkbook`, `FWorksheet` y `FRange`.
-## 🧩 Preset Mode vs Plugin Mode
+Cada plugin aporta sus propias extensiones Facade, **eventos tipados mediante `univerAPI.Event`** y **enumeraciones mediante `univerAPI.Enum`**. El código de la aplicación puede descubrir nombres de eventos y constantes desde un único punto de entrada, sin importar servicios privados ni repetir cadenas. Por ejemplo, `BeforeCommandExecute` puede inspeccionar y cancelar una ejecución; `CommandExecuted` notifica las ejecuciones a los listeners. Los listeners devuelven disposables, y la cancelación se aplica cuando el evento la admite.
-| Opción | Cuándo usarla | Empieza aquí |
-| --- | --- | --- |
-| **Plugin Mode** | Necesitas control estricto sobre paquetes, dependencias configuradas, carga bajo demanda o composición personalizada en tiempo de ejecución. | Los [`examples/`](../../examples) de este repositorio y la [guía de arquitectura](https://docs.univer.ai/guides/recipes/architecture/univer) |
-| **Preset Mode** | Quieres una configuración funcional de Sheets, Docs o Node con mínima configuración. | Los [`presets/`](../../presets) de este repositorio y la [guía de inicio](https://docs.univer.ai/guides/sheets/getting-started/installation) |
-| **Headless Mode** | Necesitas procesamiento de libros/documentos en servidor, cálculo de fórmulas o automatización sin UI. | [Headless Univer](https://docs.univer.ai/guides/sheets/getting-started/node) |
+Las extensiones Facade permanecen en los paquetes de sus funciones, de modo que una API de contenido no necesita incorporar APIs de UI ajenas. Consulta el [diseño de Facade](https://docs.univer.ai/blog/facade), los [callbacks de comandos y el puente de eventos](../../packages/core/src/facade/f-univer.ts) y el [punto de entrada de Enum](../../packages/core/src/facade/f-enum.ts).
-Mantén en la misma versión los paquetes del SDK `@univerjs/*` que formen parte de una misma línea de lanzamiento coordinada de Univer. Los paquetes con un ciclo de publicación independiente, como `@univerjs/icons` y `@univerjs/icons-svg`, deben usar las versiones compatibles declaradas en los manifiestos de los paquetes, no la versión del SDK. Si usas paquetes de Univer Pro, mantén `@univerjs-pro/*` alineados con la línea de lanzamiento coordinada correspondiente.
+El repositorio ofrece implementaciones de funciones y patrones para ampliarlas. Lee el [recorrido por la implementación del filtrado](https://docs.univer.ai/blog/anatomy) para ver un ejemplo completo, o la [Política de estabilidad de la API](../../docs/API_STABILITY.md) antes de depender de un punto de extensión.
-Para expectativas de compatibilidad de API, APIs experimentales, APIs internas y reglas de deprecación, consulta la [política de estabilidad de API](../API_STABILITY.md).
+<p align="right"><a href="#readme-top"><img src="https://img.shields.io/badge/%E2%86%91%20Volver%20arriba-30363D?style=flat-square" alt="Volver arriba" height="20" /></a></p>
-## 🧭 Compatibilidad
+<a id="open-source-and-commercial-extensions"></a>
-- **Runtime de navegador**: Univer se compila con objetivo Chrome 88 y busca funcionar en Edge `>=88`, Firefox `>=90`, Chrome `>=88`, Safari `>=14.1` y Electron `>=12`.
-- **Polyfills**: Univer depende de `Intl.Segmenter`. Añade un polyfill como `@formatjs/intl-segmenter` si tu navegador o runtime objetivo no lo incluye.
-- **Herramientas de build**: Recomendamos Vite, esbuild o Webpack 5. Si tu herramienta no soporta el campo `exports` de `package.json` (común en Webpack 4), puede que necesites configurar mapeos de ruta adicionales.
-- **React**: La capa de vista de Univer está construida sobre React 18, soporta React 18 y 19, y ofrece compatibilidad mínima para React 16.9+ y 17.
-- **Runtime Node.js**: Headless Univer soporta Node.js `>=18.17.0`. Para desarrollar este monorepo se requiere Node.js `>=22.18`.
+## 🧩 Amplía tu aplicación con Univer Office SDK
-## 🛠️ Qué puedes construir
+<p align="center"><img src="../../docs/img/readme/sdk-banner.png" alt="" width="960" /></p>
-| Área | Capacidades open source | Extensiones de Univer Pro |
-| --- | --- | --- |
-| **Sheets** | Libros, hojas, rangos, selección, fórmulas, formato numérico, filtros, ordenación, validación de datos, formato condicional, hipervínculos, comentarios, buscar y reemplazar, notas, tablas, integración de dibujo y plugins de UI extensibles. | Colaboración en tiempo real, historial de edición, importación/exportación, impresión, gráficos, tablas dinámicas, sparklines, esquemas, formas, gráficos dentro de celdas, conectores de datos, cálculo del lado del servidor y funciones de fórmulas mejoradas. |
-| **Docs** | Modelo de documento enriquecido, UI de edición, listas, hipervínculos, integración de dibujo, comentarios, inserción rápida y arquitectura compartida de documentos. | Colaboración, importación/exportación, impresión, tablas y listas mejoradas, columnas, callouts, bloques de código, citas, formas y recursos remotos de comentarios. |
-| **Slides** | — | Modelo y UI para presentaciones, importación/exportación de slides, plugins de modelo/UI para gráficos y tablas, e infraestructura compartida de edición de formas. |
-| **Bases** | Experiencias de datos estructurados personalizadas sobre la arquitectura de plugins, comandos y modelos de Univer. | Modelo de base de datos Base, comandos, integración de fórmulas, UI de workbench, editores de campos y vistas del motor de renderizado. |
-| **Runtime** | Aplicaciones en navegador, uso headless en Node.js, patrones Web Worker/RPC, múltiples instancias y automatización orientada al servidor. | Paquetes de cliente/servidor de colaboración, cliente de colaboración para Node.js, servicios Pro de servidor, SSR, delegación de cómputo, cálculo del lado del servidor y herramientas de replay de changesets. |
-| **Integrations** | React, Vue, Web Components, plantillas de frameworks, temas, localización y plugins personalizados. | Presets Pro y paquetes de despliegue empresarial. |
+Cuando necesites más capacidades listas para integrar, combina los módulos correspondientes de **Univer Office SDK**: tipos de contenido adicionales, plugins de edición avanzada, colaboración, conversión de archivos y herramientas para agentes. Amplían los mismos modelos de contenido, arquitectura de plugins, sistema de comandos y diseño de Facade presentados anteriormente, por lo que puedes aprovechar tu integración existente.
-Sheets, Docs y Slides ofrecen edición de hojas de cálculo, documentos y presentaciones sobre la arquitectura compartida de Univer, con un sistema de plugins, un sistema de comandos y una API Facade coherentes.
+<div align="center" style="overflow-x: auto;">
-## 🔓 Open Source y Pro
+<table align="center" style="display: table; width: auto; margin-left: auto; margin-right: auto;">
+<thead>
+<tr>
+<th>Parte</th>
+<th>Cómo amplía la base</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td><strong>Núcleo de Web SDK de código abierto · este repositorio</strong></td>
+<td>Modelos, motores, plugins, infraestructura de UI y capacidades de Sheets y Docs de código abierto, con sus correspondientes operaciones Headless sobre contenido. Úsalos en aplicaciones comerciales bajo Apache-2.0.</td>
+</tr>
+<tr>
+<td><strong>Plugins comerciales de Web SDK</strong></td>
+<td>Siguen los patrones de Plugin, inyección de dependencias, Command/Mutation y extensión de Facade del núcleo. Añaden gráficos, formas, tablas dinámicas, SmartArt y otras funciones para los tipos de contenido correspondientes.</td>
+</tr>
+<tr>
+<td><strong>Server SDK</strong></td>
+<td>Amplía los mismos modelos de contenido y convenciones de mutaciones con colaboración en tiempo real, historial de revisiones y conversión de archivos de Office. Se integra con la identidad, los permisos y el almacenamiento de tu aplicación.</td>
+</tr>
+<tr>
+<td><strong>Extensiones de AI SDK</strong></td>
+<td>Reutilizan las capacidades Headless y Facade de Web SDK para proporcionar APIs de Node.js y componentes de CLI que se pueden combinar para que los agentes inspeccionen, editen y comprueben contenido, con integraciones de colaboración y revisión de Worktree.</td>
+</tr>
+</tbody>
+</table>
+
+</div>
-Este repositorio contiene el núcleo open source de Univer y plugins OSS de primera parte. Univer Pro se desarrolla por separado como una capa de extensión comercial para superficies de producto avanzadas, colaboración, capacidades de servidor e integraciones empresariales.
+<a id="scope-and-licensing"></a>
-| Categoría | Open source | Univer Pro / comercial |
-| --- | --- | --- |
-| **Base** | SDK core, sistema de plugins, motor de renderizado, motor de fórmulas, Facade API, temas, i18n y adaptadores de frameworks. | Presets Pro y paquetes de despliegue empresarial. |
-| **Sheets** | Edición básica de hojas de cálculo, fórmulas, formato numérico, filtro/ordenación, validación de datos, formato condicional, notas, tablas, hipervínculos, comentarios, dibujo, buscar y reemplazar. | Colaboración, historial de edición, importación/exportación, impresión, gráficos, tablas dinámicas, sparklines, esquemas, formas, gráficos dentro de celdas, conectores de datos, preprocesamiento de rangos y funciones mejoradas del motor de fórmulas. |
-| **Docs** | Modelo de documento y UI de edición, listas, hipervínculos, comentarios, inserción rápida e integración de dibujo. | Colaboración, importación/exportación, impresión, tablas/listas mejoradas, columnas, callouts, bloques de código, citas, formas y recursos remotos de comentarios en hilos. |
-| **Slides** | — | Paquetes de modelo/UI de slides, importación/exportación de slides, gráficos, tablas y UI reutilizable de editor de formas. |
-| **Bases** | Arquitectura de plugins extensible para productos personalizados centrados en datos. | Modelo core de base de datos Base, comandos, mutations, integración de fórmulas, UI de workbench, editores de campos e integración con el motor de renderizado. |
-| **Servidor y runtime** | Runtime headless en Node.js, patrones RPC/Web Worker y primitivas de automatización orientada al servidor. | Servidor de colaboración, cliente de colaboración para Node.js, servicios SSR, delegación de cómputo, cálculo del lado del servidor y herramientas de replay de changesets de colaboración. |
+### Alcance y licencias
-Las funciones del editor se documentan en las [guías del Web SDK](https://docs.univer.ai/guides/sheets). Para la integración del backend, consulta los capítulos del Server SDK sobre [colaboración](https://docs.univer.ai/server/collaboration/overview) e [importación y exportación de archivos](https://docs.univer.ai/server/import-export).
+- **Este repositorio:** paquetes Apache-2.0 que se pueden usar en aplicaciones comerciales bajo esa licencia, incluidas las capacidades Headless de código abierto para contenido.
+- **Extensiones comerciales:** los plugins comerciales de Web SDK, Server SDK y las capacidades de AI SDK que van más allá de la base de código abierto se distribuyen y licencian por separado. La evaluación **Freemium** incluye marcas de agua y límites de funciones.
+- **Aplicaciones de referencia:** las aplicaciones de código abierto como Univer Workspace tienen sus propias licencias de código fuente. Sus dependencias del SDK conservan sus respectivas licencias.
-Para consultas sobre licencias comerciales y compras, [ponte en contacto con nosotros](https://univer.ai/#contact). Consulta la [configuración de licencias](https://docs.univer.ai/server/license) para configurar una licencia en tu aplicación.
+Consulta la [comparación de funciones](https://univer.ai/compare/), incluido su filtro **Open source only**, para conocer la cobertura detallada, y los [planes y licencias](https://univer.ai/pricing/) para las opciones comerciales.
-Principios de separación:
+<details>
+<summary>Cómo los modelos de contenido compartidos conectan la edición, la colaboración y los archivos</summary>
-- Los paquetes OSS de este repositorio están pensados para ser útiles por sí mismos bajo la licencia Apache-2.0. Univer Pro es opcional y no se requiere para usar las APIs públicas del SDK OSS.
-- Los bugs, regresiones y problemas de seguridad en paquetes OSS deben reportarse y corregirse en el repositorio OSS, incluso cuando exista una función Pro relacionada.
-- La documentación OSS no debe sugerir que capacidades Pro-only están disponibles en los paquetes públicos `@univerjs/*`. Las APIs, paquetes y rutas de despliegue Pro-only deben nombrarse explícitamente.
-- Cuando una función OSS tenga una mejora Pro, el comportamiento OSS debe seguir documentado de forma independiente para que los usuarios puedan evaluar el alcance open source sin leer primero documentación comercial.
+Estas capacidades trabajan con **instantáneas Unit** serializables, entre ellas `IWorkbookData` de Sheets, `IDocumentData` de Docs, `ISlideData` de Slides e `IBoardData` de los lienzos (llamados **Boards** en la API). Estos tipos proceden del núcleo y de los respectivos paquetes de producto; las capacidades actuales de Slides y Boards son productos comerciales distribuidos por separado. Las convenciones Unit compartidas permiten a los editores de navegador, servicios de backend y agentes trabajar con el mismo contenido.
-## 🌐 Ecosistema
+Los comandos orquestan las ediciones; **las Mutations describen los cambios de contenido**. La colaboración agrupa esas mutaciones en **changesets**, aplica **transformación operacional (OT)** a los cambios concurrentes y gestiona las revisiones confirmadas y las instantáneas. El historial puede reconstruir una revisión a partir de una instantánea y los changesets posteriores. Lee el [diseño de colaboración](https://docs.univer.ai/blog/ot) y la [descripción general de Collaboration SDK](https://docs.univer.ai/server/collaboration/overview).
+
+**Exchange** convierte las estructuras de archivos de Office en instantáneas de contenido de Univer y viceversa. Para formatos OOXML como **XLSX, DOCX y PPTX**, analiza el archivo y lo transforma en los datos de Sheet, Doc o Slide correspondientes, y genera la representación del archivo al exportar. El contenido convertido puede entrar en los mismos flujos de edición, cálculo, colaboración y agentes. Consulta la [importación y exportación de archivos de Office](https://docs.univer.ai/server/import-export/node).
+
+</details>
-- **Core SDK**: [`dream-num/univer`](https://github.com/dream-num/univer), este monorepo.
-- **Presets**: los [`presets/`](../../presets) de este repositorio, colecciones de plugins para aplicaciones en navegador y Node.js.
-- **AI agent skills**: [`dream-num/univer-sdk-skills`](https://github.com/dream-num/univer-sdk-skills), instrucciones reutilizables para agentes de IA que trabajan con integración de Univer, funciones Pro, desarrollo de plugins y backends Node. Consulta la [guía de AI Skills](https://docs.univer.ai/guides/skills).
-- **Documentación**: [docs.univer.ai](https://docs.univer.ai), con guías de Web SDK, Server SDK y AI SDK, además de la referencia de la API.
-- **Web SDK**: [editores integrables y procesamiento sin interfaz](https://docs.univer.ai/guides/sheets) en el navegador y en Node.js.
-- **Server SDK**: [colaboración y conversión de archivos](https://docs.univer.ai/server), integradas con el almacenamiento, la autenticación y los permisos de tu aplicación.
-- **AI SDK**: [flujos de agentes](https://docs.univer.ai/ai) para inspeccionar, editar y verificar contenido ofimático.
-- **API Reference**: [docs.univer.ai/reference](https://docs.univer.ai/reference/classes/univer), Facade API y referencia de API generada.
-- **Ejemplos y showcase**: [Univer Showcase](https://docs.univer.ai/showcase) y los [`examples/`](../../examples) de este repositorio.
-- **AI-native spreadsheets**: [`dream-num/univer-mcp`](https://github.com/dream-num/univer-mcp), integración Univer Platform / MCP para controlar Univer Sheets con lenguaje natural.
+<details>
+<summary>Cómo AI SDK ofrece a los agentes las mismas capacidades de contenido</summary>
+
+AI SDK se basa en los **modelos de contenido Headless, comandos, cálculo y APIs Facade** de Web SDK. Expone APIs TypeScript estructuradas y presets opcionales de Commander que las aplicaciones pueden combinar para crear su propia CLI de Office o herramientas para agentes.
+
+- **Comprender, descubrir y editar.** La inspección devuelve contenido estructurado. API Reference ayuda al agente a encontrar los símbolos y las firmas de Facade incluidos en su SDK. La ejecución de Facade distingue los modos de lectura y escritura, captura mutaciones y trabaja con sincronización explícita y resultados de commit. Consulta las [operaciones de contenido](https://docs.univer.ai/ai/content-operations).
+- **Comprobar el resultado renderizado.** Un Render Runtime de navegador reutiliza el renderizado de Web SDK para obtener capturas. La comprobación del diseño de diapositivas añade resultados estructurados para problemas como texto fuera de página o superpuesto, dando al agente evidencias para otra ronda de edición. Consulta la [inspección visual](https://docs.univer.ai/ai/visual-inspection).
+- **Editar borradores para revisión humana.** Con las capacidades de colaboración y Web correspondientes, los agentes pueden editar y verificar un borrador aislado de Worktree durante varias rondas y entregarlo después a una persona para que lo revise, fusione o reabra. El flujo usa las mismas convenciones de instantáneas, mutaciones y revisiones. Consulta [Worktree](https://docs.univer.ai/ai/worktree).
+
+Para llamadas repetidas, los [pools de Workers y un daemon](https://docs.univer.ai/ai/runtime-architecture) opcionales reutilizan las instancias de contenido cargadas y reducen la inicialización repetida. Tu aplicación se encarga de la CLI raíz, los destinos, la autorización y la salida. Explora el [catálogo de paquetes de AI SDK](https://docs.univer.ai/ai/packages) para seleccionar las capacidades necesarias.
+
+</details>
-## 📦 Guía del repositorio
+<p align="right"><a href="#readme-top"><img src="https://img.shields.io/badge/%E2%86%91%20Volver%20arriba-30363D?style=flat-square" alt="Volver arriba" height="20" /></a></p>
+
+<a id="application-patterns-and-ecosystem"></a>
+
+## 🌐 Patrones de aplicación y ecosistema
+
+<p align="center"><img src="../../docs/img/readme/ecosystem-banner.png" alt="" width="960" /></p>
+
+<a id="univer-workspace-an-office-sdk-reference-application"></a>
+
+### Univer Workspace: una aplicación de referencia de Office SDK
+
+Para ver una aplicación de referencia completa, empieza por [Univer Workspace](https://github.com/dream-num/univer-workspace). Muestra cómo combinar los editores de Univer Office SDK, colaboración, capacidades de archivos, agentes existentes y revisión humana en un espacio de trabajo autoalojable. Sigue sus patrones de integración al crear tu propia aplicación de oficina o espacio de trabajo para agentes.
+
+<div align="center" style="overflow-x: auto;">
+
+<table align="center" style="display: table; width: auto; margin-left: auto; margin-right: auto;">
+ <tr>
+ <td width="50%" valign="top">
+ <a href="https://space.univer.ai/"><img src="../../docs/img/readme/workspace.webp" alt="Una hoja de presupuesto editable en Univer Workspace" width="420" /></a>
+ </td>
+ <td width="50%" valign="top">
+ <a href="https://univer.ai/demo/web-app"><img src="../../docs/img/readme/web-app.webp" alt="Una Web App con controles de supuestos junto a su hoja de cálculo editable conectada" width="420" /></a>
+ </td>
+ </tr>
+ <tr>
+ <td width="50%" valign="top">
+ <strong>Agentes y contenido de Office editable</strong><br />
+ Reúne conversaciones, edición de hojas de cálculo y contenido de Office en un único espacio de trabajo.<br />
+ <a href="https://space.univer.ai/">Prueba Workspace</a> · <a href="https://github.com/dream-num/univer-workspace">Código fuente y configuración de Workspace</a>
+ </td>
+ <td width="50%" valign="top">
+ <strong>Web App × Sheet · Experimental</strong><br />
+ Vincula controles a celdas: la aplicación escribe en la hoja y los cambios de la hoja actualizan la aplicación.<br />
+ <a href="https://univer.ai/demo/web-app">Prueba la demo de aplicación basada en hojas</a>
+ </td>
+ </tr>
+</table>
+
+</div>
+
+Workspace es de código abierto; sus dependencias del SDK siguen sus respectivas licencias. Consulta la [descripción general de Workspace](https://univer.ai/workspace/) para conocer las aplicaciones conectadas y los flujos de revisión.
+
+<p align="center"><a href="https://www.youtube.com/watch?v=1p-SMEiK6Kg"><img src="../../docs/img/readme/integration-demo.png" alt="Ver una demo de integración del SDK" width="720" /></a></p>
+
+[Ver una demo de integración del SDK](https://www.youtube.com/watch?v=1p-SMEiK6Kg)
+
+<a id="cli-agent-integrations-and-developer-skills"></a>
+
+### CLI, integraciones de agentes y skills para desarrolladores
+
+Las mismas capacidades del SDK también se pueden combinar con los agentes y las herramientas que ya utilizas:
+
+<div align="center" style="overflow-x: auto;">
+
+<table align="center" style="display: table; width: auto; margin-left: auto; margin-right: auto;">
+<thead>
+<tr>
+<th>Proyecto</th>
+<th>Qué ofrece</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td><a href="https://github.com/dream-num/univer-cli">Univer CLI</a></td>
+<td>Un espacio de trabajo local por línea de comandos para crear, editar, inspeccionar y entregar contenido de Office.</td>
+</tr>
+<tr>
+<td><a href="https://github.com/dream-num/dsh-univer-office">Univer Office for DeepSeek Harness</a></td>
+<td>Contenido vinculado, verificación de resultados, cambios versionados y colaboración aislada con Worktree.</td>
+</tr>
+<tr>
+<td><a href="https://github.com/dream-num/workbuddy-univer-office">Univer Office for WorkBuddy</a></td>
+<td>Integración local de Office, vistas previas MCP y revisión de borradores. Versión preliminar para desarrolladores.</td>
+</tr>
+<tr>
+<td><a href="https://github.com/dream-num/openclaw-univer-office">Univer Office for OpenClaw</a></td>
+<td>Herramientas para crear, revisar y entregar contenido de Office.</td>
+</tr>
+<tr>
+<td><a href="https://github.com/dream-num/univer-sdk-skills">Univer SDK Skills</a></td>
+<td>Instrucciones que ayudan a los agentes de programación a integrar el SDK, desarrollar plugins e implementar flujos de backend.</td>
+</tr>
+</tbody>
+</table>
+
+</div>
+
+Cada repositorio documenta su configuración y sus dependencias del SDK. Explora el [ecosistema](https://univer.ai/ecosystem/) para encontrar puntos de entrada para agentes, o la [documentación](https://docs.univer.ai/) para crear tu propia integración.
+
+<p align="right"><a href="#readme-top"><img src="https://img.shields.io/badge/%E2%86%91%20Volver%20arriba-30363D?style=flat-square" alt="Volver arriba" height="20" /></a></p>
+
+<a id="documentation-and-contributing"></a>
+
+## 📚 Documentación y contribuciones
+
+Gracias a todos los [colaboradores](https://github.com/dream-num/univer/graphs/contributors) que construyen y mejoran Univer. Son bienvenidas las contribuciones a motores, plugins, pruebas, documentación y ejemplos.
+
+<p align="center"><a href="https://docs.univer.ai/guides/sheets">🧩 Web SDK</a> · <a href="https://docs.univer.ai/server">🖥️ Server SDK</a> · <a href="https://docs.univer.ai/ai">🤖 AI SDK</a> · <a href="https://docs.univer.ai/reference/classes/univer">🔧 Referencia de la API</a> · <a href="https://office.univer.ai/">🎮 Demo en vivo</a></p>
+
+<div align="center" style="overflow-x: auto;">
+
+<table align="center" style="display: table; width: auto; margin-left: auto; margin-right: auto;">
+ <tr>
+ <th align="center"><img src="https://cdnjs.cloudflare.com/ajax/libs/browser-logos/75.0.1/edge/edge_64x64.png" width="32" height="32" alt="" /><br />Edge</th>
+ <th align="center"><img src="https://cdnjs.cloudflare.com/ajax/libs/browser-logos/75.0.1/firefox/firefox_64x64.png" width="32" height="32" alt="" /><br />Firefox</th>
+ <th align="center"><img src="https://cdnjs.cloudflare.com/ajax/libs/browser-logos/75.0.1/chrome/chrome_64x64.png" width="32" height="32" alt="" /><br />Chrome</th>
+ <th align="center"><img src="https://cdnjs.cloudflare.com/ajax/libs/browser-logos/75.0.1/safari/safari_64x64.png" width="32" height="32" alt="" /><br />Safari</th>
+ <th align="center"><img src="https://cdnjs.cloudflare.com/ajax/libs/browser-logos/75.0.1/electron/electron_64x64.png" width="32" height="32" alt="" /><br />Electron</th>
+ </tr>
+ <tr>
+ <td align="center"><code>&gt;=88</code></td>
+ <td align="center"><code>&gt;=90</code></td>
+ <td align="center"><code>&gt;=88</code></td>
+ <td align="center"><code>&gt;=14.1</code></td>
+ <td align="center"><code>&gt;=12</code></td>
+ </tr>
+</table>
+
+</div>
+
+<p align="center">Univer se compila con Chrome 88 como objetivo y busca funcionar con las versiones indicadas arriba.</p>
+
+<a id="runtime-compatibility"></a>
+
+### Compatibilidad en tiempo de ejecución
+
+- **Polyfills**: Univer depende de `Intl.Segmenter`. Añade un polyfill como `@formatjs/intl-segmenter` si tu navegador o entorno de ejecución no lo proporciona.
+- **Herramientas de compilación**: recomendamos Vite, esbuild o Webpack 5. Si tu herramienta no admite el campo `exports` de `package.json` (habitual en Webpack 4), puede que necesites configurar asignaciones de rutas adicionales.
+- **React**: la capa de vistas de Univer está construida con React 18, admite React 18 y 19, y ofrece soporte mínimo de compatibilidad para React 16.9+ y 17.
+- **Node.js**: Headless Univer admite Node.js `>=18.17.0`. El desarrollo de este monorepo requiere Node.js `>=22.18`.
+
+<details>
+<summary>Desarrollo en este repositorio</summary>
+
+### Estructura del repositorio
```text
.
-├── packages/ Paquetes core, motores, tipos de documento, plugins UI y plugins de funciones
-├── examples/ Banco de trabajo Vite todo-en-uno para desarrollo local en navegador
-├── common/ Herramientas internas compartidas, storybook y utilidades
-├── tests/ Proyectos adicionales de pruebas de integración
-└── docs/ Notas de arquitectura, imágenes y documentación local del repositorio
+├── packages/ Core packages, engines, document types, UI plugins, and feature plugins
+├── examples/ All-in-one Vite workbench used for local browser development
+├── common/ Shared internal tooling, storybook, and utilities
+├── tests/ Additional integration test projects
+└── docs/ Architecture notes, images, and repository-local documentation
```
-Los README de cada paquete están junto a sus paquetes dentro de [`packages/`](../../packages).
+Los README de cada paquete están junto a su paquete en [`packages/`](../../packages).
-## 🧑‍💻 Desarrollo
+### Desarrollo local
Requisitos:
- Node.js `>=22.18`
-- pnpm `>=11`
+- pnpm: usa la versión declarada en `packageManager` dentro de `package.json`.
```bash
git clone https://github.com/dream-num/univer.git
@@ -364,63 +806,107 @@ pnpm dev
Comandos útiles:
-| Comando | Propósito |
-| --- | --- |
-| `pnpm dev` | Compila y previsualiza el banco de trabajo todo-en-uno de bajo consumo sin HMR. |
-| `pnpm dev:source` | Inicia el banco de trabajo desde el código fuente con HMR; el arranque y el uso de memoria son mayores. |
-| `pnpm build` | Compila los paquetes del workspace, excluyendo paquetes internos de common. |
-| `pnpm test` | Ejecuta pruebas unitarias mediante Turbo. |
-| `pnpm typecheck` | Ejecuta comprobaciones TypeScript mediante Turbo. |
-| `pnpm lint` | Ejecuta ESLint. |
-| `pnpm storybook:dev` | Inicia Storybook para desarrollo de componentes UI. |
+<div align="center" style="overflow-x: auto;">
+
+<table align="center" style="display: table; width: auto; margin-left: auto; margin-right: auto;">
+<thead>
+<tr>
+<th>Comando</th>
+<th>Finalidad</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td><code class="notranslate">pnpm dev</code></td>
+<td>Iniciar el entorno de desarrollo de Sheets y Docs.</td>
+</tr>
+<tr>
+<td><code class="notranslate">pnpm build</code></td>
+<td>Compilar los paquetes del workspace, excluidos los paquetes comunes internos.</td>
+</tr>
+<tr>
+<td><code class="notranslate">pnpm test</code></td>
+<td>Ejecutar pruebas unitarias mediante Turbo.</td>
+</tr>
+<tr>
+<td><code class="notranslate">pnpm typecheck</code></td>
+<td>Ejecutar las comprobaciones de TypeScript mediante Turbo.</td>
+</tr>
+<tr>
+<td><code class="notranslate">pnpm lint</code></td>
+<td>Ejecutar ESLint.</td>
+</tr>
+<tr>
+<td><code class="notranslate">pnpm storybook:dev</code></td>
+<td>Iniciar Storybook para desarrollar componentes de UI.</td>
+</tr>
+</tbody>
+</table>
+
+</div>
Lee [CONTRIBUTING.md](../../CONTRIBUTING.md) antes de abrir un pull request.
-## 📝 Notas para contribuidores
+</details>
+
+<details>
+<summary>Referencias de arquitectura y contribuciones</summary>
+
+- [Paquetes del repositorio](../../packages), [presets](../../presets) y [ejemplos](../../examples).
+- [Crear un Univer isomórfico](../../docs/ISOMORPHIC.md).
+- [Contribuir a Facade API](../../docs/CONTRIBUTING-FACADE.md).
+- [Política de estabilidad de la API](../../docs/API_STABILITY.md).
+- [Convenciones de nombres](../../docs/NAMING_CONVENTION.md) y [Corrección de fugas de memoria](../../docs/FIX_MEMORY_LEAK.md).
+- [Resúmenes de arquitectura](../../docs/tldr) y [notas sobre adjuntos OLE](../../packages/drawing/docs/ole-attachments.md).
-Notas locales del repositorio que vale la pena leer antes de cambios profundos:
+</details>
+
+<p align="right"><a href="#readme-top"><img src="https://img.shields.io/badge/%E2%86%91%20Volver%20arriba-30363D?style=flat-square" alt="Volver arriba" height="20" /></a></p>
-- [Building Isomorphic Univer](../ISOMORPHIC.md): cómo separar lógica de navegador, Node.js, UI y plugins compartidos.
-- [Política de estabilidad de API](../API_STABILITY.md): expectativas sobre stable, experimental, internal, deprecated y breaking changes.
-- [Contributing to Facade API](../CONTRIBUTING-FACADE.md): expectativas de diseño para `FUniver`, `FWorkbook`, `FRange` y clases Facade relacionadas.
-- [Naming Convention](../NAMING_CONVENTION.md): convenciones para archivos, carpetas, interfaces, plugins, comandos y tokens de inyección de dependencias.
-- [Fixing Memory Leaks](../FIX_MEMORY_LEAK.md): patrones comunes de fugas de memoria y flujo de depuración para instancias Univer.
-- [Architecture TLDRs](../tldr): notas breves sobre motor de fórmulas, Web Worker, permisos, selección y comportamiento ref-range.
+<a id="community"></a>
## 💬 Comunidad
-- Haz preguntas en [GitHub Discussions](https://github.com/dream-num/univer/discussions).
-- Habla con la comunidad en [Discord](https://discord.gg/z3NKNT6D2f).
-- Sigue [Twitter / X](https://twitter.com/univerhq) y [YouTube](https://www.youtube.com/@dreamNum).
+Haz preguntas en [GitHub Discussions](https://github.com/dream-num/univer/discussions), únete a [Discord](https://discord.gg/z3NKNT6D2f) y sigue [X](https://twitter.com/univerhq) o [YouTube](https://www.youtube.com/@dreamNum). Lee el [Código de conducta](../../CODE_OF_CONDUCT.md).
+
+<p align="right"><a href="#readme-top"><img src="https://img.shields.io/badge/%E2%86%91%20Volver%20arriba-30363D?style=flat-square" alt="Volver arriba" height="20" /></a></p>
-Lee el [Código de Conducta](../../CODE_OF_CONDUCT.md) antes de participar.
+<a id="security"></a>
## 🔒 Seguridad
Si crees haber encontrado un problema de seguridad, sigue la [Política de Seguridad](../../SECURITY.md).
+<p align="right"><a href="#readme-top"><img src="https://img.shields.io/badge/%E2%86%91%20Volver%20arriba-30363D?style=flat-square" alt="Volver arriba" height="20" /></a></p>
+
+<a id="sponsors"></a>
+
## ❤️ Patrocinadores
Univer cuenta con el apoyo de la comunidad y patrocinadores. Puedes apoyar el proyecto a través de [Open Collective](https://opencollective.com/univer).
-<a href="https://opencollective.com/univer/sponsor/0/website"><img src="https://opencollective.com/univer/sponsor/0/avatar.svg" alt="Sponsor 0" /></a>
-<a href="https://opencollective.com/univer/sponsor/1/website"><img src="https://opencollective.com/univer/sponsor/1/avatar.svg" alt="Sponsor 1" /></a>
-<a href="https://opencollective.com/univer/sponsor/2/website"><img src="https://opencollective.com/univer/sponsor/2/avatar.svg" alt="Sponsor 2" /></a>
-<a href="https://opencollective.com/univer/sponsor/3/website"><img src="https://opencollective.com/univer/sponsor/3/avatar.svg" alt="Sponsor 3" /></a>
-<a href="https://opencollective.com/univer/sponsor/4/website"><img src="https://opencollective.com/univer/sponsor/4/avatar.svg" alt="Sponsor 4" /></a>
-<a href="https://opencollective.com/univer/sponsor/5/website"><img src="https://opencollective.com/univer/sponsor/5/avatar.svg" alt="Sponsor 5" /></a>
-<a href="https://opencollective.com/univer/sponsor/6/website"><img src="https://opencollective.com/univer/sponsor/6/avatar.svg" alt="Sponsor 6" /></a>
-
-<a href="https://opencollective.com/univer/backer/0/website"><img src="https://opencollective.com/univer/backer/0/avatar.svg" alt="Backer 0" /></a>
-<a href="https://opencollective.com/univer/backer/1/website"><img src="https://opencollective.com/univer/backer/1/avatar.svg" alt="Backer 1" /></a>
-<a href="https://opencollective.com/univer/backer/2/website"><img src="https://opencollective.com/univer/backer/2/avatar.svg" alt="Backer 2" /></a>
-<a href="https://opencollective.com/univer/backer/3/website"><img src="https://opencollective.com/univer/backer/3/avatar.svg" alt="Backer 3" /></a>
-<a href="https://opencollective.com/univer/backer/4/website"><img src="https://opencollective.com/univer/backer/4/avatar.svg" alt="Backer 4" /></a>
-<a href="https://opencollective.com/univer/backer/5/website"><img src="https://opencollective.com/univer/backer/5/avatar.svg" alt="Backer 5" /></a>
-<a href="https://opencollective.com/univer/backer/6/website"><img src="https://opencollective.com/univer/backer/6/avatar.svg" alt="Backer 6" /></a>
+<p>
+ <a href="https://opencollective.com/univer/sponsor/0/website"><img src="https://opencollective.com/univer/sponsor/0/avatar.svg" alt="Patrocinar el proyecto" /></a>
+</p>
+
+<p>
+ <a href="https://opencollective.com/univer/backer/0/website"><img src="https://opencollective.com/univer/backer/0/avatar.svg" width="64" height="64" alt="Backer 0" /></a>
+ <a href="https://opencollective.com/univer/backer/1/website"><img src="https://opencollective.com/univer/backer/1/avatar.svg" width="64" height="64" alt="Backer 1" /></a>
+ <a href="https://opencollective.com/univer/backer/2/website"><img src="https://opencollective.com/univer/backer/2/avatar.svg" width="64" height="64" alt="Backer 2" /></a>
+ <a href="https://opencollective.com/univer/backer/3/website"><img src="https://opencollective.com/univer/backer/3/avatar.svg" width="64" height="64" alt="Backer 3" /></a>
+ <a href="https://opencollective.com/univer/backer/4/website"><img src="https://opencollective.com/univer/backer/4/avatar.svg" width="64" height="64" alt="Backer 4" /></a>
+ <a href="https://opencollective.com/univer/backer/5/website"><img src="https://opencollective.com/univer/backer/5/avatar.svg" width="64" height="64" alt="Backer 5" /></a>
+ <a href="https://opencollective.com/univer/backer/6/website"><img src="https://opencollective.com/univer/backer/6/avatar.svg" width="64" height="64" alt="Backer 6" /></a>
+</p>
+
+<p align="right"><a href="#readme-top"><img src="https://img.shields.io/badge/%E2%86%91%20Volver%20arriba-30363D?style=flat-square" alt="Volver arriba" height="20" /></a></p>
+
+<a id="license"></a>
## 📄 Licencia
Copyright (c) 2021-present DreamNum Co., Ltd.
-Publicado bajo la licencia [Apache-2.0](../../LICENSE).
+Los paquetes de código abierto de este repositorio se distribuyen bajo [Apache-2.0](../../LICENSE). Los módulos comerciales del SDK se distribuyen y licencian por separado.
+
+<p align="right"><a href="#readme-top"><img src="https://img.shields.io/badge/%E2%86%91%20Volver%20arriba-30363D?style=flat-square" alt="Volver arriba" height="20" /></a></p>
diff --git a/docs/readme/fr-FR.md b/docs/readme/fr-FR.md
new file mode 100644
index 0000000000..cf7cca7fab
--- /dev/null
+++ b/docs/readme/fr-FR.md
@@ -0,0 +1,912 @@
+<a id="readme-top"></a>
+
+<p align="center"><img src="../../docs/img/readme/hero-banner.png" alt="Univer Office SDK" width="960" /></p>
+
+<h1 align="center">Créez votre propre bureau IA avec Univer Office SDK.</h1>
+
+<p align="center">Commencez avec Sheets et Docs open source, puis connectez votre propre application ou agent.</p>
+
+<p align="center"><a href="#quick-start">🚀 Démarrage rapide</a> · <a href="https://docs.univer.ai/">📚 Documentation</a> · <a href="https://univer.ai/compare/">⚖️ Comparaison des fonctionnalités</a> · <a href="https://univer.ai/">🌐 Site web</a> · <a href="https://docs.univer.ai/showcase">🎮 Exemples</a> · <a href="https://docs.univer.ai/reference/classes/univer">🔧 Référence API</a> · <a href="https://docs.univer.ai/blog">📝 Blog</a></p>
+
+<p align="center"><a href="../../README.md">English</a> · <strong>Français</strong> · <a href="../../docs/readme/de-DE.md">Deutsch</a> · <a href="../../docs/readme/es-ES.md">Español</a> · <a href="../../docs/readme/zh-CN.md">简体中文</a> · <a href="../../docs/readme/zh-TW.md">繁體中文</a> · <a href="../../docs/readme/ja-JP.md">日本語</a> · <a href="../../docs/readme/ko-KR.md">한국어</a></p>
+
+<p align="center">
+ <a href="https://github.com/dream-num/univer/releases"><img src="https://img.shields.io/github/v/release/dream-num/univer?style=flat&amp;labelColor=30363D&amp;color=4F46E5&amp;logo=github&amp;logoColor=white" alt="Release" /></a>
+ <a href="../../LICENSE"><img src="https://img.shields.io/github/license/dream-num/univer?style=flat&amp;labelColor=30363D&amp;color=0F766E" alt="License" /></a>
+ <a href="https://github.com/dream-num/univer/actions/workflows/build-packages.yml"><img src="https://img.shields.io/github/actions/workflow/status/dream-num/univer/build-packages.yml?style=flat&amp;labelColor=30363D" alt="Build" /></a>
+ <a href="https://www.codefactor.io/repository/github/dream-num/univer/overview/dev"><img src="https://www.codefactor.io/repository/github/dream-num/univer/badge/dev?style=flat" alt="CodeFactor" /></a>
+ <a href="https://codecov.io/gh/dream-num/univer"><img src="https://img.shields.io/codecov/c/gh/dream-num/univer?token=aPfyW2pIMN&amp;style=flat&amp;labelColor=30363D" alt="Codecov" /></a>
+</p>
+
+<p align="center">
+ <a href="https://github.com/dream-num/univer"><img src="https://img.shields.io/github/stars/dream-num/univer?style=flat&amp;labelColor=30363D&amp;color=4F46E5" alt="Stars" /></a>
+ <a href="https://github.com/dream-num/univer/graphs/contributors"><img src="https://img.shields.io/github/contributors/dream-num/univer?style=flat&amp;labelColor=30363D&amp;color=4F46E5" alt="Contributors" /></a>
+ <a href="https://github.com/dream-num/univer/issues"><img src="https://img.shields.io/github/issues/dream-num/univer?style=flat&amp;labelColor=30363D&amp;color=4F46E5" alt="Issues" /></a>
+ <a href="https://github.com/dream-num/univer/commits/dev/"><img src="https://img.shields.io/github/last-commit/dream-num/univer?style=flat&amp;labelColor=30363D&amp;color=4F46E5" alt="Last Commit" /></a>
+</p>
+
+<p align="center">
+ <a href="https://discord.gg/z3NKNT6D2f"><img src="https://img.shields.io/discord/1136129819961217077?logo=discord&amp;logoColor=FFFFFF&amp;label=discord&amp;color=5865F2&amp;style=flat&amp;labelColor=30363D" alt="Discord" /></a>
+ <a href="https://twitter.com/univerhq"><img src="https://img.shields.io/badge/%40univerhq-18181B?style=flat&amp;logo=x&amp;logoColor=white" alt="X: @univerhq" /></a>
+ <a href="https://opencollective.com/univer"><img src="https://img.shields.io/opencollective/all/univer?logo=opencollective&amp;style=flat&amp;labelColor=30363D&amp;color=0F766E&amp;label=supporters&amp;logoColor=white" alt="Open Collective" /></a>
+</p>
+
+<p align="center">
+ <a href="https://trendshift.io/repositories/4376"><img src="https://trendshift.io/api/badge/repositories/4376" alt="Trendshift" /></a>
+</p>
+
+<details>
+<summary>Sommaire</summary>
+
+- [💡 Qu'est-ce qu'Univer ?](#what-is-univer)
+ - [Capacités open source](#open-source-capabilities)
+- [🚀 Construisez sur la base open source](#what-you-can-build)
+ - [Démarrage rapide : un éditeur de feuilles de calcul open source](#quick-start)
+ - [Connectez votre application au contenu éditable](#connect-your-application-to-editable-content)
+- [🏗️ Explorez l'architecture open source](#open-source-architecture)
+ - [Définissez des frontières claires pour les fonctionnalités personnalisées](#give-custom-features-clear-boundaries)
+ - [Assemblez les modifications et annuler/rétablir entre fonctionnalités](#compose-cross-feature-edits-and-undoredo)
+ - [Connectez les applications et les agents via les API Facade et les événements](#connect-applications-and-agents-through-facade-apis-and-events)
+- [🧩 Étendez votre application avec Univer Office SDK](#open-source-and-commercial-extensions)
+ - [Périmètre et licences](#scope-and-licensing)
+- [🌐 Modèles d'application et écosystème](#application-patterns-and-ecosystem)
+ - [Univer Workspace : une application de référence d'Office SDK](#univer-workspace-an-office-sdk-reference-application)
+ - [CLI, intégrations d'agents et skills pour les développeurs](#cli-agent-integrations-and-developer-skills)
+- [📚 Documentation et contributions](#documentation-and-contributing)
+ - [Compatibilité à l'exécution](#runtime-compatibility)
+- [💬 Communauté](#community)
+- [🔒 Sécurité](#security)
+- [❤️ Sponsors](#sponsors)
+- [📄 Licence](#license)
+
+</details>
+
+<a id="what-is-univer"></a>
+
+## 💡 Qu'est-ce qu'Univer ?
+
+<p align="center"><img src="../../docs/img/readme/intro-banner.png" alt="Univer Office SDK: Web, Server, and AI SDKs" width="960" /></p>
+
+**Univer** est un SDK bureautique permettant de créer des applications Office au sein de votre propre produit. Il fournit des capacités d'édition, de calcul, de collaboration et de traitement de fichiers Office aux utilisateurs et aux agents existants, avec vos données et vos autorisations. La gamme de produits couvre les feuilles de calcul, les documents, les présentations, les tables relationnelles, les canevas et les PDF.
+
+Univer Office SDK comprend trois parties :
+
+- **Web SDK** constitue la base : modèles de contenu, édition, rendu, calcul de formules et API Facade (API destinées aux applications). Assemblez ses plugins dans un éditeur intégré ou votre propre application Office, et réutilisez les modèles de contenu, les commandes et le calcul pour un traitement Headless sans éditeur interactif.
+- **Server SDK** ajoute des services backend pour la collaboration en temps réel, l'historique des modifications et l'importation et l'exportation de fichiers Office.
+- **AI SDK** relie les capacités Office aux agents et aux workflows existants, avec des outils de contenu et des intégrations d'exécution et de révision.
+
+**Ce dépôt fournit l'architecture centrale et les implémentations des moteurs de Web SDK sous Apache-2.0** : modèles de contenu et formats de snapshots, gestion des plugins et des dépendances, système de commandes, moteurs de formules et de rendu, API Facade, infrastructure UI et capacités d'édition de Sheets et Docs. Les plugins commerciaux de Web SDK, Server SDK et les extensions commerciales d'AI SDK sont distribués et licenciés séparément.
+
+Les agents peuvent utiliser les mêmes API open source ; votre application fournit le modèle et l'orchestration des outils. L'[exemple de devis](#connect-your-application-to-editable-content) montre comment modifier, calculer et enregistrer sans dépendre d'AI SDK.
+
+<a id="open-source-capabilities"></a>
+
+### Capacités open source
+
+<div align="center" style="overflow-x: auto;">
+
+<table align="center" style="display: table; width: auto; margin-left: auto; margin-right: auto;">
+<thead>
+<tr>
+<th>Domaine</th>
+<th>Sélection de fonctionnalités</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td><strong>Sheets · Édition et mise en page</strong></td>
+<td>Styles de cellules, cellules fusionnées, texte enrichi dans les cellules, volets figés, images flottantes et annuler/rétablir.</td>
+</tr>
+<tr>
+<td><strong>Sheets · Données et calcul</strong></td>
+<td>Formules, noms définis, filtrage, tri, validation des données, mise en forme conditionnelle, hyperliens, commentaires et rechercher/remplacer.</td>
+</tr>
+<tr>
+<td><strong>Docs</strong></td>
+<td>Édition de texte enrichi, mise en forme des paragraphes, listes, hyperliens, commentaires et intégration des dessins.</td>
+</tr>
+</tbody>
+</table>
+
+</div>
+
+Les fonctionnalités sont assemblées au moyen de plugins et de presets ; le [démarrage rapide](#quick-start) utilise uniquement le **preset Sheets Core**. Les images nécessitent les plugins de dessin correspondants. Consultez la [comparaison des fonctionnalités](https://univer.ai/compare/) pour le détail des capacités open source et commerciales.
+
+Les démonstrations ci-dessous présentent l'ensemble plus large d'**Univer Office SDK**, y compris des capacités commerciales. Elles vont au-delà de la configuration open source par défaut ; consultez [l'open source et les extensions commerciales](#open-source-and-commercial-extensions) pour en connaître le périmètre.
+
+<div align="center" style="overflow-x: auto;">
+
+<table align="center" style="display: table; width: auto; margin-left: auto; margin-right: auto;">
+<tbody>
+<tr>
+ <td width="50%"><a href="https://univer.ai/demo/spreadsheets"><img src="../../docs/img/readme/cards/sheets.webp" alt="Sheets — Édition et mise en page · Données et calcul — Ouvrir la démo" width="420" /></a></td>
+ <td width="50%"><a href="https://univer.ai/demo/docs"><img src="../../docs/img/readme/cards/docs.webp" alt="Docs — Édition de texte enrichi — Ouvrir la démo" width="420" /></a></td>
+</tr>
+<tr>
+ <td width="50%"><a href="https://univer.ai/demo/web-app"><img src="../../docs/img/readme/cards/web-app.webp" alt="Web App — Applications pilotées par des feuilles — Ouvrir la démo" width="420" /></a></td>
+ <td width="50%"><a href="https://univer.ai/demo/universe"><img src="../../docs/img/readme/cards/universe.webp" alt="Univer — Contenu Office composé — Ouvrir la démo" width="420" /></a></td>
+</tr>
+<tr>
+ <td width="50%"><a href="https://univer.ai/demo/slides"><img src="../../docs/img/readme/cards/slides.webp" alt="Slides — Ouvrir la démo" width="420" /></a></td>
+ <td width="50%"><a href="https://univer.ai/demo/relational-tables"><img src="../../docs/img/readme/cards/relational-tables.webp" alt="Relational Tables — Ouvrir la démo" width="420" /></a></td>
+</tr>
+<tr>
+ <td width="50%"><a href="https://univer.ai/demo/canvases"><img src="../../docs/img/readme/cards/canvases.webp" alt="Canvases — Ouvrir la démo" width="420" /></a></td>
+ <td width="50%"><a href="https://univer.ai/demo/pdf"><img src="../../docs/img/readme/cards/pdf.webp" alt="PDF — Ouvrir la démo" width="420" /></a></td>
+</tr>
+</tbody>
+</table>
+
+</div>
+
+<p align="right"><a href="#readme-top"><img src="https://img.shields.io/badge/%E2%86%91%20Retour%20en%20haut-30363D?style=flat-square" alt="Retour en haut" height="20" /></a></p>
+
+<a id="what-you-can-build"></a>
+
+## 🚀 Construisez sur la base open source
+
+<p align="center"><img src="../../docs/img/readme/build-banner.png" alt="Build on open source" width="960" /></p>
+
+<div align="center" style="overflow-x: auto;">
+
+<table align="center" style="display: table; width: auto; margin-left: auto; margin-right: auto;">
+<thead>
+<tr>
+<th>Votre objectif</th>
+<th>Utiliser la base open source</th>
+<th>Par où commencer</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td><strong>Intégrer Sheets ou Docs</strong></td>
+<td>Ajoutez une interface Office éditable à votre application ou produit d'agents, et connectez vos données via les API Facade.</td>
+<td><a href="#quick-start">Démarrage rapide</a></td>
+</tr>
+<tr>
+<td><strong>Traiter du contenu sans éditeur</strong></td>
+<td>Réutilisez les plugins de contenu, les modèles, les commandes et le calcul dans Node.js pour l'édition, les snapshots et les tâches automatisées.</td>
+<td><a href="https://docs.univer.ai/guides/sheets/getting-started/node">Guide Headless</a></td>
+</tr>
+<tr>
+<td><strong>Développer des fonctionnalités ou des éditeurs personnalisés</strong></td>
+<td>Réutilisez les moteurs, les composants UI, les frontières entre plugins, l'injection de dépendances et les systèmes de commandes et d'annulation. Appuyez-vous sur les fonctionnalités existantes pour étendre Sheets et Docs ou développer vos propres éditeurs.</td>
+<td><a href="#open-source-architecture">Architecture open source</a></td>
+</tr>
+</tbody>
+</table>
+
+</div>
+
+**Coordonnez les modifications et annuler/rétablir entre fonctionnalités.** Insérer une ligne dans une plage de filtre modifie à la fois le contenu de base et la plage du filtre ; l'annulation doit restaurer les deux. Chaque fonctionnalité fournit ses propres modifications et données d'annulation, et la commande assemble leur exécution et leur historique. La présentation de l'architecture explique comment étendre ces workflows d'édition.
+
+<a id="quick-start"></a>
+
+### Démarrage rapide : un éditeur de feuilles de calcul open source
+
+Dans une application de navigateur utilisant un bundler comme Vite :
+
+```bash
+pnpm add @univerjs/presets @univerjs/preset-sheets-core
+```
+
+Créez le conteneur avant d'initialiser Univer :
+
+```html
+<div id="app" style="height: 100vh"></div>
+```
+
+```ts
+import { UniverSheetsCorePreset } from '@univerjs/preset-sheets-core'
+import UniverPresetSheetsCoreEnUS from '@univerjs/preset-sheets-core/locales/en-US'
+import { createUniver, LocaleType, mergeLocales } from '@univerjs/presets'
+import '@univerjs/preset-sheets-core/lib/index.css'
+
+const { univerAPI } = createUniver({
+ locale: LocaleType.EN_US,
+ locales: {
+ [LocaleType.EN_US]: mergeLocales(UniverPresetSheetsCoreEnUS),
+ },
+ presets: [
+ UniverSheetsCorePreset({
+ container: 'app',
+ }),
+ ],
+})
+
+univerAPI.createWorkbook({})
+```
+
+Votre page contient désormais un éditeur de feuilles de calcul. Utilisez l'objet `univerAPI` retourné pour manipuler son contenu. Cet exemple utilise des packages open source et ne nécessite ni licence commerciale Univer ni Server SDK.
+
+Avec un framework à composants, conservez l'instance `univer` retournée par `createUniver` et appelez `univer.dispose()` lors du démontage du composant. Consultez le [guide du cycle de vie](https://docs.univer.ai/guides/sheets/getting-started/lifecycle).
+
+Les presets assemblent les plugins et enregistrent leurs API Facade. Pour un contrôle manuel, consultez l'[exemple Plugin Mode](#manual-plugin-composition) ci-dessous. Le [guide d'installation](https://docs.univer.ai/guides/sheets/getting-started/installation) couvre les deux modes, les dépendances peer et les intégrations avec les frameworks.
+
+Maintenez les packages coordonnés `@univerjs/*` à la même version. Les packages commerciaux doivent utiliser la série de versions correspondante ; les packages publiés indépendamment, comme les icônes, suivent la compatibilité qu'ils déclarent. Consultez la [politique de stabilité des API](../../docs/API_STABILITY.md).
+
+<a id="connect-your-application-to-editable-content"></a>
+
+### Connectez votre application au contenu éditable
+
+Les API Facade constituent l'interface de l'application avec les classeurs, les feuilles et les plages. Poursuivez le démarrage rapide pour remplir un devis, modifier une quantité depuis le code de l'application et lire le total recalculé :
+
+```ts
+// Wait for formula controllers before editing a newly created workbook.
+await new Promise<void>((resolve) => {
+ if (univerAPI.getCurrentLifecycleStage() >= univerAPI.Enum.LifecycleStages.Steady) {
+ resolve()
+ return
+ }
+ const listener = univerAPI.addEvent(univerAPI.Event.LifeCycleChanged, ({ stage }) => {
+ if (stage === univerAPI.Enum.LifecycleStages.Steady) {
+ listener.dispose()
+ resolve()
+ }
+ })
+})
+
+const workbook = univerAPI.getActiveWorkbook()!
+const sheet = workbook.getActiveSheet()
+
+sheet.getRange('A1:D4').setValues([
+ ['Item', 'Quantity', 'Unit price', 'Amount'],
+ ['Seats', 2, 25, '=B2*C2'],
+ ['Support', 1, 100, '=B3*C3'],
+ ['Total', '', '', '=SUM(D2:D3)'],
+])
+
+// An application control or agent can make the same edit.
+sheet.getRange('B2').setValue(4)
+
+univerAPI.getFormula().onCalculationResultApplied().then(() => {
+ console.log(sheet.getRange('D4').getValue()) // 200
+ localStorage.setItem('quotation', JSON.stringify(workbook.save()))
+}).catch(console.error)
+```
+
+L'éditeur et votre application travaillent sur le même classeur ; les modifications des formules sont recalculées automatiquement. `workbook.save()` retourne un snapshot JSON contenant le classeur et les données de ses plugins enregistrés. La persistance relève de votre application ; cet exemple utilise le stockage du navigateur. Lors d'un chargement ultérieur de la page, après l'initialisation, restaurez le snapshot **au lieu de créer un classeur vide** :
+
+```ts
+const saved = localStorage.getItem('quotation')
+if (saved) {
+ univerAPI.createWorkbook(JSON.parse(saved))
+}
+```
+
+Ce workflow utilise uniquement des packages open source. La persistance des snapshots est distincte de l'importation et de l'exportation XLSX, qui utilisent les capacités de conversion de fichiers distribuées séparément. Utilisez les API Facade publiques pour intégrer votre application ; les liens vers le code source ci-dessous expliquent l'implémentation interne et les points d'extension. Consultez la [politique de stabilité des API](../../docs/API_STABILITY.md) avant de dépendre d'un point d'extension.
+
+<a id="manual-plugin-composition"></a>
+
+<details>
+<summary>Avancé : assembler les plugins manuellement (Plugin Mode)</summary>
+
+Utilisez Plugin Mode si vous avez besoin d'un contrôle précis sur la sélection, les dépendances ou le chargement des plugins. Le preset précédent gère cet assemblage pour vous.
+
+Cette initialisation alternative utilise le même conteneur `app` et la pile de plugins de navigateur du preset Sheets Core, sans Worker. Utilisez-la **à la place de** l'initialisation par preset, puis exécutez le même exemple de devis avec l'objet `univerAPI` retourné.
+
+```bash
+pnpm add @univerjs/core @univerjs/design @univerjs/docs @univerjs/docs-ui \
+ @univerjs/engine-formula @univerjs/engine-render @univerjs/network \
+ @univerjs/sheets @univerjs/sheets-ui @univerjs/sheets-formula \
+ @univerjs/sheets-formula-ui @univerjs/sheets-numfmt \
+ @univerjs/sheets-numfmt-ui @univerjs/ui
+```
+
+```ts
+import { LocaleType, mergeLocales, Univer } from '@univerjs/core'
+import { FUniver } from '@univerjs/core/facade'
+import DesignEnUS from '@univerjs/design/locale/en-US'
+import { UniverDocsPlugin } from '@univerjs/docs'
+import { UniverDocsUIPlugin } from '@univerjs/docs-ui'
+import DocsUIEnUS from '@univerjs/docs-ui/locale/en-US'
+import { UniverFormulaEnginePlugin } from '@univerjs/engine-formula'
+import FormulaEnUS from '@univerjs/engine-formula/locale/en-US'
+import { UniverRenderEnginePlugin } from '@univerjs/engine-render'
+import { UniverNetworkPlugin } from '@univerjs/network'
+import { UniverSheetsPlugin } from '@univerjs/sheets'
+import SheetsEnUS from '@univerjs/sheets/locale/en-US'
+import { UniverSheetsFormulaPlugin } from '@univerjs/sheets-formula'
+import SheetsFormulaEnUS from '@univerjs/sheets-formula/locale/en-US'
+import { UniverSheetsFormulaUIPlugin } from '@univerjs/sheets-formula-ui'
+import SheetsFormulaUIEnUS from '@univerjs/sheets-formula-ui/locale/en-US'
+import { UniverSheetsNumfmtPlugin } from '@univerjs/sheets-numfmt'
+import { UniverSheetsNumfmtUIPlugin } from '@univerjs/sheets-numfmt-ui'
+import SheetsNumfmtUIEnUS from '@univerjs/sheets-numfmt-ui/locale/en-US'
+import { UniverSheetsUIPlugin } from '@univerjs/sheets-ui'
+import SheetsUIEnUS from '@univerjs/sheets-ui/locale/en-US'
+import { UniverUIPlugin } from '@univerjs/ui'
+import UIEnUS from '@univerjs/ui/locale/en-US'
+import '@univerjs/design/lib/index.css'
+import '@univerjs/ui/lib/index.css'
+import '@univerjs/docs-ui/lib/index.css'
+import '@univerjs/sheets-ui/lib/index.css'
+import '@univerjs/sheets-formula-ui/lib/index.css'
+import '@univerjs/sheets-numfmt-ui/lib/index.css'
+import '@univerjs/network/facade'
+import '@univerjs/docs/facade'
+import '@univerjs/docs-ui/facade'
+import '@univerjs/engine-formula/facade'
+import '@univerjs/sheets/facade'
+import '@univerjs/ui/facade'
+import '@univerjs/sheets-ui/facade'
+import '@univerjs/sheets-formula/facade'
+import '@univerjs/sheets-numfmt/facade'
+import '@univerjs/sheets-formula-ui/facade'
+
+const univer = new Univer({
+ locale: LocaleType.EN_US,
+ locales: {
+ [LocaleType.EN_US]: mergeLocales(
+ DesignEnUS,
+ DocsUIEnUS,
+ FormulaEnUS,
+ SheetsEnUS,
+ SheetsFormulaEnUS,
+ SheetsFormulaUIEnUS,
+ SheetsNumfmtUIEnUS,
+ SheetsUIEnUS,
+ UIEnUS,
+ ),
+ },
+})
+
+univer.registerPlugin(UniverNetworkPlugin)
+univer.registerPlugin(UniverDocsPlugin)
+univer.registerPlugin(UniverRenderEnginePlugin)
+univer.registerPlugin(UniverUIPlugin, { container: 'app' })
+univer.registerPlugin(UniverDocsUIPlugin)
+univer.registerPlugin(UniverFormulaEnginePlugin)
+univer.registerPlugin(UniverSheetsPlugin, {
+ onlyRegisterFormulaRelatedMutations: false,
+})
+univer.registerPlugin(UniverSheetsUIPlugin, {
+ protectedRangeShadow: true,
+})
+univer.registerPlugin(UniverSheetsNumfmtPlugin)
+univer.registerPlugin(UniverSheetsNumfmtUIPlugin)
+univer.registerPlugin(UniverSheetsFormulaPlugin)
+univer.registerPlugin(UniverSheetsFormulaUIPlugin)
+
+const univerAPI = FUniver.newAPI(univer)
+univerAPI.createWorkbook({})
+```
+
+Les plugins Docs permettent l'édition de texte enrichi dans les feuilles de calcul. Lorsque vous ajoutez une fonctionnalité, incluez les extensions Facade, les ressources linguistiques et les styles UI correspondants. Libérez `univer` lorsque son conteneur est démonté.
+
+</details>
+
+<p align="right"><a href="#readme-top"><img src="https://img.shields.io/badge/%E2%86%91%20Retour%20en%20haut-30363D?style=flat-square" alt="Retour en haut" height="20" /></a></p>
+
+<a id="open-source-architecture"></a>
+
+## 🏗️ Explorez l'architecture open source
+
+<p align="center"><img src="../../docs/img/readme/architecture-banner.png" alt="" width="960" /></p>
+
+<a id="give-custom-features-clear-boundaries"></a>
+
+### Définissez des frontières claires pour les fonctionnalités personnalisées
+
+Univer organise la logique de contenu et les interactions UI dans des plugins distincts. Les plugins de fonctionnalités gèrent les règles et les modifications du contenu ; les plugins UI fournissent l'interface et les interactions utilisateur. Par exemple, `sheets-filter` gère les plages et les règles de filtrage, tandis que `sheets-filter-ui` fournit les panneaux, les menus et les raccourcis.
+
+```mermaid
+%%{init: {'htmlLabels': false, 'theme': 'base', 'themeVariables': {'fontFamily': 'Arial, PingFang SC, Microsoft YaHei, sans-serif', 'fontSize': '17px', 'lineColor': '#64748b'}, 'flowchart': {'htmlLabels': false, 'curve': 'linear', 'nodeSpacing': 28, 'rankSpacing': 45, 'padding': 16, 'wrappingWidth': 270}}}%%
+%% A layered overview, not a complete dependency graph.
+%% Group arrows indicate reuse of the layer below; internal arrows show selected dependencies.
+flowchart TD
+ subgraph FEATURES["Feature Plugins"]
+ direction LR
+ FUI["Filter<br/>UI Plugin"]
+ VUI["Data Validation<br/>UI Plugin"]
+ FILTER["Filter Plugin"]
+ VALIDATION["Data Validation Plugin"]
+ FUI --> FILTER
+ VUI --> VALIDATION
+ end
+
+ subgraph PRODUCTS["Product Plugins"]
+ direction LR
+ SUI["Sheets UI Plugin"]
+ SHEETS["Sheets Plugin"]
+ SUI --> SHEETS
+ end
+
+ subgraph FOUNDATION["Core Framework & Plugins"]
+ direction LR
+ UI["UI Plugin"]
+ FORMULA["Formula Engine Plugin"]
+ RENDER["Render Engine Plugin"]
+ CORE["Core"]
+ UI --> RENDER
+ RENDER --> CORE
+ FORMULA --> CORE
+ end
+
+ FEATURES --> PRODUCTS
+ PRODUCTS --> FOUNDATION
+
+ classDef logic fill:#eff6ff,color:#17365f,stroke:#93b4df,stroke-width:1.5px
+ classDef ui fill:#f0fdf4,color:#17543a,stroke:#91c8a7,stroke-width:1.5px
+ classDef shared fill:#f6f7f9,color:#334155,stroke:#bac3ce,stroke-width:1.5px
+ classDef feature fill:#172d50,color:#ffffff,stroke:#172d50
+ class FUI,VUI ui
+ class FILTER,VALIDATION logic
+ class SUI,SHEETS logic
+ class UI,FORMULA,RENDER,CORE shared
+
+ style FEATURES fill:#f7fcf9,stroke:#b5d8c1,color:#17543a
+ style PRODUCTS fill:#f5f9ff,stroke:#b6cbea,color:#17365f
+ style FOUNDATION fill:#fafbfc,stroke:#cbd2dc,color:#334155
+```
+
+**Figure 1 : trois couches de plugins.** Les plugins de fonctionnalités reposent sur les plugins de produit, qui réutilisent le framework central et ses plugins. Les flèches entre groupes montrent les dépendances envers la couche inférieure ; Core fournit les modèles de contenu, les commandes, l'injection de dépendances et la gestion du cycle de vie. Certains plugins et certaines dépendances sont omis.
+
+Les nouvelles fonctionnalités conservent leurs règles dans leurs propres plugins et coopèrent via des services publics, des commandes et des points d'extension définis. Les plugins UI reposent sur des services et des composants UI partagés.
+
+Les dépendances sont explicites à deux niveaux :
+
+- **Entre plugins :** `DependentOn` déclare les dépendances entre plugins à l'exécution. Le service de plugins les ordonne, et les étapes du cycle de vie séparent l'enregistrement des dépendances, l'initialisation du contenu et l'initialisation de l'UI.
+- **À l'intérieur des plugins :** l'injection de dépendances relie les contrôleurs et les services par leurs dépendances déclarées. Les substitutions prises en charge permettent à une application de remplacer une implémentation, d'adapter un service de plateforme ou de fournir un double de test. Les injecteurs propres à chaque instance séparent l'état de l'application entre les instances d'Univer.
+
+Les enregistrements libérables permettent également de nettoyer les commandes, les écouteurs, les composants et les icônes lorsque leur propriétaire est libéré.
+
+Le [plugin de filtrage](../../packages/sheets-filter/src/plugin.ts) et son [plugin UI](../../packages/sheets-filter-ui/src/plugin.ts) illustrent ces frontières dans du code fonctionnel.
+
+<details>
+<summary>À l'intérieur d'une fonctionnalité : Model, Controller, Service et infrastructure UI</summary>
+
+Pour le filtrage, `sheets-filter` prend en charge la logique de contenu et `sheets-filter-ui` les interactions UI. Chaque module a une responsabilité ciblée.
+
+```mermaid
+%%{init: {'htmlLabels': false, 'theme': 'base', 'themeVariables': {'fontFamily': 'Arial, PingFang SC, Microsoft YaHei, sans-serif', 'fontSize': '17px', 'lineColor': '#64748b'}, 'flowchart': {'htmlLabels': false, 'curve': 'linear', 'nodeSpacing': 28, 'rankSpacing': 45, 'padding': 16, 'wrappingWidth': 270}}}%%
+%% Every arrow means contains. This is code organization, not execution order.
+flowchart LR
+ FEATURE["Filter Feature"]
+ LOGIC["Filter Plugin"]
+ UI["Filter UI Plugin"]
+ MODEL["Model"]
+ SERVICE["Service"]
+ CONTROLLER["Controller"]
+ COMMAND["Command / Mutation"]
+ FACADE["Facade API"]
+ VIEW["View"]
+ UICTRL["UI Controller"]
+ UISERVICE["UI Service"]
+ FEATURE --> LOGIC
+ FEATURE --> UI
+ LOGIC --> MODEL
+ LOGIC --> SERVICE
+ LOGIC --> CONTROLLER
+ LOGIC --> COMMAND
+ LOGIC --> FACADE
+ UI --> VIEW
+ UI --> UICTRL
+ UI --> UISERVICE
+
+ classDef logic fill:#eff6ff,color:#17365f,stroke:#93b4df,stroke-width:1.5px
+ classDef ui fill:#f0fdf4,color:#17543a,stroke:#91c8a7,stroke-width:1.5px
+ classDef shared fill:#f6f7f9,color:#334155,stroke:#bac3ce,stroke-width:1.5px
+ classDef feature fill:#172d50,color:#ffffff,stroke:#172d50
+ class FEATURE feature
+ class LOGIC,MODEL,SERVICE,CONTROLLER,COMMAND,FACADE logic
+ class UI,VIEW,UICTRL,UISERVICE ui
+```
+
+**Figure 2 : organisation du code. Les flèches signifient « contient ».** Les deux plugins peuvent contenir des Controllers et des Services : les Controllers de logique coordonnent les modifications du contenu et les fonctionnalités liées ; les Controllers UI relient les menus, les raccourcis et les interactions, tandis que les Services UI gèrent l'état des panneaux. Ces responsabilités donnent aux nouvelles fonctionnalités une structure cohérente pour leur implémentation et leurs tests.
+
+L'infrastructure UI suit la même séparation. **`@univerjs/design`** fournit les composants et les styles partagés, **`@univerjs/ui`** fournit les services de l'espace de travail, comme les menus, les raccourcis, les panneaux et l'enregistrement des composants, et **`@univerjs/icons`** fournit les icônes. Une fonctionnalité enregistre ses composants et ses icônes, ajoute des menus et raccorde son rendu via ces points d'extension. Les équipes peuvent ajouter un panneau ou une fonctionnalité de barre d'outils en réutilisant l'infrastructure UI de l'application. Consultez la [présentation de l'UI](https://docs.univer.ai/guides/sheets/ui/overview) et l'[enregistrement des composants et des icônes](../../packages/sheets-filter-ui/src/controllers/components.controller.ts) du plugin de filtrage.
+
+</details>
+
+<a id="compose-cross-feature-edits-and-undoredo"></a>
+
+### Assemblez les modifications et annuler/rétablir entre fonctionnalités
+
+Par exemple, lorsque des lignes sont insérées dans une plage de filtre, le plugin de filtrage fournit la modification de plage correspondante et ses données d'annulation. La commande de lignes assemble la modification de base et celles des fonctionnalités participantes, les exécute et enregistre ensemble leurs informations d'annulation et de rétablissement. La fonctionnalité d'insertion de lignes peut utiliser le mécanisme d'extension partagé, tandis que le plugin de filtrage conserve ses règles de mise à jour des plages.
+
+Le système de commandes distingue trois types d'action :
+
+- **Command** orchestre une action métier et les modifications qu'elle nécessite.
+- **Mutation** modifie du contenu enregistré dans un snapshot, avec des paramètres sérialisables.
+- **Operation** modifie un état transitoire, comme un panneau ouvert ou la position de défilement.
+
+**Une structure partagée pour annuler/rétablir.** Pour une modification annulable, l'implémentation de la fonctionnalité fournit les mutations directes et les mutations inverses correspondantes, puis la Command les enregistre via `IUndoRedoService`. Lorsqu'une action touche plusieurs fonctionnalités, la Command peut combiner leurs modifications et leurs données d'annulation dans un seul enregistrement, afin que l'utilisateur puisse annuler et rétablir l'action complète. Consultez l'[extension des commandes](https://docs.univer.ai/blog/custom-command).
+
+Les fonctionnalités doivent toujours coopérer. **Les intercepteurs et les gestionnaires de plages de référence donnent un cadre défini à cette coopération.** Aux points d'extension pris en charge, les plugins apportent des vérifications ou des mutations liées ; les priorités des intercepteurs contrôlent l'ordre lorsque l'API le prévoit.
+
+<details>
+<summary>Exemple : commandes, callbacks, coordination des fonctionnalités et annuler/rétablir</summary>
+
+```mermaid
+%%{init: {'htmlLabels': false, 'theme': 'base', 'themeVariables': {'fontFamily': 'Arial, PingFang SC, Microsoft YaHei, sans-serif', 'fontSize': '17px', 'lineColor': '#64748b'}, 'flowchart': {'htmlLabels': false, 'curve': 'linear', 'nodeSpacing': 28, 'rankSpacing': 45, 'padding': 16, 'wrappingWidth': 270}}}%%
+%% Simplified insert-row example. A command composes mutations and records undo after success.
+%% Events may also fire for nested command executions; not every callback is drawn.
+flowchart TD
+ BEFORE["Before execution<br/>Inspect or cancel"]
+ CMD["Insert-row Command"]
+ BASE["Row mutations"]
+ EXT["Feature extension points<br/>Filter range changes"]
+ MODEL["Execute combined mutations"]
+ UNDO["Record undo and redo"]
+ AFTER["After execution<br/>Notify listeners"]
+ BEFORE --> CMD
+ CMD --> BASE
+ CMD --> EXT
+ BASE --> MODEL
+ EXT --> MODEL
+ MODEL --> UNDO
+ UNDO --> AFTER
+ classDef entry fill:#f6f7f9,color:#334155,stroke:#bac3ce,stroke-width:1.5px
+ classDef core fill:#eff6ff,color:#17365f,stroke:#93b4df,stroke-width:1.5px
+ classDef extension fill:#f0fdf4,color:#17543a,stroke:#91c8a7,stroke-width:1.5px
+ class BEFORE,AFTER entry
+ class CMD,BASE,MODEL,UNDO core
+ class EXT extension
+```
+
+Ce diagramme simplifie un workflow d'insertion de lignes. Les exécutions de commandes imbriquées ont leurs propres callbacks ; il ne montre pas tous les événements ni le chemin distinct des Operations. Consultez la [commande de lignes](../../packages/sheets/src/commands/commands/insert-row-col.command.ts), le [contrôleur de filtrage](../../packages/sheets-filter/src/controllers/sheets-filter.controller.ts) et le [service d'intercepteurs](../../packages/sheets/src/services/sheet-interceptor/sheet-interceptor.service.ts).
+
+</details>
+
+Ces frontières permettent une stratégie de test pratique : tester les modèles et les services séparément, remplacer les dépendances externes via la DI et ajouter des cas de régression pour les actions combinées et annuler/rétablir. Les [tests du contrôleur de filtrage](../../packages/sheets-filter/src/controllers/__tests__/sheets-filter.controller.spec.ts) couvrent les modifications de lignes et de colonnes et leur effet sur le filtrage.
+
+<a id="connect-applications-and-agents-through-facade-apis-and-events"></a>
+
+### Connectez les applications et les agents via les API Facade et les événements
+
+Le dépôt comprend les modèles de contenu, le moteur de formules et le moteur de rendu et de mise en page Canvas utilisés par les éditeurs. Ce sont des briques partagées : le texte enrichi des feuilles de calcul, par exemple, réutilise la mise en page et le rendu des documents. Les fonctionnalités personnalisées peuvent s'appuyer sur ces moteurs au lieu d'implémenter une pile de contenu distincte. Découvrez l'[architecture du moteur de formules](https://docs.univer.ai/blog/formula) et l'[architecture du moteur de rendu](https://docs.univer.ai/blog/rendering).
+
+Les éditeurs de navigateur, les tâches Headless sous Node.js et les Workers assemblés de manière adaptée peuvent réutiliser les plugins de contenu, les modèles, les commandes et le calcul correspondants. Consultez [Headless Univer](https://docs.univer.ai/guides/sheets/getting-started/node) et l'[architecture isomorphe](../../docs/ISOMORPHIC.md).
+
+`ICommandService` expose des callbacks d'exécution permettant aux plugins d'observer les commandes avant et après leur exécution. Les API Facade encapsulent les capacités sous-jacentes dans des objets applicatifs comme `FWorkbook`, `FWorksheet` et `FRange`.
+
+Chaque plugin apporte ses propres extensions Facade, des **événements typés via `univerAPI.Event`** et des **énumérations via `univerAPI.Enum`**. Le code de l'application peut découvrir les noms d'événements et les constantes depuis un point d'entrée unique, sans importer de services privés ni répéter des chaînes. Par exemple, `BeforeCommandExecute` peut inspecter et annuler une exécution ; `CommandExecuted` signale les exécutions aux écouteurs. Les écouteurs retournent des objets libérables, et l'annulation s'applique lorsque l'événement la prend en charge.
+
+Les extensions Facade restent dans les packages de leurs fonctionnalités, afin qu'une API de contenu n'ait pas à importer des API UI sans rapport. Consultez la [conception de Facade](https://docs.univer.ai/blog/facade), les [callbacks de commandes et le pont d'événements](../../packages/core/src/facade/f-univer.ts), ainsi que le [point d'entrée Enum](../../packages/core/src/facade/f-enum.ts).
+
+Le dépôt fournit des implémentations fonctionnelles et des modèles pour les étendre. Lisez le [parcours de l'implémentation du filtrage](https://docs.univer.ai/blog/anatomy) pour un exemple complet, ou la [politique de stabilité des API](../../docs/API_STABILITY.md) avant de dépendre d'un point d'extension.
+
+<p align="right"><a href="#readme-top"><img src="https://img.shields.io/badge/%E2%86%91%20Retour%20en%20haut-30363D?style=flat-square" alt="Retour en haut" height="20" /></a></p>
+
+<a id="open-source-and-commercial-extensions"></a>
+
+## 🧩 Étendez votre application avec Univer Office SDK
+
+<p align="center"><img src="../../docs/img/readme/sdk-banner.png" alt="" width="960" /></p>
+
+Pour disposer de davantage de capacités prêtes à intégrer, assemblez les modules correspondants d'**Univer Office SDK** : types de contenu supplémentaires, plugins d'édition avancée, collaboration, conversion de fichiers et outils pour les agents. Ils étendent les mêmes modèles de contenu, architecture de plugins, système de commandes et conception de Facade présentés ci-dessus, vous permettant de poursuivre votre intégration existante.
+
+<div align="center" style="overflow-x: auto;">
+
+<table align="center" style="display: table; width: auto; margin-left: auto; margin-right: auto;">
+<thead>
+<tr>
+<th>Partie</th>
+<th>Comment elle étend la base</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td><strong>Cœur open source de Web SDK · ce dépôt</strong></td>
+<td>Modèles, moteurs, plugins, infrastructure UI et capacités Sheets et Docs open source, avec les opérations Headless correspondantes sur le contenu. Utilisez-les dans des applications commerciales sous Apache-2.0.</td>
+</tr>
+<tr>
+<td><strong>Plugins commerciaux de Web SDK</strong></td>
+<td>Suivent les modèles Plugin, injection de dépendances, Command/Mutation et extension Facade du cœur. Ajoutent des graphiques, des formes, des tableaux croisés dynamiques, SmartArt et d'autres fonctionnalités pour les types de contenu correspondants.</td>
+</tr>
+<tr>
+<td><strong>Server SDK</strong></td>
+<td>Étend les mêmes modèles de contenu et conventions de mutations avec la collaboration en temps réel, l'historique des révisions et la conversion de fichiers Office. S'intègre à l'identité, aux autorisations et au stockage de votre application.</td>
+</tr>
+<tr>
+<td><strong>Extensions AI SDK</strong></td>
+<td>Réutilisent les capacités Headless et Facade de Web SDK pour fournir des API Node.js composables et des briques de CLI permettant aux agents d'inspecter, de modifier et de vérifier le contenu, avec des intégrations de collaboration et de révision Worktree.</td>
+</tr>
+</tbody>
+</table>
+
+</div>
+
+<a id="scope-and-licensing"></a>
+
+### Périmètre et licences
+
+- **Ce dépôt :** des packages Apache-2.0 utilisables dans des applications commerciales sous cette licence, y compris les capacités Headless open source sur le contenu.
+- **Extensions commerciales :** les plugins commerciaux de Web SDK, Server SDK et les capacités d'AI SDK qui dépassent la base open source sont distribués et licenciés séparément. L'évaluation **Freemium** inclut des filigranes et des limites de fonctionnalités.
+- **Applications de référence :** les applications open source comme Univer Workspace ont leurs propres licences de code source. Leurs dépendances SDK conservent leurs licences respectives.
+
+Consultez la [comparaison des fonctionnalités](https://univer.ai/compare/), notamment son filtre **Open source only**, pour connaître la couverture détaillée, et les [offres et licences](https://univer.ai/pricing/) pour les options commerciales.
+
+<details>
+<summary>Comment les modèles de contenu partagés relient l'édition, la collaboration et les fichiers</summary>
+
+Ces capacités manipulent des **snapshots Unit** sérialisables, notamment `IWorkbookData` pour Sheets, `IDocumentData` pour Docs, `ISlideData` pour Slides et `IBoardData` pour les canevas (appelés **Boards** dans l'API). Ces types proviennent du cœur et des packages de produit respectifs ; les capacités actuelles de Slides et Boards sont des produits commerciaux distribués séparément. Les conventions Unit partagées permettent aux éditeurs de navigateur, aux services backend et aux agents de travailler sur le même contenu.
+
+Les commandes orchestrent les modifications ; **les Mutations décrivent les changements de contenu**. La collaboration regroupe ces mutations en **changesets**, applique la **transformation opérationnelle (OT)** aux modifications concurrentes et gère les révisions confirmées et les snapshots. L'historique peut reconstruire une révision à partir d'un snapshot et des changesets suivants. Consultez la [conception de la collaboration](https://docs.univer.ai/blog/ot) et la [présentation de Collaboration SDK](https://docs.univer.ai/server/collaboration/overview).
+
+**Exchange** convertit les structures de fichiers Office en snapshots de contenu Univer et inversement. Pour les formats OOXML comme **XLSX, DOCX et PPTX**, il analyse le fichier pour produire les données Sheet, Doc ou Slide correspondantes, puis génère la représentation du fichier à l'exportation. Le contenu converti peut rejoindre les mêmes workflows d'édition, de calcul, de collaboration et d'agents. Consultez l'[importation et l'exportation de fichiers Office](https://docs.univer.ai/server/import-export/node).
+
+</details>
+
+<details>
+<summary>Comment AI SDK donne aux agents les mêmes capacités de contenu</summary>
+
+AI SDK repose sur les **modèles de contenu Headless, les commandes, le calcul et les API Facade** de Web SDK. Il expose des API TypeScript structurées et des presets Commander facultatifs que les applications peuvent assembler dans leur propre CLI Office ou leurs outils pour agents.
+
+- **Comprendre, découvrir et modifier.** L'inspection retourne du contenu structuré. API Reference aide l'agent à trouver les symboles et les signatures Facade livrés avec son SDK. L'exécution Facade distingue les modes de lecture et d'écriture, capture les mutations et utilise une synchronisation explicite ainsi que des résultats de commit. Consultez les [opérations sur le contenu](https://docs.univer.ai/ai/content-operations).
+- **Vérifier le résultat du rendu.** Un Render Runtime de navigateur réutilise le rendu de Web SDK pour les captures d'écran. La vérification de mise en page des diapositives ajoute des constats structurés pour des problèmes comme du texte hors page ou superposé, fournissant à l'agent des éléments pour une nouvelle passe d'édition. Consultez l'[inspection visuelle](https://docs.univer.ai/ai/visual-inspection).
+- **Modifier des brouillons pour une révision humaine.** Avec les capacités de collaboration et Web correspondantes, les agents peuvent modifier et vérifier un brouillon Worktree isolé sur plusieurs passes, puis le remettre à une personne pour le réviser, le fusionner ou le rouvrir. Ce workflow utilise les mêmes conventions de snapshots, de mutations et de révisions. Consultez [Worktree](https://docs.univer.ai/ai/worktree).
+
+Pour les appels répétés, des [pools de Workers et un daemon](https://docs.univer.ai/ai/runtime-architecture) facultatifs réutilisent les instances de contenu chargées et réduisent les initialisations répétées. Votre application gère la CLI racine, les cibles, l'autorisation et la sortie. Explorez le [catalogue de packages AI SDK](https://docs.univer.ai/ai/packages) pour sélectionner les capacités nécessaires.
+
+</details>
+
+<p align="right"><a href="#readme-top"><img src="https://img.shields.io/badge/%E2%86%91%20Retour%20en%20haut-30363D?style=flat-square" alt="Retour en haut" height="20" /></a></p>
+
+<a id="application-patterns-and-ecosystem"></a>
+
+## 🌐 Modèles d'application et écosystème
+
+<p align="center"><img src="../../docs/img/readme/ecosystem-banner.png" alt="" width="960" /></p>
+
+<a id="univer-workspace-an-office-sdk-reference-application"></a>
+
+### Univer Workspace : une application de référence d'Office SDK
+
+Pour une application de référence complète, commencez par [Univer Workspace](https://github.com/dream-num/univer-workspace). Elle montre comment assembler les éditeurs d'Univer Office SDK, la collaboration, les capacités de fichiers, les agents existants et la révision humaine dans un espace de travail auto-hébergeable. Suivez ses modèles d'intégration pour construire votre propre application Office ou espace de travail pour agents.
+
+<div align="center" style="overflow-x: auto;">
+
+<table align="center" style="display: table; width: auto; margin-left: auto; margin-right: auto;">
+ <tr>
+ <td width="50%" valign="top">
+ <a href="https://space.univer.ai/"><img src="../../docs/img/readme/workspace.webp" alt="Une feuille de budget éditable dans Univer Workspace" width="420" /></a>
+ </td>
+ <td width="50%" valign="top">
+ <a href="https://univer.ai/demo/web-app"><img src="../../docs/img/readme/web-app.webp" alt="Une Web App avec des contrôles d'hypothèses à côté de sa feuille de calcul éditable connectée" width="420" /></a>
+ </td>
+ </tr>
+ <tr>
+ <td width="50%" valign="top">
+ <strong>Agents et contenu Office éditable</strong><br />
+ Réunissez conversations, édition de feuilles de calcul et contenu Office dans un même espace de travail.<br />
+ <a href="https://space.univer.ai/">Essayer Workspace</a> · <a href="https://github.com/dream-num/univer-workspace">Code source et configuration de Workspace</a>
+ </td>
+ <td width="50%" valign="top">
+ <strong>Web App × Sheet · Expérimental</strong><br />
+ Reliez les contrôles aux cellules : l'application écrit dans la feuille et les modifications de la feuille actualisent l'application.<br />
+ <a href="https://univer.ai/demo/web-app">Essayer la démonstration d'application pilotée par une feuille</a>
+ </td>
+ </tr>
+</table>
+
+</div>
+
+Workspace est open source ; ses dépendances SDK suivent leurs licences respectives. Consultez la [présentation de Workspace](https://univer.ai/workspace/) pour les applications connectées et les workflows de révision.
+
+<p align="center"><a href="https://www.youtube.com/watch?v=1p-SMEiK6Kg"><img src="../../docs/img/readme/integration-demo.png" alt="Voir une démonstration d'intégration du SDK" width="720" /></a></p>
+
+[Voir une démonstration d'intégration du SDK](https://www.youtube.com/watch?v=1p-SMEiK6Kg)
+
+<a id="cli-agent-integrations-and-developer-skills"></a>
+
+### CLI, intégrations d'agents et skills pour les développeurs
+
+Les mêmes capacités SDK peuvent aussi être intégrées aux agents et aux outils que vous utilisez déjà :
+
+<div align="center" style="overflow-x: auto;">
+
+<table align="center" style="display: table; width: auto; margin-left: auto; margin-right: auto;">
+<thead>
+<tr>
+<th>Projet</th>
+<th>Ce qu'il apporte</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td><a href="https://github.com/dream-num/univer-cli">Univer CLI</a></td>
+<td>Un espace de travail local en ligne de commande pour créer, modifier, inspecter et livrer du contenu Office.</td>
+</tr>
+<tr>
+<td><a href="https://github.com/dream-num/dsh-univer-office">Univer Office for DeepSeek Harness</a></td>
+<td>Contenu lié, vérification des résultats, modifications versionnées et collaboration Worktree isolée.</td>
+</tr>
+<tr>
+<td><a href="https://github.com/dream-num/workbuddy-univer-office">Univer Office for WorkBuddy</a></td>
+<td>Intégration Office locale, aperçus MCP et révision des brouillons. Version préliminaire pour développeurs.</td>
+</tr>
+<tr>
+<td><a href="https://github.com/dream-num/openclaw-univer-office">Univer Office for OpenClaw</a></td>
+<td>Outils de création, de révision et de livraison de contenu Office.</td>
+</tr>
+<tr>
+<td><a href="https://github.com/dream-num/univer-sdk-skills">Univer SDK Skills</a></td>
+<td>Instructions aidant les agents de programmation à intégrer le SDK, à développer des plugins et à implémenter des workflows backend.</td>
+</tr>
+</tbody>
+</table>
+
+</div>
+
+Chaque dépôt documente sa configuration et ses dépendances SDK. Explorez l'[écosystème](https://univer.ai/ecosystem/) pour les points d'entrée des agents, ou la [documentation](https://docs.univer.ai/) pour créer votre propre intégration.
+
+<p align="right"><a href="#readme-top"><img src="https://img.shields.io/badge/%E2%86%91%20Retour%20en%20haut-30363D?style=flat-square" alt="Retour en haut" height="20" /></a></p>
+
+<a id="documentation-and-contributing"></a>
+
+## 📚 Documentation et contributions
+
+Merci à tous les [contributeurs](https://github.com/dream-num/univer/graphs/contributors) qui construisent et améliorent Univer. Les contributions aux moteurs, aux plugins, aux tests, à la documentation et aux exemples sont les bienvenues.
+
+<p align="center"><a href="https://docs.univer.ai/guides/sheets">🧩 Web SDK</a> · <a href="https://docs.univer.ai/server">🖥️ Server SDK</a> · <a href="https://docs.univer.ai/ai">🤖 AI SDK</a> · <a href="https://docs.univer.ai/reference/classes/univer">🔧 Référence API</a> · <a href="https://office.univer.ai/">🎮 Démonstration en ligne</a></p>
+
+<div align="center" style="overflow-x: auto;">
+
+<table align="center" style="display: table; width: auto; margin-left: auto; margin-right: auto;">
+ <tr>
+ <th align="center"><img src="https://cdnjs.cloudflare.com/ajax/libs/browser-logos/75.0.1/edge/edge_64x64.png" width="32" height="32" alt="" /><br />Edge</th>
+ <th align="center"><img src="https://cdnjs.cloudflare.com/ajax/libs/browser-logos/75.0.1/firefox/firefox_64x64.png" width="32" height="32" alt="" /><br />Firefox</th>
+ <th align="center"><img src="https://cdnjs.cloudflare.com/ajax/libs/browser-logos/75.0.1/chrome/chrome_64x64.png" width="32" height="32" alt="" /><br />Chrome</th>
+ <th align="center"><img src="https://cdnjs.cloudflare.com/ajax/libs/browser-logos/75.0.1/safari/safari_64x64.png" width="32" height="32" alt="" /><br />Safari</th>
+ <th align="center"><img src="https://cdnjs.cloudflare.com/ajax/libs/browser-logos/75.0.1/electron/electron_64x64.png" width="32" height="32" alt="" /><br />Electron</th>
+ </tr>
+ <tr>
+ <td align="center"><code>&gt;=88</code></td>
+ <td align="center"><code>&gt;=90</code></td>
+ <td align="center"><code>&gt;=88</code></td>
+ <td align="center"><code>&gt;=14.1</code></td>
+ <td align="center"><code>&gt;=12</code></td>
+ </tr>
+</table>
+
+</div>
+
+<p align="center">Univer est compilé avec Chrome 88 comme cible et vise la compatibilité avec les versions indiquées ci-dessus.</p>
+
+<a id="runtime-compatibility"></a>
+
+### Compatibilité à l'exécution
+
+- **Polyfills** : Univer dépend d'`Intl.Segmenter`. Ajoutez un polyfill comme `@formatjs/intl-segmenter` si votre navigateur ou environnement d'exécution ne le fournit pas.
+- **Outils de build** : nous recommandons Vite, esbuild ou Webpack 5. Si votre outil ne prend pas en charge le champ `exports` de `package.json` (cas fréquent avec Webpack 4), des correspondances de chemins supplémentaires peuvent être nécessaires.
+- **React** : la couche de vues d'Univer est construite sur React 18, prend en charge React 18 et 19, et fournit une compatibilité minimale avec React 16.9+ et 17.
+- **Node.js** : Headless Univer prend en charge Node.js `>=18.17.0`. Le développement de ce monorepo nécessite Node.js `>=22.18`.
+
+<details>
+<summary>Développer dans ce dépôt</summary>
+
+### Organisation du dépôt
+
+```text
+.
+├── packages/ Core packages, engines, document types, UI plugins, and feature plugins
+├── examples/ All-in-one Vite workbench used for local browser development
+├── common/ Shared internal tooling, storybook, and utilities
+├── tests/ Additional integration test projects
+└── docs/ Architecture notes, images, and repository-local documentation
+```
+
+Les README propres aux packages se trouvent à côté de chaque package dans [`packages/`](../../packages).
+
+### Développement local
+
+Prérequis :
+
+- Node.js `>=22.18`
+- pnpm : utilisez la version déclarée dans le champ `packageManager` de `package.json`.
+
+```bash
+git clone https://github.com/dream-num/univer.git
+cd univer
+pnpm install
+pnpm dev
+```
+
+Commandes utiles :
+
+<div align="center" style="overflow-x: auto;">
+
+<table align="center" style="display: table; width: auto; margin-left: auto; margin-right: auto;">
+<thead>
+<tr>
+<th>Commande</th>
+<th>Rôle</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td><code class="notranslate">pnpm dev</code></td>
+<td>Démarrer l'environnement de développement de Sheets et Docs.</td>
+</tr>
+<tr>
+<td><code class="notranslate">pnpm build</code></td>
+<td>Compiler les packages du workspace, à l'exclusion des packages common internes.</td>
+</tr>
+<tr>
+<td><code class="notranslate">pnpm test</code></td>
+<td>Exécuter les tests unitaires via Turbo.</td>
+</tr>
+<tr>
+<td><code class="notranslate">pnpm typecheck</code></td>
+<td>Exécuter les vérifications TypeScript via Turbo.</td>
+</tr>
+<tr>
+<td><code class="notranslate">pnpm lint</code></td>
+<td>Exécuter ESLint.</td>
+</tr>
+<tr>
+<td><code class="notranslate">pnpm storybook:dev</code></td>
+<td>Démarrer Storybook pour le développement des composants UI.</td>
+</tr>
+</tbody>
+</table>
+
+</div>
+
+Lisez [CONTRIBUTING.md](../../CONTRIBUTING.md) avant d'ouvrir une pull request.
+
+</details>
+
+<details>
+<summary>Références d'architecture et de contribution</summary>
+
+- [Packages du dépôt](../../packages), [presets](../../presets) et [exemples](../../examples).
+- [Construire un Univer isomorphe](../../docs/ISOMORPHIC.md).
+- [Contribuer à Facade API](../../docs/CONTRIBUTING-FACADE.md).
+- [Politique de stabilité des API](../../docs/API_STABILITY.md).
+- [Conventions de nommage](../../docs/NAMING_CONVENTION.md) et [correction des fuites mémoire](../../docs/FIX_MEMORY_LEAK.md).
+- [Résumés d'architecture](../../docs/tldr) et [notes sur les pièces jointes OLE](../../packages/drawing/docs/ole-attachments.md).
+
+</details>
+
+<p align="right"><a href="#readme-top"><img src="https://img.shields.io/badge/%E2%86%91%20Retour%20en%20haut-30363D?style=flat-square" alt="Retour en haut" height="20" /></a></p>
+
+<a id="community"></a>
+
+## 💬 Communauté
+
+Posez vos questions dans [GitHub Discussions](https://github.com/dream-num/univer/discussions), rejoignez [Discord](https://discord.gg/z3NKNT6D2f) et suivez [X](https://twitter.com/univerhq) ou [YouTube](https://www.youtube.com/@dreamNum). Veuillez lire le [code de conduite](../../CODE_OF_CONDUCT.md).
+
+<p align="right"><a href="#readme-top"><img src="https://img.shields.io/badge/%E2%86%91%20Retour%20en%20haut-30363D?style=flat-square" alt="Retour en haut" height="20" /></a></p>
+
+<a id="security"></a>
+
+## 🔒 Sécurité
+
+Si vous pensez avoir découvert un problème de sécurité, veuillez suivre la [politique de sécurité](../../SECURITY.md).
+
+<p align="right"><a href="#readme-top"><img src="https://img.shields.io/badge/%E2%86%91%20Retour%20en%20haut-30363D?style=flat-square" alt="Retour en haut" height="20" /></a></p>
+
+<a id="sponsors"></a>
+
+## ❤️ Sponsors
+
+Univer est soutenu par la communauté et ses sponsors. Vous pouvez soutenir le projet via [Open Collective](https://opencollective.com/univer).
+
+<p>
+ <a href="https://opencollective.com/univer/sponsor/0/website"><img src="https://opencollective.com/univer/sponsor/0/avatar.svg" alt="Devenir sponsor" /></a>
+</p>
+
+<p>
+ <a href="https://opencollective.com/univer/backer/0/website"><img src="https://opencollective.com/univer/backer/0/avatar.svg" width="64" height="64" alt="Soutien 0" /></a>
+ <a href="https://opencollective.com/univer/backer/1/website"><img src="https://opencollective.com/univer/backer/1/avatar.svg" width="64" height="64" alt="Soutien 1" /></a>
+ <a href="https://opencollective.com/univer/backer/2/website"><img src="https://opencollective.com/univer/backer/2/avatar.svg" width="64" height="64" alt="Soutien 2" /></a>
+ <a href="https://opencollective.com/univer/backer/3/website"><img src="https://opencollective.com/univer/backer/3/avatar.svg" width="64" height="64" alt="Soutien 3" /></a>
+ <a href="https://opencollective.com/univer/backer/4/website"><img src="https://opencollective.com/univer/backer/4/avatar.svg" width="64" height="64" alt="Soutien 4" /></a>
+ <a href="https://opencollective.com/univer/backer/5/website"><img src="https://opencollective.com/univer/backer/5/avatar.svg" width="64" height="64" alt="Soutien 5" /></a>
+ <a href="https://opencollective.com/univer/backer/6/website"><img src="https://opencollective.com/univer/backer/6/avatar.svg" width="64" height="64" alt="Soutien 6" /></a>
+</p>
+
+<p align="right"><a href="#readme-top"><img src="https://img.shields.io/badge/%E2%86%91%20Retour%20en%20haut-30363D?style=flat-square" alt="Retour en haut" height="20" /></a></p>
+
+<a id="license"></a>
+
+## 📄 Licence
+
+Copyright (c) 2021-present DreamNum Co., Ltd.
+
+Les packages open source de ce dépôt sont distribués sous licence [Apache-2.0](../../LICENSE). Les modules commerciaux du SDK sont distribués et licenciés séparément.
+
+<p align="right"><a href="#readme-top"><img src="https://img.shields.io/badge/%E2%86%91%20Retour%20en%20haut-30363D?style=flat-square" alt="Retour en haut" height="20" /></a></p>
diff --git a/docs/readme/ja-JP.md b/docs/readme/ja-JP.md
index d279c9306b..8f44e123b7 100644
--- a/docs/readme/ja-JP.md
+++ b/docs/readme/ja-JP.md
@@ -1,157 +1,296 @@
-<div align="center">
+<a id="readme-top"></a>
-<img src="../img/banner.png" alt="Univer SDK" width="800" />
+<p align="center"><img src="../../docs/img/readme/hero-banner.png" alt="Univer Office SDK" width="960" /></p>
-**AI エージェントのための Office Harness**
+<h1 align="center">Univer Office SDK で独自の AI オフィスを構築。</h1>
-スプレッドシート · ドキュメント · プレゼンテーション · Bases · Boards · PDF
+<p align="center">オープンソースの Sheets と Docs から始め、独自のアプリケーションやエージェントに接続できます。</p>
-高性能で自由にカスタマイズできる Office SDK
+<p align="center"><a href="#quick-start">🚀 クイックスタート</a> · <a href="https://docs.univer.ai/">📚 ドキュメント</a> · <a href="https://univer.ai/compare/">⚖️ 機能比較</a> · <a href="https://univer.ai/">🌐 公式サイト</a> · <a href="https://docs.univer.ai/showcase">🎮 ショーケース</a> · <a href="https://docs.univer.ai/reference/classes/univer">🔧 API Reference</a> · <a href="https://docs.univer.ai/blog">📝 ブログ</a></p>
-Univer は、プラグインアーキテクチャ、Canvas ベースのレンダリング、
-数式エンジン、ブラウザと Node.js の両方で使える Facade API により、
-組み込み型の生産性体験を構築できます。
+<p align="center"><a href="../../README.md">English</a> · <a href="../../docs/readme/fr-FR.md">Français</a> · <a href="../../docs/readme/de-DE.md">Deutsch</a> · <a href="../../docs/readme/es-ES.md">Español</a> · <a href="../../docs/readme/zh-CN.md">简体中文</a> · <a href="../../docs/readme/zh-TW.md">繁體中文</a> · <strong>日本語</strong> · <a href="../../docs/readme/ko-KR.md">한국어</a></p>
-[English](../../README.md) | [简体中文](./zh-CN.md) | [繁體中文](./zh-TW.md) | 日本語 | [한국어](./ko-KR.md) | [Español](./es-ES.md)
+<p align="center">
+ <a href="https://github.com/dream-num/univer/releases"><img src="https://img.shields.io/github/v/release/dream-num/univer?style=flat&amp;labelColor=30363D&amp;color=4F46E5&amp;logo=github&amp;logoColor=white" alt="Release" /></a>
+ <a href="../../LICENSE"><img src="https://img.shields.io/github/license/dream-num/univer?style=flat&amp;labelColor=30363D&amp;color=0F766E" alt="License" /></a>
+ <a href="https://github.com/dream-num/univer/actions/workflows/build-packages.yml"><img src="https://img.shields.io/github/actions/workflow/status/dream-num/univer/build-packages.yml?style=flat&amp;labelColor=30363D" alt="Build" /></a>
+ <a href="https://www.codefactor.io/repository/github/dream-num/univer/overview/dev"><img src="https://www.codefactor.io/repository/github/dream-num/univer/badge/dev?style=flat" alt="CodeFactor" /></a>
+ <a href="https://codecov.io/gh/dream-num/univer"><img src="https://img.shields.io/codecov/c/gh/dream-num/univer?token=aPfyW2pIMN&amp;style=flat&amp;labelColor=30363D" alt="Codecov" /></a>
+</p>
-[🌐 公式サイト](https://univer.ai/) | [📖 ドキュメント](https://docs.univer.ai) | [✨ ショーケース](https://docs.univer.ai/showcase) | [📘 API Reference](https://docs.univer.ai/reference/classes/univer) | [📝 ブログ](https://docs.univer.ai/blog)
+<p align="center">
+ <a href="https://github.com/dream-num/univer"><img src="https://img.shields.io/github/stars/dream-num/univer?style=flat&amp;labelColor=30363D&amp;color=4F46E5" alt="Stars" /></a>
+ <a href="https://github.com/dream-num/univer/graphs/contributors"><img src="https://img.shields.io/github/contributors/dream-num/univer?style=flat&amp;labelColor=30363D&amp;color=4F46E5" alt="Contributors" /></a>
+ <a href="https://github.com/dream-num/univer/issues"><img src="https://img.shields.io/github/issues/dream-num/univer?style=flat&amp;labelColor=30363D&amp;color=4F46E5" alt="Issues" /></a>
+ <a href="https://github.com/dream-num/univer/commits/dev/"><img src="https://img.shields.io/github/last-commit/dream-num/univer?style=flat&amp;labelColor=30363D&amp;color=4F46E5" alt="Last Commit" /></a>
+</p>
-[![Release](https://img.shields.io/github/v/release/dream-num/univer?style=flat-square)](https://github.com/dream-num/univer/releases)
-[![License](https://img.shields.io/github/license/dream-num/univer?style=flat-square)](../../LICENSE)
-[![Build](https://img.shields.io/github/actions/workflow/status/dream-num/univer/build-packages.yml?style=flat-square)](https://github.com/dream-num/univer/actions/workflows/build-packages.yml)
-[![CodeFactor](https://www.codefactor.io/repository/github/dream-num/univer/badge/dev?style=flat-square)](https://www.codefactor.io/repository/github/dream-num/univer/overview/dev)
-[![Codecov](https://img.shields.io/codecov/c/gh/dream-num/univer?token=aPfyW2pIMN&style=flat-square)](https://codecov.io/gh/dream-num/univer)
+<p align="center">
+ <a href="https://discord.gg/z3NKNT6D2f"><img src="https://img.shields.io/discord/1136129819961217077?logo=discord&amp;logoColor=FFFFFF&amp;label=discord&amp;color=5865F2&amp;style=flat&amp;labelColor=30363D" alt="Discord" /></a>
+ <a href="https://twitter.com/univerhq"><img src="https://img.shields.io/badge/%40univerhq-18181B?style=flat&amp;logo=x&amp;logoColor=white" alt="X: @univerhq" /></a>
+ <a href="https://opencollective.com/univer"><img src="https://img.shields.io/opencollective/all/univer?logo=opencollective&amp;style=flat&amp;labelColor=30363D&amp;color=0F766E&amp;label=supporters&amp;logoColor=white" alt="Open Collective" /></a>
+</p>
-[![Stars](https://img.shields.io/github/stars/dream-num/univer?style=flat-square)](https://github.com/dream-num/univer/stargazers)
-[![Contributors](https://img.shields.io/github/contributors/dream-num/univer?style=flat-square)](https://github.com/dream-num/univer/graphs/contributors)
-[![Issues](https://img.shields.io/github/issues/dream-num/univer?style=flat-square)](https://github.com/dream-num/univer/issues)
-[![Last Commit](https://img.shields.io/github/last-commit/dream-num/univer?style=flat-square)](https://github.com/dream-num/univer/commits/dev/)
+<p align="center">
+ <a href="https://trendshift.io/repositories/4376"><img src="https://trendshift.io/api/badge/repositories/4376" alt="Trendshift" /></a>
+</p>
-[![Discord](https://img.shields.io/discord/1136129819961217077?logo=discord&logoColor=FFFFFF&label=discord&color=5865F2&style=flat-square)](https://discord.gg/z3NKNT6D2f)
-[![Twitter](https://img.shields.io/twitter/follow/univerhq?style=flat-square&logo=x)](https://twitter.com/univerhq)
-[![Open Collective](https://img.shields.io/opencollective/all/univer?logo=opencollective&style=flat-square)](https://opencollective.com/univer)
+<details>
+<summary>目次</summary>
+
+- [💡 Univer とは?](#what-is-univer)
+ - [オープンソースの機能](#open-source-capabilities)
+- [🚀 オープンソースの基盤を使って構築](#what-you-can-build)
+ - [クイックスタート:オープンソースのスプレッドシートエディター](#quick-start)
+ - [アプリケーションを編集可能なコンテンツに接続](#connect-your-application-to-editable-content)
+- [🏗️ オープンソースアーキテクチャを知る](#open-source-architecture)
+ - [カスタム機能の境界を明確にする](#give-custom-features-clear-boundaries)
+ - [複数機能の編集と元に戻す/やり直しを組み合わせる](#compose-cross-feature-edits-and-undoredo)
+ - [Facade API とイベントでアプリケーションやエージェントを接続](#connect-applications-and-agents-through-facade-apis-and-events)
+- [🧩 Univer Office SDK でアプリケーションを拡張](#open-source-and-commercial-extensions)
+ - [範囲とライセンス](#scope-and-licensing)
+- [🌐 アプリケーションのパターンとエコシステム](#application-patterns-and-ecosystem)
+ - [Univer Workspace:Office SDK のリファレンスアプリケーション](#univer-workspace-an-office-sdk-reference-application)
+ - [CLI、エージェント統合、開発スキル](#cli-agent-integrations-and-developer-skills)
+- [📚 ドキュメントとコントリビューション](#documentation-and-contributing)
+ - [実行環境の互換性](#runtime-compatibility)
+- [💬 コミュニティ](#community)
+- [🔒 セキュリティ](#security)
+- [❤️ スポンサー](#sponsors)
+- [📄 ライセンス](#license)
+
+</details>
+
+<a id="what-is-univer"></a>
+
+## 💡 Univer とは?
+
+<p align="center"><img src="../../docs/img/readme/intro-banner.png" alt="Univer Office SDK: Web, Server, and AI SDKs" width="960" /></p>
+
+**Univer** は、自社製品の中にオフィスアプリケーションを構築するための Office SDK です。独自のデータと権限を使い、ユーザーや既存のエージェントにオフィス編集、計算、共同作業、ファイル処理を提供します。製品群はスプレッドシート、ドキュメント、プレゼンテーション、リレーショナルテーブル、キャンバス、PDF をカバーします。
+
+Univer Office SDK は 3 つの部分で構成されています。
+
+- **Web SDK** は基盤となる部分で、コンテンツモデル、編集、レンダリング、数式計算、Facade API(アプリケーション向け API)を提供します。プラグインを組み合わせて埋め込みエディターや独自のオフィスアプリケーションを構築でき、対話型エディターを使わずにコンテンツモデル、コマンド、計算を Headless 処理で再利用することもできます。
+- **Server SDK** は、リアルタイム共同作業、編集履歴、オフィスファイルのインポートとエクスポートに対応するバックエンドサービスを追加します。
+- **AI SDK** は、コンテンツツール、実行、レビューの統合を通じて、オフィス機能を既存のエージェントやワークフローに接続します。
+
+**このリポジトリは Web SDK のコアアーキテクチャとエンジン実装を Apache-2.0 で提供します**。内容は、コンテンツモデルとスナップショット形式、プラグインと依存関係の管理、コマンドシステム、数式・レンダリングエンジン、Facade API、UI 基盤、Sheets と Docs の編集機能です。商用 Web SDK プラグイン、Server SDK、商用 AI SDK 拡張は、個別に配布・ライセンス提供されます。
+
+エージェントも同じオープンソース API を使用できます。モデルとツールのオーケストレーションはアプリケーション側で用意します。[見積書の例](#connect-your-application-to-editable-content)では、AI SDK に依存せずに編集、計算、保存を行います。
+
+<a id="open-source-capabilities"></a>
+
+### オープンソースの機能
-[![Trendshift](https://trendshift.io/api/badge/repositories/4376)](https://trendshift.io/repositories/4376)
+<div align="center" style="overflow-x: auto;">
+
+<table align="center" style="display: table; width: auto; margin-left: auto; margin-right: auto;">
+<thead>
+<tr>
+<th>分野</th>
+<th>主な機能</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td><strong>Sheets · 編集とレイアウト</strong></td>
+<td>セルスタイル、セル結合、セル内リッチテキスト、ウィンドウ枠の固定、浮動画像、元に戻す/やり直し。</td>
+</tr>
+<tr>
+<td><strong>Sheets · データと計算</strong></td>
+<td>数式、定義名、フィルター、並べ替え、データの入力規則、条件付き書式、ハイパーリンク、コメント、検索と置換。</td>
+</tr>
+<tr>
+<td><strong>Docs</strong></td>
+<td>リッチテキスト編集、段落書式、リスト、ハイパーリンク、コメント、描画機能の統合。</td>
+</tr>
+</tbody>
+</table>
</div>
-## ✨ Univer とは?
+機能はプラグインとプリセットを組み合わせて構成します。[クイックスタート](#quick-start)では **Sheets Core プリセット**のみを使います。画像には対応する描画プラグインが必要です。オープンソースと商用機能の詳しい範囲は[機能比較](https://univer.ai/compare/)をご覧ください。
+
+以下のデモは、商用機能を含む広範な **Univer Office SDK** を紹介します。標準のオープンソース構成よりも多くの機能が含まれます。範囲については[オープンソースと商用拡張](#open-source-and-commercial-extensions)をご覧ください。
+
+<div align="center" style="overflow-x: auto;">
+
+<table align="center" style="display: table; width: auto; margin-left: auto; margin-right: auto;">
+<tbody>
+<tr>
+ <td width="50%"><a href="https://univer.ai/demo/spreadsheets"><img src="../../docs/img/readme/cards/sheets.webp" alt="Sheets — 編集とレイアウト · データと計算 — デモを開く" width="420" /></a></td>
+ <td width="50%"><a href="https://univer.ai/demo/docs"><img src="../../docs/img/readme/cards/docs.webp" alt="Docs — リッチテキスト編集 — デモを開く" width="420" /></a></td>
+</tr>
+<tr>
+ <td width="50%"><a href="https://univer.ai/demo/web-app"><img src="../../docs/img/readme/cards/web-app.webp" alt="Web App — シートを活用したアプリ — デモを開く" width="420" /></a></td>
+ <td width="50%"><a href="https://univer.ai/demo/universe"><img src="../../docs/img/readme/cards/universe.webp" alt="Univer — 組み合わせたオフィスコンテンツ — デモを開く" width="420" /></a></td>
+</tr>
+<tr>
+ <td width="50%"><a href="https://univer.ai/demo/slides"><img src="../../docs/img/readme/cards/slides.webp" alt="Slides — デモを開く" width="420" /></a></td>
+ <td width="50%"><a href="https://univer.ai/demo/relational-tables"><img src="../../docs/img/readme/cards/relational-tables.webp" alt="Relational Tables — デモを開く" width="420" /></a></td>
+</tr>
+<tr>
+ <td width="50%"><a href="https://univer.ai/demo/canvases"><img src="../../docs/img/readme/cards/canvases.webp" alt="Canvases — デモを開く" width="420" /></a></td>
+ <td width="50%"><a href="https://univer.ai/demo/pdf"><img src="../../docs/img/readme/cards/pdf.webp" alt="PDF — デモを開く" width="420" /></a></td>
+</tr>
+</tbody>
+</table>
-Univer は、自分のプロダクト内にオフィスアプリケーションを作るためのオープンソース SDK です。スプレッドシート、ドキュメント、プレゼンテーション体験に必要な構成要素を提供しつつ、ホスト型アプリや固定 UI を強制しません。
+</div>
-Univer は次のような場面に適しています。
+<p align="right"><a href="#readme-top"><img src="https://img.shields.io/badge/%E2%86%91%20%E5%85%88%E9%A0%AD%E3%81%AB%E6%88%BB%E3%82%8B-30363D?style=flat-square" alt="先頭に戻る" height="20" /></a></p>
+
+<a id="what-you-can-build"></a>
+
+## 🚀 オープンソースの基盤を使って構築
+
+<p align="center"><img src="../../docs/img/readme/build-banner.png" alt="Build on open source" width="960" /></p>
+
+<div align="center" style="overflow-x: auto;">
+
+<table align="center" style="display: table; width: auto; margin-left: auto; margin-right: auto;">
+<thead>
+<tr>
+<th>目的</th>
+<th>オープンソース基盤の使い方</th>
+<th>はじめに</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td><strong>Sheets または Docs を埋め込む</strong></td>
+<td>アプリケーションやエージェント製品に編集可能なオフィス画面を追加し、Facade API でデータを接続します。</td>
+<td><a href="#quick-start">クイックスタート</a></td>
+</tr>
+<tr>
+<td><strong>エディターなしでコンテンツを処理する</strong></td>
+<td>Node.js でコンテンツプラグイン、モデル、コマンド、計算を再利用し、編集、スナップショット、自動化タスクを実行します。</td>
+<td><a href="https://docs.univer.ai/guides/sheets/getting-started/node">Headless ガイド</a></td>
+</tr>
+<tr>
+<td><strong>独自の機能やエディターを開発する</strong></td>
+<td>エンジン、UI コンポーネント、プラグインの境界、依存性注入、コマンド/元に戻すシステムを再利用します。既存機能を参考に Sheets と Docs を拡張したり、独自のエディターを開発したりできます。</td>
+<td><a href="#open-source-architecture">オープンソースアーキテクチャ</a></td>
+</tr>
+</tbody>
+</table>
-- SaaS、社内ツール、BI ワークフロー、AI アプリケーションにスプレッドシートやドキュメント編集を組み込む。
-- ブラウザと同じアーキテクチャで、サーバー上のワークブック/ドキュメント処理を実行する。
-- 必要な機能だけをプラグインで組み合わせる、または presets で素早く始める。
-- カスタムプラグイン、コマンド、サービス、UI コンポーネント、Facade API で振る舞いを拡張する。
+</div>
-Univer は単なるスプレッドシートファイルビューアではありません。独自の生産性インターフェースを構築するためのフレームワークです。
+**複数の機能にまたがる編集と元に戻す/やり直しを連携させます。** フィルター範囲内に行を挿入すると、基礎となるコンテンツとフィルター範囲の両方が変わり、元に戻す際には両方を復元する必要があります。各機能が変更と取り消しデータを提供し、コマンドが実行と履歴をまとめます。アーキテクチャの解説では、こうした編集フローの拡張方法を説明します。
-[Univer の製品群](https://univer.ai/)では、オフィスツールがストレージと計算のランタイムを共有します。異なるツールのコンテンツを自由に組み合わせて埋め込み、参照元の変更に合わせて関連データや参照を更新できます。人と AI エージェントは同じファイルで共同作業できます。製品の対応範囲は[機能一覧](https://univer.ai/capabilities)、このリポジトリの範囲は [Open Source と Pro](#-open-source-と-pro) を参照してください。
+<a id="quick-start"></a>
-### Univer Office SDK でコラボレーションツールを構築
+### クイックスタート:オープンソースのスプレッドシートエディター
-[![Univer Office SDK でコラボレーションツールを構築](https://i.ytimg.com/vi/1p-SMEiK6Kg/maxresdefault.jpg)](https://www.youtube.com/watch?v=1p-SMEiK6Kg)
+Vite などのバンドラーを使うブラウザーアプリケーションで、次を実行します。
-[デモを見る](https://www.youtube.com/watch?v=1p-SMEiK6Kg)
+```bash
+pnpm add @univerjs/presets @univerjs/preset-sheets-core
+```
-## Univer Office SDK で構築されたプロジェクト
+Univer を初期化する前にコンテナーを作成します。
-### 注目の事例:Univer Workspace
+```html
+<div id="app" style="height: 100vh"></div>
+```
-[Univer Workspace](https://github.com/dream-num/univer-workspace) は Univer Office SDK を基盤に構築された、セルフホスト可能なオープンソースのワークスペースです。人と AI エージェントがオフィスコンテンツを作成し、共同作業やレビューを行えます。開発者は完全な実装を参考にして SDK の組み込み方を学び、独自のプロダクトを構築できます。
+```ts
+import { UniverSheetsCorePreset } from '@univerjs/preset-sheets-core'
+import UniverPresetSheetsCoreEnUS from '@univerjs/preset-sheets-core/locales/en-US'
+import { createUniver, LocaleType, mergeLocales } from '@univerjs/presets'
+import '@univerjs/preset-sheets-core/lib/index.css'
-[![連携するスプレッドシートと並んで表示された Workspace のミニアプリ。指標、グラフ、コントロールはセルに紐付いています](../img/workspace-mini-app.png)](https://github.com/dream-num/univer-workspace)
+const { univerAPI } = createUniver({
+ locale: LocaleType.EN_US,
+ locales: {
+ [LocaleType.EN_US]: mergeLocales(UniverPresetSheetsCoreEnUS),
+ },
+ presets: [
+ UniverSheetsCorePreset({
+ container: 'app',
+ }),
+ ],
+})
-- エージェントは、意思決定ダッシュボード、インタラクティブなレポート、業務ダッシュボードなど、スプレッドシートを基盤とするミニアプリを生成できます。
-- Web ページ上の指標、グラフ、コントロールはセルに紐付き、データの読み取り、書き込み、共同更新に対応します。
+univerAPI.createWorkbook({})
+```
-[Univer Workspace を見る](https://github.com/dream-num/univer-workspace)
+これでページにスプレッドシートエディターが表示されます。返された `univerAPI` を使ってコンテンツを操作できます。この例はオープンソースパッケージを使用し、商用 Univer ライセンスや Server SDK は不要です。
-### その他の事例
+コンポーネントフレームワークでは、`createUniver` が返す `univer` インスタンスを保持し、コンポーネントのアンマウント時に `univer.dispose()` を呼び出してください。[ライフサイクルガイド](https://docs.univer.ai/guides/sheets/getting-started/lifecycle)をご覧ください。
-以下のオープンソースプロジェクトは Univer Office SDK を基盤に構築されています。
+プリセットはプラグインを組み合わせ、Facade API を登録します。手動で制御する場合は、下の[プラグインモードの例](#manual-plugin-composition)をご覧ください。[インストールガイド](https://docs.univer.ai/guides/sheets/getting-started/installation)は、両モード、ピア依存関係、フレームワークとの統合を扱います。
-| プロジェクト | 説明 |
-| --- | --- |
-| [Univer Office for DeepSeek Harness](https://github.com/dream-num/dsh-univer-office) | DeepSeek Harness 向けオフィスプラグイン。関連付けられたコンテンツ、検証、エージェントの共同作業用の独立した Worktree を提供します。 |
-| [Univer CLI](https://github.com/dream-num/univer-cli) | エージェントがオフィスコンテンツを作成、編集、検査、納品するためのローカルのコマンドラインワークスペース。 |
-| [Univer Office for WorkBuddy](https://github.com/dream-num/workbuddy-univer-office) | MCP プレビューと下書きレビューに対応する、WorkBuddy 向けローカルのオフィス統合。開発プレビュー版です。 |
-| [Univer Office for OpenClaw](https://github.com/dream-num/openclaw-univer-office) | OpenClaw でオフィスコンテンツを作成、レビュー、納品するためのツール。 |
+連携する `@univerjs/*` パッケージは同じバージョンに揃えてください。商用パッケージは対応するリリース系列を使います。アイコンなど独立してリリースされるパッケージは、それぞれが宣言する互換性に従います。[API 安定性ポリシー](../../docs/API_STABILITY.md)をご覧ください。
-セットアップと SDK のライセンス要件は、各プロジェクトのドキュメントを参照してください。
+<a id="connect-your-application-to-editable-content"></a>
-## 🌟 Highlights
+### アプリケーションを編集可能なコンテンツに接続
-<table>
- <tr>
- <td align="center" width="33%">
- ⚡<br />
- <strong>大規模な編集面に対応</strong><br />
- <sub>Canvas ベースのレンダリングと専用の数式エンジンにより、複雑なワークブックでも応答性を保ちます。</sub>
- </td>
- <td align="center" width="33%">
- 🧩<br />
- <strong>プラグイン前提の設計</strong><br />
- <sub>必要な機能を組み合わせ、置換、遅延読み込み、拡張できます。</sub>
- </td>
- <td align="center" width="33%">
- 🤖<br />
- <strong>Headless AI 基盤</strong><br />
- <sub>Node.js でワークブックとドキュメントのロジックを実行し、エージェント、自動化、サーバーサイドワークフローを支えます。</sub>
- </td>
- </tr>
- <tr>
- <td align="center" width="33%">
- 🛠️<br />
- <strong>プロダクト向け SDK</strong><br />
- <sub>フレームワークアダプター、Facade API、presets、headless runtime が実際の統合経路に対応します。</sub>
- </td>
- <td align="center" width="33%">
- 🌗<br />
- <strong>Dark mode 対応</strong><br />
- <sub>UI コンポーネントとレンダリングエンジンの両方がライト/ダークテーマに対応します。</sub>
- </td>
- <td align="center" width="33%">
- 🔌<br />
- <strong>統合 Facade API</strong><br />
- <sub>ブラウザと Node.js の両方で、ワークブック、範囲、数式、ドキュメントを一貫した API で扱えます。</sub>
- </td>
- </tr>
-</table>
+Facade API は、ワークブック、ワークシート、範囲に対するアプリケーション向けインターフェースです。クイックスタートに続けて見積書を入力し、アプリケーションコードから数量を更新して、再計算後の合計を読み取ります。
-## 🚀 なぜ Univer なのか?
+```ts
+// Wait for formula controllers before editing a newly created workbook.
+await new Promise<void>((resolve) => {
+ if (univerAPI.getCurrentLifecycleStage() >= univerAPI.Enum.LifecycleStages.Steady) {
+ resolve()
+ return
+ }
+ const listener = univerAPI.addEvent(univerAPI.Event.LifeCycleChanged, ({ stage }) => {
+ if (stage === univerAPI.Enum.LifecycleStages.Steady) {
+ listener.dispose()
+ resolve()
+ }
+ })
+})
-- **アイソモーフィック設計**:ブラウザの UI アプリと Node.js のヘッドレス処理の両方で動作します。
-- **プラグイン優先アーキテクチャ**:すべての機能は組み合わせ可能なプラグインとして提供され、追加、削除、置換、遅延読み込みが可能です。
-- **Preset Mode による高速な統合**:すぐに動くアプリが必要な場合は、このリポジトリの [`presets/`](../../presets) にある curated plugin collection を利用できます。
-- **Plugin Mode による完全な制御**:カスタム読み込み、より小さなバンドル、深い統合が必要な場合は、パッケージを手動で組み合わせられます。
-- **Facade API**:ワークブック、ワークシート、範囲、ドキュメント、数式、コマンド、イベントを高レベル API で扱えます。
-- **Canvas レンダリングエンジン**:大規模な編集可能ドキュメント面をサポートし、複数の文書タイプでレンダリング層を共有します。
-- **拡張可能な UI**:React、Vue、Web Components、各種フレームワークのアプリケーションシェルに統合できます。
+const workbook = univerAPI.getActiveWorkbook()!
+const sheet = workbook.getActiveSheet()
-## 🤖 AI エージェント向けのオフィスワークフロー
+sheet.getRange('A1:D4').setValues([
+ ['Item', 'Quantity', 'Unit price', 'Amount'],
+ ['Seats', 2, 25, '=B2*C2'],
+ ['Support', 1, 100, '=B3*C3'],
+ ['Total', '', '', '=SUM(D2:D3)'],
+])
-Univer の AI 機能と共同編集機能は、エージェントの操作、インタラクティブな編集、人によるレビューをつなぎます。
+// An application control or agent can make the same edit.
+sheet.getRange('B2').setValue(4)
-- **プログラムによる編集**:エージェントが構造化 API を通じてオフィスコンテンツを確認・変更します。
-- **結果の検証**:エージェントがコンテンツの検査、レンダリングしたスクリーンショット、レイアウト診断で結果を確認します。
-- **Worktree での共同作業**:エージェントは独立した下書きで作業し、人が変更をレビューしてマージする内容を決めます。
+univerAPI.getFormula().onCalculationResultApplied().then(() => {
+ console.log(sheet.getRange('D4').getValue()) // 200
+ localStorage.setItem('quotation', JSON.stringify(workbook.save()))
+}).catch(console.error)
+```
-統合の詳細は [AI SDK ドキュメント](https://docs.univer.ai/ai) を参照してください。リアルタイム編集、共有リビジョン、Worktree ワークフローには、対応する Web SDK と共同編集機能が必要です。利用できるパッケージとライセンス要件は機能によって異なります。
+エディターとアプリケーションは同じワークブックを操作し、数式の変更は自動的に再計算されます。`workbook.save()` は、ワークブックと登録済みプラグインのデータを含む JSON スナップショットを返します。永続化はアプリケーション側の責任で、この例ではブラウザーのストレージを使用します。後でページを読み込む際は、初期化後に**空のワークブックを作る代わりに**スナップショットを復元します。
-## ⚡ クイックスタート
+```ts
+const saved = localStorage.getItem('quotation')
+if (saved) {
+ univerAPI.createWorkbook(JSON.parse(saved))
+}
+```
+
+このフローはオープンソースパッケージのみを使います。スナップショットの永続化と XLSX のインポート/エクスポートは別の機能で、後者には個別配布のファイル変換機能が必要です。アプリケーションの統合には公開 Facade API を使ってください。下のソースリンクでは内部実装と拡張ポイントを説明します。拡張ポイントに依存する前に [API 安定性ポリシー](../../docs/API_STABILITY.md)をご確認ください。
-製品機能を広く利用し、構成を細かく制御するには **Plugin Mode** を使用します。対応する Sheets、Docs、Node の構成では、**Preset Mode** を使うと curated setup をより短く記述できます。
+<a id="manual-plugin-composition"></a>
-<details open>
-<summary><strong>Plugin Mode</strong></summary>
+<details>
+<summary>詳細:プラグインを手動で構成する(プラグインモード)</summary>
+
+プラグインの選択、依存関係、読み込みを細かく制御する必要がある場合は、プラグインモードを使います。上記のプリセットはこの構成を代わりに行います。
-Plugin Mode では、パッケージ、スタイルの import、locale の merge、Facade API 登録、プラグイン設定をより低レベルで制御できます。
+この別の初期化方法は、同じ `app` コンテナーと Sheets Core プリセットのブラウザー用プラグイン構成を Worker なしで使います。プリセットの初期化を**置き換え**、返された `univerAPI` で同じ見積書の例を実行してください。
```bash
-pnpm add @univerjs/core @univerjs/design @univerjs/docs @univerjs/docs-ui @univerjs/engine-formula @univerjs/engine-render @univerjs/sheets @univerjs/sheets-formula @univerjs/sheets-formula-ui @univerjs/sheets-numfmt @univerjs/sheets-numfmt-ui @univerjs/sheets-ui @univerjs/ui
+pnpm add @univerjs/core @univerjs/design @univerjs/docs @univerjs/docs-ui \
+ @univerjs/engine-formula @univerjs/engine-render @univerjs/network \
+ @univerjs/sheets @univerjs/sheets-ui @univerjs/sheets-formula \
+ @univerjs/sheets-formula-ui @univerjs/sheets-numfmt \
+ @univerjs/sheets-numfmt-ui @univerjs/ui
```
```ts
@@ -162,7 +301,9 @@ import { UniverDocsPlugin } from '@univerjs/docs'
import { UniverDocsUIPlugin } from '@univerjs/docs-ui'
import DocsUIEnUS from '@univerjs/docs-ui/locale/en-US'
import { UniverFormulaEnginePlugin } from '@univerjs/engine-formula'
+import FormulaEnUS from '@univerjs/engine-formula/locale/en-US'
import { UniverRenderEnginePlugin } from '@univerjs/engine-render'
+import { UniverNetworkPlugin } from '@univerjs/network'
import { UniverSheetsPlugin } from '@univerjs/sheets'
import SheetsEnUS from '@univerjs/sheets/locale/en-US'
import { UniverSheetsFormulaPlugin } from '@univerjs/sheets-formula'
@@ -176,185 +317,485 @@ import { UniverSheetsUIPlugin } from '@univerjs/sheets-ui'
import SheetsUIEnUS from '@univerjs/sheets-ui/locale/en-US'
import { UniverUIPlugin } from '@univerjs/ui'
import UIEnUS from '@univerjs/ui/locale/en-US'
-
import '@univerjs/design/lib/index.css'
import '@univerjs/ui/lib/index.css'
import '@univerjs/docs-ui/lib/index.css'
import '@univerjs/sheets-ui/lib/index.css'
import '@univerjs/sheets-formula-ui/lib/index.css'
import '@univerjs/sheets-numfmt-ui/lib/index.css'
-
+import '@univerjs/network/facade'
+import '@univerjs/docs/facade'
+import '@univerjs/docs-ui/facade'
import '@univerjs/engine-formula/facade'
-import '@univerjs/ui/facade'
import '@univerjs/sheets/facade'
+import '@univerjs/ui/facade'
import '@univerjs/sheets-ui/facade'
import '@univerjs/sheets-formula/facade'
import '@univerjs/sheets-numfmt/facade'
+import '@univerjs/sheets-formula-ui/facade'
const univer = new Univer({
locale: LocaleType.EN_US,
locales: {
[LocaleType.EN_US]: mergeLocales(
DesignEnUS,
- UIEnUS,
DocsUIEnUS,
+ FormulaEnUS,
SheetsEnUS,
- SheetsUIEnUS,
SheetsFormulaEnUS,
SheetsFormulaUIEnUS,
SheetsNumfmtUIEnUS,
+ SheetsUIEnUS,
+ UIEnUS,
),
},
})
+univer.registerPlugin(UniverNetworkPlugin)
+univer.registerPlugin(UniverDocsPlugin)
univer.registerPlugin(UniverRenderEnginePlugin)
-univer.registerPlugin(UniverFormulaEnginePlugin)
univer.registerPlugin(UniverUIPlugin, { container: 'app' })
-univer.registerPlugin(UniverDocsPlugin)
univer.registerPlugin(UniverDocsUIPlugin)
-univer.registerPlugin(UniverSheetsPlugin)
-univer.registerPlugin(UniverSheetsUIPlugin)
-univer.registerPlugin(UniverSheetsFormulaPlugin)
-univer.registerPlugin(UniverSheetsFormulaUIPlugin)
+univer.registerPlugin(UniverFormulaEnginePlugin)
+univer.registerPlugin(UniverSheetsPlugin, {
+ onlyRegisterFormulaRelatedMutations: false,
+})
+univer.registerPlugin(UniverSheetsUIPlugin, {
+ protectedRangeShadow: true,
+})
univer.registerPlugin(UniverSheetsNumfmtPlugin)
univer.registerPlugin(UniverSheetsNumfmtUIPlugin)
+univer.registerPlugin(UniverSheetsFormulaPlugin)
+univer.registerPlugin(UniverSheetsFormulaUIPlugin)
const univerAPI = FUniver.newAPI(univer)
univerAPI.createWorkbook({})
```
+Docs プラグインはスプレッドシート内のリッチテキスト編集を支えます。機能を追加する際は、対応する Facade 拡張、ロケール、UI スタイルも含めてください。コンテナーのアンマウント時に `univer` を破棄します。
+
</details>
-<details>
-<summary><strong>Preset Mode</strong></summary>
+<p align="right"><a href="#readme-top"><img src="https://img.shields.io/badge/%E2%86%91%20%E5%85%88%E9%A0%AD%E3%81%AB%E6%88%BB%E3%82%8B-30363D?style=flat-square" alt="先頭に戻る" height="20" /></a></p>
+
+<a id="open-source-architecture"></a>
+
+## 🏗️ オープンソースアーキテクチャを知る
+
+<p align="center"><img src="../../docs/img/readme/architecture-banner.png" alt="" width="960" /></p>
+
+<a id="give-custom-features-clear-boundaries"></a>
+
+### カスタム機能の境界を明確にする
+
+Univer はコンテンツロジックと UI 操作を別々のプラグインに分けています。機能プラグインはルールとコンテンツ変更を管理し、UI プラグインは画面とユーザー操作を提供します。たとえば `sheets-filter` はフィルター範囲とルールを管理し、`sheets-filter-ui` はパネル、メニュー、ショートカットを提供します。
+
+```mermaid
+%%{init: {'htmlLabels': false, 'theme': 'base', 'themeVariables': {'fontFamily': 'Arial, PingFang SC, Microsoft YaHei, sans-serif', 'fontSize': '17px', 'lineColor': '#64748b'}, 'flowchart': {'htmlLabels': false, 'curve': 'linear', 'nodeSpacing': 28, 'rankSpacing': 45, 'padding': 16, 'wrappingWidth': 270}}}%%
+%% A layered overview, not a complete dependency graph.
+%% Group arrows indicate reuse of the layer below; internal arrows show selected dependencies.
+flowchart TD
+ subgraph FEATURES["Feature Plugins"]
+ direction LR
+ FUI["Filter<br/>UI Plugin"]
+ VUI["Data Validation<br/>UI Plugin"]
+ FILTER["Filter Plugin"]
+ VALIDATION["Data Validation Plugin"]
+ FUI --> FILTER
+ VUI --> VALIDATION
+ end
+
+ subgraph PRODUCTS["Product Plugins"]
+ direction LR
+ SUI["Sheets UI Plugin"]
+ SHEETS["Sheets Plugin"]
+ SUI --> SHEETS
+ end
+
+ subgraph FOUNDATION["Core Framework & Plugins"]
+ direction LR
+ UI["UI Plugin"]
+ FORMULA["Formula Engine Plugin"]
+ RENDER["Render Engine Plugin"]
+ CORE["Core"]
+ UI --> RENDER
+ RENDER --> CORE
+ FORMULA --> CORE
+ end
+
+ FEATURES --> PRODUCTS
+ PRODUCTS --> FOUNDATION
+
+ classDef logic fill:#eff6ff,color:#17365f,stroke:#93b4df,stroke-width:1.5px
+ classDef ui fill:#f0fdf4,color:#17543a,stroke:#91c8a7,stroke-width:1.5px
+ classDef shared fill:#f6f7f9,color:#334155,stroke:#bac3ce,stroke-width:1.5px
+ classDef feature fill:#172d50,color:#ffffff,stroke:#172d50
+ class FUI,VUI ui
+ class FILTER,VALIDATION logic
+ class SUI,SHEETS logic
+ class UI,FORMULA,RENDER,CORE shared
+
+ style FEATURES fill:#f7fcf9,stroke:#b5d8c1,color:#17543a
+ style PRODUCTS fill:#f5f9ff,stroke:#b6cbea,color:#17365f
+ style FOUNDATION fill:#fafbfc,stroke:#cbd2dc,color:#334155
+```
-Preset は、必要な Facade API 登録とスタイルを含む Univer プラグインの curated collection です。
+**図 1:3 層のプラグイン。** 機能プラグインは製品プラグインの上に構築され、製品プラグインはコアフレームワークとプラグインを再利用します。グループ間の矢印は下の層への依存を示します。Core はコンテンツモデル、コマンド、依存性注入、ライフサイクル管理を提供します。一部のプラグインと依存関係は省略しています。
-```bash
-pnpm add @univerjs/presets @univerjs/preset-sheets-core
-```
+新しい機能は自身のプラグイン内でルールを保持し、公開サービス、コマンド、定義された拡張ポイントを通じて連携します。UI プラグインは共有 UI サービスとコンポーネントの上に構築されます。
-```ts
-import { UniverSheetsCorePreset } from '@univerjs/preset-sheets-core'
-import UniverPresetSheetsCoreEnUS from '@univerjs/preset-sheets-core/locales/en-US'
-import { createUniver, LocaleType, mergeLocales } from '@univerjs/presets'
+依存関係は 2 つのレベルで明示されます。
-import '@univerjs/preset-sheets-core/lib/index.css'
+- **プラグイン間:** `DependentOn` が実行時のプラグイン依存関係を宣言します。プラグインサービスが順序を決め、ライフサイクルの段階が依存関係の登録、コンテンツの初期化、UI の初期化を分離します。
+- **プラグイン内部:** 依存性注入は、宣言された依存関係を使ってコントローラーとサービスを接続します。対応するオーバーライドにより、アプリケーションは実装の置き換え、プラットフォームサービスへの適応、テストダブルの提供ができます。インスタンス単位のインジェクターは、Univer インスタンス間のアプリケーション状態を分離します。
-const { univerAPI } = createUniver({
- locale: LocaleType.EN_US,
- locales: {
- [LocaleType.EN_US]: mergeLocales(UniverPresetSheetsCoreEnUS),
- },
- presets: [
- UniverSheetsCorePreset({
- container: 'app',
- }),
- ],
-})
+破棄可能な登録により、所有者の破棄時にコマンド、リスナー、コンポーネント、アイコンもクリーンアップできます。
-univerAPI.createWorkbook({})
+[フィルタープラグイン](../../packages/sheets-filter/src/plugin.ts)とその [UI プラグイン](../../packages/sheets-filter-ui/src/plugin.ts)は、実際のコードでこれらの境界を示しています。
+
+<details>
+<summary>機能の内部:Model、Controller、Service、UI 基盤</summary>
+
+フィルターでは、`sheets-filter` がコンテンツロジックを担当し、`sheets-filter-ui` が UI 操作を担当します。各モジュールは明確な責務を持ちます。
+
+```mermaid
+%%{init: {'htmlLabels': false, 'theme': 'base', 'themeVariables': {'fontFamily': 'Arial, PingFang SC, Microsoft YaHei, sans-serif', 'fontSize': '17px', 'lineColor': '#64748b'}, 'flowchart': {'htmlLabels': false, 'curve': 'linear', 'nodeSpacing': 28, 'rankSpacing': 45, 'padding': 16, 'wrappingWidth': 270}}}%%
+%% Every arrow means contains. This is code organization, not execution order.
+flowchart LR
+ FEATURE["Filter Feature"]
+ LOGIC["Filter Plugin"]
+ UI["Filter UI Plugin"]
+ MODEL["Model"]
+ SERVICE["Service"]
+ CONTROLLER["Controller"]
+ COMMAND["Command / Mutation"]
+ FACADE["Facade API"]
+ VIEW["View"]
+ UICTRL["UI Controller"]
+ UISERVICE["UI Service"]
+ FEATURE --> LOGIC
+ FEATURE --> UI
+ LOGIC --> MODEL
+ LOGIC --> SERVICE
+ LOGIC --> CONTROLLER
+ LOGIC --> COMMAND
+ LOGIC --> FACADE
+ UI --> VIEW
+ UI --> UICTRL
+ UI --> UISERVICE
+
+ classDef logic fill:#eff6ff,color:#17365f,stroke:#93b4df,stroke-width:1.5px
+ classDef ui fill:#f0fdf4,color:#17543a,stroke:#91c8a7,stroke-width:1.5px
+ classDef shared fill:#f6f7f9,color:#334155,stroke:#bac3ce,stroke-width:1.5px
+ classDef feature fill:#172d50,color:#ffffff,stroke:#172d50
+ class FEATURE feature
+ class LOGIC,MODEL,SERVICE,CONTROLLER,COMMAND,FACADE logic
+ class UI,VIEW,UICTRL,UISERVICE ui
```
+**図 2:コードの構成。矢印は「含む」を意味します。** 両方のプラグインに Controller と Service を配置できます。ロジックの Controller はコンテンツの変更と関連機能を調整し、UI Controller はメニュー、ショートカット、操作を接続し、UI Service はパネルの状態を管理します。これらの責務は、新機能の実装とテストに一貫した構造を与えます。
+
+UI 基盤も同じ分担に従います。**`@univerjs/design`** は共有コンポーネントとスタイル、**`@univerjs/ui`** はメニュー、ショートカット、パネル、コンポーネント登録などのワークベンチサービス、**`@univerjs/icons`** はアイコンを提供します。各機能はこれらの拡張ポイントを通じてコンポーネントとアイコンを登録し、メニューを追加してレンダリングを接続します。チームはアプリケーションの UI 基盤を再利用しながら、パネルやツールバー機能を追加できます。[UI 概要](https://docs.univer.ai/guides/sheets/ui/overview)と、フィルタープラグインの[コンポーネント・アイコン登録](../../packages/sheets-filter-ui/src/controllers/components.controller.ts)をご覧ください。
+
</details>
-ページにはコンテナが必要です。
+<a id="compose-cross-feature-edits-and-undoredo"></a>
-```html
-<div id="app" style="height: 100vh"></div>
+### 複数機能の編集と元に戻す/やり直しを組み合わせる
+
+たとえばフィルター範囲内に行を挿入すると、フィルタープラグインは対応する範囲変更と取り消しデータを提供します。行コマンドは基本の編集と参加機能の変更をまとめて実行し、元に戻す/やり直しの情報も一緒に記録します。行挿入機能は共通の拡張機構を利用でき、フィルタープラグインは自身の範囲更新ルールを担当します。
+
+コマンドシステムは 3 種類のアクションを区別します。
+
+- **Command** は業務操作と必要な変更をまとめます。
+- **Mutation** は、シリアライズ可能なパラメーターを使ってスナップショットに保存されるコンテンツを変更します。
+- **Operation** は、開いているパネルやスクロール位置などの一時的な状態を変更します。
+
+**元に戻す/やり直しの共通構造。** 元に戻せる編集では、機能の実装が順方向の Mutation と対応する逆方向の Mutation を提供し、Command が `IUndoRedoService` を通じて記録します。1 つの操作が複数機能に影響する場合、Command はそれぞれの変更と取り消しデータを 1 件の記録にまとめ、ユーザーが操作全体を元に戻したり、やり直したりできるようにします。[コマンドの拡張](https://docs.univer.ai/blog/custom-command)をご覧ください。
+
+機能同士の連携も必要です。**インターセプターと参照範囲ハンドラーが、そのための明確な場所を提供します。** 対応する拡張ポイントでプラグインは検査や関連 Mutation を追加し、API が定義する範囲でインターセプターの優先順位が実行順を制御します。
+
+<details>
+<summary>例:コマンド、コールバック、機能間の連携、元に戻す/やり直し</summary>
+
+```mermaid
+%%{init: {'htmlLabels': false, 'theme': 'base', 'themeVariables': {'fontFamily': 'Arial, PingFang SC, Microsoft YaHei, sans-serif', 'fontSize': '17px', 'lineColor': '#64748b'}, 'flowchart': {'htmlLabels': false, 'curve': 'linear', 'nodeSpacing': 28, 'rankSpacing': 45, 'padding': 16, 'wrappingWidth': 270}}}%%
+%% Simplified insert-row example. A command composes mutations and records undo after success.
+%% Events may also fire for nested command executions; not every callback is drawn.
+flowchart TD
+ BEFORE["Before execution<br/>Inspect or cancel"]
+ CMD["Insert-row Command"]
+ BASE["Row mutations"]
+ EXT["Feature extension points<br/>Filter range changes"]
+ MODEL["Execute combined mutations"]
+ UNDO["Record undo and redo"]
+ AFTER["After execution<br/>Notify listeners"]
+ BEFORE --> CMD
+ CMD --> BASE
+ CMD --> EXT
+ BASE --> MODEL
+ EXT --> MODEL
+ MODEL --> UNDO
+ UNDO --> AFTER
+ classDef entry fill:#f6f7f9,color:#334155,stroke:#bac3ce,stroke-width:1.5px
+ classDef core fill:#eff6ff,color:#17365f,stroke:#93b4df,stroke-width:1.5px
+ classDef extension fill:#f0fdf4,color:#17543a,stroke:#91c8a7,stroke-width:1.5px
+ class BEFORE,AFTER entry
+ class CMD,BASE,MODEL,UNDO core
+ class EXT extension
```
-詳しくは [Installation & Basic Usage guide](https://docs.univer.ai/guides/sheets/getting-started/installation)、[`createUniver` reference](https://docs.univer.ai/reference/methods/create-univer)、[Facade API reference](https://docs.univer.ai/reference/classes/univer) を参照してください。
+この図は行挿入のフローを簡略化したものです。入れ子になったコマンドの実行にはそれぞれコールバックがあり、すべてのイベントや独立した Operation の経路は描いていません。[行コマンド](../../packages/sheets/src/commands/commands/insert-row-col.command.ts)、[フィルターコントローラー](../../packages/sheets-filter/src/controllers/sheets-filter.controller.ts)、[インターセプターサービス](../../packages/sheets/src/services/sheet-interceptor/sheet-interceptor.service.ts)をご覧ください。
+
+</details>
+
+こうした境界は実践的なテスト方針を支えます。モデルとサービスを個別にテストし、外部依存を DI で置き換え、組み合わせた操作と元に戻す/やり直しの回帰テストを追加します。[フィルターコントローラーのテスト](../../packages/sheets-filter/src/controllers/__tests__/sheets-filter.controller.spec.ts)は、行と列の変更がフィルターに与える影響を検証します。
+
+<a id="connect-applications-and-agents-through-facade-apis-and-events"></a>
+
+### Facade API とイベントでアプリケーションやエージェントを接続
+
+このリポジトリには、エディターを支えるコンテンツモデル、数式エンジン、Canvas レンダリング・レイアウトエンジンが含まれています。これらは共通の構成要素です。たとえばスプレッドシートのリッチテキストは、ドキュメントのレイアウトとレンダリングを再利用します。カスタム機能は別のコンテンツ基盤を実装する代わりに、これらのエンジンの上に構築できます。[数式エンジンのアーキテクチャ](https://docs.univer.ai/blog/formula)と[レンダリングエンジンのアーキテクチャ](https://docs.univer.ai/blog/rendering)をご覧ください。
+
+ブラウザーエディター、Node.js の Headless タスク、適切に構成した Worker は、対応するコンテンツプラグイン、モデル、コマンド、計算を再利用できます。[Headless Univer](https://docs.univer.ai/guides/sheets/getting-started/node)と[同型アーキテクチャ](../../docs/ISOMORPHIC.md)をご覧ください。
+
+`ICommandService` は実行コールバックを公開し、プラグインがコマンド実行の前後を監視できるようにします。Facade API は、基礎となる機能を `FWorkbook`、`FWorksheet`、`FRange` などのアプリケーション向けオブジェクトに包みます。
+
+各プラグインは独自の Facade 拡張、**`univerAPI.Event` による型付きイベント**、**`univerAPI.Enum` による列挙値**を提供します。アプリケーションコードは非公開サービスをインポートしたり文字列を繰り返したりせず、1 つの入口からイベント名や定数を見つけられます。たとえば `BeforeCommandExecute` は実行を検査・キャンセルでき、`CommandExecuted` は実行をリスナーに通知します。リスナーは破棄可能なオブジェクトを返し、キャンセルは対応するイベントでのみ有効です。
+
+Facade 拡張は機能パッケージに含まれるため、コンテンツ API が無関係な UI API を取り込む必要はありません。[Facade の設計](https://docs.univer.ai/blog/facade)、[コマンドコールバックとイベントブリッジ](../../packages/core/src/facade/f-univer.ts)、[Enum の入口](../../packages/core/src/facade/f-enum.ts)をご覧ください。
+
+このリポジトリは動作する機能実装と拡張のパターンを提供します。完全な例は[フィルター実装の解説](https://docs.univer.ai/blog/anatomy)をご覧ください。拡張ポイントに依存する前には [API 安定性ポリシー](../../docs/API_STABILITY.md)もご確認ください。
+
+<p align="right"><a href="#readme-top"><img src="https://img.shields.io/badge/%E2%86%91%20%E5%85%88%E9%A0%AD%E3%81%AB%E6%88%BB%E3%82%8B-30363D?style=flat-square" alt="先頭に戻る" height="20" /></a></p>
+
+<a id="open-source-and-commercial-extensions"></a>
+
+## 🧩 Univer Office SDK でアプリケーションを拡張
+
+<p align="center"><img src="../../docs/img/readme/sdk-banner.png" alt="" width="960" /></p>
+
+すぐに統合できる機能をさらに必要とする場合は、対応する **Univer Office SDK** モジュールを組み合わせます。追加のコンテンツ種類、高度な編集プラグイン、共同作業、ファイル変換、エージェントツールを利用できます。これらは上で紹介した同じコンテンツモデル、プラグインアーキテクチャ、コマンドシステム、Facade 設計を拡張するため、既存の統合を基に構築できます。
+
+<div align="center" style="overflow-x: auto;">
+
+<table align="center" style="display: table; width: auto; margin-left: auto; margin-right: auto;">
+<thead>
+<tr>
+<th>部分</th>
+<th>基盤の拡張方法</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td><strong>オープンソース Web SDK コア · このリポジトリ</strong></td>
+<td>オープンソースのモデル、エンジン、プラグイン、UI 基盤、Sheets と Docs の機能、および対応する Headless コンテンツ操作。Apache-2.0 に基づき商用アプリケーションで利用できます。</td>
+</tr>
+<tr>
+<td><strong>商用 Web SDK プラグイン</strong></td>
+<td>コアの Plugin、依存性注入、Command/Mutation、Facade 拡張パターンに従い、対応するコンテンツにチャート、図形、ピボットテーブル、SmartArt などを追加します。</td>
+</tr>
+<tr>
+<td><strong>Server SDK</strong></td>
+<td>同じコンテンツモデルと Mutation の規約に、リアルタイム共同作業、変更履歴、オフィスファイル変換を追加します。アプリケーションの ID、権限、ストレージと統合します。</td>
+</tr>
+<tr>
+<td><strong>AI SDK 拡張</strong></td>
+<td>Web SDK の Headless と Facade の機能を再利用し、エージェントがコンテンツを調査、編集、検証するための構成可能な Node.js API と CLI の基礎を提供します。共同作業と Worktree レビューも統合できます。</td>
+</tr>
+</tbody>
+</table>
+
+</div>
+
+<a id="scope-and-licensing"></a>
+
+### 範囲とライセンス
+
+- **このリポジトリ:** Apache-2.0 のパッケージは、そのライセンスに従って商用アプリケーションで利用できます。オープンソースの Headless コンテンツ機能も含まれます。
+- **商用拡張:** 商用 Web SDK プラグイン、Server SDK、オープンソース基盤を超える AI SDK 機能は個別に配布・ライセンス提供されます。**Freemium** 評価には透かしと機能制限があります。
+- **リファレンスアプリケーション:** Univer Workspace などのオープンソースアプリケーションには固有のソースライセンスがあり、SDK 依存関係には各 SDK のライセンスが引き続き適用されます。
+
+詳しい範囲は、**Open source only** フィルターを備えた[機能比較](https://univer.ai/compare/)をご覧ください。商用の選択肢は[プランとライセンス](https://univer.ai/pricing/)で確認できます。
+
+<details>
+<summary>共有コンテンツモデルが編集、共同作業、ファイルをつなぐ仕組み</summary>
+
+これらの機能はシリアライズ可能な **Unit スナップショット**を操作します。Sheets の `IWorkbookData`、Docs の `IDocumentData`、Slides の `ISlideData`、キャンバスの `IBoardData`(API では **Boards**)などです。これらの型は core と各製品パッケージで提供され、現在の Slides と Boards は個別配布の商用製品です。共通の Unit 規約により、ブラウザーエディター、バックエンドサービス、エージェントが同じコンテンツを扱えます。
+
+Command は編集をまとめ、**Mutation はコンテンツの変更を記述します**。共同作業は Mutation を **changeset(変更セット)**にまとめ、並行する変更に **operational transformation(OT)** を適用し、確定したリビジョンとスナップショットを管理します。履歴はスナップショットと後続の変更セットからリビジョンを復元できます。[共同作業の設計](https://docs.univer.ai/blog/ot)と [Collaboration SDK 概要](https://docs.univer.ai/server/collaboration/overview)をご覧ください。
+
+**Exchange** はオフィスファイルの構造と Univer のコンテンツスナップショットを相互に変換します。**XLSX、DOCX、PPTX** などの OOXML 形式では、ファイルを対応する Sheet、Doc、Slide のデータに解析し、エクスポート時にファイル表現を生成します。変換後のコンテンツは、同じ編集、計算、共同作業、エージェントのフローに参加できます。[オフィスファイルのインポートとエクスポート](https://docs.univer.ai/server/import-export/node)をご覧ください。
+
+</details>
+
+<details>
+<summary>AI SDK がエージェントに同じコンテンツ機能を提供する仕組み</summary>
-## 🧩 Preset Mode と Plugin Mode
+AI SDK は、Web SDK の **Headless コンテンツモデル、コマンド、計算、Facade API** を基にしています。構造化された TypeScript API とオプションの Commander プリセットを公開し、アプリケーションが独自の Office CLI やエージェントツールを構成できます。
-| 選択肢 | 使う場面 | はじめに読むもの |
-| --- | --- | --- |
-| **Plugin Mode** | パッケージ、構成済みの依存関係、遅延読み込み、実行時の構成を厳密に制御したい場合。 | このリポジトリの [`examples/`](../../examples) と [architecture guide](https://docs.univer.ai/guides/recipes/architecture/univer) |
-| **Preset Mode** | 最小限の設定で Sheets、Docs、Node の動作環境を作りたい場合。 | このリポジトリの [`presets/`](../../presets) と [getting started guide](https://docs.univer.ai/guides/sheets/getting-started/installation) |
-| **Headless Mode** | UI なしでサーバー側のワークブック/ドキュメント処理、数式計算、自動化を行いたい場合。 | [Headless Univer](https://docs.univer.ai/guides/sheets/getting-started/node) |
+- **理解、発見、編集。** 検査は構造化されたコンテンツを返します。API Reference は、SDK に含まれる Facade のシンボルとシグネチャをエージェントが探すのを助けます。Facade の実行は読み取りと書き込みを区別し、Mutation を取得して、明示的な同期とコミット結果を扱います。[コンテンツ操作](https://docs.univer.ai/ai/content-operations)をご覧ください。
+- **レンダリング結果を確認。** ブラウザーの Render Runtime が Web SDK のレンダリングを再利用してスクリーンショットを取得します。スライドのレイアウト検査は、文字のページ外へのはみ出しや重なりなどを構造化して返し、エージェントの次の編集の根拠になります。[視覚的な検査](https://docs.univer.ai/ai/visual-inspection)をご覧ください。
+- **人がレビューする下書きを編集。** 対応する共同作業と Web の機能を使い、エージェントは独立した Worktree 下書きを複数回編集・検証してから、人にレビュー、マージ、再開を引き継げます。フローは同じスナップショット、Mutation、リビジョン規約を利用します。[Worktree](https://docs.univer.ai/ai/worktree)をご覧ください。
-同じ Univer の協調リリースラインに含まれる `@univerjs/*` SDK パッケージは、同一バージョンに揃えてください。`@univerjs/icons` や `@univerjs/icons-svg` など独立してリリースされるパッケージは、SDK のバージョンではなく、各パッケージマニフェストに宣言された互換バージョンを使用します。Univer Pro を使用する場合は、`@univerjs-pro/*` も対応する協調リリースラインに揃えてください。
+繰り返し呼び出す場合は、オプションの [Worker プールとデーモン](https://docs.univer.ai/ai/runtime-architecture)が読み込み済みのコンテンツを再利用し、再初期化を減らします。ルート CLI、対象、認可、出力はアプリケーションが管理します。[AI SDK パッケージ一覧](https://docs.univer.ai/ai/packages)で必要な機能を選択してください。
-API 互換性、experimental API、internal API、deprecation rules については [API Stability Policy](../API_STABILITY.md) を参照してください。
+</details>
-## 🧭 互換性
+<p align="right"><a href="#readme-top"><img src="https://img.shields.io/badge/%E2%86%91%20%E5%85%88%E9%A0%AD%E3%81%AB%E6%88%BB%E3%82%8B-30363D?style=flat-square" alt="先頭に戻る" height="20" /></a></p>
-- **ブラウザ実行環境**:Univer は Chrome 88 をターゲットとしてコンパイルされており、Edge `>=88`、Firefox `>=90`、Chrome `>=88`、Safari `>=14.1`、Electron `>=12` で動作することを目指しています。
-- **Polyfills**:Univer は `Intl.Segmenter` に依存しています。対象ブラウザや実行環境が対応していない場合は、`@formatjs/intl-segmenter` などの polyfill を追加してください。
-- **ビルドツール**:Vite、esbuild、Webpack 5 を推奨します。`package.json` の `exports` フィールドに対応していないビルドツール(Webpack 4 など)では、追加のパスマッピングが必要になる場合があります。
-- **React**:Univer の view layer は React 18 ベースで構築されており、React 18 と 19 をサポートします。React 16.9+ と 17 には最小限の互換サポートを提供します。
-- **Node.js runtime**:Headless Univer は Node.js `>=18.17.0` をサポートします。この monorepo の開発には Node.js `>=22.18` が必要です。
+<a id="application-patterns-and-ecosystem"></a>
-## 🛠️ 構築できるもの
+## 🌐 アプリケーションのパターンとエコシステム
-| 領域 | オープンソースの機能 | Univer Pro 拡張 |
-| --- | --- | --- |
-| **Sheets** | ワークブック、ワークシート、範囲、選択、数式、数値書式、フィルター、ソート、データ検証、条件付き書式、ハイパーリンク、コメント、検索と置換、ノート、テーブル、描画連携、拡張可能な UI プラグイン。 | リアルタイム共同編集、編集履歴、インポート/エクスポート、印刷、チャート、ピボットテーブル、スパークライン、アウトライン、図形、セル内グラフィックス、データコネクタ、サーバーサイド計算、強化された数式機能。 |
-| **Docs** | リッチドキュメントモデル、編集 UI、リスト、ハイパーリンク、描画連携、コメント、クイック挿入、共有ドキュメントアーキテクチャ。 | 共同編集、インポート/エクスポート、印刷、強化されたテーブルとリスト、段組み、コールアウト、コードブロック、引用ブロック、図形、リモートコメントリソース。 |
-| **Slides** | — | スライドモデルと UI、スライドのインポート/エクスポート、チャートとテーブルのモデル/UI プラグイン、共有の図形編集基盤。 |
-| **Bases** | Univer のプラグイン、コマンド、モデルのアーキテクチャ上に、カスタムの構造化データ体験を構築できます。 | Base データベースモデル、コマンド、数式連携、ワークベンチ UI、フィールドエディタ、レンダリングエンジンビュー。 |
-| **Runtime** | ブラウザアプリ、Node.js ヘッドレス利用、Web Worker/RPC パターン、複数インスタンス、サーバー向け自動化。 | 共同編集クライアント/サーバーパッケージ、Node.js 共同編集クライアント、Pro サーバーサービス、SSR、計算委譲、サーバーサイド計算、changeset replay ツール。 |
-| **Integrations** | React、Vue、Web Components、フレームワークテンプレート、テーマ、ローカライズ、カスタムプラグイン。 | Pro presets とエンタープライズデプロイパッケージ。 |
+<p align="center"><img src="../../docs/img/readme/ecosystem-banner.png" alt="" width="960" /></p>
-Sheets、Docs、Slides は Univer の共通アーキテクチャ上でスプレッドシート、ドキュメント、プレゼンテーションの編集機能を提供し、一貫したプラグインシステム、コマンドシステム、Facade API を使用します。
+<a id="univer-workspace-an-office-sdk-reference-application"></a>
-## 🔓 Open Source と Pro
+### Univer Workspace:Office SDK のリファレンスアプリケーション
-このリポジトリには Univer のオープンソースコアと first-party OSS プラグインが含まれています。Univer Pro は、高度なプロダクトサーフェス、共同編集、サーバー機能、エンタープライズ連携のための商用拡張レイヤーとして別途開発されています。
+完全なアプリケーションの参考には、[Univer Workspace](https://github.com/dream-num/univer-workspace)から始めてください。Univer Office SDK のエディター、共同作業、ファイル機能、既存のエージェント、人によるレビューを、セルフホスト可能なワークスペースに組み合わせる方法を示しています。独自のオフィスアプリケーションやエージェントワークスペースを構築する際の統合パターンとして利用できます。
-| カテゴリ | Open source | Univer Pro / commercial |
-| --- | --- | --- |
-| **Foundation** | Core SDK、プラグインシステム、レンダリングエンジン、数式エンジン、Facade API、テーマ、i18n、フレームワークアダプタ。 | Pro presets とエンタープライズデプロイパッケージ。 |
-| **Sheets** | コアのスプレッドシート編集、数式、数値書式、フィルター/ソート、データ検証、条件付き書式、ノート、テーブル、ハイパーリンク、コメント、描画、検索と置換。 | 共同編集、編集履歴、インポート/エクスポート、印刷、チャート、ピボットテーブル、スパークライン、アウトライン、図形、セル内グラフィックス、データコネクタ、範囲の前処理、強化された数式エンジン機能。 |
-| **Docs** | ドキュメントモデルと編集 UI、リスト、ハイパーリンク、コメント、クイック挿入、描画連携。 | 共同編集、インポート/エクスポート、印刷、強化されたテーブル/リスト、段組み、コールアウト、コードブロック、引用ブロック、図形、リモートスレッドコメントリソース。 |
-| **Slides** | — | スライドモデル/UI パッケージ、スライドのインポート/エクスポート、チャート、テーブル、再利用可能な図形エディタ UI。 |
-| **Bases** | カスタムのデータ中心プロダクト向けの拡張可能なプラグインアーキテクチャ。 | Base データベースコアモデル、コマンド、ミューテーション、数式連携、ワークベンチ UI、フィールドエディタ、レンダリングエンジン連携。 |
-| **Server and runtime** | Node.js ヘッドレスランタイム、RPC/Web Worker パターン、サーバー向け自動化のプリミティブ。 | 共同編集サーバー、Node.js 共同編集クライアント、SSR サービス、計算委譲、サーバーサイド計算、共同編集 changeset replay ツール。 |
+<div align="center" style="overflow-x: auto;">
-エディターの機能については [Web SDK ドキュメント](https://docs.univer.ai/guides/sheets)をご覧ください。バックエンドの統合については、Server SDK の[共同編集](https://docs.univer.ai/server/collaboration/overview)と[ファイルのインポート・エクスポート](https://docs.univer.ai/server/import-export)の章をご覧ください。
+<table align="center" style="display: table; width: auto; margin-left: auto; margin-right: auto;">
+ <tr>
+ <td width="50%" valign="top">
+ <a href="https://space.univer.ai/"><img src="../../docs/img/readme/workspace.webp" alt="Univer Workspace の編集可能な予算スプレッドシート" width="420" /></a>
+ </td>
+ <td width="50%" valign="top">
+ <a href="https://univer.ai/demo/web-app"><img src="../../docs/img/readme/web-app.webp" alt="前提条件の操作と連動する編集可能なスプレッドシートを並べた Web App" width="420" /></a>
+ </td>
+ </tr>
+ <tr>
+ <td width="50%" valign="top">
+ <strong>エージェントと編集可能なオフィスコンテンツ</strong><br />
+ 会話、スプレッドシート編集、オフィスコンテンツを 1 つのワークスペースにまとめます。<br />
+ <a href="https://space.univer.ai/">Workspace を試す</a> · <a href="https://github.com/dream-num/univer-workspace">Workspace のソースとセットアップ</a>
+ </td>
+ <td width="50%" valign="top">
+ <strong>Web App × Sheet · 実験的機能</strong><br />
+ 操作をセルに結び付け、アプリからシートへ書き込み、シートの変更をアプリに反映します。<br />
+ <a href="https://univer.ai/demo/web-app">シートを活用したアプリのデモを試す</a>
+ </td>
+ </tr>
+</table>
-商用ライセンスや購入については、[お問い合わせください](https://univer.ai/#contact)。アプリケーションでのライセンス設定については、[ライセンス設定](https://docs.univer.ai/server/license)をご覧ください。
+</div>
-Boundary principles:
+Workspace はオープンソースで、SDK 依存関係にはそれぞれのライセンスが適用されます。接続されたアプリやレビューフローについては [Workspace 概要](https://univer.ai/workspace/)をご覧ください。
+
+<p align="center"><a href="https://www.youtube.com/watch?v=1p-SMEiK6Kg"><img src="../../docs/img/readme/integration-demo.png" alt="SDK 統合デモを見る" width="720" /></a></p>
+
+[SDK 統合デモを見る](https://www.youtube.com/watch?v=1p-SMEiK6Kg)
+
+<a id="cli-agent-integrations-and-developer-skills"></a>
+
+### CLI、エージェント統合、開発スキル
+
+同じ SDK 機能を、すでに使っているエージェントやツールにも組み込めます。
+
+<div align="center" style="overflow-x: auto;">
+
+<table align="center" style="display: table; width: auto; margin-left: auto; margin-right: auto;">
+<thead>
+<tr>
+<th>プロジェクト</th>
+<th>提供する機能</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td><a href="https://github.com/dream-num/univer-cli">Univer CLI</a></td>
+<td>オフィスコンテンツの作成、編集、検査、納品を行うローカルのコマンドラインワークスペース。</td>
+</tr>
+<tr>
+<td><a href="https://github.com/dream-num/dsh-univer-office">Univer Office for DeepSeek Harness</a></td>
+<td>関連コンテンツ、結果の検証、変更のバージョン管理、独立した Worktree での共同作業。</td>
+</tr>
+<tr>
+<td><a href="https://github.com/dream-num/workbuddy-univer-office">Univer Office for WorkBuddy</a></td>
+<td>ローカルの Office 統合、MCP プレビュー、下書きレビュー。開発者プレビュー。</td>
+</tr>
+<tr>
+<td><a href="https://github.com/dream-num/openclaw-univer-office">Univer Office for OpenClaw</a></td>
+<td>オフィスコンテンツの作成、レビュー、納品ツール。</td>
+</tr>
+<tr>
+<td><a href="https://github.com/dream-num/univer-sdk-skills">Univer SDK Skills</a></td>
+<td>コーディングエージェントによる SDK 統合、プラグイン開発、バックエンドフロー実装を支援する指示。</td>
+</tr>
+</tbody>
+</table>
+
+</div>
+
+各リポジトリにセットアップと SDK 依存関係の説明があります。エージェントの入口は[エコシステム](https://univer.ai/ecosystem/)で確認でき、独自の統合を構築する場合は[ドキュメント](https://docs.univer.ai/)を利用できます。
+
+<p align="right"><a href="#readme-top"><img src="https://img.shields.io/badge/%E2%86%91%20%E5%85%88%E9%A0%AD%E3%81%AB%E6%88%BB%E3%82%8B-30363D?style=flat-square" alt="先頭に戻る" height="20" /></a></p>
+
+<a id="documentation-and-contributing"></a>
-- このリポジトリの OSS パッケージは Apache-2.0 license の下で単独利用できることを意図しています。Univer Pro は任意であり、公開 OSS SDK API の利用に Pro は不要です。
-- OSS パッケージの bugs、regressions、security issues は、関連する Pro 機能がある場合でも OSS リポジトリで報告・修正されるべきです。
-- OSS documentation は、Pro-only capabilities が公開 `@univerjs/*` packages に含まれるかのように示すべきではありません。Pro-only APIs、packages、deployment paths は明示的に名前を出してください。
-- OSS feature に Pro enhancement がある場合でも、OSS behavior は独立して文書化し、commercial docs を先に読まなくても open-source surface を評価できるようにします。
+## 📚 ドキュメントとコントリビューション
-## 🌐 エコシステム
+Univer を構築し、改善するすべての[コントリビューター](https://github.com/dream-num/univer/graphs/contributors)に感謝します。エンジン、プラグイン、テスト、ドキュメント、サンプルへの貢献を歓迎します。
-- **Core SDK**:[`dream-num/univer`](https://github.com/dream-num/univer)、この monorepo です。
-- **Presets**:このリポジトリの [`presets/`](../../presets)。ブラウザと Node.js アプリ向けの curated plugin collection です。
-- **AI agent skills**:[`dream-num/univer-sdk-skills`](https://github.com/dream-num/univer-sdk-skills)、Univer 統合、Pro 機能、プラグイン開発、Node バックエンドに取り組む AI agent 向けの再利用可能な指示集です。[AI Skills guide](https://docs.univer.ai/guides/skills) も参照してください。
-- **Documentation**:[docs.univer.ai](https://docs.univer.ai)、Web SDK、Server SDK、AI SDK のガイドと API リファレンスを含みます。
-- **Web SDK**:[組み込みエディタとヘッドレス処理](https://docs.univer.ai/guides/sheets)をブラウザと Node.js で利用できます。
-- **Server SDK**:[共同編集とファイル変換](https://docs.univer.ai/server)を、アプリケーションのストレージ、認証、権限管理と統合します。
-- **AI SDK**:オフィスコンテンツの検査、編集、検証を行う[エージェントワークフロー](https://docs.univer.ai/ai)を構築できます。
-- **API Reference**:[docs.univer.ai/reference](https://docs.univer.ai/reference/classes/univer)、Facade API と生成された API reference。
-- **Examples and showcase**:[Univer Showcase](https://docs.univer.ai/showcase) とこのリポジトリの [`examples/`](../../examples)。
-- **AI-native spreadsheets**:[`dream-num/univer-mcp`](https://github.com/dream-num/univer-mcp)、自然言語で Univer Sheets を操作する Univer Platform / MCP 統合。
+<p align="center"><a href="https://docs.univer.ai/guides/sheets">🧩 Web SDK</a> · <a href="https://docs.univer.ai/server">🖥️ Server SDK</a> · <a href="https://docs.univer.ai/ai">🤖 AI SDK</a> · <a href="https://docs.univer.ai/reference/classes/univer">🔧 API リファレンス</a> · <a href="https://office.univer.ai/">🎮 ライブデモ</a></p>
-## 📦 リポジトリ構成
+<div align="center" style="overflow-x: auto;">
+
+<table align="center" style="display: table; width: auto; margin-left: auto; margin-right: auto;">
+ <tr>
+ <th align="center"><img src="https://cdnjs.cloudflare.com/ajax/libs/browser-logos/75.0.1/edge/edge_64x64.png" width="32" height="32" alt="" /><br />Edge</th>
+ <th align="center"><img src="https://cdnjs.cloudflare.com/ajax/libs/browser-logos/75.0.1/firefox/firefox_64x64.png" width="32" height="32" alt="" /><br />Firefox</th>
+ <th align="center"><img src="https://cdnjs.cloudflare.com/ajax/libs/browser-logos/75.0.1/chrome/chrome_64x64.png" width="32" height="32" alt="" /><br />Chrome</th>
+ <th align="center"><img src="https://cdnjs.cloudflare.com/ajax/libs/browser-logos/75.0.1/safari/safari_64x64.png" width="32" height="32" alt="" /><br />Safari</th>
+ <th align="center"><img src="https://cdnjs.cloudflare.com/ajax/libs/browser-logos/75.0.1/electron/electron_64x64.png" width="32" height="32" alt="" /><br />Electron</th>
+ </tr>
+ <tr>
+ <td align="center"><code>&gt;=88</code></td>
+ <td align="center"><code>&gt;=90</code></td>
+ <td align="center"><code>&gt;=88</code></td>
+ <td align="center"><code>&gt;=14.1</code></td>
+ <td align="center"><code>&gt;=12</code></td>
+ </tr>
+</table>
+
+</div>
+
+<p align="center">Univer は Chrome 88 をターゲットとしてコンパイルされ、上記のバージョンでの動作を目指しています。</p>
+
+<a id="runtime-compatibility"></a>
+
+### 実行環境の互換性
+
+- **ポリフィル**:Univer は `Intl.Segmenter` に依存します。対象のブラウザーやランタイムで利用できない場合は、`@formatjs/intl-segmenter` などのポリフィルを追加してください。
+- **ビルドツール**:Vite、esbuild、Webpack 5 を推奨します。`package.json` の `exports` フィールドに非対応のツール(Webpack 4 など)では、追加のパスマッピングが必要な場合があります。
+- **React**:Univer のビュー層は React 18 を基に構築され、React 18 と 19 に対応し、React 16.9+ と 17 には最小限の互換性サポートを提供します。
+- **Node.js 環境**:Headless Univer は Node.js `>=18.17.0` に対応します。このモノレポの開発には Node.js `>=22.18` が必要です。
+
+<details>
+<summary>このリポジトリでの開発</summary>
+
+### リポジトリ構成
```text
.
-├── packages/ コアパッケージ、エンジン、文書タイプ、UI プラグイン、機能プラグイン
-├── examples/ ローカルブラウザ開発用のオールインワン Vite ワークベンチ
-├── common/ 共有内部ツール、storybook、ユーティリティ
-├── tests/ 追加の統合テストプロジェクト
-└── docs/ アーキテクチャメモ、画像、リポジトリ内ドキュメント
+├── packages/ Core packages, engines, document types, UI plugins, and feature plugins
+├── examples/ All-in-one Vite workbench used for local browser development
+├── common/ Shared internal tooling, storybook, and utilities
+├── tests/ Additional integration test projects
+└── docs/ Architecture notes, images, and repository-local documentation
```
-パッケージごとの README は [`packages/`](../../packages) 配下の各パッケージにあります。
+パッケージごとの README は、[`packages/`](../../packages) 内の各パッケージの隣にあります。
-## 🧑‍💻 開発
+### ローカル開発
-必要環境:
+必要条件:
- Node.js `>=22.18`
-- pnpm `>=11`
+- pnpm:`package.json` の `packageManager` で宣言されたバージョンを使用します。
```bash
git clone https://github.com/dream-num/univer.git
@@ -363,65 +804,109 @@ pnpm install
pnpm dev
```
-よく使うコマンド:
+便利なコマンド:
+
+<div align="center" style="overflow-x: auto;">
+
+<table align="center" style="display: table; width: auto; margin-left: auto; margin-right: auto;">
+<thead>
+<tr>
+<th>コマンド</th>
+<th>用途</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td><code class="notranslate">pnpm dev</code></td>
+<td>Sheets と Docs の開発ワークベンチを起動。</td>
+</tr>
+<tr>
+<td><code class="notranslate">pnpm build</code></td>
+<td>内部 common パッケージを除くワークスペースパッケージをビルド。</td>
+</tr>
+<tr>
+<td><code class="notranslate">pnpm test</code></td>
+<td>Turbo 経由でユニットテストを実行。</td>
+</tr>
+<tr>
+<td><code class="notranslate">pnpm typecheck</code></td>
+<td>Turbo 経由で TypeScript のチェックを実行。</td>
+</tr>
+<tr>
+<td><code class="notranslate">pnpm lint</code></td>
+<td>ESLint を実行。</td>
+</tr>
+<tr>
+<td><code class="notranslate">pnpm storybook:dev</code></td>
+<td>UI コンポーネント開発用に Storybook を起動。</td>
+</tr>
+</tbody>
+</table>
+
+</div>
+
+Pull Request を作成する前に [CONTRIBUTING.md](../../CONTRIBUTING.md) をお読みください。
+
+</details>
-| コマンド | 用途 |
-| --- | --- |
-| `pnpm dev` | 低メモリのオールインワンワークベンチをビルドし、HMR なしでプレビューします。 |
-| `pnpm dev:source` | HMR 対応でソースから起動します。コールドスタートとメモリ使用量は増加します。 |
-| `pnpm build` | 内部 common パッケージを除いて workspace パッケージをビルドします。 |
-| `pnpm test` | Turbo 経由でユニットテストを実行します。 |
-| `pnpm typecheck` | Turbo 経由で TypeScript チェックを実行します。 |
-| `pnpm lint` | ESLint を実行します。 |
-| `pnpm storybook:dev` | UI コンポーネント開発用の Storybook を起動します。 |
+<details>
+<summary>アーキテクチャと貢献の参考資料</summary>
-Pull request を作成する前に [CONTRIBUTING.md](../../CONTRIBUTING.md) を読んでください。
+- [リポジトリのパッケージ](../../packages)、[プリセット](../../presets)、[サンプル](../../examples)。
+- [同型 Univer の構築](../../docs/ISOMORPHIC.md)。
+- [Facade API への貢献](../../docs/CONTRIBUTING-FACADE.md)。
+- [API 安定性ポリシー](../../docs/API_STABILITY.md)。
+- [命名規則](../../docs/NAMING_CONVENTION.md)と[メモリリークの修正](../../docs/FIX_MEMORY_LEAK.md)。
+- [アーキテクチャの TLDR](../../docs/tldr)と [OLE 添付ファイルの説明](../../packages/drawing/docs/ole-attachments.md)。
-## 📝 Contributor Notes
+</details>
-より深い変更を行う前に読む価値のあるリポジトリ内メモです。
+<p align="right"><a href="#readme-top"><img src="https://img.shields.io/badge/%E2%86%91%20%E5%85%88%E9%A0%AD%E3%81%AB%E6%88%BB%E3%82%8B-30363D?style=flat-square" alt="先頭に戻る" height="20" /></a></p>
-- [Building Isomorphic Univer](../ISOMORPHIC.md):ブラウザ、Node.js、UI、共有プラグインロジックの分離方針。
-- [API Stability Policy](../API_STABILITY.md):stable、experimental、internal、deprecated、breaking-change expectations。
-- [Contributing to Facade API](../CONTRIBUTING-FACADE.md):`FUniver`、`FWorkbook`、`FRange` などの Facade API 設計方針。
-- [Naming Convention](../NAMING_CONVENTION.md):ファイル、フォルダ、インターフェース、プラグイン、コマンド、DI token の命名規則。
-- [Fixing Memory Leaks](../FIX_MEMORY_LEAK.md):Univer インスタンスでよくあるメモリリークパターンとデバッグ手順。
-- [Architecture TLDRs](../tldr):数式エンジン、Web Worker、権限、選択、ref-range の簡潔な設計メモ。
+<a id="community"></a>
## 💬 コミュニティ
-- [GitHub Discussions](https://github.com/dream-num/univer/discussions) で質問できます。
-- [Discord](https://discord.gg/z3NKNT6D2f) でコミュニティと交流できます。
-- [Twitter / X](https://twitter.com/univerhq) と [YouTube](https://www.youtube.com/@dreamNum) もフォローできます。
+[GitHub Discussions](https://github.com/dream-num/univer/discussions) で質問し、[Discord](https://discord.gg/z3NKNT6D2f) に参加して、[X](https://twitter.com/univerhq) や [YouTube](https://www.youtube.com/@dreamNum) をフォローしてください。[行動規範](../../CODE_OF_CONDUCT.md)もお読みください。
+
+<p align="right"><a href="#readme-top"><img src="https://img.shields.io/badge/%E2%86%91%20%E5%85%88%E9%A0%AD%E3%81%AB%E6%88%BB%E3%82%8B-30363D?style=flat-square" alt="先頭に戻る" height="20" /></a></p>
-参加する前に [Code of Conduct](../../CODE_OF_CONDUCT.md) を読んでください。
+<a id="security"></a>
## 🔒 セキュリティ
セキュリティ上の問題を見つけたと思われる場合は、[Security Policy](../../SECURITY.md) に従ってください。
+<p align="right"><a href="#readme-top"><img src="https://img.shields.io/badge/%E2%86%91%20%E5%85%88%E9%A0%AD%E3%81%AB%E6%88%BB%E3%82%8B-30363D?style=flat-square" alt="先頭に戻る" height="20" /></a></p>
+
+<a id="sponsors"></a>
+
## ❤️ スポンサー
Univer はコミュニティとスポンサーによって支えられています。[Open Collective](https://opencollective.com/univer) からプロジェクトを支援できます。
-<a href="https://opencollective.com/univer/sponsor/0/website"><img src="https://opencollective.com/univer/sponsor/0/avatar.svg" alt="Sponsor 0" /></a>
-<a href="https://opencollective.com/univer/sponsor/1/website"><img src="https://opencollective.com/univer/sponsor/1/avatar.svg" alt="Sponsor 1" /></a>
-<a href="https://opencollective.com/univer/sponsor/2/website"><img src="https://opencollective.com/univer/sponsor/2/avatar.svg" alt="Sponsor 2" /></a>
-<a href="https://opencollective.com/univer/sponsor/3/website"><img src="https://opencollective.com/univer/sponsor/3/avatar.svg" alt="Sponsor 3" /></a>
-<a href="https://opencollective.com/univer/sponsor/4/website"><img src="https://opencollective.com/univer/sponsor/4/avatar.svg" alt="Sponsor 4" /></a>
-<a href="https://opencollective.com/univer/sponsor/5/website"><img src="https://opencollective.com/univer/sponsor/5/avatar.svg" alt="Sponsor 5" /></a>
-<a href="https://opencollective.com/univer/sponsor/6/website"><img src="https://opencollective.com/univer/sponsor/6/avatar.svg" alt="Sponsor 6" /></a>
-
-<a href="https://opencollective.com/univer/backer/0/website"><img src="https://opencollective.com/univer/backer/0/avatar.svg" alt="Backer 0" /></a>
-<a href="https://opencollective.com/univer/backer/1/website"><img src="https://opencollective.com/univer/backer/1/avatar.svg" alt="Backer 1" /></a>
-<a href="https://opencollective.com/univer/backer/2/website"><img src="https://opencollective.com/univer/backer/2/avatar.svg" alt="Backer 2" /></a>
-<a href="https://opencollective.com/univer/backer/3/website"><img src="https://opencollective.com/univer/backer/3/avatar.svg" alt="Backer 3" /></a>
-<a href="https://opencollective.com/univer/backer/4/website"><img src="https://opencollective.com/univer/backer/4/avatar.svg" alt="Backer 4" /></a>
-<a href="https://opencollective.com/univer/backer/5/website"><img src="https://opencollective.com/univer/backer/5/avatar.svg" alt="Backer 5" /></a>
-<a href="https://opencollective.com/univer/backer/6/website"><img src="https://opencollective.com/univer/backer/6/avatar.svg" alt="Backer 6" /></a>
+<p>
+ <a href="https://opencollective.com/univer/sponsor/0/website"><img src="https://opencollective.com/univer/sponsor/0/avatar.svg" alt="スポンサーになる" /></a>
+</p>
+
+<p>
+ <a href="https://opencollective.com/univer/backer/0/website"><img src="https://opencollective.com/univer/backer/0/avatar.svg" width="64" height="64" alt="Backer 0" /></a>
+ <a href="https://opencollective.com/univer/backer/1/website"><img src="https://opencollective.com/univer/backer/1/avatar.svg" width="64" height="64" alt="Backer 1" /></a>
+ <a href="https://opencollective.com/univer/backer/2/website"><img src="https://opencollective.com/univer/backer/2/avatar.svg" width="64" height="64" alt="Backer 2" /></a>
+ <a href="https://opencollective.com/univer/backer/3/website"><img src="https://opencollective.com/univer/backer/3/avatar.svg" width="64" height="64" alt="Backer 3" /></a>
+ <a href="https://opencollective.com/univer/backer/4/website"><img src="https://opencollective.com/univer/backer/4/avatar.svg" width="64" height="64" alt="Backer 4" /></a>
+ <a href="https://opencollective.com/univer/backer/5/website"><img src="https://opencollective.com/univer/backer/5/avatar.svg" width="64" height="64" alt="Backer 5" /></a>
+ <a href="https://opencollective.com/univer/backer/6/website"><img src="https://opencollective.com/univer/backer/6/avatar.svg" width="64" height="64" alt="Backer 6" /></a>
+</p>
+
+<p align="right"><a href="#readme-top"><img src="https://img.shields.io/badge/%E2%86%91%20%E5%85%88%E9%A0%AD%E3%81%AB%E6%88%BB%E3%82%8B-30363D?style=flat-square" alt="先頭に戻る" height="20" /></a></p>
+
+<a id="license"></a>
## 📄 ライセンス
Copyright (c) 2021-present DreamNum Co., Ltd.
-[Apache-2.0](../../LICENSE) ライセンスの下で公開されています。
+このリポジトリのオープンソースパッケージは [Apache-2.0](../../LICENSE) の下で提供されています。商用 SDK モジュールは個別に配布・ライセンス提供されます。
+
+<p align="right"><a href="#readme-top"><img src="https://img.shields.io/badge/%E2%86%91%20%E5%85%88%E9%A0%AD%E3%81%AB%E6%88%BB%E3%82%8B-30363D?style=flat-square" alt="先頭に戻る" height="20" /></a></p>
diff --git a/docs/readme/ko-KR.md b/docs/readme/ko-KR.md
index 2c3f4609fb..5460feb700 100644
--- a/docs/readme/ko-KR.md
+++ b/docs/readme/ko-KR.md
@@ -1,157 +1,296 @@
-<div align="center">
+<a id="readme-top"></a>
-<img src="../img/banner.png" alt="Univer SDK" width="800" />
+<p align="center"><img src="../../docs/img/readme/hero-banner.png" alt="Univer Office SDK" width="960" /></p>
-**AI 에이전트를 위한 Office Harness**
+<h1 align="center">Univer Office SDK로 나만의 AI 오피스를 구축하세요.</h1>
-스프레드시트 · 문서 · 프레젠테이션 · Bases · Boards · PDF
+<p align="center">오픈 소스 Sheets와 Docs로 시작해 자체 애플리케이션이나 에이전트를 연결하세요.</p>
-고성능, 완전한 커스터마이징을 지원하는 Office SDK
+<p align="center"><a href="#quick-start">🚀 빠른 시작</a> · <a href="https://docs.univer.ai/">📚 문서</a> · <a href="https://univer.ai/compare/">⚖️ 기능 비교</a> · <a href="https://univer.ai/">🌐 웹사이트</a> · <a href="https://docs.univer.ai/showcase">🎮 쇼케이스</a> · <a href="https://docs.univer.ai/reference/classes/univer">🔧 API Reference</a> · <a href="https://docs.univer.ai/blog">📝 블로그</a></p>
-Univer는 플러그인 아키텍처, Canvas 기반 렌더링, 수식 엔진,
-브라우저와 Node.js에서 함께 사용할 수 있는 Facade API로
-임베드 가능한 생산성 경험을 만들 수 있게 해줍니다.
+<p align="center"><a href="../../README.md">English</a> · <a href="../../docs/readme/fr-FR.md">Français</a> · <a href="../../docs/readme/de-DE.md">Deutsch</a> · <a href="../../docs/readme/es-ES.md">Español</a> · <a href="../../docs/readme/zh-CN.md">简体中文</a> · <a href="../../docs/readme/zh-TW.md">繁體中文</a> · <a href="../../docs/readme/ja-JP.md">日本語</a> · <strong>한국어</strong></p>
-[English](../../README.md) | [简体中文](./zh-CN.md) | [繁體中文](./zh-TW.md) | [日本語](./ja-JP.md) | 한국어 | [Español](./es-ES.md)
+<p align="center">
+ <a href="https://github.com/dream-num/univer/releases"><img src="https://img.shields.io/github/v/release/dream-num/univer?style=flat&amp;labelColor=30363D&amp;color=4F46E5&amp;logo=github&amp;logoColor=white" alt="Release" /></a>
+ <a href="../../LICENSE"><img src="https://img.shields.io/github/license/dream-num/univer?style=flat&amp;labelColor=30363D&amp;color=0F766E" alt="License" /></a>
+ <a href="https://github.com/dream-num/univer/actions/workflows/build-packages.yml"><img src="https://img.shields.io/github/actions/workflow/status/dream-num/univer/build-packages.yml?style=flat&amp;labelColor=30363D" alt="Build" /></a>
+ <a href="https://www.codefactor.io/repository/github/dream-num/univer/overview/dev"><img src="https://www.codefactor.io/repository/github/dream-num/univer/badge/dev?style=flat" alt="CodeFactor" /></a>
+ <a href="https://codecov.io/gh/dream-num/univer"><img src="https://img.shields.io/codecov/c/gh/dream-num/univer?token=aPfyW2pIMN&amp;style=flat&amp;labelColor=30363D" alt="Codecov" /></a>
+</p>
-[🌐 공식 웹사이트](https://univer.ai/) | [📖 문서](https://docs.univer.ai) | [✨ 쇼케이스](https://docs.univer.ai/showcase) | [📘 API Reference](https://docs.univer.ai/reference/classes/univer) | [📝 블로그](https://docs.univer.ai/blog)
+<p align="center">
+ <a href="https://github.com/dream-num/univer"><img src="https://img.shields.io/github/stars/dream-num/univer?style=flat&amp;labelColor=30363D&amp;color=4F46E5" alt="Stars" /></a>
+ <a href="https://github.com/dream-num/univer/graphs/contributors"><img src="https://img.shields.io/github/contributors/dream-num/univer?style=flat&amp;labelColor=30363D&amp;color=4F46E5" alt="Contributors" /></a>
+ <a href="https://github.com/dream-num/univer/issues"><img src="https://img.shields.io/github/issues/dream-num/univer?style=flat&amp;labelColor=30363D&amp;color=4F46E5" alt="Issues" /></a>
+ <a href="https://github.com/dream-num/univer/commits/dev/"><img src="https://img.shields.io/github/last-commit/dream-num/univer?style=flat&amp;labelColor=30363D&amp;color=4F46E5" alt="Last Commit" /></a>
+</p>
-[![Release](https://img.shields.io/github/v/release/dream-num/univer?style=flat-square)](https://github.com/dream-num/univer/releases)
-[![License](https://img.shields.io/github/license/dream-num/univer?style=flat-square)](../../LICENSE)
-[![Build](https://img.shields.io/github/actions/workflow/status/dream-num/univer/build-packages.yml?style=flat-square)](https://github.com/dream-num/univer/actions/workflows/build-packages.yml)
-[![CodeFactor](https://www.codefactor.io/repository/github/dream-num/univer/badge/dev?style=flat-square)](https://www.codefactor.io/repository/github/dream-num/univer/overview/dev)
-[![Codecov](https://img.shields.io/codecov/c/gh/dream-num/univer?token=aPfyW2pIMN&style=flat-square)](https://codecov.io/gh/dream-num/univer)
+<p align="center">
+ <a href="https://discord.gg/z3NKNT6D2f"><img src="https://img.shields.io/discord/1136129819961217077?logo=discord&amp;logoColor=FFFFFF&amp;label=discord&amp;color=5865F2&amp;style=flat&amp;labelColor=30363D" alt="Discord" /></a>
+ <a href="https://twitter.com/univerhq"><img src="https://img.shields.io/badge/%40univerhq-18181B?style=flat&amp;logo=x&amp;logoColor=white" alt="X: @univerhq" /></a>
+ <a href="https://opencollective.com/univer"><img src="https://img.shields.io/opencollective/all/univer?logo=opencollective&amp;style=flat&amp;labelColor=30363D&amp;color=0F766E&amp;label=supporters&amp;logoColor=white" alt="Open Collective" /></a>
+</p>
-[![Stars](https://img.shields.io/github/stars/dream-num/univer?style=flat-square)](https://github.com/dream-num/univer/stargazers)
-[![Contributors](https://img.shields.io/github/contributors/dream-num/univer?style=flat-square)](https://github.com/dream-num/univer/graphs/contributors)
-[![Issues](https://img.shields.io/github/issues/dream-num/univer?style=flat-square)](https://github.com/dream-num/univer/issues)
-[![Last Commit](https://img.shields.io/github/last-commit/dream-num/univer?style=flat-square)](https://github.com/dream-num/univer/commits/dev/)
+<p align="center">
+ <a href="https://trendshift.io/repositories/4376"><img src="https://trendshift.io/api/badge/repositories/4376" alt="Trendshift" /></a>
+</p>
-[![Discord](https://img.shields.io/discord/1136129819961217077?logo=discord&logoColor=FFFFFF&label=discord&color=5865F2&style=flat-square)](https://discord.gg/z3NKNT6D2f)
-[![Twitter](https://img.shields.io/twitter/follow/univerhq?style=flat-square&logo=x)](https://twitter.com/univerhq)
-[![Open Collective](https://img.shields.io/opencollective/all/univer?logo=opencollective&style=flat-square)](https://opencollective.com/univer)
+<details>
+<summary>목차</summary>
+
+- [💡 Univer란?](#what-is-univer)
+ - [오픈 소스 기능](#open-source-capabilities)
+- [🚀 오픈 소스 기반으로 구축하기](#what-you-can-build)
+ - [빠른 시작: 오픈 소스 스프레드시트 편집기](#quick-start)
+ - [애플리케이션을 편집 가능한 콘텐츠에 연결하기](#connect-your-application-to-editable-content)
+- [🏗️ 오픈 소스 아키텍처 살펴보기](#open-source-architecture)
+ - [맞춤 기능의 경계를 명확하게 나누기](#give-custom-features-clear-boundaries)
+ - [여러 기능의 편집과 실행 취소/다시 실행 조합하기](#compose-cross-feature-edits-and-undoredo)
+ - [Facade API와 이벤트로 애플리케이션 및 에이전트 연결하기](#connect-applications-and-agents-through-facade-apis-and-events)
+- [🧩 Univer Office SDK로 애플리케이션 확장하기](#open-source-and-commercial-extensions)
+ - [범위와 라이선스](#scope-and-licensing)
+- [🌐 애플리케이션 패턴과 생태계](#application-patterns-and-ecosystem)
+ - [Univer Workspace: Office SDK 참조 애플리케이션](#univer-workspace-an-office-sdk-reference-application)
+ - [CLI, 에이전트 통합, 개발 스킬](#cli-agent-integrations-and-developer-skills)
+- [📚 문서와 기여](#documentation-and-contributing)
+ - [런타임 호환성](#runtime-compatibility)
+- [💬 커뮤니티](#community)
+- [🔒 보안](#security)
+- [❤️ 스폰서](#sponsors)
+- [📄 라이선스](#license)
+
+</details>
+
+<a id="what-is-univer"></a>
+
+## 💡 Univer란?
+
+<p align="center"><img src="../../docs/img/readme/intro-banner.png" alt="Univer Office SDK: Web, Server, and AI SDKs" width="960" /></p>
+
+**Univer**는 자체 제품 안에 오피스 애플리케이션을 구축하기 위한 Office SDK입니다. 자체 데이터와 권한을 사용해 사용자와 기존 에이전트에 오피스 편집, 계산, 협업, 파일 처리 기능을 제공합니다. 제품군에는 스프레드시트, 문서, 프레젠테이션, 관계형 테이블, 캔버스, PDF가 포함됩니다.
+
+Univer Office SDK는 세 부분으로 구성됩니다.
+
+- **Web SDK**는 기반이 되는 부분으로 콘텐츠 모델, 편집, 렌더링, 수식 계산, Facade API(애플리케이션용 API)를 제공합니다. 플러그인을 조합해 임베디드 편집기나 자체 오피스 애플리케이션을 구축하고, 대화형 편집기 없이 콘텐츠 모델, 명령, 계산을 Headless 처리에 재사용할 수 있습니다.
+- **Server SDK**는 실시간 협업, 편집 이력, 오피스 파일 가져오기와 내보내기를 위한 백엔드 서비스를 추가합니다.
+- **AI SDK**는 콘텐츠 도구, 실행 및 검토 통합을 통해 오피스 기능을 기존 에이전트와 워크플로에 연결합니다.
+
+**이 저장소는 Apache-2.0 라이선스로 Web SDK의 핵심 아키텍처와 엔진 구현을 제공합니다.** 콘텐츠 모델과 스냅샷 형식, 플러그인 및 의존성 관리, 명령 시스템, 수식 및 렌더링 엔진, Facade API, UI 기반, Sheets와 Docs 편집 기능이 포함됩니다. 상용 Web SDK 플러그인, Server SDK, 상용 AI SDK 확장 기능은 별도로 배포되고 라이선스가 부여됩니다.
+
+에이전트도 동일한 오픈 소스 API를 사용할 수 있으며, 모델과 도구 오케스트레이션은 애플리케이션에서 제공합니다. [견적서 예제](#connect-your-application-to-editable-content)는 AI SDK에 의존하지 않는 편집, 계산, 저장을 보여 줍니다.
+
+<a id="open-source-capabilities"></a>
+
+### 오픈 소스 기능
-[![Trendshift](https://trendshift.io/api/badge/repositories/4376)](https://trendshift.io/repositories/4376)
+<div align="center" style="overflow-x: auto;">
+
+<table align="center" style="display: table; width: auto; margin-left: auto; margin-right: auto;">
+<thead>
+<tr>
+<th>영역</th>
+<th>주요 기능</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td><strong>Sheets · 편집과 레이아웃</strong></td>
+<td>셀 스타일, 셀 병합, 셀 내부 서식 있는 텍스트, 틀 고정, 부동 이미지, 실행 취소/다시 실행.</td>
+</tr>
+<tr>
+<td><strong>Sheets · 데이터와 계산</strong></td>
+<td>수식, 정의된 이름, 필터링, 정렬, 데이터 유효성 검사, 조건부 서식, 하이퍼링크, 댓글, 찾기 및 바꾸기.</td>
+</tr>
+<tr>
+<td><strong>Docs</strong></td>
+<td>서식 있는 텍스트 편집, 단락 서식, 목록, 하이퍼링크, 댓글, 그리기 기능 통합.</td>
+</tr>
+</tbody>
+</table>
</div>
-## ✨ Univer란?
+기능은 플러그인과 프리셋으로 조합합니다. [빠른 시작](#quick-start)은 **Sheets Core 프리셋**만 사용합니다. 이미지에는 해당 그리기 플러그인이 필요합니다. 오픈 소스와 상용 기능의 상세 범위는 [기능 비교](https://univer.ai/compare/)를 확인하세요.
+
+아래 데모는 상용 기능을 포함한 더 넓은 **Univer Office SDK**를 보여 줍니다. 기본 오픈 소스 구성보다 많은 기능을 포함하며, 범위는 [오픈 소스와 상용 확장](#open-source-and-commercial-extensions)을 참고하세요.
+
+<div align="center" style="overflow-x: auto;">
+
+<table align="center" style="display: table; width: auto; margin-left: auto; margin-right: auto;">
+<tbody>
+<tr>
+ <td width="50%"><a href="https://univer.ai/demo/spreadsheets"><img src="../../docs/img/readme/cards/sheets.webp" alt="Sheets — 편집과 레이아웃 · 데이터와 계산 — 데모 열기" width="420" /></a></td>
+ <td width="50%"><a href="https://univer.ai/demo/docs"><img src="../../docs/img/readme/cards/docs.webp" alt="Docs — 서식 있는 텍스트 편집 — 데모 열기" width="420" /></a></td>
+</tr>
+<tr>
+ <td width="50%"><a href="https://univer.ai/demo/web-app"><img src="../../docs/img/readme/cards/web-app.webp" alt="Web App — 시트 기반 앱 — 데모 열기" width="420" /></a></td>
+ <td width="50%"><a href="https://univer.ai/demo/universe"><img src="../../docs/img/readme/cards/universe.webp" alt="Univer — 조합된 오피스 콘텐츠 — 데모 열기" width="420" /></a></td>
+</tr>
+<tr>
+ <td width="50%"><a href="https://univer.ai/demo/slides"><img src="../../docs/img/readme/cards/slides.webp" alt="Slides — 데모 열기" width="420" /></a></td>
+ <td width="50%"><a href="https://univer.ai/demo/relational-tables"><img src="../../docs/img/readme/cards/relational-tables.webp" alt="Relational Tables — 데모 열기" width="420" /></a></td>
+</tr>
+<tr>
+ <td width="50%"><a href="https://univer.ai/demo/canvases"><img src="../../docs/img/readme/cards/canvases.webp" alt="Canvases — 데모 열기" width="420" /></a></td>
+ <td width="50%"><a href="https://univer.ai/demo/pdf"><img src="../../docs/img/readme/cards/pdf.webp" alt="PDF — 데모 열기" width="420" /></a></td>
+</tr>
+</tbody>
+</table>
-Univer는 제품 안에 오피스 애플리케이션을 만들기 위한 오픈소스 SDK입니다. 호스팅 앱이나 고정된 UI를 강제하지 않으면서 스프레드시트, 문서, 프레젠테이션 경험에 필요한 빌딩 블록을 제공합니다.
+</div>
-Univer는 다음과 같은 경우에 적합합니다.
+<p align="right"><a href="#readme-top"><img src="https://img.shields.io/badge/%E2%86%91%20%EB%A7%A8%20%EC%9C%84%EB%A1%9C-30363D?style=flat-square" alt="맨 위로" height="20" /></a></p>
+
+<a id="what-you-can-build"></a>
+
+## 🚀 오픈 소스 기반으로 구축하기
+
+<p align="center"><img src="../../docs/img/readme/build-banner.png" alt="Build on open source" width="960" /></p>
+
+<div align="center" style="overflow-x: auto;">
+
+<table align="center" style="display: table; width: auto; margin-left: auto; margin-right: auto;">
+<thead>
+<tr>
+<th>목표</th>
+<th>오픈 소스 기반 활용</th>
+<th>시작점</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td><strong>Sheets 또는 Docs 임베딩</strong></td>
+<td>애플리케이션이나 에이전트 제품에 편집 가능한 오피스 화면을 추가하고 Facade API로 데이터를 연결합니다.</td>
+<td><a href="#quick-start">빠른 시작</a></td>
+</tr>
+<tr>
+<td><strong>편집기 없이 콘텐츠 처리</strong></td>
+<td>Node.js에서 콘텐츠 플러그인, 모델, 명령, 계산을 재사용해 편집, 스냅샷, 자동화 작업을 수행합니다.</td>
+<td><a href="https://docs.univer.ai/guides/sheets/getting-started/node">Headless 가이드</a></td>
+</tr>
+<tr>
+<td><strong>맞춤 기능 또는 편집기 개발</strong></td>
+<td>엔진, UI 컴포넌트, 플러그인 경계, 의존성 주입, 명령/실행 취소 시스템을 재사용합니다. 기존 기능을 참고해 Sheets와 Docs를 확장하거나 자체 편집기를 개발합니다.</td>
+<td><a href="#open-source-architecture">오픈 소스 아키텍처</a></td>
+</tr>
+</tbody>
+</table>
-- SaaS 제품, 내부 도구, BI 워크플로, AI 애플리케이션에 스프레드시트나 문서 편집 기능을 임베드할 때.
-- 브라우저와 같은 아키텍처로 서버에서 워크북/문서 처리를 실행할 때.
-- 필요한 기능만 플러그인으로 조합하거나 presets로 빠르게 시작할 때.
-- 커스텀 플러그인, 명령, 서비스, UI 컴포넌트, Facade API로 동작을 확장할 때.
+</div>
-Univer는 단순한 스프레드시트 파일 뷰어가 아닙니다. 자체 생산성 화면을 구축하기 위한 프레임워크입니다.
+**여러 기능에 걸친 편집과 실행 취소/다시 실행을 조율합니다.** 필터 범위에 행을 삽입하면 기본 콘텐츠와 필터 범위가 모두 바뀌며, 실행 취소 시 둘 다 복원해야 합니다. 각 기능이 자체 변경과 실행 취소 데이터를 제공하고, 명령이 실행과 이력을 조합합니다. 아키텍처 설명에서 이러한 편집 흐름을 확장하는 방법을 다룹니다.
-[Univer 제품군](https://univer.ai/)의 오피스 도구는 저장과 연산을 위한 런타임을 공유합니다. 서로 다른 도구의 콘텐츠를 자유롭게 조합하고 임베드하며, 원본이 바뀌면 연결된 데이터와 참조도 함께 업데이트됩니다. 사람과 AI 에이전트가 같은 파일에서 협업할 수 있습니다. 제품별 기능은 [기능 목록](https://univer.ai/capabilities)을, 이 저장소의 범위는 [Open Source와 Pro](#-open-source와-pro)를 참고하세요.
+<a id="quick-start"></a>
-### Univer Office SDK로 협업 도구 만들기
+### 빠른 시작: 오픈 소스 스프레드시트 편집기
-[![Univer Office SDK로 협업 도구 만들기](https://i.ytimg.com/vi/1p-SMEiK6Kg/maxresdefault.jpg)](https://www.youtube.com/watch?v=1p-SMEiK6Kg)
+Vite 같은 번들러를 사용하는 브라우저 애플리케이션에서 다음을 실행합니다.
-[데모 보기](https://www.youtube.com/watch?v=1p-SMEiK6Kg)
+```bash
+pnpm add @univerjs/presets @univerjs/preset-sheets-core
+```
-## Univer Office SDK로 만든 프로젝트
+Univer를 초기화하기 전에 컨테이너를 만드세요.
-### 주요 사례: Univer Workspace
+```html
+<div id="app" style="height: 100vh"></div>
+```
-[Univer Workspace](https://github.com/dream-num/univer-workspace)는 Univer Office SDK를 기반으로 구축된 오픈소스 워크스페이스로, 직접 호스팅할 수 있습니다. 사람과 AI 에이전트가 오피스 콘텐츠를 만들고, 함께 작업하며, 검토할 수 있습니다. 개발자는 전체 구현을 참고하여 SDK 통합 방법을 배우고 자체 제품을 만들 수 있습니다.
+```ts
+import { UniverSheetsCorePreset } from '@univerjs/preset-sheets-core'
+import UniverPresetSheetsCoreEnUS from '@univerjs/preset-sheets-core/locales/en-US'
+import { createUniver, LocaleType, mergeLocales } from '@univerjs/presets'
+import '@univerjs/preset-sheets-core/lib/index.css'
-[![연결된 스프레드시트 옆에 표시된 Workspace 미니 앱. 지표, 차트, 컨트롤이 셀에 연결되어 있습니다](../img/workspace-mini-app.png)](https://github.com/dream-num/univer-workspace)
+const { univerAPI } = createUniver({
+ locale: LocaleType.EN_US,
+ locales: {
+ [LocaleType.EN_US]: mergeLocales(UniverPresetSheetsCoreEnUS),
+ },
+ presets: [
+ UniverSheetsCorePreset({
+ container: 'app',
+ }),
+ ],
+})
-- 에이전트는 의사결정 대시보드, 대화형 보고서, 비즈니스 대시보드 등 스프레드시트 기반 미니 앱을 생성할 수 있습니다.
-- 웹 페이지의 지표, 차트, 컨트롤은 셀에 연결되어 데이터 읽기, 쓰기, 공동 업데이트를 지원합니다.
+univerAPI.createWorkbook({})
+```
-[Univer Workspace 살펴보기](https://github.com/dream-num/univer-workspace)
+이제 페이지에 스프레드시트 편집기가 있습니다. 반환된 `univerAPI`로 콘텐츠를 조작하세요. 이 예제는 오픈 소스 패키지를 사용하므로 상용 Univer 라이선스나 Server SDK가 필요하지 않습니다.
-### 다른 사례
+컴포넌트 프레임워크에서는 `createUniver`가 반환한 `univer` 인스턴스를 보관하고 컴포넌트가 언마운트될 때 `univer.dispose()`를 호출하세요. [수명 주기 가이드](https://docs.univer.ai/guides/sheets/getting-started/lifecycle)를 참고하세요.
-다음 오픈소스 프로젝트는 Univer Office SDK를 기반으로 만들어졌습니다.
+프리셋은 플러그인을 조합하고 Facade API를 등록합니다. 수동 제어가 필요하면 아래의 [플러그인 모드 예제](#manual-plugin-composition)를 확인하세요. [설치 가이드](https://docs.univer.ai/guides/sheets/getting-started/installation)는 두 모드, 피어 의존성, 프레임워크 통합을 다룹니다.
-| 프로젝트 | 설명 |
-| --- | --- |
-| [Univer Office for DeepSeek Harness](https://github.com/dream-num/dsh-univer-office) | 연결된 콘텐츠, 검증, 에이전트 협업을 위한 격리된 Worktree를 제공하는 DeepSeek Harness용 오피스 플러그인입니다. |
-| [Univer CLI](https://github.com/dream-num/univer-cli) | 에이전트가 오피스 콘텐츠를 만들고 편집, 검사, 전달할 수 있는 로컬 명령줄 워크스페이스입니다. |
-| [Univer Office for WorkBuddy](https://github.com/dream-num/workbuddy-univer-office) | MCP 미리 보기와 초안 검토를 지원하는 WorkBuddy용 로컬 오피스 통합입니다. 개발 프리뷰 버전입니다. |
-| [Univer Office for OpenClaw](https://github.com/dream-num/openclaw-univer-office) | OpenClaw에서 오피스 콘텐츠를 만들고 검토하고 전달하기 위한 도구입니다. |
+함께 사용하는 `@univerjs/*` 패키지는 같은 버전으로 유지하세요. 상용 패키지는 일치하는 릴리스 계열을 사용해야 합니다. 아이콘처럼 독립적으로 배포되는 패키지는 각 패키지의 호환성 선언을 따릅니다. [API 안정성 정책](../../docs/API_STABILITY.md)을 참고하세요.
-설치 방법과 SDK 라이선스 요구 사항은 각 프로젝트 문서에 안내되어 있습니다.
+<a id="connect-your-application-to-editable-content"></a>
-## 🌟 Highlights
+### 애플리케이션을 편집 가능한 콘텐츠에 연결하기
-<table>
- <tr>
- <td align="center" width="33%">
- ⚡<br />
- <strong>대규모 화면에 맞춘 설계</strong><br />
- <sub>Canvas 기반 렌더링과 전용 수식 엔진이 복잡한 워크북도 반응성 있게 유지합니다.</sub>
- </td>
- <td align="center" width="33%">
- 🧩<br />
- <strong>플러그인 중심 확장</strong><br />
- <sub>필요한 기능을 조합, 교체, 지연 로딩하거나 확장할 수 있습니다.</sub>
- </td>
- <td align="center" width="33%">
- 🤖<br />
- <strong>Headless AI 인프라</strong><br />
- <sub>Node.js에서 워크북과 문서 로직을 실행해 에이전트, 자동화, 서버 사이드 워크플로를 지원합니다.</sub>
- </td>
- </tr>
- <tr>
- <td align="center" width="33%">
- 🛠️<br />
- <strong>제품 통합을 위한 SDK</strong><br />
- <sub>프레임워크 어댑터, Facade API, presets, headless runtime이 실제 통합 경로에 맞춰집니다.</sub>
- </td>
- <td align="center" width="33%">
- 🌗<br />
- <strong>Dark mode 지원</strong><br />
- <sub>UI 컴포넌트와 렌더링 엔진이 모두 라이트/다크 테마를 지원합니다.</sub>
- </td>
- <td align="center" width="33%">
- 🔌<br />
- <strong>통합 Facade API</strong><br />
- <sub>브라우저와 Node.js에서 워크북, 범위, 수식, 문서를 일관된 API로 다룰 수 있습니다.</sub>
- </td>
- </tr>
-</table>
+Facade API는 통합 문서, 워크시트, 범위를 위한 애플리케이션 인터페이스입니다. 빠른 시작에 이어 견적서를 채우고, 애플리케이션 코드에서 수량을 변경한 뒤, 다시 계산된 합계를 읽어 보세요.
-## 🚀 왜 Univer인가?
+```ts
+// Wait for formula controllers before editing a newly created workbook.
+await new Promise<void>((resolve) => {
+ if (univerAPI.getCurrentLifecycleStage() >= univerAPI.Enum.LifecycleStages.Steady) {
+ resolve()
+ return
+ }
+ const listener = univerAPI.addEvent(univerAPI.Event.LifeCycleChanged, ({ stage }) => {
+ if (stage === univerAPI.Enum.LifecycleStages.Steady) {
+ listener.dispose()
+ resolve()
+ }
+ })
+})
-- **동형 설계**: 브라우저 UI 앱과 Node.js headless 처리를 모두 실행할 수 있습니다.
-- **플러그인 우선 아키텍처**: 모든 기능은 조합 가능한 플러그인으로 제공되어 추가, 제거, 교체, 지연 로딩이 가능합니다.
-- **빠른 통합을 위한 Preset Mode**: 빠르게 동작하는 앱이 필요할 때 이 저장소의 [`presets/`](../../presets)에 있는 curated plugin collection을 사용할 수 있습니다.
-- **완전한 제어를 위한 Plugin Mode**: 커스텀 로딩, 더 작은 번들, 깊은 통합이 필요할 때 패키지를 직접 조합할 수 있습니다.
-- **Facade API**: 워크북, 워크시트, 범위, 문서, 수식, 명령, 이벤트를 고수준 API로 다룰 수 있습니다.
-- **Canvas 렌더링 엔진**: 큰 편집 가능한 문서 표면을 지원하고 여러 문서 타입이 렌더링 레이어를 공유합니다.
-- **확장 가능한 UI**: React, Vue, Web Components 및 프레임워크별 애플리케이션 셸에 통합할 수 있습니다.
+const workbook = univerAPI.getActiveWorkbook()!
+const sheet = workbook.getActiveSheet()
-## 🤖 AI 에이전트를 위한 오피스 워크플로
+sheet.getRange('A1:D4').setValues([
+ ['Item', 'Quantity', 'Unit price', 'Amount'],
+ ['Seats', 2, 25, '=B2*C2'],
+ ['Support', 1, 100, '=B3*C3'],
+ ['Total', '', '', '=SUM(D2:D3)'],
+])
-Univer의 AI 및 협업 기능은 에이전트 작업, 대화형 편집, 사람의 검토를 연결합니다.
+// An application control or agent can make the same edit.
+sheet.getRange('B2').setValue(4)
-- **프로그래밍 방식의 편집**: 에이전트가 구조화된 API로 오피스 콘텐츠를 검사하고 수정합니다.
-- **결과 검증**: 에이전트가 콘텐츠 검사, 렌더링된 스크린샷, 레이아웃 진단으로 결과를 확인합니다.
-- **Worktree 협업**: 에이전트가 격리된 초안에서 작업한 뒤, 사람이 변경 사항을 검토하고 병합할 내용을 결정합니다.
+univerAPI.getFormula().onCalculationResultApplied().then(() => {
+ console.log(sheet.getRange('D4').getValue()) // 200
+ localStorage.setItem('quotation', JSON.stringify(workbook.save()))
+}).catch(console.error)
+```
-통합 방법은 [AI SDK 문서](https://docs.univer.ai/ai)를 참고하세요. 실시간 편집, 공유 리비전, Worktree 워크플로에는 해당 Web SDK 및 협업 기능이 필요하며, 패키지 제공 여부와 라이선스 요구 사항은 기능에 따라 다릅니다.
+편집기와 애플리케이션은 같은 통합 문서를 조작하며, 수식 변경은 자동으로 다시 계산됩니다. `workbook.save()`는 통합 문서와 등록된 플러그인 데이터가 포함된 JSON 스냅샷을 반환합니다. 영구 저장은 애플리케이션이 담당하며, 이 예제는 브라우저 저장소를 사용합니다. 나중에 페이지를 다시 불러올 때 초기화 후 **빈 통합 문서를 만드는 대신** 스냅샷을 복원하세요.
-## ⚡ 빠른 시작
+```ts
+const saved = localStorage.getItem('quotation')
+if (saved) {
+ univerAPI.createWorkbook(JSON.parse(saved))
+}
+```
+
+이 흐름은 오픈 소스 패키지만 사용합니다. 스냅샷 저장은 XLSX 가져오기 및 내보내기와 별개이며, 후자에는 별도로 배포되는 파일 변환 기능이 필요합니다. 애플리케이션 통합에는 공개 Facade API를 사용하세요. 아래 소스 링크는 내부 구현과 확장 지점을 설명합니다. 확장 지점에 의존하기 전에 [API 안정성 정책](../../docs/API_STABILITY.md)을 확인하세요.
-전체 제품 기능을 활용하고 구성을 정밀하게 제어하려면 **Plugin Mode**를 사용하세요. 지원되는 Sheets, Docs, Node 프로필에서는 **Preset Mode**가 더 짧은 curated setup을 제공합니다.
+<a id="manual-plugin-composition"></a>
-<details open>
-<summary><strong>Plugin Mode</strong></summary>
+<details>
+<summary>고급: 플러그인 수동 조합(플러그인 모드)</summary>
+
+플러그인 선택, 의존성, 로딩을 정밀하게 제어해야 할 때 플러그인 모드를 사용하세요. 위 프리셋은 이 조합을 대신 처리합니다.
-Plugin Mode는 패키지, 스타일 import, locale 병합, Facade API 등록, 플러그인 구성를 더 낮은 수준에서 제어할 수 있게 해줍니다.
+이 대체 초기화 방식은 같은 `app` 컨테이너와 Sheets Core 프리셋의 브라우저 플러그인 구성을 Worker 없이 사용합니다. 프리셋 초기화 **대신** 사용한 다음, 반환된 `univerAPI`로 같은 견적서 예제를 실행하세요.
```bash
-pnpm add @univerjs/core @univerjs/design @univerjs/docs @univerjs/docs-ui @univerjs/engine-formula @univerjs/engine-render @univerjs/sheets @univerjs/sheets-formula @univerjs/sheets-formula-ui @univerjs/sheets-numfmt @univerjs/sheets-numfmt-ui @univerjs/sheets-ui @univerjs/ui
+pnpm add @univerjs/core @univerjs/design @univerjs/docs @univerjs/docs-ui \
+ @univerjs/engine-formula @univerjs/engine-render @univerjs/network \
+ @univerjs/sheets @univerjs/sheets-ui @univerjs/sheets-formula \
+ @univerjs/sheets-formula-ui @univerjs/sheets-numfmt \
+ @univerjs/sheets-numfmt-ui @univerjs/ui
```
```ts
@@ -162,7 +301,9 @@ import { UniverDocsPlugin } from '@univerjs/docs'
import { UniverDocsUIPlugin } from '@univerjs/docs-ui'
import DocsUIEnUS from '@univerjs/docs-ui/locale/en-US'
import { UniverFormulaEnginePlugin } from '@univerjs/engine-formula'
+import FormulaEnUS from '@univerjs/engine-formula/locale/en-US'
import { UniverRenderEnginePlugin } from '@univerjs/engine-render'
+import { UniverNetworkPlugin } from '@univerjs/network'
import { UniverSheetsPlugin } from '@univerjs/sheets'
import SheetsEnUS from '@univerjs/sheets/locale/en-US'
import { UniverSheetsFormulaPlugin } from '@univerjs/sheets-formula'
@@ -176,185 +317,485 @@ import { UniverSheetsUIPlugin } from '@univerjs/sheets-ui'
import SheetsUIEnUS from '@univerjs/sheets-ui/locale/en-US'
import { UniverUIPlugin } from '@univerjs/ui'
import UIEnUS from '@univerjs/ui/locale/en-US'
-
import '@univerjs/design/lib/index.css'
import '@univerjs/ui/lib/index.css'
import '@univerjs/docs-ui/lib/index.css'
import '@univerjs/sheets-ui/lib/index.css'
import '@univerjs/sheets-formula-ui/lib/index.css'
import '@univerjs/sheets-numfmt-ui/lib/index.css'
-
+import '@univerjs/network/facade'
+import '@univerjs/docs/facade'
+import '@univerjs/docs-ui/facade'
import '@univerjs/engine-formula/facade'
-import '@univerjs/ui/facade'
import '@univerjs/sheets/facade'
+import '@univerjs/ui/facade'
import '@univerjs/sheets-ui/facade'
import '@univerjs/sheets-formula/facade'
import '@univerjs/sheets-numfmt/facade'
+import '@univerjs/sheets-formula-ui/facade'
const univer = new Univer({
locale: LocaleType.EN_US,
locales: {
[LocaleType.EN_US]: mergeLocales(
DesignEnUS,
- UIEnUS,
DocsUIEnUS,
+ FormulaEnUS,
SheetsEnUS,
- SheetsUIEnUS,
SheetsFormulaEnUS,
SheetsFormulaUIEnUS,
SheetsNumfmtUIEnUS,
+ SheetsUIEnUS,
+ UIEnUS,
),
},
})
+univer.registerPlugin(UniverNetworkPlugin)
+univer.registerPlugin(UniverDocsPlugin)
univer.registerPlugin(UniverRenderEnginePlugin)
-univer.registerPlugin(UniverFormulaEnginePlugin)
univer.registerPlugin(UniverUIPlugin, { container: 'app' })
-univer.registerPlugin(UniverDocsPlugin)
univer.registerPlugin(UniverDocsUIPlugin)
-univer.registerPlugin(UniverSheetsPlugin)
-univer.registerPlugin(UniverSheetsUIPlugin)
-univer.registerPlugin(UniverSheetsFormulaPlugin)
-univer.registerPlugin(UniverSheetsFormulaUIPlugin)
+univer.registerPlugin(UniverFormulaEnginePlugin)
+univer.registerPlugin(UniverSheetsPlugin, {
+ onlyRegisterFormulaRelatedMutations: false,
+})
+univer.registerPlugin(UniverSheetsUIPlugin, {
+ protectedRangeShadow: true,
+})
univer.registerPlugin(UniverSheetsNumfmtPlugin)
univer.registerPlugin(UniverSheetsNumfmtUIPlugin)
+univer.registerPlugin(UniverSheetsFormulaPlugin)
+univer.registerPlugin(UniverSheetsFormulaUIPlugin)
const univerAPI = FUniver.newAPI(univer)
univerAPI.createWorkbook({})
```
+Docs 플러그인은 스프레드시트의 서식 있는 텍스트 편집을 지원합니다. 기능을 추가할 때는 해당 Facade 확장, 로케일 번들, UI 스타일도 포함하세요. 컨테이너가 언마운트되면 `univer`를 해제하세요.
+
</details>
-<details>
-<summary><strong>Preset Mode</strong></summary>
+<p align="right"><a href="#readme-top"><img src="https://img.shields.io/badge/%E2%86%91%20%EB%A7%A8%20%EC%9C%84%EB%A1%9C-30363D?style=flat-square" alt="맨 위로" height="20" /></a></p>
+
+<a id="open-source-architecture"></a>
+
+## 🏗️ 오픈 소스 아키텍처 살펴보기
+
+<p align="center"><img src="../../docs/img/readme/architecture-banner.png" alt="" width="960" /></p>
+
+<a id="give-custom-features-clear-boundaries"></a>
+
+### 맞춤 기능의 경계를 명확하게 나누기
+
+Univer는 콘텐츠 로직과 UI 상호작용을 별도의 플러그인으로 구성합니다. 기능 플러그인은 규칙과 콘텐츠 변경을 관리하고, UI 플러그인은 인터페이스와 사용자 상호작용을 제공합니다. 예를 들어 `sheets-filter`는 필터 범위와 규칙을 관리하고, `sheets-filter-ui`는 패널, 메뉴, 단축키를 제공합니다.
+
+```mermaid
+%%{init: {'htmlLabels': false, 'theme': 'base', 'themeVariables': {'fontFamily': 'Arial, PingFang SC, Microsoft YaHei, sans-serif', 'fontSize': '17px', 'lineColor': '#64748b'}, 'flowchart': {'htmlLabels': false, 'curve': 'linear', 'nodeSpacing': 28, 'rankSpacing': 45, 'padding': 16, 'wrappingWidth': 270}}}%%
+%% A layered overview, not a complete dependency graph.
+%% Group arrows indicate reuse of the layer below; internal arrows show selected dependencies.
+flowchart TD
+ subgraph FEATURES["Feature Plugins"]
+ direction LR
+ FUI["Filter<br/>UI Plugin"]
+ VUI["Data Validation<br/>UI Plugin"]
+ FILTER["Filter Plugin"]
+ VALIDATION["Data Validation Plugin"]
+ FUI --> FILTER
+ VUI --> VALIDATION
+ end
+
+ subgraph PRODUCTS["Product Plugins"]
+ direction LR
+ SUI["Sheets UI Plugin"]
+ SHEETS["Sheets Plugin"]
+ SUI --> SHEETS
+ end
+
+ subgraph FOUNDATION["Core Framework & Plugins"]
+ direction LR
+ UI["UI Plugin"]
+ FORMULA["Formula Engine Plugin"]
+ RENDER["Render Engine Plugin"]
+ CORE["Core"]
+ UI --> RENDER
+ RENDER --> CORE
+ FORMULA --> CORE
+ end
+
+ FEATURES --> PRODUCTS
+ PRODUCTS --> FOUNDATION
+
+ classDef logic fill:#eff6ff,color:#17365f,stroke:#93b4df,stroke-width:1.5px
+ classDef ui fill:#f0fdf4,color:#17543a,stroke:#91c8a7,stroke-width:1.5px
+ classDef shared fill:#f6f7f9,color:#334155,stroke:#bac3ce,stroke-width:1.5px
+ classDef feature fill:#172d50,color:#ffffff,stroke:#172d50
+ class FUI,VUI ui
+ class FILTER,VALIDATION logic
+ class SUI,SHEETS logic
+ class UI,FORMULA,RENDER,CORE shared
+
+ style FEATURES fill:#f7fcf9,stroke:#b5d8c1,color:#17543a
+ style PRODUCTS fill:#f5f9ff,stroke:#b6cbea,color:#17365f
+ style FOUNDATION fill:#fafbfc,stroke:#cbd2dc,color:#334155
+```
-Presets는 필요한 Facade API 등록과 스타일을 포함하는 Univer 플러그인의 curated collection입니다.
+**그림 1: 세 가지 플러그인 계층.** 기능 플러그인은 제품 플러그인 위에 구축되고, 제품 플러그인은 핵심 프레임워크와 플러그인을 재사용합니다. 그룹 간 화살표는 아래 계층에 대한 의존성을 나타냅니다. Core는 콘텐츠 모델, 명령, 의존성 주입, 수명 주기 관리를 제공합니다. 일부 플러그인과 의존성은 생략했습니다.
-```bash
-pnpm add @univerjs/presets @univerjs/preset-sheets-core
-```
+새 기능은 자체 플러그인에 규칙을 유지하고 공개 서비스, 명령, 정의된 확장 지점으로 협력합니다. UI 플러그인은 공유 UI 서비스와 컴포넌트를 바탕으로 구성됩니다.
-```ts
-import { UniverSheetsCorePreset } from '@univerjs/preset-sheets-core'
-import UniverPresetSheetsCoreEnUS from '@univerjs/preset-sheets-core/locales/en-US'
-import { createUniver, LocaleType, mergeLocales } from '@univerjs/presets'
+의존성은 두 수준에서 명시됩니다.
-import '@univerjs/preset-sheets-core/lib/index.css'
+- **플러그인 사이:** `DependentOn`은 런타임 플러그인 의존성을 선언합니다. 플러그인 서비스가 순서를 정하고, 수명 주기 단계가 의존성 등록, 콘텐츠 초기화, UI 초기화를 분리합니다.
+- **플러그인 내부:** 의존성 주입이 선언된 의존성을 통해 컨트롤러와 서비스를 연결합니다. 지원되는 오버라이드를 사용하면 애플리케이션에서 구현을 교체하거나 플랫폼 서비스를 맞추거나 테스트 대역을 제공할 수 있습니다. 인스턴스 범위의 주입기는 Univer 인스턴스 사이의 애플리케이션 상태를 분리합니다.
-const { univerAPI } = createUniver({
- locale: LocaleType.EN_US,
- locales: {
- [LocaleType.EN_US]: mergeLocales(UniverPresetSheetsCoreEnUS),
- },
- presets: [
- UniverSheetsCorePreset({
- container: 'app',
- }),
- ],
-})
+해제 가능한 등록은 소유자가 해제될 때 명령, 리스너, 컴포넌트, 아이콘을 정리할 수 있게 합니다.
-univerAPI.createWorkbook({})
+[필터 플러그인](../../packages/sheets-filter/src/plugin.ts)과 [UI 플러그인](../../packages/sheets-filter-ui/src/plugin.ts)은 실제 코드에서 이러한 경계를 보여 줍니다.
+
+<details>
+<summary>기능 내부: Model, Controller, Service, UI 기반</summary>
+
+필터링에서 `sheets-filter`는 콘텐츠 로직을, `sheets-filter-ui`는 UI 상호작용을 담당합니다. 각 모듈은 명확한 책임을 가집니다.
+
+```mermaid
+%%{init: {'htmlLabels': false, 'theme': 'base', 'themeVariables': {'fontFamily': 'Arial, PingFang SC, Microsoft YaHei, sans-serif', 'fontSize': '17px', 'lineColor': '#64748b'}, 'flowchart': {'htmlLabels': false, 'curve': 'linear', 'nodeSpacing': 28, 'rankSpacing': 45, 'padding': 16, 'wrappingWidth': 270}}}%%
+%% Every arrow means contains. This is code organization, not execution order.
+flowchart LR
+ FEATURE["Filter Feature"]
+ LOGIC["Filter Plugin"]
+ UI["Filter UI Plugin"]
+ MODEL["Model"]
+ SERVICE["Service"]
+ CONTROLLER["Controller"]
+ COMMAND["Command / Mutation"]
+ FACADE["Facade API"]
+ VIEW["View"]
+ UICTRL["UI Controller"]
+ UISERVICE["UI Service"]
+ FEATURE --> LOGIC
+ FEATURE --> UI
+ LOGIC --> MODEL
+ LOGIC --> SERVICE
+ LOGIC --> CONTROLLER
+ LOGIC --> COMMAND
+ LOGIC --> FACADE
+ UI --> VIEW
+ UI --> UICTRL
+ UI --> UISERVICE
+
+ classDef logic fill:#eff6ff,color:#17365f,stroke:#93b4df,stroke-width:1.5px
+ classDef ui fill:#f0fdf4,color:#17543a,stroke:#91c8a7,stroke-width:1.5px
+ classDef shared fill:#f6f7f9,color:#334155,stroke:#bac3ce,stroke-width:1.5px
+ classDef feature fill:#172d50,color:#ffffff,stroke:#172d50
+ class FEATURE feature
+ class LOGIC,MODEL,SERVICE,CONTROLLER,COMMAND,FACADE logic
+ class UI,VIEW,UICTRL,UISERVICE ui
```
+**그림 2: 코드 구성. 화살표는 “포함”을 뜻합니다.** 두 플러그인 모두 Controller와 Service를 포함할 수 있습니다. 로직 Controller는 콘텐츠 변경과 관련 기능을 조율하고, UI Controller는 메뉴, 단축키, 상호작용을 연결하며, UI Service는 패널 상태를 관리합니다. 이러한 책임은 새 기능의 구현과 테스트에 일관된 구조를 제공합니다.
+
+UI 기반도 같은 분담을 따릅니다. **`@univerjs/design`**은 공유 컴포넌트와 스타일을, **`@univerjs/ui`**는 메뉴, 단축키, 패널, 컴포넌트 등록 등 워크벤치 서비스를, **`@univerjs/icons`**는 아이콘을 제공합니다. 기능은 이러한 확장 지점을 통해 컴포넌트와 아이콘을 등록하고, 메뉴를 추가하고, 렌더링을 연결합니다. 팀은 애플리케이션의 UI 기반을 재사용하며 패널이나 툴바 기능을 추가할 수 있습니다. [UI 개요](https://docs.univer.ai/guides/sheets/ui/overview)와 필터 플러그인의 [컴포넌트 및 아이콘 등록](../../packages/sheets-filter-ui/src/controllers/components.controller.ts)을 확인하세요.
+
</details>
-페이지에는 컨테이너가 필요합니다.
+<a id="compose-cross-feature-edits-and-undoredo"></a>
-```html
-<div id="app" style="height: 100vh"></div>
+### 여러 기능의 편집과 실행 취소/다시 실행 조합하기
+
+예를 들어 필터 범위 안에 행을 삽입하면 필터 플러그인은 해당 범위 변경과 실행 취소 데이터를 제공합니다. 행 명령은 기본 편집과 참여 기능의 변경을 조합해 실행하고, 실행 취소/다시 실행 정보도 함께 기록합니다. 행 삽입 기능은 공유 확장 메커니즘을 활용하고, 필터 플러그인은 자체 범위 갱신 규칙을 담당합니다.
+
+명령 시스템은 세 가지 동작을 구분합니다.
+
+- **Command**는 비즈니스 동작과 필요한 변경을 조율합니다.
+- **Mutation**은 직렬화 가능한 매개변수를 사용해 스냅샷에 저장되는 콘텐츠를 변경합니다.
+- **Operation**은 열린 패널이나 스크롤 위치 같은 일시적인 상태를 변경합니다.
+
+**실행 취소/다시 실행의 공통 구조.** 실행 취소 가능한 편집에서 기능 구현은 정방향 Mutation과 대응하는 역방향 Mutation을 제공하고, Command가 `IUndoRedoService`로 기록합니다. 하나의 동작이 여러 기능에 영향을 미치면 Command는 변경과 실행 취소 데이터를 하나의 기록으로 묶어, 사용자가 전체 동작을 취소하고 다시 실행할 수 있게 합니다. [명령 확장](https://docs.univer.ai/blog/custom-command)을 참고하세요.
+
+기능 사이의 협력도 필요합니다. **인터셉터와 참조 범위 핸들러가 그 협력을 위한 명확한 지점을 제공합니다.** 지원되는 확장 지점에서 플러그인은 검사나 관련 Mutation을 추가하고, API가 정의한 범위에서 인터셉터 우선순위가 실행 순서를 제어합니다.
+
+<details>
+<summary>예제: 명령, 콜백, 기능 조율, 실행 취소/다시 실행</summary>
+
+```mermaid
+%%{init: {'htmlLabels': false, 'theme': 'base', 'themeVariables': {'fontFamily': 'Arial, PingFang SC, Microsoft YaHei, sans-serif', 'fontSize': '17px', 'lineColor': '#64748b'}, 'flowchart': {'htmlLabels': false, 'curve': 'linear', 'nodeSpacing': 28, 'rankSpacing': 45, 'padding': 16, 'wrappingWidth': 270}}}%%
+%% Simplified insert-row example. A command composes mutations and records undo after success.
+%% Events may also fire for nested command executions; not every callback is drawn.
+flowchart TD
+ BEFORE["Before execution<br/>Inspect or cancel"]
+ CMD["Insert-row Command"]
+ BASE["Row mutations"]
+ EXT["Feature extension points<br/>Filter range changes"]
+ MODEL["Execute combined mutations"]
+ UNDO["Record undo and redo"]
+ AFTER["After execution<br/>Notify listeners"]
+ BEFORE --> CMD
+ CMD --> BASE
+ CMD --> EXT
+ BASE --> MODEL
+ EXT --> MODEL
+ MODEL --> UNDO
+ UNDO --> AFTER
+ classDef entry fill:#f6f7f9,color:#334155,stroke:#bac3ce,stroke-width:1.5px
+ classDef core fill:#eff6ff,color:#17365f,stroke:#93b4df,stroke-width:1.5px
+ classDef extension fill:#f0fdf4,color:#17543a,stroke:#91c8a7,stroke-width:1.5px
+ class BEFORE,AFTER entry
+ class CMD,BASE,MODEL,UNDO core
+ class EXT extension
```
-자세한 내용은 [Installation & Basic Usage guide](https://docs.univer.ai/guides/sheets/getting-started/installation), [`createUniver` reference](https://docs.univer.ai/reference/methods/create-univer), [Facade API reference](https://docs.univer.ai/reference/classes/univer)를 참고하세요.
+이 다이어그램은 행 삽입 흐름을 단순화한 것입니다. 중첩된 명령 실행에는 각각 콜백이 있으며, 모든 이벤트나 별도의 Operation 경로를 표시하지는 않습니다. [행 명령](../../packages/sheets/src/commands/commands/insert-row-col.command.ts), [필터 컨트롤러](../../packages/sheets-filter/src/controllers/sheets-filter.controller.ts), [인터셉터 서비스](../../packages/sheets/src/services/sheet-interceptor/sheet-interceptor.service.ts)를 확인하세요.
+
+</details>
+
+이러한 경계는 실용적인 테스트 전략을 지원합니다. 모델과 서비스를 독립적으로 테스트하고, DI로 외부 의존성을 교체하며, 조합된 동작과 실행 취소/다시 실행에 대한 회귀 테스트를 추가합니다. [필터 컨트롤러 테스트](../../packages/sheets-filter/src/controllers/__tests__/sheets-filter.controller.spec.ts)는 행과 열의 변경이 필터링에 미치는 영향을 검증합니다.
+
+<a id="connect-applications-and-agents-through-facade-apis-and-events"></a>
+
+### Facade API와 이벤트로 애플리케이션 및 에이전트 연결하기
+
+이 저장소는 편집기를 뒷받침하는 콘텐츠 모델, 수식 엔진, Canvas 렌더링 및 레이아웃 엔진을 포함합니다. 이들은 공유되는 기반 요소이며, 예를 들어 스프레드시트의 서식 있는 텍스트는 문서의 레이아웃과 렌더링을 재사용합니다. 맞춤 기능은 별도 콘텐츠 스택을 구현하지 않고 이러한 엔진을 기반으로 개발할 수 있습니다. [수식 엔진 아키텍처](https://docs.univer.ai/blog/formula)와 [렌더링 엔진 아키텍처](https://docs.univer.ai/blog/rendering)를 참고하세요.
+
+브라우저 편집기, Node.js Headless 작업, 적절히 구성한 Worker는 해당 콘텐츠 플러그인, 모델, 명령, 계산을 재사용할 수 있습니다. [Headless Univer](https://docs.univer.ai/guides/sheets/getting-started/node)와 [동형 아키텍처](../../docs/ISOMORPHIC.md)를 확인하세요.
+
+`ICommandService`는 실행 콜백을 공개해 플러그인이 명령 실행 전후를 관찰할 수 있게 합니다. Facade API는 기반 기능을 `FWorkbook`, `FWorksheet`, `FRange` 같은 애플리케이션 객체로 감쌉니다.
-## 🧩 Preset Mode vs Plugin Mode
+각 플러그인은 자체 Facade 확장, **`univerAPI.Event`를 통한 타입이 지정된 이벤트**, **`univerAPI.Enum`을 통한 열거형**을 제공합니다. 애플리케이션은 비공개 서비스를 가져오거나 문자열을 반복하지 않고 하나의 진입점에서 이벤트 이름과 상수를 찾을 수 있습니다. 예를 들어 `BeforeCommandExecute`는 실행을 검사하고 취소하며, `CommandExecuted`는 실행을 리스너에 알립니다. 리스너는 해제 가능한 객체를 반환하며, 취소는 해당 이벤트가 지원할 때만 적용됩니다.
-| 선택 | 사용 시점 | 시작하기 |
-| --- | --- | --- |
-| **Plugin Mode** | 패키지, 구성된 종속성, 지연 로딩, 런타임 구성을 엄격하게 제어해야 할 때. | 이 저장소의 [`examples/`](../../examples) 및 [architecture guide](https://docs.univer.ai/guides/recipes/architecture/univer) |
-| **Preset Mode** | 최소 설정으로 동작하는 Sheets, Docs, Node 구성이 필요할 때. | 이 저장소의 [`presets/`](../../presets) 및 [getting started guide](https://docs.univer.ai/guides/sheets/getting-started/installation) |
-| **Headless Mode** | UI 없이 서버 측 워크북/문서 처리, 수식 계산, 자동화가 필요할 때. | [Headless Univer](https://docs.univer.ai/guides/sheets/getting-started/node) |
+Facade 확장은 기능 패키지에 포함되므로 콘텐츠 API가 관련 없는 UI API를 불러올 필요가 없습니다. [Facade 설계](https://docs.univer.ai/blog/facade), [명령 콜백과 이벤트 브리지](../../packages/core/src/facade/f-univer.ts), [Enum 진입점](../../packages/core/src/facade/f-enum.ts)을 확인하세요.
-동일한 Univer 통합 릴리스 라인에 포함되는 `@univerjs/*` SDK 패키지는 같은 버전으로 맞추세요. `@univerjs/icons`, `@univerjs/icons-svg`처럼 독립적으로 릴리스되는 패키지는 SDK 버전이 아니라 각 패키지 매니페스트에 선언된 호환 버전을 사용합니다. Univer Pro 패키지를 사용한다면 `@univerjs-pro/*`도 해당 통합 릴리스 라인에 맞추세요.
+이 저장소는 실제 기능 구현과 확장 패턴을 제공합니다. 완전한 예제는 [필터 구현 해설](https://docs.univer.ai/blog/anatomy)을 참고하고, 확장 지점에 의존하기 전에는 [API 안정성 정책](../../docs/API_STABILITY.md)을 확인하세요.
-API 호환성 기대치, experimental APIs, internal APIs, deprecation rules는 [API Stability Policy](../API_STABILITY.md)를 참고하세요.
+<p align="right"><a href="#readme-top"><img src="https://img.shields.io/badge/%E2%86%91%20%EB%A7%A8%20%EC%9C%84%EB%A1%9C-30363D?style=flat-square" alt="맨 위로" height="20" /></a></p>
-## 🧭 호환성
+<a id="open-source-and-commercial-extensions"></a>
-- **브라우저 런타임**: Univer는 Chrome 88을 대상으로 컴파일되며 Edge `>=88`, Firefox `>=90`, Chrome `>=88`, Safari `>=14.1`, Electron `>=12`에서 잘 동작하도록 노력합니다.
-- **Polyfills**: Univer는 `Intl.Segmenter`에 의존합니다. 대상 브라우저나 런타임이 이를 제공하지 않는다면 `@formatjs/intl-segmenter` 같은 polyfill을 추가하세요.
-- **빌드 도구**: Vite, esbuild, Webpack 5를 권장합니다. 빌드 도구가 `package.json`의 `exports` 필드를 지원하지 않는 경우(Webpack 4에서 흔함) 추가 path mapping이 필요할 수 있습니다.
-- **React**: Univer의 view layer는 React 18 기반이며 React 18과 19를 지원합니다. React 16.9+ 및 17에는 최소한의 호환성 지원을 제공합니다.
-- **Node.js runtime**: Headless Univer는 Node.js `>=18.17.0`을 지원합니다. 이 monorepo를 개발하려면 Node.js `>=22.18`이 필요합니다.
+## 🧩 Univer Office SDK로 애플리케이션 확장하기
-## 🛠️ 만들 수 있는 것
+<p align="center"><img src="../../docs/img/readme/sdk-banner.png" alt="" width="960" /></p>
-| 영역 | 오픈소스 기능 | Univer Pro 확장 |
-| --- | --- | --- |
-| **Sheets** | 워크북, 워크시트, 범위, 선택, 수식, 숫자 서식, 필터링, 정렬, 데이터 유효성 검사, 조건부 서식, 하이퍼링크, 댓글, 찾기/바꾸기, 노트, 테이블, drawing integration, 확장 가능한 UI 플러그인. | 실시간 협업, 편집 기록, import/export, printing, charts, pivot tables, sparklines, outlines, shapes, in-cell graphics, data connectors, server-side calculation, 향상된 formula 기능. |
-| **Docs** | 리치 문서 모델, 편집 UI, 목록, 하이퍼링크, drawing integration, 댓글, quick insert, 공유 문서 아키텍처. | 협업, import/export, printing, 향상된 tables/lists, columns, callouts, code blocks, quotes, shapes, remote comment resources. |
-| **Slides** | — | Slide model/UI, slide import/export, chart/table model 및 UI plugins, 공유 shape editing infrastructure. |
-| **Bases** | Univer의 plugin, command, model 아키텍처 위에서 커스텀 structured-data 경험을 만들 수 있습니다. | Base database model, commands, formula integration, workbench UI, field editors, render-engine views. |
-| **Runtime** | 브라우저 앱, Node.js headless 사용, Web Worker/RPC 패턴, multi-instance 사용, 서버 지향 자동화. | Collaboration client/server packages, Node.js collaboration client, Pro server services, SSR, computing delegation, server-side calculation, changeset replay tooling. |
-| **Integrations** | React, Vue, Web Components, 프레임워크 템플릿, 테마, 로컬라이제이션, 커스텀 플러그인. | Pro presets, enterprise deployment packages. |
+바로 통합할 수 있는 기능이 더 필요하다면 해당 **Univer Office SDK** 모듈을 조합하세요. 추가 콘텐츠 유형, 고급 편집 플러그인, 협업, 파일 변환, 에이전트 도구를 사용할 수 있습니다. 이들은 위에서 설명한 같은 콘텐츠 모델, 플러그인 아키텍처, 명령 시스템, Facade 설계를 확장하므로 기존 통합을 바탕으로 개발할 수 있습니다.
-Sheets, Docs, Slides는 Univer의 공통 아키텍처를 기반으로 스프레드시트, 문서, 프레젠테이션 편집 기능을 제공하며, 일관된 플러그인 시스템, 명령 시스템, Facade API를 사용합니다.
+<div align="center" style="overflow-x: auto;">
-## 🔓 Open Source와 Pro
+<table align="center" style="display: table; width: auto; margin-left: auto; margin-right: auto;">
+<thead>
+<tr>
+<th>구성 요소</th>
+<th>기반을 확장하는 방법</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td><strong>오픈 소스 Web SDK 코어 · 이 저장소</strong></td>
+<td>오픈 소스 모델, 엔진, 플러그인, UI 기반, Sheets와 Docs 기능 및 해당 Headless 콘텐츠 작업. Apache-2.0에 따라 상용 애플리케이션에서 사용할 수 있습니다.</td>
+</tr>
+<tr>
+<td><strong>상용 Web SDK 플러그인</strong></td>
+<td>코어의 Plugin, 의존성 주입, Command/Mutation, Facade 확장 패턴을 따릅니다. 해당 콘텐츠 유형에 차트, 도형, 피벗 테이블, SmartArt 등의 기능을 추가합니다.</td>
+</tr>
+<tr>
+<td><strong>Server SDK</strong></td>
+<td>같은 콘텐츠 모델과 Mutation 규약을 실시간 협업, 버전 이력, 오피스 파일 변환으로 확장합니다. 애플리케이션의 신원, 권한, 저장소와 통합합니다.</td>
+</tr>
+<tr>
+<td><strong>AI SDK 확장</strong></td>
+<td>Web SDK의 Headless 및 Facade 기능을 재사용해 에이전트가 콘텐츠를 살펴보고 편집하고 검사할 수 있는 조합 가능한 Node.js API와 CLI 기반 요소를 제공합니다. 협업과 Worktree 검토도 통합합니다.</td>
+</tr>
+</tbody>
+</table>
+
+</div>
-이 저장소에는 Univer의 오픈소스 코어와 first-party OSS 플러그인이 포함되어 있습니다. Univer Pro는 고급 product surfaces, collaboration, server features, enterprise integrations를 위한 commercial extension layer로 별도 개발됩니다.
+<a id="scope-and-licensing"></a>
-| 카테고리 | Open source | Univer Pro / commercial |
-| --- | --- | --- |
-| **Foundation** | Core SDK, 플러그인 시스템, 렌더링 엔진, 수식 엔진, Facade API, 테마, i18n, framework adapters. | Pro presets, enterprise deployment packages. |
-| **Sheets** | 핵심 스프레드시트 편집, 수식, 숫자 서식, filter/sort, 데이터 유효성 검사, 조건부 서식, 노트, 테이블, 하이퍼링크, 댓글, drawing, 찾기/바꾸기. | 협업, 편집 기록, import/export, print, charts, pivot tables, sparklines, outlines, shapes, in-cell graphics, data connectors, range preprocessing, 향상된 formula engine 기능. |
-| **Docs** | 문서 모델과 편집 UI, 목록, 하이퍼링크, 댓글, quick insert, drawing integration. | 협업, import/export, print, 향상된 tables/lists, columns, callouts, code blocks, quotes, shapes, remote thread-comment resources. |
-| **Slides** | — | Slide model/UI packages, slide import/export, charts, tables, reusable shape editor UI. |
-| **Bases** | 커스텀 data-centric products를 위한 확장 가능한 plugin architecture. | Base database core model, commands, mutations, formula integration, workbench UI, field editors, render-engine integration. |
-| **Server and runtime** | Node.js headless runtime, RPC/Web Worker patterns, server-oriented automation primitives. | Collaboration server, Node.js collaboration client, SSR services, computing delegation, server-side calculation, collaboration changeset replay tooling. |
+### 범위와 라이선스
-편집기 기능은 [Web SDK 문서](https://docs.univer.ai/guides/sheets)를 참고하세요. 백엔드 통합은 Server SDK의 [공동 편집](https://docs.univer.ai/server/collaboration/overview) 및 [파일 가져오기·내보내기](https://docs.univer.ai/server/import-export) 문서를 참고하세요.
+- **이 저장소:** Apache-2.0 패키지는 해당 라이선스에 따라 상용 애플리케이션에서 사용할 수 있습니다. 오픈 소스 Headless 콘텐츠 기능도 포함됩니다.
+- **상용 확장:** 상용 Web SDK 플러그인, Server SDK, 오픈 소스 기반을 넘어서는 AI SDK 기능은 별도로 배포되고 라이선스가 부여됩니다. **Freemium** 평가에는 워터마크와 기능 제한이 있습니다.
+- **참조 애플리케이션:** Univer Workspace 같은 오픈 소스 애플리케이션에는 자체 소스 라이선스가 있습니다. SDK 의존성에는 각 SDK의 라이선스가 계속 적용됩니다.
-상용 라이선스 및 구매에 관해서는 [문의해 주세요](https://univer.ai/#contact). 애플리케이션에서 라이선스를 설정하려면 [라이선스 설정](https://docs.univer.ai/server/license)을 참고하세요.
+상세 범위는 **Open source only** 필터가 있는 [기능 비교](https://univer.ai/compare/)에서, 상용 옵션은 [요금제와 라이선스](https://univer.ai/pricing/)에서 확인하세요.
-Boundary principles:
+<details>
+<summary>공유 콘텐츠 모델이 편집, 협업, 파일을 연결하는 방법</summary>
-- 이 저장소의 OSS 패키지는 Apache-2.0 license 아래에서 독립적으로 유용하게 사용할 수 있도록 의도되었습니다. Univer Pro는 선택 사항이며, 공개 OSS SDK API를 사용하는 데 필요하지 않습니다.
-- OSS 패키지의 bugs, regressions, security issues는 관련 Pro 기능이 있더라도 OSS 저장소에서 보고하고 수정해야 합니다.
-- OSS documentation은 Pro-only capabilities가 공개 `@univerjs/*` packages에 포함된 것처럼 암시해서는 안 됩니다. Pro-only APIs, packages, deployment paths는 명확히 이름을 표시해야 합니다.
-- OSS feature에 Pro enhancement가 있더라도 OSS behavior는 독립적으로 문서화되어야 하며, 사용자가 commercial docs를 먼저 읽지 않고도 open-source surface를 평가할 수 있어야 합니다.
+이 기능들은 직렬화 가능한 **Unit 스냅샷**을 조작합니다. Sheets의 `IWorkbookData`, Docs의 `IDocumentData`, Slides의 `ISlideData`, 캔버스의 `IBoardData`(API에서는 **Boards**) 등이 있습니다. 이 타입들은 core와 각 제품 패키지에서 제공되며, 현재 Slides와 Boards 기능은 별도로 배포되는 상용 제품입니다. 공유 Unit 규약을 통해 브라우저 편집기, 백엔드 서비스, 에이전트가 같은 콘텐츠를 다룰 수 있습니다.
-## 🌐 생태계
+Command는 편집을 조율하고 **Mutation은 콘텐츠 변경을 설명합니다**. 협업은 Mutation을 **changeset(변경 집합)**으로 묶고, 동시 변경에 **운영 변환(OT)**을 적용하며, 확정된 리비전과 스냅샷을 관리합니다. 이력 기능은 스냅샷과 이후 변경 집합으로 특정 리비전을 복원할 수 있습니다. [협업 설계](https://docs.univer.ai/blog/ot)와 [Collaboration SDK 개요](https://docs.univer.ai/server/collaboration/overview)를 확인하세요.
+
+**Exchange**는 오피스 파일 구조와 Univer 콘텐츠 스냅샷을 상호 변환합니다. **XLSX, DOCX, PPTX** 같은 OOXML 형식에서는 파일을 해당 Sheet, Doc, Slide 데이터로 파싱하고, 내보낼 때 파일 표현을 생성합니다. 변환된 콘텐츠는 같은 편집, 계산, 협업, 에이전트 워크플로에 참여할 수 있습니다. [오피스 파일 가져오기와 내보내기](https://docs.univer.ai/server/import-export/node)를 확인하세요.
+
+</details>
-- **Core SDK**: [`dream-num/univer`](https://github.com/dream-num/univer), 이 monorepo입니다.
-- **Presets**: 이 저장소의 [`presets/`](../../presets), 브라우저와 Node.js 앱을 위한 curated plugin collection입니다.
-- **AI agent skills**: [`dream-num/univer-sdk-skills`](https://github.com/dream-num/univer-sdk-skills), Univer 통합, Pro 기능, 플러그인 개발, Node 백엔드를 다루는 AI agent용 재사용 지침입니다. [AI Skills guide](https://docs.univer.ai/guides/skills)를 참고하세요.
-- **Documentation**: [docs.univer.ai](https://docs.univer.ai), Web SDK, Server SDK, AI SDK 가이드와 API 레퍼런스를 포함합니다.
-- **Web SDK**: 브라우저와 Node.js에서 [임베드 가능한 편집기 및 헤드리스 처리](https://docs.univer.ai/guides/sheets)를 제공합니다.
-- **Server SDK**: [협업 및 파일 변환](https://docs.univer.ai/server)을 애플리케이션의 저장소, 인증, 권한 시스템과 통합합니다.
-- **AI SDK**: 오피스 콘텐츠를 검사, 편집, 검증하는 [에이전트 워크플로](https://docs.univer.ai/ai)를 구축합니다.
-- **API Reference**: [docs.univer.ai/reference](https://docs.univer.ai/reference/classes/univer), Facade API와 생성된 API reference입니다.
-- **Examples and showcase**: [Univer Showcase](https://docs.univer.ai/showcase)와 이 저장소의 [`examples/`](../../examples).
-- **AI-native spreadsheets**: [`dream-num/univer-mcp`](https://github.com/dream-num/univer-mcp), 자연어로 Univer Sheets를 제어하기 위한 Univer Platform / MCP 통합입니다.
+<details>
+<summary>AI SDK가 에이전트에 같은 콘텐츠 기능을 제공하는 방법</summary>
+
+AI SDK는 Web SDK의 **Headless 콘텐츠 모델, 명령, 계산, Facade API**를 기반으로 합니다. 구조화된 TypeScript API와 선택적인 Commander 프리셋을 공개해 애플리케이션에서 자체 Office CLI나 에이전트 도구를 구성할 수 있게 합니다.
+
+- **이해, 발견, 편집.** 검사는 구조화된 콘텐츠를 반환합니다. API Reference는 에이전트가 SDK에 포함된 Facade 심볼과 시그니처를 찾도록 돕습니다. Facade 실행은 읽기와 쓰기 모드를 구분하고, Mutation을 수집하며, 명시적인 동기화와 커밋 결과를 다룹니다. [콘텐츠 작업](https://docs.univer.ai/ai/content-operations)을 참고하세요.
+- **렌더링 결과 확인.** 브라우저 Render Runtime은 Web SDK 렌더링을 재사용해 스크린샷을 만듭니다. 슬라이드 레이아웃 검사는 페이지를 벗어나거나 겹치는 텍스트 등의 문제를 구조화해 반환하여 에이전트가 다음 편집에 사용할 근거를 제공합니다. [시각적 검사](https://docs.univer.ai/ai/visual-inspection)를 참고하세요.
+- **사람이 검토할 초안 편집.** 해당 협업 및 Web 기능을 사용하면 에이전트는 격리된 Worktree 초안을 여러 차례 편집하고 검증한 후 사람에게 검토, 병합, 재개를 맡길 수 있습니다. 이 흐름은 같은 스냅샷, Mutation, 리비전 규약을 사용합니다. [Worktree](https://docs.univer.ai/ai/worktree)를 확인하세요.
+
+반복 호출 시 선택적인 [Worker 풀과 데몬](https://docs.univer.ai/ai/runtime-architecture)이 로드된 콘텐츠 인스턴스를 재사용해 반복 초기화를 줄입니다. 루트 CLI, 대상, 권한 부여, 출력은 애플리케이션이 담당합니다. [AI SDK 패키지 목록](https://docs.univer.ai/ai/packages)에서 필요한 기능을 선택하세요.
+
+</details>
-## 📦 저장소 안내
+<p align="right"><a href="#readme-top"><img src="https://img.shields.io/badge/%E2%86%91%20%EB%A7%A8%20%EC%9C%84%EB%A1%9C-30363D?style=flat-square" alt="맨 위로" height="20" /></a></p>
+
+<a id="application-patterns-and-ecosystem"></a>
+
+## 🌐 애플리케이션 패턴과 생태계
+
+<p align="center"><img src="../../docs/img/readme/ecosystem-banner.png" alt="" width="960" /></p>
+
+<a id="univer-workspace-an-office-sdk-reference-application"></a>
+
+### Univer Workspace: Office SDK 참조 애플리케이션
+
+완전한 애플리케이션 예제는 [Univer Workspace](https://github.com/dream-num/univer-workspace)에서 시작하세요. Univer Office SDK 편집기, 협업, 파일 기능, 기존 에이전트, 사람의 검토를 자체 호스팅 가능한 워크스페이스로 조합하는 방법을 보여 줍니다. 자체 오피스 애플리케이션이나 에이전트 워크스페이스를 구축할 때 이 통합 패턴을 참고하세요.
+
+<div align="center" style="overflow-x: auto;">
+
+<table align="center" style="display: table; width: auto; margin-left: auto; margin-right: auto;">
+ <tr>
+ <td width="50%" valign="top">
+ <a href="https://space.univer.ai/"><img src="../../docs/img/readme/workspace.webp" alt="Univer Workspace의 편집 가능한 예산 스프레드시트" width="420" /></a>
+ </td>
+ <td width="50%" valign="top">
+ <a href="https://univer.ai/demo/web-app"><img src="../../docs/img/readme/web-app.webp" alt="가정값 컨트롤과 연결된 편집 가능한 스프레드시트가 나란히 있는 Web App" width="420" /></a>
+ </td>
+ </tr>
+ <tr>
+ <td width="50%" valign="top">
+ <strong>에이전트와 편집 가능한 오피스 콘텐츠</strong><br />
+ 대화, 스프레드시트 편집, 오피스 콘텐츠를 하나의 워크스페이스에 모읍니다.<br />
+ <a href="https://space.univer.ai/">Workspace 체험</a> · <a href="https://github.com/dream-num/univer-workspace">Workspace 소스 및 설정</a>
+ </td>
+ <td width="50%" valign="top">
+ <strong>Web App × Sheet · 실험적 기능</strong><br />
+ 컨트롤을 셀에 연결합니다. 앱이 시트에 쓰고 시트의 변경이 앱을 갱신합니다.<br />
+ <a href="https://univer.ai/demo/web-app">시트 기반 앱 데모 체험</a>
+ </td>
+ </tr>
+</table>
+
+</div>
+
+Workspace는 오픈 소스이며 SDK 의존성은 각 라이선스를 따릅니다. 연결된 앱과 검토 흐름은 [Workspace 개요](https://univer.ai/workspace/)를 확인하세요.
+
+<p align="center"><a href="https://www.youtube.com/watch?v=1p-SMEiK6Kg"><img src="../../docs/img/readme/integration-demo.png" alt="SDK 통합 데모 보기" width="720" /></a></p>
+
+[SDK 통합 데모 보기](https://www.youtube.com/watch?v=1p-SMEiK6Kg)
+
+<a id="cli-agent-integrations-and-developer-skills"></a>
+
+### CLI, 에이전트 통합, 개발 스킬
+
+같은 SDK 기능을 이미 사용하는 에이전트와 도구에도 조합할 수 있습니다.
+
+<div align="center" style="overflow-x: auto;">
+
+<table align="center" style="display: table; width: auto; margin-left: auto; margin-right: auto;">
+<thead>
+<tr>
+<th>프로젝트</th>
+<th>제공하는 기능</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td><a href="https://github.com/dream-num/univer-cli">Univer CLI</a></td>
+<td>오피스 콘텐츠를 만들고 편집하고 검사하고 전달하는 로컬 명령줄 워크스페이스.</td>
+</tr>
+<tr>
+<td><a href="https://github.com/dream-num/dsh-univer-office">Univer Office for DeepSeek Harness</a></td>
+<td>연결된 콘텐츠, 결과 검증, 버전별 변경, 격리된 Worktree 협업.</td>
+</tr>
+<tr>
+<td><a href="https://github.com/dream-num/workbuddy-univer-office">Univer Office for WorkBuddy</a></td>
+<td>로컬 Office 통합, MCP 미리 보기, 초안 검토. 개발자 프리뷰.</td>
+</tr>
+<tr>
+<td><a href="https://github.com/dream-num/openclaw-univer-office">Univer Office for OpenClaw</a></td>
+<td>오피스 콘텐츠를 만들고 검토하고 전달하는 도구.</td>
+</tr>
+<tr>
+<td><a href="https://github.com/dream-num/univer-sdk-skills">Univer SDK Skills</a></td>
+<td>코딩 에이전트가 SDK를 통합하고 플러그인을 개발하며 백엔드 워크플로를 구현하도록 돕는 지침.</td>
+</tr>
+</tbody>
+</table>
+
+</div>
+
+각 저장소에 설정과 SDK 의존성이 설명되어 있습니다. 에이전트 진입점은 [생태계](https://univer.ai/ecosystem/)에서 확인하고, 자체 통합을 만들려면 [문서](https://docs.univer.ai/)를 참고하세요.
+
+<p align="right"><a href="#readme-top"><img src="https://img.shields.io/badge/%E2%86%91%20%EB%A7%A8%20%EC%9C%84%EB%A1%9C-30363D?style=flat-square" alt="맨 위로" height="20" /></a></p>
+
+<a id="documentation-and-contributing"></a>
+
+## 📚 문서와 기여
+
+Univer를 만들고 개선하는 모든 [기여자](https://github.com/dream-num/univer/graphs/contributors)에게 감사드립니다. 엔진, 플러그인, 테스트, 문서, 예제에 대한 기여를 환영합니다.
+
+<p align="center"><a href="https://docs.univer.ai/guides/sheets">🧩 Web SDK</a> · <a href="https://docs.univer.ai/server">🖥️ Server SDK</a> · <a href="https://docs.univer.ai/ai">🤖 AI SDK</a> · <a href="https://docs.univer.ai/reference/classes/univer">🔧 API 참조</a> · <a href="https://office.univer.ai/">🎮 라이브 데모</a></p>
+
+<div align="center" style="overflow-x: auto;">
+
+<table align="center" style="display: table; width: auto; margin-left: auto; margin-right: auto;">
+ <tr>
+ <th align="center"><img src="https://cdnjs.cloudflare.com/ajax/libs/browser-logos/75.0.1/edge/edge_64x64.png" width="32" height="32" alt="" /><br />Edge</th>
+ <th align="center"><img src="https://cdnjs.cloudflare.com/ajax/libs/browser-logos/75.0.1/firefox/firefox_64x64.png" width="32" height="32" alt="" /><br />Firefox</th>
+ <th align="center"><img src="https://cdnjs.cloudflare.com/ajax/libs/browser-logos/75.0.1/chrome/chrome_64x64.png" width="32" height="32" alt="" /><br />Chrome</th>
+ <th align="center"><img src="https://cdnjs.cloudflare.com/ajax/libs/browser-logos/75.0.1/safari/safari_64x64.png" width="32" height="32" alt="" /><br />Safari</th>
+ <th align="center"><img src="https://cdnjs.cloudflare.com/ajax/libs/browser-logos/75.0.1/electron/electron_64x64.png" width="32" height="32" alt="" /><br />Electron</th>
+ </tr>
+ <tr>
+ <td align="center"><code>&gt;=88</code></td>
+ <td align="center"><code>&gt;=90</code></td>
+ <td align="center"><code>&gt;=88</code></td>
+ <td align="center"><code>&gt;=14.1</code></td>
+ <td align="center"><code>&gt;=12</code></td>
+ </tr>
+</table>
+
+</div>
+
+<p align="center">Univer는 Chrome 88을 대상으로 컴파일되며 위에 나열된 버전에서 동작하는 것을 목표로 합니다.</p>
+
+<a id="runtime-compatibility"></a>
+
+### 런타임 호환성
+
+- **폴리필**: Univer는 `Intl.Segmenter`에 의존합니다. 대상 브라우저나 런타임이 제공하지 않으면 `@formatjs/intl-segmenter` 같은 폴리필을 추가하세요.
+- **빌드 도구**: Vite, esbuild, Webpack 5를 권장합니다. 빌드 도구가 `package.json`의 `exports` 필드를 지원하지 않으면(Webpack 4에서 흔함) 추가 경로 매핑이 필요할 수 있습니다.
+- **React**: Univer의 뷰 계층은 React 18을 기반으로 하며 React 18과 19를 지원하고, React 16.9+ 및 17에는 최소한의 호환성 지원을 제공합니다.
+- **Node.js 런타임**: Headless Univer는 Node.js `>=18.17.0`을 지원합니다. 이 모노레포를 개발하려면 Node.js `>=22.18`이 필요합니다.
+
+<details>
+<summary>이 저장소에서 개발하기</summary>
+
+### 저장소 구조
```text
.
-├── packages/ Core packages, engines, document types, UI plugins, feature plugins
-├── examples/ 로컬 브라우저 개발을 위한 올인원 Vite workbench
-├── common/ 공유 내부 도구, storybook, utilities
-├── tests/ 추가 integration test projects
-└── docs/ architecture notes, images, repository-local documentation
+├── packages/ Core packages, engines, document types, UI plugins, and feature plugins
+├── examples/ All-in-one Vite workbench used for local browser development
+├── common/ Shared internal tooling, storybook, and utilities
+├── tests/ Additional integration test projects
+└── docs/ Architecture notes, images, and repository-local documentation
```
패키지별 README는 [`packages/`](../../packages)의 각 패키지 옆에 있습니다.
-## 🧑‍💻 개발
+### 로컬 개발
요구 사항:
- Node.js `>=22.18`
-- pnpm `>=11`
+- pnpm: `package.json`의 `packageManager`에 선언된 버전을 사용하세요.
```bash
git clone https://github.com/dream-num/univer.git
@@ -365,63 +806,107 @@ pnpm dev
유용한 명령:
-| 명령 | 목적 |
-| --- | --- |
-| `pnpm dev` | 저메모리 올인원 workbench를 빌드하고 HMR 없이 미리 봅니다. |
-| `pnpm dev:source` | HMR로 소스 workbench를 시작하며 콜드 스타트와 메모리 사용량이 더 큽니다. |
-| `pnpm build` | 내부 common 패키지를 제외하고 workspace 패키지를 빌드합니다. |
-| `pnpm test` | Turbo를 통해 unit tests를 실행합니다. |
-| `pnpm typecheck` | Turbo를 통해 TypeScript checks를 실행합니다. |
-| `pnpm lint` | ESLint를 실행합니다. |
-| `pnpm storybook:dev` | UI component 개발용 Storybook을 시작합니다. |
+<div align="center" style="overflow-x: auto;">
+
+<table align="center" style="display: table; width: auto; margin-left: auto; margin-right: auto;">
+<thead>
+<tr>
+<th>명령</th>
+<th>용도</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td><code class="notranslate">pnpm dev</code></td>
+<td>Sheets와 Docs 개발 워크벤치를 시작합니다.</td>
+</tr>
+<tr>
+<td><code class="notranslate">pnpm build</code></td>
+<td>내부 common 패키지를 제외한 워크스페이스 패키지를 빌드합니다.</td>
+</tr>
+<tr>
+<td><code class="notranslate">pnpm test</code></td>
+<td>Turbo로 단위 테스트를 실행합니다.</td>
+</tr>
+<tr>
+<td><code class="notranslate">pnpm typecheck</code></td>
+<td>Turbo로 TypeScript 검사를 실행합니다.</td>
+</tr>
+<tr>
+<td><code class="notranslate">pnpm lint</code></td>
+<td>ESLint를 실행합니다.</td>
+</tr>
+<tr>
+<td><code class="notranslate">pnpm storybook:dev</code></td>
+<td>UI 컴포넌트 개발용 Storybook을 시작합니다.</td>
+</tr>
+</tbody>
+</table>
+
+</div>
+
+Pull Request를 열기 전에 [CONTRIBUTING.md](../../CONTRIBUTING.md)를 읽어 주세요.
-Pull request를 열기 전에 [CONTRIBUTING.md](../../CONTRIBUTING.md)를 읽어 주세요.
+</details>
+
+<details>
+<summary>아키텍처 및 기여 참고 자료</summary>
-## 📝 Contributor Notes
+- [저장소 패키지](../../packages), [프리셋](../../presets), [예제](../../examples).
+- [동형 Univer 구축](../../docs/ISOMORPHIC.md).
+- [Facade API 기여](../../docs/CONTRIBUTING-FACADE.md).
+- [API 안정성 정책](../../docs/API_STABILITY.md).
+- [명명 규칙](../../docs/NAMING_CONVENTION.md)과 [메모리 누수 수정](../../docs/FIX_MEMORY_LEAK.md).
+- [아키텍처 TLDR](../../docs/tldr)과 [OLE 첨부 파일 안내](../../packages/drawing/docs/ole-attachments.md).
-더 깊은 변경을 하기 전에 읽어볼 만한 저장소 내부 문서입니다.
+</details>
+
+<p align="right"><a href="#readme-top"><img src="https://img.shields.io/badge/%E2%86%91%20%EB%A7%A8%20%EC%9C%84%EB%A1%9C-30363D?style=flat-square" alt="맨 위로" height="20" /></a></p>
-- [Building Isomorphic Univer](../ISOMORPHIC.md): 브라우저, Node.js, UI, 공유 플러그인 로직을 나누는 방법.
-- [API Stability Policy](../API_STABILITY.md): stable, experimental, internal, deprecated, breaking-change expectations.
-- [Contributing to Facade API](../CONTRIBUTING-FACADE.md): `FUniver`, `FWorkbook`, `FRange` 등 Facade API의 설계 기준.
-- [Naming Convention](../NAMING_CONVENTION.md): 파일, 폴더, 인터페이스, 플러그인, 명령, DI token naming 규칙.
-- [Fixing Memory Leaks](../FIX_MEMORY_LEAK.md): Univer 인스턴스의 흔한 memory leak 패턴과 디버깅 흐름.
-- [Architecture TLDRs](../tldr): formula engine, Web Worker, permission, selection, ref-range 동작에 대한 간단한 설계 메모.
+<a id="community"></a>
## 💬 커뮤니티
-- [GitHub Discussions](https://github.com/dream-num/univer/discussions)에서 질문할 수 있습니다.
-- [Discord](https://discord.gg/z3NKNT6D2f)에서 커뮤니티와 대화할 수 있습니다.
-- [Twitter / X](https://twitter.com/univerhq)와 [YouTube](https://www.youtube.com/@dreamNum)를 팔로우하세요.
+[GitHub Discussions](https://github.com/dream-num/univer/discussions)에서 질문하고, [Discord](https://discord.gg/z3NKNT6D2f)에 참여하고, [X](https://twitter.com/univerhq)나 [YouTube](https://www.youtube.com/@dreamNum)를 팔로우하세요. [행동 강령](../../CODE_OF_CONDUCT.md)을 읽어 주세요.
+
+<p align="right"><a href="#readme-top"><img src="https://img.shields.io/badge/%E2%86%91%20%EB%A7%A8%20%EC%9C%84%EB%A1%9C-30363D?style=flat-square" alt="맨 위로" height="20" /></a></p>
-참여하기 전에 [Code of Conduct](../../CODE_OF_CONDUCT.md)를 읽어 주세요.
+<a id="security"></a>
## 🔒 보안
보안 문제를 발견했다고 생각되면 [Security Policy](../../SECURITY.md)를 따라 주세요.
+<p align="right"><a href="#readme-top"><img src="https://img.shields.io/badge/%E2%86%91%20%EB%A7%A8%20%EC%9C%84%EB%A1%9C-30363D?style=flat-square" alt="맨 위로" height="20" /></a></p>
+
+<a id="sponsors"></a>
+
## ❤️ 스폰서
Univer는 커뮤니티와 스폰서의 지원을 받습니다. [Open Collective](https://opencollective.com/univer)를 통해 프로젝트를 지원할 수 있습니다.
-<a href="https://opencollective.com/univer/sponsor/0/website"><img src="https://opencollective.com/univer/sponsor/0/avatar.svg" alt="Sponsor 0" /></a>
-<a href="https://opencollective.com/univer/sponsor/1/website"><img src="https://opencollective.com/univer/sponsor/1/avatar.svg" alt="Sponsor 1" /></a>
-<a href="https://opencollective.com/univer/sponsor/2/website"><img src="https://opencollective.com/univer/sponsor/2/avatar.svg" alt="Sponsor 2" /></a>
-<a href="https://opencollective.com/univer/sponsor/3/website"><img src="https://opencollective.com/univer/sponsor/3/avatar.svg" alt="Sponsor 3" /></a>
-<a href="https://opencollective.com/univer/sponsor/4/website"><img src="https://opencollective.com/univer/sponsor/4/avatar.svg" alt="Sponsor 4" /></a>
-<a href="https://opencollective.com/univer/sponsor/5/website"><img src="https://opencollective.com/univer/sponsor/5/avatar.svg" alt="Sponsor 5" /></a>
-<a href="https://opencollective.com/univer/sponsor/6/website"><img src="https://opencollective.com/univer/sponsor/6/avatar.svg" alt="Sponsor 6" /></a>
-
-<a href="https://opencollective.com/univer/backer/0/website"><img src="https://opencollective.com/univer/backer/0/avatar.svg" alt="Backer 0" /></a>
-<a href="https://opencollective.com/univer/backer/1/website"><img src="https://opencollective.com/univer/backer/1/avatar.svg" alt="Backer 1" /></a>
-<a href="https://opencollective.com/univer/backer/2/website"><img src="https://opencollective.com/univer/backer/2/avatar.svg" alt="Backer 2" /></a>
-<a href="https://opencollective.com/univer/backer/3/website"><img src="https://opencollective.com/univer/backer/3/avatar.svg" alt="Backer 3" /></a>
-<a href="https://opencollective.com/univer/backer/4/website"><img src="https://opencollective.com/univer/backer/4/avatar.svg" alt="Backer 4" /></a>
-<a href="https://opencollective.com/univer/backer/5/website"><img src="https://opencollective.com/univer/backer/5/avatar.svg" alt="Backer 5" /></a>
-<a href="https://opencollective.com/univer/backer/6/website"><img src="https://opencollective.com/univer/backer/6/avatar.svg" alt="Backer 6" /></a>
+<p>
+ <a href="https://opencollective.com/univer/sponsor/0/website"><img src="https://opencollective.com/univer/sponsor/0/avatar.svg" alt="스폰서 되기" /></a>
+</p>
+
+<p>
+ <a href="https://opencollective.com/univer/backer/0/website"><img src="https://opencollective.com/univer/backer/0/avatar.svg" width="64" height="64" alt="Backer 0" /></a>
+ <a href="https://opencollective.com/univer/backer/1/website"><img src="https://opencollective.com/univer/backer/1/avatar.svg" width="64" height="64" alt="Backer 1" /></a>
+ <a href="https://opencollective.com/univer/backer/2/website"><img src="https://opencollective.com/univer/backer/2/avatar.svg" width="64" height="64" alt="Backer 2" /></a>
+ <a href="https://opencollective.com/univer/backer/3/website"><img src="https://opencollective.com/univer/backer/3/avatar.svg" width="64" height="64" alt="Backer 3" /></a>
+ <a href="https://opencollective.com/univer/backer/4/website"><img src="https://opencollective.com/univer/backer/4/avatar.svg" width="64" height="64" alt="Backer 4" /></a>
+ <a href="https://opencollective.com/univer/backer/5/website"><img src="https://opencollective.com/univer/backer/5/avatar.svg" width="64" height="64" alt="Backer 5" /></a>
+ <a href="https://opencollective.com/univer/backer/6/website"><img src="https://opencollective.com/univer/backer/6/avatar.svg" width="64" height="64" alt="Backer 6" /></a>
+</p>
+
+<p align="right"><a href="#readme-top"><img src="https://img.shields.io/badge/%E2%86%91%20%EB%A7%A8%20%EC%9C%84%EB%A1%9C-30363D?style=flat-square" alt="맨 위로" height="20" /></a></p>
+
+<a id="license"></a>
## 📄 라이선스
Copyright (c) 2021-present DreamNum Co., Ltd.
-[Apache-2.0](../../LICENSE) 라이선스로 배포됩니다.
+이 저장소의 오픈 소스 패키지는 [Apache-2.0](../../LICENSE) 라이선스로 제공됩니다. 상용 SDK 모듈은 별도로 배포되고 라이선스가 부여됩니다.
+
+<p align="right"><a href="#readme-top"><img src="https://img.shields.io/badge/%E2%86%91%20%EB%A7%A8%20%EC%9C%84%EB%A1%9C-30363D?style=flat-square" alt="맨 위로" height="20" /></a></p>
diff --git a/docs/readme/zh-CN.md b/docs/readme/zh-CN.md
index 609798786b..867e62aaa7 100644
--- a/docs/readme/zh-CN.md
+++ b/docs/readme/zh-CN.md
@@ -1,156 +1,296 @@
-<div align="center">
+<a id="readme-top"></a>
-<img src="../img/banner.png" alt="Univer SDK" width="800" />
+<p align="center"><img src="../../docs/img/readme/hero-banner.png" alt="Univer Office SDK" width="960" /></p>
-**面向 AI Agent 的 Office Harness**
+<h1 align="center">用 Univer Office SDK 构建你的 AI 办公产品</h1>
-电子表格 · 文档 · 演示文稿 · Bases · Boards · PDF
+<p align="center">从开源的 Sheets 和 Docs 开始,再连接你自己的应用或 Agent。</p>
-高性能、可完全定制的 Office SDK
+<p align="center"><a href="#quick-start">🚀 快速开始</a> · <a href="https://docs.univer.ai/">📚 开发文档</a> · <a href="https://univer.ai/compare/">⚖️ 功能对比</a> · <a href="https://univer.ai/">🌐 官网</a> · <a href="https://docs.univer.ai/showcase">🎮 示例</a> · <a href="https://docs.univer.ai/reference/classes/univer">🔧 API 参考</a> · <a href="https://docs.univer.ai/blog">📝 博客</a></p>
-Univer 以插件化架构、Canvas 渲染引擎、公式引擎和统一的 Facade API,
-帮助你在浏览器和 Node.js 中构建可嵌入的生产力体验。
+<p align="center"><a href="../../README.md">English</a> · <a href="../../docs/readme/fr-FR.md">Français</a> · <a href="../../docs/readme/de-DE.md">Deutsch</a> · <a href="../../docs/readme/es-ES.md">Español</a> · <strong>简体中文</strong> · <a href="../../docs/readme/zh-TW.md">繁體中文</a> · <a href="../../docs/readme/ja-JP.md">日本語</a> · <a href="../../docs/readme/ko-KR.md">한국어</a></p>
-[English](../../README.md) | 简体中文 | [繁體中文](./zh-TW.md) | [日本語](./ja-JP.md) | [한국어](./ko-KR.md) | [Español](./es-ES.md)
+<p align="center">
+ <a href="https://github.com/dream-num/univer/releases"><img src="https://img.shields.io/github/v/release/dream-num/univer?style=flat&amp;labelColor=30363D&amp;color=4F46E5&amp;logo=github&amp;logoColor=white" alt="Release" /></a>
+ <a href="../../LICENSE"><img src="https://img.shields.io/github/license/dream-num/univer?style=flat&amp;labelColor=30363D&amp;color=0F766E" alt="License" /></a>
+ <a href="https://github.com/dream-num/univer/actions/workflows/build-packages.yml"><img src="https://img.shields.io/github/actions/workflow/status/dream-num/univer/build-packages.yml?style=flat&amp;labelColor=30363D" alt="Build" /></a>
+ <a href="https://www.codefactor.io/repository/github/dream-num/univer/overview/dev"><img src="https://www.codefactor.io/repository/github/dream-num/univer/badge/dev?style=flat" alt="CodeFactor" /></a>
+ <a href="https://codecov.io/gh/dream-num/univer"><img src="https://img.shields.io/codecov/c/gh/dream-num/univer?token=aPfyW2pIMN&amp;style=flat&amp;labelColor=30363D" alt="Codecov" /></a>
+</p>
-[🌐 官网](https://univer.ai/) | [📖 文档](https://docs.univer.ai) | [✨ 示例](https://docs.univer.ai/showcase) | [📘 API 参考](https://docs.univer.ai/reference/classes/univer) | [📝 博客](https://docs.univer.ai/blog)
+<p align="center">
+ <a href="https://github.com/dream-num/univer"><img src="https://img.shields.io/github/stars/dream-num/univer?style=flat&amp;labelColor=30363D&amp;color=4F46E5" alt="Stars" /></a>
+ <a href="https://github.com/dream-num/univer/graphs/contributors"><img src="https://img.shields.io/github/contributors/dream-num/univer?style=flat&amp;labelColor=30363D&amp;color=4F46E5" alt="Contributors" /></a>
+ <a href="https://github.com/dream-num/univer/issues"><img src="https://img.shields.io/github/issues/dream-num/univer?style=flat&amp;labelColor=30363D&amp;color=4F46E5" alt="Issues" /></a>
+ <a href="https://github.com/dream-num/univer/commits/dev/"><img src="https://img.shields.io/github/last-commit/dream-num/univer?style=flat&amp;labelColor=30363D&amp;color=4F46E5" alt="Last Commit" /></a>
+</p>
-[![Release](https://img.shields.io/github/v/release/dream-num/univer?style=flat-square)](https://github.com/dream-num/univer/releases)
-[![License](https://img.shields.io/github/license/dream-num/univer?style=flat-square)](../../LICENSE)
-[![Build](https://img.shields.io/github/actions/workflow/status/dream-num/univer/build-packages.yml?style=flat-square)](https://github.com/dream-num/univer/actions/workflows/build-packages.yml)
-[![CodeFactor](https://www.codefactor.io/repository/github/dream-num/univer/badge/dev?style=flat-square)](https://www.codefactor.io/repository/github/dream-num/univer/overview/dev)
-[![Codecov](https://img.shields.io/codecov/c/gh/dream-num/univer?token=aPfyW2pIMN&style=flat-square)](https://codecov.io/gh/dream-num/univer)
+<p align="center">
+ <a href="https://discord.gg/z3NKNT6D2f"><img src="https://img.shields.io/discord/1136129819961217077?logo=discord&amp;logoColor=FFFFFF&amp;label=discord&amp;color=5865F2&amp;style=flat&amp;labelColor=30363D" alt="Discord" /></a>
+ <a href="https://twitter.com/univerhq"><img src="https://img.shields.io/badge/%40univerhq-18181B?style=flat&amp;logo=x&amp;logoColor=white" alt="X: @univerhq" /></a>
+ <a href="https://opencollective.com/univer"><img src="https://img.shields.io/opencollective/all/univer?logo=opencollective&amp;style=flat&amp;labelColor=30363D&amp;color=0F766E&amp;label=supporters&amp;logoColor=white" alt="Open Collective" /></a>
+</p>
-[![Stars](https://img.shields.io/github/stars/dream-num/univer?style=flat-square)](https://github.com/dream-num/univer/stargazers)
-[![Contributors](https://img.shields.io/github/contributors/dream-num/univer?style=flat-square)](https://github.com/dream-num/univer/graphs/contributors)
-[![Issues](https://img.shields.io/github/issues/dream-num/univer?style=flat-square)](https://github.com/dream-num/univer/issues)
-[![Last Commit](https://img.shields.io/github/last-commit/dream-num/univer?style=flat-square)](https://github.com/dream-num/univer/commits/dev/)
+<p align="center">
+ <a href="https://trendshift.io/repositories/4376"><img src="https://trendshift.io/api/badge/repositories/4376" alt="Trendshift" /></a>
+</p>
-[![Discord](https://img.shields.io/discord/1136129819961217077?logo=discord&logoColor=FFFFFF&label=discord&color=5865F2&style=flat-square)](https://discord.gg/z3NKNT6D2f)
-[![Twitter](https://img.shields.io/twitter/follow/univerhq?style=flat-square&logo=x)](https://twitter.com/univerhq)
-[![Open Collective](https://img.shields.io/opencollective/all/univer?logo=opencollective&style=flat-square)](https://opencollective.com/univer)
+<details>
+<summary>目录</summary>
+
+- [💡 Univer 是什么?](#what-is-univer)
+ - [开源能力](#open-source-capabilities)
+- [🚀 基于开源基础构建](#what-you-can-build)
+ - [快速开始:开源电子表格编辑器](#quick-start)
+ - [将应用连接到可编辑内容](#connect-your-application-to-editable-content)
+- [🏗️ 探索开源架构](#open-source-architecture)
+ - [为自定义功能划分清晰边界](#give-custom-features-clear-boundaries)
+ - [组合跨功能编辑与撤销/重做](#compose-cross-feature-edits-and-undoredo)
+ - [通过 Facade API 和事件连接应用与 Agent](#connect-applications-and-agents-through-facade-apis-and-events)
+- [🧩 使用 Univer Office SDK 扩展应用](#open-source-and-commercial-extensions)
+ - [范围与授权](#scope-and-licensing)
+- [🌐 应用模式与生态](#application-patterns-and-ecosystem)
+ - [Univer Workspace:Office SDK 参考应用](#univer-workspace-an-office-sdk-reference-application)
+ - [CLI、Agent 集成与开发技能](#cli-agent-integrations-and-developer-skills)
+- [📚 文档与贡献](#documentation-and-contributing)
+ - [运行环境兼容性](#runtime-compatibility)
+- [💬 社区](#community)
+- [🔒 安全](#security)
+- [❤️ 赞助](#sponsors)
+- [📄 许可证](#license)
+
+</details>
+
+<a id="what-is-univer"></a>
+
+## 💡 Univer 是什么?
+
+<p align="center"><img src="../../docs/img/readme/intro-banner.png" alt="Univer Office SDK: Web, Server, and AI SDKs" width="960" /></p>
+
+**Univer** 是一套 Office SDK,用于在你自己的产品中构建办公应用。它基于你的数据和权限,为用户和现有 Agent 提供办公编辑、计算、协作及文件处理能力。产品系列覆盖电子表格、文档、演示文稿、关联表格、画布和 PDF。
+
+Univer Office SDK 由三部分组成:
+
+- **Web SDK** 是基础,包含内容模型、编辑、渲染、公式计算和 Facade API(面向应用的 API)。通过组合插件,可以构建嵌入式编辑器或自己的办公应用,也可以在没有交互式编辑器的情况下,复用内容模型、命令和计算能力进行 Headless 处理。
+- **Server SDK** 提供实时协作、编辑历史和办公文件导入导出的后端服务。
+- **AI SDK** 通过内容工具、执行和审阅集成,将办公能力连接到现有 Agent 和工作流程。
+
+**本仓库以 Apache-2.0 许可证提供 Web SDK 的核心架构和引擎实现**,包括内容模型与快照格式、插件与依赖管理、命令系统、公式与渲染引擎、Facade API、UI 基础设施,以及 Sheets 和 Docs 编辑能力。商业 Web SDK 插件、Server SDK 和商业 AI SDK 扩展单独分发和授权。
+
+Agent 可以使用同样的开源 API,模型和工具编排由你的应用提供。[报价单示例](#connect-your-application-to-editable-content)展示了不依赖 AI SDK 的编辑、计算和保存流程。
+
+<a id="open-source-capabilities"></a>
+
+### 开源能力
-[![Trendshift](https://trendshift.io/api/badge/repositories/4376)](https://trendshift.io/repositories/4376)
+<div align="center" style="overflow-x: auto;">
+
+<table align="center" style="display: table; width: auto; margin-left: auto; margin-right: auto;">
+<thead>
+<tr>
+<th>领域</th>
+<th>部分能力</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td><strong>Sheets · 编辑与布局</strong></td>
+<td>单元格样式、合并单元格、单元格内富文本、冻结窗格、浮动图片,以及撤销/重做。</td>
+</tr>
+<tr>
+<td><strong>Sheets · 数据与计算</strong></td>
+<td>公式、定义名称、筛选、排序、数据验证、条件格式、超链接、评论,以及查找替换。</td>
+</tr>
+<tr>
+<td><strong>Docs</strong></td>
+<td>富文本编辑、段落格式、列表、超链接、评论和绘图集成。</td>
+</tr>
+</tbody>
+</table>
</div>
-## ✨ Univer 是什么?
+功能通过插件和预设组合;[快速开始](#quick-start)仅使用 **Sheets Core 预设**。图片需要相应的绘图插件。详细的开源和商业能力范围请参阅[功能对比](https://univer.ai/compare/)。
+
+以下演示展示更完整的 **Univer Office SDK**,包括商业能力,其范围超出默认开源配置;具体请参阅[开源与商业扩展](#open-source-and-commercial-extensions)。
+
+<div align="center" style="overflow-x: auto;">
+
+<table align="center" style="display: table; width: auto; margin-left: auto; margin-right: auto;">
+<tbody>
+<tr>
+ <td width="50%"><a href="https://univer.ai/demo/spreadsheets"><img src="../../docs/img/readme/cards/sheets.webp" alt="Sheets — 编辑与布局 · 数据与计算 — 打开演示" width="420" /></a></td>
+ <td width="50%"><a href="https://univer.ai/demo/docs"><img src="../../docs/img/readme/cards/docs.webp" alt="Docs — 富文本编辑 — 打开演示" width="420" /></a></td>
+</tr>
+<tr>
+ <td width="50%"><a href="https://univer.ai/demo/web-app"><img src="../../docs/img/readme/cards/web-app.webp" alt="Web App — 由表格驱动的应用 — 打开演示" width="420" /></a></td>
+ <td width="50%"><a href="https://univer.ai/demo/universe"><img src="../../docs/img/readme/cards/universe.webp" alt="Univer — 组合式办公内容 — 打开演示" width="420" /></a></td>
+</tr>
+<tr>
+ <td width="50%"><a href="https://univer.ai/demo/slides"><img src="../../docs/img/readme/cards/slides.webp" alt="Slides — 打开演示" width="420" /></a></td>
+ <td width="50%"><a href="https://univer.ai/demo/relational-tables"><img src="../../docs/img/readme/cards/relational-tables.webp" alt="Relational Tables — 打开演示" width="420" /></a></td>
+</tr>
+<tr>
+ <td width="50%"><a href="https://univer.ai/demo/canvases"><img src="../../docs/img/readme/cards/canvases.webp" alt="Canvases — 打开演示" width="420" /></a></td>
+ <td width="50%"><a href="https://univer.ai/demo/pdf"><img src="../../docs/img/readme/cards/pdf.webp" alt="PDF — 打开演示" width="420" /></a></td>
+</tr>
+</tbody>
+</table>
-Univer 是一个开源 SDK,用于在你的产品中创建办公应用。它提供电子表格、文档和演示文稿体验所需的基础能力,同时不强制你使用托管应用或固定 UI。
+</div>
-当你需要以下能力时,可以使用 Univer:
+<p align="right"><a href="#readme-top"><img src="https://img.shields.io/badge/%E2%86%91%20%E8%BF%94%E5%9B%9E%E9%A1%B6%E9%83%A8-30363D?style=flat-square" alt="返回顶部" height="20" /></a></p>
+
+<a id="what-you-can-build"></a>
+
+## 🚀 基于开源基础构建
+
+<p align="center"><img src="../../docs/img/readme/build-banner.png" alt="Build on open source" width="960" /></p>
+
+<div align="center" style="overflow-x: auto;">
+
+<table align="center" style="display: table; width: auto; margin-left: auto; margin-right: auto;">
+<thead>
+<tr>
+<th>你的目标</th>
+<th>使用开源基础</th>
+<th>从这里开始</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td><strong>嵌入 Sheets 或 Docs</strong></td>
+<td>为应用或 Agent 产品添加可编辑的办公界面,并通过 Facade API 连接数据。</td>
+<td><a href="#quick-start">快速开始</a></td>
+</tr>
+<tr>
+<td><strong>在没有编辑器的情况下处理内容</strong></td>
+<td>在 Node.js 中复用内容插件、模型、命令和计算能力,用于编辑、快照和自动化任务。</td>
+<td><a href="https://docs.univer.ai/guides/sheets/getting-started/node">Headless 指南</a></td>
+</tr>
+<tr>
+<td><strong>开发自定义功能或编辑器</strong></td>
+<td>复用引擎、UI 组件、插件边界、依赖注入及命令/撤销系统。参考现有功能扩展 Sheets 和 Docs,或开发自己的编辑器。</td>
+<td><a href="#open-source-architecture">开源架构</a></td>
+</tr>
+</tbody>
+</table>
-- 将电子表格或文档编辑能力嵌入 SaaS 产品、内部工具、BI 流程或 AI 应用。
-- 在服务端运行工作簿/文档处理逻辑,并与浏览器端使用同一套架构。
-- 通过插件按需组合功能,或通过预设快速启动。
-- 通过自定义插件、命令、服务、UI 组件和 Facade API 扩展行为。
+</div>
-Univer 不只是一个电子表格文件查看器。它是用于构建你自己的生产力界面的框架。
+**协调跨功能的编辑与撤销/重做。** 在筛选范围内插入一行,会同时改变基础内容和筛选范围,撤销时也需要同时恢复两者。各功能提供自己的变更和撤销数据,由命令组合执行并记录历史。架构介绍会说明如何扩展这些编辑流程。
-在 [Univer 产品家族](https://univer.ai/)中,办公工具共享存储与计算运行时。不同工具的内容可以自由组合和嵌入,关联数据与引用随来源同步更新,人与 AI Agent 可以在同一文件中协作。产品能力请参阅[能力矩阵](https://univer.ai/capabilities),本仓库的范围请参阅[开源与 Pro](#-开源与-pro)。
+<a id="quick-start"></a>
-### 使用 Univer Office SDK 构建协作工具
+### 快速开始:开源电子表格编辑器
-[![使用 Univer Office SDK 构建协作工具](https://i.ytimg.com/vi/1p-SMEiK6Kg/maxresdefault.jpg)](https://www.youtube.com/watch?v=1p-SMEiK6Kg)
+在使用 Vite 等构建工具的浏览器应用中:
-[观看演示](https://www.youtube.com/watch?v=1p-SMEiK6Kg)
+```bash
+pnpm add @univerjs/presets @univerjs/preset-sheets-core
+```
-## 基于 Univer Office SDK 构建
+初始化 Univer 前,先创建容器:
-### 重点案例:Univer Workspace
+```html
+<div id="app" style="height: 100vh"></div>
+```
-[Univer Workspace](https://github.com/dream-num/univer-workspace) 是基于 Univer Office SDK 构建、支持自行部署的开源工作空间,人与 AI Agent 可以在其中创建、协作处理和审阅办公内容。开发者可以参考完整实现,学习如何集成 SDK,并构建自己的产品。
+```ts
+import { UniverSheetsCorePreset } from '@univerjs/preset-sheets-core'
+import UniverPresetSheetsCoreEnUS from '@univerjs/preset-sheets-core/locales/en-US'
+import { createUniver, LocaleType, mergeLocales } from '@univerjs/presets'
+import '@univerjs/preset-sheets-core/lib/index.css'
-[![Workspace Mini App 与其关联的电子表格并排显示,指标、图表和控件绑定到单元格](../img/workspace-mini-app.png)](https://github.com/dream-num/univer-workspace)
+const { univerAPI } = createUniver({
+ locale: LocaleType.EN_US,
+ locales: {
+ [LocaleType.EN_US]: mergeLocales(UniverPresetSheetsCoreEnUS),
+ },
+ presets: [
+ UniverSheetsCorePreset({
+ container: 'app',
+ }),
+ ],
+})
-- Agent 可以生成基于电子表格的 Mini App,例如决策看板、交互式报告和业务看板。
-- 网页上的指标、图表和控件与单元格绑定,支持数据读取、写入和协同更新。
+univerAPI.createWorkbook({})
+```
-[了解 Univer Workspace](https://github.com/dream-num/univer-workspace)
+现在,页面中已经有了电子表格编辑器。使用返回的 `univerAPI` 操作其内容。本示例使用开源包,无需商业 Univer 许可证或 Server SDK。
-### 其他案例
+对于组件框架,请保留 `createUniver` 返回的 `univer` 实例,并在组件卸载时调用 `univer.dispose()`。参阅[生命周期指南](https://docs.univer.ai/guides/sheets/getting-started/lifecycle)。
-以下开源项目基于 Univer Office SDK 构建:
+预设会组合插件并注册其 Facade API。如需手动控制,请参阅下方的[插件模式示例](#manual-plugin-composition)。[安装指南](https://docs.univer.ai/guides/sheets/getting-started/installation)涵盖两种模式、对等依赖和框架集成。
-| 项目 | 说明 |
-| --- | --- |
-| [Univer Office for DeepSeek Harness](https://github.com/dream-num/dsh-univer-office) | 面向 DeepSeek Harness 的办公插件,支持关联内容、验证和用于 Agent 协作的独立 Worktree。 |
-| [Univer CLI](https://github.com/dream-num/univer-cli) | 供 Agent 创建、编辑、检查和交付办公内容的本地命令行工作空间。 |
-| [Univer Office for WorkBuddy](https://github.com/dream-num/workbuddy-univer-office) | 面向 WorkBuddy 的本地办公集成,支持 MCP 预览和草稿审阅。目前为开发预览版。 |
-| [Univer Office for OpenClaw](https://github.com/dream-num/openclaw-univer-office) | 在 OpenClaw 中创建、审阅和交付办公内容的工具。 |
+需要配套使用的 `@univerjs/*` 包应保持同一版本。商业包必须匹配相应的发布系列;图标等独立发布的包遵循各自声明的兼容性。参阅 [API 稳定性策略](../../docs/API_STABILITY.md)。
-各项目分别说明其安装方式和 SDK 授权要求。
+<a id="connect-your-application-to-editable-content"></a>
-## 🌟 Highlights
+### 将应用连接到可编辑内容
-<table>
- <tr>
- <td align="center" width="33%">
- ⚡<br />
- <strong>大型场景也流畅</strong><br />
- <sub>Canvas 渲染与独立公式引擎,让复杂工作簿保持响应。</sub>
- </td>
- <td align="center" width="33%">
- 🧩<br />
- <strong>插件化扩展</strong><br />
- <sub>按需组合、替换、延迟加载或扩展能力,无需引入整套功能。</sub>
- </td>
- <td align="center" width="33%">
- 🤖<br />
- <strong>Headless AI 基建</strong><br />
- <sub>在 Node.js 中运行工作簿和文档逻辑,为 Agent、自动化和服务端流程提供底层能力。</sub>
- </td>
- </tr>
- <tr>
- <td align="center" width="33%">
- 🛠️<br />
- <strong>面向产品集成</strong><br />
- <sub>框架适配器、Facade API、预设和无头运行时,覆盖真实集成路径。</sub>
- </td>
- <td align="center" width="33%">
- 🌗<br />
- <strong>Dark mode 就绪</strong><br />
- <sub>UI 组件和渲染引擎都支持浅色与深色主题。</sub>
- </td>
- <td align="center" width="33%">
- 🔌<br />
- <strong>统一的 Facade API</strong><br />
- <sub>共享一致的 API,在浏览器和 Node.js 中操作工作簿、区域、公式和文档。</sub>
- </td>
- </tr>
-</table>
+Facade API 是面向应用的工作簿、工作表和范围接口。继续快速开始的示例,填入报价单,从应用代码更新数量,并读取重新计算后的总额:
-## 🚀 为什么选择 Univer?
+```ts
+// Wait for formula controllers before editing a newly created workbook.
+await new Promise<void>((resolve) => {
+ if (univerAPI.getCurrentLifecycleStage() >= univerAPI.Enum.LifecycleStages.Steady) {
+ resolve()
+ return
+ }
+ const listener = univerAPI.addEvent(univerAPI.Event.LifeCycleChanged, ({ stage }) => {
+ if (stage === univerAPI.Enum.LifecycleStages.Steady) {
+ listener.dispose()
+ resolve()
+ }
+ })
+})
-- **同构设计**:既可以在浏览器中运行 UI 应用,也可以在 Node.js 中运行无头处理逻辑。
-- **插件优先架构**:每个能力都以可组合插件的形式提供,功能可以添加、移除、替换或延迟加载。
-- **Preset Mode 便于快速集成**:当你希望快速获得可运行应用时,可以使用本仓库 [`presets/`](../../presets) 中的预设插件集合。
-- **Plugin Mode 提供完整控制**:当你需要自定义加载、更小包体或深度集成时,可以手动组合包和插件。
-- **Facade API**:通过更高层 API 操作工作簿、工作表、区域、文档、公式、命令和事件。
-- **Canvas 渲染引擎**:支持大型可编辑文档界面,并在多种文档类型之间复用渲染层。
-- **可扩展 UI**:支持 React、Vue、Web Components 和不同框架下的应用外壳集成。
+const workbook = univerAPI.getActiveWorkbook()!
+const sheet = workbook.getActiveSheet()
-## 🤖 面向 AI Agent 的办公工作流
+sheet.getRange('A1:D4').setValues([
+ ['Item', 'Quantity', 'Unit price', 'Amount'],
+ ['Seats', 2, 25, '=B2*C2'],
+ ['Support', 1, 100, '=B3*C3'],
+ ['Total', '', '', '=SUM(D2:D3)'],
+])
-Univer 的 AI 与协作能力将 Agent 操作、交互式编辑和人工审阅连接起来:
+// An application control or agent can make the same edit.
+sheet.getRange('B2').setValue(4)
-- **程序化编辑**:Agent 通过结构化 API 检查和修改办公内容。
-- **结果验证**:Agent 通过内容检查、渲染截图和布局诊断验证结果。
-- **Worktree 协作**:Agent 在独立草稿中工作,由人审阅修改并决定合并内容。
+univerAPI.getFormula().onCalculationResultApplied().then(() => {
+ console.log(sheet.getRange('D4').getValue()) // 200
+ localStorage.setItem('quotation', JSON.stringify(workbook.save()))
+}).catch(console.error)
+```
-集成详情请参阅 [AI SDK 文档](https://docs.univer.ai/ai)。实时编辑、共享版本和 Worktree 工作流需要相应的 Web SDK 与协作能力;不同功能所需的包和授权有所区别。
+编辑器与应用操作同一份工作簿,公式变更会自动重新计算。`workbook.save()` 返回包含工作簿及已注册插件数据的 JSON 快照。持久化由你的应用负责,本示例使用浏览器存储。之后再次加载页面时,在初始化后恢复快照,**而不是创建空白工作簿**:
-## ⚡ 快速开始
+```ts
+const saved = localStorage.getItem('quotation')
+if (saved) {
+ univerAPI.createWorkbook(JSON.parse(saved))
+}
+```
+
+此流程仅使用开源包。快照持久化与 XLSX 导入导出是不同的能力,后者需要单独分发的文件转换能力。应用集成应使用公开的 Facade API;下方源码链接说明内部实现和扩展点。依赖扩展点前,请参阅 [API 稳定性策略](../../docs/API_STABILITY.md)。
-使用 **Plugin Mode** 可以获得完整的产品能力覆盖并精确控制组合方式。对于受支持的 Sheets、Docs 和 Node 配置,**Preset Mode** 提供了更简短的预设方案。
+<a id="manual-plugin-composition"></a>
-<details open>
-<summary><strong>Plugin Mode</strong></summary>
+<details>
+<summary>进阶:手动组合插件(插件模式)</summary>
+
+当你需要精确控制插件选择、依赖或加载方式时,可以使用插件模式。上方的预设会代你完成这些组合工作。
-Plugin Mode 让你更底层地控制包、样式导入、locale 合并、Facade API 注册和插件配置。
+这套替代初始化方式使用相同的 `app` 容器和 Sheets Core 预设的浏览器插件栈,不使用 Worker。请用它**替代**预设初始化,然后使用返回的 `univerAPI` 运行同一份报价单示例。
```bash
-pnpm add @univerjs/core @univerjs/design @univerjs/docs @univerjs/docs-ui @univerjs/engine-formula @univerjs/engine-render @univerjs/sheets @univerjs/sheets-formula @univerjs/sheets-formula-ui @univerjs/sheets-numfmt @univerjs/sheets-numfmt-ui @univerjs/sheets-ui @univerjs/ui
+pnpm add @univerjs/core @univerjs/design @univerjs/docs @univerjs/docs-ui \
+ @univerjs/engine-formula @univerjs/engine-render @univerjs/network \
+ @univerjs/sheets @univerjs/sheets-ui @univerjs/sheets-formula \
+ @univerjs/sheets-formula-ui @univerjs/sheets-numfmt \
+ @univerjs/sheets-numfmt-ui @univerjs/ui
```
```ts
@@ -161,7 +301,9 @@ import { UniverDocsPlugin } from '@univerjs/docs'
import { UniverDocsUIPlugin } from '@univerjs/docs-ui'
import DocsUIEnUS from '@univerjs/docs-ui/locale/en-US'
import { UniverFormulaEnginePlugin } from '@univerjs/engine-formula'
+import FormulaEnUS from '@univerjs/engine-formula/locale/en-US'
import { UniverRenderEnginePlugin } from '@univerjs/engine-render'
+import { UniverNetworkPlugin } from '@univerjs/network'
import { UniverSheetsPlugin } from '@univerjs/sheets'
import SheetsEnUS from '@univerjs/sheets/locale/en-US'
import { UniverSheetsFormulaPlugin } from '@univerjs/sheets-formula'
@@ -181,176 +323,479 @@ import '@univerjs/docs-ui/lib/index.css'
import '@univerjs/sheets-ui/lib/index.css'
import '@univerjs/sheets-formula-ui/lib/index.css'
import '@univerjs/sheets-numfmt-ui/lib/index.css'
+import '@univerjs/network/facade'
+import '@univerjs/docs/facade'
+import '@univerjs/docs-ui/facade'
import '@univerjs/engine-formula/facade'
-import '@univerjs/ui/facade'
import '@univerjs/sheets/facade'
+import '@univerjs/ui/facade'
import '@univerjs/sheets-ui/facade'
import '@univerjs/sheets-formula/facade'
import '@univerjs/sheets-numfmt/facade'
+import '@univerjs/sheets-formula-ui/facade'
const univer = new Univer({
locale: LocaleType.EN_US,
locales: {
[LocaleType.EN_US]: mergeLocales(
DesignEnUS,
- UIEnUS,
DocsUIEnUS,
+ FormulaEnUS,
SheetsEnUS,
- SheetsUIEnUS,
SheetsFormulaEnUS,
SheetsFormulaUIEnUS,
SheetsNumfmtUIEnUS,
+ SheetsUIEnUS,
+ UIEnUS,
),
},
})
+univer.registerPlugin(UniverNetworkPlugin)
+univer.registerPlugin(UniverDocsPlugin)
univer.registerPlugin(UniverRenderEnginePlugin)
-univer.registerPlugin(UniverFormulaEnginePlugin)
univer.registerPlugin(UniverUIPlugin, { container: 'app' })
-univer.registerPlugin(UniverDocsPlugin)
univer.registerPlugin(UniverDocsUIPlugin)
-univer.registerPlugin(UniverSheetsPlugin)
-univer.registerPlugin(UniverSheetsUIPlugin)
-univer.registerPlugin(UniverSheetsFormulaPlugin)
-univer.registerPlugin(UniverSheetsFormulaUIPlugin)
+univer.registerPlugin(UniverFormulaEnginePlugin)
+univer.registerPlugin(UniverSheetsPlugin, {
+ onlyRegisterFormulaRelatedMutations: false,
+})
+univer.registerPlugin(UniverSheetsUIPlugin, {
+ protectedRangeShadow: true,
+})
univer.registerPlugin(UniverSheetsNumfmtPlugin)
univer.registerPlugin(UniverSheetsNumfmtUIPlugin)
+univer.registerPlugin(UniverSheetsFormulaPlugin)
+univer.registerPlugin(UniverSheetsFormulaUIPlugin)
const univerAPI = FUniver.newAPI(univer)
univerAPI.createWorkbook({})
```
+Docs 插件支持电子表格中的富文本编辑。添加功能时,请同时引入对应的 Facade 扩展、语言包和 UI 样式。容器卸载时应销毁 `univer`。
+
</details>
-<details>
-<summary><strong>Preset Mode</strong></summary>
+<p align="right"><a href="#readme-top"><img src="https://img.shields.io/badge/%E2%86%91%20%E8%BF%94%E5%9B%9E%E9%A1%B6%E9%83%A8-30363D?style=flat-square" alt="返回顶部" height="20" /></a></p>
+
+<a id="open-source-architecture"></a>
+
+## 🏗️ 探索开源架构
+
+<p align="center"><img src="../../docs/img/readme/architecture-banner.png" alt="" width="960" /></p>
+
+<a id="give-custom-features-clear-boundaries"></a>
+
+### 为自定义功能划分清晰边界
+
+Univer 使用不同的插件组织内容逻辑与 UI 交互。功能插件管理规则和内容变更,UI 插件提供界面及用户交互。例如,`sheets-filter` 管理筛选范围与规则,`sheets-filter-ui` 提供面板、菜单和快捷键。
+
+```mermaid
+%%{init: {'htmlLabels': false, 'theme': 'base', 'themeVariables': {'fontFamily': 'Arial, PingFang SC, Microsoft YaHei, sans-serif', 'fontSize': '17px', 'lineColor': '#64748b'}, 'flowchart': {'htmlLabels': false, 'curve': 'linear', 'nodeSpacing': 28, 'rankSpacing': 45, 'padding': 16, 'wrappingWidth': 270}}}%%
+%% A layered overview, not a complete dependency graph.
+%% Group arrows indicate reuse of the layer below; internal arrows show selected dependencies.
+flowchart TD
+ subgraph FEATURES["Feature Plugins"]
+ direction LR
+ FUI["Filter<br/>UI Plugin"]
+ VUI["Data Validation<br/>UI Plugin"]
+ FILTER["Filter Plugin"]
+ VALIDATION["Data Validation Plugin"]
+ FUI --> FILTER
+ VUI --> VALIDATION
+ end
+
+ subgraph PRODUCTS["Product Plugins"]
+ direction LR
+ SUI["Sheets UI Plugin"]
+ SHEETS["Sheets Plugin"]
+ SUI --> SHEETS
+ end
+
+ subgraph FOUNDATION["Core Framework & Plugins"]
+ direction LR
+ UI["UI Plugin"]
+ FORMULA["Formula Engine Plugin"]
+ RENDER["Render Engine Plugin"]
+ CORE["Core"]
+ UI --> RENDER
+ RENDER --> CORE
+ FORMULA --> CORE
+ end
+
+ FEATURES --> PRODUCTS
+ PRODUCTS --> FOUNDATION
+
+ classDef logic fill:#eff6ff,color:#17365f,stroke:#93b4df,stroke-width:1.5px
+ classDef ui fill:#f0fdf4,color:#17543a,stroke:#91c8a7,stroke-width:1.5px
+ classDef shared fill:#f6f7f9,color:#334155,stroke:#bac3ce,stroke-width:1.5px
+ classDef feature fill:#172d50,color:#ffffff,stroke:#172d50
+ class FUI,VUI ui
+ class FILTER,VALIDATION logic
+ class SUI,SHEETS logic
+ class UI,FORMULA,RENDER,CORE shared
+
+ style FEATURES fill:#f7fcf9,stroke:#b5d8c1,color:#17543a
+ style PRODUCTS fill:#f5f9ff,stroke:#b6cbea,color:#17365f
+ style FOUNDATION fill:#fafbfc,stroke:#cbd2dc,color:#334155
+```
-Preset 是一组经过整理的 Univer 插件集合,包含所需的 Facade API 注册和样式。
+**图 1:三层插件结构。** 功能插件建立在产品插件之上,产品插件复用核心框架与插件。分组箭头表示对下一层的依赖;Core 提供内容模型、命令、依赖注入和生命周期管理。图中省略了部分插件与依赖。
-```bash
-pnpm add @univerjs/presets @univerjs/preset-sheets-core
-```
+新功能将规则保留在自己的插件中,通过公开服务、命令和明确的扩展点协作。UI 插件建立在共享的 UI 服务与组件之上。
-```ts
-import { UniverSheetsCorePreset } from '@univerjs/preset-sheets-core'
-import UniverPresetSheetsCoreEnUS from '@univerjs/preset-sheets-core/locales/en-US'
-import { createUniver, LocaleType, mergeLocales } from '@univerjs/presets'
-import '@univerjs/preset-sheets-core/lib/index.css'
+依赖关系在两个层面明确声明:
-const { univerAPI } = createUniver({
- locale: LocaleType.EN_US,
- locales: {
- [LocaleType.EN_US]: mergeLocales(UniverPresetSheetsCoreEnUS),
- },
- presets: [
- UniverSheetsCorePreset({
- container: 'app',
- }),
- ],
-})
+- **插件之间:** `DependentOn` 声明运行时插件依赖。插件服务对其排序,生命周期阶段将依赖注册、内容初始化和 UI 初始化分开。
+- **插件内部:** 依赖注入通过声明的依赖连接控制器与服务。受支持的覆盖机制允许应用替换实现、适配平台服务或提供测试替身。实例级注入器将不同 Univer 实例的应用状态隔离。
-univerAPI.createWorkbook({})
+可释放的注册机制也让命令、监听器、组件和图标在所属对象销毁时得到清理。
+
+[筛选插件](../../packages/sheets-filter/src/plugin.ts)及其 [UI 插件](../../packages/sheets-filter-ui/src/plugin.ts)在实际代码中展示了这些边界。
+
+<details>
+<summary>功能内部:Model、Controller、Service 和 UI 基础设施</summary>
+
+在筛选功能中,`sheets-filter` 负责内容逻辑,`sheets-filter-ui` 负责 UI 交互,每个模块各司其职。
+
+```mermaid
+%%{init: {'htmlLabels': false, 'theme': 'base', 'themeVariables': {'fontFamily': 'Arial, PingFang SC, Microsoft YaHei, sans-serif', 'fontSize': '17px', 'lineColor': '#64748b'}, 'flowchart': {'htmlLabels': false, 'curve': 'linear', 'nodeSpacing': 28, 'rankSpacing': 45, 'padding': 16, 'wrappingWidth': 270}}}%%
+%% Every arrow means contains. This is code organization, not execution order.
+flowchart LR
+ FEATURE["Filter Feature"]
+ LOGIC["Filter Plugin"]
+ UI["Filter UI Plugin"]
+ MODEL["Model"]
+ SERVICE["Service"]
+ CONTROLLER["Controller"]
+ COMMAND["Command / Mutation"]
+ FACADE["Facade API"]
+ VIEW["View"]
+ UICTRL["UI Controller"]
+ UISERVICE["UI Service"]
+ FEATURE --> LOGIC
+ FEATURE --> UI
+ LOGIC --> MODEL
+ LOGIC --> SERVICE
+ LOGIC --> CONTROLLER
+ LOGIC --> COMMAND
+ LOGIC --> FACADE
+ UI --> VIEW
+ UI --> UICTRL
+ UI --> UISERVICE
+
+ classDef logic fill:#eff6ff,color:#17365f,stroke:#93b4df,stroke-width:1.5px
+ classDef ui fill:#f0fdf4,color:#17543a,stroke:#91c8a7,stroke-width:1.5px
+ classDef shared fill:#f6f7f9,color:#334155,stroke:#bac3ce,stroke-width:1.5px
+ classDef feature fill:#172d50,color:#ffffff,stroke:#172d50
+ class FEATURE feature
+ class LOGIC,MODEL,SERVICE,CONTROLLER,COMMAND,FACADE logic
+ class UI,VIEW,UICTRL,UISERVICE ui
```
+**图 2:代码组织。箭头表示“包含”。** 两种插件都可以包含 Controller 和 Service:逻辑 Controller 协调内容变更与相关功能;UI Controller 连接菜单、快捷键和交互,UI Service 管理面板状态。这些职责为新功能的实现与测试提供一致的结构。
+
+UI 基础设施采用相同的职责划分。**`@univerjs/design`** 提供共享组件和样式,**`@univerjs/ui`** 提供菜单、快捷键、面板和组件注册等工作台服务,**`@univerjs/icons`** 提供图标。功能通过这些扩展点注册组件和图标、添加菜单并接入渲染。团队可以在复用应用 UI 基础设施的同时添加面板或工具栏功能。参阅 [UI 概览](https://docs.univer.ai/guides/sheets/ui/overview)和筛选插件的[组件与图标注册](../../packages/sheets-filter-ui/src/controllers/components.controller.ts)。
+
</details>
-页面需要一个容器:
+<a id="compose-cross-feature-edits-and-undoredo"></a>
-```html
-<div id="app" style="height: 100vh"></div>
+### 组合跨功能编辑与撤销/重做
+
+例如,在筛选范围内插入行时,筛选插件提供相应的范围变更及撤销数据。插行命令组合基础编辑和参与功能的变更,执行它们,并统一记录撤销/重做信息。插行功能可以使用共享的扩展机制,筛选插件则负责自身的范围更新规则。
+
+命令系统区分三种操作:
+
+- **Command** 编排业务操作及其所需的变更。
+- **Mutation** 以可序列化参数修改保存在快照中的内容。
+- **Operation** 修改临时状态,例如打开的面板或滚动位置。
+
+**统一的撤销/重做结构。** 对于可撤销的编辑,功能实现提供正向 Mutation 和对应的逆向 Mutation,Command 通过 `IUndoRedoService` 记录它们。当一个操作影响多个功能时,Command 可以将它们的变更与撤销数据合并为一条记录,使用户能够完整地撤销和重做该操作。参阅[扩展命令](https://docs.univer.ai/blog/custom-command)。
+
+功能之间仍然需要协作。**拦截器与引用范围处理器为这种协作提供明确的位置。** 在受支持的扩展点,插件提供检查或相关 Mutation;在 API 定义的范围内,拦截器优先级控制执行顺序。
+
+<details>
+<summary>示例:命令、回调、功能协作与撤销/重做</summary>
+
+```mermaid
+%%{init: {'htmlLabels': false, 'theme': 'base', 'themeVariables': {'fontFamily': 'Arial, PingFang SC, Microsoft YaHei, sans-serif', 'fontSize': '17px', 'lineColor': '#64748b'}, 'flowchart': {'htmlLabels': false, 'curve': 'linear', 'nodeSpacing': 28, 'rankSpacing': 45, 'padding': 16, 'wrappingWidth': 270}}}%%
+%% Simplified insert-row example. A command composes mutations and records undo after success.
+%% Events may also fire for nested command executions; not every callback is drawn.
+flowchart TD
+ BEFORE["Before execution<br/>Inspect or cancel"]
+ CMD["Insert-row Command"]
+ BASE["Row mutations"]
+ EXT["Feature extension points<br/>Filter range changes"]
+ MODEL["Execute combined mutations"]
+ UNDO["Record undo and redo"]
+ AFTER["After execution<br/>Notify listeners"]
+ BEFORE --> CMD
+ CMD --> BASE
+ CMD --> EXT
+ BASE --> MODEL
+ EXT --> MODEL
+ MODEL --> UNDO
+ UNDO --> AFTER
+ classDef entry fill:#f6f7f9,color:#334155,stroke:#bac3ce,stroke-width:1.5px
+ classDef core fill:#eff6ff,color:#17365f,stroke:#93b4df,stroke-width:1.5px
+ classDef extension fill:#f0fdf4,color:#17543a,stroke:#91c8a7,stroke-width:1.5px
+ class BEFORE,AFTER entry
+ class CMD,BASE,MODEL,UNDO core
+ class EXT extension
```
-更多内容请阅读 [安装与基础使用指南](https://docs.univer.ai/guides/sheets/getting-started/installation)、[`createUniver` 参考](https://docs.univer.ai/reference/methods/create-univer) 和 [Facade API 参考](https://docs.univer.ai/reference/classes/univer)。
+此图简化了插行流程。嵌套命令有各自的执行回调;图中未展示全部事件,也未展示独立的 Operation 路径。参阅[行命令](../../packages/sheets/src/commands/commands/insert-row-col.command.ts)、[筛选控制器](../../packages/sheets-filter/src/controllers/sheets-filter.controller.ts)和[拦截器服务](../../packages/sheets/src/services/sheet-interceptor/sheet-interceptor.service.ts)。
+
+</details>
+
+这些边界支持实用的测试策略:独立测试模型和服务,通过依赖注入替换外部依赖,并为组合操作与撤销/重做补充回归用例。[筛选控制器测试](../../packages/sheets-filter/src/controllers/__tests__/sheets-filter.controller.spec.ts)覆盖行列变更及其对筛选的影响。
+
+<a id="connect-applications-and-agents-through-facade-apis-and-events"></a>
+
+### 通过 Facade API 和事件连接应用与 Agent
+
+本仓库包含编辑器背后的内容模型、公式引擎,以及 Canvas 渲染与布局引擎。它们是共享的基础模块;例如,电子表格的富文本会复用文档的布局和渲染。自定义功能可以基于这些引擎构建,无需另行实现内容技术栈。参阅[公式引擎架构](https://docs.univer.ai/blog/formula)和[渲染引擎架构](https://docs.univer.ai/blog/rendering)。
+
+浏览器编辑器、Node.js 中的 Headless 任务,以及合理组合的 Worker,都可以复用相应的内容插件、模型、命令和计算能力。参阅 [Headless Univer](https://docs.univer.ai/guides/sheets/getting-started/node)和[同构架构](../../docs/ISOMORPHIC.md)。
+
+`ICommandService` 提供执行回调,使插件能够在命令执行前后进行观察。Facade API 将底层能力封装为 `FWorkbook`、`FWorksheet` 和 `FRange` 等面向应用的对象。
+
+各插件提供自己的 Facade 扩展、**通过 `univerAPI.Event` 暴露的类型化事件**,以及**通过 `univerAPI.Enum` 暴露的枚举**。应用代码可以从统一入口查找事件名与常量,无需导入私有服务或重复编写字符串。例如,`BeforeCommandExecute` 可以检查并取消执行,`CommandExecuted` 向监听器报告执行情况。监听器返回可释放对象,取消仅在事件支持时生效。
+
+Facade 扩展随各自的功能包提供,因此内容 API 不必引入无关的 UI API。参阅 [Facade 设计](https://docs.univer.ai/blog/facade)、[命令回调与事件桥接](../../packages/core/src/facade/f-univer.ts)和 [Enum 入口](../../packages/core/src/facade/f-enum.ts)。
+
+本仓库提供可用的功能实现及扩展模式。完整示例请阅读[筛选功能实现解析](https://docs.univer.ai/blog/anatomy);依赖扩展点前,请参阅 [API 稳定性策略](../../docs/API_STABILITY.md)。
+
+<p align="right"><a href="#readme-top"><img src="https://img.shields.io/badge/%E2%86%91%20%E8%BF%94%E5%9B%9E%E9%A1%B6%E9%83%A8-30363D?style=flat-square" alt="返回顶部" height="20" /></a></p>
+
+<a id="open-source-and-commercial-extensions"></a>
+
+## 🧩 使用 Univer Office SDK 扩展应用
+
+<p align="center"><img src="../../docs/img/readme/sdk-banner.png" alt="" width="960" /></p>
+
+需要更多可直接集成的能力时,可以组合相应的 **Univer Office SDK** 模块,包括更多内容类型、高级编辑插件、协作、文件转换和 Agent 工具。它们扩展上文介绍的同一套内容模型、插件架构、命令系统和 Facade 设计,因此可以在现有集成之上继续构建。
+
+<div align="center" style="overflow-x: auto;">
+
+<table align="center" style="display: table; width: auto; margin-left: auto; margin-right: auto;">
+<thead>
+<tr>
+<th>组成</th>
+<th>如何扩展开源基础</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td><strong>开源 Web SDK 核心 · 本仓库</strong></td>
+<td>开源的模型、引擎、插件、UI 基础设施,以及 Sheets 和 Docs 能力,并提供相应的 Headless 内容操作。可依据 Apache-2.0 许可证用于商业应用。</td>
+</tr>
+<tr>
+<td><strong>商业 Web SDK 插件</strong></td>
+<td>遵循核心的 Plugin、依赖注入、Command/Mutation 和 Facade 扩展模式,为相应内容类型添加图表、形状、透视表、SmartArt 等功能。</td>
+</tr>
+<tr>
+<td><strong>Server SDK</strong></td>
+<td>基于相同的内容模型和 Mutation 约定,增加实时协作、版本历史和办公文件转换,并与应用的身份、权限和存储系统集成。</td>
+</tr>
+<tr>
+<td><strong>AI SDK 扩展</strong></td>
+<td>复用 Web SDK 的 Headless 与 Facade 能力,提供可组合的 Node.js API 和 CLI 基础模块,让 Agent 检查、编辑和验证内容,并集成协作与 Worktree 审阅。</td>
+</tr>
+</tbody>
+</table>
+
+</div>
+
+<a id="scope-and-licensing"></a>
+
+### 范围与授权
+
+- **本仓库:** 采用 Apache-2.0 许可证的包,可依据该许可证用于商业应用,包括开源的 Headless 内容能力。
+- **商业扩展:** 商业 Web SDK 插件、Server SDK 及超出开源基础的 AI SDK 能力单独分发和授权。**Freemium** 评估包含水印和功能限制。
+- **参考应用:** Univer Workspace 等开源应用具有自己的源码许可证,其 SDK 依赖仍遵循各自的许可证。
+
+详细覆盖范围请查看[功能对比](https://univer.ai/compare/),其中提供 **Open source only(仅开源)** 筛选;商业选项请查看[方案与授权](https://univer.ai/pricing/)。
+
+<details>
+<summary>共享内容模型如何连接编辑、协作与文件</summary>
+
+这些能力操作可序列化的 **Unit 快照**,包括 Sheets 的 `IWorkbookData`、Docs 的 `IDocumentData`、Slides 的 `ISlideData`,以及画布的 `IBoardData`(API 中称为 **Boards**)。这些类型来自 core 和相应产品包;当前 Slides 和 Boards 能力属于单独分发的商业产品。共享的 Unit 约定让浏览器编辑器、后端服务和 Agent 能够处理同一份内容。
+
+Command 编排编辑,**Mutation 描述内容变更**。协作将 Mutation 打包为 **changeset(变更集)**,通过**操作转换(OT)**处理并发变更,并管理已确认的版本和快照。历史功能可以从快照及后续变更集重建某个版本。参阅[协作设计](https://docs.univer.ai/blog/ot)和 [Collaboration SDK 概览](https://docs.univer.ai/server/collaboration/overview)。
+
+**Exchange** 在办公文件结构与 Univer 内容快照之间进行转换。对于 **XLSX、DOCX 和 PPTX** 等 OOXML 格式,它将文件解析为对应的 Sheet、Doc 或 Slide 数据,并在导出时生成文件表示。转换后的内容可以进入同样的编辑、计算、协作和 Agent 工作流程。参阅[办公文件导入导出](https://docs.univer.ai/server/import-export/node)。
+
+</details>
+
+<details>
+<summary>AI SDK 如何向 Agent 提供相同的内容能力</summary>
-## 🧩 Preset Mode 与 Plugin Mode
+AI SDK 建立在 Web SDK 的 **Headless 内容模型、命令、计算和 Facade API** 之上,提供结构化的 TypeScript API 及可选的 Commander 预设,供应用组合自己的 Office CLI 或 Agent 工具。
-| 选择 | 适用场景 | 从这里开始 |
-| --- | --- | --- |
-| **Plugin Mode** | 你需要严格控制包、已配置的依赖、延迟加载或自定义运行时组合。 | 本仓库的 [`examples/`](../../examples) 和 [架构指南](https://docs.univer.ai/guides/recipes/architecture/univer) |
-| **Preset Mode** | 你希望用最少配置获得可运行的 Sheets、Docs 或 Node 设置。 | 本仓库的 [`presets/`](../../presets) 和 [快速入门指南](https://docs.univer.ai/guides/sheets/getting-started/installation) |
-| **Headless Mode** | 你需要在没有 UI 的情况下进行服务端工作簿/文档处理、公式计算或自动化。 | [Headless Univer](https://docs.univer.ai/guides/sheets/getting-started/node) |
+- **理解、发现和编辑。** 检查会返回结构化内容。API Reference 帮助 Agent 查找随 SDK 发布的 Facade 符号与签名。Facade 执行区分读写模式、捕获 Mutation,并提供明确的同步和提交结果。参阅[内容操作](https://docs.univer.ai/ai/content-operations)。
+- **检查渲染结果。** 浏览器 Render Runtime 复用 Web SDK 渲染来生成截图。幻灯片布局检查会返回文字超出页面、重叠等问题的结构化结果,为 Agent 的下一轮编辑提供依据。参阅[视觉检查](https://docs.univer.ai/ai/visual-inspection)。
+- **编辑草稿供人工审阅。** 配合相应的协作和 Web 能力,Agent 可以在隔离的 Worktree 草稿中进行多轮编辑与验证,再交给用户审阅、合并或重新打开。流程沿用相同的快照、Mutation 和版本约定。参阅 [Worktree](https://docs.univer.ai/ai/worktree)。
-同一 Univer 协调发布线中的 `@univerjs/*` SDK 包应保持版本一致。`@univerjs/icons`、`@univerjs/icons-svg` 等独立发布的包应使用各包清单声明的兼容版本,而不是跟随 SDK 版本。使用 Univer Pro 时,也请让 `@univerjs-pro/*` 与对应的协调发布线保持一致。
+对于重复调用,可选的 [Worker 池和守护进程](https://docs.univer.ai/ai/runtime-architecture)可以复用已加载的内容实例,减少重复初始化。根 CLI、目标、授权和输出由应用负责。请通过 [AI SDK 包目录](https://docs.univer.ai/ai/packages)选择所需能力。
-关于 API 兼容性预期、实验性 API、内部 API 和废弃规则,请阅读 [API 稳定性政策](../API_STABILITY.md)。
+</details>
-## 🧭 兼容性
+<p align="right"><a href="#readme-top"><img src="https://img.shields.io/badge/%E2%86%91%20%E8%BF%94%E5%9B%9E%E9%A1%B6%E9%83%A8-30363D?style=flat-square" alt="返回顶部" height="20" /></a></p>
-- **浏览器运行时**:Univer 的编译目标是 Chrome 88,并尽力支持 Edge `>=88`、Firefox `>=90`、Chrome `>=88`、Safari `>=14.1` 和 Electron `>=12`。
-- **Polyfills**:Univer 依赖 `Intl.Segmenter`。如果目标浏览器或运行时不支持,请添加 `@formatjs/intl-segmenter` 等 polyfill。
-- **构建工具**:推荐使用 Vite、esbuild 或 Webpack 5。如果构建工具不支持 `package.json` 中的 `exports` 字段(Webpack 4 中较常见),可能需要额外配置路径映射。
-- **React**:Univer 的视图层基于 React 18 构建,支持 React 18 和 19,并对 React 16.9+ 与 17 提供最低限度的兼容支持。
-- **Node.js 运行时**:Headless Univer 支持 Node.js `>=18.17.0`。开发本 monorepo 需要 Node.js `>=22.18`。
+<a id="application-patterns-and-ecosystem"></a>
-## 🛠️ 你可以构建什么
+## 🌐 应用模式与生态
-| 领域 | 开源能力 | Univer Pro 扩展 |
-| --- | --- | --- |
-| **Sheets** | 工作簿、工作表、区域、选择、公式、数字格式、筛选、排序、数据验证、条件格式、超链接、评论、查找替换、批注、表格、绘图集成和可扩展 UI 插件。 | 实时协同、编辑历史、导入导出、打印、图表、数据透视表、迷你图、分级显示、形状、单元格内图形、数据连接器、服务端计算和增强公式能力。 |
-| **Docs** | 富文本文档模型、编辑 UI、列表、超链接、绘图集成、评论、快捷插入和共享文档架构。 | 协同、导入导出、打印、增强表格和列表、分栏、提示块、代码块、引用块、形状和远程评论资源。 |
-| **Slides** | — | 演示文稿模型和 UI、幻灯片导入导出、图表和表格模型/UI 插件,以及共享形状编辑基础设施。 |
-| **Bases** | 基于 Univer 的插件、命令和模型架构构建自定义结构化数据体验。 | Base 数据库模型、命令、公式集成、工作台 UI、字段编辑器和渲染引擎视图。 |
-| **Runtime** | 浏览器应用、Node.js 无头使用、Web Worker/RPC 模式、多实例使用和服务端自动化。 | 协同客户端/服务端包、Node.js 协同客户端、Pro 服务端服务、SSR、计算委托、服务端计算和 changeset 回放工具。 |
-| **Integrations** | React、Vue、Web Components、框架模板、主题、本地化和自定义插件。 | Pro 预设和企业部署包。 |
+<p align="center"><img src="../../docs/img/readme/ecosystem-banner.png" alt="" width="960" /></p>
-Sheets、Docs 和 Slides 基于 Univer 的共享架构,分别提供电子表格、文档和演示文稿编辑能力,并使用一致的插件系统、命令系统和 Facade API。
+<a id="univer-workspace-an-office-sdk-reference-application"></a>
-## 🔓 开源与 Pro
+### Univer Workspace:Office SDK 参考应用
-本仓库包含 Univer 的开源核心和第一方 OSS 插件。Univer Pro 作为商业扩展层单独开发,面向高级产品界面、协同、服务端能力和企业集成。
+需要完整应用参考时,可以从 [Univer Workspace](https://github.com/dream-num/univer-workspace) 开始。它展示了如何将 Univer Office SDK 编辑器、协作、文件能力、现有 Agent 和人工审阅组合成可自行托管的工作空间。构建自己的办公应用或 Agent 工作空间时,可以参考其集成模式。
-| 类别 | 开源 | Univer Pro / 商业版 |
-| --- | --- | --- |
-| **基础能力** | 核心 SDK、插件系统、渲染引擎、公式引擎、Facade API、主题、i18n 和框架适配器。 | Pro 预设和企业部署包。 |
-| **Sheets** | 核心电子表格编辑、公式、数字格式、筛选/排序、数据验证、条件格式、批注、表格、超链接、评论、绘图、查找替换。 | 协同、编辑历史、导入导出、打印、图表、数据透视表、迷你图、分级显示、形状、单元格内图形、数据连接器、区域预处理和增强公式引擎能力。 |
-| **Docs** | 文档模型和编辑 UI、列表、超链接、评论、快捷插入和绘图集成。 | 协同、导入导出、打印、增强表格/列表、分栏、提示块、代码块、引用块、形状和远程线程评论资源。 |
-| **Slides** | — | 演示文稿模型/UI 包、幻灯片导入导出、图表、表格和可复用形状编辑器 UI。 |
-| **Bases** | 用于自定义数据类产品的可扩展插件架构。 | Base 数据库核心模型、命令、变更、公式集成、工作台 UI、字段编辑器和渲染引擎集成。 |
-| **服务端与运行时** | Node.js 无头运行时、RPC/Web Worker 模式和面向服务端自动化的基础能力。 | 协同服务端、Node.js 协同客户端、SSR 服务、计算委托、服务端计算和协同 changeset 回放工具。 |
+<div align="center" style="overflow-x: auto;">
-编辑器功能请参考 [Web SDK 文档](https://docs.univer.ai/guides/sheets)。服务端集成请参考 Server SDK 中的[协同](https://docs.univer.ai/server/collaboration/overview)和[文件导入导出](https://docs.univer.ai/server/import-export)章节。
+<table align="center" style="display: table; width: auto; margin-left: auto; margin-right: auto;">
+ <tr>
+ <td width="50%" valign="top">
+ <a href="https://space.univer.ai/"><img src="../../docs/img/readme/workspace.webp" alt="Univer Workspace 中的可编辑预算表格" width="420" /></a>
+ </td>
+ <td width="50%" valign="top">
+ <a href="https://univer.ai/demo/web-app"><img src="../../docs/img/readme/web-app.webp" alt="假设条件控件与关联的可编辑表格并排展示的 Web App" width="420" /></a>
+ </td>
+ </tr>
+ <tr>
+ <td width="50%" valign="top">
+ <strong>Agent 与可编辑的办公内容</strong><br />
+ 将对话、电子表格编辑和办公内容放在同一工作空间中。<br />
+ <a href="https://space.univer.ai/">体验 Workspace</a> · <a href="https://github.com/dream-num/univer-workspace">Workspace 源码与配置</a>
+ </td>
+ <td width="50%" valign="top">
+ <strong>Web App × Sheet · 实验性功能</strong><br />
+ 将控件绑定到单元格:应用写入表格,表格变更更新应用。<br />
+ <a href="https://univer.ai/demo/web-app">体验表格驱动的应用演示</a>
+ </td>
+ </tr>
+</table>
-商业授权和购买咨询请[联系我们](https://univer.ai/#contact)。在应用中配置许可证,请参考[许可证配置](https://docs.univer.ai/server/license)。
+</div>
-边界原则:
+Workspace 是开源应用,其 SDK 依赖遵循各自的许可证。关联应用和审阅流程请参阅 [Workspace 概览](https://univer.ai/workspace/)。
+
+<p align="center"><a href="https://www.youtube.com/watch?v=1p-SMEiK6Kg"><img src="../../docs/img/readme/integration-demo.png" alt="观看 SDK 集成演示" width="720" /></a></p>
+
+[观看 SDK 集成演示](https://www.youtube.com/watch?v=1p-SMEiK6Kg)
+
+<a id="cli-agent-integrations-and-developer-skills"></a>
+
+### CLI、Agent 集成与开发技能
+
+同样的 SDK 能力也可以组合进你已经使用的 Agent 和工具中:
+
+<div align="center" style="overflow-x: auto;">
+
+<table align="center" style="display: table; width: auto; margin-left: auto; margin-right: auto;">
+<thead>
+<tr>
+<th>项目</th>
+<th>提供的能力</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td><a href="https://github.com/dream-num/univer-cli">Univer CLI</a></td>
+<td>用于创建、编辑、检查和交付办公内容的本地命令行工作空间。</td>
+</tr>
+<tr>
+<td><a href="https://github.com/dream-num/dsh-univer-office">Univer Office for DeepSeek Harness</a></td>
+<td>关联内容、结果验证、版本化变更和隔离的 Worktree 协作。</td>
+</tr>
+<tr>
+<td><a href="https://github.com/dream-num/workbuddy-univer-office">Univer Office for WorkBuddy</a></td>
+<td>本地 Office 集成、MCP 预览和草稿审阅,目前为开发者预览版。</td>
+</tr>
+<tr>
+<td><a href="https://github.com/dream-num/openclaw-univer-office">Univer Office for OpenClaw</a></td>
+<td>用于创建、审阅和交付办公内容的工具。</td>
+</tr>
+<tr>
+<td><a href="https://github.com/dream-num/univer-sdk-skills">Univer SDK Skills</a></td>
+<td>帮助编码 Agent 集成 SDK、开发插件和实现后端工作流程的指令。</td>
+</tr>
+</tbody>
+</table>
-- 本仓库中的 OSS 包应能在 Apache-2.0 许可证下独立使用。Univer Pro 是可选的,使用公开 OSS SDK API 不需要依赖 Pro。
-- OSS 包中的 bug、回归和安全问题应在 OSS 仓库中报告和修复,即使存在相关的 Pro 功能。
-- OSS 文档不应暗示 Pro-only 能力已经包含在公开的 `@univerjs/*` 包中。Pro-only API、包和部署路径应被明确命名。
-- 当某个 OSS 功能存在 Pro 增强时,OSS 行为仍应被独立记录,便于用户在不先阅读商业文档的情况下评估开源能力。
+</div>
+
+各仓库均提供配置说明和 SDK 依赖说明。可浏览[生态](https://univer.ai/ecosystem/)了解 Agent 入口,或参考[文档](https://docs.univer.ai/)构建自己的集成。
+
+<p align="right"><a href="#readme-top"><img src="https://img.shields.io/badge/%E2%86%91%20%E8%BF%94%E5%9B%9E%E9%A1%B6%E9%83%A8-30363D?style=flat-square" alt="返回顶部" height="20" /></a></p>
+
+<a id="documentation-and-contributing"></a>
+
+## 📚 文档与贡献
+
+感谢所有参与构建和改进 Univer 的[贡献者](https://github.com/dream-num/univer/graphs/contributors)。欢迎贡献引擎、插件、测试、文档和示例。
-## 🌐 生态
+<p align="center"><a href="https://docs.univer.ai/guides/sheets">🧩 Web SDK</a> · <a href="https://docs.univer.ai/server">🖥️ Server SDK</a> · <a href="https://docs.univer.ai/ai">🤖 AI SDK</a> · <a href="https://docs.univer.ai/reference/classes/univer">🔧 API 参考</a> · <a href="https://office.univer.ai/">🎮 在线示例</a></p>
-- **核心 SDK**:[`dream-num/univer`](https://github.com/dream-num/univer),也就是当前 monorepo。
-- **Presets**:本仓库的 [`presets/`](../../presets),面向浏览器和 Node.js 应用的预设插件集合。
-- **AI agent skills**:[`dream-num/univer-sdk-skills`](https://github.com/dream-num/univer-sdk-skills),供 AI agent 使用的可复用说明,覆盖 Univer 集成、Pro 功能、插件开发和 Node 后端。参见 [AI Skills 指南](https://docs.univer.ai/guides/skills)。
-- **文档**:[docs.univer.ai](https://docs.univer.ai),包含 Web SDK、Server SDK 和 AI SDK 指南及 API 参考。
-- **Web SDK**:在浏览器和 Node.js 中提供[嵌入式编辑器与无头处理](https://docs.univer.ai/guides/sheets)能力。
-- **Server SDK**:将[协作与文件转换](https://docs.univer.ai/server)接入应用的存储、身份认证和权限系统。
-- **AI SDK**:通过 [Agent 工作流](https://docs.univer.ai/ai)检查、编辑和验证办公内容。
-- **API 参考**:[docs.univer.ai/reference](https://docs.univer.ai/reference/classes/univer),包含 Facade API 和生成的 API 参考。
-- **示例与展示**:[Univer Showcase](https://docs.univer.ai/showcase) 和本仓库的 [`examples/`](../../examples)。
-- **AI-native spreadsheets**:[`dream-num/univer-mcp`](https://github.com/dream-num/univer-mcp),用于通过自然语言驱动 Univer Sheets 的 Univer Platform / MCP 集成。
+<div align="center" style="overflow-x: auto;">
-## 📦 仓库结构
+<table align="center" style="display: table; width: auto; margin-left: auto; margin-right: auto;">
+ <tr>
+ <th align="center"><img src="https://cdnjs.cloudflare.com/ajax/libs/browser-logos/75.0.1/edge/edge_64x64.png" width="32" height="32" alt="" /><br />Edge</th>
+ <th align="center"><img src="https://cdnjs.cloudflare.com/ajax/libs/browser-logos/75.0.1/firefox/firefox_64x64.png" width="32" height="32" alt="" /><br />Firefox</th>
+ <th align="center"><img src="https://cdnjs.cloudflare.com/ajax/libs/browser-logos/75.0.1/chrome/chrome_64x64.png" width="32" height="32" alt="" /><br />Chrome</th>
+ <th align="center"><img src="https://cdnjs.cloudflare.com/ajax/libs/browser-logos/75.0.1/safari/safari_64x64.png" width="32" height="32" alt="" /><br />Safari</th>
+ <th align="center"><img src="https://cdnjs.cloudflare.com/ajax/libs/browser-logos/75.0.1/electron/electron_64x64.png" width="32" height="32" alt="" /><br />Electron</th>
+ </tr>
+ <tr>
+ <td align="center"><code>&gt;=88</code></td>
+ <td align="center"><code>&gt;=90</code></td>
+ <td align="center"><code>&gt;=88</code></td>
+ <td align="center"><code>&gt;=14.1</code></td>
+ <td align="center"><code>&gt;=12</code></td>
+ </tr>
+</table>
+
+</div>
+
+<p align="center">Univer 以 Chrome 88 为编译目标,旨在支持上表所列版本。</p>
+
+<a id="runtime-compatibility"></a>
+
+### 运行环境兼容性
+
+- **Polyfill**:Univer 依赖 `Intl.Segmenter`。如果目标浏览器或运行时未提供该 API,请添加 `@formatjs/intl-segmenter` 等 Polyfill。
+- **构建工具**:推荐 Vite、esbuild 或 Webpack 5。如果构建工具不支持 `package.json` 中的 `exports` 字段(常见于 Webpack 4),可能需要额外的路径映射。
+- **React**:Univer 的视图层基于 React 18 构建,支持 React 18 和 19,并为 React 16.9+ 和 17 提供最低限度的兼容支持。
+- **Node.js 环境**:Headless Univer 支持 Node.js `>=18.17.0`,开发本仓库需要 Node.js `>=22.18`。
+
+<details>
+<summary>在本仓库中开发</summary>
+
+### 仓库结构
```text
.
-├── packages/ 核心包、引擎、文档类型、UI 插件和功能插件
-├── examples/ 用于本地浏览器开发的一体化 Vite 工作台
-├── common/ 共享内部工具、storybook 和工具函数
-├── tests/ 其他集成测试项目
-└── docs/ 架构说明、图片和仓库内文档
+├── packages/ Core packages, engines, document types, UI plugins, and feature plugins
+├── examples/ All-in-one Vite workbench used for local browser development
+├── common/ Shared internal tooling, storybook, and utilities
+├── tests/ Additional integration test projects
+└── docs/ Architecture notes, images, and repository-local documentation
```
-包级 README 位于 [`packages/`](../../packages) 下各包目录中。
+各包的 README 位于 [`packages/`](../../packages) 下对应包的目录中。
-## 🧑‍💻 开发
+### 本地开发
-要求:
+环境要求:
- Node.js `>=22.18`
-- pnpm `>=11`
+- pnpm:使用 `package.json` 中 `packageManager` 声明的版本。
```bash
git clone https://github.com/dream-num/univer.git
@@ -361,67 +806,111 @@ pnpm dev
常用命令:
-| 命令 | 用途 |
-| --- | --- |
-| `pnpm dev` | 构建并预览低内存、无 HMR 的一体化工作台。 |
-| `pnpm dev:source` | 启动支持 HMR 的源码工作台,冷启动和内存占用更高。 |
-| `pnpm build` | 构建 workspace 包,不包含内部 common 包。 |
-| `pnpm test` | 通过 Turbo 运行单元测试。 |
-| `pnpm typecheck` | 通过 Turbo 运行 TypeScript 检查。 |
-| `pnpm lint` | 运行 ESLint。 |
-| `pnpm storybook:dev` | 启动用于 UI 组件开发的 Storybook。 |
+<div align="center" style="overflow-x: auto;">
+
+<table align="center" style="display: table; width: auto; margin-left: auto; margin-right: auto;">
+<thead>
+<tr>
+<th>命令</th>
+<th>用途</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td><code class="notranslate">pnpm dev</code></td>
+<td>启动 Sheets 和 Docs 开发工作台。</td>
+</tr>
+<tr>
+<td><code class="notranslate">pnpm build</code></td>
+<td>构建工作区包,不包括内部 common 包。</td>
+</tr>
+<tr>
+<td><code class="notranslate">pnpm test</code></td>
+<td>通过 Turbo 运行单元测试。</td>
+</tr>
+<tr>
+<td><code class="notranslate">pnpm typecheck</code></td>
+<td>通过 Turbo 运行 TypeScript 检查。</td>
+</tr>
+<tr>
+<td><code class="notranslate">pnpm lint</code></td>
+<td>运行 ESLint。</td>
+</tr>
+<tr>
+<td><code class="notranslate">pnpm storybook:dev</code></td>
+<td>启动 Storybook 进行 UI 组件开发。</td>
+</tr>
+</tbody>
+</table>
+
+</div>
+
+提交 Pull Request 前,请阅读 [CONTRIBUTING.md](../../CONTRIBUTING.md)。
-提交 pull request 前请阅读 [CONTRIBUTING.md](../../CONTRIBUTING.md)。
+</details>
+
+<details>
+<summary>架构与贡献参考</summary>
-## 📝 贡献者笔记
+- [仓库中的包](../../packages)、[预设](../../presets)和[示例](../../examples)。
+- [构建同构 Univer](../../docs/ISOMORPHIC.md)。
+- [Facade API 贡献指南](../../docs/CONTRIBUTING-FACADE.md)。
+- [API 稳定性策略](../../docs/API_STABILITY.md)。
+- [命名规范](../../docs/NAMING_CONVENTION.md)和[内存泄漏修复](../../docs/FIX_MEMORY_LEAK.md)。
+- [架构 TLDR](../../docs/tldr)和 [OLE 附件说明](../../packages/drawing/docs/ole-attachments.md)。
-深入修改前,建议阅读这些仓库内说明:
+</details>
+
+<p align="right"><a href="#readme-top"><img src="https://img.shields.io/badge/%E2%86%91%20%E8%BF%94%E5%9B%9E%E9%A1%B6%E9%83%A8-30363D?style=flat-square" alt="返回顶部" height="20" /></a></p>
-- [Building Isomorphic Univer](../ISOMORPHIC.md):如何拆分浏览器、Node.js、UI 与共享插件逻辑。
-- [API 稳定性政策](../API_STABILITY.md):stable、experimental、internal、deprecated 和破坏性变更预期。
-- [Contributing to Facade API](../CONTRIBUTING-FACADE.md):`FUniver`、`FWorkbook`、`FRange` 等 Facade API 的设计约定。
-- [Naming Convention](../NAMING_CONVENTION.md):文件、目录、接口、插件、命令和依赖注入 token 的命名规则。
-- [Fixing Memory Leaks](../FIX_MEMORY_LEAK.md):Univer 实例常见内存泄漏模式和调试流程。
-- [Architecture TLDRs](../tldr):公式引擎、Web Worker、权限、选择区和 ref-range 行为的简明说明。
+<a id="community"></a>
## 💬 社区
-- 在 [GitHub Discussions](https://github.com/dream-num/univer/discussions) 提问。
-- 加入 [Discord](https://discord.gg/z3NKNT6D2f) 与社区交流。
-- 关注 [Twitter / X](https://twitter.com/univerhq) 和 [YouTube](https://www.youtube.com/@dreamNum)。
+在 [GitHub Discussions](https://github.com/dream-num/univer/discussions) 提问,加入 [Discord](https://discord.gg/z3NKNT6D2f),并关注 [X](https://twitter.com/univerhq) 或 [YouTube](https://www.youtube.com/@dreamNum)。请阅读[行为准则](../../CODE_OF_CONDUCT.md)。
微信扫码加入 Univer 交流群:
![Univer 微信交流群二维码](../img/wechat-group-qr.png)
-参与社区前,请阅读 [行为准则](../../CODE_OF_CONDUCT.md)。
+<p align="right"><a href="#readme-top"><img src="https://img.shields.io/badge/%E2%86%91%20%E8%BF%94%E5%9B%9E%E9%A1%B6%E9%83%A8-30363D?style=flat-square" alt="返回顶部" height="20" /></a></p>
+
+<a id="security"></a>
## 🔒 安全
如果你认为发现了安全问题,请遵循 [安全政策](../../SECURITY.md)。
+<p align="right"><a href="#readme-top"><img src="https://img.shields.io/badge/%E2%86%91%20%E8%BF%94%E5%9B%9E%E9%A1%B6%E9%83%A8-30363D?style=flat-square" alt="返回顶部" height="20" /></a></p>
+
+<a id="sponsors"></a>
+
## ❤️ 赞助
Univer 由社区和赞助者共同支持。你可以通过 [Open Collective](https://opencollective.com/univer) 支持这个项目。
-<a href="https://opencollective.com/univer/sponsor/0/website"><img src="https://opencollective.com/univer/sponsor/0/avatar.svg" alt="Sponsor 0" /></a>
-<a href="https://opencollective.com/univer/sponsor/1/website"><img src="https://opencollective.com/univer/sponsor/1/avatar.svg" alt="Sponsor 1" /></a>
-<a href="https://opencollective.com/univer/sponsor/2/website"><img src="https://opencollective.com/univer/sponsor/2/avatar.svg" alt="Sponsor 2" /></a>
-<a href="https://opencollective.com/univer/sponsor/3/website"><img src="https://opencollective.com/univer/sponsor/3/avatar.svg" alt="Sponsor 3" /></a>
-<a href="https://opencollective.com/univer/sponsor/4/website"><img src="https://opencollective.com/univer/sponsor/4/avatar.svg" alt="Sponsor 4" /></a>
-<a href="https://opencollective.com/univer/sponsor/5/website"><img src="https://opencollective.com/univer/sponsor/5/avatar.svg" alt="Sponsor 5" /></a>
-<a href="https://opencollective.com/univer/sponsor/6/website"><img src="https://opencollective.com/univer/sponsor/6/avatar.svg" alt="Sponsor 6" /></a>
-
-<a href="https://opencollective.com/univer/backer/0/website"><img src="https://opencollective.com/univer/backer/0/avatar.svg" alt="Backer 0" /></a>
-<a href="https://opencollective.com/univer/backer/1/website"><img src="https://opencollective.com/univer/backer/1/avatar.svg" alt="Backer 1" /></a>
-<a href="https://opencollective.com/univer/backer/2/website"><img src="https://opencollective.com/univer/backer/2/avatar.svg" alt="Backer 2" /></a>
-<a href="https://opencollective.com/univer/backer/3/website"><img src="https://opencollective.com/univer/backer/3/avatar.svg" alt="Backer 3" /></a>
-<a href="https://opencollective.com/univer/backer/4/website"><img src="https://opencollective.com/univer/backer/4/avatar.svg" alt="Backer 4" /></a>
-<a href="https://opencollective.com/univer/backer/5/website"><img src="https://opencollective.com/univer/backer/5/avatar.svg" alt="Backer 5" /></a>
-<a href="https://opencollective.com/univer/backer/6/website"><img src="https://opencollective.com/univer/backer/6/avatar.svg" alt="Backer 6" /></a>
+<p>
+ <a href="https://opencollective.com/univer/sponsor/0/website"><img src="https://opencollective.com/univer/sponsor/0/avatar.svg" alt="成为赞助者" /></a>
+</p>
+
+<p>
+ <a href="https://opencollective.com/univer/backer/0/website"><img src="https://opencollective.com/univer/backer/0/avatar.svg" width="64" height="64" alt="Backer 0" /></a>
+ <a href="https://opencollective.com/univer/backer/1/website"><img src="https://opencollective.com/univer/backer/1/avatar.svg" width="64" height="64" alt="Backer 1" /></a>
+ <a href="https://opencollective.com/univer/backer/2/website"><img src="https://opencollective.com/univer/backer/2/avatar.svg" width="64" height="64" alt="Backer 2" /></a>
+ <a href="https://opencollective.com/univer/backer/3/website"><img src="https://opencollective.com/univer/backer/3/avatar.svg" width="64" height="64" alt="Backer 3" /></a>
+ <a href="https://opencollective.com/univer/backer/4/website"><img src="https://opencollective.com/univer/backer/4/avatar.svg" width="64" height="64" alt="Backer 4" /></a>
+ <a href="https://opencollective.com/univer/backer/5/website"><img src="https://opencollective.com/univer/backer/5/avatar.svg" width="64" height="64" alt="Backer 5" /></a>
+ <a href="https://opencollective.com/univer/backer/6/website"><img src="https://opencollective.com/univer/backer/6/avatar.svg" width="64" height="64" alt="Backer 6" /></a>
+</p>
+
+<p align="right"><a href="#readme-top"><img src="https://img.shields.io/badge/%E2%86%91%20%E8%BF%94%E5%9B%9E%E9%A1%B6%E9%83%A8-30363D?style=flat-square" alt="返回顶部" height="20" /></a></p>
+
+<a id="license"></a>
## 📄 许可证
-版权所有 (c) 2021-present DreamNum Co., Ltd.
+Copyright (c) 2021-present DreamNum Co., Ltd.
+
+本仓库的开源包采用 [Apache-2.0](../../LICENSE) 许可证。商业 SDK 模块单独分发和授权。
-基于 [Apache-2.0](../../LICENSE) 许可证开源。
+<p align="right"><a href="#readme-top"><img src="https://img.shields.io/badge/%E2%86%91%20%E8%BF%94%E5%9B%9E%E9%A1%B6%E9%83%A8-30363D?style=flat-square" alt="返回顶部" height="20" /></a></p>
diff --git a/docs/readme/zh-TW.md b/docs/readme/zh-TW.md
index 939047325d..835bb485e2 100644
--- a/docs/readme/zh-TW.md
+++ b/docs/readme/zh-TW.md
@@ -1,156 +1,296 @@
-<div align="center">
+<a id="readme-top"></a>
-<img src="../img/banner.png" alt="Univer SDK" width="800" />
+<p align="center"><img src="../../docs/img/readme/hero-banner.png" alt="Univer Office SDK" width="960" /></p>
-**面向 AI Agent 的 Office Harness**
+<h1 align="center">用 Univer Office SDK 建置你的 AI 辦公產品</h1>
-試算表 · 文件 · 簡報 · Bases · Boards · PDF
+<p align="center">從開源的 Sheets 和 Docs 開始,再連線你自己的應用或 Agent。</p>
-高效能、可完全自訂的 Office SDK
+<p align="center"><a href="#quick-start">🚀 快速開始</a> · <a href="https://docs.univer.ai/">📚 開發文件</a> · <a href="https://univer.ai/compare/">⚖️ 功能對比</a> · <a href="https://univer.ai/">🌐 官網</a> · <a href="https://docs.univer.ai/showcase">🎮 示例</a> · <a href="https://docs.univer.ai/reference/classes/univer">🔧 API 參考</a> · <a href="https://docs.univer.ai/blog">📝 部落格</a></p>
-Univer 以外掛化架構、Canvas 渲染引擎、公式引擎和統一的 Facade API,
-協助你在瀏覽器和 Node.js 中構建可嵌入的生產力體驗。
+<p align="center"><a href="../../README.md">English</a> · <a href="../../docs/readme/fr-FR.md">Français</a> · <a href="../../docs/readme/de-DE.md">Deutsch</a> · <a href="../../docs/readme/es-ES.md">Español</a> · <a href="../../docs/readme/zh-CN.md">简体中文</a> · <strong>繁體中文</strong> · <a href="../../docs/readme/ja-JP.md">日本語</a> · <a href="../../docs/readme/ko-KR.md">한국어</a></p>
-[English](../../README.md) | [简体中文](./zh-CN.md) | 繁體中文 | [日本語](./ja-JP.md) | [한국어](./ko-KR.md) | [Español](./es-ES.md)
+<p align="center">
+ <a href="https://github.com/dream-num/univer/releases"><img src="https://img.shields.io/github/v/release/dream-num/univer?style=flat&amp;labelColor=30363D&amp;color=4F46E5&amp;logo=github&amp;logoColor=white" alt="Release" /></a>
+ <a href="../../LICENSE"><img src="https://img.shields.io/github/license/dream-num/univer?style=flat&amp;labelColor=30363D&amp;color=0F766E" alt="License" /></a>
+ <a href="https://github.com/dream-num/univer/actions/workflows/build-packages.yml"><img src="https://img.shields.io/github/actions/workflow/status/dream-num/univer/build-packages.yml?style=flat&amp;labelColor=30363D" alt="Build" /></a>
+ <a href="https://www.codefactor.io/repository/github/dream-num/univer/overview/dev"><img src="https://www.codefactor.io/repository/github/dream-num/univer/badge/dev?style=flat" alt="CodeFactor" /></a>
+ <a href="https://codecov.io/gh/dream-num/univer"><img src="https://img.shields.io/codecov/c/gh/dream-num/univer?token=aPfyW2pIMN&amp;style=flat&amp;labelColor=30363D" alt="Codecov" /></a>
+</p>
-[🌐 官方網站](https://univer.ai/) | [📖 文件](https://docs.univer.ai) | [✨ 示例](https://docs.univer.ai/showcase) | [📘 API 參考](https://docs.univer.ai/reference/classes/univer) | [📝 部落格](https://docs.univer.ai/blog)
+<p align="center">
+ <a href="https://github.com/dream-num/univer"><img src="https://img.shields.io/github/stars/dream-num/univer?style=flat&amp;labelColor=30363D&amp;color=4F46E5" alt="Stars" /></a>
+ <a href="https://github.com/dream-num/univer/graphs/contributors"><img src="https://img.shields.io/github/contributors/dream-num/univer?style=flat&amp;labelColor=30363D&amp;color=4F46E5" alt="Contributors" /></a>
+ <a href="https://github.com/dream-num/univer/issues"><img src="https://img.shields.io/github/issues/dream-num/univer?style=flat&amp;labelColor=30363D&amp;color=4F46E5" alt="Issues" /></a>
+ <a href="https://github.com/dream-num/univer/commits/dev/"><img src="https://img.shields.io/github/last-commit/dream-num/univer?style=flat&amp;labelColor=30363D&amp;color=4F46E5" alt="Last Commit" /></a>
+</p>
-[![Release](https://img.shields.io/github/v/release/dream-num/univer?style=flat-square)](https://github.com/dream-num/univer/releases)
-[![License](https://img.shields.io/github/license/dream-num/univer?style=flat-square)](../../LICENSE)
-[![Build](https://img.shields.io/github/actions/workflow/status/dream-num/univer/build-packages.yml?style=flat-square)](https://github.com/dream-num/univer/actions/workflows/build-packages.yml)
-[![CodeFactor](https://www.codefactor.io/repository/github/dream-num/univer/badge/dev?style=flat-square)](https://www.codefactor.io/repository/github/dream-num/univer/overview/dev)
-[![Codecov](https://img.shields.io/codecov/c/gh/dream-num/univer?token=aPfyW2pIMN&style=flat-square)](https://codecov.io/gh/dream-num/univer)
+<p align="center">
+ <a href="https://discord.gg/z3NKNT6D2f"><img src="https://img.shields.io/discord/1136129819961217077?logo=discord&amp;logoColor=FFFFFF&amp;label=discord&amp;color=5865F2&amp;style=flat&amp;labelColor=30363D" alt="Discord" /></a>
+ <a href="https://twitter.com/univerhq"><img src="https://img.shields.io/badge/%40univerhq-18181B?style=flat&amp;logo=x&amp;logoColor=white" alt="X: @univerhq" /></a>
+ <a href="https://opencollective.com/univer"><img src="https://img.shields.io/opencollective/all/univer?logo=opencollective&amp;style=flat&amp;labelColor=30363D&amp;color=0F766E&amp;label=supporters&amp;logoColor=white" alt="Open Collective" /></a>
+</p>
-[![Stars](https://img.shields.io/github/stars/dream-num/univer?style=flat-square)](https://github.com/dream-num/univer/stargazers)
-[![Contributors](https://img.shields.io/github/contributors/dream-num/univer?style=flat-square)](https://github.com/dream-num/univer/graphs/contributors)
-[![Issues](https://img.shields.io/github/issues/dream-num/univer?style=flat-square)](https://github.com/dream-num/univer/issues)
-[![Last Commit](https://img.shields.io/github/last-commit/dream-num/univer?style=flat-square)](https://github.com/dream-num/univer/commits/dev/)
+<p align="center">
+ <a href="https://trendshift.io/repositories/4376"><img src="https://trendshift.io/api/badge/repositories/4376" alt="Trendshift" /></a>
+</p>
-[![Discord](https://img.shields.io/discord/1136129819961217077?logo=discord&logoColor=FFFFFF&label=discord&color=5865F2&style=flat-square)](https://discord.gg/z3NKNT6D2f)
-[![Twitter](https://img.shields.io/twitter/follow/univerhq?style=flat-square&logo=x)](https://twitter.com/univerhq)
-[![Open Collective](https://img.shields.io/opencollective/all/univer?logo=opencollective&style=flat-square)](https://opencollective.com/univer)
+<details>
+<summary>目錄</summary>
+
+- [💡 Univer 是什麼?](#what-is-univer)
+ - [開源能力](#open-source-capabilities)
+- [🚀 基於開源基礎建置](#what-you-can-build)
+ - [快速開始:開源試算表編輯器](#quick-start)
+ - [將應用連線到可編輯內容](#connect-your-application-to-editable-content)
+- [🏗️ 探索開源架構](#open-source-architecture)
+ - [為自訂功能劃分清晰邊界](#give-custom-features-clear-boundaries)
+ - [組合跨功能編輯與復原/取消復原](#compose-cross-feature-edits-and-undoredo)
+ - [透過 Facade API 和事件連線應用與 Agent](#connect-applications-and-agents-through-facade-apis-and-events)
+- [🧩 使用 Univer Office SDK 擴展應用](#open-source-and-commercial-extensions)
+ - [範圍與授權](#scope-and-licensing)
+- [🌐 應用模式與生態](#application-patterns-and-ecosystem)
+ - [Univer Workspace:Office SDK 參考應用](#univer-workspace-an-office-sdk-reference-application)
+ - [CLI、Agent 整合與開發技能](#cli-agent-integrations-and-developer-skills)
+- [📚 文件與貢獻](#documentation-and-contributing)
+ - [執行環境相容性](#runtime-compatibility)
+- [💬 社區](#community)
+- [🔒 安全](#security)
+- [❤️ 贊助](#sponsors)
+- [📄 授權條款](#license)
+
+</details>
+
+<a id="what-is-univer"></a>
+
+## 💡 Univer 是什麼?
+
+<p align="center"><img src="../../docs/img/readme/intro-banner.png" alt="Univer Office SDK: Web, Server, and AI SDKs" width="960" /></p>
+
+**Univer** 是一套 Office SDK,用於在你自己的產品中建置辦公應用。它基於你的資料和權限,為使用者和現有 Agent 提供辦公編輯、計算、協作及檔案處理能力。產品系列覆蓋試算表、文件、示範文稿、關聯表格、畫布和 PDF。
+
+Univer Office SDK 由三部分組成:
+
+- **Web SDK** 是基礎,包含內容模型、編輯、渲染、公式計算和 Facade API(面向應用的 API)。透過組合外掛,可以建置嵌入式編輯器或自己的辦公應用,也可以在沒有互動式編輯器的情況下,重用內容模型、命令和計算能力進行 Headless 處理。
+- **Server SDK** 提供即時協作、編輯歷史和辦公檔案匯入匯出的後端服務。
+- **AI SDK** 透過內容工具、執行和審閱整合,將辦公能力連線到現有 Agent 和工作流程。
+
+**本倉庫以 Apache-2.0 授權條款提供 Web SDK 的核心架構和引擎實現**,包括內容模型與快照格式、外掛與依賴管理、命令系統、公式與渲染引擎、Facade API、UI 基礎設施,以及 Sheets 和 Docs 編輯能力。商業 Web SDK 外掛、Server SDK 和商業 AI SDK 擴展單獨散布和授權。
+
+Agent 可以使用同樣的開源 API,模型和工具編排由你的應用提供。[報價單範例](#connect-your-application-to-editable-content)展示了不依賴 AI SDK 的編輯、計算和保存流程。
+
+<a id="open-source-capabilities"></a>
+
+### 開源能力
-[![Trendshift](https://trendshift.io/api/badge/repositories/4376)](https://trendshift.io/repositories/4376)
+<div align="center" style="overflow-x: auto;">
+
+<table align="center" style="display: table; width: auto; margin-left: auto; margin-right: auto;">
+<thead>
+<tr>
+<th>領域</th>
+<th>部分能力</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td><strong>Sheets · 編輯與佈局</strong></td>
+<td>儲存格樣式、合併儲存格、儲存格內富文字、凍結窗格、浮動圖片,以及復原/取消復原。</td>
+</tr>
+<tr>
+<td><strong>Sheets · 資料與計算</strong></td>
+<td>公式、定義名稱、篩選、排序、資料驗證、條件格式、超連結、評論,以及查找替換。</td>
+</tr>
+<tr>
+<td><strong>Docs</strong></td>
+<td>富文字編輯、段落格式、列表、超連結、評論和繪圖整合。</td>
+</tr>
+</tbody>
+</table>
</div>
-## ✨ Univer 是什麼?
+功能透過外掛和預設組合;[快速開始](#quick-start)僅使用 **Sheets Core 預設**。圖片需要相應的繪圖外掛。詳細的開源和商業能力範圍請參閱[功能對比](https://univer.ai/compare/)。
+
+以下示範展示更完整的 **Univer Office SDK**,包括商業能力,其範圍超出預設開源設定;具體請參閱[開源與商業擴展](#open-source-and-commercial-extensions)。
+
+<div align="center" style="overflow-x: auto;">
+
+<table align="center" style="display: table; width: auto; margin-left: auto; margin-right: auto;">
+<tbody>
+<tr>
+ <td width="50%"><a href="https://univer.ai/demo/spreadsheets"><img src="../../docs/img/readme/cards/sheets.webp" alt="Sheets — 編輯與佈局 · 資料與計算 — 開啟示範" width="420" /></a></td>
+ <td width="50%"><a href="https://univer.ai/demo/docs"><img src="../../docs/img/readme/cards/docs.webp" alt="Docs — 富文字編輯 — 開啟示範" width="420" /></a></td>
+</tr>
+<tr>
+ <td width="50%"><a href="https://univer.ai/demo/web-app"><img src="../../docs/img/readme/cards/web-app.webp" alt="Web App — 由表格驅動的應用 — 開啟示範" width="420" /></a></td>
+ <td width="50%"><a href="https://univer.ai/demo/universe"><img src="../../docs/img/readme/cards/universe.webp" alt="Univer — 組合式辦公內容 — 開啟示範" width="420" /></a></td>
+</tr>
+<tr>
+ <td width="50%"><a href="https://univer.ai/demo/slides"><img src="../../docs/img/readme/cards/slides.webp" alt="Slides — 開啟示範" width="420" /></a></td>
+ <td width="50%"><a href="https://univer.ai/demo/relational-tables"><img src="../../docs/img/readme/cards/relational-tables.webp" alt="Relational Tables — 開啟示範" width="420" /></a></td>
+</tr>
+<tr>
+ <td width="50%"><a href="https://univer.ai/demo/canvases"><img src="../../docs/img/readme/cards/canvases.webp" alt="Canvases — 開啟示範" width="420" /></a></td>
+ <td width="50%"><a href="https://univer.ai/demo/pdf"><img src="../../docs/img/readme/cards/pdf.webp" alt="PDF — 開啟示範" width="420" /></a></td>
+</tr>
+</tbody>
+</table>
-Univer 是一個開源 SDK,用於在你的產品中建立辦公應用。它提供試算表、文件和簡報體驗所需的基礎能力,同時不強制你使用託管應用或固定 UI。
+</div>
-當你需要以下能力時,可以使用 Univer:
+<p align="right"><a href="#readme-top"><img src="https://img.shields.io/badge/%E2%86%91%20%E8%BF%94%E5%9B%9E%E9%A0%82%E9%83%A8-30363D?style=flat-square" alt="返回頂部" height="20" /></a></p>
+
+<a id="what-you-can-build"></a>
+
+## 🚀 基於開源基礎建置
+
+<p align="center"><img src="../../docs/img/readme/build-banner.png" alt="Build on open source" width="960" /></p>
+
+<div align="center" style="overflow-x: auto;">
+
+<table align="center" style="display: table; width: auto; margin-left: auto; margin-right: auto;">
+<thead>
+<tr>
+<th>你的目標</th>
+<th>使用開源基礎</th>
+<th>從這裡開始</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td><strong>嵌入 Sheets 或 Docs</strong></td>
+<td>為應用或 Agent 產品新增可編輯的辦公界面,並透過 Facade API 連線資料。</td>
+<td><a href="#quick-start">快速開始</a></td>
+</tr>
+<tr>
+<td><strong>在沒有編輯器的情況下處理內容</strong></td>
+<td>在 Node.js 中重用內容外掛、模型、命令和計算能力,用於編輯、快照和自動化任務。</td>
+<td><a href="https://docs.univer.ai/guides/sheets/getting-started/node">Headless 指南</a></td>
+</tr>
+<tr>
+<td><strong>開發自訂功能或編輯器</strong></td>
+<td>重用引擎、UI 元件、外掛邊界、依賴注入及命令/復原系統。參考現有功能擴展 Sheets 和 Docs,或開發自己的編輯器。</td>
+<td><a href="#open-source-architecture">開源架構</a></td>
+</tr>
+</tbody>
+</table>
-- 將試算表或文件編輯能力嵌入 SaaS 產品、內部工具、BI 流程或 AI 應用。
-- 在伺服器端執行活頁簿/文件處理邏輯,並與瀏覽器端使用同一套架構。
-- 透過外掛按需組合功能,或透過預設快速啟動。
-- 透過自訂外掛、命令、服務、UI 元件和 Facade API 擴充行為。
+</div>
-Univer 不只是一個試算表檔案檢視器。它是用於構建你自己的生產力介面的框架。
+**協調跨功能的編輯與復原/取消復原。** 在篩選範圍內插入一行,會同時改變基礎內容和篩選範圍,復原時也需要同時恢復兩者。各功能提供自己的變更和復原資料,由命令組合執行並記錄歷史。架構介紹會說明如何擴展這些編輯流程。
-在 [Univer 產品家族](https://univer.ai/)中,辦公工具共用儲存與運算執行環境。不同工具的內容可以自由組合和嵌入,關聯資料與引用隨來源同步更新,人與 AI Agent 可以在同一檔案中協作。產品能力請參閱[功能矩陣](https://univer.ai/capabilities),本倉庫的範圍請參閱[開源與 Pro](#-開源與-pro)。
+<a id="quick-start"></a>
-### 使用 Univer Office SDK 建立協作工具
+### 快速開始:開源試算表編輯器
-[![使用 Univer Office SDK 建立協作工具](https://i.ytimg.com/vi/1p-SMEiK6Kg/maxresdefault.jpg)](https://www.youtube.com/watch?v=1p-SMEiK6Kg)
+在使用 Vite 等建置工具的瀏覽器應用中:
-[觀看示範](https://www.youtube.com/watch?v=1p-SMEiK6Kg)
+```bash
+pnpm add @univerjs/presets @univerjs/preset-sheets-core
+```
-## 以 Univer Office SDK 構建
+初始化 Univer 前,先建立容器:
-### 重點案例:Univer Workspace
+```html
+<div id="app" style="height: 100vh"></div>
+```
-[Univer Workspace](https://github.com/dream-num/univer-workspace) 是以 Univer Office SDK 建立、支援自行部署的開源工作空間,人與 AI Agent 可以在其中建立、協作處理和審閱辦公內容。開發者可以參考完整實作,學習如何整合 SDK,並建立自己的產品。
+```ts
+import { UniverSheetsCorePreset } from '@univerjs/preset-sheets-core'
+import UniverPresetSheetsCoreEnUS from '@univerjs/preset-sheets-core/locales/en-US'
+import { createUniver, LocaleType, mergeLocales } from '@univerjs/presets'
+import '@univerjs/preset-sheets-core/lib/index.css'
-[![Workspace Mini App 與其關聯的試算表並排顯示,指標、圖表和控制項綁定至儲存格](../img/workspace-mini-app.png)](https://github.com/dream-num/univer-workspace)
+const { univerAPI } = createUniver({
+ locale: LocaleType.EN_US,
+ locales: {
+ [LocaleType.EN_US]: mergeLocales(UniverPresetSheetsCoreEnUS),
+ },
+ presets: [
+ UniverSheetsCorePreset({
+ container: 'app',
+ }),
+ ],
+})
-- Agent 可以產生以試算表為基礎的 Mini App,例如決策儀表板、互動式報告和業務儀表板。
-- 網頁上的指標、圖表和控制項與儲存格綁定,支援資料讀取、寫入和協同更新。
+univerAPI.createWorkbook({})
+```
-[探索 Univer Workspace](https://github.com/dream-num/univer-workspace)
+現在,頁面中已經有了試算表編輯器。使用傳回的 `univerAPI` 操作其內容。本範例使用開源套件,無需商業 Univer 授權條款或 Server SDK。
-### 其他案例
+對於元件框架,請保留 `createUniver` 傳回的 `univer` 執行個體,並在元件卸載時呼叫 `univer.dispose()`。參閱[生命週期指南](https://docs.univer.ai/guides/sheets/getting-started/lifecycle)。
-以下開源專案以 Univer Office SDK 構建:
+預設會組合外掛並註冊其 Facade API。如需手動控制,請參閱下方的[外掛模式範例](#manual-plugin-composition)。[安裝指南](https://docs.univer.ai/guides/sheets/getting-started/installation)涵蓋兩種模式、對等依賴和框架整合。
-| 專案 | 說明 |
-| --- | --- |
-| [Univer Office for DeepSeek Harness](https://github.com/dream-num/dsh-univer-office) | 面向 DeepSeek Harness 的辦公外掛,支援關聯內容、驗證和用於 Agent 協作的獨立 Worktree。 |
-| [Univer CLI](https://github.com/dream-num/univer-cli) | 供 Agent 建立、編輯、檢查和交付辦公內容的本機命令列工作空間。 |
-| [Univer Office for WorkBuddy](https://github.com/dream-num/workbuddy-univer-office) | 面向 WorkBuddy 的本機辦公整合,支援 MCP 預覽和草稿審閱。目前為開發預覽版。 |
-| [Univer Office for OpenClaw](https://github.com/dream-num/openclaw-univer-office) | 在 OpenClaw 中建立、審閱和交付辦公內容的工具。 |
+需要配套使用的 `@univerjs/*` 套件應保持同一版本。商業套件必須匹配相應的發佈系列;圖示等獨立發佈的套件遵循各自聲明的相容性。參閱 [API 穩定性策略](../../docs/API_STABILITY.md)。
-各專案分別說明其安裝方式和 SDK 授權要求。
+<a id="connect-your-application-to-editable-content"></a>
-## 🌟 Highlights
+### 將應用連線到可編輯內容
-<table>
- <tr>
- <td align="center" width="33%">
- ⚡<br />
- <strong>大型場景也流暢</strong><br />
- <sub>Canvas 渲染搭配獨立公式引擎,複雜活頁簿依然流暢。</sub>
- </td>
- <td align="center" width="33%">
- 🧩<br />
- <strong>外掛化擴充</strong><br />
- <sub>需要哪些功能就組合、替換或按需載入,不必引入全套。</sub>
- </td>
- <td align="center" width="33%">
- 🤖<br />
- <strong>Headless AI 基建</strong><br />
- <sub>在 Node.js 中跑活頁簿與文件邏輯,支撐 Agent、自動化和伺服器端流程。</sub>
- </td>
- </tr>
- <tr>
- <td align="center" width="33%">
- 🛠️<br />
- <strong>面向產品整合</strong><br />
- <sub>框架適配器、Facade API、預設配置、無頭執行環境,對接各種實際整合場景。</sub>
- </td>
- <td align="center" width="33%">
- 🌗<br />
- <strong>Dark mode 就緒</strong><br />
- <sub>UI 元件與渲染引擎均支援淺色和深色主題。</sub>
- </td>
- <td align="center" width="33%">
- 🔌<br />
- <strong>統一的 Facade API</strong><br />
- <sub>共享一致的 API,在瀏覽器和 Node.js 中操作活頁簿、範圍、公式和文件。</sub>
- </td>
- </tr>
-</table>
+Facade API 是面向應用的活頁簿、工作表和範圍介面。繼續快速開始的範例,填入報價單,從應用程式碼更新數量,並讀取重新計算後的總額:
-## 🚀 為什麼選擇 Univer?
+```ts
+// Wait for formula controllers before editing a newly created workbook.
+await new Promise<void>((resolve) => {
+ if (univerAPI.getCurrentLifecycleStage() >= univerAPI.Enum.LifecycleStages.Steady) {
+ resolve()
+ return
+ }
+ const listener = univerAPI.addEvent(univerAPI.Event.LifeCycleChanged, ({ stage }) => {
+ if (stage === univerAPI.Enum.LifecycleStages.Steady) {
+ listener.dispose()
+ resolve()
+ }
+ })
+})
-- **同構設計**:既可以在瀏覽器中執行 UI 應用,也可以在 Node.js 中執行無頭處理邏輯。
-- **外掛優先架構**:每個能力都以可組合外掛的形式提供,功能可以新增、移除、替換或延遲載入。
-- **Preset Mode 便於快速整合**:當你希望快速取得可執行應用時,可以使用本倉庫 [`presets/`](../../presets) 中的預設外掛集合。
-- **Plugin Mode 提供完整控制**:當你需要自訂載入、更小包體或深度整合時,可以手動組合套件和外掛。
-- **Facade API**:透過更高層 API 操作活頁簿、工作表、範圍、文件、公式、命令和事件。
-- **Canvas 渲染引擎**:支援大型可編輯文件介面,並在多種文件類型之間共用渲染層。
-- **可擴充 UI**:支援 React、Vue、Web Components 和不同框架下的應用外殼整合。
+const workbook = univerAPI.getActiveWorkbook()!
+const sheet = workbook.getActiveSheet()
-## 🤖 面向 AI Agent 的辦公工作流程
+sheet.getRange('A1:D4').setValues([
+ ['Item', 'Quantity', 'Unit price', 'Amount'],
+ ['Seats', 2, 25, '=B2*C2'],
+ ['Support', 1, 100, '=B3*C3'],
+ ['Total', '', '', '=SUM(D2:D3)'],
+])
-Univer 的 AI 與協作能力將 Agent 操作、互動式編輯和人工審閱連接起來:
+// An application control or agent can make the same edit.
+sheet.getRange('B2').setValue(4)
-- **程式化編輯**:Agent 透過結構化 API 檢查和修改辦公內容。
-- **結果驗證**:Agent 透過內容檢查、渲染截圖和版面配置診斷驗證結果。
-- **Worktree 協作**:Agent 在獨立草稿中工作,由人審閱修改並決定合併內容。
+univerAPI.getFormula().onCalculationResultApplied().then(() => {
+ console.log(sheet.getRange('D4').getValue()) // 200
+ localStorage.setItem('quotation', JSON.stringify(workbook.save()))
+}).catch(console.error)
+```
-整合詳情請參閱 [AI SDK 文件](https://docs.univer.ai/ai)。即時編輯、共用版本和 Worktree 工作流程需要相應的 Web SDK 與協作能力;不同功能所需的套件和授權有所區別。
+編輯器與應用操作同一份活頁簿,公式變更會自動重新計算。`workbook.save()` 傳回包含活頁簿及已註冊外掛資料的 JSON 快照。持久化由你的應用負責,本範例使用瀏覽器儲存。之後再次載入頁面時,在初始化後恢復快照,**而不是建立空白活頁簿**:
-## ⚡ 快速開始
+```ts
+const saved = localStorage.getItem('quotation')
+if (saved) {
+ univerAPI.createWorkbook(JSON.parse(saved))
+}
+```
+
+此流程僅使用開源套件。快照持久化與 XLSX 匯入匯出是不同的能力,後者需要單獨散布的檔案轉換能力。應用整合應使用公開的 Facade API;下方原始碼連結說明內部實現和擴展點。依賴擴展點前,請參閱 [API 穩定性策略](../../docs/API_STABILITY.md)。
-使用 **Plugin Mode** 可以取得完整的產品能力覆蓋並精確控制組合方式。對於支援的 Sheets、Docs 和 Node 設定,**Preset Mode** 提供了更精簡的預設方案。
+<a id="manual-plugin-composition"></a>
-<details open>
-<summary><strong>Plugin Mode</strong></summary>
+<details>
+<summary>進階:手動組合外掛(外掛模式)</summary>
+
+當你需要精確控制外掛選擇、依賴或載入方式時,可以使用外掛模式。上方的預設會代你完成這些組合工作。
-Plugin Mode 讓你更底層地控制套件、樣式匯入、locale 合併、Facade API 註冊和外掛設定。
+這套替代初始化方式使用相同的 `app` 容器和 Sheets Core 預設的瀏覽器外掛棧,不使用 Worker。請用它**替代**預設初始化,然後使用傳回的 `univerAPI` 執行同一份報價單範例。
```bash
-pnpm add @univerjs/core @univerjs/design @univerjs/docs @univerjs/docs-ui @univerjs/engine-formula @univerjs/engine-render @univerjs/sheets @univerjs/sheets-formula @univerjs/sheets-formula-ui @univerjs/sheets-numfmt @univerjs/sheets-numfmt-ui @univerjs/sheets-ui @univerjs/ui
+pnpm add @univerjs/core @univerjs/design @univerjs/docs @univerjs/docs-ui \
+ @univerjs/engine-formula @univerjs/engine-render @univerjs/network \
+ @univerjs/sheets @univerjs/sheets-ui @univerjs/sheets-formula \
+ @univerjs/sheets-formula-ui @univerjs/sheets-numfmt \
+ @univerjs/sheets-numfmt-ui @univerjs/ui
```
```ts
@@ -161,7 +301,9 @@ import { UniverDocsPlugin } from '@univerjs/docs'
import { UniverDocsUIPlugin } from '@univerjs/docs-ui'
import DocsUIEnUS from '@univerjs/docs-ui/locale/en-US'
import { UniverFormulaEnginePlugin } from '@univerjs/engine-formula'
+import FormulaEnUS from '@univerjs/engine-formula/locale/en-US'
import { UniverRenderEnginePlugin } from '@univerjs/engine-render'
+import { UniverNetworkPlugin } from '@univerjs/network'
import { UniverSheetsPlugin } from '@univerjs/sheets'
import SheetsEnUS from '@univerjs/sheets/locale/en-US'
import { UniverSheetsFormulaPlugin } from '@univerjs/sheets-formula'
@@ -175,185 +317,485 @@ import { UniverSheetsUIPlugin } from '@univerjs/sheets-ui'
import SheetsUIEnUS from '@univerjs/sheets-ui/locale/en-US'
import { UniverUIPlugin } from '@univerjs/ui'
import UIEnUS from '@univerjs/ui/locale/en-US'
-
import '@univerjs/design/lib/index.css'
import '@univerjs/ui/lib/index.css'
import '@univerjs/docs-ui/lib/index.css'
import '@univerjs/sheets-ui/lib/index.css'
import '@univerjs/sheets-formula-ui/lib/index.css'
import '@univerjs/sheets-numfmt-ui/lib/index.css'
-
+import '@univerjs/network/facade'
+import '@univerjs/docs/facade'
+import '@univerjs/docs-ui/facade'
import '@univerjs/engine-formula/facade'
-import '@univerjs/ui/facade'
import '@univerjs/sheets/facade'
+import '@univerjs/ui/facade'
import '@univerjs/sheets-ui/facade'
import '@univerjs/sheets-formula/facade'
import '@univerjs/sheets-numfmt/facade'
+import '@univerjs/sheets-formula-ui/facade'
const univer = new Univer({
locale: LocaleType.EN_US,
locales: {
[LocaleType.EN_US]: mergeLocales(
DesignEnUS,
- UIEnUS,
DocsUIEnUS,
+ FormulaEnUS,
SheetsEnUS,
- SheetsUIEnUS,
SheetsFormulaEnUS,
SheetsFormulaUIEnUS,
SheetsNumfmtUIEnUS,
+ SheetsUIEnUS,
+ UIEnUS,
),
},
})
+univer.registerPlugin(UniverNetworkPlugin)
+univer.registerPlugin(UniverDocsPlugin)
univer.registerPlugin(UniverRenderEnginePlugin)
-univer.registerPlugin(UniverFormulaEnginePlugin)
univer.registerPlugin(UniverUIPlugin, { container: 'app' })
-univer.registerPlugin(UniverDocsPlugin)
univer.registerPlugin(UniverDocsUIPlugin)
-univer.registerPlugin(UniverSheetsPlugin)
-univer.registerPlugin(UniverSheetsUIPlugin)
-univer.registerPlugin(UniverSheetsFormulaPlugin)
-univer.registerPlugin(UniverSheetsFormulaUIPlugin)
+univer.registerPlugin(UniverFormulaEnginePlugin)
+univer.registerPlugin(UniverSheetsPlugin, {
+ onlyRegisterFormulaRelatedMutations: false,
+})
+univer.registerPlugin(UniverSheetsUIPlugin, {
+ protectedRangeShadow: true,
+})
univer.registerPlugin(UniverSheetsNumfmtPlugin)
univer.registerPlugin(UniverSheetsNumfmtUIPlugin)
+univer.registerPlugin(UniverSheetsFormulaPlugin)
+univer.registerPlugin(UniverSheetsFormulaUIPlugin)
const univerAPI = FUniver.newAPI(univer)
univerAPI.createWorkbook({})
```
+Docs 外掛支援試算表中的富文字編輯。新增功能時,請同時引入對應的 Facade 擴展、語言套件和 UI 樣式。容器卸載時應銷毀 `univer`。
+
</details>
-<details>
-<summary><strong>Preset Mode</strong></summary>
+<p align="right"><a href="#readme-top"><img src="https://img.shields.io/badge/%E2%86%91%20%E8%BF%94%E5%9B%9E%E9%A0%82%E9%83%A8-30363D?style=flat-square" alt="返回頂部" height="20" /></a></p>
+
+<a id="open-source-architecture"></a>
+
+## 🏗️ 探索開源架構
+
+<p align="center"><img src="../../docs/img/readme/architecture-banner.png" alt="" width="960" /></p>
+
+<a id="give-custom-features-clear-boundaries"></a>
+
+### 為自訂功能劃分清晰邊界
+
+Univer 使用不同的外掛組織內容邏輯與 UI 互動。功能外掛管理規則和內容變更,UI 外掛提供界面及使用者互動。例如,`sheets-filter` 管理篩選範圍與規則,`sheets-filter-ui` 提供面板、選單和快速鍵。
+
+```mermaid
+%%{init: {'htmlLabels': false, 'theme': 'base', 'themeVariables': {'fontFamily': 'Arial, PingFang SC, Microsoft YaHei, sans-serif', 'fontSize': '17px', 'lineColor': '#64748b'}, 'flowchart': {'htmlLabels': false, 'curve': 'linear', 'nodeSpacing': 28, 'rankSpacing': 45, 'padding': 16, 'wrappingWidth': 270}}}%%
+%% A layered overview, not a complete dependency graph.
+%% Group arrows indicate reuse of the layer below; internal arrows show selected dependencies.
+flowchart TD
+ subgraph FEATURES["Feature Plugins"]
+ direction LR
+ FUI["Filter<br/>UI Plugin"]
+ VUI["Data Validation<br/>UI Plugin"]
+ FILTER["Filter Plugin"]
+ VALIDATION["Data Validation Plugin"]
+ FUI --> FILTER
+ VUI --> VALIDATION
+ end
+
+ subgraph PRODUCTS["Product Plugins"]
+ direction LR
+ SUI["Sheets UI Plugin"]
+ SHEETS["Sheets Plugin"]
+ SUI --> SHEETS
+ end
+
+ subgraph FOUNDATION["Core Framework & Plugins"]
+ direction LR
+ UI["UI Plugin"]
+ FORMULA["Formula Engine Plugin"]
+ RENDER["Render Engine Plugin"]
+ CORE["Core"]
+ UI --> RENDER
+ RENDER --> CORE
+ FORMULA --> CORE
+ end
+
+ FEATURES --> PRODUCTS
+ PRODUCTS --> FOUNDATION
+
+ classDef logic fill:#eff6ff,color:#17365f,stroke:#93b4df,stroke-width:1.5px
+ classDef ui fill:#f0fdf4,color:#17543a,stroke:#91c8a7,stroke-width:1.5px
+ classDef shared fill:#f6f7f9,color:#334155,stroke:#bac3ce,stroke-width:1.5px
+ classDef feature fill:#172d50,color:#ffffff,stroke:#172d50
+ class FUI,VUI ui
+ class FILTER,VALIDATION logic
+ class SUI,SHEETS logic
+ class UI,FORMULA,RENDER,CORE shared
+
+ style FEATURES fill:#f7fcf9,stroke:#b5d8c1,color:#17543a
+ style PRODUCTS fill:#f5f9ff,stroke:#b6cbea,color:#17365f
+ style FOUNDATION fill:#fafbfc,stroke:#cbd2dc,color:#334155
+```
-Preset 是一組經過整理的 Univer 外掛集合,包含所需的 Facade API 註冊和樣式。
+**圖 1:三層外掛結構。** 功能外掛建立在產品外掛之上,產品外掛重用核心框架與外掛。分組箭頭表示對下一層的依賴;Core 提供內容模型、命令、依賴注入和生命週期管理。圖中省略了部分外掛與依賴。
-```bash
-pnpm add @univerjs/presets @univerjs/preset-sheets-core
-```
+新功能將規則保留在自己的外掛中,透過公開服務、命令和明確的擴展點協作。UI 外掛建立在共享的 UI 服務與元件之上。
-```ts
-import { UniverSheetsCorePreset } from '@univerjs/preset-sheets-core'
-import UniverPresetSheetsCoreEnUS from '@univerjs/preset-sheets-core/locales/en-US'
-import { createUniver, LocaleType, mergeLocales } from '@univerjs/presets'
+依賴關係在兩個層面明確聲明:
-import '@univerjs/preset-sheets-core/lib/index.css'
+- **外掛之間:** `DependentOn` 聲明執行時外掛依賴。外掛服務對其排序,生命週期階段將依賴註冊、內容初始化和 UI 初始化分開。
+- **外掛內部:** 依賴注入透過聲明的依賴連線控制器與服務。受支援的覆蓋機制允許應用替換實現、適配平台服務或提供測試替身。執行個體級注入器將不同 Univer 執行個體的應用狀態隔離。
-const { univerAPI } = createUniver({
- locale: LocaleType.EN_US,
- locales: {
- [LocaleType.EN_US]: mergeLocales(UniverPresetSheetsCoreEnUS),
- },
- presets: [
- UniverSheetsCorePreset({
- container: 'app',
- }),
- ],
-})
+可釋放的註冊機制也讓命令、監聽器、元件和圖示在所屬物件銷毀時得到清理。
-univerAPI.createWorkbook({})
+[篩選外掛](../../packages/sheets-filter/src/plugin.ts)及其 [UI 外掛](../../packages/sheets-filter-ui/src/plugin.ts)在實際程式碼中展示了這些邊界。
+
+<details>
+<summary>功能內部:Model、Controller、Service 和 UI 基礎設施</summary>
+
+在篩選功能中,`sheets-filter` 負責內容邏輯,`sheets-filter-ui` 負責 UI 互動,每個模組各司其職。
+
+```mermaid
+%%{init: {'htmlLabels': false, 'theme': 'base', 'themeVariables': {'fontFamily': 'Arial, PingFang SC, Microsoft YaHei, sans-serif', 'fontSize': '17px', 'lineColor': '#64748b'}, 'flowchart': {'htmlLabels': false, 'curve': 'linear', 'nodeSpacing': 28, 'rankSpacing': 45, 'padding': 16, 'wrappingWidth': 270}}}%%
+%% Every arrow means contains. This is code organization, not execution order.
+flowchart LR
+ FEATURE["Filter Feature"]
+ LOGIC["Filter Plugin"]
+ UI["Filter UI Plugin"]
+ MODEL["Model"]
+ SERVICE["Service"]
+ CONTROLLER["Controller"]
+ COMMAND["Command / Mutation"]
+ FACADE["Facade API"]
+ VIEW["View"]
+ UICTRL["UI Controller"]
+ UISERVICE["UI Service"]
+ FEATURE --> LOGIC
+ FEATURE --> UI
+ LOGIC --> MODEL
+ LOGIC --> SERVICE
+ LOGIC --> CONTROLLER
+ LOGIC --> COMMAND
+ LOGIC --> FACADE
+ UI --> VIEW
+ UI --> UICTRL
+ UI --> UISERVICE
+
+ classDef logic fill:#eff6ff,color:#17365f,stroke:#93b4df,stroke-width:1.5px
+ classDef ui fill:#f0fdf4,color:#17543a,stroke:#91c8a7,stroke-width:1.5px
+ classDef shared fill:#f6f7f9,color:#334155,stroke:#bac3ce,stroke-width:1.5px
+ classDef feature fill:#172d50,color:#ffffff,stroke:#172d50
+ class FEATURE feature
+ class LOGIC,MODEL,SERVICE,CONTROLLER,COMMAND,FACADE logic
+ class UI,VIEW,UICTRL,UISERVICE ui
```
+**圖 2:程式碼組織。箭頭表示“包含”。** 兩種外掛都可以包含 Controller 和 Service:邏輯 Controller 協調內容變更與相關功能;UI Controller 連線選單、快速鍵和互動,UI Service 管理面板狀態。這些職責為新功能的實現與測試提供一致的結構。
+
+UI 基礎設施採用相同的職責劃分。**`@univerjs/design`** 提供共享元件和樣式,**`@univerjs/ui`** 提供選單、快速鍵、面板和元件註冊等工作台服務,**`@univerjs/icons`** 提供圖示。功能透過這些擴展點註冊元件和圖示、新增選單並接入渲染。團隊可以在重用應用 UI 基礎設施的同時新增面板或工具欄功能。參閱 [UI 概覽](https://docs.univer.ai/guides/sheets/ui/overview)和篩選外掛的[元件與圖示註冊](../../packages/sheets-filter-ui/src/controllers/components.controller.ts)。
+
</details>
-頁面需要一個容器:
+<a id="compose-cross-feature-edits-and-undoredo"></a>
-```html
-<div id="app" style="height: 100vh"></div>
+### 組合跨功能編輯與復原/取消復原
+
+例如,在篩選範圍內插入行時,篩選外掛提供相應的範圍變更及復原資料。插行命令組合基礎編輯和參與功能的變更,執行它們,並統一記錄復原/取消復原資訊。插行功能可以使用共享的擴展機制,篩選外掛則負責自身的範圍更新規則。
+
+命令系統區分三種操作:
+
+- **Command** 編排業務操作及其所需的變更。
+- **Mutation** 以可序列化參數修改保存在快照中的內容。
+- **Operation** 修改臨時狀態,例如打開的面板或滾動位置。
+
+**統一的復原/取消復原結構。** 對於可復原的編輯,功能實現提供正向 Mutation 和對應的逆向 Mutation,Command 透過 `IUndoRedoService` 記錄它們。當一個操作影響多個功能時,Command 可以將它們的變更與復原資料合併為一條記錄,使使用者能夠完整地復原和取消復原該操作。參閱[擴展命令](https://docs.univer.ai/blog/custom-command)。
+
+功能之間仍然需要協作。**攔截器與引用範圍處理器為這種協作提供明確的位置。** 在受支援的擴展點,外掛提供檢查或相關 Mutation;在 API 定義的範圍內,攔截器優先級控制執行順序。
+
+<details>
+<summary>範例:命令、回呼、功能協作與復原/取消復原</summary>
+
+```mermaid
+%%{init: {'htmlLabels': false, 'theme': 'base', 'themeVariables': {'fontFamily': 'Arial, PingFang SC, Microsoft YaHei, sans-serif', 'fontSize': '17px', 'lineColor': '#64748b'}, 'flowchart': {'htmlLabels': false, 'curve': 'linear', 'nodeSpacing': 28, 'rankSpacing': 45, 'padding': 16, 'wrappingWidth': 270}}}%%
+%% Simplified insert-row example. A command composes mutations and records undo after success.
+%% Events may also fire for nested command executions; not every callback is drawn.
+flowchart TD
+ BEFORE["Before execution<br/>Inspect or cancel"]
+ CMD["Insert-row Command"]
+ BASE["Row mutations"]
+ EXT["Feature extension points<br/>Filter range changes"]
+ MODEL["Execute combined mutations"]
+ UNDO["Record undo and redo"]
+ AFTER["After execution<br/>Notify listeners"]
+ BEFORE --> CMD
+ CMD --> BASE
+ CMD --> EXT
+ BASE --> MODEL
+ EXT --> MODEL
+ MODEL --> UNDO
+ UNDO --> AFTER
+ classDef entry fill:#f6f7f9,color:#334155,stroke:#bac3ce,stroke-width:1.5px
+ classDef core fill:#eff6ff,color:#17365f,stroke:#93b4df,stroke-width:1.5px
+ classDef extension fill:#f0fdf4,color:#17543a,stroke:#91c8a7,stroke-width:1.5px
+ class BEFORE,AFTER entry
+ class CMD,BASE,MODEL,UNDO core
+ class EXT extension
```
-更多內容請閱讀 [安裝與基礎使用指南](https://docs.univer.ai/guides/sheets/getting-started/installation)、[`createUniver` 參考](https://docs.univer.ai/reference/methods/create-univer) 和 [Facade API 參考](https://docs.univer.ai/reference/classes/univer)。
+此圖簡化了插行流程。嵌套命令有各自的執行回呼;圖中未展示全部事件,也未展示獨立的 Operation 路徑。參閱[行命令](../../packages/sheets/src/commands/commands/insert-row-col.command.ts)、[篩選控制器](../../packages/sheets-filter/src/controllers/sheets-filter.controller.ts)和[攔截器服務](../../packages/sheets/src/services/sheet-interceptor/sheet-interceptor.service.ts)。
+
+</details>
+
+這些邊界支援實用的測試策略:獨立測試模型和服務,透過依賴注入替換外部依賴,並為組合操作與復原/取消復原補充回歸用例。[篩選控制器測試](../../packages/sheets-filter/src/controllers/__tests__/sheets-filter.controller.spec.ts)覆蓋行列變更及其對篩選的影響。
+
+<a id="connect-applications-and-agents-through-facade-apis-and-events"></a>
+
+### 透過 Facade API 和事件連線應用與 Agent
+
+本倉庫包含編輯器背後的內容模型、公式引擎,以及 Canvas 渲染與佈局引擎。它們是共享的基礎模組;例如,試算表的富文字會重用文件的佈局和渲染。自訂功能可以基於這些引擎建置,無需另行實現內容技術棧。參閱[公式引擎架構](https://docs.univer.ai/blog/formula)和[渲染引擎架構](https://docs.univer.ai/blog/rendering)。
+
+瀏覽器編輯器、Node.js 中的 Headless 任務,以及合理組合的 Worker,都可以重用相應的內容外掛、模型、命令和計算能力。參閱 [Headless Univer](https://docs.univer.ai/guides/sheets/getting-started/node)和[同構架構](../../docs/ISOMORPHIC.md)。
+
+`ICommandService` 提供執行回呼,使外掛能夠在命令執行前後進行觀察。Facade API 將底層能力封裝為 `FWorkbook`、`FWorksheet` 和 `FRange` 等面向應用的物件。
+
+各外掛提供自己的 Facade 擴展、**透過 `univerAPI.Event` 暴露的具型別的事件**,以及**透過 `univerAPI.Enum` 暴露的列舉**。應用程式碼可以從統一入口查找事件名與常數,無需匯入私有服務或重複編寫字串。例如,`BeforeCommandExecute` 可以檢查並取消執行,`CommandExecuted` 向監聽器報告執行情況。監聽器傳回可釋放物件,取消僅在事件支援時生效。
+
+Facade 擴展隨各自的功能套件提供,因此內容 API 不必引入無關的 UI API。參閱 [Facade 設計](https://docs.univer.ai/blog/facade)、[命令回呼與事件橋接](../../packages/core/src/facade/f-univer.ts)和 [Enum 入口](../../packages/core/src/facade/f-enum.ts)。
+
+本倉庫提供可用的功能實現及擴展模式。完整範例請閱讀[篩選功能實現解析](https://docs.univer.ai/blog/anatomy);依賴擴展點前,請參閱 [API 穩定性策略](../../docs/API_STABILITY.md)。
+
+<p align="right"><a href="#readme-top"><img src="https://img.shields.io/badge/%E2%86%91%20%E8%BF%94%E5%9B%9E%E9%A0%82%E9%83%A8-30363D?style=flat-square" alt="返回頂部" height="20" /></a></p>
+
+<a id="open-source-and-commercial-extensions"></a>
+
+## 🧩 使用 Univer Office SDK 擴展應用
+
+<p align="center"><img src="../../docs/img/readme/sdk-banner.png" alt="" width="960" /></p>
+
+需要更多可直接整合的能力時,可以組合相應的 **Univer Office SDK** 模組,包括更多內容類型、高級編輯外掛、協作、檔案轉換和 Agent 工具。它們擴展上文介紹的同一套內容模型、外掛架構、命令系統和 Facade 設計,因此可以在現有整合之上繼續建置。
+
+<div align="center" style="overflow-x: auto;">
+
+<table align="center" style="display: table; width: auto; margin-left: auto; margin-right: auto;">
+<thead>
+<tr>
+<th>組成</th>
+<th>如何擴展開源基礎</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td><strong>開源 Web SDK 核心 · 本倉庫</strong></td>
+<td>開源的模型、引擎、外掛、UI 基礎設施,以及 Sheets 和 Docs 能力,並提供相應的 Headless 內容操作。可依據 Apache-2.0 授權條款用於商業應用。</td>
+</tr>
+<tr>
+<td><strong>商業 Web SDK 外掛</strong></td>
+<td>遵循核心的 Plugin、依賴注入、Command/Mutation 和 Facade 擴展模式,為相應內容類型新增圖表、形狀、樞紐分析表、SmartArt 等功能。</td>
+</tr>
+<tr>
+<td><strong>Server SDK</strong></td>
+<td>基於相同的內容模型和 Mutation 約定,增加即時協作、版本歷史和辦公檔案轉換,並與應用的身份、權限和儲存系統整合。</td>
+</tr>
+<tr>
+<td><strong>AI SDK 擴展</strong></td>
+<td>重用 Web SDK 的 Headless 與 Facade 能力,提供可組合的 Node.js API 和 CLI 基礎模組,讓 Agent 檢查、編輯和驗證內容,並整合協作與 Worktree 審閱。</td>
+</tr>
+</tbody>
+</table>
+
+</div>
+
+<a id="scope-and-licensing"></a>
+
+### 範圍與授權
+
+- **本倉庫:** 採用 Apache-2.0 授權條款的套件,可依據該授權條款用於商業應用,包括開源的 Headless 內容能力。
+- **商業擴展:** 商業 Web SDK 外掛、Server SDK 及超出開源基礎的 AI SDK 能力單獨散布和授權。**Freemium** 評估包含浮水印和功能限制。
+- **參考應用:** Univer Workspace 等開源應用具有自己的原始碼授權條款,其 SDK 依賴仍遵循各自的授權條款。
+
+詳細覆蓋範圍請查看[功能對比](https://univer.ai/compare/),其中提供 **Open source only(僅開源)** 篩選;商業選項請查看[方案與授權](https://univer.ai/pricing/)。
+
+<details>
+<summary>共享內容模型如何連線編輯、協作與檔案</summary>
+
+這些能力操作可序列化的 **Unit 快照**,包括 Sheets 的 `IWorkbookData`、Docs 的 `IDocumentData`、Slides 的 `ISlideData`,以及畫布的 `IBoardData`(API 中稱為 **Boards**)。這些類型來自 core 和相應產品套件;當前 Slides 和 Boards 能力屬於單獨散布的商業產品。共享的 Unit 約定讓瀏覽器編輯器、後端服務和 Agent 能夠處理同一份內容。
+
+Command 編排編輯,**Mutation 描述內容變更**。協作將 Mutation 打包為 **changeset(變更集)**,透過**操作轉換(OT)**處理併發變更,並管理已確認的版本和快照。歷史功能可以從快照及後續變更集重建某個版本。參閱[協作設計](https://docs.univer.ai/blog/ot)和 [Collaboration SDK 概覽](https://docs.univer.ai/server/collaboration/overview)。
+
+**Exchange** 在辦公檔案結構與 Univer 內容快照之間進行轉換。對於 **XLSX、DOCX 和 PPTX** 等 OOXML 格式,它將檔案解析為對應的 Sheet、Doc 或 Slide 資料,並在匯出時生成檔案表示。轉換後的內容可以進入同樣的編輯、計算、協作和 Agent 工作流程。參閱[辦公檔案匯入匯出](https://docs.univer.ai/server/import-export/node)。
+
+</details>
+
+<details>
+<summary>AI SDK 如何向 Agent 提供相同的內容能力</summary>
-## 🧩 Preset Mode 與 Plugin Mode
+AI SDK 建立在 Web SDK 的 **Headless 內容模型、命令、計算和 Facade API** 之上,提供結構化的 TypeScript API 及可選的 Commander 預設,供應用組合自己的 Office CLI 或 Agent 工具。
-| 選擇 | 適用場景 | 從這裡開始 |
-| --- | --- | --- |
-| **Plugin Mode** | 你需要嚴格控制套件、已設定的依賴、延遲載入或自訂執行時組合。 | 本倉庫的 [`examples/`](../../examples) 和 [架構指南](https://docs.univer.ai/guides/recipes/architecture/univer) |
-| **Preset Mode** | 你希望用最少配置取得可執行的 Sheets、Docs 或 Node 設定。 | 本倉庫的 [`presets/`](../../presets) 和 [快速入門指南](https://docs.univer.ai/guides/sheets/getting-started/installation) |
-| **Headless Mode** | 你需要在沒有 UI 的情況下進行伺服器端活頁簿/文件處理、公式計算或自動化。 | [Headless Univer](https://docs.univer.ai/guides/sheets/getting-started/node) |
+- **理解、發現和編輯。** 檢查會傳回結構化內容。API Reference 幫助 Agent 查找隨 SDK 發佈的 Facade 符號與簽名。Facade 執行區分讀寫模式、捕獲 Mutation,並提供明確的同步和提交結果。參閱[內容操作](https://docs.univer.ai/ai/content-operations)。
+- **檢查渲染結果。** 瀏覽器 Render Runtime 重用 Web SDK 渲染來生成截圖。投影片佈局檢查會傳回文字超出頁面、重疊等問題的結構化結果,為 Agent 的下一輪編輯提供依據。參閱[視覺檢查](https://docs.univer.ai/ai/visual-inspection)。
+- **編輯草稿供人工審閱。** 配合相應的協作和 Web 能力,Agent 可以在隔離的 Worktree 草稿中進行多輪編輯與驗證,再交給使用者審閱、合併或重新打開。流程沿用相同的快照、Mutation 和版本約定。參閱 [Worktree](https://docs.univer.ai/ai/worktree)。
-同一 Univer 協調發布線中的 `@univerjs/*` SDK 套件應保持版本一致。`@univerjs/icons`、`@univerjs/icons-svg` 等獨立發布的套件應使用各套件資訊清單所宣告的相容版本,而不是跟隨 SDK 版本。使用 Univer Pro 時,也請讓 `@univerjs-pro/*` 與對應的協調發布線保持一致。
+對於重複呼叫,可選的 [Worker 池和守護程序](https://docs.univer.ai/ai/runtime-architecture)可以重用已載入的內容執行個體,減少重複初始化。根 CLI、目標、授權和輸出由應用負責。請透過 [AI SDK 套件目錄](https://docs.univer.ai/ai/packages)選擇所需能力。
-關於 API 相容性預期、實驗性 API、內部 API 和棄用規則,請閱讀 [API 穩定性政策](../API_STABILITY.md)。
+</details>
-## 🧭 相容性
+<p align="right"><a href="#readme-top"><img src="https://img.shields.io/badge/%E2%86%91%20%E8%BF%94%E5%9B%9E%E9%A0%82%E9%83%A8-30363D?style=flat-square" alt="返回頂部" height="20" /></a></p>
-- **瀏覽器執行時**:Univer 的編譯目標是 Chrome 88,並盡力支援 Edge `>=88`、Firefox `>=90`、Chrome `>=88`、Safari `>=14.1` 和 Electron `>=12`。
-- **Polyfills**:Univer 依賴 `Intl.Segmenter`。如果目標瀏覽器或執行時不支援,請新增 `@formatjs/intl-segmenter` 等 polyfill。
-- **建構工具**:推薦使用 Vite、esbuild 或 Webpack 5。如果建構工具不支援 `package.json` 中的 `exports` 欄位(Webpack 4 中較常見),可能需要額外配置路徑映射。
-- **React**:Univer 的視圖層基於 React 18 構建,支援 React 18 和 19,並對 React 16.9+ 與 17 提供最低限度的相容支援。
-- **Node.js 執行時**:Headless Univer 支援 Node.js `>=18.17.0`。開發本 monorepo 需要 Node.js `>=22.18`。
+<a id="application-patterns-and-ecosystem"></a>
-## 🛠️ 你可以構建什麼
+## 🌐 應用模式與生態
-| 領域 | 開源能力 | Univer Pro 擴充 |
-| --- | --- | --- |
-| **Sheets** | 活頁簿、工作表、範圍、選擇、公式、數字格式、篩選、排序、資料驗證、條件格式、超連結、評論、尋找取代、註記、表格、繪圖整合和可擴充 UI 外掛。 | 即時協作、編輯歷史、匯入匯出、列印、圖表、樞紐分析表、迷你圖、大綱、形狀、儲存格內圖形、資料連接器、伺服器端計算和增強公式能力。 |
-| **Docs** | 富文字文件模型、編輯 UI、列表、超連結、繪圖整合、評論、快速插入和共享文件架構。 | 協作、匯入匯出、列印、增強表格和列表、分欄、提示區塊、程式碼區塊、引用區塊、形狀和遠端評論資源。 |
-| **Slides** | — | 簡報模型和 UI、投影片匯入匯出、圖表和表格模型/UI 外掛,以及共享形狀編輯基礎設施。 |
-| **Bases** | 基於 Univer 的外掛、命令和模型架構構建自訂結構化資料體驗。 | Base 資料庫模型、命令、公式整合、工作台 UI、欄位編輯器和渲染引擎視圖。 |
-| **Runtime** | 瀏覽器應用、Node.js 無頭使用、Web Worker/RPC 模式、多實例使用和伺服器端自動化。 | 協作客戶端/伺服器端套件、Node.js 協作客戶端、Pro 伺服器端服務、SSR、計算委派、伺服器端計算和 changeset 回放工具。 |
-| **Integrations** | React、Vue、Web Components、框架模板、主題、本地化和自訂外掛。 | Pro 預設和企業部署套件。 |
+<p align="center"><img src="../../docs/img/readme/ecosystem-banner.png" alt="" width="960" /></p>
-Sheets、Docs 和 Slides 基於 Univer 的共享架構,分別提供試算表、文件和簡報編輯能力,並使用一致的外掛系統、命令系統和 Facade API。
+<a id="univer-workspace-an-office-sdk-reference-application"></a>
-## 🔓 開源與 Pro
+### Univer Workspace:Office SDK 參考應用
-本倉庫包含 Univer 的開源核心和第一方 OSS 外掛。Univer Pro 作為商業擴充層單獨開發,面向進階產品介面、協作、伺服器端能力和企業整合。
+需要完整應用參考時,可以從 [Univer Workspace](https://github.com/dream-num/univer-workspace) 開始。它展示了如何將 Univer Office SDK 編輯器、協作、檔案能力、現有 Agent 和人工審閱組合成可自行代管的工作空間。建置自己的辦公應用或 Agent 工作空間時,可以參考其整合模式。
-| 類別 | 開源 | Univer Pro / 商業版 |
-| --- | --- | --- |
-| **基礎能力** | 核心 SDK、外掛系統、渲染引擎、公式引擎、Facade API、主題、i18n 和框架適配器。 | Pro 預設和企業部署套件。 |
-| **Sheets** | 核心試算表編輯、公式、數字格式、篩選/排序、資料驗證、條件格式、註記、表格、超連結、評論、繪圖、尋找取代。 | 協作、編輯歷史、匯入匯出、列印、圖表、樞紐分析表、迷你圖、大綱、形狀、儲存格內圖形、資料連接器、範圍預處理和增強公式引擎能力。 |
-| **Docs** | 文件模型和編輯 UI、列表、超連結、評論、快速插入和繪圖整合。 | 協作、匯入匯出、列印、增強表格/列表、分欄、提示區塊、程式碼區塊、引用區塊、形狀和遠端執行緒評論資源。 |
-| **Slides** | — | 簡報模型/UI 套件、投影片匯入匯出、圖表、表格和可重複使用形狀編輯器 UI。 |
-| **Bases** | 用於自訂資料類產品的可擴充外掛架構。 | Base 資料庫核心模型、命令、變更、公式整合、工作台 UI、欄位編輯器和渲染引擎整合。 |
-| **伺服器端與執行時** | Node.js 無頭執行時、RPC/Web Worker 模式和面向伺服器端自動化的基礎能力。 | 協作伺服器、Node.js 協作客戶端、SSR 服務、計算委派、伺服器端計算和協作 changeset 回放工具。 |
+<div align="center" style="overflow-x: auto;">
-編輯器功能請參考 [Web SDK 文件](https://docs.univer.ai/guides/sheets)。伺服器端整合請參考 Server SDK 中的[協同](https://docs.univer.ai/server/collaboration/overview)和[檔案匯入匯出](https://docs.univer.ai/server/import-export)章節。
+<table align="center" style="display: table; width: auto; margin-left: auto; margin-right: auto;">
+ <tr>
+ <td width="50%" valign="top">
+ <a href="https://space.univer.ai/"><img src="../../docs/img/readme/workspace.webp" alt="Univer Workspace 中的可編輯預算表格" width="420" /></a>
+ </td>
+ <td width="50%" valign="top">
+ <a href="https://univer.ai/demo/web-app"><img src="../../docs/img/readme/web-app.webp" alt="假設條件控件與關聯的可編輯表格並排展示的 Web App" width="420" /></a>
+ </td>
+ </tr>
+ <tr>
+ <td width="50%" valign="top">
+ <strong>Agent 與可編輯的辦公內容</strong><br />
+ 將對話、試算表編輯和辦公內容放在同一工作空間中。<br />
+ <a href="https://space.univer.ai/">體驗 Workspace</a> · <a href="https://github.com/dream-num/univer-workspace">Workspace 原始碼與設定</a>
+ </td>
+ <td width="50%" valign="top">
+ <strong>Web App × Sheet · 實驗性功能</strong><br />
+ 將控件綁定到儲存格:應用寫入表格,表格變更更新應用。<br />
+ <a href="https://univer.ai/demo/web-app">體驗表格驅動的應用示範</a>
+ </td>
+ </tr>
+</table>
-商業授權和購買諮詢請[聯絡我們](https://univer.ai/#contact)。在應用程式中設定授權,請參考[授權設定](https://docs.univer.ai/server/license)。
+</div>
-邊界原則:
+Workspace 是開源應用,其 SDK 依賴遵循各自的授權條款。關聯應用和審閱流程請參閱 [Workspace 概覽](https://univer.ai/workspace/)。
+
+<p align="center"><a href="https://www.youtube.com/watch?v=1p-SMEiK6Kg"><img src="../../docs/img/readme/integration-demo.png" alt="觀看 SDK 整合示範" width="720" /></a></p>
+
+[觀看 SDK 整合示範](https://www.youtube.com/watch?v=1p-SMEiK6Kg)
+
+<a id="cli-agent-integrations-and-developer-skills"></a>
+
+### CLI、Agent 整合與開發技能
+
+同樣的 SDK 能力也可以組合進你已經使用的 Agent 和工具中:
+
+<div align="center" style="overflow-x: auto;">
+
+<table align="center" style="display: table; width: auto; margin-left: auto; margin-right: auto;">
+<thead>
+<tr>
+<th>專案</th>
+<th>提供的能力</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td><a href="https://github.com/dream-num/univer-cli">Univer CLI</a></td>
+<td>用於建立、編輯、檢查和交付辦公內容的本地命令行工作空間。</td>
+</tr>
+<tr>
+<td><a href="https://github.com/dream-num/dsh-univer-office">Univer Office for DeepSeek Harness</a></td>
+<td>關聯內容、結果驗證、版本化變更和隔離的 Worktree 協作。</td>
+</tr>
+<tr>
+<td><a href="https://github.com/dream-num/workbuddy-univer-office">Univer Office for WorkBuddy</a></td>
+<td>本地 Office 整合、MCP 預覽和草稿審閱,目前為開發者預覽版。</td>
+</tr>
+<tr>
+<td><a href="https://github.com/dream-num/openclaw-univer-office">Univer Office for OpenClaw</a></td>
+<td>用於建立、審閱和交付辦公內容的工具。</td>
+</tr>
+<tr>
+<td><a href="https://github.com/dream-num/univer-sdk-skills">Univer SDK Skills</a></td>
+<td>幫助編碼 Agent 整合 SDK、開發外掛和實現後端工作流程的指令。</td>
+</tr>
+</tbody>
+</table>
+
+</div>
+
+各倉庫均提供設定說明和 SDK 依賴說明。可瀏覽[生態](https://univer.ai/ecosystem/)瞭解 Agent 入口,或參考[文件](https://docs.univer.ai/)建置自己的整合。
+
+<p align="right"><a href="#readme-top"><img src="https://img.shields.io/badge/%E2%86%91%20%E8%BF%94%E5%9B%9E%E9%A0%82%E9%83%A8-30363D?style=flat-square" alt="返回頂部" height="20" /></a></p>
+
+<a id="documentation-and-contributing"></a>
-- 本倉庫中的 OSS 套件應能在 Apache-2.0 授權下獨立使用。Univer Pro 是選用的,使用公開 OSS SDK API 不需要依賴 Pro。
-- OSS 套件中的 bug、回歸和安全問題應在 OSS 倉庫中回報和修復,即使存在相關的 Pro 功能。
-- OSS 文件不應暗示 Pro-only 能力已包含在公開的 `@univerjs/*` 套件中。Pro-only API、套件和部署路徑應被明確命名。
-- 當某個 OSS 功能存在 Pro 增強時,OSS 行為仍應被獨立記錄,方便使用者在不先閱讀商業文件的情況下評估開源能力。
+## 📚 文件與貢獻
-## 🌐 生態
+感謝所有參與建置和改進 Univer 的[貢獻者](https://github.com/dream-num/univer/graphs/contributors)。歡迎貢獻引擎、外掛、測試、文件和範例。
-- **核心 SDK**:[`dream-num/univer`](https://github.com/dream-num/univer),也就是目前的 monorepo。
-- **Presets**:本倉庫的 [`presets/`](../../presets),面向瀏覽器和 Node.js 應用的預設外掛集合。
-- **AI agent skills**:[`dream-num/univer-sdk-skills`](https://github.com/dream-num/univer-sdk-skills),供 AI agent 使用的可重複使用說明,涵蓋 Univer 整合、Pro 功能、外掛開發和 Node 後端。參見 [AI Skills 指南](https://docs.univer.ai/guides/skills)。
-- **文件**:[docs.univer.ai](https://docs.univer.ai),包含 Web SDK、Server SDK 和 AI SDK 指南及 API 參考。
-- **Web SDK**:在瀏覽器和 Node.js 中提供[嵌入式編輯器與無頭處理](https://docs.univer.ai/guides/sheets)能力。
-- **Server SDK**:將[協作與檔案轉換](https://docs.univer.ai/server)接入應用的儲存、身分驗證和權限系統。
-- **AI SDK**:透過 [Agent 工作流程](https://docs.univer.ai/ai)檢查、編輯和驗證辦公內容。
-- **API 參考**:[docs.univer.ai/reference](https://docs.univer.ai/reference/classes/univer),包含 Facade API 和生成的 API 參考。
-- **示例與展示**:[Univer Showcase](https://docs.univer.ai/showcase) 和本倉庫的 [`examples/`](../../examples)。
-- **AI-native spreadsheets**:[`dream-num/univer-mcp`](https://github.com/dream-num/univer-mcp),用於透過自然語言驅動 Univer Sheets 的 Univer Platform / MCP 整合。
+<p align="center"><a href="https://docs.univer.ai/guides/sheets">🧩 Web SDK</a> · <a href="https://docs.univer.ai/server">🖥️ Server SDK</a> · <a href="https://docs.univer.ai/ai">🤖 AI SDK</a> · <a href="https://docs.univer.ai/reference/classes/univer">🔧 API 參考</a> · <a href="https://office.univer.ai/">🎮 在線範例</a></p>
-## 📦 倉庫結構
+<div align="center" style="overflow-x: auto;">
+
+<table align="center" style="display: table; width: auto; margin-left: auto; margin-right: auto;">
+ <tr>
+ <th align="center"><img src="https://cdnjs.cloudflare.com/ajax/libs/browser-logos/75.0.1/edge/edge_64x64.png" width="32" height="32" alt="" /><br />Edge</th>
+ <th align="center"><img src="https://cdnjs.cloudflare.com/ajax/libs/browser-logos/75.0.1/firefox/firefox_64x64.png" width="32" height="32" alt="" /><br />Firefox</th>
+ <th align="center"><img src="https://cdnjs.cloudflare.com/ajax/libs/browser-logos/75.0.1/chrome/chrome_64x64.png" width="32" height="32" alt="" /><br />Chrome</th>
+ <th align="center"><img src="https://cdnjs.cloudflare.com/ajax/libs/browser-logos/75.0.1/safari/safari_64x64.png" width="32" height="32" alt="" /><br />Safari</th>
+ <th align="center"><img src="https://cdnjs.cloudflare.com/ajax/libs/browser-logos/75.0.1/electron/electron_64x64.png" width="32" height="32" alt="" /><br />Electron</th>
+ </tr>
+ <tr>
+ <td align="center"><code>&gt;=88</code></td>
+ <td align="center"><code>&gt;=90</code></td>
+ <td align="center"><code>&gt;=88</code></td>
+ <td align="center"><code>&gt;=14.1</code></td>
+ <td align="center"><code>&gt;=12</code></td>
+ </tr>
+</table>
+
+</div>
+
+<p align="center">Univer 以 Chrome 88 為編譯目標,旨在支援上表所列版本。</p>
+
+<a id="runtime-compatibility"></a>
+
+### 執行環境相容性
+
+- **Polyfill**:Univer 依賴 `Intl.Segmenter`。如果目標瀏覽器或執行時未提供該 API,請新增 `@formatjs/intl-segmenter` 等 Polyfill。
+- **建置工具**:推薦 Vite、esbuild 或 Webpack 5。如果建置工具不支援 `package.json` 中的 `exports` 字段(常見於 Webpack 4),可能需要額外的路徑映射。
+- **React**:Univer 的視圖層基於 React 18 建置,支援 React 18 和 19,並為 React 16.9+ 和 17 提供最低限度的相容支援。
+- **Node.js 環境**:Headless Univer 支援 Node.js `>=18.17.0`,開發本倉庫需要 Node.js `>=22.18`。
+
+<details>
+<summary>在本倉庫中開發</summary>
+
+### 倉庫結構
```text
.
-├── packages/ 核心套件、引擎、文件類型、UI 外掛和功能外掛
-├── examples/ 用於本地瀏覽器開發的一體化 Vite 工作台
-├── common/ 共享內部工具、storybook 和工具函式
-├── tests/ 其他整合測試專案
-└── docs/ 架構說明、圖片和倉庫內文件
+├── packages/ Core packages, engines, document types, UI plugins, and feature plugins
+├── examples/ All-in-one Vite workbench used for local browser development
+├── common/ Shared internal tooling, storybook, and utilities
+├── tests/ Additional integration test projects
+└── docs/ Architecture notes, images, and repository-local documentation
```
-套件級 README 位於 [`packages/`](../../packages) 下各套件目錄中。
+各套件的 README 位於 [`packages/`](../../packages) 下對應套件的目錄中。
-## 🧑‍💻 開發
+### 本地開發
-要求:
+環境要求:
- Node.js `>=22.18`
-- pnpm `>=11`
+- pnpm:使用 `package.json` 中 `packageManager` 聲明的版本。
```bash
git clone https://github.com/dream-num/univer.git
@@ -364,63 +806,107 @@ pnpm dev
常用命令:
-| 命令 | 用途 |
-| --- | --- |
-| `pnpm dev` | 構建並預覽低記憶體、無 HMR 的一體化工作台。 |
-| `pnpm dev:source` | 啟動支援 HMR 的原始碼工作台,冷啟動和記憶體用量較高。 |
-| `pnpm build` | 構建 workspace 套件,不包含內部 common 套件。 |
-| `pnpm test` | 透過 Turbo 執行單元測試。 |
-| `pnpm typecheck` | 透過 Turbo 執行 TypeScript 檢查。 |
-| `pnpm lint` | 執行 ESLint。 |
-| `pnpm storybook:dev` | 啟動用於 UI 元件開發的 Storybook。 |
+<div align="center" style="overflow-x: auto;">
+
+<table align="center" style="display: table; width: auto; margin-left: auto; margin-right: auto;">
+<thead>
+<tr>
+<th>命令</th>
+<th>用途</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td><code class="notranslate">pnpm dev</code></td>
+<td>啓動 Sheets 和 Docs 開發工作台。</td>
+</tr>
+<tr>
+<td><code class="notranslate">pnpm build</code></td>
+<td>建置工作區套件,不包括內部 common 套件。</td>
+</tr>
+<tr>
+<td><code class="notranslate">pnpm test</code></td>
+<td>透過 Turbo 執行單元測試。</td>
+</tr>
+<tr>
+<td><code class="notranslate">pnpm typecheck</code></td>
+<td>透過 Turbo 執行 TypeScript 檢查。</td>
+</tr>
+<tr>
+<td><code class="notranslate">pnpm lint</code></td>
+<td>執行 ESLint。</td>
+</tr>
+<tr>
+<td><code class="notranslate">pnpm storybook:dev</code></td>
+<td>啓動 Storybook 進行 UI 元件開發。</td>
+</tr>
+</tbody>
+</table>
+
+</div>
+
+提交 Pull Request 前,請閱讀 [CONTRIBUTING.md](../../CONTRIBUTING.md)。
+
+</details>
+
+<details>
+<summary>架構與貢獻參考</summary>
+
+- [倉庫中的套件](../../packages)、[預設](../../presets)和[範例](../../examples)。
+- [建置同構 Univer](../../docs/ISOMORPHIC.md)。
+- [Facade API 貢獻指南](../../docs/CONTRIBUTING-FACADE.md)。
+- [API 穩定性策略](../../docs/API_STABILITY.md)。
+- [命名規範](../../docs/NAMING_CONVENTION.md)和[記憶體洩漏修復](../../docs/FIX_MEMORY_LEAK.md)。
+- [架構 TLDR](../../docs/tldr)和 [OLE 附件說明](../../packages/drawing/docs/ole-attachments.md)。
-提交 pull request 前請閱讀 [CONTRIBUTING.md](../../CONTRIBUTING.md)。
+</details>
-## 📝 貢獻者筆記
+<p align="right"><a href="#readme-top"><img src="https://img.shields.io/badge/%E2%86%91%20%E8%BF%94%E5%9B%9E%E9%A0%82%E9%83%A8-30363D?style=flat-square" alt="返回頂部" height="20" /></a></p>
-深入修改前,建議閱讀這些倉庫內說明:
+<a id="community"></a>
-- [Building Isomorphic Univer](../ISOMORPHIC.md):如何拆分瀏覽器、Node.js、UI 與共享外掛邏輯。
-- [API 穩定性政策](../API_STABILITY.md):stable、experimental、internal、deprecated 和破壞性變更預期。
-- [Contributing to Facade API](../CONTRIBUTING-FACADE.md):`FUniver`、`FWorkbook`、`FRange` 等 Facade API 的設計約定。
-- [Naming Convention](../NAMING_CONVENTION.md):檔案、目錄、介面、外掛、命令和依賴注入 token 的命名規則。
-- [Fixing Memory Leaks](../FIX_MEMORY_LEAK.md):Univer 實例常見記憶體洩漏模式和除錯流程。
-- [Architecture TLDRs](../tldr):公式引擎、Web Worker、權限、選擇區和 ref-range 行為的簡明說明。
+## 💬 社區
-## 💬 社群
+在 [GitHub Discussions](https://github.com/dream-num/univer/discussions) 提問,加入 [Discord](https://discord.gg/z3NKNT6D2f),並關注 [X](https://twitter.com/univerhq) 或 [YouTube](https://www.youtube.com/@dreamNum)。請閱讀[行為準則](../../CODE_OF_CONDUCT.md)。
-- 在 [GitHub Discussions](https://github.com/dream-num/univer/discussions) 提問。
-- 加入 [Discord](https://discord.gg/z3NKNT6D2f) 與社群交流。
-- 關注 [Twitter / X](https://twitter.com/univerhq) 和 [YouTube](https://www.youtube.com/@dreamNum)。
+<p align="right"><a href="#readme-top"><img src="https://img.shields.io/badge/%E2%86%91%20%E8%BF%94%E5%9B%9E%E9%A0%82%E9%83%A8-30363D?style=flat-square" alt="返回頂部" height="20" /></a></p>
-參與社群前,請閱讀 [行為準則](../../CODE_OF_CONDUCT.md)。
+<a id="security"></a>
## 🔒 安全
如果你認為發現了安全問題,請遵循 [安全政策](../../SECURITY.md)。
+<p align="right"><a href="#readme-top"><img src="https://img.shields.io/badge/%E2%86%91%20%E8%BF%94%E5%9B%9E%E9%A0%82%E9%83%A8-30363D?style=flat-square" alt="返回頂部" height="20" /></a></p>
+
+<a id="sponsors"></a>
+
## ❤️ 贊助
Univer 由社群和贊助者共同支援。你可以透過 [Open Collective](https://opencollective.com/univer) 支援這個專案。
-<a href="https://opencollective.com/univer/sponsor/0/website"><img src="https://opencollective.com/univer/sponsor/0/avatar.svg" alt="Sponsor 0" /></a>
-<a href="https://opencollective.com/univer/sponsor/1/website"><img src="https://opencollective.com/univer/sponsor/1/avatar.svg" alt="Sponsor 1" /></a>
-<a href="https://opencollective.com/univer/sponsor/2/website"><img src="https://opencollective.com/univer/sponsor/2/avatar.svg" alt="Sponsor 2" /></a>
-<a href="https://opencollective.com/univer/sponsor/3/website"><img src="https://opencollective.com/univer/sponsor/3/avatar.svg" alt="Sponsor 3" /></a>
-<a href="https://opencollective.com/univer/sponsor/4/website"><img src="https://opencollective.com/univer/sponsor/4/avatar.svg" alt="Sponsor 4" /></a>
-<a href="https://opencollective.com/univer/sponsor/5/website"><img src="https://opencollective.com/univer/sponsor/5/avatar.svg" alt="Sponsor 5" /></a>
-<a href="https://opencollective.com/univer/sponsor/6/website"><img src="https://opencollective.com/univer/sponsor/6/avatar.svg" alt="Sponsor 6" /></a>
+<p>
+ <a href="https://opencollective.com/univer/sponsor/0/website"><img src="https://opencollective.com/univer/sponsor/0/avatar.svg" alt="成為贊助者" /></a>
+</p>
-<a href="https://opencollective.com/univer/backer/0/website"><img src="https://opencollective.com/univer/backer/0/avatar.svg" alt="Backer 0" /></a>
-<a href="https://opencollective.com/univer/backer/1/website"><img src="https://opencollective.com/univer/backer/1/avatar.svg" alt="Backer 1" /></a>
-<a href="https://opencollective.com/univer/backer/2/website"><img src="https://opencollective.com/univer/backer/2/avatar.svg" alt="Backer 2" /></a>
-<a href="https://opencollective.com/univer/backer/3/website"><img src="https://opencollective.com/univer/backer/3/avatar.svg" alt="Backer 3" /></a>
-<a href="https://opencollective.com/univer/backer/4/website"><img src="https://opencollective.com/univer/backer/4/avatar.svg" alt="Backer 4" /></a>
-<a href="https://opencollective.com/univer/backer/5/website"><img src="https://opencollective.com/univer/backer/5/avatar.svg" alt="Backer 5" /></a>
-<a href="https://opencollective.com/univer/backer/6/website"><img src="https://opencollective.com/univer/backer/6/avatar.svg" alt="Backer 6" /></a>
+<p>
+ <a href="https://opencollective.com/univer/backer/0/website"><img src="https://opencollective.com/univer/backer/0/avatar.svg" width="64" height="64" alt="Backer 0" /></a>
+ <a href="https://opencollective.com/univer/backer/1/website"><img src="https://opencollective.com/univer/backer/1/avatar.svg" width="64" height="64" alt="Backer 1" /></a>
+ <a href="https://opencollective.com/univer/backer/2/website"><img src="https://opencollective.com/univer/backer/2/avatar.svg" width="64" height="64" alt="Backer 2" /></a>
+ <a href="https://opencollective.com/univer/backer/3/website"><img src="https://opencollective.com/univer/backer/3/avatar.svg" width="64" height="64" alt="Backer 3" /></a>
+ <a href="https://opencollective.com/univer/backer/4/website"><img src="https://opencollective.com/univer/backer/4/avatar.svg" width="64" height="64" alt="Backer 4" /></a>
+ <a href="https://opencollective.com/univer/backer/5/website"><img src="https://opencollective.com/univer/backer/5/avatar.svg" width="64" height="64" alt="Backer 5" /></a>
+ <a href="https://opencollective.com/univer/backer/6/website"><img src="https://opencollective.com/univer/backer/6/avatar.svg" width="64" height="64" alt="Backer 6" /></a>
+</p>
-## 📄 授權
+<p align="right"><a href="#readme-top"><img src="https://img.shields.io/badge/%E2%86%91%20%E8%BF%94%E5%9B%9E%E9%A0%82%E9%83%A8-30363D?style=flat-square" alt="返回頂部" height="20" /></a></p>
+
+<a id="license"></a>
+
+## 📄 授權條款
Copyright (c) 2021-present DreamNum Co., Ltd.
-基於 [Apache-2.0](../../LICENSE) 授權開源。
+本倉庫的開源套件採用 [Apache-2.0](../../LICENSE) 授權條款。商業 SDK 模組單獨散布和授權。
+
+<p align="right"><a href="#readme-top"><img src="https://img.shields.io/badge/%E2%86%91%20%E8%BF%94%E5%9B%9E%E9%A0%82%E9%83%A8-30363D?style=flat-square" alt="返回頂部" height="20" /></a></p>
diff --git a/docs/tldr/skeleton.svg b/docs/tldr/skeleton.svg
deleted file mode 100644
index eebe86e818..0000000000
--- a/docs/tldr/skeleton.svg
+++ /dev/null
@@ -1,8 +0,0 @@
-<svg xmlns="http://www.w3.org/2000/svg" direction="ltr" width="1471.75" height="734.5919510667013" viewBox="157.6953125 331.4921875 1471.75 734.5919510667013" stroke-linecap="round" stroke-linejoin="round" data-color-mode="light" class="tl-container tl-theme__force-sRGB tl-theme__light" style="background-color: rgb(249, 250, 251);"><defs><style>
-@font-face {
- font-family: tldraw_draw;
- font-stretch: normal;
- font-weight: 500;
- font-style: normal;
- src: url("data:font/woff2;base64,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") format("woff2")
-}</style></defs><g transform="matrix(1, 0, 0, 1, 1067.2266, 406.3828)" opacity="1"><path d="M7,0.0182 L401.0004,1.0418 Q408.0003,1.06 407.998,8.06 L407.9704,91.2751 Q407.9681,98.2751 400.9681,98.2642 L5.972,97.6525 Q-1.028,97.6416 -0.9451,90.6421 L0.0593,5.8555 Q0.1422,-1.1441 7.1422,-1.1129 L399.684,0.6332 Q406.6839,0.6644 406.6566,7.6643 L406.3304,91.0655 Q406.3031,98.0654 399.3031,98.0587 L6.4902,97.6798 Q-0.5098,97.673 -0.4116,90.6737 L0.7636,6.9434 Q0.8618,-0.0559 7,0.0182 " stroke="#1d1d1d" stroke-width="3.5" fill="none"/></g><g transform="matrix(1, 0, 0, 1, 1066.5, 363.4922)" opacity="1"><text font-size="24" font-family="'tldraw_draw', sans-serif" font-style="normal" font-weight="normal" dominant-baseline="mathematical" alignment-baseline="mathematical" stroke="rgb(249, 250, 251)" stroke-width="2" fill="rgb(249, 250, 251)"><tspan alignment-baseline="mathematical" x="0" y="12.5" unicode-bidi="plaintext">packages/core/src/skeleton.ts</tspan></text><text font-size="24" font-family="'tldraw_draw', sans-serif" font-style="normal" font-weight="normal" dominant-baseline="mathematical" alignment-baseline="mathematical" fill="#1d1d1d"><tspan alignment-baseline="mathematical" x="0" y="12.5" unicode-bidi="plaintext">packages/core/src/skeleton.ts</tspan></text></g><g transform="matrix(1, 0, 0, 1, 1066.082, 641.9141)" opacity="1"><path d="M7,-0.0035 L402.9649,-0.1991 Q409.9649,-0.2025 410.008,6.7974 L410.6494,110.9084 Q410.6926,117.9083 403.6926,117.9297 L6.53,119.1458 Q-0.47,119.1673 -0.4066,112.1675 L0.5553,5.9036 Q0.6187,-1.0961 7.6187,-1.0948 L402.1768,-1.0241 Q409.1768,-1.0228 409.178,5.9772 L409.1958,111.3241 Q409.1969,118.3241 402.1969,118.3351 L6.2863,118.9598 Q-0.7137,118.9709 -0.7209,111.9709 L-0.8287,7.6612 Q-0.8359,0.6612 7,-0.0035 " stroke="#1d1d1d" stroke-width="3.5" fill="none"/></g><g transform="matrix(1, 0, 0, 1, 1272.9751, 704.7167)" opacity="1"><g transform="scale(1)"><defs><clipPath id="_export_1_ra3__shape_0BNGn7qEW7xCSpeSOOKXu_clip"><path d="M-102.0863,-286.287 h201 v323.48437510917597 h-201 Z"/></clipPath></defs><g fill="none" stroke="#1d1d1d" stroke-width="3.5" stroke-linejoin="round" stroke-linecap="round" pointer-events="none"><g style="clip-path: url(&quot;#_export_1_ra3__shape_0BNGn7qEW7xCSpeSOOKXu_clip&quot;);"><rect x="-102.0863" y="-286.287" width="201" height="323.4844" opacity="0"/><path d="M-2.070559439809358,-62.80262035721921L-2.0862639260245244,-186.2869954663952" stroke-dasharray="none" stroke-dashoffset="none"/></g><path d="M -7.335107420809181 -177.1930611161122 L -2.0862639260245244 -186.2869954663952 L 3.164892494276157 -177.1943964842815"/></g></g></g><g transform="matrix(1, 0, 0, 1, 1060.9297, 589.1523)" opacity="1"><text font-size="24" font-family="'tldraw_draw', sans-serif" font-style="normal" font-weight="normal" dominant-baseline="mathematical" alignment-baseline="mathematical" stroke="rgb(249, 250, 251)" stroke-width="2" fill="rgb(249, 250, 251)"><tspan alignment-baseline="mathematical" x="0" y="12.5" unicode-bidi="plaintext">packages/core/src/sheets/sheet-skeleton.ts</tspan></text><text font-size="24" font-family="'tldraw_draw', sans-serif" font-style="normal" font-weight="normal" dominant-baseline="mathematical" alignment-baseline="mathematical" fill="#1d1d1d"><tspan alignment-baseline="mathematical" x="0" y="12.5" unicode-bidi="plaintext">packages/core/src/sheets/sheet-skeleton.ts</tspan></text></g><g transform="matrix(1, 0, 0, 1, 195.4102, 637.3125)" opacity="1"><path d="M7,-0.0182 L383.4008,-0.9941 Q390.4008,-1.0123 390.5188,5.9867 L392.0823,98.7303 Q392.2003,105.7293 385.2003,105.7501 L7.5893,106.8732 Q0.5894,106.894 0.4918,99.8947 L-0.7884,8.0216 Q-0.8859,1.0223 6.114,0.9899 L385.6191,-0.7703 Q392.619,-0.8028 392.5982,6.1972 L392.3197,100.0507 Q392.2989,107.0507 385.2989,107.0304 L7.1787,105.9358 Q0.1788,105.9156 0.12,98.9158 L-0.6555,6.4964 Q-0.7143,-0.5033 7,-0.0182 " stroke="#1d1d1d" stroke-width="3.5" fill="none"/></g><g transform="matrix(1, 0, 0, 1, 568.7878, 691.5886)" opacity="1"><g transform="scale(1)"><defs><clipPath id="_export_1_ra3__shape_7ksWBbg8fZrujGFKHCzLa_clip"><path d="M-81.8581,-100.6237 h665.652407490317 v201.43093073993995 h-665.652407490317 Z"/></clipPath></defs><g fill="none" stroke="#1d1d1d" stroke-width="3.5" stroke-linejoin="round" stroke-linecap="round" pointer-events="none"><g style="clip-path: url(&quot;#_export_1_ra3__shape_7ksWBbg8fZrujGFKHCzLa_clip&quot;);"><rect x="-81.8581" y="-100.6237" width="665.6524" height="201.4309" opacity="0"/><path d="M18.14193342405906,-0.6237390370180265L483.7943409143761,0.8071917029219174" stroke-dasharray="none" stroke-dashoffset="none"/></g><path d="M 474.7172500669349 -4.470726612787424 L 483.7943409143761 0.8071917029219174 L 474.68498415015205 6.029223811410522"/></g></g></g><g transform="matrix(1, 0, 0, 1, 189.6953, 589.4375)" opacity="1"><text font-size="24" font-family="'tldraw_draw', sans-serif" font-style="normal" font-weight="normal" dominant-baseline="mathematical" alignment-baseline="mathematical" stroke="rgb(249, 250, 251)" stroke-width="2" fill="rgb(249, 250, 251)"><tspan alignment-baseline="mathematical" x="0" y="12.5" unicode-bidi="plaintext">packages/engine-render/.../sheets/sheet.render-skeleton.ts</tspan></text><text font-size="24" font-family="'tldraw_draw', sans-serif" font-style="normal" font-weight="normal" dominant-baseline="mathematical" alignment-baseline="mathematical" fill="#1d1d1d"><tspan alignment-baseline="mathematical" x="0" y="12.5" unicode-bidi="plaintext">packages/engine-render/.../sheets/sheet.render-skeleton.ts</tspan></text></g><g transform="matrix(1, 0, 0, 1, 193.477, 903.6545)" opacity="1"><path d="M7,-0.0103 L424.3633,-0.6227 Q431.3633,-0.633 431.2792,6.3665 L429.8628,124.3332 Q429.7788,131.3327 422.7788,131.3069 L7.9906,129.7781 Q0.9906,129.7523 0.8964,122.753 L-0.6507,7.7684 Q-0.7449,0.769 6.255,0.7379 L424.0652,-1.1201 Q431.0651,-1.1512 431.0326,5.8487 L430.4899,122.6332 Q430.4574,129.6331 423.4574,129.659 L7.8638,131.196 Q0.8638,131.2219 0.8294,124.222 L0.258,7.9544 Q0.2236,0.9544 7,-0.0103 " stroke="#1d1d1d" stroke-width="3.5" fill="none"/></g><g transform="matrix(1, 0, 0, 1, 340.953, 975.5307)" opacity="1"><g transform="scale(1)"><defs><clipPath id="_export_1_ra3__shape_vuB-FbNksp72A5YTcusSW_clip"><path d="M177.9577,-310.6945 h647.4490278752077 v338.81831171008275 h-647.4490278752077 Z"/></clipPath></defs><g fill="none" stroke="#1d1d1d" stroke-width="3.5" stroke-linejoin="round" stroke-linecap="round" pointer-events="none"><g style="clip-path: url(&quot;#_export_1_ra3__shape_vuB-FbNksp72A5YTcusSW_clip&quot;);"><rect x="177.9577" y="-310.6945" width="647.449" height="338.8183" opacity="0"/><path d="M277.9576808385144,-71.87622029979434L725.4067087137221,-210.69453200987707" stroke-dasharray="none" stroke-dashoffset="none"/></g><path d="M 715.1661735042127 -213.0143248072618 L 725.4067087137221 -210.69453200987707 L 718.277441614916 -202.9858647687853"/></g></g></g><g transform="matrix(1, 0, 0, 1, 191.145, 860.6505)" opacity="1"><text font-size="24" font-family="'tldraw_draw', sans-serif" font-style="normal" font-weight="normal" dominant-baseline="mathematical" alignment-baseline="mathematical" stroke="rgb(249, 250, 251)" stroke-width="2" fill="rgb(249, 250, 251)"><tspan alignment-baseline="mathematical" x="0" y="12.5" unicode-bidi="plaintext">packages/engine-render/.../docs/layout/doc-skeleton.ts</tspan></text><text font-size="24" font-family="'tldraw_draw', sans-serif" font-style="normal" font-weight="normal" dominant-baseline="mathematical" alignment-baseline="mathematical" fill="#1d1d1d"><tspan alignment-baseline="mathematical" x="0" y="12.5" unicode-bidi="plaintext">packages/engine-render/.../docs/layout/doc-skeleton.ts</tspan></text></g></svg>
\ No newline at end of file
diff --git a/examples/src/assets/univer-logo.svg b/examples/src/assets/univer-logo.svg
new file mode 100644
index 0000000000..57c93293f7
--- /dev/null
+++ b/examples/src/assets/univer-logo.svg
@@ -0,0 +1,13 @@
+<svg width="129" height="24" viewBox="0 0 129 24" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path d="M117 9.82609V6L127.569 10.0165C128.253 10.2798 128.705 10.9371 128.705 11.6699V14.1775C128.705 14.9103 128.253 15.5676 127.569 15.8309L117 19.8252V15.6669L125.214 12.8969V12.7358L117 9.82609Z" fill="white"/>
+<path d="M8.00459 11.7278C8.00459 11.8245 7.94415 11.9109 7.85327 11.9438L0 14.7986V18.6247L10.3597 14.6082C11.0436 14.3449 11.4949 13.6876 11.4949 12.9548V0H8.00437V11.7278H8.00459Z" fill="white"/>
+<path d="M23.9999 14.7986V18.6247L13.4304 14.6082C12.7465 14.3449 12.2952 13.6876 12.2952 12.9548V10.4473C12.2952 9.71443 12.7465 9.05716 13.4304 8.79385L23.9999 4.79955V8.95783L15.8626 11.702C15.8166 11.7176 15.7857 11.7607 15.7857 11.8091C15.7857 11.8569 15.816 11.8998 15.8611 11.9158L23.9999 14.7988V14.7986Z" fill="white"/>
+<path d="M11.4952 15.8288V24H8.00467L8.00556 16.7371C8.00556 16.5069 8.14777 16.3005 8.36286 16.2183L10.7415 15.3097C11.1053 15.1708 11.4952 15.4392 11.4952 15.8285V15.8288Z" fill="white"/>
+<path d="M6.58925 11.3481L8.39233e-05 8.65276V4.77711L6.92455 7.6113C7.09142 7.67951 7.20053 7.84194 7.20053 8.02237L7.20164 10.9365C7.20164 11.2525 6.88145 11.4676 6.58903 11.3481H6.58925Z" fill="white"/>
+<path d="M98.5234 19.9719V5.25C98.5234 4.42157 99.195 3.75 100.023 3.75H104.902C106.978 3.75 108.593 4.27528 109.745 5.32584C110.897 6.36096 111.473 7.66152 111.473 9.5C111.473 10.7051 111.195 11.4751 110.669 12.3557C110.142 13.2209 109.396 13.8852 108.429 14.3487C107.462 14.8122 106.31 15.0439 104.973 15.0439H100.429L101.965 13.3985L101.979 19.9719H98.5234ZM108.017 19.9719L104.269 13.6766H107.959L111.75 19.9719H108.017ZM101.965 13.8157L100.429 12.0544H104.781C105.847 12.0544 106.644 11.8073 107.17 11.3129C107.696 10.803 107.974 10.3806 107.974 9.5C107.974 8.60393 107.711 8.04494 107.185 7.55056C106.658 7.05618 105.862 6.80899 104.795 6.80899H100.443L101.979 5.02458L101.965 13.8157Z" fill="white"/>
+<path d="M84.5136 19.9719V3.75H96.5253V6.76264H87.9482V16.9593H97V19.9719H84.5136ZM87.6922 13.2051V10.2851H95.2526V13.2051L87.6922 13.2051Z" fill="white"/>
+<path d="M73.3078 19.9719C72.898 19.9719 72.5297 19.7219 72.3784 19.341L66.1863 3.75H69.9196L75.5516 18.118H73.3543L79.0716 3.75H82.5062L76.2932 19.3421C76.1417 19.7224 75.7736 19.9719 75.3643 19.9719H73.3078Z" fill="white"/>
+<path d="M60.694 19.9719V3.75H64.15V19.9719H60.694Z" fill="white"/>
+<path d="M43.8741 19.8646V3.64269H45.7486C46.3684 3.64269 46.9522 3.93358 47.3254 4.42834L55.5433 15.3225H54.1567V3.64269H57.57V19.8646H55.7153C55.0964 19.8646 54.5133 19.5745 54.14 19.0808L45.9007 8.18483H47.2874V19.8646H43.8741Z" fill="white"/>
+<path d="M34.5126 20.25C32.3935 20.25 30.7366 19.6088 29.542 18.3265C28.3473 17.0442 27.75 15.2135 27.75 12.8343V3.75H31.206V12.6952C31.206 14.2402 31.4975 15.3525 32.0806 16.0323C32.6637 16.7121 33.4815 17.052 34.5339 17.052C35.5864 17.052 36.4042 16.7121 36.9873 16.0323C37.5704 15.3525 37.8619 14.2402 37.8619 12.6952V3.75H41.2752V12.8343C41.2752 15.2135 40.6779 17.0442 39.4832 18.3265C38.2886 19.6088 36.6317 20.25 34.5126 20.25Z" fill="white"/>
+</svg>
diff --git a/examples/src/global.css b/examples/src/global.css
index f350089a3f..4a283aa2f2 100644
--- a/examples/src/global.css
+++ b/examples/src/global.css
@@ -82,7 +82,8 @@ html.univer-dark body {
height: 20px;
align-items: center;
flex: 0 0 auto;
- background: url('../../docs/img/banner-dark.png') center / contain no-repeat;
+ background: url('./assets/univer-logo.svg') center / contain no-repeat;
+ filter: brightness(0);
}
.workbench-header nav {
@@ -137,7 +138,7 @@ html.univer-dark .workbench-header {
}
html.univer-dark .workbench-brand {
- background-image: url('../../docs/img/banner-light.png');
+ filter: none;
}
.workbench-header a {