# 编辑器后续实现路线图

## 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. 对 [编辑器开发手册](./新编辑器开发手册.md) 的必要更新。

## 4. 建议实施顺序

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

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

以下旧计划已失效：

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

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

## 6. 发布门槛

合并前至少执行：

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

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