#编辑器质量路线图

A3S Office 仍处于 1.0 之前。当前优先级不是继续增加零散菜单，而是把核心编辑、文件 往返和渲染一致性做深，并为每项能力建立可重复的测试证据。

#第一优先级：文档视觉一致性

Document 的目标是同一份 DOCX 在字体可用、页面设置相同的前提下，与 WPS / Word 保持可解释、可测量的页面一致性。重点包括：

1. 字体解析、主题字体、替代字体与中西文混排。
2. 字号、字距、行高、段前段后、缩进和制表位。
3. 纸张、边距、分节、分页规则、孤行控制与自动分页。
4. 页眉页脚、页码、首页与奇偶页差异。
5. 表格宽度、行高、合并单元格、跨页续排与重复标题行。
6. 图片和浮动对象的环绕、锚点、偏移、层级与裁剪。
7. 编辑、只读预览和 PDF 导出复用同一排版结果。

验收必须使用真实 OOXML 样本、固定字体清单、固定视口和逐页截图。简单 HTML 内容或 单张页面截图不能证明整体兼容性。

#核心功能验收

#统一交互质量

所有编辑器共用的设计系统必须覆盖菜单、弹窗、颜色选择器、输入控件、滚动条、焦点环、 右键菜单和响应式布局。每个命令都要满足鼠标、键盘和可访问名称的基本要求；手机界面 不能用遮挡正文的悬浮控件代替合理布局。

#文件往返原则

• 未修改内容应尽量保持原文件语义与包结构。
• 不支持字段必须明确记录，不能无提示丢弃。
• 导入、编辑、导出后重新读取，并比较结构化结果。
• 写入失败不能覆盖源文件。
• 浏览器与本地 CLI 对同一公共语义使用兼容的类型定义。

#测试分层

类型与纯函数单元测试
  → 编辑器组件交互测试
  → 导入 / 导出往返测试
  → A3S Test 确定性 E2E
  → 固定环境视觉回归
  → WPS / Word 等参考渲染的逐页差异报告

Agentic 测试用于探索问题和形成稳定路径；确认后的流程应收敛为确定性测试。任何浏览器 会话都必须有范围地创建和清理，不能通过进程名关闭用户正在使用的 Chrome。

#发布门槛

版本发布前至少需要通过类型检查、单元测试、组件构建、Playground 构建、关键 E2E、 视觉合同和包内容校验。文档中的属性、限制与发布版本必须对应，latest 可以描述尚未 发布的主分支能力，历史版本页面则保持冻结。

完整任务清单和每项实现状态见 English 完整路线图。