教育事业统计数据管理工具 · 专业版 v2.0(优化版)使用指南

适用文件:教育事业统计数据管理工具专业版_优化版.html
版本标识:页面右上角显示 v2.0 优化版 · 离线可用
本指南旨在快速上手使用本工具


一、快速开始

1. 运行要求

项目 说明
运行方式 双击 HTML 文件即可,无需安装、无需服务器、无需联网
推荐浏览器 Chrome / Edge(用到 IndexedDB、File System Access、BroadcastChannel)
外部依赖 零依赖。SheetJS(Excel 读写)与 MD5 已内联进 HTML,两个 CDN 已移除
同目录可选文件 edu_data.db.js(同目录数据库)、edu_config.js(方案配置)。不存在也能正常运行

重要:浏览器本地数据库(IndexedDB)与文件路径 + 浏览器绑定。请把 HTML 放在一个固定文件夹里、用同一个浏览器打开;换路径、换浏览器、换电脑,旧数据不会自动出现,需要用备份迁移(见第七章)。

2. 登录

  1. 打开后是登录页,输入访问密码,回车或点「验证并登录」。
  2. 登录成功后 8 小时内同一标签页免密自动恢复;关闭标签页 / 换浏览器需重新输入。
  3. 连续输错 5 次会锁定 60 秒:输错时提示「还可尝试 N 次」,锁定期内再次点击会提示剩余秒数。
  4. 登录页已写明:「前端校验不等于加密,请勿存放涉密数据」,数据与配置仅保存在本机浏览器。

3. 上手流程

  1. 顶部学段标签切到要处理的学段(幼儿园 / 小学 / 初中 / 高中 / 特教 / 职教)。
  2. 点「🏛 机构配置」→ 导入或批量粘贴本学段的机构编码、名称、管理机构。
  3. 点「⚙ 字段配置」→ 确认字段的「汇总 / 展示」勾选,必要时调整字段名(Excel 列编码)与中文标题。
  4. 在「数据工作区」点上传框,一次选中该学段的全部附表 Excel(可多选)。
  5. 看工作区的「机构匹配」条与附表清单的「表头匹配 x/y」提示;若表头不在第 1 行,设置「表头所在行」或点「⚲ 自动识别」。
  6. 点「🩺 数据体检」核对问题清单 → 无严重问题后点「导出数据 ▾」下载 Excel。

4. 常用功能速查

想做什么 点哪里 一句话提醒
补学校名单 / 改教联体 学段头部「🏛 机构配置」 机构编码要能跟附表对上,对不上会被排除
改列、设合计 学段头部「⚙ 字段配置」 「展示」管显示,「汇总」管合计
传附表 数据工作区上传框(可多选) 文件名带表号会自动认附表
表头不在第一行 「表头所在行」/「⚲ 自动识别」 找不到编码列会红字提示并禁用导出
查数据问题 「🩺 数据体检」 重点看「严重」项和未匹配清单
导出成果表 「导出数据 ▾」 当前学段跟随筛选;全部学段导全量
存今年、比去年 「🗓 年度快照」 只存汇总,不存原始 Excel
备份 / 换电脑 / 撤销清空 「🗄 数据库」 定期导出 edu_data.db.js

二、界面导览

login_sytj
sytj_01

1
2
3
4
5
6
7
8
9
10
11
12
13
顶栏(标题 / 版本标识)
└ 学段切换标签(6 个;有数据的学段带圆点,当前学段为白点、其余为绿点)
└ 学段信息条:附表 N/M 张 · 已配置字段 · 已管理机构 · ⚙字段配置 · 🏛机构配置
├ 字段配置卡片(前 18 个展示字段的预览)
├ 管理机构配置卡片(前 6 所机构预览)
└ 数据工作区
├ 上传框(点击选择 .xlsx / .xls,可多选)
├ 附表清单(每张附表:文件名 / 工作表 / 表头匹配 x/y / 单独表头行 / 移除 / 上传)
├ 「表头所在行」+ ⚲自动识别 + 🩺数据体检 + 🗓年度快照
├ 机构匹配率条(有数据后显示)
├ 数据来源信息条(有效机构行数 / 显示列数 / 保存状态 / 🗄数据库)
├ 筛选排序条 + 「导出数据 ▾」
└ 预览表格(附表分组行 → 中文标题行 → 合计行 → 数据行)

三、机构配置

入口:学段信息条「🏛 机构配置」或卡片上的「管理机构」。

1. 能做什么

按钮 作用
+ 新增机构 弹窗填写机构编码、机构名称、管理机构(所属学段只读)
⬆ 批量导入 文本框粘贴 TSV,格式见下
⬇ 导出机构配置 ▾ ①仅当前学段 ②全部 6 学段合并为一个文件 ③全部 6 学段各一个文件
⬆ 导入机构配置 选 .tsv / .txt / .csv,按第 4 列自动分派学段
🧹 清空当前学段 / 🗑 一键清空全部学段 清空当前学段一次确认;清空全部学段两次确认
表格行 单击行 = 修改;行内「修改 / 删除」按钮可直接操作
学段标签(弹窗内) 不关闭弹窗即可切换管理其他学段

2. 文件格式

1
2
机构编码	机构名称	管理机构	机构类型
1142***536 天池**幼儿园 基层服务中心 幼儿园
  • 第 4 列可选,填「幼儿园 / 小学 / 初中 / 高中 / 特教 / 职教」或对应英文 key;留空归入当前学段。
  • 以 # 开头的行视为注释,会自动忽略;导出文件自带注释头,可以直接改完再导入。
  • 弹窗内「批量导入」的第 4 列同样可选。

3. 编码规范化

合并时会把机构编码统一成字符串再比对,自动处理:全角数字、前后空格 / 全角空格、数字被 Excel 读成 1142001536.0、科学计数法。因此不必再手工清洗编码;但若编码本身写错(少位、错位),仍会被判为未匹配。

机构配置里的「管理机构」决定默认排序(教联体顺序)和「按管理机构筛选」的下拉项,请填写规范、统一。


四、字段配置

入口:学段信息条「⚙ 字段配置」或卡片上的「管理字段」。

1. 表格里每列的含义

列 说明
附表 字段来自哪张教基附表(1002 / 1002续 …)。同一编码在不同附表含义不同,归属必须正确
字段名 Excel 表头里的列编码(如 AH)或中文列名
中文标题 预览与导出时显示的名称
汇总 勾选 = 合计行累加;不勾 = 合计行显示 —。表头复选框可一键全选 / 全不选(只作用于当前筛选出的字段)
展示 勾选 = 出现在预览与导出;不勾 = 保留配置但不展示
操作 修改 / 删除;也可直接单击整行修改

字段上可能出现的三个标记:

  • 编码重名:同一字段编码在另一张附表里另有含义,程序会按附表分别取数,避免串列。
  • 合并:同一指标出现在多张附表,已合并为一列。
  • 导出列名:…:重名列会自动加 〔表号〕 前缀或 #2 后缀,保证导出列名唯一。

2. 按钮速查

按钮 作用
+ 新增字段 / 修改字段 弹窗设置字段名、中文标题、是否汇总、是否展示、所属附表
⬆ 批量导入 每行至少两列 字段名<Tab>中文标题;第 3 列可写附表号,也支持 2 个以上空格分隔
⬇ 导出模板配置 弹窗二选一:「仅当前学段」/「全部 6 学段」(按钮直接标范围,不是「确定 / 取消」)
⬆ 导入模板配置 接受 8 列 TSV、旧版 6 列 TSV、完整配置 JSON
⬇ 完整配置(JSON) 导出 字段配置_完整_*.json,含 colKey、附表归属、合并标记、模板元信息
↺ 恢复默认字段 用内置模板重建当前学段字段配置,覆盖自定义项
🧹 清空当前学段 / 🗑 一键清空全部学段 需确认;清空后可用上面的「恢复默认字段」或 JSON 备份还原
附表筛选按钮(教基1001 / 1002 / 1002续 …) 只看某一张附表的字段
顶部学段标签 在弹窗内切换编辑其他学段,6 个学段配置互相独立

3. 导出 TSV 的 8 列

1
2
字段	中文标题	汇总	展示	附表	学段	导出列名	编码重名
AH 在校生数 1 1 义务教育_分析教基1002_小学 小学 在校生数
  • 汇总 / 展示 用 1 / 0(也接受 true / 是)。
  • 学段 填中文名或英文 key;若省略,则按第 5 列「附表」写入同名的附表模板库,不直接改当前已加载的字段配置。
  • 建议长期备份用「完整配置(JSON)」,信息最全;TSV 适合用 Excel 手工批量编辑。

五、导入附表与表头设置

1. 各学段应上传的附表

学段 附表(表号)
幼儿园 1001
小学 1002、1002续
初中 1003、1003续
高中 1004、1004续
特教 1005
职教 1008、1008续、1008续2

同一学段的多张附表会按机构编码合并成一张表;未上传的附表,其独有字段留空(附表清单里会提示「未上传(该附表独有字段会留空)」)。六个学段的数据互不影响。

2. 上传与自动识别

  • 点击上传框可一次选多个文件。文件名含表号时按最长匹配识别(「1002续」优先于「1002」);文件名无表号时,会按前 2 张工作表的前 8 行内容与各模板字段的匹配率推断(命中 ≥35% 才采纳)。
  • 若文件名像是别的学段的附表,会弹窗询问是否先切换学段再导入;取消则作为自定义附表导入当前学段。
  • 同名附表再次上传 = 覆盖该文件,不会重复挂两张。
  • 未识别的附表会显示在清单末尾,可用下拉框手动指定所属附表;不指定也能按字段名匹配,但同编码列有串列风险。
  • 多工作表文件:附表清单里出现工作表下拉框,可切换取哪一张 Sheet。

3. 表头所在行

旧版该设置是死代码,多行表头时会导致全部数据被静默丢弃。现在可用:

方式 说明
全局「表头所在行」 数据工作区输入框,1–30,修改后应用到本学段全部附表并重新加载
每张附表单独的「表头行」 附表清单里每个已加载文件右侧各有一个小输入框,适合各附表表头行不一致
「⚲ 自动识别」 扫描每张附表前 12 行:含 机构编码 / organization_no 的行权重最高,再比模板字段命中数;达到阈值才自动采用,并逐文件给出结果(未达阈值时保留原设置并提示手动指定)

判断依据:表头行 = 写有 organization_no / 机构编码 及 B、AH 等字段编码的那一行,不是标题行、表号行,也不是中文说明行。

若指定行里找不到机构编码列,预览区会红字列出涉及的文件并禁用导出,不再只显示「未读取到有效数据」。

表头匹配率:每张已加载附表会显示 表头匹配 18/24。低于 35% 时数字标红,上传时也会给出警告,通常意味着表头行不对或选错附表。

移除附表:点「移除」会确认后删除该文件;当本学段附表全部移除时,预览、合计、导出按钮一并重置,不会再导出已删除的幽灵数据。


六、预览、体检与导出

1. 预览表格

  • 表头两行:第一行是附表分组(基础信息 / 教基1002 / 教基1002续 …,带色条),第二行是中文标题;鼠标悬停标题可看字段编码、所属附表、是否重名 / 缺失。
  • 合计行固定在数据第一行;不汇总的列显示 —。
  • 单击任意数据行弹出「数据详情预览」,逐字段列出该机构原始值。
  • 筛选:「按管理机构筛选」下拉;排序:「默认排序(按教联体/自定义)」/「管理机构 升序 (A→Z)」/「管理机构 降序 (Z→A)」;「重置筛选与排序」恢复默认。
  • 默认排序按方案配置:幼儿园、小学、初中按管理机构(教联体)顺序 + 人数降序,高中按校名顺序。
  • 数据区的黄字提示「N 个字段未找到对应列」表示有字段配置在已上传附表里找不到列,导出时该列为空。

2. 机构匹配率条

有数据后显示:机构匹配 90/100 行(90%) + ⚠ 10 行编码未在机构配置中找到,已被排除,可点「查看体检 / 未匹配清单」。全部匹配时显示 ✓。未匹配的行不会进入预览和导出,务必先核对。

3. 🩺 数据体检报告

点「🩺 数据体检」或匹配率条按钮打开,顶部 6 张卡片:附表数据行 / 成功匹配机构 / 未匹配被排除 / 匹配率 / 严重问题 / 提醒事项。

检查项(分级:严重 / 提醒 / 通过):

类别 检查内容
机构匹配 附表编码在机构配置中找不到(列出编码与名称)
表头行 指定行里找不到机构编码列的附表
重复编码 同一附表内编码重复(合并时只保留第一行),列出重复次数
缺失列 已配置字段在附表里找不到对应列
数值异常 汇总列中的负数、非数值文本(如 1234 人),给出样例
表内勾稽 在校生数 / 在园人数 ≠ 各年级(班)之和,容差 2%
逻辑大小 分项大于总量(专任教师 > 教职工数、绿化面积 > 占地面积、在编人员 > 教职工数)
机构名称 附表里的名称与机构配置不一致
  • 列表页每类最多显示前 40 条;未匹配机构、重复编码、缺失字段会全量写入「⬇ 导出报告」,数值异常与勾稽不符只采集前 10 条样例(TSV,UTF-8 BOM,可直接用 Excel 打开)。
  • 「⬇ 未匹配清单」单独导出未匹配编码 + 附表名称 + 建议处理,便于补齐机构配置后重新上传。

4. 导出数据

菜单项 输出
导出当前学段(含筛选/排序) 教育统计数据_小学_YYYYMMDD_HHMM.xlsx,按当前页面视图导出
导出全部学段(一个文件多工作表) 教育统计数据_全部学段_YYYYMMDD_HHMM.xlsx,每个有数据的学段一个 Sheet,用统一默认排序

导出 Excel 的结构:

  • 第 1 行 = 导出列名(colKey,重名列带 〔表号〕 前缀);
  • 第 2 行 = 合计行(管理机构列写「汇总」,不汇总列留空);
  • 第 3 行起 = 数据行;
  • 机构编码、机构名称、办学类型、管理机构强制为文本,避免编码被 Excel 转成科学计数法;
  • 列宽自适应;合计按数值收敛到 6 位小数,避免 280.00000000000006;
  • 两种导出共用同一套取数与合计逻辑,口径一致。

注意:「导出当前学段」会带上你设置的筛选结果;「导出全部学段」导出每个学段的全部有效行。想核对总数时,建议先「重置筛选与排序」。
当前学段无有效数据时,「导出数据」按钮为灰色禁用。


七、数据保存、备份与迁移

点数据信息条右侧「🗄 数据库」打开「本地数据库 · 数据持久化」。

1. 数据存在哪里

  • 主存储:浏览器 IndexedDB。上传附表、改动字段 / 机构配置后自动写入,下次打开自动恢复(表格会提示「已从本地数据库恢复 N 个学段的数据」)。
  • 保存状态:信息条显示「已存入数据库 HH:MM:SS」;若写入失败会显示红字「⚠ 未保存成功,请重新上传或导出备份」。
  • 弹窗表格列出 6 个学段的:数据文件、有效行数、导入时间、数据库保存时间,以及「移除」按钮(只删该学段)。
  • 多标签页同时打开时,机构 / 字段配置、快照、方案、清空 / 撤销等操作会广播提醒其他标签「刷新页面可同步」;上传附表不广播,广播只提醒、不加锁,重要数据建议只在一个标签页里操作。

2. 备份与迁移

按钮 说明
⬇ 导出同目录数据库 生成 edu_data.db.js。Chrome / Edge 支持时可直接选保存位置;否则下载后手动移动到 HTML 同目录。下次打开会自动读取,并与 IndexedDB 比较保存时间、取较新的一份。适合备份、换电脑
⬆ 导入数据库备份 选 .js / .json / .txt(含清空前自动备份),确认后覆盖同名学段数据,其他学段不变
↶ 撤销上次清空 恢复最近一次「清空数据库」之前的数据与配置

3. 清空数据库

点「清空数据库」→ 两次确认 → 自动下载 数据库备份_清空前_YYYYMMDD_HHMM.json,同时把备份存进本地库,随后清空并把机构 / 字段恢复为系统预设。

  • 误清空后立即点「↶ 撤销上次清空」即可还原。
  • 请保留自动下载的备份文件:本地库里也存了一份供「撤销」使用,但跨浏览器 / 跨电脑恢复要靠这份文件(或另行「导出同目录数据库」)。
  • 清空不会删除同目录的 edu_data.db.js;若要彻底清除,需手动删除该文件。程序已在本地库写入一个「清空时间戳」,使清空后的空库比更早导出的同目录文件更新,从而避免旧文件把数据「复活」。

八、🗓 年度 / 批次快照与同比对比

入口:数据工作区「🗓 年度快照」或数据库弹窗「🗓 年度快照」。

  1. 某年度 / 批次数据全部导入并核对完成后,在「批次名称」输入如 2026 年度,点「+ 保存当前数据快照」。系统会汇总6 个学段中有数据的那些(无数据的学段跳过)。
  2. 快照列表显示批次名、保存时间、覆盖学段、机构行数,可删除。
  3. 在「基期快照」「报告期快照」两个下拉框各选一个不同批次 → 点「同比对比」→ 得到按机构编码 × 指标的对比表(差值 = 报告期 − 基期),页面显示前 120 行。
  4. 点「⬇ 导出对比」下载完整 TSV。

最多纳入 10 个指标:在园人数、在校生数、教学班数、教职工数、专任教师、占地面积、图书(册)、固定资产总值、毕业生数、招生数;按各学段实际勾选「展示」且标题匹配的字段取用,没有配置的指标不会凭空生成。

快照只存汇总结果,不存原始 Excel,因此体积很小;要恢复原始数据请用第七章的数据库备份。
建议每个年度、每次正式上报前各存一份,命名统一(如 2025 上报版、2026 上报版)。


九、方案配置(换地区 / 换年度不改源码)

入口:数据库弹窗「⬇ 导出方案配置」/「⬆ 导入方案配置」。

方案 JSON 包含:学段附表清单、附表元数据(表号 / 名称 / 说明)、字段字典模板、管理机构排序、高中校名排序、二级排序列、预设机构数据。

操作 说明
⬇ 导出方案配置 下载 edu_config_YYYYMMDD_HHMM.json,可用文本编辑器修改(如把教联体名称换成其他县市、增减附表模板)
⬆ 导入方案配置 选 JSON(也兼容包了一层 JS 赋值的文件),确认后应用;会重置 6 个学段的字段与机构配置,数据表文件保留
放到同目录 把导出内容包一层 JS 赋值再存为 edu_config.js,例如 window.EDU_APP_CONFIG = {...};,放到 HTML 同目录后打开时自动应用;直接把 JSON 改名成 .js 无效
存库 导入后会写入 IndexedDB(仅本机有效);换电脑需带上导出的 JSON 或同目录的 edu_config.js,只带 HTML 不会带上方案

导入方案前先导出当前方案备份。应用新方案后字段与机构配置会重置,需重新导入该地区机构配置并核对字段;已上传的附表数据文件会保留,不必重传。


十、文件格式速查

文件 格式 用途
.xlsx / .xls 教基附表原表 数据来源,按表号 / 表头识别
机构配置_*.tsv 4 列:编码 / 名称 / 管理机构 / 机构类型;# 注释行 机构配置备份与迁移
字段配置_*.tsv 8 列:字段 / 中文标题 / 汇总 / 展示 / 附表 / 学段 / 导出列名 / 编码重名 字段配置批量编辑
字段配置_完整_*.json JSON(app: edu-stat-fields) 字段配置完整备份(推荐)
edu_config_*.json / edu_config.js JSON(app: edu-stat-scheme) 地区 / 年度方案配置
edu_data.db.js window.EDU_STAT_DB = {...}; 同目录数据库(含原始 Excel 的 base64),自动读取
数据库备份_清空前_*.json JSON 清空前自动备份 / 撤销依据
数据体检_*.tsv、未匹配机构_*.tsv、同比对比_*.tsv TSV(UTF-8 BOM) 核对清单,可直接用 Excel 打开
教育统计数据_*.xlsx 多 Sheet Excel 正式成果表

所有 TSV 均带 UTF-8 BOM,Excel 双击不会乱码;JSON 不带 BOM,便于程序读取。


十一、使用建议与边界

  1. 固定路径 + 固定浏览器,并把 edu_data.db.js 与 HTML 放同一文件夹,形成「网页 + 数据文件」双保险。
  2. 每次正式上报前:上传 → 体检(无严重问题)→ 导出 Excel → 保存年度快照 → 导出同目录数据库备份。
  3. 配置改动后导出一份「完整配置(JSON)」和「方案配置」,比记操作更可靠。
  4. 前端访问口令不能保护数据本身:哈希在源码里、数据在本机浏览器里,可绕过界面读取。请勿存放涉密或含个人敏感信息的数据;涉密场景应改用服务端方案。
  5. 本工具是单文件离线应用,不联网、不上传任何数据;同时也没有服务端校验、没有多人协作与权限控制。
  6. 兼容性:旧版 IndexedDB 数据可直接使用(数据库从 v1 升级到 v2 只新增了快照表,不改动原有表结构)。

本指南对应 v2.0 优化版;如后续版本调整按钮名称或文件格式,请以页面内提示为准。