agent-reader 1.1.3 → 1.1.4

package/CHANGELOG.md

@@ -0,0 +1,22 @@
+# Changelog
+
+## 1.1.3 - 2026-03-14
+
+- Fixed slideshow landscape PDF crash by removing unstable in-page canvas recompression.
+- Improved custom theme error message (`theme not found`) for better novice UX.
+- Added MCP `export_slideshow` tool to export image directories directly to HTML/PDF.
+- Expanded OpenClaw skill docs/schema to include slideshow export tool and parameter hints.
+
+## 1.1.2 - 2026-03-14
+
+- Added auto fallback retry (`--no-sandbox`) for PDF export in `sandbox=auto` mode.
+
+## 1.1.1 - 2026-03-14
+
+- Fixed PDF export stability (`networkidle0` to `domcontentloaded` + font/image readiness wait).
+- Registered `mcp` command in CLI.
+- Fixed stdin TTY handling.
+
+## 1.1.0 - 2026-03-14
+
+- Implemented v2 plan: sandbox modes, DOCX fallback quality upgrades, path guard, skill/schema packaging, tests, and docs updates.

package/README.md

@@ -193,13 +193,14 @@ Claude Desktop 配置（`claude_desktop_config.json`）：
 }
 ```
 
-提供 6 个工具：
+提供 7 个工具：
 
 | 工具 | 功能 |
 |------|------|
 | `render_markdown` | Markdown → 网页预览 |
 | `export_document` | Markdown → PDF / Word |
 | `create_slideshow` | 图片目录 → 幻灯片 |
+| `export_slideshow` | 图片目录 → 幻灯片 HTML / PDF |
 | `open_file` | 智能打开（按偏好自动选格式） |
 | `configure_user_preferences` | 设置默认偏好 |
 | `get_user_preferences` | 读取当前偏好 |
@@ -226,7 +227,7 @@ Claude Desktop 配置（`claude_desktop_config.json`）：
 | 依赖 | 必需？ | 用途 |
 |------|--------|------|
 | Node.js 18+ | 是 | 运行环境 |
-| Puppeteer | 是 | PDF 导出（安装时自动下载 Chromium） |
+| Puppeteer | 否（按需） | PDF 导出（可选依赖；未安装时仅影响 PDF） |
 | Pandoc | 否 | Word 导出更好看（没有会自动降级为纯 JS 方案） |
 
 ## 云环境部署

package/SKILL.md

@@ -9,7 +9,7 @@ description: 把 Markdown 渲染成漂亮网页、导出 Word/PDF、图片做幻
 
 - Markdown 渲染为可阅读网页（目录、代码高亮、表格样式）
 - 导出 PDF / DOCX 文档
-- 图片目录生成幻灯片并支持导出 PDF
+- 图片目录生成幻灯片并支持直接导出 PDF
 
 ## 触发条件
 
@@ -31,8 +31,17 @@ agent-reader slides ./images --auto 5
 - `render_markdown`
 - `export_document`
 - `create_slideshow`
+- `export_slideshow`
 - `open_file`
 
+### MCP 参数速查
+
+- `render_markdown`: `content`(必填), `source_path`, `theme`, `return_content`
+- `export_document`: `content`(必填), `format`=`pdf|docx`(必填), `source_path`, `return_content`
+- `create_slideshow`: `image_dir`(必填), `auto_play`, `return_content`
+- `export_slideshow`: `image_dir`(必填), `format`=`pdf|html`, `auto_play`, `return_content`
+- `open_file`: `file_path`(必填), `open_as`=`auto|web|word|pdf|ppt`, `theme`, `auto_play`, `return_content`
+
 ## 安装
 
 ```bash

package/bin/agent-reader.js

@@ -17,7 +17,7 @@ const program = new Command();
 program
   .name('agent-reader')
   .description('AI Agent output beautifier and slideshow generator')
-  .version('1.1.3');
+  .version('1.1.4');
 
 setupCommonCommandOptions(
   program

package/openclaw-skill/SKILL.md

@@ -9,7 +9,7 @@ description: 把 Markdown 渲染成漂亮网页、导出 Word/PDF、图片做幻
 
 - Markdown 渲染为可阅读网页（目录、代码高亮、表格样式）
 - 导出 PDF / DOCX 文档
-- 图片目录生成幻灯片并支持导出 PDF
+- 图片目录生成幻灯片并支持直接导出 PDF
 
 ## 触发条件
 
@@ -31,8 +31,17 @@ agent-reader slides ./images --auto 5
 - `render_markdown`
 - `export_document`
 - `create_slideshow`
+- `export_slideshow`
 - `open_file`
 
+### MCP 参数速查
+
+- `render_markdown`: `content`(必填), `source_path`, `theme`, `return_content`
+- `export_document`: `content`(必填), `format`=`pdf|docx`(必填), `source_path`, `return_content`
+- `create_slideshow`: `image_dir`(必填), `auto_play`, `return_content`
+- `export_slideshow`: `image_dir`(必填), `format`=`pdf|html`, `auto_play`, `return_content`
+- `open_file`: `file_path`(必填), `open_as`=`auto|web|word|pdf|ppt`, `theme`, `auto_play`, `return_content`
+
 ## 安装
 
 ```bash

package/openclaw-skill/schema.json

@@ -192,6 +192,74 @@
         ],
         "additionalProperties": true
       }
+    },
+    "export_slideshow": {
+      "description": "Export slideshow from an image directory into HTML or PDF",
+      "input": {
+        "type": "object",
+        "properties": {
+          "image_dir": {
+            "type": "string",
+            "description": "Absolute or relative image directory path"
+          },
+          "format": {
+            "type": "string",
+            "enum": [
+              "html",
+              "pdf"
+            ],
+            "description": "Export format, default pdf"
+          },
+          "auto_play": {
+            "type": "number",
+            "description": "Autoplay interval in seconds"
+          },
+          "return_content": {
+            "type": "boolean",
+            "description": "Return file content directly"
+          }
+        },
+        "required": [
+          "image_dir"
+        ],
+        "additionalProperties": false
+      },
+      "output": {
+        "type": "object",
+        "properties": {
+          "file_path": {
+            "type": "string"
+          },
+          "content_data": {
+            "type": "string"
+          },
+          "format": {
+            "type": "string",
+            "enum": [
+              "html",
+              "pdf"
+            ]
+          },
+          "size": {
+            "type": "number"
+          },
+          "warnings": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          },
+          "image_count": {
+            "type": "number"
+          }
+        },
+        "required": [
+          "format",
+          "size",
+          "warnings"
+        ],
+        "additionalProperties": true
+      }
     }
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-reader",
-  "version": "1.1.3",
+  "version": "1.1.4",
   "description": "AI Agent 的文档美化引擎 — 一键把 Markdown 变成漂亮网页、Word、PDF 和幻灯片",
   "main": "index.js",
   "directories": {

package/src/core/renderer.js

@@ -173,12 +173,20 @@ async function loadStyles(theme) {
       : path.resolve(themeName);
 
   const highlightCssPath = themeName === 'dark' ? HIGHLIGHT_CSS_DARK : HIGHLIGHT_CSS_LIGHT;
+  const customThemePromise = customThemePath
+    ? fs.readFile(customThemePath, 'utf8').catch((error) => {
+      if (error && error.code === 'ENOENT') {
+        throw new Error(`theme not found: ${themeName}. Use "light", "dark", or a valid CSS file path.`);
+      }
+      throw error;
+    })
+    : Promise.resolve('');
 
   const [builtInTheme, githubCss, highlightCss, customTheme = ''] = await Promise.all([
     fs.readFile(builtInThemePath, 'utf8'),
     fs.readFile(GITHUB_MARKDOWN_CSS_PATH, 'utf8'),
     fs.readFile(highlightCssPath, 'utf8'),
-    customThemePath ? fs.readFile(customThemePath, 'utf8') : Promise.resolve(''),
+    customThemePromise,
   ]);
 
   const mergedCss = `${githubCss}\n${highlightCss}\n${builtInTheme}\n${TOC_BASE_CSS}\n${customTheme}`;

package/src/mcp/server.js

@@ -63,6 +63,10 @@ function maybeTooLargePayload(textOrBase64) {
   return byteLengthOfString(textOrBase64) > MAX_CONTENT_BYTES;
 }
 
+function uniqueWarnings(warnings = []) {
+  return [...new Set(warnings)];
+}
+
 async function saveHtmlResult(html, outputDir, name = 'output') {
   const htmlPath = path.join(outputDir, `${name}.html`);
   await fs.writeFile(htmlPath, html, 'utf8');
@@ -72,7 +76,7 @@ async function saveHtmlResult(html, outputDir, name = 'output') {
 
 const server = new McpServer({
   name: 'agent-reader',
-  version: '1.1.3',
+  version: '1.1.4',
 });
 
 server.registerTool(
@@ -253,6 +257,110 @@ server.registerTool(
   },
 );
 
+server.registerTool(
+  'export_slideshow',
+  MCP_TOOL_SCHEMAS.export_slideshow,
+  async ({
+    image_dir,
+    format = 'pdf',
+    auto_play,
+    return_content,
+  }) => {
+    try {
+      const outputDir = await createOutputDir('export-slideshow');
+      const wantsContent = Boolean(return_content);
+      const targetFormat = format === 'html' ? 'html' : 'pdf';
+      const slideshow = await createSlideshow(image_dir, {
+        autoPlay: auto_play,
+        inlineAll: wantsContent || targetFormat === 'pdf',
+        outDir: outputDir,
+      });
+      const warnings = [...(slideshow.warnings || [])];
+
+      if (targetFormat === 'html') {
+        const htmlPath = path.join(outputDir, 'slideshow.html');
+        await fs.writeFile(htmlPath, slideshow.html, 'utf8');
+        const fileSize = (await fs.stat(htmlPath)).size;
+
+        if (wantsContent) {
+          if (!maybeTooLargePayload(slideshow.html)) {
+            return toTextResult({
+              content_data: slideshow.html,
+              format: 'html',
+              size: byteLengthOfString(slideshow.html),
+              warnings: uniqueWarnings(warnings),
+              image_count: slideshow.imageCount,
+            });
+          }
+
+          return toTextResult({
+            file_path: htmlPath,
+            format: 'html',
+            size: fileSize,
+            warnings: uniqueWarnings([...warnings, 'content_too_large']),
+            image_count: slideshow.imageCount,
+          });
+        }
+
+        return toTextResult({
+          file_path: htmlPath,
+          format: 'html',
+          size: fileSize,
+          warnings: uniqueWarnings(warnings),
+          image_count: slideshow.imageCount,
+        });
+      }
+
+      const dirName = path.basename(path.resolve(image_dir));
+      const printHtmlPath = path.join(outputDir, '_print.html');
+      await fs.writeFile(printHtmlPath, slideshow.printHtml, 'utf8');
+
+      const pdf = await exportPDF(slideshow.printHtml, {
+        pageSize: 'A4',
+        landscape: true,
+        outDir: outputDir,
+        fileName: `${dirName}.pdf`,
+        htmlPath: printHtmlPath,
+        sandbox: MCP_SANDBOX_MODE,
+      });
+      warnings.push(...(pdf.warnings || []));
+
+      if (wantsContent) {
+        const fileBuffer = await fs.readFile(pdf.pdfPath);
+        const fileSize = fileBuffer.byteLength;
+        const base64 = fileBuffer.toString('base64');
+        if (!maybeTooLargePayload(base64)) {
+          return toTextResult({
+            content_data: base64,
+            format: 'pdf',
+            size: fileSize,
+            warnings: uniqueWarnings(warnings),
+            image_count: slideshow.imageCount,
+          });
+        }
+
+        return toTextResult({
+          file_path: pdf.pdfPath,
+          format: 'pdf',
+          size: fileSize,
+          warnings: uniqueWarnings([...warnings, 'content_too_large']),
+          image_count: slideshow.imageCount,
+        });
+      }
+
+      return toTextResult({
+        file_path: pdf.pdfPath,
+        format: 'pdf',
+        size: pdf.size,
+        warnings: uniqueWarnings(warnings),
+        image_count: slideshow.imageCount,
+      });
+    } catch (error) {
+      return toErrorResult(error, 'slideshow_export_failed');
+    }
+  },
+);
+
 server.registerTool(
   'open_file',
   MCP_TOOL_SCHEMAS.open_file,

package/src/mcp/toolSchemas.js

@@ -29,6 +29,15 @@ export const MCP_TOOL_SCHEMAS = {
       return_content: z.boolean().optional().describe('Return inline HTML content directly'),
     },
   },
+  export_slideshow: {
+    description: 'Export slideshow from an image directory into HTML or PDF',
+    inputSchema: {
+      image_dir: z.string().describe('Absolute or relative image directory path'),
+      format: z.enum(['html', 'pdf']).optional().describe('Export format, default pdf'),
+      auto_play: z.number().optional().describe('Autoplay interval in seconds'),
+      return_content: z.boolean().optional().describe('Return file content directly'),
+    },
+  },
   open_file: {
     description: 'Open a local file/path using user preference or explicit mode: web/word/pdf/ppt',
     inputSchema: {