vue-i18n-extract-plugin 1.0.47

package/lib/translators/translator/Translator.js

@@ -0,0 +1,62 @@
+const { IntervalQueue } = require("./IntervalQueue");
+
+class Translator {
+  option = {};
+
+  constructor(option) {
+    this.option = this.getResultOption(option);
+  }
+
+  defaultErrorHandler = error => {
+    const name = this.option.name;
+    console.error(error);
+    console.error(
+      `翻译api${name ? `【${name}】` : ""}请求异常：${this.getErrorMessage(error)}`
+    );
+  };
+
+  getResultOption(option) {
+    const resultOption = {
+      version: 1,
+      maxChunkSize: 4500, // 目前默认是4500
+      interval: 0,
+      onError: this.defaultErrorHandler,
+      ...option
+    };
+    if (resultOption.interval) {
+      const getIntervalFn = (fn, delay) => {
+        const queue = new IntervalQueue(fn.bind(null), delay);
+        return (...args) => {
+          return queue.execute(...args);
+        };
+      };
+      resultOption.fetchMethod = getIntervalFn(
+        resultOption.fetchMethod,
+        resultOption.interval
+      );
+    }
+    return resultOption;
+  }
+
+  getErrorMessage(error) {
+    if (error instanceof Error) {
+      return error.message;
+    } else {
+      return String(error);
+    }
+  }
+
+  async translate(text, fromKey, toKey, separator) {
+    let result = "";
+    try {
+      result = await this.option.fetchMethod(text, fromKey, toKey, separator);
+    } catch (error) {
+      this.option.onError(error, this.defaultErrorHandler);
+    }
+    return result;
+  }
+}
+
+module.exports = {
+  Translator
+};

package/lib/translators/translator/index.js

@@ -0,0 +1,5 @@
+const { Translator } = require("./Translator");
+
+module.exports = {
+  Translator
+};

package/lib/translators/volcengine.js

@@ -0,0 +1,131 @@
+// 代码灵感来自https://github.com/dadidi9900/auto-plugins-json-translate/blob/main/src/services/translationService.ts
+const axios = require("axios");
+const { generateId } = require("../utils");
+const { Translator } = require("./translator");
+
+/**
+ * 火山引擎翻译器，内置豆包、deepseek等模型
+ * 
+ * 火山引擎大模型介绍：https://www.volcengine.com/docs/82379/1099455
+ * 
+ * api文档：https://www.volcengine.com/docs/82379/1298454
+ * 
+ * 使用方式：
+ * ```ts
+ * vitePluginI18n({
+    ...
+    translator: new VolcEngineTranslator({
+        apiKey: '你申请的apiKey',
+        model: '你要调用的模型，如：`doubao-1-5-pro-32k-250115`，请确保使用前已在控制台开通了对应模型'
+    })
+})
+ * ```
+ */
+class VolcEngineTranslator extends Translator {
+  constructor(option = {}) {
+    super({
+      name: "火山引擎ai翻译",
+      fetchMethod: async (text, fromKey, toKey, separator) => {
+        let salt = new Date().getTime();
+        const textArr = text.split(separator);
+        const sourceMap = Object.fromEntries(
+          textArr.map(text => [generateId(text), text])
+        );
+        const data = {
+          model: option.model,
+          messages: [
+            {
+              role: "system",
+              content: `
+                ###
+                假如你是一个专业的翻译助手，你将根据一个${option.desc ? option.desc + "的" : ""}web项目中使用的文本组成的JSON对象，来解决将数组每个成员从源语言A翻译成目标语言B并返回翻译后的JSON对象的任务。根据以下规则一步步执行：
+                1. 明确源语言A和目标语言B。
+                2. 对JSON对象中数组的每个成员进行从源语言A到目标语言B的翻译。
+                3. 将翻译后的内容以JSON对象格式返回。
+
+                参考例子：
+                示例1：
+                输入：zh-cn -> en { "awfgx": "你好", "qwfga": "世界" }
+                输出：{ "awfgx": "Hello", "qwfga": "World" }
+                说明：输出的英文句子如果较短，则每个单词的首字母大写，如果是长句子则保持原样。
+                示例: "查看详情" 翻译为 "View Details"，"优惠券发放时间" 翻译为 "Coupon Award Time"。
+                建议：句子单词数不超过3个时每个单词首字母大写，超过3个单词时保持原样。
+
+                示例2：
+                输入：de -> fr { "gweaq": "Hallo", "wtrts": "Welt" }
+                输出：{ "gweaq": "Bonjour", "wtrts": "Monde" }
+
+                请回答问题：
+                输入：源语言A -> 目标语言B { "wghhj": "XXX" }
+                输出：
+
+                要求：
+                1 以JSON对象格式输出
+                2 JSON对象中每个成员为翻译后的内容
+                3 翻译后的内容尽可能本土化、精准、自然、不丢失原意
+                4 保持JSON对象的键不变
+                5 如果无法翻译，请返回原内容
+                ###
+            `
+            },
+            {
+              role: "user",
+              content: `${fromKey} -> ${toKey} ${JSON.stringify(sourceMap)}`
+            }
+          ]
+        };
+        const response = await axios.post(
+          `https://ark.cn-beijing.volces.com/api/v3/chat/completions?t=${salt}`,
+          data,
+          {
+            headers: {
+              "Content-Type": "application/json",
+              Authorization: `Bearer ${option.apiKey}`
+            },
+            proxy: option.proxy
+          }
+        );
+
+        let resultTextArr = Array.from(textArr).fill("");
+        const content = response.data.choices[0].message.content;
+        try {
+          let resultMap;
+          try {
+            resultMap = JSON.parse(content);
+          } catch (error) {
+            throw new Error("大模型返回文本解析失败");
+          }
+          if (typeof resultMap !== "object" || !resultMap) {
+            throw new Error("大模型返回文本解析后类型不正确");
+          }
+          const isMiss = Object.keys(resultMap).some(
+            key => !(key in sourceMap)
+          );
+          if (isMiss) {
+            throw new Error("大模型返回文本内容不完整");
+          }
+          resultTextArr = textArr.map(text => resultMap[generateId(text)]); // 用textArr遍历，保证顺序
+        } catch (error) {
+          const message = error instanceof Error ? error.message : "未知错误";
+          console.warn("⚠", message);
+          console.warn("⚠ 返回的文本内容：", content);
+          console.warn("⚠ 原文本内容：", JSON.stringify(sourceMap));
+        }
+
+        return resultTextArr.join(separator);
+      },
+      onError: (error, cb) => {
+        cb(error);
+        console.error(
+          "请确保在火山引擎控制台开通了对应模型，且有足够的token余额。控制台地址：https://console.volcengine.com/ark/"
+        );
+      },
+      maxChunkSize: 1000, // 太长可能会导致返回文本不完整
+      interval: option.interval ?? 1000
+    });
+  }
+}
+
+module.exports = {
+  VolcEngineTranslator
+};

package/lib/translators/youdao.js

@@ -0,0 +1,89 @@
+const axios = require("axios");
+const { Translator } = require("./translator");
+const CryptoJS = require("crypto-js");
+
+/**
+ * 有道翻译器
+ * 
+ * api文档：https://ai.youdao.com/DOCSIRMA/html/trans/api/wbfy/index.html
+ * 
+ * 使用方式：
+ * ```ts
+ * vitePluginI18n({
+    ...
+    translator: new YoudaoTranslator({
+        appId: '你申请的appId',
+        appKey: '你申请的appKey'
+    })
+})
+ * ```
+ */
+class YoudaoTranslator extends Translator {
+  /** 有道的语言类型映射不标准，需要手动控制 */
+  YOUDAO_TRANSLATE_KEY_CONVERT_MAP = {
+    "zh-cn": "zh-CHS",
+    "zh-tw": "zh-CHT"
+  };
+
+  truncate(q) {
+    // 检查输入字符串的长度
+    if (q.length <= 20) {
+      // 如果长度小于等于20，直接返回原字符串
+      return q;
+    } else {
+      // 如果长度大于20，截取前10个字符和后10个字符，并在中间插入长度信息
+      const len = q.length;
+      return q.substring(0, 10) + len + q.substring(len - 10);
+    }
+  }
+
+  getTranslateKey(key) {
+    return this.YOUDAO_TRANSLATE_KEY_CONVERT_MAP[key] || key;
+  }
+
+  constructor(option = {}) {
+    super({
+      name: "有道翻译",
+      fetchMethod: async (text, fromKey, toKey) => {
+        let salt = new Date().getTime();
+        let curTime = Math.round(new Date().getTime() / 1000);
+        let str =
+          option.appId + this.truncate(text) + salt + curTime + option.appKey;
+        let sign = CryptoJS.SHA256(str).toString(CryptoJS.enc.Hex);
+        const data = {
+          q: text,
+          appKey: option.appId,
+          salt,
+          from: this.getTranslateKey(fromKey),
+          to: this.getTranslateKey(toKey),
+          sign,
+          signType: "v3",
+          curtime: curTime
+        };
+        const response = await axios.post(
+          "https://openapi.youdao.com/api",
+          data,
+          {
+            headers: {
+              "Content-Type": "application/x-www-form-urlencoded; charset=UTF-8"
+            },
+            proxy: option.proxy
+          }
+        );
+        // 请求成功，返回响应数据
+        return response.data.translation?.[0] || "";
+      },
+      onError: (error, cb) => {
+        cb(error);
+        console.error(
+          "请前往有道翻译官方申请翻译key，默认会有50的额度，并请检查额度是否充足。"
+        );
+      },
+      interval: option.interval ?? 1000
+    });
+  }
+}
+
+module.exports = {
+  YoudaoTranslator
+};

package/lib/utils.js

@@ -0,0 +1,234 @@
+const path = require("path");
+const fs = require("fs-extra");
+const crypto = require("crypto");
+const types = require("@babel/types");
+
+function hashKey(str) {
+  return crypto.createHash("sha512").update(str).digest("base64").slice(0, 6);
+}
+
+function generateId(text, length = 6) {
+  let hash = 5381; // 初始哈希值（素数基数）
+
+  // 1. 计算稳定哈希值
+  for (let i = 0; i < text.length; i++) {
+    hash = (hash * 33) ^ text.charCodeAt(i); // DJB2哈希变种
+  }
+
+  // 2. 生成6位字母数字组合（Base36编码）
+  return Math.abs(hash)
+    .toString(36) // 转为36进制（0-9a-z）
+    .padStart(length, "0")
+    .slice(-length);
+}
+
+function parseArg(arg) {
+  try {
+    if (
+      arg === "true" ||
+      arg === "false" ||
+      arg === "null" ||
+      arg.startsWith("[") ||
+      arg.startsWith("{")
+    ) {
+      return JSON.parse(arg);
+    }
+    return arg;
+  } catch (err) {
+    console.warn(`解析参数失败: ${arg}`, err);
+    // 可能是因为参数不是有效的 JSON 格式，直接返回原始字符串
+    return arg;
+  }
+}
+
+function isEmptyObject(obj) {
+  return Object.keys(obj).length === 0;
+}
+
+function checkAgainstRegexArray(value, regexArray = []) {
+  for (let i = 0; i < regexArray.length; i++) {
+    const regex =
+      typeof regexArray[i] === "string"
+        ? new RegExp(regexArray[i].replace(/\*/g, ""))
+        : regexArray[i];
+    if (regex.test(value)) {
+      return true; // 如果符合任何一个规则，返回 true
+    }
+  }
+  return false; // 如果所有规则都不符合，返回 false
+}
+
+/**
+ * @description: 用于解析抽象语法树中的调用表达式，并提取出调用的名称，如a.b.c() 取 c。
+ * @param {any} path
+ * @return {*}
+ */
+function extractFunctionName(path) {
+  const callPath = path.findParent(p => p.isCallExpression());
+  if (!callPath) return "";
+
+  const callee = callPath.node.callee;
+
+  let callName = "";
+  function callObjName(callObj, name) {
+    name = "." + callObj.property.name + name;
+    if (types.isMemberExpression(callObj.object)) {
+      return callObjName(callObj.object, name);
+    }
+    return callObj.object.name + name;
+  }
+
+  if (types.isMemberExpression(callee)) {
+    callName = callObjName(callee, "");
+  } else if (types.isIdentifier(callee)) {
+    callName = callee.name;
+  }
+
+  return callName;
+}
+
+function relativeCWDPath(subPath) {
+  const rPath = path.resolve(
+    fs.realpathSync(process.cwd()),
+    subPath.replace(/^\//, "").replace(/^@\//, "")
+  );
+  if (path.extname(rPath) !== "") {
+    return rPath;
+  }
+  return rPath.replace(/\/$/, "") + "/";
+}
+
+function getLangJsonPath(langKey, option) {
+  return (
+    relativeCWDPath(option.outputPath) +
+    option.customGenLangFileName(langKey) +
+    ".json"
+  );
+}
+
+function readJsonWithDefault(pathStr, defaultValue = {}) {
+  try {
+    if (!fs.existsSync(pathStr)) {
+      return defaultValue;
+    }
+    return fs.readJSONSync(pathStr) || defaultValue;
+  } catch (err) {
+    console.warn(`读取 JSON 文件失败: ${pathStr}`, err);
+    // 如果读取失败，返回默认值
+    return defaultValue;
+  }
+}
+
+function resolveAliasPath(pathStr) {
+  if (pathStr.startsWith("@/")) {
+    return "src" + pathStr.slice(1);
+  }
+  return pathStr;
+}
+
+function resolveFilterPath(pathStr) {
+  if (/\*/.test(pathStr)) {
+    // 如果包含通配符，直接返回原始路径
+    return pathStr;
+  }
+  pathStr = resolveAliasPath(pathStr);
+  if (path.extname(pathStr) !== "") {
+    return pathStr;
+  }
+  if (pathStr.endsWith("/")) {
+    return pathStr + "**";
+  }
+  return pathStr + "/**";
+}
+
+function fixFolderPath(pathStr) {
+  if (pathStr instanceof RegExp) {
+    pathStr = pathStr.source.replace(/\\/g, "").replace(/\/\//, "/");
+  }
+  pathStr = resolveAliasPath(pathStr);
+  if (pathStr.endsWith("/")) {
+    return pathStr;
+  }
+  return pathStr + "/";
+}
+
+function sleep(ms) {
+  return new Promise(resolve => setTimeout(resolve, ms));
+}
+
+function shouldExtract(str, langKey) {
+  if (REGEX_MAP[langKey]) {
+    return REGEX_MAP[langKey].test(str);
+  }
+  return REGEX_MAP[translateLangKeyEnum.ZH].test(str);
+}
+
+function trimEmptyLine(str) {
+  return str.replace(/^\n+|\n+$/g, "");
+}
+
+function padEmptyLine(str) {
+  return "\n" + str + "\n";
+}
+
+const translateLangKeyEnum = {
+  ZH: "zh-cn",
+  EN: "en",
+  JA: "ja",
+  KO: "ko",
+  RU: "ru"
+};
+const REGEX_MAP = {
+  [translateLangKeyEnum.ZH]: /[\u4e00-\u9fff]/,
+  [translateLangKeyEnum.EN]: /[a-zA-Z]/,
+  [translateLangKeyEnum.JA]: /[\u3040-\u309F\u30A0-\u30FF\u4E00-\u9FFF]/, // 日语假名和汉字
+  [translateLangKeyEnum.KO]: /[\uAC00-\uD7A3]/, // 韩语字母
+  [translateLangKeyEnum.RU]: /[йцукенгшщзхъфывапролджэячсмитьбюё .-]{1,}/ // 俄语字母
+};
+const excludeDirectives = [
+  "model",
+  "slot",
+  "if",
+  "show",
+  "for",
+  "on",
+  "once",
+  "memo"
+];
+const EXCLUDED_CALL = [
+  "$deepScan",
+  "console.log",
+  "console.info",
+  "console.warn",
+  "console.error",
+  "$i8n",
+  "$t",
+  "require",
+  "$$i8n",
+  "$$t",
+  "$emit",
+  "$emits",
+  "emits",
+  "_createCommentVNode"
+];
+
+module.exports = {
+  hashKey,
+  generateId,
+  parseArg,
+  isEmptyObject,
+  checkAgainstRegexArray,
+  extractFunctionName,
+  relativeCWDPath,
+  getLangJsonPath,
+  readJsonWithDefault,
+  resolveAliasPath,
+  resolveFilterPath,
+  fixFolderPath,
+  sleep,
+  shouldExtract,
+  trimEmptyLine,
+  padEmptyLine,
+  excludeDirectives,
+  EXCLUDED_CALL
+};