# Phase 2 逐行走读 — 闭环声明

**日期**: 2026-05-22  
**标准**: `docs/project/line-walk-audit-standard.md`

---

## 1. 覆盖范围

| 批次 | 目录/主题 | 报告 | 文件数（约） |
|------|-----------|------|-------------|
| 2a | `server/api/` | `audit-phase-2a-line-walk.md` | 16 |
| 2b | `server/application/services/` | `audit-phase-2b-line-walk.md` | 6 |
| 2c | `server/infrastructure/` | `audit-phase-2c-line-walk.md` | 21 |
| 2d | `main` + `config` + `background/` | `audit-phase-2d-line-walk.md` | 6 |
| 2e | `web/app/` | `audit-phase-2e-line-walk.md` | 16 |
| 2f | `web/agent/` + `tests/` + `scripts/` | `audit-phase-2f-line-walk.md` | 20 |
| **2g** | 脚本执行核心（Redis/服务） | `audit-phase-2g-line-walk.md` | 5 |
| **2h** | 脚本执行 API/前端/Agent | `audit-phase-2h-line-walk.md` | 5 |
| **2i** | 脚本支撑 + main 增量 | `audit-phase-2i-line-walk.md` | 5 |
| **2j** | 安全修复 VERIFY | `audit-phase-2j-line-walk.md` | 5 |

**Post-2e 新增页面**: `web/app/script-executions.html` — 已在 **2h** 全文走读。

**合计 FINDING ID**: 见 `audit-phase-2-findings-matrix.md`（**63** 条，含 2i +2）。

---

## 2. 走读完成判定

- [x] 标准 §2 范围内 **server/**、**web/app/**、**web/agent/**、**tests/**、**scripts/**、**deploy/** 已在 2a–2f 完成基线走读
- [x] **脚本批量执行平台**（2026-05-22 交付）已在 2g–2i 增量走读
- [x] P0/P1 修复项已 **2j 抽样 VERIFY**（crypto、webssh-token、危险命令阻断、Agent key）
- [x] 全量 FINDING + 待办队列在 **汇总表** 维护

**未做**: 2a–2f 每个文件的「全文重读」（行数已变）。对 **git 已改但未列入 2g–2j** 的文件，以汇总表 OPEN 项 + 2j grep VERIFY 为准；若需 100% 重读可开 Phase 3。

---

## 3. 修复批次建议（用户确认后一并处理）

按优先级合并去重后：

### P1（先做）

| 优先级 | ID | 说明 |
|--------|-----|------|
| 1 | **F2h-03** | Agent `/exec/kill` 禁止杀未登记 pid |
| 2 | **F2f-01** + **F2g-01** | 子机 shell 执行面（文档/隔离） |
| 3 | **F2a-08** | 安装后 install 路由全 403 |

### P2（功能/正确性）

| ID | 说明 |
|----|------|
| F2g-03, **F2i-01** | JSON try / `update_status` 空记录 |
| F2h-01, F2g-05 | `credential_id` 贯通 |
| F2g-04 | 重试语义（新 id vs 续跑） |
| F2h-04 | Agent wait 超时清理 |
| F2b-05, F2a-13 | duration / stats 正确性 |

### P2（架构/观察，可 ADR）

| ID | 说明 |
|----|------|
| F2a-10, F2d-02 | 全局 JWT 中间件 |
| F2e-03, F2e-04, F2a-05 | WS/WebSSH token 不在 URL |
| F2g-02, F2g-06, F2h-02 | HTTPS 回调 + 限流 |
| F2e-05, F2e-06 | localStorage / CDN SRI |

### 运维

- **F2f-04**: 轮换曾泄露的 API Key

---

## 4. 文档索引

| 文档 | 用途 |
|------|------|
| `docs/reports/audit-phase-2-findings-matrix.md` | 全量 FINDING 表 + 修复队列 |
| `docs/project/script-execution.md` | 脚本执行技术 SSOT |
| `docs/changelog/2026-05-22-line-walk-audit-standard.md` | 批次索引 |

---

## 5. 签字

**Phase 2 逐行走读（含脚本平台增量）**: **已闭环**，可进入 **一并修复** 阶段。
