# 协同编辑

- Human documentation: [https://docs.univer.ai/zh-CN/guides/docs/features/collaboration](https://docs.univer.ai/zh-CN/guides/docs/features/collaboration)

- Agent Markdown: [https://docs.univer.ai/zh-CN/guides/docs/features/collaboration.md](https://docs.univer.ai/zh-CN/guides/docs/features/collaboration.md)

- Requested language: `zh-CN`

- Content language: `zh-CN`

- Documentation version: `1.0.0-rc.0`

- Source: [docs/features/collaboration.zh-CN.mdx](https://github.com/dream-num/documentation/blob/dev/content/guides/docs/features/collaboration.zh-CN.mdx)

---

#### Package metadata

```json
{
  "preset": [
    {
      "client": "@univerjs/preset-docs-collaboration",
      "locale": "@univerjs/preset-docs-collaboration/locales/zh-CN",
      "style": "@univerjs/preset-docs-collaboration/lib/index.css"
    }
  ],
  "plugins": [
    {
      "client": "@univerjs-pro/collaboration"
    },
    {
      "client": "@univerjs-pro/collaboration-client",
      "facade": "@univerjs-pro/collaboration-client/facade",
      "locale": "@univerjs-pro/collaboration-client/locale/zh-CN"
    },
    {
      "client": "@univerjs-pro/collaboration-client-ui",
      "facade": "@univerjs-pro/collaboration-client-ui/facade",
      "locale": "@univerjs-pro/collaboration-client-ui/locale/zh-CN",
      "style": "@univerjs-pro/collaboration-client-ui/lib/index.css"
    }
  ],
  "license": true,
  "server": true
}
```

协同编辑需要前端编辑器和服务端共同接入。请先按[协同集成](https://docs.univer.ai/zh-CN/server/collaboration/browser-integration.md)运行示例，再接入业务身份、权限和数据存储。前后端的配置代码见 [Office 快速开始](https://docs.univer.ai/zh-CN/server/collaboration/quick-start.md)。

文档由经过认证的业务 API 创建。前端拿到服务端返回的 Unit 标识后，使用下面的方法加载；再次打开同一份文档时，继续使用这个标识。

## Facade API

```ts
import '@univerjs-pro/collaboration-client/facade'

const collaboration = univerAPI.getCollaboration()
const unit = await collaboration.loadDocAsync('your-unit-id')
```

[Node.js / AI SDK](https://docs.univer.ai/zh-CN/ai/content-operations.md) · [OT](/blog/ot)