@mcpcn/markdown-converter-mcp 1.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (65) hide show
  1. package/.eslintrc.json +17 -0
  2. package/.prettierrc.json +8 -0
  3. package/README.md +214 -0
  4. package/dist/config/word.d.ts +67 -0
  5. package/dist/config/word.d.ts.map +1 -0
  6. package/dist/config/word.js +86 -0
  7. package/dist/config/word.js.map +1 -0
  8. package/dist/core/BaseConverter.d.ts +104 -0
  9. package/dist/core/BaseConverter.d.ts.map +1 -0
  10. package/dist/core/BaseConverter.js +203 -0
  11. package/dist/core/BaseConverter.js.map +1 -0
  12. package/dist/core/BrowserPool.d.ts +25 -0
  13. package/dist/core/BrowserPool.d.ts.map +1 -0
  14. package/dist/core/BrowserPool.js +152 -0
  15. package/dist/core/BrowserPool.js.map +1 -0
  16. package/dist/core/CacheManager.d.ts +26 -0
  17. package/dist/core/CacheManager.d.ts.map +1 -0
  18. package/dist/core/CacheManager.js +74 -0
  19. package/dist/core/CacheManager.js.map +1 -0
  20. package/dist/core/EnhancedConverter.d.ts +78 -0
  21. package/dist/core/EnhancedConverter.d.ts.map +1 -0
  22. package/dist/core/EnhancedConverter.js +227 -0
  23. package/dist/core/EnhancedConverter.js.map +1 -0
  24. package/dist/core/MarkdownRenderer.d.ts +19 -0
  25. package/dist/core/MarkdownRenderer.d.ts.map +1 -0
  26. package/dist/core/MarkdownRenderer.js +160 -0
  27. package/dist/core/MarkdownRenderer.js.map +1 -0
  28. package/dist/core/PDFConverter.d.ts +81 -0
  29. package/dist/core/PDFConverter.d.ts.map +1 -0
  30. package/dist/core/PDFConverter.js +284 -0
  31. package/dist/core/PDFConverter.js.map +1 -0
  32. package/dist/core/PDFGenerator.d.ts +32 -0
  33. package/dist/core/PDFGenerator.d.ts.map +1 -0
  34. package/dist/core/PDFGenerator.js +352 -0
  35. package/dist/core/PDFGenerator.js.map +1 -0
  36. package/dist/core/TemplateManager.d.ts +16 -0
  37. package/dist/core/TemplateManager.d.ts.map +1 -0
  38. package/dist/core/TemplateManager.js +321 -0
  39. package/dist/core/TemplateManager.js.map +1 -0
  40. package/dist/core/WordConverter.d.ts +43 -0
  41. package/dist/core/WordConverter.d.ts.map +1 -0
  42. package/dist/core/WordConverter.js +398 -0
  43. package/dist/core/WordConverter.js.map +1 -0
  44. package/dist/index.d.ts +28 -0
  45. package/dist/index.d.ts.map +1 -0
  46. package/dist/index.js +334 -0
  47. package/dist/index.js.map +1 -0
  48. package/dist/types/index.d.ts +69 -0
  49. package/dist/types/index.d.ts.map +1 -0
  50. package/dist/types/index.js +2 -0
  51. package/dist/types/index.js.map +1 -0
  52. package/package.json +66 -0
  53. package/src/config/word.ts +164 -0
  54. package/src/core/BaseConverter.ts +275 -0
  55. package/src/core/BrowserPool.ts +176 -0
  56. package/src/core/CacheManager.ts +88 -0
  57. package/src/core/MarkdownRenderer.ts +211 -0
  58. package/src/core/PDFConverter.ts +374 -0
  59. package/src/core/PDFGenerator.ts +428 -0
  60. package/src/core/TemplateManager.ts +331 -0
  61. package/src/core/WordConverter.ts +470 -0
  62. package/src/index.ts +419 -0
  63. package/src/types/index.ts +75 -0
  64. package/src/types/remarkable.d.ts +8 -0
  65. package/tsconfig.json +23 -0
package/.eslintrc.json ADDED
@@ -0,0 +1,17 @@
1
+ {
2
+ "extends": ["@typescript-eslint/recommended"],
3
+ "parser": "@typescript-eslint/parser",
4
+ "plugins": ["@typescript-eslint"],
5
+ "parserOptions": {
6
+ "ecmaVersion": 2022,
7
+ "sourceType": "module"
8
+ },
9
+ "rules": {
10
+ "@typescript-eslint/no-unused-vars": "warn",
11
+ "@typescript-eslint/no-explicit-any": "off",
12
+ "@typescript-eslint/explicit-function-return-type": "off",
13
+ "prefer-const": "error",
14
+ "no-var": "error"
15
+ },
16
+ "ignorePatterns": ["build/", "node_modules/"]
17
+ }
@@ -0,0 +1,8 @@
1
+ {
2
+ "semi": true,
3
+ "trailingComma": "es5",
4
+ "singleQuote": true,
5
+ "printWidth": 80,
6
+ "tabWidth": 2,
7
+ "useTabs": false
8
+ }
package/README.md ADDED
@@ -0,0 +1,214 @@
1
+ # 统一Markdown转换MCP服务器
2
+
3
+ [![TypeScript](https://img.shields.io/badge/TypeScript-5.3-blue.svg)](https://www.typescriptlang.org/)
4
+ [![Node.js](https://img.shields.io/badge/Node.js-18+-green.svg)](https://nodejs.org/)
5
+ [![MCP](https://img.shields.io/badge/MCP-1.0-orange.svg)](https://modelcontextprotocol.io/)
6
+
7
+ 一个功能强大的MCP (Model Context Protocol) 服务器,支持将Markdown文档转换为PDF和Word格式。**特别优化了代码块显示效果**,确保在转换后的文档中代码的完美呈现。
8
+
9
+ ## ✨ 主要特性
10
+
11
+ ### 🔄 双格式支持
12
+ - **PDF转换**: 高质量PDF生成,支持模板、水印、语法高亮等高级功能
13
+ - **Word转换**: 专业级Word文档生成,**特别优化代码块显示效果**
14
+
15
+ ### 🎨 丰富的自定义选项
16
+ - **PDF模板**: default, academic, modern 三种预设模板
17
+ - **Word主题**: default, github, dark, minimal 四种代码块主题
18
+ - **自定义样式**: 字体、颜色、间距等完全可定制
19
+
20
+ ### ⚡ 性能优化
21
+ - **智能缓存**: 文件系统 + 内存双重缓存机制
22
+ - **并发控制**: 资源池管理,支持批量转换
23
+ - **增量处理**: 避免重复转换,提高效率
24
+
25
+ ## 🛠️ 可用工具
26
+
27
+ ### 1. `convert_to_pdf` - PDF转换
28
+ 将Markdown内容或文件转换为PDF文件。
29
+
30
+ **参数:**
31
+ - `markdown` (必填): Markdown内容或.md文件路径
32
+ - `outputPath` (可选): 输出PDF文件路径
33
+ - `template` (可选): PDF模板 (default/academic/modern)
34
+ - `paperFormat` (可选): 页面格式 (a4/a3/a5/letter/legal/tabloid)
35
+ - `paperOrientation` (可选): 页面方向 (portrait/landscape)
36
+ - `watermark` (可选): 水印设置
37
+ - `enableSyntaxHighlight` (可选): 启用语法高亮
38
+ - `enableMermaid` (可选): 启用Mermaid图表
39
+
40
+ ### 2. `convert_to_word` - Word转换
41
+ 将Markdown内容或文件转换为Word文档,特别优化了代码块显示。
42
+
43
+ **参数:**
44
+ - `markdown` (必填): Markdown内容或.md文件路径
45
+ - `outputPath` (可选): 输出Word文件路径
46
+ - `theme` (可选): 代码块主题 (default/github/dark/minimal)
47
+ - `addFooter` (可选): 是否添加页脚页码
48
+ - `showLanguage` (可选): 是否显示代码块语言标识
49
+
50
+ ### 3. `convert_batch` - 批量转换
51
+ 批量转换多个Markdown文件。
52
+
53
+ **参数:**
54
+ - `files` (必填): Markdown文件路径列表
55
+ - `format` (可选): 输出格式 (pdf/word/both)
56
+ - `outputDir` (可选): 输出目录
57
+ - `template` (可选): PDF模板
58
+ - `theme` (可选): Word主题
59
+
60
+ ### 4. `list_themes` - 列出主题
61
+ 列出所有可用的Word代码块主题。
62
+
63
+ ## 🎯 使用示例
64
+
65
+ ### PDF转换示例
66
+ ```javascript
67
+ // 转换文件
68
+ {
69
+ "tool": "convert_to_pdf",
70
+ "arguments": {
71
+ "markdown": "/path/to/document.md",
72
+ "outputPath": "/path/to/output.pdf",
73
+ "template": "academic",
74
+ "watermark": {
75
+ "text": "Draft",
76
+ "opacity": 0.1
77
+ }
78
+ }
79
+ }
80
+
81
+ // 转换内容
82
+ {
83
+ "tool": "convert_to_pdf",
84
+ "arguments": {
85
+ "markdown": "# 我的文档\n\n```python\nprint('Hello World')\n```",
86
+ "template": "modern"
87
+ }
88
+ }
89
+ ```
90
+
91
+ ### Word转换示例
92
+ ```javascript
93
+ // 转换文件
94
+ {
95
+ "tool": "convert_to_word",
96
+ "arguments": {
97
+ "markdown": "/path/to/document.md",
98
+ "outputPath": "/path/to/output.docx",
99
+ "theme": "github",
100
+ "showLanguage": true
101
+ }
102
+ }
103
+
104
+ // 批量转换
105
+ {
106
+ "tool": "convert_batch",
107
+ "arguments": {
108
+ "files": ["/path/to/doc1.md", "/path/to/doc2.md"],
109
+ "format": "both",
110
+ "outputDir": "/path/to/output",
111
+ "theme": "dark"
112
+ }
113
+ }
114
+ ```
115
+
116
+ ## 🎨 代码块主题
117
+
118
+ ### Word文档主题
119
+ - **default**: 经典灰色背景,适合日常使用
120
+ - **github**: GitHub风格,清新简洁
121
+ - **dark**: 暗色主题,护眼舒适
122
+ - **minimal**: 极简风格,简约优雅
123
+
124
+ 每个主题都经过精心调优,确保代码的可读性和美观性。
125
+
126
+ ## ⚙️ 环境变量
127
+
128
+ - `OUTPUT_DIR`: 默认输出目录 (默认: 用户主目录)
129
+ - `MAX_CONCURRENT`: 最大并发数 (默认: 2)
130
+ - `MAX_BROWSERS`: 最大浏览器实例数 (默认: 3)
131
+ - `DISABLE_CACHE`: 禁用缓存 (设置为 'true' 禁用)
132
+
133
+ ## 📁 项目结构
134
+
135
+ ```
136
+ src/
137
+ ├── core/ # 核心转换器
138
+ │ ├── BaseConverter.ts # 抽象基类
139
+ │ ├── PDFConverter.ts # PDF转换器
140
+ │ └── WordConverter.ts # Word转换器
141
+ ├── config/ # 配置文件
142
+ │ └── word.ts # Word样式配置
143
+ ├── templates/ # 模板资源
144
+ │ ├── pdf/ # PDF模板
145
+ │ └── word/ # Word模板
146
+ ├── types/ # 类型定义
147
+ └── index.ts # MCP服务器入口
148
+ ```
149
+
150
+ ## 🔧 开发
151
+
152
+ ### 安装依赖
153
+ ```bash
154
+ npm install
155
+ ```
156
+
157
+ ### 构建项目
158
+ ```bash
159
+ npm run build
160
+ ```
161
+
162
+ ### 运行服务器
163
+ ```bash
164
+ npm start
165
+ ```
166
+
167
+ ### 开发模式
168
+ ```bash
169
+ npm run dev
170
+ ```
171
+
172
+ ## 📄 技术栈
173
+
174
+ - **TypeScript**: 类型安全的JavaScript超集
175
+ - **MCP SDK**: Model Context Protocol 软件开发包
176
+ - **Puppeteer**: PDF生成和页面渲染
177
+ - **docx**: Word文档生成库
178
+ - **Remarkable**: Markdown解析器
179
+
180
+ ## 🌟 亮点功能
181
+
182
+ ### 1. 完美的代码块显示
183
+ 基于原md-to-word-mcp项目的成功实现,每一行代码都作为独立段落处理,确保:
184
+ - 保持原有缩进结构
185
+ - 支持多种编程语言
186
+ - 语法高亮效果
187
+ - 边框和背景美化
188
+
189
+ ### 2. 智能缓存机制
190
+ - **文件缓存**: 转换结果持久化存储
191
+ - **内存缓存**: HTML渲染结果临时缓存
192
+ - **自动清理**: 过期缓存自动清理
193
+ - **缓存键优化**: 基于内容和配置生成唯一键
194
+
195
+ ### 3. 资源优化管理
196
+ - **浏览器池**: 复用Puppeteer实例
197
+ - **并发控制**: 防止资源过度使用
198
+ - **优雅关闭**: 确保资源正确释放
199
+
200
+ ## 🤝 贡献
201
+
202
+ 欢迎提交Issue和Pull Request!
203
+
204
+ ## 📜 许可证
205
+
206
+ MIT License
207
+
208
+ ---
209
+
210
+ **本项目融合了以下优秀项目的精华:**
211
+ - 原 `enhanced-markdown2pdf-mcp` 的高性能PDF转换能力
212
+ - 原 `md-to-word-mcp` 的优化Word代码块显示技术
213
+
214
+ 通过统一架构设计,为用户提供一站式Markdown文档转换解决方案。
@@ -0,0 +1,67 @@
1
+ /**
2
+ * Word转换器配置
3
+ * 基于 md-to-word-mcp 项目的成功实现
4
+ */
5
+ export interface WordStyleConfig {
6
+ fonts: {
7
+ default: string;
8
+ code: string;
9
+ heading: string;
10
+ };
11
+ fontSizes: {
12
+ title: number;
13
+ heading1: number;
14
+ heading2: number;
15
+ heading3: number;
16
+ heading4: number;
17
+ heading5: number;
18
+ paragraph: number;
19
+ code: number;
20
+ codeBlock: number;
21
+ };
22
+ colors: {
23
+ text: string;
24
+ heading: string;
25
+ code: string;
26
+ codeBackground: string;
27
+ codeBorder: string;
28
+ link: string;
29
+ };
30
+ spacing: {
31
+ paragraph: number;
32
+ heading: number;
33
+ codeBlock: number;
34
+ line: number;
35
+ };
36
+ margins: {
37
+ page: {
38
+ top: number;
39
+ right: number;
40
+ bottom: number;
41
+ left: number;
42
+ };
43
+ codeBlock: {
44
+ left: number;
45
+ };
46
+ };
47
+ }
48
+ export declare const defaultWordStyleConfig: WordStyleConfig;
49
+ export interface CodeBlockTheme {
50
+ name: string;
51
+ background: string;
52
+ border: string;
53
+ textColor: string;
54
+ fontSize: number;
55
+ fontFamily: string;
56
+ showLanguage: boolean;
57
+ }
58
+ export declare const codeBlockThemes: {
59
+ [key: string]: CodeBlockTheme;
60
+ };
61
+ export interface WordConversionOptions {
62
+ styleConfig?: Partial<WordStyleConfig>;
63
+ codeBlockTheme?: string | CodeBlockTheme;
64
+ addFooter?: boolean;
65
+ showLineNumbers?: boolean;
66
+ }
67
+ //# sourceMappingURL=word.d.ts.map
@@ -0,0 +1 @@
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"}
@@ -0,0 +1,86 @@
1
+ /**
2
+ * Word转换器配置
3
+ * 基于 md-to-word-mcp 项目的成功实现
4
+ */
5
+ export const defaultWordStyleConfig = {
6
+ fonts: {
7
+ default: 'SimSun,Times New Roman', // 添加中文字体支持
8
+ code: 'Consolas,SimHei', // 代码字体也支持中文
9
+ heading: 'SimHei,Arial', // 标题使用黑体
10
+ },
11
+ fontSizes: {
12
+ title: 36, // 18pt - 主标题
13
+ heading1: 32, // 16pt - H1
14
+ heading2: 28, // 14pt - H2
15
+ heading3: 26, // 13pt - H3
16
+ heading4: 24, // 12pt - H4
17
+ heading5: 22, // 11pt - H5
18
+ paragraph: 24, // 12pt - 正文
19
+ code: 22, // 11pt - 内联代码
20
+ codeBlock: 20, // 10pt - 代码块
21
+ },
22
+ colors: {
23
+ text: '333333',
24
+ heading: '000000',
25
+ code: '333333',
26
+ codeBackground: 'F8F8F8',
27
+ codeBorder: 'DDDDDD',
28
+ link: '0000FF',
29
+ },
30
+ spacing: {
31
+ paragraph: 120, // 段落后间距
32
+ heading: 360, // 标题前间距
33
+ codeBlock: 180, // 代码块前后间距
34
+ line: 280, // 代码块固定行高
35
+ },
36
+ margins: {
37
+ page: {
38
+ top: 1440, // 1英寸
39
+ right: 1080, // 0.75英寸
40
+ bottom: 1440, // 1英寸
41
+ left: 1080, // 0.75英寸
42
+ },
43
+ codeBlock: {
44
+ left: 200, // 代码块左缩进
45
+ },
46
+ },
47
+ };
48
+ export const codeBlockThemes = {
49
+ default: {
50
+ name: 'Default',
51
+ background: 'F8F8F8',
52
+ border: 'DDDDDD',
53
+ textColor: '333333',
54
+ fontSize: 20, // 10pt
55
+ fontFamily: 'Consolas,SimHei',
56
+ showLanguage: true,
57
+ },
58
+ dark: {
59
+ name: 'Dark',
60
+ background: '2D2D2D',
61
+ border: '404040',
62
+ textColor: 'F8F8F2',
63
+ fontSize: 20, // 10pt
64
+ fontFamily: 'Consolas,SimHei',
65
+ showLanguage: true,
66
+ },
67
+ github: {
68
+ name: 'GitHub',
69
+ background: 'F6F8FA',
70
+ border: 'D0D7DE',
71
+ textColor: '24292F',
72
+ fontSize: 18, // 9pt
73
+ fontFamily: 'Consolas,SimHei',
74
+ showLanguage: true,
75
+ },
76
+ minimal: {
77
+ name: 'Minimal',
78
+ background: 'FAFAFA',
79
+ border: 'E1E4E8',
80
+ textColor: '586069',
81
+ fontSize: 19, // 9.5pt
82
+ fontFamily: 'Monaco,SimHei',
83
+ showLanguage: false,
84
+ },
85
+ };
86
+ //# sourceMappingURL=word.js.map
@@ -0,0 +1 @@
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"}
@@ -0,0 +1,104 @@
1
+ /**
2
+ * 基础转换器抽象类
3
+ * 提供通用的Markdown处理、缓存管理、进度报告等功能
4
+ */
5
+ export interface ConversionProgress {
6
+ stage: 'parsing' | 'rendering' | 'generating' | 'converting' | 'saving' | 'complete' | 'error';
7
+ progress: number;
8
+ message: string;
9
+ filename?: string;
10
+ error?: Error;
11
+ }
12
+ export interface BaseConversionOptions {
13
+ enableCache?: boolean;
14
+ progress?: (progress: ConversionProgress) => void;
15
+ outputPath?: string;
16
+ }
17
+ export interface ConversionResult<T = any> {
18
+ success: boolean;
19
+ data?: T;
20
+ error?: string;
21
+ filePath?: string;
22
+ fileSize?: number;
23
+ stats?: ConversionStats;
24
+ }
25
+ export interface ConversionStats {
26
+ processingTime: number;
27
+ headings: number;
28
+ codeBlocks: number;
29
+ paragraphs: number;
30
+ tables: number;
31
+ fileSize: number;
32
+ }
33
+ /**
34
+ * 抽象基础转换器类
35
+ * 子类需要实现具体的转换逻辑
36
+ */
37
+ export declare abstract class BaseConverter {
38
+ protected cacheEnabled: boolean;
39
+ protected cacheDir: string;
40
+ constructor(options?: {
41
+ cacheEnabled?: boolean;
42
+ cacheDir?: string;
43
+ });
44
+ /**
45
+ * 抽象方法:子类必须实现具体的转换逻辑
46
+ */
47
+ abstract convert(content: string, outputPath: string, options?: BaseConversionOptions): Promise<ConversionResult>;
48
+ /**
49
+ * 解析Markdown内容,提取基本统计信息
50
+ */
51
+ protected parseMarkdown(content: string): {
52
+ content: string;
53
+ stats: Partial<ConversionStats>;
54
+ };
55
+ /**
56
+ * 生成缓存键
57
+ */
58
+ protected generateCacheKey(content: string, options: any): string;
59
+ /**
60
+ * 获取缓存文件路径
61
+ */
62
+ protected getCacheFilePath(cacheKey: string, extension: string): string;
63
+ /**
64
+ * 检查缓存是否存在且有效
65
+ */
66
+ protected isCacheValid(cacheKey: string, extension: string): Promise<boolean>;
67
+ /**
68
+ * 保存到缓存
69
+ */
70
+ protected saveToCache(cacheKey: string, extension: string, data: Buffer): Promise<void>;
71
+ /**
72
+ * 从缓存读取
73
+ */
74
+ protected loadFromCache(cacheKey: string, extension: string): Promise<Buffer | null>;
75
+ /**
76
+ * 报告进度
77
+ */
78
+ protected reportProgress(progress: ConversionProgress, progressCallback?: (progress: ConversionProgress) => void): void;
79
+ /**
80
+ * 清理资源
81
+ */
82
+ cleanup(): Promise<void>;
83
+ /**
84
+ * 验证输入文件
85
+ */
86
+ protected validateInputFile(filePath: string): Promise<void>;
87
+ /**
88
+ * 确保输出目录存在
89
+ */
90
+ protected ensureOutputDir(outputPath: string): Promise<void>;
91
+ /**
92
+ * 获取文件大小信息
93
+ */
94
+ protected getFileSize(filePath: string): Promise<number>;
95
+ /**
96
+ * 格式化文件大小
97
+ */
98
+ protected formatFileSize(bytes: number): string;
99
+ /**
100
+ * 清理文本,移除可能导致问题的字符
101
+ */
102
+ protected cleanText(text: string): string;
103
+ }
104
+ //# sourceMappingURL=BaseConverter.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"BaseConverter.d.ts","sourceRoot":"","sources":["../../src/core/BaseConverter.ts"],"names":[],"mappings":"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"}