FORK / 上游项目
fdygpahelper
在浏览器本地计算清华学生 GPA、年级及班级排名并导出 Excel。
本页记录本轮维护的改动和验证结果。完整差异与实时合并状态请查看 Pull Request ↗。
这是 Fork 仓库。保留上游目录、许可与贡献说明；安装和兼容性以上游对应版本为准。查看上游 ↗
准备环境
- Node.js 20+；安装 Yarn 1.22.22。
- yarn install --frozen-lockfile
使用入口
- yarn dev
- yarn typecheck
- yarn build
- node --test tests/calculator.test.mjs
目录结构与职责
- src/main.ts — 页面与上传流程
- src/utils/files.ts — Excel 读取输出
- src/utils/records.ts — 输入规范化及校验
- src/utils/calculator.ts — GPA 与排名
- tests/calculator.test.mjs — 无浏览器回归测试
本次整理
- 新增维护文档和在线文档入口，补全用途、目录、使用路径及验证边界。
- 修复 Excel 数字单元格造成班级字符串操作崩溃；拒绝缺列、空身份和非法学分，新增 6 项回归测试。
检查结果
| 检查项 | 状态 | 证据 / 范围 |
|---|---|---|
| 仓库目录与入口盘点 | passed | 检查 Git 索引中的 16 个路径、README 和项目配置；不等于功能验收。 |
| JSON/notebook parse | passed | 2 个文件通过最终解析；不导入依赖、不执行应用。 |
| XML parse | passed | 1 个文件通过最终解析；不导入依赖、不执行应用。 |
| 完整构建与端到端运行 | not_run | 6 项纯计算/输入回归测试通过（测试需 Node >=22.13）。本机 npm 禁止 remote 包下载，SheetJS CDN 依赖安装失败，未完成 TypeScript 全量构建和浏览器 Excel 端到端验证。 |
| Node 纯逻辑回归 | passed | node --test tests/calculator.test.mjs：6/6 通过。 |
已知限制与后续工作
- 6 项纯计算/输入回归测试通过（测试需 Node >=22.13）。本机 npm 禁止 remote 包下载，SheetJS CDN 依赖安装失败，未完成 TypeScript 全量构建和浏览器 Excel 端到端验证。