@lppx/nlearn 1.1.4 → 1.1.7

package/dist/src/demo/fuse/02-/351/253/230/347/272/247/346/220/234/347/264/242.js

@@ -0,0 +1,212 @@
+"use strict";
+/**
+ * Fuse.js 高级搜索
+ * ================
+ * 介绍 Fuse.js 的高级搜索功能，包括扩展搜索、权重搜索等
+ *
+ * 官方文档: https://www.fusejs.io/
+ * 适用版本: fuse.js 7.x
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const fuse_js_1 = __importDefault(require("fuse.js"));
+// #region 示例1: 扩展搜索 - 精确匹配
+function 扩展搜索精确匹配() {
+    console.log('\n=== 示例1: 扩展搜索 - 精确匹配 ===');
+    const languages = [
+        { name: 'JavaScript' },
+        { name: 'TypeScript' },
+        { name: 'Java' },
+        { name: 'Python' },
+        { name: 'C++' }
+    ];
+    // 启用扩展搜索
+    const fuse = new fuse_js_1.default(languages, {
+        keys: ['name'],
+        useExtendedSearch: true
+    });
+    // 使用 = 前缀进行精确匹配
+    const exactResult = fuse.search("=Java");
+    console.log('精确搜索 "=Java" (只匹配 Java，不匹配 JavaScript):');
+    exactResult.forEach(item => {
+        console.log(`  - ${item.item.name}`);
+    });
+    // 对比：模糊搜索
+    const fuzzyResult = fuse.search("Java");
+    console.log('\n模糊搜索 "Java" (会匹配 Java 和 JavaScript):');
+    fuzzyResult.forEach(item => {
+        console.log(`  - ${item.item.name}`);
+    });
+}
+// #endregion
+// #region 示例2: 扩展搜索 - 前缀和后缀匹配
+function 前缀后缀匹配() {
+    console.log('\n=== 示例2: 扩展搜索 - 前缀和后缀匹配 ===');
+    const files = [
+        { name: 'index.js' },
+        { name: 'app.ts' },
+        { name: 'config.json' },
+        { name: 'test.js' },
+        { name: 'main.ts' }
+    ];
+    const fuse = new fuse_js_1.default(files, {
+        keys: ['name'],
+        useExtendedSearch: true
+    });
+    // 前缀匹配：以 ^ 开头
+    console.log('前缀搜索 "^index" (以 index 开头):');
+    const prefixResult = fuse.search("^index");
+    prefixResult.forEach(item => {
+        console.log(`  - ${item.item.name}`);
+    });
+    // 后缀匹配：以 $ 结尾
+    console.log('\n后缀搜索 ".js$" (以 .js 结尾):');
+    const suffixResult = fuse.search(".js$");
+    suffixResult.forEach(item => {
+        console.log(`  - ${item.item.name}`);
+    });
+}
+// #endregion
+// #region 示例3: 扩展搜索 - 包含和排除
+function 包含排除搜索() {
+    console.log('\n=== 示例3: 扩展搜索 - 包含和排除 ===');
+    const frameworks = [
+        { name: 'React', type: 'frontend' },
+        { name: 'Vue', type: 'frontend' },
+        { name: 'Angular', type: 'frontend' },
+        { name: 'Express', type: 'backend' },
+        { name: 'Koa', type: 'backend' }
+    ];
+    const fuse = new fuse_js_1.default(frameworks, {
+        keys: ['name', 'type'],
+        useExtendedSearch: true
+    });
+    // 包含匹配：使用单引号
+    console.log("包含搜索 \"'react\" (包含 react):");
+    const includeResult = fuse.search("'react");
+    includeResult.forEach(item => {
+        console.log(`  - ${item.item.name} (${item.item.type})`);
+    });
+    // 排除匹配：使用 ! 前缀
+    console.log("\n排除搜索 \"!backend\" (排除 backend):");
+    const excludeResult = fuse.search("!backend");
+    excludeResult.forEach(item => {
+        console.log(`  - ${item.item.name} (${item.item.type})`);
+    });
+}
+// #endregion
+// #region 示例4: 扩展搜索 - 逻辑运算符
+function 逻辑运算符搜索() {
+    console.log('\n=== 示例4: 扩展搜索 - 逻辑运算符 ===');
+    const products = [
+        { name: 'iPhone 15 Pro', brand: 'Apple', price: 999 },
+        { name: 'MacBook Pro', brand: 'Apple', price: 1999 },
+        { name: 'Galaxy S24', brand: 'Samsung', price: 899 },
+        { name: 'iPad Air', brand: 'Apple', price: 599 },
+        { name: 'Surface Pro', brand: 'Microsoft', price: 1299 }
+    ];
+    const fuse = new fuse_js_1.default(products, {
+        keys: ['name', 'brand'],
+        useExtendedSearch: true
+    });
+    // AND 运算符：空格分隔
+    console.log('AND 搜索 "Apple Pro" (同时包含 Apple 和 Pro):');
+    const andResult = fuse.search("Apple Pro");
+    andResult.forEach(item => {
+        console.log(`  - ${item.item.name} (${item.item.brand})`);
+    });
+    // OR 运算符：使用 |
+    console.log('\nOR 搜索 "iPhone | Galaxy" (包含 iPhone 或 Galaxy):');
+    const orResult = fuse.search("iPhone | Galaxy");
+    orResult.forEach(item => {
+        console.log(`  - ${item.item.name} (${item.item.brand})`);
+    });
+}
+// #endregion
+// #region 示例5: 权重搜索
+function 权重搜索() {
+    console.log('\n=== 示例5: 权重搜索 ===');
+    const articles = [
+        {
+            title: 'TypeScript 入门教程',
+            content: '这是一篇关于 TypeScript 基础的文章',
+            tags: ['typescript', 'tutorial']
+        },
+        {
+            title: 'JavaScript 高级技巧',
+            content: '深入探讨 JavaScript 的高级特性，包括 TypeScript',
+            tags: ['javascript', 'advanced']
+        },
+        {
+            title: 'Node.js 实战',
+            content: '使用 TypeScript 开发 Node.js 应用',
+            tags: ['nodejs', 'typescript']
+        }
+    ];
+    // 为不同字段设置权重
+    const fuse = new fuse_js_1.default(articles, {
+        keys: [
+            { name: 'title', weight: 0.7 }, // 标题权重最高
+            { name: 'tags', weight: 0.2 }, // 标签次之
+            { name: 'content', weight: 0.1 } // 内容权重最低
+        ],
+        includeScore: true
+    });
+    const result = fuse.search('TypeScript');
+    console.log('搜索 "TypeScript" (标题权重 0.7, 标签 0.2, 内容 0.1):');
+    result.forEach(item => {
+        console.log(`  - ${item.item.title}`);
+        console.log(`    分数: ${item.score?.toFixed(4)}`);
+        console.log(`    标签: ${item.item.tags.join(', ')}`);
+    });
+}
+// #endregion
+// #region 示例6: 复杂查询组合
+function 复杂查询组合() {
+    console.log('\n=== 示例6: 复杂查询组合 ===');
+    const employees = [
+        { name: 'John Smith', department: 'Engineering', level: 'Senior' },
+        { name: 'Jane Doe', department: 'Engineering', level: 'Junior' },
+        { name: 'Bob Johnson', department: 'Marketing', level: 'Senior' },
+        { name: 'Alice Williams', department: 'Sales', level: 'Mid' },
+        { name: 'Charlie Brown', department: 'Engineering', level: 'Mid' }
+    ];
+    const fuse = new fuse_js_1.default(employees, {
+        keys: ['name', 'department', 'level'],
+        useExtendedSearch: true
+    });
+    // 复杂查询：工程部门的高级员工
+    console.log('复杂查询 "Engineering Senior" (工程部门且高级):');
+    const result = fuse.search("Engineering Senior");
+    result.forEach(item => {
+        console.log(`  - ${item.item.name}`);
+        console.log(`    部门: ${item.item.department}, 级别: ${item.item.level}`);
+    });
+}
+// #endregion
+// #region 主程序入口
+if (require.main === module) {
+    const args = process.argv.slice(2);
+    const exampleNumber = args[0] ? parseInt(args[0]) : 0;
+    const examples = [
+        扩展搜索精确匹配,
+        前缀后缀匹配,
+        包含排除搜索,
+        逻辑运算符搜索,
+        权重搜索,
+        复杂查询组合
+    ];
+    if (exampleNumber > 0 && exampleNumber <= examples.length) {
+        console.log(`\n运行示例 ${exampleNumber}:`);
+        examples[exampleNumber - 1]();
+    }
+    else {
+        console.log('Fuse.js 高级搜索示例\n');
+        console.log('运行所有示例...\n');
+        examples.forEach(example => example());
+        console.log('\n\n提示: 使用 ts-node src/demo/fuse/02-高级搜索.ts [1-6] 运行指定示例');
+    }
+}
+// #endregion

package/dist/src/demo/fuse/03-/351/205/215/347/275/256/350/257/246/350/247/243.js

@@ -0,0 +1,261 @@
+"use strict";
+/**
+ * Fuse.js 配置详解
+ * ================
+ * 深入了解 Fuse.js 的各种配置选项及其影响
+ *
+ * 官方文档: https://www.fusejs.io/api/options.html
+ * 适用版本: fuse.js 7.x
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const fuse_js_1 = __importDefault(require("fuse.js"));
+// #region 示例1: threshold 阈值配置
+function 阈值配置对比() {
+    console.log('\n=== 示例1: threshold 阈值配置 ===');
+    const words = ['apple', 'application', 'apply', 'appreciate'];
+    // 严格匹配 (threshold = 0.0)
+    const strictFuse = new fuse_js_1.default(words, { threshold: 0.0 });
+    console.log('严格匹配 (threshold: 0.0) 搜索 "apple":');
+    strictFuse.search('apple').forEach(item => {
+        console.log(`  - ${item.item}`);
+    });
+    // 中等匹配 (threshold = 0.3)
+    const mediumFuse = new fuse_js_1.default(words, { threshold: 0.3, includeScore: true });
+    console.log('\n中等匹配 (threshold: 0.3) 搜索 "aple":');
+    mediumFuse.search('aple').forEach(item => {
+        console.log(`  - ${item.item} (分数: ${item.score?.toFixed(3)})`);
+    });
+    // 宽松匹配 (threshold = 0.6)
+    const looseFuse = new fuse_js_1.default(words, { threshold: 0.6, includeScore: true });
+    console.log('\n宽松匹配 (threshold: 0.6) 搜索 "apl":');
+    looseFuse.search('apl').forEach(item => {
+        console.log(`  - ${item.item} (分数: ${item.score?.toFixed(3)})`);
+    });
+    console.log('\n说明: threshold 越小，匹配越严格；越大，匹配越宽松');
+}
+// #endregion
+// #region 示例2: location 和 distance 配置
+function 位置距离配置() {
+    console.log('\n=== 示例2: location 和 distance 配置 ===');
+    const texts = [
+        'The quick brown fox jumps over the lazy dog',
+        'A quick brown fox',
+        'The lazy dog sleeps'
+    ];
+    // 默认配置：在整个字符串中搜索
+    const defaultFuse = new fuse_js_1.default(texts, {
+        includeScore: true,
+        threshold: 0.3
+    });
+    console.log('默认配置搜索 "quick":');
+    defaultFuse.search('quick').forEach(item => {
+        console.log(`  - "${item.item.substring(0, 30)}..." (分数: ${item.score?.toFixed(3)})`);
+    });
+    // 限制搜索位置和距离
+    const restrictedFuse = new fuse_js_1.default(texts, {
+        includeScore: true,
+        threshold: 0.3,
+        location: 0, // 从字符串开头开始
+        distance: 10 // 只在前 10 个字符内搜索
+    });
+    console.log('\n限制位置配置 (location: 0, distance: 10) 搜索 "quick":');
+    const result = restrictedFuse.search('quick');
+    if (result.length > 0) {
+        result.forEach(item => {
+            console.log(`  - "${item.item.substring(0, 30)}..." (分数: ${item.score?.toFixed(3)})`);
+        });
+    }
+    else {
+        console.log('  - 无结果（因为 "quick" 不在前 10 个字符内）');
+    }
+}
+// #endregion
+// #region 示例3: minMatchCharLength 最小匹配长度
+function 最小匹配长度() {
+    console.log('\n=== 示例3: minMatchCharLength 最小匹配长度 ===');
+    const codes = [
+        'JavaScript',
+        'Java',
+        'TypeScript',
+        'Python',
+        'Go'
+    ];
+    // 不限制最小匹配长度
+    const noMinFuse = new fuse_js_1.default(codes, {
+        minMatchCharLength: 1
+    });
+    console.log('最小匹配长度 1，搜索 "ja":');
+    noMinFuse.search('ja').forEach(item => {
+        console.log(`  - ${item.item}`);
+    });
+    // 要求至少匹配 3 个字符
+    const minFuse = new fuse_js_1.default(codes, {
+        minMatchCharLength: 3
+    });
+    console.log('\n最小匹配长度 3，搜索 "ja":');
+    const result = minFuse.search('ja');
+    if (result.length > 0) {
+        result.forEach(item => {
+            console.log(`  - ${item.item}`);
+        });
+    }
+    else {
+        console.log('  - 无结果（搜索词少于 3 个字符）');
+    }
+}
+// #endregion
+// #region 示例4: shouldSort 和 sortFn 排序配置
+function 排序配置() {
+    console.log('\n=== 示例4: shouldSort 和排序配置 ===');
+    const items = [
+        { name: 'React', stars: 200000 },
+        { name: 'Vue', stars: 180000 },
+        { name: 'Angular', stars: 85000 },
+        { name: 'Svelte', stars: 65000 },
+        { name: 'Preact', stars: 35000 }
+    ];
+    // 默认按匹配分数排序
+    const scoreSortFuse = new fuse_js_1.default(items, {
+        keys: ['name'],
+        includeScore: true,
+        shouldSort: true
+    });
+    console.log('按匹配分数排序，搜索 "react":');
+    scoreSortFuse.search('react').forEach(item => {
+        console.log(`  - ${item.item.name} (分数: ${item.score?.toFixed(3)}, stars: ${item.item.stars})`);
+    });
+    // 禁用排序
+    const noSortFuse = new fuse_js_1.default(items, {
+        keys: ['name'],
+        includeScore: true,
+        shouldSort: false
+    });
+    console.log('\n禁用排序，搜索 "react":');
+    noSortFuse.search('react').forEach(item => {
+        console.log(`  - ${item.item.name} (分数: ${item.score?.toFixed(3)}, stars: ${item.item.stars})`);
+    });
+}
+// #endregion
+// #region 示例5: includeMatches 匹配详情
+function 匹配详情配置() {
+    console.log('\n=== 示例5: includeMatches 匹配详情 ===');
+    const books = [
+        {
+            title: 'JavaScript 权威指南',
+            author: 'David Flanagan'
+        },
+        {
+            title: 'TypeScript 编程',
+            author: 'Boris Cherny'
+        }
+    ];
+    const fuse = new fuse_js_1.default(books, {
+        keys: ['title', 'author'],
+        includeMatches: true, // 包含匹配详情
+        includeScore: true
+    });
+    const result = fuse.search('script');
+    console.log('搜索 "script" 的匹配详情:');
+    result.forEach(item => {
+        console.log(`\n  书名: ${item.item.title}`);
+        console.log(`  作者: ${item.item.author}`);
+        console.log(`  分数: ${item.score?.toFixed(3)}`);
+        if (item.matches) {
+            console.log('  匹配位置:');
+            item.matches.forEach(match => {
+                console.log(`    - 字段: ${match.key}`);
+                console.log(`      值: ${match.value}`);
+                if (match.indices) {
+                    console.log(`      索引: ${JSON.stringify(match.indices)}`);
+                }
+            });
+        }
+    });
+}
+// #endregion
+// #region 示例6: 完整配置示例
+function 完整配置示例() {
+    console.log('\n=== 示例6: 完整配置示例 ===');
+    const products = [
+        {
+            id: 1,
+            name: 'iPhone 15 Pro Max',
+            category: 'smartphone',
+            brand: 'Apple',
+            price: 1199
+        },
+        {
+            id: 2,
+            name: 'MacBook Pro 16',
+            category: 'laptop',
+            brand: 'Apple',
+            price: 2499
+        },
+        {
+            id: 3,
+            name: 'iPad Pro',
+            category: 'tablet',
+            brand: 'Apple',
+            price: 799
+        }
+    ];
+    const options = {
+        // 基础配置
+        isCaseSensitive: false, // 不区分大小写
+        includeScore: true, // 包含分数
+        includeMatches: false, // 不包含匹配详情
+        // 匹配配置
+        minMatchCharLength: 2, // 最小匹配 2 个字符
+        shouldSort: true, // 按分数排序
+        // 模糊匹配配置
+        threshold: 0.4, // 中等严格度
+        location: 0, // 从开头开始
+        distance: 100, // 搜索距离
+        // 搜索字段配置
+        keys: [
+            { name: 'name', weight: 0.5 },
+            { name: 'category', weight: 0.3 },
+            { name: 'brand', weight: 0.2 }
+        ]
+    };
+    const fuse = new fuse_js_1.default(products, options);
+    console.log('配置说明:');
+    console.log('  - 不区分大小写');
+    console.log('  - 中等匹配严格度 (threshold: 0.4)');
+    console.log('  - 权重: name(50%), category(30%), brand(20%)');
+    const result = fuse.search('pro');
+    console.log('\n搜索 "pro" 的结果:');
+    result.forEach(item => {
+        console.log(`  - ${item.item.name}`);
+        console.log(`    类别: ${item.item.category}, 品牌: ${item.item.brand}`);
+        console.log(`    价格: $${item.item.price}, 分数: ${item.score?.toFixed(3)}`);
+    });
+}
+// #endregion
+// #region 主程序入口
+if (require.main === module) {
+    const args = process.argv.slice(2);
+    const exampleNumber = args[0] ? parseInt(args[0]) : 0;
+    const examples = [
+        阈值配置对比,
+        位置距离配置,
+        最小匹配长度,
+        排序配置,
+        匹配详情配置,
+        完整配置示例
+    ];
+    if (exampleNumber > 0 && exampleNumber <= examples.length) {
+        console.log(`\n运行示例 ${exampleNumber}:`);
+        examples[exampleNumber - 1]();
+    }
+    else {
+        console.log('Fuse.js 配置详解示例\n');
+        console.log('运行所有示例...\n');
+        examples.forEach(example => example());
+        console.log('\n\n提示: 使用 ts-node src/demo/fuse/03-配置详解.ts [1-6] 运行指定示例');
+    }
+}
+// #endregion