@ww_nero/mini-cli 1.0.61 → 1.0.63

package/src/tools/bash.js

@@ -2,10 +2,6 @@ const { spawn } = require('child_process');
 const { resolveWorkspacePath } = require('../utils/helpers');
 const { DEFAULT_ALLOWED_COMMANDS } = require('../config');
 
-const OUTPUT_MAX_LENGTH = 12000;
-const EXECUTION_TIMEOUT = 300000;
-const SERVICE_RETURN_DELAY = 5000;
-
 // Git 只读命令白名单
 const GIT_READONLY_COMMANDS = ['show', 'diff', 'log', 'status', 'branch', 'tag', 'ls-files', 'ls-tree', 'rev-parse', 'reflog', 'blame', 'shortlog', 'describe', 'config --get', 'config --list', 'remote', 'ls-remote', 'fetch --dry-run', 'grep'];
 
@@ -86,6 +82,10 @@ const executeCommand = async ({ command, workingDirectory = '.', isService = fal
   const allowedCommands = Array.isArray(context.allowedCommands) && context.allowedCommands.length > 0
     ? context.allowedCommands
     : DEFAULT_ALLOWED_COMMANDS;
+
+  const outputMaxLength = context.outputMaxLength || 12000;
+  const executionTimeout = context.executionTimeout || 300000;
+  const serviceBootWindow = context.serviceBootWindow || 5000;
   const commands = splitShellCommands(normalizedCommand);
   if (commands.length === 0) {
     return '未找到有效的命令';
@@ -129,15 +129,15 @@ const executeCommand = async ({ command, workingDirectory = '.', isService = fal
 
     child.stdout.on('data', (data) => {
       stdout += data.toString();
-      if (stdout.length > OUTPUT_MAX_LENGTH) {
-        stdout = stdout.slice(0, OUTPUT_MAX_LENGTH);
+      if (stdout.length > outputMaxLength) {
+        stdout = stdout.slice(0, outputMaxLength);
       }
     });
 
     child.stderr.on('data', (data) => {
       stderr += data.toString();
-      if (stderr.length > OUTPUT_MAX_LENGTH) {
-        stderr = stderr.slice(0, OUTPUT_MAX_LENGTH);
+      if (stderr.length > outputMaxLength) {
+        stderr = stderr.slice(0, outputMaxLength);
       }
     });
 
@@ -169,8 +169,8 @@ const executeCommand = async ({ command, workingDirectory = '.', isService = fal
         const stdOutput = stdout.trim();
         const errOutput = stderr.trim();
         const captured = stdOutput || errOutput ? `\n当前输出:\n${stdOutput}${errOutput ? `\n错误:\n${errOutput}` : ''}` : '\n暂无输出';
-        resolve(`已等待 ${SERVICE_RETURN_DELAY / 1000}s，命令已在后台持续运行（PID: ${child.pid}）。${captured}`);
-      }, SERVICE_RETURN_DELAY);
+        resolve(`已等待 ${serviceBootWindow / 1000}s，命令已在后台持续运行（PID: ${child.pid}）。${captured}`);
+      }, serviceBootWindow);
 
       const serviceErrorHandler = (error) => {
         clearTimeout(timer);
@@ -190,8 +190,8 @@ const executeCommand = async ({ command, workingDirectory = '.', isService = fal
         if (settled) return;
         child.kill('SIGTERM');
         cleanup();
-        resolve('命令执行超时 (超过 300s)');
-      }, EXECUTION_TIMEOUT);
+        resolve(`命令执行超时 (超过 ${executionTimeout / 1000}s)`);
+      }, executionTimeout);
     }
   });
 };

package/src/tools/index.js

@@ -3,11 +3,10 @@ const read = require('./read');
 const write = require('./write');
 const replace = require('./replace');
 const todos = require('./todos');
-const convert = require('./convert');
 const { createMcpManager } = require('./mcp');
 const { loadSettings } = require('../config');
 
-const TOOL_MODULES = [bash, read, write, replace, todos, convert];
+const TOOL_MODULES = [bash, read, write, replace, todos];
 
 const createToolRuntime = async (workspaceRoot, options = {}) => {
   const defaultToolNames = TOOL_MODULES.map((tool) => tool.name);
@@ -16,7 +15,15 @@ const createToolRuntime = async (workspaceRoot, options = {}) => {
   const enabledMcps = Array.isArray(settings.mcps) ? settings.mcps : [];
   const allowedCommands = settings.allowedCommands;
 
-  const context = { workspaceRoot, allowedCommands, ...options };
+  const context = {
+    workspaceRoot,
+    allowedCommands,
+    outputMaxLength: settings.outputMaxLength,
+    executionTimeout: settings.executionTimeout,
+    serviceBootWindow: settings.serviceBootWindow,
+    largeFileLineThreshold: settings.largeFileLineThreshold,
+    ...options
+  };
 
   const tools = [];
   const handlers = {};
@@ -36,7 +43,9 @@ const createToolRuntime = async (workspaceRoot, options = {}) => {
 
   TOOL_MODULES.forEach(registerTool);
 
-  const mcpManager = await createMcpManager(workspaceRoot, enabledMcps);
+  const mcpManager = await createMcpManager(workspaceRoot, enabledMcps, {
+    mcpToolTimeout: settings.mcpToolTimeout
+  });
   let mcpConfigPath = null;
   const mcpToolNames = new Set(); // 记录所有 MCP 工具名称
   const enabledMcpNames = []; // 记录启用的 MCP 服务器名称

package/src/tools/mcp.js

@@ -305,9 +305,10 @@ const formatMcpContent = (content) => {
 };
 
 class McpManager {
-  constructor(workspaceRoot, allowedMcpNames = null) {
+  constructor(workspaceRoot, allowedMcpNames = null, options = {}) {
     this.workspaceRoot = workspaceRoot;
     this.allowedMcpNames = Array.isArray(allowedMcpNames) ? allowedMcpNames : null;
+    this.mcpToolTimeout = options.mcpToolTimeout || 600000;
     this.clients = [];
   }
 
@@ -407,7 +408,7 @@ class McpManager {
               },
               undefined,
               {
-                timeout: 600000 // 10 分钟超时
+                timeout: this.mcpToolTimeout
               }
             );
             const isError = Boolean(result && result.isError);
@@ -460,11 +461,11 @@ class McpManager {
   }
 }
 
-const createMcpManager = async (workspaceRoot, allowedMcpNames = null) => {
+const createMcpManager = async (workspaceRoot, allowedMcpNames = null, options = {}) => {
   if (Array.isArray(allowedMcpNames) && allowedMcpNames.length === 0) {
     return null;
   }
-  const manager = new McpManager(workspaceRoot, allowedMcpNames);
+  const manager = new McpManager(workspaceRoot, allowedMcpNames, options);
   await manager.initialize();
   const tools = manager.getTools();
   if (!tools || tools.length === 0) {

package/src/tools/convert.js

@@ -1,297 +0,0 @@
-const { spawn } = require('child_process');
-const fs = require('fs');
-const fsPromises = require('fs/promises');
-const path = require('path');
-const { resolveWorkspacePath } = require('../utils/helpers');
-
-const EXECUTION_TIMEOUT = 300000;
-const PYTHON_SCRIPT_ROOT = path.join(__dirname, 'python');
-
-const TYPE_META = {
-  pdf_to_png: {
-    inputType: 'file',
-    outputType: 'directory',
-    description: '将 PDF 每一页转成 PNG 图片'
-  },
-  html_to_pptx: {
-    inputType: 'list',
-    outputType: 'file',
-    description: '多个 HTML 截屏后合并为单 PPTX，保持原顺序'
-  },
-  html_to_png: {
-    inputType: 'file',
-    outputType: 'file',
-    description: '将单个 HTML 文件转换为 PNG 图片'
-  },
-  pptx_to_pdf: {
-    inputType: 'file',
-    outputType: 'file',
-    description: '通过 LibreOffice 直接将 PPT/PPTX 导出为 PDF'
-  }
-};
-
-const PYTHON_SCRIPTS = {
-  pdf_to_png: 'pdf_to_png.py',
-  html_to_pptx: 'html_to_pptx.py',
-  html_to_png: 'html_to_png.py',
-  pptx_to_pdf: 'pptx_to_pdf.py'
-};
-
-const TYPE_ENUM = Object.keys(TYPE_META);
-
-const shellQuote = (value = '') => {
-  const str = String(value);
-  const escaped = str.replace(/(["$`\\])/g, '\\$1');
-  return `"${escaped}"`;
-};
-
-const normalizeListInput = (input) => {
-  if (Array.isArray(input)) {
-    return input;
-  }
-  if (typeof input === 'string' && input.trim()) {
-    const trimmed = input.trim();
-    if (trimmed.startsWith('[') && trimmed.endsWith(']')) {
-      try {
-        const parsed = JSON.parse(trimmed);
-        if (Array.isArray(parsed)) {
-          return parsed;
-        }
-      } catch (error) {
-        // fall through to treating as single path
-      }
-    }
-    return [trimmed];
-  }
-  return [];
-};
-
-const ensureOutputLocation = async (targetPath, kind) => {
-  if (kind === 'directory') {
-    await fsPromises.mkdir(targetPath, { recursive: true });
-    return;
-  }
-  await fsPromises.mkdir(path.dirname(targetPath), { recursive: true });
-};
-
-const runBashCommand = (command, cwd) => new Promise((resolve, reject) => {
-  const child = spawn('bash', ['-lc', command], {
-    cwd,
-    env: process.env,
-    stdio: ['ignore', 'pipe', 'pipe']
-  });
-
-  let stdout = '';
-  let stderr = '';
-  let finished = false;
-
-  const finalize = (error) => {
-    if (finished) return;
-    finished = true;
-    clearTimeout(timeoutId);
-    if (error) {
-      reject(error);
-    } else {
-      resolve(stdout.trim());
-    }
-  };
-
-  child.stdout.on('data', (chunk) => {
-    stdout += chunk.toString();
-  });
-
-  child.stderr.on('data', (chunk) => {
-    stderr += chunk.toString();
-  });
-
-  child.on('error', (error) => {
-    finalize(error);
-  });
-
-  child.on('close', (code) => {
-    if (code === 0) {
-      finalize();
-      return;
-    }
-    const message = stderr.trim() || stdout.trim() || `命令执行失败，退出码 ${code}`;
-    finalize(new Error(message));
-  });
-
-  const timeoutId = setTimeout(() => {
-    child.kill('SIGTERM');
-    finalize(new Error('命令执行超时 (超过 300s)'));
-  }, EXECUTION_TIMEOUT);
-});
-
-const runPythonScript = async (scriptPath, scriptArgs = [], workspaceRoot) => {
-  const quotedScript = shellQuote(scriptPath);
-  const argsString = scriptArgs.join(' ');
-  const appendArgs = argsString ? ` ${argsString}` : '';
-
-  try {
-    return await runBashCommand(`python3 ${quotedScript}${appendArgs}`, workspaceRoot);
-  } catch (error) {
-    const message = error?.message || '';
-    if (/python3: command not found/.test(message) || /python3: not found/.test(message)) {
-      return runBashCommand(`python ${quotedScript}${appendArgs}`, workspaceRoot);
-    }
-    throw error;
-  }
-};
-
-const resolveInputPaths = (inputType, input, workspaceRoot, typeName) => {
-  if (inputType === 'list') {
-    const list = normalizeListInput(input);
-    if (list.length === 0) {
-      throw new Error(`${typeName} 需要至少一个输入路径`);
-    }
-    const resolvedList = list.map((item, index) => {
-      if (typeof item !== 'string' || !item.trim()) {
-        throw new Error(`第 ${index + 1} 个输入路径无效`);
-      }
-      const resolved = resolveWorkspacePath(workspaceRoot, item.trim());
-      if (!fs.existsSync(resolved)) {
-        throw new Error(`输入文件不存在: ${resolved}`);
-      }
-      return resolved;
-    });
-    return { list: resolvedList };
-  }
-
-  if (typeof input !== 'string' || !input.trim()) {
-    throw new Error(`${typeName} 需要传入单个输入文件路径`);
-  }
-  const resolved = resolveWorkspacePath(workspaceRoot, input.trim());
-  if (!fs.existsSync(resolved)) {
-    throw new Error(`输入文件不存在: ${resolved}`);
-  }
-  return { file: resolved };
-};
-
-const formatInputPreview = (input) => {
-  if (Array.isArray(input)) {
-    return input.join(', ');
-  }
-  return typeof input === 'string' ? input : '';
-};
-
-const convertHandler = async ({ type, input, output } = {}, context = {}) => {
-  const { workspaceRoot } = context;
-  if (!workspaceRoot) {
-    return '转换失败: 未找到工作区目录';
-  }
-
-  if (!type || typeof type !== 'string') {
-    return '转换失败: type 参数无效';
-  }
-
-  const config = TYPE_META[type];
-  if (!config) {
-    return `转换失败: 不支持的 type ${type}`;
-  }
-
-  if (typeof output !== 'string' || !output.trim()) {
-    return '转换失败: output 必须是非空字符串路径';
-  }
-
-  let outputPath;
-  try {
-    outputPath = resolveWorkspacePath(workspaceRoot, output.trim());
-  } catch (error) {
-    return `转换失败: ${error.message}`;
-  }
-
-  const pptxTypes = new Set(['html_to_pptx']);
-  if (pptxTypes.has(type) && path.extname(outputPath).toLowerCase() !== '.pptx') {
-    return `转换失败: ${type} 的 output 必须是 .pptx 文件`;
-  }
-
-  let inputResolution;
-  try {
-    inputResolution = resolveInputPaths(config.inputType, input, workspaceRoot, type);
-  } catch (error) {
-    return `转换失败: ${error.message}`;
-  }
-
-  const inputPreview = formatInputPreview(input);
-
-  try {
-    await ensureOutputLocation(outputPath, config.outputType);
-
-    if (PYTHON_SCRIPTS[type]) {
-      const scriptPath = path.join(PYTHON_SCRIPT_ROOT, PYTHON_SCRIPTS[type]);
-      if (!fs.existsSync(scriptPath)) {
-        throw new Error(`找不到 Python 脚本: ${PYTHON_SCRIPTS[type]}`);
-      }
-
-      let scriptArgs = [];
-      if (config.inputType === 'list') {
-        scriptArgs = [
-          '--inputs',
-          ...inputResolution.list.map(item => shellQuote(item)),
-          '--output',
-          shellQuote(outputPath)
-        ];
-      } else {
-        scriptArgs = [
-          '--input',
-          shellQuote(inputResolution.file),
-          config.outputType === 'directory' ? '--output-dir' : '--output',
-          shellQuote(outputPath)
-        ];
-      }
-      await runPythonScript(scriptPath, scriptArgs, workspaceRoot);
-    } else {
-      throw new Error('未知的转换模式');
-    }
-
-    return [
-      '转换完成',
-      `type: ${type}`,
-      `input: ${inputPreview}`,
-      `output: ${output}`
-    ].join('\n');
-  } catch (error) {
-    const message = error?.message || String(error);
-    return `转换失败: ${message}`;
-  }
-};
-
-const schema = {
-  type: 'function',
-  function: {
-    name: 'convert',
-    description: [
-      `统一文件转换工具。type 支持：${TYPE_ENUM.join('、')}。`,
-      '所有路径都是指相对项目根目录的路径，例如：src/index.md、README.md、src/outputs等。'
-    ].join(' '),
-    parameters: {
-      type: 'object',
-      properties: {
-        type: {
-          type: 'string',
-          enum: TYPE_ENUM,
-          description: `转换类型，可选值: ${TYPE_ENUM.join(', ')}`
-        },
-        input: {
-          description: '输入路径：当 inputType 为 list（如 html_to_pptx）时为路径列表，否则为单文件路径。',
-          oneOf: [
-            { type: 'string' },
-            { type: 'array', items: { type: 'string' } }
-          ]
-        },
-        output: {
-          type: 'string',
-          description: '输出路径：PDF->PNG 时为目录路径，其余类型为单文件路径。'
-        }
-      },
-      required: ['type', 'input', 'output']
-    }
-  }
-};
-
-module.exports = {
-  name: 'convert',
-  schema,
-  handler: convertHandler
-};

package/src/tools/python/html_to_png.py

@@ -1,100 +0,0 @@
-"""Convert a single HTML file to PNG via Playwright screenshot."""
-from __future__ import annotations
-
-import argparse
-import sys
-from pathlib import Path
-
-from playwright.sync_api import sync_playwright
-
-
-MIN_WIDTH = 320
-MIN_HEIGHT = 240
-DEVICE_SCALE_FACTOR = 4
-
-
-def _find_target_element(page):
-    body = page.query_selector('body')
-    if body is None:
-        raise ValueError('未找到 body 元素')
-
-    top_level_elements = body.query_selector_all(':scope > *')
-    if not top_level_elements:
-        raise ValueError('body 中未找到可截图元素')
-
-    # 单个最外层节点时直接使用该节点，否则使用整个 body
-    return top_level_elements[0] if len(top_level_elements) == 1 else body
-
-
-def _measure_element(element):
-    size = element.evaluate(
-        """
-        (el) => {
-            const rect = el.getBoundingClientRect();
-            const width = Math.max(rect.width || 0, el.scrollWidth || 0, el.offsetWidth || 0);
-            const height = Math.max(rect.height || 0, el.scrollHeight || 0, el.offsetHeight || 0);
-            return { width, height };
-        }
-        """
-    )
-    width = max(1, int(size.get('width') or 0))
-    height = max(1, int(size.get('height') or 0))
-    return width, height
-
-
-def convert_html_to_png(input_file: str | Path, output_file: str | Path, wait_ms: int = 1500) -> Path:
-    """Convert a single HTML file to PNG image."""
-    html_path = Path(input_file).expanduser().resolve()
-    if not html_path.exists():
-        raise FileNotFoundError(f'HTML 文件不存在: {html_path}')
-
-    output_path = Path(output_file).expanduser().resolve()
-    output_path.parent.mkdir(parents=True, exist_ok=True)
-
-    with sync_playwright() as playwright:
-        browser = playwright.chromium.launch(headless=True)
-        context = browser.new_context(
-            viewport={'width': MIN_WIDTH, 'height': MIN_HEIGHT},
-            device_scale_factor=DEVICE_SCALE_FACTOR
-        )
-        page = context.new_page()
-        try:
-            file_url = html_path.as_uri()
-            page.goto(file_url)
-            page.wait_for_timeout(wait_ms)
-
-            target = _find_target_element(page)
-            element_width, element_height = _measure_element(target)
-            viewport_width = max(MIN_WIDTH, element_width)
-            viewport_height = max(MIN_HEIGHT, element_height)
-
-            page.set_viewport_size({'width': viewport_width, 'height': viewport_height})
-            page.wait_for_timeout(200)
-            target.screenshot(path=str(output_path))
-        finally:
-            context.close()
-            browser.close()
-
-    return output_path
-
-
-def _parse_args() -> argparse.Namespace:
-    parser = argparse.ArgumentParser(description='将 HTML 文件转换为 PNG 图片。')
-    parser.add_argument('--input', required=True, help='HTML 文件路径')
-    parser.add_argument('--output', required=True, help='输出 PNG 文件路径')
-    parser.add_argument('--wait', type=int, default=1500, help='页面加载等待时间，单位毫秒，默认 1500')
-    return parser.parse_args()
-
-
-def main() -> None:
-    args = _parse_args()
-    try:
-        result = convert_html_to_png(args.input, args.output, wait_ms=args.wait)
-        print(f'已生成 PNG: {result}')
-    except Exception as error:
-        print(f'转换失败: {error}', file=sys.stderr)
-        sys.exit(1)
-
-
-if __name__ == '__main__':
-    main()

package/src/tools/python/html_to_pptx.py

@@ -1,163 +0,0 @@
-"""Convert multiple HTML files into a single PPTX via Playwright screenshots."""
-from __future__ import annotations
-
-import argparse
-import sys
-import tempfile
-from pathlib import Path
-from typing import Iterable, List
-
-from PIL import Image
-from playwright.sync_api import sync_playwright
-from pptx import Presentation
-from pptx.util import Inches
-
-
-SLIDE_SIZE_43 = (Inches(10), Inches(7.5))  # 4:3
-SLIDE_SIZE_169 = (Inches(13.3333), Inches(7.5))  # 16:9
-MIN_WIDTH = 320
-MIN_HEIGHT = 240
-DEVICE_SCALE_FACTOR = 4
-
-
-def _find_target_element(page):
-    body = page.query_selector('body')
-    if body is None:
-        raise ValueError('未找到 body 元素')
-
-    top_level_elements = body.query_selector_all(':scope > *')
-    if not top_level_elements:
-        raise ValueError('body 中未找到可截图元素')
-
-    # 单个最外层节点时直接使用该节点，否则使用整个 body
-    return top_level_elements[0] if len(top_level_elements) == 1 else body
-
-
-def _measure_element(element):
-    size = element.evaluate(
-        """
-        (el) => {
-            const rect = el.getBoundingClientRect();
-            const width = Math.max(rect.width || 0, el.scrollWidth || 0, el.offsetWidth || 0);
-            const height = Math.max(rect.height || 0, el.scrollHeight || 0, el.offsetHeight || 0);
-            return { width, height };
-        }
-        """
-    )
-    width = max(1, int(size.get('width') or 0))
-    height = max(1, int(size.get('height') or 0))
-    return width, height
-
-
-def _choose_slide_size(aspect_ratios: Iterable[float]):
-    ratios = [ratio for ratio in aspect_ratios if ratio > 0]
-    if not ratios:
-        return SLIDE_SIZE_43
-    average_ratio = sum(ratios) / len(ratios)
-    diff_43 = abs(average_ratio - (4 / 3))
-    diff_169 = abs(average_ratio - (16 / 9))
-    return SLIDE_SIZE_43 if diff_43 <= diff_169 else SLIDE_SIZE_169
-
-
-def capture_html_to_image(page, html_path: Path, target_path: Path, wait_ms: int) -> float:
-    file_url = html_path.as_uri()
-    page.goto(file_url)
-    page.wait_for_timeout(wait_ms)
-    target = _find_target_element(page)
-    element_width, element_height = _measure_element(target)
-    viewport_width = max(MIN_WIDTH, element_width)
-    viewport_height = max(MIN_HEIGHT, element_height)
-    page.set_viewport_size({'width': viewport_width, 'height': viewport_height})
-    page.wait_for_timeout(200)
-    target.screenshot(path=str(target_path))
-    return element_width / element_height if element_height else 1.0
-
-
-def build_presentation(images: Iterable[Path], output_file: Path, slide_size) -> Path:
-    slide_width, slide_height = slide_size
-    presentation = Presentation()
-    presentation.slide_width = slide_width
-    presentation.slide_height = slide_height
-
-    # Remove default slide if present
-    while len(presentation.slides) > 0:
-        slide_id = presentation.slides._sldIdLst[0].rId
-        presentation.part.drop_rel(slide_id)
-        del presentation.slides._sldIdLst[0]
-
-    layout = presentation.slide_layouts[6]
-    for image_path in images:
-        with Image.open(image_path) as image:
-            image_ratio = image.width / image.height if image.height else 1.0
-        slide_ratio = slide_width / slide_height if slide_height else image_ratio
-        if slide_ratio >= image_ratio:
-            target_height = slide_height
-            target_width = int(target_height * image_ratio)
-        else:
-            target_width = slide_width
-            target_height = int(target_width / image_ratio)
-        left = max(0, (slide_width - target_width) // 2)
-        top = max(0, (slide_height - target_height) // 2)
-        slide = presentation.slides.add_slide(layout)
-        slide.shapes.add_picture(str(image_path), left, top, width=target_width, height=target_height)
-
-    presentation.save(str(output_file))
-    return output_file
-
-
-def convert_html_list_to_pptx(html_files: Iterable[str | Path], output_file: str | Path, wait_ms: int = 1500) -> Path:
-    html_paths = [Path(item).expanduser().resolve() for item in html_files]
-    if not html_paths:
-        raise ValueError('请提供至少一个 HTML 文件')
-    for path_item in html_paths:
-        if not path_item.exists():
-            raise FileNotFoundError(f'HTML 文件不存在: {path_item}')
-
-    output_path = Path(output_file).expanduser().resolve()
-    output_path.parent.mkdir(parents=True, exist_ok=True)
-
-    screenshots: List[Path] = []
-    aspect_ratios: List[float] = []
-    with tempfile.TemporaryDirectory() as temp_dir:
-        temp_root = Path(temp_dir)
-        with sync_playwright() as playwright:
-            browser = playwright.chromium.launch(headless=True)
-            context = browser.new_context(
-                viewport={'width': MIN_WIDTH, 'height': MIN_HEIGHT},
-                device_scale_factor=DEVICE_SCALE_FACTOR
-            )
-            page = context.new_page()
-            try:
-                for index, html_path in enumerate(html_paths, start=1):
-                    target_file = temp_root / f'slide_{index:04d}.png'
-                    ratio = capture_html_to_image(page, html_path, target_file, wait_ms)
-                    screenshots.append(target_file)
-                    aspect_ratios.append(ratio)
-            finally:
-                context.close()
-                browser.close()
-        slide_size = _choose_slide_size(aspect_ratios)
-        build_presentation(screenshots, output_path, slide_size)
-    return output_path
-
-
-def _parse_args() -> argparse.Namespace:
-    parser = argparse.ArgumentParser(description='将多个 HTML 文件合并到单个 PPTX 中。')
-    parser.add_argument('--inputs', nargs='+', required=True, help='HTML 文件路径列表')
-    parser.add_argument('--output', required=True, help='输出 PPTX 文件路径')
-    parser.add_argument('--wait', type=int, default=1500, help='每个页面加载等待时间，单位毫秒，默认 1500')
-    return parser.parse_args()
-
-
-def main() -> None:
-    args = _parse_args()
-    try:
-        result = convert_html_list_to_pptx(args.inputs, args.output, wait_ms=args.wait)
-        print(f'已生成 PPTX: {result}')
-    except Exception as error:
-        print(f'转换失败: {error}', file=sys.stderr)
-        sys.exit(1)
-
-
-if __name__ == '__main__':
-    main()