浏览器支持¶

Mathware 平台是一套基于 Web 的企业内网应用，前端采用 React 18 + Ant Design 5.x 构建，并集成了 OnlyOffice 在线文档编辑器 与 WebSocket 实时通信 能力。为确保所有功能正常运行，请使用以下推荐的浏览器及版本。

推荐浏览器¶

浏览器	最低版本	推荐版本	说明
Google Chrome	80	最新稳定版	首选浏览器，兼容性最佳
Microsoft Edge	80	最新稳定版	基于 Chromium，推荐企业用户使用
Mozilla Firefox	72	最新稳定版	支持所有核心功能
Apple Safari	13	最新稳定版	仅限 macOS 用户

功能兼容性说明¶

平台各核心功能对浏览器的具体依赖如下：

基础界面¶

平台前端基于 React 18 与 Ant Design 5.x 构建，需要浏览器支持以下现代 Web 标准：

• ES2017+ 语法（async/await、Promise 等）
• CSS Grid 与 Flexbox 布局
• Fetch API

上述特性在 Chrome 80+、Edge 80+、Firefox 72+、Safari 13+ 中均已原生支持。

OnlyOffice 在线编辑器¶

"交互式表格界面"计算模式通过在页面内嵌入 OnlyOffice 文档编辑器 实现，采用 iframe + PostMessage 通信方式。该功能额外要求：

• 浏览器允许同源 iframe 嵌入（请勿开启屏蔽 iframe 的安全插件）
• 启用 JavaScript（OnlyOffice 编辑器依赖 JS 渲染）
• 推荐使用 Chrome 80+ 或 Edge 80+，以获得最佳的表格编辑性能

实时通知与计算进度¶

平台通过 WebSocket 连接向浏览器实时推送计算进度、状态变更与通知公告。使用该功能需要：

• 浏览器支持 WebSocket 协议（所有推荐浏览器均已内置支持）
• 网络环境允许 WebSocket 长连接（如有企业防火墙，请确认 WebSocket 端口未被拦截）
• 客户端心跳间隔为 30 秒，若连接长时间中断，页面将自动提示重连

文件上传与下载¶

大文件（算稿 XLSX/MCDX 等）通过 预签名 URL 直传 到对象存储，绕过后端服务器：

• 上传：浏览器直接向内网文件服务（RustFS）发起 PUT 请求
• 下载：浏览器通过有效期为 5 分钟的临时预签名链接下载文件
• 要求浏览器支持 XMLHttpRequest 或 Fetch API 的跨域请求（平台已配置 CORS）

不支持的环境¶

以下环境 不受支持 ，可能导致页面功能异常或无法正常使用：

系统与屏幕建议¶

常见问题¶