# 新机器接手交接

## 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`