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

学生部署界面设计梳理完成

上级 80663351
# studyweb_Prototype 阶段一项目理解与流程决策记录
> 记录时间:2026-08-20
> 目的:沉淀当前项目整体理解、阶段一现状梳理,以及已确认的业务决策,作为后续阶段二和导师端改造的复盘依据。
---
## 1. 项目定位
`studyweb_Prototype` 是一个以 HTML + JS 编写的高保真产品原型,覆盖以下角色:
- 学生端
- 导师端
- 管理员端
- 企业端
- 院校教务端
当前原型的核心目标,不是单纯做页面展示,而是按照真实业务流程把学生、导师、企业主管、平台管理员串成一个完整闭环。
本项目采用的视觉基线是 **Arco Design Pro** 风格,强调:
- 科技蓝主色
- 白底卡片
- 浅灰背景
- 严谨的 B 端信息层级
- 学生端沉浸式流程引导
- 导师端工作台式处理效率
---
## 2. 项目整体技术结构
### 2.1 入口与渲染方式
项目只有一个主入口:`index.html`。
页面通过以下方式动态渲染:
1. `index.html` 负责壳结构、角色切换、全局状态和路由控制
2. 各角色页面由 `pageRenderers[currentPage]` 提供模板字符串
3. `switchPage(pageId)` 负责切页
4. `renderContent()` 把对应页面内容写入学生端或其他角色容器
### 2.2 文件职责
| 文件 | 作用 |
|---|---|
| `index.html` | 全局布局、样式、角色切换、学生端状态管理、路由守卫 |
| `pages-common.js` | 登录、注册、个人中心 |
| `pages-student.js` | 学生端全部页面与阶段业务逻辑 |
| `pages-mentor.js` | 导师端工作台、学员管理、评审与配置 |
| `pages-admin.js` | 管理员端系统管理与配置 |
| `pages-enterprise.js` | 企业端审核与统计 |
| `pages-school.js` | 院校教务端培训体系与教学管理 |
| `pages.js.bak` | 旧版页面备份,保留历史流程痕迹 |
| `upgrade-ui.js` | 历史视觉升级脚本 |
| `docs/*.md` | PRD 差异分析、UI 评审、改图清单与交接文档 |
### 2.3 一个需要注意的工程问题
`index.html` 中仍然引用了 `pages.js`,但当前仓库里实际存在的是 `pages.js.bak`,没有 `pages.js` 文件。
这意味着:
- 浏览器加载时可能会请求一个不存在的脚本
- 当前页面能运行,主要依赖后续模块重新定义 `pageRenderers`
- 但这仍然是一个明确的运行时隐患,后续建议单独处理
---
## 3. 当前项目的角色结构
项目目前覆盖五类角色:
1. 学生端
2. 导师端
3. 管理员端
4. 企业端
5. 院校教务端
### 3.1 学生端
学生端的目标是:
- 被引导完成学习流程
- 根据阶段进入不同任务
- 完成预习、测验、部署、提交、报告、答辩、入项等环节
### 3.2 导师端
导师端的目标是:
- 查看学员状态
- 处理待办
- 审核产物
- 配置 AutoDL
- 执行答辩评审
### 3.3 管理员端
管理员端负责:
- 平台级配置
- 项目库维护
- 权限与角色管理
- 系统监控
- 培训体系生成
### 3.4 企业端
企业端负责:
- 学员审核
- 培训 / 入项相关审批
- 入项记录与统计
### 3.5 院校教务端
院校端负责:
- 培训体系
- 教学管理
- 学生档案
- 账号管理
- 商业服务
---
## 4. 学生端页面结构梳理
### 4.1 当前学生端页面列表
| 页面 ID | 页面名称 | 作用 |
|---|---|---|
| `student-dashboard` | 学习首页 | 阶段分流、任务总览、入口中心 |
| `student-resume` | 上传简历 | 阶段一简历解析与能力画像 |
| `student-bridge-preview` | 衔接知识点预习 | 阶段一预习 |
| `student-bridge-quiz` | 衔接测验 | 阶段一测验,及格线 70 分 |
| `student-bridge-quiz-result` | 衔接测验结果 | 通过 / 未通过反馈 |
| `student-deploy-preview` | 部署知识点预习 | 阶段二预习 |
| `student-deploy-quiz` | 部署小测 | 阶段二测验,及格线 80 分 |
| `student-deploy-quiz-result` | 部署小测结果 | 阶段二测验反馈 |
| `student-autodl` | AutoDL 配置 | 学生只读查看与测试连通 |
| `student-deploy-submit` | 提交部署产物 | 阶段二日志包 / API / 报告提交 |
| `student-deploy-result` | 部署作业详情 | 提交后结果查看与状态反馈 |
| `student-projects` | AI 推荐项目 | 阶段三至五的项目制入口 |
| `student-preview` | 知识点预习 | 旧项目预习页 |
| `student-quiz` | 预习小测 | 旧项目小测页 |
| `student-quiz-result` | 预习小测结果 | 旧项目测验结果 |
| `student-practice` | 实操工作台 | 旧项目实操与提交 |
| `student-report` | 实操报告 | 报告提交与评审反馈 |
| `student-defense` | 答辩申请 | 答辩入口 |
| `student-entry` | 入项申请 | 当前仍保留旧导师审核链路 |
| `student-advance` | 进阶学习 | 驳回后的补强路径 |
| `student-archive` | 成长档案 | 能力画像、项目履历、评审记录 |
### 4.2 学生端布局特征
学生端采用沉浸式布局:
- 顶部仅有 Logo 和头像
- 没有侧边栏
- 没有全局菜单
- 所有流程靠首页任务引导、页面内返回和闸门跳转完成
这说明学生端不是“信息后台”,而是“流程引导型产品”。
---
## 5. 学生端现有业务逻辑推断
### 5.1 阶段一:衔接阶段
阶段一的当前逻辑可以概括为:
```text
上传简历
→ AI 分析简历
→ 生成能力画像与阶段建议
→ 阅读衔接知识点
→ 完成衔接测验
→ 70 分及格
→ 进入阶段二
```
阶段一的核心特征是:
- 不推荐项目
- 不做实操
- 不进 AutoDL
- 不答辩
- 不进入旧项目闭环
#### 阶段一简历页的作用
`student-resume` 已经被改造成阶段一专用页,表现为:
- 上传简历后触发模拟分析
- 展示能力标签
- 展示项目经验
- 展示阶段能力建议
- 不再弹出项目推荐卡片
#### 阶段一预习页的作用
当前衔接预习包含 4 个知识点:
1. Linux 基础命令
2. AI 基础概念
3. Python 环境与依赖
4. 模型部署前置
每个知识点都包含:
- 学习目标
- 前置说明
- 分段讲解
- 对照表
- 命令示例
- 预习材料
- 本节要点
#### 阶段一测验页的作用
阶段一测验具有明显门槛性质:
- 10 题
- 一题一页
- 单选 / 判断混合
- 未答题高亮提示
- 提交前必须全部作答
- 70 分及格
通过后会:
- 标记阶段一完成
- 解锁阶段二
- 进入模型部署阶段
---
### 5.2 阶段二:模型部署阶段
当前阶段二的业务逻辑已经独立成线:
```text
阶段一通过
→ 系统下发模型部署任务
→ 学习部署知识点
→ 完成部署小测
→ 80 分及格
→ 查看 AutoDL
→ 完成部署并提交产物
→ 同步提交实操报告
→ 导师验收部署产物与报告
→ 进入后续答辩/阶段流转
```
#### 当前阶段二的关键特征
- 不进入 AI 推荐项目大厅
- 不进行项目选题
- 系统直接下发部署任务
- 任务是 `Qwen2.5-7B` 推理服务部署
- 学生端先完成知识点学习和测验,再进入 AutoDL 和提交页
#### AutoDL 页的业务意义
`student-autodl` 不是普通展示页,而是阶段二的实操入口前置页,主要解决:
- 下发后可见
- 脱敏展示主机、端口、用户名
- 测试连通性
- 复制 SSH 命令
- 只读查看,不允许改配置
#### 阶段二提交页的业务意义
`student-deploy-submit` 当前用于阶段二产物提交,核心内容包括:
- 日志包
- API 地址
- API 路径
- 端口
- 提交后锁定
#### 阶段二结果页的业务意义
`student-deploy-result` 用来承接:
- 提交状态
- 探测状态
- 日志预览
- AI 分析
- 导师评语
- 重新提交入口
---
### 5.3 阶段三至阶段五:保留旧项目闭环
阶段三至阶段五目前仍然沿用旧逻辑,即:
```text
AI 推荐项目
→ 选题
→ 知识点预习
→ 小测
→ 实操工作台
→ 报告
→ 答辩
```
对应阶段:
- 阶段三:RAG
- 阶段四:Agent
- 阶段五:微调
这说明当前原型采用“两条并行学习链”策略:
1. 阶段一 + 阶段二:新增专用流程
2. 阶段三 + 阶段四 + 阶段五:保留原项目制闭环
---
### 5.4 阶段六:入项阶段
当前代码中阶段六仍然残留旧流程痕迹,但业务方向已经明确要移除导师审核入项意向。
也就是说,阶段六未来应只保留:
- 企业主管终审
- 阶段完成后的入项结果
- 不再出现“导师审核入项意向”这一中间闸门
---
## 6. 导师端页面结构梳理
### 6.1 当前导师端页面列表
| 页面 ID | 页面名称 | 作用 |
|---|---|---|
| `mentor-dashboard` | 导师首页 | KPI、待办、学员进度 |
| `mentor-students` | 学员管理 | 学员列表与状态查看 |
| `mentor-practice-review` | 实操评审 | 旧项目评审链路 |
| `mentor-deploy-review` | 部署验收 | 阶段二部署产物验收 |
| `mentor-autodl` | AutoDL 配置 | 为学员下发 AutoDL |
| `mentor-defense-review` | 答辩评审 | 答辩评审入口 |
| `mentor-entry-review` | 入项审核 | 当前仍保留旧导师审核入口 |
### 6.2 导师端布局特征
导师端采用工作台布局:
- 顶部白底 Tab 导航
- 通知铃铛
- 头像菜单
- 页面间快速切换
导师端不是沉浸式流程页,而是“任务处理型后台”。
---
## 7. 导师端现有业务逻辑推断
导师端当前承担的职责包括:
### 7.1 学员管理
- 查看学员列表
- 查看阶段状态
- 查看项目状态
- 查看入项状态
- 查看进度和完成情况
### 7.2 旧实操评审
保留旧项目闭环下的评审逻辑:
- 查看项目提交
- 查看 Git / 实操内容
- 评分
- 填写评语
- 通过或驳回
### 7.3 阶段二部署验收
部署验收将成为阶段二导师侧的重点页面,应该承担:
- 产物检查
- 报告审核
- API 探测
- 日志查看
- AI 分析
- 通过 / 驳回
### 7.4 AutoDL 配置
导师负责配置并下发:
- 主机
- 端口
- 用户名
- 密码
- GPU
- 区域
- 备注
学生只能只读查看并进行测试连接。
### 7.5 入项审核
当前页面仍保留旧的“导师审核入项意向”逻辑,但该逻辑后续将正式移除。
---
## 8. 管理员端、企业端、院校端的整体定位
### 8.1 管理员端
管理员端主要是平台级配置台,内容包括:
- 系统用户
- 项目库管理
- 难度校准
- 体系生成器
- 用户角色和权限
- 部门管理
- 登录日志
- 系统监控
### 8.2 企业端
企业端主要处理:
- 学员审核
- 入项记录
- 统计报表
- 企业侧审批
### 8.3 院校教务端
院校端主要处理:
- 培训体系生成
- 教学管理
- 学生档案
- 账号管理
- 商业服务
---
## 9. 当前项目已经形成的两条业务链
### 9.1 新 PRD 路径
```text
阶段一:简历 → 衔接预习 → 衔接测验(≥70)
阶段二:部署预习 → 部署小测(≥80)→ AutoDL → 提交部署产物 + 实操报告 → 部署验收 → 后续答辩
```
### 9.2 旧项目路径
```text
阶段三至五:AI 推荐项目 → 预习 → 小测 → 实操 → 报告 → 答辩
```
### 9.3 总体设计意图
当前原型不是一条线完全推翻重做,而是:
- 阶段一、阶段二做专用流程
- 阶段三至阶段五保留旧流程
- 两条链路通过首页阶段状态进行分流
---
## 10. 当前已发现的主要问题
### 10.1 阶段六入项逻辑仍与新口径不完全一致
当前原型中仍保留:
- 导师审核入项意向
- 学生提交意向
- 导师审核后再填表
- 再进入企业主管终审
但业务决策已经明确:
> 正式移除“导师审核入项意向”,改为阶段五完成后直接进入企业主管终审。
### 10.2 阶段二提交与报告顺序需要统一
当前阶段二原型里,学生端和导师端对“提交产物、报告、验收”的顺序需要统一。该问题已经由产品确认,后续按统一口径推进。
### 10.3 阶段二导师侧仍未完全联动
当前学生端的阶段二页面较完整,但导师端的部署验收与 AutoDL 配置联动仍需要下一轮完善。
### 10.4 旧页面与新流程并存
这不是错误,而是当前阶段策略导致的并存结果,但后续要避免:
- 新流程误走旧页面
- 旧流程覆盖新阶段
- 两套状态变量互相干扰
---
## 11. 已确认的产品决策
以下内容已经确认,后续改图必须遵循。
### 决策 1:阶段二最终顺序统一为“提交部署产物时同步提交实操报告”
- 阶段二不再把“部署验收”和“实操报告”拆成两个前后独立的串联步骤
- 学生提交部署产物时,应同步提交实操报告
- 导师端在验收部署产物时,也必须同时审核实操报告
### 决策 2:正式移除“导师审核入项意向”
- 阶段六不再保留导师审核入项意向的中间环节
- 改为阶段五完成后,直接进入企业主管终审
- 入项逻辑由企业主管作为最终决策方
### 决策 3:阶段二和导师端的改造顺序
- 先完善学生端阶段二的真实交互闭环
- 再改导师端部署验收与 AutoDL 配置联动
这意味着后续开发顺序应为:
1. 学生端阶段二闭环完善
2. 导师端部署验收改造
3. 导师端 AutoDL 配置联动
4. 入项逻辑调整
---
## 12. 后续改图建议顺序
基于当前理解和已确认决策,建议下一步按以下顺序推进:
1. 先补齐学生端阶段二页面的完整闭环
2. 再统一阶段二“部署产物 + 实操报告”的提交与展示逻辑
3. 再改导师端部署验收页,使其同时审核产物和报告
4. 再移除导师入项意向审核逻辑
5. 最后联动导师端 AutoDL 配置与学生端可见状态
---
## 13. 结论
当前项目已经明确形成了以下产品结构:
- 学生端:阶段一衔接 + 阶段二部署为新增专用链路
- 阶段三至五:保留旧项目制闭环
- 导师端:从传统实操评审逐步扩展到部署验收和 AutoDL 配置
- 阶段六:最终回归企业主管终审
接下来最重要的不是继续抽象业务,而是按照已确认的决策,逐页把学生端阶段二闭环先做完整,再逐步推进导师端联动和入项逻辑移除。
# AutoDL部署实操任务
#
## 目录
- 任务一:文本模型部署验收
- 1\.1 AutoDL 实例配置
- 1\.2 任务目标
- 1\.3 API 验收流程
- 1\.3\.1 环境变量配置
- 1\.3\.2 模型发现验证
- 1\.3\.3 Chat Completions 验证
- 1\.4 通过条件
- 任务二:图像生成 API 验收
- 2\.1 AutoDL 实例配置
- 2\.3 接口总览
- 2\.4 API 详细规范
- 2\.4\.1 测试连接 / 获取模型列表
- 2\.4\.2 提交生成任务
- 2\.4\.3 查询任务状态
- 2\.4\.4 下载结果文件
- 2\.5 错误码对照表
---
# 任务一:文本模型部署验收
## 1\.1 AutoDL 实例配置
本任务使用以下 AutoDL 实例配置:
|配置项|实例配置|
|---|---|
|GPU|1 × NVIDIA RTX 4090,24 GB 显存|
|CPU|20 核 Xeon Platinum 8470Q|
|内存|90 GB|
|系统盘|30 GB|
|数据盘|50 GB,不扩容|
|AutoDL 镜像|选择带 NVIDIA GPU、CUDA 12\.x 的 PyTorch 镜像;优先使用 CUDA 12\.8,Python 3\.10 或 3\.11|
|---|---|
|Python 环境|在该镜像中安装与 CUDA 匹配的 vLLM;不要混用系统 Python 和其他虚拟环境|
|NVIDIA 驱动|570\.124\.04|
|CUDA|≤ 12\.8|
|模型|Qwen/Qwen3\.5\-4B|
|固定 revision|851bf6e806efd8d0a36b00ddf55e13ccb7b8cd0a|
模型是官方 Qwen/Qwen3\.5‑4B,不是量化模型;4B 模型权重和运行缓存可以在 24 GB RTX 4090 上完成本任务。模型和缓存必须放在数据盘。
> AutoDL 服务配置要求:实例启动后,确认 `nvidia‑smi` 能看到 RTX 4090,再在当前镜像中安装 vLLM。模型、Hugging Face 缓存和日志统一写入 `/root/autodl‑tmp` 数据盘;如果实例页面显示的数据盘挂载路径不同,以页面实际路径替换该路径。在 AutoDL 的"自定义服务/端口映射"中暴露为公网 HTTPS 地址。公网域名和外部端口由 AutoDL 页面动态分配,不能写死为 `localhost`、实例内网 IP 或某个固定公网端口。
>
>
## 1\.2 任务目标
在上述 AutoDL 实例中使用 vLLM 启动 Qwen3\.5‑4B,并通过 AutoDL 实例页面实际提供的公网地址提供 OpenAI 兼容 API。
任务完成时必须满足:
1. vLLM 服务监听 `0.0.0.0:xxxx`,并由 AutoDL 将实例内端口映射为公网 HTTPS 地址。
2. 公网 `GET /v1/models` 返回 `qwen3.5‑4b`。
3. 公网 `POST /v1/chat/completions` 返回 HTTP 200。
4. Chat 响应中的 `choices[0].message.content` 为非空文本。
> 在 AutoDL 实例页面创建"自定义服务/端口映射",把实例内端口映射为页面实际显示的公网 HTTPS 地址。外部端口和域名以页面显示值为准,不要自行填写固定值。
>
>
## 1\.3 API 验收流程
### 1\.3\.1 环境变量配置
将 AutoDL 页面显示的公网地址填入 `AUTODL_PUBLIC_BASE_URL`,地址末尾不要加 `/v1`:
```Bash
export AUTODL_PUBLIC_BASE_URL='https://<AutoDL页面显示的公网地址>'
export VLLM_API_KEY='<部署时设置的API Token>'
```
### 1\.3\.2 模型发现验证
接口:`GET /v1/models`
请求头:
```Plain Text
Authorization: Bearer <VLLM_API_KEY>
```
调用命令:
```Bash
curl -sS "$AUTODL_PUBLIC_BASE_URL/v1/models" \
-H "Authorization: Bearer $VLLM_API_KEY"
```
**验收标准**:响应中的 `data[].id` 必须包含 `qwen3.5‑4b`。
### 1\.3\.3 Chat Completions 验证
接口:`POST /v1/chat/completions`
请求头:
```Plain Text
Authorization: Bearer <VLLM_API_KEY>
Content-Type: application/json
```
请求体:
```JSON
{
"model": "qwen3.5-4b",
"messages": [
{
"role": "system",
"content": "你是技术助手。回答要准确、简洁,并使用中文。"
},
{
"role": "user",
"content": "请用三点解释 vLLM 的连续批处理。"
}
],
"max_tokens": 160,
"temperature": 0.2,
"stream": false
}
```
调用命令:
```Bash
curl -sS -i "$AUTODL_PUBLIC_BASE_URL/v1/chat/completions" \
-H "Authorization: Bearer $VLLM_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "qwen3.5-4b",
"messages": [
{"role": "system", "content": "你是技术助手。回答要准确、简洁,并使用中文。"},
{"role": "user", "content": "请用三点解释 vLLM 的连续批处理。"}
],
"max_tokens": 160,
"temperature": 0.2,
"stream": false
}'
```
## 1\.4 通过条件
Chat 接口必须返回:`HTTP/1.1 200 OK`
响应中的 ID、时间戳、token 数和具体回答文字可以变化,但必须包含以下结构:
```JSON
{
"object": "chat.completion",
"model": "qwen3.5-4b",
"choices": [
{
"message": {
"role": "assistant",
"content": "非空回答"
}
}
]
}
```
以下任一情况都**不通过**:
- AutoDL 公网地址无法访问。
- `/v1/models` 不包含 `qwen3.5‑4b`。
- Chat 请求返回非 200 状态码。
- `choices[0].message.content` 不存在或为空。
---
# 任务二:图像生成 API 验收
## 2\.1 AutoDL 实例配置
本任务使用以下 AutoDL 实例配置:
|配置项|实例配置|
|---|---|
|GPU|1 × NVIDIA RTX 4090,24 GB 显存|
|CPU|20 核 Xeon Platinum 8470Q|
|内存|90 GB|
|系统盘|30 GB|
|数据盘|50 GB,不扩容|
|AutoDL 镜像|选择带 NVIDIA GPU、CUDA 12\.x 的 PyTorch 镜像;优先使用 CUDA 12\.8,Python 3\.10 或 3\.11|
|---|---|
|Python 环境|在该镜像中安装与 CUDA 匹配的相关依赖;不要混用系统 Python 和其他虚拟环境|
|NVIDIA 驱动|570\.124\.04|
|CUDA|≤ 12\.8|
|模型|unsloth/Qwen‑Image‑2512‑unsloth‑bnb‑4bit(Qwen‑Image 2\.0 4bit 量化版)|
|部署框架|FastAPI \+ asyncio\(图像生成服务,使用 Unsloth 原生推理\)|
> 图像生成任务使用 FastAPI \+ asyncio 框架,配合 Unsloth 原生推理。unsloth/Qwen‑Image‑2512‑unsloth‑bnb‑4bit 是 4bit 量化版,显存需求更低,约 8 GB,可在 24 GB RTX 4090 上运行。
>
>
在上述 AutoDL 实例中部署图像生成服务,并通过 AutoDL 实例页面实际提供的公网地址提供异步图像生成 API。
任务完成时必须满足:
1. 图像生成服务监听 `0.0.0.0:xxxx`,并由 AutoDL 将实例内端口映射为公网 HTTPS 地址。
2. 公网 `GET /v1/models` 返回图像生成模型 ID(如 `qwen‑image‑2.0`)。
3. 公网 `POST /v1/generations` 返回 HTTP 202 和任务 ID。
4. 公网 `GET /v1/generations/{id}` 返回状态 `succeeded` 并包含图像下载 URL。
> 在 AutoDL 实例页面创建"自定义服务/端口映射",把实例内端口映射为页面实际显示的公网 HTTPS 地址。
>
>
## 2\.3 接口总览
|接口|方法|说明|前端功能|
|---|---|---|---|
|`/v1/models`|GET|获取可用模型列表|测试连接、获取模型列表|
|`/v1/generations`|POST|提交生成任务|提交图像生成|
|`/v1/generations/{id}`|GET|查询任务状态|轮询任务进度|
|`{output_url}`|GET|下载结果文件|下载生成结果|
## 2\.4 API 详细规范
### 2\.4\.1 测试连接 / 获取模型列表
接口:`GET /v1/models`
描述:获取端点支持的所有模型及其参数配置
请求头:
```Plain Text
Authorization: Bearer <token>
Content-Type: application/json
```
响应:HTTP 200
```JSON
{
"models": [
{
"id": "",
"modality": "image",
"input_roles": [],
"options": {
"sizes": ["1024x1024", "1664x928", "928x1664"],
"aspect_ratios": ["1:1", "16:9", "16:16"]
}
}
]
}
```
### 2\.4\.2 提交生成任务
接口:`POST /v1/generations`
描述:提交一个新的图像生成任务
请求头:
```Plain Text
Authorization: Bearer <token>
Content-Type: application/json
```
请求体字段:
|字段|类型|必填|说明|
|---|---|---|---|
|`model`|string|是|模型 ID|
|`modality`|string|是|模态类型:`image`|
|`prompt`|string|是|生成提示词|
|`inputs`|array|否|输入媒体数组\(图像生成通常为空\)|
|`options`|object|否|模型特定参数|
**options 参数说明**
|参数|说明|
|---|---|
|`size`|输出尺寸:`1024x1024`、`1664x928`|
|`aspect_ratio`|宽高比:`1:1`、`16:9`|
|`seed`|随机种子\(可选\)|
图像生成请求示例:
```JSON
{
"model": "",
"modality": "image",
"prompt": "一只可爱的熊猫在竹林里吃竹子",
"inputs": [],
"options": {
"size": "1664x928",
"aspect_ratio": "16:9",
"seed": 42
}
}
```
成功响应(HTTP 202):
```JSON
{
"id": "gen_9f2c81",
"status": "queued",
"created_at": "2026-08-17T14:00:00Z"
}
```
### 2\.4\.3 查询任务状态
接口:`GET /v1/generations/{id}`
描述:轮询查询任务当前状态
路径参数:
|参数|类型|说明|
|---|---|---|
|`id`|string|任务 ID|
响应 \- 运行中:
```JSON
{
"id": "gen_9f2c81",
"status": "running",
"progress": 45,
"outputs": [],
"error": null
}
```
响应 \- 排队中:
```JSON
{
"id": "gen_9f2c81",
"status": "queued",
"progress": 0,
"outputs": [],
"error": null
}
```
响应 \- 成功:
```JSON
{
"id": "gen_9f2c81",
"status": "succeeded",
"progress": 100,
"outputs": [
{
"mime_type": "image/webp",
"width": 1664,
"height": 928,
"url": "https://gpu.example.edu.cn/files/gen_9f2c81.webp"
}
],
"error": null
}
```
响应 \- 失败:
```JSON
{
"id": "gen_9f2c81",
"status": "failed",
"progress": 0,
"outputs": [],
"error": {
"code": "content_policy",
"message": "prompt rejected by safety filter"
}
}
```
状态字段说明:
|状态|说明|前端行为|
|---|---|---|
|`queued`|任务排队中|显示"排队中\.\.\."|
|`running`|正在生成|显示进度百分比|
|`succeeded`|生成完成|显示结果 \+ 下载按钮|
|`failed`|生成失败|显示错误信息|
### 2\.4\.4 下载结果文件
方式:直接访问输出 URL
成功响应中的 `outputs[].url` 即为可下载的文件地址,前端通过 `<a download>` 或 `fetch + blob` 方式触发下载。
## 2\.5 错误码对照表
|错误码|HTTP 状态|说明|处理建议|
|---|---|---|---|
|`invalid_request`|400|请求缺少必填字段或参数越界|检查请求体格式|
|`unauthorized`|401|令牌缺失或无效|检查 Authorization 头|
|`busy`|429|队列已满|等待后重试\(建议指数退避\)|
|`content_policy`|\-|内容触发安全策略|修改 prompt|
|`timeout`|\-|生成超过15分钟被终止|简化任务或降低参数|
|`internal`|500|端点内部错误|联系运维排查|
# 原型改图交接文档
> 更新时间:2026-08-18
> 工作区:`e:\studyweb_Prototype`
> 本轮范围:实习生培训平台高保真原型 · 模块一(技术部)学生端阶段一 + 阶段二学习路径
> 对照文档:
> - `docs/0817实习生培训平台PRD文档.docx`(V5.0)
> - `docs/8月25日前做完的实习生培训平台功能需求.xlsx`(P0)
> - `docs/模块一-PRD与原型业务流程差异.md`
> - `docs/学生端-阶段一与阶段二流程改造.md`
> - `docs/P0原型改图确认清单-学生端与导师端.md`
> - `docs/学生端与导师端-UIUX评审.md`
工作方式:**分步改图,每完成一块停下让产品检查**;确认后再做下一块。语言:简体中文。
> 更新时间:2026-08-20
> 工作区:`d:\0820studyweb_Prototype`
> 本轮范围:实习生培训平台高保真原型 · 学生端阶段二(模型部署)方案确认与前置梳理
> 当前状态:**仍在方案确认阶段,尚未开始代码修改**
---
......@@ -19,174 +11,334 @@
### 背景
旧原型按「通用 Web 实训 × L1–L4 四阶段循环」画:
`studyweb_Prototype` 是一个由 HTML + JS 实现的高保真产品原型,覆盖学生端、导师端、管理员端、企业端和院校教务端。
```
上传简历 → AI 推荐选题 → 知识点预习(Tailwind)→ 小测 → 沙箱交 Git 仓库 → 报告 → 答辩
```
当前项目重点正在从旧的“通用实训 / 选题 / 旧项目闭环”转向模块一(技术部)的新阶段流程:
PRD 模块一已改为 AI 工程定向路径:
- 阶段一:衔接
- 阶段二:模型部署
- 阶段三:RAG
- 阶段四:Agent
- 阶段五:微调
- 阶段六:入项
```
阶段一衔接 → 阶段二模型部署 → 阶段三 RAG → 阶段四 Agent → 阶段五微调 → 阶段六主管入项
```
本轮协作的核心目标,是先把**学生端阶段二(模型部署)**的真实业务方案确认清楚,再进入页面改造。
阶段一在旧原型里**不存在**;阶段二被当成「选题后的普通项目」。若直接改旧预习 / 旧提交 / 旧验收,RAG/Agent/微调以后还要用的页就会被覆盖。
### 当前已确认的产品方向
学生端阶段二不再是“普通项目实操”,而是一个完整的**模型部署实操闭环**,包含:
- 学生自主租赁 AutoDL
- 回到平台回填租赁信息和 SSH
- 测试连通性
- 进入 Code Server / Web IDE 编写、修改、自测脚本
- 通过 SSH 登录 AutoDL 真机完成部署
- 提交部署产物 + 实操报告
- 导师验收
### 本轮目标
1. 学生端先把 **阶段一衔接 + 阶段二模型部署** 画对。
2. 阶段三~六只在首页进度条占位锁定,不画新闭环。
3. **只新增或小改清单项**;旧选题 / 旧预习 / 旧仓库提交 / 旧实操评审整页保留给其他阶段。
4. 学生端继续沉浸式(无侧栏、无顶栏菜单)。导师端本轮尚未动手。
1. 先理解并固化阶段二的最终设计方案
2. 形成可执行的页面级改造方案
3. 后续再进入代码修改
4. 阶段二完成后,再推进导师端部署验收和 AutoDL 配置联动
5. 最后再调整阶段六入项逻辑
阶段一路径:上传简历(AI 解析,不出项目卡片)→ 衔接预习 → 测验 ≥70 → 解锁阶段二。无选题、无实操、无 AutoDL、无答辩。
### 本轮使用的对照文档
阶段二路径(本轮只完成到小测):系统直接下发部署任务(Qwen2.5-7B 推理服务)→ 部署预习 → 小测 ≥80 →(未做)AutoDL / 提交产物 / 写报告 / 部署验收 / 答辩。
本轮实际对照、并用于阶段二方案确认的文档如下:
---
- `docs/0819模型部署阶段设计方案.docx`
- `docs/AutoDL部署实操任务.md`
- `docs/模块一-PRD与原型业务流程差异.md`
- `docs/学生端与导师端-UIUX评审.md`
- `docs/学生端-阶段一与阶段二流程改造.md`
- `docs/P0原型改图确认清单-学生端与导师端.md`
- `docs/HANDOFF.md`(旧版)
## 2. 已完成的修改
其中:
### 2.1 `index.html`
- `docs/0819模型部署阶段设计方案.docx` 是阶段二最终设计方案的关键来源,包含多人对话决策记录
- `docs/AutoDL部署实操任务.md` 是 `student-autodl` 页面任务信息区的重要对照来源
---
- `studentState` 增加阶段一 / 阶段二字段(见 §3.4)。
- `switchPage` 增加闸门,避免阶段一误入旧页、未过部署小测误入 AutoDL / 提交:
- 未过衔接测验:拦截 `student-projects`、`student-preview`、`student-quiz`、`student-quiz-result`、`student-practice`、`student-report`、`student-defense`,弹「阶段一不可进入实操」。
- 已过衔接、未过部署小测:拦截 `student-autodl`、`student-deploy-submit`。
- 学生端 `ROLES.student.pages` **未改**(沉浸式无顶栏菜单;新页靠 `switchPage` / `goStudentPrdPage` 进入)。
## 2. 已完成的修改(列出文件及改了什么)
### 2.2 `pages-student.js`(主改动)
> 说明:本轮尚未进行 HTML/JS 代码改造,**没有修改业务代码文件**。当前完成的主要是文档梳理与方案沉淀。
| 页面 / 函数 | 动作 | 说明 |
### 2.1 新增 / 更新的文档
| 文件 | 状态 | 改了什么 |
|---|---|---|
| `student-dashboard` | 重写 | 培养路径改为六段:衔接 → 模型部署 → RAG → Agent → 微调 → 入项。按 `bridgeQuizPassed` 分流阶段一 / 二首页。阶段一时锁定实操 / 答辩。右侧「阶段一首页 / 阶段二首页」演示按钮。**已删系统公告卡片。** |
| `student-resume` | 新增 | 阶段一专用简历页,不进项目大厅。解析后展示能力标签(熟练绿 / 熟悉蓝 / 入门琥珀)、项目经验、分阶段能力提升建议。 |
| `student-bridge-preview` | 新增 | 衔接预习:目录 + 学习顺序 + 完整材料(目标、表格、命令示例、要点)。4 章全标已读才能测验。 |
| `student-bridge-quiz` | 新增 | 10 题一题一页,单选/判断,未答红点,未答完禁止提交。及格线 **70**。 |
| `student-bridge-quiz-result` | 新增 | 错题回知识点;通过主按钮「进入模型部署阶段」;未过可重考 / 回预习。 |
| `student-deploy-preview` | 新增 | 部署预习,顶部写明已下发任务 **Qwen2.5-7B 推理服务部署**。版面与衔接预习共用 `renderPrdKnowledgePreview`。 |
| `student-deploy-quiz` | 新增 | 同交互,及格线 **80**。 |
| `student-deploy-quiz-result` | 新增 | 通过主按钮「进入 AutoDL 实操」(AutoDL 页尚未接入,会提示尚未接入)。 |
| `previewStudentHome` | 新增 | 演示切换:`bridge` 重置为未传简历的阶段一;`deploy` 填好简历 + 衔接已过、部署小测未过。 |
| `goStudentPrdPage` | 新增 | 有 renderer 则跳转;`student-bridge-quiz` / `student-deploy-quiz` 走 `startXxxQuiz`(先检查已读);未实现页弹「尚未接入」。 |
| `docs/0820studyweb_Prototype项目理解与流程决策记录.md` | 已新增 | 沉淀项目整体理解、阶段一现状、阶段二方向、已确认决策和后续建议 |
| `docs/学生端阶段二详细改造方案_v3.md` | 已新增 | 基于最新口径输出学生端阶段二的详细改造方案,包含 `student-autodl`、提交页、结果页的结构建议 |
| `docs/HANDOFF.md` | 已覆盖更新 | 重新整理为当前交接文档,补充了本轮使用的对照文档 |
### 2.2 已完成的阅读与分析
已通读并提炼以下内容:
- `index.html`
- `pages-common.js`
- `pages-student.js`
- `pages-mentor.js`
- `pages-admin.js`
- `pages-enterprise.js`
- `pages-school.js`
- `docs/HANDOFF.md`(旧版)
- `docs/模块一-PRD与原型业务流程差异.md`
- `docs/学生端与导师端-UIUX评审.md`
- `docs/学生端-阶段一与阶段二流程改造.md`
- `docs/AutoDL部署实操任务.md`
- `docs/0819模型部署阶段设计方案.docx`
**明确未改(冻结):** `student-projects`、`student-preview`、`student-quiz`、`student-quiz-result`、`student-practice` 仓库提交区、`student-report`、`student-defense` 原逻辑、入项 / 进阶 / 成长档案。
### 2.3 已确认的页面 / 业务方向梳理结论
### 2.3 导师端
#### 学生端阶段一
`pages-mentor.js` **尚未改**。顶栏仍是:导师首页 · 学员管理 · 实操评审 · 答辩评审 · 入项审核。没有「部署验收」「AutoDL 配置」。
- 简历页已从旧“AI 推荐项目”逻辑中拆出
- 阶段一流程为:简历 → 预习 → 测验(70 分)
- 阶段一不进入实操、AutoDL、答辩、旧项目大厅
### 2.4 文档(本轮已有、非本次新建)
#### 学生端阶段二
改图口径已写在 `docs/学生端-阶段一与阶段二流程改造.md` 与 `docs/P0原型改图确认清单-学生端与导师端.md`。本次新建的是本交接文件。
当前确认的阶段二主线为:
### 2.5 用户已检查过的块
- 学生自主租赁 AutoDL
- 平台展示管理员下发的任务名称和任务要求
- 学生回填 AutoDL 配置信息
- 学生回填自己生成的 SSH
- 测试连通性
- 进入 Code Server / Web IDE 实操
- SSH 登录 AutoDL 真机部署
- 提交部署产物 + 实操报告
- 导师验收
1. 学习首页分流(含删系统公告)— 已确认可继续。
2. 阶段一全流程(简历 → 预习 → 70 分测验 → 回首页变阶段二)— 已确认可继续。
3. 阶段二学习三页(部署预习 / 小测 / 成绩)— 用户看过后指出预习太简约,已加厚正文。
4. 预习版面加厚 — 已改,用户未再反对。
5. 简历 AI 解析结果(标签分级、项目经验、分阶段建议)— **刚做完,待用户再验**。
#### `student-autodl` 页面定位
已经确认 `student-autodl` 不应再是“导师下发配置页”,而应升级为:
- 任务信息承接页
- 学生租赁信息管理页
- SSH 配置页
- 连通性测试页
- Code Server / Web IDE 入口页
#### 阶段二提交口径
已确认阶段二最终改为:
- **提交部署产物时同步提交实操报告**
- 导师验收部署产物时,也必须同时审核报告
#### 阶段六入项口径
已确认:
- 正式移除“导师审核入项意向”
- 阶段五完成后直接进入企业主管终审
---
## 3. 已确定的决策和约束
## 3. 已确定的决策和约束(风格、命名、方案取舍)
### 3.1 业务口径(最重要)
### 3.1 产品和业务决策
- **模型部署是并行路径,不是替换整条实训。** 旧页留给 RAG / Agent / 微调。
- 阶段一、阶段二都 **没有选题**。阶段二由系统直接下发部署任务。
- 阶段一:只有预习 + 测验,**禁止** 实操 / AutoDL / 答辩 / 进项目大厅。
- 阶段二及格线 **80**;阶段一及格线 **70**。
- 阶段二产物是 **日志包 + API**,不是 Git 仓库。验收走 **新页「部署验收」**,不用旧「实操评审」。
- 部署产物提交成功后仍去写报告(共用 `student-report`)。
- 答辩:仅当当前=阶段二时,改为等部署验收通过;其他阶段仍等原报告/实操评审(尚未改答辩页)。
- 入项本轮不动。阶段三~六本轮只占位。
#### 决策 1:阶段二最终顺序统一
### 3.2 交互与布局
阶段二不再拆成“先提交产物、后单独交报告”的串联步骤,而是:
- 学生端 **不加侧栏、不加顶栏菜单**;靠首页入口、返回键、流程跳转。
- 新页未接入时弹「该步骤页面尚未接入」,不要静默跳到旧页。
- 视觉规范:Arco Design Pro,主色 `#165DFF`,卡片白底 + `#E5E6EB` 描边。详见 UI 评审文档。
- 主操作永远只有一个。锁定态用琥珀图标 + 说明 + 主按钮。
- 学生提交部署产物时同步提交实操报告
- 导师端验收时也同时审核报告
### 3.3 页面命名(已占用,后续按此新增)
#### 决策 2:阶段六正式移除导师审核入项意向
| ID | 用途 | 状态 |
|---|---|---|
| `student-resume` | 阶段一简历 + AI 解析 | 已做 |
| `student-bridge-preview` / `quiz` / `quiz-result` | 阶段一衔接学习 | 已做 |
| `student-deploy-preview` / `quiz` / `quiz-result` | 阶段二部署学习 | 已做 |
| `student-autodl` | 学生 AutoDL 只读 | **未做** |
| `student-deploy-submit` | 部署产物提交(日志+API) | **未做** |
| `student-deploy-result` | 部署作业详情(探测/AI/验收) | **未做** |
| `mentor-autodl` | 导师下发 AutoDL | **未做** |
| `mentor-deploy-review` | 导师部署验收 | **未做** |
- 不再保留“导师审核入项意向”这一步
- 阶段五完成后直接进入企业主管终审
#### 决策 3:改造顺序
后续开发顺序必须是:
1. 先完善学生端阶段二真实交互闭环
2. 再改导师端部署验收和 AutoDL 配置联动
3. 最后再动入项逻辑
### 3.2 学生端阶段二的具体口径
#### AutoDL 口径
已纠正为:
- AutoDL 是**学生自主租赁**
- 学生不是等待导师下发实例
- 配置会变化,因此 `student-autodl` 中的 AutoDL 信息区必须是**动态表单**,不是只读静态信息
- 学生可以随时新增租赁记录
- 学生需要填写换租原因
#### Code Server 口径
已经明确 Code Server / Web IDE 的入口为:
`http://183.230.227.10:30002/?folder=/home`
页面上应设计按钮直接跳转到这个链接。
#### 任务信息区口径
`student-autodl` 需要在填写 AutoDL 配置之前,先展示管理员下发的任务名称和任务要求详情。
任务信息区内容可参考:
- `docs/AutoDL部署实操任务.md`
要求为“概要展示”,不要把整个文档原文堆到页面里。
### 3.3 风格和视觉约束
当前统一沿用:
旧页 ID 一律不复用、不覆盖。
- Arco Design Pro 风格
- 科技蓝主色 `#165DFF`
- 白卡片 + 浅灰背景
- 严谨的 B 端信息层级
- 学生端沉浸式布局
- 导师端工作台布局
### 3.4 状态字段(`index.html` `studentState`)
### 3.4 命名和方案取舍
```
currentStage: 1~6 // 1衔接 2模型部署 3RAG 4Agent 5微调 6入项
resumeAnalyzed, resumeAbilities, resumeProjects, resumeSuggestions
bridgeQuizPassed, bridgeQuizScore, bridgeReadIds, bridgeQuizIndex, bridgeAnswers, bridgeLastWrong
deployReadIds, deployQuizIndex, deployAnswers, deployLastWrong, deployQuizScore
deployQuizPassed, deploySubmitted, deployReviewed, deployPassed
```
#### 页面命名约束
闸门函数:`hasStudentResume()`(看 `uploadedResume` + `resumeAnalyzed`,不再只看关键词数组)、`isBridgePassed()`、`getPrdCurrentStageId()`。
当前已存在的学生端关键页面 ID 不能随意复用或覆盖,尤其是:
演示:首页右侧 `previewStudentHome('bridge'|'deploy')`。切到阶段一时会 `clearBridgeResumeAnalysis()`。
- `student-autodl`
- `student-deploy-submit`
- `student-deploy-result`
- `student-bridge-preview`
- `student-deploy-preview`
- `student-deploy-quiz`
### 3.5 方案取舍
#### 方案取舍
- **预习小测必须双份**:不能改现有 `student-preview` / `quiz`。部署专用新页。
- 简历必须新页:旧简历在 `student-projects` 里,传完立刻出项目卡片。阶段一用 `student-resume`。
- 衔接 / 部署预习共用 `renderPrdKnowledgePreview`,数据分 `BRIDGE_KNOWLEDGE` / `DEPLOY_KNOWLEDGE`。
- 简历解析是 **前端演示数据**(`applyBridgeResumeAnalysis()` 固定一份张三画像),不是真解析文件。换文件名会重新走动画,结果仍是同一套 mock。
- 能力等级色:熟练=翠绿、熟悉=主色蓝、入门=琥珀。不要混用玫红。
本轮方案取舍的重点是:
- 不覆盖旧项目制页面
- 阶段二独立出自己的闭环
- 把阶段二当成“交付型任务”而不是“普通学习页”
- 先做学生端,再做导师端
---
## 4. 未完成的任务和下一步计划
按 `docs/P0原型改图确认清单` §7,当前停在第 3 步完成后、第 4 步之前。简历解析增强是阶段一补丁,做完后仍应先让用户看一眼简历页。
### 4.1 当前未完成事项
#### 未开始代码修改
目前所有工作仍停留在方案确认和文档沉淀阶段,尚未修改以下代码:
- `index.html`
- `pages-student.js`
- `pages-mentor.js`
- 其他页面模块
#### 未开始学生端页面实现
下一步最优先的实现对象是学生端阶段二页面,尤其是:
- `student-autodl`
- `student-deploy-submit`
- `student-deploy-result`
- `student-deploy-preview`
- `student-deploy-quiz`
#### 未开始导师端联动
导师端的以下内容仍待下一轮处理:
建议顺序:
- 部署验收页
- AutoDL 配置联动
- 学生验收状态同步
1. **(若用户还要验)** 再看一遍 `student-resume` 解析结果页。
2. **学生 AutoDL 只读页** `student-autodl`:脱敏主机 / 端口 / 用户名、测连通、复制 ssh。未过 80 分进不去(闸门已写好)。
3. **导师 AutoDL 配置页** `mentor-autodl`:按学员编辑下发。顶栏 **增加** Tab,顺序建议:
`导师首页 · 学员管理 · 实操评审 · 部署验收 · AutoDL 配置 · 答辩评审 · 入项审核`
**不删、不改** `mentor-practice-review`。
4. **部署产物提交** `student-deploy-submit`:`.log/.txt` + 地址 / 路径 / 端口;待审核锁表单;成功主按钮「去写报告」。
5. **部署作业详情** `student-deploy-result`:探测、日志预览、导师评语、AI 五段分析;驳回可重提。
6. **导师部署验收** `mentor-deploy-review`:列表(探测+审核状态)+ 详情(通过/驳回,驳回必填评语)。导师首页加对应待办。
7. **小改** `student-practice`:仅 `currentStage === 2` 时加 SSH 指引 + 跳转「提交部署产物」;原仓库提交区在其他阶段原样保留。
8. **小改** `student-defense`:仅阶段二改为等 `deployPassed`;其他阶段逻辑不动。
9. 导师首页 / 学员管理:加部署验收、AutoDL 入口(给部署阶段学员)。
#### 未开始入项逻辑调整
本轮仍不做:RAG/Agent/微调新界面、改 AI 推荐大厅、改旧提交/旧验收、改入项、成长档案、向量产物。
阶段六“导师审核入项意向”的移除还没有动手。
### 4.2 建议下一步顺序
1. 先按 `docs/学生端阶段二详细改造方案_v3.md` 的口径,确认学生端阶段二页面字段和交互
2. 再开始修改 `pages-student.js` 中阶段二页面
3. 修改完成后做一次阶段二闭环的页面联调
4. 再进入 `pages-mentor.js` 改造部署验收和 AutoDL 配置
5. 最后调整入项逻辑
---
## 5. 注意事项 / 踩过的坑
1. **不要覆盖旧页。** 改预习、小测、提交、验收时先问:这是部署专用还是其他阶段还要用?其他阶段要用的就新建 ID。
2. **`switchPage` 会在 renderer 里再被调用会打架。** 阶段一测验页不要在 renderer 里 `switchPage('student-resume')` 后 `return '<div></div>'`,会白屏或循环。未满足条件时直接渲染锁定/引导卡片。
3. **首页点「衔接测验 / 部署小测」必须走 `startBridgeQuiz` / `startDeployQuiz`。** 若直接 `switchPage`,会绕过「全部已读」检查。`goStudentPrdPage` 已特殊处理这两个 ID。
4. **`hasStudentResume()` 已改为看 `resumeAnalyzed`。** 演示切阶段一、重新上传时必须 `clearBridgeResumeAnalysis()`,否则会残留旧画像。`previewStudentHome('deploy')` 要调 `applyBridgeResumeAnalysis()`,不要只填三个关键词字符串。
5. **`studentState.currentStage` 仍被旧入项 / 四阶段循环使用**(`stageStatus` 只有 1–4)。PRD 六段用 `getPrdCurrentStageId()`(未过衔接则强制为 1)。不要把旧 `advanceToNextStage()` 当成阶段二通关。
6. **学生端无顶栏页签**,新页不会出现在 `ROLES.student.pages` 里;这是刻意的。导师端新页则必须写进 `ROLES.mentor.pages`,否则顶栏没有入口。
7. **部署预习 / 衔接预习早期版只有 3 句话正文。** 用户已反馈过。后续知识点页必须带:目标、分段讲解、对照表、命令/请求示例、预习材料、本节要点。数据在 `BRIDGE_KNOWLEDGE` / `DEPLOY_KNOWLEDGE` 的 `sections`,不要再写 `body: ['...']`。
8. **首页右侧演示按钮是给检查分流用的**,后续可撤。切「阶段二首页」不会自动标部署知识点已读,所以点「部署小测」仍会要求先预习。
9. **通过部署小测后点「进入 AutoDL」目前会弹尚未接入**——这是预期,不是回归。
10. 本地预览:打开 `index.html`,登录进学生端。检查阶段一用演示按钮或从默认新用户走上传简历。
### 关键入口(检查用)
- 阶段一首页:学习首页右侧「阶段一首页」→ 上传简历。
- 阶段二首页:右侧「阶段二首页」→ 部署知识点。
- 锁定:阶段一状态下直接想进实操 / 答辩 / 旧选题,应被 `switchPage` 拦回并弹窗。
### 5.1 不要把 AutoDL 当成导师下发
这是本轮已经纠正过的一次理解偏差。正确口径是:
- 学生自主租赁 AutoDL
- 平台负责接收和管理学生回填的信息
- 不存在平台代租赁、导师代下发的默认逻辑
### 5.2 `student-autodl` 不是只读展示页
它应是动态表单页,重点是:
- 展示任务信息
- 管理学生租赁记录
- 记录换租原因
- 填写 SSH
- 测试连通性
- 跳转 Code Server
### 5.3 Code Server 入口已经固定
页面里不要再使用模糊占位链接,应该直接使用:
`http://183.230.227.10:30002/?folder=/home`
### 5.4 任务信息区只做摘要展示
任务信息区应该参考 `docs/AutoDL部署实操任务.md` 的内容,但只展示概要,不要把整份文档原文复制进页面。
### 5.5 阶段二提交口径已统一
不要再把“提交产物”和“提交报告”做成两个完全独立的顺序步骤。当前统一口径是:
- 同步提交
- 同步验收
- 同步判定通过 / 驳回
### 5.6 旧页面与新流程并存是当前策略
阶段三至五仍保留旧项目闭环,这不是错误,而是当前阶段性方案的取舍。
### 5.7 当前没有动代码
本轮只完成了:
- 文档梳理
- 方案确认
- 交接沉淀
尚未开始业务代码修改。
---
## 6. 当前交接结论
当前项目已经把阶段二的产品方向基本确认清楚,核心共识是:
- 学生端阶段二要做成“真实部署交付闭环”
- AutoDL 是学生自己租赁的
- `student-autodl` 要先看任务,再填租赁信息,再填 SSH,再测试连通
- Code Server 入口要直接跳转到指定链接
- 阶段二提交时要同步提交实操报告
- 阶段六要移除导师审核入项意向
下一步建议直接从学生端阶段二页面开始落代码。
# 学生端阶段二代码修改方案步骤文档
> 目标:分阶段修改学生端阶段二,避免上下文过长导致错误。
>
> 当前基准方案:`docs/学生端阶段二详细改造方案_v3.md`
---
## 阶段 0:方案确认
- 已确认阶段二业务主线
- 已确认学生自主租赁 AutoDL
- 已确认 `student-autodl` 先展示任务信息,再填写租赁配置
- 已确认 Code Server 入口跳转到 `http://183.230.227.10:30002/?folder=/home`
- 已确认提交页需要产物 + 报告同步提交
---
## 阶段 1:学生端阶段二任务信息区与 AutoDL 表单结构
### 目标
- 在 `student-autodl` 增加任务信息区
- 将 AutoDL 配置区改成“租赁信息表单列表”
- 支持新增租赁记录
- 支持填写换租原因
- 增加 SSH 区与 Code Server 跳转按钮
### 当前状态
- 未开始
---
## 阶段 2:阶段二提交页改造
### 目标
- 将 `student-deploy-submit` 改为产物 + 报告同步提交页
- 明确日志包、API、模型名称、报告四类核心内容
### 当前状态
- 未开始
---
## 阶段 3:阶段二结果页与状态流转
### 目标
- 将 `student-deploy-result` 改为完整作业详情页
- 支持待验收 / 通过 / 驳回 / 重提
- 展示 AI 缺陷分析与导师评语
### 当前状态
- 未开始
---
## 阶段 4:首页入口与必要闸门联动
### 目标
- 联动学习首页的阶段二入口
- 确保阶段二流程顺序正确
- 检查状态字段和跳转逻辑
### 当前状态
- 未开始
---
## 更新规则
每完成一步修改后,立即更新本文件中的“当前状态”与关键变更点,再停下来等待产品审核。
# 学生端阶段二详细改造方案 v3
> 适用范围:`studyweb_Prototype` 学生端阶段二(模型部署)
>
> 方案前提:学生自主租赁 AutoDL,回到平台填写租赁信息与 SSH,测试连通性后进入 Code Server / Web IDE 实操,再通过 SSH 登录 AutoDL 真机完成部署。
---
## 一、阶段二改造目标
阶段二不是单纯的知识学习页,而是一个完整的模型部署实操闭环。学生需要从“理解任务”开始,经过“租赁算力、配置环境、连通验证、编写脚本、真机部署、提交产物、同步报告、等待验收”完成整套流程。
### 核心目标
1. 让学生明确当前任务是什么
2. 让学生先理解任务要求,再去配置自己的 AutoDL
3. 让学生可以管理自己租赁的 AutoDL 记录
4. 让学生填写自己生成的 SSH 信息
5. 让学生测试连通性
6. 让学生进入 Code Server 编写 / 修改 / 自测脚本
7. 让学生通过 SSH 登录 AutoDL 真机完成部署
8. 让学生同步提交部署产物与实操报告
9. 让导师后续基于产物 + 报告做验收
---
## 二、阶段二完整业务主线
```text
阶段一衔接测验通过
→ 阶段二部署知识点预习
→ 阶段二部署小测(≥80)
→ 学生自主租赁 AutoDL 算力
→ 回到实训平台查看任务信息
→ 新增 / 更新 AutoDL 租赁信息
→ 填写学生自己生成的 SSH
→ 测试连通性
→ 点击进入 Code Server / Web IDE
→ 编写 / 修改 / 自测部署脚本
→ SSH 登录 AutoDL 真机完成部署
→ 提交部署产物 + 实操报告
→ 查看部署作业详情
→ 等待导师验收
→ 通过 / 驳回重提
```
---
## 三、页面级改造范围
| 页面 ID | 改造级别 | 目标 |
|---|---|---|
| `student-deploy-preview` | 中度优化 | 部署知识点更聚焦真实任务 |
| `student-deploy-quiz` | 轻度优化 | 更贴近真实部署流程 |
| `student-autodl` | 重点重做 | 任务信息 + AutoDL 表单 + SSH + 连通性 + Code Server 入口 |
| `student-deploy-submit` | 重点重做 | 同步提交部署产物 + 实操报告 |
| `student-deploy-result` | 中度优化 | 展示提交结果、验收状态、AI 分析、重提入口 |
---
## 四、`student-autodl` 页面详细改造方案
### 1. 页面定位
`student-autodl` 不再是单纯的 AutoDL 查看页,而应升级为:
> 学生阶段二任务承接页 + AutoDL 租赁管理页 + SSH 配置页 + 连通性测试页 + Code Server 入口页
### 2. 页面结构建议
页面从上到下建议按以下顺序组织:
1. 任务信息区
2. AutoDL 租赁信息区
3. SSH 信息区
4. 连通性测试区
5. Code Server / Web IDE 入口区
### 3. 任务信息区设计
这一块参考 `docs/AutoDL部署实操任务.md`,但只做**概要展示**,不把整份文档全部搬到页面上。
#### 展示目标
让学生先知道:
- 这次任务是什么
- 要验收什么
- 关键实例配置是什么
- 最终 API 要满足哪些要求
- 通过标准是什么
#### 展示内容建议
| 字段 | 展示内容 |
|---|---|
| 任务名称 | 文本模型部署验收 / 图像生成 API 验收 |
| 任务目标 | 简要说明本任务要完成什么 |
| 实例配置摘要 | GPU、CPU、内存、系统盘、数据盘 |
| 镜像 / 环境要求 | CUDA、Python、推理框架等 |
| 模型名称 | 任务对应模型 ID |
| API 验收要求 | 关键接口与返回要求 |
| 通过条件 | 满足哪些条件算通过 |
#### 建议展示方式
- 顶部主标题
- 一行任务说明
- 关键配置标签
- 验收接口列表
- 通过条件列表
避免写成整段说明文字,尽量结构化。
### 4. 任务信息区内容摘要建议
#### 任务一 文本模型部署验收
建议以摘要方式展示:
- 使用 AutoDL 4090 实例
- 运行 vLLM 启动 Qwen3.5-4B
- 提供 OpenAI 兼容 API
- `GET /v1/models` 返回 `qwen3.5-4b`
- `POST /v1/chat/completions` 返回 200 且内容非空
#### 任务二 图像生成 API 验收
建议以摘要方式展示:
- 使用 AutoDL 4090 实例
- 部署图像生成服务
- 提供异步图像生成 API
- `GET /v1/models` 返回可用模型
- `POST /v1/generations` 返回 202 和任务 ID
- `GET /v1/generations/{id}` 最终返回 `succeeded` 和下载链接
### 5. AutoDL 租赁信息区设计
#### 正确理解
AutoDL 是**学生自主租赁**,配置会变化,不是稳定固定资源,所以该区域应该做成**可维护表单列表**,而不是只读卡片。
#### 核心交互
- 新增一条租赁信息
- 编辑已有租赁信息
- 标记当前使用中的租赁记录
- 保留历史租赁记录
- 填写换租原因
- 切换当前实际生效的实例
#### 每条租赁记录建议字段
| 字段 | 含义 | 是否建议必填 |
|---|---|---|
| 租赁名称 | 用于区分不同实例 | 是 |
| 平台名称 | 如 AutoDL | 是 |
| 实例名称 | 学生自己命名 | 是 |
| 公网地址 | 后续连通性和访问依据 | 是 |
| 端口 | 服务映射端口 | 是 |
| 用户名 | SSH 登录使用 | 是 |
| 密码 / 认证说明 | 认证信息描述 | 视规则而定 |
| GPU 型号 | 实例资源规格 | 是 |
| CPU / 内存 | 可选展示 | 建议有 |
| 镜像信息 | 环境版本说明 | 是 |
| 数据盘路径 | 模型和日志存储位置 | 是 |
| 当前使用状态 | 标记是否为当前有效租赁 | 是 |
| 换租原因 | 为什么更换实例 | 建议必填 |
| 备注 | 补充说明 | 否 |
#### 页面布局建议
每条租赁记录做成一个卡片:
- 卡片头部:租赁名称 + 状态标签
- 卡片主体:公网地址、端口、用户名、GPU、镜像、数据盘路径
- 卡片底部:编辑、归档、设为当前使用、查看换租原因
#### 新增租赁按钮
建议按钮文案:
- 添加租赁信息
- 新增 AutoDL 租赁记录
- 再租一台实例
#### 换租原因字段建议
可记录的原因例如:
- 原实例到期
- 原实例性能不足
- 原实例异常
- 需要更高显存
- 需要重新租赁
- 切换更适合当前任务的配置
### 6. SSH 信息区设计
#### 定位
学生自主租赁后,SSH 由学生自己生成,所以平台只负责接收填写、展示预览、复制和测试连通。
#### 建议字段
| 字段 | 含义 |
|---|---|
| SSH 主机 | 目标地址 |
| SSH 端口 | 连接端口 |
| SSH 用户名 | 登录账户 |
| SSH 命令 | 拼装后的可复制命令 |
| SSH 认证方式 | 密码 / 密钥 |
| 补充说明 | 学生备注 |
#### 交互建议
- 支持学生手动填写 SSH 信息
- 支持展示组合后的 SSH 命令
- 支持一键复制
- 支持与连通性测试联动
- 支持多条租赁记录对应不同 SSH
---
## 五、连通性测试区设计
### 1. 作用
连通性测试是学生正式进入部署前的自检动作。
### 2. 测试状态建议
- 待测试
- 测试中
- 连通成功
- 连通失败
- 端口超时
- 认证失败
- 地址无响应
### 3. 建议展示内容
测试结果最好包含:
- 测试时间
- 当前测试对象
- 测试结果
- 错误原因
- 下一步建议
### 4. 交互建议
- 测试按钮在表单填写完成后可用
- 测试失败时给出明确排障提示
- 测试成功后可进入 Code Server 实操
---
## 六、Code Server / Web IDE 入口区设计
### 1. 链接入口
`http://183.230.227.10:30002/?folder=/home`
### 2. 按钮文案建议
- 进入 Code Server / Web IDE
- 打开 Web IDE 实操
- 去编写部署脚本
### 3. 按钮说明建议
> 点击进入 Code Server / Web IDE,在这里完成部署脚本编写、修改和自测。
### 4. 业务意义
这个入口不是普通外链,而是阶段二实操的关键步骤之一。它承接学生在平台内完成的配置和验证,进一步进入脚本编写、自测和远程部署。
---
## 七、`student-deploy-preview` 页面优化建议
### 1. 页面定位
这是阶段二的知识前置页,目标不是灌输大段理论,而是帮助学生理解:
- 为什么要先租 AutoDL
- 为什么要看任务要求
- 为什么要做 API 验收
- 为什么日志和报告都要交
### 2. 内容结构建议
1. 任务总目标
2. 部署方式概述
3. AutoDL / Code Server / SSH 的关系
4. 最终交付物说明
5. 进入小测入口
### 3. 文案建议
- 本阶段任务是部署可验收的推理服务 / 图像服务
- 你需要自己租赁 AutoDL 并回填配置信息
- 你需要进入 Code Server 编写脚本并在真机验证
- 你需要提交产物、日志和实操报告
---
## 八、`student-deploy-quiz` 页面优化建议
### 1. 功能定位
这是阶段二的门槛页。
### 2. 出题方向建议
- `GET /v1/models` 的作用
- `POST /v1/chat/completions` 的验收含义
- `POST /v1/generations` 的返回状态
- 日志为什么必须提交
- AutoDL 为什么要自己租赁
- Code Server 在流程中的作用
- 什么是通过条件
### 3. 不建议的题型
不建议出太多纯概念题,避免变成“会背答案”而不是“懂流程”。
---
## 九、`student-deploy-submit` 页面详细改造方案
### 1. 页面定位
该页面不是单纯的文件上传页,而是:
> 部署产物 + 实操报告 的同步交付页
### 2. 页面结构建议
#### A. 部署产物区
| 字段 | 含义 |
|---|---|
| 日志包上传 | 必填 |
| API 地址 | 必填 |
| API Key | 必填 |
| 模型名称 | 必填 |
| 请求路径 | 建议必填 |
| 端口 | 建议必填 |
#### B. 实操报告区
| 字段 | 含义 |
|---|---|
| 本次任务目标 | 这次部署的任务名称和目标 |
| 部署过程 | 操作过程简述 |
| 问题与解决 | 报错和解决方式 |
| 自测结果 | 接口是否可用 |
| 总结反思 | 经验与反思 |
#### C. 提交确认区
提交前强提示:
- 部署产物和报告必须一起提交
- 提交后进入待验收状态
- 驳回后可重新编辑重提
### 3. 交互建议
- 未填完整时不允许提交
- 提交成功后锁定表单
- 驳回后可继续编辑
---
## 十、`student-deploy-result` 页面详细改造方案
### 1. 页面定位
这是阶段二提交后的结果承接页。
### 2. 建议展示内容
#### 结果摘要
- 当前提交状态
- 提交时间
- 验收状态
#### 产物摘要
- API 地址
- API Key
- 模型名称
- 日志包状态
- 报告状态
#### 探测结果
- API 是否连通
- 返回状态是否正常
- 是否符合验收要求
#### AI 缺陷分析
- 错误类型
- 日志片段
- 根因
- 修复建议
#### 导师评语
- 通过意见
- 驳回意见
- 补充说明
### 3. 状态建议
#### 通过
- 显示通过状态
- 引导进入下一步
#### 驳回
- 显示驳回原因
- 提供重新提交按钮
- 回流到提交页
---
## 十一、阶段二状态字段建议
建议后续在 `studentState` 中补齐或统一这些字段:
| 字段 | 用途 |
|---|---|
| `deployTaskName` | 当前任务名称 |
| `deployTaskDescription` | 任务要求详情 |
| `deployTaskType` | 文本模型 / 图像生成 |
| `autodlLeaseList` | AutoDL 租赁记录列表 |
| `autodlCurrentLeaseId` | 当前使用中的租赁记录 |
| `autodlLeaseChangeReason` | 换租原因 |
| `sshCommand` | SSH 命令 |
| `deployConnectionStatus` | 连通性测试状态 |
| `deployLogName` | 日志包文件名 |
| `deployApiUrl` | API 地址 |
| `deployApiKey` | API Key |
| `deployModelName` | 模型名称 |
| `deployReportSubmitted` | 报告是否提交 |
| `deploySubmitted` | 产物是否提交 |
| `deployReviewed` | 是否验收 |
| `deployPassed` | 是否通过 |
| `deployReviewComment` | 导师评语 |
---
## 十二、阶段二最终结构总结
### `student-autodl`
1. 任务信息区
2. AutoDL 租赁信息区
3. 新增租赁按钮
4. SSH 信息区
5. 连通性测试区
6. Code Server / Web IDE 入口区
### `student-deploy-submit`
1. 部署产物区
2. 实操报告区
3. 提交确认区
### `student-deploy-result`
1. 结果摘要
2. 产物摘要
3. 探测结果
4. AI 缺陷分析
5. 导师评语
6. 重提按钮
---
## 十三、阶段二验收标准
如果按这版方案实现,学生端阶段二至少要满足:
### 1. 流程完整
- 阶段一通过后才开放阶段二
- 阶段二小测通过后,才能进入 AutoDL
- AutoDL 页面先看任务信息,再配置租赁信息
- 配置完成后可测试连通性
- Code Server 入口可跳转
- 提交页同步提交产物和报告
- 结果页能承接验收结果
### 2. 任务明确
- 展示任务名称
- 展示任务要求摘要
- 展示实例配置摘要
- 展示验收接口和通过条件
### 3. 配置可变
- 支持新增租赁信息
- 支持修改已有租赁
- 支持记录换租原因
- 支持多个实例并存
### 4. 交付统一
- 产物和报告同步提交
- 验收依据统一
- 结果页可回流修改
---
## 十四、审核重点
你在审这一版方案时,可以重点看这几项:
1. `student-autodl` 的任务信息区是否够清楚
2. AutoDL 配置区是否真的改成了“动态表单”
3. 是否允许学生新增多条租赁记录
4. “换租原因”字段是否设计合理
5. Code Server 按钮跳转到指定链接是否符合预期
6. `student-deploy-submit` 是否真正做到了“产物 + 报告同步提交”
......@@ -509,6 +509,9 @@ var studentState = {
deployRejected: false,
deployReviewComment: '',
deployArtifact: { fileName: '', apiUrl: '', apiPath: '', port: '' },
deployTaskId: 'text-model',
autodlLeases: [],
autodlCurrentLeaseId: '',
// 入项申请权限
canApplyEntry: false
};
......
Markdown 格式
0% 或
您添加了 0 人 到此讨论。请谨慎行事。
请先完成此评论的编辑!
请 注册 或者 后发表评论