ตัวสร้างบันทึกการเปลี่ยนแปลง (Changelog)

สร้างไฟล์ CHANGELOG.md มาตรฐานตามรูปแบบ Keep a Changelog จากประวัติคอมมิต

แยกวิเคราะห์ Conventional Commits ได้ 0 รายการ

เกี่ยวกับ ตัวสร้างบันทึกการเปลี่ยนแปลง (Changelog) — คู่มือการใช้งาน

หมวดหมู่: DevOps และมาตรฐาน ประมวลผลบนเบราว์เซอร์ 100%

เครื่องมือสร้างบันทึกการเปลี่ยนแปลง (Changelog Generator) แยกวิเคราะห์บันทึก Git commit ดิบและจัดรูปแบบให้เป็นเอกสาร `CHANGELOG.md` มาตรฐานที่พร้อมสำหรับการปล่อยเวอร์ชัน รองรับทั้งไวยากรณ์ Conventional Commits และข้อความคอมมิตทั่วไป

คอมมิตจะถูกจัดกลุ่มออกเป็นหมวดหมู่ที่มีโครงสร้างชัดเจน: ฟีเจอร์ (Features), แก้ไขข้อผิดพลาด (Bug Fixes), ปรับปรุงประสิทธิภาพ (Performance Improvements), เอกสาร (Documentation) และการปรับโครงสร้างโค้ด (Refactoring) สามารถกำหนดแท็กเวอร์ชันและวันที่ พร้อมกรองเมิร์จคอมมิตออกเพื่อส่งออกเป็น Markdown ได้ในคลิกเดียว

#changelog #git #release #version #history

คุณสมบัติและความสามารถหลัก

  • แยกวิเคราะห์เอาต์พุตจากคำสั่งเทอร์มินัล `git log --oneline` ดั้งเดิมได้โดยตรง
  • จัดหมวดหมู่รายการคอมมิตโดยอัตโนมัติตามประเภท Conventional Commit (feat, fix, perf, docs)
  • กำหนดแท็กเวอร์ชันที่จะปล่อยและแถบวันที่ได้ตามมาตรฐาน Keep a Changelog
  • กรองเมิร์จคอมมิต (merge commit) ที่ไม่จำเป็นออก และส่งออกเป็น Markdown ที่สะอาดพร้อมคัดลอกไปใช้งาน

วิธีใช้งาน

  1. 1

    รันคำสั่ง `git log --oneline` ในเทอร์มินัลของที่เก็บข้อมูล (repository) แล้ววางบันทึกลงในช่องอินพุต

  2. 2

    ป้อนเวอร์ชันที่ต้องการปล่อย (เช่น `v1.2.0`) และเลือกวันที่ปล่อยเวอร์ชัน

  3. 3

    ตรวจสอบบันทึกการปล่อยที่จัดหมวดหมู่แล้ว จากนั้นคลิกคัดลอกหรือดาวน์โหลดไฟล์ `CHANGELOG.md`

ตัวอย่างการใช้งานทั่วไป

  • → รวบรวมบันทึกการปล่อยสำหรับ GitHub Releases ก่อนปรับใช้การอัปเดตบนระบบ Production
  • → ดูแลไฟล์ CHANGELOG.md ส่วนกลางที่บันทึกประวัติการพัฒนาสำหรับโปรเจกต์โอเพนซอร์ส
  • → แปลงคอมมิตเชิงเทคนิคที่ซับซ้อนให้กลายเป็นบันทึกการเปลี่ยนแปลงที่อ่านเข้าใจง่ายสำหรับผู้มีส่วนได้ส่วนเสียในผลิตภัณฑ์

เครื่องมือที่เกี่ยวข้อง

คำถามที่พบบ่อยและความเป็นส่วนตัว

ฉันจะแยกดึงเฉพาะคอมมิตที่เกิดขึ้นหลังจากแท็กเวอร์ชันก่อนหน้าได้อย่างไร?

รัน `git log <previous-tag>..HEAD --oneline` ในเทอร์มินัลของคุณ เพื่อแยกเฉพาะคอมมิตที่เกิดขึ้นหลังจากเวอร์ชันก่อนหน้าอย่างแม่นยำ

คอมมิตที่ไม่ได้ใช้รูปแบบ Conventional Commit จะถูกจัดหมวดหมู่อย่างไร?

คอมมิตที่ไม่มีคำนำหน้าตามแบบแผนจะถูกจัดกลุ่มไว้ในส่วน "Other Changes" เพื่อให้มั่นใจว่าจะไม่มีข้อมูลคอมมิตใดตกหล่น