@liustack/pagepress 0.5.1 → 0.6.1

package/README.md

@@ -1,6 +1,6 @@
 # PagePress
 
-A web content rendering toolkit (CLI) designed for **AI Agents**, converting HTML, Markdown, and URLs into high-quality **PDF** or **PNG** images.
+A web content rendering toolkit (CLI) designed for **AI Agents**, converting local HTML and Markdown files into high-quality **PDF** or **PNG** images.
 
 中文说明请见：[README.zh-CN.md](README.zh-CN.md)
 
@@ -8,7 +8,7 @@ A web content rendering toolkit (CLI) designed for **AI Agents**, converting HTM
 
 - **Unified CLI**: One tool (`pagepress`) for both PDF and image generation
 - **AI Agent friendly**: Includes a detailed SKILL.md guide with scenario routing
-- **Multiple inputs**: Local HTML, Markdown files, or remote URLs
+- **Local files only**: Accepts local HTML and Markdown files (remote URLs are not supported for security)
 - **Rich templates**:
   - **PDF**: Apple style, GitHub style, magazine layout (Magazine)
   - **Image**: 8 presets — OG cards, infographics, posters, banners, Twitter/X cards, YouTube thumbnails, Xiaohongshu covers, WeChat covers
@@ -44,8 +44,6 @@ pagepress pdf -i document.md -o output.pdf --template default
 # Local HTML file to PDF
 pagepress pdf -i page.html -o output.pdf
 
-# Render a web page (as-is)
-pagepress pdf -i https://example.com -o webpage.pdf
 ```
 
 **Supported templates**:
@@ -55,7 +53,7 @@ pagepress pdf -i https://example.com -o webpage.pdf
 
 ### 2. Generate Images
 
-Render HTML/URLs into PNG images, suitable for social share cards, posters, and long screenshots.
+Render local HTML into PNG images, suitable for social share cards, posters, and infographics.
 
 For OG cards, posters, and banners, the visuals should be generated based on workspace brand assets (logo, colors, fonts, imagery), commonly located in `assets/`, `public/`, or `src/assets/`.
 
@@ -79,8 +77,6 @@ pagepress shot -i card.html -o og.png --preset og
 # Generate a long infographic
 pagepress shot -i stats.html -o infographic.png --preset infographic
 
-# Webpage screenshot
-pagepress shot -i https://example.com -o screenshot.png
 ```
 
 **Supported presets**:
@@ -117,8 +113,8 @@ pagepress shot -i https://example.com -o screenshot.png
 
 This project includes two skill guides for AI Agents (such as Claude, ChatGPT):
 
-- [web-to-pdf/SKILL.md](skills/web-to-pdf/SKILL.md) — PDF generation (Markdown beautification, templates, HTML/URL printing)
-- [web-to-png/SKILL.md](skills/web-to-png/SKILL.md) — PNG generation (OG cards, infographics, posters, banners, screenshots)
+- [web-to-pdf/SKILL.md](skills/web-to-pdf/SKILL.md) — PDF generation (Markdown beautification, templates, HTML printing)
+- [web-to-png/SKILL.md](skills/web-to-png/SKILL.md) — PNG generation (OG cards, infographics, posters, banners, social cards)
 
 Agents can automatically choose the appropriate commands and parameters based on natural language instructions (for example, "generate a poster" or "convert this document to PDF").
 

package/README.zh-CN.md

@@ -1,12 +1,12 @@
 # PagePress
 
-一套专为 **AI Agent** 设计的 Web 内容渲染工具集（CLI），可将 HTML、Markdown、URL 转换为高质量的 **PDF** 或 **PNG** 图像。
+一套专为 **AI Agent** 设计的 Web 内容渲染工具集（CLI），可将本地 HTML、Markdown 文件转换为高质量的 **PDF** 或 **PNG** 图像。
 
 ## ✨ 特性
 
 - **统一 CLI**：一个工具 (`pagepress`) 搞定 PDF 和 Image 生成
 - **AI Agent 友好**：包含详细的 SKILL.md 指南，支持场景路由
-- **多种输入**：支持本地 HTML、Markdown 文件或远程 URL
+- **仅本地文件**：支持本地 HTML、Markdown 文件（出于安全考虑不支持远程 URL）
 - **丰富模板**：
   - **PDF**: Apple 风格、GitHub 风格、杂志排版 (Magazine)
   - **Image**: 8 种预设 — OG 卡片、信息图、海报、横幅、Twitter/X 卡片、YouTube 缩略图、小红书封面、微信公众号封面
@@ -42,8 +42,6 @@ pagepress pdf -i document.md -o output.pdf --template default
 # 本地 HTML 文件转 PDF
 pagepress pdf -i page.html -o output.pdf
 
-# 网页打印（原样渲染）
-pagepress pdf -i https://example.com -o webpage.pdf
 ```
 
 **支持的模板**：
@@ -53,7 +51,7 @@ pagepress pdf -i https://example.com -o webpage.pdf
 
 ### 2. 生成图像
 
-将 HTML/URL 渲染为 PNG 图像，适合社交分享卡片、海报、长图截屏。
+将本地 HTML 渲染为 PNG 图像，适合社交分享卡片、海报、信息图。
 
 对于 OG 卡片、海报、横幅，视觉应基于工作区的品牌资源（logo、颜色、字体、素材）生成，常见目录包括 `assets/`、`public/`、`src/assets/`。
 
@@ -77,8 +75,6 @@ pagepress shot -i card.html -o og.png --preset og
 # 生成信息长图
 pagepress shot -i stats.html -o infographic.png --preset infographic
 
-# 网页截图
-pagepress shot -i https://example.com -o screenshot.png
 ```
 
 **支持的预设**：
@@ -115,8 +111,8 @@ pagepress shot -i https://example.com -o screenshot.png
 
 本项目包含两份 AI Agent 技能指南（适用于 Claude、ChatGPT 等）：
 
-- [web-to-pdf/SKILL.md](skills/web-to-pdf/SKILL.md) — PDF 生成（Markdown 美化、模板、HTML/URL 打印）
-- [web-to-png/SKILL.md](skills/web-to-png/SKILL.md) — PNG 生成（OG 卡片、信息图、海报、横幅、网页截图）
+- [web-to-pdf/SKILL.md](skills/web-to-pdf/SKILL.md) — PDF 生成（Markdown 美化、模板、HTML 打印）
+- [web-to-png/SKILL.md](skills/web-to-png/SKILL.md) — PNG 生成（OG 卡片、信息图、海报、横幅、社交卡片）
 
 Agent 可以根据用户的自然语言指令（如"生成一张海报"、"把这个文档转成 PDF"）自动选择合适的命令和参数。
 

package/dist/main.js

@@ -115,11 +115,8 @@ async function render$1(options) {
   const inputPath = path.resolve(options.input);
   let htmlContent;
   let hasMermaid = false;
-  if (options.input.startsWith("http")) {
-    if (safeMode) {
-      throw new Error("Safe mode does not allow remote URL inputs.");
-    }
-    htmlContent = "";
+  if (options.input.startsWith("http://") || options.input.startsWith("https://")) {
+    throw new Error("Remote URL inputs are not supported. Please provide a local Markdown or HTML file path.");
   } else if (options.input.endsWith(".md")) {
     const raw = fs.readFileSync(inputPath, "utf-8");
     const { data: frontmatter, content } = matter(raw);
@@ -191,11 +188,7 @@ async function render$1(options) {
       });
     }
     const page = await context.newPage();
-    if (options.input.startsWith("http")) {
-      await page.goto(options.input, { waitUntil, timeout });
-    } else {
-      await page.setContent(htmlContent, { waitUntil, timeout });
-    }
+    await page.setContent(htmlContent, { waitUntil, timeout });
     const fontCSS = getFontCSS(template.name);
     if (fontCSS) {
       await page.addStyleTag({ content: fontCSS });
@@ -323,7 +316,7 @@ async function render$1(options) {
     }
   }
 }
-const command$1 = new Command("pdf").description("Render Markdown or HTML to PDF").requiredOption("-i, --input <path>", "Input file path or URL").requiredOption("-o, --output <path>", "Output PDF file path").option("-t, --template <name>", "PDF template (default, github, magazine)", "default").option("--wait-until <state>", "Navigation waitUntil (load, domcontentloaded, networkidle)", "networkidle").option("--timeout <ms>", "Navigation timeout in milliseconds", "30000").option("--safe", "Disable external network requests and JavaScript execution").action(async (options) => {
+const command$1 = new Command("pdf").description("Render Markdown or HTML to PDF").requiredOption("-i, --input <path>", "Input Markdown or HTML file path").requiredOption("-o, --output <path>", "Output PDF file path").option("-t, --template <name>", "PDF template (default, github, magazine)", "default").option("--wait-until <state>", "Navigation waitUntil (load, domcontentloaded, networkidle)", "networkidle").option("--timeout <ms>", "Navigation timeout in milliseconds", "30000").option("--safe", "Disable external network requests and JavaScript execution").action(async (options) => {
   try {
     const timeout = Number.parseInt(options.timeout, 10);
     if (!Number.isFinite(timeout) || timeout < 0) {
@@ -458,10 +451,7 @@ async function render(options) {
     const page = await context.newPage();
     const inputPath = path.resolve(options.input);
     if (options.input.startsWith("http://") || options.input.startsWith("https://")) {
-      if (safeMode) {
-        throw new Error("Safe mode does not allow remote URL inputs.");
-      }
-      await page.goto(options.input, { waitUntil, timeout });
+      throw new Error("Remote URL inputs are not supported. Please provide a local HTML file path.");
     } else if (fs.existsSync(inputPath)) {
       const content = fs.readFileSync(inputPath, "utf-8");
       await page.setContent(content, { waitUntil, timeout });
@@ -510,7 +500,7 @@ async function render(options) {
     }
   }
 }
-const command = new Command("shot").description("Capture HTML to PNG image").requiredOption("-i, --input <path>", "Input HTML file path or URL").requiredOption("-o, --output <path>", "Output PNG file path").option("-p, --preset <name>", "Image preset (og, infographic, poster, banner, twitter, youtube, xiaohongshu, wechat)", "og").option("--width <number>", "Custom width in pixels").option("--height <number>", "Custom height in pixels").option("--scale <number>", "Device scale factor", "2").option("--wait-until <state>", "Navigation waitUntil (load, domcontentloaded, networkidle)", "networkidle").option("--timeout <ms>", "Navigation timeout in milliseconds", "30000").option("--safe", "Disable external network requests and JavaScript execution").action(async (options) => {
+const command = new Command("shot").description("Capture HTML to PNG image").requiredOption("-i, --input <path>", "Input HTML file path").requiredOption("-o, --output <path>", "Output PNG file path").option("-p, --preset <name>", "Image preset (og, infographic, poster, banner, twitter, youtube, xiaohongshu, wechat)", "og").option("--width <number>", "Custom width in pixels").option("--height <number>", "Custom height in pixels").option("--scale <number>", "Device scale factor", "2").option("--wait-until <state>", "Navigation waitUntil (load, domcontentloaded, networkidle)", "networkidle").option("--timeout <ms>", "Navigation timeout in milliseconds", "30000").option("--safe", "Disable external network requests and JavaScript execution").action(async (options) => {
   try {
     const timeout = Number.parseInt(options.timeout, 10);
     if (!Number.isFinite(timeout) || timeout < 0) {
@@ -534,7 +524,7 @@ const command = new Command("shot").description("Capture HTML to PNG image").req
   }
 });
 const program = new Command();
-program.name("pagepress").description("Convert web pages and Markdown to PDF and images").version("0.1.0");
+program.name("pagepress").description("Convert web pages and Markdown to PDF and images").version("0.6.1");
 program.addCommand(command$1);
 program.addCommand(command);
 program.parse();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@liustack/pagepress",
-  "version": "0.5.1",
+  "version": "0.6.1",
   "description": "CLI tool to convert web pages and Markdown to PDF and images",
   "type": "module",
   "bin": {