Lex

🚀 Changesets

Changesets 是用於管理版本發佈的工具，此目錄包含用於管理版本發佈的變更集文件。它能有效管理版本控制和更新日誌，讓版本發佈更加有序。

🚀 快速開始

🔍 什麼是變更集？

變更集是一種管理版本控制和更新日誌的方式。每個變更集描述了應該更新的內容以及原因。

🔨 工作流程

1. 進行變更

當你進行需要發佈的變更時，執行以下命令：

npx changeset

此命令會：

• 詢問變更屬於重大變更（major）、次要變更（minor）還是補丁變更（patch）。
• 要求你提供變更的摘要。

2. 每週發佈（週三）

在週三，發佈管理員需要執行以下操作：

# 1. 生成版本更新和更新日誌
npx changeset version

# 2. 審查 package.json 和 CHANGELOG.md 的變更
# 3. 提交版本變更
git add .
git commit -m "chore: version packages for release"

# 4. 推送到主分支
git push origin main

# 5. 為發佈打標籤
git checkout main
git pull
git tag -s v0.X.Y -m "Release v0.X.Y"
git push origin v0.X.Y

3. 發佈（自動化）

當推送簽名標籤時，GitHub Actions 將執行以下操作：

• 驗證標籤。
• 構建並測試。
• 使用來源證明發布到 npm。
• 創建 GitHub 版本發佈。

💻 使用示例

🌟 新特性（次要變更）

---
'lex': minor
---

Add new frame visualization command

🐛 修復 bug（補丁變更）

---
'lex': patch
---

Fix SQLite connection leak in frame queries

💥 重大變更（重大變更）

---
'lex': major
---

BREAKING: Change policy file format to YAML

💡 使用建議

• 當進行面向用戶的變更時，始終創建變更集。
• 正確使用語義化版本控制（重大變更/次要變更/補丁變更）。
• 編寫清晰、以用戶為中心的摘要。
• 引用單個 'lex' 包（而非 lex/* 子包）。