chore(release): v3.3.1

### 🛠 修复
- 修复了看板业务流量趋势与 Zone 已提供数据口径不一致的问题，业务量统一由访问日志聚合，避免边缘预聚合窗口差分导致近 24 小时趋势严重偏低。
- 修复了节点地图在缺少精确经纬度时，将香港、新加坡、台湾等地区错误回退到南美等占位坐标的问题，补全质心数据并改进复合地名匹配。

### ⚡️ 优化与改进
- 重构边缘可观测模型：访问日志为业务唯一真相，Agent 仅上报明细、主机指标与 OpenResty 健康连接；新增 edge_health 与 access_log_hourly，删除请求预聚合与 OpenResty 吞吐路径。
- 协议去掉旧兼容层，Agent 升级需销毁重建或二进制替换；旧本地观测缓冲会自动删除并在运行中重建。
- 调整 Agent 默认心跳为 3 秒、离线判定为 60 秒、离线补传窗口为 60 分钟，使节点状态与观测数据刷新更及时。
- 看板 UV 改为窗口内真正去重，Zone 分桶 UV 明确不可跨桶相加；网络趋势仅保留已提供/接收数据，磁盘读写改为按秒速率展示。
- Pages 支持多压缩格式上传、URL 导入部署包，以及可配置的包大小上限与历史保留数量；边缘按项目只保留最新激活部署，切换版本无需重发主配置。
- 新建代理规则时可选择直连、隧道或 Pages 源站类型，与详情页一致。
- 优化 Pages 部署包校验性能，不再为包内每个文件计算哈希，改由整包校验和保障完整性。

### 💄 其他/体验
- 更新可观测设计文档与运维说明，明确健康状态权威源与升级策略。
- 同步 Swagger 与变更日志，便于对照 API 与发布说明。

docs/changelog/index.md

@@ -21,40 +21,33 @@ sidebar: false
 
 ## [unreleased]
 
+## [v3.4.0] - 2026-07-18
+
 ### 新增
 
 - Pages 现支持上传 zip、tar.gz、tar.xz、tar.bz2、tar、7z 等常用压缩格式的部署包。
 - 管理员可在运维设置中配置 Pages 部署包大小上限与每个项目的历史部署保留数量。
+- Pages 支持从 URL 导入部署包：填写下载链接后由控制面代为拉取并创建部署。
+- 观测存储新增 `of_node_edge_health` 与 `of_access_log_hourly`，业务趋势优先读访问日志小时汇总。
+- 访问日志增加 `request_length` / `request_time_ms`，用于接收数据与耗时统计。
 
 ### 修复
 
-- 修复数据看板「OpenResty 入站/出站」近 24 小时趋势严重偏低的问题：边缘侧改为上报进程累计字节，并与访问日志中的已提供数据（响应体字节）口径对齐，避免按 60 秒窗口计数做差分导致流量被大量丢弃。
+- 修复数据看板业务流量趋势与已提供数据口径不一致的问题：业务量统一由访问日志聚合，避免边缘预聚合窗口差分导致趋势偏低。
+- 修复节点地图在缺少精确经纬度时，把香港/新加坡/台湾等地区错误标到占位坐标（例如南美）的问题。
 
 ### 变更
 
-- Agent 离线观测补传默认保留窗口由 15 分钟调整为 60 分钟，断线恢复后可补报更长时间范围内的访问与指标数据。
-- Agent 默认心跳/上报间隔由 10 秒调整为 3 秒，节点离线判定默认阈值由 120 秒调整为 60 秒，状态与观测数据刷新更及时。
-- 边缘观测按「访问日志为业务唯一真相」收敛：Agent 上报访问明细、主机指标与 OpenResty 健康/连接，不再上报业务预聚合；看板请求趋势与已提供/接收数据改由访问日志聚合，宿主机网卡单独展示。
-- 本机 `/openflare/observability` 改为返回探活与当前连接快照；访问日志增加 `request_length` / `request_time_ms` 字段用于接收数据与耗时统计。
-- 看板全局 UV 改为窗口内真正去重；状态码/Top 域名分布与节点行请求量均改为访问日志聚合；网络趋势 API 增加 `bytes_provided` / `bytes_received` 字段。
-- 观测协议与 API 去掉兼容层（Agent 销毁重建升级）：心跳仅 `host_metrics` / `edge_health` / `access_logs` / `buffered`；管理端不再返回 `traffic_reports` 与 `openresty_rx|tx`；网络趋势仅 `bytes_provided` / `bytes_received` + 宿主机网卡。
-- 观测存储 M5：新增 `of_node_edge_health` 与 `of_access_log_hourly`；移除已废弃的请求预聚合表与 OpenResty 吞吐观测表，业务趋势优先读访问日志小时汇总。
-- 观测清理目标对齐为 `node_edge_health`；边缘健康完整写入 status；提供历史小时汇总回填 SQL。
-- 看板与节点 UV 文案改为「24h / 查询窗口独立访客」（整窗 `uniqExact`）；小时趋势图仅展示请求/错误，不绘分时 UV。
-- Agent 二进制替换升级时，若本地观测补传缓冲仍是旧格式或损坏，则直接删除该文件并在运行中重建，避免半迁移数据或阻塞心跳。
-- Zone 流量图：顶部独立访客为整窗去重；曲线标明为分桶 UV（桶内去重，不可跨桶相加）。
-- 明确 OpenResty 健康权威：当前 status/message 以节点表为准，ClickHouse 仅存 status 与连接时序（不含 message）。
-- 看板与节点观测不再展示或采集宿主机网卡入/出站；网络趋势仅保留访问日志的已提供/接收数据。
-- 宿主机磁盘读/写趋势改为按小时速率（B/s）展示，摘要为近 24 小时平均速率。
-- 修复节点地图在缺少精确经纬度时把香港/新加坡/台湾等地区回退到错误占位坐标的问题；补全质心数据并改进复合地名匹配。
-- Pages 部署包上传体积限制改为系统动态配置，默认仍为 100 MiB，可按环境调整。
-- 上传新部署后会按保留策略自动清理超出数量的历史部署包，减少磁盘占用。
-- Agent 在同步 Pages 部署时信任控制面已完成的包校验，不再重复限制文件数与展开体积，仅校验下载完整性并安全解压到本地。
-- 明确 Pages 历史部署保留语义为每个项目最多 N 条（激活必留、其余按从新到旧填充），裁剪失败会记录日志且不回滚已成功上传。
-- 主配置版本与 Pages 部署双轨管理：Agent 以 Pages 项目 ID 为锚点请求最新激活部署包，项目内切换激活版本无需重新发布主配置即可在边缘自动更新。
-- Agent 边缘仅保留每个 Pages 项目的最新部署包，新包就绪并切换成功后清理旧 release；拉取 latest 时增加 hash 二次校验与重试以降低激活竞态失败；单个项目同步失败不再阻塞同批其它项目。
-- Pages 支持从 URL 导入部署包：填写下载链接后由控制面代为拉取并创建部署。
-- 优化 Pages 部署包校验性能：上传时不再为包内每个文件计算哈希，文件清单仅记录路径与声明大小；完整性改由整包校验和保障，并避免将整个压缩包装入内存后再逐文件读取。
+- 边缘观测改为「访问日志为业务唯一真相」：Agent 仅上报明细、主机指标与 OpenResty 健康/连接；协议去掉旧兼容字段，**升级需重建或替换 Agent**。
+- Agent 默认心跳改为 3 秒、离线判定 60 秒，离线补传窗口默认 60 分钟。
+- 看板 UV 使用窗口内真正去重；Zone 曲线标明分桶 UV；磁盘读写改为按小时速率（B/s）展示。
+- 不再采集或展示宿主机网卡入/出站；网络趋势仅保留访问日志已提供/接收数据。
+- Pages 包大小与历史保留可配置，边缘按项目只保留最新激活部署；创建规则表单与详情一致支持直连/隧道/Pages 源站类型。
+- 优化 Pages 部署包校验性能：不再为包内每个文件计算哈希，整包校验和保障完整性。
+
+### 移除
+
+- 移除请求预聚合表与 OpenResty 吞吐观测相关路径；管理端不再返回 `traffic_reports` 与 `openresty_rx|tx`。
 
 ## [v3.3.0] - 2026-07-14