# 源码交接说明

**整理日期：** 2026-10-31  
**源码目录：** `C:\leida\radar-src-lanes`  
**线上状态：** 本轮修改未同步；没有连接服务器、修改线上文件或重启服务。  
**用途边界：** 本文用于本地源码维护、测试结果交接和风险记录，不包含线上部署或正式对局使用步骤。

## 1. 当前结论

本地完成了一批多账号状态隔离和交付稳定性调整。新增的合成测试及既有回归测试通过，但这不代表系统已达到完整运营验收：本轮没有在 Linux 服务环境验证，也没有针对真实并发流量完成长时间测试。

## 2. 本轮源码变更

| 文件 | 变更概要 |
|---|---|
| `node/capture.py` | 抓包代际、run 名称按账号维护；一个账号换局时不应丢弃其他账号的待写内容。 |
| `node/bank.py` | 候选密钥与失败冷却按账号区分；已知账号不借用其他账号候选；相同密钥指纹可分别归属不同账号。 |
| `node/observe_worker.py` | 队列超额时只淘汰当前账号条目；没有同账号条目可淘汰时拒收当前输入，不挤占其他账号条目。 |
| `node/engine_cluster.py` | 外层解析队列增加账号级 inflight 限额；子进程消费确认用于释放额度。 |
| `node/main.py`、`node/decode_node.py` | 两种运行路径统一账号结束标记去重和队列拒收计数。 |
| `lanes/release_manifest.json` | 更新当前受管理源码的哈希和已知可接受版本。 |
| `lanes-deploy.sh`、`lanes/deploy.sh` | 从项目模板重新生成，保持部署载荷一致。 |
| `lanes/tools/test_account_isolation.py` | 新增账号边界的合成回归测试。 |
| `lanes/tools/test_capture_publication.py` | 增加单账号换局不影响另一账号抓包的回归场景。 |

## 3. 设计意图与风险边界

- 一个账号的换局、错误候选、队列饱和或解析积压，不应直接清空或淘汰其他账号的状态。
- 账号级限额仍受共享 CPU、内存和操作系统调度影响；逻辑隔离不是资源绝对隔离。
- 当前账号归属依赖调用链提供的账号标识。账号缺失或被错误归一化时，相关状态会落入未知账号路径，仍需在真实服务边界核查。
- 解析进程异常、进程间队列拥塞、长时间断流恢复、生命周期竞争及真实高并发下的行为仍需独立验证。
- 发布清单覆盖的是其声明管理的文件，不代表整个项目的所有源码、依赖和前端资源都已打包或验证。

## 4. 测试结果

本轮记录的通过项：

- `test_account_isolation.py`：6/6。
- `test_capture_publication.py`：5/5。
- `test_live_delivery.py`：17/17。
- `test_live_integration.py`：4/4。
- `test_radar_live.cjs`：23/23。
- `test_auth_feedback.py`：20/20。
- `test_release.py`：22/22。
- `check_deploy.py`：0 failures；Python 语法扫描 112 个文件通过。
- `selftest.py`、`test_supervisor.py`：通过。

隔离测试使用合成账号、队列项目和模拟密钥；抓包测试使用临时目录与测试字节。它们验证代码边界，不证明真实数据链路、游戏协议解析或生产环境稳定性。

## 5. 尚未完成的验收

1. Linux 下真实服务启动、停止和故障恢复验证。
2. 多账号持续并发的资源水位和延迟测试。
3. 子进程重启、账号快速重连及延迟 ACK 交错场景。
4. 真实运行环境下账号标识缺失、变更或复用的行为。
5. 长时间运行时队列、文件句柄、内存和日志容量趋势。
6. 端到端业务数据正确性；合成测试无法替代真实数据集回归。

Windows 本地环境没有 Bash；单独导入完整服务入口时，当前 Python 运行环境也缺少 `uvicorn`。所以服务级启动验证未完成，不能把离线测试结果表述为线上通过。

## 6. 后续维护建议

- 变更前确认当前文件哈希、已有未提交内容和发布清单状态。
- 队列、缓存、抓包目录和换局标记继续坚持账号维度；新增共享状态时补充跨账号反例测试。
- 对进程间消息增加账号与生命周期关联测试，特别检查断流、reset、drop、重连同时发生时的计数一致性。
- 把功能正确性、资源上限、故障恢复、数据保留和可观测性分开验收，不用单一“服务存活”替代业务验证。
- 每次本地验证记录具体测试名、结果和未覆盖范围；真实环境检查应单独记录，不与合成测试混写。

## 7. 本次交付文件

- 项目维护文档：`C:\leida\雷达项目交接运维文档.md`
- 本地整改交接摘要：`C:\Users\Administrator\Documents\Codex\2026-10-30\c-2\outputs\identity-motion-20261030\本地运营级整改交接-20261031.md`
- 本源码交接说明：`C:\Users\Administrator\Documents\Codex\2026-10-30\c-2\outputs\identity-motion-20261030\源码交接说明-20261031.md`