# Release Plugin > 用于发布 DooTask AI 插件新版本的完整流程。当用户提到"发布"、"打 tag"、"出新版本"、"release"、"上架"、"推到 DooTask AppStore"、"打标签发版"、"v0.x.x"、"升级版本号"等任何与本仓库版本发布相关的意图时，必须使用本技能 —— 即使用户只是说"准备发版"或"该发新版了"也要触发。本技能会引导完成提交代码、打 tag、推送、监控 GitHub Action 直至发布成功，避免遗漏步骤导致发布失败。 - Skill: `kuaifan/release-plugin` (Agent Skill) - Install (CLI): `npx skillmds@latest add kuaifan/release-plugin` - Raw SKILL.md: https://api.skillmd.com/api/skills/kuaifan/release-plugin/raw - Safety review: pending - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Coding & Dev Tools - Author: kuaifan (https://skillmd.com/u/kuaifan) - Updated: 2026-09-17 - Page: https://skillmd.com/skills/kuaifan/release-plugin --- # 发布 DooTask AI 插件 本仓库使用 gitflow 工作流，通过推送 `v*` 格式的 tag 触发 GitHub Action 自动构建并发布到 DockerHub、GitHub Container Registry 和 DooTask AppStore。 ## 触发条件回顾 只有 **推送 `v*` 格式的 tag** 才会触发构建发布，普通的 push 或 PR 不会发布。 ## 发布流程 按顺序执行下面的步骤。每一步都先与用户确认再操作 —— 发布是公开行为且涉及多个外部系统（Docker Hub、GHCR、DooTask AppStore），不可逆。 ### 1. 确认当前状态干净 ```bash git status git log --oneline -10 ``` 确认： - 工作区干净，没有未提交的改动 - 当前在 `main` 分支 - 本地与远程同步（`git fetch && git status` 检查是否落后于 origin/main） 如果有未提交的改动，先和用户确认是要包含进本次发布、还是要 stash/丢弃。 ### 2. 决定新版本号 ```bash 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`： ```markdown ### Fixed - Fixed when . ### Updated - Updated to . ``` 中文 `CHANGELOG_zh.md`： ```markdown ### 修复 - 修复 <事物> 在 <条件> 下的问题。 ### 更新 - 更新 <事物> 至 <新状态>。 ``` ### 4. 提交 CHANGELOG 并推送代码到远程 ```bash 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 并推送 ```bash 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 ```bash gh run list --workflow=release.yml --limit 3 gh run watch # 实时跟踪最新 run ``` 或在浏览器打开：`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 `（仅 `git tag` 不会推送到远程）。 **Docker 登录失败**：通常是 Secrets 过期或缺失，见下方"GitHub Secrets 配置"注释。 **DooTask AppStore 发布失败**：检查 `dootask-plugin/` 目录结构是否正确，以及 `DOOTASK_USERNAME` / `DOOTASK_PASSWORD` 是否有效。 **版本号已存在**：DooTask AppStore 不允许重复版本号；要发布修复版本，须递增 patch 号（例如 `v0.5.1` → `v0.5.2`）。