@mcpcn/markdown-converter 1.0.10

package/README.md

@@ -0,0 +1,210 @@
+# 统一Markdown转换MCP服务器
+
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.3-blue.svg)](https://www.typescriptlang.org/)
+[![Node.js](https://img.shields.io/badge/Node.js-18+-green.svg)](https://nodejs.org/)
+[![MCP](https://img.shields.io/badge/MCP-1.0-orange.svg)](https://modelcontextprotocol.io/)
+
+一个功能强大的MCP (Model Context Protocol) 服务器，支持将Markdown文档转换为PDF和Word格式。**特别优化了代码块显示效果**，确保在转换后的文档中代码的完美呈现。
+
+## ✨ 主要特性
+
+### 🔄 双格式支持
+- **PDF转换**: 高质量PDF生成，支持模板、水印、语法高亮等高级功能
+- **Word转换**: 专业级Word文档生成，**特别优化代码块显示效果**
+
+### 🎨 丰富的自定义选项
+- **PDF样式**: 内置经过优化的默认模板
+- **Word主题**: default, github, dark, minimal 四种代码块主题
+- **自定义样式**: 字体、颜色、间距等完全可定制
+
+### ⚡ 性能优化
+- **智能缓存**: 文件系统 + 内存双重缓存机制
+- **并发控制**: 资源池管理，支持批量转换
+- **增量处理**: 避免重复转换，提高效率
+
+## 🛠️ 可用工具
+
+### 1. `convert_to_pdf` - PDF转换
+将Markdown内容或文件转换为PDF文件。
+
+**参数:**
+- `markdown` (必填): Markdown内容或.md文件路径
+- `outputPath` (可选): 输出PDF文件路径
+- `paperFormat` (可选): 页面格式 (a4/a3/a5/letter/legal/tabloid)
+- `paperOrientation` (可选): 页面方向 (portrait/landscape)
+- `watermark` (可选): 水印设置
+- `enableSyntaxHighlight` (可选): 启用语法高亮
+- `enableMermaid` (可选): 启用Mermaid图表
+
+### 2. `convert_to_word` - Word转换
+将Markdown内容或文件转换为Word文档，特别优化了代码块显示。
+
+**参数:**
+- `markdown` (必填): Markdown内容或.md文件路径
+- `outputPath` (可选): 输出Word文件路径
+- `theme` (可选): 代码块主题 (default/github/dark/minimal)
+- `addFooter` (可选): 是否添加页脚页码
+- `showLanguage` (可选): 是否显示代码块语言标识
+
+### 3. `convert_batch` - 批量转换
+批量转换多个Markdown文件。
+
+**参数:**
+- `files` (必填): Markdown文件路径列表
+- `format` (可选): 输出格式 (pdf/word/both)
+- `outputDir` (可选): 输出目录
+- `theme` (可选): Word主题
+
+### 4. `list_themes` - 列出主题
+列出所有可用的Word代码块主题。
+
+## 🎯 使用示例
+
+### PDF转换示例
+```javascript
+// 转换文件
+{
+  "tool": "convert_to_pdf",
+  "arguments": {
+    "markdown": "/path/to/document.md",
+    "outputPath": "/path/to/output.pdf",
+    "watermark": {
+      "text": "Draft",
+      "opacity": 0.1
+    }
+  }
+}
+
+// 转换内容
+{
+  "tool": "convert_to_pdf",
+  "arguments": {
+    "markdown": "# 我的文档\n\n```python\nprint('Hello World')\n```"
+  }
+}
+```
+
+### Word转换示例
+```javascript
+// 转换文件
+{
+  "tool": "convert_to_word",
+  "arguments": {
+    "markdown": "/path/to/document.md",
+    "outputPath": "/path/to/output.docx",
+    "theme": "github",
+    "showLanguage": true
+  }
+}
+
+// 批量转换
+{
+  "tool": "convert_batch",
+  "arguments": {
+    "files": ["/path/to/doc1.md", "/path/to/doc2.md"],
+    "format": "both",
+    "outputDir": "/path/to/output",
+    "theme": "dark"
+  }
+}
+```
+
+## 🎨 代码块主题
+
+### Word文档主题
+- **default**: 经典灰色背景，适合日常使用
+- **github**: GitHub风格，清新简洁
+- **dark**: 暗色主题，护眼舒适
+- **minimal**: 极简风格，简约优雅
+
+每个主题都经过精心调优，确保代码的可读性和美观性。
+
+## ⚙️ 环境变量
+
+- `OUTPUT_DIR`: 默认输出目录 (默认: 用户主目录)
+- `MAX_CONCURRENT`: 最大并发数 (默认: 2)
+- `MAX_BROWSERS`: 最大浏览器实例数 (默认: 3)
+- `DISABLE_CACHE`: 禁用缓存 (设置为 'true' 禁用)
+
+## 📁 项目结构
+
+```
+src/
+├── core/                    # 核心转换器
+│   ├── BaseConverter.ts     # 抽象基类
+│   ├── PDFConverter.ts      # PDF转换器
+│   └── WordConverter.ts     # Word转换器
+├── config/                  # 配置文件
+│   └── word.ts             # Word样式配置
+├── templates/              # 模板资源
+│   ├── pdf/               # PDF模板
+│   └── word/              # Word模板
+├── types/                 # 类型定义
+└── index.ts              # MCP服务器入口
+```
+
+## 🔧 开发
+
+### 安装依赖
+```bash
+npm install
+```
+
+### 构建项目
+```bash
+npm run build
+```
+
+### 运行服务器
+```bash
+npm start
+```
+
+### 开发模式
+```bash
+npm run dev
+```
+
+## 📄 技术栈
+
+- **TypeScript**: 类型安全的JavaScript超集
+- **MCP SDK**: Model Context Protocol 软件开发包
+- **Puppeteer**: PDF生成和页面渲染
+- **docx**: Word文档生成库
+- **Remarkable**: Markdown解析器
+
+## 🌟 亮点功能
+
+### 1. 完美的代码块显示
+基于原md-to-word-mcp项目的成功实现，每一行代码都作为独立段落处理，确保：
+- 保持原有缩进结构
+- 支持多种编程语言
+- 语法高亮效果
+- 边框和背景美化
+
+### 2. 智能缓存机制
+- **文件缓存**: 转换结果持久化存储
+- **内存缓存**: HTML渲染结果临时缓存
+- **自动清理**: 过期缓存自动清理
+- **缓存键优化**: 基于内容和配置生成唯一键
+
+### 3. 资源优化管理
+- **浏览器池**: 复用Puppeteer实例
+- **并发控制**: 防止资源过度使用
+- **优雅关闭**: 确保资源正确释放
+
+## 🤝 贡献
+
+欢迎提交Issue和Pull Request！
+
+## 📜 许可证
+
+MIT License
+
+---
+
+**本项目融合了以下优秀项目的精华：**
+- 原 `enhanced-markdown2pdf-mcp` 的高性能PDF转换能力
+- 原 `md-to-word-mcp` 的优化Word代码块显示技术
+
+通过统一架构设计，为用户提供一站式Markdown文档转换解决方案。

package/dist/config/word.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Word转换器配置
+ * 基于 md-to-word-mcp 项目的成功实现
+ */
+export interface WordStyleConfig {
+    fonts: {
+        default: string;
+        code: string;
+        heading: string;
+    };
+    fontSizes: {
+        title: number;
+        heading1: number;
+        heading2: number;
+        heading3: number;
+        heading4: number;
+        heading5: number;
+        paragraph: number;
+        code: number;
+        codeBlock: number;
+    };
+    colors: {
+        text: string;
+        heading: string;
+        code: string;
+        codeBackground: string;
+        codeBorder: string;
+        link: string;
+    };
+    spacing: {
+        paragraph: number;
+        heading: number;
+        codeBlock: number;
+        line: number;
+    };
+    margins: {
+        page: {
+            top: number;
+            right: number;
+            bottom: number;
+            left: number;
+        };
+        codeBlock: {
+            left: number;
+        };
+    };
+}
+export declare const defaultWordStyleConfig: WordStyleConfig;
+export interface CodeBlockTheme {
+    name: string;
+    background: string;
+    border: string;
+    textColor: string;
+    fontSize: number;
+    fontFamily: string;
+    showLanguage: boolean;
+}
+export declare const codeBlockThemes: {
+    [key: string]: CodeBlockTheme;
+};
+export interface WordConversionOptions {
+    styleConfig?: Partial<WordStyleConfig>;
+    codeBlockTheme?: string | CodeBlockTheme;
+    addFooter?: boolean;
+    showLineNumbers?: boolean;
+}
+//# sourceMappingURL=word.d.ts.map

package/dist/config/word.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"word.d.ts","sourceRoot":"","sources":["../../src/config/word.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,eAAe;IAE9B,KAAK,EAAE;QACL,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IAGF,SAAS,EAAE;QACT,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;QAClB,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;IAGF,MAAM,EAAE;QACN,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,cAAc,EAAE,MAAM,CAAC;QACvB,UAAU,EAAE,MAAM,CAAC;QACnB,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;IAGF,OAAO,EAAE;QACP,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;QAClB,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;IAGF,OAAO,EAAE;QACP,IAAI,EAAE;YACJ,GAAG,EAAE,MAAM,CAAC;YACZ,KAAK,EAAE,MAAM,CAAC;YACd,MAAM,EAAE,MAAM,CAAC;YACf,IAAI,EAAE,MAAM,CAAC;SACd,CAAC;QACF,SAAS,EAAE;YACT,IAAI,EAAE,MAAM,CAAC;SACd,CAAC;KACH,CAAC;CACH;AAED,eAAO,MAAM,sBAAsB,EAAE,eA8CpC,CAAC;AAEF,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,OAAO,CAAC;CACvB;AAED,eAAO,MAAM,eAAe,EAAE;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,CAAA;CAwC5D,CAAC;AAEF,MAAM,WAAW,qBAAqB;IACpC,WAAW,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,CAAC;IACvC,cAAc,CAAC,EAAE,MAAM,GAAG,cAAc,CAAC;IACzC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B"}

package/dist/config/word.js

@@ -0,0 +1,86 @@
+/**
+ * Word转换器配置
+ * 基于 md-to-word-mcp 项目的成功实现
+ */
+export const defaultWordStyleConfig = {
+    fonts: {
+        default: 'SimSun,Times New Roman', // 添加中文字体支持
+        code: 'Consolas,SimHei', // 代码字体也支持中文
+        heading: 'SimHei,Arial', // 标题使用黑体
+    },
+    fontSizes: {
+        title: 36, // 18pt - 主标题
+        heading1: 32, // 16pt - H1
+        heading2: 28, // 14pt - H2
+        heading3: 26, // 13pt - H3
+        heading4: 24, // 12pt - H4
+        heading5: 22, // 11pt - H5
+        paragraph: 24, // 12pt - 正文
+        code: 22, // 11pt - 内联代码
+        codeBlock: 20, // 10pt - 代码块
+    },
+    colors: {
+        text: '333333',
+        heading: '000000',
+        code: '333333',
+        codeBackground: 'F8F8F8',
+        codeBorder: 'DDDDDD',
+        link: '0000FF',
+    },
+    spacing: {
+        paragraph: 120, // 段落后间距
+        heading: 360, // 标题前间距
+        codeBlock: 180, // 代码块前后间距
+        line: 280, // 代码块固定行高
+    },
+    margins: {
+        page: {
+            top: 1440, // 1英寸
+            right: 1080, // 0.75英寸
+            bottom: 1440, // 1英寸
+            left: 1080, // 0.75英寸
+        },
+        codeBlock: {
+            left: 200, // 代码块左缩进
+        },
+    },
+};
+export const codeBlockThemes = {
+    default: {
+        name: 'Default',
+        background: 'F8F8F8',
+        border: 'DDDDDD',
+        textColor: '333333',
+        fontSize: 20, // 10pt
+        fontFamily: 'Consolas,SimHei',
+        showLanguage: true,
+    },
+    dark: {
+        name: 'Dark',
+        background: '2D2D2D',
+        border: '404040',
+        textColor: 'F8F8F2',
+        fontSize: 20, // 10pt
+        fontFamily: 'Consolas,SimHei',
+        showLanguage: true,
+    },
+    github: {
+        name: 'GitHub',
+        background: 'F6F8FA',
+        border: 'D0D7DE',
+        textColor: '24292F',
+        fontSize: 18, // 9pt
+        fontFamily: 'Consolas,SimHei',
+        showLanguage: true,
+    },
+    minimal: {
+        name: 'Minimal',
+        background: 'FAFAFA',
+        border: 'E1E4E8',
+        textColor: '586069',
+        fontSize: 19, // 9.5pt
+        fontFamily: 'Monaco,SimHei',
+        showLanguage: false,
+    },
+};
+//# sourceMappingURL=word.js.map

package/dist/config/word.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"word.js","sourceRoot":"","sources":["../../src/config/word.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAuDH,MAAM,CAAC,MAAM,sBAAsB,GAAoB;IACrD,KAAK,EAAE;QACL,OAAO,EAAE,wBAAwB,EAAE,WAAW;QAC9C,IAAI,EAAE,iBAAiB,EAAW,YAAY;QAC9C,OAAO,EAAE,cAAc,EAAY,SAAS;KAC7C;IAED,SAAS,EAAE;QACT,KAAK,EAAE,EAAE,EAAO,aAAa;QAC7B,QAAQ,EAAE,EAAE,EAAI,YAAY;QAC5B,QAAQ,EAAE,EAAE,EAAI,YAAY;QAC5B,QAAQ,EAAE,EAAE,EAAI,YAAY;QAC5B,QAAQ,EAAE,EAAE,EAAI,YAAY;QAC5B,QAAQ,EAAE,EAAE,EAAI,YAAY;QAC5B,SAAS,EAAE,EAAE,EAAG,YAAY;QAC5B,IAAI,EAAE,EAAE,EAAQ,cAAc;QAC9B,SAAS,EAAE,EAAE,EAAG,aAAa;KAC9B;IAED,MAAM,EAAE;QACN,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,QAAQ;QACjB,IAAI,EAAE,QAAQ;QACd,cAAc,EAAE,QAAQ;QACxB,UAAU,EAAE,QAAQ;QACpB,IAAI,EAAE,QAAQ;KACf;IAED,OAAO,EAAE;QACP,SAAS,EAAE,GAAG,EAAI,QAAQ;QAC1B,OAAO,EAAE,GAAG,EAAM,QAAQ;QAC1B,SAAS,EAAE,GAAG,EAAI,UAAU;QAC5B,IAAI,EAAE,GAAG,EAAS,UAAU;KAC7B;IAED,OAAO,EAAE;QACP,IAAI,EAAE;YACJ,GAAG,EAAE,IAAI,EAAK,MAAM;YACpB,KAAK,EAAE,IAAI,EAAG,SAAS;YACvB,MAAM,EAAE,IAAI,EAAE,MAAM;YACpB,IAAI,EAAE,IAAI,EAAI,SAAS;SACxB;QACD,SAAS,EAAE;YACT,IAAI,EAAE,GAAG,EAAK,SAAS;SACxB;KACF;CACF,CAAC;AAYF,MAAM,CAAC,MAAM,eAAe,GAAsC;IAChE,OAAO,EAAE;QACP,IAAI,EAAE,SAAS;QACf,UAAU,EAAE,QAAQ;QACpB,MAAM,EAAE,QAAQ;QAChB,SAAS,EAAE,QAAQ;QACnB,QAAQ,EAAE,EAAE,EAAE,OAAO;QACrB,UAAU,EAAE,iBAAiB;QAC7B,YAAY,EAAE,IAAI;KACnB;IAED,IAAI,EAAE;QACJ,IAAI,EAAE,MAAM;QACZ,UAAU,EAAE,QAAQ;QACpB,MAAM,EAAE,QAAQ;QAChB,SAAS,EAAE,QAAQ;QACnB,QAAQ,EAAE,EAAE,EAAE,OAAO;QACrB,UAAU,EAAE,iBAAiB;QAC7B,YAAY,EAAE,IAAI;KACnB;IAED,MAAM,EAAE;QACN,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE,QAAQ;QACpB,MAAM,EAAE,QAAQ;QAChB,SAAS,EAAE,QAAQ;QACnB,QAAQ,EAAE,EAAE,EAAE,MAAM;QACpB,UAAU,EAAE,iBAAiB;QAC7B,YAAY,EAAE,IAAI;KACnB;IAED,OAAO,EAAE;QACP,IAAI,EAAE,SAAS;QACf,UAAU,EAAE,QAAQ;QACpB,MAAM,EAAE,QAAQ;QAChB,SAAS,EAAE,QAAQ;QACnB,QAAQ,EAAE,EAAE,EAAE,QAAQ;QACtB,UAAU,EAAE,eAAe;QAC3B,YAAY,EAAE,KAAK;KACpB;CACF,CAAC"}

package/dist/core/BaseConverter.d.ts

@@ -0,0 +1,104 @@
+/**
+ * 基础转换器抽象类
+ * 提供通用的Markdown处理、缓存管理、进度报告等功能
+ */
+export interface ConversionProgress {
+    stage: 'parsing' | 'rendering' | 'generating' | 'converting' | 'saving' | 'complete' | 'error';
+    progress: number;
+    message: string;
+    filename?: string;
+    error?: Error;
+}
+export interface BaseConversionOptions {
+    enableCache?: boolean;
+    progress?: (progress: ConversionProgress) => void;
+    outputPath?: string;
+}
+export interface ConversionResult<T = any> {
+    success: boolean;
+    data?: T;
+    error?: string;
+    filePath?: string;
+    fileSize?: number;
+    stats?: ConversionStats;
+}
+export interface ConversionStats {
+    processingTime: number;
+    headings: number;
+    codeBlocks: number;
+    paragraphs: number;
+    tables: number;
+    fileSize: number;
+}
+/**
+ * 抽象基础转换器类
+ * 子类需要实现具体的转换逻辑
+ */
+export declare abstract class BaseConverter {
+    protected cacheEnabled: boolean;
+    protected cacheDir: string;
+    constructor(options?: {
+        cacheEnabled?: boolean;
+        cacheDir?: string;
+    });
+    /**
+     * 抽象方法：子类必须实现具体的转换逻辑
+     */
+    abstract convert(content: string, outputPath: string, options?: BaseConversionOptions): Promise<ConversionResult>;
+    /**
+     * 解析Markdown内容，提取基本统计信息
+     */
+    protected parseMarkdown(content: string): {
+        content: string;
+        stats: Partial<ConversionStats>;
+    };
+    /**
+     * 生成缓存键
+     */
+    protected generateCacheKey(content: string, options: any): string;
+    /**
+     * 获取缓存文件路径
+     */
+    protected getCacheFilePath(cacheKey: string, extension: string): string;
+    /**
+     * 检查缓存是否存在且有效
+     */
+    protected isCacheValid(cacheKey: string, extension: string): Promise<boolean>;
+    /**
+     * 保存到缓存
+     */
+    protected saveToCache(cacheKey: string, extension: string, data: Buffer): Promise<void>;
+    /**
+     * 从缓存读取
+     */
+    protected loadFromCache(cacheKey: string, extension: string): Promise<Buffer | null>;
+    /**
+     * 报告进度
+     */
+    protected reportProgress(progress: ConversionProgress, progressCallback?: (progress: ConversionProgress) => void): void;
+    /**
+     * 清理资源
+     */
+    cleanup(): Promise<void>;
+    /**
+     * 验证输入文件
+     */
+    protected validateInputFile(filePath: string): Promise<void>;
+    /**
+     * 确保输出目录存在
+     */
+    protected ensureOutputDir(outputPath: string): Promise<void>;
+    /**
+     * 获取文件大小信息
+     */
+    protected getFileSize(filePath: string): Promise<number>;
+    /**
+     * 格式化文件大小
+     */
+    protected formatFileSize(bytes: number): string;
+    /**
+     * 清理文本，移除可能导致问题的字符
+     */
+    protected cleanText(text: string): string;
+}
+//# sourceMappingURL=BaseConverter.d.ts.map

package/dist/core/BaseConverter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseConverter.d.ts","sourceRoot":"","sources":["../../src/core/BaseConverter.ts"],"names":[],"mappings":"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"}

package/dist/core/BaseConverter.js

@@ -0,0 +1,203 @@
+/**
+ * 基础转换器抽象类
+ * 提供通用的Markdown处理、缓存管理、进度报告等功能
+ */
+import fs from 'fs/promises';
+import path from 'path';
+import crypto from 'crypto';
+/**
+ * 抽象基础转换器类
+ * 子类需要实现具体的转换逻辑
+ */
+export class BaseConverter {
+    cacheEnabled;
+    cacheDir;
+    constructor(options = {}) {
+        this.cacheEnabled = options.cacheEnabled ?? true;
+        this.cacheDir = options.cacheDir ?? path.join(process.cwd(), '.cache');
+    }
+    /**
+     * 解析Markdown内容，提取基本统计信息
+     */
+    parseMarkdown(content) {
+        const lines = content.split('\n');
+        const stats = {
+            headings: 0,
+            codeBlocks: 0,
+            paragraphs: 0,
+            tables: 0,
+        };
+        let inCodeBlock = false;
+        for (const line of lines) {
+            const trimmed = line.trim();
+            // 检测代码块
+            if (trimmed.startsWith('```')) {
+                inCodeBlock = !inCodeBlock;
+                if (!inCodeBlock)
+                    stats.codeBlocks++;
+                continue;
+            }
+            if (inCodeBlock)
+                continue;
+            // 检测标题
+            if (trimmed.startsWith('#')) {
+                stats.headings++;
+            }
+            // 检测表格
+            else if (trimmed.includes('|') && trimmed.split('|').length > 2) {
+                stats.tables++;
+            }
+            // 检测段落
+            else if (trimmed.length > 0) {
+                stats.paragraphs++;
+            }
+        }
+        return { content, stats };
+    }
+    /**
+     * 生成缓存键
+     */
+    generateCacheKey(content, options) {
+        const hash = crypto.createHash('md5');
+        hash.update(content);
+        hash.update(JSON.stringify(options));
+        return hash.digest('hex');
+    }
+    /**
+     * 获取缓存文件路径
+     */
+    getCacheFilePath(cacheKey, extension) {
+        return path.join(this.cacheDir, `${cacheKey}.${extension}`);
+    }
+    /**
+     * 检查缓存是否存在且有效
+     */
+    async isCacheValid(cacheKey, extension) {
+        if (!this.cacheEnabled)
+            return false;
+        try {
+            const cacheFile = this.getCacheFilePath(cacheKey, extension);
+            await fs.access(cacheFile);
+            // 检查文件修改时间（24小时内有效）
+            const stats = await fs.stat(cacheFile);
+            const now = Date.now();
+            const fileAge = now - stats.mtime.getTime();
+            const maxAge = 24 * 60 * 60 * 1000; // 24小时
+            return fileAge < maxAge;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * 保存到缓存
+     */
+    async saveToCache(cacheKey, extension, data) {
+        if (!this.cacheEnabled)
+            return;
+        try {
+            await fs.mkdir(this.cacheDir, { recursive: true });
+            const cacheFile = this.getCacheFilePath(cacheKey, extension);
+            await fs.writeFile(cacheFile, data);
+        }
+        catch (error) {
+            // 缓存失败不影响主流程
+            console.warn('保存缓存失败:', error);
+        }
+    }
+    /**
+     * 从缓存读取
+     */
+    async loadFromCache(cacheKey, extension) {
+        if (!this.cacheEnabled)
+            return null;
+        try {
+            const cacheFile = this.getCacheFilePath(cacheKey, extension);
+            return await fs.readFile(cacheFile);
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * 报告进度
+     */
+    reportProgress(progress, progressCallback) {
+        if (progressCallback) {
+            progressCallback(progress);
+        }
+    }
+    /**
+     * 清理资源
+     */
+    async cleanup() {
+        // 子类可以重写此方法进行特定清理
+    }
+    /**
+     * 验证输入文件
+     */
+    async validateInputFile(filePath) {
+        try {
+            const stats = await fs.stat(filePath);
+            if (!stats.isFile()) {
+                throw new Error(`路径不是文件: ${filePath}`);
+            }
+            // 限制文件大小为50MB
+            const maxSize = 50 * 1024 * 1024;
+            if (stats.size > maxSize) {
+                throw new Error(`文件过大，最大支持50MB: ${filePath}`);
+            }
+        }
+        catch (error) {
+            if (error.code === 'ENOENT') {
+                throw new Error(`文件不存在: ${filePath}`);
+            }
+            throw error;
+        }
+    }
+    /**
+     * 确保输出目录存在
+     */
+    async ensureOutputDir(outputPath) {
+        const dir = path.dirname(outputPath);
+        await fs.mkdir(dir, { recursive: true });
+    }
+    /**
+     * 获取文件大小信息
+     */
+    async getFileSize(filePath) {
+        try {
+            const stats = await fs.stat(filePath);
+            return stats.size;
+        }
+        catch {
+            return 0;
+        }
+    }
+    /**
+     * 格式化文件大小
+     */
+    formatFileSize(bytes) {
+        if (bytes < 1024)
+            return `${bytes} B`;
+        if (bytes < 1024 * 1024)
+            return `${(bytes / 1024).toFixed(1)} KB`;
+        return `${(bytes / 1024 / 1024).toFixed(1)} MB`;
+    }
+    /**
+     * 清理文本，移除可能导致问题的字符
+     */
+    cleanText(text) {
+        return text
+            // 修复常见的Unicode字符问题
+            .replace(/[\u2018\u2019]/g, "'") // 弯引号 → 直引号
+            .replace(/[\u201C\u201D]/g, '"') // 弯双引号 → 直双引号
+            .replace(/[\u2013\u2014]/g, '-') // 长破折号 → 连字符
+            .replace(/\u2026/g, '...') // 省略号
+            .replace(/\u00A0/g, ' ') // 不间断空格 → 普通空格
+            // 移除其他可能导致问题的字符
+            .replace(/[\u200B-\u200D\uFEFF]/g, '') // 零宽度字符
+            .trim();
+    }
+}
+//# sourceMappingURL=BaseConverter.js.map