Initial commit: GovAI 政务AI平台

2026-06-15 23:48:37 +08:00
commit 0f490f72a9
245 changed files with 51669 additions and 0 deletions
@@ -0,0 +1,94 @@
+# PPT Worker 微服务
+
+PPT Master 管线的 HTTP 服务封装，作为 GovAI 平台的 PPT 生成后端。
+
+## 架构
+
+```
+GovAI 前端 → Go 后端 → Redis 队列 → PPT Worker → PPTX 文件
+```
+
+Worker 接收任务后执行完整 PPT Master 管线：
+1. **源内容转换** — PDF/DOCX/URL/文本 → Markdown
+2. **项目初始化** — 创建 PPT Master 项目结构
+3. **策略师阶段** — LLM 生成设计规范 + 执行锁定
+4. **图片获取** — AI 生图（可选）
+5. **执行器阶段** — LLM 逐页生成 SVG
+6. **后处理导出** — SVG 质量检查 → finalize → 导出 PPTX
+
+## 快速开始
+
+### 前置条件
+
+- Python 3.10+
+- PostgreSQL（GovAI 数据库）
+- Redis
+- PPT Master 项目（`/Users/freedak/Documents/go-new/ppt-master`）
+
+### 安装
+
+```bash
+cd ppt-worker
+python3 -m venv venv
+source venv/bin/activate
+pip install -r requirements.txt
+```
+
+### 配置
+
+```bash
+cp .env.example .env
+# 编辑 .env，填入数据库、Redis、LLM API Key 等配置
+```
+
+### 启动
+
+```bash
+# 同时启动 HTTP API + Worker
+python app.py
+
+# 或仅启动 Worker（不含 HTTP API）
+python worker.py
+```
+
+### Docker
+
+```bash
+cd docker
+docker compose up -d ppt-worker
+```
+
+## API
+
+| 方法 | 路径 | 说明 |
+|------|------|------|
+| POST | `/api/tasks` | 创建文本/URL 任务 |
+| POST | `/api/tasks/upload` | 创建带文件上传的任务 |
+| GET | `/api/tasks/{id}` | 查询任务状态 |
+| GET | `/api/tasks/{id}/download` | 下载 PPTX 文件 |
+| GET | `/health` | 健康检查 |
+
+## 环境变量
+
+| 变量 | 默认值 | 说明 |
+|------|--------|------|
+| `WORKER_PORT` | 8090 | HTTP 服务端口 |
+| `WORKER_CONCURRENCY` | 2 | 并发处理数 |
+| `DATABASE_URL` | - | PostgreSQL 连接串 |
+| `REDIS_URL` | redis://localhost:6379/0 | Redis 连接串 |
+| `PPT_MASTER_PATH` | - | PPT Master 项目路径 |
+| `OPENAI_API_KEY` | - | DashScope API Key（LLM + 图片共用） |
+| `OPENAI_BASE_URL` | https://dashscope.aliyuncs.com/compatible-mode/v1 | 千问 OpenAI 兼容端点 |
+| `OPENAI_MODEL` | qwen-max | 千问模型（推荐 qwen-max / qwen-plus） |
+| `IMAGE_BACKEND` | wanx | 图片后端（`wanx` 通义万相 / 其他回退脚本） |
+| `WANX_MODEL` | wanx-v1 | 万相模型名 |
+| `IMAGE_API_KEY` | （空，复用 OPENAI_API_KEY） | 单独的图片 API Key（可选） |
+
+### 千问模型推荐
+
+| 模型 | 上下文 | 适用场景 |
+|------|--------|---------|
+| `qwen-max` | 128K | SVG 生成首选，质量最好 |
+| `qwen-plus` | 128K | 性价比之选 |
+| `qwen-long` | 10M | 超长文档输入 |
+| `qwen-turbo` | 128K | 速度优先 |