6.2 KiB
6.2 KiB
第一轮审核清单
第一轮目标:先查控制面、运行态聚合、同步链、节点控制和配置分发。
建议模型与强度:
gpt-5.4xhigh
建议额度:
300万 ~ 450万 tokens
本轮不看:
release/.venv/node_modules/- 运行时日志、快照、night runs
- 大型静态资源和锁文件
审核顺序
P0:运行态与页面口径
- domain-api/app/services/detect_job_service.py
重点看:
active_job、runtime_snapshot、runtime_ingest、distributed_node_stats、display_*字段是否会互相覆盖。 - domain-api/app/services/detect_service.py 重点看:检测控制页口径、聚合线程数、参与节点/参与进程统计、零值回退逻辑。
- domain-api/app/services/runtime_status_service.py
重点看:运行中心聚合、
queue_health与 backlog 对齐、活跃任务判定。 - domain-api/app/services/dashboard.py
重点看:首页总览是否复用旧快照、
queue_display_*和active_job是否一致。 - domain-api/app/api/routes/detect.py 重点看:检测控制接口有没有直接透传脏口径。
- domain-api/app/api/routes/runtime.py 重点看:运行中心接口是否二次加工错误。
- domain-api/app/api/routes/dashboard.py 重点看:首页口径是否和服务层一致。
P0:同步链与投影链
- domain-api/app/services/sync_record_service.py
重点看:
runtime_projection、runtime_ingest、未来时间记录、重复投影、自愈逻辑。 - domain-api/app/services/sync_push_service.py 重点看:同步触发、推送条件、失败重试、是否会把旧状态推成新状态。
- domain-api/app/services/cluster_runtime_service.py 重点看:集群节点汇总、心跳、stale/offline 判定。
- domain-api/app/services/debug_event_service.py 重点看:调试事件是否参与运行态推断,是否会误导当前任务。
P0:节点控制与配置分发
- domain-api/app/services/worker_control_service.py 重点看:worker 进程探测、当前状态读取、systemd 口径和实际进程口径是否一致。
- domain-api/app/services/settings_service.py
重点看:
process_count、thread_count、节点级覆盖、多实例父子节点映射。 - domain-api/app/services/runtime_settings_service.py 重点看:运行态配置来源、热配置优先级、页面修改后是否真生效。
- domain-api/app/services/runtime_control_service.py 重点看:启动/停止/恢复对多实例 worker 是否安全。
P1:检测任务主链
- domain-api/app/services/detect_run_service.py 重点看:运行记录、cycle 事件、页面日志来源。
- domain-api/app/services/domains_service.py 重点看:域名主数据是否和检测任务状态有交叉写入风险。
- domain-api/app/services/import_task_service.py 重点看:导入任务是否影响 backlog、是否能造成页面统计失真。
必看测试
直接对应运行态/聚合
- domain-api/tests/test_detect_job_service.py
- domain-api/tests/test_detect_service_status_fallback.py
- domain-api/tests/test_runtime_status_service.py
- domain-api/tests/test_dashboard_service.py
直接对应同步链
- domain-api/tests/test_sync_record_service.py
- domain-api/tests/test_sync_push_service.py
- domain-api/tests/test_cluster_runtime_service.py
直接对应节点控制与配置
- domain-api/tests/test_worker_control_service.py
- domain-api/tests/test_settings_service.py
- domain-api/tests/test_detect_api_routes.py
- domain-api/tests/test_ops_api_routes.py
本轮输出要求
只输出这 3 类内容,避免烧额度:
P0 / P1真实问题,带文件和行号- 影响范围
- 修复建议
不要在第一轮做这些:
- 大篇架构说明
- 文件逐段复述
- UI 细节优化建议
- 发布脚本和迁移功能深挖
第一轮完成标准
满足以下条件就可以结束第一轮,转第二轮:
- 能回答“为什么页面显示会和现场不一致”
- 能回答“为什么 sync 会把旧运行态覆盖成新页面口径”
- 能回答“进程/线程配置、页面显示、节点实际执行三者有没有断层”
- 能列出前
10个最值得先修的P0/P1问题