Hugging Face's logo

Spaces:
CatPtain
/
web_ppt_7.7
Running

App Files Community
web_ppt_7.7
File size: 3,911 Bytes 
7ca66d5
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
 
---

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 许可证开源。