diff --git a/README.md b/README.md index fad282e..b6bbe94 100644 --- a/README.md +++ b/README.md @@ -103,6 +103,9 @@ src/ ├── contexts/ # 全局状态 (UserContext) ├── services/ # 数据访问层 (api.js) ├── data/ # 模拟数据 +│ ├── adminData.js # 管理台数据（含平台级模型配置） +│ ├── projectModelConfigs.js # 项目级模型配置数据 +│ └── userModelConfigs.js # 个人模型配置数据 │ ├── pages/ # 页面组件 │ ├── console/ # 工作台子页面 @@ -115,6 +118,8 @@ src/ │ ├── layouts/ # 布局系统 │ ├── components/ # 组件样式 │ ├── pages/ # 页面样式 +│ │ ├── model-selector/ # 模型选择器样式 +│ │ └── ... │ └── global.scss # 主入口 │ ├── App.jsx # 路由配置 @@ -128,7 +133,7 @@ src/ | 模块 | 路由 | 功能 | |------|------|------| | 首页 | `/` | 品牌展示、登录入口 | -| 工作台 | `/console` | 聊天、技能市场、定时任务、项目管理（成员/权限/技能配置） | +| 工作台 | `/console` | 聊天、技能市场、定时任务、项目管理（成员/权限/技能/模型配置）、个人模型配置 | | 管理台 | `/admin` | 部门/用户/项目管理、模型配置 | | 开发台 | `/developer` | 技能开发、版本管理 | diff --git a/docs/模型管理.md b/docs/模型管理.md new file mode 100644 index 0000000..78ff63c --- /dev/null +++ b/docs/模型管理.md @@ -0,0 +1,240 @@ +# 模型配置管理业务设计 + +## 概述 + +模型配置管理是一个多层级模型配置系统，支持平台级、项目级、用户级三个层级的模型配置。各级配置独立管理，模型列表累加可见，默认模型按优先级链确定。 + +## 核心业务规则 + +### 模型配置层级结构 + +```mermaid +graph TB + subgraph Platform["平台级模型配置 (Platform Level)"] + P1[配置者: 平台管理员] + P2[可见性: 所有用户可见] + P3[用途: 作为所有用户的基础模型池] + P4[默认模型: 平台默认模型] + end + + subgraph Project["项目级模型配置 (Project Level)"] + Pr1[配置者: 项目管理员] + Pr2[可见性: 仅项目成员可见] + Pr3[用途: 项目专用模型, 覆盖平台默认] + Pr4[默认模型: 项目默认模型] + end + + subgraph User["用户级模型配置 (User Level)"] + U1[配置者: 用户自己] + U2[可见性: 仅自己可见] + U3[用途: 用户自定义模型, 覆盖项目/平台默认] + U4[默认模型: 个人默认模型] + end + + Platform -->|继承| Project + Project -->|继承| User +``` + +### 权限边界 + +- **完全隔离**：各级别只能管理本级别的模型配置 + - 平台管理员：只能管理平台级模型配置 + - 项目管理员：只能管理本项目模型配置 + - 普通用户：只能管理个人模型配置 +- **不可干预**：平台管理员不可干预项目级或用户级模型配置 +- **菜单可见性**：项目成员看不到"模型管理"菜单（仅项目管理员可见） +- **安全性**：模型调用由服务端统一处理，API密钥不暴露给前端 + +### 模型可见性规则 + +- **平台模型**：所有用户可见 +- **项目模型**：仅项目成员可见 +- **个人模型**：仅自己可见 +- **跨项目隔离**：项目X的模型在项目Y内不可见 +- **累加模式**：用户可选模型 = 平台模型 ∪ 当前项目模型 ∪ 个人模型 + +### 模型选择规则 + +#### 可选模型范围 + +用户在项目X内： +``` +可选模型 = 平台模型 ∪ 项目X模型 ∪ 个人模型 +``` + +#### 默认模型优先级链 + +新建对话时： +``` +默认模型 = 个人默认 ∨ 项目默认 ∨ 平台默认 +``` + +已有对话时： +``` +使用模型 = 上次使用的模型 +``` + +模型失效时： +``` +回退到默认模型优先级链 → 个人默认 ∨ 项目默认 ∨ 平台默认 +``` + +### 默认模型规则 + +- **自动设置**：新增第一个模型时，自动设为默认模型 +- **删除规则**： + - **平台级**：默认模型不允许直接删除，必须先将另一个模型设为默认，然后才能删除 + - **项目级**：允许删除默认模型，删除后该级别没有默认模型 + - **用户级**：允许删除默认模型，删除后该级别没有默认模型 +- **配置数量**：各级别不限制模型配置数量 +- **空列表处理**：没有任何模型时，用户可以新建对话，但对话输入框的模型下拉列表为空 + +### 跨项目对话隔离 + +对话列表按项目维度隔离： +- 在项目A的对话列表中，只能看到项目A的对话 +- 切换到项目B后，在项目B的对话列表中只能看到项目B的对话 +- 不同项目的对话互不可见 + +## 配置内容 + +### 配置字段 + +所有级别的模型配置包含相同的字段： + +#### 基本信息 +- 配置名称（必填） +- 配置类型（必填，新建时可选，编辑时只读） + - OpenAI 兼容接口 + - 智算管理平台 + +#### API配置（根据类型不同） + +**OpenAI 兼容接口**： +- API地址（必填） +- API密钥（必填，掩码显示） +- 模型名称（必填） + +**智算管理平台**： +- API地址（必填） +- App ID（必填） +- App Secret（必填，掩码显示） + +#### 参数配置（仅OpenAI兼容接口） +- Temperature（0-2，默认0.7） +- Max Tokens（1-128000，默认4096） +- Top P（0-1，默认0.9） + +## 附录：常见问题 + +### 📋 模型可见性问题 + +#### 1. 用户在项目内能看到哪些模型？模型可见性有哪些规则？ + +用户在项目X内可见的模型采用累加模式： +``` +可选模型 = 平台模型 ∪ 项目X模型 ∪ 个人模型 +``` + +**可见性规则**： +- **跨项目隔离**：项目X的模型在项目Y内不可见 +- **多项目差异**：用户在不同项目内看到的模型列表不同（平台模型和个人模型在所有项目可见，项目模型仅在本项目可见） +- **移出项目**：用户被移出项目后，项目模型从列表消失，但数据保留；重新加入后恢复可见 +- **项目成员权限**：项目模型对所有成员可见，但只有管理员能管理，普通成员只能使用 +- **模型下拉列表展示**：同名配置在模型下拉列表中会分组展示 + +### 🎯 默认模型问题 + +#### 2. 新增第一个模型时需要手动设为默认吗？ + +不需要。系统会自动将新增的第一个模型设为默认模型。各级别模型配置都遵循此规则： +- 平台新增第一个模型 → 自动设为平台默认 +- 项目新增第一个模型 → 自动设为项目默认 +- 用户新增第一个模型 → 自动设为个人默认 + +#### 3. 默认模型可以删除吗？ + +根据配置级别不同，删除规则不同： + +- **平台级**：默认模型不允许直接删除，必须先将另一个模型设为默认，然后才能删除原来的默认模型 + +- **项目级**：允许删除默认模型，删除后该级别没有默认模型 + +- **用户级**：允许删除默认模型，删除后该级别没有默认模型 + +#### 4. 如果某个级别没有配置任何模型，会怎样？ + +如果某个级别没有配置任何模型，该级别的默认模型为空，系统会按优先级链继续向上查找： +- 用户没有个人模型 → 使用项目默认模型 +- 项目没有项目模型 → 使用平台默认模型 +- 如果平台也没有模型 → 用户可以新建对话，但对话输入框的模型下拉列表为空 + +#### 5. 项目管理员想更换项目默认模型，原来的默认模型会怎样？对已有对话有影响吗？ + +项目管理员将模型B设为新的默认模型后： +- 原默认模型A变为普通模型（is_default = false） +- 模型B变为新的默认模型（is_default = true） + +原默认模型A不会被删除，仍然在项目模型列表中，项目成员可以继续使用。 + +已有对话不受影响，继续使用对话创建时选择的模型。 + +### ⚙️ 配置管理问题 + +#### 6. 平台管理员能编辑或删除项目级、用户级的模型配置吗？ + +不能。各级模型配置权限完全隔离： +- 平台管理员：只能管理平台级模型配置 +- 项目管理员：只能管理本项目模型配置 +- 用户：只能管理个人模型配置 + +平台管理员无法查看、编辑、删除项目级或用户级的模型配置，确保各级模型配置的独立性和安全性。 + +#### 7. 项目管理员能看到项目成员的个人模型配置吗？ + +不能。个人模型配置仅用户自己可见，项目管理员无法查看或管理项目成员的个人模型。 + +用户在项目内使用个人模型时，项目管理员只知道用户选择了某个模型，但无法查看模型的配置详情（如API密钥）。 + +#### 8. 编辑模型配置时，配置类型可以修改吗？ + +不可以。配置类型（OpenAI 兼容接口 / 智算管理平台）在新建时选择，保存后不可修改。 + +编辑模型配置时，配置类型字段为只读状态，只能修改其他字段（如API地址、密钥、参数等）。 + +如果需要更换配置类型，必须删除原模型配置，重新创建新模型配置。删除已被对话使用的模型配置后，该对话会失效并触发模型回退逻辑。 + +#### 9. 配置名称可以重复吗？ + +可以。配置名称仅用于展示和区分，不要求唯一性。同一个级别下可以有多个同名配置，但建议使用有区分度的名称便于管理。 + +系统通过配置ID唯一标识模型，不依赖名称唯一性。同名配置在模型下拉列表中会分组展示。 + +### 🔐 安全性问题 + +#### 10. 项目成员能看到项目模型的API密钥吗？ + +不能。项目成员看不到"模型管理"菜单，无法访问模型配置页面，因此无法查看API密钥。 + +只有项目管理员能查看和管理项目模型的配置详情（包括API密钥），且密钥在表单中默认掩码显示，需要点击显示按钮才能查看明文。 + +#### 11. 不同级别的模型配置，API密钥存储方式有区别吗？ + +没有区别。所有级别的模型配置，API密钥都存储在服务端数据库中，存储方式一致，安全级别一致。前端只知道模型ID，从未接触API密钥。 + +### ❓ 其他问题 + +#### 12. 用户在项目X内使用项目模型D创建对话，后来项目模型D被删除，用户继续这个对话时会使用哪个模型？ + +系统会自动切换到默认模型（按优先级链）： +``` +个人默认 → 项目X默认 → 平台默认 +``` + +用户打开对话时，系统检测到模型D已失效，自动切换并提示："原模型已失效，已切换为XXX"。后续新消息使用切换后的模型，历史消息保持不变。 + +#### 13. 用户在项目X内使用个人模型D创建对话，后来用户被移出项目X，个人模型D会被删除吗？ + +不会被删除。个人模型是用户级别的模型配置，跟着用户走，不会因为被移出项目就被删除。用户在其他项目仍然可以使用个人模型D。 + +*最后更新：2026-04-10* diff --git a/openspec/specs/model-selector/spec.md b/openspec/specs/model-selector/spec.md new file mode 100644 index 0000000..0356d98 --- /dev/null +++ b/openspec/specs/model-selector/spec.md @@ -0,0 +1,104 @@ +## ADDED Requirements + +### Requirement: 融合式模型选择器触发器 + +系统 SHALL 在对话输入框的顶部集成模型选择器触发器，显示当前选中的模型名称和默认标记。 + +#### Scenario: 显示模型选择器触发器 +- **WHEN** 用户访问聊天页面 +- **THEN** 系统在聊天输入框顶部显示模型选择器触发器 +- **THEN** 触发器显示模型图标、模型名称、默认标记（如果适用）和下拉箭头 +- **THEN** 触发器与输入框融合为一个整体 + +#### Scenario: 显示默认标记 +- **WHEN** 当前选中的模型是默认模型（`isDefault = true`） +- **THEN** 触发器在模型名称后显示"默认"标签 +- **THEN** 标签使用渐变背景色，视觉突出 + +#### Scenario: 隐藏默认标记 +- **WHEN** 当前选中的模型不是默认模型 +- **THEN** 触发器不显示"默认"标签 + +### Requirement: 展开模型选择器下拉列表 + +系统 SHALL 在用户点击触发器时展开模型选择器下拉列表，按层级分组展示模型（平台模型/项目模型/个人模型）。 + +#### Scenario: 展开下拉列表 +- **WHEN** 用户点击模型选择器触发器 +- **THEN** 系统展开下拉列表，显示在触发器下方 +- **THEN** 下拉列表按层级分组：平台模型、项目模型、个人模型 +- **THEN** 每个分组显示分组标题和该层级的模型列表 +- **THEN** 展开时有平滑的动画效果 + +#### Scenario: 分组标题显示 +- **WHEN** 下拉列表展开 +- **THEN** 平台模型分组显示标题"📍 平台模型" +- **THEN** 项目模型分组显示标题"📍 项目模型" +- **THEN** 个人模型分组显示标题"📍 个人模型" +- **THEN** 分组标题使用小号字体和浅色文字 + +#### Scenario: 模型列表项显示 +- **WHEN** 下拉列表展开 +- **THEN** 每个模型显示模型图标、模型名称和默认标记（如果适用） +- **THEN** 选中模型使用浅蓝色背景和左侧边框高亮显示 +- **THEN** 选中模型右侧显示勾选图标 + +#### Scenario: 鼠标悬停效果 +- **WHEN** 用户鼠标悬停在某个模型上 +- **THEN** 系统显示浅蓝色背景 + +### Requirement: 选择模型 + +系统 SHALL 允许用户从下拉列表中选择模型，更新当前选中状态并收起下拉列表。 + +#### Scenario: 选择非默认模型 +- **WHEN** 用户点击下拉列表中的某个模型 +- **THEN** 系统更新当前选中模型状态 +- **THEN** 触发器显示新选中的模型名称 +- **THEN** 触发器移除"默认"标签（如果新模型不是默认） +- **THEN** 下拉列表收起 + +#### Scenario: 选择默认模型 +- **WHEN** 用户点击下拉列表中的某个默认模型 +- **THEN** 系统更新当前选中模型状态 +- **THEN** 触发器显示新选中的模型名称 +- **THEN** 触发器显示"默认"标签 +- **THEN** 下拉列表收起 + +#### Scenario: 模型列表中的默认标记 +- **WHEN** 某个模型是默认模型（`isDefault = true`） +- **THEN** 下拉列表中的该模型显示"默认"标签 +- **THEN** 标签使用渐变背景色，视觉突出 + +### Requirement: 收起模型选择器下拉列表 + +系统 SHALL 在用户点击触发器或选择模型后收起下拉列表。 + +#### Scenario: 再次点击触发器收起 +- **WHEN** 用户再次点击已展开的触发器 +- **THEN** 系统收起下拉列表 + +#### Scenario: 选择模型后自动收起 +- **WHEN** 用户从下拉列表中选择模型 +- **THEN** 系统自动收起下拉列表 + +#### Scenario: 点击外部区域收起 +- **WHEN** 用户点击下拉列表外部的区域 +- **THEN** 系统收起下拉列表（如果当前是展开状态） + +### Requirement: 模型选择器样式 + +系统 SHALL 使用融合式设计，模型选择器与输入框风格一致，圆角、边框、阴影统一。 + +#### Scenario: 融合式设计 +- **WHEN** 模型选择器展开 +- **THEN** 触发器和下拉列表形成一个整体 +- **THEN** 触发器使用浅灰色背景，圆角顶部 16px +- **THEN** 下拉列表使用白色背景，圆角底部 12px +- **THEN** 边框颜色和阴影与输入框一致 + +#### Scenario: 响应式设计 +- **WHEN** 用户使用移动设备访问 +- **THEN** 模型选择器自适应屏幕宽度 +- **THEN** 触发器使用较小的内边距和字体大小 +- **THEN** 下拉列表最大高度调整为 280px diff --git a/openspec/specs/platform-model-config/spec.md b/openspec/specs/platform-model-config/spec.md new file mode 100644 index 0000000..b88502b --- /dev/null +++ b/openspec/specs/platform-model-config/spec.md @@ -0,0 +1,89 @@ +## ADDED Requirements + +### Requirement: 展示平台级模型配置列表 + +系统 SHALL 在管理台的模型配置页面展示所有平台级模型配置的列表，每个配置项显示配置名称、配置类型、状态和操作按钮。 + +#### Scenario: 查看配置列表 +- **WHEN** 用户访问 `/admin/models` 页面 +- **THEN** 系统显示所有平台级模型配置的表格 +- **THEN** 每个配置项显示配置名称、配置类型、状态（生效中/未生效）和操作按钮 +- **THEN** 表格头部显示"新增配置"按钮 + +#### Scenario: 生效中的配置高亮显示 +- **WHEN** 配置的 `isActive` 字段为 `true` +- **THEN** 配置项在表格中高亮显示（使用背景色或边框） + +#### Scenario: 配置类型显示 +- **WHEN** 配置类型为 `basic` +- **THEN** 配置类型列显示"OpenAI 兼容接口" +- **WHEN** 配置类型为 `zhisuan` +- **THEN** 配置类型列显示"智算管理平台" + +### Requirement: 新增平台级模型配置 + +系统 SHALL 允许平台管理员创建新的平台级模型配置，配置包含基本信息、API 配置和参数配置（根据类型不同）。 + +#### Scenario: 打开新增配置页面 +- **WHEN** 用户点击"新增配置"按钮 +- **THEN** 系统导航到 `/admin/models/add` 页面 +- **THEN** 页面显示配置名称、配置类型、API 配置和参数配置表单 + +#### Scenario: 选择配置类型 +- **WHEN** 用户在新增配置页面选择配置类型 +- **THEN** 系统根据选择的类型显示相应的配置字段 +- **WHEN** 用户选择"OpenAI 兼容接口" +- **THEN** 系统显示 API 地址、API 密钥、模型名称、Temperature、Max Tokens、Top P 字段 +- **WHEN** 用户选择"智算管理平台" +- **THEN** 系统显示 API 地址、App ID、App Secret 字段 + +#### Scenario: 保存新配置 +- **WHEN** 用户填写完整配置信息并点击"保存"按钮 +- **THEN** 系统验证表单数据 +- **WHEN** 表单验证通过 +- **THEN** 系统创建新配置并导航到配置列表页面 +- **THEN** 如果这是第一个配置，系统自动将其设为默认模型（`isActive = true`） + +### Requirement: 编辑平台级模型配置 + +系统 SHALL 允许平台管理员编辑已存在的平台级模型配置，但配置类型字段为只读。 + +#### Scenario: 打开编辑配置页面 +- **WHEN** 用户点击某个配置的"编辑"按钮 +- **THEN** 系统导航到 `/admin/models/:id/edit` 页面 +- **THEN** 页面预填充该配置的所有信息 +- **THEN** 配置类型字段为只读状态，显示"配置类型不可修改"提示 + +#### Scenario: 保存编辑的配置 +- **WHEN** 用户修改配置信息并点击"保存"按钮 +- **THEN** 系统更新配置并导航到配置列表页面 + +### Requirement: 删除平台级模型配置 + +系统 SHALL 允许平台管理员删除非默认的平台级模型配置，默认模型不允许删除。 + +#### Scenario: 删除非默认配置 +- **WHEN** 用户点击某个非默认配置的"删除"按钮 +- **THEN** 系统显示删除确认弹窗 +- **WHEN** 用户确认删除 +- **THEN** 系统删除该配置并刷新配置列表 + +#### Scenario: 删除默认配置被禁用 +- **WHEN** 配置为默认模型（`isActive = true`） +- **THEN** 系统禁用"删除"按钮 +- **THEN** 鼠标悬停时显示提示"平台默认模型不允许删除，请先切换默认模型" + +### Requirement: 设为平台级默认模型 + +系统 SHALL 允许平台管理员将某个非默认配置设为平台级默认模型，更新页面状态但不修改实际数据。 + +#### Scenario: 设为默认配置 +- **WHEN** 用户点击某个非默认配置的"设为默认"按钮 +- **THEN** 系统显示确认弹窗"确定将'XXX'设为平台默认模型配置吗？切换后，原生效配置将变为备用状态。" +- **WHEN** 用户确认切换 +- **THEN** 系统更新页面状态，将原默认配置设为非默认，将目标配置设为默认 +- **THEN** 系统不修改实际数据文件（原型行为） + +#### Scenario: 默认配置不显示设为默认按钮 +- **WHEN** 配置已经是默认模型（`isActive = true`） +- **THEN** 系统不显示"设为默认"按钮 diff --git a/openspec/specs/project-model-config/spec.md b/openspec/specs/project-model-config/spec.md new file mode 100644 index 0000000..d4f2c84 --- /dev/null +++ b/openspec/specs/project-model-config/spec.md @@ -0,0 +1,81 @@ +## ADDED Requirements + +### Requirement: 展示项目级模型配置列表 + +系统 SHALL 在工作台的项目管理二级菜单中的模型配置页面展示所有项目级模型配置的列表，每个配置项显示配置名称、配置类型、状态和操作按钮。 + +#### Scenario: 查看配置列表 +- **WHEN** 用户通过工作台项目管理菜单访问 `/console/project/models` 页面 +- **THEN** 系统显示所有项目级模型配置的表格 +- **THEN** 每个配置项显示配置名称、配置类型、状态（生效中/未生效）和操作按钮 +- **THEN** 表格头部显示"新增配置"按钮 + +### Requirement: 新增项目级模型配置 + +系统 SHALL 允许项目管理员创建新的项目级模型配置，配置包含基本信息、API 配置和参数配置（根据类型不同）。 + +#### Scenario: 打开新增配置页面 +- **WHEN** 用户点击"新增配置"按钮 +- **THEN** 系统导航到 `/console/project/models/add` 页面 +- **THEN** 页面显示配置名称、配置类型、API 配置和参数配置表单 + +#### Scenario: 选择配置类型 +- **WHEN** 用户在新增配置页面选择配置类型 +- **THEN** 系统根据选择的类型显示相应的配置字段 +- **WHEN** 用户选择"OpenAI 兼容接口" +- **THEN** 系统显示 API 地址、API 密钥、模型名称、Temperature、Max Tokens、Top P 字段 +- **WHEN** 用户选择"智算管理平台" +- **THEN** 系统显示 API 地址、App ID、App Secret 字段 + +#### Scenario: 保存新配置 +- **WHEN** 用户填写完整配置信息并点击"保存"按钮 +- **THEN** 系统验证表单数据 +- **WHEN** 表单验证通过 +- **THEN** 系统创建新配置并导航到配置列表页面 +- **THEN** 如果这是第一个配置，系统自动将其设为默认模型（`isActive = true`） + +### Requirement: 编辑项目级模型配置 + +系统 SHALL 允许项目管理员编辑已存在的项目级模型配置，但配置类型字段为只读。 + +#### Scenario: 打开编辑配置页面 +- **WHEN** 用户点击某个配置的"编辑"按钮 +- **THEN** 系统导航到 `/console/project/models/:id/edit` 页面 +- **THEN** 页面预填充该配置的所有信息 +- **THEN** 配置类型字段为只读状态，显示"配置类型不可修改"提示 + +#### Scenario: 保存编辑的配置 +- **WHEN** 用户修改配置信息并点击"保存"按钮 +- **THEN** 系统更新配置并导航到配置列表页面 + +### Requirement: 删除项目级模型配置 + +系统 SHALL 允许项目管理员删除任何项目级模型配置，包括默认模型。 + +#### Scenario: 删除默认配置 +- **WHEN** 用户点击某个默认配置的"删除"按钮 +- **THEN** 系统显示删除确认弹窗 +- **WHEN** 用户确认删除 +- **THEN** 系统删除该配置并刷新配置列表 +- **THEN** 删除后该级别没有默认模型 + +#### Scenario: 删除非默认配置 +- **WHEN** 用户点击某个非默认配置的"删除"按钮 +- **THEN** 系统显示删除确认弹窗 +- **WHEN** 用户确认删除 +- **THEN** 系统删除该配置并刷新配置列表 + +### Requirement: 设为项目级默认模型 + +系统 SHALL 允许项目管理员将某个非默认配置设为项目级默认模型，更新页面状态但不修改实际数据。 + +#### Scenario: 设为默认配置 +- **WHEN** 用户点击某个非默认配置的"设为默认"按钮 +- **THEN** 系统显示确认弹窗 +- **WHEN** 用户确认切换 +- **THEN** 系统更新页面状态，将原默认配置设为非默认，将目标配置设为默认 +- **THEN** 系统不修改实际数据文件（原型行为） + +#### Scenario: 默认配置不显示设为默认按钮 +- **WHEN** 配置已经是默认模型（`isActive = true`） +- **THEN** 系统不显示"设为默认"按钮 diff --git a/openspec/specs/user-model-config/spec.md b/openspec/specs/user-model-config/spec.md new file mode 100644 index 0000000..86fd9c6 --- /dev/null +++ b/openspec/specs/user-model-config/spec.md @@ -0,0 +1,81 @@ +## ADDED Requirements + +### Requirement: 展示个人模型配置列表 + +系统 SHALL 在工作台侧边栏的个人模型配置页面展示所有个人模型配置的列表，每个配置项显示配置名称、配置类型、状态和操作按钮。 + +#### Scenario: 查看配置列表 +- **WHEN** 用户通过工作台侧边栏访问 `/console/user-models` 页面 +- **THEN** 系统显示所有个人模型配置的表格 +- **THEN** 每个配置项显示配置名称、配置类型、状态（生效中/未生效）和操作按钮 +- **THEN** 表格头部显示"新增配置"按钮 + +### Requirement: 新增个人模型配置 + +系统 SHALL 允许用户创建新的个人模型配置，配置包含基本信息、API 配置和参数配置（根据类型不同）。 + +#### Scenario: 打开新增配置页面 +- **WHEN** 用户点击"新增配置"按钮 +- **THEN** 系统导航到 `/console/user-models/add` 页面 +- **THEN** 页面显示配置名称、配置类型、API 配置和参数配置表单 + +#### Scenario: 选择配置类型 +- **WHEN** 用户在新增配置页面选择配置类型 +- **THEN** 系统根据选择的类型显示相应的配置字段 +- **WHEN** 用户选择"OpenAI 兼容接口" +- **THEN** 系统显示 API 地址、API 密钥、模型名称、Temperature、Max Tokens、Top P 字段 +- **WHEN** 用户选择"智算管理平台" +- **THEN** 系统显示 API 地址、App ID、App Secret 字段 + +#### Scenario: 保存新配置 +- **WHEN** 用户填写完整配置信息并点击"保存"按钮 +- **THEN** 系统验证表单数据 +- **WHEN** 表单验证通过 +- **THEN** 系统创建新配置并导航到配置列表页面 +- **THEN** 如果这是第一个配置，系统自动将其设为默认模型（`isActive = true`） + +### Requirement: 编辑个人模型配置 + +系统 SHALL 允许用户编辑已存在的个人模型配置，但配置类型字段为只读。 + +#### Scenario: 打开编辑配置页面 +- **WHEN** 用户点击某个配置的"编辑"按钮 +- **THEN** 系统导航到 `/console/user-models/:id/edit` 页面 +- **THEN** 页面预填充该配置的所有信息 +- **THEN** 配置类型字段为只读状态，显示"配置类型不可修改"提示 + +#### Scenario: 保存编辑的配置 +- **WHEN** 用户修改配置信息并点击"保存"按钮 +- **THEN** 系统更新配置并导航到配置列表页面 + +### Requirement: 删除个人模型配置 + +系统 SHALL 允许用户删除任何个人模型配置，包括默认模型。 + +#### Scenario: 删除默认配置 +- **WHEN** 用户点击某个默认配置的"删除"按钮 +- **THEN** 系统显示删除确认弹窗 +- **WHEN** 用户确认删除 +- **THEN** 系统删除该配置并刷新配置列表 +- **THEN** 删除后该级别没有默认模型 + +#### Scenario: 删除非默认配置 +- **WHEN** 用户点击某个非默认配置的"删除"按钮 +- **THEN** 系统显示删除确认弹窗 +- **WHEN** 用户确认删除 +- **THEN** 系统删除该配置并刷新配置列表 + +### Requirement: 设为个人默认模型 + +系统 SHALL 允许用户将某个非默认配置设为个人默认模型，更新页面状态但不修改实际数据。 + +#### Scenario: 设为默认配置 +- **WHEN** 用户点击某个非默认配置的"设为默认"按钮 +- **THEN** 系统显示确认弹窗 +- **WHEN** 用户确认切换 +- **THEN** 系统更新页面状态，将原默认配置设为非默认，将目标配置设为默认 +- **THEN** 系统不修改实际数据文件（原型行为） + +#### Scenario: 默认配置不显示设为默认按钮 +- **WHEN** 配置已经是默认模型（`isActive = true`） +- **THEN** 系统不显示"设为默认"按钮 diff --git a/src/App.jsx b/src/App.jsx index 240aa10..482e946 100644 --- a/src/App.jsx +++ b/src/App.jsx @@ -23,6 +23,10 @@ import PermissionsPage from './pages/console/PermissionsPage.jsx'; import SkillsConfigPage from './pages/console/SkillsConfigPage.jsx'; import ConsoleReviewListPage from './pages/console/ConsoleReviewListPage.jsx'; import ConsoleReviewDetailPage from './pages/console/ConsoleReviewDetailPage.jsx'; +import ProjectModelConfigsPage from './pages/console/ProjectModelConfigsPage.jsx'; +import AddProjectModelConfigPage from './pages/console/AddProjectModelConfigPage.jsx'; +import UserModelConfigsPage from './pages/console/UserModelConfigsPage.jsx'; +import AddUserModelConfigPage from './pages/console/AddUserModelConfigPage.jsx'; // Admin 子页面 import OverviewPage from './pages/admin/OverviewPage.jsx'; @@ -71,6 +75,12 @@ function App() { } /> } /> } /> + } /> + } /> + } /> + } /> + } /> + } /> }> diff --git a/src/components/common/Modal.jsx b/src/components/common/Modal.jsx index 6b28f85..72b9f7f 100644 --- a/src/components/common/Modal.jsx +++ b/src/components/common/Modal.jsx @@ -27,7 +27,7 @@ function Modal({ {showConfirm && (
- + {cancelText && }
)} diff --git a/src/components/layout/ConsoleLayout.jsx b/src/components/layout/ConsoleLayout.jsx index 2a89632..bea0515 100644 --- a/src/components/layout/ConsoleLayout.jsx +++ b/src/components/layout/ConsoleLayout.jsx @@ -1,6 +1,6 @@ import { useState } from 'react'; import { Outlet, useLocation, useNavigate } from 'react-router-dom'; -import { FiPlus, FiClock, FiList, FiUsers, FiBox, FiFolder, FiShield, FiSettings } from 'react-icons/fi'; +import { FiPlus, FiClock, FiList, FiUsers, FiBox, FiFolder, FiShield, FiSettings, FiCpu } from 'react-icons/fi'; import { FiTrash2 } from 'react-icons/fi'; import { FaPuzzlePiece } from 'react-icons/fa'; import Layout from '../Layout.jsx'; @@ -96,6 +96,12 @@ function ConsoleLayout() { active={isPathActive('/console/tasks')} onClick={() => navigate('/console/tasks')} /> + } + label="个人模型" + active={isPathActive('/console/user-models')} + onClick={() => navigate('/console/user-models')} + /> } label="日志查询" @@ -125,6 +131,12 @@ function ConsoleLayout() { active={isPathActive('/console/project/skills')} onClick={() => navigate('/console/project/skills')} /> + } + label="模型配置" + active={isPathActive('/console/project/models')} + onClick={() => navigate('/console/project/models')} + /> { @@ -19,14 +20,22 @@ function ModelConfigsPage() { const handleSetActiveConfirm = () => { if (selectedConfig) { - api.admin.modelConfigs.setActive(selectedConfig.id); - setConfigs([...api.admin.modelConfigs.list()]); + const updatedConfigs = configs.map(c => ({ + ...c, + isActive: c.id === selectedConfig.id + })); + setConfigs(updatedConfigs); } setShowSetActiveModal(false); setSelectedConfig(null); }; const handleDeleteClick = (config) => { + if (config.isActive) { + setSelectedConfig(config); + setShowDeleteBlockedModal(true); + return; + } setSelectedConfig(config); setShowDeleteModal(true); }; @@ -42,7 +51,6 @@ function ModelConfigsPage() { return (
- {/* 配置列表 */}
配置列表
@@ -86,17 +94,12 @@ function ModelConfigsPage() {
- {/* 设为默认确认弹窗 */} 切换后，原生效配置将变为备用状态。

 - {/* 删除确认弹窗 */} 确定要删除配置"{selectedConfig?.name}"吗？

此操作不可恢复。

 + + { + setShowDeleteBlockedModal(false); + setSelectedConfig(null); + }} + onCancel={() => { + setShowDeleteBlockedModal(false); + setSelectedConfig(null); + }} + confirmText="我知道了" + cancelText="" + > +

平台默认模型不允许删除。

+

请先将另一个配置设为默认，然后再删除此配置。

+
); } diff --git a/src/pages/console/AddProjectModelConfigPage.jsx b/src/pages/console/AddProjectModelConfigPage.jsx new file mode 100644 index 0000000..a898d3e --- /dev/null +++ b/src/pages/console/AddProjectModelConfigPage.jsx @@ -0,0 +1,203 @@ +import { useState, useEffect } from 'react'; +import { useParams, useNavigate } from 'react-router-dom'; +import { FiEye, FiEyeOff } from 'react-icons/fi'; +import { api } from '../../services/api.js'; +import { MODEL_CONFIG_TYPES, getConfigFields, getConfigTypeList } from '../../data/configTypes.js'; + +function AddProjectModelConfigPage() { + const { id } = useParams(); + const navigate = useNavigate(); + const editData = id ? api.consoleModels.project.getById(id) : null; + const isEdit = !!editData; + + const [configName, setConfigName] = useState(''); + const [configType, setConfigType] = useState('basic'); + const [fieldValues, setFieldValues] = useState({}); + const [showPasswords, setShowPasswords] = useState({}); + + useEffect(() => { + if (editData) { + setConfigName(editData.name || ''); + setConfigType(editData.type || 'basic'); + const typeData = editData[editData.type] || {}; + const initialValues = {}; + const fields = getConfigFields(editData.type); + fields.forEach(field => { + initialValues[field.key] = typeData[field.key] ?? field.default ?? ''; + }); + setFieldValues(initialValues); + } else { + const fields = getConfigFields('basic'); + const initialValues = {}; + fields.forEach(field => { + initialValues[field.key] = field.default ?? ''; + }); + setFieldValues(initialValues); + } + }, [editData]); + + const handleTypeChange = (newType) => { + if (isEdit) return; + setConfigType(newType); + const fields = getConfigFields(newType); + const newValues = {}; + fields.forEach(field => { + newValues[field.key] = field.default ?? ''; + }); + setFieldValues(newValues); + }; + + const handleFieldChange = (key, value) => { + setFieldValues(prev => ({ ...prev, [key]: value })); + }; + + const togglePasswordVisibility = (key) => { + setShowPasswords(prev => ({ ...prev, [key]: !prev[key] })); + }; + + const handleSave = () => { + const typeData = {}; + const fields = getConfigFields(configType); + fields.forEach(field => { + let value = fieldValues[field.key]; + if (field.type === 'number' && value !== '') { + value = Number(value); + } + typeData[field.key] = value; + }); + + const configData = { + name: configName.trim(), + type: configType, + [configType]: typeData + }; + + if (isEdit) { + api.consoleModels.project.update(editData.id, configData); + } else { + api.consoleModels.project.create(configData); + } + + navigate('/console/project/models'); + }; + + const currentFields = getConfigFields(configType); + const configTypeList = getConfigTypeList(); + + return ( + <> +
navigate('/console/project/models')}> + ← + 返回配置列表 +
+
+
+
{isEdit ? '编辑配置' : '新增配置'}
+
+
+
+ + setConfigName(e.target.value)} + /> +
+ +
+ + + {isEdit && ( +
+ 配置类型不可修改 +
+ )} +
+ +
+
+ {MODEL_CONFIG_TYPES[configType]?.label} 配置 +
+ + {currentFields.map(field => ( +
+ + + {field.type === 'password' ? ( +
+ handleFieldChange(field.key, e.target.value)} + /> + +
+ ) : field.type === 'number' ? ( + handleFieldChange(field.key, e.target.value)} + min={field.min} + max={field.max} + step={field.step} + /> + ) : ( + handleFieldChange(field.key, e.target.value)} + /> + )} +
+ ))} +
+ +
+ + +
+
+
+ + ); +} + +export default AddProjectModelConfigPage; diff --git a/src/pages/console/AddUserModelConfigPage.jsx b/src/pages/console/AddUserModelConfigPage.jsx new file mode 100644 index 0000000..5239e1c --- /dev/null +++ b/src/pages/console/AddUserModelConfigPage.jsx @@ -0,0 +1,203 @@ +import { useState, useEffect } from 'react'; +import { useParams, useNavigate } from 'react-router-dom'; +import { FiEye, FiEyeOff } from 'react-icons/fi'; +import { api } from '../../services/api.js'; +import { MODEL_CONFIG_TYPES, getConfigFields, getConfigTypeList } from '../../data/configTypes.js'; + +function AddUserModelConfigPage() { + const { id } = useParams(); + const navigate = useNavigate(); + const editData = id ? api.consoleModels.user.getById(id) : null; + const isEdit = !!editData; + + const [configName, setConfigName] = useState(''); + const [configType, setConfigType] = useState('basic'); + const [fieldValues, setFieldValues] = useState({}); + const [showPasswords, setShowPasswords] = useState({}); + + useEffect(() => { + if (editData) { + setConfigName(editData.name || ''); + setConfigType(editData.type || 'basic'); + const typeData = editData[editData.type] || {}; + const initialValues = {}; + const fields = getConfigFields(editData.type); + fields.forEach(field => { + initialValues[field.key] = typeData[field.key] ?? field.default ?? ''; + }); + setFieldValues(initialValues); + } else { + const fields = getConfigFields('basic'); + const initialValues = {}; + fields.forEach(field => { + initialValues[field.key] = field.default ?? ''; + }); + setFieldValues(initialValues); + } + }, [editData]); + + const handleTypeChange = (newType) => { + if (isEdit) return; + setConfigType(newType); + const fields = getConfigFields(newType); + const newValues = {}; + fields.forEach(field => { + newValues[field.key] = field.default ?? ''; + }); + setFieldValues(newValues); + }; + + const handleFieldChange = (key, value) => { + setFieldValues(prev => ({ ...prev, [key]: value })); + }; + + const togglePasswordVisibility = (key) => { + setShowPasswords(prev => ({ ...prev, [key]: !prev[key] })); + }; + + const handleSave = () => { + const typeData = {}; + const fields = getConfigFields(configType); + fields.forEach(field => { + let value = fieldValues[field.key]; + if (field.type === 'number' && value !== '') { + value = Number(value); + } + typeData[field.key] = value; + }); + + const configData = { + name: configName.trim(), + type: configType, + [configType]: typeData + }; + + if (isEdit) { + api.consoleModels.user.update(editData.id, configData); + } else { + api.consoleModels.user.create(configData); + } + + navigate('/console/user-models'); + }; + + const currentFields = getConfigFields(configType); + const configTypeList = getConfigTypeList(); + + return ( + <> +
navigate('/console/user-models')}> + ← + 返回配置列表 +
+
+
+
{isEdit ? '编辑配置' : '新增配置'}
+
+
+
+ + setConfigName(e.target.value)} + /> +
+ +
+ + + {isEdit && ( +
+ 配置类型不可修改 +
+ )} +
+ +
+
+ {MODEL_CONFIG_TYPES[configType]?.label} 配置 +
+ + {currentFields.map(field => ( +
+ + + {field.type === 'password' ? ( +
+ handleFieldChange(field.key, e.target.value)} + /> + +
+ ) : field.type === 'number' ? ( + handleFieldChange(field.key, e.target.value)} + min={field.min} + max={field.max} + step={field.step} + /> + ) : ( + handleFieldChange(field.key, e.target.value)} + /> + )} +
+ ))} +
+ +
+ + +
+
+
+ + ); +} + +export default AddUserModelConfigPage; diff --git a/src/pages/console/ChatPage.jsx b/src/pages/console/ChatPage.jsx index 48c74ca..459ef36 100644 --- a/src/pages/console/ChatPage.jsx +++ b/src/pages/console/ChatPage.jsx @@ -1,7 +1,99 @@ -import { useEffect, useRef } from 'react'; +import { useEffect, useRef, useState } from 'react'; import { useParams } from 'react-router-dom'; import { getChatScenes } from '../../data/conversations.js'; -import { FiPaperclip, FiCode, FiSend } from 'react-icons/fi'; +import { FiPaperclip, FiCode, FiSend, FiChevronDown } from 'react-icons/fi'; +import { api } from '../../services/api.js'; + +function ModelSelector({ selectedModel, onSelectModel }) { + const [open, setOpen] = useState(false); + const ref = useRef(null); + + const platformModels = api.admin.modelConfigs.list().map(c => ({ + id: c.id, + name: c.name, + level: 'platform', + isDefault: c.isActive, + })); + + const projectModels = api.consoleModels.project.list().map(c => ({ + id: c.id, + name: c.name, + level: 'project', + isDefault: c.isActive, + })); + + const userModels = api.consoleModels.user.list().map(c => ({ + id: c.id, + name: c.name, + level: 'user', + isDefault: c.isActive, + })); + + const groups = [ + { key: 'platform', title: '平台模型', models: platformModels }, + { key: 'project', title: '项目模型', models: projectModels }, + { key: 'user', title: '个人模型', models: userModels }, + ]; + + useEffect(() => { + const handleClickOutside = (e) => { + if (ref.current && !ref.current.contains(e.target)) { + setOpen(false); + } + }; + document.addEventListener('mousedown', handleClickOutside); + return () => document.removeEventListener('mousedown', handleClickOutside); + }, []); + + const handleSelect = (model) => { + onSelectModel(model); + setOpen(false); + }; + + return ( +
+
setOpen(!open)} + > +
+ + + + {selectedModel?.name || '选择模型'} + {selectedModel?.isDefault && ( + 默认 + )} +
+ + + +
+ + {open && ( +
+ {groups.map(group => ( +
+
{group.title}
+ {group.models.map(model => ( +
handleSelect(model)} + > + {model.name} + {model.isDefault && ( + 默认 + )} +
+ ))} +
+ ))} +
+ )} +
+ ); +} function ChatPage() { const { scene } = useParams(); @@ -10,6 +102,17 @@ function ChatPage() { const html = chatScenes[currentScene] || ''; const chatMessagesRef = useRef(null); + const defaultPlatformModel = api.admin.modelConfigs.list().find(c => c.isActive); + const defaultProjectModel = api.consoleModels.project.list().find(c => c.isActive); + const defaultUserModel = api.consoleModels.user.list().find(c => c.isActive); + const initialModel = defaultUserModel || defaultProjectModel || defaultPlatformModel; + + const [selectedModel, setSelectedModel] = useState(() => { + if (!initialModel) return null; + const level = defaultUserModel ? 'user' : (defaultProjectModel ? 'project' : 'platform'); + return { id: initialModel.id, name: initialModel.name, level, isDefault: true }; + }); + useEffect(() => { if (!chatMessagesRef.current) return; @@ -30,7 +133,7 @@ function ChatPage() { el.removeEventListener('click', handleClick); }); }; - }, [scene, html]); // 依赖场景和html内容 + }, [scene, html]); return (
@@ -41,6 +144,10 @@ function ChatPage() {
+