feat(ota): 实现GD32 OTA包间背压机制，优化传输节奏控制

移除固定的包间延迟配置 `OTA_PACKET_DELAY_MS`，采用基于SPI Link v2 CREDIT背压的动态节奏控制，在SpiMaster中通过remoteCredit==0时wait/拒发实现流量控制，提高OTA传输稳定性。 refactor(stack): 统一任务栈大小配置并添加CPU统计功能 - 在app_config.h中集中定义所有任务栈大小常量，基于实测水位优化分配 - 新增monitor/cpu_stats.cpp组件，提供1Hz FreeRTOS CPU占用采样 - 更新main.cpp中的任务创建使用新的栈大小常量 - 调整health_monitor和ota_relay等任务的栈分配 perf(ota): 改进ESP32和GD32 OTA分区预擦策略 - ESP32 OTA从边写边擦改为整分区预擦模式，避免写入时的扇区擦除阻塞 - GD32 OTA在prepare阶段进行整分区预擦，提升后续写入吞吐量 - 优化OTA协调器状态管理，修复FINALIZING状态残留问题 fix(log): 改进UDP日志发送的堆内存管理 - 当堆内存不足时记录UDP发送跳过的告警信息到ring buffer - 降低UDP发送跳过的内存阈值从10KB到6KB - 降低日志排水最小内存阈值从8KB到4KB docs(readme): 更新OTA配置参数文档说明移除已废弃的OTA_PACKET_DELAY_MS参数，更新包间节奏控制说明为基于CREDIT背压机制的描述。
2026-07-16 01:24:12 +08:00
parent a47a027178
commit 51c89b3065
52 changed files with 1006 additions and 628 deletions
@@ -1,17 +1,16 @@
 /**
 * connection.js - 连接管理 + 系统状态显示
 *
- * 从 app.js 的「连接管理」段 + testConnection / refreshSystemStatusNow 提取。
 * 操作 DOM 元素 #pillConn / #pillConnTxt / #connStatus / #connStatusTxt / #bConn 等。
 *
- * 共享状态（通过 window.* 引用，后续 app.js 拆分时会统一挂载）：
+ * 共享状态（通过 window.* 引用）：
 *   window.latestSystemStatus     — 最近一次 /system/status 响应
 *   window.lastSysStateCode       — 上次成功的 sys_state_code（polling.js 读取）
 *   window.lastRelayState         — 上次成功的 relay_state（polling.js 读取）
 *   window.consecutivePollFailures — 连续轮询失败计数（polling.js 读取）
 *
- * 未拆分的 app.js 函数（通过 window.* 引用）：
- *   window.getBaseUrl / window.updateSystemStatusUi / window.diagnoseNetwork / window.formatPercent
+ * 复用的函数（通过 window.* 引用）：
+ *   window.getBaseUrl / window.updateSystemStatusUi / window.formatPercent
 */
 import { formatBytes, formatTime, formatUptime, escapeHtml } from './utils.js';
 import { addLog } from './log.js';
@@ -51,15 +50,18 @@ export function updateHealthUi(healthCode, freeHeap) {
    mh.className = 'v ' + (healthCode === 0 ? 'ok' : healthCode === 1 ? 'warn' : 'err');
  }
 }
+/**
+ * 每次 pollStatus 成功后刷新堆/栈/CPU（固定周期约 1000ms，中继期 400ms；
+ * sample_ms 由设备两次采样墙钟差给出；WiFi 上传 ESP32 期间 pause 不刷）。
+ */
 export function updateHeapAndTaskStatusUi(data) {
  if (!data) return;
  var ota = data.ota || {};
-  var wifi = data.wifi || {};
-  var targetHost = window.getBaseUrl().replace(/^http:\/\//, '');
  var setText = function (id, value) {
    var el = document.getElementById(id);
    if (el) el.textContent = value;
  };
+
  // ---- 堆概况：已用 / 总计 + 占用条 ----
  function setFill(id, pct) {
    var el = document.getElementById(id);
@@ -85,10 +87,10 @@ export function updateHeapAndTaskStatusUi(data) {
    el.style.width = safePct + '%';
    el.className = 'heap-bar-fill cpu-fill' + (safePct >= 85 ? ' danger' : safePct >= 70 ? ' warn' : '');
  }
-  function updateCpuUsageUi(cpu) {
-    cpu = cpu || {};
+  function updateCpuUsageUi(cpuData) {
+    cpuData = cpuData || {};
    var taskList = document.getElementById('cpuTaskList');
-    if (!cpu.available) {
+    if (!cpuData.available) {
      setText('cpuUsageText', '未启用 FreeRTOS 统计');
      setText('cpuUsagePct', '--');
      setText('cpuIdlePct', '--');
@@ -98,7 +100,7 @@ export function updateHeapAndTaskStatusUi(data) {
      if (taskList) taskList.innerHTML = '<div class="status-empty">固件未启用 CPU runtime stats</div>';
      return;
    }
-    if (!cpu.valid) {
+    if (!cpuData.valid) {
      setText('cpuUsageText', '等待下一次采样...');
      setText('cpuUsagePct', '--');
      setText('cpuIdlePct', '--');
@@ -108,10 +110,10 @@ export function updateHeapAndTaskStatusUi(data) {
      if (taskList) taskList.innerHTML = '<div class="status-empty">首次刷新只建立基线，下一次刷新后显示 CPU 占用</div>';
      return;
    }
-    var usagePct = Number(cpu.usage_pct) || 0;
-    var idlePct = Number(cpu.idle_pct) || 0;
-    var sampleMs = Number(cpu.sample_ms) || 0;
-    var tasks = Array.isArray(cpu.tasks) ? cpu.tasks.slice() : [];
+    var usagePct = Number(cpuData.usage_pct) || 0;
+    var idlePct = Number(cpuData.idle_pct) || 0;
+    var sampleMs = Number(cpuData.sample_ms) || 0;
+    var tasks = Array.isArray(cpuData.tasks) ? cpuData.tasks.slice() : [];
    tasks.sort(function (a, b) {
      return (Number(b.usage_pct) || 0) - (Number(a.usage_pct) || 0);
    });
@@ -159,7 +161,6 @@ export function updateHeapAndTaskStatusUi(data) {

  setText('sOtaState', (ota.sys_state || '--') + (Number.isFinite(ota.sys_state_code) ? ' (' + ota.sys_state_code + ')' : ''));
  setText('sRelayState', Number.isFinite(ota.relay_state) ? String(ota.relay_state) : '--');
-  // 缓存最近一次成功的 sys_state_code / relay_state，供 pollStatus 失败时判断设备是否在忙
  if (Number.isFinite(ota.sys_state_code)) window.lastSysStateCode = ota.sys_state_code;
  if (Number.isFinite(ota.relay_state)) window.lastRelayState = ota.relay_state;
  var storedText = '--';
@@ -205,6 +206,45 @@ export function updateHeapAndTaskStatusUi(data) {
    statusJson.textContent = JSON.stringify(data, null, 2);
  }
 }
+/** 从设备 IP 推导网关 IP（取前三段 + .1） */
+function getGatewayIp() {
+  var parts = (window.getEspIp ? window.getEspIp() : '192.168.31.127').split('.');
+  if (parts.length === 4) return parts[0] + '.' + parts[1] + '.' + parts[2] + '.1';
+  return '192.168.31.1';
+}
+
+/**
+ * 网络诊断：区分浏览器离线 / 网关不通 / 仅设备不通。
+ * 放在 connection.js，避免与 polling.js 形成循环 import。
+ */
+export async function diagnoseNetwork() {
+  var result = [];
+  if (navigator.onLine === false) {
+    result.push('浏览器无网络连接');
+    return result.join('；');
+  }
+  var gwIp = getGatewayIp();
+  var gwOk = false;
+  try {
+    await fetch('http://' + gwIp + '/', { mode: 'no-cors', signal: AbortSignal.timeout(2000) });
+    gwOk = true;
+  } catch (_) {}
+  if (!gwOk) {
+    try {
+      await fetch('http://' + gwIp + '/favicon.ico', { mode: 'no-cors', signal: AbortSignal.timeout(1500) });
+      gwOk = true;
+    } catch (_) {}
+  }
+  if (!gwOk) {
+    result.push('网关 ' + gwIp + ' 不可达（本地网络不通）');
+  } else {
+    result.push('网关 ' + gwIp + ' 可达');
+    var espIp = window.getEspIp ? window.getEspIp() : '设备';
+    result.push('设备 ' + espIp + ' 不响应（可能断电、重启中或 WiFi 断开）');
+  }
+  return result.join('；');
+}
+
 /** @description 测试与 ESP32 的连接（GET /status）。 */
 export async function testConnection() {
  // 立即发一次请求检测
@@ -232,7 +272,7 @@ export async function testConnection() {
  } catch (e) {
    addLog('E', '连接', '连接失败: ' + e.message);
    // 连接失败时自动诊断
-    var diag = await window.diagnoseNetwork();
+    var diag = await diagnoseNetwork();
    addLog('W', '诊断', diag);
    showToast('无法连接: ' + diag, 'error');
  } finally {
@@ -1,7 +1,7 @@
 /**
 * log.js - 日志系统（带去重 + 自动滚动）
 *
- * 从 app.js 提取的日志环形缓冲、去重、过滤、自动滚动逻辑。
+ * 日志环形缓冲、去重、过滤、自动滚动逻辑。
 * 操作 DOM 元素 #logScroll / #logCount / #autoScrollBtn / .log-filter。
 */
 import { formatTime } from './utils.js';
@@ -1,14 +1,13 @@
 /**
 * polling.js - 轮询状态 + Page Visibility 补偿 + ESP32 实时日志拉取
 *
- * 从 app.js 的「轮询状态」「Page Visibility 补偿」「ESP32 实时日志拉取 (增量)」段提取。
 * 递归 setTimeout 调度 /system/status + setInterval 调度 /logs，避免 setInterval 慢响应被 abort。
 *
 * 模块级状态（仅本模块使用，不导出）：
 *   statusTimerId / logsTimerId / statusAbortCtrl / statusPollInFlight / statusPollIntervalMs
- *   lastDiagTime / diagResult / uploadPollChip / lastLogTimestamp / pageVisible
+ *   uploadPollChip / lastLogTimestamp / pageVisible
 *
- * 共享状态（通过 window.* 引用，后续 app.js 拆分时会统一挂载）：
+ * 共享状态（通过 window.* 引用）：
 *   window.pollingPausedForUpload   — 上传期间暂停轮询标志
 *   window.consecutivePollFailures  — 连续轮询失败计数（connection.js 也写入）
 *   window.lastSysStateCode         — 上次成功的 sys_state_code（connection.js 写入）
@@ -21,7 +20,7 @@
 *   window.activeUploadChip         — 当前上传目标芯片
 *   window.currentOtaTarget         — 当前 OTA 目标
 *
- * 未拆分的 app.js 函数（通过 window.* 引用）：
+ * 复用的函数（通过 window.* 引用）：
 *   window.getEspIp / window.getBaseUrl
 *   window.updateSystemStatusUi / window.updateEsp32StagesFromPhase
 *   window.applyRebootingRuntimeState / window.applyDisconnectedRuntimeState / window.applyUploadingRuntimeState
@@ -30,7 +29,7 @@
 */
 import { addLog } from './log.js';
 import { showToast } from './toast.js';
-import { updateConnectionUi } from './connection.js';
+import { updateConnectionUi, diagnoseNetwork } from './connection.js';

 // ==================== 轮询状态 ====================
 // 共享状态（初始化到 window，供 connection.js 等其他模块读写）
@@ -41,66 +40,32 @@ window.lastRelayState = 0;     // 上次成功的 relay_state
 // 模块级状态（仅本模块使用）
 var statusTimerId = null;
 var logsTimerId = null;
-var lastDiagTime = 0;       // 上次诊断时间
-var diagResult = '';        // 最近一次诊断结果
 var statusAbortCtrl = null;  // 当前 /system/status 请求的 AbortController（3s 超时用）
-var statusPollIntervalMs = 1000;  // 状态轮询目标间隔
+var statusPollIntervalMs = 1000;  // 状态轮询目标间隔（中继期可由 setStatusPollIntervalMs 降到 400ms）
 var statusPollInFlight = false;   // 是否正在请求 /system/status，防止重叠
 var pageVisible = !document.hidden;   // 页面可见性：切到后台/最小化/切标签会变 false
 var uploadPollChip = null; // 当前暂停轮询的上传目标，用于区分 WiFi/日志策略

-// 从设备 IP 推导网关 IP（取前三段 + .1）
-function getGatewayIp() {
-  var parts = window.getEspIp().split('.');
-  if (parts.length === 4) return parts[0] + '.' + parts[1] + '.' + parts[2] + '.1';
-  return '192.168.31.1';
-}
-// 网络诊断：区分浏览器离线 / 网关不通 / 仅设备不通
-async function diagnoseNetwork() {
-  lastDiagTime = Date.now();
-  var result = [];
-  // 1) 浏览器是否在线
-  if (navigator.onLine === false) {
-    result.push('浏览器无网络连接');
-    diagResult = result.join('；');
-    return diagResult;
-  }
-  // 2) 尝试触达网关（超时 2s）
-  var gwIp = getGatewayIp();
-  var gwOk = false;
-  try {
-    await fetch('http://' + gwIp + '/', { mode: 'no-cors', signal: AbortSignal.timeout(2000) });
-    gwOk = true; // no-cors 模式下不抛异常即视为可达
-  } catch (_) {}
-  if (!gwOk) {
-    // 再试一次 favicon（有些路由器不响应 /）
-    try {
-      await fetch('http://' + gwIp + '/favicon.ico', { mode: 'no-cors', signal: AbortSignal.timeout(1500) });
-      gwOk = true;
-    } catch (_) {}
-  }
-  if (!gwOk) {
-    result.push('网关 ' + gwIp + ' 不可达（本地网络不通）');
-  } else {
-    result.push('网关 ' + gwIp + ' 可达');
-    // 3) 网关通但设备不通 → 设备自身问题
-    result.push('设备 ' + window.getEspIp() + ' 不响应（可能断电、重启中或 WiFi 断开）');
-  }
-  diagResult = result.join('；');
-  return diagResult;
+/**
+ * 调整 /system/status 目标间隔。GD32 中继期用 400ms 缩小「转发 N/M」相对设备日志的滞后；
+ * 结束后恢复 1000ms，避免常态堆/栈卡片过刷。
+ */
+export function setStatusPollIntervalMs(ms) {
+  var n = Number(ms);
+  if (!Number.isFinite(n) || n < 200) n = 1000;
+  if (n > 5000) n = 5000;
+  statusPollIntervalMs = n;
 }
+
 /** @description 调度下一次 /system/status 轮询（递归 setTimeout）。
- *  上一次请求完成（或 3s 超时）后才调度下一次，避免 setInterval 把慢响应
- *  直接 abort 而导致堆/任务栈/CPU 等卡片刷新率不稳。
+ *  默认 delay = statusPollIntervalMs；pollStatus 完成后会按「固定周期」
+ *  传入 max(0, interval - 本轮耗时)，使 CPU 采样窗口 sample_ms ≈ interval，
+ *  而不是「完成后 + interval」（会稳定偏到 1100+ ms）。
+ *  仍保证 in-flight 不重叠，避免 setInterval 慢响应被 abort。
 */
 export function scheduleStatusPoll(delayMs) {
  if (statusTimerId) clearTimeout(statusTimerId);
-  // 中继期加快：进度条依赖 status.relay_seq，1s 间隔体感像卡死
  var interval = statusPollIntervalMs;
-  // 防御性守卫：window.OtaSessionState 可能尚未挂载（模块加载早期），此时不加速
-  if (window.OtaSessionState && window.otaSessionState === window.OtaSessionState.RELAYING) {
-    interval = Math.min(interval, 400);
-  }
  statusTimerId = setTimeout(function() {
    statusTimerId = null;
    pollStatus();
@@ -161,8 +126,9 @@ export async function pollStatus() {
  // 递归 setTimeout 调度，正常情况下不会重叠；做个保险避免并发请求
  if (statusPollInFlight) return;
  statusPollInFlight = true;
+  var pollStartedAt = Date.now();
  statusAbortCtrl = new AbortController();
-  var pollTimer = setTimeout(function() { try { statusAbortCtrl.abort(); } catch(_e) {} }, 3000);
+  var pollTimer = setTimeout(function() { try { statusAbortCtrl.abort(); } catch(_e) {} }, 5000);
  try {
    var resp = await fetch(window.getBaseUrl() + '/system/status', {
      signal: statusAbortCtrl.signal
@@ -287,7 +253,13 @@ export async function pollStatus() {
    }
  } finally {
    statusPollInFlight = false;
-    scheduleStatusPoll();
+    statusAbortCtrl = null;
+    /* 固定周期调度：interval 从本轮开始计时扣减请求耗时。
+     * 旧逻辑「完成后 + 1000ms」→ 窗口稳定 1100+；现 sample_ms 贴近 1000/400。
+     * 本轮超时/很慢时 delay=0，立即补下一轮，仍不重叠。 */
+    var elapsed = Date.now() - pollStartedAt;
+    var delay = Math.max(0, statusPollIntervalMs - elapsed);
+    scheduleStatusPoll(delay);
  }
 }
 // 注意：startPoll() 由入口模块（app.js / ble_ota.js）在所有模块加载完成后调用，
@@ -316,7 +288,7 @@ export async function pollLogs() {
  // ★ ESP32 上传期间也允许日志轮询
  try {
    var resp = await fetch(window.getBaseUrl() + '/logs', {
-      signal: AbortSignal.timeout(2000)
+      signal: AbortSignal.timeout(5000)
    });
    if (!resp.ok) return;
    var logs = await resp.json();
@@ -338,6 +310,18 @@ export async function pollLogs() {
          showToast('ESP32 已恢复在线', 'success');
          if (window.otaSessionState === window.OtaSessionState.REBOOTING) window.otaSessionTransition(window.OtaSessionState.DONE);
        }
+        /*
+         * 设备已报「全部数据包已转发」时，立刻补 UI 100% 进度。
+         * status 轮询可能仍停在旧 relay_seq，否则会出现 FINISH 日志之后还刷 94%。
+         */
+        if (m[2] === 'OTA' && /全部数据包已转发/.test(m[3]) &&
+            typeof window.emitRelayProgress === 'function') {
+          var otaSnap = (window.latestSystemStatus && window.latestSystemStatus.ota) || {};
+          var tot = Number(otaSnap.relay_total_packets) || 0;
+          if (tot > 0) {
+            window.emitRelayProgress(tot, tot, { force100: true });
+          }
+        }
      } else {
        addLog('I', 'ESP32', line.trimEnd());
      }
@@ -1,7 +1,7 @@
 /**
 * toast.js - Toast 提示组件
 *
- * 从 app.js 提取的 showToast 函数，操作 DOM 元素 #toast / #toastIco / #toastMsg。
+ * showToast 函数，操作 DOM 元素 #toast / #toastIco / #toastMsg。
 * 支持 info / success / warning / error 类型，内置 5s 去重防抖。
 */
 /** @description 显示 Toast 提示消息，支持 info/success/warning/error 类型。 */
@@ -1,7 +1,7 @@
 /**
 * utils.js - 通用工具函数
 *
- * 从 app.js 提取的格式化 / 转义工具函数，供各子模块和 can.js / can_monitor.js 共享。
+ * 格式化 / 转义工具函数，供各子模块和 can.js / can_monitor.js 共享。
 */
 // ==================== 工具函数 ====================
 /** @description 格式化字节大小为人类可读字符串（B/KB/MB）。 */