admin/Nexus
1
0
Fork 0
Code Issues Pull Requests Actions 82 Packages Projects Releases Wiki Activity

release: nexus btpanel session fix and app-v2

Browse Source
This commit is contained in:
Codex Release Bot
2026-07-08 22:31:31 +08:00
commit 1933f0af6e
2457 changed files with 350105 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/reports/2026-06-01-browser-verification.md
+33
View File
@@ -0,0 +1,33 @@
# 浏览器验收记录 — 2026-06-01（续）
> 站点：https://api.synaglobal.vip/app/
> 会话：已有 admin 登录态（未重新测登录页）
## 结果摘要
| 项 | 结果 | 说明 |
|----|------|------|
| 仪表盘 `#/` | ✅ | 8 台服务器统计、列表、侧栏导航正常 |
| 服务器 `#/servers` | ✅ | 表格、添加/导入/导出按钮可见 |
| 批量选择条「已选择 N 台」 | ✅ | 修复 `v-model:selected`→`v-model` 后验证「已选择 2 台服务器」+ 批量按钮（`ServersPage-CGp8DUVa.js`） |
| 告警中心 `#/alerts` | ✅ | 页面加载，类型/状态筛选器存在 |
| 推送 `#/push` | ✅ | 源/目标路径、预览/推送、服务器列表与同步模式 |
| WebSSH `#/terminal?server_id=8` | ✅ | xterm 存在，显示 **已连接**、延迟 ~228ms、「断开」按钮 |
| Redis 心跳 | ✅ | `heartbeat:*` key 数量 1（与面板「1 在线」一致） |
| Layer3 `health_monitor.sh` | ✅ | 脚本存在，root crontab 每分钟执行 |
| 告警 WS + Telegram | ⏸ | 需真实超阈值或测试钩子，未在本轮触发 |
| 实际 Push 2 台 | ⏸ | 避免误推生产文件，未点「推送」 |
| kill Python 三层守护 | ⏸ | **维护窗口**执行，不在本轮操作 |
## WebSSH 片段（DOM 文本）
- 服务器：机器人 / `66.154.115.131`
- 状态：**已连接**，计时器运行，终端输入框可聚焦
## 批量选择修复（同日晚）
见 `docs/changelog/2026-06-01-servers-batch-selection-fix.md`。
## 仍建议抽测
1. （可选）推送页选 2 台点「预览」，不执行正式推送
docs/reports/2026-06-01-final-acceptance-checklist.md
+29
View File
@@ -0,0 +1,29 @@
# 用户终验清单 — 2026-06-01（Agent 已全量自动化）
> Agent 已完成 **API 53/53** + **Playwright 15/15**（见 `2026-06-01-full-acceptance-report.md`）。
> 你只需对下面「建议人工确认」项勾选；其余无需重复测。
## Agent 已全量验证 ✅
- [x] 全部 14 个 SPA 路由可打开且核心控件可操作
- [x] 登录 / 退出 / 主题切换
- [x] 服务器批量选择 2 台 + 添加对话框
- [x] 凭据三 Tab、调度/脚本新建对话框、命令/会话视图
- [x] 推送页预览按钮（未正式推送）
- [x] 生产 API：认证、CRUD、搜索、告警、资产、同步 browse、webssh-token、health/detail
## Agent 已验证（2026-06-09 时区 + 部署）
- [x] 调度时区：生产 API cron `0 2 * * *` → `next_run` UTC 18:00（北京 02:00）；`SchedulesPage` 含北京时间提示
- [x] 告警/审计非法 `date_from` → HTTP 422（`prod_probe` origin）
- [x] `prod_health_check.sh` origin 全绿（含 per_page=50、once 调度 201）
## 建议你终验（可选，有副作用或 Agent 未做）
- [ ] `/app/#/schedules`：在白名单 IP 浏览器核对 Picker 提示与 `next_run` 列
- [ ] WebSSH：选一台服务器实际连上并输入 `pwd`（Agent 只验页面与 token API）
- [ ] 推送：若需确认 rsync，用**预览**或测试机，勿对生产误点「推送」
- [ ] Telegram「测试发送」是否收到（设置页）
- [ ] （维护窗口）kill Python 看 Supervisor 拉起
全部 OK → 回复「终验 OK」。有问题说明页面+现象，Agent 继续修。
docs/reports/2026-06-01-full-acceptance-report.md
+115
View File
@@ -0,0 +1,115 @@
# 全站功能验收报告 — Agent 执行（非抽测）
**日期**: 2026-06-01
**环境**: 生产 `https://api.synaglobal.vip`（后端 127.0.0.1:8600）
**结论**: **SPA 14 路由 + 核心 API 已全量自动化通过**；破坏性/维护类项见文末「未自动化」表。
---
## 1. API 自动化（生产机执行）
| 套件 | 用例数 | 结果 |
|------|--------|------|
| `tests/test_api.py` | 25 | ✅ 25/25 |
| `tests/test_full_site_api.py` | 28 | ✅ 28/28 |
**合计 53 项 API 断言**（含 CRUD 清理：test-server-e2e、test-script、test-schedule、test-preset、e2e-platform-full）。
### test_full_site_api 覆盖模块
- 搜索、告警历史+统计、资产 platforms/nodes/树/SSH 会话/命令日志（含 platform CRUD）
- 服务器分类、推送日志、meta、单台 sync 日志
- 脚本 exec-config、执行历史、DB 凭据、SSH 密钥预设
- sync validate-source-path、browse（真实 server_id）、webssh-token
- 设置列表、IP 白名单、必应壁纸、**health/detail**、终端快捷命令
### 本轮修复（根因已根治）
| 问题 | 修复 |
|------|------|
| `GET /health/detail` 401 | `DbSessionMiddleware` 对 `/health/detail` 开 DB 会话（JWT 需查 admin 表） |
| `test_api.py` 被 import 即跑 | 收拢为 `run_tests()`，仅 `__main__` 执行 |
| 全站 API 平台创建 422 | 测试体补全 `category`+`type` |
| validate-source-path 422 | 字段改为 `path` |
---
## 2. UI 自动化（Playwright 15 项，生产 SPA）
命令：`frontend/` 下 `NEXUS_E2E_*` + `npx playwright test e2e/full-acceptance.spec.mjs`
| # | 路由 | 验证内容 |
|---|------|----------|
| 01 | `#/` | 登录、仪表盘卡片 |
| 02 | `#/servers` | 列表、批量选 2 台、添加对话框开/关 |
| 03 | 顶栏 | 全局搜索输入 |
| 04 | `#/terminal` | 终端页加载 |
| 05 | `#/files` | 文件管理页加载 |
| 06 | `#/push` | 预览按钮（不点正式推送） |
| 07 | `#/scripts` | 新建脚本对话框开/关 |
| 08 | `#/credentials` | 三子页切换（密码/SSH/DB） |
| 09 | `#/schedules` | 新建调度对话框开/关 |
| 10 | `#/retries` | 重试队列页 |
| 11 | `#/commands` | 命令/会话视图切换 |
| 12 | `#/alerts` | 告警中心 |
| 13 | `#/audit` | 审计日志 |
| 14 | `#/settings` | 设置区段可见 |
| 15 | — | 主题切换、退出登录 |
**结果**: ✅ **15/15 passed**（约 1.1 分钟）
---
## 3. 与功能清单对照（SPA 时代）
| 功能清单页面 | SPA 路由 | API | UI |
|--------------|----------|-----|-----|
| 仪表盘 | `/` | stats、alert 摘要 | ✅ |
| 服务器 | `/servers` | CRUD+stats+logs | ✅ 含批量选择 |
| 终端 WebSSH | `/terminal` | webssh-token | ✅ 页加载（未自动连 SSH） |
| 文件管理 | `/files` | browse（API 有 SSH 用例） | ✅ 页加载 |
| 推送 | `/push` | logs、preview 按钮 | ✅ 预览未断言结果 |
| 脚本库 | `/scripts` | CRUD、executions 列表 | ✅ 对话框 |
| 凭据 | `/credentials` | presets、ssh-key、db cred | ✅ 三 Tab |
| 调度 | `/schedules` | CRUD | ✅ |
| 重试队列 | `/retries` | list | ✅ |
| 命令日志 | `/commands` | command-logs、ssh-sessions | ✅ 视图切换 |
| 告警中心 | `/alerts` | alert-history | ✅ |
| 审计 | `/audit` | audit list | ✅ |
| 设置 | `/settings` | settings、allowlist | ✅ 未点 Telegram 测试发送 |
| 登录 | `/login` | login、logout | ✅ |
| 安装向导 | `/app/install.html` | — | ⏸ 生产已安装，未测 |
| 资产管理独立页 | 无独立路由 | assets API | ✅ API；UI 合并在服务器/命令 |
---
## 4. 未自动化（需维护窗口或你终验确认）
| 项 | 原因 |
|----|------|
| 正式 Push / rsync 写盘 | 避免误改生产文件 |
| 脚本远程执行 | 会改子机状态 |
| 批量 Agent 安装/升级/卸载 | SSH 长任务+改子机 |
| WebSSH 真实连接+resize 长会话 | Playwright 未模拟 xterm WS |
| Telegram 告警/测试发送 | 外部副作用 |
| kill Python 三层守护 | 服务中断 |
| Agent 心跳协议 | 需子机 Agent |
| install.html 五步 | 生产非安装模式 |
---
## 5. 你如何终验（可选抽查）
见 `docs/reports/2026-06-01-final-acceptance-checklist.md`。Agent 已覆盖上表 API+UI，你只需确认上表「未自动化」中你在意的 1～2 项即可。
---
## 6. 复现命令
```bash
# 生产 API
ssh nexus "cd /www/wwwroot/api.synaglobal.vip && python3 tests/test_api.py && python3 tests/test_full_site_api.py"
# 本地 UI（需 NEXUS_E2E_PASSWORD）
cd frontend && npm run test:e2e
```
docs/reports/2026-06-01-production-verification.md
+39
View File
@@ -0,0 +1,39 @@
# 生产验收记录 — 2026-06-01
> 执行人：单 Agent（用户唯一对接）
> 计划：`docs/design/plans/2026-06-01-single-owner-execution.md`
## 自动化结果
| 项 | 命令/方式 | 结果 |
|----|-----------|------|
| Git 同步 | `git reset --hard origin/main` @ b8af1fc | ✅ |
| 后端重启 | `supervisorctl restart nexus` | ✅ RUNNING |
| `/health` | `curl http://127.0.0.1:8600/health` | ✅ `ok` |
| `/app/` | HTTP 状态码 | ✅ 200 |
| Redis | `redis-cli ping` | ✅ PONG |
| MySQL | `SELECT 1` | ✅ ok |
| `test_api.py` | 生产机 | ⚠️ 无 `pytest` 模块；以 WSL/本地 CI 为准 |
## 浏览器抽测（2026-06-01 续）
详见 `docs/reports/2026-06-01-browser-verification.md`。
- [x] SPA 仪表盘 / 服务器 / 告警 / 推送 页面
- [x] WebSSH `server_id=8` 已连接
- [x] `health_monitor.sh` cron 已配置
- [x] 批量选择条（Vuetify4 `v-model` 修复后「已选择 2 台」）
- [ ] 告警 Telegram 端到端
- [ ] Push 试跑（避免误操作未执行）
- [ ] kill Python 守护（维护窗口）
## 待维护窗口
- [ ] WebSocket 告警 + Telegram 推送与恢复（需超阈值或测试钩子）
- [ ] WebSSH resize / 长会话断线重连
- [ ] Push/Sync 选 2 台试跑
- [ ] kill Python → Supervisor 恢复；health_monitor 连续失败重启
## 备注
前端构建物不在 git；生产 `web/app/assets` 以最近一次 tar/scp 为准。prune 须先 `--dry-run`（`deploy/deploy-frontend.sh` 已加固）。
docs/reports/2026-06-06-1panel-install-wizard-verification.md
+101
View File
@@ -0,0 +1,101 @@
# 1Panel 安装向导验收报告（待服务器执行）
| 项 | 内容 |
|----|------|
| 日期 | 2026-06-06 |
| 目标 | 完成 `https://api.synaglobal.vip/app/install.html` 五步安装 |
| 代码基线 | `main` @ `b25d079`（1Panel 容器名 sync） |
| DNS | `api.synaglobal.vip` → `20.24.218.235`（新 VPS） |
## Agent 侧探测（本机）
| 检查 | 结果 | 说明 |
|------|------|------|
| SSH `Host nexus` | 失败 | 本机无 `~/.ssh/id_rsa_nexus`，无法代登服务器 |
| `https://api.synaglobal.vip/health` | 连接重置 | 外网 HTTPS 未通或 OpenResty 未反代 |
| `20.24.218.235:8600` | 不可达 | 预期：仅 `127.0.0.1:8600` 监听 |
**结论**：安装向导必须在 **1Panel 终端** 本机验证；外网访问依赖 OpenResty 反代配置。
## 服务器执行清单（复制到 1Panel 终端）
### 1. 更新到 b25d079+ 并 sync 1Panel 主机名
```bash
cd /opt/nexus
git fetch && git log -1 --oneline
nx update --no-cache
```
### 2. 一键验收
```bash
bash deploy/verify-1panel-install-wizard.sh
```
关键 `[PASS]`：
- 已包含 b25d079
- `NEXUS_1PANEL_DB_HOST=1Panel-mysql-*`
- `NEXUS_1PANEL_REDIS_HOST=1Panel-redis-*`
- Nexus 已接入 `1panel-network`
- 容器内 TCP → MySQL/Redis
- `/app/.env` 不存在
- 步骤 3 预填 `db_host=1Panel-mysql-*`（非 `host.docker.internal`）
### 3. 配置 OpenResty（外网访问）
1. 1Panel → 应用商店 → **OpenResty**
2. 网站 → 域名 `api.synaglobal.vip` → 反代 `http://127.0.0.1:8600`
3. HTTPS → Let's Encrypt
4. 参考 `deploy/1panel/openresty-nexus.conf.example`（`/ws/` 超时 ≥ 3600s）
验证：
```bash
curl -sk https://api.synaglobal.vip/health # → ok
```
### 4. 1Panel 数据库准备
- 库名：`nexus`
- 用户：`nexus`（仅授权 `nexus` 库）
- 记下密码（步骤 3 填写）
### 5. 浏览器完成安装向导
打开：`https://api.synaglobal.vip/app/install.html`
| 步骤 | 要点 |
|------|------|
| 2 环境检测 | MySQL/Redis 显示 `✓ 已安装（1Panel-mysql-xxxx:3306）` |
| 3 数据库 | `db_host` / `redis_host` 为容器名；填 MySQL 密码；Redis 有密码则填 `redis_pass` |
| 4 连接 | MySQL + Redis 全绿 |
| 4 管理员 | 创建 admin 账号 |
| 5 锁定 | 完成安装 |
### 6. 安装后 L5 抽测
```bash
curl -sk https://api.synaglobal.vip/health
curl -sk -o /dev/null -w '%{http_code}\n' https://api.synaglobal.vip/app/
# 未登录 API → 401
curl -sk -o /dev/null -w '%{http_code}\n' https://api.synaglobal.vip/api/servers/
```
## 常见故障
| 现象 | 处理 |
|------|------|
| 步骤 3 仍是 `host.docker.internal` | `nx update --no-cache`；确认 `git log -1` ≥ b25d079 |
| MySQL `Can't connect on host.docker.internal` | `bash deploy/detect-1panel-services.sh` → `nx update` |
| `/app/install.html` 404 | `bash deploy/sync-install-wizard-to-container.sh` |
| `/app/.env` 已存在但向导未完成 | 删 `nexus-state` 卷内 `.env`，设 `NEXUS_INSTALL_WIZARD_PENDING=1`，`nx update` |
| 外网 HTTPS 失败、本机 8600 正常 | 配置 OpenResty 反代 + SSL |
## DoD（待填）
- [ ] `verify-1panel-install-wizard.sh` 全 PASS
- [ ] `https://api.synaglobal.vip/health` → `ok`
- [ ] 安装向导步骤 5 锁定完成
- [ ] `/app/` 可登录
docs/reports/2026-06-06-api-audit-b1-servers-webssh.md
+84
View File
@@ -0,0 +1,84 @@
# API 巡检 B1 — servers.py + webssh.py
**日期**: 2026-06-06
**范围**: `server/api/servers.py`（28 端点）、`server/api/webssh.py`（1 WS）
**方法**: 8 维清单（认证/越权/注入/路径/凭据/输入/错误/审计）
## 结论
| 级别 | 数量 | 说明 |
|------|------|------|
| P0 | 0 | — |
| P1 | 0 | — |
| P2 | 1 | 已修：`ServerCheck.server_ids` 无上限 → DoS |
| H | 3 | 已记录/接受，见下表 |
**批次结论**: **PASS**（修复已合入工作区）
---
## 端点覆盖
全部 29 个路由均要求 `get_current_admin`（REST）或 WebSSH 专用 JWT（`purpose=webssh` + `server_id` 绑定）。
| 模块 | 端点 | 认证 | 审计 CUD | 备注 |
|------|------|------|----------|------|
| servers | CRUD `/` `/{id}` | JWT | ✓ | `_server_to_dict` 不返明文密码/私钥 |
| servers | `/stats` `/categories` `/logs` | JWT | — | 只读；stats 有 online 封顶 |
| servers | `/import` | JWT | ✓ | 1MB/500 行；CSV 注入防护 `_sanitize_csv_cell` |
| servers | `/batch/*` | JWT | ✓ | `server_ids` max 50；SSH `shlex.quote` |
| servers | `/add-by-ip` `/pending/*` | JWT | ✓（已补 retry 失败） | 轮询失败写 pending + 审计 |
| servers | `/agent-key` `/agent-install-cmd` | JWT + 密码复核 | ✓ | 不回落全局 API_KEY |
| servers | `/install-agent` | JWT | ✓ | 服务端 SSH 可用全局 KEY 作 fallback（H） |
| servers | `/check` | JWT | — | **已修** max 50 server_ids |
| webssh | `/ws/terminal/{id}` | JWT query | connect/disconnect | server_id 绑定；命令审计 + 危险命令检测 |
---
## FINDING 明细
### P2-01 — `POST /api/servers/check` 无 `server_ids` 上限（已修）
- **风险**: 传入数千 ID 触发并行 SSH 探测，资源耗尽。
- **修复**: `ServerCheck.server_ids` 增加 `max_length=50`（与 `BatchAgentAction` 一致）。
- **文件**: `server/api/schemas.py`
### H-01 — WebSSH 遗留 token 无 `tv` 字段时回退 `updated_at` 宽限
- **位置**: `webssh.py` `_verify_webssh_token`
- **影响**: 改密后 5 秒内旧 WebSSH token 仍可能有效（新签发 token 均含 `tv`）。
- **处置**: 接受（单人运维模型）；新 token 路径已安全。
### H-02 — `install-agent` 无 per-server key 时回落 `settings.API_KEY`
- **位置**: `servers.py` `install_agent_remote`
- **影响**: 仅用于 SSH 下发安装命令，不向 API 响应暴露全局 KEY。
- **处置**: 接受；与 Agent 安装运维模型一致。
### H-03 — `retry_pending` 失败与 `delete_pending` 审计字段不完整（已修）
- **修复**: 失败重试写 `retry_pending_server_failed` 审计；删除前读取 pending 写入 `detail`。
- **文件**: `server/api/servers.py`
---
## 安全亮点（无需改动）
- `_server_to_dict`: `password_set` / `ssh_key_private_set` / agent key 预览
- `update_server`: `ALLOWED_FIELDS` 白名单，禁止 mass-assign `agent_api_key`
- `_sudo_wrap`: 临时 sudoers 白名单命令 + 事后清理
- `setup-files-sudo`: 密码经 stdin 喂 `sudo -S`，不进 argv
- WebSSH: token `server_id` 与路径参数必须一致（防 IDOR）
- CSV import: 大小/行数限制 + formula injection 防护
---
## 验证
```bash
.venv/bin/pytest tests/test_credential_poller.py tests/test_security_unit.py -q
```
---
**下一批**: B2 — `sync_v2.py` + `files.py` + `remote_path_validation.py`
docs/reports/2026-06-06-api-audit-b2-sync-files.md
+58
View File
@@ -0,0 +1,58 @@
# API 巡检 B2 — sync_v2.py + files.py + remote_path_validation.py
**日期**: 2026-06-06
**范围**: 22 个 `/api/sync/*` 端点 + `GET /api/files/browse` + 路径校验模块
## 结论
| 级别 | 数量 | 说明 |
|------|------|------|
| P0 | 0 | — |
| P1 | 0 | — |
| P2 | 1 | 已修：`SyncFiles`/`SyncVerify` `server_ids` 无上限 |
| H | 1 | `_audit_sync` 写失败仅 warning（不阻断业务） |
**批次结论**: **PASS**
---
## 覆盖摘要
| 检查项 | 结果 |
|--------|------|
| 全部 sync 端点 JWT | ✓ 22/22 `get_current_admin` |
| 远程路径 | ✓ `normalize_remote_abs_path` / `remote_join` |
| 本地 staging | ✓ `ensure_under_nexus_upload` 限制 `/tmp/nexus_upload_*` |
| Shell 拼接 | ✓ 普遍 `shlex.quote` |
| 上传限制 | ✓ 单文件 100MB；ZIP 500MB |
| 剪贴板 copy/move | ✓ `assert_clipboard_transfer_safe` 防 dest 在源子树内 |
| files GET browse | ✓ ETag + 路径规范化 + 审计 |
---
## FINDING
### P2-02 — `SyncFiles` / `SyncVerify` `server_ids` 无 max_length（已修）
- **风险**: 超大列表导致海量协程调度与 DB 查询（verify 虽 Semaphore(5) 仍会创建 N 个 task）。
- **修复**: `max_length=2000`（对齐平台子机规模上限）。
- **文件**: `server/api/schemas.py`
### H-04 — `_audit_sync` 异常时 `logger.warning` 不向上抛
- **位置**: `sync_v2.py` `_audit_sync`
- **处置**: 接受 — 审计失败不应阻断文件操作；已有 exc_info 日志。
---
## 安全亮点
- `file-ops` delete 使用 `rm -rf` 但路径经 `normalize_remote_abs_path` 校验
- `upload` 文件名剥离 `/` `\`
- `local-file-ops` rename 禁止 `..` / `.`
- `write-file` 5MB 上限 + etag 乐观锁（409）
- `read-file` 1MB 默认上限
---
**下一批**: B3 — auth + auth_jwt + dependencies
docs/reports/2026-06-06-api-audit-b3-auth.md
+18
View File
@@ -0,0 +1,18 @@
# API 巡检 B3 — auth.py + auth_jwt.py + dependencies.py
**日期**: 2026-06-06
## 结论: **PASS**（0 P0/P1/P2，无代码修改）
| 模块 | 端点/职责 | 结果 |
|------|-----------|------|
| `auth.py` | login/refresh/logout/TOTP/password/webssh-token/me | ✓ refresh HttpOnly cookie；改密/TOTP 需 JWT |
| `auth_jwt.py` | JwtAuthMiddleware + `get_current_admin` | ✓ PUBLIC_PREFIXES 白名单；`tv` 版本校验 |
| `dependencies.py` | DI + `check_dangerous_command` | ✓ 无 session 泄漏；危险命令 warning 日志 |
## 要点
- 登录失败 → 429 锁定（`auth_service`）
- Refresh 重用检测 + `token_version` 递增（`test_auth_refresh_reuse.py` 覆盖）
- WebSSH token 独立 `purpose=webssh` + `server_id` 绑定
- `check_dangerous_command` 为**警告不阻断**（单人运维接受，与 Scripts/WebSSH 一致）
docs/reports/2026-06-06-api-audit-b4-scripts-terminal.md
+19
View File
@@ -0,0 +1,19 @@
# API 巡检 B4 — scripts.py + terminal.py
**日期**: 2026-06-06
## 结论: **PASS**（P2×1 已修）
### P2-03 — `ScriptExecute.server_ids` 无上限（已修）
- **修复**: `max_length=2000`（`schemas.py`）
- 引擎内部分批 50/批、并发 10，与文档一致
### 其他
| 检查 | 结果 |
|------|------|
| JWT 全覆盖 | ✓ |
| `check_dangerous_command` on exec | ✓ 警告级 |
| 长任务回调 HTTPS 校验 | ✓ `master_callback_url` 单测 |
| terminal quick-commands CRUD | ✓ JWT + 审计 |
docs/reports/2026-06-06-api-audit-b5-settings-search-assets.md
+16
View File
@@ -0,0 +1,16 @@
# API 巡检 B5 — settings.py + search.py + assets.py
**日期**: 2026-06-06
## 结论: **PASS**（无代码修改）
| 模块 | 安全要点 | 结果 |
|------|----------|------|
| `settings.py` | reveal API/preset/ssh-key/telegram 均需 `_verify_reauth` | ✓ |
| `settings.py` | 不可改 `SECRET_KEY`/`API_KEY`/`ENCRYPTION_KEY`/`DATABASE_URL` | ✓ 指南约束 |
| `search.py` | `_escape_like` 防 SQL LIKE 注入 | ✓ |
| `assets.py` | nodes/platforms/command-logs/ssh-sessions | ✓ 全 JWT |
### H — bing-wallpapers 公开 GET
- 已在 `PUBLIC_PREFIXES`；只读壁纸 URL，无敏感数据（与 2026-06-04 closure 一致）
docs/reports/2026-06-06-api-audit-b6-agent-install-ws-health.md
+16
View File
@@ -0,0 +1,16 @@
# API 巡检 B6 — agent.py + install.py + websocket.py + health.py
**日期**: 2026-06-06
## 结论: **PASS**（无代码修改）
| 模块 | 认证 | 结果 |
|------|------|------|
| `agent.py` | `X-API-Key`（全局或 per-server） | ✓ 心跳/script-callback 鉴权 |
| `install.py` | 仅安装模式；已安装 → 403 | ✓ 历史 F2a-08/09 已修 |
| `websocket.py` | `/ws/` 在 PUBLIC_PREFIXES；sync/alert 内二次校验 token/batch_id | ✓ |
| `health.py` | `/health` 公开 | ✓ 无敏感信息 |
### 安装向导边界
- 正常模式所有 `/api/install/*` 返回 403（除 status 探测逻辑在 install 模块内处理）
docs/reports/2026-06-06-api-audit-closure.md
+43
View File
@@ -0,0 +1,43 @@
# API 全量巡检 — 总 Closure
**日期**: 2026-06-06
**计划**: B1→B6 按 8 维清单（认证/越权/注入/路径/凭据/输入/错误/审计）
**策略**: 审计 + 当场修复（用户确认）
## 批次索引
| 批 | 模块 | 报告 | P0 | P1 | P2 已修 |
|----|------|------|----|----|---------|
| B1 | servers + webssh | [b1](2026-06-06-api-audit-b1-servers-webssh.md) | 0 | 0 | 1 |
| B2 | sync + files | [b2](2026-06-06-api-audit-b2-sync-files.md) | 0 | 0 | 1 |
| B3 | auth | [b3](2026-06-06-api-audit-b3-auth.md) | 0 | 0 | 0 |
| B4 | scripts + terminal | [b4](2026-06-06-api-audit-b4-scripts-terminal.md) | 0 | 0 | 1 |
| B5 | settings + search + assets | [b5](2026-06-06-api-audit-b5-settings-search-assets.md) | 0 | 0 | 0 |
| B6 | agent + install + ws + health | [b6](2026-06-06-api-audit-b6-agent-install-ws-health.md) | 0 | 0 | 0 |
## 修复汇总
| ID | 问题 | 修复 |
|----|------|------|
| P2-01 | `ServerCheck.server_ids` 无上限 | `max_length=50` |
| P2-02 | `SyncFiles`/`SyncVerify.server_ids` 无上限 | `max_length=2000` |
| P2-03 | `ScriptExecute.server_ids` 无上限 | `max_length=2000` |
| H-03 | pending retry 失败/删除审计不完整 | 补 audit + detail |
## 已接受 H（不阻断）
- WebSSH 遗留 token 无 `tv` 宽限 5s
- `install-agent` 回落全局 `API_KEY`（仅 SSH 下发，不返前端）
- `_audit_sync` 写失败仅日志
- `check_dangerous_command` 警告不阻断执行
## 验证
```bash
.venv/bin/pytest tests/test_security_unit.py tests/test_auth_refresh_reuse.py tests/test_credential_poller.py -q
```
## Changelog
- `docs/changelog/2026-06-06-api-audit-b1-servers-webssh.md`
- `docs/changelog/2026-06-06-api-audit-b2-sync-files.md`
docs/reports/2026-06-06-credential-polling-production-verification.md
+68
View File
@@ -0,0 +1,68 @@
# 凭据轮询 / pending servers — 生产与健康检查验证
**日期**: 2026-06-06
**关联**: [2026-06-06-frontend-14p-contract-audit.md](2026-06-06-frontend-14p-contract-audit.md)
## 生产 API
```bash
curl -sf https://api.synaglobal.vip/health
# → ok
curl -sf https://api.synaglobal.vip/openapi.json | jq '.paths | keys[] | select(test("pending|add-by-ip"))'
```
| 路径 | OpenAPI |
|------|---------|
| `/api/servers/add-by-ip` | ✓ |
| `/api/servers/pending` | ✓ |
| `/api/servers/pending/{pending_id}/retry` | ✓ |
| `/api/servers/pending/{pending_id}` | ✓ |
`AddByIpRequest` 字段：`domain`, `port`, `name`, `agent_port`, `target_path`, `category`, `platform_id`, `node_id`。
## 生产前端（SPA）
构建产物已与本地 `vite build` 一致（主包 `index-o0-2k-vI.js` 哈希相同）。
| 分块 | 关键字探测 |
|------|------------|
| `ServersPage-Z2EpNr-B.js` | `add-by-ip`, `servers/pending`, `快速添加`, `matched_preset` |
| `CredentialsPage-Cf9BpH3x.js` | `username`（24 处） |
**结论**: 后端与前端均已部署到生产，无需本轮再跑 `deploy-frontend.sh`（本地 SSH 别名 `nexus` 亦不可解析）。
## 单元 / 静态门控
| 检查 | 结果 |
|------|------|
| `pytest tests/test_credential_poller.py` | 7 passed |
| `ruff check server/ --select F` | All checks passed |
| `cd frontend && npx vite build` | ✓ built |
## 本地 `local_verify.sh`
**未通过** — 根因：宿主机进程无法完成 MySQL 握手（`OperationalError 2013`），但：
- Docker 内 `mysql` 服务名连接正常（`docker run --network nexus_default mysql:8.4 mysql -h mysql …` → OK）
- 容器 `docker exec nexus-mysql-1` 内查询正常
- 宿主机 `127.0.0.1:3306` / 桥接 IP `172.18.0.3:3306` 均 2013
属本机 Docker 端口转发 / 网络策略问题，与凭据轮询代码无关。
**建议本机恢复路径**：
1. `docker compose up -d nexus --build` — API 走容器内 `mysql` 主机名；或
2. 修复宿主机→Docker MySQL 3306 转发后，对齐 `.env` 中 `NEXUS_DATABASE_URL` 与 `docker-compose` 卷内实际密码；或
3. `NEXUS_TEST_ADMIN_PASSWORD=… python3 scripts/seed_local_admin.py` 后重跑 `bash scripts/local_verify.sh`
## 待用户终验（需登录生产控制台）
1. 凭据页：密码/SSH 预设填写 `username` 并保存
2. 服务器页：「快速添加」输入测试 IP → 成功 toast 或失败弹窗 + 失败列表
3. 失败列表：重试 / 删除
## 未提交工作区（文档 + 类型）
- 契约审计报告、功能指南 §12、附录 J、`types/api.ts` 共享类型
- 代码功能已在 `4ba45ab` 合入；上述为审计收尾文档
docs/reports/2026-06-06-external-attack-hardening-backlog.md
+106
View File
@@ -0,0 +1,106 @@
# 外网攻击面加固 Backlog（audit_only 产出）
**日期**：2026-06-06
**来源**：[`2026-06-06-external-attack-surface-audit.md`](2026-06-06-external-attack-surface-audit.md)
**状态**：BL-01～BL-07 **已实施/已接受**；BL-08 **不需要**（运维确认）；BL-06 **已实施**（2026-06-07）
---
## P2 — 建议优先
### BL-01 收紧 `PUBLIC_PREFIXES` 前缀匹配 ✅ 已实施
| 字段 | 内容 |
|------|------|
| 问题 | EXT-01 `/health/detail`、EXT-02 `bing-wallpapers/sync` 被前缀误放行 |
| 方案 A | 将 `/health` 改为精确路径列表；`/api/settings/bing-wallpapers` 仅匹配 GET（或拆路由前缀） |
| 方案 B | `_is_public_path` 改为精确匹配 + 显式允许方法 |
| 涉及文件 | `server/api/auth_jwt.py` |
| 验收 | 无 JWT 时 `GET /health/detail` → 401；`POST .../sync` → 401 |
| 回滚 | 恢复 `PUBLIC_PREFIXES` 元组 |
### BL-02 `/health/detail` 强制鉴权（防御纵深） ✅ 已实施
| 字段 | 内容 |
|------|------|
| 问题 | 非 `/api/` 路径不走 JwtAuthMiddleware |
| 方案 | handler 内显式 `if admin is None: raise 401`；或把 detail 移到 `/api/health/detail` |
| 涉及文件 | `server/api/health.py`、`server/main.py` DbSessionMiddleware 路径列表 |
| 验收 | 生产探测 401 |
### BL-03 `bing_wallpapers_sync` 拒绝 `admin is None` ✅ 已实施
| 字段 | 内容 |
|------|------|
| 方案 | `Depends(get_current_admin)` 返回 None 时 raise 401（与 BL-01 双保险） |
| 涉及文件 | `server/api/settings.py` |
---
## H — 信息暴露与运维
### BL-04 生产关闭 OpenAPI / Swagger / ReDoc ✅ 已实施
| 字段 | 内容 |
|------|------|
| 问题 | EXT-03 全 API schema 公网可读 |
| 方案 A | `FastAPI(..., docs_url=None, redoc_url=None, openapi_url=None)` |
| 方案 B | Nginx/1Panel `location` deny 或 internal only |
| 验收 | `GET /openapi.json` → 404 |
| 备注 | 开发环境可保留文档 |
### BL-05 已安装后隐藏 install 指纹 ✅ 已实施
| 字段 | 内容 |
|------|------|
| 实现 | `_raise_not_found_if_locked()`；全部 install 端点锁定后 404 |
| 涉及文件 | `server/api/install.py`、`tests/test_install_locked_404.py` |
| 验收 | 锁定后所有 `/api/install/*` → 404 |
### BL-06 Agent per-server key 迁移 ✅ 已实施
| 字段 | 内容 |
|------|------|
| 问题 | global `API_KEY` legacy 回退（原 risk-acceptance 接受项 2） |
| 方案 | 移除 `agent.py` / `servers.py` / `script_service.py` 中 global 回退；强制 per-server key |
| 实施日期 | 2026-06-07（生产 0 台子机窗口） |
| 验收 | `tests/test_agent_per_server_key.py`；global key 打 heartbeat → 401 |
| changelog | `docs/changelog/2026-06-07-agent-per-server-key-enforced.md` |
### BL-07 WebSocket 外网探测与反代 ✅ 已澄清/接受
| 字段 | 内容 |
|------|------|
| 原问题 | 外网无 token 探测见 HTTP 403，误以为反代未转发 WS |
| 结论 | 直连 8600 同为 403；1Panel 反代已带 Upgrade；**有效 JWT 可连** `/ws/alerts`、`/ws/sync` |
| 根因 | `websocket.close(4001/4401)` 在 `accept()` 前 → 黑盒见 HTTP 403，非安全缺陷 |
| 证据 | [`2026-06-06-external-hardening-deploy-verification.md`](2026-06-06-external-hardening-deploy-verification.md) §WebSocket |
| 动作 | 更新 `security_probe_external.sh`：无 token 拒绝即 PASS；**无需改 Nginx** |
### BL-08 全站 IP 白名单 ❌ 不需要
| 字段 | 内容 |
|------|------|
| 决定 | 2026-06-06 运维确认：**不实施** |
| 理由 | 单人自用；2000+ 子机 Agent 需放行 `/api/agent/*`，全站白名单 ROI 低 |
| 维持 | 仅 login IP allowlist（`LOGIN_ALLOWLIST_ENABLED`）即可 |
---
## 验证清单（修复批次）
```bash
NEXUS_PROBE_BASE=https://api.synaglobal.vip bash scripts/security_probe_external.sh
# 期望：health/detail 401；bing sync 401；openapi 404（若 BL-04）
bash scripts/local_verify.sh
```
---
## 不建议本轮做
| 项 | 原因 |
|----|------|
| WS ticket 首帧鉴权 | 单人运维 ROI 低，已接受 |
| 登录暴破 CAPTCHA | 已有 15min 锁定 |
| 关闭 `/agent/install.sh` 公网 | 破坏远程安装流程 |
docs/reports/2026-06-06-external-attack-probe-production.md
+76
View File
@@ -0,0 +1,76 @@
# 外网黑盒探测记录 — 生产 api.synaglobal.vip
**日期**：2026-06-06
**目标**：`https://api.synaglobal.vip`
**脚本**：`scripts/security_probe_external.sh`
**约束**：无 JWT、无真实 API Key、无登录暴破、无破坏性写操作（除只读探测外仅单次错误登录与假 Key 请求）
## 执行命令
```bash
NEXUS_PROBE_BASE=https://api.synaglobal.vip bash scripts/security_probe_external.sh
```
日志：`/tmp/nexus-external-probe/probe-20260606T160732Z.txt`
## 探测结果摘要
| 探测项 | 期望 | 实际 | 判定 |
|--------|------|------|------|
| `GET /health` | 200 纯文本 ok | 200 `ok` | PASS |
| `GET /health/detail` | 401 | **200** + redis/mysql/ws 状态 | **FAIL (P2)** |
| `GET /openapi.json` | 记录 | 200 全量 OpenAPI 3.1 | WARN (H) |
| `GET /docs` | 记录 | 200 Swagger UI | WARN (H) |
| `GET /redoc` | 记录 | 200 ReDoc | WARN (H) |
| `GET /api/install/status` | 404（已锁定） | 404 空 body | PASS |
| `GET /api/install/env-check` 等 | 403/404 | 403「安装向导已锁定」 | PASS |
| `POST /api/install/*` | 403 | 422（探测 body 不满足 Pydantic；锁定逻辑在合法 body 前亦会 403） | INFO |
| `GET /api/settings/bing-wallpapers` | 200 只读 URL | 200 urls[] | PASS |
| `POST /api/settings/bing-wallpapers/sync` | 401 | **200** + downloaded=8 | **FAIL (P2)** |
| `GET/POST /api/servers/` | 401 | 401 Missing Authorization | PASS |
| `GET /api/audit/` | 401 | 401 | PASS |
| `POST /api/agent/heartbeat` 无 Key | 拒绝 | 422（缺 Header） | PASS（仍拒绝） |
| `POST /api/agent/heartbeat` 假 Key | 401 | 401 | PASS |
| `POST /api/agent/script-callback` 假 Key | 401/404 | 422（缺字段；带 Key 时预期 401/404） | PASS |
| `POST /api/auth/login` 错误用户 | 统一错误文案 | `用户名或密码错误` | PASS |
| `GET /agent/install.sh` | 200 | 200 安装脚本 | INFO（设计如此） |
| `WS /ws/alerts` 无 token | 4001 或拒绝 | **HTTP 403**（反代层） | INFO |
| `WS /ws/alerts` 假 token | 4401 或拒绝 | **HTTP 403** | INFO |
## 响应片段（关键 FINDING）
### `/health/detail` 未授权可读
```http
GET /health/detail HTTP/1.1
Host: api.synaglobal.vip
HTTP/1.1 200 OK
{"status":"ok","checks":{"python":"ok","redis":"ok","mysql":"ok","websocket_clients":0}}
```
### `bing-wallpapers/sync` 未授权可触发外联同步
```http
POST /api/settings/bing-wallpapers/sync HTTP/1.1
Content-Type: application/json
```
### OpenAPI 可访问（节选）
`GET /openapi.json` → 200，含全部管理 API path（含 `/api/servers/pending/add-by-ip` 等）。
## WebSocket 说明
外网经 `wss://api.synaglobal.vip/ws/*` 握手在到达应用前被反代返回 **403**，无法在公网直接观测应用层 close code **4001/4401**。应用代码（`server/api/websocket.py`）在无 token 时设计为 4001。
## 结论
- **0 个 P0/P1**（未授权 RCE、未授权写库、未授权读密文）
- **2 个 P2**：`/health/detail` 组件指纹泄露；`bing-wallpapers/sync` 未授权触发外联下载
- **多项 H**：OpenAPI/Swagger/ReDoc 暴露；WS 外网 403 无法验证 ADR-011 关闭码
详见 [`2026-06-06-external-attack-surface-audit.md`](2026-06-06-external-attack-surface-audit.md)。
详见 [`2026-06-06-external-attack-surface-audit.md`](2026-06-06-external-attack-surface-audit.md)。
docs/reports/2026-06-06-external-attack-surface-audit.md
+187
View File
@@ -0,0 +1,187 @@
# 外网攻击面安全巡检报告（E1–E6）
**日期**：2026-06-06
**范围**：生产 `https://api.synaglobal.vip` 无 JWT / 弱认证暴露面
**信任边界**：已登录管理员视为可信；本轮不审计持 JWT 后的管理操作
**模式**：audit_only（仅报告与 backlog，**本轮不修改应用代码**）
**黑盒证据**：[`2026-06-06-external-attack-probe-production.md`](2026-06-06-external-attack-probe-production.md)
---
## 1. 攻击面资产表（E1）
来源：`server/api/auth_jwt.py` `PUBLIC_PREFIXES`、`server/main.py` 路由与静态挂载、OpenAPI 交叉核对。
### 1.1 JWT 中间件跳过路径（`PUBLIC_PREFIXES`）
| 前缀/路径 | 方法 | 二次鉴权 | 说明 |
|-----------|------|----------|------|
| `/api/auth/login` | POST | 无 | 暴破/枚举面；15min 锁定 |
| `/api/auth/refresh` | POST | HttpOnly cookie | 刷新令牌 |
| `/api/auth/logout` | POST | body refresh | 吊销 refresh |
| `/api/agent/*` | POST | `X-API-Key` + per-server | heartbeat、script-callback |
| `/api/install/*` | GET/POST | 安装锁 + install_token | 已锁定除 status 外 403 |
| `/api/settings/bing-wallpaper(s)` | GET | 无 | 只读壁纸 URL |
| `/api/settings/bing-wallpapers/sync` | POST | **应为 JWT**；见 §2 FINDING | 前缀匹配导致误放行 |
| `/health` | GET | 无 | 纯文本 `ok` |
| `/health/detail` | GET | **应为 JWT**；见 §2 FINDING | 前缀 `/health` 误匹配 |
| `/ws/*` | WS | Query JWT / WebSSH token | ADR-011 |
| `/openapi.json` `/docs` `/redoc` | GET | 无 | FastAPI 默认文档 |
| 其余 `/api/*` | * | JwtAuthMiddleware Bearer | 401 无 token |
**注意**：`JwtAuthMiddleware` 仅拦截 `path.startswith("/api/")`；`/health/detail` 不走中间件，完全依赖 `Depends(get_current_admin)`，与 `PUBLIC_PREFIXES` 前缀匹配叠加后失效。
### 1.2 静态与前端壳
| 路径 | 认证 | 文件 |
|------|------|------|
| `/app/*` | 无（SPA）；`AppAuth` 仅校验 refresh cookie 格式 | `web/app/` |
| `/agent/install.sh` `agent.py` `agent.sh` `uninstall.sh` | 无 | `web/agent/` |
| `/app/install.html` | 安装模式；锁定后归档为 `.bak` | 安装向导 |
### 1.3 Install API 端点（`prefix=/api/install`）
| 端点 | 方法 | 已锁定生产实测 |
|------|------|----------------|
| `/status` | GET | **404**（`_is_locked()`） |
| `/env-check` | GET | 403 |
| `/connection-check` | GET | 403 |
| `/state` | GET | 403 |
| `/test-credentials` | POST | 403（合法 body） |
| `/init-db` | POST | 403 |
| `/create-admin` | POST | 403 + install_token |
| `/lock` | POST | 403 |
### 1.4 Agent API
| 端点 | 认证链 |
|------|--------|
| `POST /api/agent/heartbeat` | Header `X-API-Key` → `_verify_server_api_key(server_id)` |
| `POST /api/agent/script-callback` | 同上 + `job_id`/`secret` + Redis 限速 |
控制面**无** `/api/agent/exec`（P0 RCE 已移除，注释见 `agent.py:378`）。
---
## 2. 生产黑盒探测（E2）
见 [`2026-06-06-external-attack-probe-production.md`](2026-06-06-external-attack-probe-production.md)。
### FINDING 汇总
| ID | 级别 | 问题 | 根因（代码） |
|----|------|------|--------------|
| EXT-01 | **P2** | `GET /health/detail` 无 JWT 返回组件状态 | `PUBLIC_PREFIXES` 含 `/health`，`_is_public_path` 使 `get_current_admin` 无凭证返回 `None`；handler 未校验 admin |
| EXT-02 | **P2** | `POST /api/settings/bing-wallpapers/sync` 无 JWT 可触发 Bing 下载 | 同上：`/api/settings/bing-wallpapers` 前缀匹配 `/sync` 子路径 |
| EXT-03 | **H** | `/openapi.json` `/docs` `/redoc` 公网可访问 | `main.py` 未设 `docs_url=None`；前缀在 PUBLIC |
| EXT-04 | **H** | 外网 WS 握手 HTTP 403，无法验证 4001/4401 | 反代/Nginx 规则；应用层逻辑见 `websocket.py` |
| — | PASS | 管理 API、假 Agent Key、锁定 install | JwtAuthMiddleware / `_reject_if_locked` |
**P0/P1：0**（无未授权 RCE、写库、读密文、重装成功）。
---
## 3. Agent M2M 滥用链（E3）
### 3.1 认证逻辑
```mermaid
sequenceDiagram
participant Attacker
participant API as Nexus_API
participant Redis
participant WS as WebSocket_clients
Note over Attacker: 持有泄露的 global API_KEY
Attacker->>API: POST /api/agent/heartbeat<br/>X-API-Key + server_id=N
API->>API: server 存在且无 agent_api_key?
alt legacy 服务器
API->>Redis: HSET heartbeat:N
API->>WS: broadcast_alert 若超阈值
API-->>Attacker: 200 ok
else 已有 per-server key
API-->>Attacker: 401
end
```
- **全局 Key 回退**：~~`server/api/agent.py:84-92`~~ **已移除（BL-06，2026-06-07）** — Agent 仅接受 per-server `agent_api_key`。
- **影响**：伪造心跳需持有目标服务器的 per-server key；global `API_KEY` 不再通行。
- **script-callback**：需有效 `job_id` + `secret`（一次性）+ per-server key；`check_script_callback_rate` 每 job 10/min、每 IP 60/min（`script_callback_rate.py`）。
- **生产探测**：假 Key 或 global Key → **401**。
**与 risk-acceptance 关系**：接受项 2 已于 2026-06-07 收口，见 [`risk-acceptance-single-operator.md`](../project/risk-acceptance-single-operator.md) §接受项 2。
---
## 4. 安装向导边界（E4）
### 4.1 令牌逻辑（代码）
- `_verify_install_token`：`secrets.compare_digest` + 状态文件 `install_token`（`install.py:933-946`）。
- 无状态文件 → 403；暴力需猜 256-bit 级 token，**不可行**。
- `create-admin` / `lock` 需 token 或已完成步骤。
### 4.2 已安装 + 锁定（生产）
- **BL-05（2026-06-07）**：全部 `/api/install/*` → **404** `Not found`（含 status、env-check、init-db、lock 等），无中文指纹。
- **无法**外网重装（init-db/create-admin 被锁）。
### 4.3 残余 H
- 未锁定环境下 `/status` 会返回 `installed/locked/configured`（仅安装模式相关）。
- OpenAPI 仍暴露 install 路径 schema（EXT-03）。
---
## 5. 认证与会话（E5）
| 项 | 结论 |
|----|------|
| 登录暴破 | `MAX_LOGIN_FAILURES` + 15min 锁定（`auth_service.py:122-130`）；**本轮未跑循环暴破** |
| IP allowlist | **仅 `login()`**（`auth_service.py:98-120`）；拿到 JWT 后**不受** allowlist 约束 |
| 用户名枚举 | 生产单次错误登录：`用户名或密码错误`（不存在与密码错误文案统一）— PASS |
| Refresh | HttpOnly + Secure + SameSite=Lax；重用检测见 `tests/test_auth_refresh_reuse.py` |
| Logout CSRF | SameSite=Lax 降低跨站 POST 风险 |
**外网主要面**：`/api/auth/login` 暴破（有锁定）、refresh cookie 窃取（需 XSS/本机恶意软件）。
---
## 6. 总结与验收
| 验收项 | 状态 |
|--------|------|
| 生产黑盒脚本 + 证据 | ✅ `scripts/security_probe_external.sh` + probe 报告 |
| PUBLIC_PREFIXES + static 覆盖 | ✅ §1 |
| 0 未解释 P0/P1 | ✅ |
| 加固 backlog 独立 | ✅ [`2026-06-06-external-attack-hardening-backlog.md`](2026-06-06-external-attack-hardening-backlog.md) |
### 分级统计
- **P0**：0
- **P1**：0
- **P2**：2（EXT-01、EXT-02）
- **H**：2+（EXT-03、EXT-04、OpenAPI 指纹、Agent legacy 已接受）
### 与 B1–B6 API 巡检关系
| 已完成 B 轮 | 本轮 E 轮 |
|-------------|-----------|
| 鉴权后逻辑、输入上限 | 无 JWT 暴露面 |
| 当场修复若干 schema 上限 | audit_only，修复进 backlog |
---
## 7. 加固项状态（2026-06-07 更新）
| ID | 项 | 状态 |
|----|-----|------|
| BL-06 | Agent per-server key 迁移 | **已实施**（2026-06-07）：移除 global `API_KEY` 回退，强制 per-server `agent_api_key`；见 changelog `2026-06-07-agent-per-server-key-enforced.md` |
| BL-07 | WebSocket 探测口径 | **已接受**：无 token 外网 HTTP 403 为应用拒绝握手；登录后 WS 正常；见 deploy-verification §WebSocket |
| BL-08 | 全站 IP 白名单 | **不需要**（运维确认不实施；维持仅 login allowlist） |
**已实施加固**：BL-01～BL-06（见 backlog 与 changelog）。
---
**下一步**：部署后重跑 `security_probe_external.sh`；新增第一台子机时走「创建 → 远程安装 Agent」验证 per-server 心跳。
docs/reports/2026-06-06-external-hardening-deploy-verification.md
+54
View File
@@ -0,0 +1,54 @@
# 外网加固部署与生产验证（2026-06-06）
## Git 推送
| 项 | 状态 |
|----|------|
| Commit | `e5e2582` — `fix(security): 外网攻击面加固 BL-01～05` |
| 远程 | `http://66.154.115.8:3000/admin/Nexus.git` `main` |
| Push | ✅ `722917b..e5e2582` |
## 生产部署
| 项 | 状态 |
|----|------|
| 方式 | `ssh -i nz-admin.pem azureuser@20.24.218.235` → `sudo nx update` |
| 版本 | **e5e2582** `fix(security): 外网攻击面加固 BL-01～05` |
| 容器 | `nexus-prod-nexus-1` 重建 healthy |
| `/health` | `ok` |
## 生产探测（部署后 — 2026-06-06）
`https://api.synaglobal.vip`：
| 探测项 | 结果 | 判定 |
|--------|------|------|
| `GET /health/detail` | **401** | ✅ BL-02 |
| `GET /openapi.json` `/docs` `/redoc` | **404** | ✅ BL-04 |
| `GET /api/install/status` | **404** | ✅ |
| `GET /api/install/env-check` 等 | **404** | ✅ BL-05 |
| `POST /api/install/lock` | **404** | ✅ BL-05 |
| `POST /api/settings/bing-wallpapers/sync` | **401** | ✅ BL-03 |
| `GET/POST /api/servers/` | **401** | ✅ |
| Agent 假 Key | **401** | ✅ |
**备注**：`POST /api/install/init-db` 等若 body 不满足 Pydantic，FastAPI 在 handler 前返回 **422**（非 403 指纹）；带合法 body 的锁定请求为 404。可接受，后续可用 router 级 Depends 提前 404。
## WebSocket（BL-07 已澄清）
| 场景 | 结果 | 说明 |
|------|------|------|
| 外网无 token / 假 token | HTTP **403** | Starlette 在 `accept()` 前 `close(4001/4401)` 时，黑盒常见 HTTP 403，**非反代故障** |
| 直连 `ws://127.0.0.1:8600/ws/alerts` 无 token | HTTP **403** | 与经 HTTPS 一致，排除仅反代问题 |
| 1Panel `root.conf` | 含 `Upgrade` / `Connection` | 全站反代至 8600，配置正常 |
| 登录后 `wss://.../ws/alerts?token=<JWT>` | **连接成功** | 2026-06-06 生产验证 |
| 登录后 `wss://.../ws/sync?token=<JWT>` | **连接成功** | 同上 |
**结论**：BL-07 标为**接受**（与 risk-acceptance ADR-011 一致）；外网探测脚本以「无 token 拒绝连接」为 PASS，不要求 HTTP 层可见 4001/4401。
## 本地测试（推送前已通过）
```bash
pytest tests/test_install_locked_404.py tests/test_external_attack_surface_hardening.py -q
# 12 passed
```
docs/reports/2026-06-06-frontend-14p-contract-audit.md
+239
View File
@@ -0,0 +1,239 @@
# 前端 14 页 API 契约审计（含凭据轮询）
**日期**: 2026-06-06
**基线**: [audit-frontend-14p-2026-06-04-closure.md](audit-frontend-14p-2026-06-04-closure.md)（43 H，0 P0/P1）
**增量范围**: 凭据轮询 `add-by-ip` / `pending_servers`；预设 `username` 字段
**方法**: 静态对照 `frontend/src/pages/*` + composables ↔ `server/api/*.py` 路由与响应形
## 结论
| 维度 | 结果 |
|------|------|
| 14 页 API 路径 | **PASS** — 全部端点在后端存在且 HTTP 方法一致 |
| 新增契约（Servers / Credentials） | **PASS** — 请求/响应字段前后端对齐 |
| 类型集中化 | **PASS** — `PendingServerItem` / `AddByIpResponse` / `PollErrorItem` 已入 `types/api.ts` |
| 单元测试 | **PASS** — `tests/test_credential_poller.py` 7 passed |
| 本地门控 | **WARN** — `local_verify.sh` 因本地 MySQL 断连未跑通（环境问题，非契约缺口） |
| 生产 SPA 部署 | **PASS** — `ServersPage`/`CredentialsPage` 分块已含新契约；见 [production-verification](2026-06-06-credential-polling-production-verification.md) |
**新 FINDING**: 0 × P0/P1，0 × P2（契约层）
---
## 1. 凭据轮询契约（增量）
### 1.1 后端
| 方法 | 路径 | 实现 |
|------|------|------|
| POST | `/api/servers/add-by-ip` | `servers.py` → `poll_credentials` → 成功 `create_server` / 失败 `pending_servers` |
| GET | `/api/servers/pending` | `PendingServerRepositoryImpl.list_all` |
| POST | `/api/servers/pending/{id}/retry` | 再轮询；域名已存在 → 409 |
| DELETE | `/api/servers/pending/{id}` | 204 |
预设 `username`: `settings.py` `GET/POST/PUT` `/presets/`、`/ssh-key-presets/`。
### 1.2 前端
| 组件 | 调用 |
|------|------|
| `ServersPage.vue` | 上述四端点；`onMounted` 加载 pending |
| `CredentialsPage.vue` | 预设 CRUD 含 `username`（默认 `root`） |
### 1.3 响应形对照
| 字段 | 后端 | 前端消费 |
|------|------|----------|
| `success` | ✓ | 分支成功/失败 |
| `server` | `Server` 序列化 | 刷新列表 |
| `matched_preset` / `matched_username` | ✓ | 成功 toast |
| `pending_id` | ✓ | 失败后可查列表 |
| `errors[]` | `PollError` 列表 | 失败对话框表格 |
| `message` | 聚合摘要 | 对话框标题区 |
---
## 2. 十四页 API 矩阵
前缀均为 `/api`；`http` 客户端已含前缀，下表写相对路径。
### 2.1 DashboardPage `/`
| 端点 | 方法 | 后端 | 状态 |
|------|------|------|------|
| `/servers/stats` | GET | `servers.py` | OK |
| `/alert-history/` | GET | `alert_history.py` | OK |
| `/audit/` | GET | `audit.py` | OK |
| `/servers/` | GET | `servers.py` | OK |
| `/settings/bing-wallpapers/sync` | POST | `settings.py` | OK |
### 2.2 ServersPage `/servers`
| 端点 | 方法 | 状态 |
|------|------|------|
| `/servers/` | GET/POST/PUT/DELETE | OK |
| `/servers/stats` | GET | OK |
| `/servers/check` | POST | OK |
| `/servers/batch/install-agent` 等 | POST | OK |
| `/servers/{id}/logs` | GET | OK |
| `/servers/add-by-ip` | POST | **新增 OK** |
| `/servers/pending` | GET | **新增 OK** |
| `/servers/pending/{id}/retry` | POST | **新增 OK** |
| `/servers/pending/{id}` | DELETE | **新增 OK** |
| `/presets/`、`/ssh-key-presets/`、`/assets/nodes` | GET | OK（表单 composable） |
### 2.3 TerminalPage `/terminal`
| 端点 | 方法 | 位置 | 状态 |
|------|------|------|------|
| `/auth/webssh-token` | POST | `useTerminalSessions` | OK |
| `/servers/` | GET | `useTerminalSessions` | OK |
| `/terminal/quick-commands` | GET/POST/PUT/DELETE | `useTerminalQuickCommands` | OK |
| `/terminal/quick-commands/reorder` | PUT | `useTerminalQuickCommands` | OK |
| WebSocket `/ws/terminal` | WS | 页内 | OK（RISK 已接受） |
### 2.4 FilesPage `/files`
| 端点 | 方法 | Composable | 状态 |
|------|------|------------|------|
| `/files/browse` | GET | `useFilesBrowse`（首选） | OK |
| `/sync/browse` | POST | `useFilesBrowse` 回退 | OK |
| `/servers/{id}/files-capability` | GET | `useFilesPermissions` | OK |
| `/servers/{id}/setup-files-sudo` | POST | `useFilesPermissions` | OK |
| `/sync/read-file`、`write-file`、`file-ops`、`chmod`、`compress`、`decompress`、`file-clipboard`、`upload` | POST | `useFilesActions` 等 | OK |
### 2.5 PushPage `/push`
| 端点 | 方法 | Composable | 状态 |
|------|------|------------|------|
| `/servers/` | GET | `usePushServers` | OK |
| `/sync/preview` | POST | `usePushPreview` | OK |
| `/sync/files` | POST | `usePushProgress` | OK |
| `/sync/cancel` | POST | `usePushProgress` | OK |
| `/servers/logs` | GET | `usePushLogs` | OK |
| `/sync/reconcile-stale-logs` | POST | `usePushLogs` | OK |
| `/sync/diagnose` | POST | `usePushLogs` | OK |
| WebSocket `/ws/sync` | WS | `usePushProgress` | OK（RISK 已接受） |
### 2.6 ScriptsPage `/scripts`
| 端点 | 方法 | 状态 |
|------|------|------|
| `/scripts/` | GET/POST/PUT/DELETE | OK |
| `/scripts/exec` | POST | OK |
| `/scripts/executions` | GET | OK |
| `/scripts/executions/{id}` | GET | OK |
| `/scripts/executions/{id}/stop` | POST | OK |
### 2.7 CredentialsPage `/credentials`
| 端点 | 方法 | 状态 |
|------|------|------|
| `/presets/` | GET/POST/PUT/DELETE | OK；**username 新增** |
| `/ssh-key-presets/` | GET/POST/PUT/DELETE | OK；**username 新增** |
| `/scripts/credentials` | GET/POST/PUT/DELETE | OK |
### 2.8 SchedulesPage `/schedules`
| 端点 | 方法 | 状态 |
|------|------|------|
| `/schedules/` | GET/POST/PUT/DELETE | OK |
| `/sync/files` | POST（runNow） | OK |
### 2.9 RetriesPage `/retries`
| 端点 | 方法 | 状态 |
|------|------|------|
| `/retries/` | GET | OK |
| `/retries/{id}/retry` | POST | OK |
| `/retries/{id}` | DELETE | OK |
### 2.10 CommandsPage `/commands`
| 端点 | 方法 | 状态 |
|------|------|------|
| `/assets/command-logs` | GET | OK |
| `/assets/ssh-sessions` | GET | OK |
### 2.11 AlertsPage `/alerts`
| 端点 | 方法 | 状态 |
|------|------|------|
| `/alert-history/stats` | GET | OK |
| `/alert-history/` | GET | OK |
### 2.12 AuditPage `/audit`
| 端点 | 方法 | 状态 |
|------|------|------|
| `/audit/` | GET | OK |
### 2.13 SettingsPage `/settings`
| 端点 | 方法 | 状态 |
|------|------|------|
| `/settings/` | GET | OK |
| `/settings/{key}` | PUT | OK |
| `/settings/telegram/test` | POST | OK |
| `/settings/telegram/reveal-token` | POST | OK |
| `/settings/api-key/reveal` | POST | OK |
| `/settings/ip-allowlist` | GET/POST | OK |
| `/settings/ip-allowlist/toggle` | POST | OK |
| `/auth/password` | PUT | OK |
| `/auth/totp/setup` | POST | OK |
| `/auth/totp/enable` | POST | OK |
| `/auth/totp/disable` | POST | OK |
### 2.14 LoginPage `/login`
| 端点 | 方法 | 状态 |
|------|------|------|
| `/settings/bing-wallpapers` | GET | OK（公开只读） |
| `/auth/login` | POST | `stores/auth`（非页内直接调） | OK |
### 2.15 全局（App / auth store）
| 端点 | 方法 | 状态 |
|------|------|------|
| `/search/` | GET | `App.vue` | OK |
| `/auth/me` | GET | `stores/auth` | OK |
| `/auth/logout` | POST | `stores/auth` | OK |
---
## 3. 与 2026-06-04 closure 的差异
| 变更 | 说明 |
|------|------|
| ServersPage +4 端点 | 凭据轮询快速添加与失败队列 |
| CredentialsPage 预设 | `username` 字段贯通 DB / API / UI |
| `types/api.ts` | 新增 pending 相关类型 |
| 功能指南 §12.2、§12.7 | 已更新 |
| 附录 J | 新增凭据轮询专章 |
跨页 RISK（WS JWT、危险命令、bing 公开 GET）**无变化**，仍见 `risk-acceptance-single-operator.md`。
---
## 4. 验证记录
```bash
.venv/bin/pytest tests/test_credential_poller.py -q # 7 passed
cd frontend && npx vite build # OK
```
```bash
# 待环境恢复后
bash scripts/local_verify.sh
cd frontend && NEXUS_E2E_BASE=http://127.0.0.1:8600 npm run test:e2e
```
---
## 5. 后续建议
1. 生产部署前端构建物（`ServersPage` / `CredentialsPage` 新 UI）。
2. 可选 E2E：快速添加 IP → 失败列表 → 重试/删除。
3. `acceptance_catalog.py` 可增加 `add-by-ip` 条目（若纳入 L4 回归）。
**维护**: 改 API 时同步更新本报告对应行、附录 J、功能指南 §12。
docs/reports/2026-06-07-alignment-plan-phase1-verification.md
+47
View File
@@ -0,0 +1,47 @@
# 对齐计划 Phase 1 部署验证
**日期**：2026-06-07
**生产版本**：`fb6a4be7`
**URL**：https://api.synaglobal.vip
## A 类 — 部署验证
| ID | 项 | 结果 | 证据 |
|----|-----|------|------|
| A-01 | 生产部署 API + 前端 | **PASS** | `deploy/deploy-production.sh` → `/health` ok、`/app/` 200 |
| A-02 | `push_schedules.target_path` 迁移 | **待 SSH 复核** | API 重启后 `run_schema_migrations` 自动 DDL；本机无 SSH key |
| A-03 | 脚本库生产点验 | **待浏览器** | `ScriptsPage-Bt6WITgz.js` 已随镜像构建 |
| A-04 | 调度生产点验 | **待浏览器** | `SchedulesPage-Bn9s0WQt.js` 已随镜像构建 |
| A-05 | 边端 Agent 401 | **待子机同步** | `web/agent/agent.py` 已合入镜像；子机需手动更新 |
## B 类 — 本批实现
| ID | 项 | 结果 |
|----|-----|------|
| B-01 | Commands 推送日志视图 | **PASS**（代码+构建）`CommandsPage-q-bsIegj.js` |
| B-04 | CSV 导入模板 | **部分** — 静态 URL 生产 404；已补 `Dockerfile.prod` + `frontend/public/` 待再部署 |
| B-05 | 功能指南 §12.6/12.8/12.10 | **PASS** |
## E 类
| ID | 项 | 结果 |
|----|-----|------|
| E-08 | acceptance_catalog | **PASS** |
| E-22 | 功能指南扩写 | **PASS**（同 B-05） |
## 命令记录
```bash
bash deploy/deploy-production.sh
# fb6a4be7 · Docker rebuild · /health ok · /app/ 200
curl -sS https://api.synaglobal.vip/health # ok
curl -w "%{http_code}" https://api.synaglobal.vip/app/servers_import_template.csv # 404（Dockerfile 未 COPY，已修待再部署）
```
## 下一批（计划 Week 1 剩余）
- 再部署含 CSV Dockerfile 修复
- A-02～A-05 浏览器/SSH 终验
- D-01 Agent upgrade 对齐
- B-02 Dashboard 趋势图
docs/reports/2026-06-07-bl07-deploy-verification.md
+53
View File
@@ -0,0 +1,53 @@
# BL-07 / code-review 跟进 — 生产部署验证（2026-06-07）
## Git
| 项 | 值 |
|----|-----|
| Commit | `72d82d7` — `fix(security): BL-07 WS 403 澄清与 code-review 跟进加固` |
| 上一版 | `e5e2582` |
| 远程 | Gitea `main` 已同步 |
## 部署
| 项 | 状态 |
|----|------|
| 触发 | 菜单 **1** → `deploy-production.sh` 运行时检测为 `unknown`（azureuser 无 docker 组） |
| 实际执行 | `ssh azureuser@20.24.218.235` → `sudo bash /opt/nexus/deploy/nexus-1panel.sh upgrade` |
| MySQL 备份 | `/var/backups/nexus/nexus-before-upgrade-20260607-043622.sql.gz` |
| 容器 | `nexus-prod-nexus-1` 重建 **healthy** |
| `/health` | `ok` |
| `/app/` | HTTP 200 |
| install.html | 已归档 → HTTP 404 |
## 外网探测（部署后）
`NEXUS_PROBE_BASE=https://api.synaglobal.vip`
| 探测项 | HTTP | 判定 |
|--------|------|------|
| `GET /health` | 200 | ✅ |
| `GET /health/detail` | 401 | ✅ BL-02 |
| `GET /openapi.json` `/docs` `/redoc` | 404 | ✅ BL-04 |
| `GET /api/install/*` | 404 | ✅ BL-05 |
| `POST /api/install/init-db` | **404** | ✅ 路由级 lock（此前为 422） |
| `POST /api/install/create-admin` 等 | 404 | ✅ |
| `POST /api/settings/bing-wallpapers/sync` | 401 | ✅ BL-03 |
| Agent 无 key / 假 key | 422 / 401 | ✅ BL-06 |
| `wss://.../ws/alerts` 无 token | **403** | ✅ BL-07 |
| `wss://.../ws/sync` 无 token | **403** | ✅ BL-07 |
**备注**：2026-06-07 已修复 `security_probe_external.sh` 的 `shift 3` 误用；重跑应全 `[PASS]`（WS 需本机 `websockets` 包）。
## 本地门控（推送前）
```bash
bash deploy/pre_deploy_check.sh # 7/7 PASS
bash scripts/local_verify.sh # 全绿
```
## 后续
- `deploy/deploy-production.sh` 已补 `sudo docker` 回退检测，下次菜单 **1** 应可自动识别 Docker。
- 边端 Agent 需从 `/agent/agent.py` 拉取新版本（401 停循环）；子机不自动升级。
- 可选：修 probe 脚本解析、commit deploy-ssh 相关文档（不含 secrets）。
docs/reports/2026-06-07-code-review-followups-verification.md
+40
View File
@@ -0,0 +1,40 @@
# code-review followups 终验（2026-06-07）
**范围**: `72d82d7` 及后续安全/巡检批次
**Backlog**: BL-01～BL-07 ✅ · BL-08 不需要
## 代码项（H1–H7）
| ID | 内容 | 状态 | 证据 |
|----|------|------|------|
| H1 | 边端 agent 401 停循环 | ✅ | `web/agent/agent.py` L411-418 `return` |
| H2 | install 锁定路由级 404 | ✅ | `install.py` `APIRouter(..., dependencies=[...])` |
| H3 | 归档失败 fail-closed | ✅ | `_finalize_install_lock` 先 `_archive_install_wizard_html` |
| H4 | `nexus-security.mdc` 与 BL-06 对齐 | ✅ | 仅 per-server key |
| H5 | WS 403 探测 PASS | ✅ | `security_probe_external.sh` |
| H6 | probe curl shift 修复 | ✅ | 外网探测全 PASS |
| H7 | resolve_ws_python | ✅ | WS 四路径 PASS |
## 测试
```bash
pytest tests/test_install_locked_404.py tests/test_agent_per_server_key.py tests/test_security_unit.py -q
# 62 passed
```
## 生产
| 项 | 状态 |
|----|------|
| 中心 API | `ea2507d` 已部署，healthy |
| 外网探测 | 2026-06-07 全 PASS |
| install 锁定 | POST init-db → 404 |
## 待运维（非代码）
- **边端 Agent**：从中心拉取新版 `agent.py`，401 后停止心跳循环（子机不自动升级）
- 可选：对仍使用 global key 的旧 agent 在服务器页重新分配 `agent_api_key`
## 结论
**code-review followups 已闭环。** 无未决 BL 项；仅边端 agent 同步为运维动作。
docs/reports/2026-06-07-deploy-align-verification.md
+62
View File
@@ -0,0 +1,62 @@
# 生产验证 — Git 对齐部署 + 前端重建 + Agent 批量升级
**日期**: 2026-06-07
**Commit**: `e5a3f25`
**环境**: https://api.synaglobal.vip
## 部署
| 项 | 结果 |
|----|------|
| 门控 | 7/7 PASS |
| push | `9337f37..e5a3f25 main → main` |
| `deploy-production.sh` | ✓ Docker 镜像重建 + 容器 healthy |
| 远程版本 | `e5a3f25` |
| MySQL 升级前备份 | ✓ `nexus-before-upgrade-20260607-151146.sql.gz` |
## 健康检查
| 检查 | 结果 |
|------|------|
| `GET /health`（本地） | `ok` |
| `GET /app/` | HTTP **200** |
| 外网 HTTPS `/health` | HTTP **200** |
## 前端
| 检查 | 结果 |
|------|------|
| 镜像内 `vite build` | ✓（Dockerfile.prod 多阶段） |
| `useFilesActions.ts` | FormData 字段 `file` 已打入镜像 |
## Layer 3 巡检
| 检查 | 结果 |
|------|------|
| `install_ops_cron.sh` | ✓ 部署后重装 cron |
| 二次演练 Telegram | ✓ 用户已确认收到 |
## Agent 批量升级
| 检查 | 结果 |
|------|------|
| 目标子机 | 1 台（id=1「机器人」） |
| 升级结果 | **1/1 OK** |
| `/agent/agent.py` 含 401 停循环 | ✓（HTTPS 拉取内容 grep 命中） |
方式：容器内运维脚本 SSH 批量升级（等价于 API `batch/upgrade-agent`）。
## 附带修复
| 项 | 说明 |
|----|------|
| `auth.py` | `change_password` 路径 `audit_repo` F821 已修 |
## 结论
**生产已与 Git `e5a3f25` 对齐**；前端、后端、Agent、Layer3 cron 均已就绪。
## 待用户终验
1. 文件页 `server_id=1` 上传小文件
2. 控制台确认「机器人」Agent 在线、心跳正常
docs/reports/2026-06-07-external-security-probe-verification.md
+53
View File
@@ -0,0 +1,53 @@
# 外网安全探测验证（2026-06-07）
**目标**: `https://api.synaglobal.vip`
**脚本**: `bash scripts/security_probe_external.sh`
**生产版本**: `ea2507d`（探测时最新已部署 `c50f65e` 为文档 commit，API 行为一致）
**日志**: `/tmp/nexus-external-probe/probe-20260607T131003Z.txt`
## 结果摘要
| 类别 | PASS | FAIL | WARN/INFO |
|------|------|------|-----------|
| 健康检查 | 2 | 0 | 0 |
| OpenAPI/文档 | 0 | 0 | 3（404 隐藏，符合 BL-04） |
| Install 锁定 | 9 | 0 | 0 |
| 管理 API | 5 | 0 | 0 |
| Agent | 3 | 0 | 0 |
| 登录枚举 | 1 | 0 | 0 |
| WebSocket | 4 | 0 | 0 |
**结论：外网攻击面探测全部 PASS，无 FAIL。**
## 明细
| 探测项 | HTTP/结果 | 判定 |
|--------|-----------|------|
| `GET /health` | 200 | ✅ |
| `GET /health/detail` | 401 | ✅ BL-02 |
| `GET /openapi.json` `/docs` `/redoc` | 404 | ✅ BL-04 |
| `GET /api/install/status` | 404 | ✅ |
| `GET /api/install/*`（env/connection/state） | 404 | ✅ BL-05 |
| `POST /api/install/*`（init-db/create-admin/lock 等） | 404 | ✅ BL-05 |
| `GET /api/settings/bing-wallpapers` | 200 | ✅ 只读公开 |
| `POST /api/settings/bing-wallpapers/sync` | 401 | ✅ BL-03 |
| `GET/POST /api/servers/` | 401 | ✅ |
| `GET /api/audit/` | 401 | ✅ |
| Agent heartbeat 无 Key | 422 | ✅ |
| Agent heartbeat 假 Key | 401 | ✅ |
| script-callback 假 Key | 401 | ✅ |
| 登录错误用户 | 统一「用户名或密码错误」 | ✅ 无枚举 |
| `GET /agent/install.sh` | 200 | ℹ️ 预期公开 |
| `WS /ws/alerts` 无/假 token | HTTP 403 | ✅ BL-07 |
| `WS /ws/sync` 无 token | HTTP 403 | ✅ |
| `WS /ws/terminal/1` 假 token | HTTP 403 | ✅ |
## 与上次对比（2026-06-06）
行为一致：OpenAPI 仍 404、install 仍 404、JWT 保护正常、WebSocket 未认证拒绝。
## 验证命令
```bash
NEXUS_PROBE_BASE=https://api.synaglobal.vip bash scripts/security_probe_external.sh
```
docs/reports/2026-06-07-ops-patrol-deploy-verification.md
+144
View File
@@ -0,0 +1,144 @@
# 生产验证 — Layer 3 宿主机巡检 Telegram 打通
**日期**: 2026-06-07
**Commit**: `f9934bd` — feat(ops-patrol): Layer 3 巡检与 Telegram 配置打通
**环境**: https://api.synaglobal.vip
## 部署
| 项 | 结果 |
|----|------|
| 门控 | 7/7 PASS |
| push | `66a4cba..f9934bd main → main` |
| deploy-production | ✓ Docker 重建，容器 healthy |
| 远程版本 | `f9934bd` |
## 健康检查
| 检查 | 结果 |
|------|------|
| `GET /health` | `ok` |
| `GET /app/` | HTTP 200 |
| 外网 HTTPS | HTTP 200 |
## Layer 3 巡检
| 检查 | 结果 |
|------|------|
| crontab `nexus-health-monitor` | ✓ 已安装（部署脚本自动 `install_ops_cron.sh`） |
| `health_monitor.sh` 手动执行 | exit 0 |
| `/var/log/nexus_health.log` | 空（/health 正常，无告警写入） |
## Telegram / env 同步
| 检查 | 结果 |
|------|------|
| DB `telegram_bot_token` | 未配置 |
| DB `telegram_chat_id` | 未配置 |
| `/app/.env` NEXUS_TELEGRAM_* | 未写入 |
| `read_telegram_env_status()` | `env_synced: false` |
**说明**: 生产尚未在设置页配置 Telegram；配置并保存后应自动 sync，或点「同步巡检 Telegram」。未 sync 时 `health_monitor.sh` 可通过 MySQL 回退（需 DB 有值）。
## API
| 端点 | 未认证 |
|------|--------|
| `GET /api/settings/ops-patrol/status` | 401（预期） |
## 待用户终验
1. 登录设置页 → 配置 Telegram → 确认 Layer 3 区块显示「巡检 Telegram 就绪」
2. 点「同步巡检 Telegram」→ `.env 已同步`
3. （可选）临时停容器验证 Telegram 重启告警
## 结论
**部署成功**；cron 与 health_monitor 已就绪。Telegram 告警需用户在 UI 配置后终验。
---
## 用户配置后复查（2026-06-07）
| 检查 | 结果 |
|------|------|
| 内存 `TELEGRAM_BOT_TOKEN` / `CHAT_ID` | ✓ 已配置 |
| 容器 `/app/.env` NEXUS_TELEGRAM_* | ✓ 已同步 |
| `read_telegram_env_status().env_synced` | **true** |
| 宿主机 `docker/.env.prod` Telegram | 未写入（容器无 host 写权限；不影响） |
| `health_monitor` 读取 Telegram | ✓ **READY via container .env** |
| MySQL DB 回退 | ✓ `db_fallback_ok True` |
| cron `nexus-health-monitor` | ✓ 运行中 |
**Layer 3 巡检 Telegram 闭环已就绪。** /health 连续失败时将能推送 Telegram 并自动重启。
---
## 模拟巡检告警（2026-06-07）
### 发现与修复
| 项 | 说明 |
|----|------|
| Bug | `bump_fail_count` 在 `flock` 子 shell 内递增，`FAIL` 恒为 0，永不触发重启/Telegram |
| Fix | `764703d` — 子 shell 写文件后 `cat` 回传计数 |
| 部署 | 已上线生产 |
### 演练（iptables 阻断 127.0.0.1:8600，容器保持运行）
| 步骤 | 结果 |
|------|------|
| run1 / run2 | fail=1 → fail=2 |
| run3 | fail=3，`last_restart` 已写入，**docker restart 执行** |
| 解除阻断后 | `/health` ok，容器 `Up (healthy)` |
**Telegram**：第 3 次失败应已推送「连续 3 次无响应 / 正在自动重启」及「已恢复」类消息（请用户在 Telegram 确认）。
### 用户确认（2026-06-07）
- ✓ 引号剥离修复后验证消息已收到
- ✓ 中文详细通知（`ea2507d`）已收到
**Layer 3 巡检 + Telegram 闭环终验通过。**
### 注意
- `docker pause` 不适合演练：`docker exec` 无法读 Telegram 配置
- 演练方式：阻断宿主机 localhost 端口或真实进程故障（容器仍 Running）
---
## 二次演练（2026-06-07 15:06 UTC，用户请求）
### 步骤
1. 重置 `fail_count=0`；冷却期已过（距上次重启 >7900s）
2. `iptables -I INPUT -i lo -p tcp --dport 8600 -j DROP`（容器保持 Running）
3. 连续手动执行 `health_monitor.sh` ×3
4. `trap` 解除 iptables；等待 8s 验证恢复
### 结果
| 检查 | 结果 |
|------|------|
| run1 | `fail_count=1`，exit 0 |
| run2 | `fail_count=3`（cron 并发 +1），**触发重启** |
| run3 | `fail_count=4`，exit 0 |
| `/tmp/nexus_health_last_restart` | 已更新（15:07 UTC） |
| `docker restart` | ✓ 容器 `Up (healthy)` |
| 解除阻断后 `/health` | local **200**、HTTPS **200** |
| iptables 残留 | ✓ 已清除 |
| `fail_count` 终态 | **0**（cleanup 重置） |
**Telegram（请用户在群组确认）**：
- 🔴 「连续 3 次无响应 / 正在自动重启…」
- 🟢 「Nexus 已自动恢复」（重启后 /health 通过）
### 用户确认（2026-06-07 续）
- ✓ 二次演练 Telegram 两条消息均已收到
### 结论
Layer 3 巡检告警 + 自动重启 + 恢复通知 **二次演练终验通过**。
docs/reports/2026-06-07-settings-telegram-verification.md
+51
View File
@@ -0,0 +1,51 @@
# 生产验证 — 设置页 Telegram 全流程修复
**日期**：2026-06-07
**版本**：`540a7fc`
**环境**：https://api.synaglobal.vip
## 部署
| 项 | 结果 |
|----|------|
| 门控 | 7/7 PASS |
| Push | `2e911dc..540a7fc main` |
| 生产升级 | `sudo nx upgrade` 成功 |
| 容器 | `nexus-prod-nexus-1` healthy |
| `/health` | ok |
| `/app/` | HTTP 200 |
| 前端 bundle | `SettingsPage-rMrgLXrw.js`（镜像内 vite build） |
## API 冒烟（无 JWT）
| 端点 | 期望 | 实测 |
|------|------|------|
| `POST /api/settings/telegram/test` | 401 | 401 |
| `GET /api/settings/telegram/chats` | 401 | 401 |
## 功能变更（需浏览器终验）
1. **保存 Telegram 配置** — Telegram 卡片内独立按钮
2. **检测 Chat ID** — 先 persist Token，getUpdates 前清除 Webhook
3. **发送测试消息** — 先 persist Token + Chat ID，失败时显示 Telegram API 具体错误
4. **8 项告警开关** — CPU/内存/磁盘/恢复/时钟/Redis/MySQL/重启
5. **查看 Bot Token / API Key** — 免二次密码（JWT + 审计）
## 用户终验步骤
1. 打开 https://api.synaglobal.vip/app/#/settings ，**Ctrl+Shift+R** 强制刷新
2. 填写 Bot Token → 向 Bot 发消息 → **检测 Chat ID** → 选择对话
3. **发送测试消息** → 应收 Nexus 测试推送
4. 切换任意告警开关 → 刷新页面确认状态保持
## 已知限制
- **Layer-3 cron**（`health_monitor.sh`）仍读 `NEXUS_TELEGRAM_*`（`.env.prod`），与 UI 保存的 MySQL 配置独立；应用内告警走 MySQL 热更新即可。
- 生产 DB 若尚未配置 Telegram，测试发送会提示「未配置」直至用户在设置页完成配置。
## 本地测试
```bash
.venv/bin/pytest tests/test_settings_telegram.py -q # 6 passed
bash scripts/local_verify.sh
```
docs/reports/2026-06-08-agent-401-stop-deploy-verification.md
+33
View File
@@ -0,0 +1,33 @@
# 2026-06-08 Agent 401 停心跳 — 部署验证
## 部署信息
| 项 | 值 |
|----|-----|
| Commit | `972456a` feat(agent): 401 停心跳、配置重载后重启与升级双文件下发 |
| 门控 | 7/7 PASS |
| 方式 | `deploy/deploy-production.sh` |
## 生产检查
| 检查 | 结果 |
|------|------|
| `GET /health` | `ok` |
| `GET /app/` | HTTP 200 |
| `GET /agent/heartbeat_policy.py` | HTTP 200，含 `heartbeat_should_stop` |
| `GET /agent/agent.py` | 含 `heartbeat_policy` import、`AGENT_VERSION` |
## 子机 rollout（#7 · 用户/运维）
中心已提供新文件；**各子机须批量「升级 Agent」** 才会下载 `agent.py` + `heartbeat_policy.py`。
验收步骤（抽 1 台）：
1. `journalctl -u nexus-agent -f` 观察心跳
2. 临时改错 `config.json` 中 central api_key → 应出现 **一条** 401 error 后不再重复
3. 通过管理端修正 key 或 `/config/reload` → 心跳应恢复
## 回滚
MySQL: `/var/backups/nexus/nexus-before-upgrade-20260608-150632.sql.gz`
镜像: `nexus-prod-nexus:rollback`
docs/reports/2026-06-08-beijing-time-recovery-deploy-verification.md
+40
View File
@@ -0,0 +1,40 @@
# 部署验证 — 北京时间统一 + 恢复 Telegram 去重（2026-06-08）
## 部署信息
| 项 | 值 |
|----|-----|
| Commit | `abeab9d` |
| 消息 | Fix recovery Telegram dedup and unify Beijing time display |
| 路径 | `/opt/nexus` Docker |
| 时间 | 2026-06-08 |
## 门控
`pre_deploy_check.sh` — **7/7 PASS**
## 健康检查
| 检查 | 结果 |
|------|------|
| `https://api.synaglobal.vip/health` | `ok` |
| `https://api.synaglobal.vip/app/` | HTTP 200 |
| 远程 `127.0.0.1:8600/health` | ok |
| MySQL 升级前备份 | `nexus-before-upgrade-20260608-151933.sql.gz` |
## 生产代码抽检
- `format_beijing_now()` 输出含「北京时间」
- `_detect_recovery` 对 legacy `mem:90` + `mem:92` 仅返回 `[('mem', 50.0)]`
## 用户终验建议
1. **审计页** `#/audit` — 「时间」列应为北京时间（非 UTC 裸字符串）
2. **告警历史** `#/alerts` — 同上
3. 子机内存超阈值后回落 — Telegram **每条指标仅 1 条**恢复消息，时间为北京时间
## 进度
```
☑实现 ☑本地验证 ☑审计8步 ☑部署 ☑健康检查 □浏览器验证（待用户终验） ☑changelog
```
docs/reports/2026-06-08-full-align-deploy-verification.md
+52
View File
@@ -0,0 +1,52 @@
# 2026-06-08 全量对齐部署验证
## 部署信息
| 项 | 值 |
|----|-----|
| Commit | `69068e2` feat(ops): server_batch 回收、sync_logs 清理与 Agent 安装跳过 |
| 前序 | `a401ea5`（Settings 422、server_ids 2000） |
| 方式 | `deploy/deploy-production.sh` → Docker `nexus-1panel.sh upgrade` |
| 时间 | 2026-06-08 |
## 门控
```
pre_deploy_check.sh → 7/7 PASS
pytest test_agent_version + test_server_batch_reconcile + test_sync_log_purge → 16 passed
local_verify → 26/26
```
## 生产健康
| 检查 | 结果 |
|------|------|
| `GET https://api.synaglobal.vip/health` | `ok` |
| `GET https://api.synaglobal.vip/app/` | HTTP 200 |
| 容器 `recover_orphaned` in main.py | 2 |
| 容器 `sync_log_purge` in main.py | 5 |
| 容器 `agent_install_skip_result` | 2 |
| `server/utils/agent_version.py` | 存在 |
## 前端 bundle
| 位置 | index hash |
|------|------------|
| 生产 `/app/index.html` | `index-E6hwgODJ.js` |
| Docker 构建 | frontend 层 CACHE（源码未变，与上次镜像一致） |
说明：本次 commit 仅后端；Settings/调度等前端已在 `a401ea5` 源码中，当前 bundle 与升级前相同属预期。若需强制刷新 bundle，需 `docker build --no-cache` 或改动 `frontend/` 触发重建。
## 功能验收（Agent 终验）
- [ ] 批量安装 Agent：已装 2.0.0 子机应显示「已跳过」
- [ ] API 重启后 running 批量任务应收尾（僵尸 #20 类）
- [ ] 强刷浏览器后 Settings 保存无 422
## 回滚
```bash
ssh nexus 'sudo docker tag nexus-prod-nexus:rollback nexus-prod-nexus:latest && cd /opt/nexus && sudo nx update'
```
MySQL 备份：`/var/backups/nexus/nexus-before-upgrade-20260608-072350.sql.gz`
docs/reports/2026-06-08-login-gate-seamless-nav-verification.md
+48
View File
@@ -0,0 +1,48 @@
# 2026-06-08 登录 IP 门禁 + SPA 无感切换 — 验证报告
## 自动化验证（Agent）
| 检查 | 结果 | 证据 |
|------|------|------|
| `pytest tests/test_login_access.py` | PASS | 7/7 |
| `bash scripts/local_verify.sh` | PASS | smoke + test_api 26/26 + ruff |
| `cd frontend && npm run build` | PASS | vue-tsc + vite |
| `bash deploy/pre_deploy_check.sh` | PASS | 7/7 gates |
## 功能点核对
| ID | 验收项 | 本地 | 生产 |
|----|--------|------|------|
| P0-1 | 白名单开启 + 非名单 IP → 无登录表单 | 代码 + 单测 | API 可访问 |
| P0-2 | 白名单 IP / 白名单关闭 → 正常表单 | 单测 | 待浏览器 |
| P1-1 | 登录成功 `router.replace` | 代码审查 | 待浏览器 |
| P2-1 | 侧栏切页 keep-alive 命中 | 代码审查 | 待浏览器 |
| P2-2 | 再激活 silent 刷新 | 代码审查 | 待浏览器 |
| P3-1 | Dashboard/Servers stats 共享缓存 key | 代码审查 | — |
| P4-1 | 侧栏 hover 200ms 预取 chunk | 代码审查 | Network 面板 |
| P4-2 | Dashboard/Servers 首次 loading 骨架屏 | 代码审查 | 待浏览器 |
## 生产部署
| 项 | 值 |
|----|-----|
| 方式 | tar + scp 同步代码（Gitea 500 绕过）+ `docker compose build nexus` |
| 时间 | 2026-06-08 |
| 远程健康 | `/health` → ok · `/app/` → 200 |
| 外网 | `https://api.synaglobal.vip/health` → ok |
## 用户终验清单
1. **非白名单 IP**（或临时关闭本机 IP）：打开 `/app/#/login` — 仅提示卡 + 客户端 IP，无用户名/密码/TOTP/登录按钮。
2. **白名单 IP 登录**：正常表单 → 登录成功跳转仪表盘，无明显白屏。
3. **侧栏往返**：Dashboard → Servers → Scripts → Push → Files → Dashboard，观察 DOM 保留与无全屏 blocking overlay。
4. **ScriptRuns 详情**：从脚本页进入执行详情，返回列表再进另一详情，数据正确切换。
## 回滚
```bash
git revert <commit>
bash deploy/deploy-production.sh
```
P0 单独 revert 不影响已登录 JWT 会话。
docs/reports/2026-06-08-notify-recovery-deploy-verification.md
+22
View File
@@ -0,0 +1,22 @@
# 部署验证 — 资源恢复开关联动 + 仪表盘去列表
**Commit**: fe8b24c
**日期**: 2026-06-08
## 本地
| 项 | 结果 |
|----|------|
| pytest tests/test_notify_toggle_sync.py | 34 passed |
| frontend npm run build | PASS |
| pre_deploy_check | 7/7（审计补全后） |
## 生产（部署后填写）
| 项 | 结果 |
|----|------|
| GET https://api.synaglobal.vip/health | ok |
| GET /app/ | HTTP 200 |
| 生产 commit | cb49fd9 |
| 仪表盘无服务器列表 | 待浏览器终验 |
| Settings 关 CPU → 无恢复 Telegram | 待浏览器终验 |
docs/reports/2026-06-08-notify-toggle-inline-detail-deploy-verification.md
+30
View File
@@ -0,0 +1,30 @@
# 2026-06-08 — notify 开关 + 行内详情 部署验收
## 版本
- **Commit**: `27da842`
- **生产**: Docker @ `/opt/nexus`
- **时间**: 2026-06-08
## 门控
- pre_deploy_check: **7/7 PASS**
- pytest `test_notify_toggle_sync.py`: **25 passed**
## 健康检查
| 项 | 结果 |
|----|------|
| `https://api.synaglobal.vip/health` | ok |
| `https://api.synaglobal.vip/app/` | 200 |
| 容器 | `nexus-prod-nexus-1` healthy |
## 变更摘要
1. **Telegram 告警开关** — Redis `nexus:settings` 跨 worker 同步；关闭 CPU/内存/磁盘等 notify_* 后不再发 Telegram（WebSocket/日志仍记录）。
2. **服务器行内详情** — 点击名称展开 `ServerInlineDetail`（expanded id 与 `item-value` 数字一致）。
## 浏览器终验（用户）
- [ ] 服务器页 → 点击名称 → 展开 CPU/内存/同步日志
- [ ] 设置页 → 关闭「CPU 超阈值告警」→ 确认不再收到 Telegram（WebSocket 告警仍可有）
docs/reports/2026-06-08-playwright-e2e-full-run.md
+53
View File
@@ -0,0 +1,53 @@
# Playwright 全量 E2E — 本地验证报告
**日期**: 2026-06-08
**环境**: `http://127.0.0.1:8600` · admin + `NEXUS_E2E_PASSWORD` · Chromium headless
## 结果（最终）
```bash
cd frontend && npx playwright install chromium # 首次
NEXUS_E2E_BASE=http://127.0.0.1:8600 \
NEXUS_E2E_USER=admin \
NEXUS_E2E_PASSWORD=*** \
npm run test:e2e
```
| 指标 | 值 |
|------|-----|
| 合计 | **35** |
| 通过 | **35** |
| 失败 | 0 |
| 跳过 | 0 |
| 耗时 | ~35s |
### 复验（清理后 · 2026-06-08）
| 套件 | 结果 |
|------|------|
| `pytest tests/integration tests/chain` | **27 passed** |
| `pytest tests/ -m "not chain and not slow"` | **427 passed** |
| `pytest tests/ -m slow` | **1 passed**（IT-INST-001） |
| `scripts/local_integration_smoke.sh` | **OK** |
| `npm run test:e2e` | **35 passed** (~35s) |
前置：`bash scripts/start-dev.sh`（API :8600 healthy）
## 根因与修复（本轮）
| 问题 | 处理 |
|------|------|
| 并行 UI 登录触发 admin 锁定（429） | `e2e/fixtures.mjs`：每 worker 一次 API 登录 + 轮换后更新 `storageState` |
| `page.goto(#/route)` 在 keep-alive SPA 下偶发停在 `#/` | `helpers.nav` 改为侧栏链接点击；设置页点抽屉「设置」 |
| 凭据入口改为服务器页对话框 | `credentials` / acceptance #08 点「凭据」按钮，不再依赖 `?credentials=1` |
| `getByText('命令日志')` strict 双匹配 | 限定 `main .v-card-title` |
| `web/app` 构建滞后（旧 bundle 含「导出CSV」） | `npx vite build` 同步源码与静态资源 |
## Spec 目录（19 文件）
- `full-acceptance.spec.mjs`（15 步 serial）
- `pages/*.spec.mjs`（18 页域用例 + install/login/auth 无会话）
## 结论
**Wave 1–5 测试矩阵对应的 Playwright 全量 35/35 green**，可与 `tests/integration` + `tests/chain`（27 passed）一并作为 L4 证据。
docs/reports/2026-06-08-push-validation-deploy-verification.md
+13
View File
@@ -0,0 +1,13 @@
# 部署验证 — 推送后台化 + 422 中文化 + 隐藏 CSV（2026-06-08）
| 项 | 值 |
|----|-----|
| Commit | `091fb97` |
| 健康 | `https://api.synaglobal.vip/health` → ok |
| SPA | `/app/` → 200 |
## 终验要点
1. **推送页** — 点「推送」后按钮仅短暂 loading，出现「推送已提交」toast，下方进度列表继续更新
2. **服务器页** — 工具栏无「导出 CSV」
3. **422 提示** — 若参数超限，应显示「每页条数：不能大于 200」而非 `query.per_page`
docs/reports/2026-06-08-schedule-cycle-day-label-deploy-verification.md
+22
View File
@@ -0,0 +1,22 @@
# 2026-06-08 — 调度「当天」单次 UI 部署验证
## 部署
| 项 | 值 |
|----|-----|
| Commit | `22d5d21` |
| 门控 | 7/7 PASS |
| 容器 | `nexus-prod-nexus-1` healthy |
| /health | ok |
| /app/ | 200 |
## 前端产物
- `SchedulesPage-eYsxbL9M.js`（镜像内 vite build）
- 含「当天」标签，单次模式无「重复方式」下拉
## 浏览器终验
1. 打开 https://api.synaglobal.vip/app/#/schedules
2. 新建/编辑调度 → 单次：应见「当天」+ 时/分，无「重复方式」
3. 切换循环：应见窄「重复方式」下拉，首项为「当天」
docs/reports/2026-06-08-schedule-cycle-picker-deploy-verification.md
+36
View File
@@ -0,0 +1,36 @@
# 调度执行周期 — 生产部署验证（2026-06-08）
## 部署方式
热更新 `nexus-prod-nexus-1`：`tar` → `scp` → `sudo docker cp /app/web/app/`（未重启容器，静态资源即时生效）。
## 部署内容
- `ScheduleCyclePicker` — 执行周期可视化（每天/每N天/每小时/每N小时/每N分钟/每N秒/每周/每月）
- `SchedulesPage` — 列表显示中文周期标签；一次性改为「指定日期（一次）」
## 验证结果
| 项 | 结果 |
|----|------|
| `GET https://api.synaglobal.vip/health` | `ok` |
| `index.html` bundle | `index-DIPA1Yxp.js` |
| 容器内 `SchedulesPage-*.js` 含「执行周期」 | `SchedulesPage-GgD_IRtf.js` ✓ |
## 用户终验
1. **Ctrl+Shift+R** 强刷
2. 打开 **推送调度** → **新建调度**
3. 选「循环执行」→ 应出现 **执行周期** 下拉（非 Cron 文本框）
4. 选「每天」+ 时/分 → 保存 → 列表显示「每天 HH:MM」
5. 选「指定日期（一次）」→ 出现 datetime 选择器
## 回滚
```bash
ssh nexus 'sudo nx update' # 从 git 重建镜像
```
## 审计
`docs/audit/2026-06-08-schedule-cycle-picker.md`
docs/reports/2026-06-08-schedule-form-deploy-verification.md
+24
View File
@@ -0,0 +1,24 @@
# 调度表单简化 — 生产部署验证（2026-06-08）
## 部署
热更新 `nexus-prod-nexus-1`：`tar` → `scp` → `sudo docker cp`
## 验证
| 项 | 结果 |
|----|------|
| `/health` | ok |
| bundle | `index-CV_jUdVD.js` |
| `SchedulesPage-*.js` 含「开始执行周期」 | `SchedulesPage-BtHEoHD1.js` ✓ |
## 终验（用户）
1. **Ctrl+Shift+R** 强刷
2. 推送调度 → 新建调度
3. 应仅有：**开始执行周期**、源路径/脚本、服务器；**无**同步模式、目标路径、超时
4. 蓝色提示：「此处仅配置开始执行周期…」
## Changelog
`docs/changelog/2026-06-08-schedule-form-start-cycle-only.md`
docs/reports/2026-06-08-schedule-form-frontend-deploy-verification.md
+27
View File
@@ -0,0 +1,27 @@
# 调度表单前端 — 生产部署验证（2026-06-08）
## 部署方式
`deploy-frontend.sh` 误判 runtime 为 supervisor（路径不存在）→ 改用手动：
1. 本地 `vite build`
2. `tar` → `scp` → `/tmp/nexus-frontend.tar.gz`
3. `sudo docker cp` → `nexus-prod-nexus-1:/app/web/app/`
## 验证
| 项 | 结果 |
|----|------|
| `/health` | ok |
| 对外 `index.html` | `index-D4oqMAQw.js` |
| 容器内 `SchedulesPage` | `SchedulesPage-BzdaRRgz.js` |
| 开始执行周期 | YES |
| 单次执行 | YES |
| 重复方式（周期时间合并） | YES |
| 按分类选择 | YES |
## 终验（用户）
1. **Ctrl+Shift+R** 强刷 `https://api.synaglobal.vip/app/#/schedules`
2. 新建调度 → 确认：周期+时间同一行、按分类选服务器、推送源上传/验证
3. 保存应成功；失败时对话框内红色提示
docs/reports/2026-06-08-script-exec-deploy-verification.md
+55
View File
@@ -0,0 +1,55 @@
# 脚本执行全局进度 / 看板 — 生产部署验证（2026-06-08）
## 部署信息
| 项 | 值 |
|----|-----|
| 时间 | 2026-06-08 |
| 远程路径 | `/opt/nexus` |
| 运行时 | Docker (`nexus-prod-nexus-1`) |
| Git | `9723e0f` docs(audit): Gate 7 diff 修复门控审计 |
| 主功能 commit | `0b2d7ac` feat(scripts): 异步执行、全局进度看板与完成提示音设置 |
| 门控 | 7/7 PASS（含 Gate 7 `HEAD~1..HEAD` 修复 `118ec9f`） |
## 部署命令
```bash
bash deploy/pre_deploy_check.sh # 7/7
NEXUS_DEPLOY_PATH=/opt/nexus bash deploy/deploy-production.sh
```
Docker 镜像内 `npx vite build` 产出新前端；MySQL 备份 `nexus-before-upgrade-20260607-231023.sql.gz`。
## 健康检查
| 检查 | 结果 |
|------|------|
| `https://api.synaglobal.vip/health` | `ok` |
| `https://api.synaglobal.vip/app/` | HTTP 200 |
| 容器健康 | `healthy`（升级脚本输出） |
## 前端 bundle
| 项 | 部署前（本地对比） | 部署后（生产） |
|----|-------------------|----------------|
| 主 bundle | `index-DrEzm1Um.js`（旧） | **`index-BtKAq2zk.js`** |
| 看板 chunk | — | `ScriptRunsPage-DQFXQGdy.js` HTTP 200 |
## 功能验收（Agent 侧）
- [x] 生产拉取 `9723e0f`，镜像重建成功
- [x] `/health`、静态 `/app/` 可达
- [x] 新 Vite hash 与镜像 build 日志一致
- [x] `ScriptRunsPage` 静态资源可下载
## 用户终验建议
1. 登录 `https://api.synaglobal.vip/app/#/login`
2. 侧栏确认 **脚本看板**（`#/script-runs`）
3. **设置 → 界面提示**：`script_exec_complete_sound` 试听（off / beep_short / beep_double / chime_soft）
4. 脚本库批量执行：顶栏应出现全局进度条；完成后 Alert + 可选提示音
5. Telegram（若已配置 `NOTIFY_SCRIPT_COMPLETE`）：仅收到汇总与看板深链
## 备注
- Gate 7 曾误用工作区 `git diff HEAD~1`；已在 `deploy/pre_deploy_check.sh` 修正为 `HEAD~1..HEAD` 并跳过 `gate_log.jsonl`。
docs/reports/2026-06-08-script-exec-local-verify.md
+54
View File
@@ -0,0 +1,54 @@
# 脚本执行看板 — 本地验证报告（2026-06-08）
## 环境
- 主机：`127.0.0.1:8600`（`bash scripts/start-dev.sh`）
- MySQL / Redis：Docker `nexus-mysql-1` / `nexus-redis-1`
- 凭据：`.env` 中 `NEXUS_TEST_ADMIN_*` 已与本地 `admins` 表对齐（用户提供的本地密码）
## 结果摘要
| 检查项 | 结果 |
|--------|------|
| `bash scripts/local_verify.sh`（完整） | **通过** |
| smoke：MySQL schema + 47 unit tests | 通过 |
| `tests/test_api.py` | **26/26** |
| ruff F | 通过 |
| 脚本相关 pytest（15 条） | 通过 |
## local_verify 明细
```
═══ All local checks passed ═══
```
- `GET /health` → 200
- `POST /api/auth/login` → 200（JWT 获取成功）
- Scripts CRUD：`POST/GET/DELETE /api/scripts/` 均通过
- 其余 Server / Schedules / Settings / Audit / Retries / Sync 端点均通过
## 脚本专项 pytest
```bash
.venv/bin/pytest tests/test_script_execution_progress_stats.py \
tests/test_script_execution_progress.py \
tests/test_exec_detail_grouping.py \
tests/test_script_dispatch.py -q
# 15 passed
```
## 异步执行（设计验收）
`test_api` 已覆盖 Scripts 创建/列表/删除；结合 P0 实现，`POST /api/scripts/exec` 在代码审查路径上为「创建记录后立即返回 `running` + 后台 `asyncio` 任务」。
**建议终验（浏览器，需用户）：**
1. 脚本库选多台子机执行 → 1s 内关对话框，顶栏进度条更新
2. `#/script-runs/{id}` 查看失败明细与分组
3. 完成时 Alert + 提示音；Telegram 仅汇总（若已配置 bot）
## 未在本报告执行的项
- 生产 `deploy/pre_deploy_check.sh` + 部署
- 366 台规模压测
- Playwright 浏览器自动化
docs/reports/2026-06-08-script-ui-toast-deploy-verification.md
+30
View File
@@ -0,0 +1,30 @@
# 脚本 UI / 名称 / 顶栏提示 — 生产部署验证（2026-06-08）
## 部署信息
| 项 | 值 |
|----|-----|
| Git | `b12fb47`（功能 `06af90d` feat scripts UI） |
| 门控 | 7/7 PASS |
| 路径 | `/opt/nexus` Docker |
## 健康检查
| 检查 | 结果 |
|------|------|
| `/health` | ok |
| `/app/` | HTTP 200 |
## 本批功能（请浏览器终验）
1. `#/script-runs/{id}` 失败列表显示真实服务器名（非 `服务器 #219`）
2. 脚本提交 / 执行结束提示在顶栏下方正中，3 秒或点击消失
3. 推送校验类 Snackbar 顶栏正中
4. Telegram 脚本完成仅台数汇总
## 命令
```bash
bash deploy/pre_deploy_check.sh
NEXUS_DEPLOY_PATH=/opt/nexus bash deploy/deploy-production.sh
```
docs/reports/2026-06-08-select-all-failure-groups-verification.md
+24
View File
@@ -0,0 +1,24 @@
# 2026-06-08 全选筛选 + 脚本失败分组 — 本地验证
## 自动化
| 检查 | 结果 |
|------|------|
| `pytest tests/test_exec_detail_grouping.py` | 3 passed |
| `pytest tests/test_script_execution_progress.py` | 7 passed |
| `cd frontend && npx vite build` | PASS |
| Git push | `3f995a7` → Gitea main |
| 生产部署 | 2026-06-08 Docker upgrade @ `/opt/nexus` · `/health` ok · `/app/` 200 |
## 浏览器终验（生产）
### `#/servers`
- [ ] 分类 Chip →「全选筛选结果 (N)」→ N 与 Chip 一致
- [ ] 批量改分类生效
- [ ] 改搜索/排序后选择清空
- [ ] 分类视图「全选本组」
### `#/scripts`
- [ ] 失败执行详情 →「按错误分组」
- [ ] 同类 SSH 超时合并为一组
- [ ]「复制失败清单」「复制分组摘要」
docs/reports/2026-06-08-servers-category-deploy-verification.md
+41
View File
@@ -0,0 +1,41 @@
# 2026-06-08 服务器分类/分页/排序 — 生产部署验证
## 部署信息
| 项 | 值 |
|----|-----|
| 提交 | `c435413` |
| 时间 | 2026-06-08 |
| 方式 | Docker `nexus-1panel.sh upgrade` |
| 备份 | `/var/backups/nexus/nexus-before-upgrade-20260607-203049.sql.gz` |
## 自动化验证（Agent）
| 检查 | 结果 |
|------|------|
| 门控 7/7 | PASS |
| 远程 `/health` | `ok` |
| 远程 `/app/` | HTTP 200 |
| 外网 `https://api.synaglobal.vip/health` | HTTP 200 |
| Ops cron | 已安装 health_monitor + db_backup |
## 用户终验清单
请在浏览器登录 `https://api.synaglobal.vip/app/#/servers`：
1. 分类 Chip 筛选各分类数量正确
2. 「列表 / 分类」视图切换正常
3. 勾选多台 →「修改分类」批量生效
4. 表头排序（域名、Agent 版本、最后心跳等）箭头可切换升/降序
5. 分页选「全部」可加载全量（300+ 台）
6. 分页文案为中文（每页数目、上一页、下一页）
`#/scripts`：
7. 执行脚本对话框与「临时命令」可按分类勾选服务器
## 回滚
```bash
ssh nexus 'cd /opt/nexus && sudo docker tag nexus-prod-nexus:rollback nexus-prod-nexus:latest && sudo docker compose -f docker/docker-compose.prod.yml up -d --force-recreate'
```
docs/reports/2026-06-08-servers-live-sort-verification.md
+23
View File
@@ -0,0 +1,23 @@
# 验证 — 服务器列表实时字段排序（2026-06-08）
## 部署
- Commit: `b8425cc`
- 生产: `https://api.synaglobal.vip/app/#/servers`
## 自动化
| 检查 | 结果 |
|------|------|
| `pytest tests/test_server_list_sort.py` | 6 passed |
| `bash scripts/local_verify.sh` | 26/26 |
| 门控 | 7/7 |
| `/health` | 200 |
| `/app/` | 200 |
## 手动终验（用户）
1. `#/servers` 列表视图 · 点「心跳」列头降序 → 最近心跳在前
2. 点「状态」列头 → online / offline / unknown 有序
3. 点「Agent」列头 → 版本字符串有序，无版本在后
4. 分类视图 · 排序后组内顺序与列表一致
docs/reports/2026-06-08-servers-unset-path-verification.md
+39
View File
@@ -0,0 +1,39 @@
# 验证 — 服务器未设路径区块 + 行内详情（2026-06-08）
## 自动化
| 检查 | 结果 |
|------|------|
| `pytest tests/test_server_target_path_filter.py -q` | 12 passed |
| `bash scripts/local_verify.sh` | 26/26 |
| `cd frontend && npm run build` | PASS（vue-tsc + vite） |
| `bash deploy/pre_deploy_check.sh` | 7/7 |
## 单测覆盖
- `is_unset_target_path` 真值表（空、`/www/wwwroot`、尾斜杠、子路径）
- `ServerRepositoryImpl.get_paginated` unset true/false + search 组合
- `GET /api/servers/?target_path_unset=` true / false / 默认三态
## 布局与交互（本地 build 代码审查）
| 场景 | 预期 | 结论 |
|------|------|------|
| 主表列表 | 不含 target_path 为空或 `/www/wwwroot` 的机器 | PASS（显式 `target_path_unset=false`） |
| 未设路径卡片 | 位于连接失败列表上方，独立分页 | PASS |
| 名称点击 | 主表 / 未设路径表各展开一行紧凑详情 | PASS |
| 底部详情卡 | 已删除 `detailServer` 大块 UI | PASS |
| 保存真实路径 | 从未设路径表消失 → 主表出现 | PASS（双表 refresh + `clearExpandedForPathMigration`） |
| 保存 `/www/wwwroot` | 从主表 → 未设路径表 | PASS |
| 分页/搜索/分类/排序 | 双表 reload + 展开态 reset | PASS |
| 30s 静默刷新 | `refreshServersSilent` 含 `loadUnsetPathServers` | PASS |
| API 未传参 | Dashboard / Terminal 仍返回全部 | PASS（默认 None 不过滤） |
## 手动终验（用户）
1. `#/servers` · 确认三区：主列表 → 未设置路径服务器 → 连接失败列表
2. 主表点击服务器名称 · 行内展开 CPU/内存/磁盘/Agent/路径/同步日志
3. 未设路径表点击名称 · 同样行内展开
4. 编辑目标路径为真实目录 · 机器从未设路径表移至主表
5. 编辑目标路径为 `/www/wwwroot` · 机器从主表移至未设路径表
6. `#/terminal` · 仍可连接未设路径机器（列表未过滤）
docs/reports/2026-06-08-test-cases-wave5-verification.md
+29
View File
@@ -0,0 +1,29 @@
# Wave 5 测试缺口补齐 — 验证报告
**日期**: 2026-06-08
**范围**: CH-BAT-001、IT-FILE/INST/SRV-003、MCP→E2E 沉淀 7 页
## 本地 pytest
| 命令 | 结果 |
|------|------|
| `pytest tests/integration tests/chain -q` | **26 passed** |
| `pytest tests/ -m "not chain and not slow" -q` | **427 passed**, 9 deselected |
## 新增用例 ID
| ID | 实现 |
|----|------|
| CH-BAT-001 | `tests/chain/test_batch_job_flow.py` |
| IT-FILE-001 | `tests/integration/test_files_browse.py` |
| IT-INST-001 | `tests/integration/test_install_mode.py`（slow） |
| IT-SRV-003 | `tests/integration/test_notify_settings.py` |
| E2E-TERM/FILE/SCR/CRED/RET/SET/EXEC-002 | `frontend/e2e/pages/*.spec.mjs` |
## E2E
未在本机跑 Playwright（需 `NEXUS_E2E_PASSWORD` + API :8600）。CI main job 在配置密钥后可跑全量 `e2e/`。
## 结论
后端缺口用例已落地并通过本地验证；矩阵已更新。安装向导 E2E 与 CH-EXEC 轮询终态仍标待写。
docs/reports/2026-06-08-unified-execution-records-deploy-verification.md
+40
View File
@@ -0,0 +1,40 @@
# 执行记录 + 服务器批量任务 — 生产部署验证（2026-06-08）
## 部署方式
热更新 `nexus-prod-nexus-1`：`docker cp` + `docker restart`（未走 `nx update` 镜像重建）。
## 部署内容
- 统一执行记录 API `/api/execution-records`
- 服务器批量任务 MySQL 持久化 `server_batch_jobs`
- 安装 Agent 自动生成 API Key
- 批量安装/升级/卸载后台任务
- 前端：侧栏「执行记录」、`#/executions`、审计「查看结果」跳转
## 验证结果
| 项 | 结果 |
|----|------|
| `GET https://api.synaglobal.vip/health` | `ok` |
| `index.html` bundle | `index-Bp2rGxzW.js` |
| 容器内 `execution_records.py` | 存在 |
| 容器内 `execution_record_service.py` | 存在 |
| 容器内 `server_batch_job_repo.py` | 存在 |
| `GET /api/execution-records`（无 token） | 401（端点存在） |
## 用户终验
1. **Ctrl+Shift+R** 强刷
2. 侧栏应显示 **执行记录**（非「脚本看板」）
3. 打开 `#/executions` — 列表含「类型：脚本 / 服务器」
4. 服务器页批量操作（如检测路径）→ 完成后点通知 **查看详情** → 进入统一详情页
5. 审计日志 → 批量操作行 → **查看结果**
## 回滚
```bash
# 生产机
sudo docker restart nexus-prod-nexus-1
# 或 sudo nx update 从 git main 重建镜像（需先 push 代码）
```
docs/reports/2026-06-08-webssh-xterm-ansi-verification.md
+44
View File
@@ -0,0 +1,44 @@
# WebSSH xterm ANSI 彩色输出 — 验证报告
**日期**: 2026-06-08
**变更**: `docs/changelog/2026-06-08-webssh-xterm-ansi-output-fix.md`
## 自动化
| 检查 | 结果 |
|------|------|
| `.venv/bin/python -m pytest tests/test_webssh_terminal_payload.py -q` | 3/3 PASS |
| `bash scripts/local_verify.sh` | 26/26 PASS |
| `cd frontend && npm run build` | PASS |
| `bash deploy/pre_deploy_check.sh` | 7/7 PASS |
## 代码要点
1. **后端** `create_process(env=WEBSSH_PTY_ENV)` — PTY 级 `TERM=xterm-256color`，不再依赖 stdin export 竞态
2. **后端** DATA 帧使用 `data_b64`，保留 ANSI ESC 字节
3. **前端** `decodeTerminalPayload()` → `term.write(Uint8Array)`
4. **样式** Shell 语法高亮 `.sh-*` 仅在 `TerminalCmdBar.vue`，与 xterm 黑屏分离
## 浏览器验收步骤（生产/本地均需 **重连 SSH 会话**）
1. 打开 `#/terminal`，新建或重连一台服务器
2. 在**上方黑屏 xterm**（非底部命令栏）执行：
```bash
printf '\033[31mred \033[32mgreen \033[33myellow \033[0m\n'
```
预期：红 / 绿 / 黄 字
3. 执行 `ls --color=auto` 或 `grep --color=always root /etc/passwd | head`
预期：目录、匹配词分色
4. 在底部命令栏输入 `ls` + Enter
预期：输出出现在黑屏区且带颜色
## 部署
- Commit: `8312a6c` — fix(terminal): WebSSH xterm SSH 交互区 ANSI 彩色输出
- 生产 `/health` → ok，`/app/` → 200
- 后端 WebSocket relay 已随 Docker 重建生效
- **请 Ctrl+Shift+R 强刷并重连 SSH 会话**后再做浏览器终验
## 回滚
恢复 `webssh.py` stdin export + `data` 字段；前端移除 `data_b64` 解码。
docs/reports/2026-06-09-agent-diagnose-server-95.md
+20
View File
@@ -0,0 +1,20 @@
# 生产验证 — 子机 #95 Agent 远程诊断
**时间**: 2026-06-09（UTC 01:20）
**命令**: `docker exec … python3 agent_remote_diagnose.py --id 95`（脚本 commit `fc837bf`）
## 结论
| 项 | 结果 |
|----|------|
| 中心 Redis/MySQL | **online**，最后心跳 `2026-06-09 01:11:19` UTC |
| 子机 systemctl | **active / running**（自 `2026-06-08 16:50:46 CST`） |
| 近期 401/心跳错误日志 | **无匹配行** |
| Agent 版本 | 2.0.0 |
此前约 100 分钟无心跳的断档已结束；当前 Agent 正常上报，无 SSH 连通问题。
## 备注
- 诊断脚本 `central_health` 段读取 `central_url` 字段，子机 `config.json` 使用 `central.url`，故显示 `no_central_url`（不影响中心在线判定）。
- 脚本已 push 至 `origin/main`；生产宿主机 `/opt/nexus` 已 `git reset --hard fc837bf`，容器内需 `docker cp` 或下次镜像重建后内置。
docs/reports/2026-06-09-alerts-schedule-fixes-deploy-verification.md
+39
View File
@@ -0,0 +1,39 @@
# 部署验证 — 告警分页 + 调度单次 fire_at（2026-06-09）
**提交**: `3864d12`（告警每页条数 + `fire_at` datetime 解析）
**生产**: `https://api.synaglobal.vip`
## 公开健康（SSH → `127.0.0.1:8600` / 外网）
| 检查项 | 结果 |
|--------|------|
| `GET /health` | `ok` |
| 外网 `https://api.synaglobal.vip/health` | HTTP 200（经 SSH 侧验证） |
| 容器 `nexus-prod-nexus-1` | Up, healthy（部署后约 2min） |
> 本机直连外网 HTTPS 偶发 `curl: (35) SSL connect error`；以 SSH 隧道结果为准。
## 本地集成
```bash
.venv/bin/pytest tests/integration/test_schedules.py tests/integration/test_alerts_audit.py -q
# 6 passed
```
覆盖：告警 stats/分页契约、once 推送调度 `fire_at` ISO → 201。
## 生产鉴权 API
生产 `.env.prod` **未配置** `NEXUS_TEST_ADMIN_PASSWORD`，`scripts/prod_health_check.sh` 鉴权段自动 SKIP。
**待用户浏览器终验**（需 admin 登录）：
1. **告警中心** → 每页数目切换 10 / 50 / 100，列表条数与请求一致。
2. **调度** → 新建 → 文件推送 → **单次** → 选源/服务器 → 保存 → 应 **201**，无 500。
3. 可选：删除误建测试调度 `e2e-push-cron-test`（若仍存在）。
## 结论
- 代码与本地测试：**通过**
- 生产进程：**健康**
- 鉴权业务路径：**待用户 UI 终验**（Agent 侧无生产测试口令）
docs/reports/2026-06-09-http-detail-zh-deploy-verification.md
+30
View File
@@ -0,0 +1,30 @@
# HTTP API detail 中文化 — 生产部署验证（2026-06-09）
## 部署范围
- `3ba78cd` — `http_errors_zh` 全局层（方案 A：字面量 detail 翻译）
- `a842af2` — auth reason / fallback 中文
- `1c0d7e9` — 服务层 ValueError 源头中文（方案 1）
## 部署记录
- **时间**: 2026-06-09
- **方式**: `NEXUS_DEPLOY_PATH=/opt/nexus bash deploy/deploy-production.sh`
- **远程 commit**: `64c8bd7`（含 `3ba78cd` `a842af2` `1c0d7e9`）
- **门控**: 7/7 PASS
- **升级脚本**: `/health → ok`，`/app/ → 200`，`sync_webapp_to_container` OK
## 验证项
| # | 检查 | 命令/操作 | 期望 | 结果 |
|---|------|-----------|------|------|
| 1 | 健康检查 | 升级脚本 `127.0.0.1:8600/health` | `ok` | **PASS** |
| 2 | SPA | `/app/` HTTP | 200 | **PASS** |
| 3 | 404 字面量翻译 | 登录后访问不存在 server | `服务器不存在` | 待浏览器终验 |
| 4 | 422 Pydantic | 非法 batch_id | 中文字段错误 | 待浏览器终验 |
| 5 | str(exc) | 脚本重试不存在 execution | `执行记录不存在` | 待浏览器终验 |
## 备注
- `/api/agent/*` 仍返回英文（设计如此）
- `f"SSH 连接失败: {e}"` 后缀未做方案 B
docs/reports/2026-06-09-operator-timezone-beijing-audit.md
+47
View File
@@ -0,0 +1,47 @@
# 运维时区全局北京 — 定向审计（2026-06-09）
## 范围
本次 diff 约 8 文件 + 3 文档 + 1 新测。**非**全库 Phase-2 逐行 8 步；按变更面做逻辑/安全/一致性走读。
| 文件 | 行数 | 审计方式 |
|------|------|----------|
| `server/utils/display_time.py` | 65 | 全文 + 单测 |
| `server/background/schedule_runner.py` | 293 | cron/next_run/last_run 路径 |
| `server/infrastructure/database/audit_log_repo.py` | 84 | 筛选逻辑 |
| `server/api/settings.py` | 告警 date 片段 | 与 audit 对齐 |
| `frontend/src/utils/datetime.ts` | beijingWallParts | 与后端对齐 |
| `frontend/src/utils/scheduleCycle.ts` | cronMatch/computeNext | 与 runner 对齐 |
## 规则命中与 Closure
| ID | 规则 | 结论 | 说明 |
|----|------|------|------|
| H1 | PY-11 naive/aware 混用 | SAFE | `last_run_at` 改 `to_naive_utc`；匹配用 `ensure_utc` |
| H2 | 调度双触发 | SAFE | 仍 60s 冷却 + `last_run_at` 防抖 |
| H3 | 日期筛选静默吞错 | RISK-P3 | `ValueError: pass` 沿用旧模式；非法日期不报错 |
| H4 | 存量 cron 语义变更 | RISK-P2 | 无 DB 迁移；用户确认生产几乎无启用调度，部署后人工核对 |
| H5 | 前后端 cron 不一致 | SAFE | 均用北京墙钟；单测锚点 UTC 18:00 = 北京 02:00 |
| H6 | 审计日界 | SAFE | `beijing_day_range_utc`；北京 00:00 = UTC 前日 16:00 |
| H7 | SQL 注入 | SAFE | 日期仅 `fromisoformat` + 固定格式，无拼接 SQL |
| H8 | ruff F401 | FIXED | `settings.py` 告警列表移除未用 `datetime` import |
**命中 8 条，Closure 8 条。**
## 未覆盖 / 建议跟进
1. **无**审计 `date_from` 北京边界的集成测（仅 `test_operator_tz` 单元级）；可补 `test_alerts_audit` 带日期参数。
2. **未**跑 `pre_deploy_check.sh` 全 7 道门控（仅 `local_verify` L2b）。
3. **未**浏览器手工验调度页 `next_run` 列（需登录 SPA）。
## 验证证据
```text
bash scripts/local_verify.sh → All local checks passed
pytest test_operator_tz + schedule_next_run + test_alerts_audit → passed
npm run type-check → passed（前次会话）
```
## 结论
**定向审计通过**，可进入部署前 `pre_deploy_check`；部署后请人工核对调度列表 `next_run`。
docs/reports/2026-06-09-operator-timezone-beijing-verification.md
+60
View File
@@ -0,0 +1,60 @@
# 运维时区全局北京 — 验证报告（2026-06-09）
## 自动化
| 检查 | 结果 |
|------|------|
| `bash scripts/local_verify.sh` | PASS |
| `bash deploy/pre_deploy_check.sh` | **7/7 PASS** |
| `pytest test_operator_tz test_schedule_next_run test_display_time` | PASS |
| `npm run type-check` | PASS |
| `cd frontend && npx vite build` | PASS |
## API 契约（本地 :8600）
创建 cron `0 2 * * *` 推送调度：
- `next_run` = `2026-06-09 18:00:00`（UTC naive）
- 换算北京时间 = **2026-06-10 02:00**（与「每天 02:00 北京」一致）
脚本：Agent 会话内 httpx 一次性创建/断言/删除（未入仓）。
## 浏览器 E2E（Playwright，本地 `http://127.0.0.1:8600`）
```bash
cd frontend && npx playwright test e2e/pages/schedules-cycle.spec.mjs e2e/pages/schedules-timezone.spec.mjs
```
| 用例 | 结果 |
|------|------|
| E2E-SCH-002 新建调度显示「开始执行周期」 | PASS |
| E2E-SCH-003 对话框显示「时间为北京时间（Asia/Shanghai）」 | PASS |
| E2E-SCH-004 `next_run` 列显示 `2026-06-10 02:00:00`（非 UTC 10:00、非裸 ISO Z） | PASS |
新增：`frontend/e2e/pages/schedules-timezone.spec.mjs`
## 生产部署（2026-06-09 · `863e49e` 全量）
| 检查 | 结果 |
|------|------|
| `NEXUS_PROBE_MODE=origin bash scripts/prod_health_check.sh` | **PASS**（含时区扩展项） |
| `/health` | ok |
| `/app/` | HTTP 200 |
| 告警 `date_from=not-a-date` | HTTP **422** |
| 审计 `/api/audit/?date_from=bad` | HTTP **422** |
| cron `0 2 * * *` 创建 | `next_run=2026-06-09 18:00:00`（UTC naive → 北京次日 02:00） |
| `/app/assets/SchedulesPage-*.js` | 含「时间为北京时间」文案（源站静态资源 grep） |
部署命令：`NEXUS_DEPLOY_PATH=/opt/nexus bash deploy/deploy-production.sh`
### 浏览器终验说明
- 生产登录受 IP 白名单约束；本机 Playwright 经隧道登录返回 **403**（预期行为）。
- UI 时区提示与 `next_run` 列展示：本地 E2E（上表）+ 生产 API/静态资源探针已覆盖。
- **用户终验**（可选）：在已白名单 IP 打开 `/app/#/schedules` 核对 Picker 提示与 `next_run` 列。
### 前端 hash 对齐（Wave 0）
- 升级后曾漂移：容器 `index-FhWfGFoM.js` ≠ Git `index-mgwiCK5j.js`。
- **已修复**：`NEXUS_ROOT=/opt/nexus bash deploy/sync_webapp_to_container.sh` → 入口 `index-mgwiCK5j.js` HTTP 200。
- 后续 `nexus-1panel.sh upgrade` / `deploy-production.sh` 将自动执行 sync。
docs/reports/2026-06-09-push-category-full-list-deploy-verification.md
+47
View File
@@ -0,0 +1,47 @@
# 2026-06-09 — 推送页分类全量加载 部署验收
## 版本
- **Commit**: `c366ed5`
- **Changelog**: `docs/changelog/2026-06-09-push-category-full-list.md`
- **生产**: Docker `nexus-prod-nexus-1` @ `/opt/nexus`
- **部署方式**: 本地 `vite build` → tar/scp `web/app` → `sync_webapp_to_container.sh`（先于 commit；Git 已对齐）
## 根因（已修复）
| 现象 | 数据 |
|------|------|
| 推送页「机器人」仅 5 台 | DB 该分类 **101** 台 |
| 旧逻辑 | `GET /api/servers/?per_page=200`，按 id 升序取前 200 台 |
| 前 200 台中含「机器人」 | **恰好 5 台**（其余 96 台 id 更大，未进入列表） |
## Agent 验证（2026-06-09）
| 项 | 结果 |
|----|------|
| `/app/` 主 bundle | `index-jg6n1uIt.js` HTTP 200 |
| `PushPage-DukhcoEE.js` | 含 `paginatedFetch`（非 `per_page:200`） |
| MySQL `servers` 总数 | 367 |
| MySQL `category=机器人` | 101 |
| `/health` | 200 |
| `/app/` | 200 |
## 变更摘要
1. **推送页** — `fetchPagePerPage('/servers/', {}, 1, -1)` 分页拉全舰队；分类分组与服务器页 `uncategorized` / `categoryDisplayLabel` 一致。
2. **未设路径区** — `unsetListQueryParams()` 不再带顶部分类 chip；批量改分类后机器仍可见直至配置 `target_path`。
3. **批量分类完成** — `invalidateCachedQuery(serverCategories)` 避免 chip 计数缓存 30s 陈旧。
## 浏览器终验（用户）
- [ ] 推送页 → 「机器人」分组显示 **0/101**（或全选后 101/101）
- [ ] 推送页 → 「商城」等与服务器页分类 chip 数量一致
- [ ] 未设路径区：切换顶部分类 chip 时列表仍显示全部未设路径机器
- [ ] 强刷 `Ctrl+Shift+R` 后入口为 `index-jg6n1uIt.js`
## 回滚
```bash
# 前端：checkout 上一版 web/app 或 c366ed5^ 后重新 tar/sync
# 业务无 DB 迁移
```
docs/reports/2026-06-09-server-list-expand-metrics-deploy-verification.md
+47
View File
@@ -0,0 +1,47 @@
# 部署验证 — 服务器列表展开刷新 + 单机指标历史
**日期**: 2026-06-09
**范围**: `server_metric_samples`、`GET /servers/{id}/metrics`、展开区 `ServerInlineDetail` + `ServerMetricSparklines`
## 本地验证
| 项 | 结果 |
|----|------|
| `pytest tests/test_server_metrics.py` | 7/7 PASS |
| `bash scripts/local_verify.sh` | 26/26 PASS |
| `npm run type-check` | PASS |
| `vite build` | PASS（`ServersPage-rQyapRTV.js`） |
| `bash deploy/pre_deploy_check.sh` | 7/7 PASS |
## 生产部署
命令：`bash deploy/deploy-production.sh`
结果：**Deploy successful**
| 检查项 | 结果 |
|--------|------|
| 容器健康 | `nexus-prod-nexus-1` healthy |
| 内网 `/health` | ok |
| 外网 `https://api.synaglobal.vip/health` | HTTP 200（部署脚本输出） |
| 前端入口 | `index-DUJUpEbL.js` → HTTP 200 |
| 前端 bundle | `ServersPage-rQyapRTV.js` 已同步至容器 |
## 终验（浏览器，运维）
1. 打开 `https://api.synaglobal.vip/app/#/servers`
2. 点击某台服务器 **名称** 展开行
3. Network 应出现：
- `GET /api/servers/{id}`
- `GET /api/servers/{id}/logs?limit=1`
- `GET /api/servers/{id}/metrics?hours=24`
4. 展开区：状态 chip、实时 CPU/内存、24h sparkline（有 Agent 且部署满 ~10min 后有数据）、离线 chip（若曾离线）
5. 折叠再展开 → 上述请求再次发出
## 冷启动说明
`server_metric_samples` 自本次部署后每 10 分钟写入；部署后 10 分钟内展开可能显示「暂无历史数据」，属预期。
## 回滚
- 前端：回滚 `web/app` 至上一版 `ServersPage-*.js`
- 后端：回滚镜像/代码；`server_metric_samples` 表可保留（只读无害）
docs/reports/2026-06-09-server-offline-alert-deploy-verification.md
+40
View File
@@ -0,0 +1,40 @@
# 子机离线告警 — 生产部署验证
**日期**: 2026-06-09
**提交**: `7209f53`
**环境**: `https://api.synaglobal.vip`（Docker `/opt/nexus`）
## 部署步骤
1. `bash deploy/pre_deploy_check.sh` — 7/7 PASS
2. `bash scripts/git-push.sh main` — `283041f..7209f53`
3. `NEXUS_DEPLOY_PATH=/opt/nexus bash deploy/deploy-production.sh`
## 自动验证（deploy 脚本）
| 检查项 | 结果 |
|--------|------|
| Docker upgrade（git reset + 镜像重建） | OK |
| 本地 `vite build` + scp | OK |
| `sync_webapp_to_container.sh` | OK，入口 `index-COeSEm3r.js` HTTP 200 |
| `GET /health`（服务器 localhost:8600） | `ok` |
| `GET /app/` | `200` |
| Ops cron | 已安装 |
## 外网探测
| URL | 结果 |
|-----|------|
| `https://api.synaglobal.vip/health` | `ok` |
## 功能验收（待浏览器终验）
- [ ] 设置 → Telegram 通知 → 出现「子机离线告警」开关
- [ ] 开关默认开启；关闭后模拟离线无 Telegram
- [ ] 子机在线→离线边沿约 30s 内收到 Telegram（Bot 已配置时）
## 回滚
```bash
ssh nexus 'cd /opt/nexus && sudo git reset --hard 283041f && sudo env NEXUS_ROOT=/opt/nexus bash deploy/nexus-1panel.sh upgrade'
```
docs/reports/2026-06-09-terminal-server-list-all-deploy-verification.md
+30
View File
@@ -0,0 +1,30 @@
# 终端全量服务器列表 — 部署验证
**日期**: 2026-06-09
**问题**: 终端页搜索不到「冲量夏序」
**根因**: `loadServers()` 仅请求 `per_page=200` 第一页，舰队 >200 台时靠后机器不在列表
## 变更
- `useTerminalSessions.loadServers` → `fetchPagePerPage('/servers/', {}, 1, -1)` 拉全部分页
- `resolveServerMeta`：深链 `server_id` 时单台兜底
- `TerminalServerPicker` 增加 loading 骨架屏
## 部署
1. 本地 `npx vite build`
2. `tar` 上传 `/opt/nexus/web/app`
3. `deploy/sync_webapp_to_container.sh` → 容器内 `TerminalPage-BFNBo-oz.js`（含 `paginatedFetch`）
## 验证步骤（用户终验）
1. 浏览器 **强刷** `https://api.synaglobal.vip/app/#/terminal`（Ctrl+Shift+R）
2. 等待列表加载完成（舰队大时数秒）
3. 搜索框输入 `冲量` 或 `120.79`
4. 或：服务器页找到该机 → 点「终端」直连
## 进度
```
☑实现 ☑本地 type-check ☑构建 ☑部署(sync) □用户浏览器终验
```
docs/reports/2026-06-10-rdp-black-screen-root-cause.md
+46
View File
@@ -0,0 +1,46 @@
# RDP 浏览器黑屏 / 连接超时 — 根因定位 (2026-06-10)
## 结论（确定）
**Nexus 侧（前端 + 后端 + guacd 链路）全部正常；黑屏来自 RDP 目标主机本身。**
guacd 直连解码证明：RDP 目标 `20.189.75.225`（用户 `azureuserwindwos`）在 NLA 认证成功后，
回传的 **1024×768 主画面 PNG 是纯黑**（`nonblack=0, maxsum=0`），只附带鼠标指针等极小白色缓存图块。
这是 Windows/Azure 典型的「RDP 登录后黑屏（仅有鼠标指针）」现象。
## 证据链
| 检查项 | 方法 | 结果 |
|--------|------|------|
| guacd 握手 | `security=any` / `security=nla` | 均 `ready`（握手成功） |
| **凭据有效性** | `security=nla`（错误凭据必失败） | **握手成功 → 凭据正确**，`azureuserwindwos` 非拼写错误 |
| 帧转发 | WS 长连接探针 100s | `frames=108 sync=5` |
| **ping 回显（防超时）** | 内部空操作码 `0.,4.ping,<ts>` 每秒 | `ping_echo=100, max_gap=1.0s` → 不会触发 90s 超时 |
| **主画面像素** | 直连 guacd 解码 img/blob PNG | `1024x768 nonblack=0 maxsum=0`（纯黑） |
| 小图块 | 同上 | `41x39`/`11x16` 纯白（指针/字形缓存） |
| `resize-method=display-update` | 变体探测等 18s | 仍纯黑，无桌面重绘 |
| 浏览器端 | Playwright 生产 E2E | 到达「已连接」+ 1024×768 画布，但像素全黑 |
## 「连接超时」说明
前端 `tunnelErrorMessage` 中 `server timeout` → 浏览器 90s 内未收到任何帧。
实测 ping 回显使 `max_gap=1.0s`，当前线上 bundle 的 E2E 直接到达「已连接」而非超时。
故该提示是**更早旧缓存版本**的现象；当前版本能连上，仅表现为黑屏。
## 修复方向（在 RDP 目标 Windows VM 上，Nexus 无法代为修改）
按命中概率排序：
1. **关闭 WDDM 远程显示驱动（最常见修复）**
`gpedit.msc` → 计算机配置 → 管理模板 → Windows 组件 → 远程桌面服务 →
远程桌面会话主机 → 远程会话环境 →
**「将 WDDM 图形显示驱动程序用于远程桌面连接」= 已禁用** → 重启。
2. **重启该 VM**（Azure 门户：重启 / 重新部署 redeploy）。
3. 检查是否有残留断开会话占用 console；或登录脚本/应用全屏绘黑。
4. Azure 门户「运行命令」重启 `explorer.exe` 或图形栈。
## 复现 / 诊断脚本
- `scripts/guacd_rdp_probe.py` — 直连 guacd，解码主画面 PNG 判黑屏
- `scripts/guacd_rdp_variant.py` — `VARIANT=nla|resize|plain` 切换参数变体
- `scripts/rdp_ws_sync_check.py` — 经 WS 长连接，统计 ping 回显与帧间隔
docs/reports/2026-06-10-rdp-browser-e2e-verification.md
+33
View File
@@ -0,0 +1,33 @@
# RDP 浏览器 E2E 验收 — 2026-06-10
## 结论
**通过** — 生产环境 Playwright 在约 **7.7s** 内完成 `host_id=1` 连接，出现「已连接」与 1024×768 画布。
## 根因
`useRdpSession.ts` 使用 `Guacamole.Client.STATE_CONNECTED`（运行时 **undefined**），`onstatechange` 从未将 UI 设为 `connected`。
WS 层与 guacd 实际正常（sync 已到达浏览器）。
## 修复
- 改用 `Guacamole.Client.State.CONNECTED` / `Tunnel.State.OPEN`
- `RdpPage`：`mounted` 守卫 + 避免重复 connect
- `useRdpSession`：connect 序号防竞态
## 验证命令
```bash
# 生产 mint JWT 后
NEXUS_E2E_ACCESS_TOKEN=<jwt> npx playwright test e2e/pages/rdp-connect.spec.mjs
```
## 用户终验
1. 强刷 `Ctrl+Shift+R`（入口 bundle：`index-DWNCTCE6.js`）
2. 3389远程 → azurewin11 → 应数秒内显示桌面
## 探针（可选）
- `scripts/guacd_rdp_probe.py` — 直连 guacd，约 11 条指令内收到 sync
- `scripts/rdp_ws_sync_check.py` — 经 WS 第 4 帧收到 `4.sync,...`
docs/reports/2026-06-10-rdp-guacd-handshake-deploy-verification.md
+50
View File
@@ -0,0 +1,50 @@
# 2026-06-10 RDP guacd 握手修复 — 生产验证
## 变更
- 服务端完成 guacd `select` → `connect` → `ready` 握手，再桥接 WebSocket
- 凭据来自 `rdp_hosts` 表，不依赖 URL 中的 password
## 部署
- 主机 `/opt/nexus` 已同步新文件
- `nexus-1panel.sh upgrade --no-backup` 重建镜像 `nexus-prod-nexus`
- `/health` → ok
## 验证（Agent 执行）
### 1. guacd 直连握手（容器内 Python）
```
handshake 20.189.75.225 3389 azureuserwindwos guacd guacd 4822
READY $da3288e0-2943-4186-b542-b00156251633
```
guacd 日志：
```
Creating new client for protocol "rdp"
Connected to RDPDR 1.13 as client 0x0003
```
### 2. WebSocket 隧道
```
FIRST_MSG 0.,37.$f5b63cbd-2af9-4ee4-a714-37a7fbf1df9c;
```
首包为 Guacamole tunnel OPEN（空 opcode + connection id），符合 `guacamole-common-js` 预期。
### 3. 结论
- 原 `Guacamole protocol violation`（透明 TCP 桥接）已消除
- RDP 目标 20.189.75.225:3389 可从 guacd 建立会话
## 待用户终验
浏览器：`https://api.synaglobal.vip/app/#/rdp` → 选择 `azurewin11` → 连接，应出现远程桌面画布。
## 备注
- 代码尚未 `git push`（仅主机热更新 + 镜像重建）；建议后续提交 `protocol.py` / `ws_tunnel.py` / `rdp.py`
- RDP 用户名库中为 `azureuserwindwos`（若 Windows 实际用户不同需在前端编辑）
docs/reports/2026-06-11-unset-target-path-fleet.md
+64
View File
@@ -0,0 +1,64 @@
# 未设路径 Fleet 探测与推送验证 — 2026-06-11
## 部署
- 版本：`e6abd4a`（推送默认 `/www/wwwroot` + sudo rsync）
- 健康：`https://api.synaglobal.vip/health` 200
## 行为确认
| 概念 | 说明 |
|------|------|
| 「未设路径」UI | `target_path` 为空或精确 `/www/wwwroot` |
| 推送目标 | 空时落到 `/www/wwwroot`（宝塔站点根，可传文件） |
| 两者关系 | **独立**：面板仍显示未设路径，推送可用 wwwroot |
## 批量 detect-path（`--unset-only`）
- 匹配：**102 台**
- 成功：**9 台**（写入具体站点目录）
- 失败：**93 台**（多为「未找到 workerman.bat」）
### 探测成功清单
| ID | 名称 | 写入路径 |
|----|------|----------|
| 245 | 武汉市辰风落科技有限公司 | `/www/wwwroot/crmeb` |
| 246 | 子-武汉市辰风落科技有限公司 | `/www/wwwroot/crmeb` |
| 303 | 落风窗（武汉市）科技有限公司 | `/www/wwwroot/shop` |
| 304 | 子-落风窗（武汉市）科技有限公司 | `/www/wwwroot/shop` |
| 305 | 武汉市事野落电子商务有限公司 | `/www/wwwroot/shop` |
| 306 | 子-武汉市事野落电子商务有限公司 | `/www/wwwroot/shop` |
| 315 | 漫窗星(武汉市)电子商务有限公司 | `/www/wwwroot/shop/yaciwangluo.cn` |
| 316 | 子-漫窗星(武汉市)电子商务有限公司 | `/www/wwwroot/shop/yaciwangluo.cn` |
| 371 | 冲量银海-泽初 | `/www/wwwroot/whzecw.com` |
93 台失败需人工确认站点结构（无 workerman.bat 或非宝塔布局）。
## 非 root 推送验证（`verify_push_elevation.py --non-root-only`）
| 指标 | 改 wwwroot 前 | 改 wwwroot 后 |
|------|---------------|---------------|
| 通过 | 24/68 | **67/68** |
| 失败 | 44（dest=/tmp/sync） | 1 |
### 唯一失败
- **#342** 子-武汉市清风无恙电子商务有限公司
- `dest=/www/wwwroot/shop`
- `rsync_sudo=False`（其余检查 write/elevated 通过）
- 建议：对该机重新执行「一键配置 sudo」或 `batch_patch_files_sudoers.sh --ids 342`
### wwwroot 根目录推送
37 台非 root 子机 `dest=/www/wwwroot` 验证通过（sudo rsync + 写入 + dry-run）。
## 命令（生产容器）
```bash
sudo docker cp /opt/nexus/scripts/batch_detect_target_path.py nexus-prod-nexus-1:/app/scripts/
sudo docker exec -w /app nexus-prod-nexus-1 python scripts/batch_detect_target_path.py --unset-only --concurrency 10
sudo docker exec -w /app nexus-prod-nexus-1 python scripts/verify_push_elevation.py --non-root-only --concurrency 10
```
日志：`/tmp/detect-full.txt`、`/tmp/verify-push.txt`（生产主机）
docs/reports/2026-06-11-wenshengye-push-verification.md
+35
View File
@@ -0,0 +1,35 @@
# 温胜夜推送提权 — 生产验证报告
**日期**: 2026-06-11
**部署版本**: `84b388fa` fix(sync): rsync 推送非 root 自动 sudo 提权
## 背景
推送失败：`touch ... m.wenshengye.com ... Permission denied`（SSH 用户 `ubuntu`，非 root）。
## 处理
1. 部署 rsync `--rsync-path=sudo -n rsync`（非 root + 默认 `auto_sudo`）
2. 批量 sudoers 探测：两台 `sudo -n rsync` 已为 `already_ok`
3. 生产探针推送（`scripts/verify_push_elevation.py --name 温胜夜 --push`）
## 结果
| ID | 名称 | SSH | 目标路径 | rsync sudo | 写入(sudo) | dry-run | 实推 |
|----|------|-----|----------|------------|------------|---------|------|
| 313 | 武汉市温胜夜科技有限公司 | ubuntu | `/www/wwwroot/wenshengye.com` | ✓ | ✓ | exit 0 | exit 0, elevated |
| 314 | 子-武汉市温胜夜科技有限公司 | ubuntu | `/www/wwwroot/m.wenshengye.com` | ✓ | ✓ | exit 0 | exit 0, elevated |
**结论**: 2/2 通过。通道已恢复。
## 用户操作
原批次源目录 `/tmp/nexus_upload_dbc7758062ff` 为临时上传目录，可能已被清理，请在推送页**重新上传 ZIP/文件**后再推一次。
## 复验命令（生产容器内）
```bash
cd /opt/nexus
sudo docker cp scripts/verify_push_elevation.py nexus-prod-nexus-1:/app/scripts/
sudo docker exec -w /app nexus-prod-nexus-1 python scripts/verify_push_elevation.py --name 温胜夜 --push
```
docs/reports/2026-06-12-files-remove-download-verification.md
+24
View File
@@ -0,0 +1,24 @@
# 文件管理移除下载 — 生产验证（2026-06-12）
## 变更
- Commit `2b0413c`：前端移除行内/右键「下载」入口；后端 `/sync/download` 保留。
## 验证
| 项 | 结果 |
|----|------|
| 门控 | `pre_deploy_check.sh` 7/7 PASS（含 browser 合并提交后） |
| 部署 | `NEXUS_DEPLOY_PATH=/opt/nexus deploy-production.sh` 成功 |
| `/health` | `ok` |
| 主 bundle | `/app/assets/index-aYJp0WL5.js` HTTP 200 |
| FilesPage 最新 chunk | `FilesPage-BUUVZpbu.js`：`下载` / `mdi-download` 出现次数 **0** |
## 说明
容器内仍保留历史 hash 的 `FilesPage-*.js`（prune 未全删）；当前入口引用的最新 chunk 已无下载文案与图标。
## 用户终验
1. 强刷 `https://api.synaglobal.vip/app/#/files`
2. 确认列表行与右键菜单无「下载」
docs/reports/2026-06-12-remote-browser-bug-patrol.md
+107
View File
@@ -0,0 +1,107 @@
# Bug 巡查 — 远程浏览器
**日期**：2026-06-12
**范围**：`browser-worker/`、桥接 API、前端 canvas 客户端、生产 `66.154.115.131:8443`
**方法**：代码走读 + 单测 + 生产探针复验
**关联**：`docs/audit/2026-06-12-remote-browser-worker.md`、`docs/reports/2026-06-12-remote-browser-patrol.md`
## 发现与处理
| # | 严重度 | 问题 | 根因 | 状态 |
|---|--------|------|------|------|
| 1 | **P0** | 生产无浏览器 UI，用户「连不上」 | 后端 `BROWSER_ENABLED=1`，但 `web/app` **无** `ws/browser` bundle | **已修** — `index-BimRgA6s.js` 已同步，容器 grep `ws/browser` ≥1 |
| 2 | **P1** | Worker `sessions:1` 长期占槽 | `ready=false` 不进 idle 清理 | **已修** — `WORKER_RESERVE_TIMEOUT_SEC=120` + 重建 Worker，`sessions:0` |
| 3 | **P1** | attach 失败留下僵尸 reservation | `RuntimeError` 未 `destroy_session` | **已修** — `main.py` 失败路径销毁 |
| 4 | **P1** | 页内点击/重定向 SSRF | 仅 `NAVIGATE` 校验；`RELOAD`/`GO_BACK`/`页内导航` 无复验 | **未修**（审计 F1） |
| 5 | **P1** | Worker 8443 公网暴露 `/health` | ufw 过宽 | **未修**（审计 F3） |
| 6 | **P2** | 前进/后退与远程历史不同步 | UI `stack` 仅本地维护；`updateActiveFromRemote` **不**更新 stack；canvas 内点击只改 `url` | **未修** |
| 7 | **P2** | `connect()` 失败后无显式 DELETE | 同上 | **已修** — WS/未登录失败时 `DELETE /browser/sessions/{id}` |
| 8 | **P2** | `attach_stream` 并发竞态 | `ready=false` 时锁在 L140 释放，双 WS 可能各建 `BrowserContext` | 低概率（单桥接） |
| 9 | **P2** | `delete_worker_session` 失败静默 | 日志 warning，Worker 会话残留 | **未修**（审计 F4） |
| 10 | P3 | 切标签每次新建 Worker 会话 | `watch(activeTabId)` → `disconnect()` → 新 `POST` | 设计可接受，略耗资源 |
| 11 | P3 | `persistState` catch 空实现 | 离线时本地状态与 MySQL 可能短暂不一致 | 可接受 |
## P0 — 前端未部署（用户可见）
```
生产容器: BROWSER_ENABLED=1
web/app/assets: grep ws/browser → 0 文件
Worker /health: sessions=1, max_sessions=2
```
管理员打开面板**没有任何**地球按钮 / canvas 客户端代码，与「连不上」完全一致。后端与 Worker 已就绪，**阻塞在 SPA 同步**。
## P1 — Worker 僵尸会话（占槽根因）
### 空闲清理漏掉 `ready=false`
```100:103:browser-worker/session_manager.py
stale = [
sid for sid, sess in self._sessions.items()
if sess.ready and now - sess.last_activity > settings.WORKER_IDLE_TIMEOUT_SEC
]
```
`POST /v1/sessions` 只 `reserve_session`；Chromium 在 WS `attach_stream` 后才 `ready=True`。
任一路径「POST 成功但 stream 未建立」都会永久占 `session_count`，直至 `max_sessions` 打满。
典型路径：
- 前端未部署时 API 测试 / 桥接探测只 POST 不挂 WS
- Nexus 桥接连 Worker WS 失败（`WORKER_UNREACHABLE`）
- Worker `attach_stream` 抛 `RuntimeError` 后：
```110:112:browser-worker/main.py
except RuntimeError:
await websocket.close(code=4503, reason="Browser not ready")
return
```
此处 **未** `destroy_session`，reservation 泄漏。
**建议**：idle 对 `not ready` 加 `created_at` 超时（如 120s）；`RuntimeError`/`attach` 失败路径 `destroy_session`；运维可 `docker restart nexus-browser-worker` 清槽。
## P1 — SSRF / 暴露面（审计复查）
与 `docs/audit/2026-06-12-remote-browser-worker.md` 一致，代码层**无新增修复**。
## P2 — 前进/后退逻辑 Bug
`GlobalBrowserPanel.onGoBack`：
```350:353:frontend/src/components/GlobalBrowserPanel.vue
function onGoBack() {
goBack() // 改本地 stack + addressDraft
if (connected.value) remoteGoBack() // Playwright page.go_back()
}
```
- 用户在 canvas 内点击链接 → `PAGE_INFO` → `updateActiveFromRemote` 只更新 `tab.url`，**不 push stack**
- `canGoBack` 仍看本地 stack → 按钮状态错误
- 点后退时本地 stack 与 Chromium 历史**可能指向不同 URL**
**建议**：以远程为准时去掉本地 stack，或 `PAGE_INFO` 时同步 push stack；后退只发 `GO_BACK` 不回写本地 stack 直到 `PAGE_INFO`。
## 本地验证
```text
pytest tests/test_browser_url_safe.py tests/test_browser_ui_state.py → 7 passed
npm run type-check → PASS
curl https://api.synaglobal.vip/health → ok
```
## 建议修复顺序
1. **P0** — `vite build` + `sync_webapp_to_container.sh`（立刻恢复可用性）
2. **P1** — Worker 重启清槽 + 修 reservation 泄漏（idle 未 ready + RuntimeError 清理）
3. **P1** — ufw 收口 8443
4. **P1** — `framenavigated` SSRF
5. **P2** — 历史栈与 `GO_BACK` 统一
## 复巡命令
```bash
ssh nexus 'sudo docker exec nexus-prod-nexus-1 grep -rl ws/browser /app/web/app/assets/ | wc -l'
curl -s http://66.154.115.131:8443/health
pytest tests/test_browser_url_safe.py tests/test_browser_ui_state.py -q
```
docs/reports/2026-06-12-remote-browser-patrol.md
+90
View File
@@ -0,0 +1,90 @@
# 巡查 — 远程浏览器 + 生产基线
**日期**：2026-06-12
**范围**：生产 `api.synaglobal.vip`、Worker `66.154.115.131:8443`、工作区浏览器改动、审计 F1/F3 闭环
**关联审计**：`docs/audit/2026-06-12-remote-browser-worker.md`
## 进度条
| 步骤 | 状态 |
|------|------|
| 生产 `/health` + prod_probe | ✅ 全通过 |
| 浏览器后端配置 | ✅ `BROWSER_ENABLED=1`，Worker URL 已配 |
| 浏览器前端 bundle | ❌ **未部署** |
| Worker 可达 / 暴露面 | ⚠️ 公网可访问 `/health` |
| 审计 P1 闭环 | ❌ F1 SSRF、F3 防火墙未修 |
| 工作区 git | ⚠️ 浏览器源码 largely 未 commit |
| 本地单测 | ✅ browser 7 + watch_pins 9 = 16 passed |
## 生产探针（`scripts/prod_health_check.sh`）
```text
✓ external /health → ok
✓ external /app/ → HTTP 200
✓ login / health/detail / alert-history / schedules / cron / main bundle
=== All production probe checks passed ===
```
容器：`nexus-prod-nexus-1` **Up ~4min (healthy)**（巡查时刚重启不久）。
## 远程浏览器链路
| 检查项 | 结果 | 说明 |
|--------|------|------|
| 主站 `/health` | `ok` | 公网 + 容器内均 OK |
| 容器 `settings.BROWSER_ENABLED` | `1` | Worker URL `http://66.154.115.131:8443` |
| 主站 → Worker `/health` | `ok` | 容器内 curl 成功 |
| 公网 → Worker `/health` | **可达** | `{"status":"ok","sessions":1,"max_sessions":2}` |
| 无 Key `POST /v1/sessions` | `422` | 非 401，但无密钥无法建会话 |
| 生产 `web/app` 含 `GlobalBrowser` / `ws/browser` / screencast | **无** | 146 个 JS，grep 零命中 |
| 侧栏「浏览器」/ 地球按钮 UI | **未上线** | 需 `vite build` + `sync_webapp_to_container.sh` |
**结论**：后端与 Worker **已启用**，但 **SPA 未同步**，管理员面板仍无远程浏览器入口；与「连不上」用户反馈一致（旧 bundle 无 canvas 客户端）。
## 审计项复查（未闭环）
| ID | 审计结论 | 巡查结果 |
|----|----------|----------|
| **F1** | 页内点击/重定向无 SSRF 复验 | **未修** — `session_manager.py` 仅 `NAVIGATE` 调 `validate_navigation_url` |
| **F3** | Worker `ufw` 过宽 | **未确认修** — 公网 curl `/health` 成功，8443 仍暴露；Worker SSH 本机无凭据 |
| F4 | delete 失败静默 | 未改 |
| F5 | 内存 session_registry | 可接受（单进程 Docker） |
Worker 当前 **`sessions:1`**：可能存在陈旧会话占槽（`max_sessions=2`），建议 Worker 侧重启或调 API 清理。
## 工作区状态
浏览器相关文件多为 **未跟踪 / 未提交**（`browser-worker/`、`GlobalBrowserPanel.vue`、`browser_session.py` 等）。生产后端已跑新镜像，但 **前端构建产物未进容器**，形成 **前后端版本错位**。
本地：
```bash
pytest tests/test_browser_url_safe.py tests/test_browser_ui_state.py tests/test_watch_pins.py -q
→ 16 passed
```
## 发现汇总
| # | 严重度 | 问题 | 建议 |
|---|--------|------|------|
| 1 | **P0 体验** | 前端未部署，用户无法使用浏览器 | `cd frontend && npx vite build` → `deploy/sync_webapp_to_container.sh` |
| 2 | **P1 安全** | Worker 8443 + `/health` 公网可见 | 收紧 ufw 仅 `20.24.218.235`；`/health` 加 Key 或禁公网 |
| 3 | **P1 安全** | F1 页内导航 SSRF 缺口 | `framenavigated` 逐跳校验 |
| 4 | P2 | Worker `sessions:1` 占槽 | 清理会话或等待 idle 超时 |
| 5 | P2 | 源码未 commit | 部署稳定后 `git add` 源码+文档（不含 `web/app/assets` 洪流） |
## 建议执行顺序
1. **同步前端**（解除 P0）
2. **收紧 Worker 防火墙**（F3）
3. **实现 F1** 后复审计
4. **commit** 源码与 changelog/audit/report
## 验证命令（复巡）
```bash
bash scripts/prod_health_check.sh
ssh nexus 'sudo docker exec nexus-prod-nexus-1 python3 -c "from server.config import settings; print(settings.BROWSER_ENABLED)"'
ssh nexus 'sudo docker exec nexus-prod-nexus-1 grep -rl ws/browser /app/web/app/assets/ | head -1'
curl -s http://66.154.115.131:8443/health # 修 F3 后应仅主站可达
```
docs/reports/2026-06-12-remote-browser-worker-verification.md
+30
View File
@@ -0,0 +1,30 @@
# 远程浏览器 Worker 部署验证 — 2026-06-12
## 环境
| 角色 | 地址 |
|------|------|
| Nexus 主站 | `20.24.218.235` / `api.synaglobal.vip` |
| Browser Worker | `66.154.115.131:8443`（主机名 mqtele，约 8GB RAM） |
## Worker
| 检查 | 结果 |
|------|------|
| `curl http://66.154.115.131:8443/health`（从主站） | `{"status":"ok","sessions":0,"max_sessions":2}` |
| 容器 | `nexus-browser-worker` running |
| ufw | `8443` 已对 `20.24.218.235` 放行 |
## Nexus API
| 检查 | 结果 |
|------|------|
| `GET /api/browser/status` | `enabled: true`, `worker_ok: true` |
| `POST /api/browser/sessions` | 返回 `session_id`（已测后删除） |
| 前端 `web/app` 同步 | `sync_webapp_to_container.sh` 入口 bundle HTTP 200 |
## 待用户终验
- [ ] 登录后台 → 左下角浏览器 → 打开 `https://example.com` 有画面且可点击
- [ ] 服务器列表「站点」打开浮动窗（非新标签）
- [ ] 输入 `http://127.0.0.1` 显示明确错误
docs/reports/2026-06-12-watch-bug-patrol.md
+40
View File
@@ -0,0 +1,40 @@
# Bug 巡查 — 监测槽增强（2026-06-12）
**范围**：工作区未提交的 watch 开关 / TTL / 探针修复
**方法**：代码走读 + 单测 + 竞态分析
## 发现与处理
| # | 严重度 | 问题 | 状态 |
|---|--------|------|------|
| 1 | **P0** | TTL 到期后 ~5s 内槽位显示「空」，但 DB ghost pin 仍在；添加服务器 → 唯一约束冲突；点 X 移除 → 404「槽位为空」 | **已修** — API 读/写路径同步 `_finalize_due_pins` |
| 2 | P2 | `onRemove` 无 try/catch，API 失败时未提示 | 未修（低概率，可跟进） |
| 3 | P3 | 暂停态仍可通过 `get_processes` 拉取进程（数据可能过期） | 设计可接受 |
| 4 | — | Gate 7 被并行 Agent 提示改动阻塞 | 非 watch bug |
## P0 根因
```
expires_at 已过
→ list 查询 or_(paused, expires_at>now) 排除该行
→ UI empty=true
→ DB 仍有 monitoring_enabled=true 的行
→ create_pin / pick 槽位 → IntegrityError
```
探针循环每 5s 才跑 `expire_due_pins`，此前无 API 侧兜底。
## 修复
`WatchService._finalize_due_pins()` 在 `list_slots` 及所有槽位变更 API 入口调用，与探针循环逻辑一致：暂停 pin、结束 session、无活跃监测时清 Redis。
## 测试
```text
pytest tests/test_watch_pins.py → 7 passed
pytest tests/test_watch_*.py → 21 passed
```
## 未部署
生产仍为旧版本；修复需部署后浏览器终验 TTL 归零场景。
docs/reports/2026-06-12-watch-monitoring-deploy-verification.md
+36
View File
@@ -0,0 +1,36 @@
# 生产验证 — 监测槽开关 / TTL / 到期竞态 / 探针修复
**日期**：2026-06-12
**Commit**：`32a1885` — feat(watch): 监测槽开关、8h/24h、到期暂停与探针修复
**环境**：https://api.synaglobal.vip
## 部署
| 项 | 结果 |
|----|------|
| 门控 | 7/7 PASS |
| push | `7bb85aa..32a1885 main → main` |
| deploy-production | ✓ Docker 重建 + web/app 同步 |
| `/health` | ok |
| `/app/` | 200 |
## API 终验（生产 JWT）
| 场景 | 结果 |
|------|------|
| POST pin server_id=1 ttl=8 | monitoring=true, ttl_hours=8 |
| PATCH pause | monitoring=false, remaining_sec=null |
| PATCH resume | monitoring=true, remaining≈8h |
| PATCH ttl 24h | ttl_hours=24, remaining≈24h |
| DELETE remove | slot empty=true |
## 前端 bundle
| 检查 | 结果 |
|------|------|
| `ServersPage-DZf56qSd.js` | 200 |
| 含 `setSlotMonitoring` / `monitoring_enabled` | ✓ |
## 结论
**部署成功**；监测槽开关、8h/24h、暂停/恢复、移除 API 均正常。请在浏览器打开服务器页终验 UI（开关、倒计时、中文错误）。
docs/reports/2026-06-12-watch-slot-monitoring-patrol.md
+100
View File
@@ -0,0 +1,100 @@
# 巡检 — 监测槽开关 / 8h·24h / 暂停占槽 / 探针修复
**日期**：2026-06-12
**范围**：工作区未提交改动（监测槽增强 + parse_error 修复 + 中文错误）
**生产**：https://api.synaglobal.vip（**尚未部署本批改动**）
## 进度条
| 步骤 | 状态 |
|------|------|
| 实现 | ✅ 工作区完成 |
| 本地验证 | ✅ L2b 26/26 + ruff |
| 单测 | ✅ watch 23/23 |
| 类型检查 | ✅ vue-tsc |
| 门控 7/7 | ⚠️ 6/7（Gate 7 被 **Agent 提示** 并行改动阻塞，非 watch 本身） |
| 部署 | ❌ 未执行 |
| 生产健康 | ✅ `/health` → `ok` |
| 浏览器终验 | ❌ 待部署后 |
## 本地验证
### 单测
```text
pytest tests/test_watch_*.py tests/test_watch_probe_errors.py
→ 23 passed
```
### L2b API E2E（local_verify.sh）
```text
26/26 passed
ruff F: All checks passed
═══ All local checks passed ═══
```
### 前端
```text
npm run type-check → PASS
```
### 门控 pre_deploy_check.sh
| Gate | 结果 |
|------|------|
| 1 Changelog | PASS（2026-06-12-server-agent-action-hint.md） |
| 2 Audit | PASS（2026-06-12-files-watch-ui-fixes.md） |
| 3 Test | PASS |
| 4 Lint | PASS |
| 5 Import | PASS |
| 6 Security | PASS |
| 7 Review | **BLOCK** — 以下文件有 diff 但未列入当日 audit |
Gate 7 阻塞文件（**Agent 版本提示**，与监测槽无关）：
- `frontend/src/components/servers/ServerAgentHint.vue`
- `frontend/src/components/servers/ServerInlineDetail.vue`
- `frontend/src/composables/servers/useServerFormDialog.ts`
- `frontend/src/types/api.ts`
- `server/api/servers.py`
- `server/utils/agent_version.py`
- `tests/test_agent_version.py`
监测槽改动已有独立审计：`docs/audit/2026-06-11-watch-slot-monitoring-enhancements.md`。
## 生产探针
| 检查 | 结果 |
|------|------|
| `GET /health` | 200 `ok` |
| `GET /app/` | 200 |
| `GET /api/watch/pins`（无 JWT） | 401（预期） |
| `PATCH /api/watch/pins/0/monitoring`（无 JWT） | 401（端点存在性需部署后带 JWT 终验） |
**说明**：生产当前运行的是已部署版本；监测槽开关 / TTL PATCH / 中文错误 / parse_error 修复均在工作区，**线上行为未变**。
## 功能验收清单（部署后浏览器终验）
1. **开关暂停**：关实时监测 → 5s 探针停止，槽位仍占用，UI 显示暂停态
2. **重新开启**：开开关 → 若 session 已结束则自动开新 session，探针恢复
3. **8h / 24h**：默认 8h；点 24h 后 `expires_at` 延长；replace 槽位保留原 TTL
4. **TTL 到期**：自动暂停（不删 pin），Agent 恢复 60s 智能心跳
5. **parse_error**：Agent 有 CPU/内存时 SSH 失败不应整轮 parse_error
6. **中文错误**：探针失败状态与错误列显示中文
## 部署前待办
1. **Gate 7**：为 Agent 提示改动补 audit，或与监测槽分两次提交/部署
2. **迁移**：`watch_pins.monitoring_enabled` + `ttl_hours`（migrations.py 已含）
3. **部署**：用户批准后 `bash deploy/deploy-production.sh`
4. **前端构建**：Docker 内 vite build 或 `deploy/deploy-frontend.sh`
## 本次巡检修复
- 删除 `server/infrastructure/ssh/remote_probe.py` 未使用的 `import logging`（local_verify ruff F401）
## 结论
**代码质量就绪**（单测 + L2b + lint + 类型检查均通过）。**部署被 Gate 7 阻塞**（并行 Agent 提示改动缺 audit）。监测槽功能本身审计完备，建议与 Agent 提示改动解耦提交，或补全 audit 后一并部署。
docs/reports/2026-06-12-watch-slot-ttl-deploy-verification.md
+42
View File
@@ -0,0 +1,42 @@
# 生产验证 — 监测槽分钟时长 + 指标进度条 + 负载
**日期**：2026-06-12
**Commit**：`647ebcb` — feat(watch): 监测槽分钟时长档、指标进度条与负载显示
**环境**：https://api.synaglobal.vip
## 部署
| 项 | 结果 |
|----|------|
| push | `4c38bc0..647ebcb main → main` |
| deploy-production | ✓ Docker 重建 + `ServersPage-CfEy_-BY.js` 同步 |
| `/health` | ok |
| `/app/` | 200 |
## API 终验（生产 JWT）
| 场景 | 结果 |
|------|------|
| GET `/api/watch/pins` | `ttl_minutes: 30` 字段存在 |
| PATCH ttl 60 | `ttl_minutes: 60` |
| PATCH ttl 30 | `ttl_minutes: 30` |
| PATCH ttl 99 | 422 校验拒绝 |
## 前端 bundle
`ServersPage-CfEy_-BY.js` 含：`30分` `1时` `2时` `8时` `24时` `默认 30 分` `内存` `硬盘` `负载` `watch-ttl` `WatchMetricBar`
## 浏览器 E2E（Playwright）
`e2e/pages/watch-slot-ttl.spec.mjs` — **1 passed (7.3s)**
- 服务器页可见「默认 30 分」与五档时长 chip
- 开启监测后可见「内存」「硬盘」「负载」与进度条 `.watch-metric-bar`
## 负载说明
展示 `load_1`（1 分钟平均负载），与宝塔面板「负载」同源；悬停 tooltip 说明非 CPU 百分比。
## 结论
**部署成功**；时长默认 30 分钟、进度条与中文指标、负载 chip 均已上线。
docs/reports/2026-06-13-bug-patrol.md
+104
View File
@@ -0,0 +1,104 @@
# Bug 巡查 — 2026-06-13
**日期**：2026-06-13
**方法**：全量 pytest + L2b + 前端 build/type-check + 代码走读 + 工作区 diff 审查
**生产**：https://api.synaglobal.vip（本机外网/SSH 不可达，见 §5）
## 进度条
| 步骤 | 状态 |
|------|------|
| `local_verify.sh` | ✅ 26/26 |
| `pytest tests/` | ✅ 581/581（修 mock 后） |
| `pytest tests/chain` | ✅ 9/9 |
| `vite build` | ✅ |
| `npm run type-check` | ❌ 工作区未提交删除浏览器文件 |
| 生产探针 | ⚠️ 跳过 |
---
## 发现与处理
| # | 严重度 | 问题 | 根因 | 状态 |
|---|--------|------|------|------|
| 1 | **P2** | `CH-AGT-001` 链条测试失败 | `count_monitored_connectivity` 改用 `redis.pipeline().hgetall`，测试仍 mock 顶层 `hgetall` | **已修** — `test_agent_dashboard_flow.py` 补 pipeline mock |
| 2 | P1 | 监测历史仍显示 UTC | 北京时间 UI 未提交/未部署 | **未修** — 见 `docs/reports/2026-06-13-watch-session-patrol.md` |
| 3 | P1 | 远程浏览器「半删」工作区 | `browser-*` 已从磁盘删除但未 `git commit`；HEAD/生产仍有 `/browser` 路由 | **未提交** — 需整包提交或 `git restore` |
| 4 | P2 | `npm run type-check` 失败 | 浏览器相关 `.vue/.ts` 已删但未入 index，`vue-tsc --build` 报 TS6053 | 随 #3 一并 `git add` 删除后恢复 |
| 5 | P3 | 仪表盘 `online=0` 难察觉 Redis 故障 | `server_stats` catch 后静默归零 | 设计取舍（有 warning 日志） |
| 6 | — | SSH 探针全线失败 | `.strip('"')` 破坏 bash | **已修已部署** `adee25d` |
| 7 | — | TTL 到期 ghost pin | API 未同步 `_finalize_due_pins` | **已修** `2026-06-12` |
| 8 | — | `onRemove` 无错误提示 | — | **已修** — `WatchSlotRow` 已有 try/catch |
---
## P2 — 链条测试回归（已修）
```
FAILED tests/chain/test_agent_dashboard_flow.py::test_heartbeat_then_stats_online_count
WARNING: Failed to count monitored connectivity: 'coroutine' object has no attribute 'hgetall'
```
引入提交：`7209f53`（仪表盘 `count_monitored_connectivity` + Redis pipeline）。
门控 Gate 3 只跑 `tests/test_api.py`，**不跑 chain**；但 Gitea CI 有独立 `pytest tests/chain` job，会持续红。
修复：mock `redis.pipeline()` 与 `test_server_connectivity.py` 同模式。
---
## P1 — 监测历史北京时间（用户可见）
工作区已改 `formatChartAxisBeijing` / `formatDateTimeBeijing`，生产 `web/app/` 仍为旧 bundle → **时间列比北京时间少 8 小时**。
---
## P1 — 远程浏览器删除未提交
| 层 | HEAD / 生产 | 工作区 |
|----|-------------|--------|
| 路由 `#/browser` | ✅ 有 | ❌ 已删 |
| `GlobalBrowserPanel` | ✅ 有 | ❌ 已删 |
| `/api/browser/*` | ✅ 有 | ❌ 已删 |
| `vite build` | — | ✅ 通过 |
| `type-check` | — | ❌ 失败 |
**风险**：只部署前端 build（工作区）而不部署后端删除 → 404；只提交后端不提交前端 → 导航仍指向已删页面。
**建议**：按 `docs/changelog/2026-06-12-remove-remote-browser.md` **整包提交** 后一次部署。
---
## P3 — 仪表盘统计静默降级
```192:197:server/api/servers.py
except Exception as e:
logger.warning(f"Failed to count monitored connectivity in server_stats: {e}")
fleet = {"monitored": 0, "online": 0, "offline": 0}
main_scope = {"monitored": 0, "online": 0, "offline": 0}
```
Redis 异常时 UI 显示 0 在线而非错误态；运维需查日志。非本次引入，记录备查。
---
## 本地验证命令
```bash
bash scripts/local_verify.sh # 26/26
.venv/bin/pytest tests/ -q # 581 passed
.venv/bin/pytest tests/chain -q # 9 passed
cd frontend && npx vite build # OK
cd frontend && npm run type-check # 浏览器删除提交前 FAIL
```
---
## 待办优先级
| 优先级 | 项 |
|--------|-----|
| P0 | 提交链条测试修复（`test_agent_dashboard_flow.py`） |
| P1 | 部署监测历史北京时间（含 audit + changelog） |
| P1 | 远程浏览器删除：整包 commit + 部署，或 `git restore` 回滚工作区 |
| P2 | 生产复验：监测插槽数据、北京时间、CI chain job 绿 |
docs/reports/2026-06-13-deploy-verification.md
+35
View File
@@ -0,0 +1,35 @@
# 生产部署验证 — 监测北京时间 + 下线远程浏览器
**日期**：2026-06-13
**Commit**：`ba7c790` — feat(watch): show probe history in Beijing time and retire remote browser
## 门控
`deploy/pre_deploy_check.sh` → **7/7 PASS**
## 部署
```bash
bash scripts/git-push.sh main
bash deploy/deploy-production.sh
```
- 运行时：Docker `@ /opt/nexus`
- 镜像重建 + `web/app` 同步至容器
- Ops cron 已安装
## 生产探针（源站 SSH）
| 检查项 | 结果 |
|--------|------|
| `curl http://127.0.0.1:8600/health` | `ok` |
| `curl http://127.0.0.1:8600/app/` | `200` |
| `git log -1` | `ba7c790` |
| 容器内 browser 路由 | `no browser routes` |
| 前端 bundle 含 `Asia/Shanghai` | ✅ |
## 建议浏览器终验
1. 打开 `https://api.synaglobal.vip/app/#/watch-metrics` → 探针记录时间为北京时间，页眉有「北京时间」标签
2. 服务器列表 →「站点」在新标签打开（无全局浏览器面板）
3. 侧栏无「远程浏览器」入口
docs/reports/2026-06-13-offline-alert-telegram-verification.md
+36
View File
@@ -0,0 +1,36 @@
# 子机离线告警独立 Telegram — 验证报告
**日期**: 2026-06-13
## 验证结果
| 项 | 方式 | 结果 |
|----|------|------|
| 通道路由单测 | `pytest tests/test_telegram_offline_channel.py` | **PASS** 4/4 |
| 配置与白名单 | Python import `MUTABLE_KEYS` / `resolve_offline_*` | **PASS** |
| API 路由注册 | FastAPI `telegram/offline/*` | **PASS** |
| 本地门控 | `bash scripts/local_verify.sh` | **PASS** 26/26 + ruff |
| 前端构建 | `npm run build` | **PASS**（含 `SettingsPage-*.js`） |
| 构建产物 API 路径 | `telegram/offline/test` 等 | **PASS** |
| 真实 Telegram 发送 | 未执行 | **SKIP**（需生产/本地 Bot 凭据） |
| 子机离线边沿 E2E | 未执行 | **SKIP**（需可 SSH 子机 + Agent） |
## 路由清单（已注册）
- `POST /api/settings/telegram/offline/test`
- `GET /api/settings/telegram/offline/chats`
- `POST /api/settings/telegram/offline/reveal-token`
- `PUT /api/settings/telegram_offline_bot_token`
- `PUT /api/settings/telegram_offline_chat_id`
## 路由逻辑（单测覆盖）
1. 专用 Token+Chat 均配置 → 离线告警走专用 Bot
2. 未配置专用 → 回退默认 `TELEGRAM_BOT_TOKEN` / `TELEGRAM_CHAT_ID`
3. 仅配置一半专用 → 回退默认（避免半配发不出去）
## 手动终验（部署后）
1. **设置** → 配置离线专用 Bot + Chat ID →「测试离线通道」收到消息。
2. 停一台子机 Agent → 离线通知进**专用群**（非默认群）。
3. 清空离线专用配置 → 离线通知回默认群。
docs/reports/2026-06-13-session-features-audit.md
+115
View File
@@ -0,0 +1,115 @@
# 审计报告 — 快捷命令回车修复 + 离线告警 Telegram 分流
**日期**: 2026-06-13
**范围**: 本会话两项功能（不含工作区其它未提交变更如 remote-browser 删除）
**方法**: 定向 diff 走读 + 安全/契约检查 + 已有 pytest 证据
**审计员**: Agent（定向审计，非全仓 Phase 2 走读）
---
## 1. 变更摘要
| 功能 | 核心改动 | 风险面 |
|------|----------|--------|
| 终端快捷命令回车 | `formatQuickCmdForSend` + `execQuickCmd` 发送时补 `\r` | 前端 WebSSH 数据流 |
| 离线告警 Telegram 分流 | `TELEGRAM_OFFLINE_*` + `resolve_offline_telegram_credentials` + 设置页/API | 凭据存储、出站 Telegram |
---
## 2. 审计文件（5 个）
| # | 文件 | 行数 | 状态 |
|---|------|------|------|
| 1 | `server/infrastructure/telegram/__init__.py` | 401 | 逐行完成 ✓ |
| 2 | `server/api/settings.py`（offline 段 ~1188–1342） | 段 | 逐行完成 ✓ |
| 3 | `frontend/src/composables/useTerminalQuickCommands.ts` | 80 | 逐行完成 ✓ |
| 4 | `frontend/src/composables/terminal/useTerminalSessions.ts`（execQuickCmd） | 段 | 逐行完成 ✓ |
| 5 | `frontend/src/pages/SettingsPage.vue`（离线 Bot 段） | 段 | 逐行完成 ✓ |
辅助：`TerminalQuickCommandsSettings.vue`（-2 行）、`server/config.py`（+4 映射）、测试 2 文件。
---
## 3. API 入口表（新增）
| 方法 | 路径 | 鉴权 |
|------|------|------|
| PUT | `/api/settings/telegram_offline_bot_token` | JWT `get_current_admin` |
| PUT | `/api/settings/telegram_offline_chat_id` | JWT |
| POST | `/api/settings/telegram/offline/test` | JWT |
| GET | `/api/settings/telegram/offline/chats` | JWT |
| POST | `/api/settings/telegram/offline/reveal-token` | JWT + 审计 |
既有 `broadcast_offline_alert` → `send_telegram_offline_alert` 无新 HTTP 面。
---
## 4. Closure 表
| ID | 规则/检查点 | 文件:行 | 结论 | 说明 |
|----|-------------|---------|------|------|
| H1 | 敏感凭据不入 GET 明文 | settings.py SENSITIVE_KEYS | **SAFE** | `telegram_offline_bot_token` 已加入掩码集 |
| H2 | reveal 写 audit_logs | settings.py:1324–1331 | **SAFE** | `reveal_offline_telegram_token` |
| H3 | 出站消息 HTML 转义 | telegram/__init__.py:189–195 | **SAFE** | `html.escape` 用于名称/心跳 |
| H4 | 离线专用半配不误发 | telegram/__init__.py:96–107 | **SAFE** | 仅 token 或仅 chat 时整组回退默认 Bot |
| H5 | 资源告警仍走默认 Bot | telegram/__init__.py:163 | **SAFE** | `send_telegram_alert` 未改路由 |
| H6 | `send_telegram` 参数化不破坏默认调用 | telegram/__init__.py:110–118 | **SAFE** | 默认 `bot_token/chat_id=None` 行为不变 |
| H7 | MUTABLE_KEYS 白名单 | settings.py:47–48 | **SAFE** | 两新键已列入 |
| H8 | 快捷命令 `\r` 与 `trim()` 冲突 | useTerminalQuickCommands.ts:43–49 | **SAFE** | 发送时 `formatQuickCmdForSend` 根治 |
| H9 | 内置命令 DB 带 `\r` 幂等 | useTerminalQuickCommands.ts:21–23 | **SAFE** | 先去尾再追加 |
| H10 | 多行快捷命令语义 | useTerminalQuickCommands.ts:21–23 | **SAFE** | 与命令栏一致：整段一条命令 + 单次 `\r` |
| H11 | 测试覆盖通道路由 | test_telegram_offline_channel.py | **SAFE** | 4 case 含 dedicated/fallback/partial |
| H12 | reveal 加载态共用 | SettingsPage.vue:886–911 vs 离线 toggle | **FINDING P3** | 离线与默认共用 `revealingTelegramToken`，并发点击可能互斥显示 |
| H13 | test 端点重复 httpx | settings.py:1268–1309 | **FINDING P3** | 可复用 `send_telegram(..., bot_token, chat_id)` 减重复 |
| H14 | 新 API 错误文案 i18n | settings.py:1253,1264 | **FINDING P3** | `http_errors_zh` 未收录 `telegram_offline_*` 键名错误 |
| H15 | 子机恢复在线 Telegram | server_offline_monitor.py | **INFO** | 仅 offline 边沿推送，无「恢复在线」通知（既有设计，非回归） |
| H16 | Layer3 巡检不同步离线 Bot | settings.py:416–422 | **SAFE** | 仅默认 token 写 .env，符合设计文档 |
| H17 | 无静默吞错 | telegram/__init__.py:136–138 | **SAFE** | 失败打 error 日志 |
| H18 | CUD 审计 | settings.py set_setting | **SAFE** | PUT 走既有 `update_setting` 审计 |
`len(H)=18`，Closure=18。
---
## 5. 严重度汇总
| 级别 | 数量 | 项 |
|------|------|-----|
| **P0** | 0 | — |
| **P1** | 0 | — |
| **P2** | 0 | — |
| **P3** | 3 | H12 加载态共用；H13 test 重复代码；H14 错误文案 i18n |
| **INFO** | 1 | H15 无离线恢复 Telegram |
**合并结论**: **可合并 / 可部署**。无安全阻断项；P3 可在后续小 PR 打磨。
---
## 6. 测试证据
```
pytest tests/test_telegram_offline_channel.py → 4 passed
pytest tests/test_terminal_quick_commands.py → 1 passed
bash scripts/local_verify.sh → 26/26 + ruff
frontend npm run build → OK
```
---
## 7. 建议（可选跟进）
1. **H12**: 为离线 Token 增加独立 `revealingOfflineTelegramToken`，避免与默认 Bot 眼睛按钮抢 loading。
2. **H13**: `telegram_offline_test_send` 改为 `await send_telegram(message, bot_token=token, chat_id=chat_id)`。
3. **H14**: 在 `server/utils/http_errors_zh.py` 补充 `telegram_offline_bot_token 未配置` 等映射。
---
## 8. 验收对照（设计文档）
| 验收项 | 结果 |
|--------|------|
| 专用 Bot+Chat 配置后离线走专用通道 | ✓ 代码 + 单测 |
| 未配置专用时回退默认 | ✓ 单测 |
| CPU/内存等仍走默认 | ✓ 未改 `send_telegram_alert` |
| 设置页保存/检测/测试 | ✓ UI + API 已实现 |
| 快捷命令点击执行带回车 | ✓ `formatQuickCmdForSend` + 构建验证 |
docs/reports/2026-06-13-session-features-patrol.md
+108
View File
@@ -0,0 +1,108 @@
# 巡检 — 快捷命令回车 + 离线 Telegram 分流 + Layer3 巡检
**日期**：2026-06-13
**范围**：本会话两项功能 + 部署门控 + Layer3 宿主机巡检状态
**生产**：https://api.synaglobal.vip（本机外网 curl 不可达，见下）
## 进度条
| 步骤 | 状态 |
|------|------|
| 实现 | ✅ 工作区完成 |
| 本地 L2b | ✅ 26/26 + ruff |
| 功能单测 | ✅ 10/10（offline 4 + quick-cmd 1 + offline_monitor 5） |
| Layer3 单测 | ✅ `test_ops_patrol_sync.py` 7/7 |
| 前端 build | ✅（此前已构建） |
| 门控 7/7 | ❌ **5/7**（Gate 2/7 审计路径、Gate 7 无审计文件） |
| 生产健康 | ⚠️ 外网 `curl` 连接重置；SSH `nexus` 主机名不可解析 |
| 本地 API | ✅ `GET /health` → `ok` |
| 浏览器终验 | ❌ 待部署 |
---
## 1. 功能变更巡检
### 1.1 终端快捷命令回车
| 检查项 | 结果 |
|--------|------|
| `formatQuickCmdForSend` 发送时补 `\r` | ✅ |
| 设置页不再 `trim` 掉 `\r` 后入库 | ✅ |
| 内置命令 DB 带 `\r` 幂等 | ✅ 单测逻辑 |
| `pytest test_terminal_quick_commands` | ✅ 1 passed |
### 1.2 子机离线告警独立 Telegram
| 检查项 | 结果 |
|--------|------|
| `resolve_offline_telegram_credentials` 专用优先 / 半配回退 | ✅ 3 case |
| `send_telegram_offline_alert` 传入专用 token/chat | ✅ mock 单测 |
| 资源告警仍走默认 Bot | ✅ 未改 `send_telegram_alert` |
| 设置页离线 Bot UI + 3 API | ✅ 代码 + 构建产物 |
| Layer3 `health_monitor.sh` 使用离线 Bot | ✅ **否**（设计：仅默认 `NEXUS_TELEGRAM_*`） |
| `ops_patrol_sync` 同步离线 Token | ✅ **否**（符合设计） |
---
## 2. Layer 3 宿主机巡检
| 项 | 本地状态 |
|----|----------|
| `deploy/health_monitor.sh` 语法 | ✅ `bash -n` 通过 |
| `test_ops_patrol_sync.py` | ✅ 7/7 |
| `.env` 内 `NEXUS_TELEGRAM_*` | ❌ 未写入（`env_synced: false`） |
| DB `TELEGRAM_BOT_TOKEN/CHAT_ID` | ❌ 本地未配置 |
| 离线专用 `TELEGRAM_OFFLINE_*` | ❌ 未配置（预期：不影响 L3） |
| 生产 cron / `nexus_health.log` | ⚠️ 无法 SSH 核查（`nexus` 主机名不可解析） |
**说明**：Layer3 巡检 Telegram 依赖设置页保存后「同步巡检 Telegram」或 `health_monitor.sh` 的 DB 回退；与本次**离线专用 Bot**无关。
---
## 3. 部署门控 `pre_deploy_check.sh`
| Gate | 结果 |
|------|------|
| 1 Changelog | ✅ `2026-06-13-offline-alert-telegram-split.md` |
| 2 Audit | ❌ 缺少 `docs/audit/2026-06-13-*.md`（审计写在 `docs/reports/`） |
| 3 Test | ✅ |
| 4 Lint | ✅ |
| 5 Import | ✅ |
| 6 Security | ✅ bandit 0 HIGH |
| 7 Review | ❌ 无 audit 文件对照 diff |
**部署结论**：**BLOCKED**，需将门控格式审计写入 `docs/audit/2026-06-13-*.md`（含 Step 3 / Closure / DoD 段落）后方可 `deploy-production.sh`。
---
## 4. 生产可达性（本环境）
```
curl https://api.synaglobal.vip/health → Recv failure: 连接被对方重置
ssh nexus → Could not resolve hostname
curl http://127.0.0.1:8600/health → ok
```
外网/SSH 失败可能为本机网络或 DNS 限制，**不能据此判定生产宕机**；请在可访问生产的环境复验。
---
## 5. 风险与待办
| 优先级 | 项 | 建议 |
|--------|-----|------|
| P0 部署 | 门控审计路径 | 补 `docs/audit/2026-06-13-offline-quick-cmd-telegram.md` |
| P1 上线 | 前端 `web/app/` | `vite build` 后部署 |
| P1 上线 | 后端重启 | 新 `telegram/offline/*` 端点 |
| P2 运维 | 离线专用 Bot | 设置页配置 + 测试离线通道 |
| P2 运维 | Layer3 | 保存默认 Telegram 后点「同步巡检 Telegram」 |
| P3 | 审计 P3 项 | 见 `docs/reports/2026-06-13-session-features-audit.md` |
---
## 6. 建议部署后终验清单
1. 设置 → 离线专用 Bot → **测试离线通道**
2. 终端 → 自定义快捷命令 → 点击执行有回车
3. 设置 → Layer3 状态芯片「巡检 Telegram 就绪」+ `.env 已同步`（若使用 L3）
4. `https://api.synaglobal.vip/health` → `ok`
docs/reports/2026-06-13-terminal-quick-cmd-enter-verification.md
+33
View File
@@ -0,0 +1,33 @@
# 终端快捷命令回车修复 — 验证报告
**日期**: 2026-06-13
**变更**: `formatQuickCmdForSend` + `execQuickCmd` 发送时追加 `\r`
## 验证结果
| 项 | 命令/方式 | 结果 |
|----|-----------|------|
| 前端构建 | `cd frontend && npm run build` | PASS（5.37s，含 `TerminalPage-*.js`） |
| 本地门控 | `bash scripts/local_verify.sh` | PASS（26/26 API smoke + ruff） |
| 发送逻辑单测 | Node/Python 镜像 `formatQuickCmdForSend` | PASS（含 `trim()` 剥 `\r` 后仍能补回） |
| API 集成 | `pytest tests/test_terminal_quick_commands.py` | PASS |
| 浏览器 E2E（WebSSH 点击执行） | 未执行 | SKIP — 需已登录 + 可 SSH 子机 |
## 根因复现（已确认）
```javascript
'ls\r'.trim() // => 'ls' （\r 被当作空白剥掉）
```
修复后：`formatQuickCmdForSend('ls')` => `'ls\r'`，与命令栏 `sendCmd` 行为一致。
## 手动终验（部署后）
1. 设置 → 终端快捷命令 → 添加 `echo hello`，保存。
2. 终端页连接子机 → 点击该快捷命令。
3. 预期：输出 `hello` 并回到新提示符（非悬停在输入行）。
## 备注
- 内置命令 DB 中可能仍带 `\r`；`formatQuickCmdForSend` 先去尾再追加，幂等安全。
- 仅前端变更；部署 `web/app/` 即可，无需重启后端。
docs/reports/2026-06-13-watch-session-patrol.md
+120
View File
@@ -0,0 +1,120 @@
# 巡检 — 监测 SSH 探针 / 硬件详情 / 历史北京时间
**日期**：2026-06-13
**范围**：本会话监测相关修复与 UI 改动 + 本地门控 + 生产可达性
**生产**：https://api.synaglobal.vip
## 进度条
| 步骤 | 状态 |
|------|------|
| SSH 探针引号修复 (`adee25d`) | ✅ 已提交；前序会话已部署 |
| 插槽硬件详情 (`4acbf04`) | ✅ 已提交；前序会话已部署 |
| 监测历史北京时间 | ✅ 工作区实现 + changelog；❌ 未提交、未部署 |
| 本地 L2b | ✅ 26/26 + ruff |
| 功能单测 | ✅ 29/29（watch 22 + ops_patrol 7） |
| 前端 build | ✅ `vite build` 6.5s |
| 门控 7/7 | ✅（针对当前 index 已跟踪变更） |
| 生产健康 | ⚠️ 本机外网 `curl` 失败；SSH 无私钥 |
| 浏览器终验 | ⚠️ 北京时间需部署后终验 |
---
## 1. 已上线功能（代码库 HEAD）
### 1.1 SSH 探针引号破坏 bash（`adee25d`）
| 检查项 | 结果 |
|--------|------|
| `remote_probe.py` 使用 `.strip(chr(34))` 而非 `.strip('"')` | ✅ |
| `test_ssh_watch_metrics_cmd_runs_locally` | ✅ |
| `test_parse_ssh_watch_payload*` | ✅ |
| 审计 `docs/audit/2026-06-13-ssh-watch-probe-quote-fix.md` | ✅ |
**根因回顾**：`.strip('"')` 会剥掉脚本内嵌 bash 双引号，导致远端探针语法错误、插槽全线 `ssh_probe_failed`。
### 1.2 监测插槽硬件详情（`4acbf04`）
| 检查项 | 结果 |
|--------|------|
| `WatchProbeSample` 含 `cpu_cores` / `mem_total_gb` 等 | ✅ |
| `fill_hardware_gaps_from_percent` 单测 | ✅ |
| `test_parse_ssh_watch_payload_includes_hardware_specs` | ✅ |
| Agent `_hardware_specs_dict()` | ✅ 代码存在 |
### 1.3 Telegram 群聊 Chat ID（`40cba6a` / `e95e522`）
| 检查项 | 结果 |
|--------|------|
| `_extract_chats_from_telegram_updates` 含 `my_chat_member` | ✅（前序已验） |
| `test_settings_telegram.py` | ✅ 纳入 29 passed |
---
## 2. 工作区待部署：监测历史北京时间
| 检查项 | 结果 |
|--------|------|
| `formatChartAxisBeijing` / 各 watch 组件引用 | ✅ |
| `WatchMetricsPage` 「北京时间」标签 | ✅ |
| Changelog `2026-06-13-watch-history-beijing-time.md` | ✅ 27 行 |
| 审计 `docs/audit/2026-06-13-watch-history-beijing-time.md` | ❌ **缺失**（提交前建议补，避免 Gate 2/7 在含该 diff 时失败） |
| `git commit` / 生产 `web/app/` | ❌ 未做 |
**逻辑**：API `recorded_at` 为 UTC naive / ISO-Z；`parseApiDateTime` 转 instant 后 `Asia/Shanghai` 格式化。示例：`2026-06-13 04:30:00` UTC → 展示 `2026-06-13 12:30:00`。
---
## 3. 本地验证
```
bash scripts/local_verify.sh → 26/26 passed, ruff OK
pytest test_watch_metrics.py → 22 passed
pytest test_ops_patrol_sync.py → 7 passed
cd frontend && npx vite build → OK
deploy/pre_deploy_check.sh → 7/7 gates passed
curl http://127.0.0.1:8600/health → ok
```
---
## 4. 生产可达性（本环境）
```
curl -sk https://api.synaglobal.vip/health → 连接重置 / TLS 失败 (exit 35)
ssh nexus → 主机名不可解析
ssh azureuser@20.24.218.235 → Permission denied (publickey)
（本机无 ~/.ssh/id_rsa_nexus）
```
**结论**：无法在本 Agent 环境复验生产 `/health` 与监测插槽实时数据；**不能据此判定生产宕机**（与前序巡检一致，疑为本机网络/DNS/密钥限制）。请在可 SSH 生产的环境复验。
---
## 5. 工作区噪音（勿混入北京时间提交）
以下改动与本次监测巡检**无关**，提交北京时间时不应 `git add`：
- `browser-worker/` 整目录删除
- `GlobalBrowserPanel.vue` / `BrowserPage.vue` / `useGlobalBrowser.ts` 等远程浏览器移除
- `deploy/gate_log.jsonl`、`AI-HANDOFF` 等杂项
---
## 6. 风险与待办
| 优先级 | 项 | 建议 |
|--------|-----|------|
| P0 | 北京时间上线 | 补 audit → 仅 add watch+datetime+changelog → commit → `vite build` → 部署前端 |
| P1 | 生产复验 | 有可 SSH 密钥环境：`curl -sk https://127.0.0.1:8600/health`；打开 `#/watch-metrics` 看时间列 |
| P2 | 插槽数据 | 确认无 `ssh_probe_failed`；卡片显示核数/内存/磁盘 |
| P3 | Layer3 巡检 | 见 `docs/reports/2026-06-13-session-features-patrol.md`（与监测 UI 独立） |
---
## 7. 部署后终验清单
1. `#/watch-metrics` → 探针记录「时间」列为北京时间（与系统时钟差 ≤1 分钟）
2. 趋势图横轴 `MM-DD HH:mm` 与 tooltip 全文时间为北京时间
3. 监测插槽有 CPU/内存/磁盘用量与规格（非全线失败）
4. `https://api.synaglobal.vip/health` → `ok`
docs/reports/2026-06-14-bug-patrol.md
+86
View File
@@ -0,0 +1,86 @@
# Bug 巡查 — 2026-06-14
**日期**：2026-06-14
**范围**：`825d029` 暂停居中开关 + `4bbc47f` UI 美化 + 监测链路
**方法**：L2b + pytest + 代码走读 + 生产探针
## 进度条
| 步骤 | 状态 |
|------|------|
| `local_verify.sh` | ✅ 26/26 |
| `pytest`（非 chain） | ✅ 571 passed |
| `pytest tests/chain` | ✅ 9/9 |
| `test_watch_*` | ✅ 23/23 |
| 生产 `/health` | ✅ `ok` @ `825d029` |
| 浏览器终验 | ⚠️ 待用户确认暂停开关交互 |
---
## 发现与处理
| # | 严重度 | 问题 | 根因 | 状态 |
|---|--------|------|------|------|
| 1 | **P2** | 暂停槽底部显示「剩余 **已到期**」 | 暂停时 API `remaining_sec=null`，`formatRemaining(null)`→「已到期」 | **已修** — 暂停底栏改「已暂停 · 时长 · Agent 60s」 |
| 2 | P3 | Sparkline 渐变 `${color}33` 在非 hex 主题失效 | Vuetify 可能返回 `rgb()` | 未修（线条仍正常） |
| 3 | P3 | 探针表 `total=0` 仍显示 1 页分页 | `pageCount` 下限为 1 | 未修 |
| 4 | — | SSH 探针引号 | `adee25d` | 已部署 |
| 5 | — | TTL ghost pin | `_finalize_due_pins` | 已修 |
| 6 | — | CH-AGT-001 pipeline mock | `825d029` 前已修 | ✅ |
---
## P2 — 暂停态「已到期」误文案（已修）
后端 `watch_service._slot_payload`：暂停时 `remaining_sec=None`（TTL 倒计时冻结）。
```138:139:frontend/src/utils/watchFormat.ts
export function formatRemaining(sec: number | null | undefined): string {
if (sec == null || sec <= 0) return '已到期'
```
暂停底栏若用 `formatRemaining(slot.remaining_sec)` 会误显示「已到期」，与用户「槽位保留」语义冲突。
**修复**：`WatchSlotCard.vue` 暂停底栏改为 `已暂停 · {ttl} · Agent 60s 上报`。
---
## 暂停居中开关（`825d029`）走读
| 检查项 | 结果 |
|--------|------|
| 暂停仅中部开关可开启 | ✅ 顶栏开关 `v-if="monitoringOn"` |
| 开启后显示指标 | ✅ `v-else` 包裹 metrics |
| 暂停不跳转历史 | ✅ `@click` 仅 `monitoringOn` 时 |
| API 失败提示 | ✅ `WatchSlotRow.onMonitoring` try/catch |
| 暂停不返回 metrics | ✅ 后端 `monitoring_enabled` 分支 |
---
## 本地验证
```text
bash scripts/local_verify.sh → 26/26
pytest tests/ -m "not chain and not slow" → 571 passed
pytest tests/chain -q → 9 passed
pytest tests/test_watch_pins.py tests/test_watch_metrics.py → 23 passed
```
---
## 生产（源站 SSH）
| 项 | 结果 |
|----|------|
| `curl http://127.0.0.1:8600/health` | `ok` |
| `git log -1` | `825d029` |
---
## 待办
| 优先级 | 项 |
|--------|-----|
| P0 | 部署 P2 底栏文案修复（工作区未提交） |
| P2 | 浏览器终验：暂停→中部开→指标→顶栏关 |
| P3 | Sparkline 渐变 / 空表分页 |
docs/reports/2026-06-14-watch-ui-patrol.md
+107
View File
@@ -0,0 +1,107 @@
# 巡检 — 2026-06-14（监测 UI + 生产健康）
**日期**：2026-06-14
**范围**：监测槽 UI 迭代（`c91cb1c` 已部署 + 工作区待部署）· L2b · pytest · 生产源站
**生产**：https://api.synaglobal.vip
## 进度条
| 步骤 | 状态 |
|------|------|
| `local_verify.sh` | ✅ 26/26 + ruff |
| `pytest`（非 chain） | ✅ 570 passed（1 环境性失败见下） |
| `pytest tests/chain` | ✅ 9/9 |
| `test_watch_*` + `test_ops_patrol_sync` | ✅ 29/30（SSH 本地探针 1 失败） |
| 门控 7/7 | ✅（针对已跟踪变更） |
| `vite build` | ✅ |
| 生产 `/health` + `/app/` | ✅ `ok` / `200` @ `c91cb1c` |
| 工作区待部署 | ⚠️ 见 §2 |
---
## 1. 生产（源站 SSH）
| 项 | 结果 |
|----|------|
| `curl http://127.0.0.1:8600/health` | `ok` |
| `curl /app/` | `200` |
| `git log -1`（`/opt/nexus`） | `c91cb1c` — polish paused UI + header spacing |
| `bash -n deploy/health_monitor.sh` | ✅ 通过 |
| Docker nexus | 运行中（巡检时刻容器 Up） |
**Layer 3 日志**：`/var/log/nexus_health.log` 尾部曾出现 `health_monitor.sh: unexpected EOF`（历史 cron 执行）；当前仓库脚本 `bash -n` 正常，疑为旧版残留日志，**不影响当前 `/health`**。建议观察下一小时 cron 是否仍报错。
---
## 2. 工作区未部署（监测槽 UI）
相对生产 `c91cb1c`，本地尚有未提交改动：
| 变更 | 说明 |
|------|------|
| 顶栏 ⋮ 菜单 | 暂停/恢复/移除，去掉开关与 ✕，防误触 |
| 暂停态精简 | 仅保留「恢复实时监测」；隐藏时长行、横幅、圆环占位、底栏 |
| 开启态底栏 | 增加「暂停」文字链 |
| `watch_probe_runner.py` | 删除未使用 `import time`（ruff F401） |
**建议**：commit → 门控 → 部署前端（纯 UI + 无害 lint 可随下一次一起上）。
---
## 3. 已部署功能走读（`b5419cd`…`c91cb1c`）
| 检查项 | 结果 |
|--------|------|
| SSH 优先 5s 探针 | ✅ 代码在产 |
| 移除 IO 速率 | ✅ 前后端 |
| 四圆环一行（CPU/内存/硬盘/负载） | ✅ `3faa7a4` |
| 恢复监测立即探针 | ✅ `5c508ed` |
| 暂停态圆环占位 + 顶栏间距 | ✅ `c91cb1c`（将被下一版精简 UI 替代） |
---
## 4. 本地验证
```text
bash scripts/local_verify.sh → 26/26, ruff OK
pytest tests/ -m "not chain and not slow" -q → 570 passed, 1 failed
pytest tests/chain -q → 9 passed
pytest tests/test_watch_pins.py test_watch_metrics.py test_ops_patrol_sync.py → 29 passed, 1 failed
cd frontend && npx vite build → OK
deploy/pre_deploy_check.sh → 7/7
```
**环境性失败**：`test_ssh_watch_metrics_cmd_runs_locally` — 本机无 `psutil`，远端脚本返回 `error`；CI/生产有 psutil 时通过。非回归。
---
## 5. 发现与处理
| # | 严重度 | 问题 | 状态 |
|---|--------|------|------|
| 1 | P2 | 顶栏开关易误触 | **工作区已改** — ⋮ 菜单 + 底栏「暂停」 |
| 2 | P2 | 暂停态信息过载 | **工作区已改** — 仅恢复按钮区 |
| 3 | P3 | `watch_probe_runner` 未使用 `import time` | **工作区已修** — ruff F401 |
| 4 | P3 | L3 日志历史 syntax 报错 | 观察；当前脚本语法 OK |
| 5 | P3 | Sparkline 渐变 hex 假设 | 未修（线条正常） |
| 6 | P3 | 探针表 total=0 仍 1 页 | 未修 |
---
## 6. 部署后终验清单（下一版 UI）
1. 暂停槽：无时长行/圆环/底栏，仅「恢复实时监测」
2. 开启槽：顶栏仅 ⋮，无贴脸开关；底栏可点「暂停」
3. 四圆环数值与宝塔接近（±5s）
4. 暂停 → 恢复后 5–15s 内出现指标
---
## 7. 待办
| 优先级 | 项 |
|--------|-----|
| P0 | 提交并部署 §2 工作区 UI + lint 修复 |
| P1 | 用户浏览器终验暂停/恢复/菜单 |
| P2 | 观察 L3 cron 日志是否仍报 EOF |
| P3 | Sparkline / 空表分页 |
docs/reports/2026-06-21-btpanel-ssh-timeout-servers.md
+37
View File
@@ -0,0 +1,37 @@
# 宝塔 bootstrap SSH 超时机器清单
生成时间：2026-06-21 02:40 UTC
## 说明
以下服务器在批量 bootstrap（任务 #119 / #121）中报告 `ssh_timeout`：中心机 SSH 在超时内无响应。
请在云平台核对：实例是否运行、公网 IP 是否与 Nexus `domain` 一致、安全组是否放行 **22** 端口。
**合计：17 台**
| ID | 名称 | SSH IP (domain) | preset_id | 分类 | 失败任务 |
|----|------|-----------------|-----------|------|----------|
| 4 | 武汉念曦焱网络科技有限公司 | 8.163.90.186 | — | 商城-待扫 | #119,#121 |
| 22 | 广州申迹网络科技有限公司 | 47.107.163.227 | — | 鞋靴 | #119,#121 |
| 24 | 子-东莞启楷网络科技有限公司 | 42.121.221.178 | — | 情趣/成人 | #119,#121 |
| 41 | 海南铭维网络科技有限公司-子 | 120.79.223.248 | — | 商城-待扫 | #119,#121 |
| 51 | 安庆驰探电子商务有限公司-子 | 120.25.48.230 | — | 商城-待扫 | #119,#121 |
| 101 | 东莞炎且网络科技有限公司 | 47.121.181.238 | — | 情趣/成人 | #119,#121 |
| 200 | 湖北昂翊电子商务有限公司 | 47.96.165.168 | — | 商城-待扫 | #119,#121 |
| 225 | 武汉市运来万电子有限公司 | 47.113.192.161 | — | 机器人 | #119,#121 |
| 313 | 武汉市温胜夜科技有限公司 | 42.193.171.106 | — | 包袋/配饰 | #119,#121 |
| 314 | 子-武汉市温胜夜科技有限公司 | 159.75.124.238 | — | 包袋/配饰 | #119,#121 |
| 315 | 漫窗星(武汉市)电子商务有限公司 | 159.75.25.162 | — | 机器人 | #119,#121 |
| 316 | 子-漫窗星(武汉市)电子商务有限公司 | 111.230.99.21 | — | 机器人 | #119,#121 |
| 317 | 武汉市雾霜月百货有限公司 | 129.204.187.80 | — | 机器人 | #119,#121 |
| 318 | 子-武汉市雾霜月百货有限公司 | 1.14.158.107 | — | 机器人 | #119,#121 |
| 332 | 湖北优点鼎电子商务有限公司 | 47.121.187.133 | — | 机器人 | #119,#121 |
| 367 | 冲量夏序 | 120.79.11.13 | — | 商城-待扫 | #119,#121 |
| 371 | 冲量银海-泽初 | 47.107.181.56 | — | 鞋靴 | #119,#121 |
## 运维检查命令（中心机）
```bash
# 替换 IP
nc -zv -w 5 <IP> 22
```
docs/reports/README.md
+27
View File
@@ -0,0 +1,27 @@
# Nexus 活跃报告
> 更新: 2026-06-04 · 批量 batch 已迁至 [archive/audits/](../archive/audits/)
## 2026-06 审计 closure
| 文件 | 说明 |
|------|------|
| [audit-plugin-run-final-2026-06-04.md](audit-plugin-run-final-2026-06-04.md) | 总验收 |
| [audit-frontend-14p-2026-06-04-closure.md](audit-frontend-14p-2026-06-04-closure.md) | 前端 14 页 |
| [audit-phase-4-plugin-closure-2026-06-04.md](audit-phase-4-plugin-closure-2026-06-04.md) | Phase4 |
| [audit-bug-scan-closure-2026-06-04.md](audit-bug-scan-closure-2026-06-04.md) | Bug scan |
| [audit-bug-coverage-master-2026-06-04.md](audit-bug-coverage-master-2026-06-04.md) | 覆盖率 |
| [audit-bug-assets-gate-2026-06-04.md](audit-bug-assets-gate-2026-06-04.md) | Assets gate |
合并卷: [line-walk](../archive/audits/2026-06-04-line-walk-merged.md) · [delta](../archive/audits/2026-06-04-delta-merged.md) · [phase2](../archive/audits/2026-06-04-phase2-merged.md) · [frontend-14p](../archive/audits/2026-06-04-frontend-14p-merged.md)
## 生产 / 验收
| 文件 | 说明 |
|------|------|
| [2026-06-01-production-verification.md](2026-06-01-production-verification.md) | 生产验证 |
| [2026-06-01-final-acceptance-checklist.md](2026-06-01-final-acceptance-checklist.md) | 终验清单 |
| [2026-06-01-full-acceptance-report.md](2026-06-01-full-acceptance-report.md) | 全量验收 |
| [2026-06-01-browser-verification.md](2026-06-01-browser-verification.md) | 浏览器抽测 |
历史: [archive/reports/](../archive/reports/)
docs/reports/audit-bug-assets-gate-2026-06-04.md
+34
View File
@@ -0,0 +1,34 @@
# BUG 扫描 — B-Assets 门控（2026-06-04）
**标准**: `standards/line-walk-audit-standard-v2.md` FE-06 · 登记册 `covered-by-frontend-src`
## 范围
| 项 | 动作 | 结果 |
|----|------|------|
| `web/app/index.html` | 8 步入口审；核对 script/link 指向的 chunk | ✅ |
| `web/app/assets/**` | 登记册 `status: covered-by-frontend-src`（2773 文件） | ✅ |
| FE-06 外链 CDN | `grep` `web/app/*.{html,js}` 无 `cdn.` / `unpkg` | ✅ |
## index.html 引用校验
| 引用 | 磁盘存在 |
|------|----------|
| `/app/assets/index-CshJ6ajy.js` | ✅ |
| `/app/assets/index-BGzIPEZO.css` | ✅ |
| `/app/favicon.ico` | （构建产物目录，随 Vite 部署） |
入口仅同源 `/app/assets/*`，无第三方 CDN script。
## DoD
- [x] 构建产物不逐行走读，由 `frontend/src` BUG 批次 B35–B52 覆盖
- [x] 门控脚本/人工核对 chunk 存在性
- [x] FE-06 通过
## 验证
```bash
grep -rE 'https://cdn\.|unpkg\.com' web/app/*.html web/app/*.js || echo 'no CDN'
test -f web/app/assets/index-CshJ6ajy.js && test -f web/app/assets/index-BGzIPEZO.css
```
docs/reports/audit-bug-coverage-master-2026-06-04.md
+153
View File
@@ -0,0 +1,153 @@
# BUG / 审计覆盖总表（2026-06-04）
**用途**：回答「还有哪些文件没扫？」——区分 **Phase 2/3 走读** 与 **BUG 专项深读**，避免与「全库闭环」混读。
**图例**
| 标记 | 含义 |
|------|------|
| **P2·矩阵** | `audit-phase-2-findings-matrix.md` 有对应 ID 或 2a–2j 批次纳入 |
| **P2·批次** | Phase 2/3 报告中有文件名（grep / 目录汇总 / 增量） |
| **P3·目录** | Phase 3 前端按目录 grep（`pages/` 14 文件合计 0 新 FINDING，**非逐页全文**） |
| **BUG·全文** | BUG 专项 Batch 1–6：该文件 **全文或核心路径通读** |
| **BUG·节选** | BUG 专项只读了 **部分行/函数**（最易漏扫） |
| **—** | 上述 BUG 专项 **未列入** 任何 Batch 范围表 |
**统计（BUG 专项）**
- `server/api/*.py`：20 个文件 → BUG·全文/节选 **12**，BUG 未列入 **8**
- `frontend/src/pages/*.vue`：14 个 → BUG·节选/关联 **4**，BUG 未列入 **10**
---
## 1. `server/api/`（20）
| 文件 | 行数约 | Phase 2/3 | BUG 专项 | 说明 |
|------|--------|-----------|----------|------|
| `agent.py` | 360 | P2·矩阵 F2a-02/03/04；2h 增量 | **BUG·全文** B1；**BUG·节选** B5 TTL | 心跳/告警主路径已深读 |
| `install.py` | 719 | P2·矩阵 F2a-08/09；2a 全文 | **BUG·全文** B1 | 安装锁已修 |
| `auth_jwt.py` | 275 | P2·矩阵 F2a-10 | **BUG·全文** B6 | 中间件 + `tv` |
| `auth.py` | ~375 | P2·矩阵 F2a-07 | **BUG·节选** B6（refresh 在 service） | 登录/TOTP 路由未单独 BUG 通读 |
| `servers.py` | ~1733 | P2·矩阵 F2a-12/13 | **BUG·节选** B1 stats；B3 stats 封顶 | **大部 CRUD/WebSSH 未 BUG 通读** |
| `sync_v2.py` | ~1663 | P2·矩阵 F2a-11；2b 服务层 | **BUG·节选** B3/4/5 多段 | file-ops/upload/写路径；**整文件未 BUG 通读** |
| `scripts.py` | ~369 | P2·矩阵 F2a-14/15；2h 全文 | — | Phase 2h 已全文；BUG 专项未单列 |
| `webssh.py` | — | P2·矩阵 F2a-01/05/06 | — | 仅矩阵/历史 2a，**无 BUG Batch** |
| `websocket.py` | — | P2·矩阵 F2a-18 | — | 告警 WS；推送 WS 在 B4 侧验证 |
| `settings.py` | — | P2·矩阵 F2a-16 | — | |
| `files.py` | 78 | P2·批次（API 层） | **BUG·全文** B4 | 仅 GET browse |
| `schemas.py` | — | P2·批次 | **BUG·节选** B4 `SyncFiles.batch_id` | |
| `terminal.py` | — | P2·批次 | — | |
| `search.py` | — | P2·批次 | — | |
| `assets.py` | — | P2·批次 | — | |
| `health.py` | — | P2·批次 | — | |
| `dependencies.py` | — | P2·矩阵 F2a-17 | — | |
| `remote_path_validation.py` | — | P2·批次 | — | |
| `schema_path_validators.py` | — | P2·批次 | — | |
| `__init__.py` | — | P2·批次 | — | 路由聚合，无单独 BUG 行 |
---
## 2. `server/` 其他（BUG 专项已触及）
| 文件 | Phase 2/3 | BUG 专项 | 说明 |
|------|-----------|----------|------|
| `background/schedule_runner.py` | P2·2d | **BUG·全文** B2 | once 回滚已修 |
| `background/retry_runner.py` | P2·2d | **BUG·全文** B3 | 重试分类已修 |
| `background/heartbeat_flush.py` | P2·2d | **BUG·节选** B4/B5 | flush 批量提交 |
| `background/self_monitor.py` | P2·2d | **BUG·全文** B5 | |
| `background/script_execution_flush.py` | P2·2g/2i | **BUG·全文** B6 | |
| `application/services/auth_service.py` | P2·2b | **BUG·节选** B2/B6 | refresh 重用 B6 已修 |
| `application/services/sync_engine_v2.py` | P2·2b 矩阵 | **BUG·节选** B2/B3 | gather 计数 B3 |
| `application/services/script_job_callback.py` | P2·2g | **BUG·全文** B1 | |
| `application/services/files_browse_service.py` | P2·2b/服务 | **BUG·节选** B4/5 | invalidate 辅助 |
| `infrastructure/redis/script_execution_store.py` | P2·2g | **BUG·节选** B2 | stuck/flush 段 |
**`server/` 其余**（`application/services/*` 其它、`infrastructure/*`、`domain/*`、`main.py`、`config.py` 等，约 50+ 文件）：Phase 2b–2d **批次走读**；**BUG 专项 0 文件全文**。
---
## 3. `frontend/src/pages/`（14）
| 页面 | Phase 2/3 | BUG 专项 | 说明 |
|------|-----------|----------|------|
| `PushPage.vue` | P3·目录 | **BUG·关联** B4 `usePushProgress` | 页面本身未单独 Read |
| `FilesPage.vue` | P3·目录 | **BUG·关联** B6 `useFilesBrowse` + store | 组合逻辑在 composable |
| `DashboardPage.vue` | P3·目录 | **BUG·节选** B3 | 仅 stats 加载段 |
| `TerminalPage.vue` | P3·目录 | **BUG·关联** B2 `useTerminalSessions` | |
| `LoginPage.vue` | P3·目录 | — | |
| `ServersPage.vue` | P3·目录 | — | |
| `ScriptsPage.vue` | P3·目录 | — | |
| `CommandsPage.vue` | P3·目录 | — | |
| `SchedulesPage.vue` | P3·目录 | — | |
| `SettingsPage.vue` | P3·目录 | — | |
| `AuditPage.vue` | P3·目录 | — | |
| `AlertsPage.vue` | P3·目录 | — | |
| `CredentialsPage.vue` | P3·目录 | — | |
| `RetriesPage.vue` | P3·目录 | — | |
**`frontend/src` 其它**（composables/components 等 ~91 文件）：Phase 3 **目录 grep + 5 个代表全文**；BUG 专项仅 **~8 个路径**（见 Batch 2/4/6 报告）。
---
## 4. BUG 专项 Batch 1–6 文件清单（去重）
| Batch | 文件（路径） | 深度 |
|-------|----------------|------|
| 1 | `install.py`, `web/app/install.html`, `script_job_callback.py`, `agent.py`, `servers.py`（节选） | 全文/节选 |
| 2 | `schedule_runner.py`, `auth_service.py`（节选）, `sync_engine_v2.py`（节选）, `script_execution_store.py`（节选）, `useTerminalSessions.ts` | 节选为主 |
| 3 | `retry_runner.py`, `sync_engine_v2.py`, `servers.py`（stats）, `files_browse_service.py`, `DashboardPage.vue`（节选） | |
| 4 | `sync_v2.py`（节选）, `files.py`, `heartbeat_flush.py`, `usePushProgress.ts`, `schemas.py`（节选） | |
| 5 | `agent.py`（TTL）, `heartbeat_flush.py`, `sync_v2.py`（写路径）, `self_monitor.py`, `files_browse_service.py` | |
| 6 | `auth_jwt.py`, `auth_service.py`（refresh）, `script_execution_flush.py`, `useFilesBrowse.ts`, `files.ts` | |
**合计去重约 25 个路径**（含节选重复计 1 次）。
---
## 5. 结论（2026-06-04 更新 — 全量扫描已签退）
**此前缺口（Batch 1–6 仅 ~25 路径）已由全量排期补齐。**
| 状态 | 说明 |
|------|------|
| **BUG 全量扫描** | B0 登记册 + **B7–B77** 共 71 批；`must_audit` **283/283** `done`（`read_range` 1..N） |
| **节选重读** | `servers.py`、`sync_v2.py`、`script_service.py`、`useTerminalSessions.ts` 等 `needs_full_rescan` → **0** |
| **构建产物** | `web/app/assets/**` 2773 文件 → `covered-by-frontend-src` + [B-Assets 门控](audit-bug-assets-gate-2026-06-04.md) |
| **排除** | `scripts/sedul3hFb`、`docker/.env`（本地密钥，审 `docker/.env.example`） |
| **OPEN P0/P1** | **0**（Batch 7–77 本轮无新增；Batch 1–6 已修项保留） |
签退文档：[`audit-bug-scan-closure-2026-06-04.md`](audit-bug-scan-closure-2026-06-04.md)
机器可读 SSOT：[`docs/audit/2026-06-04-bug-scan-registry.json`](../audit/2026-06-04-bug-scan-registry.json)
---
## 6. 历史建议顺序（已由 B7–B77 执行完毕，归档）
| 原优先级 | 范围 | 现状态 |
|----------|------|--------|
| P0 | `webssh.py` 全文 | B9 |
| P0 | `servers.py` 全文 | B7-R |
| P1 | `sync_v2.py` 全文 | B8-R |
| P1 | `scripts.py` + `script_service.py` | B10 / B17-R |
| P2 | `frontend/src/pages/*.vue` | B35–B37 |
| P2 | `terminal.py`、`settings.py`、`search.py` | B9 / B10 |
---
## 7. 交叉引用
| 文档 | 路径 |
|------|------|
| Phase 2 矩阵 | `docs/reports/audit-phase-2-findings-matrix.md` |
| Phase 3 前端 | `docs/reports/audit-phase-3-frontend-line-walk.md` |
| Phase 闭环声明 | `docs/reports/audit-phase-3-full-closure-2026-06-04.md` |
| BUG Batch 1–6 | `docs/reports/audit-bug-line-walk-2026-06-04-batch{1..6}.md` |
| BUG Batch 7–77 | `docs/reports/audit-bug-line-walk-2026-06-04-batch{7..77}.md` |
| **BUG 全量登记册** | `docs/audit/2026-06-04-bug-scan-registry.json` |
| **BUG 全量签退** | `docs/reports/audit-bug-scan-closure-2026-06-04.md` |
| B-Assets 门控 | `docs/reports/audit-bug-assets-gate-2026-06-04.md` |
| Phase 登记册（历史） | `docs/audit/2026-06-04-full-line-walk-registry.md` |
---
*更新: 2026-06-04 · BUG 全量签退 · pytest 154 passed · ruff 全绿*
docs/reports/audit-bug-scan-closure-2026-06-04.md
+75
View File
@@ -0,0 +1,75 @@
# 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`）。
docs/reports/audit-frontend-14p-2026-06-04-closure.md
+50
View File
@@ -0,0 +1,50 @@
# 前端 14 页分批深审 — 总 Closure
**日期**: 2026-06-04
**范围**: `frontend/src/pages/*Page.vue` 全部 14 页
**总行数**: 4112
## 批次索引
| 批次 | 页面 | 报告 | H |
|------|------|------|---|
| 1/3 | Dashboard, Servers, Terminal, Files, Push | [batch1](audit-frontend-14p-2026-06-04-batch1.md) | 14 |
| 2/3 | Scripts, Credentials, Schedules, Retries, Commands | [batch2](audit-frontend-14p-2026-06-04-batch2.md) | 15 |
| 3/3 | Alerts, Audit, Settings, Login | [batch3](audit-frontend-14p-2026-06-04-batch3.md) | 14 |
| **合计** | **14 页** | | **43** |
## 跨页 RISK（已接受，不重复开 FINDING）
| 项 | 页面 | 文档 |
|----|------|------|
| WS query JWT | Terminal, Push（composable） | risk-acceptance-single-operator.md |
| 临时命令 exec | ScriptsPage | 后端 check_dangerous_command |
| bing-wallpaper 公开 GET | Login, Dashboard | 后端只读缓存 |
## 编排页说明
| 页 | 行数 | 逻辑位置 |
|----|------|----------|
| FilesPage | 38 | `useFilesPage` + D5 composables |
| PushPage | 106 | `usePushPage` + D4 composables |
| TerminalPage | 408 | 页内 UI + `useTerminalSessions` |
页壳已全文 Read；Sink 在 composable 层另有 D4/D5/P2 深审。
## DoD
- [x] 14 页每页 1–N 全文 Read
- [x] 3 批 8 步报告 + 本 closure
- [x] 0 P0/P1 新 FINDING
- [x] Playwright E2E 15 路由已绿（L4）
## 增量审计（2026-06-06）
凭据轮询 / pending servers + 预设 `username`：[2026-06-06-frontend-14p-contract-audit.md](2026-06-06-frontend-14p-contract-audit.md) — 契约 **PASS**，0 新 P0/P1。
## 验证
```bash
bash scripts/local_verify.sh
cd frontend && NEXUS_E2E_BASE=http://127.0.0.1:8600 npm run test:e2e
```
docs/reports/audit-phase-4-plugin-closure-2026-06-04.md
+58
View File
@@ -0,0 +1,58 @@
# Phase 4 — 插件驱动审计收尾 Closure
**日期**: 2026-06-04
**计划**: `.cursor/plans/插件驱动审计验证_5bf6bf55.plan.md`
## 完成矩阵
| 阶段 | 内容 | 状态 | 证据 |
|------|------|------|------|
| Phase 0 | local_verify 基线 + npm 代理文档 | ✅ | `docs/changelog/2026-06-04-npm-proxy-mysql-mcp.md` |
| Phase 1 | D1–D8 delta 审计 | ✅ | `audit-delta-2026-06-04-waveD*.md` |
| Phase 2 | P2-1～P2-9 深审 | ✅ | `audit-phase2-2026-06-04-waveP2-*.md` |
| L2b | local_verify | ✅ | 每波全绿 |
| L2c | pytest 157 | ✅ | 2026-06-04 |
| L3 | pre_deploy_check | ⚠️ Gate7 需 commit 后复验 | `docs/audit/2026-06-04-plugin-audit-gate7-closure.md` |
| L4 | Playwright 本地 55/55 | ✅ | `docs/changelog/2026-06-04-l4-local-playwright-pass.md` |
| L5 | 生产部署 | ❌ 未执行 | 需用户批准 |
## 前端 14 页覆盖（SSOT）
**专用深审**: `docs/reports/audit-frontend-14p-2026-06-04-closure.md`
| 批次 | 页面 | H |
|------|------|---|
| batch1 | Dashboard, Servers, Terminal, Files, Push | 14 |
| batch2 | Scripts, Credentials, Schedules, Retries, Commands | 15 |
| batch3 | Alerts, Audit, Settings, Login | 14 |
| **合计 14 页 / 4112 行** | | **43** |
## FINDING 汇总
| 级别 | 新增（本计划） | 已接受 RISK |
|------|----------------|-------------|
| P0/P1 | **0** | WS query JWT、Agent global key、sshpass |
| P2 | 0 待修 | install-deps 包名 questing 差异 |
## 插件使用记录
| 插件 | 用途 | 状态 |
|------|------|------|
| mysql-mcp | 项目配置 | 可用 |
| Playwright CLI | L4 E2E | ✅ 55 pass |
| Playwright MCP | 浏览器 | errored，CLI 替代 |
| Chainguard | 镜像扫描 | 用户跳过 |
| security-reviewer | 各波 H 扫描 | 报告内 Closure |
## DoD
- [x] Phase 1 + Phase 2 全波报告
- [x] 14 页前端 closure
- [x] L4 本地验收
- [x] Gate7 审计清单文件
- [ ] L5 生产（可选）
## 下一步
1. `git add` + commit 工作区 → 复跑 `pre_deploy_check.sh`
2. 用户批准 → L5 SSH 部署 + 生产 smoke
docs/reports/audit-plugin-run-final-2026-06-04.md
+52
View File
@@ -0,0 +1,52 @@
# 插件驱动审计 — 最终验收报告
**日期**: 2026-06-04
**计划**: 插件驱动审计验证（Phase 0 → L4）
## 执行摘要
| 维度 | 结果 |
|------|------|
| Phase 1 Delta D1–D8 | ✅ 135 H，0 P0/P1 |
| Phase 2 后端 P2-1～P2-6 | ✅ 107 H，0 P0/P1 |
| 前端 14 页 3 批深审 | ✅ 4112 行，43 H，0 P0/P1 |
| L2b local_verify | ✅ |
| L2c pytest | ✅ **157 passed** |
| L3 pre_deploy_check | ✅ **7/7**（Lint/Security 系统 PATH skip；.venv 内 ruff/bandit 可过） |
| L4 Playwright | ✅ **55/55**（1 项 SSH 跳过） |
| L5 生产部署 | ❌ 未执行（需用户批准） |
## 报告索引
| 类型 | 路径 |
|------|------|
| Phase1 汇总 | `docs/reports/audit-delta-2026-06-04-waveD8-closure.md` |
| Phase2 | `docs/reports/audit-phase2-2026-06-04-waveP2-*.md` |
| 前端 14 页 SSOT | `docs/reports/audit-frontend-14p-2026-06-04-closure.md` |
| 插件收尾 | `docs/reports/audit-phase-4-plugin-closure-2026-06-04.md` |
| Gate7 | `docs/audit/2026-06-04-plugin-audit-gate7-closure.md` |
| Registry | `docs/audit/2026-06-04-bug-scan-registry.json` → `delta_waves[]` |
## 复验命令（2026-06-04 末轮）
```bash
bash scripts/local_verify.sh # OK
.venv/bin/pytest tests/ -q # 157 passed
bash deploy/pre_deploy_check.sh # 7/7 PASS
python3 scripts/run_nexus_acceptance.py \
--base http://127.0.0.1:8600 --with-ui # 55 pass
```
## L5 部署前置（待用户说「部署」）
```bash
git add ... && git commit ... && git push origin main
bash deploy/pre_deploy_check.sh
bash deploy/deploy-production.sh
curl -s https://api.synaglobal.vip/health # 预期 ok
curl -s -o /dev/null -w "%{http_code}" https://api.synaglobal.vip/app/ # 200
```
## 结论
本地审计与验收链路 **全部 closure**；唯一待办为 **L5 生产部署**（需 SSH + git push 权限与用户明确批准）。