绘本阅读统计 · 本地工作台

本机是采集机:负责采集微信朗读视频、跑任务、上传服务器。 名单与机构数据只在服务器那台编辑;榜单与周报也以服务器为准。 本机是否在线、版本号,请在服务器的「系统设置 → 数据汇聚 → 机群遥控」里查看。

本周概览

常用工具 点开在新标签页打开

未绑定发送人 这些微信在群里发过视频,但还没绑到学员

班级统计

按统计周:一周一周地看,数字能和周报逐字对上。

学生阅读数据 ?

选好班级、把时间口径切到「按统计周」,再点「载入本周名单」。
只在小程序里跟读的孩子,群里没有视频、系统算不出任何数 —— 在这里填了才会进榜。 两个格子都留空 = 不修正(不是 0)。
有效朗读是分钟数,不是评分:把视频/录音送 VAD 掐掉静音、翻书、 家长说话之后,孩子真正开口读的时长。它一定小于视频本身的长度 (视频 7 分钟、有效朗读 4.7 分钟是正常的)。
总分才是 0~100 的评分:按时长 / 本数 / 发音三项在本班内的 百分位加权(默认 0.3 / 0.3 / 0.4)+ 坚持加分;没跑评测时质量维不参与、权重自动重新归一。
提交是这周发到群里的条数(视频 / 小程序卡片各算 1 条), 包含还没下载到本机的;绘本是从已下载的条目里算出的本数 —— 语音段之间停顿 ≥ 8 秒算另起一本,且不少于本周教研计划本数、上限 12 本。
所以「提交 15 / 绘本 7」是正常的(15 条在内容上算出 7 本);而 「提交 8 / 绘本 0」几乎都是这几条还没下载、或音频不可信(低信噪比)—— 对照右侧「待下载」列就能看出是哪种。
本数 / 时长修正:小程序打卡、补录视频在这里填;填的是本周最终值(不是增量), 改完排名与导出立即生效。

待补下载清单 在微信里点开这些视频,下一轮会自动补上

班级周汇总(发群版)

学员管理 ?

学员卡片

班级管理

班级统计 → 课程与排期 →

班级列表

课程管理

课程库 排课列表「课程」下拉的候选来源

课程编号是这门课的键(下拉显示「课程名 (编号)」)—— 重复编号保存会被拒;单价按元填写(可有小数),系统按分存储。
列表平时只读:点「编辑」改那一行,行内保存立即生效。

班级课时设置 学员档案的「已上课时 / 剩余课时」按它算

点「编辑」改一个班的课时,行内「保存」立即生效。

绘本库

book_id 是排期引用的键(B001)。改 id 会让已有排期指向空号 —— 要改请先在排期页把引用一起换掉。
列表平时只读:点「编辑」改那一行,行内保存立即生效。

每周排期 周报「完成率」的口径取自这里

「班级」必须选班号(P23)—— 写群名不会报错, 但周报的完成率会永远是 0,而且从报告上看不出来。
列表平时只读:点「编辑」改那一条,行内保存立即生效。

教师与助教

这张名单是排课列表里「上课老师 / 助教」两个下拉的候选来源 —— 在这里维护好,排课时直接点选,不用再手打名字。 同一个人既带课又做助教?录两行(角色不同是两个人格档,不冲突)。
列表平时只读:点「编辑」改那一行,行内保存立即生效。

排课列表

这段区间的课

展开是**只读**的:改课时/时间要改上面的规则,这一段会跟着重算。

课程表

纵轴 08:00–20:30(每 15 分钟一格)。点任意一节课可以打开点名 —— 打卡、消课、请假都在那里;那一份记录就是学员档案里的「已上课时」。

课堂记录

老师 / 助教课后记的这节课进度、情况、作业,供接手老师和做课后作业的人看。 入口在课程表上点那一节 —— 弹窗下方就是记录区。 同一节课只有一条(再保存是覆盖,不是追加)。

课后作业库

课程开发老师把课后作业按大类 → 级别 → 单元放进来, 管理员/开发老师在课程表上按上课进度把它挂到某一次课, 助教下载后发家长群。 删除是两级:先移入回收站(可恢复),再由管理员彻底删除。 上锁有两档:禁止下载(还能改)与完全冻结(连改都不行)。

RAZ 书库

按级别翻或按书名/文件名搜;点开一本看逐页正文。 正文是 OCR 识别结果(可能有识别误差,例如漏字、插图页无文字), 只作备课参考,以纸质书/PDF 原文为准。
← 左边选一本书

学生名单

直接改「学生姓名」即可,保存后立即生效。家长wxid 是身份键,不要改—— 改名不会丢连续打卡记录,改 wxid 会。每次保存都会自动备份到 data/_backup/。

未登记发送人 一键补进名单

班级设置

群ID 改了会导致整班对不上,建议只改「班级名称」和「老师」。加新班级群请先在命令行跑 python -m src.extract_wechat --list-groups 拿群ID。

绑定总览

群只是采集入口:一条视频算谁的,由这里这张 微信 → 学员 表决定,跟它在哪个群发的无关。 班级是学员的属性(取自档案),所以换班会连历史成绩一起带走。

待绑定 表里有这个微信,但还没指认是谁的家长

需要确认的异常 系统只报告,不自动修

全部绑定

筛选只影响这张表;待绑定与异常区块用的是上面的筛选框。

机构学生编号绑定 还没拉取

阅读记录要回流到机构系统,必须先把每个孩子的「学生编号」对上。 编号由机构系统生成,这里只做认领:按姓名 + 班级给出候选,点一下即绑。
同名的孩子只能靠班级区分,所以候选里的班级一栏必须核对 —— 绑错等于把别人的阅读记到这个孩子头上。

学员档案 本系统唯一档案 · 学籍字段保护

档案的「姓名 / 出生年月 / 班级 / 备注」可以在左侧「学员管理」页新增与修改 (每次改动都会打 local_* 标记并留审计)。 学号 / 入学日期 / 学籍状态为保护性只读(防误改身份键),如需调整请联系管理员。 下面这里只做一件事:换班(只写「班级」这一个字段)。

换班 改的是学员档案的班级;先预演,再确认

「确认换班」在预演之前保持禁用 —— 先看清要动谁、动到哪, 再决定落盘。这一步不可撤销(能改回来,但会留下两条记录)。

数据合规 · 软删除 家长要求删除 → 先停统计,可恢复

加入排除后,这位学员立即从排名、查询、导出里消失(归档与档案原样保留, 随时可恢复)。只有管理员能做这一步。要彻底清除数据,请用下面的硬删除。

数据合规 · 硬删除 物理清除,先预演再确认,产出删除工单

⚠️ 此操作不可逆:将物理删除名单行、绑定行、事件归档、坚持分键与教学记录, 并删除受影响周的排名产物。学员档案(不开删除通道)、微信原片、云端音频不在此删除, 会列进删除工单转人工处理。删除记录本身进审计日志。

学员与筛选 提交一律用学号,跨班重名也认得准

成绩 / 考勤两类记录都以学号归属学员,录入后立即参与 数据合规的删除范围(禁令 23)。评语与沟通已移到学员档案的 时间线上写(那里同时能看到他的阅读与考勤,写完当场可见)。

考试成绩录入 一次录一个班

先在左上「班级」选一个班,再点载入。只提交填了分数的行 —— 空着 = 这次没考 / 不记,不会被写成 0 分。已有本次成绩的学员会标出来, 不会重复写第二遍。

考勤与课时 一次记一个班 · 点名记录在这里撤销

默认「不记录」:只给需要记的人选状态,不会因为漏改一行 就凭空多出出勤。当天已有考勤的学员会标出来并锁住 —— 要改那条去他的档案或下面的台账,不在这里叠加第二条(叠加会重复扣课时)。
课程表里点名消课写进来的记录,来源标着点名,只能撤销、不能改 —— 撤销后这一条的课时 / 请假 / 迟到全部回到点名前的状态(这三个数字都是 从这张表现算的,没有别处缓存)。手工补录的还是走「删除」。

查询条件

选好条件后点「查询」。
选好条件后点「查询」。

导出视频 按班级 + 时间段,把本地已就位的阅读视频归集出来

导出是复制,不是移动:微信 msg\video 里的原片始终留在原处,导出后照样能看、能重跑。
只有「本地已就位」的视频导得出去 —— 微信默认不自动下载正片,需要先在微信里点开那条视频。
(还没有开始导出)

定向评测

评测日志 评测进行中,请勿离开本页;关掉页面评测也会在后台继续

          
与「跑本周」用的是同一份评测缓存,所以哪一边评过都不会重复计费。
「已评测」的默认不会被提交;「口径已变」(改了模型或苛刻指数)的必须重评, 否则报告会一半新口径一半旧口径 —— 那在榜单上完全看不出来。
「未绑定家长」的默认跳过:评了也归不到人头上,等于白花一次钱。 未归属班级的行显示为 —,选「全部班级」才看得到。

评测层总开关

「单次运行调用上限」填 0 表示不限。第一次正式跑建议先填一个小值(如 20)试水。
并发不要调太高:评测接口有 QPS 限制,撞了会返回限流错误,白花钱。

Provider 参数

密钥只保存在本机 config/settings.json,回显时打码。 保存时若字段仍是打码值,会沿用旧的真实值——所以「打开页面直接保存」不会把密钥冲掉。

连通性测试

这一步会**真的调用一次并计费**。它的价值在于确认两件凭文档无法确定的事: ① PronFluency 的量纲到底是 [0,1] 还是百分制(量纲错了分数会静默算错); ② 当前账号的评测模式与额度是否真的可用。
下面会原样回显接口返回,便于核对。若归档里没有已就位视频,会用合成测试音—— 那种情况下分数没有意义,只看鉴权是否通过。

评测缓存与花费

缓存不是优化,是必须的:评测按次计费,而流程是「跑本周 → 发现问题 → 再跑一次」, 没缓存会把同一批音频重复计费好几遍。
改了模型参数(模式/苛刻指数/提示词)会让旧缓存口径不一致,重跑时自动作废重评。
「只清失败项」:评测失败(多半是网络抖动导致的 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 缓存(丢了要重算几小时)、评测缓存(花了钱的)、小程序本数差分基线、 周归档、归档索引、群映射、名单 / 学员档案 / 微信绑定(缺了认不出人, 统计里一个人都出不来)。
新机器会自己接上:装好包、配好密钥后第一次启动,如果本机既没有缓存、 也没有周归档和名单,就自动从服务器拉回这台机器最近一份备份(不用敲命令)。 恢复的是"上次备份那一刻"的名单 —— 服务器后来改过名单不会随备份回流。
微信密钥不在备份里(与那台机器登录的微信号绑定,搬过去也用不了)—— 新电脑装好包后按安装流程重新提取即可。

常用工具链接

这里配置的链接会显示在总览页第一屏的「常用工具」里,老师点一下就能跳过去。 改完点「保存链接」立即生效;颜色决定总览上那个方块底色。

目录占用

数据量

最近操作

班 —

班级成长记录

图片 / 视频 / 音频都可以。图片自动压成 webp(浏览器转,转不动服务端兜底); 大视频后台转码,几秒后自动出现。同一个「日期 + 活动名」归成一组,按日期倒序。

播放

执行日志


    

只采集

增量采集:取自上次以来的新增,日常用这个,原行为。
按区间补采:按起止日期(含当天)显式重采,不推进水位线。 按群补采不支持遥控,请到那台采集机的本机工作台操作。

一键补历史

按自然周口径,对每个已完结的历史周各下发一条「只重算」, 采集机会按周顺序逐周执行(本周不在内,日常「跑本周」照旧)。 前提:那些周的视频已经采集在本机 —— 只重算只消化本机已采数据, 不重新采集。

任务进度

正在读取…

      
采集机每 30 秒推一批增量。如果这里一直空着,多半是那台还在 旧版采集机 —— 旧版只在任务结束时推一次完整日志。

远程诊断

只读诊断,支持 netstat / tasklist / dir / type / findstr / where / ping / ipconfig / ffprobe 以及 python tools/xxx.py。不允许管道、重定向、命令拼接,不允许 python -c。命令留空则执行上面选中的诊断项。

绘本阅读统计 · 本地工作台

请用工作台账号登录。

AI 助手
点名与消课
「到课 / 迟到」按这条排课的课时扣课时,「请假」不扣。 重复点同一节课只覆盖、不会重复扣 —— 同一节课同一学员只留一条记录。
本节课记录
情况
课后作业包
1 / 1

操作

说明