第 1 层
首屏三屏引导
第一次打开时出现,90 秒讲完「这是什么、能帮你什么、从哪开始」。看过一次就不再打扰。
看引导内容 →
第 2 层
模块内「?」帮助
在哪个页面遇到问题,就在哪个页面得到答案。不跳走、不打断正在做的事。
看帮助位置 →
第 3 层
本页 · 按任务查
「我的 → 使用手册」进入。按角色和任务组织,适合已经上手、要办具体事的时候查。
就在本页 ↓
我是:
老师端 7 项任务。点任意一条展开步骤;点标题可收起。
1第一次用,把班级建起来5 分钟。建完之后学生就能用班级码进来,这是所有功能的地基。
▶
组卷工作台 › 班级管理
- 打开组卷工作台,进 班级管理,点「新建班级」,填班级名(如「高二 3 班」)。
- 系统生成一个 六位班级码。把这个码写在黑板上,或投到屏幕上。
- 学生端打开后点「我是学生」,用手机号验证码或微信登录(登录只是为了认人,用于跨设备找回进度)。
- 登录后点「加入班级」,输码 + 起个昵称,就进来了。班级里显示的是昵称,不是真名。
- 回到班级管理,能看到进来的人数。人齐了就开始下一步。
手机号只用于登录,不进班级。 一个班级码 + 一个昵称就够区分同班学生了。老师在名单里看到的是昵称,收不到学生手机号——少让一个人看到,就少一份泄露面。
2组一份卷,发给学生做造题 → 排卷 → 发布,主链路。
▶
首页 › 造题入库 / 选题排卷
- 造题入库:机器造题(按知识点、难度、题型批量生成)或人工造题(自己写,进编辑器)。
- 选题排卷:从题库里挑题,拖进卷子,调顺序、设分值。
- 排完点 发布到班级,选班级、设截止时间。
- 学生在学生端「我的作业」里就能看到,点「开始做」。
题不够用? 题库是持续造出来的。先看知识库里有没有现成的,没有再自己造。造过的题会留在题库里,下次直接选。
3布置不同形态的作业(四种)一份卷只是其中一种。听写、背诵打卡、实验报告各有各的批法。
▶
组卷工作台 › 班级管理 › 题包行「布置」
- 在班级题包里找到要发的卷,点 「布置」,按提示选类型:
1 纸质卷 / 2 听写 / 3 背诵打卡 / 4 实验报告。
- 纸质卷:只填截止日期和一句说明。学生线下做、拍照上传,你按卷面批阅。
- 听写:每行一条
提示词|标准答案|提示(第三段可省)。学生线上自默,系统自动判分,你不用逐份看。
- 背诵打卡:贴条目全文,用顿号列出 3~8 个必背关键词,设打卡天数(默认 5 天);想让家长见证就打开「家长确认」。
- 实验报告:从 10 个内置模板选一个(配制溶液 / 粗盐提纯 / 焰色试验 / 氯离子检验 / 铁盐亚铁盐转化 / 速率影响因素 / 原电池 / 乙酸乙酯 / 中和滴定 / 中和热),六栏结构自动带出。
- 点 「进度」 看谁交了、谁没交;背诵与报告还多一个「查看」——能回听录音、看 AI 检查单,再标 合格 或 退回重做。
四类的判分权不在同一处。 听写由系统判(客观比对,无争议);背诵只给关键词三档参考、不打分,合格与否你定;实验报告 AI 只预检「六栏是否填全 + 现象栏关键词是否命中」,判分权在你。AI 不判分是刻意的——化学的「现象描述得对不对」需要人看。
4看学情:哪些题全班都错了不要看平均分,看错误集中在哪个错点上。
▶
组卷工作台 › 学情看板
- 选一份已发布的卷子,看 逐题正确率。低于 40% 的题会被标红。
- 点那题,展开 选项分布——错的人都选了哪个选项,比错了几个人更有信息量。
- 看 错点聚类:系统把错到同一个概念上的题归到一起,告诉你「这个班卡在『平衡常数随浓度变』上」。
- 拿着一两条错点去上课,比讲一整章有效。
数据从哪来? 学生的作答记录默认存 浏览器本地,学生点「同步进度」时才上传。所以刚发下去的卷子可能还没数据,别急着看。
5用可视化演示讲一个错点学生想不通的地方,让他自己拨一拨参数。
▶
化学可视化实验室 › 14 件演示
- 每个演示对应一个具体错点(标题下面标着
MIS-SC-xxx 与题目数量)。
- 课堂上投屏,拖参数让学生看结果怎么变——比如「平衡常数温度台」里,改浓度 K 不动、改温度 K 才动。
- 每个演示末尾有 5 题变式快测,讲完立刻出题,看学生是否真的转过弯。
- 「辩驳台」环节列了 6 句话,其中恰好 2 句是对的,让学生举手判断。
纯本地,断网也能用。 演示页不含任何网络请求,机房没网、或者你不想让学生连网,都不影响。
6给家长发一份学习情况不用截图、不用手打,一键生成家长能看懂的一段话。
▶
学生端 › 生成家长版文本
- 让学生在自己那端点 「生成家长版文本」,得到一段只含总量与趋势的话——没有每题对错,没有排名。
- 学生复制后自己发给家长。这一步刻意不自动发送:发给谁、发不发,学生自己决定。
- 如果家长要用家长端看,学生点 「生成家长码」,把六位码当面给家长。
家长码和班级码不是一回事。 家长码只能绑一个学生,且家长端是纯只读的——看得到数据,改不了任何东西,也干涉不到教学。
7把资料放进知识库,以后好找上课用的图、讲义、真题,建一次索引就够了。
▶
老师知识库
- 进 知识库,选文件夹导入。原始文件不上传,只在本机建索引。
- 用关键词搜,命中后直接打开原文件。
- 常给某个班讲的资料,可以固定到班级页,学生也能看到。
索引在本地,换电脑就要重建。 别把它当云盘用。要长期保存的资料,请留在项目盘或自己的硬盘里。
1加入班级,开始用登录用手机号或微信,班里只显示昵称。
▶
学生做题端 › 加入班级
- 打开学生端,点 「我是学生」,用 手机号验证码 或 微信 登录。
- 输入老师给的 六位班级码,起个昵称(可以不用真名)。
- 点「加入班级」。成功后就能看到老师发的作业。
- 想先看看是什么样?点 「在本机试用」,不登录也能做几道题试试。
手机号只用来登录。 老师看不到你的手机号,名单里只有你的昵称。作答记录默认存在本机,不会上传服务器——除非你自己点「同步进度」。
2做作业,卡住了怎么办先自己想,再让页面把原理回放一遍。
▶
学生做题端 › 我的作业 › 开始做
- 点「开始做」,逐题作答。中途退出不要紧,进度存在本机。
- 卡住时先 「再提一个」 看提示——给的是思路,不是答案。
- 答错后会出现 原理回放:把这道题背后的概念拆开演示一遍。先想、再看,两步是有顺序的,别直接跳到回放。
- 全部做完点「提交」,看 错因诊断单——它告诉你错的不是这道题,而是哪个概念。
答错不是坏事。 这个产品就是围绕「人会怎么错」设计的。你错在哪,系统比你自己更清楚,讲解也就更对你的路子。
3四种作业分别怎么交拍照、自默、打卡、填报告——入口都在「我的作业」里。
▶
学生做题端 › 我的作业
- 纸质卷:点「领取并开始」做题,卷面写完后拍照上传。家长代拍也行,会标「家长代传」,老师看得到。
- 听写:点「开始听写」,屏幕逐词朗读(可重听、可跳题),你在输入框写答案,交卷即出对错。大小写和空格不算错(
naoh 与 NaOH 同判)。
- 背诵打卡:点「打卡」,两条路任选——默写(写完点「按关键词检查」,给 🟢/🟡/🔴 三档参考)或 录音(最长 30 秒)。一天算一次,攒够天数即完成。
- 实验报告:点「填写报告」,六栏逐栏写(目的 / 器材 / 步骤 / 现象 / 结论 / 误差分析),可附最多 4 张照片。提交前点 「🤖 AI 预检」,它会告诉你哪栏还空着、现象栏的关键词漏了哪些。
- 罗盘页顶部还有 「🎧 化学用语听写 · 从我的红格生成」:系统按你的红格自动组一份约 10 分钟的自默单,交卷后错词直接写回罗盘。
背诵的默写不是考试。 三档参考只告诉你哪几个关键词没写出来,不打分、不排名、不影响掌握度。漏掉的词会进「今日 10 分钟」的复背清单,第二天提醒你再看一眼——那才是它真正起作用的地方。
学生做题端 › 错题本 / 学习罗盘
- 错题本按知识点分组,不是按时间堆。同一类错放一起,才看得出规律。
- 点 「看本节掌握度」,看到每一节的掌握进度。
- 点 「看罗盘」,看到整体分布——哪个板块一直没动。
- 对着薄弱项去「知识迁移专练」练同类题,比换一套新卷有效。
掌握度是按错点算的,不是按做题数算的。 做 100 道同一类型的题,掌握度不会涨多少;搞懂 1 个错点,会明显涨。
学生做题端 › 生成家长版文本 / 生成家长码
- 点 「生成家长版文本」,得到一段话:只有总量和趋势,不含每题对错,也不含排名。
- 点 「复制文本」,自己用微信发给家长。
- 如果家长想在手机上看,点 「生成家长码」,把六位码当面给他。
家长看不到你的每题对错。 家长端只有几个数字和趋势。这是设计上刻意的:让家长知道进展,但不干涉你的学习过程。
6换设备了,进度怎么办点一下同步,之后在哪台机器都能接着做。
▶
学生做题端 › 立即同步进度
- 在原设备上点 「立即同步进度」,把本机记录传上去。
- 到新设备上,用 同一个班级码 + 同一个昵称 加入。
- 自动拉回之前同步过的进度。
不点同步 = 不上传。 这是隐私设计的代价:记录默认只在你自己的浏览器里。换设备之前记得先同步,清浏览器数据就等于删掉。
1绑定孩子,看学习情况需要一个孩子给你的六位家长码。
▶
家长端 › 绑定孩子
- 让孩子在自己那端点 「生成家长码」,把六位码给你。
- 你打开家长端,输码完成绑定。一个家长码只能绑一个孩子,不能重复用。
- 绑定后能看到四项:近阶段完成量、正确率趋势、薄弱知识点、老师是否已发布新作业。
为什么不能拿班级码绑定? 班级码能绑进全班。如果家长都能用班级码,一位家长就能看到全班学生的数据。家长码由孩子主动生成、当面给你,确保绑定是经过孩子知情的。
2家长端能做什么、不能做什么边界是清楚的,不是"看情况"。
▶
家长端 › 全部页面
- 能做:查看学习情况、接收老师发的资料、对孩子的内容点「已阅」、提交一份结构化的求助单;另有两个写入口——持家长助理码「代传作业的照片」与「确认孩子已背诵」。
- 不能做:改分数、改批阅结论、自己发作业、看其他学生、看班级、导出任何数据。
- 这些不是"没做",是 接口层就拦掉了——家长端主体只读,两个写入口各自独立校验(助理码 6 位 + 7 天有效期 + 只能落在自己孩子那一条提交上),且都留痕。
为什么不做聊天? 微信已经是最好的聊天工具。本产品只做微信做不了的事——把学习数据结构化地呈现出来。真要沟通,点「已阅」或发一份求助单,然后去微信聊。
2b帮孩子打印、拍照、确认背诵(家长助理)用孩子给的 6 位「家长助理码」,只看自家孩子的作业。
▶
首页 › 家长助理(parent.html)
- 让孩子在学生端 「老师计划 · 家长助理码」 点「生成 / 续期」,把 6 位码给你——7 天有效,孩子可随时作废。
- 家长看结果无需账号:请老师把回执 / 学情报告文件导出给你,用本机浏览器打开即可(类型、卷名、截止日期、老师的一句话说明都在里面)。
- 纸质卷:点 「🖨 代打印」(与孩子端同一版式,A4 纵向);孩子手写完成后,点 「📷 代拍照提交」 上传卷面。
- 背诵打卡:如果老师开了「家长确认」,孩子打完卡后会出 「✓ 确认孩子已背诵」 按钮——你听过或看着他背过再点,点了才算完成。
- 实验报告:线上填写的六栏报告你不需要插手;若孩子按纸质报告做,同样可以 「📷 代拍照提交」。
- 你代传的每一份都会标 「家长代传」,老师批阅时看得到——这是留痕,不是监控:你看不到其他学生、看不到班级、没有任何导出。
家长助理码 ≠ 家长码。 助理码只服务于「作业的打印、提交、背诵确认」这几件事、7 天自动过期;「家长码」管的是学习情况只读查看。两者互相独立,孩子都可以随时作废。
3发现孩子的数据有问题,怎么处理你有一份完整的权利清单,且每条都有对应按钮。
▶
家长端 › 我的孩子 / 隐私设置
- 查阅:我的孩子 → 信息清单,逐项列出收集了什么、存在哪里。
- 更正:我的孩子 → 申请更正。
- 撤回同意:隐私设置 → 撤回同意。撤回后账号停用,数据按规则删除。
- 删除:我的孩子 → 注销。7 日内完成,不可恢复。
如果孩子不满 14 周岁,账号必须经你单独同意才能激活。在你同意之前,孩子只能浏览、不能作答,也不会留下任何数据。详见《未成年人保护规则》。
1本地跑起来零依赖,双击即开。不需要 node、不需要装包。
▶
任意静态服务器 / 直接双击
- 拿到代码后,直接双击
index.html 就能用(纯前端,无构建步骤)。
- 要分享给同网段的人,起个静态服务器即可:
python -m http.server 8000。
- 部署到公网只需静态托管,无后端依赖。没有数据库,就没有数据泄露面。
MIT 许可:可自由获取、修改、再分发,包括商业用途。唯一要求是保留版权声明与免责条款。
2关键约定(改代码前先看这条)几条硬规矩,破坏了会连带坏掉别的东西。
▶
visual-lab/ 与 modules/
- 零第三方上报:不引入任何分析脚本、CDN 探针。这是隐私政策最硬的一句,也是开源可验证的部分。
- 作答记录只进 localStorage,键名前缀
ctc_。跨页共享靠这个前缀,别改名。
- Canvas 不用
roundRect,兼容性差,用现成的 rrect() 辅助函数。
- 可视化页保留
window.trace({sims:[], quiz:[], sok:[]}),自动化测试靠它断言交互是否真的发生过。
家长端权限要在路由层拦。 不要在控制器里写
if 判断——将来新增接口很容易漏。见
权限矩阵。
3新增一个错点可视化模块现有的 14 件都是同一个模子,照着做最快。
▶
visual-lab/
- 从错点清单里挑一条,记下
id、title、statement(错误说法)、correct(正确说法)。
- 照着现有文件的四站结构写:现象模拟 / 条件对照表 / 误判辩驳台(6 句、恰好 2 句正确)/ 错案库。
- 加 5 题变式快测,答案写进
trace.quiz。
- 在
visual-lab/index.html 加一张卡片,并更新卡片总数。
- 跑 playwright 冒烟测试,并通过截图目视确认四站都渲染正常。
辩驳台必须恰好 2 句正确——这是设计约束,不是随手写的。正确句过少会变成单向灌输,过多会让学生猜。
项目根目录
组卷工作台 教师
- 造题入库、选题排卷、班级管理、学情看板
- 只有教师可写,管理员也不行
index.html · group.html · modules/
学生做题端 学生
- 作业、错题本、罗盘、家长版文本
- 作答数据默认本地,手动同步
student.html
可视化实验室 公开
- 14 件错点演示 + 变式快测
- 零依赖单文件,可单独分发
visual-lab/
家长端与管理员不在这张图里:家长助理页(parent.html)从首页角色卡进入,只服务于作业的打印 / 提交 / 背诵确认;家长只读端与管理员各有独立入口。三者都进不了组卷工作台——家长侧看不到班级、看不到其他学生,管理员只看聚合数据、不能下钻到个人。
师生家长是怎么绑起来的
这条链只有三环,且只有一条:老师 →(班级码)学生 →(家长码)家长。管理员和开发者不在链上。
1老师和学生是怎么绑定的?
靠本机名片码 / 计划口令,不靠搜索、不靠好友申请、不靠账号。老师本机生成六位码(如 MYSHBR),学生粘贴一次即在本机建立关系。四条规矩:
· 老师不能主动拉人,只有「发码」这个动作,避免了「老师强行把谁拉进来」的责任模糊;
· 一个学生可以进多个班(走班制、跨学科班),每条关系独立;
· 老师能移出、学生能退出,双向都可以;
· 码可以重新生成,旧成员不受影响,外人加不进来。
2为什么不让学生搜老师的名字加班级?
一旦可搜索,必然出现三件事:① 有人冒充老师建同名班;② 学生误加外班,看到别人的成绩;③ 老师被陌生人反复打扰。码是单向的、老师发的、可换的——正好挡住这三种情况。
另一个不太直观的好处:码让「谁邀请谁」这件事有明确记录。出了纠纷,能追到是哪个码、什么时候被谁用了。
3家长是怎么进来的?为什么家长码不能代替班级码?
家长码由学生自己生成,只能绑一个孩子。
不能代替班级码的原因很直接:班级码能绑进全班。如果家长也能用班级码,一位家长就能看到全班所有学生的数据——这是绝对不能出现的。家长码由孩子主动生成、当面交给家长,确保这段绑定关系是经过孩子知情的。
4管理者是怎么参与进来的?
管理员不在绑定链上,也不进首页宫格。他们有独立入口,看到的是聚合数据:「高二 3 班平衡常数这块偏弱」,但看不到「张三 58 分」。
技术上用 RLS(行级安全)+ 聚合视图双重保证——不是界面不放按钮,是数据库根本不返回明细。
还有一条边界容易被搞错:管理员不是老师的上级。 管理员不能替老师建班、发作业、改成绩,也不能下钻到个人。否则就从「教学工具」变成「行政监控」了。
5老师离职或者班级不带了,关系怎么办?
老师可以在班级管理里移出成员,学生也可以自己退出班级。班级删除时成员关系一并解除。
关键一条:解除后老师不再看到该学生此后的作答数据,但学生已上传的历史数据仍归他自己所有,不随关系解除而转移或删除。数据不属于班级,属于学生。
6老师怎么证明自己真是老师?
按运行形态分级:
· 自部署版:不核验。学校自己管人,责任在学校,我们也接触不到账号数据。
· 托管版:必须完成其一——学校邮箱域名验证或学校管理员邀请。二者择一,避免只留一条路把小规模学校挡在门外。
· 未完成核验的教师:可以建班、组卷、自测,但学生数上限 30 人,班级不对外展示。
托管版必须做这层,是因为托管版里我们承担个人信息处理者责任——若谁都能自称老师收学生数据,出了冒名建班的事,我们没法证明「这个班有真实教师负责」。
错因归因闭环 · 五步走(高中教师端)
入口:教师端 → 「📈 教学过程」→ 首屏「🧭 错因归因 · 教学动作单」主卡。五步是同一条记录接力,只有你核定过的错因才会驱动后面所有环节。
① 归因核定 —— 考完在错因表录学生涂的错因卡 → 点「生成教学动作单」→ 勾选核定。没核定的错因不进下游。
② 学情安排 —— 按核定错因配真实题位,生成「明天讲什么」任务单;③ 处方题入卷 —— 核定出的题位一键进试卷篮。
④ 讲评材料 —— 课件页点「按核定错因生成」:典型错例(真实错题)→ 正解对比 → 同型变式;导出时自动带 3 题验收小测发给学生。
⑤ 效果回看 —— 学生做完交回,导入回执后对照讲前 / 讲后证据,由你按「已过关 / 再讲一次」结案;未过关的错因带证据回流下一轮。
第一次用?在主卡点「用示例数据走一遍」,五步全通后一键清除,不碰真实数据。
常见问题
Q数据存在哪里?会上传到服务器吗?
默认存在你自己的浏览器里(localStorage,键名前缀 ctc_)。学生作答记录不上传服务器,除非学生主动点「立即同步进度」。教师知识库的索引也在本机。代码全程开源,你可以自己搜一遍有没有对外发送数据的请求——没有。
Q学生登录要手机号,那我的手机号老师能看到吗?
看不到。 手机号只用于登录验明身份,不写入班级成员关系。老师在名单里看到的是你自己起的昵称,没有任何联系方式。学生也可以选微信登录,完全不用手机号。
另外,产品不收集学生的真实姓名、身份证号、家庭住址、人脸、位置、通讯录——这几项在任何流程里都不需要。
Q家长能改孩子的成绩或作业吗?
不能,而且是在接口层就拦住的——不是"界面上没放按钮"。
家长能做的只有四件事:看四项总览、点「已阅」、提交求助单,以及持家长助理码代传作业 / 确认背诵(这两项写的是「提交」和「确认」,不是「改」)。分数的写入接口对家长完全关闭,批阅结论只能由班级的创建老师写。
这是设计的一部分:家长知情、能搭把手,但不干涉教学判断。
Q听写、背诵、实验报告,哪些是系统判分,哪些要老师判?
只有听写是系统判的。 因为它是客观比对——答案规范化(忽略大小写与空白)后字符串相等即对,没有争议空间。
背诵不打分。 系统只核对老师设的必背关键词,给 🟢 全中 / 🟡 部分 / 🔴 基本没写 三档参考,合格与否由老师看。默写文本与录音都留档,老师随时可查、可退回。
实验报告由老师判分。 AI 只做两件事:结构完整性(六栏哪栏还空着)与现象栏关键词命中(参考现象里的关键表述写没写)。这两项只是给学生的自检提示,不是分数。化学的「现象描述得对不对」需要人看,这一条我们不交给模型。
Q家长代传的作业,老师能分辨吗?
能,而且会明确标出来。 家长助理页代交的每一份,服务端在提交记录里写入「家长代传」标记,老师在进度墙里直接看得到。
这不是为了抓什么,是为了让老师知道这份卷子的提交过程家长在场——批阅时对字迹与完成时长的判断会更准。同时助理码只能看自家孩子、7 天过期、孩子可随时作废,边界是收紧的。
Q不满 14 周岁的学生怎么处理?
走监护人单独同意流程:学生填出生年份 → 判为不满 14 周岁 → 生成监护人授权码 → 监护人在家长端确认并单独勾选同意 → 账号才激活。在你同意之前,孩子只能浏览、不能作答,也不会留下任何数据。详见《未成年人保护规则》。
Q换电脑 / 换手机后数据还在吗?
作答数据默认只在原设备的浏览器里。换设备前先点「立即同步进度」,到新设备用同一个班级码 + 昵称加入就能拉回。教师知识库的索引不跟随账号,换设备需要重新导入建索引。
Q断网 / 机房没网能用吗?
能。 可视化实验室的每一件都是零依赖单文件,不含任何网络请求。组卷工作台和学生端也是纯前端,双击打开即可运行。没有后端依赖,也就没有"服务器挂了用不了"这回事。
Q学校想私有化部署,怎么做?
代码以 MIT 许可发布,学校可自行部署到自有服务器,数据不出校门。此时数据控制方是学校,我们接触不到任何数据。这是 to 校场景最硬的一条——也是政府采购常明确要求的「无技术锁定」。