使用说明书

「点化」不是一套要学的软件,是三类人各看自己那一页的东西。
本说明书按 你现在是谁、想干哪件事 组织,不按功能菜单组织——找功能不如找任务。

v0.2 2026-10-20 四类作业:纸质卷 / 听写 / 背诵打卡 / 实验报告 开源 MIT
第 1 层

首屏三屏引导

第一次打开时出现,90 秒讲完「这是什么、能帮你什么、从哪开始」。看过一次就不再打扰。

看引导内容 →
第 2 层

模块内「?」帮助

在哪个页面遇到问题,就在哪个页面得到答案。不跳走、不打断正在做的事。

看帮助位置 →
第 3 层

本页 · 按任务查

「我的 → 使用手册」进入。按角色和任务组织,适合已经上手、要办具体事的时候查。

就在本页 ↓
我是:

老师端 7 项任务。点任意一条展开步骤;点标题可收起。

1
第一次用,把班级建起来5 分钟。建完之后学生就能用班级码进来,这是所有功能的地基。
▶
组卷工作台 › 班级管理
  1. 打开组卷工作台,进 班级管理,点「新建班级」,填班级名(如「高二 3 班」)。
  2. 系统生成一个 六位班级码。把这个码写在黑板上,或投到屏幕上。
  3. 学生端打开后点「我是学生」,用手机号验证码或微信登录(登录只是为了认人,用于跨设备找回进度)。
  4. 登录后点「加入班级」,输码 + 起个昵称,就进来了。班级里显示的是昵称,不是真名。
  5. 回到班级管理,能看到进来的人数。人齐了就开始下一步。
手机号只用于登录,不进班级。 一个班级码 + 一个昵称就够区分同班学生了。老师在名单里看到的是昵称,收不到学生手机号——少让一个人看到,就少一份泄露面。
2
组一份卷,发给学生做造题 → 排卷 → 发布,主链路。
▶
首页 › 造题入库 / 选题排卷
  1. 造题入库:机器造题(按知识点、难度、题型批量生成)或人工造题(自己写,进编辑器)。
  2. 选题排卷:从题库里挑题,拖进卷子,调顺序、设分值。
  3. 排完点 发布到班级,选班级、设截止时间。
  4. 学生在学生端「我的作业」里就能看到,点「开始做」。
题不够用? 题库是持续造出来的。先看知识库里有没有现成的,没有再自己造。造过的题会留在题库里,下次直接选。
3
布置不同形态的作业(四种)一份卷只是其中一种。听写、背诵打卡、实验报告各有各的批法。
▶
组卷工作台 › 班级管理 › 题包行「布置」
  1. 在班级题包里找到要发的卷,点 「布置」,按提示选类型:1 纸质卷 / 2 听写 / 3 背诵打卡 / 4 实验报告。
  2. 纸质卷:只填截止日期和一句说明。学生线下做、拍照上传,你按卷面批阅。
  3. 听写:每行一条 提示词|标准答案|提示(第三段可省)。学生线上自默,系统自动判分,你不用逐份看。
  4. 背诵打卡:贴条目全文,用顿号列出 3~8 个必背关键词,设打卡天数(默认 5 天);想让家长见证就打开「家长确认」。
  5. 实验报告:从 10 个内置模板选一个(配制溶液 / 粗盐提纯 / 焰色试验 / 氯离子检验 / 铁盐亚铁盐转化 / 速率影响因素 / 原电池 / 乙酸乙酯 / 中和滴定 / 中和热),六栏结构自动带出。
  6. 点 「进度」 看谁交了、谁没交;背诵与报告还多一个「查看」——能回听录音、看 AI 检查单,再标 合格 或 退回重做。
四类的判分权不在同一处。 听写由系统判(客观比对,无争议);背诵只给关键词三档参考、不打分,合格与否你定;实验报告 AI 只预检「六栏是否填全 + 现象栏关键词是否命中」,判分权在你。AI 不判分是刻意的——化学的「现象描述得对不对」需要人看。
4
看学情:哪些题全班都错了不要看平均分,看错误集中在哪个错点上。
▶
组卷工作台 › 学情看板
  1. 选一份已发布的卷子,看 逐题正确率。低于 40% 的题会被标红。
  2. 点那题,展开 选项分布——错的人都选了哪个选项,比错了几个人更有信息量。
  3. 看 错点聚类:系统把错到同一个概念上的题归到一起,告诉你「这个班卡在『平衡常数随浓度变』上」。
  4. 拿着一两条错点去上课,比讲一整章有效。
数据从哪来? 学生的作答记录默认存 浏览器本地,学生点「同步进度」时才上传。所以刚发下去的卷子可能还没数据,别急着看。
5
用可视化演示讲一个错点学生想不通的地方,让他自己拨一拨参数。
▶
化学可视化实验室 › 14 件演示
  1. 每个演示对应一个具体错点(标题下面标着 MIS-SC-xxx 与题目数量)。
  2. 课堂上投屏,拖参数让学生看结果怎么变——比如「平衡常数温度台」里,改浓度 K 不动、改温度 K 才动。
  3. 每个演示末尾有 5 题变式快测,讲完立刻出题,看学生是否真的转过弯。
  4. 「辩驳台」环节列了 6 句话,其中恰好 2 句是对的,让学生举手判断。
纯本地,断网也能用。 演示页不含任何网络请求,机房没网、或者你不想让学生连网,都不影响。
6
给家长发一份学习情况不用截图、不用手打,一键生成家长能看懂的一段话。
▶
学生端 › 生成家长版文本
  1. 让学生在自己那端点 「生成家长版文本」,得到一段只含总量与趋势的话——没有每题对错,没有排名。
  2. 学生复制后自己发给家长。这一步刻意不自动发送:发给谁、发不发,学生自己决定。
  3. 如果家长要用家长端看,学生点 「生成家长码」,把六位码当面给家长。
家长码和班级码不是一回事。 家长码只能绑一个学生,且家长端是纯只读的——看得到数据,改不了任何东西,也干涉不到教学。
7
把资料放进知识库,以后好找上课用的图、讲义、真题,建一次索引就够了。
▶
老师知识库
  1. 进 知识库,选文件夹导入。原始文件不上传,只在本机建索引。
  2. 用关键词搜,命中后直接打开原文件。
  3. 常给某个班讲的资料,可以固定到班级页,学生也能看到。
索引在本地,换电脑就要重建。 别把它当云盘用。要长期保存的资料,请留在项目盘或自己的硬盘里。

师生家长是怎么绑起来的

这条链只有三环,且只有一条:老师 →(班级码)学生 →(家长码)家长。管理员和开发者不在链上。

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 校场景最硬的一条——也是政府采购常明确要求的「无技术锁定」。