babaofan-translate-cli 1.0.0 → 1.0.2-beta.0

package/README.md

@@ -1,5 +1,25 @@
 # babaofan-translate-cli
 
+> 当前版本为 **Beta 测试版**。功能还在快速迭代，存在已知问题与兼容性风险，生产项目请先使用 `--dry-run` 验证，再决定是否正式改写源码。
+>
+> Beta 安装方式：
+>
+> ```bash
+> npm install -D babaofan-translate-cli@beta
+> ```
+>
+> Beta 临时执行方式：
+>
+> ```bash
+> npx babaofan-translate-cli@beta create --languages zh-cn,en --files "src/**/*.vue,src/**/*.ts" --dry-run
+> ```
+>
+> GitHub 仓库地址：
+>
+> ```text
+> https://github.com/2285907229/babaofan-translate-cli
+> ```
+
 一个本地运行的 i18n 翻译 CLI。
 
 它的目标很直接：扫描前端项目中的 `t("...")`、`$t("...")` 这类国际化调用，把中文词条提取出来，自动生成稳定的 i18n key，把源码里的中文调用改写成 key 调用，然后直接在本地通过 Google AI Studio 的 Gemini 模型完成翻译，最后生成对应的多语言文件。
@@ -89,56 +109,19 @@ npm install
 - 已安装当前项目依赖
 - 能访问 Google AI Studio / Gemini 接口
 
-## 发布到 npm
-
-发布前建议先确认：
-
-- [package.json](./package.json) 中的 `name`、`version`、`description` 已经正确
-- [config.js](./config.js) 里不要保留你自己的真实 API Key
-- 本地已经执行过测试命令
-
-### 1. 登录 npm
-
-```bash
-npm login
-```
-
-### 2. 检查最终会发布哪些文件
-
-```bash
-npm pack --dry-run
-```
-
-### 3. 发布
-
-首次发布：
-
-```bash
-npm publish
-```
 
-如果后续发新版本，先改 `version`，再发布：
-
-```bash
-npm version patch
-npm publish
-```
+### 安装
 
-你也可以按需使用：
+建议作为开发依赖安装：
 
 ```bash
-npm version minor
-npm version major
+npm install -D babaofan-translate-cli
 ```
 
-## 在别的项目里使用
-
-### 安装
-
-建议作为开发依赖安装：
+如果你想明确安装测试版，建议直接指定 `beta` tag：
 
 ```bash
-npm install -D babaofan-translate-cli
+npm install -D babaofan-translate-cli@beta
 ```
 
 或者：
@@ -159,6 +142,12 @@ yarn add -D babaofan-translate-cli
 npx babaofan-translate create --languages zh-cn,en --files "src/**/*.vue,src/**/*.tsx" --dry-run
 ```
 
+如果你想强制使用 Beta 版本测试：
+
+```bash
+npx babaofan-translate-cli@beta create --languages zh-cn,en --files "src/**/*.vue,src/**/*.tsx" --dry-run
+```
+
 ### 方式 2：写进项目 scripts
 
 在目标项目的 `package.json` 里加：

package/package.json

@@ -1,8 +1,8 @@
 {
 	"private": false,
 	"name": "babaofan-translate-cli",
-	"version": "1.0.0",
-	"description": "A local CLI for scanning i18n calls, generating semantic keys, translating with Google AI Studio, and updating locale files.",
+	"version": "1.0.2-beta.0",
+	"description": "Beta local CLI for scanning i18n calls, generating semantic keys, translating with Google AI Studio, and updating locale files.",
 	"type": "module",
 	"bin": {
 		"babaofan-translate": "./bin/i18n.js"
@@ -13,7 +13,8 @@
 	"files": [
 		"bin",
 		"config.js",
-		"README.md"
+		"README.md",
+		"utils.js"
 	],
 	"keywords": [
 		"i18n",
@@ -28,6 +29,14 @@
 	],
 	"author": "",
 	"license": "MIT",
+	"homepage": "https://github.com/2285907229/babaofan-translate-cli#readme",
+	"bugs": {
+		"url": "https://github.com/2285907229/babaofan-translate-cli/issues"
+	},
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/2285907229/babaofan-translate-cli.git"
+	},
 	"dependencies": {
 		"@google/genai": "^1.24.0",
 		"@babel/parser": "^7.28.6",

package/utils.js

@@ -0,0 +1,244 @@
+#!/usr/bin/env node
+
+/**
+ * 公共工具函数模块
+ * 提供跨脚本使用的通用功能
+ */
+
+import chalk from "chalk";
+import path from "path";
+import fs from "fs";
+import { execSync } from "child_process";
+import os from "os";
+
+// ============================================================================
+// 路径工具
+// ============================================================================
+
+/**
+ * 获取项目根目录
+ * @returns {string} 项目根目录路径
+ */
+function getProjectRoot() {
+	// return "/Users/jiangshuai/Desktop/coding/cool/uniapp/cool-unix";
+	return process.cwd();
+}
+
+/**
+ * 获取相对于项目根目录的路径
+ * @param {string} absolutePath - 绝对路径
+ * @param {string} projectRoot - 项目根目录（可选）
+ * @returns {string} 相对路径
+ */
+function getRelativePath(absolutePath, projectRoot = getProjectRoot()) {
+	return absolutePath.replace(projectRoot, "").replace(/^\//, "");
+}
+
+// ============================================================================
+// 文件系统工具
+// ============================================================================
+
+/**
+ * 确保目录存在，不存在则创建
+ * @param {string} filePath - 文件路径或目录路径
+ */
+function ensureDirectoryExists(filePath) {
+	const dirPath = path.dirname(filePath);
+	if (!fs.existsSync(dirPath)) {
+		fs.mkdirSync(dirPath, { recursive: true });
+	}
+}
+
+/**
+ * 递归复制目录/文件（覆盖模式）
+ * @param {string} src - 源路径
+ * @param {string} dest - 目标路径
+ */
+function copyRecursive(src, dest) {
+	const stat = fs.statSync(src);
+
+	if (fs.existsSync(dest)) {
+		fs.rmSync(dest, { recursive: true, force: true });
+	}
+
+	if (stat.isDirectory()) {
+		fs.mkdirSync(dest, { recursive: true });
+		const items = fs.readdirSync(src);
+		for (const item of items) {
+			const srcPath = path.join(src, item);
+			const destPath = path.join(dest, item);
+			copyRecursive(srcPath, destPath);
+		}
+	} else {
+		fs.copyFileSync(src, dest);
+	}
+}
+
+/**
+ * 清理目录
+ * @param {string} dirPath - 目录路径
+ * @returns {boolean} 是否成功清理
+ */
+function cleanDirectory(dirPath) {
+	if (fs.existsSync(dirPath)) {
+		fs.rmSync(dirPath, { recursive: true, force: true });
+		return true;
+	}
+	return false;
+}
+
+// ============================================================================
+// 终端日志工具
+// ============================================================================
+
+/**
+ * 统一的日志工具类
+ */
+const logger = {
+	/**
+	 * 打印标题
+	 * @param {string} text - 标题文本
+	 */
+	title(text) {
+		console.log();
+		console.log(chalk.white.bold(text));
+		console.log(chalk.gray("─".repeat(50)));
+	},
+
+	/**
+	 * 打印信息
+	 * @param {string} label - 标签
+	 * @param {string} value - 值
+	 */
+	info(label, value) {
+		console.log(chalk.gray("  ●"), chalk.white(label), chalk.cyan(value));
+	},
+
+	/**
+	 * 打印成功消息
+	 * @param {string} text - 消息文本
+	 */
+	success(text) {
+		console.log(chalk.green("  ✓"), chalk.white(text));
+	},
+
+	/**
+	 * 打印警告消息
+	 * @param {string} text - 警告文本
+	 */
+	warn(text) {
+		console.log(chalk.yellow("  ⚠"), chalk.white(text));
+	},
+
+	/**
+	 * 打印错误消息
+	 * @param {string} text - 错误文本
+	 */
+	error(text) {
+		console.error(chalk.red("  ✗"), chalk.white(text));
+	},
+
+	/**
+	 * 打印文件路径
+	 * @param {string} filePath - 文件路径
+	 * @param {string} projectRoot - 项目根目录（可选）
+	 */
+	file(filePath, projectRoot = getProjectRoot()) {
+		const relativePath = getRelativePath(filePath, projectRoot);
+		console.log(chalk.gray("  +"), chalk.green(relativePath));
+	},
+
+	/**
+	 * 打印分隔线
+	 */
+	divider() {
+		console.log(chalk.gray("─".repeat(50)));
+	},
+
+	/**
+	 * 打印空行
+	 */
+	newline() {
+		console.log();
+	}
+};
+
+// ============================================================================
+// 命令行工具
+// ============================================================================
+
+/**
+ * 跨平台检测命令是否存在
+ * @param {string} command - 要检测的命令
+ * @returns {boolean} 命令是否存在
+ */
+function commandExists(command) {
+	const isWindows = os.platform() === "win32";
+
+	try {
+		if (isWindows) {
+			try {
+				execSync(`where ${command}`, { stdio: "ignore", shell: "cmd.exe" });
+				return true;
+			} catch {
+				execSync(`${command} --version`, {
+					stdio: "ignore",
+					shell: "cmd.exe",
+					timeout: 3000
+				});
+				return true;
+			}
+		} else {
+			try {
+				execSync(`which ${command}`, { stdio: "ignore" });
+				return true;
+			} catch {
+				execSync(`${command} --version`, {
+					stdio: "ignore",
+					timeout: 3000
+				});
+				return true;
+			}
+		}
+	} catch {
+		return false;
+	}
+}
+
+// ============================================================================
+// 字符串工具
+// ============================================================================
+
+/**
+ * 将连字符命名转换为驼峰命名
+ * @param {string} str - 连字符字符串
+ * @returns {string} 驼峰命名字符串
+ */
+function toCamelCase(str) {
+	return str.replace(/-([a-z])/g, (_match, letter) => letter.toUpperCase());
+}
+
+/**
+ * 将驼峰命名转换为连字符命名
+ * @param {string} str - 驼峰字符串
+ * @returns {string} 连字符命名字符串
+ */
+function toKebabCase(str) {
+	return str.replace(/([a-z])([A-Z])/g, "$1-$2").toLowerCase();
+}
+
+// ============================================================================
+// 导出
+// ============================================================================
+
+export {
+	getProjectRoot,
+	getRelativePath,
+	ensureDirectoryExists,
+	copyRecursive,
+	cleanDirectory,
+	logger,
+	commandExists,
+	toCamelCase,
+	toKebabCase
+};