nodejieba-plus 3.5.13 → 3.5.17

package/README.md

@@ -1,38 +1,38 @@
-[![Build Status](https://github.com/yanyiwu/nodejieba/actions/workflows/test.yml/badge.svg)](https://github.com/yanyiwu/nodejieba/actions/workflows/test.yml)
-[![Financial Contributors on Open Collective](https://opencollective.com/nodejieba/all/badge.svg?label=financial+contributors)](https://opencollective.com/nodejieba) [![Author](https://img.shields.io/badge/author-@yanyiwu-blue.svg?style=flat)](https://github.com/yanyiwu/) 
-[![Platform](https://img.shields.io/badge/platform-Linux,macOS,Windows-green.svg?style=flat)](https://github.com/yanyiwu/nodejieba)
-[![Performance](https://img.shields.io/badge/performance-excellent-brightgreen.svg?style=flat)](https://github.com/yanyiwu/blog/blob/posts2023archive/_posts/2015-06-14-jieba-series-performance-test.md) 
-[![License](https://img.shields.io/badge/license-MIT-yellow.svg?style=flat)](http://yanyiwu.mit-license.org)
-[![NpmDownload Status](http://img.shields.io/npm/dm/nodejieba.svg)](https://www.npmjs.org/package/nodejieba)
-[![NPM Version](https://img.shields.io/npm/v/nodejieba.svg?style=flat)](https://www.npmjs.org/package/nodejieba)
-[![Code Climate](https://codeclimate.com/github/yanyiwu/nodejieba/badges/gpa.svg)](https://codeclimate.com/github/yanyiwu/nodejieba)
+[!\[Build Status\](https://github.com/yanyiwu/nodejieba/actions/workflows/test.yml/badge.svg null)](https://github.com/yanyiwu/nodejieba/actions/workflows/test.yml)
+[!\[Financial Contributors on Open Collective\](https://opencollective.com/nodejieba/all/badge.svg?label=financial+contributors null)](https://opencollective.com/nodejieba) [!\[Author\](https://img.shields.io/badge/author-@yanyiwu-blue.svg?style=flat null)](https://github.com/yanyiwu/)
+[!\[Platform\](https://img.shields.io/badge/platform-Linux,macOS,Windows-green.svg?style=flat null)](https://github.com/yanyiwu/nodejieba)
+[!\[Performance\](https://img.shields.io/badge/performance-excellent-brightgreen.svg?style=flat null)](https://github.com/yanyiwu/blog/blob/posts2023archive/_posts/2015-06-14-jieba-series-performance-test.md)
+[!\[License\](https://img.shields.io/badge/license-MIT-yellow.svg?style=flat null)](http://yanyiwu.mit-license.org)
+[!\[NpmDownload Status\](http://img.shields.io/npm/dm/nodejieba.svg null)](https://www.npmjs.org/package/nodejieba)
+[!\[NPM Version\](https://img.shields.io/npm/v/nodejieba.svg?style=flat null)](https://www.npmjs.org/package/nodejieba)
+[!\[Code Climate\](https://codeclimate.com/github/yanyiwu/nodejieba/badges/gpa.svg null)](https://codeclimate.com/github/yanyiwu/nodejieba)
 
-- - -
+***
 
 # NodeJieba "结巴"分词的Node.js版本
 
-## 介绍 
+## 介绍
 
 `NodeJieba`是"结巴"中文分词的 Node.js 版本实现，
-由[CppJieba]提供底层分词算法实现，
+由[CppJieba](https://github.com/yanyiwu/cppjieba.git)提供底层分词算法实现，
 是兼具高性能和易用性两者的 Node.js 中文分词组件。
 
 ## 特点
 
-+ 词典载入方式灵活，无需配置词典路径也可使用，需要定制自己的词典路径时也可灵活定制。
-+ 底层算法实现是C++，性能高效。
-+ 支持多种分词算法，各种分词算法见[CppJieba]的README.md介绍。
-+ 支持动态补充词库。
-+ 支持TypeScript，提供完整的类型定义。
-+ **支持包含空格的关键词**（如 "Open Claw"）。
-+ **支持无空格版本匹配**（如 "OpenClaw" 可匹配 "Open Claw"）。
-+ **支持英文大小写不敏感匹配**（如 "open claw"、"OPEN CLAW" 都可匹配 "Open Claw"）。
-+ **支持批量加载用户词典**（字符串数组、单个字符串、Buffer 格式）。
+- 词典载入方式灵活，无需配置词典路径也可使用，需要定制自己的词典路径时也可灵活定制。
+- 底层算法实现是C++，性能高效。
+- 支持多种分词算法，各种分词算法见[CppJieba](https://github.com/yanyiwu/cppjieba.git)的README.md介绍。
+- 支持动态补充词库。
+- 支持TypeScript，提供完整的类型定义。
+- **支持包含空格的关键词**（如 "Open Claw"）。
+- **支持无空格版本匹配**（如 "Open Claw" 可匹配 "OpenClaw"）。
+- **支持英文大小写不敏感匹配**（如 "open claw"、"OPEN CLAW" 都可匹配 "Open Claw"）。
+- **支持批量加载用户词典**（字符串数组、单个字符串、Buffer 格式）。
 
 对实现细节感兴趣的请看如下博文：
 
-+ [Node.js的C++扩展初体验之NodeJieba] 
-+ [由NodeJieba谈谈Node.js异步实现] 
+- [Node.js的C++扩展初体验之NodeJieba](https://github.com/yanyiwu/blog/blob/posts2023archive/_posts/2014-02-22-nodejs-cpp-addon-nodejieba.md)
+- [由NodeJieba谈谈Node.js异步实现](https://github.com/yanyiwu/blog/blob/posts2023archive/_posts/2015-03-21-nodejs-asynchronous-insight.md)
 
 ## 安装
 
@@ -88,11 +88,11 @@ nodejieba.load({
 
 #### 词典说明
 
-+ dict: 主词典，带权重和词性标签，建议使用默认词典。
-+ hmmDict: 隐式马尔科夫模型，建议使用默认词典。
-+ userDict: 用户词典，建议自己根据需要定制。
-+ idfDict: 关键词抽取所需的idf信息。
-+ stopWordDict: 关键词抽取所需的停用词列表。
+- dict: 主词典，带权重和词性标签，建议使用默认词典。
+- hmmDict: 隐式马尔科夫模型，建议使用默认词典。
+- userDict: 用户词典，建议自己根据需要定制。
+- idfDict: 关键词抽取所需的idf信息。
+- stopWordDict: 关键词抽取所需的停用词列表。
 
 ## API 文档
 
@@ -211,13 +211,77 @@ nodejieba.loadUserDict(dictSet);
 // 方式3：使用单个字符串
 nodejieba.loadUserDict("区块链");
 
-// 方式4：使用 Buffer
+// 方式4：使用 Buffer（必须是 UTF-8 编码）
 const dictBuffer = Buffer.from("新词1\n新词2 100 n\n新词3 nz");
 nodejieba.loadUserDict(dictBuffer);
 
+// 注意：Buffer 必须是 UTF-8 编码，其他编码可能导致乱码或加载失败
+
 // 分词时会识别用户词典中的词
 var result = nodejieba.cut("云计算和大数据是人工智能的基础");
 console.log(result); // ['云计算', '和', '大数据', '是', '人工智能', '的', '基础']
+
+// 关键词提取时，用户词典中的词会自动获得更高的权重（默认2倍）
+var keywords = nodejieba.extract("云计算和大数据是人工智能的基础", 5);
+console.log(keywords); // 用户词典中的词排名会显著提升
+```
+
+#### 用户词典权重提升机制（新功能）
+
+从 v3.5.16 开始，加载用户词典时会自动为词典中的词设置更高的 IDF 权重，确保在关键词提取时获得更高的排名：
+
+**自动权重提升**：
+- 加载用户词典后，词典中的词会自动获得 **1.3 倍 IDF 权重**
+- 这意味着用户词典中的词在关键词提取时会优先显示
+
+**手动设置权重**：
+```js
+// 方式1：设置具体的 IDF 值
+nodejieba.setIdf("Open Claw", 30.0);
+
+// 方式2：使用倍数提升权重（默认1.3倍）
+nodejieba.setIdf("Open Claw");  // 1.3倍权重
+
+// 方式3：自定义倍数
+nodejieba.setIdf("Open Claw", null, 2.0);  // 2倍权重
+```
+
+#### IDF 词典支持空格关键词（新功能）
+
+从 v3.5.16 开始，IDF 词典支持包含空格的关键词：
+
+**IDF 词典格式**：
+```
+# 普通关键词
+互动 12.0
+
+# 包含空格的关键词
+Open Claw 30.0
+Machine Learning 25.0
+Deep Learning 28.0
+```
+
+**使用示例**：
+```js
+var nodejieba = require("nodejieba");
+
+// 加载包含空格关键词的 IDF 词典
+nodejieba.load({
+  idfDict: "./custom_idf.txt"
+});
+
+// 加载用户词典（同时需要分词词典支持）
+nodejieba.loadUserDict(["Open Claw", "Machine Learning", "Deep Learning"]);
+
+// 关键词提取时会正确识别包含空格的词
+var keywords = nodejieba.extract("Open Claw和Machine Learning都是Deep Learning的基础", 5);
+console.log(keywords);
+// 输出: [
+//   { word: 'Open Claw', weight: 30.00 },
+//   { word: 'Deep Learning', weight: 28.00 },
+//   { word: 'Machine Learning', weight: 25.00 },
+//   ...
+// ]
 ```
 
 #### 词典条目格式
@@ -242,76 +306,72 @@ console.log(result); // ['云计算', '和', '大数据', '是', '人工智能',
 
 支持在自定义词典中使用包含空格的关键词，且支持无空格版本匹配和大小写不敏感匹配。
 
+**注意**：本版本已移除空格作为默认分隔符，因此包含空格的关键词可以正确匹配文本中的对应内容，不会被分割。
+
 #### 用户词典格式
 
 用户词典支持以下格式：
 
 ```
-# 只有关键词
+# 只有关键词（包含空格）
 Open Claw
+Game Master
 
-# 关键词 + 词性标签
-Open Claw n
+# 关键词 + 词频（仅支持单关键词，不支持包含空格的关键词+词频）
+人工智能 1000
 
-# 关键词 + 词频 + 词性标签
+# 关键词 + 词频 + 词性标签（支持包含空格的关键词）
 Open Claw 100 n
+Machine Learning 200 n
 
 # 包含多个空格的关键词
-Machine Learning 200 n
 Artificial Intelligence 300 n
+Deep Learning 400 n
 ```
 
+**格式说明**：
+
+- 当词典行只有关键词时（如 `Open Claw`），整个字符串作为关键词
+- 当词典行有词频时（如 `人工智能 1000`），第一个部分是关键词，第二个是词频
+- 当词典行有三个部分且倒数第二个是数字时（如 `Open Claw 100 n`），前面的部分组成关键词，后面是词频和词性
+
 #### 使用示例
 
 ```js
 var nodejieba = require("nodejieba");
-var fs = require('fs');
-var path = require('path');
-
-// 创建包含空格关键词的用户词典
-var dictContent = `Open Claw 100 n
-Machine Learning 200 n
-Artificial Intelligence 300 n
-`;
+nodejieba.load();
 
-var testDictPath = path.join(__dirname, 'user_dict.utf8');
-fs.writeFileSync(testDictPath, dictContent);
+// 方式1：使用 loadUserDict 加载包含空格的关键词
+nodejieba.loadUserDict(["Open Claw 100 n", "Game Master"]);
 
-// 加载词典
-nodejieba.load({
-  userDict: testDictPath,
-});
+// 方式2：使用 insertWord 添加包含空格的关键词
+nodejieba.insertWord("Deep Learning");
 
 // 测试1: 包含空格的关键词匹配
-console.log(nodejieba.cut("I want to use Open Claw tool"));
-// 输出包含: ['Open Claw']
+console.log(nodejieba.cut("I like Open Claw game"));
+// 输出: ['I', ' ', 'l', 'i', 'k', 'e', ' ', 'Open Claw', ' ', 'g', 'a', 'm', 'e']
 
-// 测试2: 大小写不敏感匹配
+// 测试2: 在中文句子中匹配
+console.log(nodejieba.cut("Open Claw和Game Master都是好游戏"));
+// 输出: ['Open Claw', '和', 'Game Master', '都', '是', '好', '游戏']
+
+// 测试3: 大小写不敏感匹配
 console.log(nodejieba.cut("open claw"));        // 匹配 Open Claw
 console.log(nodejieba.cut("OPEN CLAW"));        // 匹配 Open Claw
 console.log(nodejieba.cut("Open Claw"));        // 匹配 Open Claw
 
-// 测试3: 无空格版本匹配
+// 测试4: 无空格版本匹配
 console.log(nodejieba.cut("OpenClaw"));         // 匹配 Open Claw
 console.log(nodejieba.cut("openclaw"));         // 匹配 Open Claw
 console.log(nodejieba.cut("OPENCLAW"));         // 匹配 Open Claw
-
-// 测试4: 其他包含空格的关键词
-console.log(nodejieba.cut("Machine Learning is great"));
-// 输出包含: ['Machine Learning']
-
-console.log(nodejieba.cut("Artificial Intelligence will change the world"));
-// 输出包含: ['Artificial Intelligence']
-
-// 清理测试文件
-fs.unlinkSync(testDictPath);
 ```
 
 #### 功能说明
 
-1. **包含空格的关键词**: 词典中的 "Open Claw" 可以匹配文本中的 "Open Claw"
+1. **包含空格的关键词**: 词典中的 "Open Claw" 可以匹配文本中的 "Open Claw"（不会被分割）
 2. **无空格版本匹配**: 词典中的 "Open Claw" 也可以匹配文本中的 "OpenClaw"
 3. **大小写不敏感**: 词典中的 "Open Claw" 可以匹配 "open claw"、"OPEN CLAW"、"Open Claw" 等任意大小写组合
+4. **自动生成变体**: 添加包含空格的关键词时，会自动生成无空格版本和小写版本，确保各种变体都能匹配
 
 More Detals in [demo](https://github.com/yanyiwu/nodejieba-demo)
 
@@ -347,37 +407,23 @@ npm test
 
 ## 应用
 
-+ 支持中文搜索的 gitbook 插件: [gitbook-plugin-search-pro]
-+ 汉字拼音转换工具: [pinyin]
+- 支持中文搜索的 gitbook 插件: [gitbook-plugin-search-pro](https://plugins.gitbook.com/plugin/search-pro)
+- 汉字拼音转换工具: [pinyin](https://github.com/hotoo/pinyin)
 
 ## 性能评测
 
 应该是目前性能最好的 Node.js 中文分词库
-详见: [Jieba中文分词系列性能评测]
-
-
-[由NodeJieba谈谈Node.js异步实现]:https://github.com/yanyiwu/blog/blob/posts2023archive/_posts/2015-03-21-nodejs-asynchronous-insight.md
-[Node.js的C++扩展初体验之NodeJieba]:https://github.com/yanyiwu/blog/blob/posts2023archive/_posts/2014-02-22-nodejs-cpp-addon-nodejieba.md
-[CppJieba]:https://github.com/yanyiwu/cppjieba.git
-[cnpm]:http://cnpmjs.org
-[Jieba中文分词]:https://github.com/fxsjy/jieba
-
-[Jieba中文分词系列性能评测]:https://github.com/yanyiwu/blog/blob/posts2023archive/_posts/2015-06-14-jieba-series-performance-test.md
-[contributors]:https://github.com/yanyiwu/nodejieba/graphs/contributors
-[YanyiWu]:http://github.com/yanyiwu
-[gitbook-plugin-search-pro]:https://plugins.gitbook.com/plugin/search-pro
-[pinyin]:https://github.com/hotoo/pinyin
+详见: [Jieba中文分词系列性能评测](https://github.com/yanyiwu/blog/blob/posts2023archive/_posts/2015-06-14-jieba-series-performance-test.md)
 
 ## Contributors
 
 ### Code Contributors
 
-This project exists thanks to all the people who contribute. [[Contribute](CONTRIBUTING.md)].
-<a href="https://github.com/yanyiwu/nodejieba/graphs/contributors"><img src="https://opencollective.com/nodejieba/contributors.svg?width=890&button=false" /></a>
+This project exists thanks to all the people who contribute. \[[Contribute](CONTRIBUTING.md)]. <a href="https://github.com/yanyiwu/nodejieba/graphs/contributors"><img src="https://opencollective.com/nodejieba/contributors.svg?width=890&button=false" /></a>
 
 ### Financial Contributors
 
-Become a financial contributor and help us sustain our community. [[Contribute](https://opencollective.com/nodejieba/contribute)]
+Become a financial contributor and help us sustain our community. \[[Contribute](https://opencollective.com/nodejieba/contribute)]
 
 #### Individuals
 
@@ -385,15 +431,6 @@ Become a financial contributor and help us sustain our community. [[Contribute](
 
 #### Organizations
 
-Support this project with your organization. Your logo will show up here with a link to your website. [[Contribute](https://opencollective.com/nodejieba/contribute)]
-
-<a href="https://opencollective.com/nodejieba/organization/0/website"><img src="https://opencollective.com/nodejieba/organization/0/avatar.svg"></a>
-<a href="https://opencollective.com/nodejieba/organization/1/website"><img src="https://opencollective.com/nodejieba/organization/1/avatar.svg"></a>
-<a href="https://opencollective.com/nodejieba/organization/2/website"><img src="https://opencollective.com/nodejieba/organization/2/avatar.svg"></a>
-<a href="https://opencollective.com/nodejieba/organization/3/website"><img src="https://opencollective.com/nodejieba/organization/3/avatar.svg"></a>
-<a href="https://opencollective.com/nodejieba/organization/4/website"><img src="https://opencollective.com/nodejieba/organization/4/avatar.svg"></a>
-<a href="https://opencollective.com/nodejieba/organization/5/website"><img src="https://opencollective.com/nodejieba/organization/5/avatar.svg"></a>
-<a href="https://opencollective.com/nodejieba/organization/6/website"><img src="https://opencollective.com/nodejieba/organization/6/avatar.svg"></a>
-<a href="https://opencollective.com/nodejieba/organization/7/website"><img src="https://opencollective.com/nodejieba/organization/7/avatar.svg"></a>
-<a href="https://opencollective.com/nodejieba/organization/8/website"><img src="https://opencollective.com/nodejieba/organization/8/avatar.svg"></a>
-<a href="https://opencollective.com/nodejieba/organization/9/website"><img src="https://opencollective.com/nodejieba/organization/9/avatar.svg"></a>
+Support this project with your organization. Your logo will show up here with a link to your website. \[[Contribute](https://opencollective.com/nodejieba/contribute)]
+
+<a href="https://opencollective.com/nodejieba/organization/0/website"><img src="https://opencollective.com/nodejieba/organization/0/avatar.svg"></a> <a href="https://opencollective.com/nodejieba/organization/1/website"><img src="https://opencollective.com/nodejieba/organization/1/avatar.svg"></a> <a href="https://opencollective.com/nodejieba/organization/2/website"><img src="https://opencollective.com/nodejieba/organization/2/avatar.svg"></a> <a href="https://opencollective.com/nodejieba/organization/3/website"><img src="https://opencollective.com/nodejieba/organization/3/avatar.svg"></a> <a href="https://opencollective.com/nodejieba/organization/4/website"><img src="https://opencollective.com/nodejieba/organization/4/avatar.svg"></a> <a href="https://opencollective.com/nodejieba/organization/5/website"><img src="https://opencollective.com/nodejieba/organization/5/avatar.svg"></a> <a href="https://opencollective.com/nodejieba/organization/6/website"><img src="https://opencollective.com/nodejieba/organization/6/avatar.svg"></a> <a href="https://opencollective.com/nodejieba/organization/7/website"><img src="https://opencollective.com/nodejieba/organization/7/avatar.svg"></a> <a href="https://opencollective.com/nodejieba/organization/8/website"><img src="https://opencollective.com/nodejieba/organization/8/avatar.svg"></a> <a href="https://opencollective.com/nodejieba/organization/9/website"><img src="https://opencollective.com/nodejieba/organization/9/avatar.svg"></a>

package/analyze_weight.js

@@ -0,0 +1,57 @@
+var nodejieba = require("./index.js");
+
+console.log("=== 关键词提取权重机制分析 ===\n");
+
+nodejieba.load();
+
+const content = "疯狂动物城 疯狂动物城 疯狂动物城 这是一个二次开发的项目，整合了原版的动画及Open Claw打包制作了MAC安装包，它可以出Open Claw现在你的系统桌面的任何地方，也会随互动有特定的动作，还蛮有意思的项目地址：https://github.com/justaLoli/VPet-Mac云盘：https://pan.quark.cn/s/62596470429a功能：✅开始、关闭、正常效果的动画播放✅拖动效果✅「互动」菜单里的互动，即睡觉、学习、工作等（带计时器，但没有经验、金钱加成）✅自动事件（发呆、待机、睡觉等）✅桌宠自动移动✅摸头预览";
+
+console.log("【问题分析】");
+console.log("关键词提取权重 = TF（词频）× IDF（逆文档频率）\n");
+
+console.log("步骤1: 查看分词结果");
+var cutResult = nodejieba.cut(content);
+console.log("分词结果:", cutResult.slice(0, 30));
+
+console.log("\n步骤2: 统计词频（TF）");
+var wordFreq = {};
+cutResult.forEach(word => {
+  wordFreq[word] = (wordFreq[word] || 0) + 1;
+});
+
+console.log("\n高频词（出现2次以上）:");
+Object.entries(wordFreq)
+  .filter(([word, freq]) => freq >= 2)
+  .sort((a, b) => b[1] - a[1])
+  .forEach(([word, freq]) => {
+    console.log(`  ${word}: ${freq}次`);
+  });
+
+console.log("\n步骤3: 提取关键词（未加载用户词典）");
+var extractResult1 = nodejieba.extract(content, 20);
+console.log("关键词及权重:");
+extractResult1.forEach((item, i) => {
+  console.log(`  ${i + 1}. ${item.word}: ${item.weight.toFixed(2)} (出现${wordFreq[item.word] || 1}次)`);
+});
+
+console.log("\n步骤4: 加载用户词典");
+nodejieba.loadUserDict("Open Claw 10 n");
+
+console.log("\n步骤5: 再次提取关键词");
+var extractResult2 = nodejieba.extract(content, 20);
+console.log("关键词及权重:");
+extractResult2.forEach((item, i) => {
+  console.log(`  ${i + 1}. ${item.word}: ${item.weight.toFixed(2)} (出现${wordFreq[item.word] || 1}次)`);
+});
+
+console.log("\n【核心问题】");
+console.log("1. 'Open Claw' 出现了 2 次（TF = 2）");
+console.log("2. '互动' 出现了 2 次（TF = 2）");
+console.log("3. 但 '互动' 的权重可能更高，因为：");
+console.log("   - '互动' 在 IDF 词典中有专门的权重值");
+console.log("   - 'Open Claw' 不在 IDF 词典中，使用平均 IDF 值");
+console.log("4. 如果 '互动' 的 IDF 值 > 平均 IDF 值，则权重更高");
+
+console.log("\n【解决方案】");
+console.log("需要为用户词典中的词设置 IDF 权重！");
+console.log("建议：在 loadUserDict 时，自动为用户词典中的词设置较高的 IDF 值");

package/diagnose_priority.js

@@ -0,0 +1,71 @@
+var nodejieba = require("./index.js");
+
+console.log("=== 问题诊断：Open Claw 未被识别 ===\n");
+
+console.log("【问题原因分析】");
+console.log("1. 用户词典必须在调用 extract() 之前加载");
+console.log("2. 用户词典会影响分词结果，进而影响关键词提取");
+console.log("3. 关键词提取依赖于分词结果和 IDF 权重\n");
+
+console.log("=== 测试场景 1: 错误用法（先提取后加载）===");
+nodejieba.load();
+const content = "这是一个Open Claw项目，Open Claw很好玩";
+
+console.log("步骤1: 先提取关键词（未加载用户词典）");
+var result1 = nodejieba.extract(content, 5);
+console.log("关键词:", result1.map(r => r.word));
+console.log("说明: 此时 'Open Claw' 被拆分成单个字母\n");
+
+console.log("步骤2: 再加载用户词典");
+nodejieba.loadUserDict("Open Claw 10 n");
+console.log("词典已加载\n");
+
+console.log("步骤3: 再次提取关键词");
+var result2 = nodejieba.extract(content, 5);
+console.log("关键词:", result2.map(r => r.word));
+console.log("说明: 此时 'Open Claw' 已被正确识别\n");
+
+console.log("=== 测试场景 2: 正确用法（先加载后提取）===");
+console.log("重新初始化...");
+delete require.cache[require.resolve('./index.js')];
+var nodejieba2 = require("./index.js");
+
+console.log("步骤1: 先加载词典");
+nodejieba2.load();
+nodejieba2.loadUserDict("Open Claw 10 n");
+console.log("词典已加载\n");
+
+console.log("步骤2: 再提取关键词");
+var result3 = nodejieba2.extract(content, 5);
+console.log("关键词:", result3.map(r => r.word));
+console.log("说明: 'Open Claw' 被正确识别\n");
+
+console.log("=== 测试场景 3: 检查优先级 ===");
+console.log("测试: 用户词典 vs 默认词典\n");
+
+var testCases = [
+  "Open Claw",
+  "Open Claw是一个项目",
+  "我喜欢Open Claw这个游戏"
+];
+
+testCases.forEach((text, i) => {
+  console.log(`测试 ${i + 1}: "${text}"`);
+  var cut = nodejieba2.cut(text);
+  var extract = nodejieba2.extract(text, 3);
+  console.log("  分词:", cut);
+  console.log("  关键词:", extract.map(r => r.word));
+  console.log("  包含 'Open Claw':", cut.includes("Open Claw"));
+  console.log();
+});
+
+console.log("=== 解决方案 ===");
+console.log("✅ 正确做法:");
+console.log("   1. 先调用 nodejieba.load()");
+console.log("   2. 再调用 nodejieba.loadUserDict('Open Claw 10 n')");
+console.log("   3. 最后调用 nodejieba.extract()");
+console.log();
+console.log("❌ 错误做法:");
+console.log("   1. 先调用 nodejieba.extract()");
+console.log("   2. 再调用 nodejieba.loadUserDict()");
+console.log("   （此时词典不会影响已提取的结果）");

package/index.js

@@ -74,6 +74,7 @@ wrapWithDictLoad("extract");
 wrapWithDictLoad("textRankExtract");
 wrapWithDictLoad("insertWord");
 wrapWithDictLoad("loadUserDict");
+wrapWithDictLoad("setIdf");
 
 // 保存原始的 loadUserDict 函数
 var _loadUserDict = exports.loadUserDict;
@@ -84,11 +85,18 @@ exports.loadUserDict = function (dict) {
     exports.load();
   }
   
-  // 如果是 Set 对象，转换为数组
+  if (dict === null || dict === undefined) {
+    return false;
+  }
+  
   if (dict instanceof Set) {
     dict = Array.from(dict);
   }
   
+  if (typeof dict !== 'string' && !Array.isArray(dict) && !Buffer.isBuffer(dict)) {
+    throw new TypeError('dict must be string, string[], Set<string>, or Buffer');
+  }
+  
   return _loadUserDict.call(this, dict);
 };