ax-frontend-app/docs/新编辑器实现路线图.md

编辑器后续实现路线图

1. 当前基线

块编辑器已经替代旧的 MDXEditor，并完成以下基础能力：

• 文档 blocks 加载、渲染、更新和保存。
• 标题、段落、列表和富文本格式。
• 表格结构编辑、合并拆分、尺寸调整。
• 图片上传、替换、尺寸和对齐。
• 目录、大纲、自动保存和失败重试。
• Word、PDF、Markdown 导出。
• 面板懒加载、拖动节流和图片 CLS 优化。

当前路线图从“迁移工程”改为“现有编辑器的增量增强”，不再安排 Feature Flag、MDXEditor 删除或新目录搭建任务。

2. 优先级

P0：稳定性和正确性

• 为表格视觉坐标、混合合并和拆分补充自动化测试。
• 修正 package.json 中指向不存在测试文件的命令。
• 补充编辑器加载、保存、失败重试和关闭确认的集成测试。
• 明确后端 blocks API 的响应、错误和权限契约。
• 评估图片 Data URL 对请求体大小、内存和数据库存储的影响。

P1：编辑体验

• 增加可撤销的编辑历史，先定义与自动保存的边界。
• 改进块级移动和键盘导航。
• 完善表格 Tab 导航、跨合并区域选择和可访问性。
• 对长文档评估虚拟化或分段渲染，使用真实性能数据决定是否引入库。
• 增加导出结果和错误状态的可观测性。

P2：协作和扩展

• 多人协同编辑和冲突解决。
• 文档版本、回滚和审计记录。
• 搜索替换、批量格式化和评论。
• 权限、认证上下文和用户隔离。

3. 每项功能的交付要求

新增功能必须同时提供：

1. 类型和 API 契约。
2. UI 状态和失败状态。
3. 与自动保存的交互规则。
4. 至少一个行为测试或可重复的手动验证步骤。
5. 对 Markdown、Word、PDF 导出的影响说明。
6. 性能和安全影响评估。
7. 对 编辑器开发手册 的必要更新。

4. 建议实施顺序

修正测试脚本和补充核心测试
  -> 稳定表格与保存协议
  -> 改善键盘导航和块操作
  -> 评估长文档渲染策略
  -> 增加撤销/重做
  -> 完善权限和后端代理
  -> 再考虑协同、版本和搜索

5. 不应直接执行的旧计划

以下旧计划已失效：

• 安装 @dnd-kit、react-window 或 use-debounce。
• 增加 VITE_USE_NEW_EDITOR Feature Flag。
• 保留 WYSIWYGEditor 或 EditorPanel.backup。
• 把表格从原生 table 改回 CSS Grid。
• 按固定 10 周计划标记功能完成。

这些内容来自迁移阶段，不代表当前代码库的工作方式。

6. 发布门槛

合并前至少执行：

npm run build
npm run lint
npm run format:check
npm run test

涉及首屏、导出或长列表时，还应执行生产预览和性能审计：npm run serve:prod。发布前必须确认生产环境不把 AI 或工作流 API key 直接放进前端构建产物。