# Text Video Agent API 集成开发提示词

## 概述

本文档包含将 openapi.md 中定义的 8 个 API 组合调用场景集成到便捷工具中的详细开发提示词。每个场景都遵循 promptx/tauri-desktop-app-expert 规定的开发规范。

---

## 场景1：完整图片生成流程工具

### 开发提示词

```
请开发一个完整的图片生成流程工具，集成到便捷工具页面中。

**功能要求：**
1. 提示词预审功能 - 调用 `GET /api/mj/prompt/check` 检查提示词合规性
2. 异步图片生成 - 调用 `POST /api/mj/async/generate/image` 提交生成任务
3. 状态轮询监控 - 调用 `GET /api/mj/async/query/status` 定期查询任务进度
4. 文件上传保存 - 调用 `POST /api/file/upload/s3` 将生成图片上传到云存储
5. 支持参考图片上传（可选）

**技术规范：**
- 遵循 Tauri 桌面应用开发规范
- 使用 TailwindCSS 进行样式设计
- 实现异步任务状态管理
- 提供实时进度反馈
- 错误处理和重试机制
- 支持任务取消功能

**UI/UX要求：**
- 遵循 promptx/frontend-developer 标准
- 美观的界面设计，流畅的操作体验
- 合理的信息布局和用户习惯
- 实时状态显示和进度条
- 结果预览和下载功能

**文件结构：**
- 创建 `apps/desktop/src/pages/tools/ImageGenerationTool.tsx`
- 添加相应的 Rust 后端命令处理
- 更新工具数据配置
- 添加路由配置
```

---

## 场景2：图片到视频转换工具

### 开发提示词

```
请开发一个图片到视频转换工具，支持完整的图片到视频生成流程。

**功能要求：**
1. 参考图片上传 - 调用 `POST /api/file/upload/s3` 上传用户图片
2. 视频生成任务提交 - 调用 `POST /api/jm/async/generate/video` 提交视频生成
3. 任务状态监控 - 调用 `GET /api/jm/async/query/status` 监控生成进度
4. 模板保存功能 - 调用 `POST /api/template/create` 保存成功配置为模板
5. 支持多种视频参数配置（时长、模型类型等）

**技术规范：**
- 支持图片格式验证和预览
- 实现视频生成参数配置界面
- 异步任务队列管理
- 生成结果预览和下载
- 模板化配置保存

**UI/UX要求：**
- 拖拽上传图片界面
- 参数配置面板
- 实时进度显示
- 结果对比展示
- 模板管理界面

**文件结构：**
- 创建 `apps/desktop/src/pages/tools/ImageToVideoTool.tsx`
- 实现图片上传组件
- 添加视频参数配置组件
- 集成模板保存功能
```

---

## 场景3：模板化批量生产工具

### 开发提示词

```
请开发一个模板化批量生产工具，支持基于模板的批量任务处理。

**功能要求：**
1. 模板列表获取 - 调用 `GET /api/template/default` 获取可用模板
2. 任务类型检查 - 调用 `GET /api/template/check/task_type` 确认可用性
3. 批量任务提交 - 调用 `POST /api/task/create/task/v2` 批量提交任务
4. 状态监控面板 - 调用 `GET /api/task/status/{task_id}` 监控所有任务
5. 支持任务队列管理和优先级设置

**技术规范：**
- 模板选择和预览功能
- 批量任务配置界面
- 并发任务控制
- 任务状态实时更新
- 失败任务重试机制

**UI/UX要求：**
- 模板卡片展示
- 批量操作界面
- 任务状态仪表板
- 进度统计图表
- 任务管理操作

**文件结构：**
- 创建 `apps/desktop/src/pages/tools/BatchProductionTool.tsx`
- 实现模板选择组件
- 添加任务监控面板
- 集成批量操作功能
```

---

## 场景4：多模型对比生成工具

### 开发提示词

```
请开发一个多模型对比生成工具，支持同时使用多个AI模型生成内容并对比效果。

**功能要求：**
1. 模型列表获取 - 调用 `GET /api/union/img/model/list` 获取支持的模型
2. 并行任务提交 - 调用 `POST /api/union/img/sync/generate/image` 使用不同模型
3. 结果对比分析 - 提供生成结果的并排对比功能
4. 支持图片和视频模型对比
5. 性能指标统计（生成时间、质量评分等）

**技术规范：**
- 多模型并发处理
- 结果收集和整理
- 对比分析算法
- 性能指标计算
- 结果导出功能

**UI/UX要求：**
- 模型选择界面
- 并排对比展示
- 性能指标图表
- 结果评分系统
- 导出和分享功能

**文件结构：**
- 创建 `apps/desktop/src/pages/tools/ModelComparisonTool.tsx`
- 实现模型选择组件
- 添加对比展示组件
- 集成性能分析功能
```

---

## 场景5：声音克隆与TTS工具

### 开发提示词

```
请开发一个声音克隆与TTS工具，提供完整的语音合成和声音克隆功能。

**功能要求：**
1. 音频上传 - 调用 `POST /api/302/hl_router/sync/file/upload` 上传音频素材
2. 声音克隆 - 调用 `POST /api/302/hl_router/sync/voice/clone` 创建个性化音色
3. 音色管理 - 调用 `GET /api/302/hl_router/sync/get/voices` 管理音色列表
4. 语音生成 - 调用 `POST /api/302/hl_router/sync/generate/speech` 生成语音
5. 支持多种音频参数配置（语速、音量、情感等）

**技术规范：**
- 音频文件格式验证
- 声音克隆质量评估
- 音色库管理系统
- 语音合成参数控制
- 音频播放和下载

**UI/UX要求：**
- 音频上传和预览
- 声音克隆进度显示
- 音色库管理界面
- 语音合成控制面板
- 音频播放器组件

**文件结构：**
- 创建 `apps/desktop/src/pages/tools/VoiceCloneTool.tsx`
- 实现音频上传组件
- 添加音色管理组件
- 集成语音合成功能
```

---

## 场景6：工作流自动化工具

### 开发提示词

```
请开发一个ComfyUI工作流自动化工具，支持复杂AI处理工作流的管理和执行。

**功能要求：**
1. 节点管理 - 调用 `GET /api/comfy/fetch/running/node` 获取可用节点
2. 工作流提交 - 调用 `POST /api/comfy/async/submit/task` 提交工作流任务
3. 执行监控 - 调用 `GET /api/comfy/async/task/status` 跟踪执行状态
4. 同步执行 - 调用 `POST /api/comfy/sync/execute/workflow` 同步执行工作流
5. 工作流模板管理和可视化编辑

**技术规范：**
- 工作流JSON编辑器
- 节点状态监控
- 任务队列管理
- 工作流模板系统
- 执行日志记录

**UI/UX要求：**
- 工作流可视化编辑器
- 节点状态仪表板
- 任务执行监控
- 模板库管理
- 日志查看器

**文件结构：**
- 创建 `apps/desktop/src/pages/tools/WorkflowAutomationTool.tsx`
- 实现工作流编辑器
- 添加节点监控组件
- 集成模板管理功能
```

---

## 场景7：图片反推与再生成工具

### 开发提示词

```
请开发一个图片反推与再生成工具，支持从图片反推提示词并重新生成优化图片。

**功能要求：**
1. 图片上传 - 调用 `POST /api/mj/sync/file/img/describe` 上传图片获取描述
2. 提示词优化 - 调用 `GET /api/mj/prompt/check` 检查和优化提示词
3. 重新生成 - 调用 `POST /api/mj/sync/image` 基于优化提示词重新生成
4. 支持批量图片处理
5. 提示词编辑和优化建议

**技术规范：**
- 图片格式支持和验证
- 提示词智能优化算法
- 生成结果对比分析
- 批量处理队列
- 结果历史记录

**UI/UX要求：**
- 图片上传和预览
- 提示词编辑器
- 生成结果对比
- 批量处理界面
- 历史记录管理

**文件结构：**
- 创建 `apps/desktop/src/pages/tools/ImageReverseEngineeringTool.tsx`
- 实现图片分析组件
- 添加提示词编辑器
- 集成对比展示功能
```

---

## 场景8：多平台视频生成对比工具

### 开发提示词

```
请开发一个多平台视频生成对比工具，支持多个视频生成平台的并行处理和效果对比。

**功能要求：**
1. 素材准备 - 调用 `POST /api/file/upload/s3` 上传参考图片
2. 多平台并行生成：
   - 极梦平台：`POST /api/jm/sync/generate/video`
   - 302AI MJ：`POST /api/302/mj/video/sync/generate/video`
   - 302AI VEO：`POST /api/302/veo/video/sync/generate/video`
3. 效果对比分析 - 比较不同平台的生成效果和速度
4. 支持参数统一配置和个性化调整

**技术规范：**
- 多平台API统一管理
- 并行任务处理
- 结果收集和分析
- 性能指标统计
- 平台特性对比

**UI/UX要求：**
- 平台选择界面
- 参数配置面板
- 并行进度显示
- 结果对比展示
- 性能分析图表

**文件结构：**
- 创建 `apps/desktop/src/pages/tools/MultiPlatformVideoTool.tsx`
- 实现平台管理组件
- 添加对比分析组件
- 集成性能统计功能
```

---

## 通用开发规范

### 技术要求
1. 遵循 promptx/tauri-desktop-app-expert 开发规范
2. 使用 TailwindCSS 进行样式设计
3. 实现 TypeScript 类型安全
4. 添加完整的错误处理机制
5. 支持国际化（中英文）

### UI/UX标准
1. 遵循 promptx/frontend-developer 设计标准
2. 保持界面美观和操作流畅
3. 提供清晰的用户反馈
4. 实现响应式设计
5. 优化用户体验流程

### 代码结构
1. 组件化开发，提高复用性
2. 状态管理使用 React Hooks
3. API 调用封装为独立服务
4. 添加单元测试和集成测试
5. 完善的文档和注释

### 集成要求
1. 更新 `apps/desktop/src/data/tools.ts` 添加新工具
2. 在 `apps/desktop/src/App.tsx` 中添加路由
3. 更新导航菜单和工具分类
4. 添加相应的 Rust 后端命令
5. 实现数据持久化存储