Skip to content
项目
群组
代码片段
帮助
当前项目
正在载入...
登录 / 注册
切换导航面板
S
studyweb_Prototype
项目
项目
详情
活动
周期分析
仓库
仓库
文件
提交
分支
标签
贡献者
图表
比较
统计图
议题
0
议题
0
列表
看板
标记
里程碑
合并请求
0
合并请求
0
CI / CD
CI / CD
流水线
作业
日程
统计图
Wiki
Wiki
代码片段
代码片段
成员
成员
折叠边栏
关闭边栏
活动
图像
聊天
创建新问题
作业
提交
问题看板
Open sidebar
yujiejie
studyweb_Prototype
Commits
e77241fb
提交
e77241fb
authored
8月 23, 2026
作者:
yujiejie
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
0823最终版本
上级
f0b387d6
隐藏空白字符变更
内嵌
并排
正在显示
6 个修改的文件
包含
1151 行增加
和
185 行删除
+1151
-185
0823核心交互逻辑与验收标准.md
docs/0823核心交互逻辑与验收标准.md
+278
-0
0823页面元素与状态字段详解.md
docs/0823页面元素与状态字段详解.md
+321
-0
0823页面清单与联动路径.md
docs/0823页面清单与联动路径.md
+150
-0
0824阶段二模型部署-原型交互说明文档.md
docs/0824阶段二模型部署-原型交互说明文档.md
+401
-0
index.html
index.html
+1
-1
pages-mentor.js
pages-mentor.js
+0
-184
没有找到文件。
docs/0823核心交互逻辑与验收标准.md
0 → 100644
浏览文件 @
e77241fb
# 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
docs/0823页面元素与状态字段详解.md
0 → 100644
浏览文件 @
e77241fb
# 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
docs/0823页面清单与联动路径.md
0 → 100644
浏览文件 @
e77241fb
# 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
docs/0824阶段二模型部署-原型交互说明文档.md
0 → 100644
浏览文件 @
e77241fb
# 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`
| 原型代码实现 |
index.html
浏览文件 @
e77241fb
...
...
@@ -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
,
...
...
pages-mentor.js
浏览文件 @
e77241fb
...
...
@@ -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
人
到此讨论。请谨慎行事。
请先完成此评论的编辑!
取消
请
注册
或者
登录
后发表评论