成绩记录册说明书

01这是什么

一个用来记录行测类试卷练习成绩的网页工具。你把每次模考的错题数填进去，它按各题型的每题分值自动折算得分，并把每次成绩攒成趋势。

核心逻辑只有一条公式

满分

Σ 题数 × 分值

扣分

Σ 错题 × 分值

得分

满分 − 扣分

正确率

(题数−错题)/题数

能做什么

• 多套卷型并存：江苏省考、国考、自建模考卷各自独立的分值结构，互不干扰。
• 自动计分：填错题数即刻出分，附带每个题型、每个模块的失分与得分小计。
• 趋势统计：月度热力图、得分柱状图、模块/题型正确率、历次成绩对比。
• 成绩卡：每次记录自动生成一张可保存为图片的成绩卡，适合打卡、发群里。

不做什么（重要）

• 不联网、不上传：所有数据存在你浏览器的 localStorage 里，服务器收不到任何东西。
• 不自动同步：换浏览器、换设备、清缓存都不会自动带过去，需要手动导出 JSON 搬家。
• 无账号体系：打开即用，也因此没有「忘记密码」这类麻烦。

02五分钟上手

1. 打开页面双击 index.html，或访问线上地址 scorecal.pages.dev。首次打开是空的，自带两套试卷类型（江苏省考 A 类、国考行政执法）可用。
2. 选类型 + 起名「试卷类型」选一套卷；「试卷名称」自己起，比如 2026 江苏 A 类 第 3 套。名字填过一次，下次输入会自动联想。
3. 填日期默认是今天，考完隔几天补录记得改。
4. 填错题数往下滚到「分题型错题」，只填有错的题型，没填的按 0 算（即全对）。右侧实时显示该题型扣了几分。
5. 保存点「保存成绩」，下方成绩明细立刻出现这条记录，顶部计分条同步更新。
6. 看统计切到「02 数据统计」，热力图、柱状图、成绩卡都已按这条记录算好。

03录入成绩详解

表单字段

计分条的四个数字

• 满分：当前类型所有题型「题数 × 分值」之和，改类型分值会跟着变。
• 错题：本次填写的错题总数，跨全部题型累加。
• 得分：满分减去扣分，最低显示 0，不会出现负分。
• 总用时：手填优先；手填留空或填 0 时，等于各模块用时之和，都没填则显示 —。

成绩明细列表

• 按日期倒序排列，最新一条在最上；同一天的多条按录入顺序倒排。
• 顶部「筛选」可按试卷类型过滤，右侧同步显示该批记录的平均分 / 最高 / 最低。
• 每条记录右侧有编辑与删除；点编辑会把内容回填到上方表单，此时保存按钮上方会出现「正在编辑已有记录」提示，不会新增一条。
• 删除需要二次确认，删掉后无法恢复。

04数据统计怎么看

页面顶部有类型筛选，默认按最近使用/全部类型统计。以下模块自上而下排列：

整体概览（四格 KPI）

练习记录热力图

• 以月历形式铺开，周一为一行起点，最早可回溯到 2025-06。
• 格子颜色代表当日平均正确率，五档：0–59 / 60–69 / 70–79 / 80–89 / 90+，越深越好。
• 标题两侧的 ‹ › 切换月份；右侧显示「本月 N 天 · 均 xx.x%」。
• 点任意有记录的日期，下方「当日记录」列出那天所有成绩；未来日期显示为虚线空格。
• 同一天练了多套，取那天的平均值上色，具体每套在下方列表里看。

各次得分柱状图

按日期先后排，柱子是每次得分，横虚线是这一批记录的平均分。手机上柱子会横向自适应，不会挤到右侧。

模块答题情况 / 题型掌握情况

• 两组都可切换口径：正确率（对/总）与错误率（错/总），两者互补，加起来 100%。
• 「模块」是粗粒度（如判断推理整体），「题型」是细粒度（如其中的图形推理、逻辑判断）。
• 排序按题量，右侧标注「对 x / y 题」，一眼能看出哪块最拖分。
• 切换口径只会改变显示方式，不会改动已有数据，且会被记住。

历次成绩表

八列：日期 / 试卷 / 类型 / 得分 / 正确率 / 环比 / 错题 / 用时。「环比」算的是正确率的差值（本条 − 上一条，单位百分点），不是分数的差值——上升标红并带 +，下降标蓝灰，差距小于 0.05 个百分点记为「持平」。

05试卷类型与分值

在「03 数据管理 → 试卷类型」里维护。一个类型 = 若干「分组」下挂若干「题型」，每个题型有自己的题数与每题分值。

内置两套（可直接用）

江苏省考行测 A 类 · 135 题 / 100 分

国考行政执法 · 130 题 / 100 分

自己建一套

1. 新增点「新增试卷类型」，编辑器出现在下方。
2. 填表逐行填「分组 / 题型 / 题数 / 每题分值」，分组相同的行会自动归为一个模块。右侧「小计」实时算，底部汇总「合计 N 题 · 满分 M 分」。
3. 增删行「添加题型」加一行，行尾 × 删除该行。
4. 保存类型题数须大于 0，分值不能为负，题型名称不能为空。

• 复制类型：从已有类型一键复制副本，改几行就能得出一套新卷，比从零建快。
• 删除类型：该类型下还有成绩记录时会拒绝删除，需先清掉那些记录。
• 内置类型可以改分值、改名，但升级版本时若结构未改动会被刷新为最新官方分值；你自己建的类型永不被动。

06成绩卡与导出

「数据统计」页最下方是成绩卡区，每条记录自动渲染一张卡片（默认只展示最近若干张，点底部按钮可展开全部）。

卡片上有什么

• 顶栏：成绩记录册 · SCORE SHEET 与考试日期。
• 左侧：试卷名称与类型；右侧：得分 / 满分，得分正下方一行小字是总用时（未填则显示 —）。
• 中段：分组条形图，长度代表该模块正确率（或错误率），右侧标注百分比或「错 x / y」。
• 底部：复盘备注（最多两行）、生成日期与当前统计口径。

切换口径

卡片区右上角的 正确率 / 错误率 切换只影响这一区，会让条形图与右上角总览文字一起变，不影响其它统计模块。

保存为图片

每张卡片下方「保存图片」会以 2.5 倍尺寸重绘并下载 PNG，文件名格式为 试卷名称-成绩卡-日期.png。文件名里的 \ / : * ? " < > | 等非法字符会被替换成下划线。

07数据备份与迁移

在「03 数据管理 → 数据备份与清理」里操作。

数据到底存在哪

• 存在浏览器 localStorage 的 score_sheet_v1 键下，按域名/文件路径隔离。
• 本地双击打开的 file:// 与线上 scorecal.pages.dev 是两套完全独立的数据，互不相通。
• 以下操作都会让数据消失，且无法恢复：清除浏览器数据 / 使用无痕模式后关闭窗口 / 换浏览器 / 换电脑 / 重装系统。

08常见问题

换了台电脑，数据怎么带过去？

旧设备「导出 JSON」→ 把文件传过去 → 新设备打开工具「导入数据」选择该文件。类型与成绩会一起过去，导入是合并不是覆盖。

我改了某题型的分值，为什么旧成绩没变？

这是设计如此。成绩保存时已快照当时的题型结构，改分值只影响之后新录入的记录，历史分数保持不变，趋势才不会被追溯性篡改。

总用时为什么和我填的不一样？

总用时有两处来源：表单里的「总用时」输入框，以及各模块卡片里的用时。规则是手填优先；留空或填 0 时取模块用时合计；两处都没填才显示 —。

得分能出现负数吗？

不能。得分最低截断到 0；而且每个错题输入框都有该题型题数作为上限，填超了会被自动截断，正常操作不会把分数扣成负的。

同一天练了两套，热力图怎么算？

取当天所有记录的平均正确率上色，点开这一天可以在下方看到当天每一条记录与各自得分。

柱状图/热力图在手机上显示不全？

柱状图会按容器宽度自适应（每根柱子至少保留可读宽度），热力图是七列月历、随屏幕缩放。若仍异常，检查是否用了浏览器「桌面版网站」模式。

成绩卡保存失败？

少数内嵌浏览器/老旧内核不支持 canvas 转图片。换 Chrome / Edge / Safari 最新版打开即可。

能多人共用一份数据吗？

不能。数据是本地单机的，没有账号与同步。想共享就用导出的 JSON 互相传递，或把成绩卡图片发出去。

09部署与本地使用

最简单：直接用文件

双击 index.html 即可，无需安装任何东西、无需联网。缺点是数据绑定在这个文件路径上，移动文件后浏览器会视作新站点（数据不跟随）。

线上版：Cloudflare Pages

当前线上地址 https://scorecal.pages.dev。更新发布需要 Node 18+ 环境，在项目目录执行：

说明：发布时只上传 index.html，.git、.workbuddy、wrangler.toml 等本地文件不会被打包上传。

功能一览（速查）