| name | release-plugin |
| description | 用于发布 DooTask AI 插件新版本的完整流程。当用户提到"发布"、"打 tag"、"出新版本"、"release"、"上架"、"推到 DooTask AppStore"、"打标签发版"、"v0.x.x"、"升级版本号"等任何与本仓库版本发布相关的意图时，必须使用本技能 —— 即使用户只是说"准备发版"或"该发新版了"也要触发。本技能会引导完成提交代码、打 tag、推送、监控 GitHub Action 直至发布成功，避免遗漏步骤导致发布失败。 |
发布 DooTask AI 插件
本仓库使用 gitflow 工作流，通过推送 v* 格式的 tag 触发 GitHub Action 自动构建并发布到 DockerHub、GitHub Container Registry 和 DooTask AppStore。
触发条件回顾
只有 推送 v* 格式的 tag 才会触发构建发布，普通的 push 或 PR 不会发布。
发布流程
按顺序执行下面的步骤。每一步都先与用户确认再操作 —— 发布是公开行为且涉及多个外部系统（Docker Hub、GHCR、DooTask AppStore），不可逆。
1. 确认当前状态干净
git status
git log --oneline -10
确认：
- 工作区干净，没有未提交的改动
- 当前在
main 分支
- 本地与远程同步（
git fetch && git status 检查是否落后于 origin/main）
如果有未提交的改动，先和用户确认是要包含进本次发布、还是要 stash/丢弃。
2. 决定新版本号
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。
3. 更新 CHANGELOG（中英双语）
发版前必须同步更新这两个文件：
dootask-plugin/0.0.1/CHANGELOG.md（英文）dootask-plugin/0.0.1/CHANGELOG_zh.md（中文）
这两个文件是覆盖式的，不是追加式的 —— 每次发版直接把整个文件替换为本次的更新内容，不保留上一版的条目（AppStore 自己维护历史）。文件里也不写版本号和日期，版本号由 tag 隐式承载。
按分类列点，只用本次涉及到的分类。常用分类（中英对应必须严格一致）：
| 英文 | 中文 |
|---|
| Added | 新增 |
| Fixed | 修复 |
| Updated | 更新 |
| Changed | 变更 |
| Improved | 优化 |
| Removed | 移除 |
写法要求：
- 一句话一条，写给最终用户看，不是开发者 —— 说"修复 DeepSeek 通过 SiliconFlow 调用失败"，不要说"修复 base_url 参数透传 bug"
- 涉及具体模型、提供商、配置项时写出名字，方便用户判断是否影响自己
- 中英两个文件 分类、条数、含义一一对应（第 N 条说的是同一件事）
- 保持简洁，每条一行就够了
格式示例（按本次实际改动写，不要照抄文字）：
英文 CHANGELOG.md：
### Fixed
- Fixed <thing> when <condition>.
### Updated
- Updated <thing> to <new state>.
中文 CHANGELOG_zh.md：
### 修复
- 修复 <事物> 在 <条件> 下的问题。
### 更新
- 更新 <事物> 至 <新状态>。
4. 提交 CHANGELOG 并推送代码到远程
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 也可以。
5. 打 tag 并推送
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 不会撤回已发布的版本）。
6. 监控 GitHub Action
gh run list --workflow=release.yml --limit 3
gh run watch
或在浏览器打开：https://github.com/kuaifan/dootask-ai/actions
7. 验证发布结果
Action 成功后，确认：
- Docker Hub 上
kuaifan/dootask-ai 出现新 tag
- GHCR 上对应仓库出现新 tag
- DooTask AppStore 中
ai 插件版本已更新，且更新说明显示本次 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）。
