| name | release |
| description | 为 astrbot_plugin_goofish_catcher 发布新版本。当用户说"发版"、"发布"、"release"、"推版本"、"打 tag"时触发。完整流程：确定新版本号 → 更新 CHANGELOG.md → 更新 metadata.yaml → 提交 → 推送 → 打 tag → 创建 GitHub Release。 |
Release 发版流程
版本号规则（Semantic Versioning）
- patch（默认）：bug 修复、文档，不影响接口 →
v2.2.3 → v2.2.4
- minor：新功能、向下兼容 →
v2.2.3 → v2.3.0
- major：破坏性变更 →
v2.2.3 → v3.0.0
用户未指定时根据本次改动判断，有疑问时直接选 patch。
执行步骤
1. 确认当前状态
git log --oneline -5
cat metadata.yaml
git diff HEAD
若有未提交改动，先询问用户是否纳入本次 release，再决定是否先提交。
2. 确定新版本号
从 metadata.yaml 读取 version: vX.Y.Z，按上述规则递增。
3. 更新 CHANGELOG.md
在 ## [上一版本] 条目前插入：
## [X.Y.Z] - YYYY-MM-DD
### Added / Changed / Fixed（按实际选）
- 改动描述，简明扼要，面向用户
日期用当天日期（date +%Y-%m-%d）。改动内容从对话上下文或 git log 提炼，不要照抄 commit message。
Worker 兼容性行：CHANGELOG 顶部有一行：
当前插件版本（vX.Y.Z）需要 Worker **≥ vA.B.C**。
每次发版都要把括号里的插件版本号更新为新版本号。
≥ vA.B.C 何时需要同步更新：只要本次改动包含 worker_server.py 的任何功能性修改（新增行为、修复 bug、默认值变更等），就必须把 ≥ vA.B.C 更新为新版本号，并在 CHANGELOG 条目顶部加上：
> **⚠️ Worker 端行为变更，`remote_rest` 模式需在 Worker 服务器上 `git pull` 并重启。**
仅当本次改动完全不涉及 worker_server.py（只改插件侧逻辑、UI、文档等）时，≥ vA.B.C 才保持不变。
4. 更新 metadata.yaml
将 version: vX.Y.Z 改为新版本号。
5. 提交
git add CHANGELOG.md metadata.yaml
git commit -m "release: bump version to vX.Y.Z"
git push origin master
6. 打 Tag 并推送
git tag vX.Y.Z
git push origin vX.Y.Z
7. 创建 GitHub Release
gh release create vX.Y.Z \
--title "vX.Y.Z" \
--notes "$(从 CHANGELOG 摘取本版本的条目内容)"
--notes 内容直接取 CHANGELOG 中本次版本的 ### Added/Changed/Fixed 部分，不要加版本号标题行。
注意事项
- 如果
gh 未登录（gh auth status 失败），告知用户执行 gh auth login 后再继续
- 若有未推送的功能性提交不在 CHANGELOG 里，先补充再发版
- 不要改动
requirements.txt、_conf_schema.json 等非版本文件
