Menü
维护测试分层、回归命令、契约测试与复杂链路验证策略的手册。
Mit Codex oder Claude installieren Kopieren Sie diesen Prompt, fügen Sie ihn in Codex, Claude oder einen anderen Assistant ein und lassen Sie die Skill-Seite prüfen und installieren.
Basierend auf der SOC-Berufsklassifikation
维护配置系统、服务编排、离线工具与自动化调度的手册。
维护 Web 入口、Flask app factory、页面探针与全局运行时 hook 的手册。
维护摘要生成、缓存、任务状态、SSE 通知与模型切换全链路的手册。
使用 MinerU 云 API 解析 PDF、Office、图片或 HTML 文档，并通过轮询或批量接口获取结果。
维护 aslite 数据层、SQLite KV、仓储、索引与底层状态库的手册。
维护模板、静态脚本、CSS、manifest 与页面级交互契约的手册。
| name | arxiv-sanity-testing |
| description | 维护测试分层、回归命令、契约测试与复杂链路验证策略的手册。 |
| license | MIT |
| compatibility | opencode |
| metadata | {"category":"repo-maintenance","repo":"arxiv-sanity","audience":"maintainers"} |
tests/README.md, tests/conftest.py, tests/unit/, tests/integration/, tests/live/, tests/e2e/, tests/validate_summary_flow.py.github/workflows/, docs/DEVELOPMENT.mdtests/README.mdtests/conftest.pydocs/DEVELOPMENT.mdunit -> 逻辑与源码契约
integration -> Flask test_client 接口协作
live -> 真实服务探测
e2e -> 真实服务器上的完整流
manual diag -> tests/validate_summary_flow.py 等脚本
tests/conftest.py 默认切临时 ARXIV_SANITY_DATA_DIR，避免污染真实数据。conda activate sanity
ARXIV_SANITY_DATA_DIR=$(mktemp -d) pytest tests/unit tests/integration -q -k "not daemon"
npm run build:static + template/frontend contract 测试pytest tests/live/test_summary_frontend_behavior.py -qtests/unit/test_sse.py、tests/unit/test_sse_sqlite_ipc.py、tests/integration/test_api_sse.pytests/unit/test_summary_*、tests/unit/test_tasks_*、tests/integration/test_api_summary.pytests/unit/test_upload_*、tests/integration/test_api_uploads.pytests/unit/test_tasks_summary_force_refresh.py、tests/unit/test_summary_cancellation.py、tests/unit/test_tasks_summary_status_events.py、tests/unit/test_upload_task_status_sse.py、tests/unit/test_tasks_upload_deleting.pytests/unit/test_settings_*、tests/unit/test_run_services.pytests/README.md 的交叉引用是否一致python bin/run_services.py
python bin/huey_consumer.py tasks.huey -w 4 -k thread
python tests/validate_summary_flow.py --pid <pid> --trigger --poll
ARXIV_SANITY_DATA_DIR，pytest 可能不再是隔离环境。tests/unit/test_frontend_sse_wiring.py 主要是源码契约守卫；如果你改的是 summary 页 fallback model 的实时刷新，记得再跑 live 浏览器测试。1. 改动触达哪些文件？
2. 是否涉及 API / repository / task / SSE / upload / summary / template / config？
3. 默认 unit + integration 是否已跑？
4. 是否补跑了该模块专属测试簇？
5. 是否需要 build:static？
6. 是否需要 live/e2e 或 validate_summary_flow？
7. 是否新增了必须保留的回归测试？
arxiv-sanity-summary-pipelinearxiv-sanity-task-orchestrationarxiv-sanity-upload-systemarxiv-sanity-sse-busarxiv-sanity-frontendarxiv-sanity-ops-config