@lppx/nlearn 1.1.19 → 1.1.21

package/dist/src/cli/cli.js

@@ -141,7 +141,7 @@ async function executeDemoFunction(demoFunc) {
         }
         // 执行函数
         await module[demoFunc.functionName]();
-        console.log('\n' + '='.repeat(50) + '用户选择的函数执行结束' + '='.repeat(50));
+        console.log('\n' + '='.repeat(20) + '用户选择的函数执行结束' + '='.repeat(20));
         // console.log('✓ \n');
     }
     catch (error) {

package/dist/src/demo/winston/01-/345/237/272/347/241/200/346/246/202/345/277/265.js

@@ -0,0 +1,142 @@
+"use strict";
+/**
+ * Winston 基础概念
+ * ================
+ * Winston 是 Node.js 中最流行的日志库，支持多种传输方式和日志级别
+ * 适用版本: winston ^3.0.0
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createBasicLogger = createBasicLogger;
+exports.demonstrateLogLevels = demonstrateLogLevels;
+exports.useDefaultLogger = useDefaultLogger;
+exports.logWithMetadata = logWithMetadata;
+exports.multipleTransports = multipleTransports;
+const winston_1 = __importDefault(require("winston"));
+// #region 示例1: 创建基础日志记录器
+function createBasicLogger() {
+    console.log('\n=== 创建基础日志记录器 ===\n');
+    // 创建一个简单的 logger
+    const logger = winston_1.default.createLogger({
+        level: 'info',
+        format: winston_1.default.format.simple(),
+        transports: [
+            new winston_1.default.transports.Console()
+        ]
+    });
+    // 使用不同级别记录日志
+    logger.error('这是一个错误日志');
+    logger.warn('这是一个警告日志');
+    logger.info('这是一个信息日志');
+    logger.debug('这是一个调试日志（不会显示，因为 level 设置为 info）');
+    console.log('\n日志级别优先级: error > warn > info > http > verbose > debug > silly');
+}
+// #endregion
+// #region 示例2: 日志级别详解
+function demonstrateLogLevels() {
+    console.log('\n=== 日志级别详解 ===\n');
+    const logger = winston_1.default.createLogger({
+        level: 'silly', // 设置为最低级别，显示所有日志
+        format: winston_1.default.format.simple(),
+        transports: [
+            new winston_1.default.transports.Console()
+        ]
+    });
+    // Winston 默认的日志级别（从高到低）
+    logger.error('error - 错误信息，最高优先级');
+    logger.warn('warn - 警告信息');
+    logger.info('info - 一般信息');
+    logger.http('http - HTTP 请求日志');
+    logger.verbose('verbose - 详细信息');
+    logger.debug('debug - 调试信息');
+    logger.silly('silly - 最详细的信息，最低优先级');
+    console.log('\n提示: 设置 level 为某个级别后，只会显示该级别及更高优先级的日志');
+}
+// #endregion
+// #region 示例3: 使用默认 logger
+function useDefaultLogger() {
+    console.log('\n=== 使用默认 logger ===\n');
+    // Winston 提供了一个默认的 logger
+    winston_1.default.info('使用默认 logger 记录信息');
+    winston_1.default.warn('默认 logger 的警告');
+    winston_1.default.error('默认 logger 的错误');
+    console.log('\n注意: 默认 logger 配置简单，生产环境建议自定义配置');
+}
+// #endregion
+// #region 示例4: 日志元数据
+function logWithMetadata() {
+    console.log('\n=== 日志元数据 ===\n');
+    const logger = winston_1.default.createLogger({
+        level: 'info',
+        format: winston_1.default.format.json(),
+        transports: [
+            new winston_1.default.transports.Console()
+        ]
+    });
+    // 添加元数据
+    logger.info('用户登录', {
+        userId: '12345',
+        username: 'john_doe',
+        ip: '192.168.1.1',
+        timestamp: new Date().toISOString()
+    });
+    logger.error('数据库连接失败', {
+        database: 'users_db',
+        host: 'localhost',
+        port: 5432,
+        error: 'Connection timeout'
+    });
+    console.log('\n元数据以 JSON 格式输出，便于日志分析和检索');
+}
+// #endregion
+// #region 示例5: 多个 transport
+function multipleTransports() {
+    console.log('\n=== 多个 transport ===\n');
+    const logger = winston_1.default.createLogger({
+        level: 'info',
+        format: winston_1.default.format.json(),
+        transports: [
+            // 控制台输出
+            new winston_1.default.transports.Console({
+                format: winston_1.default.format.simple()
+            }),
+            // 文件输出 - 所有日志
+            new winston_1.default.transports.File({
+                filename: 'logs/combined.log'
+            }),
+            // 文件输出 - 仅错误日志
+            new winston_1.default.transports.File({
+                filename: 'logs/error.log',
+                level: 'error'
+            })
+        ]
+    });
+    logger.info('这条日志会输出到控制台和 combined.log');
+    logger.error('这条错误会输出到控制台、combined.log 和 error.log');
+    console.log('\n日志已写入 logs/ 目录');
+}
+// #endregion
+if (require.main === module) {
+    const examples = [
+        { name: '创建基础日志记录器', fn: createBasicLogger },
+        { name: '日志级别详解', fn: demonstrateLogLevels },
+        { name: '使用默认 logger', fn: useDefaultLogger },
+        { name: '日志元数据', fn: logWithMetadata },
+        { name: '多个 transport', fn: multipleTransports }
+    ];
+    const exampleNumber = process.argv[2] ? parseInt(process.argv[2]) : null;
+    if (exampleNumber && exampleNumber >= 1 && exampleNumber <= examples.length) {
+        examples[exampleNumber - 1].fn();
+    }
+    else {
+        console.log('Winston 基础概念示例\n');
+        console.log('使用方法: ts-node 01-基础概念.ts [示例编号]\n');
+        examples.forEach((example, index) => {
+            console.log(`${index + 1}. ${example.name}`);
+        });
+        console.log('\n运行所有示例:');
+        examples.forEach(example => example.fn());
+    }
+}

package/dist/src/demo/winston/02-/346/240/274/345/274/217/345/214/226/350/276/223/345/207/272.js

@@ -0,0 +1,153 @@
+"use strict";
+/**
+ * Winston 格式化输出
+ * ==================
+ * Winston 提供了丰富的格式化选项，可以自定义日志输出格式
+ * 适用版本: winston ^3.0.0
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.builtInFormatters = builtInFormatters;
+exports.combineFormatters = combineFormatters;
+exports.addTimestamp = addTimestamp;
+exports.customFormat = customFormat;
+exports.colorizedOutput = colorizedOutput;
+exports.alignedFormat = alignedFormat;
+const winston_1 = __importDefault(require("winston"));
+// #region 示例1: 内置格式化器
+function builtInFormatters() {
+    console.log('\n=== 内置格式化器 ===\n');
+    // JSON 格式
+    const jsonLogger = winston_1.default.createLogger({
+        level: 'info',
+        format: winston_1.default.format.json(),
+        transports: [new winston_1.default.transports.Console()]
+    });
+    console.log('1. JSON 格式:');
+    jsonLogger.info('JSON 格式的日志', { userId: 123, action: 'login' });
+    // Simple 格式
+    const simpleLogger = winston_1.default.createLogger({
+        level: 'info',
+        format: winston_1.default.format.simple(),
+        transports: [new winston_1.default.transports.Console()]
+    });
+    console.log('\n2. Simple 格式:');
+    simpleLogger.info('简单格式的日志');
+    // Prettyprint 格式
+    const prettyLogger = winston_1.default.createLogger({
+        level: 'info',
+        format: winston_1.default.format.prettyPrint(),
+        transports: [new winston_1.default.transports.Console()]
+    });
+    console.log('\n3. Pretty Print 格式:');
+    prettyLogger.info('美化打印的日志', { user: { id: 123, name: 'John' } });
+}
+// #endregion
+// #region 示例2: 组合格式化器
+function combineFormatters() {
+    console.log('\n=== 组合格式化器 ===\n');
+    const logger = winston_1.default.createLogger({
+        level: 'info',
+        format: winston_1.default.format.combine(winston_1.default.format.timestamp({ format: 'YYYY-MM-DD HH:mm:ss' }), winston_1.default.format.errors({ stack: true }), winston_1.default.format.splat(), winston_1.default.format.json()),
+        transports: [new winston_1.default.transports.Console()]
+    });
+    logger.info('组合格式化的日志');
+    logger.error('错误日志', new Error('示例错误'));
+    console.log('\n使用 combine 可以组合多个格式化器');
+}
+// #endregion
+// #region 示例3: 添加时间戳
+function addTimestamp() {
+    console.log('\n=== 添加时间戳 ===\n');
+    const logger = winston_1.default.createLogger({
+        level: 'info',
+        format: winston_1.default.format.combine(winston_1.default.format.timestamp({
+            format: 'YYYY-MM-DD HH:mm:ss'
+        }), winston_1.default.format.printf(info => {
+            return `[${info.timestamp}] ${info.level}: ${info.message}`;
+        })),
+        transports: [new winston_1.default.transports.Console()]
+    });
+    logger.info('带时间戳的日志');
+    logger.warn('警告信息');
+    logger.error('错误信息');
+}
+// #endregion
+// #region 示例4: 自定义格式化
+function customFormat() {
+    console.log('\n=== 自定义格式化 ===\n');
+    const customFormat = winston_1.default.format.printf(({ level, message, timestamp, ...metadata }) => {
+        let msg = `${timestamp} [${level.toUpperCase()}] ${message}`;
+        if (Object.keys(metadata).length > 0) {
+            msg += ` | ${JSON.stringify(metadata)}`;
+        }
+        return msg;
+    });
+    const logger = winston_1.default.createLogger({
+        level: 'info',
+        format: winston_1.default.format.combine(winston_1.default.format.timestamp({ format: 'YYYY-MM-DD HH:mm:ss' }), customFormat),
+        transports: [new winston_1.default.transports.Console()]
+    });
+    logger.info('自定义格式的日志');
+    logger.info('带元数据的日志', { userId: 123, action: 'update' });
+}
+// #endregion
+// #region 示例5: 彩色输出
+function colorizedOutput() {
+    console.log('\n=== 彩色输出 ===\n');
+    const logger = winston_1.default.createLogger({
+        level: 'silly',
+        format: winston_1.default.format.combine(winston_1.default.format.colorize(), winston_1.default.format.timestamp({ format: 'HH:mm:ss' }), winston_1.default.format.printf(({ timestamp, level, message }) => {
+            return `${timestamp} ${level}: ${message}`;
+        })),
+        transports: [new winston_1.default.transports.Console()]
+    });
+    logger.error('错误日志 - 红色');
+    logger.warn('警告日志 - 黄色');
+    logger.info('信息日志 - 绿色');
+    logger.debug('调试日志 - 蓝色');
+    console.log('\n彩色输出让日志更易读');
+}
+// #endregion
+// #region 示例6: 对齐格式
+function alignedFormat() {
+    console.log('\n=== 对齐格式 ===\n');
+    const logger = winston_1.default.createLogger({
+        level: 'info',
+        format: winston_1.default.format.combine(winston_1.default.format.timestamp({ format: 'HH:mm:ss' }), winston_1.default.format.align(), winston_1.default.format.printf(info => {
+            const { timestamp, level, message, ...args } = info;
+            const ts = typeof timestamp === 'string' ? timestamp : String(timestamp);
+            return `${ts} [${level}]: ${message} ${Object.keys(args).length ? JSON.stringify(args, null, 2) : ''}`;
+        })),
+        transports: [new winston_1.default.transports.Console()]
+    });
+    logger.info('对齐的日志输出');
+    logger.warn('警告信息');
+    logger.error('错误信息', { code: 500, details: 'Internal Server Error' });
+}
+// #endregion
+if (require.main === module) {
+    const examples = [
+        { name: '内置格式化器', fn: builtInFormatters },
+        { name: '组合格式化器', fn: combineFormatters },
+        { name: '添加时间戳', fn: addTimestamp },
+        { name: '自定义格式化', fn: customFormat },
+        { name: '彩色输出', fn: colorizedOutput },
+        { name: '对齐格式', fn: alignedFormat }
+    ];
+    const exampleNumber = process.argv[2] ? parseInt(process.argv[2]) : null;
+    if (exampleNumber && exampleNumber >= 1 && exampleNumber <= examples.length) {
+        examples[exampleNumber - 1].fn();
+    }
+    else {
+        console.log('Winston 格式化输出示例\n');
+        console.log('使用方法: ts-node 02-格式化输出.ts [示例编号]\n');
+        examples.forEach((example, index) => {
+            console.log(`${index + 1}. ${example.name}`);
+        });
+        console.log('\n运行所有示例:');
+        examples.forEach(example => example.fn());
+    }
+}

package/dist/src/demo/winston/03-/344/274/240/350/276/223/346/226/271/345/274/217.js

@@ -0,0 +1,186 @@
+"use strict";
+/**
+ * Winston 传输方式
+ * =================
+ * Winston 支持多种传输方式（Transport），可以将日志输出到不同的目标
+ * 适用版本: winston ^3.0.0
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.consoleTransport = consoleTransport;
+exports.fileTransport = fileTransport;
+exports.separateLogsByLevel = separateLogsByLevel;
+exports.logRotation = logRotation;
+exports.customTransport = customTransport;
+exports.dynamicTransports = dynamicTransports;
+const winston_1 = __importDefault(require("winston"));
+// #region 示例1: Console Transport
+function consoleTransport() {
+    console.log('\n=== Console Transport ===\n');
+    const logger = winston_1.default.createLogger({
+        level: 'info',
+        transports: [
+            new winston_1.default.transports.Console({
+                format: winston_1.default.format.combine(winston_1.default.format.colorize(), winston_1.default.format.simple())
+            })
+        ]
+    });
+    logger.info('输出到控制台');
+    logger.warn('控制台警告');
+    logger.error('控制台错误');
+    console.log('\nConsole Transport 适合开发环境调试');
+}
+// #endregion
+// #region 示例2: File Transport
+function fileTransport() {
+    console.log('\n=== File Transport ===\n');
+    const logger = winston_1.default.createLogger({
+        level: 'info',
+        format: winston_1.default.format.combine(winston_1.default.format.timestamp(), winston_1.default.format.json()),
+        transports: [
+            new winston_1.default.transports.File({
+                filename: 'logs/app.log',
+                maxsize: 5242880, // 5MB
+                maxFiles: 5,
+            })
+        ]
+    });
+    logger.info('写入文件的日志');
+    logger.warn('文件警告');
+    logger.error('文件错误');
+    console.log('日志已写入 logs/app.log');
+    console.log('maxsize: 单个文件最大大小');
+    console.log('maxFiles: 保留的文件数量');
+}
+// #endregion
+// #region 示例3: 按级别分离日志文件
+function separateLogsByLevel() {
+    console.log('\n=== 按级别分离日志文件 ===\n');
+    const logger = winston_1.default.createLogger({
+        level: 'debug',
+        format: winston_1.default.format.combine(winston_1.default.format.timestamp(), winston_1.default.format.json()),
+        transports: [
+            // 所有日志
+            new winston_1.default.transports.File({
+                filename: 'logs/combined.log'
+            }),
+            // 仅错误日志
+            new winston_1.default.transports.File({
+                filename: 'logs/error.log',
+                level: 'error'
+            }),
+            // 仅警告及以上
+            new winston_1.default.transports.File({
+                filename: 'logs/warn.log',
+                level: 'warn'
+            }),
+            // 控制台输出
+            new winston_1.default.transports.Console({
+                format: winston_1.default.format.simple()
+            })
+        ]
+    });
+    logger.debug('调试信息');
+    logger.info('一般信息');
+    logger.warn('警告信息');
+    logger.error('错误信息');
+    console.log('\n日志已按级别分离到不同文件');
+}
+// #endregion
+// #region 示例4: 日志轮转
+function logRotation() {
+    console.log('\n=== 日志轮转 ===\n');
+    const logger = winston_1.default.createLogger({
+        level: 'info',
+        format: winston_1.default.format.combine(winston_1.default.format.timestamp(), winston_1.default.format.json()),
+        transports: [
+            new winston_1.default.transports.File({
+                filename: 'logs/application.log',
+                maxsize: 20971520, // 20MB
+                maxFiles: 14
+            })
+        ]
+    });
+    logger.info('日志轮转示例');
+    console.log('\n配置说明:');
+    console.log('- maxsize: 单个文件最大 20MB');
+    console.log('- maxFiles: 保留 14 个日志文件');
+    console.log('\n注意: 更高级的日期轮转功能需要安装 winston-daily-rotate-file 包');
+}
+// #endregion
+// #region 示例5: 自定义 Transport
+function customTransport() {
+    console.log('\n=== 自定义 Transport ===\n');
+    // 创建一个简单的自定义 Transport
+    class CustomTransport extends winston_1.default.transports.Stream {
+        constructor(opts) {
+            super(opts);
+        }
+        log(info, callback) {
+            setImmediate(() => {
+                this.emit('logged', info);
+            });
+            // 自定义处理逻辑
+            console.log(`[自定义输出] ${info.level}: ${info.message}`);
+            callback();
+        }
+    }
+    const logger = winston_1.default.createLogger({
+        level: 'info',
+        transports: [
+            new CustomTransport()
+        ]
+    });
+    logger.info('使用自定义 Transport');
+    logger.warn('自定义警告');
+    console.log('\n可以创建自定义 Transport 将日志发送到任何目标');
+}
+// #endregion
+// #region 示例6: 动态添加和移除 Transport
+function dynamicTransports() {
+    console.log('\n=== 动态添加和移除 Transport ===\n');
+    const logger = winston_1.default.createLogger({
+        level: 'info',
+        format: winston_1.default.format.simple()
+    });
+    // 初始没有 transport
+    logger.info('这条日志不会输出');
+    // 动态添加 Console transport
+    const consoleTransport = new winston_1.default.transports.Console();
+    logger.add(consoleTransport);
+    logger.info('添加 Console transport 后的日志');
+    // 动态添加 File transport
+    const fileTransport = new winston_1.default.transports.File({ filename: 'logs/dynamic.log' });
+    logger.add(fileTransport);
+    logger.info('同时输出到控制台和文件');
+    // 移除 Console transport
+    logger.remove(consoleTransport);
+    logger.info('移除 Console transport 后，只输出到文件');
+    console.log('\n可以在运行时动态管理 transports');
+}
+// #endregion
+if (require.main === module) {
+    const examples = [
+        { name: 'Console Transport', fn: consoleTransport },
+        { name: 'File Transport', fn: fileTransport },
+        { name: '按级别分离日志文件', fn: separateLogsByLevel },
+        { name: '日志轮转', fn: logRotation },
+        { name: '自定义 Transport', fn: customTransport },
+        { name: '动态添加和移除 Transport', fn: dynamicTransports }
+    ];
+    const exampleNumber = process.argv[2] ? parseInt(process.argv[2]) : null;
+    if (exampleNumber && exampleNumber >= 1 && exampleNumber <= examples.length) {
+        examples[exampleNumber - 1].fn();
+    }
+    else {
+        console.log('Winston 传输方式示例\n');
+        console.log('使用方法: ts-node 03-传输方式.ts [示例编号]\n');
+        examples.forEach((example, index) => {
+            console.log(`${index + 1}. ${example.name}`);
+        });
+        console.log('\n运行所有示例:');
+        examples.forEach(example => example.fn());
+    }
+}

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

@@ -0,0 +1,254 @@
+"use strict";
+/**
+ * Winston 实战案例
+ * ================
+ * 实际项目中 Winston 的应用场景和最佳实践
+ * 适用版本: winston ^3.0.0
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.productionLoggerConfig = productionLoggerConfig;
+exports.httpRequestLogger = httpRequestLogger;
+exports.errorTracking = errorTracking;
+exports.childLoggers = childLoggers;
+exports.performanceMonitoring = performanceMonitoring;
+exports.logFiltering = logFiltering;
+const winston_1 = __importDefault(require("winston"));
+// #region 示例1: 生产环境日志配置
+function productionLoggerConfig() {
+    console.log('\n=== 生产环境日志配置 ===\n');
+    const logger = winston_1.default.createLogger({
+        level: process.env.LOG_LEVEL || 'info',
+        format: winston_1.default.format.combine(winston_1.default.format.timestamp({ format: 'YYYY-MM-DD HH:mm:ss' }), winston_1.default.format.errors({ stack: true }), winston_1.default.format.json()),
+        defaultMeta: { service: 'user-service' },
+        transports: [
+            // 错误日志
+            new winston_1.default.transports.File({
+                filename: 'logs/error.log',
+                level: 'error',
+                maxsize: 5242880, // 5MB
+                maxFiles: 5
+            }),
+            // 所有日志
+            new winston_1.default.transports.File({
+                filename: 'logs/combined.log',
+                maxsize: 5242880,
+                maxFiles: 5
+            })
+        ]
+    });
+    // 开发环境添加控制台输出
+    if (process.env.NODE_ENV !== 'production') {
+        logger.add(new winston_1.default.transports.Console({
+            format: winston_1.default.format.combine(winston_1.default.format.colorize(), winston_1.default.format.simple())
+        }));
+    }
+    logger.info('应用启动', { port: 3000 });
+    logger.error('数据库连接失败', new Error('Connection timeout'));
+    console.log('\n生产环境配置要点:');
+    console.log('- 使用环境变量控制日志级别');
+    console.log('- 文件大小和数量限制');
+    console.log('- 开发和生产环境区分');
+}
+// #endregion
+// #region 示例2: HTTP 请求日志中间件
+function httpRequestLogger() {
+    console.log('\n=== HTTP 请求日志中间件 ===\n');
+    const logger = winston_1.default.createLogger({
+        level: 'http',
+        format: winston_1.default.format.combine(winston_1.default.format.timestamp(), winston_1.default.format.json()),
+        transports: [
+            new winston_1.default.transports.File({ filename: 'logs/http.log' }),
+            new winston_1.default.transports.Console({ format: winston_1.default.format.simple() })
+        ]
+    });
+    // 模拟 Express 中间件
+    function loggerMiddleware(req, res, next) {
+        const start = Date.now();
+        res.on('finish', () => {
+            const duration = Date.now() - start;
+            logger.http('HTTP Request', {
+                method: req.method,
+                url: req.url,
+                status: res.statusCode,
+                duration: `${duration}ms`,
+                ip: req.ip,
+                userAgent: req.get('user-agent')
+            });
+        });
+        next();
+    }
+    // 模拟请求
+    const mockReq = {
+        method: 'GET',
+        url: '/api/users',
+        ip: '192.168.1.1',
+        get: (header) => 'Mozilla/5.0'
+    };
+    const mockRes = {
+        statusCode: 200,
+        on: (event, callback) => {
+            if (event === 'finish') {
+                setTimeout(callback, 100);
+            }
+        }
+    };
+    loggerMiddleware(mockReq, mockRes, () => { });
+    console.log('\n可以集成到 Express/Koa 等框架中记录 HTTP 请求');
+}
+// #endregion
+// #region 示例3: 错误追踪和堆栈信息
+function errorTracking() {
+    console.log('\n=== 错误追踪和堆栈信息 ===\n');
+    const logger = winston_1.default.createLogger({
+        level: 'error',
+        format: winston_1.default.format.combine(winston_1.default.format.timestamp(), winston_1.default.format.errors({ stack: true }), winston_1.default.format.json()),
+        transports: [
+            new winston_1.default.transports.Console({
+                format: winston_1.default.format.prettyPrint()
+            })
+        ]
+    });
+    try {
+        // 模拟错误
+        throw new Error('数据库查询失败');
+    }
+    catch (error) {
+        logger.error('捕获到错误', {
+            error,
+            context: {
+                userId: '12345',
+                operation: 'getUserProfile'
+            }
+        });
+    }
+    console.log('\n错误日志包含完整的堆栈信息，便于调试');
+}
+// #endregion
+// #region 示例4: 子 Logger 和模块化
+function childLoggers() {
+    console.log('\n=== 子 Logger 和模块化 ===\n');
+    // 主 logger
+    const mainLogger = winston_1.default.createLogger({
+        level: 'info',
+        format: winston_1.default.format.combine(winston_1.default.format.timestamp(), winston_1.default.format.json()),
+        transports: [
+            new winston_1.default.transports.Console({ format: winston_1.default.format.simple() })
+        ]
+    });
+    // 为不同模块创建子 logger
+    const dbLogger = mainLogger.child({ module: 'database' });
+    const authLogger = mainLogger.child({ module: 'authentication' });
+    const apiLogger = mainLogger.child({ module: 'api' });
+    dbLogger.info('数据库连接成功', { host: 'localhost', port: 5432 });
+    authLogger.warn('登录尝试失败', { username: 'john', attempts: 3 });
+    apiLogger.info('API 请求', { endpoint: '/users', method: 'GET' });
+    console.log('\n子 logger 自动继承父 logger 的配置，并添加额外的元数据');
+}
+// #endregion
+// #region 示例5: 性能监控日志
+function performanceMonitoring() {
+    console.log('\n=== 性能监控日志 ===\n');
+    const logger = winston_1.default.createLogger({
+        level: 'info',
+        format: winston_1.default.format.combine(winston_1.default.format.timestamp(), winston_1.default.format.json()),
+        transports: [
+            new winston_1.default.transports.Console({ format: winston_1.default.format.simple() })
+        ]
+    });
+    // 性能监控辅助函数
+    function measurePerformance(operation, fn) {
+        const start = Date.now();
+        try {
+            fn();
+            const duration = Date.now() - start;
+            logger.info('操作完成', {
+                operation,
+                duration: `${duration}ms`,
+                status: 'success'
+            });
+        }
+        catch (error) {
+            const duration = Date.now() - start;
+            logger.error('操作失败', {
+                operation,
+                duration: `${duration}ms`,
+                status: 'failed',
+                error: error instanceof Error ? error.message : String(error)
+            });
+        }
+    }
+    // 使用示例
+    measurePerformance('数据库查询', () => {
+        // 模拟耗时操作
+        const start = Date.now();
+        while (Date.now() - start < 50) { }
+    });
+    measurePerformance('API 调用', () => {
+        const start = Date.now();
+        while (Date.now() - start < 30) { }
+    });
+    console.log('\n性能日志帮助识别系统瓶颈');
+}
+// #endregion
+// #region 示例6: 日志过滤和敏感信息脱敏
+function logFiltering() {
+    console.log('\n=== 日志过滤和敏感信息脱敏 ===\n');
+    // 自定义格式化器，过滤敏感信息
+    const maskSensitiveData = winston_1.default.format((info) => {
+        if (info.password) {
+            info.password = '******';
+        }
+        if (info.creditCard && typeof info.creditCard === 'string') {
+            info.creditCard = info.creditCard.replace(/\d(?=\d{4})/g, '*');
+        }
+        if (info.email && typeof info.email === 'string') {
+            info.email = info.email.replace(/(.{2})(.*)(@.*)/, '$1***$3');
+        }
+        return info;
+    });
+    const logger = winston_1.default.createLogger({
+        level: 'info',
+        format: winston_1.default.format.combine(maskSensitiveData(), winston_1.default.format.timestamp(), winston_1.default.format.json()),
+        transports: [
+            new winston_1.default.transports.Console({ format: winston_1.default.format.simple() })
+        ]
+    });
+    logger.info('用户注册', {
+        username: 'john_doe',
+        email: 'john.doe@example.com',
+        password: 'MySecretPassword123'
+    });
+    logger.info('支付信息', {
+        userId: '12345',
+        creditCard: '1234567890123456',
+        amount: 99.99
+    });
+    console.log('\n敏感信息已脱敏，保护用户隐私');
+}
+// #endregion
+if (require.main === module) {
+    const examples = [
+        { name: '生产环境日志配置', fn: productionLoggerConfig },
+        { name: 'HTTP 请求日志中间件', fn: httpRequestLogger },
+        { name: '错误追踪和堆栈信息', fn: errorTracking },
+        { name: '子 Logger 和模块化', fn: childLoggers },
+        { name: '性能监控日志', fn: performanceMonitoring },
+        { name: '日志过滤和敏感信息脱敏', fn: logFiltering }
+    ];
+    const exampleNumber = process.argv[2] ? parseInt(process.argv[2]) : null;
+    if (exampleNumber && exampleNumber >= 1 && exampleNumber <= examples.length) {
+        examples[exampleNumber - 1].fn();
+    }
+    else {
+        console.log('Winston 实战案例示例\n');
+        console.log('使用方法: ts-node 04-实战案例.ts [示例编号]\n');
+        examples.forEach((example, index) => {
+            console.log(`${index + 1}. ${example.name}`);
+        });
+        console.log('\n运行所有示例:');
+        examples.forEach(example => example.fn());
+    }
+}

package/package.json

@@ -3,7 +3,7 @@
   "publishConfig": {
     "access": "public"
   },
-  "version": "1.1.19",
+  "version": "1.1.21",
   "description": "ts test",
   "bin": {
     "nlearn": "dist/src/cli/index.js",
@@ -27,6 +27,7 @@
     "inquirer": "^9.3.8",
     "isomorphic-git": "^1.36.3",
     "prompts": "^2.4.2",
+    "winston": "^3.11.0",
     "yargs": "^18.0.0"
   },
   "engines": {