# patron

**Repository Path**: gnaiq/patron

## Basic Information

- **Project Name**: patron
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-08
- **Last Updated**: 2026-03-08

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Patron PPT - 企业级智能PPT排版引擎

国内首款可私有化、全离线、自带企业级智能排版引擎的PPT生成工具。

## 核心特性

- **数据安全**：全程内网运行，核心业务数据100%不出网
- **品牌合规**：生成即符合企业VI规范，零返工、零不合规
- **提效降本**：输入文档/主题，10分钟生成可直接上台汇报的PPT
- **灵活模型配置**：支持所有 OpenAI 兼容的 API，可自定义每个模型的请求地址、请求头等
- **智能排版引擎**：内置24套专业版式，自动匹配最优布局

## 技术栈

- **后端**：Python 3.11 + FastAPI
- **前端**：Vue 3 + TypeScript + Element Plus
- **部署**：Docker + Docker Compose

## 快速开始

### 开发环境

#### 后端

```bash
cd backend
python -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate
pip install -r requirements.txt
python -m uvicorn app.main:app --reload --host 0.0.0.0 --port 8000
```

#### 前端

```bash
cd frontend
npm install
npm run dev
```

### Docker 部署

```bash
# 构建并启动
docker-compose up -d --build

# 查看日志
docker-compose logs -f

# 停止
docker-compose down
```

访问 http://localhost:3000 即可使用。

## 项目结构

```
patron-ppt/
├── backend/              # Python FastAPI 后端
│   ├── app/
│   │   ├── api/         # API 路由
│   │   ├── core/        # 核心业务逻辑
│   │   ├── models/      # 数据模型
│   │   └── services/    # 业务服务
│   └── requirements.txt
├── frontend/             # Vue3 + Element Plus 前端
│   ├── src/
│   │   ├── views/       # 页面
│   │   ├── store/       # Pinia 状态管理
│   │   └── router/      # 路由
│   └── package.json
└── docker-compose.yml
```

## 核心模块

### 1. 灵活的模型配置

不限制 provider，直接配置每个模型：

- 自定义 `base_url`
- 自定义请求头 `headers`
- 灵活的超时、重试配置
- 一键测试连接

### 2. 智能排版引擎

- 8种页面类型：封面、目录、核心论点、对比、时间线、数据清单、结尾、过渡
- 每种类型3套版式，共24套专业设计
- 自动内容自适应：字体缩放、行距调整、页面拆分
- VI规范强制锁定：色值、字体、logo、页码

### 3. PPT 渲染引擎

- 基于 Office Open XML 原生规范
- 完美兼容 WPS/Office
- 字体自动嵌入
- 原生可编辑元素

## 开发计划

- [x] 项目初始化
- [x] 灵活的模型配置模块
- [x] 24套版式配置
- [ ] 内容结构化引擎
- [ ] 智能版式决策引擎
- [ ] PPTX 渲染引擎
- [ ] 全流程集成

## 许可证

MIT License