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