release publish: LLM 生成的 CHANGELOG 内容可能包含错误日期，污染 Release body

[Guo-Zhang]

问题描述

执行 qtcloud-devops release publish 时，LLM 生成的 CHANGELOG 条目中可能自带日期（如 2023-08-31），该日期被 extract_notes() 原样提取后传入 gh release create --notes，导致 GitHub Release body 显示错误日期。

实际表现

• CHANGELOG.md 中工具写入的日期是正确的（来自 today() 调用系统 date +%Y-%m-%d）
• 但 Release body 中出现了 LLM 生成的错误日期（2023-08-31）
• 需要手动用 gh release edit 修复

根因

write_changelog() 写入的格式：

## [{version}] - {today()}    ← 工具写入，日期正确

{LLM 生成的内容}                ← 可能自带头部或日期行

extract_notes() 提取时不会过滤 LLM 产物中的多余日期信息，直接透传给 gh release create。

建议修复方向

1. write_changelog() 写入后，让 extract_notes() 在提取时去除内容中可能存在的重复版本头部或日期行
2. 或在发布前打印即将发布的 notes 内容让用户确认
3. 或在 LLM prompt 中明确禁止输出日期（当前 prompt 未约束）

[Guo-Zhang]

修复方案

当前 LLM prompt 只说了"严格按 Keep a Changelog 格式输出"，LLM 可能输出完整的版本头部（含日期）。

改动 1：LLM prompt 添加格式约束

changelog.rs 的 system prompt 改为：

// 当前:
"严格按 Keep a Changelog 格式输出，分类为 Added / Changed / Fixed / Removed。"

// 改为:
"只输出分类列表，不要版本号、不要日期、不要 Markdown 标题。 格式为：
 ### Added
 - 条目
 - 条目

 ### Changed
 - 条目"

改动 2：write_changelog 防污染

即使 LLM 不听话，write_changelog 写入前把 content 中可能存在的 ## [ 行和日期行过滤掉：

fn write_changelog(path: &Path, version: &str, content: &str) -> Result<(), String> {
    let ver = super::util::normalize_version(version);
    // 过滤 LLM 可能自带的版本头部
    let clean: Vec<&str> = content.lines()
        .filter(|l| !l.trim().starts_with("## [") && !l.trim().starts_with("# "))
        .collect();
    let content = clean.join("\n");
    let entry = format!("\n## [{}] - {}\n\n{}\n", ver, today(), content);
    // ...
}

改动 3：extract_notes 同理

extract_notes 提取时也应过滤 LLM 可能混入的多余头部，防止污染 Release body。

[Guo-Zhang]

测试设计

三层防御各对应一组测试：

测试集 1：write_changelog 内容净化

#[test]
fn test_write_changelog_strips_llm_header() {
    let d = tempfile::tempdir().unwrap();
    let path = d.path().join("CHANGELOG.md");
    // LLM 污染的内容：自带了版本头部和错误日期
    let dirty = "### Added\n- fix bug\n\n## [0.2.0] - 2023-08-31\n\n### Changed\n- refactor";
    write_changelog(&path, "v0.2.0", dirty).unwrap();
    let content = std::fs::read_to_string(&path).unwrap();
    // 工具写入的头部日期必须正确
    assert!(content.contains("## [0.2.0] - 2026-06-27"));
    // LLM 自带的错误日期不应该出现
    assert!(!content.contains("2023-08-31"));
    // LLM 的内容应该保留（只去掉了头部）
    assert!(content.contains("- fix bug"));
    assert!(content.contains("- refactor"));
}

#[test]
fn test_write_changelog_clean_content_unchanged() {
    let d = tempfile::tempdir().unwrap();
    let path = d.path().join("CHANGELOG.md");
    let clean = "### Added\n- feat: new\n### Fixed\n- bug";
    write_changelog(&path, "v0.3.0", clean).unwrap();
    let content = std::fs::read_to_string(&path).unwrap();
    assert!(content.contains("## [0.3.0]"));
    assert!(content.contains("- feat: new"));
    assert!(content.contains("- bug"));
}

测试集 2：extract_notes 输出净化

#[test]
fn test_extract_notes_strips_embedded_headers() {
    let d = tempfile::tempdir().unwrap();
    let path = d.path().join("CHANGELOG.md");
    // CHANGELOG 中 LLM 产物的头部与工具写入的头部混在一起
    let content = "# CHANGELOG\n\n        ## [0.2.0] - 2026-06-27\n\n        ### Added\n- new feature\n\n        ## [0.2.0] - 2023-08-31\n\n        ### Changed\n- refactor\n\n        ## [0.1.0]\n\nold";
    std::fs::write(&path, content).unwrap();
    let notes = extract_notes("v0.2.0", &path).unwrap();
    // 不应包含 LLM 自带的重复头部
    assert!(!notes.contains("## [0.2.0]"));
    // 不应包含错误日期
    assert!(!notes.contains("2023-08-31"));
    // 内容应该保留
    assert!(notes.contains("- new feature"));
    assert!(notes.contains("- refactor"));
}

#[test]
fn test_extract_notes_normal_unchanged() {
    let d = tempfile::tempdir().unwrap();
    let path = d.path().join("CHANGELOG.md");
    let content = "# CHANGELOG\n\n## [0.2.0] - 2026-06-27\n\n### Fixed\n- crash";
    std::fs::write(&path, content).unwrap();
    let notes = extract_notes("v0.2.0", &path).unwrap();
    assert!(notes.contains("### Fixed"));
    assert!(notes.contains("- crash"));
    assert!(!notes.contains("## [0.2.0]"));
}

防御层次

LLM 输出 ──→ [write_changelog 输入清洗] ──→ CHANGELOG.md
                                  ──→ [extract_notes 输出过滤] ──→ Release body

任意一层生效即可阻断错误日期泄漏。两者都失效时还有人工审核 Release 这个兜底。

[Guo-Zhang]

fixed in e67607c: LLM prompt 禁止输出版本头部和日期 + extract_notes 防御性过滤