@lppx/nlearn 1.1.4 → 1.1.5

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

package/dist/src/demo/fuse/04-/345/256/236/346/210/230/346/241/210/344/276/213.js

@@ -0,0 +1,354 @@
+"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 users = [
+        {
+            id: 1,
+            username: 'john_doe',
+            email: 'john@example.com',
+            fullName: 'John Doe',
+            bio: 'Full-stack developer specializing in React and Node.js',
+            tags: ['javascript', 'react', 'nodejs']
+        },
+        {
+            id: 2,
+            username: 'jane_smith',
+            email: 'jane@example.com',
+            fullName: 'Jane Smith',
+            bio: 'Frontend developer passionate about TypeScript and Vue',
+            tags: ['typescript', 'vue', 'css']
+        },
+        {
+            id: 3,
+            username: 'bob_wilson',
+            email: 'bob@example.com',
+            fullName: 'Bob Wilson',
+            bio: 'Backend engineer working with Python and Django',
+            tags: ['python', 'django', 'postgresql']
+        }
+    ];
+    const fuse = new fuse_js_1.default(users, {
+        keys: [
+            { name: 'username', weight: 0.3 },
+            { name: 'fullName', weight: 0.3 },
+            { name: 'email', weight: 0.1 },
+            { name: 'bio', weight: 0.2 },
+            { name: 'tags', weight: 0.1 }
+        ],
+        threshold: 0.4,
+        includeScore: true
+    });
+    const searchQuery = 'typescript';
+    console.log(`搜索用户: "${searchQuery}"\n`);
+    const results = fuse.search(searchQuery);
+    if (results.length === 0) {
+        console.log('未找到匹配的用户');
+    }
+    else {
+        results.forEach((result, index) => {
+            const user = result.item;
+            console.log(`${index + 1}. ${user.fullName} (@${user.username})`);
+            console.log(`   邮箱: ${user.email}`);
+            console.log(`   简介: ${user.bio}`);
+            console.log(`   标签: ${user.tags.join(', ')}`);
+            console.log(`   匹配度: ${((1 - (result.score || 0)) * 100).toFixed(1)}%\n`);
+        });
+    }
+}
+// #endregion
+// #region 示例2: 商品搜索与过滤
+function 商品搜索与过滤() {
+    console.log('\n=== 示例2: 商品搜索与过滤 ===');
+    const products = [
+        {
+            id: 1,
+            name: 'iPhone 15 Pro',
+            category: 'smartphone',
+            brand: 'Apple',
+            price: 999,
+            description: '最新款 iPhone，配备 A17 Pro 芯片',
+            inStock: true
+        },
+        {
+            id: 2,
+            name: 'Samsung Galaxy S24',
+            category: 'smartphone',
+            brand: 'Samsung',
+            price: 899,
+            description: '旗舰安卓手机，强大的拍照功能',
+            inStock: true
+        },
+        {
+            id: 3,
+            name: 'MacBook Pro 16',
+            category: 'laptop',
+            brand: 'Apple',
+            price: 2499,
+            description: '专业级笔记本电脑，M3 Max 芯片',
+            inStock: false
+        },
+        {
+            id: 4,
+            name: 'iPad Pro 12.9',
+            category: 'tablet',
+            brand: 'Apple',
+            price: 1099,
+            description: '大屏平板电脑，支持 Apple Pencil',
+            inStock: true
+        }
+    ];
+    // 创建搜索实例
+    const fuse = new fuse_js_1.default(products, {
+        keys: [
+            { name: 'name', weight: 0.4 },
+            { name: 'brand', weight: 0.2 },
+            { name: 'category', weight: 0.2 },
+            { name: 'description', weight: 0.2 }
+        ],
+        threshold: 0.3,
+        includeScore: true
+    });
+    // 搜索功能
+    function searchProducts(query, filters) {
+        let results = fuse.search(query);
+        // 应用过滤器
+        if (filters) {
+            results = results.filter(result => {
+                const product = result.item;
+                if (filters.inStock !== undefined && product.inStock !== filters.inStock) {
+                    return false;
+                }
+                if (filters.maxPrice !== undefined && product.price > filters.maxPrice) {
+                    return false;
+                }
+                return true;
+            });
+        }
+        return results;
+    }
+    // 示例搜索
+    console.log('搜索 "pro" 且价格 <= 1500 的商品:\n');
+    const results = searchProducts('pro', { maxPrice: 1500 });
+    results.forEach((result, index) => {
+        const product = result.item;
+        console.log(`${index + 1}. ${product.name} - $${product.price}`);
+        console.log(`   品牌: ${product.brand} | 类别: ${product.category}`);
+        console.log(`   库存: ${product.inStock ? '有货' : '缺货'}`);
+        console.log(`   ${product.description}\n`);
+    });
+}
+// #endregion
+// #region 示例3: 文档搜索引擎
+function 文档搜索引擎() {
+    console.log('\n=== 示例3: 文档搜索引擎 ===');
+    const documents = [
+        {
+            id: 'doc1',
+            title: 'TypeScript 入门指南',
+            content: 'TypeScript 是 JavaScript 的超集，添加了静态类型系统。它可以帮助开发者在编译时发现错误。',
+            category: '教程',
+            tags: ['typescript', 'javascript', '入门'],
+            lastUpdated: '2024-01-15'
+        },
+        {
+            id: 'doc2',
+            title: 'React Hooks 最佳实践',
+            content: 'React Hooks 是 React 16.8 引入的新特性，让你在不编写 class 的情况下使用 state 和其他 React 特性。',
+            category: '最佳实践',
+            tags: ['react', 'hooks', 'javascript'],
+            lastUpdated: '2024-02-20'
+        },
+        {
+            id: 'doc3',
+            title: 'Node.js 性能优化',
+            content: '本文介绍 Node.js 应用的性能优化技巧，包括异步编程、缓存策略和数据库优化。',
+            category: '性能优化',
+            tags: ['nodejs', 'performance', 'optimization'],
+            lastUpdated: '2024-03-10'
+        }
+    ];
+    const fuse = new fuse_js_1.default(documents, {
+        keys: [
+            { name: 'title', weight: 0.5 },
+            { name: 'content', weight: 0.3 },
+            { name: 'tags', weight: 0.2 }
+        ],
+        threshold: 0.4,
+        includeScore: true,
+        includeMatches: true,
+        minMatchCharLength: 2
+    });
+    function searchDocuments(query) {
+        const results = fuse.search(query);
+        console.log(`搜索 "${query}" 找到 ${results.length} 个结果:\n`);
+        results.forEach((result, index) => {
+            const doc = result.item;
+            console.log(`${index + 1}. ${doc.title}`);
+            console.log(`   类别: ${doc.category} | 更新: ${doc.lastUpdated}`);
+            console.log(`   标签: ${doc.tags.join(', ')}`);
+            console.log(`   相关度: ${((1 - (result.score || 0)) * 100).toFixed(1)}%`);
+            // 显示内容摘要
+            const preview = doc.content.substring(0, 60) + '...';
+            console.log(`   ${preview}\n`);
+        });
+    }
+    searchDocuments('react');
+}
+// #endregion
+// #region 示例4: 命令行工具搜索
+function 命令行工具搜索() {
+    console.log('\n=== 示例4: 命令行工具搜索 ===');
+    const commands = [
+        {
+            name: 'git commit',
+            description: '记录更改到仓库',
+            usage: 'git commit -m "message"',
+            aliases: ['commit', 'ci'],
+            category: 'git'
+        },
+        {
+            name: 'git push',
+            description: '推送本地更改到远程仓库',
+            usage: 'git push origin main',
+            aliases: ['push'],
+            category: 'git'
+        },
+        {
+            name: 'npm install',
+            description: '安装项目依赖',
+            usage: 'npm install [package]',
+            aliases: ['npm i', 'install'],
+            category: 'npm'
+        },
+        {
+            name: 'npm run',
+            description: '运行 package.json 中定义的脚本',
+            usage: 'npm run [script]',
+            aliases: ['run'],
+            category: 'npm'
+        }
+    ];
+    const fuse = new fuse_js_1.default(commands, {
+        keys: [
+            { name: 'name', weight: 0.4 },
+            { name: 'description', weight: 0.3 },
+            { name: 'aliases', weight: 0.3 }
+        ],
+        threshold: 0.3,
+        useExtendedSearch: true
+    });
+    function findCommand(query) {
+        const results = fuse.search(query);
+        if (results.length === 0) {
+            console.log(`未找到命令: "${query}"`);
+            return;
+        }
+        console.log(`搜索 "${query}" 的命令:\n`);
+        results.forEach((result, index) => {
+            const cmd = result.item;
+            console.log(`${index + 1}. ${cmd.name}`);
+            console.log(`   ${cmd.description}`);
+            console.log(`   用法: ${cmd.usage}`);
+            if (cmd.aliases.length > 0) {
+                console.log(`   别名: ${cmd.aliases.join(', ')}`);
+            }
+            console.log();
+        });
+    }
+    findCommand('install');
+}
+// #endregion
+// #region 示例5: 智能联系人搜索
+function 智能联系人搜索() {
+    console.log('\n=== 示例5: 智能联系人搜索 ===');
+    const contacts = [
+        {
+            id: 1,
+            name: '张伟',
+            phone: '13800138000',
+            email: 'zhangwei@company.com',
+            company: '阿里巴巴',
+            notes: '技术总监，负责云计算业务'
+        },
+        {
+            id: 2,
+            name: '李娜',
+            phone: '13900139000',
+            email: 'lina@tech.com',
+            company: '腾讯',
+            notes: '产品经理，微信团队'
+        },
+        {
+            id: 3,
+            name: '王强',
+            phone: '13700137000',
+            email: 'wangqiang@startup.com',
+            company: '字节跳动',
+            notes: '前端工程师，抖音部门'
+        }
+    ];
+    const fuse = new fuse_js_1.default(contacts, {
+        keys: [
+            { name: 'name', weight: 0.4 },
+            { name: 'company', weight: 0.3 },
+            { name: 'notes', weight: 0.2 },
+            { name: 'email', weight: 0.1 }
+        ],
+        threshold: 0.4,
+        includeScore: true
+    });
+    function searchContacts(query) {
+        const results = fuse.search(query);
+        console.log(`搜索联系人: "${query}"\n`);
+        if (results.length === 0) {
+            console.log('未找到匹配的联系人');
+            return;
+        }
+        results.forEach((result, index) => {
+            const contact = result.item;
+            console.log(`${index + 1}. ${contact.name} - ${contact.company}`);
+            console.log(`   电话: ${contact.phone}`);
+            console.log(`   邮箱: ${contact.email}`);
+            console.log(`   备注: ${contact.notes}\n`);
+        });
+    }
+    searchContacts('腾讯');
+}
+// #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/04-实战案例.ts [1-5] 运行指定示例');
+    }
+}
+// #endregion

package/package.json

@@ -3,7 +3,7 @@
   "publishConfig": {
     "access": "public"
   },
-  "version": "1.1.4",
+  "version": "1.1.5",
   "description": "一个nodejs学习工具",
   "bin": {
     "nlearn": "dist/src/cli/index.js",