ci: filter internal release notes

ark-65 · ark-65 · commit 7743f5329ea3 · 2026-05-13T08:57:53.000+08:00
diff --git a/.github/workflows/prepare-release.yml b/.github/workflows/prepare-release.yml
@@ -74,6 +74,7 @@ jobs:
           date = ENV.fetch("DATE")
 
           EMOJI_HEADINGS = ["### ✨", "### 🔄", "### 🐛", "### 🔧", "### 📚", "### 🧪", "### 📦", "### 🧱"].freeze
+          PUBLIC_RELEASE_NOTE_EXCLUDED_HEADINGS = ["### 🔧 CI/CD"].freeze
 
           def extract_unreleased(path)
             content = File.read(path)
@@ -89,6 +90,21 @@ jobs:
             body
           end
 
+          def public_release_notes(markdown)
+            skip_section = false
+            markdown.each_line.each_with_object([]) do |line, lines|
+              stripped = line.strip
+              if stripped.start_with?("### ")
+                skip_section = PUBLIC_RELEASE_NOTE_EXCLUDED_HEADINGS.include?(stripped)
+                next if skip_section
+              elsif stripped.start_with?("## ")
+                skip_section = false
+              end
+
+              lines << line unless skip_section
+            end.join.strip
+          end
+
           gradle = File.read("gradle.properties")
           gradle.sub!(/^version\s*=.*$/, "version = #{version}")
           File.write("gradle.properties", gradle)
@@ -105,6 +121,8 @@ jobs:
 
           notes_en = extract_unreleased("CHANGELOG.md")
           notes_zh = extract_unreleased("CHANGELOG_zh.md")
+          public_notes_en = public_release_notes(notes_en)
+          abort("Empty public release notes after filtering internal changelog sections") if public_notes_en.empty?
 
           archive_unreleased("CHANGELOG.md", "## [#{version}] - #{date}", notes_en)
           archive_unreleased("CHANGELOG_zh.md", "## [#{version}]", notes_zh)
@@ -114,7 +132,7 @@ jobs:
           Prepare release `v#{version}`.
 
           ## Release Notes
-          #{notes_en}
+          #{public_notes_en}
           BODY
 
           File.write("build/release-pr-body.md", body)
diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml
@@ -65,13 +65,30 @@ jobs:
 
           version = ARGV.fetch(0)
           output = ARGV.fetch(1)
+          excluded_headings = ["### 🔧 CI/CD"]
+
+          def public_release_notes(markdown, excluded_headings)
+            skip_section = false
+            markdown.each_line.each_with_object([]) do |line, lines|
+              stripped = line.strip
+              if stripped.start_with?("### ")
+                skip_section = excluded_headings.include?(stripped)
+                next if skip_section
+              elsif stripped.start_with?("## ")
+                skip_section = false
+              end
+
+              lines << line unless skip_section
+            end.join.strip
+          end
+
           changelog = File.read("CHANGELOG.md")
           pattern = /^## \[#{Regexp.escape(version)}\](?: - \d{4}-\d{2}-\d{2})?\s*$\n(?<body>.*?)(?=^## \[|\z)/m
           match = changelog.match(pattern)
           abort("Missing CHANGELOG.md section for #{version}") unless match
 
-          body = match[:body].strip
-          abort("Empty CHANGELOG.md section for #{version}") if body.empty?
+          body = public_release_notes(match[:body], excluded_headings)
+          abort("Empty public release notes for #{version} after filtering internal changelog sections") if body.empty?
 
           FileUtils.mkdir_p(File.dirname(output))
           File.write(output, body + "\n")
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -10,6 +10,7 @@
 - Updated the bundled Mermaid runtime to [mermaid@11.15.0](https://github.com/mermaid-js/mermaid/releases/tag/mermaid%4011.15.0).
 
 ### 🔧 CI/CD
+- Filtered internal CI/CD entries out of public release notes and JetBrains Marketplace change notes.
 - Configured release automation commits and tags with GitHub-attributed author and collaborator metadata.
 - Enforced Unreleased-only bilingual changelog updates and duplicate section checks in CI.
 - Added upstream release links, automated PR labels, and co-author metadata to Mermaid runtime sync automation.
diff --git a/CHANGELOG_zh.md b/CHANGELOG_zh.md
@@ -10,6 +10,7 @@
 - 将内置 Mermaid runtime 更新到 [mermaid@11.15.0](https://github.com/mermaid-js/mermaid/releases/tag/mermaid%4011.15.0)。
 
 ### 🔧 CI/CD
+- 从公开 release notes 和 JetBrains Marketplace change notes 中过滤内部 CI/CD 条目。
 - 为 release 自动化提交和 tag 配置可归属的 GitHub 作者与协作者元数据。
 - 在 CI 中强制双语 changelog 只能更新 Unreleased，并检查重复小节。
 - 为 Mermaid runtime 同步自动化新增上游 release 链接、自动 PR labels 和 co-author 元数据。
diff --git a/build.gradle.kts b/build.gradle.kts
@@ -46,6 +46,29 @@ dependencies {
     }
 }
 
+val publicReleaseNoteExcludedHeadings = setOf("### 🔧 CI/CD")
+
+fun publicReleaseNotes(markdown: String): String {
+    var skipSection = false
+    return markdown
+        .lineSequence()
+        .filter { line ->
+            when {
+                line.startsWith("### ") -> {
+                    skipSection = line.trim() in publicReleaseNoteExcludedHeadings
+                    !skipSection
+                }
+                line.startsWith("## ") -> {
+                    skipSection = false
+                    true
+                }
+                else -> !skipSection
+            }
+        }
+        .joinToString("\n")
+        .trim()
+}
+
 // Configure IntelliJ Platform Gradle Plugin - read more: https://plugins.jetbrains.com/docs/intellij/tools-intellij-platform-gradle-plugin-extension.html
 intellijPlatform {
     pluginConfiguration {
@@ -71,12 +94,13 @@ intellijPlatform {
         // Get the latest available change notes from the changelog file
         changeNotes = version.map { pluginVersion ->
             with(changelog) {
-                renderItem(
+                val releaseNotes = renderItem(
                     (getOrNull(pluginVersion) ?: getUnreleased())
                         .withHeader(false)
                         .withEmptySections(false),
-                    Changelog.OutputType.HTML,
+                    Changelog.OutputType.MARKDOWN,
                 )
+                markdownToHTML(publicReleaseNotes(releaseNotes))
             }
         }
     }
