zhouwentao
/
doc-forge-remark
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
doc-forge-remark/docs/需求与设计/00-项目概述.md

2.6 KiB
Raw Blame History

AI 文档模板生成系统 · 项目概述

一句话

上传 Word 模板 → AI 自动解析段落结构 → 配置各段落生成规则 → 上传参考文件 → AI 并行生成 → 在线预览编辑 → 导出保留原始样式的 Word 文档。

核心架构

┌─────────────────────────────────────────────────────┐
│                  前端 Vue 3 + Ant Design Vue         │
│  模板管理  模型管理  执行生成  生成记录  预览编辑    │
└────────────┬───────────────────────────┬────────────┘
             │ REST API + SSE 进度       │
             ▼                           ▼
┌─────────────────────────────────────────────────────┐
│              后端 FastAPI + SQLAlchemy               │
│  模板解析 → 段落管理 → AI 调度 → 文档生成 → 导出    │
└─────────────────────────────────────────────────────┘

核心流程（7步闭环）

  1. 上传模板 — 上传 .docx → 解析段落结构 + 完整样式 → 存库
  2. 段落标注 — 三栏编辑器：左栏点段落→中栏定位→右栏配置（编辑方式/模型/提示词/参考文件）
  3. 保存模板 — 段落配置持久化
  4. 执行生成 — 选模板 → 按需上传参考文件 → 启动生成
  5. 并行生成 — 无依赖段落同时请求 AI，SSE 实时推进度
  6. 预览编辑 — 富文本编辑器查看结果，手动精修
  7. 导出 Word — 基于原模板替换内容，样式零损失

关键设计决策

决策 选择 原因
段落边界 Word 内置标题样式 (Heading 1~6) 最稳定，用户学习成本低
输出格式 AI 返回结构化 JSON 支持文字+表格混合，后端可控解析
导出策略 基于原模板替换内容 样式零损失，不限模板格式
生成方式 多段落并行请求 AI 大幅缩短等待时间
样式保留 导出时读取原模板段落样式映射 精度最高

技术栈

  • 前端: Vue 3.4 + Vite 5 + TypeScript + Ant Design Vue 4.x + Pinia + Axios
  • 后端: Python 3.11+ + FastAPI + SQLAlchemy 2.0 (async) + SQLite + python-docx + openpyxl + httpx