Model Context Protocols

🚀 變更集

變更集是一種用於管理單體倉庫中版本控制和變更日誌的有效工具。此目錄包含變更集，可幫助您輕鬆記錄包的更改、確定版本號、生成變更日誌並將包發佈到 npm。

🚀 快速開始

什麼是變更集？

變更集是一種管理單體倉庫中版本控制和變更日誌的方式。它們允許您：

1. 記錄對倉庫中包的更改
2. 自動確定適當的版本號 bump（主版本、次版本、修補版本）
3. 根據更改生成變更日誌
4. 發佈包到 npm

如何使用變更集

添加變更集

當您對包進行更改時，應該添加一個變更集以描述這些更改：

運行`npm run changeset`

這將提示您：

1. 選擇已更改的包（按空格鍵選擇，回車確認）
2. 為每個包選擇版本號 bump 的類型：
   • major：重大更改
   • minor：新功能（非破壞性）
   • patch：錯誤修復和小改動
3. 編寫更改摘要 該摘要將包含在變更日誌中，當包發佈時顯示。

版本管理包

準備好發佈新版本的包時：

運行`npm run version-packages`

這將：

1. 消費所有變更集
2. 更新包版本
3. 更新變更日誌
4. 創建包含這些更改的新提交

發佈包

要將包發佈到 npm：

運行`npm run release`

這將：

1. 構建所有包
2. 將包發佈到 npm

📚 詳細文檔

CI/CD 集成

此倉庫配置了一個 GitHub 工作流，該工作流：

1. 當將變更集添加到主分支時，創建一個帶有版本更新的 PR
2. 合併 PR 時向 npm 發佈包 該工作流在將更改推送到主分支時自動運行。

最佳實踐

1. 按需創建變更集：每次進行顯著更改時創建變更集，以使變更日誌更詳細和有用。
2. 編寫有意義的變更集消息：描述更改的內容和原因，而不僅僅是文件發生了什麼變化。
3. 使用適當的 bump 類型：
   • major：需要用戶更新代碼的重大破壞性更改
   • minor：不會破壞現有功能的新功能
   • patch：錯誤修復和小改動，不添加新功能或破壞現有代碼
4. 在版本管理前檢查變更集：確保所有更改已正確記錄，再運行version-packages。
5. 保持包同步：對於緊密耦合的包，請考慮使用配置中的fixed選項以確保它們始終一起版本化。

故障排除

• 空變更集列表：如果npm run changeset顯示沒有包，請確保您的包有正確的package.json文件，並且包含name和version字段。
• 發佈錯誤：如果發佈失敗，請檢查是否具有正確的 npm 憑據，並且包名稱可用。
• 合併變更日誌中的衝突：通過保留所有條目並修復任何格式問題來解決衝突。

如需更多詳細信息，請參閱官方變更集文檔。