# Prompt Optimizer 产品需求文档

## 1. 产品概述

Prompt Optimizer 是一个强大的 AI 提示词优化工具，帮助用户编写更好的 AI 提示词，提升 AI 输出质量。通过集成多个 LLM 模型，为用户提供专业的提示词优化建议、测试验证和结果评估。

产品采用纯前端架构，所有数据存储在浏览器本地，保障用户隐私和安全。

## 2. 目标用户

- AI 应用开发者
- 提示词工程师
- 内容创作者
- 需要与 AI 模型交互的普通用户
- 图像生成爱好者

## 3. 核心功能需求

### 3.1 提示词优化
- 支持输入原始提示词
- 提供多个 LLM 模型选择
- 实时字数统计
- 一键清空输入
- 优化结果预览
- 一键复制结果
- 多轮迭代优化

### 3.2 模型管理
- 支持多个 LLM 模型
  - OpenAI
  - Gemini
  - DeepSeek
  - 智谱 AI
  - SiliconFlow
  - MiniMax（v2.6.0）
  - Cloudflare（v2.8.0）
  - 自定义 OpenAI 兼容 API
- API 密钥管理
- 模型配置编辑
- 高级 LLM 参数配置（llmParams）

### 3.3 工作区模式

#### 3.3.1 文本工作区
- **系统提示词工作区**：优化角色、规则、边界和输出规范
- **用户提示词工作区**：优化直接发给模型的任务提示词
- **变量工作区**：把提示词沉淀成模板，分离固定结构与可变输入
- **多消息工作区**：在完整上下文里优化某条消息

#### 3.3.2 图像工作区（v2.8.0-v2.9.0）
- **文生图工作区**：通过文本提示词生成图像
- **图生图工作区**：基于本地图片进行图像变换和优化
- **多图生图工作区**（v2.9.0）：使用多张输入图共同约束生成目标
- 参考图工作流
- 风格迁移支持
- 图像提示词提取（v2.6.3）

### 3.4 评估系统

#### 3.4.1 分析功能
- 提示词结构分析
- 改进建议生成

#### 3.4.2 结果评估
- 单结果评估
- 结构化对比评估（v2.7.0）
- 反馈驱动评估（v2.5.4）

### 3.5 Prompt Garden（v2.10.0）
- 提示词发现
- 导入与收藏
- 来源绑定
- 元数据保留

### 3.6 智能收藏（v2.10.0）
- 资源感知提示词资产
- 版本历史
- 可复现示例
- 媒体支持
- 完整备份/导入
- 工作区应用

### 3.7 历史记录
- 本地保存优化历史
- 按时间排序
- 搜索和过滤
- 一键重用历史记录
- 删除历史记录
- 版本链追溯

### 3.8 模板管理
- 预设模板库
- 自定义模板
- 模板分类
- 模板导入导出

### 3.9 数据管理
- 数据导入导出
- 完整备份（v2.10.0）
- 存储概览（v2.9.0）
- 启动自检（v2.9.0）

### 3.10 工具调用（Function Calling）
- OpenAI 工具调用支持
- Gemini 工具调用支持
- 自定义工具定义

## 4. 平台支持

### 4.1 Web 应用
- 纯前端架构
- 浏览器本地存储
- 响应式设计

### 4.2 桌面应用（Electron）
- 无 CORS 限制
- 自动更新
- 本地 LLM 直连
- 系统托盘

### 4.3 Chrome 插件
- 右键菜单集成
- 快捷键支持
- 历史同步

### 4.4 Docker 部署
- 容器化部署
- 环境变量配置
- 密码保护

### 4.5 MCP 协议集成
- Model Context Protocol 支持
- Claude Desktop 集成
- HTTP 访问

## 5. 非功能需求

### 5.1 性能要求
- 页面加载时间 < 2秒
- API 响应时间 < 5秒
- 流畅的动画效果

### 5.2 安全要求
- API 密钥加密存储
- 本地数据安全存储
- 敏感信息保护
- 启动自检（v2.9.0）

### 5.3 兼容性要求
- 支持主流浏览器
- 移动端适配
- 响应式布局

### 5.4 国际化要求
- 中文支持
- English-first locale（v2.9.3）
- 多语言 UI

## 6. 技术架构

### 6.1 前端架构
- Vue 3 + TypeScript
- Vite 构建工具
- Naive UI 组件库
- Pinia 状态管理

### 6.2 包结构
- @prompt-optimizer/core - 核心逻辑
- @prompt-optimizer/ui - UI 组件
- @prompt-optimizer/web - Web 应用
- @prompt-optimizer/extension - Chrome 插件
- @prompt-optimizer/desktop - 桌面应用
- @prompt-optimizer/mcp-server - MCP 服务器

### 6.3 部署架构
- Vercel 部署
- Docker 部署
- 桌面安装包

## 7. 已发布版本

### 7.1 v2.10.0（2026-05-03）
- 提示词模型标准化
- Prompt Garden 集成
- 智能收藏升级
- 资源完整备份

### 7.2 v2.9.x（2026-04）
- 多图生图工作流
- 存储安全加固
- 收藏增强

### 7.3 v2.8.0（2026-04-03）
- 文生图评估
- 参考图工作流
- Cloudflare Provider

### 7.4 v2.7.0（2026-03-25）
- 结构化对比评估
- 文档站刷新

### 7.5 v2.6.x（2026-03）
- MiniMax 支持
- 图像提示词提取
- 评估架构重构

## 8. 未来规划

### 8.1 近期规划
- 完善 E2E 测试覆盖
- 优化图像生成性能
- 扩展 Prompt Garden 内容

### 8.2 中期规划
- 工作区/项目管理支持
- 更多图像模型集成
- 社区功能扩展

### 8.3 长期规划
- 企业版功能
- API 服务化
- 国际化扩展