@ww_nero/skills 2.4.0 → 2.4.2

package/assets/{pptx_to_pdf.py → pptx_to_png.py}

@@ -1,4 +1,4 @@
-"""使用 LibreOffice 无头模式将 PPT/PPTX 直接转换为 PDF。"""
+"""使用 LibreOffice 无头模式将 PPT/PPTX 转换为 PNG 图片。"""
 from __future__ import annotations
 
 import argparse
@@ -9,6 +9,9 @@ import subprocess
 import sys
 import tempfile
 from pathlib import Path
+from typing import List
+
+from pdf2image import convert_from_path
 
 
 def _detect_libreoffice() -> str:
@@ -27,7 +30,6 @@ def _detect_libreoffice() -> str:
             if base:
                 candidates.append(str(Path(base) / 'LibreOffice' / 'program' / 'soffice.exe'))
 
-    # 通用命令放在末尾，优先尝试绝对路径
     candidates.extend(['soffice', 'libreoffice'])
 
     for candidate in candidates:
@@ -42,21 +44,22 @@ def _detect_libreoffice() -> str:
     return ''
 
 
-def pptx_to_pdf(input_file: str | Path, output_file: str | Path) -> Path:
+def pptx_to_png(input_file: str | Path, output_dir: str | Path, dpi: int = 300) -> List[Path]:
+    """将 PPTX 转换为 PNG 图片，返回生成的文件路径列表。"""
     pptx_path = Path(input_file).expanduser().resolve()
     if not pptx_path.exists():
         raise FileNotFoundError(f'PPT/PPTX 文件不存在: {pptx_path}')
     if pptx_path.is_dir():
         raise ValueError(f'输入路径不是文件: {pptx_path}')
 
-    output_path = Path(output_file).expanduser().resolve()
-    output_path.parent.mkdir(parents=True, exist_ok=True)
+    output_path = Path(output_dir).expanduser().resolve()
+    output_path.mkdir(parents=True, exist_ok=True)
 
     libreoffice_cmd = _detect_libreoffice()
     if not libreoffice_cmd:
         raise RuntimeError('未找到 LibreOffice，请先安装（例如 apt install libreoffice 或从官网安装包）。')
 
-    with tempfile.TemporaryDirectory(prefix='pptx_to_pdf_') as temp_dir:
+    with tempfile.TemporaryDirectory(prefix='pptx_to_png_') as temp_dir:
         cmd = [
             libreoffice_cmd,
             '--headless',
@@ -71,33 +74,44 @@ def pptx_to_pdf(input_file: str | Path, output_file: str | Path) -> Path:
             message = result.stderr.strip() or result.stdout.strip() or 'LibreOffice 返回非零退出码'
             raise RuntimeError(f'LibreOffice 转换失败: {message}')
 
-        generated = Path(temp_dir) / f'{pptx_path.stem}.pdf'
-        if not generated.exists():
+        generated_pdf = Path(temp_dir) / f'{pptx_path.stem}.pdf'
+        if not generated_pdf.exists():
             pdf_candidates = list(Path(temp_dir).glob('*.pdf'))
             if len(pdf_candidates) == 1:
-                generated = pdf_candidates[0]
+                generated_pdf = pdf_candidates[0]
             else:
                 raise RuntimeError('未找到 LibreOffice 生成的 PDF 文件')
 
-        if output_path.exists():
-            output_path.unlink()
+        images = convert_from_path(str(generated_pdf), dpi=dpi, fmt='png')
+
+        saved_files: List[Path] = []
+        for index, image in enumerate(images, start=1):
+            file_name = f'page_{index:04d}.png'
+            target = output_path / file_name
+            image.save(str(target), 'PNG')
+            saved_files.append(target)
 
-        shutil.move(str(generated), str(output_path))
-        return output_path
+        return saved_files
 
 
 def _parse_args() -> argparse.Namespace:
-    parser = argparse.ArgumentParser(description='将 PPT/PPTX 转换为 PDF（调用 LibreOffice 无头模式）。')
+    parser = argparse.ArgumentParser(description='将 PPT/PPTX 转换为 PNG 图片（调用 LibreOffice + pdf2image）。')
     parser.add_argument('--input', required=True, help='PPT/PPTX 文件路径')
-    parser.add_argument('--output', required=True, help='输出 PDF 文件路径')
+    parser.add_argument('--output-dir', required=True, help='保存图片的目录')
+    parser.add_argument('--dpi', type=int, default=300, help='输出图片的 DPI，默认 300')
     return parser.parse_args()
 
 
 def main() -> None:
     args = _parse_args()
     try:
-        result = pptx_to_pdf(args.input, args.output)
-        print(f'已生成 PDF: {result}')
+        results = pptx_to_png(args.input, args.output_dir, dpi=args.dpi)
+        if not results:
+            print('未生成任何图片')
+            return
+        print(f'成功生成 {len(results)} 张图片:')
+        for path in results:
+            print(path)
     except Exception as error:
         print(f'转换失败: {error}', file=sys.stderr)
         sys.exit(1)

package/index.js

@@ -96,14 +96,15 @@ const SNIPPETS = {
       '如需大批量转换，可将 convert_from_path 的线程参数打开以提升性能。'
     ]
   },
-  pptx_to_pdf: {
-    title: 'PPTX 转 PDF',
-    description: '使用 LibreOffice 无头模式批量转换，兼容 Windows/macOS/Linux。',
-    codeFile: 'pptx_to_pdf.py',
+  pptx_to_png: {
+    title: 'PPTX 转 PNG',
+    description: '使用 LibreOffice 无头模式转换为 PDF，再通过 pdf2image 转成 PNG 图片，兼容 Windows/macOS/Linux。',
+    codeFile: 'pptx_to_png.py',
     notes: [
       '脚本会自动探测 soffice 路径，如未安装需先安装 LibreOffice。',
-      '转换在临时目录完成后再移动到目标路径，避免半成品文件覆盖。',
-      '输出路径父目录会自动创建，可直接传绝对路径。'
+      '内部先转 PDF 再转 PNG，中间文件在临时目录处理，不会残留。',
+      '支持自定义 dpi，默认 300dpi 用于打印级清晰度。',
+      '输出目录会自动创建，文件名形如 page_0001.png，便于批量处理。'
     ]
   },
   svg_to_pptx: {
@@ -156,7 +157,7 @@ const GUIDES = {
 |---------|-------------|------|
 | HTML → PNG | \`html_to_png\` | 使用 Playwright 渲染并截图 |
 | PDF → PNG | \`pdf_to_png\` | 使用 pdf2image 分页转换 |
-| PPTX → PDF | \`pptx_to_pdf\` | 使用 LibreOffice 无头模式 |
+| PPTX → PNG | \`pptx_to_png\` | 使用 LibreOffice + pdf2image |
 | SVG → PPTX | \`svg_to_pptx\` | 转化为可编辑的 PPTX 元素 |
 
 调用示例：使用 \`snippet\` 工具获取参考代码，如 \`snippet({ title: "pdf_to_png" })\`
@@ -215,7 +216,7 @@ const buildSnippet = (title, workingDirectory) => {
   fs.writeFileSync(outputPath, code);
 
   const lines = [];
-  lines.push(`文件名: ${entry.codeFile}`);
+  lines.push(`示例脚本已经存储到工作目录下，文件名: ${entry.codeFile}，可直接作为工具模块导入使用。`);
   if (entry.notes && entry.notes.length > 0) {
     lines.push('');
     lines.push('注意事项:');
@@ -255,7 +256,7 @@ const listTools = () => ({
           },
           title: {
             type: 'string',
-            description: '示例类型，可选: html_to_png | pdf_to_png | pptx_to_pdf | svg_to_pptx',
+            description: '示例类型，可选: html_to_png | pdf_to_png | pptx_to_png | svg_to_pptx',
             enum: Object.keys(SNIPPETS)
           }
         },
@@ -280,7 +281,7 @@ const listTools = () => ({
   ]
 });
 
-const server = new Server({ name: 'skills', version: '2.4.0' }, { capabilities: { tools: {} } });
+const server = new Server({ name: 'skills', version: '2.4.2' }, { capabilities: { tools: {} } });
 
 server.setRequestHandler(ListToolsRequestSchema, async () => listTools());
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ww_nero/skills",
-  "version": "2.4.0",
+  "version": "2.4.2",
   "description": "MCP server that returns Python reference snippets and skill guides",
   "main": "index.js",
   "bin": {