更新日志
V4.0-1014.3 2026-10-14
更新 智能体安装方式改为「把技能包当附件发给 AI 工具 → 说『安装这个 SKILL』→ 把 KEY 发给它」：不用解压、不用自己找目录；包内说明书同步更新（手动解压保留为备选）
修复 智能体页按当前站点自动显示正确的包名（主站 mingyuan-period21-main.zip / 测试站 mingyuan-period21.zip），避免拿错版本
V4.0-1014.2 2026-10-14
重大更新 21期 智能体平台上主站：同学在「21期 智能体」页点一下就能生成自己的 KEY，把「明缘21期」技能包装到本地（Codex / 豆包 / WorkBuddy 等）用，在本地也能查看打卡、作业、提问和自我介绍
新增 主站版技能包（绑定 m.muguaclub.cn）：明缘21期 主站版，与测试站包互不通用；拿错版本会直接提示该用哪个站点的包
新增 「明缘智能体」页（/agent/）：按账号显示可用智能体，点开直接进对应功能
更新 自我介绍接口支持 2W1H 结构化字段，并清掉响应里的内部字段；既有 114 条自我介绍（含 7 张照片）一条都没动
修复 期数接口在主站只认登录态导致本地智能体取不到数据的问题（现在登录态与 KEY 都可用）
说明 老师管理 / 智能体管理两个智能体在主站默认没有授权，主站变更仍走总指挥；需要放权时在后台加角色即可
V4.0-1014.1 2026-10-14
重大更新 第二次作业「正式自我介绍（2W1H）」上线：独立作业页，含 2W1H 写法提醒、老师样例、工作样例；点作业列表第 2 张卡片直接进入
新增 作业提交不再选可见范围，交上来即全班可见；列表「自己小组排最前」，顶部显示全班总完成度与各小组完成度，列表每批 9 条下拉加载
新增 向老师提问：待提交 / 待回答 / 回答中 / 已回答四态；可自己选公开范围（默认仅自己+老师）；同学的问题区显示学号与姓名；老师接手后作答，答复提交后锁定
更新 21期 主页加入「向老师提问」入口；作业列表第 1 张卡片仍直达自我介绍墙，第 2 张直达本次作业页
修复 提问页两处脚本残留导致整页打不开、输入框过窄、命令行与哈希长串在手机上撑破版面等问题
说明 21期 学习智能体（技能包）当前只在测试站可用；主站要启用需先部署智能体平台，届时再发布主站版
V4.0-1014 2026-10-14
重大更新 21期「知行合一」学习模块上线：学习打卡（9 次课）、作业九卡片、讨论复盘入口、21期 智能体页
新增 学习打卡：正常 / 请假 / 不开摄像头 / 参加但不讨论 / 迟到或早退（系统态：没有操作）；窗口到本场 17:00，过点锁定只能看历史
新增 小组内打卡互相可见；自由学习组只看自己；老师同一页看各小组汇总，点开某组才加载明细
新增 作业九卡片：第 1 次「自我介绍」点卡片直接进自我介绍墙；第 2–9 次课后开放提交，未到时间可先看要求
更新 21期 主页改版：本周状态条（打卡 / 作业 / 分组 / 窗口）+ 五个模块入口；首页 21期·知行合一 卡片列出模块内容，点击直接进 21期 内容页，不用先到智能体目录
更新 没打卡时首页显示「本周还没打卡」并给「去打卡」入口；六个打卡状态各有颜色与字形，一眼区分
修复 日期解析兼容、打卡状态入库归一化、老师不参与打卡、作业卡片"能点不能交" 四处问题
V4.0-1008 2026-10-08
重大更新 21期“知行合一”自我介绍正式版上线：后端持久化、跨设备查看、保存日志与权限校验全面启用
新增 自我介绍卡片改为“学号 + 姓名”两行展示；无副标题时保留空行；长内容支持“查看详情”
新增 自我介绍列表首屏加载 9 条，支持滚动加载，每次追加 9 条，结束显示“已经到底了”
更新 `0000 周华明` 仅保留一张老师样例卡，不计入“已写”人数；老师记录自动去重
更新 自我介绍接口补充 `student_id`、`group`、`is_teacher`、`is_mine` 等字段，前后端展示与权限保持一致
更新 21期入口、自我介绍、保存修改、头像照片和权限控制同步到主站
修复 自我介绍保存日志、浏览器本地内容迁移和照片压缩，降低内容丢失风险
V3.3-1008.1 2026-10-08
新增 自我介绍保存日志：记录提交用户、期数、内容长度、是否带照片、内容摘要、成功状态和失败原因
修复 测试站自我介绍接口重复定义导致 5005 服务启动失败的问题，恢复服务并完成验证
V3.3-1008 2026-10-08
新增 自我介绍正式版数据库与接口：新增 `period_introductions` 通用表及查看、读取本人、保存本人三个接口
更新 21期自我介绍改为后端保存，支持跨设备查看，不再只依赖浏览器 localStorage
修复 自动迁移浏览器中尚未上传的旧自我介绍；照片上传前自动压缩，减少本地保存失败和内容丢失
V3.3-1007.1 2026-10-07
修复 移除 21期自我介绍墙中误用的 6 位非 21期学员样例数据，仅保留老师说例，避免被误认为正式 21期成员
V3.3-1007 2026-10-07
新增 21期“知行合一”入口与自我介绍墙，支持查看、撰写和修改自己的自我介绍，可选上传照片
更新 首页 21期入口仅 21期学员和老师可见；直接访问 21期页面时进行登录和身份权限校验
更新 当前为静态预览版，自我介绍暂存浏览器 localStorage，后续接入统一 periods introductions 接口与数据库
V3.3-0907 2026-09-07
更新 学员360 第6场：情绪轨迹结构化、发言人归位、观自在归并苏舟、组别修正、量化心智注入
更新 薪火相传 09-06 报告与 No14/No27 重跑版同步主站
新增 课程《荀子 · 解蔽》：36讲、序言L00、前10讲免作业解锁
新增 读书会课程与老师专属课程助理
修复 参与统计显示学号-姓名；年课/终身与账号状态判定生效
更新 中文路径英文化收尾，作业/授课文件改英文命名
更新 移除上课打卡与计划打卡入口及页面
V3.2-0831 2026-08-31
新增 读书会模块上线：读书会首页与《马克思主义逻辑学导论》课程
新增 课程助理入口（老师专属）
更新 学员360 第5场与学号修正：409份档案、版本清单同步到主站
更新 20期 8/30 复盘报告与参与统计
修复 学生360 权限：学生直达自己的档案，索引仅老师，他人档案403
修复 手机站 m.muguaclub.cn 360/课程矩阵/功能演示鉴权；introduction 301 跳转 m
更新 各期报告英文化与最新数据同步
修复 服务器 Python 3.9 环境与依赖，全部服务恢复运行
V3.1-0825 2026-08-25
修复 学员360 权限收紧：索引页仅老师可见，学生只能访问自己的360，他人页面一律403
修复 手机站 m.muguaclub.cn 英文360文件未鉴权漏洞，鉴权规则与主站对齐
修复 course-matrix 与 virtual-group 页面补充权限校验
更新 20qi、薪火相传、19期、18期组页与报告全面英文化（NoN.html 与英文报告目录）
更新 首页与入口链接改为英文路径，清理旧中文组页与报告目录
更新 学员360 英文单文件与版本清单同步到主站，学生点返回一次回到站点首页
更新 introduction.muguaclub.cn 301 跳转到 m.muguaclub.cn，内容统一由短域名提供
V3.1-0824 2026-08-24
新增 全站中英文路径切换：自由小组、量化排名、虚拟演示等英文页面
新增 短域名 m.muguaclub.cn 作为主站别名
更新 学员360 页面与去缓存版本自检同步到主站
更新 课程页面、用户数据与参与统计同步到主站
修复 时间戳仲裁：正式站新数据自动反向同步回测试站，避免旧数据覆盖
V3.1-0821 2026-08-21
新增 课程中心上线：4 门课程、序言/总结、逐讲内容与解锁体系
新增 课程作业、课程留言与 AI 回复、从智到行方法库
新增 客服支持页面与联系二维码
更新 用户、班级、小组、报告与课程数据同步到正式服务器
更新 服务器程序与数据库迁移同步，新增课程相关接口
V3.1-0820 2026-08-20
更新 20期 No 系列复盘报告与参与统计同步到主站
更新 20期小组页面与报告版本更新
更新 用户信息与成员关系同步
更新 统计数据与受管文件同步
V3.1 2026-08-10
重大更新 用户360 新增独立个人档案页，覆盖薪火相传全体成员
更新 用户360 第2场讨论档案与成员覆盖扩展
更新 薪火相传组页、参与统计与复盘报告同步到主站
更新 student360 学员全景首页同步到主站
V3.0.0809 2026-08-09
新增 用户360 新增 19 位薪火相传成员个人档案页
更新 用户360 首页与吸引力页同步到主站
更新 易经学习模块页面同步到主站
更新 课程投票数据同步到主站，同步前已备份
V3.0 2026-08-08
重大更新 新增“用户360”：薪火相传学员个人档案上线，每位成员拥有独立档案页与第1场讨论报告
新增 易经学习模块上线（yijing）
新增 student360 学员全景页面上线，覆盖终身学员及年课学员
更新 课程投票数据同步到主站，同步前已备份
V2.7.0808 2026-08-08
新增 易经模块首页 yijing/index.html 上线
更新 student360 学员个人页面全量同步到主站
更新 课程投票数据同步到主站，同步前已备份
V2.6.0806 2026-08-06
新增 student360 学员个人全景页面上线，覆盖终身学员及年课学员
新增 course-matrix 课程投票矩阵功能，学员可浏览并投票本学期课程
修复 主站 /api/admin/ 路由缺失，课程投票提交无响应问题
V2.6.0805 2026-08-05
修复 personal-report.html 旧版权限过滤（每人只能看自己的报告），恢复为全组成员可见，教师账号恢复正常查看
变更 19期全组（01-10组）量化心智图谱和参与统计数据同步到主站
变更 薪火相传及20期最新参与统计和报告数据同步到主站
修复 服务器 C.UTF-8 locale 编码问题，Python 标准输出/文件系统编码恢复为 UTF-8
V2.5.0803 2026-08-03
新增 老师大班授课新增课程「董仲舒与《天人三策》」（讲者：武海涛），音频和结构化纪要均已上传测试站
新增 固化结构化纪要生成流程：大班授课文件/STRUCTURED_SUMMARY_WORKFLOW.md + append_structured.py
修复 teacher 三页面（index/date/player）增加「讲解老师」显示逻辑（非华明讲者自动标注，华明默认不显）
修复 player.html 手机端返回按钮无效：<a href="#"> 改为 onclick + location.href，兼容移动端浏览器
修复 参与统计「您不属于该小组」BUG：stats.html 成员匹配从纯名字对比改为学号-姓名格式匹配，覆盖 xinhuo/19qi/18qi 三个期数
修复 18 期参与统计数据缺失：同步 _participation.json 并重新聚合 stats_data.json
修复 首页鼓励语优化：点名具体人的团队鼓励语自动加「有同学说：」前缀，避免误认为自夸
V2.4 2026-07-29
全新改版 首页重新设计，优化视觉体验和加载性能
升级 播放器功能升级，提升课程播放体验
更新 薪火相传所有组页面数据同步刷新
V2.3-正式版 2026-07-28
重大更新 新增「老师授课」音频模块，支持自定义播放器、课程导航、结构化纪要
新增 自定义播放器：15秒跳转、倍速(0.75x~2x)、跳转时间、小节列表弹窗
新增 结构化纪要卡片：基于JSON的分段渲染，逐字稿/时间轴/纪要瀑布流排版
新增 上一节/下一节跨日期导航，localStorage自动续播
修复 手机端进度条太小无法拖动的问题
V2.2-正式版 2026-07-28
新增 薪火相传 01/06/10/11/16/18/22/28/30/33 组讨论报告更新
新增 19期05组讨论报告更新
新增 量化心智图谱报告更新（10组/14组）
新增 11组、22组页面更新
变更 数据全部基于 _participation.json，学号直匹配，消除姓名歧义
V2.1-正式版 2026-07-28
重大更新 新增「老师授课」音频与逐字稿模块，年课/长期学员专属
新增 老师大班授权：音频在线播放 + 逐字稿/纪要/时间轴三栏阅读
新增 已上线8节课：大学中庸（7/12）+ 牧学三周年（7/18）+ 大学中庸（7/26）
修复 更新使用说明书，增加老师授课模块说明
V2.1-测试版 2026-07-28
重大重构 数据引擎全面升级，基于 _participation.json 替代 HTML 参与表解析，彻底解决姓名匹配问题
新增 所有成员显示统一为"学号-姓名"格式（如 N631-关芝秀），消除重名和繁简歧义
新增 参与统计页面取消权限控制，全体组员可查看完整参与数据
新增 列表只显示有实际报告文件的成员，无报告自动隐藏
修复 关芝秀等成员有报告但不显示的问题（源自 index.json 解析bug）
修复 周善明（请假）被识别为两个人的问题（参与表直接使用学号匹配）
修复 高暢/高畅繁简字导致重复卡片的bug
修复 参与统计不显示"不属于该小组"的问题
修复 忘记密码验证中一直不跳转的bug
变更 优化参与统计颜色梯度，根据参与率自动从黄到绿渐变
变更 量化心智图谱报告卡片，参与场次和评分更直观
V1.8-正式版 2026-07-27
多处优化与 bug 修复（详见 V1.5 ~ V1.8 版本）
V1.5-正式版 2026-07-18
重大升级 增加个人的「量化心智图谱」报告系统，在小组页点击按钮查看
新增 行为模式量化、语言DNA、认知深层扫描、量化评分卡四种个人报告
新增 量化组内排名、量化全局排名入口
新增 教师视角：老师可查看全组所有成员的量化报告
新增 报告页面添加「返回心智图谱」导航按钮
修复 JS 硬编码 07组导致所有组链接都指向07组
V1.4-正式版 2026-07-17
修复登录和忘记密码bug
V1.3-正式版 2026-07-16
增加忘记密码功能、统计报告页面
V1.0-正式版 2026-07-08
新增 导航栏、网页文件独立存放、SKILL/README 文档
新增 问题反馈和更新日志页面
修复 日期排序、摘要提取、路径错误
V0.9-Beta 2026-07-07
三站点架构（首页 → 站点 → 小组列表 → 报告）
组列表卡片、Hero Banner、nginx 鉴权