完成即梦配置功能页面

2026-04-29 14:34:27 +08:00 · 2025-07-21 07:08:06 +08:00
parent 73d003d6c3
commit 41eb0e634a
14 changed files with 993 additions and 406 deletions
--- a/JIMENG_CONFIG_README.md
+++ b/JIMENG_CONFIG_README.md
@@ -0,0 +1,195 @@
+# 即梦 AI 配置功能说明
+
+## 功能概述
+
+即梦 AI 配置功能允许管理员通过 Web 界面配置即梦 AI 的 API 密钥和算力消耗设置，支持动态配置更新，无需重启服务。
+
+## 功能特性
+
+### 1. 秘钥配置
+
+- AccessKey 和 SecretKey 配置
+- 支持密码显示/隐藏
+- 连接测试功能
+
+### 2. 算力配置
+
+- 文生图算力消耗
+- 图生图算力消耗
+- 图片编辑算力消耗
+- 图片特效算力消耗
+- 文生视频算力消耗
+- 图生视频算力消耗
+
+### 3. 动态配置
+
+- 配置实时生效
+- 无需重启服务
+- 支持配置验证
+
+## API 接口
+
+### 获取配置
+
+```
+GET /api/admin/jimeng/config
+```
+
+### 更新配置
+
+```
+POST /api/admin/jimeng/config
+Content-Type: application/json
+
+{
+  "config": {
+    "access_key": "your_access_key",
+    "secret_key": "your_secret_key",
+    "power": {
+      "text_to_image": 10,
+      "image_to_image": 15,
+      "image_edit": 20,
+      "image_effects": 25,
+      "text_to_video": 30,
+      "image_to_video": 35
+    }
+  }
+}
+```
+
+### 测试连接
+
+```
+POST /api/admin/jimeng/config/test
+Content-Type: application/json
+
+{
+  "config": {
+    "access_key": "your_access_key",
+    "secret_key": "your_secret_key"
+  }
+}
+```
+
+## 前端页面
+
+### 访问路径
+
+管理后台 -> 即梦 AI -> 配置设置
+
+### 页面功能
+
+1. **秘钥配置标签页**
+
+   - AccessKey 输入框（密码模式）
+   - SecretKey 输入框（密码模式）
+   - 测试连接按钮
+
+2. **算力配置标签页**
+
+   - 各种任务类型的算力消耗配置
+   - 数字输入框，支持 1-100 范围
+   - 提示信息说明
+
+3. **操作按钮**
+   - 保存配置
+   - 重置配置
+
+## 配置存储
+
+配置存储在数据库的`config`表中：
+
+- 配置键：`jimeng`
+- 配置值：JSON 格式的即梦 AI 配置
+
+## 默认配置
+
+如果配置不存在，系统会使用以下默认值：
+
+```json
+{
+  "access_key": "",
+  "secret_key": "",
+  "power": {
+    "text_to_image": 10,
+    "image_to_image": 15,
+    "image_edit": 20,
+    "image_effects": 25,
+    "text_to_video": 30,
+    "image_to_video": 35
+  }
+}
+```
+
+## 使用流程
+
+1. **初始配置**
+
+   - 访问管理后台即梦 AI 配置页面
+   - 填写 AccessKey 和 SecretKey
+   - 点击"测试连接"验证配置
+   - 调整各功能算力消耗
+   - 保存配置
+
+2. **配置更新**
+
+   - 修改需要更新的配置项
+   - 保存配置
+   - 配置立即生效
+
+3. **故障排查**
+   - 使用"测试连接"功能验证 API 密钥
+   - 检查配置是否正确保存
+   - 查看服务日志
+
+## 注意事项
+
+1. **权限要求**
+
+   - 只有管理员可以访问配置页面
+   - 需要有效的管理员登录会话
+
+2. **配置验证**
+
+   - AccessKey 和 SecretKey 不能为空
+   - 算力消耗必须大于 0
+   - 建议先测试连接再保存配置
+
+3. **服务影响**
+   - 配置更新不会影响正在进行的任务
+   - 新任务会使用更新后的配置
+   - 客户端配置会在下次请求时更新
+
+## 错误处理
+
+1. **配置加载失败**
+
+   - 使用默认配置
+   - 记录错误日志
+
+2. **连接测试失败**
+
+   - 显示具体错误信息
+   - 建议检查 API 密钥
+
+3. **配置保存失败**
+   - 显示错误信息
+   - 保留原有配置
+
+## 开发说明
+
+### 后端文件
+
+- `api/handler/admin/jimeng_handler.go` - 配置管理 API
+- `api/service/jimeng/service.go` - 配置服务逻辑
+- `api/core/types/jimeng.go` - 配置类型定义
+
+### 前端文件
+
+- `web/src/views/admin/jimeng/JimengSetting.vue` - 配置页面
+
+### 数据库
+
+- `config`表存储配置信息
+- 配置键：`jimeng`
+- 配置值：JSON 格式