tj

2025-10-17 23:38:10 +08:00
parent 1c07b9246f
commit 91bac9ec48
12 changed files with 2601 additions and 13 deletions
--- a/项目功能和配置.txt
+++ b/项目功能和配置.txt
@@ -0,0 +1,464 @@
+# PromptForge 项目功能和配置总结
+
+## 项目概述
+PromptForge 是一个专为大模型提示词系统优化的完整平台，涵盖了提示词创建、优化、测试、部署和管理的全生命周期。项目采用现代化的技术栈，提供了直观的用户界面和强大的功能支持。
+
+## 技术架构
+
+### 前端技术栈
+- **Next.js 14** - React 框架，支持 SSR 和静态生成
+- **React 18** - 用户界面库
+- **TypeScript** - 类型安全的 JavaScript
+- **Tailwind CSS** - 实用优先的 CSS 框架
+- **Lucide React** - 现代化图标库
+- **Zustand** - 轻量级状态管理
+- **Monaco Editor** - VS Code 同款代码编辑器
+- **Framer Motion** - 动画库
+
+### 后端技术栈
+- **Next.js API Routes** - 后端 API 服务
+- **MySQL** - 关系型数据库（腾讯云）
+- **mysql2/promise** - MySQL 数据库驱动
+- **bcryptjs** - 密码加密
+- **Prisma** - 数据库 ORM
+
+### 开发工具
+- **ESLint** - 代码质量检查
+- **PostCSS** - CSS 处理工具
+- **tsx** - TypeScript 执行器
+
+## 核心功能模块
+
+### 1. 用户系统 ✅
+**文件位置**：`src/app/auth/`, `src/contexts/AuthContext.tsx`, `src/app/profile/`
+
+#### 功能特性
+- **用户注册**：邮箱、用户名、密码注册
+- **用户登录**：安全的身份验证
+- **个人资料**：用户信息管理和展示
+- **密码加密**：bcryptjs 安全加密
+- **会话管理**：React Context 状态管理
+- **路由保护**：ProtectedRoute 组件
+
+#### 技术实现
+- 完整的注册/登录表单
+- 用户认证上下文
+- 数据库用户表管理
+- 密码哈希和验证
+- 响应式用户界面
+
+### 2. 模板管理系统 ✅
+**文件位置**：`src/app/templates/`, `src/app/editor/`, `src/app/api/templates/`
+
+#### 功能特性
+- **模板创建**：可视化模板编辑器
+- **模板编辑**：实时编辑和预览
+- **模板库**：分类浏览和搜索
+- **模板分享**：公开/私密设置
+- **模板复制**：一键复制他人模板
+- **批量操作**：批量删除和分享
+- **模板管理**：个人模板管理页面
+
+#### 技术实现
+- Monaco Editor 集成
+- 实时预览功能
+- 分类和标签系统
+- 搜索和过滤功能
+- 数据库 CRUD 操作
+- 响应式卡片布局
+
+### 3. AI 测试台模块 ✅
+**文件位置**：`src/app/playground/`, `src/app/api/test/`, `src/components/playground/`
+
+#### 功能特性
+- **单模型测试**：单个 AI 模型测试
+- **批量测试**：多模型并行测试
+- **结果比较**：测试结果对比分析
+- **测试场景**：预设测试场景
+- **变量管理**：动态变量输入
+- **结果导出**：JSON 格式导出
+- **历史记录**：本地测试历史
+
+#### 技术实现
+- 多平台 API 集成（OpenAI, Anthropic, DeepSeek）
+- 并行请求处理
+- 实时响应时间统计
+- 错误处理和重试机制
+- 结果可视化展示
+- 本地存储管理
+
+### 4. 部署模块 ✅
+**文件位置**：`src/app/deploy/`, `src/components/deploy/`
+
+#### 功能特性
+- **部署模板**：预配置部署方案
+- **多语言支持**：Python, JavaScript, TypeScript
+- **框架选择**：FastAPI, Express.js, Electron
+- **代码生成**：自动生成部署代码
+- **配置管理**：部署参数配置
+- **部署历史**：部署记录管理
+- **快速部署**：一键部署到平台
+
+#### 技术实现
+- 模板化代码生成
+- 多平台配置支持
+- 代码高亮显示
+- 复制和下载功能
+- 部署状态跟踪
+- 错误日志管理
+
+### 5. 设置模块 ✅
+**文件位置**：`src/app/settings/`
+
+#### 功能特性
+- **个人资料**：用户信息管理
+- **API 配置**：多平台 API 密钥管理
+- **外观设置**：主题和语言配置
+- **通知设置**：邮件和推送通知
+- **隐私设置**：数据隐私控制
+- **偏好设置**：AI 参数预设
+- **设置同步**：本地存储持久化
+
+#### 技术实现
+- 标签页导航界面
+- 实时设置应用
+- API 密钥测试
+- 主题切换功能
+- 本地存储管理
+- 响应式表单设计
+
+## 数据库设计
+
+### 主要数据表
+1. **users** - 用户信息
+2. **templates** - 提示词模板
+3. **favorites** - 用户收藏
+4. **comments** - 模板评论
+5. **tests** - 测试记录
+6. **system_configs** - 系统配置
+
+### 表关系
+```
+User (1) ←→ (N) Template
+User (1) ←→ (N) Favorite
+User (1) ←→ (N) Comment
+Template (1) ←→ (N) Test
+```
+
+### 用户表结构
+```sql
+- id (主键)
+- username (用户名)
+- email (邮箱)
+- password (加密密码)
+- displayName (显示名称)
+- bio (个人简介)
+- avatar (头像)
+- createdAt (创建时间)
+- updatedAt (更新时间)
+```
+
+### 模板表结构
+```sql
+- id (主键)
+- title (标题)
+- description (描述)
+- role (角色定义)
+- task (任务描述)
+- context (上下文)
+- constraints (约束条件)
+- variables (变量定义)
+- outputFormat (输出格式)
+- category (分类)
+- tags (标签)
+- authorId (作者ID)
+- isPublic (是否公开)
+- usageCount (使用次数)
+- rating (评分)
+- ratingCount (评分次数)
+- createdAt (创建时间)
+- updatedAt (更新时间)
+```
+
+## API 接口设计
+
+### 用户相关
+- `POST /api/auth/register` - 用户注册
+- `POST /api/auth/login` - 用户登录
+- `GET /api/users/profile` - 获取用户资料
+- `PUT /api/users/profile` - 更新用户资料
+
+### 模板相关
+- `GET /api/templates` - 获取模板列表
+- `POST /api/templates` - 创建新模板
+- `GET /api/templates/[id]` - 获取模板详情
+- `PUT /api/templates/[id]` - 更新模板
+- `DELETE /api/templates/[id]` - 删除模板
+- `PATCH /api/templates/[id]/share` - 切换分享状态
+- `POST /api/templates/[id]/copy` - 复制模板
+
+### AI 测试相关
+- `POST /api/test` - 单模型测试
+- `POST /api/test/batch` - 批量模型测试
+
+## 项目结构
+
+```
+promptforge/
+├── src/
+│   ├── app/                    # Next.js App Router
+│   │   ├── auth/              # 用户认证页面
+│   │   ├── templates/         # 模板管理页面
+│   │   ├── editor/            # 模板编辑器
+│   │   ├── playground/        # AI 测试台
+│   │   ├── deploy/            # 部署中心
+│   │   ├── settings/          # 设置页面
+│   │   ├── profile/           # 个人资料页面
+│   │   ├── docs/              # 文档页面
+│   │   └── api/               # API 路由
+│   ├── components/            # React 组件
+│   │   ├── auth/              # 认证组件
+│   │   ├── editor/            # 编辑器组件
+│   │   ├── playground/        # 测试台组件
+│   │   ├── deploy/            # 部署组件
+│   │   └── layout/            # 布局组件
+│   ├── contexts/              # React Context
+│   ├── lib/                   # 工具函数和常量
+│   ├── store/                 # Zustand 状态管理
+│   └── types/                 # TypeScript 类型定义
+├── public/                    # 静态资源
+├── prisma/                    # 数据库模式
+├── scripts/                   # 数据库脚本
+└── docs/                      # 文档
+```
+
+## 环境配置
+
+### 数据库配置
+- **数据库类型**: MySQL
+- **云服务商**: 腾讯云
+- **连接地址**: `gz-cynosdbmysql-grp-d26pzce5.sql.tencentcdb.com:24936`
+- **数据库名**: `pronode_db`
+- **用户名**: `root`
+
+### 环境变量
+```env
+# 数据库配置
+DATABASE_URL="mysql://root:!Rjb12191@gz-cynosdbmysql-grp-d26pzce5.sql.tencentcdb.com:24936/pronode_db?charset=utf8mb4"
+
+# Next.js 配置
+NEXTAUTH_SECRET="your-secret-key-here"
+NEXTAUTH_URL="http://localhost:3000"
+
+# API 密钥配置
+DEEPSEEK_API_KEY=your_deepseek_api_key_here
+OPENAI_API_KEY=your_openai_api_key_here
+ANTHROPIC_API_KEY=your_anthropic_api_key_here
+
+# 应用配置
+NODE_ENV="development"
+```
+
+## 部署信息
+
+### 访问地址
+- **本地访问**：http://localhost:3000
+- **公网访问**：http://101.43.95.130:3000
+- **网络访问**：http://0.0.0.0:3000
+
+### 启动命令
+```bash
+# 开发模式
+npm run dev
+
+# 生产模式
+npm run build
+npm start
+
+# 使用 PM2 管理
+pm2 start ecosystem.config.js
+```
+
+### 数据库管理命令
+```bash
+# 生成 Prisma 客户端
+npm run db:generate
+
+# 推送模式到数据库
+npm run db:push
+
+# 创建迁移文件
+npm run db:migrate
+
+# 打开 Prisma Studio
+npm run db:studio
+
+# 初始化示例数据
+npm run db:seed
+```
+
+## 古诗词模板特色功能
+
+### 模板1：古诗词创作与解读生成器
+- **多种体裁**：支持五言绝句、七言绝句、五言律诗、七言律诗、词、古体诗
+- **格律规范**：严格遵循传统诗词的格律要求
+- **主题丰富**：支持各种主题，如春景、离别、思乡、咏史等
+- **情感表达**：涵盖欢快、忧伤、豪放、婉约等多种情感基调
+
+### 模板2：古诗词查询与解析器
+- **原文展示**：准确的诗词原文
+- **详细注释**：字词解释、典故出处、历史背景
+- **深度解读**：结构分析、意象解读、情感分析
+- **专业赏析**：文学价值、风格特色、影响意义
+
+### 模板3：古诗词翻译与解析器
+- **现代译文**：优美流畅的现代汉语翻译
+- **保持意境**：在翻译中保持原诗的意境和美感
+- **现代表达**：使用现代汉语表达习惯
+- **通俗易懂**：让现代读者容易理解古典诗词的含义
+
+## 支持的 AI 模型
+
+### DeepSeek 模型
+- `deepseek-coder`: 代码生成模型
+- `deepseek-chat`: 通用对话模型
+- `deepseek-vision`: 视觉模型
+
+### OpenAI 模型
+- `gpt-4`: GPT-4 模型
+- `gpt-4-turbo`: GPT-4 Turbo 模型
+- `gpt-3.5-turbo`: GPT-3.5 Turbo 模型
+
+### Anthropic 模型
+- `claude-3-opus`: Claude 3 Opus 模型
+- `claude-3-sonnet`: Claude 3 Sonnet 模型
+- `claude-3-haiku`: Claude 3 Haiku 模型
+
+## 项目亮点
+
+### 1. 完整的功能覆盖
+- 从用户注册到模板部署的完整流程
+- 涵盖提示词工程的所有核心需求
+- 模块化设计，易于扩展和维护
+
+### 2. 现代化的技术栈
+- 使用最新的前端技术
+- 类型安全的 TypeScript
+- 响应式的 Tailwind CSS
+
+### 3. 优秀的用户体验
+- 直观的界面设计
+- 流畅的交互体验
+- 完善的错误处理
+
+### 4. 强大的 AI 集成
+- 多平台 AI 模型支持
+- 实时测试和比较
+- 灵活的部署选项
+
+### 5. 企业级特性
+- 完整的用户系统
+- 安全的认证机制
+- 可扩展的架构设计
+
+## 安全特性
+
+### 数据安全
+- **密码加密**：bcryptjs 哈希加密
+- **API 密钥保护**：密码模式显示
+- **输入验证**：前后端双重验证
+- **SQL 注入防护**：参数化查询
+
+### 访问控制
+- **路由保护**：需要登录的页面保护
+- **权限验证**：用户权限检查
+- **会话管理**：安全的会话处理
+- **CSRF 防护**：跨站请求伪造防护
+
+## 性能优化
+
+### 前端优化
+- **代码分割**：按需加载组件
+- **图片优化**：Next.js 图片优化
+- **缓存策略**：浏览器缓存利用
+- **懒加载**：组件和图片懒加载
+
+### 后端优化
+- **数据库索引**：查询性能优化
+- **连接池**：数据库连接管理
+- **API 缓存**：响应缓存机制
+- **错误处理**：优雅的错误处理
+
+## 文档资源
+
+项目包含完整的文档体系：
+- **README.md** - 项目介绍和快速开始
+- **INSTALLATION_GUIDE.md** - 详细安装指南
+- **CORE_CONCEPTS.md** - 核心概念说明
+- **DATABASE_SETUP.md** - 数据库设置指南
+- **ENV_SETUP.md** - 环境配置说明
+- **TEMPLATE_TUTORIAL.md** - 模板创建教程
+- **USER_SYSTEM.md** - 用户系统说明
+- **PLAYGROUND_FEATURES.md** - 测试台功能说明
+- **DEPLOYMENT_FEATURES.md** - 部署功能说明
+- **古诗词模板说明.md** - 古诗词模板详细说明
+
+## 总结
+
+PromptForge 是一个功能完整、技术先进的 AI 提示词工程平台，适合提示词工程师、AI 应用开发者和内容创作者使用。项目代码结构清晰，功能模块化，具有良好的扩展性和维护性。
+
+通过这个项目，用户可以：
+- 创建和管理高质量的提示词模板
+- 测试和比较不同 AI 模型的性能
+- 快速部署 AI 应用到各种平台
+- 个性化配置和管理平台设置
+
+PromptForge 为 AI 应用开发提供了一个强大而完整的工具平台，大大降低了高质量 AI 应用开发的门槛。
+
+---
+## 新增模板功能
+
+### 求职指导模板 ⭐ 2025年1月27日新增
+
+#### 模板信息
+- **模板名称**：华为/荣耀客服求职指导专家
+- **模板ID**：template_1758556833494_career_guidance
+- **分类**：客服 (customer-service)
+- **状态**：已导入数据库，公开可用
+
+#### 核心功能
+- **职位分析**：深入了解华为、荣耀等公司客服职位要求
+- **简历优化**：针对性的简历改进建议
+- **面试准备**：全面的面试准备策略和技巧
+- **职业规划**：长期职业发展路径规划
+- **行动建议**：具体可操作的实施步骤
+
+#### 模板参数
+- **company**：目标公司（华为、荣耀等）
+- **position**：目标职位（客服专员、高级客服等）
+- **background**：求职者背景
+- **experience**：工作经验
+- **education**：教育背景
+- **skills**：现有技能（可选）
+- **weaknesses**：需要改进的方面（可选）
+- **timeline**：求职时间规划（可选）
+
+#### 使用场景
+- 应届毕业生求职指导
+- 转行人员职业规划
+- 在职人员跳槽准备
+- 职业咨询师工具
+- 企业培训材料
+
+#### 技术特性
+- **兼容模型**：GPT-4、Claude-3-Opus、DeepSeek-Chat
+- **输出格式**：Markdown
+- **个性化**：根据求职者背景提供差异化建议
+- **实用性**：提供具体可操作的建议和示例
+
+---
+
+**创建时间**：2025年1月27日
+**项目路径**：/home/renjianbo/aiapply
+**版本**：v0.1.1
+**状态**：功能完整，新增求职指导模板，可投入使用