use std::path::Path;
use quanttide_agent::{llm::CompleteOptions, Message, Settings, LLM};
pub fn collect_git_log(repo_path: &Path) -> Result<String, String> {
let repo = git2::Repository::open(repo_path).map_err(|e| format!("打开仓库失败: {}", e))?;
let head_oid = repo
.head()
.and_then(|h| {
h.target()
.ok_or_else(|| git2::Error::from_str("HEAD 无目标"))
})
.map_err(|_| "无法获取 HEAD".to_string())?;
let mut revwalk = repo
.revwalk()
.map_err(|e| format!("创建 revwalk 失败: {}", e))?;
revwalk.push(head_oid).ok();
if let Some(tag) = get_latest_tag(repo_path) {
if let Ok(r) = repo.find_reference(&format!("refs/tags/{}", tag)) {
if let Some(oid) = r.target() {
revwalk.hide(oid).ok();
}
}
}
let mut log_lines: Vec<String> = Vec::new();
for oid in revwalk {
let oid = oid.map_err(|_| "revwalk 迭代失败".to_string())?;
let commit = repo
.find_commit(oid)
.map_err(|_| "找不到 commit".to_string())?;
let short = &oid.to_string()[..7];
let summary = commit.summary().unwrap_or("").to_string();
log_lines.push(format!("{} {}", short, summary));
}
if log_lines.is_empty() {
return Err("没有新的提交记录".into());
}
Ok(log_lines.join("\n"))
}
fn get_latest_tag(repo_path: &Path) -> Option<String> {
let repo = git2::Repository::open(repo_path).ok()?;
let tag_names = repo.tag_names(None).ok()?;
let mut tags: Vec<&str> = tag_names.iter().flatten().collect();
tags.sort_by(|a, b| b.cmp(a));
tags.first().map(|s| s.to_string())
}
fn llm_changelog(git_log: &str, version: &str) -> Result<String, String> {
let hint = format!(
"根据以下 git 提交记录,为版本 {} 生成 CHANGELOG 条目。\n\n\
要求:\n\
1. 按 Added / Changed / Fixed / Removed 分类\n\
2. 同类提交合并为概括性条目,不要逐条罗列\n\
3. 用中文描述\n\
4. 每类不超过 5 条\n\
5. 仅输出内容,不要版本头部和日期\n\n\
提交记录:\n{git_log}",
version
);
let settings = Settings::from_env();
if settings.llm_api_key.is_empty() {
return Err(format!(
"LLM 未配置(LLM_API_KEY 未设置)。请将以下文本发送给 AI 生成 CHANGELOG:\n\n{hint}"
));
}
let llm = LLM::new(
&settings.llm_model,
&settings.llm_base_url,
&settings.llm_api_key,
);
let messages = vec![
Message::new(
"system",
"你是一个帮助生成 CHANGELOG 的助手。\
将 git 提交记录按 Added / Changed / Fixed / Removed 分类\
并合并为概括性条目,用中文描述。不要逐条罗列 commit message。\
只输出分类后的条目内容,不要输出版本头部(## 行)和日期。",
),
Message::new("user", &hint),
];
let response = llm
.complete(&messages, CompleteOptions::default())
.map_err(|e| format!("LLM 调用失败: {}\n\n请手动生成 CHANGELOG:\n\n{hint}", e))?;
Ok(response.content.trim().to_string())
}
pub fn write_changelog(path: &Path, version: &str, content: &str) -> Result<(), String> {
let ver = super::util::normalize_version(version);
let entry = format!("\n## [{}] - {}\n\n{}\n", ver, today(), content);
let mut existing = if path.exists() {
std::fs::read_to_string(path).map_err(|e| format!("读取 CHANGELOG.md 失败: {}", e))?
} else {
"# CHANGELOG\n".to_string()
};
if let Some(pos) = existing.find("\n## ") {
existing.insert_str(pos, &entry);
} else {
existing.push_str(&entry);
}
std::fs::write(path, &existing).map_err(|e| format!("写入 CHANGELOG.md 失败: {}", e))?;
Ok(())
}
fn today() -> String {
let output = std::process::Command::new("date")
.args(["+%Y-%m-%d"])
.output()
.ok();
output
.and_then(|o| {
if o.status.success() {
Some(String::from_utf8_lossy(&o.stdout).trim().to_string())
} else {
None
}
})
.unwrap_or_else(|| "unknown".to_string())
}
pub fn ensure_changelog(repo_path: &Path, scope_dir: &Path, version: &str) -> Result<(), String> {
let changelog_path = scope_dir.join("CHANGELOG.md");
if changelog_path.exists() {
let content = std::fs::read_to_string(&changelog_path)
.map_err(|e| format!("读取 CHANGELOG.md 失败: {}", e))?;
let ver = super::util::normalize_version(version);
if content.contains(&format!("[{}]", ver)) || content.contains(&format!("[v{}]", ver)) {
return Ok(());
}
}
let git_log = collect_git_log(repo_path)?;
let changelog_content = llm_changelog(&git_log, version)?;
write_changelog(&changelog_path, version, &changelog_content)?;
println!("✓ CHANGELOG.md 已更新(版本 {})", version);
let ver = super::util::normalize_version(version);
let rel = changelog_path
.strip_prefix(repo_path)
.unwrap_or(&changelog_path)
.to_str()
.unwrap_or("CHANGELOG.md");
let add = std::process::Command::new("git")
.args(["add", rel])
.current_dir(repo_path)
.output()
.map_err(|e| format!("git add 失败: {}", e))?;
if !add.status.success() {
return Err("git add CHANGELOG.md 失败".into());
}
let commit = std::process::Command::new("git")
.args([
"commit",
"-m",
&format!("chore: add CHANGELOG entry for {}", ver),
])
.current_dir(repo_path)
.output()
.map_err(|e| format!("git commit 失败: {}", e))?;
if !commit.status.success() {
return Err("git commit CHANGELOG.md 失败".into());
}
println!("✓ CHANGELOG 修改已提交");
Ok(())
}
#[cfg(test)]
mod tests {
use super::*;
fn git_init(path: &Path) {
std::process::Command::new("git")
.args(["init", "-b", "main"])
.current_dir(path)
.output()
.unwrap();
std::process::Command::new("git")
.args(["config", "user.email", "t@t"])
.current_dir(path)
.output()
.unwrap();
std::process::Command::new("git")
.args(["config", "user.name", "t"])
.current_dir(path)
.output()
.unwrap();
}
fn git_commit(path: &Path, msg: &str) {
std::fs::write(path.join("f"), msg).unwrap();
std::process::Command::new("git")
.args(["add", "."])
.current_dir(path)
.output()
.unwrap();
std::process::Command::new("git")
.args(["commit", "-m", msg])
.current_dir(path)
.output()
.unwrap();
}
#[test]
fn test_collect_git_log_with_commits() {
let d = tempfile::tempdir().unwrap();
git_init(d.path());
git_commit(d.path(), "feat: add foo");
git_commit(d.path(), "fix: bar");
let log = collect_git_log(d.path()).unwrap();
assert!(log.contains("feat: add foo"));
}
#[test]
fn test_collect_git_log_single_commit() {
let d = tempfile::tempdir().unwrap();
git_init(d.path());
git_commit(d.path(), "init");
let log = collect_git_log(d.path()).unwrap();
assert!(log.contains("init"));
}
#[test]
fn test_write_changelog_creates_file() {
let d = tempfile::tempdir().unwrap();
let path = d.path().join("CHANGELOG.md");
write_changelog(&path, "v0.1.0", "### Added\n- new feature").unwrap();
let content = std::fs::read_to_string(&path).unwrap();
assert!(content.contains("## [0.1.0]"));
}
#[test]
fn test_write_changelog_append() {
let d = tempfile::tempdir().unwrap();
let path = d.path().join("CHANGELOG.md");
std::fs::write(&path, "# CHANGELOG\n\n## [0.1.0]\n\nold\n").unwrap();
write_changelog(&path, "v0.2.0", "### Added\n- new").unwrap();
let content = std::fs::read_to_string(&path).unwrap();
assert!(content.contains("## [0.2.0]"));
assert!(content.contains("## [0.1.0]"));
}
#[test]
fn test_write_changelog_scope_version() {
let d = tempfile::tempdir().unwrap();
let path = d.path().join("CHANGELOG.md");
write_changelog(&path, "cli/v0.1.0", "### Added\n- feature").unwrap();
let content = std::fs::read_to_string(&path).unwrap();
assert!(content.contains("## [0.1.0]"));
assert!(!content.contains("## [cli/v0.1.0]"));
}
#[test]
fn test_ensure_changelog_skips_if_exists() {
let d = tempfile::tempdir().unwrap();
let path = d.path().join("CHANGELOG.md");
std::fs::write(&path, "# CHANGELOG\n\n## [0.1.0]\n\ncontent\n").unwrap();
assert!(ensure_changelog(d.path(), d.path(), "v0.1.0").is_ok());
}
#[test]
fn test_ensure_changelog_no_git_log() {
let d = tempfile::tempdir().unwrap();
let result = ensure_changelog(d.path(), d.path(), "v0.1.0");
assert!(result.is_err());
}
#[test]
fn test_ensure_changelog_skips_with_v_prefix() {
let d = tempfile::tempdir().unwrap();
git_init(d.path());
git_commit(d.path(), "init");
std::fs::write(
d.path().join("CHANGELOG.md"),
"# CHANGELOG\n\n## [v0.1.0]\n\ncontent\n",
)
.unwrap();
assert!(ensure_changelog(d.path(), d.path(), "v0.1.0").is_ok());
}
#[test]
fn test_latest_tag_empty_repo() {
let d = tempfile::tempdir().unwrap();
git_init(d.path());
git_commit(d.path(), "init");
assert!(get_latest_tag(d.path()).is_none());
}
#[test]
fn test_latest_tag_with_tags() {
let d = tempfile::tempdir().unwrap();
git_init(d.path());
git_commit(d.path(), "init");
std::process::Command::new("git")
.args(["tag", "v0.1.0"])
.current_dir(d.path())
.output()
.unwrap();
std::process::Command::new("git")
.args(["tag", "v0.2.0"])
.current_dir(d.path())
.output()
.unwrap();
assert_eq!(get_latest_tag(d.path()).as_deref(), Some("v0.2.0"));
}
#[test]
fn test_collect_git_log_with_tags_hides_older() {
let d = tempfile::tempdir().unwrap();
git_init(d.path());
git_commit(d.path(), "A");
std::process::Command::new("git")
.args(["tag", "v0.1.0"])
.current_dir(d.path())
.output()
.unwrap();
git_commit(d.path(), "B");
git_commit(d.path(), "C");
let log = collect_git_log(d.path()).unwrap();
assert!(log.contains("B"));
assert!(log.contains("C"));
}
#[test]
fn test_ensure_changelog_repo_path_differs_from_scope_dir() {
let d = tempfile::tempdir().unwrap();
let root_dir = d.path().join("repo");
std::fs::create_dir_all(&root_dir).unwrap();
git_init(&root_dir);
git_commit(&root_dir, "init");
let scope_dir = root_dir.join("sub/scope");
std::fs::create_dir_all(&scope_dir).unwrap();
std::fs::write(
scope_dir.join("CHANGELOG.md"),
"# CHANGELOG\n\n## [0.1.0]\n\ncontent\n",
)
.unwrap();
assert!(ensure_changelog(&root_dir, &scope_dir, "v0.2.0").is_ok());
let scoped_content = std::fs::read_to_string(scope_dir.join("CHANGELOG.md")).unwrap();
assert!(scoped_content.contains("[0.2.0]"));
assert!(!root_dir.join("CHANGELOG.md").exists());
}
#[test]
fn test_ensure_changelog_appends_new_version() {
let d = tempfile::tempdir().unwrap();
git_init(d.path());
git_commit(d.path(), "init");
std::fs::write(
d.path().join("CHANGELOG.md"),
"# CHANGELOG\n\n## [0.1.0]\n\n### Added\n- init\n",
)
.unwrap();
assert!(ensure_changelog(d.path(), d.path(), "v0.2.0").is_ok());
let content = std::fs::read_to_string(d.path().join("CHANGELOG.md")).unwrap();
assert!(content.contains("[0.1.0]"));
assert!(content.contains("[0.2.0]"));
}
}