Files
kaoyan/docs/verification.md

5.4 KiB
Raw Permalink Blame History

验证记录

2026-10-11,Windows、本地独立虚拟环境,Python 3.12.13 / Node 24.16。

  • 后端:python -m pytest -q,62 passed。Starlette TestClient 提示一条 httpx 迁移 warning,测试退出 0,生产服务不使用 TestClient。
  • 前端:npm test,3 passed;npm run build,TypeScript 检查与 Vite 生产构建退出 0。
  • Edge 实际浏览器:独立端口 8766、独立 .runtime/qa/db,验证导入→科目筛选→收藏→对比→历史趋势→Excel 下载;任务/代理/设置页面;设置保存;390px 手机宽度无页面溢出;无 pageerror。测试数据均标明「自动验收样例」,没有写入正式数据库。
  • 启动脚本:Windows PowerShell 首启、重复启动、停止、重新启动均退出 0;正式服务在 127.0.0.1:8765,健康检查应用身份和项目路径匹配。
  • 真实数据源:proxy_pool /count/ 正常响应;研招页面 curYear=2027 可核实;研招目录第一页(包括 081200 方向)可以匿名返回,第二页需要登录,详见下方登录会话修复;掌上考研精确匹配北京大学,2025 年 081200 查询返回 1 条门类参考线和 2 条历史计划。真实探测不写入正式目录。
  • 独立只读审查:复现并修复专项线覆盖、同名跨域 Cookie、任务失败恢复竞态、服务退出被误取消、文件往返丢失身份字段、学院人数误升格、YAM 种子误识别、院校关键词范围、参考书 JSON 字符串、业务限流等问题,补充相应回归。

初次自动验收未使用真人学信网账号。后续登录修复使用用户已保存的 Cookie 进行了有限的只读分页验证,未对全部院校进行实网抓取。登录后的全国采集能力取决于账号状态、代理可用性、开放目录年份和数据源限流。

复跑浏览器验收(只使用测试库):

.\.venv\Scripts\python.exe -m studio --port 8766 --data-dir .runtime\qa\db
# 在另一个终端运行
.\.venv\Scripts\python.exe tools\browser_qa.py

正式服务不会自动开始采集,需要用户在网页创建任务。

代理池服务控制修复(2026-10-11):

  • 复现原因:代理池 API / 调度器以管理员权限运行,普通权限的 CIM 读取不到命令行;旧调用误判为其他进程,且把 PowerShell 本地编码按 UTF-8 解码。新适配层分别显示状态、权限和外部 Redis,不改写原代理池项目。
  • 14 项新增回归覆盖受限状态、重复启动、无权停止、中文输出、错误/过期 PID、停止权限、操作超时、Python 引号、真正的脚本入口、并发配置快照和后台输出管道。后端合计 49 passed。
  • tools/proxy_service_qa.py:复制管理脚本到临时测试目录,启动无抓取行为的假 API / 调度器;实际验证普通权限 start → 重复 start → status → stop → API 关闭,PASS。仅只读检查现有 Redis,正式代理池未停止。
  • 独立代码审查确认真实脚本入口校验和一次操作使用同一配置快照;最终无 Critical / Important。
  • 正式界面 Edge 验收:显示 API 正常、两个进程的管理员权限、外部 Redis;点击检查状态成功,点击启动复用现有进程,无乱码或原错误堆栈,状态检查与复用保留当前路由,停止按钮给出权限限制说明。390px 代理页无溢出,无浏览器错误;截图保存为「代理池修复预览.png」。完整独立测试库浏览器流程亦再次通过。

登录会话与分页修复(2026-10-11):

  • 复现:两次任务都在北京大学的前 10 个专业、107 条记录后收到「请登录」。匿名方向第一页也返回 flag=true;原来的第一页验证不能证明登录成功,且任务的登录失败没有更新登录卡片。
  • 使用相同代理和已保存 Cookie,只读请求专业第二页仍提示登录;访问 /zsml/a/dw.do 同步 CAS 会话后,专业第二页和方向第二页均正常。没有要求用户重新提供凭据,没有输出 Cookie 或密码。
  • 请求 pageSize=50 时,真实接口返回 size=10、startOfNextPage=10。修复按实际下一页位置继续,防止用 50 作为偏移跳过记录。
  • 13 项新增行为回归覆盖匿名第一页误判、已有 SSO Cookie 初始化、服务端页大小限制、原页自动恢复、恢复次数限制、任务与登录状态同步及断点保留、限流分类、人工验证码、网络出口变化,以及验证中切换出口、清除/替换凭据、新验证码拦截覆盖旧证明的并发情形。
  • 修正后实网只读验证:15 个专业跨两页、081200 的全部 15 条原始研究方向跨两页,当前代理保持不变,正式数据库写入 0 条。
  • tools/auth_browser_qa.py:模拟登录已完成后收到失效状态,原版因不再轮询而失败;修正后登录卡片自动显示「需重新登录」并清除旧成功提示。独立端口 8766 和正式端口的 Edge 验收通过;390px 无溢出,无浏览器错误。原完整工作区浏览器验收再次通过。
  • 正式服务重启后,使用已有加密 Cookie 再次验证第二页成功,登录卡片显示最新检查结果。原任务保留 107 条记录和 10 个已完成单元,仍可从断点恢复,未自动启动全国采集。截图为「登录修复预览.png」。最终 62 项后端测试、3 项前端测试和生产构建通过;独立只读审查未发现剩余 Critical / Important。