常见问题 · Norio Office

为什么提示字体配置错误

fontUrls 必须同时提供 text、symbols、emoji、cjk 四项，且字体文件字节与当前组件版本配套。只有文件名相同不够，组件还会校验 SHA-256。

先在浏览器网络面板检查四个地址是否返回字体文件，而不是 404 页面或登录页；跨域资源需要允许应用访问。如果请求正常但校验失败，请使用当前版本交付的字体，不要自行替换。完整配置见快速开始。

除了字体，还要部署 Worker 和 WASM。Vite 项目按快速开始配置 officeWordAssets()；其他构建工具需要保留完整运行资源及相对路径。检查资源请求、跨域策略和控制台报错，不能只复制单个 Worker 文件。

v-model 只把内容更新交给应用，不会替你写入数据库。请接入保存接口，并在重新打开文档时加载保存的数据。不要只保存纯文本，否则会丢失排版和其他结构。

先用保存与常用场景中的例子理解读写流程，再接入自己的存储服务。

可以按文件导入与导出使用 DOCX 相关接口。旧版二进制 .doc 不在支持范围内；HTML 形式的 .doc 与二进制 .doc 是两种不同文件，不能只看扩展名判断。

复杂文件的字体、字段、对象等可能有兼容性差异。建议用实际文件走一遍“导入 → 修改 → 导出 → 重开”，检查结果后再接业务流程。

编辑器提供编辑目标与 AI Bridge，聊天窗口、模型调用和工具注册由你的应用实现。按钮不会自动连接模型。按AI 原子级修改连接当前编辑器实例，读取目标后提交局部操作。

需要。操作回执表示编辑器接受了修改，不表示数据库或原始文件已更新。成功后仍需走应用的保存流程。如果目标过期或文档已变化，应重新读取并准备操作，不要重复提交旧目标。

预览模式主要控制编辑器交互。文件读写接口、用户身份及资源访问权限仍由应用和服务端校验，不能用隐藏按钮代替权限控制。参数说明见组件参数与事件。

需要部署 Docker 版本，使用与组件匹配的协作服务，并配置用户身份、文档 ID、访问权限和持久化。只安装前端包不会自动产生协作服务。部署要求见Docker 协作说明。