getDomain/docs/ops_center_runtime/IMPLEMENTATION_STATUS.md

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%