|
|
---
|
|
|
title: PPTist Huggingface
|
|
|
emoji: 📊
|
|
|
colorFrom: blue
|
|
|
colorTo: purple
|
|
|
sdk: docker
|
|
|
pinned: false
|
|
|
license: agpl-3.0
|
|
|
app_port: 7860
|
|
|
tags:
|
|
|
- presentation
|
|
|
- ppt
|
|
|
- powerpoint
|
|
|
- slides
|
|
|
- editor
|
|
|
---
|
|
|
|
|
|
# PPTist Huggingface Space
|
|
|
|
|
|
一个基于 PPTist 的在线演示文稿编辑器，部署在 Huggingface Space 上，支持多用户登录和 GitHub 数据存储。
|
|
|
|
|
|
## 🎯 项目特点
|
|
|
|
|
|
- **多用户支持**: 内置4个测试账号（PS01-PS04）
|
|
|
- **GitHub存储**: 使用GitHub仓库作为数据存储后端
|
|
|
- **公网分享**: 每个PPT页面都有独立的公网URL
|
|
|
- **完整功能**: 保留PPTist的所有编辑和展示功能
|
|
|
- **Docker部署**: 一键部署到Huggingface Space
|
|
|
|
|
|
## 🔑 测试账号
|
|
|
|
|
|
| 用户名 | 密码 | 角色 |
|
|
|
|--------|------|------|
|
|
|
| PS01 | admin_cybercity2025 | 管理员 |
|
|
|
| PS02 | cybercity2025 | 用户 |
|
|
|
| PS03 | cybercity2025 | 用户 |
|
|
|
| PS04 | cybercity2025 | 用户 |
|
|
|
|
|
|
## 🚀 部署说明
|
|
|
|
|
|
### 环境变量配置
|
|
|
|
|
|
在 Huggingface Space 的 Settings 中设置以下环境变量：
|
|
|
|
|
|
```bash
|
|
|
GITHUB_TOKEN=你的GitHub访问令牌
|
|
|
GITHUB_REPOS=https://github.com/CaPaCaptain/PPTist_huggingface_db
|
|
|
JWT_SECRET=pptist-secret-key-2025-huggingface
|
|
|
NODE_ENV=production
|
|
|
```
|
|
|
|
|
|
### GitHub 仓库设置
|
|
|
|
|
|
1. 创建一个 GitHub 仓库用于存储 PPT 数据
|
|
|
2. 生成 GitHub Personal Access Token，需要 `repo` 权限
|
|
|
3. 在仓库中创建 `users/` 目录结构
|
|
|
|
|
|
### 数据存储结构
|
|
|
|
|
|
```
|
|
|
仓库根目录/
|
|
|
├── users/
|
|
|
│ ├── PS01/
|
|
|
│ │ ├── ppt1.json
|
|
|
│ │ └── ppt2.json
|
|
|
│ ├── PS02/
|
|
|
│ │ └── presentation.json
|
|
|
│ └── ...
|
|
|
```
|
|
|
|
|
|
## 📡 API 接口
|
|
|
|
|
|
### 认证接口
|
|
|
- `POST /api/auth/login` - 用户登录
|
|
|
- `GET /api/auth/verify` - 验证token
|
|
|
- `GET /api/auth/user` - 获取用户信息
|
|
|
|
|
|
### PPT管理接口
|
|
|
- `GET /api/ppt/list` - 获取PPT列表
|
|
|
- `GET /api/ppt/:pptId` - 获取PPT数据
|
|
|
- `POST /api/ppt/save` - 保存PPT
|
|
|
- `POST /api/ppt/create` - 创建新PPT
|
|
|
- `DELETE /api/ppt/:pptId` - 删除PPT
|
|
|
- `POST /api/ppt/:pptId/copy` - 复制PPT
|
|
|
|
|
|
### 公共分享接口
|
|
|
- `GET /api/public/view/:userId/:pptId/:slideIndex` - 公开访问单页
|
|
|
- `GET /api/public/ppt/:userId/:pptId` - 公开访问完整PPT
|
|
|
- `POST /api/public/generate-share-link` - 生成分享链接
|
|
|
|
|
|
## 🔧 本地开发
|
|
|
|
|
|
1. 克隆项目：
|
|
|
```bash
|
|
|
git clone <repository-url>
|
|
|
cd PPtist-Huggingface
|
|
|
```
|
|
|
|
|
|
2. 安装依赖：
|
|
|
```bash
|
|
|
# 后端
|
|
|
cd backend
|
|
|
npm install
|
|
|
|
|
|
# 前端
|
|
|
cd ../frontend
|
|
|
npm install
|
|
|
```
|
|
|
|
|
|
3. 配置环境变量：
|
|
|
```bash
|
|
|
cp backend/.env.example backend/.env
|
|
|
# 编辑 .env 文件，填入你的配置
|
|
|
```
|
|
|
|
|
|
4. 启动开发服务器：
|
|
|
```bash
|
|
|
# 启动后端 (端口 7860)
|
|
|
cd backend
|
|
|
npm run dev
|
|
|
|
|
|
# 启动前端 (端口 5173)
|
|
|
cd frontend
|
|
|
npm run dev
|
|
|
```
|
|
|
|
|
|
## 🏗️ 系统架构
|
|
|
|
|
|
```
|
|
|
┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
|
|
|
│ 前端 Vue3 │ │ 后端 Express │ │ GitHub 仓库 │
|
|
|
│ PPTist UI │────│ JWT认证 │────│ JSON数据存储 │
|
|
|
│ Vite构建 │ │ RESTful API │ │ 版本控制 │
|
|
|
└─────────────────┘ └─────────────────┘ └─────────────────┘
|
|
|
```
|
|
|
|
|
|
## 🌐 公网分享功能
|
|
|
|
|
|
每个PPT页面都可以生成公网访问链接：
|
|
|
|
|
|
- **单页链接**: `https://your-space.hf.space/api/public/view/PS01/ppt-id/0`
|
|
|
- **完整PPT**: `https://your-space.hf.space/api/public/ppt/PS01/ppt-id`
|
|
|
- **前端查看**: `https://your-space.hf.space/public/PS01/ppt-id/0`
|
|
|
|
|
|
## 📝 许可证
|
|
|
|
|
|
本项目基于 AGPL-3.0 许可证开源。 |
