getDomain/docs/新机器接手交接_20260427.md

新机器接手交接

1. 目标

这次不是继续在当前机器上排障，而是：

• 把当前代码整理后提交到 Git
• 在新服务器上重新部署验证
• 让新的 Codex 接手继续推进

当前最重要的未完成主线只有一条：

• domain-api/app/services/sync_push_service.py 中 _load_pushable_projections() 的修复，需要在远端稳定部署后验证：
  • detect_result_projection push 是否恢复
  • detect_result_ingest 是否出现

2. 当前代码结论

已经确认并完成的代码侧修复：

• domain-api/app/services/sync_push_service.py
  • 修复 _load_pushable_projections() 选择逻辑
  • 旧问题：最新 detect_result_projection 明明存在且没有 push attempt，但候选集为空
  • 现修复：候选改为优先按最新 projection 选择
• domain-api/tests/test_sync_push_service.py
  • 已补回归测试

本地验证已完成：

• py_compile 通过
• python -m unittest tests.test_sync_push_service 通过

3. 当前卡点

不是代码不清楚，而是当前远端 SSH 不稳定：

• 121.204.244.188:22 TCP 可连接
• 但 SSH banner 经常超时
• Paramiko 常见报错：
  • SSHException('No existing session')
  • Error reading SSH protocol banner

因此当前没有拿到“远端已发布并生效”的硬结果。

4. 新机器接手后的首要动作

新机器接手后，先不要扩散排查面，只做这一个最小动作：

1. 发布 domain-api/app/services/sync_push_service.py
2. 重启 domaincheck-sync-agent.service
3. 只验证两项：
   • detect_result_projection push 是否恢复
   • detect_result_ingest 是否出现

5. 关键背景

项目根目录：

• /www/wwwroot/getDomain

主要子目录：

• domain-api/
• domain-web/
• domainCheck/
• docs/

当前远端主机：

• mainland-controller-01
• 121.204.244.188

已确认的远端运行时 region 配置：

• NODE_REGION=mainland
• SYNC_SOURCE_REGION=mainland
• SYNC_TARGET_REGION=overseas

已确认的数据事实：

• mainland 本地已经生成了 detect_result_projection
• surrogate job 例如：
  • job_id=909
  • job_code=sync-overseas-28618
• worker 事件已写入 mainland 本地库
• 真正未打通的是 detect_result_projection 的 push 选择阶段

6. 建议提交范围

建议优先提交真正的代码改动，不要把运行产物一起带上。

建议提交：

• domain-api/
• domain-web/
• domainCheck/
• tools/
• 需要保留的文档 .md

建议重点确认本次必须包含：

• domain-api/app/services/sync_push_service.py
• domain-api/tests/test_sync_push_service.py

7. 明确不要提交的内容

以下属于运行产物、临时文件或本地探针，不建议提交：

• docs/ops_center_runtime/night_runs/step_mix_*/
• docs/ops_center_runtime/chinaz_gray_runs/
• docs/_tmp_regression/
• .codex-release-probe.txt
• *.bak_*
• *.log
• *.pid

当前工作区里特别要排除的项目：

• domainCheck/app/utils/database.py.bak_20260426_220818_active_job_cache_tune
• domainCheck/detect_worker.py.bak_20260426_220818_active_job_cache_tune
• docs/ops_center_runtime/night_runs/step_mix_20260426_051718_smoke_p200/
• docs/ops_center_runtime/night_runs/step_mix_20260426_051754_smoke_p200/
• docs/ops_center_runtime/night_runs/step_mix_20260426_052641_debug_stepmix/
• docs/ops_center_runtime/night_runs/step_mix_20260426_053252_mainland_step_mix_p200_t800/
• docs/ops_center_runtime/chinaz_gray_runs/
• .codex-release-probe.txt

8. 已跟踪但不建议把这次删除提交进去的文件

这些文件目前显示为已删除，但更像本地运行态/配置文件，不建议在这次“迁移到新服务器”的提交里带上删除：

• domainCheck/app/thread_count.json
• domainCheck/node_thread_counts.json
• domainCheck/runtime/runtime_settings.json
• domainCheck/runtime/sensitive_words.json
• domainCheck/runtime_settings.json
• domainCheck/thread_count.json

处理建议：

• 如果这些删除不是你明确想做的配置收口，请在提交前恢复
• 不要把“本地运行时删掉了某个 JSON”误当作产品代码改动提交

9. 提交前建议

提交前建议至少做这几步：

1. git status --short
2. 把运行产物和备份文件排除掉
3. 只保留代码、测试、必要文档
4. 单独复查：
   • sync_push_service.py
   • test_sync_push_service.py
   • .gitignore
   • 本交接文档

10. 给新机器上的 Codex 的一句话

接手后不要重新发散排查 worker、projection 生成、事件落库链；这些已经基本收敛。优先完成 sync_push_service.py 的远端生效验证，只盯：

• detect_result_projection push
• detect_result_ingest