// 用于发布 DooTask AI 插件新版本的完整流程。当用户提到"发布"、"打 tag"、"出新版本"、"release"、"上架"、"推到 DooTask AppStore"、"打标签发版"、"v0.x.x"、"升级版本号"等任何与本仓库版本发布相关的意图时，必须使用本技能 —— 即使用户只是说"准备发版"或"该发新版了"也要触发。本技能会引导完成提交代码、打 tag、推送、监控 GitHub Action 直至发布成功，避免遗漏步骤导致发布失败。
| name | release-plugin |
| description | 用于发布 DooTask AI 插件新版本的完整流程。当用户提到"发布"、"打 tag"、"出新版本"、"release"、"上架"、"推到 DooTask AppStore"、"打标签发版"、"v0.x.x"、"升级版本号"等任何与本仓库版本发布相关的意图时，必须使用本技能 —— 即使用户只是说"准备发版"或"该发新版了"也要触发。本技能会引导完成提交代码、打 tag、推送、监控 GitHub Action 直至发布成功，避免遗漏步骤导致发布失败。 |
本仓库使用 gitflow 工作流，通过推送 v* 格式的 tag 触发 GitHub Action 自动构建并发布到 DockerHub、GitHub Container Registry 和 DooTask AppStore。
只有 推送 v* 格式的 tag 才会触发构建发布，普通的 push 或 PR 不会发布。
按顺序执行下面的步骤。每一步都先与用户确认再操作 —— 发布是公开行为且涉及多个外部系统（Docker Hub、GHCR、DooTask AppStore），不可逆。
git status
git log --oneline -10
确认：
main 分支git fetch && git status 检查是否落后于 origin/main）如果有未提交的改动，先和用户确认是要包含进本次发布、还是要 stash/丢弃。
git tag --sort=-creatordate | head -5
看最新 tag 后，与用户确认新版本号。遵循语义化版本（SemVer）：
v0.x.Y patch：bugfix、小修小补v0.X.0 minor：新功能、模型新增、不破坏兼容性的重构vX.0.0 major：破坏性变更版本号格式必须是 v 开头，如 v0.5.1。
发版前必须同步更新这两个文件：
dootask-plugin/0.0.1/CHANGELOG.md（英文）dootask-plugin/0.0.1/CHANGELOG_zh.md（中文）这两个文件是覆盖式的，不是追加式的 —— 每次发版直接把整个文件替换为本次的更新内容，不保留上一版的条目（AppStore 自己维护历史）。文件里也不写版本号和日期，版本号由 tag 隐式承载。
按分类列点，只用本次涉及到的分类。常用分类（中英对应必须严格一致）：
| 英文 | 中文 |
|---|---|
| Added | 新增 |
| Fixed | 修复 |
| Updated | 更新 |
| Changed | 变更 |
| Improved | 优化 |
| Removed | 移除 |
写法要求：
格式示例（按本次实际改动写，不要照抄文字）：
英文 CHANGELOG.md：
### Fixed
- Fixed <thing> when <condition>.
### Updated
- Updated <thing> to <new state>.
中文 CHANGELOG_zh.md：
### 修复
- 修复 <事物> 在 <条件> 下的问题。
### 更新
- 更新 <事物> 至 <新状态>。
git add dootask-plugin/0.0.1/CHANGELOG.md dootask-plugin/0.0.1/CHANGELOG_zh.md
git commit -m "docs(changelog): notes for v0.5.1" # 替换为实际版本号
git push origin main
如果同时还有其他待发版的代码改动，一起 commit 进同一次 push 也可以。
git tag v0.5.1 # 替换为实际版本号
git push origin v0.5.1
注意：tag 一旦推送到远程，就会立即触发 Action。在推送前再次确认版本号无误，并确认 CHANGELOG 已经在 main 上了。 如果误推了 tag，可以用
git push --delete origin v0.5.1 && git tag -d v0.5.1删除（但如果 Action 已经发布到 DooTask AppStore，删除 tag 不会撤回已发布的版本）。
gh run list --workflow=release.yml --limit 3
gh run watch # 实时跟踪最新 run
或在浏览器打开：https://github.com/kuaifan/dootask-ai/actions
Action 成功后，确认：
kuaifan/dootask-ai 出现新 tagai 插件版本已更新，且更新说明显示本次 CHANGELOG 内容Action 没触发：检查 tag 是否以 v 开头，是否已经 git push origin <tag>（仅 git tag 不会推送到远程）。
Docker 登录失败：通常是 Secrets 过期或缺失，见下方"GitHub Secrets 配置"注释。
DooTask AppStore 发布失败：检查 dootask-plugin/ 目录结构是否正确，以及 DOOTASK_USERNAME / DOOTASK_PASSWORD 是否有效。
版本号已存在：DooTask AppStore 不允许重复版本号；要发布修复版本，须递增 patch 号（例如 v0.5.1 → v0.5.2）。