Files
OpenFlare/.agent/skills/release-guide/SKILL.md
T
ryan 4c0c389122 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 与发布说明。
2026-07-18 16:37:20 +08:00

3.3 KiB
Raw Blame History

name, description
name description
release-guide 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. 如果某个分类没有内容,可以省略。

固定使用以下分类:

### 🛠 修复
### ⚡️ 优化与改进
### 💄 其他/体验

分类规则:

  • 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):
git add docs/changelog/index.md   # 及其他发版所需文件
git commit -m "$(cat <<'EOF'
chore(release): vX.Y.Z

### 🛠 修复
- ...

### ⚡️ 优化与改进
- ...

### 💄 其他/体验
- ...
EOF
)"
  1. 向用户展示完整 commit message,并说明后续可由用户执行:
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。