# IMPLEMENTATION_STATUS

更新时间：2026-04-19 02:40 CST

## 当前真实状态

阶段判断：

- 海外单脑接管能力：约 `95%`
- 分布式检测真实执行能力：约 `94%`
- 距离“可稳定上线并放心用后台发起检测”：约 `93%~94%`

本轮最重要的新事实：

- Detect 主统计口径已经从“双轨显示”推进到“统一后的有效账本”
- `detect/job/active` 和 `detect/queue-summary` 主字段已直接体现大陆 + 海外的统一聚合结果
- 原始中央账本仍完整保留，便于继续排障和审计

## 本轮代码收口

本轮后端变更：

- `domain-api/app/services/detect_job_service.py`

本轮测试变更：

- `domain-api/tests/test_detect_job_service.py`

本轮修复方式：

- 保留中央 `detect_job_items` 原始值
- 引入“有效统一账本”：
  - `node_stats`
  - `items_pending`
  - `items_claimed`
  - `items_running`
  - `items_completed`
  - `items_failed`
  - `items_terminal`
- 同时新增 `raw_*` 字段保留中央原始账本

## 关键验证证据

接口验证：

- `detect/job/active`
  - 已统一为：
    - `items_total = 1000`
    - `items_pending = 931`
    - `items_claimed = 34`
    - `items_running = 14`
    - `items_completed = 21`
  - 原始账本仍可追溯：
    - `raw_items_pending = 950`
    - `raw_items_claimed = 25`
    - `raw_items_running = 4`
  - `node_stats` 已包含：
    - `mainland-controller-01`
    - `mainland-worker-01`
    - `overseas-control-01`
    - `unassigned`
- `detect/queue-summary`
  - 已统一为：
    - `pending = 931`
    - `claimed = 34`
    - `running = 14`

编译验证：

- `python3 -m py_compile domain-api/app/services/detect_job_service.py domain-api/tests/test_detect_job_service.py`
  - 通过

单测验证：

- `/opt/domaincheck/domainCheck/.venv/bin/python -m unittest tests.test_detect_job_service`
  - 通过

运行验证：

- `domaincheck-api`
  - 已重启成功
- 线上接口返回统一账本字段正常

## 当前已闭合的问题

已闭合：

- 大陆 controller 无法 `pull_tasks`
- Detect 页面误判“大陆没跑”
- Detect 节点表格只显示海外与 `unassigned`
- Detect 主统计仍依赖 display 附加字段才能看懂

## 当前剩余问题

当前唯一剩余问题：

- 还没有做到 item 级逐条统一回写

具体来说：

- 当前已做到：
  - 主统计口径一致
  - 节点参与口径一致
  - Runtime / Detect 读取同一套有效聚合值
- 当前未做到：
  - 大陆执行结果逐条回写 `detect_job_items`

## 当前是否可以继续跑检测测试

当前结论：

- 可以继续跑检测任务测试
- 而且现在 Detect 主统计和节点参与都更接近真实执行态

## 当前是否建议直接上线

当前结论：

- 已经比上一轮更接近可上线状态
- 如果目标是“后台可以稳定发起检测并看懂谁在跑”，已经基本可用
- 如果目标是“中央账本逐条结果完全统一”，还差最后一层 item 级回写

## 当前优先级判断

最高优先级：

- 决定是否继续进入 `detect_result_projection -> detect_job_items` 的 item 级统一

当前不应继续推进：

- 新控制面功能
- 新模块
- 新页面
- 发布动作
- 与检测账本统一无关的工作

## 完成下一轮后的预期

如果下一轮把 item 级结果回写规则明确并最小落地：

- Detect 不仅主统计一致
- 而且底层逐条账本也会接近最终一致
- 整体可上线程度预计提升到 `95%~96%`