發佈流程

Osprey 使用 Semantic Versioning 的 SemVer 1.x.y 系列。這套輕量初始流程讓 downstream users 可以依賴 version tags，而不必使用 commit hashes。隨著專案使用增加，流程仍可能調整。

Patch releases，1.x.y

Patch releases 包含已合併至 main 且向後相容的修正或小型改善。

符合下列情況時，可以建立 patch release。

• Downstream users 需要穩定的 version tag
• 已累積具實質意義的修正，且 CI 為 green

發佈沒有固定週期，而是依事件需求進行。

Patch release checklist

建立 release 前，確認下列事項。

• main 的 code quality CI 通過，請見 Code Quality Checks
• 沒有 breaking changes
• 已視需要更新 CHANGELOG.md

建立 release

1. 確認完成上述 checklist
2. 在 GitHub 選擇 Releases → Draft a new release
3. 從 main 選擇或建立 X.Y.Z tag，例如 1.0.1
4. 發佈 release

發佈 release 會觸發既有自動化。

• osprey-rpc　建立 sdist 與 zip 並附加至 release，請見 release-osprey-rpc
• Osprey Coordinator　建立 Docker image 並以 version tags push 至 GHCR，請見 publish-coordinator-image

Downstream projects 可以依賴 1.0.1 等 version tags，不必使用 commit SHAs。

翻譯狀態提醒

本頁只翻譯上游既有流程，不授權建立 tag 或發佈 release。實際操作前仍須由具有 repository 發佈權限的 maintainer 確認 checklist、version 與 artifacts。