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

821最终版本

上级 94dfffef
# 0823 导师部署验收台重构 - 交接文档
> 更新时间:2026-06-16
> 项目:`0820studyweb_Prototype`
> 涉及文件:`pages-mentor.js`(主改)、`pages-student.js`(仅核对,未改)
> 状态:步骤 0 → 13 已按方案全部完成
---
## 1. 本次重构完成内容
### 步骤 1:全局状态与命名
- `MENTOR_DEPLOY_TASKS`:任务定义表,含「任务一 文本模型 / 任务二 图像生成」两个任务的路径、默认参数。
- `mentorDeployReviewState`:验收台状态全部改为「任务 × 学生」两级索引(`params / tests / scores / comments / conclusion`)。
- 提交数据 `deploySubmissionsByStudent` 二维化:`[学生 id][taskKey]`。
### 步骤 2:测试函数 + Mock 数据
- 四个学生 × 两个任务共 8 组 mock 提交数据,覆盖:待验收 / 已驳回(第 1 轮)/ 未提交 / 部分提交。
- 真实 API 测试函数:`runMentorDeployModelsTest / runMentorDeployChatTest / runMentorDeployGenSubmitTest / runMentorDeployGenStatusTest`,每个测试函数显式绑定任务维度,防止串数据。
### 步骤 3-5:三栏布局与中栏 Tab
- 左侧学生列表卡:显示每个学生两个任务的状态徽章 + 提交完整度。
- 顶部全局任务 Tab(任务一 / 任务二),切换联动中栏与右栏。
- 中栏内部 Tab:部署产物 / 实操日志 / 实操报告(只读展示 + 复制入口)。
### 步骤 7-8:产物复制与全局配置
- 产物 API Key / 地址一键复制,并可快速填入测试配置。
- 右栏顶部全局配置区:API 地址 + API Key 临时覆盖(`window.__mentorDeployTempApiUrl / TempApiKey`),「应用 / 恢复学生值」。
### 步骤 9-10:API 测试区重构
- **文本模型卡**:任务说明条(非竖排横向布局)+「恢复任务默认值」+ 默认值文案,测试项含模型列表 / 聊天补全。
- **图像生成卡**:任务说明条 +「恢复任务默认值」+ 图片尺寸 / **宽高比(1:1 / 3:4 / 4:3 / 9:16 / 16:9)** / 随机种子参数,提交 body 携带 `options.aspect_ratio`。
### 步骤 11:验收结论区重构(整体单选)
- 取消「产物 / 报告分项验收」,改为**整体单选**:通过 / 驳回 / 待补充。
- `getMentorDeployReviewConclusion / setMentorDeployReviewConclusion`:结论草稿按学生索引。
- 提交校验:
- 通过 → 产物与报告必须都已提交,且关键 API 测试全部通过。
- 驳回 / 待补充 → 评语必填。
- 锁定态只读卡与历史记录卡同步移除分项展示。
### 步骤 12:提交同步与锁定适配
- `submitMentorDeployReview`:按当前任务提交,快照本轮测试结果与参数,仅「通过」写入评分。
- 同步 `studentState`:`deployReviewTaskKey / deployReviewStatus / deployReviewComment / deployPassed / deployRejected` 等;驳回 / 待补充时重置学生提交状态(学生可重新编辑提交)。
- `isMentorDeployReviewLocked`:仅 `已通过 / 已驳回 / 待补充` 三种正式结论锁定;`验收中 / 待验收` 仍可编辑。
### 步骤 13:整体联调与样式打磨
- 图像生成**自动轮询**:`startMentorDeployGenPolling / stopMentorDeployGenPolling`,3 秒一次,成功 / 失败 / 网络错误 3 次自动停止;提交成功自动启动,轮询开关可手动切换(`toggleMentorDeployGenPolling`)。
- 图片预览:`succeeded` 时展示 `outputs[].url` 图片 + 打开原图链接,加载失败降级提示。
- 生成进度条:`running` 状态展示进度百分比进度条。
- **保存草稿**:`saveMentorDeployReviewDraft`,未给正式结论时置为「验收中」(不锁定),同步学生端状态。
- 轮询清理:切换学生、切换任务 Tab、提交结论三处均调用 `stopMentorDeployGenPolling()`。
- 状态颜色统一:通过绿 / 驳回红 / 待补充紫 / 验收中蓝 / 待验收琥珀。
---
## 2. 数据结构速览
### 任务定义(`MENTOR_DEPLOY_TASKS`)
```javascript
'text-model': { tabName: '任务一', title: '文本模型部署', mainPath: '/v1/chat/completions', ... }
'image-gen': { tabName: '任务二', title: '图像生成 API', mainPath: '/v1/generations', statusPath: '/v1/generations/{id}', defaultImagePrompt, defaultSize, defaultAspectRatio }
```
### 验收台状态(`mentorDeployReviewState`)
```javascript
{
activeTask, contentTab,
params, // [taskKey][sid] -> { apiUrl, apiKey, modelName, prompt, maxTokens, temperature | imagePrompt, size, aspectRatio, seed }
tests, // [taskKey][sid] -> { models, chat | genSubmit, genStatus }
scores, // [taskKey][sid] -> { api(40), deployment(20), logs(15), report(15), reflection(10) }
comments, // [taskKey][sid] -> string
conclusion, // [sid] -> '通过' | '驳回' | '待补充'(草稿,全局共享)
pollTimer, pollAuto
}
```
### 测试结果结构
- `genSubmit`:`{ status, httpStatus, latency, taskId, raw, error, testedAt, url }`
- `genStatus`:`{ status, httpStatus, latency, taskId, taskStatus, progress, outputs, raw, error, testedAt, url }`
- `chat`:`{ status, httpStatus, latency, responseText, returnedModel, raw, error, testedAt, url }`
---
## 3. 验收结论流转
```
未提交 → 待验收(双提交完成)→ 验收中(导师保存草稿,可编辑)
→ 已通过 / 已驳回 / 待补充(导师提交,锁定只读)
→ 驳回 / 待补充后学生重新编辑提交 → 新一轮「待验收」
```
---
## 4. 已知限制与注意事项
1. **`Lundefined:undefined` lint 预警**(4 条):来自 HTML 模板字符串,已知无害,可忽略。
2. **真实 API 受 CORS 限制**:AutoDL 服务未允许跨域时测试会失败,错误提示已覆盖;原型保持真实请求,不加伪造数据。
3. **`studentState` 为全局单例**:导师端同步的仍是同一份演示数据,最后一次提交为准。
4. **轮询基于真实 HTTP**:无真实服务时自动轮询会因网络错误在 3 次后自动停止,不会无限重试。
5. **步骤 6(日志关键词高亮)本次未实施**:中栏日志为只读展示,未做高亮;如后续需要可在此基础上补充。
6. **宽高比参数名**:请求 body 使用 `options.aspect_ratio`,若实际服务端字段不同需按服务端文档调整。
7. **轮询间隔**:3 秒 / 最多 30 次(约 90 秒),如需更久请调整 `startMentorDeployGenPolling` 内的 `poll` 对象。
---
## 5. 验证方式
- 语法检查:`node --check pages-mentor.js`(每步完成后执行)。
- 浏览器流程(导师端 → 部署验收):
1. 任务 Tab 切换:任务一 / 任务二状态徽章与内容区联动。
2. 文本任务:模型列表 / 聊天补全测试,四要素(状态码 / 耗时 / 结论 / JSON)。
3. 图像任务:提交生成任务 → 自动轮询 → 进度条 → 图片预览;宽高比参数生效。
4. 结论:整体单选 → 保存草稿(状态变「验收中」且不锁定)→ 提交(通过需 API 全过 + 双提交;驳回 / 待补充需评语)。
5. 锁定后只读;驳回后学生重新提交 → 新轮次解锁。
- 自动化冒烟:`node _tmp_*.js`(临时脚本已清理)。
差异被折叠。
Markdown 格式
0% 或
您添加了 0 人 到此讨论。请谨慎行事。
请先完成此评论的编辑!
请 注册 或者 后发表评论