Skip to content
项目
群组
代码片段
帮助
当前项目
正在载入...
登录 / 注册
切换导航面板
S
studyweb_Prototype
项目
项目
详情
活动
周期分析
仓库
仓库
文件
提交
分支
标签
贡献者
图表
比较
统计图
议题
0
议题
0
列表
看板
标记
里程碑
合并请求
0
合并请求
0
CI / CD
CI / CD
流水线
作业
日程
统计图
Wiki
Wiki
代码片段
代码片段
成员
成员
折叠边栏
关闭边栏
活动
图像
聊天
创建新问题
作业
提交
问题看板
Open sidebar
yujiejie
studyweb_Prototype
Commits
c684d05f
提交
c684d05f
authored
8月 23, 2026
作者:
yujiejie
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
821步骤零完成
上级
f7a2c972
隐藏空白字符变更
内嵌
并排
正在显示
2 个修改的文件
包含
520 行增加
和
21 行删除
+520
-21
0823导师部署验收台重构方案.md
docs/0823导师部署验收台重构方案.md
+476
-0
pages-mentor.js
pages-mentor.js
+44
-21
没有找到文件。
docs/0823导师部署验收台重构方案.md
0 → 100644
浏览文件 @
c684d05f
# 0823 导师部署验收台重构方案(分步实施)
> 更新时间:2026-08-23
> 项目:`0820studyweb_Prototype`
> 涉及文件:`pages-mentor.js`(主改)、`index.html`(仅核对,不改)
> 状态:方案已与需求方确认,待按步骤逐步实施
> 使用方式:严格按「步骤 0 → 步骤 13」顺序执行,每完成一步先验证再进入下一步,避免一次性大改出错。
---
## 1. 背景与目标
当前
`mentor-deploy-review`
(导师部署验收台)已完成基础三栏布局(学生列表 / 提交内容 / 验收台)与真实 API 测试能力,但存在以下问题:
1.
每个学生只绑定单一
`taskType`
,无法覆盖「任务一(文本模型)+ 任务二(图像生成)」两条任务的验收场景。
2.
中栏产物 / 日志 / 报告垂直平铺,长页面滚动成本高,日志无关键词高亮,产物无复制入口。
3.
右栏验收参数、测试项、评分、结论挤在一起,结论采用「产物 / 报告分项验收」,与确认后的「整体单选」不符。
4.
图像生成缺「尺寸比例」参数与自动轮询能力。
**本次目标**
:按确认后的产品设计,将导师部署验收台重构为:
-
页顶全局任务 Tab(任务一 / 任务二),切换联动中栏与右栏
-
中栏内部 Tab(部署产物 / 实操日志 / 实操报告)
-
右栏三段式:顶部配置 → 中部 API 测试 → 底部验收结论
-
验收结论改为
**整体单选**
(通过 / 待补充 / 驳回),联动动态表单
---
## 2. 已确认的产品决策
| # | 决策 | 说明 |
|---|---|---|
| 1 |
**验收结论改为整体单选**
| 通过 / 待补充 / 驳回 三选一,取消「产物 / 报告分别验收」 |
| 2 |
**实操报告保持结构化分段**
| 沿用
`taskName / process / issues / selfTest / summary`
五个字段分段渲染,不做 Markdown |
| 3 |
**全局任务 Tab**
| 任务一(文本模型)/ 任务二(图像生成),Tab 显示当前选中学生在该任务下的验收状态 |
| 4 |
**中栏 Tab 化**
| 部署产物(默认)/ 实操日志 / 实操报告 |
| 5 |
**右栏三段式**
| 顶部全局配置 → 中部测试区 → 底部验收结论区 |
| 6 |
**测试结果展示**
| HTTP 状态码 + 耗时 + 验证结论标签 + 深色 JSON 代码块 |
---
## 3. 目标数据模型与状态结构
### 3.1 提交数据:二维化
当前(一维,按学生):
```
javascript
deploySubmissionsByStudent
:
{
1
:
{
taskType
:
'text-model'
,
artifact
:
{...},
log
:
{...},
report
:
{...},
review
:
{...}
}
}
```
目标(二维,按学生 × 任务):
```
javascript
deploySubmissionsByStudent
:
{
1
:
{
'text-model'
:
{
artifactSubmitted
,
reportSubmitted
,
artifact
:
{...},
log
:
{...},
report
:
{...},
review
:
{...}
},
'image-gen'
:
{
artifactSubmitted
,
reportSubmitted
,
artifact
:
{...},
log
:
{...},
report
:
{...},
review
:
{...}
}
}
}
```
**Mock 数据规划**
(步骤 1 落地):
| 学生 | text-model | image-gen |
|---|---|---|
| 张三(1) | 待验收(双提交) | 未提交 |
| 李四(2) | 已驳回(第 1 轮,沿用现有 mock) | 待验收(双提交) |
| 王五(3) | 未提交 | 待验收(双提交,沿用现有 mock) |
| 赵六(4) | 部分提交(产物已交、报告未交,沿用现有 mock) | 未提交 |
### 3.2 验收台状态:全部改为「任务 × 学生」两级索引
```
javascript
var
mentorDeployReviewState
=
{
activeTask
:
'text-model'
,
// 'text-model' | 'image-gen',全局 Tab
contentTab
:
'artifact'
,
// 'artifact' | 'log' | 'report',中栏 Tab
params
:
{},
// [taskKey][sid] -> { apiUrl, apiKey, modelName, prompt, ... }
tests
:
{},
// [taskKey][sid] -> { models, chat | genSubmit | genStatus }
scores
:
{},
// [taskKey][sid] -> { api, deployment, logs, report, reflection }
comments
:
{},
// [taskKey][sid] -> string
decision
:
{},
// [taskKey][sid] -> '通过' | '待补充' | '驳回'(草稿态)
pollTimer
:
null
// 图像任务自动轮询定时器
};
```
统一入口辅助函数:
```
javascript
function
getMentorDeployTaskKey
()
{
return
mentorDeployReviewState
.
activeTask
||
'text-model'
;
}
function
getMentorDeploySubmission
(
studentId
,
taskKey
)
{
var
subs
=
mentorState
.
deploySubmissionsByStudent
||
{};
var
s
=
subs
[
Number
(
studentId
)];
return
s
?
(
s
[
taskKey
||
getMentorDeployTaskKey
()]
||
null
)
:
null
;
}
```
### 3.3 任务定义常量
```
javascript
var
MENTOR_DEPLOY_TASKS
=
{
'text-model'
:
{
key
:
'text-model'
,
tabName
:
'任务一'
,
title
:
'文本模型部署'
,
shortName
:
'文本模型'
,
modelsPath
:
'/v1/models'
,
mainPath
:
'/v1/chat/completions'
,
defaultPrompt
:
'请用三点解释 vLLM 的连续批处理。'
,
defaultMaxTokens
:
'160'
,
defaultTemperature
:
'0.2'
},
'image-gen'
:
{
key
:
'image-gen'
,
tabName
:
'任务二'
,
title
:
'图像生成 API'
,
shortName
:
'图像生成'
,
modelsPath
:
'/v1/models'
,
mainPath
:
'/v1/generations'
,
statusPath
:
'/v1/generations/{id}'
,
defaultPrompt
:
'一只可爱的熊猫在竹林里吃竹子'
,
defaultSize
:
'1024x1024'
,
defaultAspectRatio
:
'1:1'
}
};
```
---
## 4. 分步骤实施计划
> 每个步骤包含:**目标 / 改动内容 / 涉及函数 / 完成标准**。每步完成标准必须验证通过后再继续。
---
### 步骤 0:基线备份与语法检查
-
**目标**
:确认当前可回退状态,建立安全基线。
-
**改动内容**
:
1.
`git status`
确认工作区干净,如有未提交内容先提交或 stash。
2.
执行语法检查:
```bash
node --check pages-mentor.js
node --check pages-student.js
```
3.
浏览器打开页面,进入导师端「部署验收」,截图记录当前三栏布局与每个学生的展示效果,作为后续回归对照。
-
**涉及函数**
:无
-
**完成标准**
:语法检查通过;当前页面渲染正常;有基准截图。
---
### 步骤 1:提交数据模型二维化
-
**目标**
:把
`deploySubmissionsByStudent`
从一维改为「学生 × 任务」二维,此步骤
**不引入任何 UI 变化**
,所有读取默认走
`text-model`
,保证页面视觉与改动前一致。
-
**改动内容**
:
1.
重写
`mentorState.deploySubmissionsByStudent`
为
`{ sid: { taskKey: submission } }`
。
2.
按 3.1 的 Mock 规划填充数据;原有字段(
`artifact`
/
`log`
/
`report`
/
`review`
/
`artifactSubmitted`
/
`reportSubmitted`
)原样保留到对应任务下。
3.
删除原 submission 上的顶层
`taskType`
字段(任务归属由外层 key 决定)。
-
**涉及函数**
(全部增加可选
`taskKey`
参数,默认
`getMentorDeployTaskKey()`
):
-
`getMentorDeploySubmission(studentId)`
-
`getMentorDeployStudentStatus(studentId)`
-
`isMentorDeployReviewLocked(studentId)`
-
`getMentorDeployTaskTypeLabel(studentId)`
(改用
`MENTOR_DEPLOY_TASKS[taskKey].shortName`
)
-
`getMentorDeployCompletenessLabel(studentId)`
-
`buildMentorDeploySubmissionPanel(sub)`
(入参不变,调用处传当前任务的 sub)
-
**完成标准**
:
`node --check`
通过;页面渲染、学生列表、中栏内容与改动前
**逐像素一致**
。
---
### 步骤 2:任务定义与验收台状态重构
-
**目标**
:建立
`MENTOR_DEPLOY_TASKS`
常量,并把
`mentorDeployReviewState`
的临时态全部改为「任务 × 学生」两级。
-
**改动内容**
:
1.
新增
`MENTOR_DEPLOY_TASKS`
(见 3.3)。
2.
`mentorDeployReviewState`
增加
`activeTask`
、
`contentTab`
;
`params / tests / scores / comments`
从
`[sid]`
改为
`[taskKey][sid]`
;新增
`decision`
。
3.
新增
`getMentorDeployTaskKey()`
与
`getMentorDeployStateNode(key)`
(返回
`state[key][taskKey][sid]`
并自动初始化)。
4.
以下函数增加
`taskKey`
维度(签名统一为
`(sid, taskKey)`
):
-
`getMentorDeployReviewParams`
/
`setMentorDeployReviewParam`
/
`restoreMentorDeployReviewParams`
-
`getMentorDeployReviewScores`
/
`setMentorDeployReviewScore`
/
`normalizeMentorDeployScoreInput`
/
`updateMentorDeployScoreTotal`
-
`getMentorDeployReviewComment`
/
`setMentorDeployReviewComment`
-
`getMentorDeployBaseUrl`
/
`getMentorDeployModelsUrl`
/
`getMentorDeployChatUrl`
/
`getMentorDeployRequestHeaders`
-
`runMentorDeployModelsTest`
/
`runMentorDeployChatTest`
-
`getMentorDeployGenSubmitUrl`
/
`getMentorDeployGenStatusUrl`
-
`runMentorDeployGenSubmitTest`
/
`runMentorDeployGenStatusTest`
-
`getMentorDeployMissingApiTests`
-
**完成标准**
:
`node --check`
通过;切换(手动改
`activeTask`
变量模拟)后各测试结果、评分、评语互不串扰。
---
### 步骤 3:页顶全局任务 Tab
-
**目标**
:页面头部下方新增任务 Tab 栏,显示当前选中学生的各任务验收状态,支持切换。
-
**改动内容**
:
1.
新增
`buildMentorDeployTaskTabs(selectedId)`
:渲染两个 Tab。
-
每个 Tab 显示:
`任务一 · 文本模型`
/
`任务二 · 图像生成`
-
Tab 徽章 = 当前选中学生在该任务下的
`getMentorDeployStudentStatus(sid, taskKey)`
-
状态徽章复用
`getMentorDeployStatusBadge`
;已通过前加
`check`
图标、待验收加
`clock`
、已驳回加
`x`
、未提交/部分提交加
`minus`
-
当前激活 Tab 蓝色高亮(
`bg-[#165DFF] text-white`
),未激活白底
2.
新增
`switchMentorDeployTask(taskKey)`
:
-
设置
`activeTask`
、重置
`contentTab='artifact'`
-
若存在图像轮询定时器则
`stopMentorDeployGenPolling()`
-
`renderContent()`
刷新
3.
页面渲染函数中,Tab 栏放在标题行下方、三栏容器上方(整行
`col-span-12`
)。
-
**涉及函数**
:
`buildMentorDeployTaskTabs`
(新)、
`switchMentorDeployTask`
(新)、
`pageRenderers["mentor-deploy-review"]`
-
**完成标准**
:两个 Tab 徽章与所选学生状态一致;点击切换后中栏、右栏内容随之刷新。
---
### 步骤 4:学生列表适配当前任务
-
**目标**
:左栏学生卡片的状态与完整度跟随当前任务展示。
-
**改动内容**
:
1.
`buildMentorDeployStudentList(students, selectedId)`
内所有状态计算改为传入当前
`activeTask`
。
2.
学生卡片第二行文案由「业务线 · 任务类型」改为「业务线 · 当前任务:任务一/任务二」。
3.
完整度标签按当前任务计算(
`getMentorDeployCompletenessLabel(sid, taskKey)`
)。
-
**涉及函数**
:
`buildMentorDeployStudentList`
、
`getMentorDeployCompletenessLabel`
-
**完成标准**
:切换任务 Tab 后,左栏每个学生的状态徽章、完整度文案同步变化。
---
### 步骤 5:中栏内部 Tab 化(产物 / 日志 / 报告)
-
**目标**
:中栏由垂直平铺改为内部 Tab 切换,默认展示「部署产物」。
-
**改动内容**
:
1.
新增
`buildMentorDeployContentTabs(sid, taskKey)`
:三个 Tab(部署产物 / 实操日志 / 实操报告),当前项蓝色高亮。
2.
新增
`setMentorDeployContentTab(tab)`
:更新
`contentTab`
并
`renderContent()`
。
3.
新增三个构建函数(拆自原
`buildMentorDeploySubmissionPanel`
):
-
`buildMentorDeployArtifactTab(sid, taskKey)`
:key-value 卡片
-
模型名称、API 地址、请求路径、端口、API Key(脱敏)、日志包文件名
-
每行右侧加「复制」图标按钮(复制按钮逻辑见步骤 7)
-
API Key 行特殊处理:显示「已配置 · sk-••••」,旁置「填入验收台」按钮
-
`buildMentorDeployLogTab(sid, taskKey)`
:日志文件卡片 + 「在线预览」按钮
-
`buildMentorDeployReportTab(sid, taskKey)`
:结构化五段(任务目标 / 部署过程 / 问题与解决 / 自测结果 / 总结反思),优化为分隔卡片排版
4.
中栏顶部保留学生信息条与
`buildMentorDeployCompletenessNotice(sub)`
不完整提示。
-
**涉及函数**
:
`buildMentorDeployContentTabs`
、
`setMentorDeployContentTab`
、
`buildMentorDeployArtifactTab`
、
`buildMentorDeployLogTab`
、
`buildMentorDeployReportTab`
(均为新);
`buildMentorDeploySubmissionPanel`
(删除或保留为空壳,建议删除)
-
**完成标准**
:三个 Tab 切换正常;产物 key-value 展示完整;报告五段可读。
---
### 步骤 6:日志在线预览增强(关键词高亮)
-
**目标**
:日志预览弹窗支持关键词着色,方便快速定位问题。
-
**改动内容**
:
1.
新增
`highlightMentorDeployLog(content)`
:
-
先转义 HTML(复用
`mentorDeployReviewEsc`
)
-
再按关键词包裹高亮 span:
-
`[ERROR]`
/
`CUDA out of memory`
/
`failed`
→ 红色(
`text-rose-400`
)
-
`[WARN]`
→ 黄色(
`text-amber-300`
)
-
`[INFO]`
→ 蓝色(
`text-sky-300`
)
-
`HTTP 200`
→ 绿色(
`text-emerald-300`
)
-
vLLM / Qwen / SDXL / AutoDL → 青色(
`text-cyan-300`
)
-
注意:关键词高亮须在转义之后进行,避免注入。
2.
重写
`viewMentorDeployLogModal(nameEncoded, contentEncoded)`
:
`<pre>`
内调用高亮函数;同时显示日志行数与文件大小。
-
**涉及函数**
:
`highlightMentorDeployLog`
(新)、
`viewMentorDeployLogModal`
(重写)
-
**完成标准**
:预览弹窗中 ERROR 红色、INFO 蓝色、HTTP 200 绿色等关键词正确着色。
---
### 步骤 7:产物复制与 API Key 填入验收台
-
**目标**
:导师可一键复制产物信息;API Key 脱敏前提下可一键填入右栏验收配置。
-
**改动内容**
:
1.
新增
`copyMentorDeployValue(text, label)`
:
-
优先
`navigator.clipboard.writeText`
,失败时用隐藏
`textarea + document.execCommand('copy')`
兜底
-
成功用
`showStudentFlowModal('已复制', label + ' 已复制到剪贴板')`
提示
2.
新增
`fillMentorDeployApiKeyToReview()`
:
-
读取当前任务学生提交的
`artifact.apiKey`
全量值
-
写入
`mentorDeployReviewState.params[taskKey][sid].apiKey`
-
提示「已将 API Key 填入验收台」;
**不把全量 Key 渲染到页面上**
3.
产物 Tab 各 key-value 行右侧加复制按钮;API Key 行加「填入验收台」按钮。
-
**涉及函数**
:
`copyMentorDeployValue`
(新)、
`fillMentorDeployApiKeyToReview`
(新)、
`buildMentorDeployArtifactTab`
-
**完成标准**
:点击复制提示成功;点击「填入验收台」后右栏 Token 输入框出现该学生的完整 Key。
---
### 步骤 8:右栏顶部全局配置区
-
**目标**
:右栏最顶部独立出「验收配置」卡片(API Base URL / API Token / 模型名称)。
-
**改动内容**
:
1.
重写
`buildMentorDeployParamsPanel(sid, taskKey)`
:
-
标题:
`验收配置`
+ 提示文案「已带入学生提交值,以下调整仅用于本次验收,不会修改学生原始提交内容」
-
三个字段:API Base URL(说明:不包含 /v1,示例
`http://IP:端口`
)、API Token(
`type=password`
)、模型名称
-
底部保留「恢复学生提交值」按钮
-
锁定态(已提交结论)时输入框只读
2.
该卡片固定在右栏
`buildMentorDeployReviewPanel`
输出的第一块。
-
**涉及函数**
:
`buildMentorDeployParamsPanel`
(重写)、
`buildMentorDeployReviewPanel`
-
**完成标准**
:配置区置顶;修改 URL/Token 后各测试请求使用新值。
---
### 步骤 9:文本模型测试区重构
-
**目标**
:任务一的测试区改为两个独立测试卡片,结果区结构化展示并给出验证结论。
-
**改动内容**
:
1.
重写
`buildMentorDeployTextModelItems(sid, taskKey)`
:
-
**卡片一 · GET /v1/models**
:
-
请求地址展示 + 「测试」按钮
-
结果区:HTTP 状态码(着色)、耗时、验证结论标签
-
结论:✅ 模型列表包含声明模型
`qwen3.5-4b`
/ ❌ 未找到声明模型(附返回模型名列表)
-
深色 JSON 代码块展示原始响应
-
**卡片二 · POST /v1/chat/completions**
:
-
参数:测试提示词(默认
`请用三点解释 vLLM 的连续批处理。`
)、Max Tokens(默认 160)、Temperature(默认 0.2)
-
结果区:HTTP 状态码、耗时、验证结论
-
结论:✅
`choices[0].message.content`
非空 / ❌ 未解析到有效内容
-
展示返回内容摘要与返回模型名
-
深色 JSON 代码块展示原始响应
2.
新增通用结果块构建函数
`buildMentorDeployTestResultCard(result, conclusionText)`
:
-
内部复用现有
`buildMentorDeployTestMeta`
/
`buildMentorDeployTestError`
-
结论标签:通过绿色 +
`check-circle`
图标,失败红色 +
`x-circle`
3.
默认参数来源改为
`MENTOR_DEPLOY_TASKS['text-model']`
常量。
-
**涉及函数**
:
`buildMentorDeployTextModelItems`
(重写)、
`buildMentorDeployTestResultCard`
(新)、
`getMentorDeployReviewParams`
-
**完成标准**
:两项测试结果区展示 HTTP 码/耗时/结论/JSON 四要素;默认参数为设计值。
---
### 步骤 10:图像生成测试区重构(含比例与自动轮询)
-
**目标**
:任务二改为三个测试卡片,支持图片尺寸比例参数与任务自动轮询。
-
**改动内容**
:
1.
重写
`buildMentorDeployImageGenItems(sid, taskKey)`
:
-
**卡片一 · GET /v1/models**
:结果区含验证结论「✅ 存在图像模型(modality=image)/ ❌ 未找到可用图像模型」
-
**卡片二 · POST /v1/generations**
:
-
参数:生成描述(默认
`一只可爱的熊猫在竹林里吃竹子`
)、图片尺寸(1024×1024 / 1664×928 / 928×1664)、宽高比(1:1 / 3:4 / 4:3 / 9:16 / 16:9)
-
结果区:HTTP 状态码(期望 202)、耗时、任务 ID、深色 JSON
-
提交成功后若开启自动轮询则启动
`startMentorDeployGenPolling()`
-
**卡片三 · GET /v1/generations/{id}**
:
-
展示任务 ID、任务状态(queued / running / succeeded / failed)、进度条(running 时显示百分比)
-
succeeded 时展示图片预览(
`<img>`
,来自
`outputs[].url`
)+ 下载链接
-
failed 时展示错误信息
-
「立即查询」手动按钮 + 「自动轮询」开关(默认开)
2.
新增轮询函数:
-
`startMentorDeployGenPolling()`
:
`setInterval`
每 3 秒调
`runMentorDeployGenStatusTest()`
,最多 30 次
-
`stopMentorDeployGenPolling()`
:
`clearInterval`
并清空
`pollTimer`
-
轮询中任一
`succeeded`
/
`failed`
状态出现即自动停止
3.
新增
`aspectRatio`
参数与选项渲染
`getMentorDeployAspectRatioOptions(current)`
;提交 body 中
`options.size`
保留,
`options.aspect_ratio`
按需加入。
4.
切换任务 Tab / 切换学生 / 提交验收结论时调用
`stopMentorDeployGenPolling()`
。
-
**涉及函数**
:
`buildMentorDeployImageGenItems`
(重写)、
`startMentorDeployGenPolling`
(新)、
`stopMentorDeployGenPolling`
(新)、
`getMentorDeployAspectRatioOptions`
(新)、
`switchMentorDeployTask`
(补调用)、
`selectMentorDeployReviewStudent`
(补调用)
-
**完成标准**
:提交生成任务返回任务 ID → 自动轮询 → 成功展示图片、失败展示错误;手动/自动切换正常。
---
### 步骤 11:验收结论区重构(整体单选 + 动态表单 + 草稿)
-
**目标**
:底部结论区改为「单选 → 动态表单 → 操作按钮」三步联动。
-
**改动内容**
:
1.
**删除**
旧分项结论相关代码:
-
`buildMentorDeployPartConclusionRow`
、
`setMentorDeployPartReviewStatus`
、
`getMentorDeployPartReviewStatus`
、
`getMentorDeployOverallStatus`
、
`getMentorDeployPartStatusLabel`
、
`getMentorDeployPartStatusBadge`
-
`mentorDeployReviewState.partStatus`
2.
重写
`buildMentorDeployConclusionPanel(sid, taskKey)`
:
-
**步骤 1 · 验收结论**
:单选组
`通过 / 待补充 / 驳回`
-
每个选项一行,选中态:通过=绿色边框、待补充=紫色、驳回=红色
-
选项旁说明文案:
-
通过:产物、日志、报告与 API 验收均满足要求
-
待补充:主体可验收但缺少材料或说明
-
驳回:存在关键问题,需修改后重新提交
-
**步骤 2 · 动态表单**
:
-
选「通过」:展开评分表单(5 项:API 可用性 40 / 部署规范性 20 / 实操日志完整度 15 / 实操报告质量 15 / 问题排查与总结 10,自动算总分)+ 导师评语 textarea
-
选「待补充」/「驳回」:隐藏评分,显示必填 textarea(标题:修改建议 / 驳回原因)
-
**步骤 3 · 操作按钮**
:
-
`保存草稿`
(次级,
`btn-outline`
)→
`saveMentorDeployReviewDraft()`
-
`提交验收并通知学生`
(主色,
`btn-primary`
高亮)
3.
新增
`getMentorDeployDecision(sid, taskKey)`
/
`setMentorDeployDecision(value)`
:读写
`mentorDeployReviewState.decision`
。
4.
新增
`saveMentorDeployReviewDraft()`
:
-
若该任务
`review.status`
为空或「待验收」,置为「验收中」
-
`showStudentFlowModal('草稿已保存', ...)`
提示
-
不锁定,可继续编辑
5.
提交校验逻辑(放入步骤 12 的
`submitMentorDeployReview`
):
-
未选结论 → 拦截「请先选择验收结论」
-
选「通过」:5 项评分全部必填(或给出默认值 0 且提示总分 ≥60)+ 关键 API 测试必须全部通过(复用
`getMentorDeployMissingApiTests`
)
-
选「待补充」/「驳回」:原因/建议必填
-
**涉及函数**
:
`buildMentorDeployConclusionPanel`
(重写)、
`buildMentorDeployScoreCard`
(并入动态表单,原独立卡片可删除)、
`saveMentorDeployReviewDraft`
(新)、
`get/setMentorDeployDecision`
(新)
-
**完成标准**
:单选切换后表单联动正确;三种结论的校验拦截生效;保存草稿后状态变「验收中」。
---
### 步骤 12:提交同步与锁定面板适配
-
**目标**
:
`submitMentorDeployReview`
改为整体单结论提交;锁定只读面板去掉分项展示。
-
**改动内容**
:
1.
重写
`submitMentorDeployReview()`
:
-
校验通过后写入:
```javascript
sub.review.round = (parseInt(sub.review.round, 10) || 0) + 1;
sub.review.status = decision; // '已通过' | '已驳回' | '待补充'
sub.review.comment = comment;
sub.review.score = scores; // 仅「通过」时有值
sub.review.reviewedAt = reviewedAt;
sub.review.notifiedAt = reviewedAt;
sub.review.updatedAt = reviewedAt;
sub.review.tests = JSON.parse(JSON.stringify(mentorDeployReviewState.tests[taskKey][sid] || {}));
sub.review.params = JSON.parse(JSON.stringify(mentorDeployReviewState.params[taskKey][sid] || {}));
```
-
清空
`decision / scores / comments`
草稿
2.
`studentState`
同步(仍在
`pages-mentor.js`
内写):
-
新增
`deployReviewTaskKey = taskKey`
-
`deployReviewStatus / deployReviewComment / deployReviewScore / deployReviewRound / deployReviewUpdatedAt / deployReviewNotifiedAt`
-
`deployPassed`
、
`deployRejected`
-
「已驳回」/「待补充」时:
`deployArtifactSubmitted = false`
、
`deployReportSubmitted = false`
(整体重提);「已通过」时保留
3.
通知创建:
`message`
改为整体结论文案(通过 → 评分与简要评语;驳回/待补充 → 必带处理意见)。
4.
重写
`buildMentorDeployLockedReviewPanel(sid, taskKey)`
:
-
去掉
`artifactStatus / reportStatus`
分项展示
-
保留:验收轮次、整体状态、提交时间 / 通知时间、API 测试摘要(
`buildMentorDeployReviewTestsSummary`
)、5 项评分 + 总分、导师评语
5.
清理 Mock 数据:李四「已驳回」记录移除
`artifactStatus / reportStatus`
字段,补
`round: 1`
。
-
**涉及函数**
:
`submitMentorDeployReview`
(重写)、
`buildMentorDeployLockedReviewPanel`
(重写)、
`isMentorDeployReviewLocked`
-
**完成标准**
:提交后页面锁定、只读面板正确;学生端状态与通知文案一致;驳回后学生可重新编辑。
---
### 步骤 13:整体联调、样式打磨与交接
-
**目标**
:全流程走查、视觉统一、输出交接文档。
-
**改动内容**
:
1.
**联调清单**
(逐项验证):
-
[
]
`node --check pages-mentor.js`
/
`pages-student.js`
通过
-
[
]
任务 Tab 状态徽章与选中学生一致,切换不串数据
-
[
]
中栏三 Tab 内容只读,产物复制 / API Key 填入正常
-
[
]
日志关键词高亮正确
-
[
]
文本模型两项测试:HTTP 码 / 耗时 / 结论 / JSON 四要素齐全
-
[
]
图像生成:提交→轮询→图片预览;比例参数传入 body
-
[
]
整体单选 + 动态表单联动,三种结论校验正确
-
[
]
保存草稿 → 状态「验收中」
-
[
]
提交后锁定只读;学生端状态 / 通知 / 结果页一致
-
[
]
驳回 / 待补充后学生重新编辑提交 → 新轮次
2.
**样式打磨**
:
-
状态颜色统一:通过绿 / 驳回红 / 待补充紫 / 验收中蓝 / 待验收琥珀
-
测试结果 JSON 统一深色代码块(
`bg-[#1D2129] text-emerald-300`
)
-
状态图标:
`check-circle`
/
`x-circle`
/
`clock`
/
`loader`
(lucide)
3.
更新
`docs/0821HANDOFF.md`
或新建
`docs/0823HANDOFF.md`
记录本轮改动与验证结果。
-
**涉及文件**
:
`pages-mentor.js`
、
`docs/0823HANDOFF.md`
(新)
-
**完成标准**
:联调清单全绿;样式统一;交接文档完成。
---
## 5. 涉及文件与函数总清单(便于对照执行)
### 5.1 删除 / 废弃
| 函数 | 原因 |
|---|---|
|
`buildMentorDeploySubmissionPanel`
| 拆为三个 Tab 构建函数 |
|
`buildMentorDeployPartConclusionRow`
| 分项结论取消 |
|
`setMentorDeployPartReviewStatus`
| 分项结论取消 |
|
`getMentorDeployPartReviewStatus`
| 分项结论取消 |
|
`getMentorDeployOverallStatus`
| 分项结论取消 |
|
`getMentorDeployPartStatusLabel`
| 分项结论取消 |
|
`getMentorDeployPartStatusBadge`
| 分项结论取消 |
|
`mentorDeployTestNotReady`
| 静态占位,已无需要 |
|
`mentorDeployReviewState.partStatus`
| 分项结论取消 |
### 5.2 新增
| 函数 | 归属步骤 |
|---|---|
|
`getMentorDeployTaskKey`
| 2 |
|
`MENTOR_DEPLOY_TASKS`
常量 | 2 |
|
`buildMentorDeployTaskTabs`
| 3 |
|
`switchMentorDeployTask`
| 3 |
|
`buildMentorDeployContentTabs`
/
`setMentorDeployContentTab`
| 5 |
|
`buildMentorDeployArtifactTab`
/
`buildMentorDeployLogTab`
/
`buildMentorDeployReportTab`
| 5 |
|
`highlightMentorDeployLog`
| 6 |
|
`copyMentorDeployValue`
| 7 |
|
`fillMentorDeployApiKeyToReview`
| 7 |
|
`buildMentorDeployTestResultCard`
| 9 |
|
`getMentorDeployAspectRatioOptions`
| 10 |
|
`startMentorDeployGenPolling`
/
`stopMentorDeployGenPolling`
| 10 |
|
`get/setMentorDeployDecision`
| 11 |
|
`saveMentorDeployReviewDraft`
| 11 |
### 5.3 重写 / 适配(增加 taskKey 维度)
`getMentorDeploySubmission`
/
`getMentorDeployStudentStatus`
/
`isMentorDeployReviewLocked`
/
`getMentorDeployTaskTypeLabel`
/
`getMentorDeployCompletenessLabel`
/
`buildMentorDeployStudentList`
/
`viewMentorDeployLogModal`
/
`getMentorDeployReviewParams`
/
`setMentorDeployReviewParam`
/
`restoreMentorDeployReviewParams`
/
`getMentorDeployBaseUrl`
/
`getMentorDeployModelsUrl`
/
`getMentorDeployChatUrl`
/
`getMentorDeployRequestHeaders`
/
`runMentorDeployModelsTest`
/
`runMentorDeployChatTest`
/
`getMentorDeployGenSubmitUrl`
/
`getMentorDeployGenStatusUrl`
/
`runMentorDeployGenSubmitTest`
/
`runMentorDeployGenStatusTest`
/
`buildMentorDeployParamsPanel`
/
`buildMentorDeployTextModelItems`
/
`buildMentorDeployImageGenItems`
/
`getMentorDeployReviewScores`
/
`setMentorDeployReviewScore`
/
`normalizeMentorDeployScoreInput`
/
`updateMentorDeployScoreTotal`
/
`buildMentorDeployScoreCard`
/
`getMentorDeployReviewComment`
/
`setMentorDeployReviewComment`
/
`buildMentorDeployConclusionPanel`
/
`buildMentorDeployLockedReviewPanel`
/
`buildMentorDeployReviewPanel`
/
`getMentorDeployMissingApiTests`
/
`submitMentorDeployReview`
/
`pageRenderers["mentor-deploy-review"]`
---
## 6. 风险与注意事项
1.
**任务 × 学生两级索引是最大改动点**
:步骤 1、2 完成后必须先做数据隔离验证(两个任务测试结果互不串扰),再继续 UI。
2.
**`studentState` 为全局单例**
:原型限制下,导师端同步的仍是同一份演示数据,切换学生/任务时同步字段需保证最后一次提交为准(注意先清掉旧值再写入)。
3.
**真实 API 测试受 CORS 限制**
:AutoDL 服务未允许跨域时测试会失败,现有错误提示文案已覆盖;原型演示时可保持真实请求 + 明确错误提示,不建议加伪造数据。
4.
**语法检查不能省**
:每步完成后执行
`node --check pages-mentor.js`
。模板字符串过长容易出引号/
`};`
问题。
5.
**`Lundefined:undefined` lint 预警**
:来自 HTML 模板字符串,已知无害,可忽略。
6.
**锁定判断统一**
:
`isMentorDeployReviewLocked(sid, taskKey)`
只在
`review.status`
为
`已通过 / 已驳回 / 待补充`
时返回 true,
`验收中 / 待验收`
仍可编辑。
7.
**轮询清理**
:切换任务 Tab、切换学生、提交结论三处都必须
`stopMentorDeployGenPolling()`
,防止定时器泄漏。
pages-mentor.js
浏览文件 @
c684d05f
...
...
@@ -1480,15 +1480,22 @@ function buildMentorDeployStudentList(students, selectedId) {
var
active
=
Number
(
s
.
id
)
===
selectedId
;
var
status
=
getMentorDeployStudentStatus
(
s
.
id
);
var
statusClass
=
getMentorDeployStatusBadge
(
status
);
return
'<button type="button" class="w-full text-left p-4 rounded-lg border mb-2 transition-all '
+
(
active
?
'border-[#165DFF] bg-[#E8F3FF]'
:
'border-[#E5E6EB] bg-white hover:border-[#165DFF]'
)
+
var
taskTypeLabel
=
getMentorDeployTaskTypeLabel
(
s
.
id
);
var
completeness
=
getMentorDeployCompletenessLabel
(
s
.
id
);
return
'<button type="button" class="w-full text-left p-3 rounded-lg border mb-2 transition-all '
+
(
active
?
'border-[#165DFF] bg-[#E8F3FF] shadow-sm'
:
'border-[#E5E6EB] bg-white hover:border-[#165DFF] hover:shadow-sm'
)
+
'" onclick="selectMentorDeployReviewStudent('
+
s
.
id
+
')">'
+
'<div class="flex items-center justify-between">'
+
'<span class="font-medium text-[#1D2129]">'
+
mentorDeployReviewEsc
(
s
.
name
)
+
'</span>'
+
'<span class="text-xs px-2 py-0.5 rounded '
+
statusClass
+
'">'
+
status
+
'</span>'
+
'<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-sm font-bold flex-shrink-0">'
+
mentorDeployReviewEsc
(
s
.
name
.
charAt
(
0
))
+
'</div>'
+
'<div class="min-w-0 flex-1">'
+
'<div class="flex items-center justify-between gap-2">'
+
'<span class="font-medium text-sm text-[#1D2129] truncate">'
+
mentorDeployReviewEsc
(
s
.
name
)
+
'</span>'
+
'<span class="text-[11px] px-1.5 py-0.5 rounded flex-shrink-0 '
+
statusClass
+
'">'
+
status
+
'</span>'
+
'</div>'
+
'<div class="text-xs text-[#86909C] mt-0.5 truncate">'
+
mentorDeployReviewEsc
(
s
.
businessLine
||
'—'
)
+
' · '
+
taskTypeLabel
+
'</div>'
+
'<div class="text-xs text-[#86909C] mt-0.5">'
+
completeness
+
'</div>'
+
'</div>'
+
'</div>'
+
'<div class="text-xs text-[#86909C] mt-1">'
+
mentorDeployReviewEsc
(
s
.
businessLine
||
'—'
)
+
' · '
+
getMentorDeployTaskTypeLabel
(
s
.
id
)
+
'</div>'
+
'<div class="text-xs text-[#86909C] mt-0.5">'
+
getMentorDeployCompletenessLabel
(
s
.
id
)
+
'</div>'
+
'</button>'
;
}).
join
(
''
);
}
...
...
@@ -2393,9 +2400,9 @@ function buildMentorDeployReviewPanel(student) {
var
locked
=
isMentorDeployReviewLocked
(
sid
);
var
leftHtml
=
buildMentorDeployReviewHistoryHtml
(
sid
)
+
buildMentorDeployParamsPanel
(
sid
)
+
itemsHtml
;
var
rightHtml
=
locked
?
buildMentorDeployLockedReviewPanel
(
sid
)
:
buildMentorDeployScoreCard
(
sid
)
+
buildMentorDeployConclusionPanel
(
sid
);
return
'<div class="grid grid-cols-
2 gap-4
">'
+
'<div class="min-w-0">'
+
leftHtml
+
'</div>'
+
'<div class="min-w-0">'
+
rightHtml
+
'</div>'
+
return
'<div class="grid grid-cols-
12 gap-4 items-start
">'
+
'<div class="
col-span-7
min-w-0">'
+
leftHtml
+
'</div>'
+
'<div class="
col-span-5
min-w-0">'
+
rightHtml
+
'</div>'
+
'</div>'
;
}
...
...
@@ -2540,22 +2547,38 @@ pageRenderers["mentor-deploy-review"] = function() {
}).
length
;
var
listHtml
=
buildMentorDeployStudentList
(
students
,
selectedId
);
var
contentHtml
=
selected
?
'<div class="mb-4 flex items-center justify-between"><div><h3 class="font-semibold text-[#1D2129]">'
+
mentorDeployReviewEsc
(
selected
.
name
)
+
' · 提交内容</h3><p class="text-xs text-[#86909C] mt-1">学生提交内容只读展示,验收参数、API 测试与评分结论见右侧验收台</p></div><span class="px-2.5 py-1 rounded-lg text-xs font-medium '
+
statusClass
+
'">'
+
status
+
'</span></div>'
+
?
'<div class="bg-white rounded-lg border border-[#E5E6EB] p-4 mb-4 flex items-center justify-between gap-3">'
+
'<div class="flex items-center gap-3 min-w-0">'
+
'<div class="w-10 h-10 rounded-full bg-gradient-to-br from-[#165DFF] to-[#4080FF] text-white flex items-center justify-center text-base font-bold flex-shrink-0">'
+
mentorDeployReviewEsc
(
selected
.
name
.
charAt
(
0
))
+
'</div>'
+
'<div class="min-w-0">'
+
'<h3 class="font-semibold text-[#1D2129] truncate">'
+
mentorDeployReviewEsc
(
selected
.
name
)
+
' · 提交内容</h3>'
+
'<p class="text-xs text-[#86909C] mt-0.5 truncate">产物 / 日志 / 报告只读展示,验收参数与测试在右侧验收台</p>'
+
'</div>'
+
'</div>'
+
'<span class="px-2.5 py-1 rounded-lg text-xs font-medium flex-shrink-0 '
+
statusClass
+
'">'
+
status
+
'</span>'
+
'</div>'
+
buildMentorDeployCompletenessNotice
(
sub
)
+
buildMentorDeploySubmissionPanel
(
sub
)
:
'<div class="bg-white rounded-lg border border-[#E5E6EB] p-8 text-center text-[#86909C]">请先从左侧选择学生</div>'
;
return
'<div class="max-w-[1400px] mx-auto">'
+
'<div class="flex items-center justify-between mb-6"><div><h1 class="text-2xl font-bold text-[#1D2129]">部署验收</h1><p class="text-sm text-[#86909C] mt-1">选择负责学生,查看提交内容并完成 API 验收</p></div>'
+
'<span class="px-3 py-1.5 rounded-lg text-sm font-medium '
+
statusClass
+
'">'
+
status
+
'</span></div>'
+
'<div class="grid grid-cols-3 gap-5 mb-6">'
+
'<div class="feature-card p-5"><div class="text-xs text-[#86909C]">负责学生</div><div class="text-2xl font-bold mt-1">'
+
students
.
length
+
'</div></div>'
+
'<div class="feature-card p-5"><div class="text-xs text-[#86909C]">待验收提交</div><div class="text-2xl font-bold mt-1">'
+
pendingCount
+
'</div></div>'
+
'<div class="feature-card p-5"><div class="text-xs text-[#86909C]">当前学生</div><div class="text-lg font-bold mt-1">'
+
(
selected
?
mentorDeployReviewEsc
(
selected
.
name
)
:
'—'
)
+
'</div></div>'
+
return
'<div class="max-w-[1500px] mx-auto">'
+
'<div class="flex items-center justify-between mb-6">'
+
'<div>'
+
'<h1 class="text-2xl font-bold text-[#1D2129]">部署验收</h1>'
+
'<p class="text-sm text-[#86909C] mt-1">选择负责学生,查看提交内容并完成 API 验收</p>'
+
'</div>'
+
'<div class="flex items-center gap-3">'
+
'<div class="px-4 py-2 bg-white rounded-lg border border-[#E5E6EB] flex items-center gap-2"><span class="text-xs text-[#86909C]">负责学生</span><b class="text-base text-[#1D2129]">'
+
students
.
length
+
'</b></div>'
+
'<div class="px-4 py-2 bg-white rounded-lg border border-[#E5E6EB] flex items-center gap-2"><span class="text-xs text-[#86909C]">待验收</span><b class="text-base text-amber-600">'
+
pendingCount
+
'</b></div>'
+
'<span class="px-3 py-1.5 rounded-lg text-sm font-medium '
+
statusClass
+
'">'
+
status
+
'</span>'
+
'</div>'
+
'</div>'
+
'<div class="grid grid-cols-12 gap-6">'
+
'<div class="col-span-3 bg-white rounded-lg border border-[#E5E6EB] p-5"><h3 class="font-semibold mb-4">我的学生</h3>'
+
(
listHtml
||
'<div class="py-10 text-center text-sm text-[#86909C]">暂无负责学生</div>'
)
+
'</div>'
+
'<div class="col-span-4">'
+
contentHtml
+
'</div>'
+
'<div class="col-span-5">'
+
buildMentorDeployReviewPanel
(
selected
)
+
'</div>'
+
'<div class="col-span-3 bg-white rounded-lg border border-[#E5E6EB] p-4 self-start">'
+
'<div class="flex items-center justify-between mb-3"><h3 class="font-semibold text-[#1D2129]">我的学生</h3><span class="text-xs px-2 py-0.5 rounded bg-[#F2F3F5] text-[#86909C]">'
+
students
.
length
+
' 人</span></div>'
+
(
listHtml
||
'<div class="py-10 text-center text-sm text-[#86909C]">暂无负责学生</div>'
)
+
'</div>'
+
'<div class="col-span-4 min-w-0">'
+
contentHtml
+
'</div>'
+
'<div class="col-span-5 min-w-0">'
+
buildMentorDeployReviewPanel
(
selected
)
+
'</div>'
+
'</div></div>'
;
};
...
...
编写
预览
Markdown
格式
0%
重试
或
添加新文件
添加附件
取消
您添加了
0
人
到此讨论。请谨慎行事。
请先完成此评论的编辑!
取消
请
注册
或者
登录
后发表评论