本周概览
常用工具 点开在新标签页打开
未绑定发送人 这些微信在群里发过视频,但还没绑到学员
班级统计
学生阅读数据 ?
有效朗读是分钟数,不是评分:把视频/录音送 VAD 掐掉静音、翻书、
家长说话之后,孩子真正开口读的时长。它一定小于视频本身的长度
(视频 7 分钟、有效朗读 4.7 分钟是正常的)。
总分才是 0~100 的评分:按时长 / 本数 / 发音三项在本班内的 百分位加权(默认 0.3 / 0.3 / 0.4)+ 坚持加分;没跑评测时质量维不参与、权重自动重新归一。
提交是这周发到群里的条数(视频 / 小程序卡片各算 1 条), 包含还没下载到本机的;绘本是从已下载的条目里算出的本数 —— 语音段之间停顿 ≥ 8 秒算另起一本,且不少于本周教研计划本数、上限 12 本。
所以「提交 15 / 绘本 7」是正常的(15 条在内容上算出 7 本);而 「提交 8 / 绘本 0」几乎都是这几条还没下载、或音频不可信(低信噪比)—— 对照右侧「待下载」列就能看出是哪种。
本数 / 时长修正:小程序打卡、补录视频在这里填;填的是本周最终值(不是增量), 改完排名与导出立即生效。
总分才是 0~100 的评分:按时长 / 本数 / 发音三项在本班内的 百分位加权(默认 0.3 / 0.3 / 0.4)+ 坚持加分;没跑评测时质量维不参与、权重自动重新归一。
提交是这周发到群里的条数(视频 / 小程序卡片各算 1 条), 包含还没下载到本机的;绘本是从已下载的条目里算出的本数 —— 语音段之间停顿 ≥ 8 秒算另起一本,且不少于本周教研计划本数、上限 12 本。
所以「提交 15 / 绘本 7」是正常的(15 条在内容上算出 7 本);而 「提交 8 / 绘本 0」几乎都是这几条还没下载、或音频不可信(低信噪比)—— 对照右侧「待下载」列就能看出是哪种。
本数 / 时长修正:小程序打卡、补录视频在这里填;填的是本周最终值(不是增量), 改完排名与导出立即生效。
待补下载清单 在微信里点开这些视频,下一轮会自动补上
班级周汇总(发群版)
学员管理 ?
学员卡片
班级列表
课程管理
课程库 排课列表「课程」下拉的候选来源
课程编号是这门课的键(下拉显示「课程名 (编号)」)——
重复编号保存会被拒;单价按元填写(可有小数),系统按分存储。
列表平时只读:点「编辑」改那一行,行内保存立即生效。
教师与助教
这张名单是排课列表里「上课老师 / 助教」两个下拉的候选来源 ——
在这里维护好,排课时直接点选,不用再手打名字。
同一个人既带课又做助教?录两行(角色不同是两个人格档,不冲突)。
列表平时只读:点「编辑」改那一行,行内保存立即生效。
排课列表
课程表
纵轴 08:00–20:30(每 15 分钟一格)。点任意一节课可以打开点名 ——
打卡、消课、请假都在那里;那一份记录就是学员档案里的「已上课时」。
课堂记录
老师 / 助教课后记的这节课进度、情况、作业,供接手老师和做课后作业的人看。
入口在课程表上点那一节 —— 弹窗下方就是记录区。
同一节课只有一条(再保存是覆盖,不是追加)。
课后作业库
课程开发老师把课后作业按大类 → 级别 → 单元放进来,
管理员/开发老师在课程表上按上课进度把它挂到某一次课,
助教下载后发家长群。
删除是两级:先移入回收站(可恢复),再由管理员彻底删除。
上锁有两档:禁止下载(还能改)与完全冻结(连改都不行)。
RAZ 书库
按级别翻或按书名/文件名搜;点开一本看逐页正文。
正文是 OCR 识别结果(可能有识别误差,例如漏字、插图页无文字),
只作备课参考,以纸质书/PDF 原文为准。
← 左边选一本书
学生名单
直接改「学生姓名」即可,保存后立即生效。家长wxid 是身份键,不要改——
改名不会丢连续打卡记录,改 wxid 会。每次保存都会自动备份到
data/_backup/。
未登记发送人 一键补进名单
班级设置
群ID 改了会导致整班对不上,建议只改「班级名称」和「老师」。加新班级群请先在命令行跑
python -m src.extract_wechat --list-groups 拿群ID。
绑定总览
群只是采集入口:一条视频算谁的,由这里这张
微信 → 学员 表决定,跟它在哪个群发的无关。
班级是学员的属性(取自档案),所以换班会连历史成绩一起带走。
待绑定 表里有这个微信,但还没指认是谁的家长
需要确认的异常 系统只报告,不自动修
全部绑定
筛选只影响这张表;待绑定与异常区块用的是上面的筛选框。
学员与筛选 提交一律用学号,跨班重名也认得准
成绩 / 考勤两类记录都以学号归属学员,录入后立即参与
数据合规的删除范围(禁令 23)。评语与沟通已移到学员档案的
时间线上写(那里同时能看到他的阅读与考勤,写完当场可见)。
考试成绩录入 一次录一个班
先在左上「班级」选一个班,再点载入。只提交填了分数的行 ——
空着 = 这次没考 / 不记,不会被写成 0 分。已有本次成绩的学员会标出来,
不会重复写第二遍。
查询条件
选好条件后点「查询」。
导出视频 按班级 + 时间段,把本地已就位的阅读视频归集出来
导出是复制,不是移动:微信
只有「本地已就位」的视频导得出去 —— 微信默认不自动下载正片,需要先在微信里点开那条视频。
msg\video 里的原片始终留在原处,导出后照样能看、能重跑。只有「本地已就位」的视频导得出去 —— 微信默认不自动下载正片,需要先在微信里点开那条视频。
(还没有开始导出)
定向评测
评测日志
与「跑本周」用的是同一份评测缓存,所以哪一边评过都不会重复计费。
「已评测」的默认不会被提交;「口径已变」(改了模型或苛刻指数)的必须重评, 否则报告会一半新口径一半旧口径 —— 那在榜单上完全看不出来。
「未绑定家长」的默认跳过:评了也归不到人头上,等于白花一次钱。 未归属班级的行显示为 —,选「全部班级」才看得到。
「已评测」的默认不会被提交;「口径已变」(改了模型或苛刻指数)的必须重评, 否则报告会一半新口径一半旧口径 —— 那在榜单上完全看不出来。
「未绑定家长」的默认跳过:评了也归不到人头上,等于白花一次钱。 未归属班级的行显示为 —,选「全部班级」才看得到。
评测层总开关
「单次运行调用上限」填 0 表示不限。第一次正式跑建议先填一个小值(如 20)试水。
并发不要调太高:评测接口有 QPS 限制,撞了会返回限流错误,白花钱。
并发不要调太高:评测接口有 QPS 限制,撞了会返回限流错误,白花钱。
Provider 参数
密钥只保存在本机
config/settings.json,回显时打码。
保存时若字段仍是打码值,会沿用旧的真实值——所以「打开页面直接保存」不会把密钥冲掉。
连通性测试
这一步会**真的调用一次并计费**。它的价值在于确认两件凭文档无法确定的事:
①
下面会原样回显接口返回,便于核对。若归档里没有已就位视频,会用合成测试音—— 那种情况下分数没有意义,只看鉴权是否通过。
PronFluency 的量纲到底是 [0,1] 还是百分制(量纲错了分数会静默算错);
② 当前账号的评测模式与额度是否真的可用。下面会原样回显接口返回,便于核对。若归档里没有已就位视频,会用合成测试音—— 那种情况下分数没有意义,只看鉴权是否通过。
评测缓存与花费
缓存不是优化,是必须的:评测按次计费,而流程是「跑本周 → 发现问题 → 再跑一次」,
没缓存会把同一批音频重复计费好几遍。
改了模型参数(模式/苛刻指数/提示词)会让旧缓存口径不一致,重跑时自动作废重评。
「只清失败项」:评测失败(多半是网络抖动导致的 WebSocket 断开)也会进缓存, 不清就永远没有质量分。这个按钮只删失败的那些,下次运行按条数重新计费 (「清空全部」会把已评好的也一起重花一遍)。
改了模型参数(模式/苛刻指数/提示词)会让旧缓存口径不一致,重跑时自动作废重评。
「只清失败项」:评测失败(多半是网络抖动导致的 WebSocket 断开)也会进缓存, 不清就永远没有质量分。这个按钮只删失败的那些,下次运行按条数重新计费 (「清空全部」会把已评好的也一起重花一遍)。
运行任务
不勾选:只采集 = 增量(取自上次以来的新增),原行为。
勾选后按所选区间显式补采,可只补某个群;区间补采不推进水位线,
不影响之后的增量。跑本周 / 只重算不受这里的筛选影响。
「只采集」是增量的:取自上次采集以来的新增(首次运行取最近 35 天),
周五晚 / 周末发的视频也会被采到,归入其后第一个统计周 —— 不进周报,但区间查询、
待下载引导和区间排名都能看到。
「解密 → 采集」这一步需要
密钥命令:
「解密 → 采集」这一步需要
work/keys/all_keys.json。密钥提取只能在命令行做,
页面有意不提供——否则 Web 服务一旦被访问,密钥就等于暴露了。密钥命令:
python -m src.wechat_keys extract --db-dir "<db_storage路径>" --output work/keys/all_keys.json
实时日志
(还没有运行过任务)
自动下载群视频
只在采集机的微信里点击「未下载」视频。运行时请暂时不要操作那台电脑的鼠标;
已下载的视频会跳过,是否成功以真实文件复核为准。
待下载引导
微信只自动下载封面,正片要点开播放才下载。
按引导逐条在微信里点开,点完(或点了一部分)回来点
「重新检查」,清单会自动缩短。
点完视频后必须重跑它所属的那一周(重新定位视频文件 →「待下载」变「已就位」→ 进榜)。
「只重算」不会重新定位,跑了清单也不会缩短 —— 这是最容易踩的坑。
加载中…
模型服务商
三家都是 OpenAI 兼容协议,区别只在接口地址与模型名 ——
所以选一家、填模型 ID 和 API Key 就能用。
配置一次,档案页的「学情分析」与 AI 对话同时生效。
连接参数
密钥不会回显——页面只显示「已设置 / 未设置」。
打码显示(
sk-****abcd)会让人误以为配好了,而实际可能是空的。
保存在 。
数据汇聚
机构学生名单同步(badi_school)
学员主数据在机构系统(
badi_school),这里只负责拉名单和
把阅读记录推回去。两边靠 7 位「学生编号」认人,
绝不按姓名匹配——重名的孩子会被算成一个人。
拉下来之后还要在「绑定与合规 → 档案与换班」里的「机构学生编号绑定」认领一次。
令牌不会回显——只显示「已设置 / 未设置」,留空保存不会清掉它。
令牌就是机构管理后台「配置中心 → 阅读对接」里那一串,两边必须是同一个。
名单:
推送:
推送:
阅读上行(推送到机构系统)
把本机统计好的阅读记录推给
badi_school,家长在公众号
看到的就是这些数据。LSA 是权威源:数字有出入时以这里为准,
在采集侧修正后重推,不要在机构系统里手改。
周报跑完自动推一次最近 1 周(
badi_read_push.auto_after_weekly);
另有每 6 小时兜底重推。指纹没变化的日子不会重复请求对方接口。
|
预演只统计、不发请求:能看清"会推多少条、多少条因为学员没编号
或视频未就位被跳过"。补推之前先预演一次,不要一上来就推。
角色一览
账号与角色
用户管理
角色能干什么见「权限设置」;改名/改角色也可在「角色设置」操作。
用户只停用、不删除 —— 历史操作记录要能对上人。停用后该账号立即无法登录
(进行中的会话也会失效);恢复启用后要重新登录。
角色 × 权限矩阵
只读。角色与权限由代码定义(
src/core/permissions.py),
刻意不在页面上改 —— 否则一旦把管理员的权限改掉,就再也进不来这个页面了。
要调整某个账号能做什么,到「角色设置」里换角色。
周期坚持分
这是按班课节周期的坚持分:连续打卡周期数 × 每期加分,封顶上限。
一个「周期」= 该班上次课下课 → 下次上课前(跟着排课规则走,停课期间没有课次,
连续性自然不断)。它只用在「导出周期报告」里;
发家长群的周报坚持分走
ranking.streak_bonus(配置文件),
两套互不影响。
按班覆盖:某班的加分节奏与全局不同时在此配置;覆盖里留空的项 = 用全局值。
班号必须是已建档的班级,保存时会校验。
生成备份
打包
备份里不含第三方密钥——
data/(名单、考勤、阅读历史等)与配置文件,
不含 media/(视频原件,几百 MB)与 work/(临时产物)。
备份里不含第三方密钥——
data/ 里全是学生真名,
不该再躺着一份 API Key。代价是导入后需要重新填一次密钥。
已有备份
导入备份
(预演会显示将覆盖哪些文件,不会写盘)
导入是覆盖写:执行前会自动先备份一次当前数据,
data/ 会被包里的版本替换。
保留策略
超出份数的旧备份会在下次生成备份时自动删除。儿童数据不宜无限留存。
云存储
开启后,老师上传的照片 / 视频存到腾讯云对象存储,任何电脑打开档案都能看;
关闭时存在服务器本机——上传功能照常可用,但只有服务器上能看,也占服务器磁盘。
允许上传的类型
没勾的类型点上传会被明确拒绝,不会悄悄存到本机 ——
同一个文件两种去处,用户看不出、排查极痛。
桶参数
SecretKey 不会回显——只显示「已配置(末四位 xxxx)」。
建议用只授予该桶权限的子账号密钥。测试连通性是只读 GET,不会在桶里造任何对象。
上传规则
存量附件
迁移是幂等的:已上云的跳过,可反复点,中断了重跑即可。
默认保留本机副本(云端出问题还有退路),确认没问题后再点「清理本机副本」
—— 那一步会逐条确认云端对象还在才删本机,确认不到的一律保留。
运行环境与自动化
改了配置要生效、或服务异常时用。重启 = 自动以最新配置拉起新进程(约 10 秒内恢复,
本页会自动等它回来);退出 = 彻底停止,要重新登录 Windows(自启开着时)或双击
start_workbench.bat 才会再起。
定时跑本周
每天
点到
点,每小时跑一次
为什么要有这个:家长当天发的视频,跑过一次才会进「待下载」清单,
老师才知道该去微信点哪几个。定时每天跑几轮,就不用等人手动跑完再看 ——
否则刷新清单还得再跑一次。
只在采集机上生效(服务器没有微信库)。机器没开机就自然跳过,开机后不补跑; 到点时如果有别的任务在跑,这一轮跳过,等下一个整点。
下面的执行记录来自各采集机的回执:定时是本机任务,不进「机群遥控」的指令台账, 所以"跑了没跑、跑成没跑成"要看这张表。
只在采集机上生效(服务器没有微信库)。机器没开机就自然跳过,开机后不补跑; 到点时如果有别的任务在跑,这一轮跳过,等下一个整点。
下面的执行记录来自各采集机的回执:定时是本机任务,不进「机群遥控」的指令台账, 所以"跑了没跑、跑成没跑成"要看这张表。
小文件备份(换机续跑用)
只备缓存 / 基线 / 索引 / 名单(几 MB),不备原片视频。
什么时候传:每跑完一次本周就传一份(那时候缓存才刚变), 另外服务启动时看一眼 —— 如果从没备过、或最新那份超过一天,补传一次。
硬盘坏了换电脑时:历史统计不会丢(服务器上有权威副本),但这几样只在本机 —— VAD 缓存(丢了要重算几小时)、评测缓存(花了钱的)、小程序本数差分基线、 周归档、归档索引、群映射、名单 / 学员档案 / 微信绑定(缺了认不出人, 统计里一个人都出不来)。
新机器会自己接上:装好包、配好密钥后第一次启动,如果本机既没有缓存、 也没有周归档和名单,就自动从服务器拉回这台机器最近一份备份(不用敲命令)。 恢复的是"上次备份那一刻"的名单 —— 服务器后来改过名单不会随备份回流。
微信密钥不在备份里(与那台机器登录的微信号绑定,搬过去也用不了)—— 新电脑装好包后按安装流程重新提取即可。
什么时候传:每跑完一次本周就传一份(那时候缓存才刚变), 另外服务启动时看一眼 —— 如果从没备过、或最新那份超过一天,补传一次。
硬盘坏了换电脑时:历史统计不会丢(服务器上有权威副本),但这几样只在本机 —— VAD 缓存(丢了要重算几小时)、评测缓存(花了钱的)、小程序本数差分基线、 周归档、归档索引、群映射、名单 / 学员档案 / 微信绑定(缺了认不出人, 统计里一个人都出不来)。
新机器会自己接上:装好包、配好密钥后第一次启动,如果本机既没有缓存、 也没有周归档和名单,就自动从服务器拉回这台机器最近一份备份(不用敲命令)。 恢复的是"上次备份那一刻"的名单 —— 服务器后来改过名单不会随备份回流。
微信密钥不在备份里(与那台机器登录的微信号绑定,搬过去也用不了)—— 新电脑装好包后按安装流程重新提取即可。
常用工具链接
这里配置的链接会显示在总览页第一屏的「常用工具」里,老师点一下就能跳过去。
改完点「保存链接」立即生效;颜色决定总览上那个方块底色。
目录占用
数据量
最近操作
班
—
班级成长记录
图片 / 视频 / 音频都可以。图片自动压成 webp(浏览器转,转不动服务端兜底);
大视频后台转码,几秒后自动出现。同一个「日期 + 活动名」归成一组,按日期倒序。