diff --git a/scripts/update-version.ts b/scripts/update-version.ts
index 4ad4f941..9d33b7c9 100644
--- a/scripts/update-version.ts
+++ b/scripts/update-version.ts
@@ -1,32 +1,121 @@
 /**
- * @file scripts/update-version.ts
- * @description 抬升版本号
- * @since Beta v0.6.8
+ * 抬升版本号
+ * @since Beta v0.10.2
  */
 import fs from "fs-extra";
 import { resolve } from "path";
 import { fileURLToPath } from "node:url";
 import { execSync } from "node:child_process";
 
-// 获取参数
-const args = process.argv;
-const version = args[2];
-if (!version) {
-  console.error("请输入版本号");
+const __dirname = resolve(fileURLToPath(import.meta.url), "../");
+const rootDir = resolve(__dirname, "..");
+
+// ── ANSI 颜色工具 ──────────────────────────────────────────────
+const color = {
+  reset: "\x1b[0m",
+  bold: "\x1b[1m",
+  dim: "\x1b[2m",
+  green: "\x1b[32m",
+  yellow: "\x1b[33m",
+  cyan: "\x1b[36m",
+  red: "\x1b[31m",
+  magenta: "\x1b[35m",
+};
+
+function logStep(index: number, total: number, msg: string): void {
+  console.log(
+    `  ${color.dim}[${index}/${total}]${color.reset} ${color.cyan}▸${color.reset} ${msg}`,
+  );
+}
+
+function logOk(msg: string): void {
+  console.log(`      ${color.green}✔${color.reset}  ${msg}`);
+}
+
+function logDetail(label: string, value: string): void {
+  console.log(`        ${color.dim}${label}:${color.reset} ${value}`);
+}
+
+function logDivider(): void {
+  console.log(`${color.dim}  ────────────────────────────────────────────${color.reset}`);
+}
+
+function logError(msg: string): never {
+  console.error(`\n  ${color.red}✖${color.reset}  ${color.bold}${msg}${color.reset}\n`);
   process.exit(1);
 }
-const __dirname = resolve(fileURLToPath(import.meta.url), "../");
-// 更新package.json
-const pkgJson = fs.readJsonSync(resolve(__dirname, "../package.json"));
-pkgJson.version = version;
-fs.writeJsonSync(resolve(__dirname, "../package.json"), pkgJson);
-// 更新src-tauri
-const tauriDir = resolve(__dirname, "../src-tauri");
-const tauriToml = fs.readFileSync(resolve(tauriDir, "Cargo.toml"), "utf-8").split("\n");
-tauriToml[2] = `version = "${version}"`;
-fs.writeFileSync(resolve(tauriDir, "Cargo.toml"), tauriToml.join("\n"));
-const tauriJson = fs.readJsonSync(resolve(tauriDir, "tauri.conf.json"));
-tauriJson.version = version;
-fs.writeJsonSync(resolve(tauriDir, "tauri.conf.json"), tauriJson);
 
-execSync("pnpm prettier", { cwd: resolve(__dirname, "..") });
+// ── 参数解析 ──────────────────────────────────────────────────
+const version = process.argv[2];
+if (!version) {
+  logError("缺少版本号参数\n    用法: pnpm upv <version>\n    示例: pnpm upv 0.11.0");
+}
+
+const startTime = performance.now();
+
+console.log();
+console.log(`  ${color.magenta}📦 TeyvatGuide 版本号更新工具${color.reset}`);
+logDivider();
+logDetail("目标版本", `${color.bold}${color.yellow}${version}${color.reset}`);
+logDetail("执行时间", new Date().toLocaleString("zh-CN", { timeZone: "Asia/Shanghai" }));
+logDetail("工作目录", rootDir);
+logDivider();
+
+const steps: string[] = [];
+
+// ── Step 1: 更新 package.json ─────────────────────────────────
+steps.push("package.json");
+logStep(1, 4, "更新 package.json");
+const pkgPath = resolve(rootDir, "package.json");
+const pkgJson = fs.readJsonSync(pkgPath);
+const pkgOldVersion = pkgJson.version;
+pkgJson.version = version;
+fs.writeJsonSync(pkgPath, pkgJson);
+logOk(
+  `package.json  ${color.dim}${pkgOldVersion}${color.reset} → ${color.green}${version}${color.reset}`,
+);
+
+// ── Step 2: 更新 Cargo.toml ───────────────────────────────────
+steps.push("Cargo.toml");
+logStep(2, 4, "更新 src-tauri/Cargo.toml");
+const tauriDir = resolve(rootDir, "src-tauri");
+const cargoPath = resolve(tauriDir, "Cargo.toml");
+const cargoLines = fs.readFileSync(cargoPath, "utf-8").split("\n");
+const cargoOldVersion = cargoLines[2].match(/version = "([^"]+)"/)?.[1] ?? "unknown";
+cargoLines[2] = `version = "${version}"`;
+fs.writeFileSync(cargoPath, cargoLines.join("\n"));
+logOk(
+  `Cargo.toml     ${color.dim}${cargoOldVersion}${color.reset} → ${color.green}${version}${color.reset}`,
+);
+
+// ── Step 3: 更新 tauri.conf.json ──────────────────────────────
+steps.push("tauri.conf.json");
+logStep(3, 4, "更新 src-tauri/tauri.conf.json");
+const tauriConfPath = resolve(tauriDir, "tauri.conf.json");
+const tauriConf = fs.readJsonSync(tauriConfPath);
+const tauriOldVersion = tauriConf.version;
+tauriConf.version = version;
+fs.writeJsonSync(tauriConfPath, tauriConf);
+logOk(
+  `tauri.conf.json ${color.dim}${tauriOldVersion}${color.reset} → ${color.green}${version}${color.reset}`,
+);
+
+// ── Step 4: 运行 Prettier 格式化 ─────────────────────────────
+steps.push("Prettier 格式化");
+logStep(4, 4, "运行 Prettier 格式化");
+const prettierStart = performance.now();
+execSync("pnpm prettier", { cwd: rootDir, stdio: "pipe" });
+const prettierCost = ((performance.now() - prettierStart) / 1000).toFixed(2);
+logOk(`格式化完成 (${color.dim}${prettierCost}s${color.reset})`);
+
+// ── 汇总 ──────────────────────────────────────────────────────
+const totalCost = ((performance.now() - startTime) / 1000).toFixed(2);
+
+logDivider();
+console.log(
+  `  ${color.green}✨ 版本更新完成${color.reset}  ${color.dim}${pkgOldVersion}${color.reset} → ${color.bold}${color.green}${version}${color.reset}`,
+);
+logDetail("更新文件", steps.join(", "));
+logDetail("总耗时", `${color.cyan}${totalCost}s${color.reset}`);
+logDivider();
+console.log();