@done-coding/output-node 0.1.0-alpha.0 → 0.1.1

package/README.md

@@ -1,22 +1,28 @@
 # @done-coding/output-node
 
+[![NPM Version](https://img.shields.io/npm/v/@done-coding/output-node)](https://www.npmjs.com/package/@done-coding/output-node)
+[![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+[![Codecov](https://img.shields.io/codecov/c/github/done-coding/output-node)](https://codecov.io/gh/done-coding/output-node)
+
 Node.js 环境下的同构输出工具包，基于 @done-coding/output-core 核心包构建，提供控制台输出和日志文件输出功能。
 
-## 特性
+## 功能特性
 
 - 🎨 **丰富的控制台输出** - 支持多种输出类型和颜色配置
 - 📝 **专业的日志文件输出** - 基于 pino 的高性能日志记录
 - 🔄 **混合类型接口** - 支持函数调用和属性链式调用两种方式
 - 🛡️ **临终落盘保护** - 使用 signal-exit 库实现非侵入式进程退出监听
-- 🚨 **信号监听** - 与 NestJS 等现代框架完美兼容
-- ⚡ **高性能** - 异步日志写入，预计算枚举映射
+- 🚨 **框架兼容** - 与 NestJS 等现代框架的关闭钩子完美兼容
+- ⚡ **高性能** - 异步日志写入，可配置缓冲区大小
 - 🔧 **完整的错误处理** - 输入验证、配置验证、文件权限检查
-- 📦 **TypeScript 支持** - 完整的类型定义和类型推导
-- 🎯 **输出模式切换** - 支持控制台和日志文件之间的智能切换
+- 📦 **完整类型支持** - 100% TypeScript 类型定义和类型推导
+- 🔇 **动态静默控制** - 支持运行时动态控制输出静默，基于类型的条件静默
+- 🎯 **智能切换同步** - 支持控制台和日志文件之间的智能切换和同步
 - 📋 **TABLE 类型特殊处理** - 智能表格数据展示和 JSON 序列化
-- 🔧 **常量集中管理** - 所有配置参数的默认值统一管理
 
-## 安装
+## 快速开始
+
+### 安装
 
 ```bash
 npm install @done-coding/output-node
@@ -26,247 +32,228 @@ yarn add @done-coding/output-node
 pnpm add @done-coding/output-node
 ```
 
-## 快速开始
-
-### 控制台输出
+### 最小可用示例
 
 ```typescript
 import {
   createOutputConsole,
-  OutputConsoleTypeEnum,
-} from "@done-coding/output-node";
-
-// 创建控制台输出实例
-const outputConsole = createOutputConsole({
-  enableColor: true, // 启用颜色输出
-  silent: false, // 非静默模式
-});
-
-// 函数调用方式
-outputConsole(OutputConsoleTypeEnum.INFO, "这是一条信息");
-outputConsole(OutputConsoleTypeEnum.SUCCESS, "操作成功！");
-outputConsole(OutputConsoleTypeEnum.ERROR, "发生错误");
-
-// 属性链式调用方式（推荐）
-outputConsole.info("这是一条信息");
-outputConsole.success("操作成功！");
-outputConsole.error("发生错误");
-outputConsole.warn("这是一个警告");
-outputConsole.debug("调试信息");
-outputConsole.stage("当前步骤");
-outputConsole.skip("跳过此步骤");
-
-// TABLE 类型特殊处理
-outputConsole.table({
-  name: "张三",
-  age: 25,
-  city: "北京",
-});
-```
-
-### 日志文件输出
-
-```typescript
-import {
   createOutputLogFile,
-  OutputLogFileTypeEnum,
 } from "@done-coding/output-node";
 
-// 创建日志文件输出实例
-const logger = createOutputLogFile({
-  logFilePath: "app.log", // 可选，默认自动生成
-  prettyPrint: false, // 是否美化输出
-  silent: false, // 非静默模式
-  sync: false, // 异步写入（推荐）
-  bufferSize: 4096, // 缓冲区大小
-});
+// 创建控制台输出
+const output = createOutputConsole();
+output.info("Hello World");
+output.success("操作成功");
 
-// 函数调用方式
-logger(OutputLogFileTypeEnum.INFO, "应用启动");
-logger(OutputLogFileTypeEnum.ERROR, "数据库连接失败");
-
-// 属性链式调用方式（推荐）
+// 创建日志文件输出
+const logger = createOutputLogFile({ logFilePath: "app.log" });
 logger.info("应用启动");
-logger.warn("内存使用率较高");
-logger.error("数据库连接失败");
-logger.debug("调试信息");
-logger.trace("详细跟踪信息");
-logger.fatal("致命错误，应用即将退出");
+logger.error("发生错误");
 ```
 
-### 输出模式切换
+## 架构设计
 
-```typescript
-import { outputLogFile } from "@done-coding/output-node";
+### 分层架构
 
-// 支持输出到控制台
-const logger1 = outputLogFile({
-  outputToConsole: true, // 输出到控制台
-  prettyPrint: true, // 美化输出
-});
-
-// 支持输出到文件
-const logger2 = outputLogFile({
-  outputToConsole: false, // 输出到文件
-  logFilePath: "app.log",
-  sync: true, // 同步写入
-});
+```
+┌─────────────────────────────────────┐
+│        Node.js 适配包层              │
+│   (@done-coding/output-node)        │
+├─────────────────────────────────────┤
+│            核心包层                   │
+│     (@done-coding/output-core)      │
+├─────────────────────────────────────┤
+│           驱动实现层                  │
+│   (console.log, pino, chalk, etc.)  │
+└─────────────────────────────────────┘
 ```
 
-### 切换和同步逻辑
+### 设计原则
 
-```typescript
-import {
-  createOutputConsole,
-  createOutputLogFile,
-  OutputConsoleTypeEnum,
-} from "@done-coding/output-node";
+1. **自动化驱动** - 自动创建和管理输出驱动实现
+2. **零配置** - 提供合理的默认配置，开箱即用
+3. **高性能** - 异步日志写入，可配置缓冲区
+4. **安全可靠** - 完整的错误处理和防御性编程
+5. **框架兼容** - 与现代框架（NestJS、Express 等）完美兼容
+6. **极简 API** - 最少化的配置参数，易于使用
 
-// 创建日志文件输出实例
-const fileLogger = createOutputLogFile({ logFilePath: "error.log" });
+### 内置实现
 
-// 创建带有切换和同步逻辑的控制台输出
-const outputConsole = createOutputConsole({
-  enableColor: true,
-  // 错误级别切换到日志文件（不在控制台显示）
-  isSwitchLogFile: (type) => type === OutputConsoleTypeEnum.ERROR,
-  // 警告级别同步到日志文件（控制台和文件都显示）
-  isSyncToLogFile: (type) => type === OutputConsoleTypeEnum.WARN,
-  // 指定日志文件输出函数
-  outputFileFn: fileLogger,
-});
+#### 控制台输出驱动
 
-outputConsole.info("普通信息"); // 只在控制台显示
-outputConsole.warn("警告信息"); // 控制台和文件都显示
-outputConsole.error("错误信息"); // 只在文件中记录
-```
+- **基础实现**: `console.log` + `chalk` 颜色支持
+- **颜色配置**: 支持自定义颜色映射和禁用颜色
+- **TABLE 类型**: 自动调用 `console.table` 进行表格展示
+- **错误处理**: 颜色格式化失败时自动降级到无颜色输出
+
+#### 日志文件输出驱动
+
+- **基础实现**: `pino` + `sonic-boom` 高性能日志写入
+- **缓冲机制**: 可配置缓冲区大小，支持同步/异步写入
+- **临终保护**: 使用 `signal-exit` 实现非侵入式进程退出监听
+- **内置控制台**: 自动提供 `outputConsoleFn`，基于 pino 输出到控制台
 
 ## API 文档
 
-### createOutputConsole(options?)
+### createOutputConsole
 
 创建控制台输出实例。
 
-#### 参数
+**签名：**
 
-- `options` (可选) - 配置选项
-  - `silent?: boolean` - 是否静默模式，默认 `false`
-  - `enableColor?: boolean` - 是否启用颜色输出，默认 `true`
-  - `colorMap?: Record<OutputConsoleTypeEnum, string>` - 自定义颜色映射
-  - `isSwitchLogFile?: (type: OutputConsoleTypeEnum) => boolean` - 切换到日志文件的条件函数
-  - `isSyncToLogFile?: (type: OutputConsoleTypeEnum) => boolean` - 同步到日志文件的条件函数
-  - `outputFileFn?: OutputLogFile` - 日志文件输出函数
+```typescript
+function createOutputConsole(
+  options?: CreateOutputConsoleOptions,
+): OutputConsole;
+```
 
-#### 返回值
+**参数：**
 
-返回 `OutputConsole` 混合类型实例，支持：
+| 参数                    | 类型                                  | 默认值 | 说明                 |
+| ----------------------- | ------------------------------------- | ------ | -------------------- |
+| options.isSilent        | (type) => boolean                     | -      | 动态静默控制函数     |
+| options.enableColor     | boolean                               | true   | 是否启用颜色输出     |
+| options.colorMap        | Record<OutputConsoleTypeEnum, string> | -      | 自定义颜色映射       |
+| options.isSwitchLogFile | (type) => boolean                     | -      | 切换到日志文件的条件 |
+| options.isSyncToLogFile | (type) => boolean                     | -      | 同步到日志文件的条件 |
+| options.outputFileFn    | OutputConsoleRaw                      | -      | 日志文件输出函数     |
 
-- 函数调用：`output(type, ...messages)`
-- 属性调用：`output.info(...messages)`、`output.error(...messages)` 等
+**返回值：** OutputConsole 混合类型实例
 
-### createOutputLogFile(options?)
+**示例：**
 
-创建日志文件输出实例。
+```typescript
+const output = createOutputConsole({
+  enableColor: true,
+  isSilent: (type) =>
+    type === OutputConsoleTypeEnum.DEBUG && !process.env.DEBUG,
+});
 
-#### 参数
+output.info("信息");
+output.success("成功");
+output.error("错误");
+```
 
-- `options` (可选) - 配置选项
-  - `silent?: boolean` - 是否静默模式，默认 `false`
-  - `logFilePath?: string` - 日志文件路径，默认自动生成
-  - `prettyPrint?: boolean` - 是否启用美化输出，默认 `false`
-  - `sync?: boolean` - 是否同步写入，默认 `false`
-  - `bufferSize?: number` - 缓冲区大小，默认 `4096`
+### createOutputLogFile
 
-#### 返回值
+创建日志文件输出实例。
 
-返回 `OutputLogFile` 混合类型实例，支持：
+**签名：**
 
-- 函数调用：`logger(type, ...messages)`
-- 属性调用：`logger.info(...messages)`、`logger.error(...messages)` 等
+```typescript
+function createOutputLogFile(
+  options: CreateOutputLogFileOptions,
+): OutputLogFile;
+```
 
-### outputLogFile(options?)
+**参数：**
 
-创建支持输出模式切换的日志实例。
+| 参数                    | 类型              | 默认值 | 说明                 |
+| ----------------------- | ----------------- | ------ | -------------------- |
+| options.logFilePath     | string            | -      | 日志文件路径（必传） |
+| options.isSilent        | (type) => boolean | -      | 动态静默控制函数     |
+| options.sync            | boolean           | false  | 是否同步写入         |
+| options.bufferSize      | number            | 4096   | 缓冲区大小（字节）   |
+| options.isSwitchConsole | (type) => boolean | -      | 切换到控制台的条件   |
 
-#### 参数
+**返回值：** OutputLogFile 混合类型实例
 
-- `options` (可选) - 配置选项
-  - `outputToConsole?: boolean` - 是否输出到控制台，默认 `false`
-  - `prettyPrint?: boolean` - 是否美化输出，默认 `false`
-  - `logFilePath?: string` - 日志文件路径（当 `outputToConsole` 为 `false` 时）
-  - `sync?: boolean` - 是否同步写入，默认 `false`
-  - `bufferSize?: number` - 缓冲区大小，默认 `4096`
+**示例：**
+
+```typescript
+const logger = createOutputLogFile({
+  logFilePath: "app.log",
+  sync: false,
+  bufferSize: 8192,
+});
+
+logger.info("应用启动");
+logger.error("数据库连接失败");
+```
 
 ### 输出类型枚举
 
 #### OutputConsoleTypeEnum
 
-控制台输出类型枚举：
-
-```typescript
-enum OutputConsoleTypeEnum {
-  DEBUG = 31, // 调试信息
-  SKIP = 32, // 跳过
-  INFO = 33, // 提示信息
-  TABLE = 34, // 表格
-  STAGE = 35, // 步骤
-  SUCCESS = 36, // 成功
-  WARN = 37, // 警告
-  ERROR = 38, // 错误
-}
-```
+| 值  | 名称    | 说明     |
+| --- | ------- | -------- |
+| 31  | DEBUG   | 调试信息 |
+| 32  | SKIP    | 跳过     |
+| 33  | INFO    | 提示信息 |
+| 34  | TABLE   | 表格     |
+| 35  | STAGE   | 步骤     |
+| 36  | SUCCESS | 成功     |
+| 37  | WARN    | 警告     |
+| 38  | ERROR   | 错误     |
 
 #### OutputLogFileTypeEnum
 
-日志文件输出类型枚举（对齐 Pino 标准）：
+| 值  | 名称  | 说明         |
+| --- | ----- | ------------ |
+| 10  | TRACE | 跟踪级别     |
+| 20  | DEBUG | 调试级别     |
+| 30  | INFO  | 信息级别     |
+| 40  | WARN  | 警告级别     |
+| 50  | ERROR | 错误级别     |
+| 60  | FATAL | 致命错误级别 |
 
-```typescript
-enum OutputLogFileTypeEnum {
-  TRACE = 10, // 跟踪级别
-  DEBUG = 20, // 调试级别
-  INFO = 30, // 信息级别
-  WARN = 40, // 警告级别
-  ERROR = 50, // 错误级别
-  FATAL = 60, // 致命错误级别
-}
-```
-
-## 高级功能
+## 进阶使用
 
-### 临终落盘保护
-
-Node.js 包使用 signal-exit 库实现非侵入式临终落盘保护机制，确保进程退出时日志数据不丢失：
+### 动态静默控制
 
 ```typescript
-import { createOutputLogFile } from "@done-coding/output-node";
+import {
+  createOutputConsole,
+  OutputConsoleTypeEnum,
+} from "@done-coding/output-node";
 
-// 创建日志实例会自动注册 signal-exit 监听器
-const logger = createOutputLogFile({ logFilePath: "app.log" });
+const output = createOutputConsole({
+  // 动态控制静默：只在调试模式下显示 DEBUG 信息
+  isSilent: (type) => {
+    if (type === OutputConsoleTypeEnum.DEBUG) {
+      return !process.env.DEBUG;
+    }
+    // 生产环境下静默所有 SKIP 类型
+    if (type === OutputConsoleTypeEnum.SKIP) {
+      return process.env.NODE_ENV === "production";
+    }
+    return false;
+  },
+});
 
-logger.info("应用启动");
-// 当收到 SIGINT 或 SIGTERM 信号时，会自动刷新日志缓冲区
-// 与 NestJS 等现代框架的关闭钩子完美兼容
+output.debug("调试信息"); // 只在 DEBUG=true 时显示
+output.skip("跳过信息"); // 生产环境下不显示
+output.info("普通信息"); // 总是显示
 ```
 
-### 错误处理
-
-包含完整的错误处理机制：
+### 切换和同步逻辑
 
 ```typescript
 import {
   createOutputConsole,
-  DriverInitializationError,
+  createOutputLogFile,
+  OutputConsoleTypeEnum,
 } from "@done-coding/output-node";
 
-try {
-  const outputConsole = createOutputConsole({
-    bufferSize: -1, // 无效配置会抛出错误
-  });
-} catch (error) {
-  if (error instanceof DriverInitializationError) {
-    console.error("驱动初始化失败:", error.message);
-  }
-}
+// 创建日志文件输出
+const fileLogger = createOutputLogFile({ logFilePath: "error.log" });
+
+// 创建带有切换和同步逻辑的控制台输出
+const output = createOutputConsole({
+  enableColor: true,
+  // 错误级别切换到日志文件（不在控制台显示）
+  isSwitchLogFile: (type) => type === OutputConsoleTypeEnum.ERROR,
+  // 警告级别同步到日志文件（控制台和文件都显示）
+  isSyncToLogFile: (type) => type === OutputConsoleTypeEnum.WARN,
+  outputFileFn: (type, ...messages) => {
+    // 将控制台类型映射到日志文件类型并输出
+    fileLogger(type, ...messages);
+  },
+});
+
+output.info("普通信息"); // 只在控制台显示
+output.warn("警告信息"); // 控制台和文件都显示
+output.error("错误信息"); // 只在文件中记录
 ```
 
 ### 自定义颜色配置
@@ -277,7 +264,7 @@ import {
   OutputConsoleTypeEnum,
 } from "@done-coding/output-node";
 
-const outputConsole = createOutputConsole({
+const output = createOutputConsole({
   enableColor: true,
   colorMap: {
     [OutputConsoleTypeEnum.INFO]: "blue",
@@ -291,161 +278,126 @@ const outputConsole = createOutputConsole({
 ### 缓冲区配置
 
 ```typescript
-import { createOutputLogFile } from "@done-coding/output-node";
-
-// 自定义缓冲区大小
+// 异步写入模式（推荐用于生产环境）
 const logger = createOutputLogFile({
-  bufferSize: 8192, // 8KB 缓冲区
+  logFilePath: "app.log",
   sync: false, // 异步写入
+  bufferSize: 8192, // 8KB 缓冲区
 });
 
 // 同步写入模式（性能较低但数据安全性更高）
 const syncLogger = createOutputLogFile({
+  logFilePath: "critical.log",
   sync: true, // 同步写入
   bufferSize: 1024, // 较小的缓冲区
 });
 ```
 
-### 工具函数
+### TABLE 类型处理
 
 ```typescript
-import {
-  generateDefaultNodeLogFileName,
-  getConsoleTypeName,
-  getLogFileTypeName,
-} from "@done-coding/output-node";
+const output = createOutputConsole();
 
-// 生成默认日志文件名
-const fileName = generateDefaultNodeLogFileName();
-console.log(fileName); // 20240131_235959-12345.log
+// 数组表格
+output.table([
+  { name: "张三", age: 25, city: "北京" },
+  { name: "李四", age: 30, city: "上海" },
+]);
 
-// 获取类型名称
-console.log(getConsoleTypeName(OutputConsoleTypeEnum.INFO)); // "INFO"
-console.log(getLogFileTypeName(OutputLogFileTypeEnum.ERROR)); // "ERROR"
+// 对象表格
+output.table({
+  total: 100,
+  success: 95,
+  failed: 5,
+});
 ```
 
-## 最佳实践
-
-### 1. 使用属性调用方式
+### 临终落盘保护
 
 ```typescript
-// ✅ 推荐：属性调用方式
-outputConsole.info("用户登录成功");
-outputConsole.error("数据库连接失败");
+import { createOutputLogFile } from "@done-coding/output-node";
 
-// ❌ 不推荐：函数调用方式（虽然也支持）
-outputConsole(OutputConsoleTypeEnum.INFO, "用户登录成功");
+// 创建日志实例会自动注册 signal-exit 监听器
+const logger = createOutputLogFile({ logFilePath: "app.log" });
+
+logger.info("应用启动");
+
+// 当收到 SIGINT 或 SIGTERM 信号时，会自动刷新日志缓冲区
+// 与 NestJS 等现代框架的关闭钩子完美兼容
 ```
 
-### 2. 合理配置日志级别
+## 开发与测试
 
-```typescript
-// 开发环境
-const devLogger = createOutputLogFile({
-  prettyPrint: true, // 美化输出便于调试
-  logFilePath: "dev.log",
-  outputToConsole: true, // 同时输出到控制台
-});
+### 测试覆盖率
 
-// 生产环境
-const prodLogger = createOutputLogFile({
-  prettyPrint: false, // 标准 JSON 格式
-  logFilePath: `/var/log/app-${process.pid}.log`,
-  sync: false, // 异步写入提高性能
-  bufferSize: 8192, // 较大缓冲区
-});
-```
+- **语句覆盖率**: 99.35%
+- **分支覆盖率**: 97.63%
+- **函数覆盖率**: 97.5%
+- **行覆盖率**: 99.35%
+- **测试数量**: 181 个测试，全部通过
 
-### 3. 错误处理和降级
+### 本地开发
 
-```typescript
-import { createOutputLogFile } from "@done-coding/output-node";
+```bash
+# 克隆仓库
+git clone https://github.com/done-coding/output-node.git
+cd output-node
 
-try {
-  const logger = createOutputLogFile({
-    logFilePath: "/protected/app.log",
-    bufferSize: 4096,
-  });
-} catch (error) {
-  // 降级到控制台输出
-  console.warn("日志文件创建失败，降级到控制台输出");
-  const fallbackLogger = createOutputLogFile({
-    outputToConsole: true,
-    prettyPrint: true,
-  });
-}
-```
+# 安装依赖
+pnpm install
 
-### 4. 性能优化
+# 开发模式
+pnpm dev
 
-```typescript
-// 在高频输出场景下使用静默模式进行性能测试
-const outputConsole = createOutputConsole({
-  silent: process.env.NODE_ENV === "test",
-});
+# 运行测试
+pnpm test
 
-// 批量输出时考虑使用异步日志
-const logger = createOutputLogFile({
-  logFilePath: "batch.log",
-  prettyPrint: false, // 禁用美化以提高性能
-  sync: false, // 异步写入
-  bufferSize: 16384, // 更大的缓冲区
-});
+# 构建
+pnpm build
 ```
 
-### 5. TABLE 类型最佳实践
+### 贡献流程
 
-```typescript
-// ✅ 推荐：结构化数据
-outputConsole.table([
-  { name: "张三", age: 25, city: "北京" },
-  { name: "李四", age: 30, city: "上海" },
-]);
+1. Fork 本仓库
+2. 创建特性分支 (`git checkout -b feature/AmazingFeature`)
+3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)
+4. 推送到分支 (`git push origin feature/AmazingFeature`)
+5. 开启 Pull Request
 
-// ✅ 推荐：对象数据
-outputConsole.table({
-  total: 100,
-  success: 95,
-  failed: 5,
-});
+## 常见问题
 
-// ❌ 避免：非结构化数据
-outputConsole.table("这不是表格数据");
-```
+**Q: 为什么 Node 包不需要传入 `outputImpl` 参数？**
 
-## 依赖
+A: Node 包自动提供了基于 `console.log + chalk` 和 `pino` 的输出实现，用户无需手动创建和传入 `outputImpl`。这是 Node 包相比 Core 包的主要优势。
 
-- `@done-coding/output-core` - 核心包
-- `chalk` - 控制台颜色输出
-- `pino` - 高性能日志库
-- `pino-pretty` - 日志美化输出
-- `signal-exit` - 非侵入式进程退出监听
+**Q: 如何在生产环境中优化日志性能？**
 
-## 测试覆盖率
+A: 使用异步写入模式（`sync: false`），适当增加缓冲区大小（如 8KB 或 16KB），并合理配置 `isSilent` 函数来过滤不必要的日志输出。
 
-- **语句覆盖率**: 99.51%
-- **分支覆盖率**: 98.13%
-- **函数覆盖率**: 97.29%
-- **行覆盖率**: 99.51%
-- **测试数量**: 182 个测试，全部通过
+**Q: 如何在 NestJS 中使用？**
 
-## 许可证
+A: 可以在 NestJS 的 OnModuleInit 和 OnApplicationShutdown 钩子中使用，临终落盘保护会自动处理进程退出时的日志刷新。
 
-MIT
+**Q: 日志文件路径可以是相对路径吗？**
+
+A: 可以，相对路径会相对于当前工作目录。建议使用绝对路径以避免歧义。
+
+**Q: 如何禁用颜色输出？**
+
+A: 设置 `enableColor: false` 即可。
+
+**Q: 缓冲区大小应该设置多少？**
 
-## 贡献
+A: 默认 4KB 适合大多数场景。高频输出可以增加到 8KB 或 16KB，低频输出可以减少到 1KB。
 
-欢迎提交 Issue 和 Pull Request！
+**Q: 支持哪些 Node.js 版本？**
 
-## 更新日志
+A: 支持 Node.js 14+，推荐使用 Node.js 16+。
 
-### v0.0.0
+**Q: 如何处理日志文件权限错误？**
 
-- 初始版本发布
-- 支持控制台输出和日志文件输出
-- 实现基于 signal-exit 的临终落盘保护机制
-- 完整的错误处理和类型推导支持
-- 输出模式切换功能
-- TABLE 类型特殊处理
-- 常量集中管理
-- 缓冲区大小配置和验证
+A: 包会自动捕获权限错误并静默处理，日志会降级到内存缓冲。建议检查文件路径和目录权限。
+
+## 许可证
+
+MIT