Files
kaoyan/docs/verification.md

41 lines
5.4 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 验证记录
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 进行了有限的只读分页验证,未对全部院校进行实网抓取。登录后的全国采集能力取决于账号状态、代理可用性、开放目录年份和数据源限流。
复跑浏览器验收(只使用测试库):
```powershell
.\.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。