# IMPLEMENTATION_STATUS

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

## 当前真实状态

阶段判断：

- 海外单脑接管能力：约 `95%`
- 分布式检测真实跑通程度：约 `89%`
- 距离“可稳定上线并放心用后台发起检测”：约 `90%`

当前最重要的新事实：

- 大陆节点接管闭环已完成
- acceptance 主链已完成
- `runtime.pull_tasks` 的环境阻塞已解决
- 大陆检测链已开始真实执行
- 当前剩余问题已收敛为“检测总览统计口径未统一”

## 本轮代码与环境收口

本轮代码变更：

- 提交：`74dc009`
- 主题：`fix: inherit sync env in node agent`

本轮实际变更点：

- `domain-api/deploy/systemd/domain-node-agent.service`
  - 增加：
    - `EnvironmentFile=-/etc/default/domaincheck-api`
- `domain-api/deploy/multi-region/templates/domaincheck-node-agent.env.example`
  - 补齐：
    - `runtime.start_detection`
    - `runtime.stop_detection`
    - `runtime.pull_tasks`

本轮环境动作：

- 已在 `mainland-controller-01` 刷新并重启 `domaincheck-node-agent`
- 已在 `mainland-worker-01` 刷新并重启 `domaincheck-node-agent`
- 已确认两台节点 unit 包含：
  - `/etc/default/domaincheck-api`
  - `/etc/default/domaincheck-node-agent`
  - `SupplementaryGroups=systemd-journal`

## 关键验证证据

关键成功证据：

- `mainland-controller-01` 新运维任务：
  - `job_id = 87`
  - `action = runtime.pull_tasks`
  - `status = success`
- 返回结果：
  - `pull_state = success`
  - `items_total = 50`
  - `summary_text = 待检测任务批次拉取并入库成功`

远端日志证据：

- `mainland-controller-01`
  - `job start: id=87 ... action=runtime.pull_tasks`
  - `job complete: ... ok=True`

节点运行证据：

- `mainland-controller-01`
  - `participation_state = running`
  - `items_running = 5`
  - `items_total = 200`
- `mainland-worker-01`
  - `participation_state = running`
  - `items_running = 5`
  - `items_total = 70`

## 代码闭环

当前已经被验证打通的链路：

- detect.start 触发远端动作排队
- mainland controller 的 sync-agent / pull_tasks 目标地址读取
- Node Agent 远端执行 `runtime.pull_tasks`
- 大陆 controller 拉批入库
- 大陆 controller / worker 进入执行态

这意味着：

- “点开始检测后大陆节点完全不参与”这个问题已经被修掉

## 外部条件闭环

已经闭合：

- SSH
- node handover
- bootstrap
- register / heartbeat
- acceptance
- journald 权限
- node-agent 同步目标地址继承

当前不再依赖用户补充的外部条件：

- 不需要再补 `SYNC_TARGET_API_BASE_URL`
- 不需要再手工改 controller 的 node-agent env
- 不需要重装系统

## 当前剩余问题

当前唯一剩余问题：

- 控制面“检测总览”口径仍未和大陆拉批执行口径统一

具体表现：

- `ops/nodes`
  - 明确显示大陆 controller / worker 正在执行
- 但：
  - `/api/v1/detect/queue-summary`
  - `/api/v1/detect/job/active`
  - 仍主要显示旧的：
    - `overseas-control-01`
    - `unassigned`

因此当前判断是：

- 执行链路已经通
- 展示与统计口径还没完全通

## 当前是否可以直接上线

当前结论：

- 可以继续做检测功能测试
- 但还不建议宣称“检测总览已经完全可信、可以直接签收上线”

原因不是执行失败，而是：

- 总览统计仍会让人误判“大陆没跑”

## 当前优先级判断

最高优先级：

- 收敛 `detect/queue-summary` / `detect/job/active` 的统计口径

当前不应继续推进：

- 新运维页面
- 控制面增强
- 新模块
- 发布动作
- 与检测总览收口无关的任何功能

## 完成下一轮后的预期

如果检测总览口径收敛成功：

- 后台将能同时看到：
  - 海外触发
  - 大陆拉批
  - 大陆执行
  - 统一进度统计
- 整体可上线程度预计提升到 `94%~96%`