For AI agents: the complete documentation index is available at https://a3s-lab.github.io/Office/docs/0.38.0/llms.txt, the full documentation bundle is available at https://a3s-lab.github.io/Office/docs/0.38.0/llms-full.txt, and this page is available as Markdown at https://a3s-lab.github.io/Office/docs/0.38.0/components/index.md.

组件接入

所有框架绑定都使用同一套受控内容模型。适配层只转换属性和事件约定,不会维护 第二份编辑器实现。

框架绑定

框架导入路径内容绑定
React@a3s-lab/office/reactcontentonChange
Vue@a3s-lab/office/vuev-model:content,或 content@change
Web Component@a3s-lab/office/web-component.contentchange 事件

多人实时协作

多人实时协作适用于全部五种编辑器和三种框架绑定。同一个 宿主拥有的 Yjs 会话可以连接两台浏览器、在线成员与远端位置,也可以让 CLI、MCP 或 A3S Code 的 Yrs 副本加入。Document 审阅者可以创建实名选区评论、回复、解决或 重开,并删除自己的记录,同时保持正文只读。经过认证的建议者还可以提交署名插入、 删除和替换提案,但不能获得规范格式或最终决定权限;编辑者接受或拒绝后会形成不可变 审计记录。文档还说明房间认证、权限边界、首次初始化、断线重连、离线收敛和当前原生 智能体限制。

需要把这些宿主职责直接落地时,可以运行 A3S Boot 实时协作后端。它包含鉴权 WebSocket 房间、 Yrs 持久化、Awareness 转发、浏览器适配器和绑定参与者身份的房间协议。

接入对象公开边界宿主仍然负责
共享内容collaboration房间、Provider、Y.Doc 与持久化
在线成员和位置presenceAwareness 传输与成员身份
原生智能体CLI / MCP 协作副本授权、投递与审计策略

可用编辑器

产品组件内容类型
文档DocumentEditorDocumentContent
MarkdownMarkdownEditorMarkdownContent
表格SpreadsheetEditorSpreadsheetContent
演示文稿PresentationEditorPresentationContent
PDFPdfViewer输入、输出均为 Blob

通用界面属性

属性类型默认值说明
theme'light' | 'dark' | 'system''system'编辑器配色模式。
classNamestringReact 宿主元素类名;Vue 与 Web Component 使用普通 class
styleCSSPropertiesReact 宿主元素行内样式;编辑器会填满该元素。
previewbooleanfalse受控编辑器的只读模式。
saveStatusstring各编辑器不同由宿主提供的保存状态。
fileActionsreadonly OfficeFileAction[][]保存、导出、历史记录或审批等宿主文件操作。