提交 e77241fb authored 作者: yujiejie's avatar yujiejie

0823最终版本

上级 f0b387d6
# 0823 核心交互逻辑与验收标准
> 生成时间:2026-08-24
> 依据文件:`docs/AutoDL部署实操任务.md`、`pages-mentor.js`(导师部署验收台)
---
## 一、导师端 API 自动化测试逻辑
### 1.1 通用前置条件与请求构造
**Base URL 构造**(`getMentorDeployBaseUrl`):
- 取验收参数 `params.apiUrl`,去除末尾 `/`
- 若地址未带端口且学生提交过端口,自动拼接 `:端口`(导师地址已带端口则不重复拼)
- 为空时点击任何测试按钮都会弹窗提示「缺少 API 地址」
**请求头**(`getMentorDeployRequestHeaders`):
```js
{ 'Content-Type': 'application/json', 'Authorization': 'Bearer <apiKey>' }
```
Key 为空时不带 Authorization 头。
**每次测试的结果快照**(写入 `tests[taskKey][sid].{models,chat,genSubmit,genStatus}`):
`status`(pass/fail/loading)、`httpStatus`、`latency`(ms)、`raw`(格式化JSON)、`error`、`testedAt`、`url`。
---
### 1.2 任务一:文本模型
#### ① `GET /v1/models`(模型发现验证)
| 项 | 内容 |
|----|------|
| URL | `base + '/v1/models'` |
| 请求参数 | 无 body,仅 Bearer 认证 |
| 触发时机 | 点击「模型列表」测试按钮 |
**通过条件**:`HTTP 2xx` 且返回的 `data[].id` 中包含验收参数中声明的 `modelName`(默认 `qwen3.5-4b`)。
**失败场景**:
- 非 2xx → `接口返回非 2xx:HTTP xxx · <error.message>`
- 2xx 但模型列表不含声明模型 → `HTTP 200,但模型列表未包含声明的模型名称「...」,请核对模型名称是否与部署服务一致。`
**结果展示**:状态码(2xx 绿/其他红)+ 耗时 + 返回模型 ID 列表(前 8 个,超出省略)+ 「已包含声明的模型 X / 未找到声明的模型 X」提示 + 原始 JSON。
#### ② `POST /v1/chat/completions`(Chat 补全验证)
| 项 | 内容 |
|----|------|
| URL | `base + apiPath`(默认 `/v1/chat/completions`) |
| 请求体 | 见下 |
| 触发时机 | 点击「聊天补全」测试按钮 |
**请求体构造**(与知识库 1.3.3 对齐):
```js
{
model: params.modelName, // 如 qwen3.5-4b
messages: [{ role: 'user', content: prompt }], // 仅一条 user 消息
max_tokens: parseInt(params.maxTokens) || 2048,
temperature: parseFloat(params.temperature) // 空则不带该字段
}
```
**内置默认参数**(`MENTOR_DEPLOY_TASKS['text-model']`):
| 参数 | 默认值 | 对应知识库 |
|------|--------|-----------|
| 测试提示词 `prompt` | `请用三点解释 vLLM 的连续批处理。` | 知识库 1.3.3 用户提问一致 |
| `max_tokens` | `160` | 一致 |
| `temperature` | `0.2` | 一致 |
> 与知识库差异:知识库请求体含 system 消息(「你是技术助手…」)且显式 `"stream": false`,原型只发一条 user 消息、未显式传 stream。
**通过条件**:`HTTP 2xx` 且 `choices[0].message.content` 存在且 trim 后非空(对应知识库「Chat 响应中的 content 为非空文本」)。
**失败场景**:
- 非 2xx → `接口返回非 2xx:HTTP xxx · <error.message>`
- 2xx 但无非空 content → `HTTP 200,但未解析到非空的 choices[0].message.content,请确认返回结构与 OpenAI 兼容格式一致。`
**结果展示**:状态码 + 耗时 + 返回的 `content` 文本 + 返回模型名 `returnedModel` + 原始 JSON。
---
### 1.3 任务二:图像生成
#### ① `GET /v1/models`(图像模型列表)
同文本模型的 models 测试逻辑:2xx 且列表包含声明的模型名即通过。
#### ② `POST /v1/generations`(提交生成任务)
| 项 | 内容 |
|----|------|
| URL | `base + apiPath`(默认 `/v1/generations`) |
| 触发时机 | 点击「提交生成任务」主按钮 |
**请求体构造**(与知识库 2.4.2 对齐):
```js
{
model: params.modelName,
modality: 'image',
prompt: params.imagePrompt,
inputs: [],
options: {
size: params.size, // 默认 '1024x1024'
aspect_ratio: params.aspectRatio, // 默认 '1:1',可选
seed: parseInt(params.seed) // 填了才带
}
}
```
**内置默认参数**(`MENTOR_DEPLOY_TASKS['image-gen']`):
`imagePrompt` = `一只戴蓝色围巾的柴犬,半身像,自然光`、`size` = `1024x1024`、`aspectRatio` = `1:1`;可选尺寸 `1024x1024 / 1664x928 / 928x1664`,宽高比 `1:1 / 3:4 / 4:3 / 9:16 / 16:9`。
**通过条件**:`HTTP 2xx`(知识库要求 `202`)且响应解析出任务 ID `data.id`(状态 `queued`)。
**失败场景**:非 2xx → 拼接 `error.message`;2xx 但无任务 ID → `未解析到任务 ID(data.id),请确认返回结构与 API 文档一致。`
**成功后的联动**:拿到任务 ID 后**立即查询一次状态**,若 `pollAuto` 开启则**自动启动轮询**。
#### ③ `GET /v1/generations/{id}`(查询任务状态)
| 项 | 内容 |
|----|------|
| URL | `base + '/v1/generations/' + encodeURIComponent(taskId)` |
| 前置 | 必须先提交生成任务拿到 taskId,否则弹窗「无任务 ID,请先提交生成任务」 |
| 触发时机 | 手动「立即查询」/ 自动轮询 |
**通过条件**:`HTTP 2xx` 且 `status === 'succeeded'` 且 `outputs.length > 0`。
**失败场景**:非 2xx → 拼接 `error.message`;`status === 'failed'` → `生成任务失败,状态:failed。错误:<data.error>`。
#### ④ 自动轮询逻辑(`startMentorDeployGenPolling`)
```
提交成功拿到 taskId
↓
立即查询一次 + 启动 setInterval(每 3000ms 一次,最多 30 次)
↓
每次轮询:GET /v1/generations/{id}
↓
状态流转:
queued(排队中…,无进度条)
→ running(显示进度条 progress%)
→ succeeded(停止轮询:绿色状态 + 图片预览卡片 + 打开原图链接)
→ failed(停止轮询:红色状态 + 错误信息)
↓
三个停止条件:
① 任务状态到达 succeeded / failed
② 轮询超过 30 次(超时保护)
③ 连续网络错误达 3 次(_pollFailCount 计数,避免无限重试)
```
**其他停止时机**:导师切换任务 Tab(`switchMentorDeployTask`)时清除定时器;提交验收结论(`submitMentorDeployReview`)时停止。
**轮询开关**:右下角「自动轮询:开/关」按钮(`pollAuto` 布尔值),关闭时须手动点「立即查询」。
#### ⑤ 结果展示(`buildMentorDeployGenImagePreview` / `buildMentorDeployGenProgressBar`)
- `queued`:任务状态文字 `queued`(无额外图形)
- `running`:进度条(蓝色 `#165DFF` 填充 + 百分比文字,范围钳制 0~100)
- `succeeded`:显示「已生成 N 张图片」+ 每张图片 `<img>` 预览卡片 + 「打开原图 ↗」链接;图片加载失败时显示占位提示(见异常处理)
- `failed`:红色错误块展示 `error` 内容
- 所有测试项下方始终有原始 JSON 展开预览(`<pre>` 深色背景绿色文字)
---
## 二、验收决策联动逻辑
### 2.1 三态结论选择(通过 / 驳回 / 待补充)
**按钮交互**(`setMentorDeployReviewConclusion`):
- 三个选项按钮为「单选 + 可取消」:再次点击已选中项 → 取消选择(`delete conclusion[sid]`)
- 选中态高亮色(结论面板 `buildMentorDeployConclusionPanel`):
| 结论 | 选中态样式(背景/文字/边框) |
|------|---------------------------|
| 通过 | 绿 `emerald-100 / emerald-700 / emerald-200` |
| 驳回 | 红 `rose-100 / rose-700 / rose-200` |
| 待补充 | 紫 `violet-100 / violet-700 / violet-200` |
| 未选中 | 灰底 `#F7F8FA / #86909C`,悬停变蓝边框 |
### 2.2 结论选择对表单的影响(关键结论)
> **原型中切换结论不会隐藏/禁用任何表单**:评分卡 5 项输入、导师评语 textarea 始终显示。约束通过**提交时硬校验**落地,而非动态显隐。
**提交校验矩阵**(`submitMentorDeployReview`):
| 校验 | 通过 | 驳回 | 待补充 |
|------|------|------|--------|
| 已选择结论 | 必填 | 必填 | 必填 |
| 产物已提交 | 必填,否则提示改「驳回/待补充」 | 不要求 | 不要求 |
| 报告已提交 | 必填,同上 | 不要求 | 不要求 |
| 关键 API 测试全通过 | 必填(列出缺失项:模型列表/聊天补全/图像生成项) | 不要求 | 不要求 |
| 评语非空 | 不强制 | **必填**(提示「请填写导师评语」,说明问题与修改建议) | **必填** |
- **通过**:评分写入 `sub.review.score` 与 `studentState.deployReviewScore`,通知文案含「本次评分 X/100 分」
- **驳回/待补充**:评分不写入;提交后**重置学生提交状态**(`deployArtifactSubmitted=false`、`deployReportSubmitted=false`),学生可重新编辑提交;通知文案含结论与评语
**材料不完整预警**(`buildMentorDeployCompletenessNotice`):学生缺产物/报告时,中列顶部出现琥珀色警示条「该学生提交材料不完整:缺少 X,暂不能提交「通过」验收结论」。
### 2.3 草稿与锁定联动
| 动作 | 效果 |
|------|------|
| 保存草稿(`saveMentorDeployReviewDraft`) | 学生状态标记为「验收中」(琥珀→蓝徽章),**不锁定**,可继续编辑 |
| 提交结论(通过/驳回/待补充) | `sub.review.status` = 已通过/已驳回/待补充 → **锁定**:验收参数「提交后只读」、评分输入 disabled、右侧面板替换为「本轮验收记录」只读卡片(含提交时间/通知时间/API测试摘要/5项得分/总分/评语) |
| 通知学生 | `studentState.notifications` 插入 `type:'deploy-review'`、`status`、`targetPage:'student-deploy-result'`;同步 `deployReviewStatus/Comment/Score/Round/UpdatedAt`、`deployPassed`、`deployRejected` |
### 2.4 学生端反馈联动(结果页)
| 状态 | 学生端显示 |
|------|-----------|
| 已通过 | 绿色徽章「通过」+ 主按钮「去撰写实操报告」,产物/报告只读锁定 |
| 已驳回 | 红色徽章「驳回」+ 主按钮「返回提交页修改」 |
| 待补充 | 紫色徽章「待补充」+ 主按钮「返回提交页修改」 |
| 验收中 | 蓝色徽章「验收中」+ 主按钮「等待导师验收」 |
| 待验收 | 琥珀徽章「待验收」 |
---
## 三、异常处理
### 3.1 知识库错误码表(`docs/AutoDL部署实操任务.md` 2.5)
| 错误码 | HTTP 状态 | 说明 | 前端处理建议 |
|--------|----------|------|-------------|
| `invalid_request` | 400 | 请求缺少必填字段或参数越界 | 检查请求体格式 |
| `unauthorized` | 401 | 令牌缺失或无效 | 检查 Authorization 头 |
| `busy` | 429 | 队列已满 | 等待后重试(建议指数退避) |
| `content_policy` | — | 内容触发安全策略 | 修改 prompt |
| `timeout` | — | 生成超过 15 分钟被终止 | 简化任务或降低参数 |
| `internal` | 500 | 端点内部错误 | 联系运维排查 |
### 3.2 原型前端异常处理实现
| 异常场景 | 前端处理 | 界面表现 |
|---------|---------|---------|
| 网络不可达(fetch 抛错) | `httpStatus` 记为 `0`,拼接错误信息 | 状态码显示「网络错误」(红色 `rose-500`) |
| CORS 跨域拦截 | 错误信息追加提示「如果被浏览器 CORS 跨域拦截,请确认服务端已允许跨域(Access-Control-Allow-Origin)后再测试」 | 红色错误块 |
| 接口返回非 2xx | 拼接 `HTTP <status> · <error.message>` | 红色错误块 + 状态码红色 |
| 2xx 但结构不符 | 分别提示:模型列表缺声明的模型 / 无非空 content / 无任务 ID | 红色错误块 |
| 图像任务 `failed` | 展示 `data.error` 原始 JSON | 红色错误块 |
| 生成图片链接加载失败 | `<img onerror>` 替换为占位文案 | 「图片地址无法加载(CORS 或链接已过期),原始响应见下方 JSON。」 |
| 轮询网络错误 | 连续 3 次自动停止轮询 | 状态保持失败,停止刷新 |
| 轮询超时 | 30 次(约 90 秒)强制停止 | 不再自动刷新,可手动查询 |
| 缺少 API 地址/任务 ID | 弹窗引导 | 「缺少 API 地址」「无任务 ID,请先提交生成任务」 |
### 3.3 状态码颜色规则(`buildMentorDeployTestMeta`)
| 条件 | 显示 | 颜色 |
|------|------|------|
| `httpStatus === 0` | 网络错误 | 红 `#F43F5E` |
| 2xx ≤ status < 3xx | 状态码数字 | 绿 `#059669` |
| 其他 | 状态码数字 | 红 `#F43F5E` |
| 未测试 | — | 灰 `#86909C` |
---
## 四、端到端验收时序(导师视角)
```
1. 进入部署验收台 → 左列选择学生 → 中列查看产物/日志/报告
2. 全局配置:填入 API 地址 + API Key → 点「应用」
3. 验收参数:确认模型名称、请求路径(可临时调整/恢复学生提交值)
4. 逐项测试:
任务一:GET /v1/models(通过 ✓)→ POST /v1/chat/completions(通过 ✓)
任务二:GET /v1/models → POST /v1/generations(拿到 taskId,自动轮询启动)
→ GET /v1/generations/{id}(queued → running → succeeded + 图片预览)
5. 评分:5 项维度打分(总分自动计算,≥100 满分显示绿色)
6. 选择结论:
通过 → 校验产物+报告已提交 + API 测试全通过 → 评语可选
驳回/待补充 → 评语必填 → 提交后学生提交状态重置
7. 提交验收结论 → 锁定本轮(参数/评分只读)→ 通知学生 → 学生端结果页展示
```
\ No newline at end of file
# 0823 页面元素与真实状态字段详解
> 生成时间:2026-08-24
> 依据文件:`pages-student.js`、`pages-mentor.js`、`index.html`、`docs/AutoDL部署实操任务.md`
---
## 一、核心页面元素表
### 1.1 学生提交页(`student-deploy-submit`)
入口:`pageRenderers["student-deploy-submit"]`
双列布局:左侧「部署产物」面板 + 右侧「实操报告」面板,独立保存独立提交。
#### ① 部署产物面板(`buildDeployArtifactPanel`)
| 字段名称 | 界面标签 | 变量名(`studentState` 下) | 备注 |
|---------|---------|--------------------------|------|
| 日志包文件名 | 上传部署日志包 | `deployArtifact.fileName` | `.tar.gz/.zip` 原型点击选择演示文件 |
| API 地址 | API 地址 | `deployArtifact.apiUrl` + `deployApiUrl` | 占位符 `https://xxx.autodl.com/v1/chat/completions` |
| API Key | API Key | `deployArtifact.apiKey` | 占位符 `sk-...` |
| 模型名称 | 模型名称(必填) | `deployArtifact.modelName` | 占位符 `qwen3.5-4b` |
| 请求路径 | 请求路径 | `deployArtifact.apiPath` | 占位符 `/v1/chat/completions` |
| 端口 | 端口(必填) | `deployArtifact.port` + `deployApiPort` | 占位符 `8000` |
| 保存状态 | 右上角徽章 | `deployArtifactSaved` / `deployArtifactSubmitted` | 待保存/已保存/已提交 |
| 锁定状态 | — | `isDeployPartLocked('artifact')` | 产物被验收通过后锁定 |
#### ② 实操报告面板(`buildDeployReportPanel`)
| 字段名称 | 界面标签 | 变量名(`studentState.deployReport` 下) | 备注 |
|---------|---------|----------------------------------------|------|
| 任务目标 | 本次任务目标(必填) | `deployReport.taskName` | 占位符见上 |
| 部署过程 | 部署过程(必填) | `deployReport.process` | 描述环境检查、启动过程等 |
| 问题与解决 | 问题与解决 | `deployReport.issues` | 记录报错和修复 |
| 自测结果 | 自测结果 | `deployReport.selfTest` | 接口是否可用 |
| 总结反思 | 总结反思 | `deployReport.summary` | 经验与改进 |
| 保存状态 | 右上角徽章 | `deployReportSaved` / `deployReportSubmitted` | 待保存/已保存/已提交 |
| 锁定状态 | — | `isDeployPartLocked('report')` | 报告被验收通过后锁定 |
#### ③ 提交状态汇总
| 状态变量 | 类型 | 说明 |
|---------|------|------|
| `deployArtifactSubmitted` | boolean | 产物是否已提交 |
| `deployReportSubmitted` | boolean | 报告是否已提交 |
| `deploySubmitted` | boolean | 产物 && 报告都已提交 |
| `deployReviewed` | boolean | 导师是否已验收 |
| `deployPassed` | boolean | 是否已通过 |
| `deployRejected` | boolean | 是否已驳回 |
| `deployReviewStatus` | string | 见第二节状态字段 |
| `deployReviewScore` | object | `{ total, api, deployment, logs, report, reflection }` |
| `deployReviewComment` | string | 导师评语 |
| `deployReviewRound` | number | 当前验收轮次 |
| `deployReviewUpdatedAt` | string | 验收更新时间 |
| `deployArtifactReviewStatus` | string | 产物单独验收状态 |
| `deployReportReviewStatus` | string | 报告单独验收状态 |
---
### 1.2 导师验收页(`mentor-deploy-review`)
入口:`pageRenderers["mentor-deploy-review"]`
三列布局:左列学生列表 + 中列提交内容 + 右列验收台。
#### ① 左列:学生列表(`buildMentorDeployStudentList`)
| 字段 | 说明 |
|------|------|
| 学生姓名 | `mentorState.students[].name` |
| 业务线 | `mentorState.students[].businessLine` |
| 当前任务 | 根据 `getMentorDeployTaskKey` 显示 |
| 状态徽章 | 见第二节状态颜色表 |
| 提交完整性 | 产物/报告是否已提交 |
#### ② 中列:提交内容(`buildMentorDeploySubmissionPanel`)
三个 Tab:`artifact` / `log` / `report`
**「部署产物」Tab:**
| 字段 | 变量来源 | 说明 |
|------|---------|------|
| 日志包 | `sub.artifact.fileName` | 学生提交的日志包文件名 |
| 模型名称 | `sub.artifact.modelName` | 学生声明的模型 |
| API 地址 | `sub.artifact.apiUrl` | 学生提交的 API 地址 |
| 请求路径 | `sub.artifact.apiPath` | 如 `/v1/chat/completions` |
| 端口 | `sub.artifact.port` | 服务端口 |
| API Key | `sub.artifact.apiKey` | 掩码显示(`sk-••••••••`),可复制 |
**「实操日志」Tab:**
| 字段 | 变量来源 | 说明 |
|------|---------|------|
| 日志文件名 | `sub.log.fileName` | 日志包名称 |
| 日志内容 | `sub.log.content` | 弹窗查看 |
**「实操报告」Tab:**
| 字段 | 变量来源 | 说明 |
|------|---------|------|
| 任务目标 | `sub.report.taskName` | 学生填写 |
| 部署过程 | `sub.report.process` | 学生填写 |
| 问题与解决 | `sub.report.issues` | 学生填写 |
| 自测结果 | `sub.report.selfTest` | 学生填写 |
| 总结反思 | `sub.report.summary` | 学生填写 |
#### ③ 右列:验收台
**全局配置(`buildMentorDeployGlobalConfig`):**
| 字段 | 变量 | 说明 |
|------|------|------|
| API 地址 | `__mentorDeployTempApiUrl` | 全局临时变量,应用后写入 `params` |
| API Key | `__mentorDeployTempApiKey` | 同上 |
**验收参数(`buildMentorDeployParamsPanel`):**
| 字段 | 变量 | 说明 |
|------|------|------|
| 模型名称 | `params.modelName` | 带入学生提交值,可临时调整 |
| 请求路径 | `params.apiPath` | 同上 |
**API 测试项(文本模型 `buildMentorDeployTextModelItems`):**
| 测试项 | 方法/路径 | 变量前缀 | 说明 |
|--------|----------|---------|------|
| 模型列表 | `GET /v1/models` | `tests.models` | 验证返回模型列表中包含学生声明的模型 |
| 聊天补全 | `POST /v1/chat/completions` | `tests.chat` | 验证返回 HTTP 200 且 content 非空 |
**API 测试项(图像生成 `buildMentorDeployImageGenItems`):**
| 测试项 | 方法/路径 | 变量前缀 | 说明 |
|--------|----------|---------|------|
| 图像模型列表 | `GET /v1/models` | `tests.models` | 验证返回图像模型 |
| 提交生成任务 | `POST /v1/generations` | `tests.genSubmit` | 返回 HTTP 202 + taskId |
| 查询生成任务 | `GET /v1/generations/{id}` | `tests.genStatus` | 轮询到 `succeeded` |
**验收评分(`MENTOR_DEPLOY_SCORE_ITEMS`):**
| 评分项 | 键名 | 满分 | 存储位置 |
|--------|------|------|---------|
| API 可用性 | `api` | 40 | `scores[taskKey][sid].api` |
| 部署规范性 | `deployment` | 20 | `scores[taskKey][sid].deployment` |
| 实操日志完整度 | `logs` | 15 | `scores[taskKey][sid].logs` |
| 实操报告质量 | `report` | 15 | `scores[taskKey][sid].report` |
| 问题排查与总结 | `reflection` | 10 | `scores[taskKey][sid].reflection` |
| **总分** | `total` | 100 | 自动计算 |
**整体结论(`buildMentorDeployConclusionPanel`):**
| 字段 | 变量 | 说明 |
|------|------|------|
| 整体结论 | `conclusion[sid]` | 三个选项按钮:通过 / 驳回 / 待补充 |
| 导师评语 | `comments[taskKey][sid]` | `<textarea>` 输入 |
| 保存草稿 | — | 调用 `saveMentorDeployReviewDraft()` |
| 提交验收 | — | 调用 `submitMentorDeployReview()` |
---
## 二、真实状态字段详解
### 2.1 学生端部署提交相关状态
#### ① 连通性测试状态(`deployConnectionStatus`)
| 状态值 | 界面标签 | 背景色 | 文字色 | 图标 |
|--------|---------|--------|--------|------|
| `idle` | 待测试 | `#F2F3F5` | `#86909C` | `wifi` |
| `testing` | 测试中 | `#E8F3FF` | `#165DFF` | `loader-circle`(旋转) |
| `success` | 连通成功 | `#D1FAE5` (emerald-100) | `#047857` (emerald-700) | `check-circle` |
| `fail` | 连通失败 | `#FFE4E6` (rose-100) | `#BE123C` (rose-700) | `x-circle` |
#### ② 验收状态(`deployReviewStatus`)
| 状态值 | 界面标签 | 背景色 | 文字色 | 说明 |
|--------|---------|--------|--------|------|
| `待提交` | 待提交 | — | — | 产物/报告都未提交 |
| `待验收` | 待验收 | `#FEF3C7` (amber-100) | `#B45309` (amber-700) | 双方都已提交,等待导师 |
| `验收中` | 验收中 | `#E8F3FF` | `#165DFF` | 导师已保存草稿,正在验收 |
| `已通过` | 通过 | `#D1FAE5` (emerald-100) | `#047857` (emerald-700) | 验收通过,可进入下一阶段 |
| `已驳回` | 驳回 | `#FFE4E6` (rose-100) | `#BE123C` (rose-700) | 验收不通过,需修改重提 |
| `待补充` | 待补充 | `#EDE9FE` (violet-100) | `#6D28D9` (violet-700) | 需要补充材料后重提 |
#### ③ 通知状态(`notifications[].status`)
| 状态值 | 界面标签 | 背景色 | 文字色 |
|--------|---------|--------|--------|
| `已通过` | 已通过 | `#D1FAE5` (emerald-100) | `#047857` (emerald-700) |
| `已驳回` | 已驳回 | `#FFE4E6` (rose-100) | `#BE123C` (rose-700) |
| `待补充` | 待补充 | `#EDE9FE` (violet-100) | `#6D28D9` (violet-700) |
| 其他 | 通知 | `#E8F3FF` | `#165DFF` |
#### ④ 保存/提交状态(产物+报告各自独立)
| 状态 | 条件 | 界面标签 | 背景色 | 文字色 |
|------|------|---------|--------|--------|
| `deployArtifactSubmitted` = true | 已提交 | 已提交 | `#D1FAE5` (emerald-100) | `#047857` (emerald-700) |
| `deployArtifactSaved` = true && `submitted` = false | 已保存未提交 | 已保存 | `#E8F3FF` | `#165DFF` |
| 两者都 false | 未填写 | 待保存 | `#F2F3F5` | `#86909C` |
---
### 2.2 导师端部署验收相关状态
#### ① 学生整体验收状态(`getMentorDeployStudentStatus` 返回值)
| 状态值 | 界面标签 | 背景色 | 文字色 | 生成逻辑 |
|--------|---------|--------|--------|---------|
| `未提交` | 未提交 | `#F2F3F5` | `#86909C` | 无提交记录 |
| `部分提交` | 部分提交 | `#FFEDD5` (orange-100) | `#C2410C` (orange-700) | 产物或报告之一未提交 |
| `待验收` | 待验收 | `#FEF3C7` (amber-100) | `#B45309` (amber-700) | 双方都已提交,未验收 |
| `验收中` | 验收中 | `#E8F3FF` | `#165DFF` | 导师保存草稿后 |
| `已通过` | 已通过 | `#D1FAE5` (emerald-100) | `#047857` (emerald-700) | 导师提交「通过」 |
| `已驳回` | 已驳回 | `#FFE4E6` (rose-100) | `#BE123C` (rose-700) | 导师提交「驳回」 |
| `待补充` | 待补充 | `#EDE9FE` (violet-100) | `#6D28D9` (violet-700) | 导师提交「待补充」 |
#### ② API 测试状态(`tests[taskKey][sid].{models/chat/genSubmit/genStatus}`)
| 状态值 | 界面标签 | 背景色 | 文字色 | 说明 |
|--------|---------|--------|--------|------|
| `undefined` | 未测试 | `#F2F3F5` | `#86909C` | 尚未点击测试按钮 |
| `loading` | 测试中 | `#FEF3C7` (amber-100) | `#B45309` (amber-700) | 正在请求中 |
| `pass` | 已通过 | `#D1FAE5` (emerald-100) | `#047857` (emerald-700) | HTTP 2xx 且内容符合预期 |
| `fail` | 失败 | `#FFE4E6` (rose-100) | `#BE123C` (rose-700) | 网络错误或非 2xx 响应 |
#### ③ HTTP 状态码颜色映射(`buildMentorDeployTestMeta`)
| 条件 | 文字色 | 显示格式 |
|------|--------|---------|
| `httpStatus === 0` | `#F43F5E` (rose-500) | 显示「网络错误」 |
| `200 <= status < 300` | `#059669` (emerald-600) | 显示状态码数字 |
| 其他 `status` | `#F43F5E` (rose-500) | 显示状态码数字 |
| 无结果 | `#86909C` | 显示「—」 |
#### ④ 测试摘要行列状态(`buildMentorDeployTestSummary`)
| 条件 | 显示文本 |
|------|---------|
| 全部未测试 | `未测试` |
| 部分已测试 | `N/M 通过`(如 `2/3 通过`) |
---
### 2.3 AutoDL 部署实操任务 API 状态
源自 `docs/AutoDL部署实操任务.md`,用于学生端部署实操任务信息展示和导师端 API 测试。
#### ① 任务状态(图像生成异步任务)
| 状态值 | 界面显示 | 说明 | 导师端 UI 展示 |
|--------|---------|------|--------------|
| `queued` | 排队中... | 任务已接受但尚未开始 | 文本显示,无进度条 |
| `running` | 正在生成 N% | 正在生成图像 | 显示进度百分比 |
| `succeeded` | 生成完成 | 生成成功,产出 URL | 绿色文字 + 图片预览 + 下载按钮 |
| `failed` | 生成失败 | 生成失败,含错误码 | 红色文字 + 错误信息显示 |
#### ② HTTP 状态码
| 状态码 | 含义 | 使用场景 |
|--------|------|---------|
| `200` | 成功 | `GET /v1/models` 模型列表返回;`POST /v1/chat/completions` 聊天补全返回 |
| `202` | 已接受 | `POST /v1/generations` 提交生成任务成功(异步) |
| `400` | 请求错误 | 参数缺失或越界(`invalid_request`) |
| `401` | 未授权 | API Key 缺失或无效(`unauthorized`) |
| `429` | 请求过多 | 队列已满,需等待重试(`busy`) |
| `500` | 内部错误 | 端点内部异常(`internal`) |
#### ③ 错误码对照表
| 错误码 | HTTP 状态 | 说明 | 前端处理建议 |
|--------|----------|------|-------------|
| `invalid_request` | 400 | 请求缺少必填字段或参数越界 | 检查请求体格式 |
| `unauthorized` | 401 | 令牌缺失或无效 | 检查 Authorization 头 |
| `busy` | 429 | 队列已满 | 等待后重试(指数退避) |
| `content_policy` | — | 内容触发安全策略 | 修改 prompt |
| `timeout` | — | 生成超过 15 分钟被终止 | 简化任务或降低参数 |
| `internal` | 500 | 端点内部错误 | 联系运维排查 |
### 2.4 导师端锁定状态(`isMentorDeployReviewLocked`)
| 状态 | 锁定? | 说明 |
|------|--------|------|
| `已通过` | **是** | 验收锁定,不可再编辑评分/参数/结论 |
| `已驳回` | **是** | 同上 |
| `待补充` | **是** | 同上 |
| `验收中` | 否 | 可继续编辑 |
| `待验收` | 否 | 可继续编辑 |
| 无状态 | 否 | 首次验收 |
---
## 三、状态流转图(学生端提交 → 导师端验收)
```
[学生端] [导师端]
│
deployReviewStatus: 待提交 │
↓ │
产物提交 (deployArtifactSubmitted) │
报告提交 (deployReportSubmitted) │
↓ │
deployReviewStatus: 待验收 ──────────→ 学生列表显示「待验收」
↓ │
deployReviewStatus: 验收中 ←───────── 导师保存草稿
│ │
│ ├─ 全局配置:API 地址 + Key
│ ├─ 验收参数:模型/路径
│ ├─ API 测试:models / chat / gen
│ ├─ 评分:5 维度打分
│ └─ 结论:通过/驳回/待补充
│ │
↓ ↓
deployReviewStatus: 已通过/已驳回/待补充
↓
通知学生 → 查看 deploy-result 页
│
├─ 通过 → 进入下一阶段(实操报告)
├─ 驳回 → 修改后重新提交
└─ 待补充 → 补充材料后重新提交
```
\ No newline at end of file
# 0823 页面清单与基础联动路径
> 生成时间:2026-08-24
> 依据文件:`index.html`、`pages-student.js`、`pages-mentor.js`、`pages-common.js`、`docs/AutoDL部署实操任务.md`
---
## 一、页面清单
### 1.1 学生端(共 21 个页面)
| 页面 ID | 标签 | 一句话功能描述 |
|---------|------|--------------|
| `student-dashboard` | 学习首页 | 展示六阶段进度条、快速入口卡片、待办事项与能力雷达图 |
| `student-resume` | 上传简历 | 上传简历文档,AI 提取技能关键词并推荐匹配项目 |
| `student-bridge-preview` | 衔接预习 | 阶段一知识点预习,阅读衔接材料 |
| `student-bridge-quiz` | 衔接测验 | 阶段一衔接知识点小测,答对 ≥80% 及格 |
| `student-bridge-quiz-result` | 衔接测验结果 | 展示阶段一测验分数、通过/未通过状态及错题回顾 |
| `student-deploy-preview` | 部署知识点 | 阶段二模型部署知识预习,阅读部署文档 |
| `student-deploy-quiz` | 部署小测 | 阶段二部署知识小测,答对 ≥80% 及格 |
| `student-deploy-quiz-result` | 部署小测结果 | 展示阶段二测验分数、通过状态与错题回顾 |
| `student-autodl` | AutoDL | 只读查看导师下发的 AutoDL 实例配置,测试 SSH 连通性,复制 SSH 命令 |
| `student-deploy-submit` | 提交部署产物 | 提交模型部署产物(API 地址/端口/Key)+ 实操报告 |
| `student-deploy-result` | 部署作业详情 | 查看导师部署验收结论、分项评分与评语,驳回时可重新提交 |
| `student-projects` | AI 推荐项目 | 基于简历技能推荐实训项目列表,选择后进入学习 |
| `student-preview` | 知识点预习 | 阶段三~五的项目知识点预习(阅读材料) |
| `student-quiz` | 预习小测 | 阶段三~五的项目预习小测 |
| `student-quiz-result` | 预习小测结果 | 展示预习小测分数与通过状态 |
| `student-practice` | 实操工作台 | 提交代码仓库链接,进行实操实践 |
| `student-report` | 实操报告 | 提交实操报告,申请导师评审 |
| `student-defense` | 答辩申请 | 提交答辩申请,导师评审通过后进入下一阶段 |
| `student-entry` | 入项申请 | 两步流程:提交入项意向(导师审核)→ 填写正式申请(企业主管审核) |
| `student-archive` | 成长档案 | 查看完整个人学习记录、能力雷达图与历史成绩 |
| `student-advance` | 进阶学习 | 阶段晋升提示页面,展示下一阶段学习目标 |
### 1.2 导师端(共 7 个页面)
| 页面 ID | 标签 | 一句话功能描述 |
|---------|------|--------------|
| `mentor-dashboard` | 导师首页 | 工作台概览,展示学员统计、待办任务队列、学员四阶段进度 |
| `mentor-students` | 学员管理 | 查看所有学员列表及四阶段完成进度、入项状态、可筛选搜索 |
| `mentor-practice-review` | 实操评审 | 评审学员提交的实操报告,看板式待评审/评审中/已完成 |
| `mentor-deploy-review` | 部署验收 | 对学员模型部署产物进行 API 真实测试、分项评分并给出整体结论(通过/驳回/待补充) |
| `mentor-autodl` | AutoDL 配置 | 为学员下发 AutoDL 实例配置(主机/端口/用户名/密码),学生端只读 |
| `mentor-defense-review` | 答辩评审 | 评审学员答辩申请,按技术深度/逻辑表达/应变能力评分 |
| `mentor-entry-review` | 入项审核 | 综合评审学员四阶段履历,推荐入项等级并给出综合评价 |
### 1.3 公共页面(3 个)
| 页面 ID | 标签 | 一句话功能描述 |
|---------|------|--------------|
| `login` | 登录 | 角色选择登录页(学生/导师/管理员/企业/院校) |
| `register` | 注册 | 新用户注册页 |
| `profile` | 个人中心 | 查看与编辑个人资料 |
---
## 二、基础联动路径
### 2.1 学生端:从"查看任务"到"提交"的主干路径
```
学习首页 (dashboard)
│
├─→ 上传简历 (resume) ───→ AI推荐项目 (projects) ───→ 选择项目
│
├─→ 阶段一:衔接预习 (bridge-preview) → 衔接测验 (bridge-quiz) → 结果页
│
├─→ 阶段二(模型部署):
│ 部署预习 (deploy-preview) → 部署小测 (deploy-quiz) → 结果页
│ → AutoDL (autodl) → 提交部署产物 (deploy-submit) → 作业详情 (deploy-result)
│
├─→ 阶段三~五(循环,每阶段一次):
│ AI推荐项目 (projects) → 知识点预习 (preview) → 预习小测 (quiz) → 结果页
│ → 实操工作台 (practice) → 实操报告 (report) → 答辩申请 (defense)
│ → 通过后进入下一阶段
│
└─→ 阶段六(入项):
入项申请 (entry) → 导师审核意向 → 填写正式申请 → 企业主管审核
→ 成长档案 (archive)
```
### 2.2 导师端:从"列表"到"验收"的主干路径
```
导师首页 (dashboard)
│
├─→ 学员管理 (students)
│ ├── 查看学员进度 → 跳转对应评审页
│ └── 入项申请列表 → 跳转入项审核
│
├─→ 实操评审 (practice-review)
│ ├── 待评审看板 → 查看详情 → 评分/评语 → 通过/驳回
│ └── 已完成列表 → 查看历史记录
│
├─→ 部署验收 (deploy-review)
│ ├── 选择学生 → 查看提交内容(产物/日志/报告)
│ ├── 切换任务 Tab(任务一 文本模型 / 任务二 图像生成)
│ ├── 全局配置 API 地址/Key → 运行 API 测试(模型列表/聊天补全/图像生成)
│ └── 分项评分 → 选择整体结论(通过/驳回/待补充)→ 填写评语 → 提交验收
│
├─→ AutoDL 配置 (autodl)
│ └── 选择学员 → 填写主机/端口/密码 → 下发配置(学生端只读查看)
│
├─→ 答辩评审 (defense-review)
│ └── 待答辩看板 → 技术深度/逻辑表达评分 → 通过/不通过
│
└─→ 入项审核 (entry-review)
└── 查看学员四阶段履历 → 推荐等级 → 综合评价 → 推荐/不推荐入项
```
### 2.3 学生 → 导师 跨角色联动
```
学生提交部署产物/报告/答辩/入项
↓
通知到达导师待办队列
↓
导师评审并提交结论
↓
结论同步到学生端(通过/驳回/待补充)
↓
学生查看结果,驳回时可重新提交
```
---
## 三、阶段二(模型部署)核心流程详解
```
[学生端] [导师端]
│ │
├─ 部署预习 (deploy-preview) │
├─ 部署小测 (deploy-quiz) │
│ └─ 及格线 80 分 │
├─ AutoDL (autodl) ────────────────→ mentor-autodl(导师下发配置)
│ └─ 查看配置、测连通 │
├─ 提交部署产物 (deploy-submit) │
│ ├─ 部署产物(API 地址/端口/Key/日志) │
│ └─ 实操报告(任务目标/过程/问题/自测/总结)│
│ ├─ 部署验收 (deploy-review)
│ │ ├─ 查看提交内容
│ │ ├─ API 真实测试
│ │ ├─ 分项评分(5项,共100分)
│ │ └─ 整体结论(通过/驳回/待补充)
├─ 部署作业详情 (deploy-result) ←───────────┤
│ └─ 查看验收结论、评分、评语 │
└─ 驳回后重新提交 ───────────────────→ 新一轮验收
```
\ No newline at end of file
# 0824 阶段二模型部署 - 原型交互说明文档
> 版本:V1.0(整合版)
> 生成时间:2026-08-24
> 依据:`index.html`、`pages-student.js`、`pages-mentor.js`、`pages-common.js`、`docs/AutoDL部署实操任务.md`
>
> 本文档整合《0823页面清单与联动路径》《0823页面元素与状态字段详解》《0823核心交互逻辑与验收标准》三份拆分文档,面向开发阶段二(模型部署)功能。
---
## 一、页面清单与联动
### 1.1 页面清单
#### 学生端(阶段二核心流程 7 个页面)
| 页面 ID | 标签 | 一句话功能描述 |
|---------|------|--------------|
| `student-dashboard` | 学习首页 | 展示六阶段进度条、快速入口卡片、待办事项与能力雷达图 |
| `student-deploy-preview` | 部署知识点 | 阶段二模型部署知识预习(阅读部署文档) |
| `student-deploy-quiz` | 部署小测 | 阶段二部署知识小测,答对 ≥80% 及格 |
| `student-deploy-quiz-result` | 部署小测结果 | 展示阶段二测验分数、通过状态与错题回顾 |
| `student-autodl` | AutoDL | 只读查看导师下发的 AutoDL 实例配置、登记自租实例、测试 SSH 连通性、进入 Code Server |
| `student-deploy-submit` | 提交部署产物 | 提交模型部署产物(日志包/API地址/Key/模型/路径/端口)+ 实操报告 |
| `student-deploy-result` | 部署作业详情 | 查看导师部署验收结论、评分与评语,驳回时重新提交 |
#### 导师端(阶段二核心流程 2 个页面)
| 页面 ID | 标签 | 一句话功能描述 |
|---------|------|--------------|
| `mentor-deploy-review` | 部署验收 | 选择学生→查看提交内容→API 真实测试→分项评分→给出整体结论(通过/驳回/待补充) |
| `mentor-autodl` | AutoDL 配置 | 为学员下发 AutoDL 实例配置(主机/端口/用户名/密码/GPU/备注),学生端只读 |
#### 全平台页面总览(学生端 21 / 导师端 7 / 公共 3)
- 学生端其余页面:`student-resume` 上传简历、`student-bridge-preview/quiz/quiz-result` 阶段一衔接学习、`student-projects` AI推荐项目、`student-preview/quiz/quiz-result` 阶段三~五预习、`student-practice` 实操工作台、`student-report` 实操报告、`student-defense` 答辩申请、`student-entry` 入项申请、`student-archive` 成长档案、`student-advance` 进阶学习
- 导师端其余页面:`mentor-dashboard` 导师首页、`mentor-students` 学员管理、`mentor-practice-review` 实操评审、`mentor-defense-review` 答辩评审、`mentor-entry-review` 入项审核
- 公共页面:`login` 登录、`register` 注册、`profile` 个人中心
### 1.2 学生端联动路径(阶段二:查看任务 → 提交)
```
学习首页 (dashboard)
│
└─ 阶段二(模型部署):
部署预习 (deploy-preview) → 部署小测 (deploy-quiz) → 结果页 (deploy-quiz-result)
→ AutoDL (autodl)[查看任务信息与验收要求 → 登记实例 → SSH测试 → Code Server 开发 → 真机部署]
→ 提交部署产物 (deploy-submit)[产物 + 实操报告]
→ 部署作业详情 (deploy-result)
├─ 通过 → 进入阶段三(实操报告)
├─ 驳回 → 返回提交页修改后重新提交
└─ 待补充 → 补充材料后重新提交
```
阶段门槛(代码内置锁定页):
- 衔接测验未通过(≥70 分)→ 不可进入 AutoDL
- 部署小测未通过(≥80 分)→ 不可进入 AutoDL,需返回部署预习
### 1.3 导师端联动路径(列表 → 验收)
```
导师首页 (dashboard)
│
├─ AutoDL 配置 (mentor-autodl)
│ └─ 选择学员 → 填写主机/端口/用户名/密码/GPU → 下发配置(学生端只读)
│
└─ 部署验收 (mentor-deploy-review)
├─ 左列:学生列表(姓名/业务线/状态徽章/提交完整性)
├─ 中列:提交内容(产物 / 日志 / 报告 三个 Tab 只读展示)
└─ 右列:验收台(全局配置 → 验收参数 → API 测试 → 评分 → 结论 → 提交通知学生)
```
### 1.4 跨角色联动
```
学生提交部署产物/报告
↓
导师待办队列出现「待验收」
↓
导师验收(测试/评分/结论)→ 保存草稿(验收中)或 提交结论
↓
结论同步学生端(已通过/已驳回/待补充)+ 站内通知
↓
学生查看结果页,驳回/待补充可重新提交 → 进入下一轮验收(round+1)
```
---
## 二、页面元素与状态字段
### 2.1 学生提交页核心字段(`student-deploy-submit`)
双列布局:左「部署产物」+ 右「实操报告」,独立保存、独立提交。
#### 部署产物面板
| 界面字段 | 变量名(`studentState` 下) | 必填 | 备注 |
|---------|--------------------------|------|------|
| 上传部署日志包 | `deployArtifact.fileName` | 是 | 原型为选择演示文件,真实需上传接口 |
| API 地址 | `deployArtifact.apiUrl` / `deployApiUrl` | 否 | 占位 `https://xxx.autodl.com/v1/chat/completions` |
| API Key | `deployArtifact.apiKey` | 否 | 占位 `sk-...`,提交后掩码 |
| 模型名称 | `deployArtifact.modelName` | 是 | 占位 `qwen3.5-4b` |
| 请求路径 | `deployArtifact.apiPath` | 否 | 占位 `/v1/chat/completions` |
| 端口 | `deployArtifact.port` / `deployApiPort` | 是 | 占位 `8000` |
| 保存/提交徽章 | `deployArtifactSaved` / `deployArtifactSubmitted` | — | 待保存/已保存/已提交 |
#### 实操报告面板
| 界面字段 | 变量名(`deployReport` 下) | 必填 |
|---------|--------------------------|------|
| 任务目标 | `taskName` | 是 |
| 部署过程 | `process` | 是 |
| 问题与解决 | `issues` | 否 |
| 自测结果 | `selfTest` | 否 |
| 总结反思 | `summary` | 否 |
#### 提交状态汇总
| 状态变量 | 类型 | 说明 |
|---------|------|------|
| `deployArtifactSubmitted` / `deployReportSubmitted` | boolean | 产物 / 报告是否已提交 |
| `deploySubmitted` | boolean | 两者都已提交 |
| `deployReviewed` / `deployPassed` / `deployRejected` | boolean | 已验收 / 已通过 / 已驳回 |
| `deployReviewStatus` | string | 验收整体状态(见 2.3) |
| `deployReviewScore` | object | `{ total, api, deployment, logs, report, reflection }` |
| `deployReviewComment` / `deployReviewRound` | string / number | 导师评语 / 验收轮次 |
| `deployArtifactReviewStatus` / `deployReportReviewStatus` | string | 产物 / 报告单独验收状态 |
### 2.2 导师验收页核心字段(`mentor-deploy-review`)
三列布局:学生列表 + 提交内容 + 验收台。
#### 提交内容(中列,三个 Tab 只读)
| Tab | 字段 | 变量来源 |
|-----|------|---------|
| 部署产物 | 日志包 / 模型名 / API 地址 / 请求路径 / 端口 / API Key(掩码+复制) | `sub.artifact.{fileName,modelName,apiUrl,apiPath,port,apiKey}` |
| 实操日志 | 文件名 / 日志内容(弹窗查看) | `sub.log.{fileName,content}` |
| 实操报告 | 任务目标 / 部署过程 / 问题解决 / 自测 / 总结 | `sub.report.{taskName,process,issues,selfTest,summary}` |
#### 验收台(右列)
| 区域 | 核心字段 | 变量/函数 |
|------|---------|----------|
| 全局配置 | API 地址 / API Key(所有测试项共用,可「应用/恢复学生值」) | `window.__mentorDeployTempApiUrl/Key` → `params` |
| 验收参数 | 模型名称 / 请求路径(临时调整,不修改学生提交) | `params.{modelName,apiPath}` |
| 测试项(任务一) | 模型列表 / 聊天补全 | `tests.{models,chat}` |
| 测试项(任务二) | 图像模型列表 / 提交生成 / 查询生成 | `tests.{models,genSubmit,genStatus}` |
| 验收评分 | 5 项维度(API40/部署20/日志15/报告15/总结10),总分 100 自动计算 | `MENTOR_DEPLOY_SCORE_ITEMS` + `scores[taskKey][sid]` |
| 整体结论 | 通过 / 驳回 / 待补充 + 评语 + 保存草稿 + 提交通知 | `conclusion[sid]`、`comments[taskKey][sid]`、`submitMentorDeployReview()` |
### 2.3 真实状态字段详解
#### 学生端验收状态(`deployReviewStatus` / 导师端 `getMentorDeployStudentStatus`)
| 状态值 | 界面标签 | 背景色 | 文字色 | 触发条件 |
|--------|---------|--------|--------|---------|
| `未提交` | 未提交 | 灰 `#F2F3F5` | 灰 `#86909C` | 无提交记录 |
| `部分提交` | 部分提交 | 橙 `#FFEDD5` | 橙 `#C2410C` | 产物/报告仅提交其一 |
| `待提交` | 待提交 | — | — | 学生端:都未提交 |
| `待验收` | 待验收 | 琥珀 `#FEF3C7` | 琥珀 `#B45309` | 产物+报告都已提交,未验收 |
| `验收中` | 验收中 | 蓝 `#E8F3FF` | 蓝 `#165DFF` | 导师保存草稿后 |
| `已通过` | 通过/已通过 | 绿 `#D1FAE5` | 绿 `#047857` | 导师提交「通过」 |
| `已驳回` | 驳回/已驳回 | 红 `#FFE4E6` | 红 `#BE123C` | 导师提交「驳回」 |
| `待补充` | 待补充 | 紫 `#EDE9FE` | 紫 `#6D28D9` | 导师提交「待补充」 |
#### 学生端连通性测试状态(`deployConnectionStatus`)
| 状态值 | 界面标签 | 颜色 | 图标 |
|--------|---------|------|------|
| `idle` | 待测试 | 灰 | `wifi` |
| `testing` | 测试中 | 蓝 | `loader-circle`(旋转) |
| `success` | 连通成功 | 绿 | `check-circle` |
| `fail` | 连通失败 | 红 | `x-circle` |
#### 导师端 API 测试状态(`tests[taskKey][sid].*`)
| 状态值 | 界面标签 | 颜色 |
|--------|---------|------|
| `undefined` | 未测试 | 灰 |
| `loading` | 测试中 | 琥珀 |
| `pass` | 已通过 | 绿 |
| `fail` | 失败 | 红 |
#### 锁定状态(`isMentorDeployReviewLocked`)
| 状态 | 锁定? | 说明 |
|------|--------|------|
| `已通过` / `已驳回` / `待补充` | 是 | 参数只读、评分禁用、结论区变「本轮验收记录」只读卡 |
| `验收中` / `待验收` / 无状态 | 否 | 可继续编辑 |
#### AutoDL API 任务状态(知识库,图像生成)
| 状态值 | 界面显示 | 导师端 UI |
|--------|---------|----------|
| `queued` | 排队中... | 文本显示 |
| `running` | 正在生成 N% | 蓝色进度条 |
| `succeeded` | 生成完成 | 绿色 + 图片预览 + 打开原图链接 |
| `failed` | 生成失败 | 红色 + 错误信息 |
---
## 三、核心交互逻辑
### 3.1 导师端 API 自动化测试
**通用基础**:
- Base URL:`params.apiUrl` 去尾 `/`;未带端口且学生提交过端口时自动拼接 `:端口`
- 请求头:`Content-Type: application/json` + `Authorization: Bearer <apiKey>`
- 结果快照:`{status, httpStatus, latency, raw, error, testedAt, url}`
**任务一(文本模型)**:
| 测试项 | 方法/URL | 请求体要点 | 通过条件 |
|--------|---------|-----------|---------|
| 模型列表 | `GET /v1/models` | 无 body | 2xx 且 `data[].id` 含声明模型名 |
| 聊天补全 | `POST /v1/chat/completions` | `{model, messages:[{role:'user',content}], max_tokens:160, temperature:0.2}` | 2xx 且 `choices[0].message.content` 非空 |
默认参数:prompt=「请用三点解释 vLLM 的连续批处理。」、maxTokens=160、temperature=0.2(与知识库 1.3.3 一致)。
**任务二(图像生成)**:
| 测试项 | 方法/URL | 请求体要点 | 通过条件 |
|--------|---------|-----------|---------|
| 图像模型列表 | `GET /v1/models` | 无 body | 2xx 且含图像模型 |
| 提交生成任务 | `POST /v1/generations` | `{model, modality:'image', prompt, inputs:[], options:{size,aspect_ratio,seed?}}` | 2xx(知识库 202)且解析出 `data.id` |
| 查询生成任务 | `GET /v1/generations/{id}` | 路径参数 taskId | 2xx 且 `status==='succeeded'` 且 `outputs.length>0` |
默认参数:prompt=「一只戴蓝色围巾的柴犬,半身像,自然光」、size=1024x1024、宽高比=1:1。
**图像生成自动轮询**:提交成功后立即查询一次 → `setInterval` 每 3000ms 轮询,最多 30 次 → 状态流转 `queued → running → succeeded/failed` → 结束或连续网络错误 3 次或超时自动停止 → 切换任务 Tab / 提交验收时清除定时器 → 提供「自动轮询:开/关」开关。
### 3.2 验收决策联动逻辑
**三态单选**:通过(绿)/ 驳回(红)/ 待补充(紫),再次点击取消选择。
**关键点:切换结论不隐藏/不禁用任何表单**(评分卡与评语框始终显示),约束通过提交时硬校验落地:
| 校验项 | 通过 | 驳回 / 待补充 |
|--------|------|--------------|
| 已选择结论 | 必填 | 必填 |
| 产物已提交 | 必填(否则提示改驳回/待补充) | 不要求 |
| 报告已提交 | 必填 | 不要求 |
| 关键 API 测试全部通过 | 必填(列出缺失项) | 不要求 |
| 评语非空 | 不强制 | **必填** |
| 评分写入 | 写入 `review.score` 并通知「本次评分 X/100 分」 | 不写入,且重置学生提交状态(可重新提交) |
**辅助联动**:
- 材料不完整预警:中列顶部琥珀警示条「缺少 X,暂不能提交『通过』」
- 保存草稿 → 学生状态「验收中」(不锁定)
- 提交结论 → 锁定本轮 + 快照测试结果/参数 + 写 reviewHistory + 通知学生(`targetPage: 'student-deploy-result'`)+ 同步 `studentState`(含 `deployPassed/deployRejected`)
- 学生端结果页反馈:通过→「去撰写实操报告」;驳回/待补充→「返回提交页修改」;验收中→「等待导师验收」
### 3.3 异常处理
| 错误码 | HTTP | 说明 | 前端处理建议 |
|--------|------|------|-------------|
| `invalid_request` | 400 | 请求缺少必填字段或参数越界 | 检查请求体格式 |
| `unauthorized` | 401 | 令牌缺失或无效 | 检查 Authorization 头 |
| `busy` | 429 | 队列已满 | 等待后重试(建议指数退避) |
| `content_policy` | — | 内容触发安全策略 | 修改 prompt |
| `timeout` | — | 生成超过 15 分钟被终止 | 简化任务或降低参数 |
| `internal` | 500 | 端点内部错误 | 联系运维排查 |
**原型前端异常表现**:
| 异常场景 | 前端处理 |
|---------|---------|
| 网络不可达(fetch 抛错) | `httpStatus=0`,状态码显示「网络错误」(红) |
| CORS 跨域拦截 | 错误信息追加「请确认服务端已允许跨域(Access-Control-Allow-Origin)」 |
| 接口非 2xx | 拼接 `HTTP <status> · <error.message>` |
| 2xx 但结构不符 | 分别提示:模型列表缺声明模型 / 无非空 content / 无任务 ID |
| 图片链接加载失败 | 替换为「图片地址无法加载(CORS 或链接已过期),原始响应见下方 JSON」 |
| 轮询网络错误 / 超时 | 连续 3 次错误停止;30 次(约 90 秒)强制停止 |
---
## 四、API 验收标准
### 4.1 任务一:文本模型(vLLM + Qwen3.5-4B)
**环境要求**:RTX 4090 24GB / CUDA ≤12.8 / vLLM / 公网 HTTPS 映射 / 数据盘 `/root/autodl-tmp`。
| 接口 | 方法 | 通过标准 |
|------|------|---------|
| `/v1/models` | GET | 响应 `data[].id` 必须包含 `qwen3.5-4b` |
| `/v1/chat/completions` | POST | HTTP 200,`choices[0].message.content` 为非空文本 |
**请求示例(POST /v1/chat/completions)**:
```json
{
"model": "qwen3.5-4b",
"messages": [
{ "role": "system", "content": "你是技术助手。回答要准确、简洁,并使用中文。" },
{ "role": "user", "content": "请用三点解释 vLLM 的连续批处理。" }
],
"max_tokens": 160,
"temperature": 0.2,
"stream": false
}
```
**不通过情况**:公网地址不可访问;`/v1/models` 不含 `qwen3.5-4b`;Chat 非 200;content 不存在或为空。
### 4.2 任务二:图像生成(FastAPI + asyncio + Unsloth Qwen-Image)
**环境要求**:RTX 4090 24GB / Qwen-Image 4bit 量化(显存约 8GB)/ 公网 HTTPS 映射。
| 接口 | 方法 | 通过标准 | 前端功能 |
|------|------|---------|---------|
| `/v1/models` | GET | 返回图像模型 ID | 测试连接、获取模型列表 |
| `/v1/generations` | POST | HTTP 202 + 任务 ID(status=queued) | 提交图像生成 |
| `/v1/generations/{id}` | GET | status=succeeded 且含输出 URL | 轮询任务进度 |
| `{output_url}` | GET | 可下载 | 下载生成结果 |
**请求示例(POST /v1/generations)**:
```json
{
"model": "qwen-image-2.0",
"modality": "image",
"prompt": "一只可爱的熊猫在竹林里吃竹子",
"inputs": [],
"options": { "size": "1664x928", "aspect_ratio": "16:9", "seed": 42 }
}
```
**状态字段说明**:
| 状态 | 说明 | 前端行为 |
|------|------|---------|
| `queued` | 任务排队中 | 显示「排队中...」 |
| `running` | 正在生成 | 显示进度百分比 |
| `succeeded` | 生成完成 | 显示结果 + 下载按钮 |
| `failed` | 生成失败 | 显示错误信息 |
**响应结构(成功)**:
```json
{
"id": "gen_9f2c81",
"status": "succeeded",
"progress": 100,
"outputs": [{ "mime_type": "image/webp", "width": 1664, "height": 928, "url": "https://.../gen_9f2c81.webp" }],
"error": null
}
```
### 4.3 端到端验收时序
```
1. 选择学生 → 查看产物/日志/报告
2. 全局配置:API 地址 + Key → 应用
3. 确认验收参数:模型名/请求路径
4. 逐项 API 测试(任务一:models+chat;任务二:models+genSubmit+genStatus 轮询)
5. 五维评分(总分自动计算)
6. 选择结论 → 提交校验(通过需材料完整+测试全过;驳回/待补充需评语)
7. 提交 → 锁定 + 通知学生 → 学生端结果页展示 → 驳回可重提进入下一轮
```
---
## [待产品确认] 清单
> 以下为原型图中未体现或存在不一致,但开发实现前需要产品确认的细节。
| 编号 | 待确认项 | 原型现状 / 差异 | 建议 |
|------|---------|---------------|------|
| 1 | Chat 测试请求体 | 原型只发单条 user 消息、未显式传 `stream:false`;知识库含 system 消息 + stream 字段 | 确认是否按知识库补全 system 消息与 stream 参数 |
| 2 | 测试直连 vs 后端代理 | 原型用浏览器 fetch 直连学生 API 地址,真实环境大概率被 CORS 拦截 | 确认验收请求是否由平台后端代理转发 |
| 3 | 阶段门槛不一致 | 衔接测验页显示及格线 80 分,但 AutoDL 锁定页文案为「衔接测验 ≥70 分」 | 确认衔接测验真实及格线(70 或 80) |
| 4 | 日志包上传 | 原型为选择演示文件,无真实上传 | 确认后端上传接口(multipart)与文件大小限制 |
| 5 | 轮询参数 | 3000ms 间隔 / 最多 30 次 / 连续错误 3 次停止均为原型默认值 | 确认生产轮询间隔、超时上限与重试策略 |
| 6 | 学生端是否真实轮询 | 学生端任务信息仅静态展示知识库接口规范,无真实状态查询 | 确认学生端是否需要实现真实轮询与进度展示 |
| 7 | 通过的最低分 | 总分 100,原型未定义最低通过分数线 | 确认「通过」是否要求总分 ≥60(或其它) |
| 8 | 驳回/待补充重提范围 | 原型重置产物与报告两个提交状态 | 确认重提是「全部重提」还是「按被驳回部分单独重提」 |
| 9 | API Key 掩码规则 | 原型展示前 3 位 + `••••••••` | 确认脱敏规则(保留位数)与存储加密要求 |
| 10 | 通知机制 | 原型为本地 `studentState.notifications` 模拟 | 确认真实环境为站内消息中心还是邮件/短信 |
| 11 | 多轮验收上限 | `reviewHistory` + `round` 已实现,无最大轮次限制 | 确认最大验收轮次(如 3 轮后需管理员介入) |
| 12 | 「待补充」补充范围 | 原型可修改产物+报告全部字段 | 确认待补充是否限定字段范围 |
| 13 | 验收参数持久化 | 「应用」的临时调整仅本次会话有效,未持久化 | 确认临时调整是否需保存为历史记录 |
| 14 | 图片下载/保存 | 原型仅「打开原图 ↗」,无平台内保存机制 | 确认是否需要平台下载/归档 output_url 文件 |
| 15 | 宽高比选项 | 原型提供 5 种(1:1/3:4/4:3/9:16/16:9),知识库仅定义 1:1、16:9 | 确认宽高比支持范围与知识库对齐 |
| 16 | 错误码重试 | 知识库建议 429 指数退避,原型未实现重试逻辑 | 确认前端是否需要实现自动退避重试 |
| 17 | 密码下发方式 | 原型明文存 `autodlState.draft.password`,仅导师可见 | 确认真实环境密码的加密存储与一次性展示规则 |
| 18 | AutoDL 租赁登记 | 学生自填实例(主机/端口/用户名)为演示功能 | 确认真实租赁流程(自租 or 平台代租)与数据来源 |
| 19 | 任务二生成超时 | 知识库 timeout=15 分钟,轮询 30 次约 90 秒即停止 | 确认轮询窗口是否覆盖 15 分钟任务 |
| 20 | 评分项权重 | API40/部署20/日志15/报告15/总结10 为原型设定 | 确认权重是否需调整 |
---
### 附:相关文件索引
| 文件 | 用途 |
|------|------|
| `docs/0823页面清单与联动路径.md` | 页面清单 + 联动路径详版 |
| `docs/0823页面元素与状态字段详解.md` | 元素/变量/状态颜色详版 |
| `docs/0823核心交互逻辑与验收标准.md` | 测试逻辑/决策联动/异常处理详版 |
| `docs/AutoDL部署实操任务.md` | 知识库:部署任务与 API 规范 |
| `index.html` / `pages-student.js` / `pages-mentor.js` | 原型代码实现 |
......@@ -426,7 +426,7 @@ function initRadarChart() {
<script src="pages-enterprise.js"></script>
<script src="pages-school.js"></script>
<script>
const ROLES = {student:{name:'学生端',pages:[{id:'student-dashboard',label:'学习首页'},{id:'student-resume',label:'上传简历'},{id:'student-bridge-preview',label:'衔接预习'},{id:'student-bridge-quiz',label:'衔接测验'},{id:'student-deploy-preview',label:'部署知识点'},{id:'student-deploy-quiz',label:'部署小测'},{id:'student-autodl',label:'AutoDL'},{id:'student-deploy-submit',label:'提交部署产物'},{id:'student-deploy-result',label:'部署作业详情'},{id:'student-projects',label:'AI推荐项目'},{id:'student-preview',label:'知识点预习'},{id:'student-quiz',label:'预习小测'},{id:'student-practice',label:'实操工作台'},{id:'student-report',label:'实操报告'},{id:'student-defense',label:'答辩申请'},{id:'student-entry',label:'入项申请'},{id:'student-archive',label:'成长档案'}]},mentor:{name:'导师端',pages:[{id:'mentor-dashboard',label:'导师首页'},{id:'mentor-students',label:'学员管理'},{id:'mentor-practice-review',label:'实操评审'},{id:'mentor-deploy-review',label:'部署验收'},{id:'mentor-autodl',label:'AutoDL 配置'},{id:'mentor-defense-review',label:'答辩评审'},{id:'mentor-entry-review',label:'入项审核'}]},admin:{name:'管理员端',pages:[{id:'admin-dashboard',label:'管理首页'},{id:'admin-projects',label:'项目库管理'},{id:'admin-difficulty',label:'难度校准'},{id:'admin-system-generator',label:'体系生成器'},{id:'admin-deploy-task',label:'阶段二任务下发'},{id:'admin-users',label:'用户列表'},{id:'admin-roles',label:'角色管理'},{id:'admin-permissions',label:'权限配置'},{id:'admin-departments',label:'部门管理'},{id:'admin-logs',label:'登录日志'},{id:'admin-monitoring',label:'系统监控'}]},enterprise:{name:'企业端',pages:[{id:'enterprise-dashboard',label:'总览首页'},{id:'enterprise-review',label:'学员审核台'},{id:'enterprise-records',label:'入项记录'},{id:'enterprise-stats',label:'统计报表'}]},school:{name:'院校教务端',pages:[{id:'school-dashboard',label:'工作台'},{id:'school-systems',label:'培训体系'},{id:'school-teaching',label:'教学管理'},{id:'school-students',label:'学生档案'},{id:'school-accounts',label:'账号管理'},{id:'school-business',label:'商业服务'}]}};
const ROLES = {student:{name:'学生端',pages:[{id:'student-dashboard',label:'学习首页'},{id:'student-resume',label:'上传简历'},{id:'student-bridge-preview',label:'衔接预习'},{id:'student-bridge-quiz',label:'衔接测验'},{id:'student-deploy-preview',label:'部署知识点'},{id:'student-deploy-quiz',label:'部署小测'},{id:'student-autodl',label:'AutoDL'},{id:'student-deploy-submit',label:'提交部署产物'},{id:'student-deploy-result',label:'部署作业详情'},{id:'student-projects',label:'AI推荐项目'},{id:'student-preview',label:'知识点预习'},{id:'student-quiz',label:'预习小测'},{id:'student-practice',label:'实操工作台'},{id:'student-report',label:'实操报告'},{id:'student-defense',label:'答辩申请'},{id:'student-entry',label:'入项申请'},{id:'student-archive',label:'成长档案'}]},mentor:{name:'导师端',pages:[{id:'mentor-dashboard',label:'导师首页'},{id:'mentor-students',label:'学员管理'},{id:'mentor-practice-review',label:'实操评审'},{id:'mentor-deploy-review',label:'部署验收'},{id:'mentor-defense-review',label:'答辩评审'},{id:'mentor-entry-review',label:'入项审核'}]},admin:{name:'管理员端',pages:[{id:'admin-dashboard',label:'管理首页'},{id:'admin-projects',label:'项目库管理'},{id:'admin-difficulty',label:'难度校准'},{id:'admin-system-generator',label:'体系生成器'},{id:'admin-deploy-task',label:'阶段二任务下发'},{id:'admin-users',label:'用户列表'},{id:'admin-roles',label:'角色管理'},{id:'admin-permissions',label:'权限配置'},{id:'admin-departments',label:'部门管理'},{id:'admin-logs',label:'登录日志'},{id:'admin-monitoring',label:'系统监控'}]},enterprise:{name:'企业端',pages:[{id:'enterprise-dashboard',label:'总览首页'},{id:'enterprise-review',label:'学员审核台'},{id:'enterprise-records',label:'入项记录'},{id:'enterprise-stats',label:'统计报表'}]},school:{name:'院校教务端',pages:[{id:'school-dashboard',label:'工作台'},{id:'school-systems',label:'培训体系'},{id:'school-teaching',label:'教学管理'},{id:'school-students',label:'学生档案'},{id:'school-accounts',label:'账号管理'},{id:'school-business',label:'商业服务'}]}};
// Student state management
var studentState = {
selectedProject: null,
......
......@@ -1393,78 +1393,6 @@ pageRenderers["mentor-entry-review"] = function() {
</div>`;
};
function getAutodlEligibleStudents() {
return (mentorState.students || []).filter(function(s) {
return s.businessLine === '技术部' && Number(s.prdStage) === 2;
});
}
function getMentorAutodlStudent(id) {
return mentorState.students.find(function(s) { return s.id === id; });
}
function loadMentorAutodlDraft(studentId) {
autodlState.selectedMentorStudentId = studentId;
var cfg = (autodlState.configs || {})[studentId];
var preset = (typeof AUTODL_PRESETS !== 'undefined' && AUTODL_PRESETS[studentId]) ? AUTODL_PRESETS[studentId] : {};
if (cfg && cfg.issued) {
autodlState.draft = {
studentId: studentId,
host: cfg.host,
port: cfg.port,
username: cfg.username,
password: cfg.password,
gpu: cfg.gpu || 'RTX 4090 24GB',
remark: cfg.remark || ''
};
} else {
autodlState.draft = {
studentId: studentId,
host: preset.host || '',
port: preset.port || '',
username: preset.username || 'root',
password: preset.password || '',
gpu: preset.gpu || 'RTX 4090 24GB',
remark: preset.remark || ''
};
}
}
function selectMentorAutodlStudent(id) {
loadMentorAutodlDraft(id);
renderContent();
}
function setMentorAutodlDraft(field, value) {
if (!autodlState.draft) loadMentorAutodlDraft(autodlState.selectedMentorStudentId);
autodlState.draft[field] = value;
}
function issueMentorAutodl() {
if (!autodlState.draft) loadMentorAutodlDraft(autodlState.selectedMentorStudentId);
var d = autodlState.draft;
var sid = autodlState.selectedMentorStudentId;
if (!d.host || !d.port || !d.username || !d.password) {
showStudentFlowModal('请填写必填项', '主机、端口、用户名、密码都需要填写后再下发。');
return;
}
var preset = (typeof AUTODL_PRESETS !== 'undefined' && AUTODL_PRESETS[sid]) ? AUTODL_PRESETS[sid] : {};
applyAutodlIssued(sid, {
host: d.host.trim(),
port: String(d.port).trim(),
username: d.username.trim(),
password: d.password,
gpu: d.gpu,
remark: d.remark || '',
region: preset.region || '西北A区',
instanceStatus: 'running'
});
var student = getMentorAutodlStudent(sid);
var name = student ? student.name : '学员';
renderContent();
showStudentFlowModal('已下发 AutoDL', name + ' 可在学生端只读页立即看到这套配置,并测连通、复制 ssh。密码不会展示给学生。');
}
function selectMentorDeployReviewStudent(id) {
mentorState.deployReviewStudentId = Number(id);
// 切换学生时停止图像轮询并重置全局配置临时变量,避免上一学生残留
......@@ -3011,116 +2939,4 @@ pageRenderers["mentor-deploy-review"] = function() {
'</div></div>';
};
pageRenderers["mentor-autodl"] = function() {
var eligible = getAutodlEligibleStudents();
if (!autodlState.selectedMentorStudentId || !eligible.some(function(s) { return s.id === autodlState.selectedMentorStudentId; })) {
autodlState.selectedMentorStudentId = eligible.length ? eligible[0].id : null;
autodlState.draft = null;
}
if (autodlState.selectedMentorStudentId && (!autodlState.draft || autodlState.draft.studentId !== autodlState.selectedMentorStudentId)) {
loadMentorAutodlDraft(autodlState.selectedMentorStudentId);
}
var selectedId = autodlState.selectedMentorStudentId;
var draft = autodlState.draft || { host: '', port: '', username: 'root', password: '', gpu: 'RTX 4090 24GB', remark: '' };
var selected = selectedId ? getMentorAutodlStudent(selectedId) : null;
var issued = selectedId ? isAutodlIssuedForStudent(selectedId) : false;
var gpuOptions = ['RTX 4090 24GB', 'RTX 3090 24GB', 'A100 40GB'];
var listHtml = eligible.map(function(s) {
var hasCfg = isAutodlIssuedForStudent(s.id);
var active = s.id === selectedId;
return '<button type="button" class="w-full text-left p-4 rounded-lg border transition-all mb-2 ' +
(active ? 'border-[#165DFF] bg-[#E8F3FF]' : 'border-[#E5E6EB] bg-white hover:border-[#165DFF]') +
'" onclick="selectMentorAutodlStudent(' + s.id + ')">' +
'<div class="flex items-center justify-between mb-1">' +
'<div class="flex items-center gap-3">' +
'<div class="w-9 h-9 rounded-full bg-gradient-to-br from-[#165DFF] to-[#4080FF] text-white flex items-center justify-center text-xs font-bold">' + s.name.charAt(0) + '</div>' +
'<div>' +
'<div class="text-sm font-medium text-[#1D2129]">' + s.name + '</div>' +
'<div class="text-xs text-[#86909C] mt-0.5">模型部署 · Qwen2.5-7B</div>' +
'</div>' +
'</div>' +
'<span class="text-xs px-2 py-0.5 rounded-lg ' + (hasCfg ? 'bg-emerald-100 text-emerald-700' : 'bg-amber-100 text-amber-700') + '">' + (hasCfg ? '已下发' : '未下发') + '</span>' +
'</div>' +
'</button>';
}).join('');
if (!eligible.length) {
listHtml = '<div class="p-6 text-center text-sm text-[#86909C]">当前没有处于模型部署阶段的技术部学员。</div>';
}
var formHtml = '';
if (!selected) {
formHtml = '<div class="bg-white rounded-lg border border-[#E5E6EB] p-8 text-center text-sm text-[#86909C]">请从左侧选择学员。</div>';
} else {
var gpuSelect = gpuOptions.map(function(g) {
return '<option value="' + g + '"' + (draft.gpu === g ? ' selected' : '') + '>' + g + '</option>';
}).join('');
formHtml = `
<div class="bg-white rounded-lg shadow-sm border border-[#E5E6EB] p-6">
<div class="flex items-center justify-between mb-5">
<div>
<h3 class="font-semibold text-[#1D2129]">下发给 ` + selected.name + `</h3>
<p class="text-xs text-[#86909C] mt-1">学生页只读。密码仅导师可见。</p>
</div>
<span class="text-xs px-2.5 py-1 rounded-lg ` + (issued ? 'bg-emerald-100 text-emerald-700' : 'bg-amber-100 text-amber-700') + `">` + (issued ? '已下发' : '未下发') + `</span>
</div>
<div class="grid grid-cols-2 gap-4 mb-4">
<div>
<label class="text-xs font-medium text-[#4E5969] mb-1.5 block">主机 <span class="text-rose-500">*</span></label>
<input class="input-field font-mono text-sm" placeholder="connect.west-a.autodl.com" value="` + escapeAutodlHtml(draft.host) + `" oninput="setMentorAutodlDraft('host', this.value)">
</div>
<div>
<label class="text-xs font-medium text-[#4E5969] mb-1.5 block">端口 <span class="text-rose-500">*</span></label>
<input class="input-field font-mono text-sm" placeholder="22135" value="` + escapeAutodlHtml(draft.port) + `" oninput="setMentorAutodlDraft('port', this.value)">
</div>
<div>
<label class="text-xs font-medium text-[#4E5969] mb-1.5 block">用户名 <span class="text-rose-500">*</span></label>
<input class="input-field font-mono text-sm" placeholder="root" value="` + escapeAutodlHtml(draft.username) + `" oninput="setMentorAutodlDraft('username', this.value)">
</div>
<div>
<label class="text-xs font-medium text-[#4E5969] mb-1.5 block">密码 <span class="text-rose-500">*</span></label>
<input type="password" class="input-field text-sm" placeholder="不会同步到学生页" value="` + escapeAutodlHtml(draft.password) + `" oninput="setMentorAutodlDraft('password', this.value)">
</div>
<div class="col-span-2">
<label class="text-xs font-medium text-[#4E5969] mb-1.5 block">GPU 型号</label>
<select class="input-field text-sm" onchange="setMentorAutodlDraft('gpu', this.value)">` + gpuSelect + `</select>
</div>
<div class="col-span-2">
<label class="text-xs font-medium text-[#4E5969] mb-1.5 block">备注</label>
<textarea class="input-field text-sm" rows="3" placeholder="给学生的说明,会显示在只读页" oninput="setMentorAutodlDraft('remark', this.value)">` + escapeAutodlHtml(draft.remark) + `</textarea>
</div>
</div>
<button class="btn-primary w-full py-3" onclick="issueMentorAutodl()">` + (issued ? '重新下发' : '下发配置') + `</button>
</div>`;
}
return `
<div class="max-w-7xl mx-auto">
<div class="flex items-center justify-between mb-6">
<div class="flex items-center gap-4">
<button class="btn-ghost p-2 rounded-lg hover:bg-[#F2F3F5]" onclick="switchPage('mentor-dashboard')">
<svg class="w-5 h-5" data-lucide="arrow-left"></svg>
</button>
<div class="w-12 h-12 rounded-xl bg-gradient-to-br from-[#165DFF] to-[#4080FF] flex items-center justify-center shadow-lg shadow-[#165DFF]/20">
<svg class="w-6 h-6 text-white" data-lucide="server"></svg>
</div>
<div>
<h2 class="text-xl font-bold text-[#1D2129]">AutoDL 配置</h2>
<p class="text-sm text-[#86909C]">按学员下发 GPU 实例,学生只读查看</p>
</div>
</div>
</div>
<div class="flex gap-6">
<div class="w-80 flex-shrink-0">
<div class="bg-white rounded-lg shadow-sm border border-[#E5E6EB] p-4">
<div class="text-sm font-semibold text-[#1D2129] mb-1">可配置学员</div>
<p class="text-xs text-[#86909C] mb-3">仅技术部、当前为模型部署阶段</p>
` + listHtml + `
</div>
</div>
<div class="flex-1">` + formHtml + `</div>
</div>
</div>`;
};
Markdown 格式
0% 或
您添加了 0 人 到此讨论。请谨慎行事。
请先完成此评论的编辑!
请 注册 或者 后发表评论