Univer AI Agent 集成上线前验收清单：2026 Mac 浏览器回归

上线前应分别验证编辑器状态、Agent 操作边界、Mac 浏览器交互、异常恢复和回归证据；不要因为一次演示成功就判定集成可以上线。只有当测试环境覆盖了产品承诺的 macOS 与浏览器组合，并且每项关键操作都留有可复核记录时，验收结论才适用于该组合。

Univer 集成开发者：需要确认 Agent 如何读取、修改和提交编辑器内容。
QA 工程师：需要制定 Mac 浏览器测试用例，并能记录失败现场。
产品技术负责人：需要在上线前核对权限、恢复路径和验收证据是否齐全。

Univer AI Agent 验收：按实际编辑流程划定边界

先把用户会完成的任务写成流程，而不是从 Agent 的演示提示词开始。以在线表格为例，可以从用户选择数据区域、请求生成摘要，到 Agent 提出修改、用户确认、编辑器显示变更，再到保存结果逐步拆解；如果产品还包含文档或演示文稿，就为各自最常用的编辑任务单独列用例。

Univer 官方仓库介绍了可组合的办公编辑器、插件体系和 Facade API；表格快速入门文档说明，数据修改应通过命令执行，并介绍了保存文档快照的方式。它们能帮助团队确认 SDK 层面的产品结构，却不能证明项目中的 Agent 已经实现某个权限规则、确认弹窗、撤销流程或可靠保存机制。应以Univer 官方仓库和表格快速入门文档核对所用版本的公开能力，再用项目自身的实现和测试结果确定验收范围。

验收路径	能回答的问题	能提供的证据	不能单独证明什么
人工操作真实流程	用户能否完成目标任务，界面反馈是否清楚	操作录屏、前后状态截图、步骤记录	多次运行都稳定
自动化浏览器用例	指定步骤能否重复执行，断言是否符合预期	测试报告、错误日志、运行环境	真实 Safari 的全部行为
实际 Mac 浏览器回归	目标部署环境中的交互是否符合产品承诺	系统及浏览器版本、用例结果、缺陷记录	未测试的系统与浏览器组合

先列出用户发起、Agent 执行和用户确认的操作，再写清各步骤通过什么信号判定成功。若某项行为由项目自定义代码完成，验收依据应是项目接口、日志和实际结果，而不是把它归为 Univer 的默认能力。官方核心功能说明可用于核对公开功能范围；具体功能仍要与项目安装版本和插件配置逐项对照。

编辑前后状态：用可比较的结果验收

对于表格任务，应在执行前固定工作簿、工作表、选区和目标数据的状态；至少记录目标单元格的值、公式或格式，以及产品可提供的保存状态。Agent 执行后，要核对编辑器呈现的内容和项目实际保存结果，避免只凭 Agent 返回“已完成”就通过。

成功之外还要覆盖取消与重复执行：取消后不应留下未授权的部分修改；同一请求被重新提交后，不应在没有预期的情况下继续叠加内容或重复格式操作。可借助自定义命令扩展说明核对项目是否通过命令扩展编辑行为，但验收应针对实际接入的命令与处理逻辑，不能由文档推断业务数据一定已保存。

• [ ] 操作前记录初始状态、目标区域和发起请求。
• [ ] 操作后对照单元格内容、公式、格式和保存状态。
• [ ] 分别执行成功、用户取消、操作失败和重复提交用例。
• [ ] 保存足以复查的前后截图、结构化数据或应用日志。
• [ ] 若界面状态与保存结果不一致，先标记失败，不以 Agent 的文字回复替代数据核验。

⚠️ 若项目没有能读取或导出编辑器当前状态的验证途径，先补上可复核的验收信号；否则截图看似正确，也不能说明服务端已持久化相同内容。

权限与误操作：区分产品设计和已实现行为

权限检查要从产品定义开始：哪些数据允许 Agent 读取，哪些操作可以直接执行，哪些必须经过用户确认，哪些无论收到什么指令都应被拒绝。随后为每条规则设计正向和反向用例，例如允许修改指定区域，同时验证对授权范围以外区域的修改请求会被拦截。

这是一套验收设计，不是对 Univer 内置权限机制的断言。若权限由应用后端、身份系统或自定义 Agent 工具实现，应检查实际授权决策、执行主体和日志；只在界面隐藏某个按钮，不足以证明后端也拒绝了越权请求。还要验证失败后的停止条件：遇到拒绝、超时或部分执行失败时，后续操作是否会继续，用户能否看懂哪些内容已经改变。

团队可把风险较高的操作单独列出，例如批量清除、覆盖公式、删除内容或改变共享文件。先明确需要确认的条件和预期提示，再逐项测试；若产品本来不支持某项防护，就应如实记录为产品决策或上线风险，而非写成已具备的能力。

Mac 浏览器交互：测试实际支持的环境组合

浏览器回归不能只检查页面是否打开。应在目标 macOS 浏览器和实际部署环境中逐项检查编辑器焦点是否按预期移动、快捷键是否触发正确动作、滚动是否落在正确容器、弹层是否遮住关键控件，以及窗口尺寸变化后工具栏与编辑区是否仍可操作。键盘操作的焦点顺序也值得纳入验收；W3C 焦点顺序说明强调，顺序应保留内容的含义和可操作性。

回归方式	适合承担的检查	主要边界	验收记录
自动化 WebKit 项目	重复执行基础交互、验证断言和捕获失败	WebKit 构建不等于实际 Safari；操作系统行为也可能不同	测试框架、浏览器构建、运行平台与报告
实际 Mac 浏览器	检查产品承诺的浏览器、系统交互和部署表现	结论仅适用于实测组合	macOS 版本、浏览器版本、部署环境、用例结果
桌面端人工探索	发现焦点、滚动、弹层和布局等非预期问题	覆盖范围容易不完整，不易自动复现	操作步骤、录屏或截图、复现条件

浏览器自动化工具的浏览器说明区分了 WebKit 测试构建与实际 Safari，并指出要贴近 Safari 的测试，应在 Mac 上运行 WebKit。它适合帮助团队选择自动化回归层，但不能据此把一次 WebKit 通过写成 Safari 兼容结论。对于键盘操作，可参考网页焦点顺序的无障碍检查思路，再按编辑器自己的交互模型定义预期行为。

如果自动化覆盖多个浏览器，应记录每个运行项目的实际配置，并让关键人工用例补足自动化没有覆盖的系统交互。真实 Mac 上的网页检查工具说明可用于检查页面资源、运行状态和 JavaScript；若测试窗口切换或后台恢复，还可结合页面可见性接口说明检查页面从前台切换到后台后的行为。以上资料说明的是检查手段，不是对特定 Univer 集成兼容性的证明。

异常恢复：验证中断后状态是否可控

网络异常测试的重点不是“断网后页面有没有报错”，而是恢复时数据是否仍可解释、可核对。分别在 Agent 执行前、执行中和收到结果后模拟连接中断或页面刷新；检查任务状态、编辑器内容和保存结果是否一致，并确认界面有没有提示未完成操作。

• [ ] 中断后恢复页面，确认已提交内容和未提交内容能否区分。
• [ ] 在请求无响应时再次提交，确认重复请求不会导致未预期的二次修改。
• [ ] 执行过程中切换页面或刷新，核对 Agent 任务是否继续、停止或允许安全重试。
• [ ] 对照客户端与服务端日志，标出每个操作的开始、结束、失败或取消结果。
• [ ] 检查失败后是否继续执行队列中的后续动作，以及操作者能否明确停止任务。

提醒：自动重试能让测试更容易暴露间歇性失败，但不能把重试后通过当成首次执行成功。重试机制说明会区分首次失败后重试通过的波动用例；项目验收也应保留首次失败和最终结果，避免掩盖不稳定性。

验收记录：让上线结论可以追溯

每条用例都应有唯一编号，并记录目标环境、前置状态、执行步骤、预期结果、实际结果和缺陷链接。环境至少要写明项目构建或部署版本、macOS 版本、目标浏览器及其版本、测试数据标识；如果使用自动化，还应记录框架与浏览器构建信息。自动化测试的隔离也很重要：独立的浏览器上下文有助于减少会话、存储状态互相污染，相关做法可参照测试上下文隔离说明。

记录字段	应写入的内容	复核目的
用例与前置条件	用例编号、文件状态、账号权限、初始选区	确认场景可重现
目标环境	部署版本、操作系统与浏览器的实际版本	限定结论适用范围
预期与实际结果	操作前后内容、权限结果、恢复表现	判断是否满足项目要求
证据与缺陷	日志、截图或录屏、缺陷链接、复测记录	追踪失败与修复情况
判定与批准	通过、失败、阻塞或风险接受及负责人	留存上线决策依据

项目团队应按产品风险和自身上线要求定义通过标准；不存在适用于所有 Univer 集成的统一通过率或固定性能阈值。若发生浏览器、操作系统、编辑器依赖或部署配置更新，应重新运行受影响的用例，并让报告标明新的环境组合。验收结论只覆盖记录中实际验证的条件，不能外推到未测过的浏览器版本。

常见验收疑问

Univer 接入 AI Agent 后，验收要覆盖什么？

按实际用户流程覆盖编辑器状态、Agent 请求与执行边界、危险操作确认、失败停止和结果保存。对于项目自定义的权限与工作流，要用接口行为和实测证据说明，不要把 SDK 文档里介绍的编辑器能力当成集成已经支持的功能。

怎样确认 Agent 修改在线表格的结果正确？

对比操作前后的目标单元格、公式、内容、格式和保存状态，并保留相应截图、数据快照或日志。还要测试取消、失败和重复提交；若只能看到 Agent 的完成提示，却无法核对编辑器或保存结果，验收证据就不充分。

Mac 浏览器回归应该检查哪些交互？

检查焦点、键盘快捷键、滚动容器、弹层、页面布局以及窗口状态变化，并针对实际支持的 macOS 和浏览器组合记录结果。自动化测试通过不能替代未实际运行过的浏览器验证，测试报告也不应宣称覆盖未验证的组合。

怎样检查集成在异常中断后能否恢复？

分别模拟断网、刷新、重复请求和页面状态变化，对照任务日志、编辑器内容与保存结果，确认哪些修改已完成、哪些应被停止或重试。把重复执行造成额外修改、无法判断保存状态和失败后仍继续操作列为缺陷或风险，再由项目团队决定是否满足上线标准。

为真实 Mac 回归选择合适环境

若当前流程只依赖 Linux 或其他非 Mac 自动化环境，它可能无法替代目标用户实际使用的 Mac 浏览器检查；若团队仅在开发者本机手动测试，又容易缺少固定环境记录和可复现流程。频繁、长期运行的测试集适合评估自有设备；仅在发布前或问题复现时需要 Mac 环境的团队，可以比较设备采购、维护和临时测试安排，再决定是否租用。

在执行真实 Mac 回归前，可先查看 nuvcloud 的 Mac 方案概览，按项目需要了解环境；若决定采用按需租用，也可核对 Mac mini 方案与价格。只有当测试目标确实需要 Mac 环境、且实际浏览器和部署组合能够在环境中核验时，租赁 nuvcloud 的 Mac 才是替代临时拼凑设备的一种务实选择；若测试需要持续高负载运行或依赖特定物理接口，则应优先评估自购设备或专用实验室。

常见问题

Univer 接入 AI Agent 后，验收时应覆盖哪些行为？

先按产品真实流程检查 Agent 的读取、修改、取消和失败表现，再核对修改是否反映在编辑器模型与保存结果中。还要验证授权范围、危险操作确认、重复提交和异常中止。具体能力以项目接入方式与所用版本为准，官方 SDK 能力不能代替对自定义 Agent 流程的实测。

怎样确认 AI Agent 修改在线表格后，结果确实正确？

为测试文件准备可辨认的初始状态，记录目标单元格、内容、格式与保存状态；执行 Agent 操作后，逐项检查可见界面和可复核的数据快照。另做取消、失败和重复执行用例，保存输入、操作记录及前后对照。只看聊天回复成功，无法证明表格实际状态正确。

Mac 浏览器回归应该重点检查哪些交互？

在项目支持且实际安装的 macOS 与浏览器组合中，检查焦点进出编辑器、键盘快捷键、滚动、弹层遮挡、窗口尺寸变化及保存提示。记录系统和浏览器版本、部署环境与用例结果。自动化 WebKit 测试不等于 Safari 实测，因此需要按产品承诺补足真实浏览器验证。

如何验证 Univer 集成遇到断网或刷新后能否恢复？

先确认操作处于什么阶段，再分别模拟断网、刷新、页面切换和重复提交，检查恢复后是否保留已提交更改、是否提示未完成任务，以及重试是否产生额外修改。保存控制台与服务端日志、前后状态及复现步骤；恢复能力应按项目实际实现验收，不要假设编辑器或 Agent 自动提供。