utiller 1.0.381 → 1.0.383

package/lib/utiller/index.js

@@ -306,6 +306,89 @@ var Utiller = /*#__PURE__*/function () {
         minimumFractionDigits: 0 // 確保不顯示小數
       }).format(number);
     });
+    /**
+     * 使用 ES10+ 和 Lodash，將短句子轉換為潛在的搜尋關鍵字陣列。
+     * 策略：1. 提取英文單字 2. 提取規格/色號詞組 3. 清理中文 4. 窮舉中文 N-gram 5. 去重和過濾
+     * @param {string} sentence - 原始字串。
+     * @param {number} [maxLength=50] - 允許的最大字串長度。
+     * @param {number} [maxNgramLength=3] - N-gram 的最大長度，預設為 3。
+     * @returns {string[]} - 潛在關鍵字陣列（至少 2 個字/中文字）。
+     */
+    (0, _defineProperty2["default"])(this, "generateUniversalKeywords", function (sentence) {
+      var maxLength = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : 50;
+      var maxNgramLength = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : 4;
+      // 引入 Lodash，確保在執行環境中可用
+      if (!sentence || typeof sentence !== "string") {
+        return [];
+      }
+
+      // 假設 Lodash 已經全域引入為 '_'
+      if (typeof _lodash["default"] === "undefined") {
+        console.error("Lodash is not available. Please ensure it is imported.");
+        return [];
+      }
+      var textToProcess = sentence.trim();
+      var keywords = []; // 最終所有關鍵字的集合
+
+      // 參數安全檢查 (確保 N-gram 長度至少為 2)
+      maxNgramLength = Math.max(2, maxNgramLength);
+
+      // 警告/截斷邏輯
+      if (textToProcess.length > maxLength) {
+        console.warn("\u8B66\u544A\uFF1A\u8F38\u5165\u5B57\u4E32\u9577\u5EA6\u70BA ".concat(textToProcess.length, "\uFF0C\u5DF2\u6839\u64DA maxLength: ").concat(maxLength, " \u622A\u65B7\u3002"));
+        textToProcess = textToProcess.substring(0, maxLength);
+      }
+
+      // --- 步驟 1: 提取完整英文單字 (SACHIA, sachia, Sachia) ---
+      var englishWords = textToProcess.match(/[a-zA-Z]+/g) || [];
+      englishWords.forEach(function (word) {
+        if (word.length >= 2) {
+          keywords.push(word.toUpperCase());
+          keywords.push(word.toLowerCase());
+          var capitalized = word.charAt(0).toUpperCase() + word.slice(1).toLowerCase();
+          keywords.push(capitalized);
+        }
+      });
+
+      // --- 步驟 2: 提取規格、數量和色號關鍵字 (12W, 10ml, 10色, 1號) ---
+      var specKeywordsRegex = /\b[0-9]+[a-zA-Z]{1,4}\b|\b[0-9]{1,3}(w|ml|g|oz|k)\b|[\u4e00-\u9fa5a-zA-Z0-9]{1,4}(色|號)[\u4e00-\u9fa5a-zA-Z0-9]{0,2}/gi;
+      var specKeywords = (textToProcess.match(specKeywordsRegex) || []).filter(function (k) {
+        return k.length >= 2;
+      }).map(function (k) {
+        return k.toLowerCase();
+      });
+      keywords.push.apply(keywords, (0, _toConsumableArray2["default"])(specKeywords));
+
+      // --- 步驟 3: 清理和標準化 (用於 N-gram 提取) ---
+
+      var cleanText = textToProcess.toLowerCase();
+
+      // 1. 將所有提取過的規格詞彙（數字+單位/字母）替換為空格
+      cleanText = cleanText.replace(/[0-9]+([\u4e00-\u9fa5a-z]{1,4}|[\/\-\~\\])/g, " ").replace(/\b[a-z]{1,4}\b/g, " ").replace(/\b[0-9]{1,3}\b/g, " ");
+
+      // 2. 移除通用詞和符號
+      cleanText = cleanText.replace(/[!@#$%^&*()_+={}\[\]:;"'<>,.?\/\\|`~]/g, " ").replace(/系列|一組|單色|多款|套組|全套|專用|迷你|頂級|高品質|超閃|奢華|最新|款式|新款|超亮|的|與|和|閃|美甲/g, " ").replace(/\s+/g, "") // **移除所有空格**
+      .trim();
+
+      // --- 步驟 4: 窮舉所有 >= 2 個字的 N-gram 詞組 (針對純中文) ---
+      var minLength = 2;
+      // maxNgramLength 現在是從參數傳入的
+
+      for (var len = minLength; len <= maxNgramLength; len++) {
+        for (var i = 0; i <= cleanText.length - len; i++) {
+          var keyword = cleanText.substring(i, i + len);
+          keywords.push(keyword);
+        }
+      }
+
+      // --- 步驟 5: 標準化、去重和過濾 ---
+      var finalKeywords = _lodash["default"].chain(keywords).filter(function (k) {
+        return k.length >= 2;
+      }).filter(function (k) {
+        return k.length > 2 || !/^[\u4e00-\u9fa5a-z0-9]$/.test(k);
+      }).uniq().sortBy().value();
+      return finalKeywords;
+    });
     /**
      * 直接修改原本 array，將 object 移動到指定 index
      * @param {Array} array - 要修改的陣列
@@ -4059,14 +4142,14 @@ var Utiller = /*#__PURE__*/function () {
       }).keys().compact() // 移除 null、undefined、''、0、false、NaN
       .value();
     }
-
+  }, {
+    key: "getObjectOfSpecifyKey",
+    value:
     /**
      * 減少不必要的{}
      * 例如 array.map(each => {return {key,value}})
      **/
-  }, {
-    key: "getObjectOfSpecifyKey",
-    value: function getObjectOfSpecifyKey(value, key) {
+    function getObjectOfSpecifyKey(value, key) {
       var object = {};
       object[key] = value;
       return object;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "utiller",
-  "version": "1.0.381",
+  "version": "1.0.383",
   "description": "",
   "main": "index.js",
   "scripts": {

package/template/sample.package.json

@@ -11,7 +11,7 @@
   "license": "ISC",
   "dependencies": {
     "configerer": "^1.0.23",
-    "utiller": "^1.0.380",
+    "utiller": "^1.0.382",
     "linepayer": "^1.0.15",
     "databazer": "^1.0.17",
     "lodash": "^4.17.20",