提交 3792fdad authored 作者: yujiejie's avatar yujiejie

预习点知识中心界面完善

上级 935e00cf
......@@ -450,44 +450,221 @@ var BRIDGE_KNOWLEDGE = [
id: 'linux',
title: 'Linux 基础命令',
duration: '40 分钟',
level: '基础',
summary: '掌握日常排障与环境操作所需的基础命令。',
body: [
'学习目标:能够在终端完成目录浏览、文件查看、权限修改和进程查看。',
'重点命令:ls、cd、pwd、cat、tail、grep、chmod、ps、top。',
'衔接意义:阶段二在 AutoDL / 沙箱中部署模型时,需要用这些命令检查日志、端口和进程。'
prereq: '无。阶段二 AutoDL / 沙箱排障的前置。',
goals: [
'能在终端完成目录浏览、文件查看、权限修改和进程查看',
'会用 tail / grep 盯日志,定位端口和报错',
'知道这些命令会在阶段二部署时反复用到'
],
sections: [
{
heading: '为什么阶段一要先学 Linux',
paragraphs: [
'阶段二不会在网页里替你点「一键部署」。你要 SSH 进 AutoDL 或沙箱终端,自己看目录、盯日志、查进程。命令不熟,后面的推理服务启动失败时会完全摸不到线索。',
'本课不要求成为运维,只要求能完成部署现场最常见的 8 个动作。'
]
},
{
heading: '部署现场最常用的命令',
paragraphs: ['把命令和场景绑在一起记,比背手册更有用:'],
table: [
['命令', '作用', '部署时用来做什么'],
['pwd', '打印当前目录', '确认你是否在项目/权重目录里'],
['ls -lh', '列出文件和大小', '找日志、脚本、模型权重是否在'],
['cd', '切换目录', '进入启动脚本所在路径'],
['cat / tail -f', '查看 / 持续跟踪文件', '盯启动日志,看服务有没有起来'],
['grep', '过滤文本', '在日志里搜 Error、Address already in use'],
['chmod +x', '添加可执行权限', '启动脚本无法执行时使用'],
['ps / top', '查看进程', '确认推理进程是否还在跑'],
['nvidia-smi', '查看 GPU', '显存是否被占满、驱动是否可见']
]
},
{
heading: '推荐操作顺序(排障时照着做)',
paragraphs: ['服务起不来时,按下面顺序查,避免一上来就重装环境:'],
list: [
'pwd + ls:我在不在正确目录?启动脚本和权重还在吗?',
'tail -f 日志:最后 50 行有没有 Traceback / CUDA / port?',
'ps 或 nvidia-smi:进程死了,还是卡在加载权重?',
'端口占用:日志里写的监听端口,是否已经被别的进程占用?'
],
code: 'pwd\nls -lh\ntail -n 80 /root/infer.log\ngrep -i "error\\|traceback\\|cuda\\|listen" /root/infer.log\nnvidia-smi'
},
{
heading: '和阶段二的衔接',
paragraphs: [
'AutoDL 登录后你做的第一件事就是这些命令。平台沙箱里也可以练,但不要把大模型本体塞进沙箱。'
]
}
],
materials: [
{ name: 'Linux 命令速查:ls / cd / pwd / cat / tail / grep', kind: '文档' },
{ name: '权限与进程:chmod、ps、top 示意', kind: '文档' },
{ name: '对照练习:在沙箱终端把上述命令各跑一遍', kind: '实操提示' }
],
takeaways: [
'pwd / ls / tail / grep 是部署排障的最低配',
'chmod 用于改权限;ps / nvidia-smi 用于确认进程和 GPU',
'阶段一只学命令,不启动大模型、不交产物'
]
},
{
id: 'ai-basic',
title: 'AI 基础概念',
duration: '35 分钟',
level: '基础',
summary: '建立大模型、推理、向量化等后续任务的共同语言。',
body: [
'学习目标:区分训练、微调、推理;理解 Token、上下文窗口、Embedding 的基本含义。',
'重点概念:大语言模型、API 调用、延迟与吞吐、GPU 显存。',
'衔接意义:阶段二的部署任务会要求你启动推理服务并登记 API 地址。'
prereq: '无编程也可读;后续部署课会反复出现这些词。',
goals: [
'能区分训练、微调、推理三件不同的事',
'理解 Token、上下文窗口、Embedding 在部署里意味着什么',
'知道「部署成功」通常等于「推理 API 可调用」'
],
sections: [
{
heading: '三件不要混的事',
paragraphs: ['实习生培训里最容易混的是训练和推理。阶段二要你做的是推理服务,不是从零训练一个模型。'],
table: [
['概念', '在做什么', '本阶段要不要做'],
['训练 Training', '用大量数据从零或继续优化权重,耗时长、吃 GPU', '不做'],
['微调 Fine-tune', '在已有模型上用小数据适配业务', '阶段五才会涉及'],
['推理 Inference', '加载已有权重,根据输入生成结果', '阶段二要做的事']
]
},
{
heading: '部署时会碰到的词',
list: [
'大语言模型(LLM):根据提示生成文本。阶段二任务是把 Qwen 这类模型做成可调用服务。',
'Token:模型读写文本的基本单位。上下文窗口越大,一次能看的内容越多,也越占显存。',
'Embedding / 向量化:把文本变成一组数字,便于检索。和「聊天生成」不是同一类接口。',
'延迟 / 吞吐:第一条结果要等多久、一分钟能处理多少请求。导师探测时会顺带看服务是否卡住。',
'GPU 显存:权重加载失败、OOM,多半是显存不够或被其它进程占满。'
]
},
{
heading: '为什么产物是 API 而不是模型文件',
paragraphs: [
'导师不会打开你的权重文件「验收」。他们用 HTTP 调用你登记的地址:通了、能返回结果,才算推理服务部署成功。',
'所以你要理解:启动进程只是手段,对外暴露稳定的推理 API 才是目标。'
]
}
],
materials: [
{ name: '训练 / 微调 / 推理对照表', kind: '文档' },
{ name: 'Token、上下文窗口、Embedding 名词解释', kind: '文档' },
{ name: '推理 API 在验收中的角色说明', kind: '文档' }
],
takeaways: [
'阶段二 = 推理服务,不是训练',
'Embedding 是向量化,和聊天生成接口不同',
'验收看的是 API 能不能调通'
]
},
{
id: 'python-env',
title: 'Python 环境与依赖',
duration: '30 分钟',
level: '基础',
summary: '能看懂依赖安装、虚拟环境和常见报错。',
body: [
'学习目标:使用 pip / conda 安装依赖,阅读 requirements.txt,处理 ModuleNotFoundError。',
'重点:虚拟环境隔离、CUDA 与驱动不匹配的常见现象。',
'衔接意义:模型部署失败时,日志里最常见的就是环境和依赖问题。'
prereq: '有任意语言基础更好;本课只覆盖部署会踩的坑。',
goals: [
'能读懂 requirements.txt,并用 pip 安装依赖',
'理解虚拟环境是为了隔离,避免系统 Python 被污染',
'见到 ModuleNotFoundError / CUDA 不匹配时知道先查环境'
],
sections: [
{
heading: '部署失败,第一嫌疑人往往是环境',
paragraphs: [
'模型代码本身没问题,但 AutoDL 镜像里的 CUDA、PyTorch、驱动对不上,服务一样起不来。阶段一先建立「先看环境再改代码」的习惯。'
]
},
{
heading: '你需要会的三件事',
list: [
'看依赖清单:项目根目录的 requirements.txt 列出了必须安装的包和版本。',
'隔离安装:用 venv / conda 建独立环境,不要把包装进系统 Python。',
'对症读报错:ModuleNotFoundError 优先 pip install;CUDA error 优先核对驱动与 PyTorch 是否匹配。'
],
code: 'python -m venv .venv\nsource .venv/bin/activate # Windows: .venv\\Scripts\\activate\npip install -r requirements.txt\npython -c "import torch; print(torch.__version__, torch.cuda.is_available())"'
},
{
heading: '常见报错怎么理解',
table: [
['报错', '优先检查'],
['ModuleNotFoundError: No module named xxx', '当前环境是否装了该包、是否激活了 venv'],
['CUDA unknown error / driver mismatch', 'nvidia-smi 驱动版本 vs 安装的 torch 是否配套'],
['CUDA out of memory', '显存被占满,或模型比 GPU 规格更大']
]
}
],
materials: [
{ name: 'pip 与 requirements.txt 使用说明', kind: '文档' },
{ name: 'venv / conda 隔离环境示意', kind: '文档' },
{ name: 'CUDA 与 PyTorch 版本对照提示', kind: '文档' }
],
takeaways: [
'先激活环境,再安装依赖,再启动服务',
'ModuleNotFoundError ≠ 代码写错,先查包',
'GPU 报错先看驱动和显存,而不是先改模型代码'
]
},
{
id: 'deploy-prep',
title: '模型部署前置',
duration: '45 分钟',
level: '基础',
summary: '理解推理服务、端口、日志包和 API 回传方式。',
body: [
'学习目标:知道什么是推理 API、健康检查、端口放行,以及为何要回传 AutoDL 日志。',
'重点:不要把大模型部署进平台沙箱;重 GPU 任务走 AutoDL。',
'衔接意义:这是阶段二系统直接下发的部署任务的前置知识,本阶段仍不选题、不实操。'
prereq: '建议先读完 Linux / AI 概念 / Python 环境。',
goals: [
'能说清推理 API、健康检查、端口放行各自解决什么问题',
'知道大模型不能部署进平台沙箱,重 GPU 走 AutoDL',
'明白阶段二要交的是日志包 + API,不是 Git 仓库'
],
sections: [
{
heading: '推理服务长什么样',
paragraphs: [
'一个推理服务 = 进程在某台机器上监听端口,外面用 HTTP 把 prompt 打进去,再拿到生成结果。',
'健康检查(如 GET /health)用来快速判断进程还活着。导师探测会先打这个,再打真正的推理接口。'
]
},
{
heading: '沙箱和 AutoDL 怎么分工',
list: [
'平台沙箱:练 Linux 命令、改启动脚本、看报错。不要把大模型权重加载进沙箱。',
'AutoDL:导师下发 GPU 机器。学生只读配置,测连通、复制 ssh,上去做真正的部署。',
'学生不能自己改 IP / 端口 / 账号,配置有问题找导师。'
]
},
{
heading: '阶段二你要交什么(先记住)',
table: [
['提交物', '作用'],
['AutoDL 日志包(.log / .txt)', '证明服务是怎么启动的、报错是什么'],
['API 地址 / 路径 / 端口', '导师用来实际调用'],
['实操报告', '提交成功后仍要写,说明过程和自测'],
['Git 仓库', '本阶段不用,留给其他阶段的旧路径']
]
},
{
heading: '本阶段仍然没有实操',
paragraphs: [
'阶段一只学这些概念和命令。通过 70 分测验后,系统才会下发「Qwen2.5-7B 推理服务部署」任务。'
]
}
],
materials: [
{ name: '推理 API 与健康检查示意', kind: '文档' },
{ name: '沙箱 vs AutoDL 分工说明', kind: '文档' },
{ name: '阶段二产物清单(日志包 + API)', kind: '文档' }
],
takeaways: [
'大模型不进沙箱,重 GPU 走 AutoDL',
'健康检查 + 推理 API 才是「部署起来了」',
'阶段一结束标准是测验 ≥70,不是交仓库'
]
}
];
......@@ -662,36 +839,100 @@ pageRenderers["student-resume"] = function() {
</div>`;
};
pageRenderers["student-bridge-preview"] = function() {
if (!hasStudentResume()) {
return `
<div class="max-w-3xl mx-auto">
<div class="feature-card p-8 text-center">
<div class="w-16 h-16 mx-auto mb-4 rounded-full bg-[#FFF7E6] flex items-center justify-center">
<svg class="w-8 h-8 text-[#FF7D00]" data-lucide="alert-circle"></svg>
</div>
<h3 class="text-xl font-bold text-[#1D2129] mb-2">请先上传简历</h3>
<p class="text-[#86909C] mb-6">衔接知识点需要先完成简历分析。</p>
<button class="btn-primary py-2.5 px-6" onclick="switchPage('student-resume')">去上传简历</button>
</div>
</div>`;
function escapeKnowledgeText(s) {
return String(s).replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;');
}
function getNextKnowledgeItem(list, id) {
for (var i = 0; i < list.length - 1; i++) {
if (list[i].id === id) return list[i + 1];
}
var activeId = studentState.bridgeActiveId || BRIDGE_KNOWLEDGE[0].id;
var item = getBridgeKnowledge(activeId);
var readCount = getBridgeReadIds().length;
var percent = Math.round((readCount / BRIDGE_KNOWLEDGE.length) * 100);
var tree = BRIDGE_KNOWLEDGE.map(function(k) {
var read = isBridgeKnowledgeRead(k.id);
return null;
}
function renderKnowledgeTable(rows) {
if (!rows || rows.length < 2) return '';
var th = rows[0].map(function(c) {
return '<th class="text-left text-xs font-medium text-[#86909C] px-3 py-2 bg-[#F7F8FA] border-b border-[#E5E6EB]">' + c + '</th>';
}).join('');
var tr = rows.slice(1).map(function(row) {
return '<tr>' + row.map(function(c, i) {
return '<td class="text-sm text-[#4E5969] px-3 py-2.5 border-b border-[#E5E6EB] align-top' + (i === 0 ? ' font-medium text-[#1D2129] whitespace-nowrap' : '') + '">' + c + '</td>';
}).join('') + '</tr>';
}).join('');
return '<div class="overflow-x-auto rounded-lg border border-[#E5E6EB] mb-4"><table class="w-full">' + '<thead><tr>' + th + '</tr></thead><tbody>' + tr + '</tbody></table></div>';
}
function renderPrdKnowledgePreview(opts) {
var list = opts.list;
var item = opts.item;
var isReadFn = opts.isReadFn;
var readCount = 0;
for (var i = 0; i < list.length; i++) if (isReadFn(list[i].id)) readCount++;
var percent = Math.round((readCount / list.length) * 100);
var isRead = isReadFn(item.id);
var next = getNextKnowledgeItem(list, item.id);
var tree = list.map(function(k, idx) {
var read = isReadFn(k.id);
var active = k.id === item.id;
return `
<button class="w-full text-left px-3 py-2.5 rounded-lg mb-1 ` + (active ? 'bg-[#E8F3FF] text-[#165DFF]' : 'hover:bg-[#F7F8FA] text-[#4E5969]') + `" onclick="studentState.bridgeActiveId='` + k.id + `';renderContent();">
<div class="flex items-center justify-between">
<span class="text-sm font-medium">` + k.title + `</span>
<span class="text-[10px] ` + (read ? 'text-emerald-600' : 'text-[#FF7D00]') + `">` + (read ? '已读' : '未读') + `</span>
</div>
</button>`;
return '<button class="w-full text-left px-3 py-2.5 rounded-lg mb-1 ' + (active ? 'bg-[#E8F3FF] text-[#165DFF]' : 'hover:bg-[#F7F8FA] text-[#4E5969]') + '" onclick="studentState.' + opts.activeKey + '=\'' + k.id + '\';renderContent();">' +
'<div class="flex items-start justify-between gap-2">' +
'<div><div class="text-sm font-medium">' + (idx + 1) + '. ' + k.title + '</div><div class="text-[10px] mt-0.5 ' + (active ? 'text-[#165DFF]/70' : 'text-[#86909C]') + '">' + k.duration + '</div></div>' +
'<span class="text-[10px] flex-shrink-0 mt-0.5 ' + (read ? 'text-emerald-600' : 'text-[#FF7D00]') + '">' + (read ? '已读' : '未读') + '</span>' +
'</div></button>';
}).join('');
var graph = '<div class="flex items-start">' + list.map(function(k, idx) {
var read = isReadFn(k.id);
var active = k.id === item.id;
var dot = read ? 'bg-emerald-500' : (active ? 'bg-[#165DFF] ring-4 ring-[#165DFF]/15' : 'bg-[#E5E6EB]');
var text = read ? 'text-emerald-600' : (active ? 'text-[#165DFF] font-medium' : 'text-[#C9CDD4]');
var line = idx < list.length - 1 ? '<div class="flex-1 h-px mt-1.5 mx-2 ' + (read ? 'bg-emerald-200' : 'bg-[#E5E6EB]') + '"></div>' : '';
return '<div class="flex items-start ' + (idx < list.length - 1 ? 'flex-1 min-w-0' : '') + '">' +
'<button class="flex flex-col items-center flex-shrink-0" onclick="studentState.' + opts.activeKey + '=\'' + k.id + '\';renderContent();">' +
'<div class="w-2.5 h-2.5 rounded-full ' + dot + '"></div>' +
'<div class="text-[10px] mt-2 text-center leading-tight max-w-[4.5rem] ' + text + '">' + k.title + '</div>' +
'</button>' + line + '</div>';
}).join('') + '</div>';
var goals = (item.goals || []).map(function(g) {
return '<div class="flex items-start gap-2 text-sm text-[#4E5969] mb-2"><svg class="w-4 h-4 text-[#165DFF] mt-0.5 flex-shrink-0" data-lucide="check-circle"></svg><span>' + g + '</span></div>';
}).join('');
var sections = (item.sections || []).map(function(sec) {
var paras = (sec.paragraphs || []).map(function(p) {
return '<p class="text-sm text-[#4E5969] leading-relaxed mb-3">' + p + '</p>';
}).join('');
var lis = sec.list ? '<ul class="space-y-2 mb-4">' + sec.list.map(function(li) {
return '<li class="flex items-start gap-2 text-sm text-[#4E5969] leading-relaxed"><span class="w-1.5 h-1.5 rounded-full bg-[#165DFF] mt-2 flex-shrink-0"></span><span>' + li + '</span></li>';
}).join('') + '</ul>' : '';
var code = sec.code
? '<pre class="bg-[#1D2129] text-[#E5E6EB] text-xs leading-relaxed rounded-lg p-4 mb-4 overflow-x-auto"><code>' + escapeKnowledgeText(sec.code) + '</code></pre>'
: '';
return '<div class="mb-2">' +
'<h3 class="font-semibold text-[#1D2129] mb-3 flex items-center gap-2"><span class="w-1.5 h-4 rounded bg-[#165DFF]"></span>' + sec.heading + '</h3>' +
paras + lis + renderKnowledgeTable(sec.table) + code +
'</div>';
}).join('');
var materials = (item.materials || []).map(function(m) {
return '<div class="flex items-center gap-2 text-sm text-[#4E5969] py-1.5"><svg class="w-3.5 h-3.5 text-[#00B42A] flex-shrink-0" data-lucide="link"></svg><span>' + m.name + '</span><span class="text-[10px] text-[#86909C]">' + m.kind + '</span></div>';
}).join('');
var takeaways = (item.takeaways || []).map(function(t) {
return '<li class="text-sm text-[#4E5969] mb-1.5">· ' + t + '</li>';
}).join('');
var body = item.body.map(function(p) { return '<p class="text-sm text-[#4E5969] leading-relaxed mb-3">' + p + '</p>'; }).join('');
var actions = '';
if (!isRead) {
actions = '<button class="btn-primary py-2.5 px-5" onclick="' + opts.markFn + '(\'' + item.id + '\')">标记本节已读</button>';
} else if (next) {
actions = '<button class="btn-primary py-2.5 px-5" onclick="studentState.' + opts.activeKey + '=\'' + next.id + '\';renderContent();">下一节:' + next.title + '</button>' +
'<button class="btn-outline py-2.5 px-5" onclick="' + opts.quizFn + '()">' + opts.quizLabel + '</button>';
} else {
actions = '<button class="btn-primary py-2.5 px-5" onclick="' + opts.quizFn + '()">' + opts.quizLabel + '</button>';
}
return `
<div class="max-w-7xl mx-auto">
......@@ -701,48 +942,107 @@ pageRenderers["student-bridge-preview"] = function() {
<svg class="w-5 h-5 text-[#86909C]" data-lucide="arrow-left"></svg>
</button>
<div class="w-10 h-10 rounded-lg bg-gradient-to-br from-[#165DFF] to-[#4080FF] flex items-center justify-center">
<svg class="w-5 h-5 text-white" data-lucide="book-open"></svg>
<svg class="w-5 h-5 text-white" data-lucide="` + opts.icon + `"></svg>
</div>
<div>
<h1 class="text-2xl font-bold text-[#1D2129]">衔接知识点预习</h1>
<p class="text-sm text-[#86909C]">阶段一 · 无实操、无答辩。学完后参加 70 分测验。</p>
<h1 class="text-2xl font-bold text-[#1D2129]">` + opts.pageTitle + `</h1>
<p class="text-sm text-[#86909C]">` + opts.pageDesc + `</p>
</div>
</div>
<button class="btn-primary py-2.5 px-5" onclick="startBridgeQuiz()">开始衔接测验</button>
<button class="btn-primary py-2.5 px-5" onclick="` + opts.quizFn + `()">` + opts.quizLabel + `</button>
</div>
<div class="bg-white rounded-lg shadow-sm border border-[#E5E6EB] p-4 mb-6">
<div class="flex items-center justify-between mb-2">
<span class="text-sm text-[#86909C]">阅读进度</span>
<span class="text-sm font-medium text-[#165DFF]">` + readCount + ` / ` + BRIDGE_KNOWLEDGE.length + ` · ` + percent + `%</span>
` + (opts.bannerHtml || '') + `
<div class="bg-white rounded-lg shadow-sm border border-[#E5E6EB] p-5 mb-6">
<div class="flex items-center justify-between mb-4">
<div class="flex items-center gap-2">
<svg class="w-4 h-4 text-[#165DFF]" data-lucide="git-branch"></svg>
<span class="text-sm font-semibold text-[#1D2129]">知识点学习顺序</span>
</div>
<span class="text-sm font-medium text-[#165DFF]">` + readCount + ` / ` + list.length + ` · ` + percent + `%</span>
</div>
<div class="progress-bar h-2"><div class="fill" style="width:` + percent + `%"></div></div>
<div class="progress-bar h-2 mb-4"><div class="fill" style="width:` + percent + `%"></div></div>
` + graph + `
</div>
<div class="flex gap-6">
<div class="w-72 flex-shrink-0">
<div class="flex gap-6 items-start">
<div class="w-72 flex-shrink-0 sticky top-4">
<div class="bg-white rounded-lg shadow-sm border border-[#E5E6EB] p-4">
<div class="text-xs text-[#86909C] mb-2">知识点目录</div>
` + tree + `
<p class="text-[10px] text-[#C9CDD4] mt-3 leading-relaxed">点目录切换章节。正文在右侧,含目标、材料、命令/流程示例。</p>
</div>
</div>
<div class="flex-1 bg-white rounded-lg shadow-sm border border-[#E5E6EB] p-6">
<div class="flex items-start justify-between mb-4">
<div>
<h2 class="text-xl font-bold text-[#1D2129] mb-1">` + item.title + `</h2>
<p class="text-sm text-[#86909C]">预计 ` + item.duration + ` · ` + item.summary + `</p>
<div class="flex-1 min-w-0 space-y-4">
<div class="bg-white rounded-lg shadow-sm border border-[#E5E6EB] p-6">
<div class="flex items-start justify-between mb-4">
<div>
<h2 class="text-xl font-bold text-[#1D2129] mb-1">` + item.title + `</h2>
<p class="text-sm text-[#86909C]">` + item.summary + `</p>
</div>
` + (isRead ? '<span class="px-2 py-1 rounded text-xs bg-emerald-100 text-emerald-700 flex-shrink-0">已读</span>' : '<span class="px-2 py-1 rounded text-xs bg-[#FFF7E6] text-[#FF7D00] flex-shrink-0">学习中</span>') + `
</div>
<div class="flex flex-wrap gap-2 mb-5">
<span class="px-2 py-0.5 rounded text-xs bg-[#E8F3FF] text-[#165DFF]">预计 ` + item.duration + `</span>
<span class="px-2 py-0.5 rounded text-xs bg-[#F7F8FA] text-[#4E5969]">` + (item.level || '基础') + `</span>
</div>
<div class="grid grid-cols-2 gap-4 mb-6">
<div class="rounded-lg bg-[#E8F3FF]/60 border border-[#165DFF]/15 p-4">
<div class="text-xs font-semibold text-[#165DFF] mb-2">学习目标</div>
` + goals + `
</div>
<div class="rounded-lg bg-[#F7F8FA] border border-[#E5E6EB] p-4">
<div class="text-xs font-semibold text-[#1D2129] mb-2">前置要求</div>
<p class="text-sm text-[#4E5969] leading-relaxed mb-3">` + (item.prereq || '无') + `</p>
<div class="text-xs font-semibold text-[#1D2129] mb-1">预计时长</div>
<p class="text-sm text-[#4E5969]">` + item.duration + `</p>
</div>
</div>
` + sections + `
<div class="border-t border-[#E5E6EB] pt-4 mt-2">
<div class="font-medium text-[#1D2129] mb-2 flex items-center gap-2">
<svg class="w-4 h-4 text-[#165DFF]" data-lucide="file-text"></svg>
预习材料
</div>
<div class="pl-1">` + materials + `</div>
</div>
` + (isBridgeKnowledgeRead(item.id) ? '<span class="px-2 py-1 rounded text-xs bg-emerald-100 text-emerald-700">已读</span>' : '') + `
</div>
` + body + `
<div class="mt-6 pt-4 border-t border-[#E5E6EB]">
` + (isBridgeKnowledgeRead(item.id)
? '<button class="btn-outline py-2 px-4" onclick="startBridgeQuiz()">去参加测验</button>'
: '<button class="btn-primary py-2 px-4" onclick="markBridgeKnowledgeRead(\'' + item.id + '\')">标记为已读</button>') + `
<div class="bg-white rounded-lg shadow-sm border border-[#E5E6EB] p-5">
<div class="text-sm font-semibold text-[#1D2129] mb-2">本节要点</div>
<ul class="mb-5">` + takeaways + `</ul>
<div class="flex flex-wrap gap-3">` + actions + `</div>
</div>
</div>
</div>
</div>`;
}
pageRenderers["student-bridge-preview"] = function() {
if (!hasStudentResume()) {
return `
<div class="max-w-3xl mx-auto">
<div class="feature-card p-8 text-center">
<div class="w-16 h-16 mx-auto mb-4 rounded-full bg-[#FFF7E6] flex items-center justify-center">
<svg class="w-8 h-8 text-[#FF7D00]" data-lucide="alert-circle"></svg>
</div>
<h3 class="text-xl font-bold text-[#1D2129] mb-2">请先上传简历</h3>
<p class="text-[#86909C] mb-6">衔接知识点需要先完成简历分析。</p>
<button class="btn-primary py-2.5 px-6" onclick="switchPage('student-resume')">去上传简历</button>
</div>
</div>`;
}
var activeId = studentState.bridgeActiveId || BRIDGE_KNOWLEDGE[0].id;
var item = getBridgeKnowledge(activeId);
return renderPrdKnowledgePreview({
pageTitle: '衔接知识点预习',
pageDesc: '阶段一 · 无实操、无答辩。按目录阅读右侧材料,学完后参加 70 分测验。',
icon: 'book-open',
list: BRIDGE_KNOWLEDGE,
item: item,
isReadFn: isBridgeKnowledgeRead,
activeKey: 'bridgeActiveId',
markFn: 'markBridgeKnowledgeRead',
quizFn: 'startBridgeQuiz',
quizLabel: '开始衔接测验'
});
};
pageRenderers["student-bridge-quiz"] = function() {
......@@ -862,48 +1162,201 @@ var DEPLOY_KNOWLEDGE = [
id: 'infer-flow',
title: '推理服务部署流程',
duration: '45 分钟',
level: '阶段任务',
summary: '从拉起模型到对外提供 HTTP 推理接口。',
body: [
'本阶段任务由系统直接下发,不经过选题。当前任务:Qwen2.5-7B 推理服务部署。',
'学习目标:能按顺序完成环境准备、启动推理进程、健康检查、登记 API。',
'标准路径:检查 GPU 与依赖 → 启动服务 → 访问 /health 或等价探针 → 用示例请求验证返回 → 记录地址/路径/端口。',
'阶段二产物不是 Git 仓库,而是日志包 + API 信息,供导师探测验收。'
prereq: '已通过阶段一衔接测验。系统已下发任务,无需选题。',
goals: [
'能按顺序完成:环境检查 → 启动服务 → 健康检查 → 示例请求 → 登记 API',
'说清阶段二产物是日志包 + API,不是 Git 仓库',
'知道导师会按你登记的地址做探测'
],
sections: [
{
heading: '当前任务(系统已下发)',
paragraphs: [
'任务名称:Qwen2.5-7B 推理服务部署。本阶段没有 AI 推荐、没有项目大厅。你要在 AutoDL 上把推理进程跑起来,并让导师能用 HTTP 调到。'
]
},
{
heading: '推荐落地顺序',
list: [
'登录 AutoDL,确认 GPU 可见(nvidia-smi),确认工作目录里有启动脚本和权重。',
'按项目说明安装依赖,激活环境后再启动,不要用系统 Python 直接跑。',
'启动后立刻看日志:是否在监听端口、有没有 CUDA / OOM / Address already in use。',
'访问健康检查(如 GET /health)。不通就不要先去写报告。',
'用一条最小请求验证真正的推理接口有返回。',
'记下地址、路径、端口,准备导出启动日志包。'
],
code: '# 示意:启动后自测\ncurl -s http://127.0.0.1:8000/health\ncurl -s http://127.0.0.1:8000/v1/chat/completions \\\n -H "Content-Type: application/json" \\\n -d \'{"model":"qwen","messages":[{"role":"user","content":"ping"}]}\''
},
{
heading: '怎样才算这一步完成',
paragraphs: [
'进程在跑、端口在听、健康检查通过、示例请求有结果。然后把日志包和 API 信息交到「部署产物提交」页。不要把仓库地址交到旧的实操提交区。'
]
}
],
materials: [
{ name: 'Qwen 推理服务启动说明(任务附带)', kind: '任务文档' },
{ name: '健康检查与最小请求示例', kind: '文档' },
{ name: '产物清单:日志包 + API 地址/路径/端口', kind: '清单' }
],
takeaways: [
'先健康检查,再登记 API',
'产物 = 日志 + API,不是 Git',
'启动失败先看日志,不要先申请答辩'
]
},
{
id: 'autodl-ssh',
title: 'AutoDL 环境与 SSH',
duration: '40 分钟',
level: '阶段任务',
summary: '分清沙箱和 AutoDL,知道配置从哪里来。',
body: [
'平台沙箱只做基础开发与排障练习,不要把大模型本体部署进沙箱。',
'重 GPU 任务走 AutoDL。服务器由导师下发,学生页只读,可测试连通、复制 ssh 命令。',
'登录后先确认工作目录、GPU 可见性和端口占用,再启动推理服务。',
'配置变更只能找导师,学生不能自行改 IP / 端口 / 账号。'
prereq: '导师会下发服务器信息;学生页只读。',
goals: [
'能说明沙箱和 AutoDL 各自干什么、不能干什么',
'知道配置由导师下发,学生只能测连通和复制 ssh',
'登录后先检查目录、GPU、端口,再启动服务'
],
sections: [
{
heading: '两条环境,不要用错',
table: [
['环境', '用来做什么', '不要做什么'],
['平台沙箱', '基础开发、改脚本、练命令', '加载大模型本体、当验收环境'],
['AutoDL GPU', '部署 / 推理 / 重计算', '学生私自改 IP、端口、账号']
]
},
{
heading: '配置权在导师',
paragraphs: [
'学生 AutoDL 页是只读的:可以看到脱敏后的主机、端口、用户名,可以点「测试连接」,可以复制 ssh 命令。机器规格或登录失败,去找导师改配置,不要在学生页硬改。'
],
code: 'ssh -p 22 账号@主机地址\n# 登录后建议先做:\npwd\nnvidia-smi\nls -lh'
},
{
heading: '登录后的检查清单',
list: [
'当前目录对不对,启动脚本在不在',
'nvidia-smi 能否看到 GPU,显存是否已被占用',
'任务要求的端口有没有被其它进程占用',
'再启动推理服务,并打开日志跟踪'
]
}
],
materials: [
{ name: '学生 AutoDL 只读页操作说明', kind: '文档' },
{ name: 'SSH 登录与 GPU 自检步骤', kind: '文档' },
{ name: '配置异常时如何联系导师', kind: '说明' }
],
takeaways: [
'大模型不进沙箱',
'配置只读,测连通 + 复制 ssh',
'先 GPU / 目录 / 端口,后启动'
]
},
{
id: 'deploy-log',
title: '日志包与常见排障',
duration: '35 分钟',
level: '阶段任务',
summary: 'AutoDL 日志需自行导出上传,沙箱日志由平台采集。',
body: [
'MVP 阶段 AutoDL 日志不会自动采集,需要你导出 .log / .txt 日志包一并提交。',
'日志里应能看到启动命令、监听端口、健康检查结果,以及关键报错栈。',
'常见问题:CUDA 与驱动不匹配、端口未放行、依赖缺失、显存不足导致进程退出。',
'导师验收会抽检日志是否与你提交的 API 地址一致。'
prereq: '已能启动或尝试启动推理进程。',
goals: [
'知道 MVP 阶段 AutoDL 日志不会自动采集,必须自己导出',
'日志里应包含启动命令、监听端口、健康检查和关键报错',
'能根据典型报错判断是环境、端口还是显存问题'
],
sections: [
{
heading: '为什么一定要交日志包',
paragraphs: [
'沙箱日志可以由平台采集;AutoDL 在 MVP 不做自动采集。导师看不到你机器上的终端,只能靠你上传的 .log / .txt 判断服务是怎么起来的、为什么探测失败。'
]
},
{
heading: '日志里至少要有这些',
list: [
'启动命令或启动脚本名',
'监听地址和端口(例如 0.0.0.0:8000)',
'模型加载完成 / 进入 listening 的语句',
'健康检查或第一条请求的结果',
'若失败:完整 Traceback,不要只截最后一行'
],
code: 'tail -n 200 /root/infer.log > qwen-startup.log\n# 提交前自己搜一遍:\ngrep -i "error\\|traceback\\|oom\\|listen" qwen-startup.log'
},
{
heading: '常见失败怎么对',
table: [
['现象', '优先原因'],
['导师探测超时', '进程没起来、端口没放行、填了内网地址'],
['CUDA error / driver mismatch', '镜像里的 torch 与驱动不匹配'],
['CUDA out of memory', '显存不够或有残留进程'],
['Address already in use', '端口被旧进程占用'],
['ModuleNotFoundError', '没激活环境或没装依赖']
]
}
],
materials: [
{ name: '日志包导出约定(.log / .txt)', kind: '规范' },
{ name: '启动成功日志样例', kind: '样例' },
{ name: '排障对照表', kind: '文档' }
],
takeaways: [
'AutoDL 日志靠你导出,平台不会自动采',
'日志要能对上你填的端口和 API',
'OOM / 端口占用 / 依赖缺失是前三名'
]
},
{
id: 'api-accept',
title: 'API 回传与验收标准',
duration: '40 分钟',
level: '阶段任务',
summary: '导师用探测和 API 调用决定是否通过。',
body: [
'提交时填写 API 地址、请求路径、端口,必要时补充请求示例。',
'大模型推理类任务:导师会实际调用接口,检查连通和返回是否可用。',
'提交成功后仍需撰写实操报告;产物检查通过后才解锁答辩,不是交完就能答辩。',
'被驳回可以按评语修改后重提日志包和 API,旧的仓库提交页不会用于本阶段。'
prereq: '服务已能在本机 curl 通。',
goals: [
'能正确填写 API 地址、请求路径、端口',
'理解导师会实际调用接口,通了才算验收通过',
'知道交完产物还要写报告,验收通过后才解锁答辩'
],
sections: [
{
heading: '提交页要填什么',
table: [
['字段', '示例', '注意'],
['API 地址', 'http://x.x.x.x', '导师从外网能访问的地址,不要填 127.0.0.1 交差'],
['路径', '/v1/chat/completions', '和你实际启动的路由一致'],
['端口', '8000', '和日志里 listen 的端口一致'],
['日志包', 'qwen-startup.log', '含启动与报错,不要空文件']
]
},
{
heading: '导师怎么验收',
list: [
'探测:端口是否开放、健康检查是否 200。',
'API 调用:按大模型任务发一条真实请求,看返回是否可用。',
'日志抽检:启动命令、端口、报错是否和你填的信息一致。',
'通过后才解锁答辩;驳回后按评语改完可以重提。旧「实操评审」不用于本阶段。'
]
},
{
heading: '提交之后还有报告',
paragraphs: [
'产物提交成功会引导你去写实操报告(两条路径共用报告页)。报告里写清部署方式、API、排障和自测。没有「交完仓库就算过」这条捷径。'
]
}
],
materials: [
{ name: 'API 字段填写说明', kind: '文档' },
{ name: '导师探测与调用规则', kind: '规则' },
{ name: '驳回后重提说明', kind: '说明' }
],
takeaways: [
'地址 / 路径 / 端口必须和日志一致',
'答辩锁在部署验收,不锁在旧实操评审',
'提交成功 → 写报告 → 等验收'
]
}
];
......@@ -1013,77 +1466,19 @@ pageRenderers["student-deploy-preview"] = function() {
}
var activeId = studentState.deployActiveId || DEPLOY_KNOWLEDGE[0].id;
var item = getDeployKnowledge(activeId);
var readCount = getDeployReadIds().length;
var percent = Math.round((readCount / DEPLOY_KNOWLEDGE.length) * 100);
var tree = DEPLOY_KNOWLEDGE.map(function(k) {
var read = isDeployKnowledgeRead(k.id);
var active = k.id === item.id;
return `
<button class="w-full text-left px-3 py-2.5 rounded-lg mb-1 ` + (active ? 'bg-[#E8F3FF] text-[#165DFF]' : 'hover:bg-[#F7F8FA] text-[#4E5969]') + `" onclick="studentState.deployActiveId='` + k.id + `';renderContent();">
<div class="flex items-center justify-between">
<span class="text-sm font-medium">` + k.title + `</span>
<span class="text-[10px] ` + (read ? 'text-emerald-600' : 'text-[#FF7D00]') + `">` + (read ? '已读' : '未读') + `</span>
</div>
</button>`;
}).join('');
var body = item.body.map(function(p) { return '<p class="text-sm text-[#4E5969] leading-relaxed mb-3">' + p + '</p>'; }).join('');
return `
<div class="max-w-7xl mx-auto">
<div class="flex items-center justify-between mb-6">
<div class="flex items-center gap-4">
<button class="btn-ghost p-2 rounded-lg hover:bg-[#F2F3F5]" onclick="switchPage('student-dashboard')">
<svg class="w-5 h-5 text-[#86909C]" data-lucide="arrow-left"></svg>
</button>
<div class="w-10 h-10 rounded-lg bg-gradient-to-br from-[#165DFF] to-[#4080FF] flex items-center justify-center">
<svg class="w-5 h-5 text-white" data-lucide="cpu"></svg>
</div>
<div>
<h1 class="text-2xl font-bold text-[#1D2129]">部署知识点预习</h1>
<p class="text-sm text-[#86909C]">阶段二 · 系统已下发任务,无需选题。学完后参加 80 分小测。</p>
</div>
</div>
<button class="btn-primary py-2.5 px-5" onclick="startDeployQuiz()">开始章节小测</button>
</div>
<div class="bg-[#E8F3FF] border border-[#165DFF]/20 rounded-lg p-4 mb-6">
<div class="text-xs text-[#86909C] mb-1">系统已下发部署任务</div>
<div class="text-base font-semibold text-[#1D2129] mb-1">` + DEPLOY_TASK.name + `</div>
<div class="text-sm text-[#4E5969]">` + DEPLOY_TASK.goal + ` · ` + DEPLOY_TASK.env + `</div>
</div>
<div class="bg-white rounded-lg shadow-sm border border-[#E5E6EB] p-4 mb-6">
<div class="flex items-center justify-between mb-2">
<span class="text-sm text-[#86909C]">阅读进度</span>
<span class="text-sm font-medium text-[#165DFF]">` + readCount + ` / ` + DEPLOY_KNOWLEDGE.length + ` · ` + percent + `%</span>
</div>
<div class="progress-bar h-2"><div class="fill" style="width:` + percent + `%"></div></div>
</div>
<div class="flex gap-6">
<div class="w-72 flex-shrink-0">
<div class="bg-white rounded-lg shadow-sm border border-[#E5E6EB] p-4">
<div class="text-xs text-[#86909C] mb-2">知识点目录</div>
` + tree + `
</div>
</div>
<div class="flex-1 bg-white rounded-lg shadow-sm border border-[#E5E6EB] p-6">
<div class="flex items-start justify-between mb-4">
<div>
<h2 class="text-xl font-bold text-[#1D2129] mb-1">` + item.title + `</h2>
<p class="text-sm text-[#86909C]">预计 ` + item.duration + ` · ` + item.summary + `</p>
</div>
` + (isDeployKnowledgeRead(item.id) ? '<span class="px-2 py-1 rounded text-xs bg-emerald-100 text-emerald-700">已读</span>' : '') + `
</div>
` + body + `
<div class="mt-6 pt-4 border-t border-[#E5E6EB]">
` + (isDeployKnowledgeRead(item.id)
? '<button class="btn-outline py-2 px-4" onclick="startDeployQuiz()">去参加小测</button>'
: '<button class="btn-primary py-2 px-4" onclick="markDeployKnowledgeRead(\'' + item.id + '\')">标记为已读</button>') + `
</div>
</div>
</div>
</div>`;
return renderPrdKnowledgePreview({
pageTitle: '部署知识点预习',
pageDesc: '阶段二 · 系统已下发任务,无需选题。按目录阅读右侧材料,学完后参加 80 分小测。',
icon: 'cpu',
list: DEPLOY_KNOWLEDGE,
item: item,
isReadFn: isDeployKnowledgeRead,
activeKey: 'deployActiveId',
markFn: 'markDeployKnowledgeRead',
quizFn: 'startDeployQuiz',
quizLabel: '开始章节小测',
bannerHtml: '<div class="bg-[#E8F3FF] border border-[#165DFF]/20 rounded-lg p-4 mb-6"><div class="text-xs text-[#86909C] mb-1">系统已下发部署任务</div><div class="text-base font-semibold text-[#1D2129] mb-1">' + DEPLOY_TASK.name + '</div><div class="text-sm text-[#4E5969]">' + DEPLOY_TASK.goal + ' · ' + DEPLOY_TASK.env + '</div></div>'
});
};
pageRenderers["student-deploy-quiz"] = function() {
......
Markdown 格式
0% 或
您添加了 0 人 到此讨论。请谨慎行事。
请先完成此评论的编辑!
请 注册 或者 后发表评论