Skip to content
项目
群组
代码片段
帮助
当前项目
正在载入...
登录 / 注册
切换导航面板
S
studyweb_Prototype
项目
项目
详情
活动
周期分析
仓库
仓库
文件
提交
分支
标签
贡献者
图表
比较
统计图
议题
0
议题
0
列表
看板
标记
里程碑
合并请求
0
合并请求
0
CI / CD
CI / CD
流水线
作业
日程
统计图
Wiki
Wiki
代码片段
代码片段
成员
成员
折叠边栏
关闭边栏
活动
图像
聊天
创建新问题
作业
提交
问题看板
Open sidebar
yujiejie
studyweb_Prototype
Commits
f0b387d6
提交
f0b387d6
authored
8月 23, 2026
作者:
yujiejie
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
821最终版本
上级
94dfffef
全部展开
隐藏空白字符变更
内嵌
并排
正在显示
2 个修改的文件
包含
116 行增加
和
0 行删除
+116
-0
0823HANDOFF.md
docs/0823HANDOFF.md
+116
-0
pages-mentor.js
pages-mentor.js
+0
-0
没有找到文件。
docs/0823HANDOFF.md
0 → 100644
浏览文件 @
f0b387d6
# 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`
(临时脚本已清理)。
pages-mentor.js
浏览文件 @
f0b387d6
差异被折叠。
点击展开。
编写
预览
Markdown
格式
0%
重试
或
添加新文件
添加附件
取消
您添加了
0
人
到此讨论。请谨慎行事。
请先完成此评论的编辑!
取消
请
注册
或者
登录
后发表评论