@quiteer/scripts 0.0.1 → 0.0.3

package/dist/index.d.mts

@@ -1,3 +1,4 @@
+#!/usr/bin/env node
 //#region src/index.d.ts
 declare function setupCli(): Promise<void>;
 //#endregion

package/dist/index.mjs

@@ -1,100 +1,63 @@
+#!/usr/bin/env node
 import cac from "cac";
-import { bgRed, blue, gray, green, lightGreen, red, yellow } from "kolorist";
-import { rimraf } from "rimraf";
-import { access, writeFile } from "node:fs/promises";
+import { bgGreen, bgRed, blue, gray, green, lightBlue, lightCyan, lightGreen, red, white, yellow } from "kolorist";
+import { access, readFile, writeFile } from "node:fs/promises";
 import path from "node:path";
 import process from "node:process";
-import { prompt } from "enquirer";
+import { execa } from "execa";
+import { rimraf } from "rimraf";
 import { loadConfig } from "c12";
 import { readFileSync } from "node:fs";
+import enquirer from "enquirer";
 import { versionBump } from "bumpp";
 
 //#region package.json
-var version = "0.0.1";
-
-//#endregion
-//#region src/commands/cleanup.ts
-async function cleanup(paths) {
-	await rimraf(paths, { glob: true });
-}
+var version = "0.0.2";
 
 //#endregion
-//#region src/config/index.ts
-const defaultOptions = {
-	cwd: process.cwd(),
-	cleanupDirs: [
-		"**/dist",
-		"**/node_modules",
-		"!node_modules/**"
-	],
-	lang: "zh-cn",
-	ncuCommandArgs: ["--deep", "-u"],
-	gitCommitVerifyIgnores: [
-		/^((Merge pull request)|(Merge (.*?) into (.*)|(Merge branch (.*)))(?:\r?\n)*$)/m,
-		/^(Merge tag (.*))(?:\r?\n)*$/m,
-		/^(R|r)evert (.*)/,
-		/^(amend|fixup|squash)!/,
-		/^(Merged (.*?)(in|into) (.*)|Merged PR (.*): (.*))/,
-		/^Merge remote-tracking branch(\s*)(.*)/,
-		/^Automatic merge(.*)/,
-		/^Auto-merged (.*?) into (.*)/
-	]
-};
-async function loadCliOptions(overrides, cwd = process.cwd()) {
-	const { config } = await loadConfig({
-		name: "quiteer",
-		defaults: defaultOptions,
-		overrides,
-		cwd,
-		packageJson: true
-	});
-	return config;
-}
-
-//#endregion
-//#region src/commands/generate-cfg.ts
+//#region src/locales/changelog.ts
 /**
-* 函数：在项目根目录生成 quiteer 配置文件
-* 作用：若已有配置则询问是否覆盖；按默认配置生成 `quiteer.config.ts`
+* 获取 changelog 类型到分组标题的映射
+* @param lang 输出语言
+* @returns 类型分组标题映射
 */
-async function generateConfig() {
-	const cwd = process.cwd();
-	const configPath = path.join(cwd, "quiteer.config.ts");
-	let exists = true;
-	try {
-		await access(configPath);
-	} catch {
-		exists = false;
-	}
-	if (exists) {
-		const { overwrite } = await prompt([{
-			name: "overwrite",
-			type: "confirm",
-			message: `检测到已存在配置文件 ${path.basename(configPath)}，是否覆盖？`
-		}]);
-		if (!overwrite) return;
-	}
-	const regexList = defaultOptions.gitCommitVerifyIgnores.map((r) => r.toString());
-	const indentJson = (val) => {
-		return JSON.stringify(val, null, 2).split("\n").map((line, i) => i === 0 ? line : `  ${line}`).join("\n");
+function getChangelogHeadingMap(lang) {
+	if (lang === "en-us") return {
+		"feat": "Features",
+		"feat-wip": "Features",
+		"fix": "Fixes",
+		"docs": "Docs",
+		"typo": "Typo",
+		"style": "Style",
+		"refactor": "Refactor",
+		"perf": "Performance",
+		"optimize": "Optimization",
+		"test": "Tests",
+		"build": "Build",
+		"ci": "CI",
+		"chore": "Chore",
+		"revert": "Revert"
+	};
+	return {
+		"feat": "新功能",
+		"feat-wip": "新功能",
+		"fix": "修复",
+		"docs": "文档",
+		"typo": "勘误",
+		"style": "代码风格",
+		"refactor": "重构",
+		"perf": "性能优化",
+		"optimize": "质量优化",
+		"test": "测试",
+		"build": "构建",
+		"ci": "CI",
+		"chore": "其他",
+		"revert": "回滚"
 	};
-	await writeFile(configPath, [
-		"// 自动生成的 quiteer 配置文件",
-		"",
-		"export default {",
-		`  cleanupDirs: ${indentJson(defaultOptions.cleanupDirs)},`,
-		`  lang: ${JSON.stringify(defaultOptions.lang)},`,
-		`  ncuCommandArgs: ${indentJson(defaultOptions.ncuCommandArgs)},`,
-		"  gitCommitVerifyIgnores: [",
-		...regexList.map((r, idx, arr) => `    ${r}${idx < arr.length - 1 ? "," : ""}`),
-		"  ]",
-		"}",
-		""
-	].join("\n"), "utf8");
 }
 
 //#endregion
-//#region src/locales/index.ts
+//#region src/locales/commit.ts
 const locales = {
 	"zh-cn": {
 		gitCommitMessages: {
@@ -173,83 +136,469 @@ const locales = {
 //#endregion
 //#region src/shared/index.ts
 async function execCommand(cmd, args, options) {
-	const { execa } = await import("execa");
 	return ((await execa(cmd, args, options))?.stdout)?.trim() || "";
 }
 
 //#endregion
-//#region src/commands/git-commit.ts
+//#region src/commands/changelog.ts
 /**
-* 函数：交互式添加变更文件到暂存区
-* 作用：先询问是否添加全部；若否，列出变更文件供多选后执行 git add
+* 获取分组标题映射（使用 locales/changelog 聚合配置）
+* @param lang 输出语言
 */
-async function gitCommitAdd() {
-	const { confirm } = await prompt([{
-		name: "confirm",
-		type: "confirm",
-		message: "是否添加所有变更文件到暂存区？"
-	}]);
-	if (!confirm) {
-		const files = (await execCommand("git", ["diff", "--name-only"])).split("\n").filter(Boolean);
-		if (files.length === 0) return;
-		const { selected } = await prompt([{
-			name: "selected",
-			type: "multiselect",
-			message: "选择需要添加到暂存区的文件（空格选择，回车确认）",
-			choices: files.map((f) => ({
-				name: f,
-				value: f
-			}))
-		}]);
-		if (!selected?.length) return;
-		await execCommand("git", ["add", ...selected], { stdio: "inherit" });
+function getHeadingMap(lang) {
+	return getChangelogHeadingMap(lang);
+}
+function parseCommit(line) {
+	const [hash, short, date, author, email, subject] = line.split("|");
+	const m = subject.match(/(?<type>[a-z]+)(?:\((?<scope>.+)\))?!?: (?<description>.+)/i);
+	if (!m?.groups) return null;
+	return {
+		type: m.groups.type.toLowerCase(),
+		scope: m.groups.scope,
+		description: m.groups.description.trim(),
+		hash,
+		short,
+		author,
+		email,
+		date,
+		added: 0,
+		deleted: 0
+	};
+}
+function groupByType(items, lang) {
+	const map = /* @__PURE__ */ new Map();
+	const headingMap = getHeadingMap(lang);
+	for (const it of items) {
+		const heading = headingMap[it.type] || (lang === "en-us" ? "Other" : "其他");
+		const arr = map.get(heading) || [];
+		arr.push(it);
+		map.set(heading, arr);
+	}
+	return map;
+}
+/** 获取类型图标映射 */
+function getTypeIcon(type) {
+	return {
+		"feat": "✨ ",
+		"feat-wip": "🧪 ",
+		"fix": "🐛 ",
+		"docs": "📝 ",
+		"style": "🎨 ",
+		"refactor": "♻️ ",
+		"perf": "⚡ ",
+		"optimize": "🧹 ",
+		"test": "✅ ",
+		"build": "🏗️ ",
+		"ci": "⚙️ ",
+		"chore": "🔧 ",
+		"deps": "📦 ",
+		"revert": "⏪ ",
+		"typo": "✏️ "
+	}[type] || "";
+}
+async function getTags() {
+	return (await execCommand("git", [
+		"tag",
+		"--list",
+		"--sort=-version:refname"
+	])).split("\n").filter(Boolean);
+}
+async function getRootCommit() {
+	return await execCommand("git", [
+		"rev-list",
+		"--max-parents=0",
+		"HEAD"
+	]);
+}
+async function getDateForRef(ref) {
+	return await execCommand("git", [
+		"log",
+		"-1",
+		"--date=short",
+		"--format=%ad",
+		ref
+	]) || (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
+}
+async function getCommitsInRange(range) {
+	return (await execCommand("git", [
+		"log",
+		range,
+		"--no-merges",
+		"--pretty=format:%H|%h|%ad|%an|%ae|%s",
+		"--date=format:%Y-%m-%d %H:%M %z"
+	])).split("\n").filter(Boolean).map(parseCommit).filter((x) => !!x);
+}
+/**
+* 读取 package homepage 以生成提交链接
+* @returns 仓库主页 URL
+*/
+async function readHomepage() {
+	try {
+		const content = await readFile(path.join(process.cwd(), "scripts", "package.json"), "utf8");
+		const json = JSON.parse(content);
+		return typeof json.homepage === "string" ? json.homepage.replace(/\/$/, "") : void 0;
+	} catch {
 		return;
 	}
-	await execCommand("git", ["add", "."], { stdio: "inherit" });
+}
+async function prependFile(filePath, content) {
+	try {
+		await access(filePath);
+		const prev = await readFile(filePath, "utf8");
+		await writeFile(filePath, [
+			content.trim(),
+			"",
+			prev.trim()
+		].join("\n"), "utf8");
+	} catch {
+		await writeFile(filePath, `${content.trim()}\n`, "utf8");
+	}
 }
 /**
-* Git commit with Conventional Commits standard
-*
-* @param lang
+* 为每个提交补充变更文件与统计信息
+* @param items 提交项
 */
-async function gitCommit(lang = "en-us") {
-	const { gitCommitMessages, gitCommitTypes, gitCommitScopes } = locales[lang];
-	const typesChoices = gitCommitTypes.map(([value, msg]) => {
-		return {
-			name: value,
-			message: `${`${value}:`.padEnd(12)}${msg}`
-		};
+async function enrichCommit(items) {
+	const results = [];
+	for (const it of items) {
+		const out = await execCommand("git", [
+			"show",
+			it.hash,
+			"--numstat",
+			"--pretty=format:"
+		]);
+		let added = 0;
+		let deleted = 0;
+		for (const line of out.split("\n").filter(Boolean)) {
+			const parts = line.split("	");
+			if (parts.length === 3) {
+				const ai = Number.parseInt(parts[0], 10);
+				const di = Number.parseInt(parts[1], 10);
+				if (!Number.isNaN(ai)) added += ai;
+				if (!Number.isNaN(di)) deleted += di;
+			}
+		}
+		const statusOut = await execCommand("git", [
+			"show",
+			it.hash,
+			"--name-status",
+			"--pretty=format:"
+		]);
+		const filesAdded = [];
+		const filesModified = [];
+		const filesDeleted = [];
+		for (const sLine of statusOut.split("\n").filter(Boolean)) {
+			const [status, file] = sLine.split("	");
+			if (status === "A") filesAdded.push(file);
+			else if (status === "M") filesModified.push(file);
+			else if (status === "D") filesDeleted.push(file);
+			else if (status?.startsWith("R") && file) filesModified.push(file);
+		}
+		results.push({
+			...it,
+			added,
+			deleted,
+			filesAdded,
+			filesModified,
+			filesDeleted
+		});
+	}
+	return results;
+}
+function formatSection(title, date, items, repoUrl, lang) {
+	const groups = groupByType(items, lang);
+	const lines = [];
+	lines.push("## 变更日志");
+	lines.push("");
+	for (const [heading, arr] of groups) {
+		if (!arr.length) continue;
+		lines.push(`### ${heading}`);
+		const dayMap = groupByDay(arr);
+		for (const [day, list] of dayMap) {
+			const dayAdded = list.reduce((s, c) => s + (c.filesAdded?.length || 0), 0);
+			const dayMod = list.reduce((s, c) => s + (c.filesModified?.length || 0), 0);
+			const dayDel = list.reduce((s, c) => s + (c.filesDeleted?.length || 0), 0);
+			lines.push(`#### ${day} \`✏️ ${dayMod}+\` \`➕ ${dayAdded}+\` \`🗑️ ${dayDel}+\``);
+			for (const it of list) {
+				const scopeFmt = it.scope ? `\`${it.scope}\`` : "";
+				const link = repoUrl ? ` ([\`${it.short}\`](${repoUrl}/commit/${it.hash}))` : "";
+				const email = ` <${it.email}>`;
+				const typeIcon = getTypeIcon(it.type);
+				const typeLabel = it.type === "chore" ? "**chore**" : `**${it.type}**`;
+				const time = getTime(it.date);
+				lines.push(`- ${typeIcon} ${typeLabel} ${scopeFmt ? `${scopeFmt}: ` : ""}${it.description}`);
+				lines.push(`  > **🕒  ${time}** · \`➕${it.added}\` / \`➖${it.deleted}\``);
+				lines.push(`  > \`👤 ${it.author}\` ${email}${link}`);
+				for (const f of it.filesAdded ?? []) lines.push(`  - ➕ \`${f}\``);
+				for (const f of it.filesModified ?? []) lines.push(`  - ✏️ \`${f}\``);
+				for (const f of it.filesDeleted ?? []) lines.push(`  - 🗑️ ~~~~\`${f}\`~~~~`);
+			}
+			lines.push("");
+		}
+	}
+	return lines.join("\n");
+}
+function formatTimeline(items, repoUrl) {
+	const lines = [];
+	lines.push("## 变更日志");
+	lines.push("");
+	const dayMap = groupByDay(items);
+	for (const [day, list] of dayMap) {
+		const dayAdded = list.reduce((s, c) => s + (c.filesAdded?.length || 0), 0);
+		const dayMod = list.reduce((s, c) => s + (c.filesModified?.length || 0), 0);
+		const dayDel = list.reduce((s, c) => s + (c.filesDeleted?.length || 0), 0);
+		lines.push(`### ${day} \`✏️ ${dayMod}+\` \`➕ ${dayAdded}+\` \`🗑️ ${dayDel}+\``);
+		for (const it of list) {
+			const link = repoUrl ? ` ([\`${it.short}\`](${repoUrl}/commit/${it.hash}))` : "";
+			const email = ` <${it.email}>`;
+			const typeIcon = getTypeIcon(it.type);
+			const time = getTime(it.date);
+			const scopeFmt = it.scope ? `\`${it.scope}\`` : "";
+			const typeLabel = it.type === "chore" ? "**chore**" : `**${it.type}**`;
+			lines.push(`- ${typeIcon} ${typeLabel} ${scopeFmt ? `${scopeFmt}: ` : ""}${it.description}`);
+			lines.push(`  > **🕒  ${time}** · \`➕${it.added}\` / \`➖${it.deleted}\``);
+			lines.push(`  > \`👤 ${it.author}\` ${email}${link}`);
+			for (const f of it.filesAdded ?? []) lines.push(`  - ➕ \`${f}\``);
+			for (const f of it.filesModified ?? []) lines.push(`  - ✏️ \`${f}\``);
+			for (const f of it.filesDeleted ?? []) lines.push(`  - 🗑️ ~~~~\`${f}\`~~~~`);
+		}
+		lines.push("");
+	}
+	return lines.join("\n");
+}
+/**
+* 生成两种样式的 CHANGELOG 文件
+* @param {{ lang: Lang, format: 'group' | 'timeline' | 'both', groupOutput: string, timelineOutput: string }} options 生成选项
+* @param {'zh-cn'|'en-us'} options.lang 输出语言
+* @param {'group'|'timeline'|'both'} options.format 输出样式
+* @param {string} options.groupOutput 分组样式输出文件路径
+* @param {string} options.timelineOutput 时间轴样式输出文件路径
+* @returns {Promise<void>} 异步任务
+*/
+async function generateChangelogFiles(options) {
+	const repoRoot = await execCommand("git", ["rev-parse", "--show-toplevel"]);
+	const homepage = await readHomepage();
+	const tags = await getTags();
+	let title = "未发布";
+	let date = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
+	let range = "";
+	if (tags.length >= 1) {
+		const latest = tags[0];
+		const prev = tags[1];
+		title = latest;
+		date = await getDateForRef(latest);
+		range = prev ? `${prev}..${latest}` : `${await getRootCommit()}..${latest}`;
+	} else range = "HEAD";
+	let items = await getCommitsInRange(range);
+	items = await enrichCommit(items);
+	const fallback = [
+		`## ${title} - ${date}`,
+		"",
+		"- 无符合 Conventional Commits 标准的提交",
+		""
+	].join("\n");
+	if (options.format === "group" || options.format === "both") {
+		const content = items.length ? formatSection(title, date, items, homepage, options.lang) : fallback;
+		await prependFile(path.join(repoRoot, options.groupOutput), content);
+	}
+	if (options.format === "timeline" || options.format === "both") {
+		const content = items.length ? formatTimeline(items, homepage) : fallback;
+		await prependFile(path.join(repoRoot, options.timelineOutput), content);
+	}
+}
+function getDay(d) {
+	return d.match(/^(\d{4}-\d{2}-\d{2})/)?.[1] || d;
+}
+function getTime(d) {
+	return d.match(/^\d{4}-\d{2}-\d{2}\s(\d{2}:\d{2})/)?.[1] || d;
+}
+function groupByDay(items) {
+	const map = /* @__PURE__ */ new Map();
+	for (const it of items) {
+		const day = getDay(it.date);
+		const arr = map.get(day) || [];
+		arr.push(it);
+		map.set(day, arr);
+	}
+	return map;
+}
+
+//#endregion
+//#region src/commands/cleanup.ts
+async function cleanup(paths) {
+	await rimraf(paths, { glob: true });
+}
+
+//#endregion
+//#region src/config/index.ts
+const defaultOptions = {
+	cwd: process.cwd(),
+	cleanupDirs: [
+		"**/dist",
+		"**/node_modules",
+		"!node_modules/**"
+	],
+	lang: "zh-cn",
+	ncuCommandArgs: ["--deep", "-u"],
+	gitCommitVerifyIgnores: [
+		/^((Merge pull request)|(Merge (.*?) into (.*)|(Merge branch (.*)))(?:\r?\n)*$)/m,
+		/^(Merge tag (.*))(?:\r?\n)*$/m,
+		/^(R|r)evert (.*)/,
+		/^(amend|fixup|squash)!/,
+		/^(Merged (.*?)(in|into) (.*)|Merged PR (.*): (.*))/,
+		/^Merge remote-tracking branch(\s*)(.*)/,
+		/^Automatic merge(.*)/,
+		/^Auto-merged (.*?) into (.*)/
+	],
+	release: {
+		execute: "qui cl",
+		push: true
+	},
+	changelog: {
+		groupOutput: "CHANGELOG.md",
+		timelineOutput: "CHANGELOG_TIMELINE.md",
+		formats: "both"
+	},
+	gitCommit: { add: true }
+};
+async function loadCliOptions(overrides, cwd = process.cwd()) {
+	const { config } = await loadConfig({
+		name: "quiteer",
+		defaults: defaultOptions,
+		overrides,
+		cwd,
+		packageJson: true
 	});
-	const scopesChoices = gitCommitScopes.map(([value, msg]) => ({
-		name: value,
-		message: `${value.padEnd(30)} (${msg})`
-	}));
-	const result = await prompt([
-		{
-			name: "types",
-			type: "select",
-			message: gitCommitMessages.types,
-			choices: typesChoices
-		},
-		{
-			name: "scopes",
-			type: "select",
-			message: gitCommitMessages.scopes,
-			choices: scopesChoices
-		},
-		{
-			name: "description",
-			type: "text",
-			message: gitCommitMessages.description
+	return config;
+}
+
+//#endregion
+//#region src/commands/generate-cfg.ts
+/**
+* 函数：在项目根目录生成 quiteer 配置文件
+* 作用：若已有配置则询问是否覆盖；按默认配置生成 `quiteer.config.ts`
+*/
+async function generateConfig() {
+	const cwd = process.cwd();
+	const configPath = path.join(cwd, "quiteer.config.ts");
+	const regexList = defaultOptions.gitCommitVerifyIgnores.map((r) => r.toString());
+	const indentJson = (val) => {
+		return JSON.stringify(val, null, 2).split("\n").map((line, i) => i === 0 ? line : `  ${line}`).join("\n");
+	};
+	await writeFile(configPath, [
+		"// 自动生成的 quiteer 配置文件",
+		"// 说明：可在此文件中覆盖默认配置项，所有未定义项将采用默认值",
+		"",
+		"export default {",
+		"  // 清理命令默认清理的目录（支持 glob）",
+		`  cleanupDirs: ${indentJson(defaultOptions.cleanupDirs)},`,
+		"",
+		"  // CLI 提示语言：zh-cn | en-us",
+		`  lang: ${JSON.stringify(defaultOptions.lang)},`,
+		"",
+		"  // npm-check-updates 命令参数",
+		`  ncuCommandArgs: ${indentJson(defaultOptions.ncuCommandArgs)},`,
+		"",
+		"  // 提交信息校验的忽略规则（正则）",
+		"  gitCommitVerifyIgnores: [",
+		...regexList.map((r, idx, arr) => `    ${r}${idx < arr.length - 1 ? "," : ""}`),
+		"  ],",
+		"",
+		"  // 发布配置：执行的发布命令与是否推送",
+		`  release: ${indentJson(defaultOptions.release)},`,
+		"",
+		"  // changelog 配置（仅保留输出文件与样式）",
+		`  changelog: ${indentJson(defaultOptions.changelog)},`,
+		"",
+		"  // git-commit 配置：是否默认添加变更文件到暂存区",
+		`  gitCommit: ${indentJson(defaultOptions.gitCommit)},`,
+		"}",
+		""
+	].join("\n"), "utf8");
+}
+
+//#endregion
+//#region src/commands/git-commit.ts
+/**
+* 交互式添加变更文件到暂存区
+* - 先询问是否添加全部；若否，列出变更文件供多选后执行 git add
+* - 在非交互或输入中断等情况下安全退出，不抛出未处理异常
+* @returns {Promise<void>} 异步任务
+*/
+async function gitCommitAdd() {
+	const { prompt: ask } = enquirer;
+	try {
+		if (!!!(await ask([{
+			name: "confirm",
+			type: "confirm",
+			message: "是否添加所有变更文件到暂存区？"
+		}]))?.confirm) {
+			const files = (await execCommand("git", ["diff", "--name-only"])).split("\n").filter(Boolean);
+			if (files.length === 0) return;
+			const selected = (await ask([{
+				name: "selected",
+				type: "multiselect",
+				message: "选择需要添加到暂存区的文件（空格选择，回车确认）",
+				choices: files.map((f) => ({
+					name: f,
+					value: f
+				}))
+			}]))?.selected ?? [];
+			if (!selected.length) return;
+			await execCommand("git", ["add", ...selected], { stdio: "inherit" });
+			return;
 		}
-	]);
-	const breaking = result.description.startsWith("!") ? "!" : "";
-	const description = result.description.replace(/^!/, "").trim();
-	await execCommand("git", [
-		"commit",
-		"-m",
-		`${result.types}(${result.scopes})${breaking}: ${description}`
-	], { stdio: "inherit" });
+		await execCommand("git", ["add", "."], { stdio: "inherit" });
+	} catch {}
+}
+/**
+* 交互式生成符合 Conventional Commits 的提交信息并执行提交
+* - 支持取消或非交互环境下安全退出
+* @param {Lang} lang 交互提示语言
+* @returns {Promise<void>} 异步任务
+*/
+async function gitCommit(lang = "en-us") {
+	try {
+		const { prompt: ask } = enquirer;
+		const { gitCommitMessages, gitCommitTypes, gitCommitScopes } = locales[lang];
+		const typesChoices = gitCommitTypes.map(([value, msg]) => {
+			return {
+				name: value,
+				message: `${`${value}:`.padEnd(12)}${msg}`
+			};
+		});
+		const scopesChoices = gitCommitScopes.map(([value, msg]) => ({
+			name: value,
+			message: `${value.padEnd(30)} (${msg})`
+		}));
+		const result = await ask([
+			{
+				name: "types",
+				type: "select",
+				message: gitCommitMessages.types,
+				choices: typesChoices
+			},
+			{
+				name: "scopes",
+				type: "select",
+				message: gitCommitMessages.scopes,
+				choices: scopesChoices
+			},
+			{
+				name: "description",
+				type: "text",
+				message: gitCommitMessages.description
+			}
+		]);
+		if (!result) return;
+		const breaking = result.description.startsWith("!") ? "!" : "";
+		const description = result.description.replace(/^!/, "").trim();
+		await execCommand("git", [
+			"commit",
+			"-m",
+			`${result.types}(${result.scopes})${breaking}: ${description}`
+		], { stdio: "inherit" });
+	} catch {}
 }
 /** Git commit message verify */
 async function gitCommitVerify(lang = "zh-cn", ignores = []) {
@@ -264,14 +613,77 @@ async function gitCommitVerify(lang = "zh-cn", ignores = []) {
 
 //#endregion
 //#region src/commands/release.ts
-async function release(execute = "", push = true) {
+/**
+* 版本管理：交互选择需要提升版本的包、创建自定义前缀标签、生成变更日志
+* - 多层级仓库：通过交互选择需要更新的包，未选中的包跳过
+* - 标签：支持自定义前缀，命名为 <prefix>-v${version}，存在则跳过创建
+* - 变更日志：默认生成 CHANGELOG.md 与 CHANGELOG_TIMELINE.md（中文，both 格式）
+* - 不包含推送操作，如需发布请手动执行 git push / pnpm publish
+* @param {string} [tagPrefix] 标签前缀（可选，留空则交互输入）
+* @returns {Promise<void>} 异步任务
+*/
+async function release(tagPrefix) {
+	const { prompt: ask } = enquirer;
+	const repoRoot = await execCommand("git", ["rev-parse", "--show-toplevel"]);
+	const files = (await execCommand("git", [
+		"-C",
+		repoRoot,
+		"ls-files",
+		"**/package.json"
+	])).split("\n").filter(Boolean).filter((p) => !p.includes("node_modules"));
+	const choices = [];
+	for (const rel of files) try {
+		const abs = path.join(repoRoot, rel);
+		const json = JSON.parse(await readFile(abs, "utf8"));
+		if (json?.name) choices.push({
+			name: `${json.name} (${rel})`,
+			value: rel
+		});
+	} catch {}
+	const selected = ((await ask([{
+		name: "selected",
+		type: "multiselect",
+		message: "选择需要提升版本的包（空格选择，回车确认）",
+		choices
+	}]))?.selected ?? []).map((s) => {
+		return choices.find((c) => c.value === s || c.name === s)?.value || s;
+	}).filter(Boolean);
+	if (!selected.length) return;
 	await versionBump({
-		files: ["**/package.json", "!**/node_modules"],
-		execute,
-		all: true,
-		tag: true,
-		commit: "chore(projects): release v%s",
-		push
+		files: selected.map((rel) => path.join(repoRoot, rel)),
+		all: false,
+		tag: false,
+		commit: "chore(release): v%s"
+	});
+	const firstPkgPath = path.join(repoRoot, selected[0]);
+	const version$1 = JSON.parse(await readFile(firstPkgPath, "utf8")).version;
+	let prefix = tagPrefix;
+	if (prefix === void 0) try {
+		prefix = (await ask([{
+			name: "prefix",
+			type: "text",
+			message: "请输入标签前缀（可留空）"
+		}]))?.prefix?.trim() || "";
+	} catch {
+		prefix = "";
+	}
+	const tagName = `${prefix ? `${prefix}-` : ""}v${version$1}`;
+	if (!(await execCommand("git", [
+		"tag",
+		"--list",
+		tagName
+	])).trim()) await execCommand("git", [
+		"tag",
+		"--annotate",
+		"--message",
+		`chore(projects): release ${tagName}`,
+		tagName
+	]);
+	await generateChangelogFiles({
+		lang: "zh-cn",
+		format: "both",
+		groupOutput: "CHANGELOG.md",
+		timelineOutput: "CHANGELOG_TIMELINE.md"
 	});
 }
 
@@ -291,35 +703,43 @@ async function setupCli() {
 	* @returns Promise<void>
 	*/
 	const cliOptions = await loadCliOptions();
-	const cli = cac(blue("quiteer-scripts"));
-	cli.version(lightGreen(version)).help();
-	cli.command("generate-config", "在项目根目录下生成配置文件").alias("g").action(async () => {
+	const cli = cac(blue("quiteer"));
+	cli.command("generate-config", `${bgGreen(white("便捷命令"))} ${lightCyan("qui g")}  在项目根目录下生成配置文件`).alias("g").action(async () => {
 		await generateConfig();
 	});
-	cli.command("remove [path]", "删除单个或者多个文件，多个值用逗号分隔，递归删除").alias("rm").action(async (paths) => {
+	cli.command("remove [path]", `${bgGreen(white("便捷命令"))} ${lightBlue("qui rm")}  删除单个或者多个文件 , 多个值用逗号分隔，递归删除`).alias("rm").action(async (paths) => {
 		if (paths && paths.includes(",")) await cleanup(paths.split(","));
 		else if (paths) await cleanup([paths]);
 		else console.info("quiteer-script :>> ", gray("无事发生"));
 	});
-	cli.command("cleanup [path]", "清除目录 node_modules、dist 等").alias("c").action(async (paths) => {
+	cli.command("cleanup [path]", `${bgGreen(white("便捷命令"))} ${lightBlue("qui c")}  清除目录 node_modules、dist 等`).alias("c").action(async (paths) => {
 		if (paths && paths.includes(",")) await cleanup(paths.split(","));
 		else if (paths) await cleanup([paths]);
 		else await cleanup(cliOptions.cleanupDirs);
 	});
-	cli.command("update-pkg", "更新 package.json 依赖版本").alias("u").action(async () => {
+	cli.command("update-pkg", `${bgGreen(white("便捷命令"))} ${lightBlue("qui u")}  更新 package.json 依赖版本`).alias("u").action(async () => {
 		await updatePkg(cliOptions.ncuCommandArgs);
 	});
-	cli.command("git-commit", "git 提交前后的操作和规范等").alias("git-c").option("--add", "添加所有变更文件到暂存区", { default: true }).option("-l ,--lang", "校验提交信息的语言", { default: cliOptions.lang }).action(async (args) => {
+	cli.command("git-commit", `${bgGreen(white("便捷命令"))} ${lightBlue("qui gc")}  git 提交前后的操作和规范等`).alias("gc").option("--add", "添加所有变更文件到暂存区", { default: cliOptions.gitCommit.add }).option("-l ,--lang", "校验提交信息的语言", { default: cliOptions.lang }).action(async (args) => {
 		if (args?.add) await gitCommitAdd();
 		await gitCommit(args?.lang);
 	});
-	cli.command("git-commit-verify", "校验提交信息是否符合 Conventional Commits 标准").alias("git-v").option("-l --lang", "校验提交信息的语言", { default: cliOptions.lang }).action(async (args) => {
+	cli.command("git-commit-verify", `${bgGreen(white("便捷命令"))} ${lightBlue("qui gv")}  校验提交信息是否符合 Conventional Commits 标准`).alias("gv").option("-l --lang", "校验提交信息的语言", { default: cliOptions.lang }).action(async (args) => {
 		await gitCommitVerify(args?.lang, cliOptions.gitCommitVerifyIgnores);
 	});
-	cli.command("release", "发布：更新版本、生成变更日志、提交代码").alias("r").option("--execute", "执行发布的命令").option("--push", "是否推送代码", { default: true }).action(async (args) => {
-		await release(args?.execute, args?.push);
+	cli.command("release", `${bgGreen(white("便捷命令"))} ${lightBlue("qui r")}  版本管理：选择包并提升版本，创建自定义前缀标签并生成 changelog`).alias("r").option("--tag-prefix <prefix>", "标签前缀（可选，留空则交互输入）").action(async (args) => {
+		await release(args?.tagPrefix);
+	});
+	cli.command("changelog", `${bgGreen(white("便捷命令"))} ${lightBlue("qui cl")}  生成变更日志 CHANGELOG.md、CHANGELOG_TIMELINE`).alias("cl").option("-f, --format <format>", "输出样式：group|timeline|both", { default: cliOptions.changelog.formats }).option("--group-output <path>", "分组样式输出文件", { default: cliOptions.changelog.groupOutput }).option("--timeline-output <path>", "时间轴样式输出文件", { default: cliOptions.changelog.timelineOutput }).option("-l, --lang <lang>", "输出语言", { default: cliOptions.lang }).action(async (args) => {
+		const cfg = cliOptions.changelog;
+		await generateChangelogFiles({
+			lang: args.lang || cliOptions.lang,
+			format: args.format || cfg.formats,
+			groupOutput: args.groupOutput || cfg.groupOutput,
+			timelineOutput: args.timelineOutput || cfg.timelineOutput
+		});
 	});
-	cli.parse();
+	cli.version(lightGreen(version)).help().parse();
 }
 setupCli();
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@quiteer/scripts",
   "type": "module",
-  "version": "0.0.1",
+  "version": "0.0.3",
   "homepage": "https://github.com/TaiAiAc/web",
   "publishConfig": {
     "access": "public",
@@ -49,6 +49,6 @@
   "scripts": {
     "dev": "tsdown -w",
     "build": "tsdown",
-    "release": "pnpm publish"
+    "release": "qui r --tag-prefix scripts"
   }
 }