aitsc/生成专业提示词代码逻辑分析.md

🎯 生成专业提示词代码逻辑分析

📋 系统概述

生成专业提示词系统是一个基于Flask的Web应用，采用前后端分离架构，集成了DeepSeek LLM API，实现了智能化的提示词生成功能。

🏗️ 系统架构

1. 技术栈

• 后端: Flask + SQLAlchemy + PyMySQL
• 前端: HTML5 + CSS3 + JavaScript + Bootstrap
• 数据库: MySQL (本地 + 腾讯云)
• LLM API: DeepSeek Chat API
• 部署: Gunicorn + Nginx

2. 核心组件

• 路由层: Flask Blueprint路由管理
• 模型层: SQLAlchemy ORM模型
• 服务层: LLM API集成服务
• 视图层: Jinja2模板渲染
• 静态资源: CSS/JS资源管理

🔄 完整生成流程

第一阶段：用户交互层

1.1 前端界面 (generate.html)

<!-- 模板选择区域 -->
<div class="template-grid">
    {% for template in templates %}
    <div class="template-card" data-template-id="{{ template.id }}">
        <input type="radio" name="template_id" value="{{ template.id }}">
        <label>{{ template.name }}</label>
    </div>
    {% endfor %}
</div>

<!-- 需求输入区域 -->
<div class="input-section">
    <textarea name="input_text" placeholder="请详细描述您的需求..."></textarea>
</div>

<!-- 生成按钮 -->
<button type="submit" class="btn-generate">生成专业提示词</button>

1.2 JavaScript交互逻辑

// 模板选择处理
function handleTemplateSelection(radio) {
    const card = radio.closest('.template-card');
    const templateId = card.dataset.templateId;
    
    // 添加选择动画
    card.classList.add('selecting');
    
    // 更新选择状态
    updateSelectionStatus();
    
    // 添加到选择历史
    addToSelectionHistory(templateId, templateName);
}

// 表单提交处理
document.getElementById('promptForm').addEventListener('submit', function(e) {
    e.preventDefault();
    
    const formData = new FormData(this);
    const templateId = formData.get('template_id');
    const inputText = formData.get('input_text');
    
    // 发送AJAX请求
    fetch('/', {
        method: 'POST',
        body: formData
    })
    .then(response => response.text())
    .then(html => {
        // 更新页面内容
        document.body.innerHTML = html;
    });
});

第二阶段：后端处理层

2.1 路由处理 (routes.py)

@main_bp.route('/', methods=['GET', 'POST'])
def index():
    form = PromptForm()
    templates = PromptTemplate.query.all()
    
    if form.validate_on_submit():
        # 获取用户输入和模板ID
        template_id = request.form.get('template_id')
        input_text = form.input_text.data
        
        # 调用LLM生成提示词
        generated_text = generate_with_llm(input_text, template_id)
        
        # 保存到数据库
        prompt = Prompt(
            input_text=input_text,
            generated_text=generated_text,
            user_id=get_user_id()
        )
        db.session.add(prompt)
        db.session.commit()
        
        # 返回结果页面
        return render_template('generate.html', 
                             form=form, 
                             prompt=prompt, 
                             templates=templates)
    
    return render_template('generate.html', 
                         form=form, 
                         templates=templates)

2.2 模板系统逻辑

def get_system_prompt(template_id=None):
    """获取系统提示词模板"""
    if template_id:
        # 根据模板ID获取特定模板
        template = PromptTemplate.query.get(template_id)
        if template:
            return template.system_prompt
    
    # 获取默认模板
    default_template = PromptTemplate.query.filter_by(is_default=True).first()
    if default_template:
        return default_template.system_prompt
    
    # 硬编码默认模板
    return """你是一个专业的提示词工程师，擅长将普通的描述转换为结构化、专业的 Prompt。
    
你需要：
1. 分析用户的需求和意图
2. 将其转换为清晰、详细的提示词
3. 添加必要的上下文和约束条件
4. 使用专业的术语和格式
5. 确保生成的提示词能够获得最佳的 AI 响应

请直接返回优化后的提示词，不要添加任何解释或其他内容。"""

第三阶段：LLM集成层

3.1 API配置

# OpenAI兼容客户端配置
client = OpenAI(
    api_key='sk-fdf7cc1c73504e628ec0119b7e11b8cc',
    base_url='https://api.deepseek.com/v1'
)

3.2 LLM调用逻辑

def generate_with_llm(input_text, template_id=None, max_retries=3):
    """调用大模型API生成提示词，带重试机制"""
    system_prompt = get_system_prompt(template_id)
    
    for attempt in range(max_retries):
        try:
            response = client.chat.completions.create(
                model="deepseek-chat",
                messages=[
                    {"role": "system", "content": system_prompt},
                    {"role": "user", "content": input_text}
                ],
                temperature=0.7,
                max_tokens=500,
                timeout=60
            )
            
            generated_text = response.choices[0].message.content.strip()
            return generated_text
            
        except Exception as e:
            if attempt == max_retries - 1:
                current_app.logger.error(f'LLM API调用失败: {str(e)}')
                return "提示词生成失败，请稍后重试"
            time.sleep(2 ** attempt)  # 指数退避

第四阶段：专家模式生成

4.1 两阶段专家系统

@main_bp.route('/api/wx/generate/expert', methods=['POST'])
def wx_generate_expert_prompt():
    """两阶段专家提示词生成系统"""
    
    # 第一阶段：意图识别专家
    intent_analyst_prompt = """你是一位资深的意图分析专家，请分析用户输入的意图和需求。

你必须严格按照以下JSON格式返回：
{
    "core_intent": "技术",  // 技术、创意、分析、咨询
    "domain": "web开发",    // 具体的专业领域
    "key_requirements": [   // 2-4个关键需求
        "需求1", "需求2"
    ],
    "expected_output": "期望输出的具体形式",
    "constraints": [        // 1-3个主要约束
        "约束1", "约束2"
    ],
    "keywords": [          // 2-4个关键词
        "关键词1", "关键词2"
    ]
}"""

    # 获取意图分析结果
    intent_response = client.chat.completions.create(
        model="deepseek-chat",
        messages=[
            {"role": "system", "content": intent_analyst_prompt},
            {"role": "user", "content": user_input}
        ],
        temperature=0.1
    )
    
    intent_analysis = json.loads(intent_response.choices[0].message.content.strip())
    
    # 第二阶段：领域专家提示生成
    domain_expert_templates = {
        "技术": """你是一位专业的技术领域提示工程师。基于以下意图分析，生成一个专业的技术任务提示词：
        
意图分析：{analysis}

请生成的提示词包含：
1. 明确的技术背景和上下文
2. 具体的技术要求和规范
3. 性能和质量标准
4. 技术约束条件
5. 预期交付成果
6. 评估标准

使用专业技术术语，确保提示词的可执行性和可验证性。""",
        
        "创意": """你是一位专业的创意领域提示工程师。基于以下意图分析，生成一个创意设计提示词：
        
意图分析：{analysis}

请生成的提示词包含：
1. 创意方向和灵感来源
2. 风格和氛围要求
3. 目标受众定义
4. 设计元素规范
5. 创意表现形式
6. 评估标准

使用专业创意术语，确保提示词的创新性和可执行性。"""
    }
    
    # 选择领域专家模板
    expert_prompt = domain_expert_templates.get(
        intent_analysis['core_intent'], 
        default_template
    )
    
    # 生成最终提示词
    final_response = client.chat.completions.create(
        model="deepseek-chat",
        messages=[
            {"role": "system", "content": expert_prompt.format(
                analysis=json.dumps(intent_analysis, ensure_ascii=False, indent=2)
            )},
            {"role": "user", "content": user_input}
        ],
        temperature=0.7
    )
    
    generated_prompt = final_response.choices[0].message.content.strip()
    
    return jsonify({
        'code': 200,
        'data': {
            'intent_analysis': intent_analysis,
            'generated_prompt': generated_prompt
        }
    })

🗄️ 数据库设计

1. 核心表结构

Prompt表 (主要数据表)

CREATE TABLE prompt (
    id INT PRIMARY KEY AUTO_INCREMENT,
    input_text TEXT NOT NULL,
    generated_text TEXT NOT NULL,
    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
    user_id INT,
    wx_user_id INT,
    FOREIGN KEY (user_id) REFERENCES user(uid),
    FOREIGN KEY (wx_user_id) REFERENCES wx_user(id)
);

PromptTemplate表 (模板管理)

CREATE TABLE prompt_template (
    id INT PRIMARY KEY AUTO_INCREMENT,
    name VARCHAR(100) NOT NULL,
    description TEXT,
    category VARCHAR(50),
    industry VARCHAR(50),
    profession VARCHAR(50),
    sub_category VARCHAR(50),
    system_prompt TEXT NOT NULL,
    is_default BOOLEAN DEFAULT FALSE,
    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);

2. 数据流转

用户输入 → 模板选择 → LLM处理 → 结果生成 → 数据库存储 → 页面展示

🎨 前端交互逻辑

1. 模板选择系统

// 模板筛选逻辑
function performSearchAndFilter() {
    const searchTerm = document.getElementById('templateSearch').value.toLowerCase();
    const selectedCategory = document.querySelector('.filter-tab.active')?.dataset.category;
    
    document.querySelectorAll('.template-card').forEach(card => {
        const templateName = card.querySelector('h3').textContent.toLowerCase();
        const templateCategory = card.dataset.category;
        
        const matchesSearch = templateName.includes(searchTerm);
        const matchesCategory = !selectedCategory || templateCategory === selectedCategory;
        
        card.style.display = (matchesSearch && matchesCategory) ? 'block' : 'none';
    });
}

// 选择状态管理
function updateSelectionStatus() {
    const selectedTemplates = document.querySelectorAll('input[name="template_id"]:checked');
    const selectedCount = selectedTemplates.length;
    
    document.getElementById('selectedCount').textContent = selectedCount;
    document.getElementById('selectionStatus').style.display = selectedCount > 0 ? 'block' : 'none';
}

2. 用户体验优化

// 现代交互功能
function initializeModernInteractions() {
    // 平滑滚动
    initializeSmoothScroll();
    
    // 焦点管理
    initializeFocusManagement();
    
    // 悬停效果
    initializeHoverEffects();
    
    // 键盘导航
    initializeKeyboardNavigation();
    
    // 性能优化
    initializePerformanceOptimizations();
}

// 防抖搜索
let searchTimeout;
document.getElementById('templateSearch').addEventListener('input', function() {
    clearTimeout(searchTimeout);
    searchTimeout = setTimeout(() => {
        performSearchAndFilter();
    }, 300);
});

⚙️ 配置管理

1. 环境配置

class Config:
    # 数据库配置
    SQLALCHEMY_DATABASE_URI = 'mysql+pymysql://root:123456@localhost:3306/pro_db?charset=utf8mb4'
    TENCENT_SQLALCHEMY_DATABASE_URI = 'mysql+pymysql://root:!Rjb12191@gz-cynosdbmysql-grp-d26pzce5.sql.tencentcdb.com:24936/pro_db?charset=utf8mb4'
    
    # LLM API配置
    LLM_API_URL = 'https://api.deepseek.com/v1'
    LLM_API_KEY = 'sk-fdf7cc1c73504e628ec0119b7e11b8cc'
    
    # 微信小程序配置
    WX_APPID = 'wx2c65877d37fc29bf'
    WX_SECRET = '89aa97dda3c1347c6ae3d6ab4627f1f4'

2. 部署配置

# Gunicorn配置 (gunicorn.conf.py)
bind = "0.0.0.0:5002"
workers = multiprocessing.cpu_count() * 2 + 1
worker_class = "sync"
timeout = 120
accesslog = "logs/gunicorn_access.log"
errorlog = "logs/gunicorn_error.log"

🔧 核心功能实现

1. 模板管理系统

• 模板分类: 按行业、职业、领域分类
• 模板选择: 单选模式，支持默认模板
• 模板搜索: 实时搜索和筛选
• 模板历史: 记录用户选择历史

2. 生成引擎

• 普通模式: 单次LLM调用
• 专家模式: 两阶段专家系统
• 重试机制: 指数退避重试
• 错误处理: 完善的异常处理

3. 数据管理

• 用户数据: 支持普通用户和微信用户
• 历史记录: 完整的生成历史管理
• 数据导出: 支持JSON格式导出
• 统计分析: 使用统计和分析

🚀 性能优化

1. 前端优化

• 懒加载: 图片和资源懒加载
• 防抖搜索: 减少API调用频率
• 缓存策略: 模板数据缓存
• 响应式设计: 移动端适配

2. 后端优化

• 连接池: 数据库连接池管理
• 重试机制: LLM API调用重试
• 日志记录: 详细的日志追踪
• 错误处理: 优雅的错误处理

3. 数据库优化

• 索引优化: 关键字段索引
• 查询优化: 减少N+1查询
• 分页查询: 大数据量分页
• 连接管理: 连接池和超时设置

📊 监控和日志

1. 日志系统

# 配置日志
logger = logging.getLogger(__name__)

# API调用日志
logger.info("=== API 调用参数 ===")
logger.info(f"模板ID: {template_id}")
logger.info(f"输入文本: {input_text}")
logger.info(f"系统提示: {system_prompt}")

# 错误日志
current_app.logger.error(f'LLM API调用失败: {str(e)}')

2. 性能监控

• 响应时间: API调用响应时间
• 成功率: 生成成功率统计
• 错误率: 错误类型和频率
• 用户行为: 用户使用模式分析

🎯 总结

生成专业提示词系统采用了现代化的架构设计，具有以下特点：

优势

1. 架构清晰: 前后端分离，职责明确
2. 功能完整: 支持多种生成模式
3. 用户体验: 现代化的交互设计
4. 扩展性强: 支持模板和功能扩展
5. 性能优化: 多层次的性能优化

技术亮点

1. 两阶段专家系统: 意图识别 + 领域专家
2. 智能模板选择: 基于用户行为的推荐
3. 多数据库支持: 本地 + 腾讯云
4. 完善的错误处理: 重试机制和降级策略
5. 现代化前端: 响应式设计和交互优化

这个系统为用户提供了专业、高效的提示词生成服务，通过智能化的模板选择和专家级的生成逻辑，帮助用户快速生成高质量的AI提示词。

---

分析完成时间：2025年1月 系统版本：v1.0 维护人员：系统管理员