41 lines
2.6 KiB
Markdown
41 lines
2.6 KiB
Markdown
# 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
|