@liustack/pagepress 0.3.0 → 0.5.0

package/README.md

@@ -11,7 +11,7 @@ A web content rendering toolkit (CLI) designed for **AI Agents**, converting HTM
 - **Multiple inputs**: Local HTML, Markdown files, or remote URLs
 - **Rich templates**:
   - **PDF**: Apple style, GitHub style, magazine layout (Magazine)
-  - **Image**: OG cards, infographics, posters, banners
+  - **Image**: 8 presets — OG cards, infographics, posters, banners, Twitter/X cards, YouTube thumbnails, Xiaohongshu covers, WeChat covers
 - **Brand-aware visuals**: OG / poster / banner outputs are generated based on workspace visual & brand assets (commonly in `assets/`, `public/`, `src/assets/`)
 - **Consistency guarantees**: Deterministic rendering, font waiting, network idle detection, syntax highlighting
 
@@ -88,10 +88,37 @@ pagepress shot -i https://example.com -o screenshot.png
 - `infographic` (1080x1350) - Infographic
 - `poster` (1200x1500) - Poster
 - `banner` (1600x900) - Banner
+- `twitter` (1200x675) - Twitter/X card
+- `youtube` (1280x720) - YouTube thumbnail
+- `xiaohongshu` (1080x1440) - Xiaohongshu / RedNote cover
+- `wechat` (900x383) - WeChat Official Account cover
+
+## 🖼️ Examples
+
+### Image Presets
+
+| OG Card (1200×630) | Infographic (1080×1350) |
+|:---:|:---:|
+| ![OG Card](examples/shot-og.png) | ![Infographic](examples/shot-infographic.png) |
+
+| Poster (1200×1500) | Banner (1600×900) |
+|:---:|:---:|
+| ![Poster](examples/shot-poster.png) | ![Banner](examples/shot-banner.png) |
+
+| Twitter/X Card (1200×675) | YouTube Thumbnail (1280×720) |
+|:---:|:---:|
+| ![Twitter Card](examples/shot-twitter.png) | ![YouTube Thumbnail](examples/shot-youtube.png) |
+
+| Xiaohongshu Cover (1080×1440) | WeChat Cover (900×383) |
+|:---:|:---:|
+| ![Xiaohongshu Cover](examples/shot-xiaohongshu.png) | ![WeChat Cover](examples/shot-wechat.png) |
 
 ## 🤖 AI Agent Integration
 
-This project includes a detailed [SKILL.md](skills/pagepress/SKILL.md) to help AI Agents (such as Claude, ChatGPT) understand how to use this tool.
+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)
 
 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

@@ -9,7 +9,7 @@
 - **多种输入**：支持本地 HTML、Markdown 文件或远程 URL
 - **丰富模板**：
   - **PDF**: Apple 风格、GitHub 风格、杂志排版 (Magazine)
-  - **Image**: OG 卡片、信息图、海报、横幅
+  - **Image**: 8 种预设 — OG 卡片、信息图、海报、横幅、Twitter/X 卡片、YouTube 缩略图、小红书封面、微信公众号封面
 - **品牌一致性**：OG/海报/横幅会基于工作区的视觉与品牌资源生成（常见于 `assets/`、`public/`、`src/assets/`）
 - **一致性保障**：确定性渲染、字体等待、网络空闲检测、代码高亮
 
@@ -86,12 +86,39 @@ pagepress shot -i https://example.com -o screenshot.png
 - `infographic` (1080×1350) - 信息图
 - `poster` (1200×1500) - 海报
 - `banner` (1600×900) - 横幅
+- `twitter` (1200×675) - Twitter/X 卡片
+- `youtube` (1280×720) - YouTube 缩略图
+- `xiaohongshu` (1080×1440) - 小红书封面
+- `wechat` (900×383) - 微信公众号封面
+
+## 🖼️ 示例
+
+### 图像预设
+
+| OG 卡片 (1200×630) | 信息图 (1080×1350) |
+|:---:|:---:|
+| ![OG 卡片](examples/shot-og.png) | ![信息图](examples/shot-infographic.png) |
+
+| 海报 (1200×1500) | 横幅 (1600×900) |
+|:---:|:---:|
+| ![海报](examples/shot-poster.png) | ![横幅](examples/shot-banner.png) |
+
+| Twitter/X 卡片 (1200×675) | YouTube 缩略图 (1280×720) |
+|:---:|:---:|
+| ![Twitter 卡片](examples/shot-twitter.png) | ![YouTube 缩略图](examples/shot-youtube.png) |
+
+| 小红书封面 (1080×1440) | 微信公众号封面 (900×383) |
+|:---:|:---:|
+| ![小红书封面](examples/shot-xiaohongshu.png) | ![微信公众号封面](examples/shot-wechat.png) |
 
 ## 🤖 AI Agent 集成
 
-本项目包含详细的 [SKILL.md](skills/pagepress/SKILL.md)，旨在帮助 AI Agent（如 Claude, ChatGPT）理解如何使用此工具。
+本项目包含两份 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 卡片、信息图、海报、横幅、网页截图）
 
-Agent 可以根据用户的自然语言指令（如“生成一张海报”、“把这个文档转成 PDF”）自动选择合适的命令和参数。
+Agent 可以根据用户的自然语言指令（如"生成一张海报"、"把这个文档转成 PDF"）自动选择合适的命令和参数。
 
 ## 📄 License
 

package/dist/main.js

@@ -379,6 +379,18 @@ const imagePresets = {
     width: 1280,
     height: 720,
     description: "YouTube Thumbnail (1280×720)"
+  },
+  xiaohongshu: {
+    name: "xiaohongshu",
+    width: 1080,
+    height: 1440,
+    description: "Xiaohongshu / RedNote Cover (1080×1440)"
+  },
+  wechat: {
+    name: "wechat",
+    width: 900,
+    height: 383,
+    description: "WeChat Official Account Cover (900×383)"
   }
 };
 function getPreset(name) {
@@ -498,7 +510,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)", "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 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) => {
   try {
     const timeout = Number.parseInt(options.timeout, 10);
     if (!Number.isFinite(timeout) || timeout < 0) {

package/package.json

@@ -1,17 +1,11 @@
 {
   "name": "@liustack/pagepress",
-  "version": "0.3.0",
+  "version": "0.5.0",
   "description": "CLI tool to convert web pages and Markdown to PDF and images",
   "type": "module",
   "bin": {
     "pagepress": "./dist/main.js"
   },
-  "scripts": {
-    "dev": "vite build --watch",
-    "build": "vite build",
-    "typecheck": "tsc --noEmit",
-    "prepublishOnly": "pnpm build"
-  },
   "files": [
     "dist",
     "src/pdf/templates"
@@ -64,5 +58,10 @@
     "typescript": "^5.9.3",
     "vite": "^6.4.1",
     "vite-plugin-node": "^5.0.1"
+  },
+  "scripts": {
+    "dev": "vite build --watch",
+    "build": "vite build",
+    "typecheck": "tsc --noEmit"
   }
-}
+}