Repository navigation
Releases
Releases · jorinyang/YSCOT
v0.4.1 · CUA 视觉复核修复
v0.4.1 · CUA 浏览器逐页视觉复核与修复
用本机 CUA(隔离 profile)打开真实浏览器,逐页复核了登录页、工作台、课程房间、课堂后台、授课大屏、遥控器、学员端,并修掉发现的问题。
修复清单
- 遥控器桌面被拉满宽 → 限制 560px 居中,手机比例正常;
- 大屏二维码压住小组积分、底部溢出 → 二维码缩小并移进「抢答」卡右下角;
- 大屏强调色不对 → 「未开启」从米色改荧光绿;
- 大屏脚本中断 → 删除旧二维码容器后残留空引用,已加空值保护;
- 房间页顶部多余「·」 → 清理;
- 学员端输入框白底 → 改成深色输入卡;
- 禁用按钮仍是亮绿 → 增加降饱和禁用态。
截图(release 资产)
01-login.png登录页02-home.png工作台03-screen.png授课大屏04-remote.png讲师遥控器05-join.png学员端
其他
- 测试房间已清理:只保留
ROOM0与6MZK(2026-10-21 黔西南); - 浏览器核验使用独立 profile,结束后已关闭,不影响本机 Chrome。
Full Changelog: v0.4...v0.4.1
v0.4 · wb 风格改版 + 工作台/房间/四端联动
v0.4 · 参考 wb 风格的全站改版 + 工作台/房间/四端联动
设计
- 参考
wb.gzzhike.cn:近黑底#0E0E10+ 荧光绿#CBF74E+ 24px 大圆角 + Inter 字体; - 新增
templates/ui.css全站主题层,19 个页面统一注入; - 登录页改分屏:左侧品牌/数据,右侧登录卡(钉钉 / 本地口令双标签)。
信息架构
/未登录是登录页,已登录跳/home;- 工作台默认 房间管理,含模型配置 / 个人信息 / 讲师管理(仅超管);
- 管理员看全部房间,讲师只看自己的;
- 房间默认名称 = 日期 + 城市,可编辑、可删除;
- 建房后进入课程生成页:上传大纲/课件 → 进度条 → 自动应用题库/作业 → 跳转各页面。
身份
- 钉钉登录保存头像/姓名/角色/部门;
- 工作台、课堂后台、房间页显示头像,点击回工作台;
- 新讲师首次登录自动入名单,超管可改角色/删除。
内容
- pptx / pdf / html 保留原文件,房间页可查看/下载;
- md / txt 生成大纲框架页;
- 生成使用「模型配置」中保存的模型,产出课程页/宣传页/题库/素材/作业题。
联动
- 遥控器:预置题目投票、素材发放、作业开关、开始答题、抢答轮次、工作坊计时、大屏切换、课件翻页;
- 课堂后台:投票题库、素材上传、分组、抢答开关、表现分、作业评分、在线答题;
- 大屏三视图:数据 / 课程页 / 宣传页,学员扫码二维码;
- 学员端:素材发放后出现下载卡;
- 房间页四端卡片 + 二维码 + 大纲文件 + 生成内容。
验证
- 全部页面 200 且带
ui.css;登录页 /ui.css / 工作台 / 房间 / 生成页 / 四端 / 编辑页均通过; - 房间创建(日期+城市)、上传、md 框架页、投票预置、素材发放、大屏切换、翻页、按题库开答、删除均实测成功;
- 讲师归属:两个讲师会话各自只见自己的房间,管理员见全部。
Full Changelog: v0.3...v0.4
v0.3 · 房间化课堂运营 + 课程包 + 讲师管理 + 嵌入/MCP
v0.3 · 房间化课堂运营 + 课程包 + 讲师管理 + 嵌入 / MCP
课堂层
- 房间:一节课一个房间(4 位码),学员、投票、答题、作业、积分互相隔离;
ROOM0兼容旧数据 - 操作台
/ops?room=:投票、抽签分组(上限 1–10)、多轮抢答、课堂表现分、学员管理、四个标签(课堂/作业/答题/模型) - 大屏
/screen?room=:投票实时条、抢答赢家、答题进度、积分榜、工作坊倒计时,SSE 推送 + 轮询降级 - 遥控器
/remote?room=:手机发起/结束投票、抢答、结束答题、计时、推送行动卡 - 学员页
/join?room=:抽签、投票、抢答、答题、行动卡与素材、六类作业上传 - 课堂报告
/report?room=:学员、小组、答题、作业汇总,CSV 导出
教学工作坊
- 工作坊计时:开始/暂停/重置,大屏同步倒计时
- 行动卡推送:一键让所有学员页出现任务卡与素材下载(PPT 讲课也能用,不再依赖课件页)
教学内容层
- 课程包
/packages:上传 HTML、预览、删除;/shell?pkg=框架播放,保留顶部导航与后台入口 - AI 生成课程包:素材 → 模型出大纲 → 模板渲染成单文件 HTML
- 课程包模板:内容 JSON + 构建脚本(
templates/course-package-template/)
身份与权限
- 讲师登录
/login:钉钉 OAuth2 扫码(需应用凭证)或本地口令;HMAC Cookie - 讲师管理
/teachers:讲师名单、角色(超管/讲师/助教/观察)、钉钉 unionId - 钉钉部门同步:登录时按 unionid 取部门,自动补全讲师部门(需 CorpId 与通讯录权限)
- 强制登录:
REQUIRE_AUTH=1时页面 302 到登录、管理接口 401,大屏保持公开
集成层
- 嵌入组件:
/embed.js+/embed,投票 / 抢答 / 答题 / 积分四类小组件 - MCP:
/mcpJSON-RPC,10 个工具(建房、房间状态、投票、抢答、发布答题、调分、报告、大屏地址等) - REST API:房间、状态、投票、答题、作业、报告
部署
- 局域网:
node server.mjs;公网:Node 主机 + HTTPS + 钉钉回调白名单 - Docker:
docker build -t gtscdt ./docker run -p 8899:8899 ...
文档
- README 重写为能力全景:每项能力的能力、使用方法、适用场景
- 新增
docs/06-课堂使用说明-按课程流程.md:按课前 → 开场 → 上午 → 工作坊 → 评分 → 复盘的顺序,说明用什么、怎么用、什么效果
验证
- 现场接口回归 30/30;v0.3 功能 21/21;MCP 与嵌入 7/7;讲师与课程包管理 14/14;计时与报告 10/10;鉴权 6/6
- 钉钉:授权跳转与回调代码已就绪,真实扫码需要应用凭证,尚未联调
Full Changelog: v0.2...v0.3
v0.2 · 四标签后台 + 在线答题 + 模型评分
v0.2 · 四标签后台 + 在线答题 + 模型评分
合并后台
- 课堂后台合并为一个页面四个标签:课堂管理 / 作业评分 / 在线答题 / 模型管理
- 旧的 /admin、/grader 地址继续可用
在线答题
- Excel 四表导入题库:选择题(题目/答案A–D/正确答案)、判断题(题目/对错)、填空题(题目/答案)、简答题(题目/参考答案)
- 出题方式:随机 / 顺序;四类题各自设置数量与分值
- 学员手机作答;客观题精确判分;简答题由模型按参考答案评分
- 支持结束答题、清空本次结果、清空题库
模型管理
- 新增「模型管理」标签:API Key / Base URL / Model
- 支持测试连通性与保存;Key 只存服务端,页面不回显
- 已用 deepseek-flash 实测:本地约 1.0s、FC 约 0.6s 返回 OK
- 作业评价与主观题共用该配置;未配置时自动回落规则/相似度评分
作业评分
- 每个任务的详情新增「AI 评分」:按评分标准逐项打分并给依据,可再人工修改
同步与模板
- 阿里云 FC 云函数同步以上接口
- 仓库更名为 GTSCDT(Game Theory Strategy Course Development Tools · 弈策课程开发工具)
- 保持脱敏模板;xlsx 导入使用 SheetJS(Apache-2.0,已登记)
Full Changelog: https://github.com/jorinyang/GTSCDT/commits/v0.2