@ww_nero/mini-cli 1.0.60 → 1.0.62

package/README.md

@@ -0,0 +1,24 @@
+# Mini CLI
+
+极简的 AI 命令行助手，支持工具调用、上下文压缩以及会话历史管理。
+
+## 快速开始
+- 安装依赖：`npm install`
+- 填写配置：首次运行会在 `~/.mini` 生成 `chat.json` 等文件，修改其中的 `key` 为你的接口密钥即可。
+- 运行方式：`npm start` 或 `node bin/mini.js`，也可在全局安装后直接执行 `mini`。
+
+## 常用启动参数
+- `mini -i "你好"`：启动后立即发送首条问题。
+- `mini -m <model>`：指定默认模型（等同于会话内的 `/model <name>`）。
+- `mini --resume`：启动时自动恢复当前工作目录最近一次对话。
+- `mini --help`：查看全部参数说明。
+
+## 对话内快捷命令
+- `/model`：查看或切换模型。
+- `/clear`：清空上下文。
+- `/resume [序号]`：列出或恢复历史会话。
+- `/exit`：退出对话。
+
+## 会话历史
+- 每个工作目录的历史记录保存在 `~/.mini/cli/<workspace-hash>/YYYYMMDDHHMMSS.json` 中。
+- 可通过 `mini --resume` 自动载入最近一次会话，或在对话中使用 `/resume` 按序号恢复。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ww_nero/mini-cli",
-  "version": "1.0.60",
+  "version": "1.0.62",
   "description": "极简的 AI 命令行助手",
   "bin": {
     "mini": "bin/mini.js"

package/src/chat.js

@@ -173,6 +173,7 @@ const setLoadingCursorState = (isLoading) => {
 const startChatSession = async ({
   initialQuestion = '',
   initialModelName,
+  initialResume = false,
   cliOptions = []
 } = {}) => {
   const initResult = ensureConfigFiles();
@@ -423,6 +424,38 @@ const startChatSession = async ({
     console.log(chalk.gray('-------- 历史会话结束，可继续提问 --------'));
   };
 
+  const resumeHistoryByIndex = (index = 0, { auto = false } = {}) => {
+    const entries = listHistoryFiles(workspaceRoot);
+
+    if (entries.length === 0) {
+      const notice = auto
+        ? '未找到可恢复的历史记录，将开始新的会话。'
+        : '暂无历史记录。';
+      console.log(chalk.yellow(notice));
+      return false;
+    }
+
+    const target = entries[index];
+    if (!target) {
+      console.log(chalk.yellow(`序号 ${index + 1} 超出范围，当前共有 ${entries.length} 条历史记录。`));
+      return false;
+    }
+
+    const historyMessages = readHistoryMessages(target.filePath);
+    if (!Array.isArray(historyMessages) || historyMessages.length === 0) {
+      console.log(chalk.yellow('该历史记录为空或已损坏，无法恢复。'));
+      return false;
+    }
+
+    const refreshedPath = refreshHistoryFilePath(target.filePath, workspaceRoot) || target.filePath;
+    loadHistoryFromFile(refreshedPath, historyMessages);
+
+    const prefix = auto ? '已自动恢复最近一条历史记录' : `已切换到历史记录 #${index + 1}`;
+    console.log(chalk.green(`${prefix}，可继续对话。`));
+    replayHistoryConversation(historyMessages);
+    return true;
+  };
+
   const handleResumeCommand = (rawArgs = '') => {
     const entries = listHistoryFiles(workspaceRoot);
     if (entries.length === 0) {
@@ -451,22 +484,7 @@ const startChatSession = async ({
       return;
     }
 
-    const target = entries[numeric - 1];
-    if (!target) {
-      console.log(chalk.yellow(`序号 ${numeric} 超出范围，当前共有 ${entries.length} 条历史记录。`));
-      return;
-    }
-
-    const historyMessages = readHistoryMessages(target.filePath);
-    if (!Array.isArray(historyMessages) || historyMessages.length === 0) {
-      console.log(chalk.yellow('该历史记录为空或已损坏，无法恢复。'));
-      return;
-    }
-
-    const refreshedPath = refreshHistoryFilePath(target.filePath, workspaceRoot) || target.filePath;
-    loadHistoryFromFile(refreshedPath, historyMessages);
-    console.log(chalk.green(`已切换到历史记录 #${numeric}，可继续对话。`));
-    replayHistoryConversation(historyMessages);
+    resumeHistoryByIndex(numeric - 1);
   };
 
   console.log(chalk.blueBright('Mini CLI 已启动，随时输入问题开始提问。'));
@@ -499,6 +517,10 @@ const startChatSession = async ({
     console.log(chalk.gray(`  ${cmd.value} - ${cmd.description}`));
   });
 
+  if (initialResume) {
+    resumeHistoryByIndex(0, { auto: true });
+  }
+
   const rl = readline.createInterface({
     input: process.stdin,
     output: process.stdout,

package/src/index.js

@@ -1,38 +1,39 @@
-const { Command } = require('commander');
-const chalk = require('chalk');
-
-const pkg = require('../package.json');
-const { startChatSession } = require('./chat');
-const { getDefaultConfigPath } = require('./config');
-const { CLI_OPTIONS } = require('./utils/cliOptions');
-
-const run = async () => {
-  const program = new Command();
-
-  program
-    .name('mini')
-    .description('Mini CLI · 极简 AI 命令行助手')
-    .version(pkg.version, '-v, --version')
-    .addHelpText('after', `\n退出方法：输入 /exit 或按 Ctrl+C。\n配置模板会自动生成于 ${getDefaultConfigPath()}。`)
-    .showHelpAfterError('(使用 mini --help 查看完整帮助)')
-    .action(async (options) => {
-      await startChatSession({
-        initialQuestion: options.input || '',
-        initialModelName: options.model,
-        cliOptions: CLI_OPTIONS
-      });
-    });
-
-  CLI_OPTIONS.forEach((option) => {
-    program.option(option.flags, option.description);
-  });
-
-  try {
-    await program.parseAsync(process.argv);
-  } catch (error) {
-    console.error(chalk.red(`Mini CLI 运行失败: ${error.message}`));
-    process.exitCode = 1;
-  }
-};
-
-run();
+const { Command } = require('commander');
+const chalk = require('chalk');
+
+const pkg = require('../package.json');
+const { startChatSession } = require('./chat');
+const { getDefaultConfigPath } = require('./config');
+const { CLI_OPTIONS } = require('./utils/cliOptions');
+
+const run = async () => {
+  const program = new Command();
+
+  program
+    .name('mini')
+    .description('Mini CLI · 极简 AI 命令行助手')
+    .version(pkg.version, '-v, --version')
+    .addHelpText('after', `\n退出方法：输入 /exit 或按 Ctrl+C。\n配置模板会自动生成于 ${getDefaultConfigPath()}。`)
+    .showHelpAfterError('(使用 mini --help 查看完整帮助)')
+    .action(async (options) => {
+      await startChatSession({
+        initialQuestion: options.input || '',
+        initialModelName: options.model,
+        initialResume: Boolean(options.resume),
+        cliOptions: CLI_OPTIONS
+      });
+    });
+
+  CLI_OPTIONS.forEach((option) => {
+    program.option(option.flags, option.description);
+  });
+
+  try {
+    await program.parseAsync(process.argv);
+  } catch (error) {
+    console.error(chalk.red(`Mini CLI 运行失败: ${error.message}`));
+    process.exitCode = 1;
+  }
+};
+
+run();

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);

package/src/utils/cliOptions.js

@@ -1,6 +1,7 @@
 const CLI_OPTIONS = [
   { flags: '-i, --input <text>', description: '启动后先发送一条问题' },
-  { flags: '-m, --model <name>', description: '指定启动模型名称（等同于运行 /model <name>）' }
+  { flags: '-m, --model <name>', description: '指定启动模型名称（等同于运行 /model <name>）' },
+  { flags: '-r, --resume', description: '启动时自动恢复最近一条历史会话' }
 ];
 
 module.exports = {

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()

package/src/tools/python/pdf_to_png.py

@@ -1,58 +0,0 @@
-"""Convert PDF pages to PNG files."""
-from __future__ import annotations
-
-import argparse
-import sys
-from pathlib import Path
-from typing import List
-
-from pdf2image import convert_from_path
-
-
-def convert_pdf_to_png(input_file: str | Path, output_dir: str | Path, dpi: int = 300, fmt: str = 'png') -> List[Path]:
-    """Convert a PDF into PNG images and return saved file paths."""
-    input_path = Path(input_file).expanduser().resolve()
-    if not input_path.exists():
-        raise FileNotFoundError(f'PDF文件不存在: {input_path}')
-
-    output_path = Path(output_dir).expanduser().resolve()
-    output_path.mkdir(parents=True, exist_ok=True)
-
-    format_lower = fmt.lower() or 'png'
-    images = convert_from_path(str(input_path), dpi=dpi, fmt=format_lower)
-
-    saved_files: List[Path] = []
-    for index, image in enumerate(images, start=1):
-        file_name = f'page_{index:04d}.{format_lower}'
-        target = output_path / file_name
-        image.save(str(target), format_lower.upper())
-        saved_files.append(target)
-
-    return saved_files
-
-
-def _parse_args() -> argparse.Namespace:
-    parser = argparse.ArgumentParser(description='将 PDF 转换为 PNG 图片。')
-    parser.add_argument('--input', required=True, help='待转换的 PDF 文件路径')
-    parser.add_argument('--output-dir', required=True, help='保存图片的目录')
-    parser.add_argument('--dpi', type=int, default=300, help='输出图片的 DPI，默认 300')
-    parser.add_argument('--format', default='png', help='输出图片格式，默认 PNG')
-    return parser.parse_args()
-
-
-def main() -> None:
-    args = _parse_args()
-    try:
-        results = convert_pdf_to_png(args.input, args.output_dir, dpi=args.dpi, fmt=args.format)
-        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)
-
-if __name__ == '__main__':
-    main()

package/src/tools/python/pptx_to_pdf.py

@@ -1,107 +0,0 @@
-"""使用 LibreOffice 无头模式将 PPT/PPTX 直接转换为 PDF。"""
-from __future__ import annotations
-
-import argparse
-import os
-import platform
-import shutil
-import subprocess
-import sys
-import tempfile
-from pathlib import Path
-
-
-def _detect_libreoffice() -> str:
-    """寻找 LibreOffice 可执行文件路径。"""
-    system = platform.system()
-    candidates: list[str] = []
-
-    if system == 'Darwin':
-        candidates.append('/Applications/LibreOffice.app/Contents/MacOS/soffice')
-    elif system == 'Windows':
-        program_dirs = [
-            os.environ.get('PROGRAMFILES', ''),
-            os.environ.get('PROGRAMFILES(X86)', '')
-        ]
-        for base in program_dirs:
-            if base:
-                candidates.append(str(Path(base) / 'LibreOffice' / 'program' / 'soffice.exe'))
-
-    # 通用命令放在末尾，优先尝试绝对路径
-    candidates.extend(['soffice', 'libreoffice'])
-
-    for candidate in candidates:
-        candidate_path = Path(candidate)
-        if candidate_path.exists():
-            return str(candidate_path)
-
-        resolved = shutil.which(candidate)
-        if resolved:
-            return resolved
-
-    return ''
-
-
-def pptx_to_pdf(input_file: str | Path, output_file: str | Path) -> Path:
-    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)
-
-    libreoffice_cmd = _detect_libreoffice()
-    if not libreoffice_cmd:
-        raise RuntimeError('未找到 LibreOffice，请先安装（例如 apt install libreoffice 或从官网安装包）。')
-
-    with tempfile.TemporaryDirectory(prefix='pptx_to_pdf_') as temp_dir:
-        cmd = [
-            libreoffice_cmd,
-            '--headless',
-            '--invisible',
-            '--convert-to', 'pdf',
-            '--outdir', temp_dir,
-            str(pptx_path)
-        ]
-
-        result = subprocess.run(cmd, capture_output=True, text=True)
-        if result.returncode != 0:
-            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():
-            pdf_candidates = list(Path(temp_dir).glob('*.pdf'))
-            if len(pdf_candidates) == 1:
-                generated = pdf_candidates[0]
-            else:
-                raise RuntimeError('未找到 LibreOffice 生成的 PDF 文件')
-
-        if output_path.exists():
-            output_path.unlink()
-
-        shutil.move(str(generated), str(output_path))
-        return output_path
-
-
-def _parse_args() -> argparse.Namespace:
-    parser = argparse.ArgumentParser(description='将 PPT/PPTX 转换为 PDF（调用 LibreOffice 无头模式）。')
-    parser.add_argument('--input', required=True, help='PPT/PPTX 文件路径')
-    parser.add_argument('--output', required=True, help='输出 PDF 文件路径')
-    return parser.parse_args()
-
-
-def main() -> None:
-    args = _parse_args()
-    try:
-        result = pptx_to_pdf(args.input, args.output)
-        print(f'已生成 PDF: {result}')
-    except Exception as error:
-        print(f'转换失败: {error}', file=sys.stderr)
-        sys.exit(1)
-
-
-if __name__ == '__main__':
-    main()