Upload 3 files

.gitignore

@@ -0,0 +1,56 @@
+# Dependencies
+node_modules/
+*/node_modules/
+
+# Production builds
+dist/
+build/
+
+# Environment variables
+.env
+.env.local
+.env.development.local
+.env.test.local
+.env.production.local
+
+# Logs
+logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+
+# Runtime data
+pids
+*.pid
+*.seed
+*.pid.lock
+
+# Coverage directory used by tools like istanbul
+coverage/
+
+# OS generated files
+.DS_Store
+.DS_Store?
+._*
+.Spotlight-V100
+.Trashes
+ehthumbs.db
+Thumbs.db
+
+# Editor directories and files
+.vscode/
+.idea/
+*.suo
+*.ntvs*
+*.njsproj
+*.sln
+*.sw?
+
+# Package files
+*.tgz
+*.zip
+
+# Temporary files
+tmp/
+temp/

Dockerfile

@@ -0,0 +1,42 @@
+FROM node:18-alpine
+
+# 安装必要的系统依赖
+RUN apk add --no-cache bash curl
+
+# 设置工作目录
+WORKDIR /app
+
+# 复制package.json文件
+COPY backend/package*.json ./backend/
+COPY frontend/package*.json ./frontend/
+
+# 安装后端依赖
+WORKDIR /app/backend
+RUN npm ci --only=production
+
+# 安装前端依赖并构建
+WORKDIR /app/frontend
+RUN npm ci
+COPY frontend/ ./
+RUN npm run build
+
+# 复制后端代码
+WORKDIR /app
+COPY backend/ ./backend/
+
+# 复制脚本文件
+COPY deploy.sh start.sh ./
+RUN chmod +x ./deploy.sh ./start.sh
+
+# 设置工作目录为后端
+WORKDIR /app/backend
+
+# 暴露端口
+EXPOSE 7860
+
+# 健康检查
+HEALTHCHECK --interval=30s --timeout=10s --start-period=15s --retries=3 \
+  CMD curl -f http://localhost:7860/api/health || exit 1
+
+# 启动应用
+CMD ["npm", "start"]

README.md

@@ -1,10 +1,149 @@
----
-title: PPTist Cybercity
-emoji: 🏢
-colorFrom: gray
-colorTo: green
-sdk: docker
-pinned: false
----
-
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+title: PPTist Huggingface
+emoji: 📊
+colorFrom: blue
+colorTo: purple
+sdk: docker
+pinned: false
+license: agpl-3.0
+app_port: 7860
+
+models:
+- sentence-transformers/all-MiniLM-L6-v2
+
+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 许可证开源。