3.3 KiB
研选项目接手指南
本项目整理考研招生与历史结果数据,提供按专业、目标分、地区筛选院校,以及查看方向、考试科目、院校详情、收藏和对比的离线界面。本指南以 2026-10-30 仓库交付为准,不代表实时招生结果。
快速查看
- 安装 Git 和 Git LFS。仅看代码或界面时,可先设置
GIT_LFS_SKIP_SMUDGE=1再克隆,避免自动下载约 3.32 GiB 数据库压缩包;需要备份时运行git lfs pull。 - 打开
docs/择校UI/index.html。界面依赖同目录的数据文件和图片,不要单独复制 HTML。手机浏览器的本地文件策略可能影响图片加载,详见docs/择校UI/README.md。 - 先选择专业,再到院校库按目标分、地区或学校属性筛选;可进入详情、方向和对比。
website/是另一条早期原型,不等于现行离线 UI。 - 阅读
docs/项目进度总览_UI制作基线_20261030.md、docs/择校UI/README.md和docs/agent_handoffs/20261030_专业入口与全组核查.md,了解交付数据、已实现功能与限制。
数据与恢复
数据库备份/ 是两份分别生成的 SQLite 在线备份 gzip 包,主库用于整理与交付,采集库保存平台采集数据。压缩包未加密,仓库成员应按数据权限使用。大小、SHA-256 和恢复方式见该目录 README 与 receipt;两库并非同一时刻的原子快照。解压到独立目录并校验后使用,切勿覆盖正在运行的生产库。
事实层优先查 fact_admission、fact_dest、fact_score_dist、fact_score;交付界面部分指标来自 fact_global。院校、专业和年份必须保留来源、粒度与缺失状态。2027 招生计划与 2026 复试线属于不同年份;冲稳保依据复试线区间上限,不代表录取概率。
专业代码和院校代码按文本处理,保留前导零和字母;跨表关联保留院系键 xy_id。招生人数应区分专业级和方向级语义,不能直接相加。报录比及调剂缺额目前不作为可靠 UI 指标。
待核对的口径差异:项目规则与 10-30 总览写 B2 平台校库 1,039,docs/审计口径规范.md 和根 README 的旧内容写 1,019。本次未重跑分母核查,不据此给出覆盖率;使用前按数据表与审计口径复核并标明时点。
脚本与报告
核心脚本位于 脚本/ 和 数据库/。脚本/UI导出快照_20261030/ 是从本机运行暂存复制的 6 个 UI 导出和打包脚本,原始内容保留;脚本使用 D:/择校 绝对路径,导出会覆盖 UI 数据,打包会覆盖同名 zip。迁移后先检查路径、数据库和输出位置,不要直接在生产目录运行。
审计报告/ 中收录本次选取的历史审计报告,报告数字有各自的时间和分母,不代表最新实时结果。数据修改后的审计命令及硬性规则见 AGENTS.md;全量审计和事实层重建会读写数据库,应先准备可恢复副本。
仓库边界
仓库包含代码、界面、选取的文档和压缩快照;原始来源、历史归档、运行暂存、浏览器登录态、采集 token 和在线数据库文件未完整上传。不要使用 git add .,应逐项审查拟提交文件及密钥。此前对当前 token 的精确匹配检查不能替代完整的凭据审查。