mirror of
https://github.com/Rain-kl/OpenFlare.git
synced 2026-10-11 17:56:37 +08:00
ryan
4c0c389122
### 🛠 修复 - 修复了看板业务流量趋势与 Zone 已提供数据口径不一致的问题，业务量统一由访问日志聚合，避免边缘预聚合窗口差分导致近 24 小时趋势严重偏低。 - 修复了节点地图在缺少精确经纬度时，将香港、新加坡、台湾等地区错误回退到南美等占位坐标的问题，补全质心数据并改进复合地名匹配。 ### ⚡️ 优化与改进 - 重构边缘可观测模型：访问日志为业务唯一真相，Agent 仅上报明细、主机指标与 OpenResty 健康连接；新增 edge_health 与 access_log_hourly，删除请求预聚合与 OpenResty 吞吐路径。 - 协议去掉旧兼容层，Agent 升级需销毁重建或二进制替换；旧本地观测缓冲会自动删除并在运行中重建。 - 调整 Agent 默认心跳为 3 秒、离线判定为 60 秒、离线补传窗口为 60 分钟，使节点状态与观测数据刷新更及时。 - 看板 UV 改为窗口内真正去重，Zone 分桶 UV 明确不可跨桶相加；网络趋势仅保留已提供/接收数据，磁盘读写改为按秒速率展示。 - Pages 支持多压缩格式上传、URL 导入部署包，以及可配置的包大小上限与历史保留数量；边缘按项目只保留最新激活部署，切换版本无需重发主配置。 - 新建代理规则时可选择直连、隧道或 Pages 源站类型，与详情页一致。 - 优化 Pages 部署包校验性能，不再为包内每个文件计算哈希，改由整包校验和保障完整性。 ### 💄 其他/体验 - 更新可观测设计文档与运维说明，明确健康状态权威源与升级策略。 - 同步 Swagger 与变更日志，便于对照 API 与发布说明。
105 lines
3.3 KiB
Markdown
105 lines
3.3 KiB
Markdown
---
|
|
name: "release-guide"
|
|
description: "Wavelet 项目专用：根据自上一个正式版本 Tag 以来的提交记录，整理生成规范的 Version Bump Commit Message，用于触发自动双语 Release。"
|
|
---
|
|
|
|
# Release Commit Message Guide
|
|
|
|
## 目标
|
|
|
|
当用户准备发布 Wavelet 新版本时，本 Skill 负责：
|
|
|
|
1. 根据上一正式版本 Tag 以来的提交，整理面向用户的发版说明；
|
|
2. 新建 **独立的** `chore(release): vX.Y.Z` 提交（可附带将 `docs/changelog` 从 `[unreleased]` 落版）。
|
|
|
|
## 硬性约束（禁止改写历史）
|
|
|
|
- **禁止** `git commit --amend` 修改任何**已经 push 到远端**的提交。
|
|
- **禁止** 为了发版去改写已有功能/修复提交的 message 或内容。
|
|
- **禁止** 发版流程中的 force-push（除非用户明确要求且知晓后果）。
|
|
- 发版提交必须是 **新增 commit**：在当前 `HEAD` 之上 `git commit` 一次。
|
|
- 默认 **不要 push、不要打 tag**；生成并完成本地 release commit 后，把后续 `push` / `git tag` 命令交给用户确认执行。
|
|
|
|
## 生成提交信息
|
|
|
|
将原始 commit log 整理为面向 Release 的更新说明。
|
|
|
|
要求：
|
|
|
|
1. 合并重复或相近提交。
|
|
2. 删除无意义提交，例如格式化、临时调试、无关重构。
|
|
3. 将内部实现描述改写为用户可理解的变更。
|
|
4. 每条使用完整中文句子。
|
|
5. 尽量说明“修复/优化了什么”以及“带来的效果”。
|
|
6. 不要编造 commit log 中没有的信息。
|
|
7. 不要加入 token、密钥、私有地址等敏感信息。
|
|
8. 如果某个分类没有内容，可以省略。
|
|
|
|
固定使用以下分类：
|
|
|
|
```text
|
|
### 🛠 修复
|
|
### ⚡️ 优化与改进
|
|
### 💄 其他/体验
|
|
```
|
|
|
|
分类规则：
|
|
|
|
- Bug、异常行为、错误逻辑：放入 ### 🛠 修复
|
|
- 性能、稳定性、接口、架构、兼容性：放入 ### ⚡️ 优化与改进
|
|
- 日志、文案、UI、文档、开发体验：放入 ### 💄 其他/体验
|
|
|
|
示例:
|
|
|
|
```
|
|
chore(release): v3.3.0
|
|
|
|
### 🛠 修复
|
|
- 修复了通过 MCP 接口操作时笔记库范围限制未正确生效的问题。
|
|
- 修复了 MCP 接口返回数据格式不一致的问题。
|
|
- 修复了 WebSocket 客户端异常断开后僵尸连接未及时清理的问题。
|
|
|
|
### ⚡️ 优化与改进
|
|
- 优化了 WebGUI 登录机制，引入设备令牌自动轮转，减少因 IP 变化产生的冗余令牌。
|
|
|
|
### 💄 其他/体验
|
|
- 优化了 WebSocket 错误日志，增加请求路径信息，方便问题排查。
|
|
```
|
|
|
|
## 提交步骤
|
|
|
|
1. 确认工作区干净，且 `HEAD` 与将要发布的代码一致（通常已与 `origin/main` 对齐或仅含未 push 的合法新提交）。
|
|
2. 将 `docs/changelog/index.md` 中 `[unreleased]` 落版为 `[vX.Y.Z] - YYYY-MM-DD`（按需整理条目）。
|
|
3. **新建** release 提交（不要 amend）：
|
|
|
|
```bash
|
|
git add docs/changelog/index.md # 及其他发版所需文件
|
|
git commit -m "$(cat <<'EOF'
|
|
chore(release): vX.Y.Z
|
|
|
|
### 🛠 修复
|
|
- ...
|
|
|
|
### ⚡️ 优化与改进
|
|
- ...
|
|
|
|
### 💄 其他/体验
|
|
- ...
|
|
EOF
|
|
)"
|
|
```
|
|
|
|
4. 向用户展示完整 commit message，并说明后续可由用户执行：
|
|
|
|
```bash
|
|
git push origin main
|
|
git tag vX.Y.Z
|
|
git push origin vX.Y.Z
|
|
```
|
|
|
|
（打 tag 后由 CI 创建双语 Release。）
|
|
|
|
## 任务结束条件
|
|
|
|
本地已存在 **新的** `chore(release): vX.Y.Z` 提交，且**未**改写任何已 push 提交、**未**擅自 push/tag。
|