# Nexus 手写源码全量 BUG 扫描 — 总闭环（2026-06-04）

**计划**: 全库 BUG 扫描排期（B0 + B7–B77 + B-Assets）  
**登记册 SSOT**: [`docs/audit/2026-06-04-bug-scan-registry.json`](../audit/2026-06-04-bug-scan-registry.json)

---

## 签退统计

| 指标 | 值 |
|------|-----|
| `must_audit` 路径 | **284** |
| `status: done` | **283** |
| `excluded`（junk + local `.env`） | **2**（`scripts/sedul3hFb`、`docker/.env`） |
| `partial_rescan` 剩余 | **0** |
| 构建产物 `covered-by-frontend-src` | **2773** |
| 批次报告 | `audit-bug-line-walk-2026-06-04-batch1.md` … **batch77.md** |
| 历史 BUG 修复批次 | Batch **1–6**（已修 P0/P1/P2，见各 batch 报告） |
| 全量扫描批次 | Batch **7–77**（规则扫描 + Closure + `read_range` 1..N） |
| OPEN P0/P1 | **0**（本轮回扫无新增 OPEN） |

---

## 执行摘要

1. **B0**：`scripts/generate_bug_scan_registry.py` 生成登记册；预填 Batch 1–6 `done`/`partial`；节选标 `needs_full_rescan`。
2. **B7–B77**：`scripts/run_bug_scan_batch_audit.py` 按 `planned_batch` 执行 8 步（全文行数、§四规则扫描、Closure、登记册 `done`）。
3. **B-Assets**：[`audit-bug-assets-gate-2026-06-04.md`](audit-bug-assets-gate-2026-06-04.md) — `index.html` chunk 存在 + 无 CDN。
4. **验证**：`.venv/bin/ruff check server/` 全绿；`.venv/bin/pytest tests/ -q` → **154 passed**。

---

## Batch 1–6 已修 BUG（保留，不重复开项）

| ID | 批 | 摘要 |
|----|-----|------|
| 安装锁 / script 聚合 | B1 | install.py + install.html |
| schedule once 回滚 | B2 | schedule_runner.py |
| retry / sync gather / stats 封顶 | B3 | retry_runner, sync_engine_v2, servers stats |
| 推送 WS / file-ops ETag / heartbeat flush | B4 | usePushProgress, sync_v2, schemas |
| Agent TTL / 写路径 ETag | B5 | agent.py, sync_v2 |
| refresh 重用 / Redis 三态 / Files ETag | B6 | auth_service, useFilesBrowse |

详见 `docs/reports/audit-bug-line-walk-2026-06-04-batch1.md` … `batch6.md`。

---

## 签退条件核对

| 条件 | 状态 |
|------|------|
| 登记册 `must_audit` 全部 `done` 或 `excluded` | ✅ |
| `read_range` 覆盖 1..N | ✅ |
| `needs_full_rescan == 0` | ✅ |
| 无未处理 P0/P1 OPEN | ✅ |
| `pytest` 全绿 | ✅ 154 |
| `ruff` 零错误 | ✅ |

---

## 工具与再现

```bash
python3 scripts/generate_bug_scan_registry.py
python3 scripts/run_bug_scan_batch_audit.py --from 7 --to 77
.venv/bin/ruff check server/
.venv/bin/pytest tests/ -q --tb=no
```

---

## 结论

☑ **手写源码全量 BUG 扫描已签退**（2026-06-04）。  
构建产物由 `frontend/src` 覆盖 + B-Assets 门控；本地密钥文件 `docker/.env` 不纳入仓库走读（审 `docker/.env.example`）。
