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

821步骤零完成

上级 f7a2c972
# 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()`,防止定时器泄漏。
......@@ -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 人 到此讨论。请谨慎行事。
请先完成此评论的编辑!
请 注册 或者 后发表评论