← 返回列表

00-今日改进总结与经验沉淀.md

00 今日改进总结与经验沉淀（2026-09-09/10 联合打磨记录）

对象：软件项目管理第 1 章课件（HTML 仿 PPT）＋教学包 v2.0 产出物目录：dl-hub/22-软件项目管理教学包/课件成品-HTML/软件项目管理-16周课件/ 云端：http://111.231.0.226:1234/ （腾讯云 111.231.0.226，端口 1234，systemd spm-web） 本文件提取出可复用的模板（见本目录 01–06 模板文件与"引用文件"），供后续章节、其他课程直接套用。

一、今天做了什么（回顾时间线）

  1. 教学包 v2.0 口径重校：按广东金融学院学校文档把 64 学时/4 学分假设修正为 32 学时/2 学分/纯理论，考核改为平时 30（作业20＋课堂10）＋期末 70，章节学时分法对齐学校进度表，实验与综合项目转课外。
  2. 课件工程化：仿《第八章生成式人工智能》HTML 模板做出第 1 章课件 → 重构为课程主页（16 次大课卡片）＋次课分页结构 → 第 1 次课从 20+ 页充实到 52 页（约 90 分钟），其余 15 课占位"未开放观看"。
  3. 云端发布：打包上传腾讯云，systemd 静态服务端口 1234，配合安全组放行；建立一键更新流程。
  4. 十三轮打磨（详见第二节意见清单）：内容故事化、正反例、失败案例对比、交互化、字号下限、SVG 制图、拆页、口径清理、作业渠道等。

二、全部改进意见清单（含处理结果）

A. 结构与导航

#反馈处理
A1首页应是课程主页，按教学安排分次大课首页＝软件项目管理 16 张大课卡片（依《02-教学日历》），每次课独立 lectureN/ 分页
A2未制作的课不要写"制作中"占位页只显示"未开放观看＋返回主页按钮"，首页卡片标"🔒 未开放观看"
A3授课教师信息上每次课首页课程主页、第 1 次课封面/目录、占位页统一显示"授课教师：周宇文 ｜ 电话/微信"
A4页数变化要同步插入/拆分页后：总页数断言、TOC 分组、首页卡片、交叉引用页号（如"第 1.20 页→1.21"）全部重算

B. 内容与表达

#反馈处理
B1案例背景内容太少、缺故事性改为故事弧：风暴→处境→回应→目标（三层次）→结局（1.6）
B2加失败案例对比新增 IBM OS/360、微软 Vista、苹果 Newton/Lisa 对比页（1.10），形成"成败对照"
B35 大特征各举正反例每个特征配 ✓ 正面例子＋✗ 反面例子（缺了这项会怎样）（1.13）
B4软件项目 3 特点也举例子同上，正反例对照表（1.15）
B5五要素怎么配合举正面例子用"校园选课系统"贯穿示例列（1.32）
B6表 1-2 分两页太散合并为一页全表（字号微调），腾出的一页做"怎么读：一行知识域的旅程"讲解页
B7练习题一页放不下一题一页（选择题每题 1 页）；填空题把题干空白放上来再揭晓
B8填空缺已知项没法答题干改为补全式：给出已知项＋空（如"启动、＿＿、执行、＿＿、收尾"）
B9作业改为学习通发布作业页＝学习通考试题库·必做（含简答开放题），并同步《07 考核方案》与《00 总览》
B10"不计学时学分"是废话删除（32 学时课程本无独立学分口径）
B11每章案例/知识点要有生活化例子用"小组课程设计""校园选课系统"等学生熟悉场景类比

C. 交互（学生可操作）

#反馈处理
C1选择题/速判应可选对也可选错全部改造为可点选：选对绿✓锁定＋解析；选错红✗提示可继续，可"重新作答"；可多选（破冰题）
C2提问/思考不要直接给答案提问页统一"先思考→揭晓按钮"（案例思考、选型、绩效域、填空、鸿蒙选型等）
C3可交互的载体styles.css 加 quiz 样式块＋独立 quiz.js（判分/揭晓/重置），生成器自动注入

D. 视觉与投影

#反馈处理
D1拔下来的图太小图片统一放大：证书类 400/360px，框架图 780px（约 2 倍），封面 260px
D2字号太小、投影看不清单页放映模式字号下限：正文 2.1rem、选项 2.0rem、按钮 1.7rem、表格 1.75rem、标签 1.35rem
D3小结页文字堆叠难看改 SVG 流程图（项目→软件项目→软件项目管理→五要素）
D4分区页"全书地图在此展开"口吻差改为 SVG 五要素关系图（价值交付系统居中＋四要素环绕连线）
D5连线太短、标签被色块压住左右节点外移、中间收窄，连线 30px→70px，标签居中于空隙
D6大图＋文字布局"左大图（55%）＋右要点卡片（42%）＋底部引述"三段式
D7左上 logo 看不清logo 加白底圆角（background:#fff;border-radius:6px）

E. 口径与"AI 味"清理（重要）

#反馈处理
E1"教材与 PMBOK 一致是八大（不是九大）——别记错"是重大错误整句删除（修订批注口吻，且"别记错/不是九大"是编辑痕迹）
E2图片 caption 的加工来源"沿用学校课件图片/此处沿用/正式印刷请以教材为准"→ 中性图注"教材图 1-1"
E3标题括号批注"案例思考（教材原问，先写黑板）""失败 9 大原因（教材原文）"等 → 去掉括号批注
E4课堂操作提示"（可举手表决）""（先口答，再揭晓）""课堂动作：请先写下""🗣 互动/开放讨论"→ 中性问句"💡 想一想/猜一猜/请判断"
E5出处与内部编号外露"（原题出自教材…）""《06 综合小组项目实施方案》""（教材数据）""（呼应 1.3.1…）"→ 删除或改自然表述
E6"全书都是这句话的展开"改为课程主线表述："本课程的主线：第 2 章启动→第 3–10 章知识域→第 16 周整合与复习"
E7"教材开篇案例/贯穿 1.1 与 1.2 全都能对上号"改为干净引导语"带着这个问题，开始今天的学习"
E8教师名学校报备文件写"潘琪"，实际授课"周宇文"——以教师确认为准并全站统一

F. 部署与运维

#反馈/事件处理
F180 被备课平台占用课件用独立端口 1234；systemd spm-web 静态服务（开机自启＋崩溃重启）
F2公网不通服务端监听正常但安全组未放行→用户放行 TCP 1234 后 200
F3更新课件本地 python3 _build.py → tar → scp → 解压覆盖 → systemctl restart spm-web（见《06 模板》）

三、经验与收获（可迁移原则）

  1. 学生页面只放"学生该看的内容"：杜绝教学批注、出处注、课堂操作提示、内部文档编号、版本痕迹、AI 腔。发布前过一遍"禁词清单"（见《05 模板》）。
  2. 能交互就不直接给答案：判断/选择/填空/思考四类题型全部做成"点选判分"或"揭晓按钮"；揭晓内容用 data-action="reveal" 隐藏，点击才显示。
  3. 投影要有字号下限：正文 ≥2.1rem；选项/按钮 ≥1.7–2.0rem；密页拆页，选择题一题一页。
  4. 填空题题干必须补全已知项（"启动、＿＿、执行、＿＿、收尾"），否则学生无法作答。
  5. 概念配正反例（✓ 正面＋✗ 反面"缺了这项会怎样"）显著降低理解门槛；复杂关系用贯穿示例（选课系统、小组课程设计）。
  6. 讲故事：案例按"冲突→处境→回应→目标→结局"组织；再配一个失败案例做对照，说服力更强。
  7. 图优先、字精简：能用 SVG 就画 SVG；大图与文字用"左图右要点＋底部引述"布局；画完检查连线长度与标签是否被色块遮挡。
  8. 页码是全局状态：插入/拆分页后必须重算总页数、TOC 分组、首页卡片、交叉引用，不能只改一处。
  9. 口径有唯一事实源：学校文档（大纲/进度表/考核方案）> 教师实际安排 > 模板默认值；文档之间打架时（如考核方案 30/70 vs 大纲正文 10/10/80）要显式标注让教师定夺，不要自作主张。
  10. 工程化与记录：_build.py 一键重建、版本沿革文件（_沿革与待办.md）防口径回退、_素材/ 预抽取学校 PPT 文本与图片供后续章节使用。
  11. 云发布流水线：tar→scp→systemd restart + 安全组放行；更新流程固化到记录文件，避免每次重查。

四、遗留待办（教师侧）

下载此文件