# API 概覽

> 查找 API、設定功能套件，開始使用 Univer Office SDK。

- Human documentation: [https://docs.univer.ai/zh-TW/reference](https://docs.univer.ai/zh-TW/reference)

- Agent Markdown: [https://docs.univer.ai/zh-TW/reference.md](https://docs.univer.ai/zh-TW/reference.md)

- Requested language: `zh-TW`

- Content language: `zh-TW`

- Documentation version: `1.2.0`

- Source: [index.zh-TW.mdx](https://github.com/dream-num/documentation/blob/dev/content/reference/index.zh-TW.mdx)

---

透過 Facade API 在應用程式中讀取與修改 Office 內容。你可以依產品查找介面，也可以從下方的初始化與外掛設定入口開始。

## 試用 API

先完成[安裝與基本使用](https://docs.univer.ai/zh-TW/guides/sheets/getting-started/installation.md)。初始化 Sheets 編輯器並取得 `createUniver` 傳回的 `univerAPI` 後，下列程式碼會向 A1 儲存格寫入內容：

```ts
const workbook = univerAPI.getActiveWorkbook()
const worksheet = workbook?.getActiveSheet()
worksheet?.getRange('A1').setValue('Hello, Univer!')
```

`univerAPI` 是 `FUniver` 執行個體。在 Sheets 中，從活頁簿進入工作表，再取得儲存格範圍。外掛模式的初始化方式與功能套件的 Facade 匯入方式，請見 [Facade API 基礎](https://docs.univer.ai/zh-TW/guides/sheets/getting-started/facade.md)。

## 依用途查找

| 用途              | 參考文件                                                                                                                    |
| --------------- | ----------------------------------------------------------------------------------------------------------------------- |
| 執行個體、生命週期與通用操作  | [FUniver](https://docs.univer.ai/zh-TW/reference/facade/univer.md)                                                                                     |
| 活頁簿、工作表與儲存格     | [FWorkbook](https://docs.univer.ai/zh-TW/reference/facade/workbook.md) · [FWorksheet](https://docs.univer.ai/zh-TW/reference/facade/worksheet.md) · [FRange](https://docs.univer.ai/zh-TW/reference/facade/range.md) |
| 文件與文字           | [FDocument](https://docs.univer.ai/zh-TW/reference/facade/document.md)                                                                                 |
| 簡報              | [Slides](https://docs.univer.ai/zh-TW/reference/facade/presentation.md)                                                                                |
| 畫板              | [Boards](https://docs.univer.ai/zh-TW/reference/facade/board.md)                                                                                       |
| 多維表格            | [Bases](https://docs.univer.ai/zh-TW/reference/facade/base.md)                                                                                         |
| PDF 內容          | [PDF](https://docs.univer.ai/zh-TW/reference/facade/pdf.md)                                                                                            |
| 事件              | [Events](https://docs.univer.ai/zh-TW/reference/facade/events.md)                                                                                      |
| 協同編輯            | [Collaboration](https://docs.univer.ai/zh-TW/reference/facade/collaboration.md)                                                                        |
| 留言              | [Comments](https://docs.univer.ai/zh-TW/reference/facade/thread-comment.md)                                                                            |
| 儲存格值、範圍、樣式與產品快照 | [資料型別](https://docs.univer.ai/zh-TW/reference/types.md)                                                                                                |
| 內容格式與初始化常數      | [常用列舉](https://docs.univer.ai/zh-TW/reference/enums.md) · [Facade 列舉目錄](https://docs.univer.ai/zh-TW/reference/facade/enums.md)                                                       |

## 初始化與設定

Univer 提供*預設模式*與*外掛模式*兩種整合方式。預設模式透過預先組合好的外掛簡化設定，更容易上手；如果**需要深度擴充**，建議使用外掛模式，依需求組合與設定外掛。

在側欄 **功能套件 → Plugins** 中查看各外掛的設定。[createUniver](https://docs.univer.ai/zh-TW/reference/methods/create-univer.md) 與 **Presets** 仍可用於便捷地載入預先組合好的外掛。

## 伺服器端與 AI 整合

後端協同與檔案轉換請從 [Server SDK](https://docs.univer.ai/zh-TW/server.md) 開始；CLI 工作流程與 AI Agent 內容操作請從 [AI SDK](https://docs.univer.ai/zh-TW/ai.md) 開始。