agent-reader 1.1.0 → 1.1.2

package/README.md

@@ -232,6 +232,7 @@ Claude Desktop 配置（`claude_desktop_config.json`）：
 ## 云环境部署
 
 在 Docker/CI 中，Agent Reader 会自动检测环境并在需要时为 Puppeteer 关闭沙盒参数（`--no-sandbox` 等）。
+在部分非标准云环境里，`auto` 模式首次失败时也会自动重试一次 `no-sandbox`，减少手动排障。
 
 手动覆盖方式：
 

package/bin/agent-reader.js

@@ -4,6 +4,7 @@ import {
   cleanCommand,
   doctorCommand,
   exportCommand,
+  mcpStubCommand,
   openCommand,
   renderCommand,
   runCommandSafely,
@@ -16,7 +17,7 @@ const program = new Command();
 program
   .name('agent-reader')
   .description('AI Agent output beautifier and slideshow generator')
-  .version('1.1.0');
+  .version('1.1.2');
 
 setupCommonCommandOptions(
   program
@@ -80,4 +81,9 @@ program
   .option('--days <days>', 'max age in days', '7')
   .action((options) => runCommandSafely(() => cleanCommand(options)));
 
+program
+  .command('mcp')
+  .description('Start MCP server on stdio')
+  .action(() => runCommandSafely(() => mcpStubCommand()));
+
 await program.parseAsync(process.argv);

package/package.json

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

package/src/cli/commands.js

@@ -1,5 +1,6 @@
 import { promises as fs } from 'node:fs';
 import path from 'node:path';
+import { fileURLToPath } from 'node:url';
 import open from 'open';
 import { execa } from 'execa';
 import { renderMarkdown } from '../core/renderer.js';
@@ -49,6 +50,9 @@ function normalizeMode(options) {
 }
 
 async function readAllFromStdin() {
+  if (process.stdin.isTTY) {
+    throw new Error('stdin is a terminal — pipe content or use a file path instead (e.g. echo "# hi" | agent-reader render --stdin)');
+  }
   const chunks = [];
   for await (const chunk of process.stdin) {
     chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
@@ -591,7 +595,9 @@ export async function cleanCommand(options) {
 }
 
 export async function mcpStubCommand() {
-  const result = await execa('node', ['src/mcp/server.js'], { stdio: 'inherit' });
+  const __dirname = path.dirname(fileURLToPath(import.meta.url));
+  const serverPath = path.resolve(__dirname, '..', 'mcp', 'server.js');
+  const result = await execa('node', [serverPath], { stdio: 'inherit' });
   return result;
 }
 

package/src/core/exporter.js

@@ -690,30 +690,15 @@ export function createPandocFallbackWarnings(platform = process.platform) {
   ];
 }
 
-export async function exportPDF(html, options = {}) {
-  const {
-    pageSize = 'A4',
-    landscape = false,
-    outDir = os.tmpdir(),
-    fileName = 'output.pdf',
-    htmlPath,
-    sandbox,
-  } = options;
-
-  let puppeteer;
-  try {
-    const mod = await import('puppeteer');
-    puppeteer = mod.default || mod;
-  } catch {
-    throw new Error('Puppeteer is not installed. Install optional dependency: npm install puppeteer');
-  }
-
-  const warnings = [];
-  const pdfPath = path.join(path.resolve(outDir), fileName);
-  const resolvedSandboxMode = resolveSandboxMode(sandbox);
-  const launchArgs = landscape ? ['--allow-file-access-from-files'] : [];
-  launchArgs.push(...getSandboxArgs(resolvedSandboxMode));
-
+async function renderPdfWithPuppeteer({
+  puppeteer,
+  launchArgs,
+  html,
+  htmlPath,
+  pageSize,
+  landscape,
+  pdfPath,
+}) {
   const browser = await puppeteer.launch({
     headless: true,
     args: launchArgs,
@@ -723,14 +708,24 @@ export async function exportPDF(html, options = {}) {
 
     if (htmlPath) {
       await page.goto(pathToFileURL(path.resolve(htmlPath)).toString(), {
-        waitUntil: 'networkidle0',
+        waitUntil: 'domcontentloaded',
       });
     } else {
       await page.setContent(html, {
-        waitUntil: 'networkidle0',
+        waitUntil: 'domcontentloaded',
       });
     }
 
+    // Wait for images and fonts to finish loading before generating PDF.
+    await page.evaluate(() =>
+      Promise.all([
+        document.fonts?.ready,
+        ...Array.from(document.images).map((img) =>
+          img.complete ? Promise.resolve() : new Promise((r) => { img.onload = r; img.onerror = r; }),
+        ),
+      ]),
+    );
+
     await page.addStyleTag({
       content: `
 @page {
@@ -798,7 +793,72 @@ blockquote { break-inside: avoid; }`,
       tagged: true,
     });
   } finally {
-    await browser.close();
+    await browser.close().catch(() => {});
+  }
+}
+
+export async function exportPDF(html, options = {}) {
+  const {
+    pageSize = 'A4',
+    landscape = false,
+    outDir = os.tmpdir(),
+    fileName = 'output.pdf',
+    htmlPath,
+    sandbox,
+    puppeteerInstance,
+    sandboxRuntime,
+  } = options;
+
+  let puppeteer = puppeteerInstance;
+  try {
+    if (!puppeteer) {
+      const mod = await import('puppeteer');
+      puppeteer = mod.default || mod;
+    }
+  } catch {
+    throw new Error('Puppeteer is not installed. Install optional dependency: npm install puppeteer');
+  }
+
+  const warnings = [];
+  const pdfPath = path.join(path.resolve(outDir), fileName);
+  const resolvedSandboxMode = resolveSandboxMode(sandbox);
+  const baseArgs = landscape ? ['--allow-file-access-from-files'] : [];
+  const primaryArgs = [...baseArgs, ...getSandboxArgs(resolvedSandboxMode, sandboxRuntime)];
+  const canRetryWithNoSandbox = resolvedSandboxMode === 'auto'
+    && !primaryArgs.includes('--no-sandbox');
+
+  try {
+    await renderPdfWithPuppeteer({
+      puppeteer,
+      launchArgs: primaryArgs,
+      html,
+      htmlPath,
+      pageSize,
+      landscape,
+      pdfPath,
+    });
+  } catch (primaryError) {
+    if (!canRetryWithNoSandbox) {
+      throw primaryError;
+    }
+
+    const fallbackArgs = [...baseArgs, ...SANDBOX_DISABLED_ARGS];
+    try {
+      await renderPdfWithPuppeteer({
+        puppeteer,
+        launchArgs: fallbackArgs,
+        html,
+        htmlPath,
+        pageSize,
+        landscape,
+        pdfPath,
+      });
+      warnings.push('sandbox_auto_retry_off');
+    } catch (fallbackError) {
+      throw new Error(
+        `PDF export failed in auto mode and fallback off mode: ${fallbackError.message} (auto error: ${primaryError.message})`,
+      );
+    }
   }
 
   const stat = await fs.stat(pdfPath);

package/src/mcp/server.js

@@ -72,7 +72,7 @@ async function saveHtmlResult(html, outputDir, name = 'output') {
 
 const server = new McpServer({
   name: 'agent-reader',
-  version: '1.1.0',
+  version: '1.1.2',
 });
 
 server.registerTool(