基本概念

了解 Univer Docs 的外掛、快照、命令與 Facade API。需要建立編輯器時，請繼續閱讀安裝與基本使用。

基本概念

在進一步深入瞭解 Univer 之前，請閱讀本篇文件以瞭解 Univer 的基本概念，將有助於你更順利地使用 Univer。

基本概念包括：

• 外掛 Plugin
• 快照 Snapshot
• 命令 Command
• Facade API

外掛

Univer 的功能均由外掛提供，外掛是 Univer 的基本組成單元，多個外掛組合在一起構成了 Univer 應用。

外掛的職責包括：

1. 實現功能，例如 @univerjs/docs-hyper-link 提供 Univer Docs 的超連結模型和命令
2. 提供某種基礎能力，例如 @univerjs/engine-render 提供渲染能力

你可以按照自己的需要組合 Univer 提供的外掛，客製出符合你的需求的 Univer 應用，避免載入多餘程式碼。你也可以透過編寫外掛來擴充 Univer 的功能，滿足個別化需求。

相關連結

1. 超連結 介紹如何透過預設模式或外掛模式新增 Docs 功能
2. Univer 架構 詳細瞭解 Univer 的架構設計

快照

Univer Docs 使用 IDocumentData 作為快照格式，它描述文件正文、文件層級樣式、頁首和頁尾、繪圖、清單、表格和外掛資源。

可選的 resources 欄位用於儲存外掛定義的資料。

命令

在 Univer Docs 中，文件內容和格式的修改都透過命令執行。這樣可以追蹤變更，實現復原、重做和協同編輯，並協調相關功能。

Facade API 會在背後準備參數並執行對應的 Docs 命令。

Facade API

由於辦公應用的複雜度非常高，Univer 的架構相應地也非常複雜，為了讓開發者更容易地使用 Univer，我們提供了 Facade API，它是對 Univer 第一方外掛的封裝，提供了更簡單的介面，讓開發者可以更容易地使用 Univer。

目前 Facade API 在不斷完善中，如果你有任何建議或者需求，歡迎在 GitHub 上提 issue。

Facade API 是對底層細節的抽象，雖然它簡化了常見任務，但實現複雜功能時可能需要你了解 Univer 的架構並直接使用底層 API。

相關連結

1. Facade API 介紹
2. Facade API 常用方法
3. Univer Docs API 常用方法

預設模式與外掛模式

Univer 採用了外掛化的設計理念，旨在為開發者提供一個靈活、可擴充的電子文件應用框架。透過外掛化設計，Univer 可以輕鬆地整合各種功能模組，從而滿足不同使用者的需求。但外掛化的設計會增加應用的複雜性，尤其是對於首次接觸 Univer 的開發者來說。

為此，Univer 提供了外掛模式和預設模式兩種方式幫助你快速整合和使用 Univer。所謂預設實際上就是一組預先配置好的外掛組合，因此在無需進行復雜擴充的情況下，兩者所提供的能力是相同的。

預設模式與外掛模式的區別：