# AI 文档模板生成系统 · 后续迭代任务拆解清单

基线版本：`a796301`

目标：把当前系统从“按 Heading 解析的模板配置工具”迭代为“占位 + 块级编辑 + 精确写回”的文档生成系统。

总工期估算：4-6 周（两人并行：前端 + 后端）

## 第一阶段：模板标准化与块级编辑（第 1-2 周）

### 模板占位体系（3-4 天）
- [ ] 定义统一占位命名规范（标题、日期、摘要、正文、表格）
- [ ] 支持封面字段占位（如 `{{ report_date }}`、`{{ report_company_name }}`）
- [ ] 支持标题字段占位（如 `{{ report_period_title }}`）
- [ ] 支持摘要块占位（如 `{{ opening_summary }}`）
- [ ] 支持正文块占位（如 `{{ section_xxx }}`）
- [ ] 输出模板占位说明文档

### 模板解析器升级（3-5 天）
- [ ] 同时识别 Heading、显式占位、固定文本块
- [ ] 识别封面区域与正文区域
- [ ] 识别未设置 Heading 的疑似二级小节
- [ ] 为每个块记录原始锚点与块类型
- [ ] 输出新的块级结构 JSON

### 块级模板编辑器（5-7 天）
- [ ] 支持固定块 / AI 块 / 标题块 / 摘要块显示
- [ ] 支持新增块
- [ ] 支持删除块
- [ ] 支持块上移 / 下移
- [ ] 支持块间插入 AI 块
- [ ] 支持块内容手动编辑
- [ ] 支持块写入方式配置（仅标题 / 插入 / 替换）
- [ ] 支持保存块级模板结构

## 第二阶段：导出精确写回与模板体检（第 2-3 周）

### Word 写回引擎升级（5-7 天）
- [ ] 标题单独替换
- [ ] 日期单独替换
- [ ] 摘要块单独替换
- [ ] AI 块按位置精确写回
- [ ] 固定块完全保留
- [ ] 同一锚点下多块顺序写回
- [ ] 表格块精确填充
- [ ] 混合块（文字 + 表格）顺序写回

### 模板体检工具（3-4 天）
- [ ] 检查未设置 Heading 的小节
- [ ] 检查缺失占位的可变字段
- [ ] 检查会被并入上一级的正文块
- [ ] 检查重复锚点与歧义标题
- [ ] 给出修复建议列表
- [ ] 在模板上传后展示体检结果

### 模板修复辅助（2-3 天）
- [ ] 一键将疑似标题转为独立块
- [ ] 一键将日期识别为变量占位
- [ ] 一键将开篇摘要识别为 AI 摘要块
- [ ] 一键补充推荐占位名

## 第三阶段：生成体验与结果编辑（第 3-4 周）

### 执行生成体验优化（2-3 天）
- [ ] 按段落记忆最近使用文件
- [ ] 历史文件默认折叠 + 已选数量提示
- [ ] 已选文件去重与快速复用
- [ ] AI 段落与人工段落展示区分更明显

### 生成编排增强（3-4 天）
- [ ] 多块并发生成调度
- [ ] 按块重试与失败回退
- [ ] 按块取消 / 跳过生成
- [ ] 开篇摘要优先生成或最后汇总生成

### 预览编辑页增强（4-5 天）
- [ ] 支持按块查看生成结果
- [ ] 支持单块重新生成
- [ ] 支持恢复模板默认内容
- [ ] 支持标记固定块 / AI 块来源
- [ ] 支持导出前最终校对

## 第四阶段：模型能力与运维增强（第 4-5 周）

### 模型管理增强（2-3 天）
- [ ] 常用厂商预设（DeepSeek / OpenAI / Anthropic / 自定义）
- [ ] 常用模型名预设
- [ ] 不同厂商默认 API 地址模板
- [ ] 测试结果摘要化展示
- [ ] DeepSeek 余额缓存与刷新时间展示

### AI 服务增强（3-4 天）
- [ ] 提示词模板分层（系统 / 模板 / 块 / 文件）
- [ ] 文件摘要生成增强（Excel / PDF / Word）
- [ ] 多模型回退策略
- [ ] 单块超时与重试策略优化
- [ ] 生成日志与错误诊断信息增强

## 第五阶段：质量与交付（第 5-6 周）

- [ ] 真实模板专项联调（公司经营分析报告、财务分析报告等）
- [ ] 多级报告模板兼容性测试
- [ ] 未规范模板的降级策略验证
- [ ] 导出结果与原 Word 样式一致性验收
- [ ] 错误提示与异常恢复完善
- [ ] 使用手册与模板制作指南整理

## 阶段交付物

| 阶段 | 交付物 |
|------|--------|
| 第 1-2 周 | 块级模板结构、占位规范、可编辑模板画布 |
| 第 2-3 周 | 精确写回导出引擎、模板体检与修复辅助 |
| 第 3-4 周 | 完整生成与预览编辑闭环 |
| 第 4-5 周 | 模型管理增强、AI 调用稳定性提升 |
| 第 5-6 周 | 真实模板全流程验收、交付文档 |