chore: release v1.28.1

- Extract detailed workflow to references/workflow.md
- Add Core Styles for quick selection (vector, minimal-flat, sci-fi, hand-drawn, editorial, scene)
- Add vector-illustration as recommended default style
- Add Illustration Purpose (information/visualization/imagination)
- Add default composition, character rendering, text styling to prompts

.claude-plugin/marketplace.json

@@ -6,7 +6,7 @@
   },
   "metadata": {
     "description": "Skills shared by Baoyu for improving daily work efficiency",
-    "version": "1.21.4"
+    "version": "1.28.1"
   },
   "plugins": [
     {
@@ -43,7 +43,9 @@
       "skills": [
         "./skills/baoyu-danger-x-to-markdown",
         "./skills/baoyu-compress-image",
-        "./skills/baoyu-url-to-markdown"
+        "./skills/baoyu-url-to-markdown",
+        "./skills/baoyu-format-markdown",
+        "./skills/baoyu-markdown-to-html"
       ]
     }
   ]

.claude/skills/release-skills/SKILL.md

@@ -114,11 +114,17 @@ Display version change: `1.2.3 → 1.3.0`
 For each detected changelog file:
 
 1. **Identify language** from filename suffix
-2. **Generate content in that language**:
+2. **Detect third-party contributors**:
+   - Check merge commits: `git log ${LAST_TAG}..HEAD --merges --pretty=format:"%H %s"`
+   - For each merged PR, identify the PR author via `gh pr view <number> --json author --jq '.author.login'`
+   - Compare against repo owner (`gh repo view --json owner --jq '.owner.login'`)
+   - If PR author ≠ repo owner → third-party contributor
+3. **Generate content in that language**:
    - Section titles in target language
    - Change descriptions written naturally in target language (not translated)
    - Date format: YYYY-MM-DD (universal)
-3. **Insert at file head** (preserve existing content)
+   - **Third-party contributions**: Append contributor attribution `(by @username)` to the changelog entry
+4. **Insert at file head** (preserve existing content)
 
 **Section Title Translations** (built-in):
 
@@ -138,6 +144,7 @@ For each detected changelog file:
 
 ### Features
 - Description of new feature
+- Description of third-party contribution (by @username)
 
 ### Fixes
 - Description of fix
@@ -148,6 +155,12 @@ For each detected changelog file:
 
 Only include sections that have changes. Omit empty sections.
 
+**Third-Party Attribution Rules**:
+- Only add `(by @username)` for contributors who are NOT the repo owner
+- Use GitHub username with `@` prefix
+- Place at the end of the changelog entry line
+- Apply to all languages consistently (always use `(by @username)` format, not translated)
+
 **Multi-language Example**:
 
 English (CHANGELOG.md):
@@ -155,7 +168,7 @@ English (CHANGELOG.md):
 ## 1.3.0 - 2026-01-22
 
 ### Features
-- Add user authentication module
+- Add user authentication module (by @contributor1)
 - Support OAuth2 login
 
 ### Fixes
@@ -167,7 +180,7 @@ Chinese (CHANGELOG.zh.md):
 ## 1.3.0 - 2026-01-22
 
 ### 新功能
-- 新增用户认证模块
+- 新增用户认证模块 (by @contributor1)
 - 支持 OAuth2 登录
 
 ### 修复
@@ -179,7 +192,7 @@ Japanese (CHANGELOG.ja.md):
 ## 1.3.0 - 2026-01-22
 
 ### 新機能
-- ユーザー認証モジュールを追加
+- ユーザー認証モジュールを追加 (by @contributor1)
 - OAuth2 ログインをサポート
 
 ### 修正

.gitignore

@@ -152,3 +152,10 @@ slide-deck/
 infographic/
 illustrations/
 comic/
+### IntelliJ IDEA ###
+.idea
+*.iws
+*.iml
+*.ipr
+
+.claude/skills/baoyu-skill-evolution

CHANGELOG.md

@@ -2,10 +2,125 @@
 
 English | [中文](./CHANGELOG.zh.md)
 
+## 1.28.1 - 2026-02-02
+
+### Refactor
+- `baoyu-article-illustrator`: simplify main SKILL.md by extracting detailed procedures to `workflow.md`; add Core Styles tier (vector, minimal-flat, sci-fi, hand-drawn, editorial, scene) for quick selection; add `vector-illustration` as recommended default style; add Illustration Purpose (information/visualization/imagination) for better type/style recommendations; add default composition requirements, character rendering guidelines, and text styling rules to prompt construction.
+
+## 1.28.0 - 2026-02-01
+
+### Features
+- `baoyu-cover-image`: add reference image support (`--ref` parameter) with direct/style/palette usage types; add visual elements library with icon vocabulary by topic.
+- `baoyu-article-illustrator`: add reference image support with direct/style/palette usage types.
+- `baoyu-post-to-wechat`: add `newspic` article type for image-text posts.
+
+### Refactor
+- `baoyu-cover-image`, `baoyu-article-illustrator`, `baoyu-comic`, `baoyu-xhs-images`: enforce first-time setup as blocking operation before any other workflow steps.
+- `baoyu-cover-image`: remove character limits from titles, use original source titles.
+
+## 1.26.1 - 2026-01-29
+
+### Features
+- `baoyu-article-illustrator`, `baoyu-comic`, `baoyu-cover-image`, `baoyu-infographic`, `baoyu-slide-deck`, `baoyu-xhs-images`: add backup rules for existing files—automatically renames source, prompt, and image files with timestamp suffix before overwriting.
+
+### Fixes
+- `baoyu-xhs-images`: remove `notebook` style (10 styles remaining).
+
+## 1.26.0 - 2026-01-29
+
+### Features
+- `baoyu-xhs-images`: add `notebook` style (hand-drawn infographic with watercolor rendering and Morandi palette) and `study-notes` style (realistic handwritten photo aesthetic).
+- `baoyu-xhs-images`: add `mindmap` (center radial) and `quadrant` (four-section grid) layouts.
+
+## 1.25.4 - 2026-01-29
+
+### Fixes
+- `baoyu-markdown-to-html`: generate proper `<img>` tags with `data-local-path` attribute instead of text placeholders.
+- `baoyu-post-to-wechat`: fix API publishing to read image paths from `data-local-path` attribute; fix title/cover extraction from corresponding `.md` frontmatter when publishing HTML files.
+- `baoyu-post-to-wechat`: fix CLI argument parsing to handle unknown parameters gracefully; add `--summary` parameter support.
+- `baoyu-post-to-wechat`: fix browser publishing to convert `<img>` tags back to text placeholders before paste.
+
+## 1.25.3 - 2026-01-28
+
+### Features
+- `baoyu-format-markdown`: add content type detection with user confirmation for markdown files; add CJK punctuation handling to move paired punctuation outside emphasis markers.
+
+## 1.25.2 - 2026-01-28
+
+### Documentation
+- `baoyu-post-to-wechat`: add WeChat API credentials configuration guide to README.
+
+## 1.25.1 - 2026-01-28
+
+### Features
+- `baoyu-markdown-to-html`: add pre-check step for CJK content to suggest formatting with `baoyu-format-markdown` before conversion.
+
+## 1.25.0 - 2026-01-28
+
+### Features
+- `baoyu-format-markdown`: add markdown formatter skill with frontmatter, typography, and CJK spacing support.
+- `baoyu-markdown-to-html`: add markdown to HTML converter with WeChat-compatible themes, code highlighting, math, PlantUML, and alerts.
+- `baoyu-post-to-wechat`: add API-based publishing method and external theme support.
+
+## 1.24.4 - 2026-01-28
+
+### Fixes
+- `baoyu-post-to-x`: fix Apply button click for cover image modal; add retry logic and wait for modal close.
+
+## 1.24.3 - 2026-01-28
+
+### Documentation
+- Emphasize updating prompt files before regenerating images in modification workflows (article-illustrator, slide-deck, xhs-images, cover-image, comic).
+
+## 1.24.2 - 2026-01-28
+
+### Refactor
+- `baoyu-image-gen`: default to sequential generation; parallel available on request.
+
+## 1.24.1 - 2026-01-28
+
+### Features
+- `baoyu-image-gen`: add Aliyun Tongyi Wanxiang (DashScope) text-to-image model support (by @JianJang2017).
+
+### Documentation
+- Add Aliyun text-to-image model configuration to README.
+
+## 1.24.0 - 2026-01-27
+
+### Features
+- `baoyu-post-to-wechat`: reuse existing Chrome browser instead of requiring all windows closed (by @AliceLJY).
+
+### Fixes
+- `baoyu-post-to-wechat`: improves title extraction to support h1/h2 headings; adds summary auto-fill and content verification after paste/type; supports flexible HTML meta tag attribute ordering.
+
+### Documentation
+- `release-skills`: adds third-party contributor attribution rules to changelog workflow.
+- Backfills missing third-party contributor attributions across historical changelog entries.
+
+## 1.23.1 - 2026-01-27
+
+### Fixes
+- `baoyu-compress-image`: rename original file as `_original` backup instead of deleting after compression.
+
+## 1.23.0 - 2026-01-26
+
+### Refactor
+- `baoyu-cover-image`: replaces 20 fixed styles with 5-dimension system (Type × Palette × Rendering × Text × Mood). 9 color palettes × 6 rendering styles = 54 combinations. Adds style presets for backward compatibility, v2→v3 schema migration, and new reference structure (`palettes/`, `renderings/`, `workflow/`).
+
+## 1.22.0 - 2026-01-25
+
+### Features
+- `baoyu-article-illustrator`: adds `imgs-subdir` output directory option; improves style selection to always ask and show preferred_style from EXTEND.md.
+- `baoyu-cover-image`: adds `default_output_dir` preference supporting `same-dir`, `imgs-subdir`, and `independent` options with Step 1.5 for output directory selection.
+- `baoyu-post-to-wechat`: adds theme selection (default/grace/simple) with AskUserQuestion before posting; adds HTML preview step; simplifies image placeholders to `WECHATIMGPH_N` format; refactors copy/paste to cross-platform helpers.
+
+### Refactor
+- `baoyu-post-to-x`: simplifies image placeholders from `[[IMAGE_PLACEHOLDER_N]]` to `XIMGPH_N` format.
+
 ## 1.21.4 - 2026-01-25
 
 ### Fixes
-- `baoyu-post-to-wechat`: adds Windows compatibility—uses `fileURLToPath` for correct path resolution, replaces system-dependent copy/paste tools (osascript/xdotool) with CDP keyboard events for cross-platform support.
+- `baoyu-post-to-wechat`: adds Windows compatibility—uses `fileURLToPath` for correct path resolution, replaces system-dependent copy/paste tools (osascript/xdotool) with CDP keyboard events for cross-platform support (by @JadeLiang003).
 - `baoyu-post-to-wechat`: fixes regressions from Windows compatibility PR—corrects broken `-fixed` filename references, restores frontmatter quote stripping, restores `--title` CLI parameter, fixes summary extraction to skip headings/quotes/lists, fixes argument parsing for single-dash flags, removes debug logs.
 - `baoyu-article-illustrator`, `baoyu-cover-image`, `baoyu-xhs-images`: removes opacity option from watermark configuration.
 
@@ -155,7 +270,7 @@ English | [中文](./CHANGELOG.zh.md)
 ## 1.14.0 - 2026-01-22
 
 ### Fixes
-- `baoyu-post-to-x`: improves video ready detection for more reliable video posting.
+- `baoyu-post-to-x`: improves video ready detection for more reliable video posting (by @fkysly).
 
 ### Documentation
 - `baoyu-slide-deck`: comprehensive SKILL.md enhancement—adds slide count guidance (recommended 8-25, max 30), audience guidelines table with audience-specific principles, style selection principles with content-type recommendations, layout selection tips with common mistakes to avoid, visual hierarchy principles, content density guidelines (McKinsey-style high-density principles), color selection guide, typography principles with font recommendations (English and Chinese fonts with multilingual pairing), and visual elements reference (backgrounds, typography treatments, geometric accents).
@@ -170,6 +285,9 @@ English | [中文](./CHANGELOG.zh.md)
 
 ## 1.12.0 - 2026-01-21
 
+### Features
+- `baoyu-post-to-x`: adds quote tweet support (by @threehotpot-bot).
+
 ### Refactor
 - `baoyu-post-to-x`: extracts shared utilities to `x-utils.ts`—consolidates Chrome detection, CDP connection, clipboard operations, and helper functions from `x-article.ts`, `x-browser.ts`, `x-quote.ts`, and `x-video.ts` into a single reusable module.
 
@@ -185,7 +303,7 @@ English | [中文](./CHANGELOG.zh.md)
 ## 1.10.0 - 2026-01-21
 
 ### Features
-- `baoyu-post-to-x`: adds video posting support—new `x-video.ts` script for posting text with video files (MP4, MOV, WebM). Supports preview mode and handles video processing timeouts.
+- `baoyu-post-to-x`: adds video posting support—new `x-video.ts` script for posting text with video files (MP4, MOV, WebM). Supports preview mode and handles video processing timeouts (by @fkysly).
 
 ## 1.9.0 - 2026-01-20
 
@@ -241,7 +359,7 @@ English | [中文](./CHANGELOG.zh.md)
 ## 1.4.1 - 2026-01-18
 
 ### Fixes
-- `baoyu-post-to-x`: supports multi-language UI selectors for X Articles (contributed by [@ianchenx](https://github.com/ianchenx)).
+- `baoyu-post-to-x`: supports multi-language UI selectors for X Articles (by @ianchenx).
 
 ## 1.4.0 - 2026-01-18
 

CHANGELOG.zh.md

@@ -2,10 +2,125 @@
 
 [English](./CHANGELOG.md) | 中文
 
+## 1.28.1 - 2026-02-02
+
+### 重构
+- `baoyu-article-illustrator`：简化主 SKILL.md，将详细步骤提取到 `workflow.md`；新增 Core Styles 快速选择层（vector、minimal-flat、sci-fi、hand-drawn、editorial、scene）；新增 `vector-illustration` 作为推荐默认风格；新增插图目的（information/visualization/imagination）以优化类型/风格推荐；在提示词构建中新增默认构图要求、人物渲染指南和文本样式规则。
+
+## 1.28.0 - 2026-02-01
+
+### 新功能
+- `baoyu-cover-image`：新增参考图片支持（`--ref` 参数），支持 direct/style/palette 三种用法；新增视觉元素库，按主题分类图标词汇。
+- `baoyu-article-illustrator`：新增参考图片支持，支持 direct/style/palette 三种用法。
+- `baoyu-post-to-wechat`：新增 `newspic` 图文消息类型支持。
+
+### 重构
+- `baoyu-cover-image`、`baoyu-article-illustrator`、`baoyu-comic`、`baoyu-xhs-images`：强化首次设置为阻塞操作，必须在其他工作流步骤之前完成。
+- `baoyu-cover-image`：移除标题字符数限制，使用原始来源标题。
+
+## 1.26.1 - 2026-01-29
+
+### 新功能
+- `baoyu-article-illustrator`、`baoyu-comic`、`baoyu-cover-image`、`baoyu-infographic`、`baoyu-slide-deck`、`baoyu-xhs-images`：新增文件备份规则，覆盖前自动将现有源文件、提示词和图片重命名为带时间戳后缀的备份文件。
+
+### 修复
+- `baoyu-xhs-images`：移除 `notebook` 风格（保留 10 种风格）。
+
+## 1.26.0 - 2026-01-29
+
+### 新功能
+- `baoyu-xhs-images`：新增 `notebook` 风格（水彩渲染手绘信息图 + 莫兰迪配色）和 `study-notes` 风格（真实手写照片美学）。
+- `baoyu-xhs-images`：新增 `mindmap`（中心发散式）和 `quadrant`（四象限）布局。
+
+## 1.25.4 - 2026-01-29
+
+### 修复
+- `baoyu-markdown-to-html`：生成带 `data-local-path` 属性的 `<img>` 标签，而非纯文本占位符。
+- `baoyu-post-to-wechat`：修复 API 发布时从 `data-local-path` 属性读取图片路径；修复发布 HTML 文件时从对应 `.md` 的 frontmatter 提取标题和封面图。
+- `baoyu-post-to-wechat`：修复命令行参数解析，正确跳过未知参数；新增 `--summary` 参数支持。
+- `baoyu-post-to-wechat`：修复浏览器发布模式，粘贴前将 `<img>` 标签转换回文本占位符。
+
+## 1.25.3 - 2026-01-28
+
+### 新功能
+- `baoyu-format-markdown`：新增内容类型检测，对已有 markdown 格式的文件提供用户确认选项；新增 CJK 配对标点处理，将括号、引号等标点移出加粗标记外。
+
+## 1.25.2 - 2026-01-28
+
+### 文档
+- `baoyu-post-to-wechat`：README 新增微信公众号 API 凭证配置说明。
+
+## 1.25.1 - 2026-01-28
+
+### 新功能
+- `baoyu-markdown-to-html`：新增中文内容预检查，建议在转换前使用 `baoyu-format-markdown` 格式化以修复加粗标点问题。
+
+## 1.25.0 - 2026-01-28
+
+### 新功能
+- `baoyu-format-markdown`：新增 markdown 格式化技能，支持 frontmatter、排版优化和中英文空格处理。
+- `baoyu-markdown-to-html`：新增 markdown 转 HTML 技能，支持微信兼容主题、代码高亮、数学公式、PlantUML 和 alerts。
+- `baoyu-post-to-wechat`：新增 API 发布方式和外部主题支持。
+
+## 1.24.4 - 2026-01-28
+
+### 修复
+- `baoyu-post-to-x`：修复封面图上传后 Apply 按钮点击问题；增加重试逻辑并等待弹窗关闭后再继续。
+
+## 1.24.3 - 2026-01-28
+
+### 文档
+- 在修改工作流中强调先更新提示词文件再生成图片（article-illustrator、slide-deck、xhs-images、cover-image、comic）。
+
+## 1.24.2 - 2026-01-28
+
+### 重构
+- `baoyu-image-gen`：默认改为顺序生成图片；并行生成需明确请求。
+
+## 1.24.1 - 2026-01-28
+
+### 新功能
+- `baoyu-image-gen`：新增阿里云通义万象（DashScope）文生图模型支持 (by @JianJang2017)。
+
+### 文档
+- README 中新增阿里云文生图模型配置说明。
+
+## 1.24.0 - 2026-01-27
+
+### 新功能
+- `baoyu-post-to-wechat`：复用已打开的 Chrome 浏览器，无需关闭所有窗口 (by @AliceLJY)。
+
+### 修复
+- `baoyu-post-to-wechat`：改进标题提取，支持 h1/h2 标题；新增摘要自动填充和粘贴/输入后内容验证；支持 HTML meta 标签属性顺序灵活匹配。
+
+### 文档
+- `release-skills`：在发布流程中新增第三方贡献者署名规则。
+- 补全历史 changelog 中缺失的第三方贡献者署名。
+
+## 1.23.1 - 2026-01-27
+
+### 修复
+- `baoyu-compress-image`：压缩后将原始文件重命名为 `_original` 备份，不再删除。
+
+## 1.23.0 - 2026-01-26
+
+### 重构
+- `baoyu-cover-image`：将 20 种固定风格替换为五维系统（类型 × 配色 × 渲染 × 文字 × 氛围）。9 种配色方案 × 6 种渲染风格 = 54 种组合。新增风格预设实现向后兼容，v2→v3 配置迁移，以及新的引用文件结构（`palettes/`、`renderings/`、`workflow/`）。
+
+## 1.22.0 - 2026-01-25
+
+### 新功能
+- `baoyu-article-illustrator`：新增 `imgs-subdir` 输出目录选项；改进风格选择，始终询问并展示 EXTEND.md 中的 preferred_style。
+- `baoyu-cover-image`：新增 `default_output_dir` 偏好设置，支持 `same-dir`、`imgs-subdir` 和 `independent` 选项，新增 Step 1.5 输出目录选择流程。
+- `baoyu-post-to-wechat`：发布前新增主题选择（default/grace/simple）；新增 HTML 预览步骤；图片占位符简化为 `WECHATIMGPH_N` 格式；重构复制粘贴为跨平台辅助函数。
+
+### 重构
+- `baoyu-post-to-x`：图片占位符从 `[[IMAGE_PLACEHOLDER_N]]` 简化为 `XIMGPH_N` 格式。
+
 ## 1.21.4 - 2026-01-25
 
 ### 修复
-- `baoyu-post-to-wechat`：新增 Windows 兼容性——使用 `fileURLToPath` 正确解析路径，将系统依赖的复制粘贴工具（osascript/xdotool）替换为 CDP 键盘事件，实现跨平台支持。
+- `baoyu-post-to-wechat`：新增 Windows 兼容性——使用 `fileURLToPath` 正确解析路径，将系统依赖的复制粘贴工具（osascript/xdotool）替换为 CDP 键盘事件，实现跨平台支持 (by @JadeLiang003)。
 - `baoyu-post-to-wechat`：修复 Windows 兼容性 PR 引入的回退问题——修正错误的 `-fixed` 文件名引用、恢复 frontmatter 引号剥离、恢复 `--title` CLI 参数、修复摘要提取逻辑以正确跳过标题/引用/列表、修复单横线参数解析、移除调试日志。
 - `baoyu-article-illustrator`、`baoyu-cover-image`、`baoyu-xhs-images`：移除水印配置中的透明度选项。
 
@@ -155,7 +270,7 @@
 ## 1.14.0 - 2026-01-22
 
 ### 修复
-- `baoyu-post-to-x`：改进视频就绪检测，提升视频发布稳定性。
+- `baoyu-post-to-x`：改进视频就绪检测，提升视频发布稳定性 (by @fkysly)。
 
 ### 文档
 - `baoyu-slide-deck`：SKILL.md 全面增强——新增幻灯片数量指南（推荐 8-25 张，最多 30 张）、受众指南表格及各受众特定原则、风格选择原则与内容类型推荐、布局选择技巧与常见错误提示、视觉层次原则、内容密度指南（麦肯锡风格高密度原则）、配色选择指南、字体排版原则与字体推荐（中英文字体及多语言搭配方案）、视觉元素参考（背景处理、字体处理、几何装饰）。
@@ -170,6 +285,9 @@
 
 ## 1.12.0 - 2026-01-21
 
+### 新功能
+- `baoyu-post-to-x`：新增引用推文（Quote Tweet）支持 (by @threehotpot-bot)。
+
 ### 重构
 - `baoyu-post-to-x`：提取公共工具函数到 `x-utils.ts`——将 `x-article.ts`、`x-browser.ts`、`x-quote.ts`、`x-video.ts` 中重复的 Chrome 检测、CDP 连接、剪贴板操作等功能整合为统一的可复用模块。
 
@@ -185,7 +303,7 @@
 ## 1.10.0 - 2026-01-21
 
 ### 新功能
-- `baoyu-post-to-x`：新增视频发布支持——新增 `x-video.ts` 脚本，支持发布带视频的推文（MP4、MOV、WebM 格式）。支持预览模式，自动处理视频上传等待。
+- `baoyu-post-to-x`：新增视频发布支持——新增 `x-video.ts` 脚本，支持发布带视频的推文（MP4、MOV、WebM 格式）。支持预览模式，自动处理视频上传等待 (by @fkysly)。
 
 ## 1.9.0 - 2026-01-20
 
@@ -241,7 +359,7 @@
 ## 1.4.1 - 2026-01-18
 
 ### 修复
-- `baoyu-post-to-x`：支持 X Articles 多语言 UI 选择器（感谢 [@ianchenx](https://github.com/ianchenx) 贡献）。
+- `baoyu-post-to-x`：支持 X Articles 多语言 UI 选择器 (by @ianchenx)。
 
 ## 1.4.0 - 2026-01-18
 

README.md

@@ -55,7 +55,7 @@ Simply tell Claude Code:
 |--------|-------------|--------|
 | **content-skills** | Content generation and publishing | [xhs-images](#baoyu-xhs-images), [infographic](#baoyu-infographic), [cover-image](#baoyu-cover-image), [slide-deck](#baoyu-slide-deck), [comic](#baoyu-comic), [article-illustrator](#baoyu-article-illustrator), [post-to-x](#baoyu-post-to-x), [post-to-wechat](#baoyu-post-to-wechat) |
 | **ai-generation-skills** | AI-powered generation backends | [image-gen](#baoyu-image-gen), [danger-gemini-web](#baoyu-danger-gemini-web) |
-| **utility-skills** | Utility tools for content processing | [url-to-markdown](#baoyu-url-to-markdown), [danger-x-to-markdown](#baoyu-danger-x-to-markdown), [compress-image](#baoyu-compress-image) |
+| **utility-skills** | Utility tools for content processing | [url-to-markdown](#baoyu-url-to-markdown), [danger-x-to-markdown](#baoyu-danger-x-to-markdown), [compress-image](#baoyu-compress-image), [format-markdown](#baoyu-format-markdown) |
 
 ## Update Skills
 
@@ -245,7 +245,7 @@ Generate professional infographics with 20 layout types and 17 visual styles. An
 
 #### baoyu-cover-image
 
-Generate cover images for articles with 4 dimensions: Type × Style × Text × Mood.
+Generate cover images for articles with 5 dimensions: Type × Palette × Rendering × Text × Mood. Combines 9 color palettes with 6 rendering styles for 54 unique combinations.
 
 ```bash
 # Auto-select all dimensions based on content
@@ -254,44 +254,27 @@ Generate cover images for articles with 4 dimensions: Type × Style × Text × M
 # Quick mode: skip confirmation, use auto-selection
 /baoyu-cover-image path/to/article.md --quick
 
-# Specify dimensions
-/baoyu-cover-image path/to/article.md --type conceptual --style blueprint
+# Specify dimensions (5D system)
+/baoyu-cover-image path/to/article.md --type conceptual --palette cool --rendering digital
 /baoyu-cover-image path/to/article.md --text title-subtitle --mood bold
 
-# Specify aspect ratio (default: 2.35:1)
-/baoyu-cover-image path/to/article.md --aspect 16:9
+# Style presets (backward-compatible shorthand)
+/baoyu-cover-image path/to/article.md --style blueprint
+
+# Specify aspect ratio (default: 16:9)
+/baoyu-cover-image path/to/article.md --aspect 2.35:1
 
 # Visual only (no title text)
 /baoyu-cover-image path/to/article.md --no-title
 ```
 
-**Four Dimensions**:
+**Five Dimensions**:
 - **Type**: `hero`, `conceptual`, `typography`, `metaphor`, `scene`, `minimal`
-- **Style**: 20 built-in styles (see previews below)
+- **Palette**: `warm`, `elegant`, `cool`, `dark`, `earth`, `vivid`, `pastel`, `mono`, `retro`
+- **Rendering**: `flat-vector`, `hand-drawn`, `painterly`, `digital`, `pixel`, `chalk`
 - **Text**: `none`, `title-only` (default), `title-subtitle`, `text-rich`
 - **Mood**: `subtle`, `balanced` (default), `bold`
 
-Available styles: `elegant` (default), `blueprint`, `bold-editorial`, `chalkboard`, `dark-atmospheric`, `editorial-infographic`, `fantasy-animation`, `flat-doodle`, `intuition-machine`, `minimal`, `nature`, `notion`, `pixel-art`, `playful`, `retro`, `sketch-notes`, `vector-illustration`, `vintage`, `warm`, `watercolor`
-
-**Style Previews**:
-
-| | | |
-|:---:|:---:|:---:|
-| ![elegant](./screenshots/cover-image-styles/elegant.webp) | ![blueprint](./screenshots/cover-image-styles/blueprint.webp) | ![bold-editorial](./screenshots/cover-image-styles/bold-editorial.webp) |
-| elegant | blueprint | bold-editorial |
-| ![chalkboard](./screenshots/cover-image-styles/chalkboard.webp) | ![dark-atmospheric](./screenshots/cover-image-styles/dark-atmospheric.webp) | ![editorial-infographic](./screenshots/cover-image-styles/editorial-infographic.webp) |
-| chalkboard | dark-atmospheric | editorial-infographic |
-| ![fantasy-animation](./screenshots/cover-image-styles/fantasy-animation.webp) | ![intuition-machine](./screenshots/cover-image-styles/intuition-machine.webp) | ![minimal](./screenshots/cover-image-styles/minimal.webp) |
-| fantasy-animation | intuition-machine | minimal |
-| ![nature](./screenshots/cover-image-styles/nature.webp) | ![notion](./screenshots/cover-image-styles/notion.webp) | ![pixel-art](./screenshots/cover-image-styles/pixel-art.webp) |
-| nature | notion | pixel-art |
-| ![playful](./screenshots/cover-image-styles/playful.webp) | ![retro](./screenshots/cover-image-styles/retro.webp) | ![sketch-notes](./screenshots/cover-image-styles/sketch-notes.webp) |
-| playful | retro | sketch-notes |
-| ![vector-illustration](./screenshots/cover-image-styles/vector-illustration.webp) | ![vintage](./screenshots/cover-image-styles/vintage.webp) | ![warm](./screenshots/cover-image-styles/warm.webp) |
-| vector-illustration | vintage | warm |
-| ![watercolor](./screenshots/cover-image-styles/watercolor.webp) | ![flat-doodle](./screenshots/cover-image-styles/flat-doodle.webp) | |
-| watercolor | flat-doodle | |
-
 #### baoyu-slide-deck
 
 Generate professional slide deck images from content. Creates comprehensive outlines with style instructions, then generates individual slide images.
@@ -552,7 +535,28 @@ Post content to WeChat Official Account (微信公众号). Two modes available:
 /baoyu-post-to-wechat 文章 --html article.html
 ```
 
-Prerequisites: Google Chrome installed. First run requires QR code login (session preserved).
+**Publishing Methods**:
+
+| Method | Speed | Requirements |
+|--------|-------|--------------|
+| API (Recommended) | Fast | API credentials |
+| Browser | Slow | Chrome, login session |
+
+**API Configuration** (for faster publishing):
+
+```bash
+# Add to .baoyu-skills/.env (project-level) or ~/.baoyu-skills/.env (user-level)
+WECHAT_APP_ID=your_app_id
+WECHAT_APP_SECRET=your_app_secret
+```
+
+To obtain credentials:
+1. Visit https://developers.weixin.qq.com/platform/
+2. Go to: 我的业务 → 公众号 → 开发密钥
+3. Create development key and copy AppID/AppSecret
+4. Add your machine's IP to the whitelist
+
+**Browser Method** (no API setup needed): Requires Google Chrome. First run opens browser for QR code login (session preserved).
 
 ### AI Generation Skills
 
@@ -560,7 +564,7 @@ AI-powered generation backends.
 
 #### baoyu-image-gen
 
-AI SDK-based image generation using official OpenAI and Google APIs. Supports text-to-image, reference images, aspect ratios, and quality presets.
+AI SDK-based image generation using official OpenAI, Google and DashScope (Aliyun Tongyi Wanxiang) APIs. Supports text-to-image, reference images, aspect ratios, and quality presets.
 
 ```bash
 # Basic generation (auto-detect provider)
@@ -575,6 +579,9 @@ AI SDK-based image generation using official OpenAI and Google APIs. Supports te
 # Specific provider
 /baoyu-image-gen --prompt "A cat" --image cat.png --provider openai
 
+# DashScope (Aliyun Tongyi Wanxiang)
+/baoyu-image-gen --prompt "一只可爱的猫" --image cat.png --provider dashscope
+
 # With reference images (Google multimodal only)
 /baoyu-image-gen --prompt "Make it blue" --image out.png --ref source.png
 ```
@@ -585,7 +592,7 @@ AI SDK-based image generation using official OpenAI and Google APIs. Supports te
 | `--prompt`, `-p` | Prompt text |
 | `--promptfiles` | Read prompt from files (concatenated) |
 | `--image` | Output image path (required) |
-| `--provider` | `google` or `openai` (default: google) |
+| `--provider` | `google`, `openai` or `dashscope` (default: google) |
 | `--model`, `-m` | Model ID |
 | `--ar` | Aspect ratio (e.g., `16:9`, `1:1`, `4:3`) |
 | `--size` | Size (e.g., `1024x1024`) |
@@ -597,15 +604,18 @@ AI SDK-based image generation using official OpenAI and Google APIs. Supports te
 |----------|-------------|---------|
 | `OPENAI_API_KEY` | OpenAI API key | - |
 | `GOOGLE_API_KEY` | Google API key | - |
+| `DASHSCOPE_API_KEY` | DashScope API key (Aliyun) | - |
 | `OPENAI_IMAGE_MODEL` | OpenAI model | `gpt-image-1.5` |
 | `GOOGLE_IMAGE_MODEL` | Google model | `gemini-3-pro-image-preview` |
+| `DASHSCOPE_IMAGE_MODEL` | DashScope model | `z-image-turbo` |
 | `OPENAI_BASE_URL` | Custom OpenAI endpoint | - |
 | `GOOGLE_BASE_URL` | Custom Google endpoint | - |
+| `DASHSCOPE_BASE_URL` | Custom DashScope endpoint | - |
 
 **Provider Auto-Selection**:
 1. If `--provider` specified → use it
 2. If only one API key available → use that provider
-3. If both available → default to Google
+3. If multiple available → default to Google
 
 #### baoyu-danger-gemini-web
 
@@ -689,6 +699,43 @@ Compress images to reduce file size while maintaining quality.
 /baoyu-compress-image path/to/images/ --quality 80
 ```
 
+#### baoyu-format-markdown
+
+Format plain text or markdown files with proper frontmatter, titles, summaries, headings, bold, lists, and code blocks.
+
+```bash
+# Format a markdown file
+/baoyu-format-markdown path/to/article.md
+
+# Format with specific output
+/baoyu-format-markdown path/to/draft.md
+```
+
+**Workflow**:
+1. Read source file and analyze content structure
+2. Check/create YAML frontmatter (title, slug, summary, featureImage)
+3. Handle title: use existing, extract from H1, or generate candidates
+4. Apply formatting: headings, bold, lists, code blocks, quotes
+5. Save to `{filename}-formatted.md`
+6. Run typography script: ASCII→fullwidth quotes, CJK spacing, autocorrect
+
+**Frontmatter Fields**:
+| Field | Processing |
+|-------|------------|
+| `title` | Use existing, extract H1, or generate candidates |
+| `slug` | Infer from file path or generate from title |
+| `summary` | Generate engaging summary (100-150 chars) |
+| `featureImage` | Check for `imgs/cover.png` in same directory |
+
+**Formatting Rules**:
+| Element | Format |
+|---------|--------|
+| Titles | `#`, `##`, `###` hierarchy |
+| Key points | `**bold**` |
+| Parallel items | `-` unordered or `1.` ordered lists |
+| Code/commands | `` `inline` `` or ` ```block``` ` |
+| Quotes | `>` blockquote |
+
 ## Environment Configuration
 
 Some skills require API keys or custom configuration. Environment variables can be set in `.env` files:
@@ -716,6 +763,11 @@ OPENAI_IMAGE_MODEL=gpt-image-1.5
 GOOGLE_API_KEY=xxx
 GOOGLE_IMAGE_MODEL=gemini-3-pro-image-preview
 # GOOGLE_BASE_URL=https://generativelanguage.googleapis.com/v1beta
+
+# DashScope (Aliyun Tongyi Wanxiang)
+DASHSCOPE_API_KEY=sk-xxx
+DASHSCOPE_IMAGE_MODEL=z-image-turbo
+# DASHSCOPE_BASE_URL=https://dashscope.aliyuncs.com/api/v1
 EOF
 ```
 
@@ -744,13 +796,14 @@ mkdir -p .baoyu-skills/baoyu-cover-image
 Then create `.baoyu-skills/baoyu-cover-image/EXTEND.md`:
 
 ```markdown
-## Custom Styles
+## Custom Palettes
 
-### brand
-- Primary color: #1a73e8
-- Secondary color: #34a853
-- Font style: Modern sans-serif
-- Always include company logo watermark
+### corporate-tech
+- Primary colors: #1a73e8, #4A90D9
+- Background: #F5F7FA
+- Accent colors: #00B4D8, #48CAE4
+- Decorative hints: Clean lines, subtle gradients
+- Best for: SaaS, enterprise, technical
 ```
 
 The extension content will be loaded before skill execution and override defaults.

README.zh.md

@@ -55,7 +55,7 @@ npx skills add jimliu/baoyu-skills
 |------|------|----------|
 | **content-skills** | 内容生成和发布 | [xhs-images](#baoyu-xhs-images), [infographic](#baoyu-infographic), [cover-image](#baoyu-cover-image), [slide-deck](#baoyu-slide-deck), [comic](#baoyu-comic), [article-illustrator](#baoyu-article-illustrator), [post-to-x](#baoyu-post-to-x), [post-to-wechat](#baoyu-post-to-wechat) |
 | **ai-generation-skills** | AI 生成后端 | [image-gen](#baoyu-image-gen), [danger-gemini-web](#baoyu-danger-gemini-web) |
-| **utility-skills** | 内容处理工具 | [url-to-markdown](#baoyu-url-to-markdown), [danger-x-to-markdown](#baoyu-danger-x-to-markdown), [compress-image](#baoyu-compress-image) |
+| **utility-skills** | 内容处理工具 | [url-to-markdown](#baoyu-url-to-markdown), [danger-x-to-markdown](#baoyu-danger-x-to-markdown), [compress-image](#baoyu-compress-image), [format-markdown](#baoyu-format-markdown) |
 
 ## 更新技能
 
@@ -245,7 +245,7 @@ npx skills add jimliu/baoyu-skills
 
 #### baoyu-cover-image
 
-为文章生成封面图，支持四维定制系统：类型 × 风格 × 文字 × 氛围。
+为文章生成封面图，支持五维定制系统：类型 × 配色 × 渲染 × 文字 × 氛围。9 种配色方案与 6 种渲染风格组合，提供 54 种独特效果。
 
 ```bash
 # 根据内容自动选择所有维度
@@ -254,44 +254,27 @@ npx skills add jimliu/baoyu-skills
 # 快速模式：跳过确认，使用自动选择
 /baoyu-cover-image path/to/article.md --quick
 
-# 指定维度
-/baoyu-cover-image path/to/article.md --type conceptual --style blueprint
+# 指定维度（5D 系统）
+/baoyu-cover-image path/to/article.md --type conceptual --palette cool --rendering digital
 /baoyu-cover-image path/to/article.md --text title-subtitle --mood bold
 
-# 指定宽高比（默认：2.35:1）
-/baoyu-cover-image path/to/article.md --aspect 16:9
+# 风格预设（向后兼容的简写方式）
+/baoyu-cover-image path/to/article.md --style blueprint
+
+# 指定宽高比（默认：16:9）
+/baoyu-cover-image path/to/article.md --aspect 2.35:1
 
 # 纯视觉（不含标题文字）
 /baoyu-cover-image path/to/article.md --no-title
 ```
 
-**四个维度**：
+**五个维度**：
 - **类型 (Type)**：`hero`、`conceptual`、`typography`、`metaphor`、`scene`、`minimal`
-- **风格 (Style)**：20 种内置风格（见下方预览）
+- **配色 (Palette)**：`warm`、`elegant`、`cool`、`dark`、`earth`、`vivid`、`pastel`、`mono`、`retro`
+- **渲染 (Rendering)**：`flat-vector`、`hand-drawn`、`painterly`、`digital`、`pixel`、`chalk`
 - **文字 (Text)**：`none`、`title-only`（默认）、`title-subtitle`、`text-rich`
 - **氛围 (Mood)**：`subtle`、`balanced`（默认）、`bold`
 
-可用风格：`elegant`（默认）、`blueprint`、`bold-editorial`、`chalkboard`、`dark-atmospheric`、`editorial-infographic`、`fantasy-animation`、`flat-doodle`、`intuition-machine`、`minimal`、`nature`、`notion`、`pixel-art`、`playful`、`retro`、`sketch-notes`、`vector-illustration`、`vintage`、`warm`、`watercolor`
-
-**风格预览**：
-
-| | | |
-|:---:|:---:|:---:|
-| ![elegant](./screenshots/cover-image-styles/elegant.webp) | ![blueprint](./screenshots/cover-image-styles/blueprint.webp) | ![bold-editorial](./screenshots/cover-image-styles/bold-editorial.webp) |
-| elegant | blueprint | bold-editorial |
-| ![chalkboard](./screenshots/cover-image-styles/chalkboard.webp) | ![dark-atmospheric](./screenshots/cover-image-styles/dark-atmospheric.webp) | ![editorial-infographic](./screenshots/cover-image-styles/editorial-infographic.webp) |
-| chalkboard | dark-atmospheric | editorial-infographic |
-| ![fantasy-animation](./screenshots/cover-image-styles/fantasy-animation.webp) | ![intuition-machine](./screenshots/cover-image-styles/intuition-machine.webp) | ![minimal](./screenshots/cover-image-styles/minimal.webp) |
-| fantasy-animation | intuition-machine | minimal |
-| ![nature](./screenshots/cover-image-styles/nature.webp) | ![notion](./screenshots/cover-image-styles/notion.webp) | ![pixel-art](./screenshots/cover-image-styles/pixel-art.webp) |
-| nature | notion | pixel-art |
-| ![playful](./screenshots/cover-image-styles/playful.webp) | ![retro](./screenshots/cover-image-styles/retro.webp) | ![sketch-notes](./screenshots/cover-image-styles/sketch-notes.webp) |
-| playful | retro | sketch-notes |
-| ![vector-illustration](./screenshots/cover-image-styles/vector-illustration.webp) | ![vintage](./screenshots/cover-image-styles/vintage.webp) | ![warm](./screenshots/cover-image-styles/warm.webp) |
-| vector-illustration | vintage | warm |
-| ![watercolor](./screenshots/cover-image-styles/watercolor.webp) | ![flat-doodle](./screenshots/cover-image-styles/flat-doodle.webp) | |
-| watercolor | flat-doodle | |
-
 #### baoyu-slide-deck
 
 从内容生成专业的幻灯片图片。先创建包含样式说明的完整大纲，然后逐页生成幻灯片图片。
@@ -552,7 +535,28 @@ npx skills add jimliu/baoyu-skills
 /baoyu-post-to-wechat 文章 --html article.html
 ```
 
-前置要求：已安装 Google Chrome，首次运行需扫码登录（登录状态会保存）
+**发布方式**：
+
+| 方式 | 速度 | 要求 |
+|------|------|------|
+| API（推荐） | 快 | API 凭证 |
+| 浏览器 | 慢 | Chrome，登录会话 |
+
+**API 配置**（更快的发布方式）：
+
+```bash
+# 添加到 .baoyu-skills/.env（项目级）或 ~/.baoyu-skills/.env（用户级）
+WECHAT_APP_ID=你的AppID
+WECHAT_APP_SECRET=你的AppSecret
+```
+
+获取凭证方法：
+1. 访问 https://developers.weixin.qq.com/platform/
+2. 进入：我的业务 → 公众号 → 开发密钥
+3. 添加开发密钥，复制 AppID 和 AppSecret
+4. 将你操作的机器 IP 加入白名单
+
+**浏览器方式**（无需 API 配置）：需已安装 Google Chrome，首次运行需扫码登录（登录状态会保存）
 
 ### AI 生成技能 (AI Generation Skills)
 
@@ -560,7 +564,7 @@ AI 驱动的生成后端。
 
 #### baoyu-image-gen
 
-基于 AI SDK 的图像生成，使用官方 OpenAI 和 Google API。支持文生图、参考图、宽高比和质量预设。
+基于 AI SDK 的图像生成，使用官方 OpenAI、Google 和 DashScope（阿里通义万相）API。支持文生图、参考图、宽高比和质量预设。
 
 ```bash
 # 基础生成（自动检测服务商）
@@ -575,6 +579,9 @@ AI 驱动的生成后端。
 # 指定服务商
 /baoyu-image-gen --prompt "一只猫" --image cat.png --provider openai
 
+# DashScope（阿里通义万相）
+/baoyu-image-gen --prompt "一只可爱的猫" --image cat.png --provider dashscope
+
 # 带参考图（仅 Google 多模态支持）
 /baoyu-image-gen --prompt "把它变成蓝色" --image out.png --ref source.png
 ```
@@ -585,7 +592,7 @@ AI 驱动的生成后端。
 | `--prompt`, `-p` | 提示词文本 |
 | `--promptfiles` | 从文件读取提示词（多文件拼接） |
 | `--image` | 输出图片路径（必需） |
-| `--provider` | `google` 或 `openai`（默认：google） |
+| `--provider` | `google`、`openai` 或 `dashscope`（默认：google） |
 | `--model`, `-m` | 模型 ID |
 | `--ar` | 宽高比（如 `16:9`、`1:1`、`4:3`） |
 | `--size` | 尺寸（如 `1024x1024`） |
@@ -597,15 +604,18 @@ AI 驱动的生成后端。
 |------|------|--------|
 | `OPENAI_API_KEY` | OpenAI API 密钥 | - |
 | `GOOGLE_API_KEY` | Google API 密钥 | - |
+| `DASHSCOPE_API_KEY` | DashScope API 密钥（阿里云） | - |
 | `OPENAI_IMAGE_MODEL` | OpenAI 模型 | `gpt-image-1.5` |
 | `GOOGLE_IMAGE_MODEL` | Google 模型 | `gemini-3-pro-image-preview` |
+| `DASHSCOPE_IMAGE_MODEL` | DashScope 模型 | `z-image-turbo` |
 | `OPENAI_BASE_URL` | 自定义 OpenAI 端点 | - |
 | `GOOGLE_BASE_URL` | 自定义 Google 端点 | - |
+| `DASHSCOPE_BASE_URL` | 自定义 DashScope 端点 | - |
 
 **服务商自动选择**：
 1. 如果指定了 `--provider` → 使用指定的
 2. 如果只有一个 API 密钥 → 使用对应服务商
-3. 如果两个都有 → 默认使用 Google
+3. 如果多个可用 → 默认使用 Google
 
 #### baoyu-danger-gemini-web
 
@@ -689,6 +699,43 @@ AI 驱动的生成后端。
 /baoyu-compress-image path/to/images/ --quality 80
 ```
 
+#### baoyu-format-markdown
+
+格式化纯文本或 Markdown 文件，添加 frontmatter、标题、摘要、层级标题、加粗、列表和代码块。
+
+```bash
+# 格式化 markdown 文件
+/baoyu-format-markdown path/to/article.md
+
+# 格式化指定文件
+/baoyu-format-markdown path/to/draft.md
+```
+
+**工作流程**：
+1. 读取源文件并分析内容结构
+2. 检查/创建 YAML frontmatter（title、slug、summary、featureImage）
+3. 处理标题：使用现有标题、提取 H1 或生成候选标题
+4. 应用格式：层级标题、加粗、列表、代码块、引用
+5. 保存为 `{文件名}-formatted.md`
+6. 运行排版脚本：半角引号→全角引号、中英文空格、autocorrect
+
+**Frontmatter 字段**：
+| 字段 | 处理方式 |
+|------|----------|
+| `title` | 使用现有、提取 H1 或生成候选 |
+| `slug` | 从文件路径推断或根据标题生成 |
+| `summary` | 生成吸引人的摘要（100-150 字） |
+| `featureImage` | 检查同目录下 `imgs/cover.png` |
+
+**格式化规则**：
+| 元素 | 格式 |
+|------|------|
+| 标题 | `#`、`##`、`###` 层级 |
+| 重点内容 | `**加粗**` |
+| 并列要点 | `-` 无序列表或 `1.` 有序列表 |
+| 代码/命令 | `` `行内` `` 或 ` ```代码块``` ` |
+| 引用 | `>` 引用块 |
+
 ## 环境配置
 
 部分技能需要 API 密钥或自定义配置。环境变量可以在 `.env` 文件中设置：
@@ -716,6 +763,11 @@ OPENAI_IMAGE_MODEL=gpt-image-1.5
 GOOGLE_API_KEY=xxx
 GOOGLE_IMAGE_MODEL=gemini-3-pro-image-preview
 # GOOGLE_BASE_URL=https://generativelanguage.googleapis.com/v1beta
+
+# DashScope（阿里通义万相）
+DASHSCOPE_API_KEY=sk-xxx
+DASHSCOPE_IMAGE_MODEL=z-image-turbo
+# DASHSCOPE_BASE_URL=https://dashscope.aliyuncs.com/api/v1
 EOF
 ```
 
@@ -744,13 +796,14 @@ mkdir -p .baoyu-skills/baoyu-cover-image
 然后创建 `.baoyu-skills/baoyu-cover-image/EXTEND.md`：
 
 ```markdown
-## 自定义风格
+## 自定义配色
 
-### brand
-- 主色：#1a73e8
-- 辅色：#34a853
-- 字体风格：现代无衬线
-- 始终包含公司 logo 水印
+### corporate-tech
+- 主色：#1a73e8、#4A90D9
+- 背景色：#F5F7FA
+- 强调色：#00B4D8、#48CAE4
+- 装饰提示：简洁线条、渐变效果
+- 适用于：SaaS、企业、技术内容
 ```
 
 扩展内容会在技能执行前加载，并覆盖默认设置。

skills/baoyu-article-illustrator/SKILL.md

@@ -16,6 +16,16 @@ Analyze articles, identify illustration positions, generate images with Type ×
 
 Type × Style can be freely combined. Example: `--type infographic --style blueprint`
 
+## Illustration Purpose
+
+Auto-detected during content analysis. Influences type/style recommendations.
+
+| Purpose | Description | Best Types |
+|---------|-------------|------------|
+| **information** | Help understand abstract concepts | infographic, flowchart, comparison |
+| **visualization** | Turn abstract ideas into concrete visuals | framework, comparison, infographic |
+| **imagination** | Create atmosphere, spark imagination | scene, timeline |
+
 ## Type Gallery
 
 | Type | Best For |
@@ -27,90 +37,37 @@ Type × Style can be freely combined. Example: `--type infographic --style bluep
 | `framework` | Methodologies, models, architecture |
 | `timeline` | History, progress, evolution |
 
-## Style Gallery
+## Styles
 
-| Style | Best For |
-|-------|----------|
-| `notion` (Default) | Knowledge sharing, SaaS, productivity |
-| `elegant` | Business, thought leadership |
-| `warm` | Personal growth, lifestyle, education |
-| `minimal` | Philosophy, core concepts |
-| `blueprint` | Architecture, system design |
-| `watercolor` | Lifestyle, travel, creative |
-| `editorial` | Tech explainers, journalism |
-| `scientific` | Academic, technical research |
-
-Full styles: [references/styles.md](references/styles.md)
-
-## Auto Selection
-
-| Content Signals | Type | Style |
-|-----------------|------|-------|
-| API, metrics, data, numbers | infographic | blueprint, notion |
-| Story, emotion, journey | scene | warm, watercolor |
-| How-to, steps, workflow | flowchart | notion, minimal |
-| vs, pros/cons, before/after | comparison | notion, elegant |
-| Framework, model, architecture | framework | blueprint, notion |
-| History, timeline, progress | timeline | elegant, warm |
+See [references/styles.md](references/styles.md) for:
+- **Core Styles**: Simplified tier for quick selection (vector, minimal-flat, sci-fi, hand-drawn, editorial, scene)
+- **Style Gallery**: Full 20+ style options with descriptions
+- **Auto Selection**: Content signals → Type/Style recommendations
+- **Compatibility Matrix**: Type × Style combinations
 
 ## Workflow
 
-Copy this checklist and track progress:
-
 ```
 Progress:
 - [ ] Step 1: Pre-check
+  - [ ] 1.5 Load preferences (EXTEND.md) ⛔ BLOCKING
+  - [ ] 1.0 Reference images ⚠️ (if provided)
+  - [ ] 1.2-1.4 Config questions (1 AskUserQuestion, max 4 Qs)
 - [ ] Step 2: Setup & Analyze
-- [ ] Step 3: Confirm Settings ⚠️ REQUIRED
+- [ ] Step 3: Confirm Settings (1 AskUserQuestion, max 4 Qs)
+  - [ ] Q1: Type ⚠️
+  - [ ] Q2: Density ⚠️ MUST ASK
+  - [ ] Q3: Style ⚠️
 - [ ] Step 4: Generate Outline
 - [ ] Step 5: Generate Images
 - [ ] Step 6: Finalize
 ```
 
----
-
 ### Step 1: Pre-check
 
-**1.1 Determine Input Type**
+**1.5 Load Preferences (EXTEND.md) ⛔ BLOCKING**
 
-| Input | Output Directory | Next |
-|-------|------------------|------|
-| File path | Ask user (1.2) | → 1.2 |
-| Pasted content | `illustrations/{topic-slug}/` | → 1.4 |
-
-**1.2 Determine Output Directory** (file path input only)
-
-Check `default_output_dir` in preferences:
-
-| Preference Value | Action |
-|------------------|--------|
-| `same-dir` | Use `{article-dir}/`, display "Output: {path}" |
-| `illustrations-subdir` | Use `{article-dir}/illustrations/`, display "Output: {path}" |
-| `independent` | Use `illustrations/{topic-slug}/`, display "Output: {path}" |
-| Not configured | **MUST** ask with AskUserQuestion ↓ |
-
-**AskUserQuestion** (when no preference):
-- `{article-dir}/` - Same directory as article
-- `{article-dir}/illustrations/` - Illustrations subdirectory (Recommended)
-- `illustrations/{topic-slug}/` - Independent directory
-- Save as default - Remember this choice for future runs
-
-**1.3 Check Existing Images**
-
-Scan target directory for `.png/.jpg/.webp` files.
-
-If images exist → AskUserQuestion: How to handle?
-- `supplement` - Keep existing, generate only new positions
-- `overwrite` - Overwrite same-name files
-- `regenerate` - Clear all and regenerate
-
-**1.4 Confirm Article Update Method** (file path input only)
-
-AskUserQuestion: How to update article?
-- `update` - Modify original file directly
-- `copy` - Create `{name}-illustrated.md` copy
-
-**1.5 Load Preferences (EXTEND.md)**
+**CRITICAL**: If EXTEND.md not found, MUST complete first-time setup before ANY other steps.
 
 ```bash
 test -f .baoyu-skills/baoyu-article-illustrator/EXTEND.md && echo "project"
@@ -119,155 +76,86 @@ test -f "$HOME/.baoyu-skills/baoyu-article-illustrator/EXTEND.md" && echo "user"
 
 | Result | Action |
 |--------|--------|
-| Found | Read, parse, display summary |
-| Not found | Ask with AskUserQuestion (see references/config/first-time-setup.md) |
+| Found | Read, parse, display summary → Continue |
+| Not found | ⛔ Run first-time setup ([references/config/first-time-setup.md](references/config/first-time-setup.md)) |
 
 **Supports**: Watermark | Preferred type/style | Custom styles | Language | Output directory
 
+**1.0-1.4**: Handle reference images, determine input type, ask config questions.
+
+Full procedures: [references/workflow.md](references/workflow.md#step-1-pre-check)
+
 ---
 
 ### Step 2: Setup & Analyze
 
-**2.1 Analyze Content**
-
 | Analysis | Description |
 |----------|-------------|
 | Content type | Technical / Tutorial / Methodology / Narrative |
+| Illustration purpose | information / visualization / imagination |
 | Core arguments | 2-5 main points to visualize |
 | Visual opportunities | Positions where illustrations add value |
-| Recommended type | Based on content signals |
-| Recommended density | Based on length and complexity |
 
-**2.2 Extract Core Arguments**
+**CRITICAL**: If article uses metaphors, do NOT illustrate literally. Visualize the **underlying concept**.
 
-- Main thesis
-- Key concepts reader needs
-- Comparisons/contrasts
-- Framework/model proposed
-
-**CRITICAL**: If article uses metaphors (e.g., "电锯切西瓜"), do NOT illustrate literally. Visualize the **underlying concept**.
-
-**2.3 Identify Positions**
-
-**Illustrate**:
-- Core arguments (REQUIRED)
-- Abstract concepts
-- Data comparisons
-- Processes, workflows
-
-**Do NOT Illustrate**:
-- Metaphors literally
-- Decorative scenes
-- Generic illustrations
+Full procedures: [references/workflow.md](references/workflow.md#step-2-setup--analyze)
 
 ---
 
 ### Step 3: Confirm Settings ⚠️
 
-**Do NOT skip.** Use AskUserQuestion with 3-4 questions in ONE call.
+**Do NOT skip.** Use ONE AskUserQuestion call with max 4 questions. **Q1, Q2, Q3 are ALL REQUIRED.**
 
-**Q1: Illustration Type**
-- [Recommended based on analysis] (Recommended)
-- infographic / scene / flowchart / comparison / framework / timeline / mixed
+| Question | Options |
+|----------|---------|
+| **Q1: Type** ⚠️ | [Recommended], infographic, scene, flowchart, comparison, framework, timeline, mixed |
+| **Q2: Density** ⚠️ | minimal (1-2), balanced (3-5), per-section (Recommended), rich (6+) |
+| **Q3: Style** ⚠️ | [Recommended], minimal-flat, sci-fi, hand-drawn, editorial, scene, Other |
+| **Q4: Language** | When article language ≠ EXTEND.md setting |
 
-**Q2: Density**
-- minimal (1-2) - Core concepts only
-- balanced (3-5) (Recommended) - Major sections
-- rich (6+) - Comprehensive support
-
-**Q3: Style**
-Based on Type, suggest compatible styles from matrix:
-- [Best compatible] (Recommended)
-- [Other ✓✓ styles]
-- [Other ✓ styles]
-
-**Q4** (only if source ≠ user language):
-- Language: Source / User language
+Full procedures: [references/workflow.md](references/workflow.md#step-3-confirm-settings-)
 
 ---
 
 ### Step 4: Generate Outline
 
-Save as `outline.md`:
+Save as `outline.md` with frontmatter (type, density, style, image_count, references) and illustration entries:
 
 ```yaml
----
-type: infographic
-density: balanced
-style: blueprint
-image_count: 4
----
-
 ## Illustration 1
-
 **Position**: [section] / [paragraph]
 **Purpose**: [why this helps]
 **Visual Content**: [what to show]
-**Type Application**: [how type applies]
 **Filename**: 01-infographic-concept-name.png
-
-## Illustration 2
-...
 ```
 
-**Requirements**:
-- Each position justified by content needs
-- Type applied consistently
-- Style reflected in descriptions
-- Count matches density
+Full template: [references/workflow.md](references/workflow.md#step-4-generate-outline)
 
 ---
 
 ### Step 5: Generate Images
 
-**5.1 Create Prompts**
+1. **Create Prompts**: Follow [references/prompt-construction.md](references/prompt-construction.md)
+2. **Select Generation Skill**: Check available skills
+3. **Process References**: Handle `direct`/`style`/`palette` usage
+4. **Apply Watermark**: If enabled in EXTEND.md
+5. **Generate**: Sequential, retry once on failure
 
-Follow [references/prompt-construction.md](references/prompt-construction.md). Save to `prompts/illustration-{slug}.md`.
-
-**5.2 Select Generation Skill**
-
-Check available skills. If multiple, ask user.
-
-**5.3 Apply Watermark** (if enabled)
-
-Add: `Include a subtle watermark "[content]" at [position].`
-
-**5.4 Generate**
-
-1. Generate sequentially
-2. After each: "Generated X/N"
-3. On failure: retry once, then log and continue
+Full procedures: [references/workflow.md](references/workflow.md#step-5-generate-images)
 
 ---
 
 ### Step 6: Finalize
 
-**6.1 Update Article**
-
-Insert after corresponding paragraph:
-```markdown
-![description](illustrations/{slug}/NN-{type}-{slug}.png)
-```
-
-Alt text: concise description in article's language.
-
-**6.2 Output Summary**
+**Update Article**: Insert `![description](path/NN-{type}-{slug}.png)` after corresponding paragraphs.
 
+**Output Summary**:
 ```
 Article Illustration Complete!
-
-Article: [path]
-Type: [type] | Density: [level] | Style: [style]
-Location: [directory]
+Article: [path] | Type: [type] | Density: [level] | Style: [style]
 Images: X/N generated
-
 Positions:
 - 01-xxx.png → After "[Section]"
-- 02-yyy.png → After "[Section]"
-
-[If failures]
-Failed:
-- NN-zzz.png: [reason]
 ```
 
 ---
@@ -277,6 +165,8 @@ Failed:
 ```
 illustrations/{topic-slug}/
 ├── source-{slug}.{ext}
+├── references/                    # Only if references provided
+│   └── NN-ref-{slug}.png
 ├── outline.md
 ├── prompts/
 │   └── illustration-{slug}.md
@@ -290,7 +180,7 @@ illustrations/{topic-slug}/
 
 | Action | Steps |
 |--------|-------|
-| **Edit** | Update prompt → Regenerate → Update reference |
+| **Edit** | Update prompt file FIRST → Regenerate → Update reference |
 | **Add** | Identify position → Create prompt → Generate → Update outline → Insert |
 | **Delete** | Delete files → Remove reference → Update outline |
 
@@ -298,13 +188,10 @@ illustrations/{topic-slug}/
 
 | File | Content |
 |------|---------|
+| [references/workflow.md](references/workflow.md) | Detailed workflow procedures |
 | [references/usage.md](references/usage.md) | Command syntax and options |
 | [references/styles.md](references/styles.md) | Style gallery & compatibility |
 | [references/prompt-construction.md](references/prompt-construction.md) | Prompt templates |
 | `references/styles/<style>.md` | Full style specifications |
 | `references/config/preferences-schema.md` | EXTEND.md schema |
 | `references/config/first-time-setup.md` | First-time setup flow |
-
-## Extension Support
-
-Custom configurations via EXTEND.md. See **Step 1.5** for paths and supported options.

skills/baoyu-article-illustrator/references/config/first-time-setup.md

@@ -9,6 +9,14 @@ description: First-time setup flow for baoyu-article-illustrator preferences
 
 When no EXTEND.md is found, guide user through preference setup.
 
+**⛔ BLOCKING OPERATION**: This setup MUST complete before ANY other workflow steps. Do NOT:
+- Ask about reference images
+- Ask about content/article
+- Ask about type or style preferences
+- Proceed to content analysis
+
+ONLY ask the questions in this setup flow, save EXTEND.md, then continue.
+
 ## Setup Flow
 
 ```

skills/baoyu-article-illustrator/references/prompt-construction.md

@@ -1,5 +1,102 @@
 # Prompt Construction
 
+## Prompt File Format
+
+Each prompt file uses YAML frontmatter + content:
+
+```yaml
+---
+illustration_id: 01
+type: infographic
+style: blueprint
+references:                    # ⚠️ ONLY if files EXIST in references/ directory
+  - ref_id: 01
+    filename: 01-ref-diagram.png
+    usage: direct              # direct | style | palette
+---
+
+[Type-specific template content below...]
+```
+
+**⚠️ CRITICAL - When to include `references` field**:
+
+| Situation | Action |
+|-----------|--------|
+| Reference file saved to `references/` | Include in frontmatter ✓ |
+| Style extracted verbally (no file) | DO NOT include in frontmatter, append to prompt body instead |
+| File path in frontmatter but file doesn't exist | ERROR - remove references field |
+
+**Reference Usage Types** (only when file exists):
+
+| Usage | Description | Generation Action |
+|-------|-------------|-------------------|
+| `direct` | Primary visual reference | Pass to `--ref` parameter |
+| `style` | Style characteristics only | Describe style in prompt text |
+| `palette` | Color palette extraction | Include colors in prompt |
+
+**If no reference file but style/palette extracted verbally**, append directly to prompt body:
+```
+COLORS (from reference):
+- Primary: #E8756D coral
+- Secondary: #7ECFC0 mint
+...
+
+STYLE (from reference):
+- Clean lines, minimal shadows
+- Gradient backgrounds
+...
+```
+
+---
+
+## Default Composition Requirements
+
+**Apply to ALL prompts by default**:
+
+| Requirement | Description |
+|-------------|-------------|
+| **Clean composition** | Simple layouts, no visual clutter |
+| **White space** | Generous margins, breathing room around elements |
+| **No complex backgrounds** | Solid colors or subtle gradients only, avoid busy textures |
+| **Centered or content-appropriate** | Main visual elements centered or positioned by content needs |
+| **Matching graphics** | Use graphic elements that align with content theme |
+| **Highlight core info** | White space draws attention to key information |
+
+**Add to ALL prompts**:
+> Clean composition with generous white space. Simple or no background. Main elements centered or positioned by content needs.
+
+---
+
+## Character Rendering
+
+When depicting people:
+
+| Guideline | Description |
+|-----------|-------------|
+| **Style** | Simplified cartoon silhouettes or symbolic expressions |
+| **Avoid** | Realistic human portrayals, detailed faces |
+| **Diversity** | Varied body types when showing multiple people |
+| **Emotion** | Express through posture and simple gestures |
+
+**Add to ALL prompts with human figures**:
+> Human figures: simplified stylized silhouettes or symbolic representations, not photorealistic.
+
+---
+
+## Text in Illustrations
+
+| Element | Guideline |
+|---------|-----------|
+| **Size** | Large, prominent, immediately readable |
+| **Style** | Handwritten fonts preferred for warmth |
+| **Content** | Concise keywords and core concepts only |
+| **Language** | Match article language |
+
+**Add to prompts with text**:
+> Text should be large and prominent with handwritten-style fonts. Keep minimal, focus on keywords.
+
+---
+
 ## Principles
 
 Good prompts must include:
@@ -31,6 +128,13 @@ STYLE: [style characteristics]
 ASPECT: 16:9
 ```
 
+**Infographic + vector-illustration**:
+```
+Flat vector illustration infographic. Clean black outlines on all elements.
+COLORS: Cream background (#F5F0E6), Coral Red (#E07A5F), Mint Green (#81B29A), Mustard Yellow (#F2CC8F)
+ELEMENTS: Geometric simplified icons, no gradients, playful decorative elements (dots, stars)
+```
+
 ### Scene
 
 ```
@@ -61,6 +165,13 @@ STYLE: [style characteristics]
 ASPECT: 16:9
 ```
 
+**Flowchart + vector-illustration**:
+```
+Flat vector flowchart with bold arrows and geometric step containers.
+COLORS: Cream background (#F5F0E6), steps in Coral/Mint/Mustard, black outlines
+ELEMENTS: Rounded rectangles, thick arrows, simple icons per step
+```
+
 ### Comparison
 
 ```
@@ -79,6 +190,13 @@ STYLE: [style characteristics]
 ASPECT: 16:9
 ```
 
+**Comparison + vector-illustration**:
+```
+Flat vector comparison with split layout. Clear visual separation.
+COLORS: Left side Coral (#E07A5F), Right side Mint (#81B29A), cream background
+ELEMENTS: Bold icons, black outlines, centered divider line
+```
+
 ### Framework
 
 ```
@@ -95,6 +213,13 @@ STYLE: [style characteristics]
 ASPECT: 16:9
 ```
 
+**Framework + vector-illustration**:
+```
+Flat vector framework diagram with geometric nodes and bold connectors.
+COLORS: Cream background (#F5F0E6), nodes in Coral/Mint/Mustard/Blue, black outlines
+ELEMENTS: Rounded rectangles or circles for nodes, thick connecting lines
+```
+
 ### Timeline
 
 ```

skills/baoyu-article-illustrator/references/styles.md

@@ -1,10 +1,28 @@
 # Style Reference
 
+## Core Styles
+
+Simplified style tier for quick selection:
+
+| Core Style | Maps To | Best For |
+|------------|---------|----------|
+| `vector` | vector-illustration | Knowledge articles, tutorials, tech content |
+| `minimal-flat` | notion | General, knowledge sharing, SaaS |
+| `sci-fi` | blueprint | AI, frontier tech, system design |
+| `hand-drawn` | sketch/warm | Relaxed, reflective, casual content |
+| `editorial` | editorial | Processes, data, journalism |
+| `scene` | warm/watercolor | Narratives, emotional, lifestyle |
+
+Use Core Styles for most cases. See full Style Gallery below for granular control.
+
+---
+
 ## Style Gallery
 
 | Style | Description | Best For |
 |-------|-------------|----------|
-| `notion` (Default) | Minimalist hand-drawn line art | Knowledge sharing, SaaS, productivity |
+| `vector-illustration` | Clean flat vector art with bold shapes | Knowledge articles, tutorials, tech content |
+| `notion` | Minimalist hand-drawn line art | Knowledge sharing, SaaS, productivity |
 | `elegant` | Refined, sophisticated | Business, thought leadership |
 | `warm` | Friendly, approachable | Personal growth, lifestyle, education |
 | `minimal` | Ultra-clean, zen-like | Philosophy, minimalism, core concepts |
@@ -12,19 +30,31 @@
 | `watercolor` | Soft artistic with natural warmth | Lifestyle, travel, creative |
 | `editorial` | Magazine-style infographic | Tech explainers, journalism |
 | `scientific` | Academic precise diagrams | Biology, chemistry, technical research |
+| `chalkboard` | Classroom chalk drawing style | Education, teaching, explanations |
+| `fantasy-animation` | Ghibli/Disney-inspired hand-drawn | Storybook, magical, emotional |
+| `flat` | Modern bold geometric shapes | Modern digital, contemporary |
+| `flat-doodle` | Cute flat with bold outlines | Cute, friendly, approachable |
+| `intuition-machine` | Technical briefing with aged paper | Technical briefings, academic |
+| `nature` | Organic earthy illustration | Environmental, wellness |
+| `pixel-art` | Retro 8-bit gaming aesthetic | Gaming, retro tech |
+| `playful` | Whimsical pastel doodles | Fun, casual, educational |
+| `retro` | 80s/90s neon geometric | 80s/90s nostalgic, bold |
+| `sketch` | Raw pencil notebook style | Brainstorming, creative exploration |
+| `sketch-notes` | Soft hand-drawn warm notes | Educational, warm notes |
+| `vintage` | Aged parchment historical | Historical, heritage |
 
 Full specifications: `references/styles/<style>.md`
 
 ## Type × Style Compatibility Matrix
 
-| | notion | warm | minimal | blueprint | watercolor | elegant | editorial | scientific |
-|---|:---:|:---:|:---:|:---:|:---:|:---:|:---:|:---:|
-| infographic | ✓✓ | ✓ | ✓✓ | ✓✓ | ✓ | ✓✓ | ✓✓ | ✓✓ |
-| scene | ✓ | ✓✓ | ✓ | ✗ | ✓✓ | ✓ | ✓ | ✗ |
-| flowchart | ✓✓ | ✓ | ✓ | ✓✓ | ✗ | ✓ | ✓✓ | ✓ |
-| comparison | ✓✓ | ✓ | ✓✓ | ✓ | ✓ | ✓✓ | ✓✓ | ✓ |
-| framework | ✓✓ | ✓ | ✓✓ | ✓✓ | ✗ | ✓✓ | ✓ | ✓✓ |
-| timeline | ✓✓ | ✓ | ✓ | ✓ | ✓✓ | ✓✓ | ✓✓ | ✓ |
+| | vector-illustration | notion | warm | minimal | blueprint | watercolor | elegant | editorial | scientific |
+|---|:---:|:---:|:---:|:---:|:---:|:---:|:---:|:---:|:---:|
+| infographic | ✓✓ | ✓✓ | ✓ | ✓✓ | ✓✓ | ✓ | ✓✓ | ✓✓ | ✓✓ |
+| scene | ✓ | ✓ | ✓✓ | ✓ | ✗ | ✓✓ | ✓ | ✓ | ✗ |
+| flowchart | ✓✓ | ✓✓ | ✓ | ✓ | ✓✓ | ✗ | ✓ | ✓✓ | ✓ |
+| comparison | ✓✓ | ✓✓ | ✓ | ✓✓ | ✓ | ✓ | ✓✓ | ✓✓ | ✓ |
+| framework | ✓✓ | ✓✓ | ✓ | ✓✓ | ✓✓ | ✗ | ✓✓ | ✓ | ✓✓ |
+| timeline | ✓ | ✓✓ | ✓ | ✓ | ✓ | ✓✓ | ✓✓ | ✓✓ | ✓ |
 
 ✓✓ = highly recommended | ✓ = compatible | ✗ = not recommended
 
@@ -32,30 +62,57 @@ Full specifications: `references/styles/<style>.md`
 
 | Type | Primary Style | Secondary Styles |
 |------|---------------|------------------|
-| infographic | blueprint | notion, editorial, scientific |
+| infographic | vector-illustration | notion, blueprint, editorial |
 | scene | warm | watercolor, elegant |
-| flowchart | notion | blueprint, editorial |
-| comparison | notion | elegant, editorial |
-| framework | blueprint | notion, scientific |
+| flowchart | vector-illustration | notion, blueprint |
+| comparison | vector-illustration | notion, elegant |
+| framework | blueprint | vector-illustration, notion |
 | timeline | elegant | warm, editorial |
 
 ## Auto Selection by Content Signals
 
 | Content Signals | Recommended Type | Recommended Style |
 |-----------------|------------------|-------------------|
-| API, metrics, data, comparison, numbers | infographic | blueprint, notion |
+| API, metrics, data, comparison, numbers | infographic | blueprint, vector-illustration |
+| Knowledge, concept, tutorial, learning, guide | infographic | vector-illustration, notion |
+| Tech, AI, programming, development, code | infographic | vector-illustration, blueprint |
+| How-to, steps, workflow, process, tutorial | flowchart | vector-illustration, notion |
+| Framework, model, architecture, principles | framework | blueprint, vector-illustration |
+| vs, pros/cons, before/after, alternatives | comparison | vector-illustration, notion |
 | Story, emotion, journey, experience, personal | scene | warm, watercolor |
-| How-to, steps, workflow, process, tutorial | flowchart | notion, minimal |
-| vs, pros/cons, before/after, alternatives | comparison | notion, elegant |
-| Framework, model, architecture, principles | framework | blueprint, notion |
 | History, timeline, progress, evolution | timeline | elegant, warm |
-| Knowledge, concept, productivity, SaaS, tool | infographic | notion |
+| Productivity, SaaS, tool, app, software | infographic | notion, vector-illustration |
 | Business, professional, strategy, corporate | framework | elegant |
 | Biology, chemistry, medical, scientific | infographic | scientific |
 | Explainer, journalism, magazine, investigation | infographic | editorial |
 
 ## Style Characteristics by Type
 
+### infographic + vector-illustration
+- Clean flat vector shapes, bold geometric forms
+- Vibrant but harmonious color palette
+- Clear visual hierarchy with icons and labels
+- Modern, professional, highly readable
+- Perfect for knowledge articles and tutorials
+
+### flowchart + vector-illustration
+- Bold arrows and connectors
+- Distinct step containers with icons
+- Clean progression flow
+- High contrast for readability
+
+### comparison + vector-illustration
+- Split layout with clear visual separation
+- Bold iconography for each side
+- Color-coded distinctions
+- Easy at-a-glance comparison
+
+### framework + vector-illustration
+- Geometric node representations
+- Clear hierarchical structure
+- Bold connecting lines
+- Modern system diagram aesthetic
+
 ### infographic + blueprint
 - Technical precision, schematic lines
 - Grid-based layout, clear zones

skills/baoyu-article-illustrator/references/workflow.md

@@ -0,0 +1,355 @@
+# Detailed Workflow Procedures
+
+## Step 1: Pre-check
+
+### 1.0 Detect & Save Reference Images ⚠️ REQUIRED if images provided
+
+Check if user provided reference images. Handle based on input type:
+
+| Input Type | Action |
+|------------|--------|
+| Image file path provided | Copy to `references/` subdirectory → can use `--ref` |
+| Image in conversation (no path) | **ASK user for file path** with AskUserQuestion |
+| User can't provide path | Extract style/palette verbally → append to prompts (NO frontmatter references) |
+
+**CRITICAL**: Only add `references` to prompt frontmatter if files are ACTUALLY SAVED to `references/` directory.
+
+**If user provides file path**:
+1. Copy to `references/NN-ref-{slug}.png`
+2. Create description: `references/NN-ref-{slug}.md`
+3. Verify files exist before proceeding
+
+**If user can't provide path** (extracted verbally):
+1. Analyze image visually, extract: colors, style, composition
+2. Create `references/extracted-style.md` with extracted info
+3. DO NOT add `references` to prompt frontmatter
+4. Instead, append extracted style/colors directly to prompt text
+
+**Description File Format** (only when file saved):
+```yaml
+---
+ref_id: NN
+filename: NN-ref-{slug}.png
+---
+[User's description or auto-generated description]
+```
+
+**Verification** (only for saved files):
+```
+Reference Images Saved:
+- 01-ref-{slug}.png ✓ (can use --ref)
+- 02-ref-{slug}.png ✓ (can use --ref)
+```
+
+**Or for extracted style**:
+```
+Reference Style Extracted (no file):
+- Colors: #E8756D coral, #7ECFC0 mint...
+- Style: minimal flat vector, clean lines...
+→ Will append to prompt text (not --ref)
+```
+
+---
+
+### 1.1 Determine Input Type
+
+| Input | Output Directory | Next |
+|-------|------------------|------|
+| File path | Ask user (1.2) | → 1.2 |
+| Pasted content | `illustrations/{topic-slug}/` | → 1.4 |
+
+**Backup rule for pasted content**: If `source.md` exists in target directory, rename to `source-backup-YYYYMMDD-HHMMSS.md` before saving.
+
+### 1.2-1.4 Configuration (file path input only)
+
+Check preferences and existing state, then ask ALL needed questions in ONE AskUserQuestion call (max 4 questions).
+
+**Questions to include** (skip if preference exists or not applicable):
+
+| Question | When to Ask | Options |
+|----------|-------------|---------|
+| Output directory | No `default_output_dir` in EXTEND.md | `{article-dir}/`, `{article-dir}/imgs/` (Recommended), `{article-dir}/illustrations/`, `illustrations/{topic-slug}/` |
+| Existing images | Target dir has `.png/.jpg/.webp` files | `supplement`, `overwrite`, `regenerate` |
+| Article update | Always (file path input) | `update`, `copy` |
+
+**Preference Values** (if configured, skip asking):
+
+| `default_output_dir` | Path |
+|----------------------|------|
+| `same-dir` | `{article-dir}/` |
+| `imgs-subdir` | `{article-dir}/imgs/` |
+| `illustrations-subdir` | `{article-dir}/illustrations/` |
+| `independent` | `illustrations/{topic-slug}/` |
+
+### 1.5 Load Preferences (EXTEND.md) ⛔ BLOCKING
+
+**CRITICAL**: If EXTEND.md not found, MUST complete first-time setup before ANY other questions or steps. Do NOT proceed to reference images, do NOT ask about content, do NOT ask about type/style — ONLY complete the preferences setup first.
+
+```bash
+test -f .baoyu-skills/baoyu-article-illustrator/EXTEND.md && echo "project"
+test -f "$HOME/.baoyu-skills/baoyu-article-illustrator/EXTEND.md" && echo "user"
+```
+
+| Result | Action |
+|--------|--------|
+| Found | Read, parse, display summary → Continue |
+| Not found | ⛔ **BLOCKING**: Run first-time setup ONLY ([config/first-time-setup.md](config/first-time-setup.md)) → Complete and save EXTEND.md → Then continue |
+
+**Supports**: Watermark | Preferred type/style | Custom styles | Language | Output directory
+
+---
+
+## Step 2: Setup & Analyze
+
+### 2.1 Analyze Content
+
+| Analysis | Description |
+|----------|-------------|
+| Content type | Technical / Tutorial / Methodology / Narrative |
+| Illustration purpose | information / visualization / imagination |
+| Core arguments | 2-5 main points to visualize |
+| Visual opportunities | Positions where illustrations add value |
+| Recommended type | Based on content signals and purpose |
+| Recommended density | Based on length and complexity |
+
+### 2.2 Extract Core Arguments
+
+- Main thesis
+- Key concepts reader needs
+- Comparisons/contrasts
+- Framework/model proposed
+
+**CRITICAL**: If article uses metaphors (e.g., "电锯切西瓜"), do NOT illustrate literally. Visualize the **underlying concept**.
+
+### 2.3 Identify Positions
+
+**Illustrate**:
+- Core arguments (REQUIRED)
+- Abstract concepts
+- Data comparisons
+- Processes, workflows
+
+**Do NOT Illustrate**:
+- Metaphors literally
+- Decorative scenes
+- Generic illustrations
+
+### 2.4 Analyze Reference Images (if provided in Step 1.0)
+
+For each reference image:
+
+| Analysis | Description |
+|----------|-------------|
+| Visual characteristics | Style, colors, composition |
+| Content/subject | What the reference depicts |
+| Suitable positions | Which sections match this reference |
+| Style match | Which illustration types/styles align |
+| Usage recommendation | `direct` / `style` / `palette` |
+
+| Usage | When to Use |
+|-------|-------------|
+| `direct` | Reference matches desired output closely |
+| `style` | Extract visual style characteristics only |
+| `palette` | Extract color scheme only |
+
+---
+
+## Step 3: Confirm Settings ⚠️
+
+**Do NOT skip.** Use ONE AskUserQuestion call with max 4 questions. **Q1, Q2, Q3 are ALL REQUIRED.**
+
+### Q1: Illustration Type ⚠️ REQUIRED
+- [Recommended based on analysis] (Recommended)
+- infographic / scene / flowchart / comparison / framework / timeline / mixed
+
+### Q2: Density ⚠️ REQUIRED - DO NOT SKIP
+- minimal (1-2) - Core concepts only
+- balanced (3-5) - Major sections
+- per-section - At least 1 per section/chapter (Recommended)
+- rich (6+) - Comprehensive coverage
+
+### Q3: Style ⚠️ REQUIRED (ALWAYS ask, even with preferred_style in EXTEND.md)
+
+If EXTEND.md has `preferred_style`:
+- [Custom style name + brief description] (Recommended)
+- [Top compatible core style 1]
+- [Top compatible core style 2]
+- Other (see full Style Gallery)
+
+If no `preferred_style` (present Core Styles first):
+- [Best compatible core style] (Recommended)
+- [Other compatible core style 1]
+- [Other compatible core style 2]
+- Other (see full Style Gallery)
+
+**Core Styles** (simplified selection):
+
+| Core Style | Best For |
+|------------|----------|
+| `minimal-flat` | General, knowledge sharing, SaaS |
+| `sci-fi` | AI, frontier tech, system design |
+| `hand-drawn` | Relaxed, reflective, casual |
+| `editorial` | Processes, data, journalism |
+| `scene` | Narratives, emotional, lifestyle |
+
+Style selection based on Type × Style compatibility matrix (styles.md).
+Full specs: `styles/<style>.md`
+
+### Q4: Image Text Language ⚠️ REQUIRED when article language ≠ EXTEND.md `language`
+
+Detect article language from content. If different from EXTEND.md `language` setting, MUST ask:
+- Article language (match article content) (Recommended)
+- EXTEND.md language (user's general preference)
+
+**Skip only if**: Article language matches EXTEND.md `language`, or EXTEND.md has no `language` setting.
+
+### Display Reference Usage (if references detected in Step 1.0)
+
+When presenting outline preview to user, show reference assignments:
+
+```
+Reference Images:
+| Ref | Filename | Recommended Usage |
+|-----|----------|-------------------|
+| 01 | 01-ref-diagram.png | direct → Illustration 1, 3 |
+| 02 | 02-ref-chart.png | palette → Illustration 2 |
+```
+
+---
+
+## Step 4: Generate Outline
+
+Save as `outline.md`:
+
+```yaml
+---
+type: infographic
+density: balanced
+style: blueprint
+image_count: 4
+references:                    # Only if references provided
+  - ref_id: 01
+    filename: 01-ref-diagram.png
+    description: "Technical diagram showing system architecture"
+  - ref_id: 02
+    filename: 02-ref-chart.png
+    description: "Color chart with brand palette"
+---
+
+## Illustration 1
+
+**Position**: [section] / [paragraph]
+**Purpose**: [why this helps]
+**Visual Content**: [what to show]
+**Type Application**: [how type applies]
+**References**: [01]                    # Optional: list ref_ids used
+**Reference Usage**: direct             # direct | style | palette
+**Filename**: 01-infographic-concept-name.png
+
+## Illustration 2
+...
+```
+
+**Requirements**:
+- Each position justified by content needs
+- Type applied consistently
+- Style reflected in descriptions
+- Count matches density
+- References assigned based on Step 2.4 analysis
+
+---
+
+## Step 5: Generate Images
+
+### 5.1 Create Prompts
+
+Follow [prompt-construction.md](prompt-construction.md). Save to `prompts/illustration-{slug}.md`.
+- **Backup rule**: If prompt file exists, rename to `prompts/illustration-{slug}-backup-YYYYMMDD-HHMMSS.md`
+
+**CRITICAL - References in Frontmatter**:
+- Only add `references` field if files ACTUALLY EXIST in `references/` directory
+- If style/palette was extracted verbally (no file), append info to prompt BODY instead
+- Before writing frontmatter, verify: `test -f references/NN-ref-{slug}.png`
+
+### 5.2 Select Generation Skill
+
+Check available skills. If multiple, ask user.
+
+### 5.3 Process References ⚠️ REQUIRED if references saved in Step 1.0
+
+**DO NOT SKIP if user provided reference images.** For each illustration with references:
+
+1. **VERIFY files exist first**:
+   ```bash
+   test -f references/NN-ref-{slug}.png && echo "exists" || echo "MISSING"
+   ```
+   - If file MISSING but in frontmatter → ERROR, fix frontmatter or remove references field
+   - If file exists → proceed with processing
+
+2. Read prompt frontmatter for reference info
+3. Process based on usage type:
+
+| Usage | Action | Example |
+|-------|--------|---------|
+| `direct` | Add reference path to `--ref` parameter | `--ref references/01-ref-brand.png` |
+| `style` | Analyze reference, append style traits to prompt | "Style: clean lines, gradient backgrounds..." |
+| `palette` | Extract colors from reference, append to prompt | "Colors: #E8756D coral, #7ECFC0 mint..." |
+
+4. Check image generation skill capability:
+
+| Skill Supports `--ref` | Action |
+|------------------------|--------|
+| Yes (e.g., baoyu-image-gen with Google) | Pass reference images via `--ref` |
+| No | Convert to text description, append to prompt |
+
+**Verification**: Before generating, confirm reference processing:
+```
+Reference Processing:
+- Illustration 1: using 01-ref-brand.png (direct) ✓
+- Illustration 2: extracted palette from 02-ref-style.png ✓
+```
+
+### 5.4 Apply Watermark (if enabled)
+
+Add: `Include a subtle watermark "[content]" at [position].`
+
+### 5.5 Generate
+
+1. For each illustration:
+   - **Backup rule**: If image file exists, rename to `NN-{type}-{slug}-backup-YYYYMMDD-HHMMSS.md`
+   - If references with `direct` usage: include `--ref` parameter
+   - Generate image
+2. After each: "Generated X/N"
+3. On failure: retry once, then log and continue
+
+---
+
+## Step 6: Finalize
+
+### 6.1 Update Article
+
+Insert after corresponding paragraph:
+```markdown
+![description](illustrations/{slug}/NN-{type}-{slug}.png)
+```
+
+Alt text: concise description in article's language.
+
+### 6.2 Output Summary
+
+```
+Article Illustration Complete!
+
+Article: [path]
+Type: [type] | Density: [level] | Style: [style]
+Location: [directory]
+Images: X/N generated
+
+Positions:
+- 01-xxx.png → After "[Section]"
+- 02-yyy.png → After "[Section]"
+
+[If failures]
+Failed:
+- NN-zzz.png: [reason]
+```

skills/baoyu-comic/SKILL.md

@@ -153,7 +153,11 @@ Technical terms remain in English.
 
 ```
 Comic Progress:
-- [ ] Step 1: Setup & Analyze (1.1 Preferences, 1.2 Analyze, 1.3 Check existing)
+- [ ] Step 1: Setup & Analyze
+  - [ ] 1.1 Preferences (EXTEND.md) ⛔ BLOCKING
+    - [ ] Found → load preferences → continue
+    - [ ] Not found → run first-time setup → MUST complete before other steps
+  - [ ] 1.2 Analyze, 1.3 Check existing
 - [ ] Step 2: Confirmation - Style & options ⚠️ REQUIRED
 - [ ] Step 3: Generate storyboard + characters
 - [ ] Step 4: Review outline (conditional)
@@ -169,14 +173,22 @@ Comic Progress:
 ### Flow
 
 ```
-Input → Preferences → Analyze → [Check Existing?] → [Confirm: Style + Reviews] → Storyboard → [Review?] → Prompts → [Review?] → Images → PDF → Complete
+Input → [Preferences] ─┬─ Found → Continue
+                       │
+                       └─ Not found → First-Time Setup ⛔ BLOCKING
+                                      │
+                                      └─ Complete setup → Save EXTEND.md → Continue
+                                                                              │
+        ┌─────────────────────────────────────────────────────────────────────┘
+        ↓
+Analyze → [Check Existing?] → [Confirm: Style + Reviews] → Storyboard → [Review?] → Prompts → [Review?] → Images → PDF → Complete
 ```
 
 ### Step Summary
 
 | Step | Action | Key Output |
 |------|--------|------------|
-| 1.1 | Load EXTEND.md preferences | Config loaded |
+| 1.1 | Load EXTEND.md preferences ⛔ BLOCKING if not found | Config loaded |
 | 1.2 | Analyze content | `analysis.md` |
 | 1.3 | Check existing directory | Handle conflicts |
 | 2 | Confirm style, focus, audience, reviews | User preferences |
@@ -194,6 +206,7 @@ Input → Preferences → Analyze → [Check Existing?] → [Confirm: Style + Re
 **Character reference is MANDATORY for visual consistency.**
 
 **7.1 Generate character sheet first**:
+- **Backup rule**: If `characters/characters.png` exists, rename to `characters/characters-backup-YYYYMMDD-HHMMSS.png`
 ```bash
 # Use Reference Sheet Prompt from characters/characters.md
 npx -y bun ${SKILL_DIR}/../baoyu-image-gen/scripts/main.ts \
@@ -214,6 +227,10 @@ Compress to reduce token usage when used as reference image:
 | Supports `--ref` | Pass `characters/characters.png` with EVERY page |
 | No `--ref` support | Prepend character descriptions to EVERY prompt file |
 
+**Backup rules for page generation**:
+- If prompt file exists: rename to `prompts/NN-{cover|page}-[slug]-backup-YYYYMMDD-HHMMSS.md`
+- If image file exists: rename to `NN-{cover|page}-[slug]-backup-YYYYMMDD-HHMMSS.png`
+
 ```bash
 # Example: ALWAYS include --ref for consistency
 npx -y bun ${SKILL_DIR}/../baoyu-image-gen/scripts/main.ts \
@@ -224,13 +241,20 @@ npx -y bun ${SKILL_DIR}/../baoyu-image-gen/scripts/main.ts \
 
 **Full workflow details**: [references/workflow.md](references/workflow.md)
 
-### EXTEND.md Paths
+### EXTEND.md Paths ⛔ BLOCKING
+
+**CRITICAL**: If EXTEND.md not found, MUST complete first-time setup before ANY other questions or steps. Do NOT proceed to content analysis, do NOT ask about art style, do NOT ask about tone — ONLY complete the preferences setup first.
 
 | Path | Location |
 |------|----------|
 | `.baoyu-skills/baoyu-comic/EXTEND.md` | Project directory |
 | `$HOME/.baoyu-skills/baoyu-comic/EXTEND.md` | User home |
 
+| Result | Action |
+|--------|--------|
+| Found | Read, parse, display summary → Continue |
+| Not found | ⛔ **BLOCKING**: Run first-time setup ONLY ([references/config/first-time-setup.md](references/config/first-time-setup.md)) → Complete and save EXTEND.md → Then continue |
+
 **EXTEND.md Supports**: Watermark | Preferred art/tone/layout | Custom style definitions | Character presets | Language preference
 
 Schema: [references/config/preferences-schema.md](references/config/preferences-schema.md)
@@ -259,6 +283,16 @@ Schema: [references/config/preferences-schema.md](references/config/preferences-
 - [config/first-time-setup.md](references/config/first-time-setup.md) - First-time setup
 - [config/watermark-guide.md](references/config/watermark-guide.md) - Watermark configuration
 
+## Page Modification
+
+| Action | Steps |
+|--------|-------|
+| **Edit** | **Update prompt file FIRST** → `--regenerate N` → Regenerate PDF |
+| **Add** | Create prompt at position → Generate with character ref → Renumber subsequent → Update storyboard → Regenerate PDF |
+| **Delete** | Remove files → Renumber subsequent → Update storyboard → Regenerate PDF |
+
+**IMPORTANT**: When updating pages, ALWAYS update the prompt file (`prompts/NN-{cover|page}-[slug].md`) FIRST before regenerating. This ensures changes are documented and reproducible.
+
 ## Notes
 
 - Image generation: 10-30 seconds per page

skills/baoyu-comic/references/config/first-time-setup.md

@@ -9,6 +9,14 @@ description: First-time setup flow for baoyu-comic preferences
 
 When no EXTEND.md is found, guide user through preference setup.
 
+**⛔ BLOCKING OPERATION**: This setup MUST complete before ANY other workflow steps. Do NOT:
+- Ask about content/source material
+- Ask about art style or tone
+- Ask about layout preferences
+- Proceed to content analysis
+
+ONLY ask the questions in this setup flow, save EXTEND.md, then continue.
+
 ## Setup Flow
 
 ```

skills/baoyu-comic/references/workflow.md

@@ -84,6 +84,7 @@ Read source content, save it if needed, and perform deep analysis.
 1. **Save source content** (if not already a file):
    - If user provides a file path: use as-is
    - If user pastes content: save to `source.md` in target directory
+   - **Backup rule**: If `source.md` exists, rename to `source-backup-YYYYMMDD-HHMMSS.md`
 2. Read source content
 3. **Deep analysis** following `analysis-framework.md`:
    - Target audience identification
@@ -329,6 +330,7 @@ Create image generation prompts for all pages.
 1. Create prompt following art style + tone guidelines
 2. Include character visual descriptions for consistency
 3. Save to `prompts/NN-{cover|page}-[slug].md`
+   - **Backup rule**: If prompt file exists, rename to `prompts/NN-{cover|page}-[slug]-backup-YYYYMMDD-HHMMSS.md`
 
 **Prompt File Format**:
 ```markdown
@@ -405,8 +407,9 @@ With confirmed prompts from Step 5/6:
 ### 7.1 Generate Character Reference Sheet (first)
 
 1. Use Reference Sheet Prompt from `characters/characters.md`
-2. Generate → `characters/characters.png`
-3. This ensures visual consistency for all subsequent pages
+2. **Backup rule**: If `characters/characters.png` exists, rename to `characters/characters-backup-YYYYMMDD-HHMMSS.png`
+3. Generate → `characters/characters.png`
+4. This ensures visual consistency for all subsequent pages
 
 ### 7.2 Generate Comic Pages
 
@@ -453,9 +456,10 @@ When skill does NOT support reference images, create combined prompt files:
 
 **For each page (cover + pages)**:
 1. Read prompt from `prompts/NN-{cover|page}-[slug].md`
-2. Generate image using Strategy A or B (based on skill capability)
-3. Save to `NN-{cover|page}-[slug].png`
-4. Report progress after each generation: "Generated X/N: [page title]"
+2. **Backup rule**: If image file exists, rename to `NN-{cover|page}-[slug]-backup-YYYYMMDD-HHMMSS.png`
+3. Generate image using Strategy A or B (based on skill capability)
+4. Save to `NN-{cover|page}-[slug].png`
+5. Report progress after each generation: "Generated X/N: [page title]"
 
 **Session Management**:
 If image generation skill supports `--sessionId`:

skills/baoyu-compress-image/scripts/main.ts

@@ -147,7 +147,9 @@ async function processFile(
   const outputSize = statSync(tempOutput).size;
 
   if (!opts.keep && absInput !== output) {
-    unlinkSync(absInput);
+    const ext = extname(absInput);
+    const base = absInput.slice(0, -ext.length);
+    renameSync(absInput, `${base}_original${ext}`);
   }
   renameSync(tempOutput, output);
 

skills/baoyu-cover-image/SKILL.md

@@ -1,11 +1,11 @@
 ---
 name: baoyu-cover-image
-description: Generates article cover images with 4 dimensions (type, style, text, mood) and 20 hand-drawn styles. Supports cinematic (2.35:1), widescreen (16:9), and square (1:1) aspects. Use when user asks to "generate cover image", "create article cover", "make cover", or mentions "封面图".
+description: Generates article cover images with 5 dimensions (type, palette, rendering, text, mood) combining 9 color palettes and 6 rendering styles. Supports cinematic (2.35:1), widescreen (16:9), and square (1:1) aspects. Use when user asks to "generate cover image", "create article cover", or "make cover".
 ---
 
 # Cover Image Generator
 
-Generate elegant cover images for articles with 4-dimensional customization.
+Generate elegant cover images for articles with 5-dimensional customization.
 
 ## Usage
 
@@ -16,10 +16,14 @@ Generate elegant cover images for articles with 4-dimensional customization.
 # Quick mode: skip confirmation, use auto-selection
 /baoyu-cover-image article.md --quick
 
-# Specify dimensions
-/baoyu-cover-image article.md --type conceptual --style blueprint
+# Specify dimensions (new 5D system)
+/baoyu-cover-image article.md --type conceptual --palette warm --rendering flat-vector
 /baoyu-cover-image article.md --text title-subtitle --mood bold
 
+# Style presets (backward-compatible shorthand for palette + rendering)
+/baoyu-cover-image article.md --style blueprint
+/baoyu-cover-image article.md --style blueprint --rendering hand-drawn  # override rendering
+
 # Visual only (no title text)
 /baoyu-cover-image article.md --no-title
 
@@ -28,8 +32,12 @@ Generate elegant cover images for articles with 4-dimensional customization.
 [paste content]
 
 # Direct input with options
-/baoyu-cover-image --style notion --aspect 1:1 --quick
+/baoyu-cover-image --palette mono --rendering digital --aspect 1:1 --quick
 [paste content]
+
+# With reference images
+/baoyu-cover-image article.md --ref style-ref.png
+/baoyu-cover-image article.md --ref ref1.png ref2.png --quick
 ```
 
 ## Options
@@ -37,24 +45,28 @@ Generate elegant cover images for articles with 4-dimensional customization.
 | Option | Description |
 |--------|-------------|
 | `--type <name>` | Cover type: hero, conceptual, typography, metaphor, scene, minimal |
-| `--style <name>` | Cover style (see Style Gallery) |
+| `--palette <name>` | Color palette: warm, elegant, cool, dark, earth, vivid, pastel, mono, retro |
+| `--rendering <name>` | Rendering style: flat-vector, hand-drawn, painterly, digital, pixel, chalk |
+| `--style <name>` | Preset shorthand (expands to palette + rendering, see [Style Presets](references/style-presets.md)) |
 | `--text <level>` | Text density: none, title-only, title-subtitle, text-rich |
 | `--mood <level>` | Emotional intensity: subtle, balanced, bold |
 | `--aspect <ratio>` | 16:9 (default), 2.35:1, 4:3, 3:2, 1:1, 3:4 |
 | `--lang <code>` | Title language (en, zh, ja, etc.) |
 | `--no-title` | Alias for `--text none` |
 | `--quick` | Skip confirmation, use auto-selection for missing dimensions |
+| `--ref <files...>` | Reference images for style/composition guidance |
 
-## Four Dimensions
+## Five Dimensions
 
 | Dimension | Controls | Values | Default |
 |-----------|----------|--------|---------|
 | **Type** | Visual composition, information structure | hero, conceptual, typography, metaphor, scene, minimal | auto |
-| **Style** | Visual aesthetics, colors, technique | 20 built-in styles | auto |
+| **Palette** | Colors, color scheme, decorative hints | warm, elegant, cool, dark, earth, vivid, pastel, mono, retro | auto |
+| **Rendering** | Line quality, texture, depth, element style | flat-vector, hand-drawn, painterly, digital, pixel, chalk | auto |
 | **Text** | Text density, information hierarchy | none, title-only, title-subtitle, text-rich | title-only |
 | **Mood** | Emotional intensity, visual weight | subtle, balanced, bold | balanced |
 
-Dimensions can be freely combined. Example: `--type conceptual --style blueprint --text title-only --mood subtle` creates a calm technical concept visualization.
+Dimensions can be freely combined. Auto-selection rules: [references/auto-selection.md](references/auto-selection.md)
 
 ## Type Gallery
 
@@ -67,207 +79,133 @@ Dimensions can be freely combined. Example: `--type conceptual --style blueprint
 | `scene` | Atmospheric scene, narrative feel | Stories, travel, lifestyle |
 | `minimal` | Minimalist composition, generous whitespace | Zen, focus, core concepts |
 
-## Auto Type Selection
+Type composition details: [references/types.md](references/types.md)
 
-When `--type` is omitted, select based on content signals:
+## Palette Gallery
 
-| Signals | Type |
-|---------|------|
-| Product, launch, announcement, release, reveal | `hero` |
-| Architecture, framework, system, API, technical, model | `conceptual` |
-| Quote, opinion, insight, thought, headline, statement | `typography` |
-| Philosophy, growth, abstract, meaning, reflection | `metaphor` |
-| Story, journey, travel, lifestyle, experience, narrative | `scene` |
-| Zen, focus, essential, core, simple, pure | `minimal` |
+| Palette | Vibe | Primary Colors |
+|---------|------|----------------|
+| `warm` | Friendly, approachable | Orange, golden yellow, terracotta |
+| `elegant` | Sophisticated, refined | Soft coral, muted teal, dusty rose |
+| `cool` | Technical, professional | Engineering blue, navy, cyan |
+| `dark` | Cinematic, premium | Electric purple, cyan, magenta |
+| `earth` | Natural, organic | Forest green, sage, earth brown |
+| `vivid` | Energetic, bold | Bright red, neon green, electric blue |
+| `pastel` | Gentle, whimsical | Soft pink, mint, lavender |
+| `mono` | Clean, focused | Black, near-black, white |
+| `retro` | Nostalgic, vintage | Muted orange, dusty pink, maroon |
 
-## Style Gallery
+Palette definitions: [references/palettes/](references/palettes/)
 
-| Style | Description |
-|-------|-------------|
-| `elegant` (default) | Refined, sophisticated |
-| `blueprint` | Technical schematics |
-| `bold-editorial` | Magazine impact |
-| `chalkboard` | Chalk on blackboard |
-| `dark-atmospheric` | Cinematic dark mode |
-| `editorial-infographic` | Visual storytelling |
-| `fantasy-animation` | Ghibli/Disney inspired |
-| `flat-doodle` | Pastel, cute shapes |
-| `intuition-machine` | Technical, bilingual |
-| `minimal` | Ultra-clean, zen |
-| `nature` | Organic, earthy |
-| `notion` | SaaS dashboard |
-| `pixel-art` | Retro 8-bit |
-| `playful` | Fun, whimsical |
-| `retro` | Halftone, vintage |
-| `sketch-notes` | Hand-drawn, warm |
-| `vector-illustration` | Flat vector |
-| `vintage` | Aged, expedition |
-| `warm` | Friendly, human |
-| `watercolor` | Soft hand-painted |
+## Rendering Gallery
 
-Style definitions: [references/styles/](references/styles/)
+| Rendering | Description | Key Characteristics |
+|-----------|-------------|---------------------|
+| `flat-vector` | Clean modern vector | Uniform outlines, flat fills, geometric icons |
+| `hand-drawn` | Sketchy organic illustration | Imperfect strokes, paper texture, doodles |
+| `painterly` | Soft watercolor/paint | Brush strokes, color bleeds, soft edges |
+| `digital` | Polished modern digital | Precise edges, subtle gradients, UI components |
+| `pixel` | Retro 8-bit pixel art | Pixel grid, dithering, chunky shapes |
+| `chalk` | Chalk on blackboard | Chalk strokes, dust effects, board texture |
 
-## Auto Style Selection
+Rendering definitions: [references/renderings/](references/renderings/)
 
-When `--style` is omitted, select based on content signals:
+## Text & Mood
 
-| Signals | Style |
-|---------|-------|
-| Architecture, system design | `blueprint` |
-| Product launch, marketing | `bold-editorial` |
-| Education, tutorial | `chalkboard` |
-| Entertainment, premium | `dark-atmospheric` |
-| Tech explainer, research | `editorial-infographic` |
-| Fantasy, children | `fantasy-animation` |
-| Technical docs, bilingual | `intuition-machine` |
-| Personal story, emotion | `warm` |
-| Zen, focus, essential | `minimal` |
-| Fun, beginner, casual | `playful` |
-| Nature, wellness, eco | `nature` |
-| SaaS, dashboard | `notion` |
-| Workflow, productivity | `flat-doodle` |
-| Gaming, retro tech | `pixel-art` |
-| Knowledge sharing | `sketch-notes` |
-| Creative proposals | `vector-illustration` |
-| History, exploration | `vintage` |
-| Lifestyle, travel | `watercolor` |
-| Business, professional | `elegant` |
-
-## Text Dimension
-
-| Value | Title | Subtitle | Tags | Use Case |
-|-------|:-----:|:--------:|:----:|----------|
+| Text Level | Title | Subtitle | Tags | Use Case |
+|------------|:-----:|:--------:|:----:|----------|
 | `none` | - | - | - | Pure visual, no text |
-| `title-only` | ✓ (≤8字) | - | - | Simple headline (default) |
-| `title-subtitle` | ✓ | ✓ (≤15字) | - | Title + supporting context |
+| `title-only` | ✓ | - | - | Simple headline (default) |
+| `title-subtitle` | ✓ | ✓ | - | Title + supporting context |
 | `text-rich` | ✓ | ✓ | ✓ (2-4) | Information-dense |
 
-Full guide: [references/dimensions/text.md](references/dimensions/text.md)
-
-## Auto Text Selection
-
-When `--text` is omitted, select based on content signals:
-
-| Signals | Text Level |
-|---------|------------|
-| Visual-only, photography, abstract, art | `none` |
-| Article, blog, standard cover | `title-only` |
-| Series, tutorial, technical with context | `title-subtitle` |
-| Announcement, features, multiple points, infographic | `text-rich` |
-
-Default: `title-only`
-
-## Mood Dimension
-
-| Value | Contrast | Saturation | Weight | Use Case |
-|-------|:--------:|:----------:|:------:|----------|
+| Mood | Contrast | Saturation | Weight | Use Case |
+|------|:--------:|:----------:|:------:|----------|
 | `subtle` | Low | Muted | Light | Corporate, thought leadership |
 | `balanced` | Medium | Normal | Medium | General articles (default) |
 | `bold` | High | Vivid | Heavy | Announcements, promotions |
 
-Full guide: [references/dimensions/mood.md](references/dimensions/mood.md)
+Full guides: [references/dimensions/text.md](references/dimensions/text.md) | [references/dimensions/mood.md](references/dimensions/mood.md)
 
-## Auto Mood Selection
+## Style Presets & Compatibility
 
-When `--mood` is omitted, select based on content signals:
-
-| Signals | Mood Level |
-|---------|------------|
-| Professional, corporate, thought leadership, academic, luxury | `subtle` |
-| General, educational, standard, blog, documentation | `balanced` |
-| Launch, announcement, promotion, event, gaming, entertainment | `bold` |
-
-Default: `balanced`
-
-## Compatibility Matrices
-
-### Type × Style
-
-| | elegant | blueprint | notion | warm | minimal | watercolor | bold-editorial | dark-atmospheric |
-|---|:---:|:---:|:---:|:---:|:---:|:---:|:---:|:---:|
-| hero | ✓✓ | ✓ | ✓ | ✓✓ | ✓ | ✓✓ | ✓✓ | ✓✓ |
-| conceptual | ✓✓ | ✓✓ | ✓✓ | ✓ | ✓✓ | ✗ | ✓ | ✓ |
-| typography | ✓✓ | ✓ | ✓✓ | ✓ | ✓✓ | ✓ | ✓✓ | ✓✓ |
-| metaphor | ✓✓ | ✗ | ✓ | ✓✓ | ✓ | ✓✓ | ✓ | ✓ |
-| scene | ✓ | ✗ | ✗ | ✓✓ | ✓ | ✓✓ | ✓ | ✓✓ |
-| minimal | ✓✓ | ✓ | ✓✓ | ✓ | ✓✓ | ✓ | ✗ | ✓ |
-
-### Type × Text
-
-| | none | title-only | title-subtitle | text-rich |
-|---|:---:|:---:|:---:|:---:|
-| hero | ✓ | ✓✓ | ✓✓ | ✓ |
-| conceptual | ✓✓ | ✓✓ | ✓ | ✓ |
-| typography | ✗ | ✓ | ✓✓ | ✓✓ |
-| metaphor | ✓✓ | ✓ | ✓ | ✗ |
-| scene | ✓✓ | ✓ | ✓ | ✗ |
-| minimal | ✓✓ | ✓✓ | ✓ | ✗ |
-
-### Type × Mood
-
-| | subtle | balanced | bold |
-|---|:---:|:---:|:---:|
-| hero | ✓ | ✓✓ | ✓✓ |
-| conceptual | ✓✓ | ✓✓ | ✓ |
-| typography | ✓ | ✓✓ | ✓✓ |
-| metaphor | ✓✓ | ✓✓ | ✓ |
-| scene | ✓✓ | ✓✓ | ✓ |
-| minimal | ✓✓ | ✓✓ | ✗ |
-
-✓✓ = highly recommended | ✓ = compatible | ✗ = not recommended
+- **Style Presets**: `--style X` expands to palette + rendering. See [references/style-presets.md](references/style-presets.md)
+- **Compatibility Matrices**: Palette×Rendering, Type×Rendering, Type×Text, Type×Mood. See [references/compatibility.md](references/compatibility.md)
+  - ✓✓ = highly recommended | ✓ = compatible | ✗ = not recommended
 
 ## File Structure
 
-Each session creates an independent directory named by content slug:
+Output directory depends on `default_output_dir` preference:
+
+| Preference | Output Path |
+|------------|-------------|
+| `same-dir` | `{article-dir}/` |
+| `imgs-subdir` | `{article-dir}/imgs/` |
+| `independent` (default) | `cover-image/{topic-slug}/` |
+| Pasted content | `cover-image/{topic-slug}/` (always) |
 
 ```
-cover-image/{topic-slug}/
+<output-dir>/
 ├── source-{slug}.{ext}    # Source files (text, images, etc.)
+├── refs/                  # Reference images (if provided)
+│   ├── ref-01-{slug}.{ext}
+│   ├── ref-01-{slug}.md   # Description file (optional)
+│   ├── ref-02-{slug}.{ext}
+│   ├── ref-02-{slug}.md   # Description file (optional)
+│   └── extracted-style.md # Verbally extracted style (if no file path)
 ├── prompts/cover.md       # Generation prompt
 └── cover.png              # Output image
 ```
 
-**Slug Generation**:
-1. Extract main topic from content (2-4 words, kebab-case)
-2. Example: "The Future of AI" → `future-of-ai`
-
-**Conflict Resolution**:
-If `cover-image/{topic-slug}/` already exists:
-- Append timestamp: `{topic-slug}-YYYYMMDD-HHMMSS`
-- Example: `ai-future` exists → `ai-future-20260118-143052`
-
-**Source Files**:
-Copy all sources with naming `source-{slug}.{ext}`:
-- `source-article.md`, `source-reference.png`, etc.
-- Multiple sources supported: text, images, files from conversation
+**Slug**: Extract main topic (2-4 words, kebab-case). Example: "The Future of AI" → `future-of-ai`
+**Conflict**: If directory exists, append timestamp: `{topic-slug}-YYYYMMDD-HHMMSS`
+**Source Files**: Copy all sources with naming `source-{slug}.{ext}` (multiple supported)
 
 ## Workflow
 
 ### Progress Checklist
 
-Copy and track progress:
-
 ```
 Cover Image Progress:
-- [ ] Step 0: Check preferences (EXTEND.md) ⚠️ REQUIRED if not found
-- [ ] Step 1: Analyze content
-- [ ] Step 2: Confirm options (4 dimensions) ⚠️ REQUIRED unless --quick or all specified
+- [ ] Step 0: Check preferences (EXTEND.md) ⛔ BLOCKING
+  - [ ] Found → load preferences → continue
+  - [ ] Not found → run first-time setup → MUST complete before Step 1
+- [ ] Step 1: Analyze content + determine output directory
+  - [ ] 1.1 Reference images ⚠️ (if provided)
+    - [ ] File path given → saved to refs/ ✓
+    - [ ] No path → asked user OR extracted verbally
+  - [ ] 1.2 Output directory determined
+- [ ] Step 2: Confirm options (5 dimensions) ⚠️ REQUIRED unless --quick or all specified
 - [ ] Step 3: Create prompt
+  - [ ] References in prompt ONLY if files exist in refs/
+  - [ ] Extracted style/palette appended to prompt body (if no file)
 - [ ] Step 4: Generate image
+  - [ ] 4.1 References verified before generation
+  - [ ] 4.2 Pass refs via --ref if skill supports AND files exist
 - [ ] Step 5: Completion report
 ```
 
 ### Flow
 
 ```
-Input → [Step 0: Preferences/Setup] → Analyze → [Confirm: 4 Dimensions] → Prompt → Generate → Complete
-                                                      ↓
-                                              (skip if --quick or all dimensions specified)
+Input → [Step 0: Preferences] ─┬─ Found → Continue
+                               │
+                               └─ Not found → First-Time Setup ⛔ BLOCKING
+                                              │
+                                              └─ Complete setup → Save EXTEND.md → Continue
+                                                                                      │
+        ┌───────────────────────────────────────────────────────────────────────────┘
+        ↓
+Analyze + Save Refs → [Output Dir ⚠️] → [Confirm: 5 Dimensions] → Prompt → Generate → Complete
+                                                 ↓
+                                        (skip if --quick or all specified)
 ```
 
-### Step 0: Load Preferences (EXTEND.md) ⚠️
+### Step 0: Load Preferences (EXTEND.md) ⛔ BLOCKING
 
-**Purpose**: Load user preferences or run first-time setup. **Do NOT skip setup if EXTEND.md not found.**
+**Purpose**: Load user preferences or run first-time setup.
+
+**CRITICAL**: If EXTEND.md not found, MUST complete first-time setup before ANY other questions or steps. Do NOT proceed to content analysis, do NOT ask about reference images, do NOT ask about dimensions — ONLY complete the preferences setup first.
 
 Use Bash to check EXTEND.md existence (priority order):
 
@@ -279,362 +217,212 @@ test -f .baoyu-skills/baoyu-cover-image/EXTEND.md && echo "project"
 test -f "$HOME/.baoyu-skills/baoyu-cover-image/EXTEND.md" && echo "user"
 ```
 
-┌──────────────────────────────────────────────────┬───────────────────┐
-│                       Path                       │     Location      │
-├──────────────────────────────────────────────────┼───────────────────┤
-│ .baoyu-skills/baoyu-cover-image/EXTEND.md        │ Project directory │
-├──────────────────────────────────────────────────┼───────────────────┤
-│ $HOME/.baoyu-skills/baoyu-cover-image/EXTEND.md  │ User home         │
-└──────────────────────────────────────────────────┴───────────────────┘
+| Result | Action |
+|--------|--------|
+| Found | Read, parse, display preferences summary → Continue to Step 1 |
+| Not found | ⛔ **BLOCKING**: Run first-time setup ONLY ([references/config/first-time-setup.md](references/config/first-time-setup.md)) → Complete and save EXTEND.md → Then continue to Step 1 |
 
-┌───────────┬───────────────────────────────────────────────────────────────────────────┐
-│  Result   │                                  Action                                   │
-├───────────┼───────────────────────────────────────────────────────────────────────────┤
-│ Found     │ Read, parse, display preferences summary (see below) → Continue to Step 1 │
-├───────────┼───────────────────────────────────────────────────────────────────────────┤
-│ Not found │ ⚠️ MUST run first-time setup (see below) → Then continue to Step 1        │
-└───────────┴───────────────────────────────────────────────────────────────────────────┘
-
-**Preferences Summary** (when EXTEND.md found):
-
-Display loaded preferences:
+**Preferences Summary** (when found):
 
 ```
 Preferences loaded from [project/user]:
 • Watermark: [enabled/disabled] [content if enabled]
-• Type: [preferred_type or "auto"]
-• Style: [preferred_style or "auto"]
-• Text: [preferred_text or "title-only"]
-• Mood: [preferred_mood or "balanced"]
-• Aspect: [default_aspect]
-• Quick mode: [enabled/disabled]
-• Language: [language or "auto"]
+• Type/Palette/Rendering: [value or "auto"]
+• Text: [value or "title-only"] | Mood: [value or "balanced"]
+• Aspect: [default_aspect] | Output: [dir or "not set — will ask in Step 1.5"]
+• Quick mode: [enabled/disabled] | Language: [value or "auto"]
 ```
 
-**First-Time Setup** (when EXTEND.md not found):
+**EXTEND.md Supports**: Watermark | Preferred type | Preferred palette | Preferred rendering | Preferred text | Preferred mood | Default aspect ratio | Default output directory | Quick mode | Custom palette definitions | Language preference
 
-**Language**: Use user's input language or saved language preference.
-
-Use AskUserQuestion with ALL questions in ONE call:
-
-**Q1: Watermark**
-```yaml
-header: "Watermark"
-question: "Watermark text for generated cover images?"
-options:
-  - label: "No watermark (Recommended)"
-    description: "Clean covers, can enable later in EXTEND.md"
-```
-
-**Q2: Preferred Type**
-```yaml
-header: "Type"
-question: "Default cover type preference?"
-options:
-  - label: "Auto-select (Recommended)"
-    description: "Choose based on content analysis each time"
-  - label: "hero"
-    description: "Large visual impact - product launch, announcements"
-  - label: "conceptual"
-    description: "Concept visualization - technical, architecture"
-```
-
-**Q3: Preferred Style**
-```yaml
-header: "Style"
-question: "Default cover style preference?"
-options:
-  - label: "Auto-select (Recommended)"
-    description: "Choose based on content analysis each time"
-  - label: "elegant"
-    description: "Refined, sophisticated - professional business"
-  - label: "notion"
-    description: "SaaS dashboard - productivity/tech content"
-```
-
-**Q4: Default Aspect Ratio**
-```yaml
-header: "Aspect"
-question: "Default aspect ratio for cover images?"
-options:
-  - label: "16:9 (Recommended)"
-    description: "Standard widescreen - YouTube, presentations, versatile"
-  - label: "2.35:1"
-    description: "Cinematic widescreen - article headers, blog posts"
-  - label: "1:1"
-    description: "Square - Instagram, WeChat, social cards"
-  - label: "3:4"
-    description: "Portrait - Xiaohongshu, Pinterest, mobile content"
-```
-
-Note: More ratios (4:3, 3:2) available during generation. This sets the default recommendation.
-
-**Q5: Quick Mode**
-```yaml
-header: "Quick"
-question: "Enable quick mode by default?"
-options:
-  - label: "No (Recommended)"
-    description: "Confirm dimension choices each time"
-  - label: "Yes"
-    description: "Skip confirmation, use auto-selection"
-```
-
-**Q6: Save Location**
-```yaml
-header: "Save"
-question: "Where to save preferences?"
-options:
-  - label: "Project (Recommended)"
-    description: ".baoyu-skills/ (this project only)"
-  - label: "User"
-    description: "~/.baoyu-skills/ (all projects)"
-```
-
-**After setup**: Create EXTEND.md with user choices, then continue to Step 1.
-
-Full setup details: `references/config/first-time-setup.md`
-
-**EXTEND.md Supports**: Watermark | Preferred type | Preferred style | Preferred text | Preferred mood | Default aspect ratio | Quick mode | Custom style definitions | Language preference
-
-Schema: `references/config/preferences-schema.md`
+Schema: [references/config/preferences-schema.md](references/config/preferences-schema.md)
 
 ### Step 1: Analyze Content
 
-Read source content, save it if needed, and perform analysis.
+**1.0 Detect & Save Reference Images** ⚠️ REQUIRED if images provided
 
-**Actions**:
-1. **Save source content** (if not already a file):
-   - If user provides a file path: use as-is
-   - If user pastes content: save to `source.md` in target directory
-2. Read source content
-3. **Content analysis**:
-   - Extract: topic, core message, tone, keywords
-   - Identify visual metaphor opportunities
-   - Detect content type (technical/personal/business/creative)
-4. **Language detection**:
-   - Detect source content language
-   - Note user's input language (from conversation)
-   - Compare with language preference in EXTEND.md
+Check if user provided reference images. Handle based on input type:
+
+| Input Type | Action |
+|------------|--------|
+| Image file path provided | Copy to `refs/` subdirectory → can use `--ref` |
+| Image in conversation (no path) | **ASK user for file path** with AskUserQuestion |
+| User can't provide path | Extract style/palette verbally → append to prompt (NO frontmatter references) |
+
+**CRITICAL**: Only add `references` to prompt frontmatter if files are ACTUALLY SAVED to `refs/` directory.
+
+**If user provides file path**:
+1. Copy to `refs/ref-NN-{slug}.{ext}` (NN = 01, 02, ...)
+2. Create description: `refs/ref-NN-{slug}.md`
+3. Verify files exist before proceeding
+
+**If user can't provide path** (extracted verbally):
+1. Analyze image visually, extract: colors, style, composition
+2. Create `refs/extracted-style.md` with extracted info
+3. DO NOT add `references` to prompt frontmatter
+4. Instead, append extracted style/colors directly to prompt text
+
+**Description File Format** (only when file saved):
+```yaml
+---
+ref_id: NN
+filename: ref-NN-{slug}.{ext}
+usage: direct | style | palette
+---
+[User's description or auto-generated description]
+```
+
+| Usage | When to Use |
+|-------|-------------|
+| `direct` | Reference matches desired output closely |
+| `style` | Extract visual style characteristics only |
+| `palette` | Extract color scheme only |
+
+**Verification** (only for saved files):
+```
+Reference Images Saved:
+- ref-01-{slug}.png ✓ (can use --ref)
+- ref-02-{slug}.png ✓ (can use --ref)
+```
+
+**Or for extracted style**:
+```
+Reference Style Extracted (no file):
+- Colors: #E8756D coral, #7ECFC0 mint...
+- Style: minimal flat vector, clean lines...
+→ Will append to prompt text (not --ref)
+```
+
+---
+
+**1.1 Save Source Content**
+- If pasted, save to `source.md` in target directory; if file path, use as-is
+- **Backup rule**: If `source.md` exists, rename to `source-backup-YYYYMMDD-HHMMSS.md`
+
+**1.2 Content Analysis**
+- Extract topic, core message, tone, keywords
+- Identify visual metaphors
+- Detect content type
+
+**1.3 Reference Image Analysis** (if provided in Step 1.0)
+
+For each reference image:
+
+| Analysis | Description |
+|----------|-------------|
+| Visual characteristics | Style, colors, composition |
+| Content/subject | What the reference depicts |
+| Style match | Which type/palette/rendering align |
+| Usage recommendation | `direct` / `style` / `palette` |
+
+**1.4 Language Detection**
+- Detect source language
+- Note user's input language
+- Compare with EXTEND.md preference
+
+**1.5 Determine Output Directory**
+- Per File Structure rules
+- If no `default_output_dir` preference + file path input, include in Step 2 Q4
 
 ### Step 2: Confirm Options ⚠️
 
-**Purpose**: Validate all 4 dimensions + aspect ratio.
+Validate all 5 dimensions + aspect ratio. Full confirmation flow: [references/workflow/confirm-options.md](references/workflow/confirm-options.md)
 
 **Skip Conditions**:
-| Condition | Skipped Questions | Still Asked |
-|-----------|-------------------|-------------|
-| `--quick` flag | Type, Style, Text, Mood | **Aspect Ratio** (unless `--aspect` specified) |
-| All 4 dimensions + `--aspect` specified | All | None |
-| `quick_mode: true` in EXTEND.md | Type, Style, Text, Mood | **Aspect Ratio** (unless `--aspect` specified) |
-| Otherwise | None | All 5 questions |
 
-**Important**: Aspect ratio is ALWAYS asked unless explicitly specified via `--aspect` CLI flag. User presets in EXTEND.md are shown as recommended option, not auto-selected.
-
-**Quick Mode Output** (when skipping 4 dimensions):
-
-```
-Quick Mode: Auto-selected dimensions
-• Type: [type] ([reason])
-• Style: [style] ([reason])
-• Text: [text] ([reason])
-• Mood: [mood] ([reason])
-
-[Then ask Question 5: Aspect Ratio]
-```
-
-**Confirmation Flow** (when NOT skipping):
-
-**Language**: Auto-determined (user's input language > saved preference > source language). No need to ask.
-
-Present options using AskUserQuestion:
-
-**Question 1: Type** (if not specified via `--type`)
-- Show recommended type based on content analysis + preferred type from EXTEND.md
-
-```yaml
-header: "Type"
-question: "Which cover type?"
-multiSelect: false
-options:
-  - label: "[auto-recommended type] (Recommended)"
-    description: "[reason based on content signals]"
-  - label: "hero"
-    description: "Large visual impact, title overlay - product launch, announcements"
-  - label: "conceptual"
-    description: "Concept visualization - technical, architecture"
-  - label: "typography"
-    description: "Text-focused layout - opinions, quotes"
-```
-
-**Question 2: Style** (if not specified via `--style`)
-- Based on selected Type, show compatible styles (✓✓ first from compatibility matrix)
-- Format: `[style name] - [why it fits this content]`
-
-```yaml
-header: "Style"
-question: "Which cover style?"
-multiSelect: false
-options:
-  - label: "[best compatible style] (Recommended)"
-    description: "[reason based on type + content]"
-  - label: "[style2]"
-    description: "[reason]"
-  - label: "[style3]"
-    description: "[reason]"
-```
-
-**Question 3: Text** (if not specified via `--text`)
-- Based on selected Type, show compatible text levels (✓✓ first from compatibility matrix)
-
-```yaml
-header: "Text"
-question: "Text density level?"
-multiSelect: false
-options:
-  - label: "title-only (Recommended)"
-    description: "Simple headline, ≤8 characters"
-  - label: "none"
-    description: "Pure visual, no text elements"
-  - label: "title-subtitle"
-    description: "Title + supporting context"
-  - label: "text-rich"
-    description: "Title + subtitle + keyword tags"
-```
-
-**Question 4: Mood** (if not specified via `--mood`)
-- Based on content analysis, show recommended mood
-
-```yaml
-header: "Mood"
-question: "Emotional intensity?"
-multiSelect: false
-options:
-  - label: "balanced (Recommended)"
-    description: "Medium contrast and saturation, versatile"
-  - label: "subtle"
-    description: "Low contrast, muted colors, calm"
-  - label: "bold"
-    description: "High contrast, vivid colors, dynamic"
-```
-
-**Question 5: Aspect Ratio** (ALWAYS ask unless `--aspect` specified via CLI)
-
-Note: Even if user has a preset in EXTEND.md, still ask this question. The preset is shown as the recommended option.
-
-```yaml
-header: "Aspect"
-question: "Cover aspect ratio?"
-multiSelect: false
-options:
-  - label: "[user preset or 16:9] (Recommended)"
-    description: "[based on preset or default: Standard widescreen, versatile]"
-  - label: "2.35:1"
-    description: "Cinematic widescreen - article headers, blog posts"
-  - label: "4:3"
-    description: "Traditional screen - PPT slides, classic displays"
-  - label: "3:2"
-    description: "Photography ratio - blog articles, Medium posts"
-  - label: "1:1"
-    description: "Square - Instagram, WeChat moments, social cards"
-  - label: "3:4"
-    description: "Portrait - Xiaohongshu, Pinterest, mobile-first content"
-```
-
-**After response**: Proceed to Step 3 with confirmed dimensions.
+| Condition | Skipped | Still Asked |
+|-----------|---------|-------------|
+| `--quick` or `quick_mode: true` | 5 dimensions | Aspect ratio (unless `--aspect`) |
+| All 5 + `--aspect` specified | All | None |
 
 ### Step 3: Create Prompt
 
-Save to `prompts/cover.md`:
+**Backup rule**: If `prompts/cover.md` exists, rename to `prompts/cover-backup-YYYYMMDD-HHMMSS.md`
 
-```markdown
-# Content Context
-Article title: [full original title from source]
-Content summary: [2-3 sentence summary of key points and themes]
-Keywords: [5-8 key terms extracted from content]
+Save to `prompts/cover.md`. Full template: [references/workflow/prompt-template.md](references/workflow/prompt-template.md)
 
-# Visual Design
-Cover theme: [2-3 words visual interpretation]
-Type: [confirmed type]
-Style: [confirmed style]
-Text level: [confirmed text level]
-Mood: [confirmed mood]
-Aspect ratio: [confirmed ratio]
-Language: [confirmed language]
+**CRITICAL - References in YAML Frontmatter**:
 
-# Text Elements
-[Based on text level:]
-- none: "No text elements"
-- title-only: "Title: [max 8 chars headline]"
-- title-subtitle: "Title: [headline] / Subtitle: [max 15 chars context]"
-- text-rich: "Title: [headline] / Subtitle: [context] / Tags: [2-4 keywords]"
+When reference files are saved to `refs/`, **MUST add `references` field in frontmatter**:
 
-# Mood Application
-[Based on mood level:]
-- subtle: "Use low contrast, muted colors, light visual weight, calm aesthetic"
-- balanced: "Use medium contrast, normal saturation, balanced visual weight"
-- bold: "Use high contrast, vivid saturated colors, heavy visual weight, dynamic energy"
-
-# Composition
-Type composition:
-- [Type-specific layout and structure]
-
-Visual composition:
-- Main visual: [metaphor derived from content meaning]
-- Layout: [positioning based on type and aspect ratio]
-- Decorative: [style elements that reinforce content theme]
-
-Color scheme: [primary, background, accent from style, adjusted by mood]
-Type notes: [key characteristics from type definition]
-Style notes: [key characteristics from style definition]
-
-[Watermark section if enabled]
+```yaml
+---
+type: cover
+palette: warm
+rendering: flat-vector
+references:
+  - ref_id: 01
+    filename: refs/ref-01-podcast-thumbnail.jpg
+    usage: style
+---
 ```
 
-**Content-Driven Design**:
-- Article title and summary inform the visual metaphor choice
-- Keywords guide decorative elements and symbols
-- The skill controls visual style; the content drives meaning
+| Rule | Action |
+|------|--------|
+| Files saved to `refs/` | Add to frontmatter `references` list |
+| Style extracted verbally (no file) | Omit `references` field, describe in body |
+| Before writing | Verify: `test -f refs/ref-NN-{slug}.{ext}` |
 
-**Type-Specific Composition**:
+**Reference Embedding**:
 
-| Type | Composition Guidelines |
-|------|------------------------|
-| `hero` | Large focal visual (60-70% area), title overlay on visual, dramatic composition |
-| `conceptual` | Abstract shapes representing core concepts, information hierarchy, clean zones |
-| `typography` | Title as primary element (40%+ area), minimal supporting visuals, strong hierarchy |
-| `metaphor` | Concrete object/scene representing abstract idea, symbolic elements, emotional resonance |
-| `scene` | Atmospheric environment, narrative elements, mood-setting lighting and colors |
-| `minimal` | Single focal element, generous whitespace (60%+), essential shapes only |
-
-**Title guidelines** (when text level includes title):
-- Max 8 characters, punchy headline
-- Use hooks: numbers, questions, contrasts
-- Match confirmed language
-
-**Watermark Application** (if enabled in preferences):
-Add to prompt:
-```
-Include a subtle watermark "[content]" positioned at [position].
-The watermark should be legible but not distracting from the main content.
-```
-Reference: `references/config/watermark-guide.md`
+| Situation | Frontmatter | Body |
+|-----------|-------------|------|
+| Reference file saved to `refs/` | Add to `references` ✓ | Brief style note |
+| Style extracted verbally (no file) | Omit `references` | Full style description |
+| File in frontmatter but doesn't exist | ERROR - fix or remove | — |
 
 ### Step 4: Generate Image
 
-**Backup Existing Cover** (if regenerating):
-If `cover.png` already exists in the output directory:
-- Rename to `cover-backup-YYYYMMDD-HHMMSS.png`
+**4.1 Backup existing** `cover.png` → `cover-backup-YYYYMMDD-HHMMSS.png` (if regenerating)
 
-**Image Generation Skill Selection**:
-1. Check available image generation skills
-2. If multiple skills available, ask user preference
-3. Call selected skill with:
-   - Prompt file path
-   - Output image path: `cover.png`
-   - Aspect ratio parameter
+**4.2 Check available image generation skills**; if multiple, ask user preference
 
-**On failure**: Auto-retry once before reporting error.
+**4.3 Process References** ⚠️ REQUIRED if references in frontmatter
+
+**Read `references` from prompt frontmatter** and process each entry:
+
+1. **Parse frontmatter** to get references list:
+   ```yaml
+   references:
+     - ref_id: 01
+       filename: refs/ref-01-podcast-thumbnail.jpg
+       usage: style
+   ```
+
+2. **VERIFY each file exists**:
+   ```bash
+   test -f refs/ref-NN-{slug}.{ext} && echo "exists" || echo "MISSING"
+   ```
+   - If file MISSING → ERROR, fix prompt or remove from references
+   - If file exists → proceed with processing
+
+3. Process based on `usage` type:
+
+| Usage | Action | Example |
+|-------|--------|---------|
+| `direct` | Add reference path to `--ref` parameter | `--ref refs/ref-01-brand.png` |
+| `style` | Analyze reference, append style traits to prompt | "Style: clean lines, gradient backgrounds..." |
+| `palette` | Extract colors from reference, append to prompt | "Colors: #E8756D coral, #7ECFC0 mint..." |
+
+3. Check image generation skill capability:
+
+| Skill Supports `--ref` | Action |
+|------------------------|--------|
+| Yes (e.g., baoyu-image-gen with Google) | Pass reference images via `--ref` |
+| No | Convert to text description, append to prompt |
+
+**Verification**: Before generating, confirm reference processing:
+```
+Reference Processing:
+- ref-01-brand.png: using as direct reference ✓
+- ref-02-style.png: extracted palette ✓
+```
+
+**4.4 Generate**
+
+1. Call selected skill with prompt file path, output path (`cover.png`), aspect ratio
+2. If references with `direct` usage AND skill supports `--ref`: include `--ref` parameter
+3. On failure: auto-retry once before reporting error
 
 ### Step 5: Completion Report
 
@@ -642,18 +430,18 @@ If `cover.png` already exists in the output directory:
 Cover Generated!
 
 Topic: [topic]
-Type: [type name]
-Style: [style name]
-Text: [text level]
-Mood: [mood level]
-Aspect: [ratio]
+Type: [type] | Palette: [palette] | Rendering: [rendering]
+Text: [text] | Mood: [mood] | Aspect: [ratio]
 Title: [title text or "visual only"]
-Language: [lang]
-Watermark: [enabled/disabled]
+Language: [lang] | Watermark: [enabled/disabled]
+References: [N images (direct/style/palette) or "extracted style" or "none"]
 Location: [directory path]
 
 Files:
 ✓ source-{slug}.{ext}
+[✓ refs/ref-01-{slug}.{ext} ... (if references saved)]
+[✓ refs/ref-01-{slug}.md ... (description files)]
+[✓ refs/extracted-style.md (if style extracted verbally)]
 ✓ prompts/cover.md
 ✓ cover.png
 [✓ cover-backup-{timestamp}.png (if regenerated)]
@@ -663,39 +451,47 @@ Files:
 
 | Action | Steps |
 |--------|-------|
-| **Regenerate** | Backup existing → Update prompt → Regenerate with same settings |
-| **Change type** | Backup existing → Confirm new type → Update prompt → Regenerate |
-| **Change style** | Backup existing → Confirm new style → Update prompt → Regenerate |
-| **Change text** | Backup existing → Confirm new text level → Update prompt → Regenerate |
-| **Change mood** | Backup existing → Confirm new mood → Update prompt → Regenerate |
-| **Change aspect** | Backup existing → Confirm new aspect → Update prompt → Regenerate |
+| **Regenerate** | Backup existing → **Update prompt file FIRST** → Regenerate with same settings |
+| **Change dimension** | Backup existing → Confirm new value → **Update prompt file FIRST** → Regenerate |
 
-All modifications automatically backup the existing `cover.png` before regenerating.
+**IMPORTANT**: When regenerating, ALWAYS update the prompt file (`prompts/cover.md`) FIRST before regenerating. This ensures changes are documented and reproducible.
+
+All modifications automatically backup existing `cover.png` before regenerating.
 
 ## Notes
 
 - Cover must be readable at small preview sizes
 - Visual metaphors > literal representations
-- Title: max 8 chars, readable, impactful
-- **Two confirmation points**: Step 0 (first-time setup if no EXTEND.md) + Step 2 (options) - can skip Step 2 with `--quick`
+- Title: readable, impactful
+- Two confirmation points: Step 0 (first-time setup) + Step 2 (options) - skip Step 2 with `--quick`
 - Use confirmed language for title text
 - Maintain watermark consistency if enabled
 - Check compatibility matrices when selecting combinations
-- `--no-title` is preserved as alias for `--text none`
+- `--no-title` is alias for `--text none`
+- `--style` presets are backward-compatible; explicit `--palette`/`--rendering` override preset values
+
+### Composition Principles
+
+- **Generous whitespace**: 40-60% breathing room; avoid cluttered layouts
+- **Visual anchor**: Main element centered or offset left (reserve right for title)
+- **Character handling**: Simplified silhouettes or icon-style figures; NO realistic humans
+- **Icon vocabulary**: Use simple, recognizable symbols (see [references/visual-elements.md](references/visual-elements.md))
+
+### Title Handling
+
+- **Source**: Use the exact title provided by user, or extract from source content
+- **Do NOT invent titles**: Stay faithful to the original
+- If no title in source and user doesn't provide one, ask user to specify
 
 ## References
 
-**Dimensions**:
-- `references/dimensions/text.md` - Text density dimension
-- `references/dimensions/mood.md` - Mood intensity dimension
-
-**Styles**: `references/styles/<name>.md` - Style definitions
-
-**Config**:
-- `references/config/preferences-schema.md` - EXTEND.md schema
-- `references/config/first-time-setup.md` - First-time setup flow
-- `references/config/watermark-guide.md` - Watermark configuration
-
-## Extension Support
-
-Custom configurations via EXTEND.md. See **Step 0** for paths and supported options.
+**Dimensions**: [text.md](references/dimensions/text.md) | [mood.md](references/dimensions/mood.md)
+**Palettes**: [references/palettes/](references/palettes/)
+**Renderings**: [references/renderings/](references/renderings/)
+**Auto-Selection**: [references/auto-selection.md](references/auto-selection.md)
+**Style Presets**: [references/style-presets.md](references/style-presets.md)
+**Compatibility**: [references/compatibility.md](references/compatibility.md)
+**Types**: [references/types.md](references/types.md)
+**Visual Elements**: [references/visual-elements.md](references/visual-elements.md)
+**Workflow**: [confirm-options.md](references/workflow/confirm-options.md) | [prompt-template.md](references/workflow/prompt-template.md)
+**Config**: [preferences-schema.md](references/config/preferences-schema.md) | [first-time-setup.md](references/config/first-time-setup.md) | [watermark-guide.md](references/config/watermark-guide.md)

skills/baoyu-cover-image/references/auto-selection.md

@@ -0,0 +1,60 @@
+# Auto-Selection Rules
+
+When a dimension is omitted, select based on content signals.
+
+## Auto Type Selection
+
+| Signals | Type |
+|---------|------|
+| Product, launch, announcement, release, reveal | `hero` |
+| Architecture, framework, system, API, technical, model | `conceptual` |
+| Quote, opinion, insight, thought, headline, statement | `typography` |
+| Philosophy, growth, abstract, meaning, reflection | `metaphor` |
+| Story, journey, travel, lifestyle, experience, narrative | `scene` |
+| Zen, focus, essential, core, simple, pure | `minimal` |
+
+## Auto Palette Selection
+
+| Signals | Palette |
+|---------|---------|
+| Personal story, emotion, lifestyle, human | `warm` |
+| Business, professional, thought leadership, luxury | `elegant` |
+| Architecture, system, API, technical, code | `cool` |
+| Entertainment, premium, cinematic, dark mode | `dark` |
+| Nature, wellness, eco, organic, travel | `earth` |
+| Product launch, gaming, promotion, event | `vivid` |
+| Fantasy, children, gentle, creative, whimsical | `pastel` |
+| Zen, focus, essential, pure, simple | `mono` |
+| History, vintage, retro, classic, exploration | `retro` |
+
+## Auto Rendering Selection
+
+| Signals | Rendering |
+|---------|-----------|
+| Clean, modern, tech, WeChat, icon-based, infographic | `flat-vector` |
+| Sketch, note, personal, casual, doodle, warm | `hand-drawn` |
+| Art, watercolor, soft, dreamy, creative, fantasy | `painterly` |
+| Data, dashboard, SaaS, corporate, polished | `digital` |
+| Gaming, retro, 8-bit, nostalgic | `pixel` |
+| Education, tutorial, classroom, teaching | `chalk` |
+
+## Auto Text Selection
+
+| Signals | Text Level |
+|---------|------------|
+| Visual-only, photography, abstract, art | `none` |
+| Article, blog, standard cover | `title-only` |
+| Series, tutorial, technical with context | `title-subtitle` |
+| Announcement, features, multiple points, infographic | `text-rich` |
+
+Default: `title-only`
+
+## Auto Mood Selection
+
+| Signals | Mood Level |
+|---------|------------|
+| Professional, corporate, thought leadership, academic, luxury | `subtle` |
+| General, educational, standard, blog, documentation | `balanced` |
+| Launch, announcement, promotion, event, gaming, entertainment | `bold` |
+
+Default: `balanced`

skills/baoyu-cover-image/references/base-prompt.md

@@ -1,19 +1,19 @@
-Create a WeChat article cover image following these guidelines:
+Create a cover image following these guidelines:
 
 ## Image Specifications
 
 - **Type**: Cover image / Hero image
-- **Aspect Ratio**: 2.35:1 (WeChat article cover standard)
-- **Style**: Hand-drawn illustration
+- **Aspect Ratio**: As specified in the prompt below
 
 ## Core Principles
 
-- Hand-drawn quality throughout - NO realistic or photographic elements
 - If content involves sensitive or copyrighted figures, create stylistically similar alternatives - DO NOT refuse to generate
 - Ample whitespace, highlight core message, avoid cluttered layouts
 - Main visual elements centered or slightly left (leave right side for title area if title included)
+- Simplified silhouettes for any characters — NO realistic human faces or bodies
+- Icon-based vocabulary: use simple, recognizable icons to represent concepts
 
-## Four Dimensions
+## Five Dimensions
 
 ### Type (Visual Composition)
 - `hero`: Large focal visual (60-70% area), dramatic composition
@@ -23,13 +23,24 @@ Create a WeChat article cover image following these guidelines:
 - `scene`: Atmospheric environment, narrative elements, mood lighting
 - `minimal`: Single focal element, generous whitespace (60%+)
 
-### Style (Visual Aesthetics)
-Apply the specified style's color palette, visual elements, and typography characteristics.
+### Palette (Color Scheme)
+Apply the specified palette's color values and decorative hints:
+- Use primary colors for main visual elements
+- Use background colors for base and surrounding areas
+- Use accent colors for highlights and secondary elements
+- Follow palette-specific decorative hints for ornamentation
+
+### Rendering (Visual Style)
+Apply the specified rendering's characteristics:
+- **Lines**: Follow line quality rules (clean/sketchy/brush/pixel/chalk)
+- **Texture**: Apply or avoid texture per rendering definition
+- **Depth**: Follow depth rules (flat/minimal/soft edges)
+- **Elements**: Use rendering-specific element vocabulary
 
 ### Text (Density Level)
 - `none`: No text elements, full visual area
-- `title-only`: Single headline (≤8 characters), 85% visual area
-- `title-subtitle`: Title + context (≤15 chars), 75% visual area
+- `title-only`: Single headline, 85% visual area
+- `title-subtitle`: Title + context, 75% visual area
 - `text-rich`: Title + subtitle + 2-4 keyword tags, 60% visual area
 
 ### Mood (Emotional Intensity)
@@ -39,16 +50,48 @@ Apply the specified style's color palette, visual elements, and typography chara
 
 ## Text Style (When Title Included)
 
-- **ALL text MUST be hand-drawn style**
-- Title text: Large, eye-catching, max 8 characters
-- Subtitle: Secondary, max 15 characters (if title-subtitle or text-rich)
+- **Title source**: Use the exact title provided by user, or extract from source content. Do NOT invent or modify titles.
+- Title text: Large, eye-catching, faithful to source
+- Subtitle: Secondary element (if title-subtitle or text-rich)
 - Tags: 2-4 keyword badges (if text-rich)
-- Font style harmonizes with illustration style
-- **DO NOT use realistic or computer-generated fonts**
+- Font style harmonizes with rendering style
+
+## Composition Guidance
+
+### Layout Principles
+
+- **Generous whitespace**: Maintain 40-60% breathing room; avoid cluttered compositions
+- **Visual anchor placement**: Main element centered or offset left (reserve right side for title if included)
+- **Information hierarchy**: One dominant focal point, 1-2 supporting elements, decorative accents
+- **Clean backgrounds**: Solid colors or subtle gradients; no complex textures or patterns
+
+### Icon & Symbol Vocabulary
+
+Represent concepts with simple, recognizable icons rather than detailed illustrations:
+
+| Category | Examples |
+|----------|----------|
+| Tech | Code window, gear, circuit, cloud, lock, API brackets |
+| Ideas | Lightbulb, rocket, target, puzzle, key, magnifier |
+| Communication | Speech bubble, chat dots, megaphone, mail |
+| Growth | Plant/sprout, tree, arrow, chart, mountain |
+| Tools | Wrench, pencil, brush, checklist, clock |
+
+Use the rendering style to determine icon complexity (flat-vector = geometric, hand-drawn = sketchy, etc.)
+
+Full library: [references/visual-elements.md](visual-elements.md)
+
+### Character Handling
+
+When people are needed:
+- Use simplified silhouettes or abstract stick figures
+- Symbolic representations (head + shoulders outline)
+- NO realistic faces, detailed anatomy, or photographic representations
+- Cartoon/icon style consistent with rendering choice
 
 ## Mood Application
 
-Apply mood adjustments to the base style:
+Apply mood adjustments to the base palette:
 
 | Mood | Contrast | Saturation | Weight |
 |------|----------|------------|--------|
@@ -61,6 +104,16 @@ Apply mood adjustments to the base style:
 - Use the same language as the content provided below for any text elements
 - Match punctuation style to the content language
 
+## Reference Images
+
+When reference images are provided:
+
+- **Style extraction**: Identify rendering technique, line quality, texture, and visual vocabulary
+- **Composition learning**: Note layout patterns, whitespace usage, element placement
+- **Mood matching**: Capture the emotional tone and visual weight
+- **Adaptation**: Apply extracted characteristics while respecting the specified Type, Palette, and Rendering dimensions
+- **Priority**: If reference style conflicts with specified dimensions, dimensions take precedence for structural choices; reference influences decorative details
+
 ---
 
-Please use nano banana pro to generate the cover image based on the content provided below:
+Please generate the cover image based on the content provided below:

skills/baoyu-cover-image/references/compatibility.md

@@ -0,0 +1,50 @@
+# Compatibility Matrices
+
+✓✓ = highly recommended | ✓ = compatible | ✗ = not recommended
+
+## Palette × Rendering
+
+| | flat-vector | hand-drawn | painterly | digital | pixel | chalk |
+|---|:---:|:---:|:---:|:---:|:---:|:---:|
+| warm | ✓✓ | ✓✓ | ✓ | ✓ | ✓ | ✓ |
+| elegant | ✓ | ✓✓ | ✓ | ✓✓ | ✗ | ✗ |
+| cool | ✓✓ | ✓ | ✗ | ✓✓ | ✓ | ✓ |
+| dark | ✓ | ✓ | ✓ | ✓✓ | ✓ | ✓✓ |
+| earth | ✓ | ✓✓ | ✓✓ | ✓ | ✗ | ✗ |
+| vivid | ✓✓ | ✓ | ✓ | ✓ | ✓✓ | ✓ |
+| pastel | ✓✓ | ✓✓ | ✓✓ | ✓ | ✗ | ✗ |
+| mono | ✓✓ | ✓ | ✗ | ✓✓ | ✓ | ✓ |
+| retro | ✓✓ | ✓✓ | ✓ | ✓✓ | ✓ | ✗ |
+
+## Type × Rendering
+
+| | flat-vector | hand-drawn | painterly | digital | pixel | chalk |
+|---|:---:|:---:|:---:|:---:|:---:|:---:|
+| hero | ✓ | ✓✓ | ✓✓ | ✓✓ | ✓ | ✓ |
+| conceptual | ✓✓ | ✓ | ✗ | ✓✓ | ✓ | ✓ |
+| typography | ✓✓ | ✓ | ✓ | ✓✓ | ✓ | ✓ |
+| metaphor | ✓ | ✓✓ | ✓✓ | ✓ | ✗ | ✓ |
+| scene | ✗ | ✓ | ✓✓ | ✓ | ✓ | ✗ |
+| minimal | ✓✓ | ✓ | ✓ | ✓✓ | ✗ | ✗ |
+
+## Type × Text
+
+| | none | title-only | title-subtitle | text-rich |
+|---|:---:|:---:|:---:|:---:|
+| hero | ✓ | ✓✓ | ✓✓ | ✓ |
+| conceptual | ✓✓ | ✓✓ | ✓ | ✓ |
+| typography | ✗ | ✓ | ✓✓ | ✓✓ |
+| metaphor | ✓✓ | ✓ | ✓ | ✗ |
+| scene | ✓✓ | ✓ | ✓ | ✗ |
+| minimal | ✓✓ | ✓✓ | ✓ | ✗ |
+
+## Type × Mood
+
+| | subtle | balanced | bold |
+|---|:---:|:---:|:---:|
+| hero | ✓ | ✓✓ | ✓✓ |
+| conceptual | ✓✓ | ✓✓ | ✓ |
+| typography | ✓ | ✓✓ | ✓✓ |
+| metaphor | ✓✓ | ✓✓ | ✓ |
+| scene | ✓✓ | ✓✓ | ✓ |
+| minimal | ✓✓ | ✓✓ | ✗ |

skills/baoyu-cover-image/references/config/first-time-setup.md

@@ -9,6 +9,14 @@ description: First-time setup flow for baoyu-cover-image preferences
 
 When no EXTEND.md is found, guide user through preference setup.
 
+**⛔ BLOCKING OPERATION**: This setup MUST complete before ANY other workflow steps. Do NOT:
+- Ask about reference images
+- Ask about content/article
+- Ask about dimensions (type, palette, rendering)
+- Proceed to content analysis
+
+ONLY ask the questions in this setup flow, save EXTEND.md, then continue.
+
 ## Setup Flow
 
 ```
@@ -33,69 +41,99 @@ No EXTEND.md found
 
 **Language**: Use user's input language or saved language preference.
 
-Use single AskUserQuestion with multiple questions (AskUserQuestion auto-adds "Other" option):
+Use AskUserQuestion with ALL questions in ONE call:
 
 ### Question 1: Watermark
 
-```
+```yaml
 header: "Watermark"
-question: "Watermark text for generated cover images? Type your watermark content (e.g., name, @handle)"
+question: "Watermark text for generated cover images?"
 options:
   - label: "No watermark (Recommended)"
-    description: "No watermark, can enable later in EXTEND.md"
+    description: "Clean covers, can enable later in EXTEND.md"
 ```
 
-Position defaults to bottom-right.
-
 ### Question 2: Preferred Type
 
-```
+```yaml
 header: "Type"
 question: "Default cover type preference?"
 options:
-  - label: "None (Recommended)"
-    description: "Auto-select based on content analysis"
+  - label: "Auto-select (Recommended)"
+    description: "Choose based on content analysis each time"
   - label: "hero"
     description: "Large visual impact - product launch, announcements"
   - label: "conceptual"
     description: "Concept visualization - technical, architecture"
-  - label: "typography"
-    description: "Text-focused layout - opinions, quotes"
 ```
 
-### Question 3: Preferred Style
+### Question 3: Preferred Palette
 
-```
-header: "Style"
-question: "Default cover style preference? Or type another style name"
+```yaml
+header: "Palette"
+question: "Default color palette preference?"
 options:
-  - label: "None (Recommended)"
-    description: "Auto-select based on content analysis"
+  - label: "Auto-select (Recommended)"
+    description: "Choose based on content analysis each time"
   - label: "elegant"
-    description: "Refined, sophisticated - professional business"
-  - label: "blueprint"
-    description: "Technical schematics - architecture/system design"
-  - label: "notion"
-    description: "SaaS dashboard - productivity/tech content"
+    description: "Sophisticated - soft coral, muted teal, dusty rose"
+  - label: "warm"
+    description: "Friendly - orange, golden yellow, terracotta"
+  - label: "cool"
+    description: "Technical - engineering blue, navy, cyan"
 ```
 
-### Question 4: Default Aspect Ratio
+### Question 4: Preferred Rendering
 
+```yaml
+header: "Rendering"
+question: "Default rendering style preference?"
+options:
+  - label: "Auto-select (Recommended)"
+    description: "Choose based on content analysis each time"
+  - label: "hand-drawn"
+    description: "Sketchy organic illustration with personal touch"
+  - label: "flat-vector"
+    description: "Clean modern vector with geometric shapes"
+  - label: "digital"
+    description: "Polished precise digital illustration"
 ```
+
+### Question 5: Default Aspect Ratio
+
+```yaml
 header: "Aspect"
 question: "Default aspect ratio for cover images?"
 options:
-  - label: "2.35:1 (Recommended)"
-    description: "Cinematic widescreen, best for article headers"
-  - label: "16:9"
-    description: "Standard widescreen, versatile"
+  - label: "16:9 (Recommended)"
+    description: "Standard widescreen - YouTube, presentations, versatile"
+  - label: "2.35:1"
+    description: "Cinematic widescreen - article headers, blog posts"
   - label: "1:1"
-    description: "Square, social media friendly"
+    description: "Square - Instagram, WeChat, social cards"
+  - label: "3:4"
+    description: "Portrait - Xiaohongshu, Pinterest, mobile content"
 ```
 
-### Question 5: Quick Mode
+Note: More ratios (4:3, 3:2) available during generation. This sets the default recommendation.
 
+### Question 6: Default Output Directory
+
+```yaml
+header: "Output"
+question: "Default output directory for cover images?"
+options:
+  - label: "Independent (Recommended)"
+    description: "cover-image/{topic-slug}/ - separate from article"
+  - label: "Same directory"
+    description: "{article-dir}/ - alongside the article file"
+  - label: "imgs subdirectory"
+    description: "{article-dir}/imgs/ - images folder near article"
 ```
+
+### Question 7: Quick Mode
+
+```yaml
 header: "Quick"
 question: "Enable quick mode by default?"
 options:
@@ -105,13 +143,13 @@ options:
     description: "Skip confirmation, use auto-selection"
 ```
 
-### Question 6: Save Location
+### Question 8: Save Location
 
-```
+```yaml
 header: "Save"
 question: "Where to save preferences?"
 options:
-  - label: "Project"
+  - label: "Project (Recommended)"
     description: ".baoyu-skills/ (this project only)"
   - label: "User"
     description: "~/.baoyu-skills/ (all projects)"
@@ -135,36 +173,30 @@ options:
 
 ```yaml
 ---
-version: 2
+version: 3
 watermark:
   enabled: [true/false]
   content: "[user input or empty]"
   position: bottom-right
   opacity: 0.7
 preferred_type: [selected type or null]
-preferred_style: [selected style or null]
+preferred_palette: [selected palette or null]
+preferred_rendering: [selected rendering or null]
 preferred_text: title-only
 preferred_mood: balanced
-default_aspect: [2.35:1/16:9/1:1]
+default_aspect: [16:9/2.35:1/1:1/3:4]
+default_output_dir: [independent/same-dir/imgs-subdir]
 quick_mode: [true/false]
 language: null
-custom_styles: []
+custom_palettes: []
 ---
 ```
 
-## New Fields in v2
-
-| Field | Default | Description |
-|-------|---------|-------------|
-| `preferred_text` | title-only | Text density (none, title-only, title-subtitle, text-rich) |
-| `preferred_mood` | balanced | Mood intensity (subtle, balanced, bold) |
-| `quick_mode` | false | Skip confirmation step when true |
-
-Note: Text and Mood preferences use sensible defaults (title-only, balanced) and don't require setup questions. Users can modify these in EXTEND.md directly.
-
 ## Modifying Preferences Later
 
 Users can edit EXTEND.md directly or run setup again:
 - Delete EXTEND.md to trigger setup
 - Edit YAML frontmatter for quick changes
-- Full schema: `config/preferences-schema.md`
+- Full schema: `preferences-schema.md`
+
+**EXTEND.md Supports**: Watermark | Preferred type | Preferred palette | Preferred rendering | Preferred text | Preferred mood | Default aspect ratio | Default output directory | Quick mode | Custom palette definitions | Language preference

skills/baoyu-cover-image/references/config/preferences-schema.md

@@ -9,7 +9,7 @@ description: EXTEND.md YAML schema for baoyu-cover-image user preferences
 
 ```yaml
 ---
-version: 2
+version: 3
 
 watermark:
   enabled: false
@@ -18,7 +18,9 @@ watermark:
 
 preferred_type: null      # hero|conceptual|typography|metaphor|scene|minimal or null for auto-select
 
-preferred_style: null     # Built-in style name or null for auto-select
+preferred_palette: null   # warm|elegant|cool|dark|earth|vivid|pastel|mono|retro or null for auto-select
+
+preferred_rendering: null # flat-vector|hand-drawn|painterly|digital|pixel|chalk or null for auto-select
 
 preferred_text: title-only  # none|title-only|title-subtitle|text-rich
 
@@ -30,15 +32,14 @@ quick_mode: false         # Skip confirmation when true
 
 language: null            # zh|en|ja|ko|auto (null = auto-detect)
 
-custom_styles:
-  - name: my-style
-    description: "Style description"
-    color_palette:
+custom_palettes:
+  - name: my-palette
+    description: "Palette description"
+    colors:
       primary: ["#1E3A5F", "#4A90D9"]
       background: "#F5F7FA"
       accents: ["#00B4D8"]
-    visual_elements: "Clean lines, geometric shapes"
-    typography: "Modern sans-serif"
+    decorative_hints: "Clean lines, geometric shapes"
     best_for: "Business, tech content"
 ---
 ```
@@ -47,18 +48,19 @@ custom_styles:
 
 | Field | Type | Default | Description |
 |-------|------|---------|-------------|
-| `version` | int | 2 | Schema version |
+| `version` | int | 3 | Schema version |
 | `watermark.enabled` | bool | false | Enable watermark |
 | `watermark.content` | string | "" | Watermark text (@username or custom) |
 | `watermark.position` | enum | bottom-right | Position on image |
 | `preferred_type` | string | null | Type name or null for auto |
-| `preferred_style` | string | null | Style name or null for auto |
+| `preferred_palette` | string | null | Palette name or null for auto |
+| `preferred_rendering` | string | null | Rendering name or null for auto |
 | `preferred_text` | string | title-only | Text density level |
 | `preferred_mood` | string | balanced | Mood intensity level |
 | `default_aspect` | string | "2.35:1" | Default aspect ratio |
 | `quick_mode` | bool | false | Skip confirmation step |
 | `language` | string | null | Output language (null = auto-detect) |
-| `custom_styles` | array | [] | User-defined styles |
+| `custom_palettes` | array | [] | User-defined palettes |
 
 ## Type Options
 
@@ -71,13 +73,38 @@ custom_styles:
 | `scene` | Atmospheric scene, narrative feel |
 | `minimal` | Minimalist composition, generous whitespace |
 
+## Palette Options
+
+| Value | Description |
+|-------|-------------|
+| `warm` | Friendly, approachable — orange, golden yellow, terracotta |
+| `elegant` | Sophisticated, refined — soft coral, muted teal, dusty rose |
+| `cool` | Technical, professional — engineering blue, navy, cyan |
+| `dark` | Cinematic, premium — electric purple, cyan, magenta |
+| `earth` | Natural, organic — forest green, sage, earth brown |
+| `vivid` | Energetic, bold — bright red, neon green, electric blue |
+| `pastel` | Gentle, whimsical — soft pink, mint, lavender |
+| `mono` | Clean, focused — black, near-black, white |
+| `retro` | Nostalgic, vintage — muted orange, dusty pink, maroon |
+
+## Rendering Options
+
+| Value | Description |
+|-------|-------------|
+| `flat-vector` | Clean outlines, uniform fills, geometric icons |
+| `hand-drawn` | Sketchy, organic, imperfect strokes, paper texture |
+| `painterly` | Soft brush strokes, color bleeds, watercolor feel |
+| `digital` | Polished, precise edges, subtle gradients, UI components |
+| `pixel` | Pixel grid, dithering, chunky 8-bit shapes |
+| `chalk` | Chalk strokes, dust effects, blackboard texture |
+
 ## Text Options
 
 | Value | Description |
 |-------|-------------|
 | `none` | Pure visual, no text elements |
-| `title-only` | Single headline (≤8 characters) |
-| `title-subtitle` | Title + subtitle (≤15 characters) |
+| `title-only` | Single headline |
+| `title-subtitle` | Title + subtitle |
 | `text-rich` | Title + subtitle + keyword tags (2-4) |
 
 ## Mood Options
@@ -105,29 +132,29 @@ custom_styles:
 | `16:9` | Standard widescreen | Presentations, video thumbnails |
 | `1:1` | Square | Social media, profile images |
 
-## Custom Style Fields
+## Custom Palette Fields
 
 | Field | Required | Description |
 |-------|----------|-------------|
-| `name` | Yes | Unique style identifier (kebab-case) |
-| `description` | Yes | What the style conveys |
-| `color_palette.primary` | No | Main colors (array) |
-| `color_palette.background` | No | Background color |
-| `color_palette.accents` | No | Accent colors (array) |
-| `visual_elements` | No | Decorative elements |
-| `typography` | No | Font/lettering style |
+| `name` | Yes | Unique palette identifier (kebab-case) |
+| `description` | Yes | What the palette conveys |
+| `colors.primary` | No | Main colors (array of hex) |
+| `colors.background` | No | Background color (hex) |
+| `colors.accents` | No | Accent colors (array of hex) |
+| `decorative_hints` | No | Decorative elements and patterns |
 | `best_for` | No | Recommended content types |
 
 ## Example: Minimal Preferences
 
 ```yaml
 ---
-version: 2
+version: 3
 watermark:
   enabled: true
   content: "@myhandle"
 preferred_type: null
-preferred_style: elegant
+preferred_palette: elegant
+preferred_rendering: hand-drawn
 preferred_text: title-only
 preferred_mood: balanced
 quick_mode: false
@@ -138,7 +165,7 @@ quick_mode: false
 
 ```yaml
 ---
-version: 2
+version: 3
 watermark:
   enabled: true
   content: "myblog.com"
@@ -146,7 +173,9 @@ watermark:
 
 preferred_type: conceptual
 
-preferred_style: blueprint
+preferred_palette: cool
+
+preferred_rendering: digital
 
 preferred_text: title-subtitle
 
@@ -158,26 +187,73 @@ quick_mode: true
 
 language: en
 
-custom_styles:
+custom_palettes:
   - name: corporate-tech
-    description: "Professional B2B tech style"
-    color_palette:
+    description: "Professional B2B tech palette"
+    colors:
       primary: ["#1E3A5F", "#4A90D9"]
       background: "#F5F7FA"
       accents: ["#00B4D8", "#48CAE4"]
-    visual_elements: "Clean lines, subtle gradients, circuit patterns"
-    typography: "Modern sans-serif, professional"
+    decorative_hints: "Clean lines, subtle gradients, circuit patterns"
     best_for: "SaaS, enterprise, technical"
 ---
 ```
 
+## Migration from v2
+
+When loading v2 schema, auto-upgrade:
+
+| v2 Field | v3 Field | Migration |
+|----------|----------|-----------|
+| `version: 2` | `version: 3` | Update |
+| `preferred_style` | `preferred_palette` + `preferred_rendering` | Use preset mapping table |
+| `custom_styles` | `custom_palettes` | Rename, restructure fields |
+
+**Style → Palette + Rendering mapping**:
+
+| v2 `preferred_style` | v3 `preferred_palette` | v3 `preferred_rendering` |
+|----------------------|----------------------|-------------------------|
+| `elegant` | `elegant` | `hand-drawn` |
+| `blueprint` | `cool` | `digital` |
+| `chalkboard` | `dark` | `chalk` |
+| `dark-atmospheric` | `dark` | `digital` |
+| `editorial-infographic` | `cool` | `digital` |
+| `fantasy-animation` | `pastel` | `painterly` |
+| `flat-doodle` | `pastel` | `flat-vector` |
+| `intuition-machine` | `retro` | `digital` |
+| `minimal` | `mono` | `flat-vector` |
+| `nature` | `earth` | `hand-drawn` |
+| `notion` | `mono` | `digital` |
+| `pixel-art` | `vivid` | `pixel` |
+| `playful` | `pastel` | `hand-drawn` |
+| `retro` | `retro` | `digital` |
+| `sketch-notes` | `warm` | `hand-drawn` |
+| `vector-illustration` | `retro` | `flat-vector` |
+| `vintage` | `retro` | `hand-drawn` |
+| `warm` | `warm` | `hand-drawn` |
+| `watercolor` | `earth` | `painterly` |
+| null (auto) | null | null |
+
+**Custom style migration**:
+
+| v2 Field | v3 Field |
+|----------|----------|
+| `custom_styles[].name` | `custom_palettes[].name` |
+| `custom_styles[].description` | `custom_palettes[].description` |
+| `custom_styles[].color_palette` | `custom_palettes[].colors` |
+| `custom_styles[].visual_elements` | `custom_palettes[].decorative_hints` |
+| `custom_styles[].typography` | (removed — determined by rendering) |
+| `custom_styles[].best_for` | `custom_palettes[].best_for` |
+
 ## Migration from v1
 
-When loading v1 schema, auto-upgrade:
+When loading v1 schema, auto-upgrade to v3:
 
-| v1 Field | v2 Field | Default Value |
+| v1 Field | v3 Field | Default Value |
 |----------|----------|---------------|
-| (missing) | `version` | 2 |
+| (missing) | `version` | 3 |
+| (missing) | `preferred_palette` | null |
+| (missing) | `preferred_rendering` | null |
 | (missing) | `preferred_text` | title-only |
 | (missing) | `preferred_mood` | balanced |
 | (missing) | `quick_mode` | false |

skills/baoyu-cover-image/references/dimensions/mood.md

@@ -102,15 +102,29 @@ Dynamic, high-impact visual presence.
 
 ✓✓ = highly recommended | ✓ = compatible | ✗ = not recommended
 
-## Style Interaction
+## Palette Interaction
 
-Mood modifies the base style characteristics:
+Mood modifies the base palette characteristics:
 
-| Style Category | subtle | balanced | bold |
-|----------------|--------|----------|------|
-| Technical (blueprint, notion) | Lighter lines, softer colors | Standard rendering | Stronger contrast, sharper edges |
-| Artistic (watercolor, sketch-notes) | More whitespace, lighter strokes | Standard rendering | Deeper colors, heavier strokes |
-| Editorial (bold-editorial, dark-atmospheric) | Reduced contrast, softer tones | Standard rendering | Maximum impact, vivid colors |
+| Palette Category | subtle | balanced | bold |
+|------------------|--------|----------|------|
+| Warm palettes (warm, earth, pastel) | More whitespace, softer tones | Standard colors | Deeper, richer warm tones |
+| Cool palettes (cool, mono, elegant) | Lighter lines, muted colors | Standard colors | Stronger contrast, sharper definition |
+| Dark palettes (dark, vivid) | Reduced contrast, softer glow | Standard colors | Maximum impact, vivid saturation |
+| Vintage palettes (retro) | More faded, sepia-heavy | Standard colors | Bolder retro contrasts |
+
+## Rendering Interaction
+
+Mood adjusts rendering characteristics:
+
+| Rendering | subtle | balanced | bold |
+|-----------|--------|----------|------|
+| flat-vector | Thinner strokes, lighter fills | Standard weight | Thicker strokes, stronger fills |
+| hand-drawn | Lighter pencil pressure, more space | Standard strokes | Heavier marker strokes, denser elements |
+| painterly | Diluted washes, more white | Standard brush | Thicker paint, saturated strokes |
+| digital | Reduced shadows, lower contrast | Standard rendering | Stronger shadows, sharper edges |
+| pixel | Fewer colors, simpler shapes | Standard palette | More colors, denser pixel detail |
+| chalk | Lighter chalk, more board showing | Standard chalk | Heavy chalk, vivid colors, dense marks |
 
 ## Auto Selection
 

skills/baoyu-cover-image/references/dimensions/text.md

@@ -12,8 +12,8 @@ Controls text density and information hierarchy on cover images.
 | Value | Title | Subtitle | Tags | Visual Area |
 |-------|:-----:|:--------:|:----:|:-----------:|
 | `none` | - | - | - | 100% |
-| `title-only` | ✓ (≤8字) | - | - | 85% |
-| `title-subtitle` | ✓ | ✓ (≤15字) | - | 75% |
+| `title-only` | ✓ | - | - | 85% |
+| `title-subtitle` | ✓ | ✓ | - | 75% |
 | `text-rich` | ✓ | ✓ | ✓ (2-4) | 60% |
 
 ## Detail
@@ -43,13 +43,13 @@ Single headline, maximum impact.
 - Strong brand recognition
 
 **Composition**:
-- Title: ≤8 characters, prominent
+- Title: prominent placement
 - Reserved zone: top or bottom 15%
 - Visual supports title message
 
 **Title Guidelines**:
-- Punchy, action-oriented
-- Numbers, questions, contrasts work well
+- Use exact title from source content or user-provided title
+- Do NOT invent or modify titles
 - Match content language
 
 ### title-subtitle
@@ -62,11 +62,15 @@ Title with supporting context.
 - Content with dual messages
 
 **Composition**:
-- Title: ≤8 characters, primary
-- Subtitle: ≤15 characters, secondary
+- Title: primary element
+- Subtitle: secondary element
 - Reserved zone: 25%
 - Clear hierarchy between title/subtitle
 
+**Title Guidelines**:
+- Use exact title from source content or user-provided title
+- Do NOT invent or modify titles
+
 **Subtitle Guidelines**:
 - Clarify or contextualize title
 - Can include series name, author, date
@@ -89,6 +93,10 @@ Information-dense cover with multiple text elements.
 - Reserved zone: 40%
 - Clear visual hierarchy
 
+**Title Guidelines**:
+- Use exact title from source content or user-provided title
+- Do NOT invent or modify titles
+
 **Tag Guidelines**:
 - 2-4 tags maximum
 - Short keywords (1-2 words each)

skills/baoyu-cover-image/references/palettes/cool.md

@@ -0,0 +1,26 @@
+# cool
+
+Technical, professional, precise
+
+## Color Palette
+
+| Role | Color | Hex |
+|------|-------|-----|
+| Primary 1 | Engineering Blue | #2563EB |
+| Primary 2 | Navy Blue | #1E3A5F |
+| Primary 3 | Cyan | #06B6D4 |
+| Background | Light Gray | #F8F9FA |
+| Background Alt | Blueprint Off-White | #FAF8F5 |
+| Accent 1 | Amber | #F59E0B |
+| Accent 2 | Light Blue | #BFDBFE |
+
+## Decorative Hints
+
+- Grid lines and alignment guides
+- Dimension indicators and measurements
+- Technical schematics and diagrams
+- Geometric precision elements
+
+## Best For
+
+Architecture, system design, API, technical documentation, engineering, data analysis

skills/baoyu-cover-image/references/palettes/dark.md

@@ -0,0 +1,26 @@
+# dark
+
+Cinematic, premium, atmospheric
+
+## Color Palette
+
+| Role | Color | Hex |
+|------|-------|-----|
+| Primary 1 | Electric Purple | #8B5CF6 |
+| Primary 2 | Cyan Blue | #06B6D4 |
+| Primary 3 | Magenta Pink | #EC4899 |
+| Background | Deep Purple-Black | #0A0A0A |
+| Background Alt | Rich Navy | #1A1A2E |
+| Accent 1 | Amber | #F59E0B |
+| Accent 2 | Pure White | #FFFFFF |
+
+## Decorative Hints
+
+- Glowing accent elements and neon highlights
+- Atmospheric fog or particle effects
+- Silhouettes with backlit edges
+- Subtle gradient backgrounds
+
+## Best For
+
+Entertainment, premium brands, cinematic storytelling, dark mode, gaming, night themes

skills/baoyu-cover-image/references/palettes/earth.md

@@ -0,0 +1,26 @@
+# earth
+
+Natural, organic, grounded
+
+## Color Palette
+
+| Role | Color | Hex |
+|------|-------|-----|
+| Primary 1 | Forest Green | #276749 |
+| Primary 2 | Sage | #9AE6B4 |
+| Primary 3 | Earth Brown | #744210 |
+| Background | Sand Beige | #F5E6D3 |
+| Background Alt | Sky Blue | #E0F2FE |
+| Accent 1 | Sunset Orange | #ED8936 |
+| Accent 2 | Water Blue | #63B3ED |
+
+## Decorative Hints
+
+- Leaves, trees, mountains, natural forms
+- Sun, clouds, organic flowing lines
+- Botanical illustrations
+- Earthy textures and natural patterns
+
+## Best For
+
+Nature, wellness, eco, organic, travel, sustainability, outdoor topics, slow living

skills/baoyu-cover-image/references/palettes/elegant.md

@@ -0,0 +1,26 @@
+# elegant
+
+Sophisticated, refined, understated luxury
+
+## Color Palette
+
+| Role | Color | Hex |
+|------|-------|-----|
+| Primary 1 | Soft Coral | #E8A598 |
+| Primary 2 | Muted Teal | #5B8A8A |
+| Primary 3 | Dusty Rose | #D4A5A5 |
+| Background | Warm Cream | #F5F0E6 |
+| Background Alt | Soft Beige | #F0EBE0 |
+| Accent 1 | Gold | #C9A962 |
+| Accent 2 | Copper | #B87333 |
+
+## Decorative Hints
+
+- Delicate ornamental details
+- Subtle gradients and soft transitions
+- Refined geometric patterns
+- Balanced, symmetrical compositions
+
+## Best For
+
+Business, professional, thought leadership, luxury, corporate communications

skills/baoyu-cover-image/references/palettes/mono.md

@@ -0,0 +1,26 @@
+# mono
+
+Clean, focused, essential
+
+## Color Palette
+
+| Role | Color | Hex |
+|------|-------|-----|
+| Primary 1 | Pure Black | #000000 |
+| Primary 2 | Near Black | #1F1F1F |
+| Primary 3 | Dark Gray | #374151 |
+| Background | White | #FFFFFF |
+| Background Alt | Off-White | #FAFAFA |
+| Accent 1 | Content-derived single color | - |
+| Accent 2 | Medium Gray | #9CA3AF |
+
+## Decorative Hints
+
+- Maximum negative space
+- Thin lines and minimal strokes
+- Single focal point emphasis
+- Stark contrast between elements
+
+## Best For
+
+Zen, focus, essential concepts, pure, simple, minimalist philosophy, clean design

skills/baoyu-cover-image/references/palettes/pastel.md

@@ -0,0 +1,26 @@
+# pastel
+
+Gentle, whimsical, soft
+
+## Color Palette
+
+| Role | Color | Hex |
+|------|-------|-----|
+| Primary 1 | Soft Pink | #FFB6C1 |
+| Primary 2 | Mint | #98D8C8 |
+| Primary 3 | Lavender | #C8A2C8 |
+| Background | White | #FFFFFF |
+| Background Alt | Light Cream | #FFF8E7 |
+| Accent 1 | Butter Yellow | #FFFACD |
+| Accent 2 | Sky Blue | #BEE3F8 |
+
+## Decorative Hints
+
+- Cute rounded proportions
+- Stars, sparkles, flowers, decorative flourishes
+- Soft shadows and gentle highlights
+- Storybook-style elements
+
+## Best For
+
+Fantasy, children, gentle content, creative, whimsical, casual, beginner guides

skills/baoyu-cover-image/references/palettes/retro.md

@@ -0,0 +1,30 @@
+# retro
+
+Nostalgic, vintage, classic
+
+## Color Palette
+
+| Role | Color | Hex |
+|------|-------|-----|
+| Primary 1 | Coral Red | #E07A5F |
+| Primary 2 | Mint Green | #81B29A |
+| Primary 3 | Mustard Yellow | #F2CC8F |
+| Primary 4 | Dark Maroon | #5D3A3A |
+| Background | Cream Off-White | #F5F0E6 |
+| Background Alt | Aged Paper | #F5E6D3 |
+| Accent 1 | Burnt Orange | #D4764A |
+| Accent 2 | Rock Blue | #577590 |
+| Accent 3 | Vintage Gold | #C9A227 |
+| Accent 4 | Faded Teal | #2F7373 |
+
+## Decorative Hints
+
+- Halftone dots and vintage badges
+- Aged textures with subtle paper grain
+- Sunburst/radiating lines for energy
+- Pill-shaped clouds, small dots and stars
+- Classic icons and retro motifs
+
+## Best For
+
+History, vintage, retro, classic, exploration, retrospectives, throwback content, creative proposals, educational

skills/baoyu-cover-image/references/palettes/vivid.md

@@ -0,0 +1,26 @@
+# vivid
+
+Energetic, bold, attention-grabbing
+
+## Color Palette
+
+| Role | Color | Hex |
+|------|-------|-----|
+| Primary 1 | Bright Red | #EF4444 |
+| Primary 2 | Neon Green | #22C55E |
+| Primary 3 | Electric Blue | #3B82F6 |
+| Background | Light Blue | #EFF6FF |
+| Background Alt | Soft Lavender | #F5F3FF |
+| Accent 1 | Bright Orange | #FB923C |
+| Accent 2 | Vivid Yellow | #FACC15 |
+
+## Decorative Hints
+
+- Dynamic diagonal lines and angles
+- Bold geometric shapes and color blocks
+- Dramatic lighting effects
+- High-energy visual compositions
+
+## Best For
+
+Product launch, gaming, promotion, event, marketing, announcements, brand showcases

skills/baoyu-cover-image/references/palettes/warm.md

@@ -0,0 +1,26 @@
+# warm
+
+Friendly, approachable, human-centered
+
+## Color Palette
+
+| Role | Color | Hex |
+|------|-------|-----|
+| Primary 1 | Warm Orange | #ED8936 |
+| Primary 2 | Golden Yellow | #F6AD55 |
+| Primary 3 | Terracotta | #C05621 |
+| Background | Cream | #FFFAF0 |
+| Background Alt | Soft Peach | #FED7AA |
+| Accent 1 | Deep Brown | #744210 |
+| Accent 2 | Soft Red | #E53E3E |
+
+## Decorative Hints
+
+- Sun rays, warm lighting effects
+- Rounded shapes, organic curves
+- Hearts, smiling faces, friendly icons
+- Warm gradient overlays
+
+## Best For
+
+Personal growth, lifestyle, education, human stories, emotion, community

skills/baoyu-cover-image/references/renderings/chalk.md

@@ -0,0 +1,43 @@
+# chalk
+
+Educational, authentic, classroom
+
+## Core Characteristics
+
+Chalk on blackboard aesthetic with imperfect strokes, dust effects, and authentic classroom feel. Nostalgic educational warmth.
+
+## Lines
+
+- Imperfect chalk strokes with variable pressure
+- Visible chalk texture and grain
+- Slightly wobbly, hand-drawn quality
+- Thick strokes for emphasis, thin for details
+
+## Texture
+
+- Chalk dust effects around text and elements
+- Board surface (dark, slightly worn)
+- Eraser smudges and residue
+- Grainy chalk quality on all elements
+
+## Depth
+
+- None: flat chalk drawings on board surface
+- Layering through erasure and redrawing
+- No shadows or perspective
+
+## Element Vocabulary
+
+- Chalk doodles: stars, arrows, underlines
+- Mathematical formulas and diagrams
+- Stick figures and simple icons
+- Connection lines with chalk feel
+- Checkmarks, circles, boxes for lists
+- Wooden frame border optional
+
+## Typography Approach
+
+- Hand-drawn chalk lettering
+- Imperfect baseline, authentic classroom feel
+- White or bright colored chalk for emphasis
+- Variable sizing for hierarchy

skills/baoyu-cover-image/references/renderings/digital.md

@@ -0,0 +1,42 @@
+# digital
+
+Polished, precise, modern
+
+## Core Characteristics
+
+Clean digital illustration with polished finish, precise edges, and subtle modern effects. Feels like a professional UI mockup or corporate illustration.
+
+## Lines
+
+- Clean, precise, computer-perfect edges
+- Consistent stroke weights
+- Sharp corners where appropriate
+- Anti-aliased smooth rendering
+
+## Texture
+
+- Smooth surfaces with no visible texture
+- Subtle gradients permitted (soft, controlled)
+- Frosted glass and blur effects
+- Clean shadows with consistent direction
+
+## Depth
+
+- Subtle gradients and soft drop shadows
+- Layered card-based layouts
+- Light 3D effects (subtle, not realistic)
+- Material Design-inspired elevation
+
+## Element Vocabulary
+
+- Polished icons and UI components
+- Data visualizations: charts, graphs, metrics
+- Card layouts and structured grids
+- Tag chips, progress bars, status indicators
+- Clean geometric shapes
+
+## Typography Approach
+
+- System UI or modern sans-serif (Inter, SF Pro style)
+- Clean, functional, high readability
+- Structured hierarchy with consistent spacing

skills/baoyu-cover-image/references/renderings/flat-vector.md

@@ -0,0 +1,42 @@
+# flat-vector
+
+Clean, modern, geometric illustration
+
+## Core Characteristics
+
+Flat design with clean outlines, uniform fills, and no texture or depth. Think modern app icons, infographic illustrations, and vector-based editorial art.
+
+## Lines
+
+- Clean outlines with uniform stroke weight
+- Closed shapes (coloring-book style)
+- Rounded line endings, avoid sharp corners
+- Consistent stroke width throughout
+
+## Texture
+
+- None: smooth, flat color fills only
+- No gradients, shadows, or noise
+- Solid color blocks
+
+## Depth
+
+- Flat: no shadows, no perspective
+- 2D layering with overlap for depth illusion
+- Optional 2.5D isometric layering (front/back occlusion, no atmospheric perspective)
+- No 3D effects or bevels
+
+## Element Vocabulary
+
+- Geometric icons and simple shapes
+- Bold outlined objects with clean fills
+- Geometric simplification: complex objects → basic shapes (trees → lollipop/triangle, buildings → rectangles)
+- "Toy model" aesthetic: cute, rounded proportions
+- Decorative: dots, lines, sunbursts, pill-shaped clouds, small stars
+- Isolated elements on clean backgrounds
+
+## Typography Approach
+
+- Clean sans-serif or bold geometric lettering
+- Strong readability, consistent weight
+- Easily scalable at any size

skills/baoyu-cover-image/references/renderings/hand-drawn.md

@@ -0,0 +1,40 @@
+# hand-drawn
+
+Sketchy, organic, personal
+
+## Core Characteristics
+
+Hand-drawn illustration with visible imperfections, organic line quality, and personal touch. Feels like a skilled artist's sketchbook or whiteboard drawing.
+
+## Lines
+
+- Sketchy, organic, slightly imperfect strokes
+- Variable line weight (thicker at pressure points)
+- Wavy connectors and arrows
+- Natural hand tremor visible
+
+## Texture
+
+- Paper grain and subtle surface texture
+- Pencil/pen/marker texture on strokes
+- Casual fills with visible brush direction
+
+## Depth
+
+- Minimal: light hand-drawn shadows or hatching
+- No realistic depth or perspective
+- Simple layering with overlap
+
+## Element Vocabulary
+
+- Doodles, organic shapes, hand-lettered labels
+- Conceptual icons with sketchy quality
+- Connection lines with hand-drawn wavy feel
+- Stars, arrows, underlines, circles, checkmarks
+- Stick figures and simple characters
+
+## Typography Approach
+
+- Hand-lettered or marker-style text
+- Bouncy baselines, organic feel
+- Variable sizes for emphasis hierarchy

skills/baoyu-cover-image/references/renderings/painterly.md

@@ -0,0 +1,40 @@
+# painterly
+
+Soft, artistic, expressive
+
+## Core Characteristics
+
+Watercolor or paint-style illustration with visible brush strokes, color bleeds, and artistic texture. Feels like a hand-painted art piece.
+
+## Lines
+
+- Soft brush strokes with variable opacity
+- No hard outlines; edges defined by color transitions
+- Organic flowing strokes with natural blending
+
+## Texture
+
+- Visible paint or watercolor wash textures
+- Color bleeds and wet-on-wet effects
+- Paper texture showing through transparent areas
+- Brush stroke patterns visible
+
+## Depth
+
+- Soft edges with natural color blending
+- Atmospheric depth through color fading
+- Layered washes creating depth illusion
+
+## Element Vocabulary
+
+- Watercolor washes as backgrounds
+- Natural elements: leaves, flowers, organic forms
+- Soft gradients and color transitions
+- Splatter and drip effects as accents
+- Botanical and environmental motifs
+
+## Typography Approach
+
+- Elegant brush script or handwritten style
+- Organic letterforms with brush texture
+- Integrated with paint environment

skills/baoyu-cover-image/references/renderings/pixel.md

@@ -0,0 +1,42 @@
+# pixel
+
+Retro 8-bit, nostalgic, chunky
+
+## Core Characteristics
+
+Pixel art aesthetic with visible pixel grid, limited color palette, and nostalgic gaming feel. Emulates classic 8-bit and 16-bit era graphics.
+
+## Lines
+
+- Pixel grid alignment, no anti-aliasing
+- Staircase edges on diagonals
+- Single-pixel or double-pixel outlines
+- Blocky, angular forms
+
+## Texture
+
+- Dithering patterns for gradients
+- No smooth transitions
+- Cross-hatching with pixel precision
+- Limited 16-32 color palette per scene
+
+## Depth
+
+- None: flat pixel planes only
+- Parallax layering (foreground/background)
+- No perspective or 3D effects
+
+## Element Vocabulary
+
+- 8-bit sprites and chunky shapes
+- Simple iconography: stars, hearts, arrows
+- Text bubbles with pixel borders
+- Progress bars with chunky segments
+- Retro gaming UI elements
+
+## Typography Approach
+
+- Pixelated bitmap font style
+- Chunky blocky letterforms
+- Fixed-width or monospace feel
+- All-caps for headers

skills/baoyu-cover-image/references/style-presets.md

@@ -0,0 +1,32 @@
+# Style Presets
+
+`--style X` expands to a palette + rendering combination. Users can override either dimension.
+
+| --style | Palette | Rendering |
+|---------|---------|-----------|
+| `elegant` | `elegant` | `hand-drawn` |
+| `blueprint` | `cool` | `digital` |
+| `chalkboard` | `dark` | `chalk` |
+| `dark-atmospheric` | `dark` | `digital` |
+| `editorial-infographic` | `cool` | `digital` |
+| `fantasy-animation` | `pastel` | `painterly` |
+| `flat-doodle` | `pastel` | `flat-vector` |
+| `intuition-machine` | `retro` | `digital` |
+| `minimal` | `mono` | `flat-vector` |
+| `nature` | `earth` | `hand-drawn` |
+| `notion` | `mono` | `digital` |
+| `pixel-art` | `vivid` | `pixel` |
+| `playful` | `pastel` | `hand-drawn` |
+| `retro` | `retro` | `digital` |
+| `sketch-notes` | `warm` | `hand-drawn` |
+| `vector-illustration` | `retro` | `flat-vector` |
+| `vintage` | `retro` | `hand-drawn` |
+| `warm` | `warm` | `hand-drawn` |
+| `watercolor` | `earth` | `painterly` |
+
+## Override Examples
+
+- `--style blueprint --rendering hand-drawn` = cool palette with hand-drawn rendering
+- `--style elegant --palette warm` = warm palette with hand-drawn rendering
+
+Explicit `--palette`/`--rendering` flags always override preset values.

skills/baoyu-cover-image/references/styles/blueprint.md

@@ -1,25 +0,0 @@
-# blueprint
-
-Precise technical blueprint style with engineering aesthetic
-
-## Color Palette
-
-- Primary: Engineering Blue (#2563EB), Navy Blue (#1E3A5F)
-- Background: Blueprint Off-White (#FAF8F5), subtle grid overlay
-- Accents: Amber (#F59E0B), Light Blue (#BFDBFE)
-
-## Visual Elements
-
-- Precise lines with consistent stroke weights
-- Technical schematics and clean vector graphics
-- Dimension lines and measurement indicators
-- Grid alignment for all elements
-- Geometric precision for all shapes
-
-## Typography
-
-- Clean sans-serif hand lettering, technical and authoritative
-
-## Best For
-
-Technical architecture, system design, data analysis, engineering documentation

skills/baoyu-cover-image/references/styles/bold-editorial.md

@@ -1,26 +0,0 @@
-# bold-editorial
-
-High-impact magazine editorial with bold visual expression
-
-## Color Palette
-
-- Primary: Pure White (#FFFFFF), Electric Blue (#3B82F6), Bright Orange (#FB923C)
-- Background: Deep Black (#0A0A0A), Deep Blue (#0F172A)
-- Accents: Magenta (#EC4899), Neon Green (#22C55E), Violet (#8B5CF6)
-
-## Visual Elements
-
-- Strong typography as visual element itself
-- Geometric shapes and bold color blocks
-- Full-bleed solid color backgrounds
-- Dynamic diagonal lines and angles
-- Dramatic lighting effects on text
-- Minimal decoration, maximum impact
-
-## Typography
-
-- Bold condensed typeface, oversized headlines, all-caps, tight letter-spacing
-
-## Best For
-
-Product launches, marketing, keynote speeches, brand showcases, investor pitches

skills/baoyu-cover-image/references/styles/chalkboard.md

@@ -1,61 +0,0 @@
-# chalkboard
-
-Black chalkboard background with colorful chalk drawing style
-
-## Design Aesthetic
-
-Classic classroom chalkboard aesthetic with hand-drawn chalk illustrations. Nostalgic educational feel with imperfect, sketchy lines that capture the warmth of traditional teaching. Colorful chalk creates visual hierarchy while maintaining the authentic chalkboard experience.
-
-## Background
-
-- Color: Chalkboard Black (#1A1A1A) or Dark Green-Black (#1C2B1C)
-- Texture: Realistic chalkboard texture with subtle scratches, dust particles, and faint eraser marks
-
-## Typography
-
-Hand-drawn chalk lettering style with visible chalk texture. Imperfect baseline adds authenticity. White or bright colored chalk for emphasis.
-
-## Color Palette
-
-| Role | Color | Hex | Usage |
-|------|-------|-----|-------|
-| Background | Chalkboard Black | #1A1A1A | Primary background |
-| Alt Background | Green-Black | #1C2B1C | Traditional green board |
-| Primary Text | Chalk White | #F5F5F5 | Main text, outlines |
-| Accent 1 | Chalk Yellow | #FFE566 | Highlights, emphasis |
-| Accent 2 | Chalk Pink | #FF9999 | Secondary highlights |
-| Accent 3 | Chalk Blue | #66B3FF | Diagrams, links |
-| Accent 4 | Chalk Green | #90EE90 | Success, nature |
-| Accent 5 | Chalk Orange | #FFB366 | Warnings, energy |
-
-## Visual Elements
-
-- Hand-drawn chalk illustrations with sketchy, imperfect lines
-- Chalk dust effects around text and key elements
-- Doodles: stars, arrows, underlines, circles, checkmarks
-- Mathematical formulas and simple diagrams
-- Eraser smudges and chalk residue textures
-- Wooden frame border optional
-- Stick figures and simple icons
-- Connection lines with hand-drawn feel
-
-## Style Rules
-
-### Do
-
-- Maintain authentic chalk texture on all elements
-- Use imperfect, hand-drawn quality throughout
-- Add subtle chalk dust and smudge effects
-- Create visual hierarchy with color variety
-- Include playful doodles and annotations
-
-### Don't
-
-- Use perfect geometric shapes
-- Create clean digital-looking lines
-- Add photorealistic elements
-- Use gradients or glossy effects
-
-## Best For
-
-Educational content, tutorials, classroom themes, teaching materials, workshops, informal learning sessions, knowledge sharing

skills/baoyu-cover-image/references/styles/dark-atmospheric.md

@@ -1,25 +0,0 @@
-# dark-atmospheric
-
-Dark moody aesthetic with glowing accent elements
-
-## Color Palette
-
-- Primary: Electric Purple (#8B5CF6), Cyan Blue (#06B6D4), Magenta Pink (#EC4899)
-- Background: Deep Purple-Black (#0D0D1A), Rich Navy (#1A1A2E)
-- Accents: Amber (#F59E0B), Pure White (#FFFFFF)
-
-## Visual Elements
-
-- Glowing accent elements and borders
-- Subtle gradient backgrounds
-- Atmospheric fog or particle effects
-- Neon-style highlights on key elements
-- Silhouettes with backlit edges
-
-## Typography
-
-- Elegant serif or refined sans-serif in light/white with subtle glow
-
-## Best For
-
-Entertainment, creative industries, premium brands, cinematic storytelling

skills/baoyu-cover-image/references/styles/editorial-infographic.md

@@ -1,26 +0,0 @@
-# editorial-infographic
-
-Modern magazine-style editorial with clear visual storytelling
-
-## Color Palette
-
-- Primary: Near Black (#1A1A1A), Editorial Blue (#2563EB)
-- Background: Pure White (#FFFFFF), Light Gray (#F8F9FA)
-- Accents: Coral (#F97316), Emerald (#10B981), Amber (#F59E0B)
-
-## Visual Elements
-
-- Clean flat illustrations (not photos)
-- Structured multi-section layouts
-- Callout boxes for key insights
-- Icon-based data visualization
-- Visual metaphors for abstract concepts
-- Pull quotes and highlight boxes
-
-## Typography
-
-- Bold display serif or modern sans-serif, editorial sophistication
-
-## Best For
-
-Technology explainers, science communication, research summaries, thought leadership

skills/baoyu-cover-image/references/styles/elegant.md

@@ -1,23 +0,0 @@
-# elegant
-
-Refined, sophisticated, understated
-
-## Color Palette
-
-- Primary: Soft coral (#E8A598), muted teal (#5B8A8A), dusty rose (#D4A5A5)
-- Background: Warm cream (#F5F0E6), soft beige
-- Accents: Gold (#C9A962), copper
-
-## Visual Elements
-
-- Delicate lines, refined icons
-- Subtle gradients
-- Balanced composition
-
-## Typography
-
-- Elegant serif-style hand lettering
-
-## Best For
-
-Professional content, thought leadership, business topics

skills/baoyu-cover-image/references/styles/fantasy-animation.md

@@ -1,25 +0,0 @@
-# fantasy-animation
-
-Whimsical hand-drawn animation style inspired by Ghibli and Disney
-
-## Color Palette
-
-- Primary: Golden Yellow (#F4D03F), Rose Pink (#E8A0BF), Deep Forest (#2D5A3D)
-- Background: Soft Sky Blue (#E8F4FC), Warm Cream (#FFF8E7)
-- Accents: Sage Green (#87A96B), Sky Blue (#7EC8E3), Coral (#F08080)
-
-## Visual Elements
-
-- Central illustrated character (friendly, expressive)
-- Magical floating objects (books, orbs, sparkles)
-- Storybook-style environment backgrounds
-- Soft shadows and gentle highlights
-- Decorative elements: stars, sparkles, flowers, leaves
-
-## Typography
-
-- Whimsical serif or decorative hand-lettered style, organic feel
-
-## Best For
-
-Educational content, storytelling, creative workshops, fantasy/gaming content

skills/baoyu-cover-image/references/styles/flat-doodle.md

@@ -1,27 +0,0 @@
-# flat-doodle
-
-Cute, simple doodle illustrations with bold outlines
-
-## Color Palette
-
-- Primary: Bright pastel pink (#FFB6C1), mint (#98D8C8), lavender (#C8A2C8), butter yellow (#FFFACD)
-- Background: Clean white (#FFFFFF)
-- Accents: Bold black outlines, soft coral, sky blue
-
-## Visual Elements
-
-- Bold black outlines around all shapes
-- Simple flat shapes with no shading
-- Cute rounded proportions
-- Productivity-themed icons
-- Isolated elements on white background
-- Minimal decorative details
-
-## Typography
-
-- Simple, clean sans-serif or hand-lettering
-- Bold and easily readable
-
-## Best For
-
-Productivity content, SaaS articles, workflow tutorials, app features, beginner guides, casual business

skills/baoyu-cover-image/references/styles/intuition-machine.md

@@ -1,26 +0,0 @@
-# intuition-machine
-
-Technical briefing style with aged paper and bilingual labels
-
-## Color Palette
-
-- Primary: Dark Maroon (#5D3A3A), Teal (#2F7373)
-- Background: Aged Cream (#F5F0E6), subtle paper texture with light creases
-- Accents: Warm Brown (#8B7355), Maroon (#722F37), Deep Charcoal (#2D2D2D)
-
-## Visual Elements
-
-- Isometric 3D technical illustrations or flat 2D diagrams
-- Bilingual callout labels (English + Chinese)
-- Faded thematic background patterns
-- Clean black outlines on all elements
-- Split or triptych layouts
-- Key quote box at bottom
-
-## Typography
-
-- Bold display font in dark maroon, ALL CAPS for titles, bilingual labels
-
-## Best For
-
-Technical explanations, academic presentations, bilingual audiences, knowledge docs

skills/baoyu-cover-image/references/styles/minimal.md

@@ -1,23 +0,0 @@
-# minimal
-
-Ultra-clean, zen-like, focused
-
-## Color Palette
-
-- Primary: Pure black (#000000), white (#FFFFFF)
-- Background: White or off-white (#FAFAFA)
-- Accents: Single color (user's choice or content-derived)
-
-## Visual Elements
-
-- Single focal point
-- Maximum negative space
-- Thin lines
-
-## Typography
-
-- Clean, simple hand lettering, lots of breathing room
-
-## Best For
-
-Philosophy, minimalism, focused concepts

skills/baoyu-cover-image/references/styles/nature.md

@@ -1,22 +0,0 @@
-# nature
-
-Organic, calm, earthy
-
-## Color Palette
-
-- Primary: Forest green (#276749), sage (#9AE6B4), earth brown (#744210)
-- Background: Sand beige (#F5E6D3), sky blue (#E0F2FE)
-- Accents: Sunset orange, water blue
-
-## Visual Elements
-
-- Leaves, trees, mountains
-- Sun, clouds, organic flowing lines
-
-## Typography
-
-- Organic, flowing hand lettering with natural textures
-
-## Best For
-
-Sustainability, wellness, outdoor topics, slow living

skills/baoyu-cover-image/references/styles/notion.md

@@ -1,25 +0,0 @@
-# notion
-
-Clean SaaS dashboard aesthetic with productivity tool styling
-
-## Color Palette
-
-- Primary: Near Black (#1F1F1F), Notion Blue (#2383E2)
-- Background: Light Gray (#F7F7F5), Pure White (#FFFFFF)
-- Accents: Success Green (#0F7B6C), Alert Red (#E03E3E), Warning Yellow (#DFAB01)
-
-## Visual Elements
-
-- Card-based layouts with subtle borders
-- Clean data visualizations
-- Tag and label chips
-- Icon-based navigation hints
-- Progress bars and metric displays
-
-## Typography
-
-- System UI or Inter style, clean and functional
-
-## Best For
-
-Product demos, SaaS presentations, productivity content, B2B topics

skills/baoyu-cover-image/references/styles/pixel-art.md

@@ -1,26 +0,0 @@
-# pixel-art
-
-Retro 8-bit pixel art aesthetic with nostalgic gaming style
-
-## Color Palette
-
-- Primary: Dark Navy (#1A1A2E), Pixel Green (#00FF00)
-- Background: Light Blue (#87CEEB), Soft Lavender (#E6E6FA)
-- Accents: Pixel Red (#FF0000), Pixel Yellow (#FFFF00), Pixel Cyan (#00FFFF)
-
-## Visual Elements
-
-- All elements with visible pixel structure
-- Simple iconography: stars, hearts, arrows
-- Text bubbles with pixel borders
-- Progress bars with chunky segments
-- Dithering patterns for gradients
-- Limited 16-32 color palette
-
-## Typography
-
-- Pixelated bitmap font style, chunky blocky letterforms
-
-## Best For
-
-Gaming content, tech tutorials, developer talks, retro-themed topics

skills/baoyu-cover-image/references/styles/playful.md

@@ -1,23 +0,0 @@
-# playful
-
-Fun, creative, whimsical
-
-## Color Palette
-
-- Primary: Pastel pink (#FED7E2), mint (#C6F6D5), lavender (#E9D8FD), sky blue (#BEE3F8)
-- Background: Light cream (#FFFBEB), soft white
-- Accents: Bright pops - yellow, coral, turquoise
-
-## Visual Elements
-
-- Doodles, stars, swirls
-- Cute characters, emoji-style icons
-- Playful compositions
-
-## Typography
-
-- Bouncy, irregular hand lettering, playful angles
-
-## Best For
-
-Casual content, tutorials, beginner guides, fun topics

skills/baoyu-cover-image/references/styles/retro.md

@@ -1,22 +0,0 @@
-# retro
-
-Vintage, nostalgic, classic
-
-## Color Palette
-
-- Primary: Muted orange (#ED8936 at 70%), dusty pink (#FED7E2 at 80%), faded teal
-- Background: Aged paper (#F5E6D3), sepia tones
-- Accents: Faded red, vintage gold
-
-## Visual Elements
-
-- Halftone dots, vintage badges
-- Classic icons, aged textures
-
-## Typography
-
-- Vintage-style hand lettering, classic serif influence
-
-## Best For
-
-History, retrospectives, classic topics, throwback content

skills/baoyu-cover-image/references/styles/sketch-notes.md

@@ -1,25 +0,0 @@
-# sketch-notes
-
-Soft hand-drawn illustration style with fresh minimalist aesthetic
-
-## Color Palette
-
-- Primary: Deep Charcoal (#2C3E50), Soft Orange (#F4A261)
-- Background: Warm Off-White (#FAF8F0), subtle paper grain
-- Accents: Mustard Yellow (#E9C46A), Sage Green (#87A96B), Light Blue (#7EC8E3)
-
-## Visual Elements
-
-- Connection lines with hand-drawn wavy feel
-- Conceptual abstract icons illustrating ideas
-- Color fills with hand-painted casual feel
-- Doodle-style decorative elements
-- Arrows and pointers with sketchy style
-
-## Typography
-
-- Bold hand-written marker font for headlines, casual handwriting for body
-
-## Best For
-
-Educational content, knowledge sharing, technical explanations, tutorials

skills/baoyu-cover-image/references/styles/vector-illustration.md

@@ -1,25 +0,0 @@
-# vector-illustration
-
-Flat vector illustration with black outlines and retro soft colors
-
-## Color Palette
-
-- Primary: Coral Red (#E07A5F), Mint Green (#81B29A), Mustard Yellow (#F2CC8F)
-- Background: Cream Off-White (#F5F0E6), subtle paper texture
-- Accents: Burnt Orange (#D4764A), Rock Blue (#577590), Deep Charcoal (#2D2D2D) outlines
-
-## Visual Elements
-
-- All objects have closed black outlines (coloring book style)
-- Rounded line endings, avoid sharp corners
-- Simplified geometric shapes
-- 2.5D perspective with layering
-- Decorative elements: sunbursts, pill clouds, dots, stars
-
-## Typography
-
-- Large bold retro serif for titles, clean geometric sans-serif for body
-
-## Best For
-
-Educational content, creative proposals, brand showcases, explainer content

skills/baoyu-cover-image/references/styles/vintage.md

@@ -1,26 +0,0 @@
-# vintage
-
-Vintage aged-paper aesthetic with historical document styling
-
-## Color Palette
-
-- Primary: Dark Brown (#3D2914), Forest Green (#2D5A3D), Navy Blue (#1E3A5F)
-- Background: Aged Parchment (#F5E6D3), Sepia Cream (#FFF8DC)
-- Accents: Burgundy (#722F37), Gold (#C9A227), Sepia Black (#3D3D3D)
-
-## Visual Elements
-
-- Antique maps with route lines and landmarks
-- Compass roses and nautical elements
-- Specimen drawings (flora, fauna)
-- Handwritten-style annotations
-- Rope, leather, brass decorative motifs
-- Aged texture with subtle creases
-
-## Typography
-
-- Classic serif with historical character, elegant flourishes
-
-## Best For
-
-Historical content, travel, heritage storytelling, biography, scientific discovery

skills/baoyu-cover-image/references/styles/warm.md

@@ -1,22 +0,0 @@
-# warm
-
-Friendly, approachable, human-centered
-
-## Color Palette
-
-- Primary: Warm orange (#ED8936), golden yellow (#F6AD55), terracotta (#C05621)
-- Background: Cream (#FFFAF0), soft peach (#FED7AA)
-- Accents: Deep brown (#744210), soft red
-
-## Visual Elements
-
-- Rounded shapes, smiling faces
-- Sun rays, hearts, warm lighting
-
-## Typography
-
-- Friendly rounded hand lettering
-
-## Best For
-
-Personal growth, lifestyle, education, human stories

skills/baoyu-cover-image/references/styles/watercolor.md

@@ -1,25 +0,0 @@
-# watercolor
-
-Soft watercolor illustration style with hand-painted textures
-
-## Color Palette
-
-- Primary: Soft Coral (#F4A261), Dusty Rose (#E8A0A0)
-- Background: Warm Off-White (#FAF8F0), Soft Cream (#FFF9E6)
-- Accents: Sage Green (#87A96B), Sky Blue (#7EC8E3), Soft Lavender (#C5B4E3)
-
-## Visual Elements
-
-- Watercolor washes as backgrounds
-- Visible brush strokes and textures
-- Natural elements: leaves, flowers, organic shapes
-- Color bleeds and soft edges
-- Hand-drawn arrows and connections
-
-## Typography
-
-- Elegant handwritten or brush script, organic letterforms
-
-## Best For
-
-Lifestyle content, wellness, travel guides, personal stories, creative topics

skills/baoyu-cover-image/references/types.md

@@ -0,0 +1,23 @@
+# Type Composition Guidelines
+
+## Type Gallery
+
+| Type | Description | Best For |
+|------|-------------|----------|
+| `hero` | Large visual impact, title overlay | Product launch, brand promotion, major announcements |
+| `conceptual` | Concept visualization, abstract core ideas | Technical articles, methodology, architecture design |
+| `typography` | Text-focused layout, prominent title | Opinion pieces, quotes, insights |
+| `metaphor` | Visual metaphor, concrete expressing abstract | Philosophy, growth, personal development |
+| `scene` | Atmospheric scene, narrative feel | Stories, travel, lifestyle |
+| `minimal` | Minimalist composition, generous whitespace | Zen, focus, core concepts |
+
+## Type-Specific Composition
+
+| Type | Composition Guidelines |
+|------|------------------------|
+| `hero` | Large focal visual (60-70% area), title overlay on visual, dramatic composition |
+| `conceptual` | Abstract shapes representing core concepts, information hierarchy, clean zones |
+| `typography` | Title as primary element (40%+ area), minimal supporting visuals, strong hierarchy |
+| `metaphor` | Concrete object/scene representing abstract idea, symbolic elements, emotional resonance |
+| `scene` | Atmospheric environment, narrative elements, mood-setting lighting and colors |
+| `minimal` | Single focal element, generous whitespace (60%+), essential shapes only |

skills/baoyu-cover-image/references/visual-elements.md

@@ -0,0 +1,101 @@
+# Visual Elements Library
+
+Icon and symbol vocabulary organized by topic. Use these as building blocks for cover compositions.
+
+## Tech & Development
+
+| Element | Use For |
+|---------|---------|
+| Code window / Terminal | Programming, development |
+| Gear / Cog | Engineering, settings, process |
+| Circuit board / Chip | Hardware, AI, computing |
+| Binary / Data stream | Data, algorithms |
+| API brackets `</>` | Web development, APIs |
+| Cloud | Cloud computing, SaaS |
+| Lock / Shield | Security, privacy |
+| Network nodes | Distributed systems, connections |
+
+## Ideas & Innovation
+
+| Element | Use For |
+|---------|---------|
+| Lightbulb | Ideas, insights, innovation |
+| Rocket | Launch, growth, startups |
+| Target / Bullseye | Goals, precision, focus |
+| Puzzle piece | Problem solving, integration |
+| Key | Solutions, access, unlocking |
+| Magnifying glass | Analysis, search, discovery |
+| Chart / Graph | Data, trends, growth |
+| Arrow / Path | Direction, journey, progress |
+
+## Communication & Collaboration
+
+| Element | Use For |
+|---------|---------|
+| Speech bubble | Communication, dialogue |
+| Chat dots `...` | Conversation, messaging |
+| Handshake | Partnership, agreement |
+| Team / Figures | Collaboration, community |
+| Mail / Envelope | Notifications, outreach |
+| Megaphone | Announcements, marketing |
+| Network / Web | Social, connections |
+
+## Nature & Growth
+
+| Element | Use For |
+|---------|---------|
+| Plant / Sprout | Growth, organic, sustainability |
+| Tree | Established, structure, branching |
+| Leaf | Eco, natural, fresh |
+| Sun / Rays | Energy, positivity, new beginnings |
+| Mountain | Challenge, achievement, scale |
+| Wave | Flow, change, rhythm |
+| Seed → Plant | Transformation, potential |
+
+## Tools & Actions
+
+| Element | Use For |
+|---------|---------|
+| Wrench / Hammer | Building, fixing, tools |
+| Pencil / Pen | Writing, creation, editing |
+| Brush | Design, creativity, art |
+| Scissors | Cutting, editing, trimming |
+| Clock / Timer | Time, scheduling, deadlines |
+| Calendar | Planning, events, milestones |
+| Checklist / Checkbox | Tasks, completion, validation |
+
+## Abstract Concepts
+
+| Element | Use For |
+|---------|---------|
+| Infinity ∞ | Continuous, endless, loops |
+| Yin-yang | Balance, duality, harmony |
+| Spiral | Evolution, recursion, cycles |
+| Stack / Layers | Depth, hierarchy, structure |
+| Bridge | Connection, transition, spanning |
+| Door / Portal | Opportunity, entry, access |
+| Mirror / Reflection | Self-improvement, analysis |
+
+## Combination Patterns
+
+Create visual metaphors by combining elements:
+
+| Combination | Represents |
+|-------------|------------|
+| Lightbulb + Gear | Innovative engineering |
+| Plant + Code | Organic tech growth |
+| Rocket + Target | Precise acceleration |
+| Key + Lock | Security solutions |
+| Bridge + People | Team connections |
+| Magnifier + Data | Analytics, insights |
+
+## Rendering-Specific Treatment
+
+| Rendering | Element Style |
+|-----------|---------------|
+| `flat-vector` | Geometric, simple shapes, uniform fills |
+| `hand-drawn` | Sketchy, organic, doodle-like |
+| `painterly` | Soft edges, brush strokes |
+| `digital` | Precise, gradient hints, polished |
+| `pixel` | 8-bit chunky, grid-aligned |
+| `chalk` | Dusty, textured, board style |

skills/baoyu-cover-image/references/workflow/confirm-options.md

@@ -0,0 +1,132 @@
+# Step 2: Confirm Options
+
+## Purpose
+
+Validate all 5 dimensions + aspect ratio.
+
+## Skip Conditions
+
+| Condition | Skipped Questions | Still Asked |
+|-----------|-------------------|-------------|
+| `--quick` flag | Type, Palette, Rendering, Text, Mood | **Aspect Ratio** (unless `--aspect` specified) |
+| All 5 dimensions + `--aspect` specified | All | None |
+| `quick_mode: true` in EXTEND.md | Type, Palette, Rendering, Text, Mood | **Aspect Ratio** (unless `--aspect` specified) |
+| Otherwise | None | All 6 questions |
+
+**Important**: Aspect ratio is ALWAYS asked unless explicitly specified via `--aspect` CLI flag. User presets in EXTEND.md are shown as recommended option, not auto-selected.
+
+## Quick Mode Output
+
+When skipping 5 dimensions:
+
+```
+Quick Mode: Auto-selected dimensions
+• Type: [type] ([reason])
+• Palette: [palette] ([reason])
+• Rendering: [rendering] ([reason])
+• Text: [text] ([reason])
+• Mood: [mood] ([reason])
+
+[Then ask Question 6: Aspect Ratio]
+```
+
+## Confirmation Flow
+
+**Language**: Auto-determined (user's input language > saved preference > source language). No need to ask.
+
+Present ALL options in a **single AskUserQuestion call** (4 questions max).
+
+Skip any question where the dimension is already specified via CLI flag or `--style` preset.
+
+### Q1: Type (skip if `--type`)
+
+```yaml
+header: "Type"
+question: "Which cover type?"
+multiSelect: false
+options:
+  - label: "[auto-recommended type] (Recommended)"
+    description: "[reason based on content signals]"
+  - label: "hero"
+    description: "Large visual impact, title overlay - product launch, announcements"
+  - label: "conceptual"
+    description: "Concept visualization - technical, architecture"
+  - label: "typography"
+    description: "Text-focused layout - opinions, quotes"
+```
+
+### Q2: Palette (skip if `--palette` or `--style`)
+
+```yaml
+header: "Palette"
+question: "Which color palette?"
+multiSelect: false
+options:
+  - label: "[auto-recommended palette] (Recommended)"
+    description: "[reason based on content signals]"
+  - label: "warm"
+    description: "Friendly - orange, golden yellow, terracotta"
+  - label: "elegant"
+    description: "Sophisticated - soft coral, muted teal, dusty rose"
+  - label: "cool"
+    description: "Technical - engineering blue, navy, cyan"
+```
+
+### Q3: Rendering (skip if `--rendering` or `--style`)
+
+Show compatible renderings (✓✓ first from compatibility matrix):
+
+```yaml
+header: "Rendering"
+question: "Which rendering style?"
+multiSelect: false
+options:
+  - label: "[best compatible rendering] (Recommended)"
+    description: "[reason based on palette + type + content]"
+  - label: "flat-vector"
+    description: "Clean outlines, flat fills, geometric icons"
+  - label: "hand-drawn"
+    description: "Sketchy, organic, imperfect strokes"
+  - label: "digital"
+    description: "Polished, precise, subtle gradients"
+```
+
+### Q4: Other Settings (skip if all remaining dimensions already specified)
+
+Combine remaining settings into one question. Include: Output Dir (if no preference + file path input), Text, Mood, Aspect. Show auto-selected values as recommended option. User can accept all or type adjustments via "Other".
+
+**When output dir needs asking** (no `default_output_dir` preference + file path input):
+
+```yaml
+header: "Settings"
+question: "Output / Text / Mood / Aspect?"
+multiSelect: false
+options:
+  - label: "imgs/ / [auto-text] / [auto-mood] / [preset-aspect] (Recommended)"
+    description: "{article-dir}/imgs/, [text reason], [mood reason], [aspect source]"
+  - label: "same-dir / [auto-text] / [auto-mood] / [preset-aspect]"
+    description: "{article-dir}/, same directory as article"
+  - label: "independent / [auto-text] / [auto-mood] / [preset-aspect]"
+    description: "cover-image/{topic-slug}/, separate from article"
+```
+
+**When output dir already set** (preference exists or pasted content):
+
+```yaml
+header: "Settings"
+question: "Text / Mood / Aspect?"
+multiSelect: false
+options:
+  - label: "[auto-text] / [auto-mood] / [preset-aspect] (Recommended)"
+    description: "Auto-selected: [text reason], [mood reason], [aspect source]"
+  - label: "[auto-text] / bold / [preset-aspect]"
+    description: "High contrast, vivid — matches [content signal]"
+  - label: "[auto-text] / subtle / [preset-aspect]"
+    description: "Low contrast, muted — calm, professional"
+```
+
+*Note*: "Other" (auto-added) allows typing custom combo. Parse `/`-separated values matching the question format.
+
+## After Response
+
+Proceed to Step 3 with confirmed dimensions.

skills/baoyu-cover-image/references/workflow/prompt-template.md

@@ -0,0 +1,229 @@
+# Step 3: Prompt Template
+
+Save to `prompts/cover.md`:
+
+```markdown
+---
+type: cover
+palette: [confirmed palette]
+rendering: [confirmed rendering]
+references:
+  - ref_id: 01
+    filename: refs/ref-01-{slug}.{ext}
+    usage: direct | style | palette
+  - ref_id: 02
+    filename: refs/ref-02-{slug}.{ext}
+    usage: direct | style | palette
+---
+
+# Content Context
+Article title: [full original title from source]
+Content summary: [2-3 sentence summary of key points and themes]
+Keywords: [5-8 key terms extracted from content]
+
+# Visual Design
+Cover theme: [2-3 words visual interpretation]
+Type: [confirmed type]
+Palette: [confirmed palette]
+Rendering: [confirmed rendering]
+Text level: [confirmed text level]
+Mood: [confirmed mood]
+Aspect ratio: [confirmed ratio]
+Language: [confirmed language]
+
+# Text Elements
+[Based on text level:]
+- none: "No text elements"
+- title-only: "Title: [exact title from source or user]"
+- title-subtitle: "Title: [title] / Subtitle: [context]"
+- text-rich: "Title: [title] / Subtitle: [context] / Tags: [2-4 keywords]"
+
+# Mood Application
+[Based on mood level:]
+- subtle: "Use low contrast, muted colors, light visual weight, calm aesthetic"
+- balanced: "Use medium contrast, normal saturation, balanced visual weight"
+- bold: "Use high contrast, vivid saturated colors, heavy visual weight, dynamic energy"
+
+# Composition
+Type composition:
+- [Type-specific layout and structure]
+
+Visual composition:
+- Main visual: [metaphor derived from content meaning]
+- Layout: [positioning based on type and aspect ratio]
+- Decorative: [palette-specific elements that reinforce content theme]
+
+Color scheme: [primary, background, accent from palette definition, adjusted by mood]
+Rendering notes: [key characteristics from rendering definition — lines, texture, depth, element style]
+Type notes: [key characteristics from type definition]
+Palette notes: [key characteristics from palette definition]
+
+[Watermark section if enabled]
+
+[Reference images section if provided — see below]
+```
+
+## Content-Driven Design
+
+- Article title and summary inform the visual metaphor choice
+- Keywords guide decorative elements and symbols
+- The skill controls visual style; the content drives meaning
+
+## Visual Element Selection
+
+Match content themes to icon vocabulary:
+
+| Content Theme | Suggested Elements |
+|---------------|-------------------|
+| Programming/Dev | Code window, terminal, API brackets, gear |
+| AI/ML | Brain, neural network, robot, circuit |
+| Growth/Business | Chart, rocket, plant, mountain, arrow |
+| Security | Lock, shield, key, fingerprint |
+| Communication | Speech bubble, megaphone, mail, handshake |
+| Tools/Methods | Wrench, checklist, pencil, puzzle |
+
+Full library: [../visual-elements.md](../visual-elements.md)
+
+## Type-Specific Composition
+
+| Type | Composition Guidelines |
+|------|------------------------|
+| `hero` | Large focal visual (60-70% area), title overlay on visual, dramatic composition |
+| `conceptual` | Abstract shapes representing core concepts, information hierarchy, clean zones |
+| `typography` | Title as primary element (40%+ area), minimal supporting visuals, strong hierarchy |
+| `metaphor` | Concrete object/scene representing abstract idea, symbolic elements, emotional resonance |
+| `scene` | Atmospheric environment, narrative elements, mood-setting lighting and colors |
+| `minimal` | Single focal element, generous whitespace (60%+), essential shapes only |
+
+## Title Guidelines
+
+When text level includes title:
+- **Source**: Use the exact title provided by user, or extract from source content
+- **Do NOT invent titles**: Stay faithful to the original
+- Match confirmed language
+
+## Watermark Application
+
+If enabled in preferences, add to prompt:
+
+```
+Include a subtle watermark "[content]" positioned at [position].
+The watermark should be legible but not distracting from the main content.
+```
+
+Reference: `config/watermark-guide.md`
+
+## Reference Image Handling
+
+When user provides reference images (`--ref` or pasted images):
+
+### ⚠️ CRITICAL - Frontmatter References
+
+**MUST add `references` field in YAML frontmatter** when reference files are saved to `refs/`:
+
+```yaml
+---
+type: cover
+palette: warm
+rendering: flat-vector
+references:
+  - ref_id: 01
+    filename: refs/ref-01-podcast-thumbnail.jpg
+    usage: style
+---
+```
+
+| Field | Description |
+|-------|-------------|
+| `ref_id` | Sequential number (01, 02, ...) |
+| `filename` | Relative path from prompt file's parent directory |
+| `usage` | `direct` / `style` / `palette` |
+
+**Omit `references` field entirely** if no reference files saved (style extracted verbally only).
+
+### When to Include References in Frontmatter
+
+| Situation | Frontmatter Action | Generation Action |
+|-----------|-------------------|-------------------|
+| Reference file saved to `refs/` | Add to `references` list ✓ | Pass via `--ref` parameter |
+| Style extracted verbally (no file) | Omit `references` field | Describe in prompt body only |
+| File path in frontmatter but doesn't exist | ERROR - fix or remove | Generation will fail |
+
+**Before writing prompt with references, verify**: `test -f refs/ref-NN-{slug}.{ext}`
+
+### Reference Usage Types
+
+| Usage | When to Use | Generation Action |
+|-------|-------------|-------------------|
+| `direct` | Reference matches desired output closely | Pass to `--ref` parameter |
+| `style` | Extract visual style characteristics only | Describe style in prompt text |
+| `palette` | Extract color palette only | Include colors in prompt |
+
+### Step 1: Analyze References
+
+For each reference image, extract:
+- **Style**: Rendering technique, line quality, texture
+- **Composition**: Layout, visual hierarchy, focal points
+- **Color mood**: Palette characteristics (without specific colors)
+- **Elements**: Key visual elements and symbols used
+
+### Step 2: Embed in Prompt
+
+**If file saved AND skill supports `--ref`** (e.g., baoyu-image-gen with Google):
+- Pass ref images directly via `--ref` parameter
+- Add brief style note in prompt:
+
+```
+# Reference Style
+Follow the visual style of the attached reference image(s):
+- [1-2 sentence style summary from analysis]
+```
+
+**If file saved BUT skill does NOT support `--ref`**:
+- Embed detailed text description in prompt:
+
+```
+# Reference Style (Text Description)
+Emulate the following visual style from reference image(s):
+
+Reference 1: [filename]
+- Style: [detailed rendering technique description]
+- Composition: [layout and hierarchy description]
+- Elements: [key visual elements used]
+- Mood: [emotional tone and visual weight]
+
+[Repeat for additional references]
+
+Apply these style characteristics to the cover design while maintaining the specified Type, Palette, and Rendering dimensions.
+```
+
+**If style/palette extracted verbally (NO file saved)**:
+- DO NOT add references metadata to prompt
+- Append extracted info directly to prompt body:
+
+```
+# Extracted Style (from reference)
+
+COLORS (from reference):
+- Primary: #E8756D coral
+- Secondary: #7ECFC0 mint
+...
+
+STYLE (from reference):
+- Clean lines, minimal shadows
+- Gradient backgrounds
+- Flat vector icons
+...
+```
+
+### Reference Analysis Template
+
+Use this format when analyzing reference images:
+
+| Aspect | Analysis Points |
+|--------|-----------------|
+| **Rendering** | Line quality (clean/sketchy/painted), texture presence, depth treatment |
+| **Composition** | Element placement, whitespace ratio, visual flow |
+| **Typography** | Font style, text placement, hierarchy (if present) |
+| **Elements** | Icon vocabulary, decorative motifs, character style |
+| **Mood** | Contrast level, saturation, visual weight |

skills/baoyu-format-markdown/SKILL.md

@@ -0,0 +1,298 @@
+---
+name: baoyu-format-markdown
+description: Formats plain text or markdown files with frontmatter, titles, summaries, headings, bold, lists, and code blocks. Use when user asks to "format markdown", "beautify article", "add formatting", or improve article layout. Outputs to {filename}-formatted.md.
+---
+
+# Markdown Formatter
+
+Transforms plain text or markdown files into well-structured markdown with proper frontmatter, formatting, and typography.
+
+## Script Directory
+
+Scripts in `scripts/` subdirectory. Replace `${SKILL_DIR}` with this SKILL.md's directory path.
+
+| Script | Purpose |
+|--------|---------|
+| `scripts/main.ts` | Main entry point with CLI options (uses remark-cjk-friendly for CJK emphasis) |
+| `scripts/quotes.ts` | Replace ASCII quotes with fullwidth quotes |
+| `scripts/autocorrect.ts` | Add CJK/English spacing via autocorrect |
+
+## Preferences (EXTEND.md)
+
+Use Bash to check EXTEND.md existence (priority order):
+
+```bash
+# Check project-level first
+test -f .baoyu-skills/baoyu-format-markdown/EXTEND.md && echo "project"
+
+# Then user-level (cross-platform: $HOME works on macOS/Linux/WSL)
+test -f "$HOME/.baoyu-skills/baoyu-format-markdown/EXTEND.md" && echo "user"
+```
+
+┌──────────────────────────────────────────────────────────┬───────────────────┐
+│                           Path                           │     Location      │
+├──────────────────────────────────────────────────────────┼───────────────────┤
+│ .baoyu-skills/baoyu-format-markdown/EXTEND.md            │ Project directory │
+├──────────────────────────────────────────────────────────┼───────────────────┤
+│ $HOME/.baoyu-skills/baoyu-format-markdown/EXTEND.md      │ User home         │
+└──────────────────────────────────────────────────────────┴───────────────────┘
+
+┌───────────┬───────────────────────────────────────────────────────────────────────────┐
+│  Result   │                                  Action                                   │
+├───────────┼───────────────────────────────────────────────────────────────────────────┤
+│ Found     │ Read, parse, apply settings                                               │
+├───────────┼───────────────────────────────────────────────────────────────────────────┤
+│ Not found │ Use defaults                                                              │
+└───────────┴───────────────────────────────────────────────────────────────────────────┘
+
+**EXTEND.md Supports**: Default formatting options | Summary length preferences
+
+## Usage
+
+Claude performs content analysis and formatting (Steps 1-6), then runs the script for typography fixes (Step 7).
+
+## Workflow
+
+### Step 1: Read Source File
+
+Read the user-specified markdown or plain text file.
+
+### Step 1.5: Detect Content Type & Confirm
+
+**Content Type Detection:**
+
+| Indicator | Classification |
+|-----------|----------------|
+| Has `---` YAML frontmatter | Markdown |
+| Has `#`, `##`, `###` headings | Markdown |
+| Has `**bold**`, `*italic*` | Markdown |
+| Has `- ` or `1. ` lists | Markdown |
+| Has ``` code blocks | Markdown |
+| Has `> ` blockquotes | Markdown |
+| None of above | Plain text |
+
+**Decision Flow:**
+
+┌─────────────────┬────────────────────────────────────────────────┐
+│  Content Type   │                     Action                     │
+├─────────────────┼────────────────────────────────────────────────┤
+│ Plain text      │ Proceed to Step 2 (format to markdown)         │
+├─────────────────┼────────────────────────────────────────────────┤
+│ Markdown        │ Use AskUserQuestion to confirm optimization    │
+└─────────────────┴────────────────────────────────────────────────┘
+
+**If Markdown detected, ask user:**
+
+```
+Detected existing markdown formatting. What would you like to do?
+
+1. Optimize formatting (Recommended)
+   - Add/improve frontmatter, headings, bold, lists
+   - Run typography script (spacing, emphasis fixes)
+   - Output: {filename}-formatted.md
+
+2. Keep original formatting
+   - Preserve existing markdown structure
+   - Run typography script (spacing, emphasis fixes)
+   - Output: {filename}-formatted.md
+
+3. Typography fixes only
+   - Run typography script on original file in-place
+   - No copy created, modifies original file directly
+```
+
+**Based on user choice:**
+- **Optimize**: Continue to Step 2-8 (full workflow)
+- **Keep original**: Skip Steps 2-5, copy file → Step 6-8 (run script on copy)
+- **Typography only**: Skip Steps 2-6, run Step 7 on original file directly
+
+### Step 2: Analyze Content Structure
+
+Identify:
+- Existing title (H1 `#`)
+- Paragraph separations
+- Keywords suitable for **bold**
+- Parallel content convertible to lists
+- Code snippets
+- Quotations
+
+### Step 3: Check/Create Frontmatter
+
+Check for YAML frontmatter (`---` block). Create if missing.
+
+**Meta field handling:**
+
+| Field | Processing |
+|-------|------------|
+| `title` | See Step 4 |
+| `slug` | Infer from file path (e.g., `posts/2026/01/10/vibe-coding/` → `vibe-coding`) or generate from title |
+| `summary` | Generate engaging summary (100-150 characters) |
+| `featureImage` | Check if `imgs/cover.png` exists in same directory; if so, use relative path |
+
+### Step 4: Title Handling
+
+**Logic:**
+1. If frontmatter already has `title` → use it, no H1 in body
+2. If first line is H1 → extract to frontmatter `title`, remove H1 from body
+3. If neither exists → generate candidate titles
+
+**Title generation flow:**
+
+1. Generate 3 candidate titles based on content
+2. Use `AskUserQuestion` tool:
+
+```
+Select a title:
+
+1. [Title A] (Recommended)
+2. [Title B]
+3. [Title C]
+```
+
+3. If no selection within a few seconds, use recommended (option 1)
+
+**Title principles:**
+- Concise, max 20 characters
+- Captures core message
+- Engaging, sparks reading interest
+- Accurate, avoids clickbait
+
+**Important:** Once title is in frontmatter, body should NOT have H1 (avoid duplication)
+
+### Step 5: Format Processing
+
+**Formatting rules:**
+
+| Element | Format |
+|---------|--------|
+| Titles | Use `#`, `##`, `###` hierarchy |
+| Key points | Use `**bold**` |
+| Parallel items | Convert to `-` unordered or `1.` ordered lists |
+| Code/commands | Use `` `inline` `` or ` ```block``` ` |
+| Quotes/sayings | Use `>` blockquote |
+| Separators | Use `---` where appropriate |
+
+**Formatting principles:**
+- Preserve original content and viewpoints
+- Add formatting only, do not modify text
+- Formatting serves readability
+- Avoid over-formatting
+
+### Step 6: Save Formatted File
+
+Save as `{original-filename}-formatted.md`
+
+Examples:
+- `final.md` → `final-formatted.md`
+- `draft-v1.md` → `draft-v1-formatted.md`
+
+**If user chose "Keep original formatting" (from Step 1.5):**
+- Copy original file to `{filename}-formatted.md` without modifications
+- Proceed to Step 7 for typography fixes only
+
+**Backup existing file:**
+
+If `{filename}-formatted.md` already exists, backup before overwriting:
+
+```bash
+# Check if formatted file exists
+if [ -f "{filename}-formatted.md" ]; then
+  # Backup with timestamp
+  mv "{filename}-formatted.md" "{filename}-formatted.backup-$(date +%Y%m%d-%H%M%S).md"
+fi
+```
+
+Example:
+- `final-formatted.md` exists → backup to `final-formatted.backup-20260128-143052.md`
+
+### Step 7: Execute Text Formatting Script
+
+After saving, **must** run the formatting script:
+
+```bash
+npx -y bun ${SKILL_DIR}/scripts/main.ts {output-file-path} [options]
+```
+
+**Script Options:**
+
+| Option | Short | Description | Default |
+|--------|-------|-------------|---------|
+| `--quotes` | `-q` | Replace ASCII quotes with fullwidth quotes `"..."` | false |
+| `--no-quotes` | | Do not replace quotes | |
+| `--spacing` | `-s` | Add CJK/English spacing via autocorrect | true |
+| `--no-spacing` | | Do not add CJK/English spacing | |
+| `--emphasis` | `-e` | Fix CJK emphasis punctuation issues | true |
+| `--no-emphasis` | | Do not fix CJK emphasis issues | |
+| `--help` | `-h` | Show help message | |
+
+**Examples:**
+
+```bash
+# Default: spacing + emphasis enabled, quotes disabled
+npx -y bun ${SKILL_DIR}/scripts/main.ts article.md
+
+# Enable all features including quote replacement
+npx -y bun ${SKILL_DIR}/scripts/main.ts article.md --quotes
+
+# Only fix emphasis issues, skip spacing
+npx -y bun ${SKILL_DIR}/scripts/main.ts article.md --no-spacing
+
+# Disable all processing except frontmatter formatting
+npx -y bun ${SKILL_DIR}/scripts/main.ts article.md --no-spacing --no-emphasis
+```
+
+**Script performs (based on options):**
+1. Fix CJK emphasis/bold punctuation issues (default: enabled)
+2. Add CJK/English mixed text spacing via autocorrect (default: enabled)
+3. Replace ASCII quotes `"..."` with fullwidth quotes `"..."` (default: disabled)
+4. Format frontmatter YAML (always enabled)
+
+### Step 8: Display Results
+
+```
+**Formatting complete**
+
+File: posts/2026/01/09/example/final-formatted.md
+
+Changes:
+- Added title: [title content]
+- Added X bold markers
+- Added X lists
+- Added X code blocks
+```
+
+## Formatting Example
+
+**Before:**
+```
+This is plain text. First point is efficiency improvement. Second point is cost reduction. Third point is experience optimization. Use npm install to install dependencies.
+```
+
+**After:**
+```markdown
+---
+title: Three Core Advantages
+slug: three-core-advantages
+summary: Discover the three key benefits that drive success in modern projects.
+---
+
+This is plain text.
+
+**Main advantages:**
+- Efficiency improvement
+- Cost reduction
+- Experience optimization
+
+Use `npm install` to install dependencies.
+```
+
+## Notes
+
+- Preserve original writing style and tone
+- Specify correct language for code blocks (e.g., `python`, `javascript`)
+- Maintain CJK/English spacing standards
+- Do not add content not present in original
+
+## Extension Support
+
+Custom configurations via EXTEND.md. See **Preferences** section for paths and supported options.

skills/baoyu-format-markdown/scripts/autocorrect.ts

@@ -0,0 +1,10 @@
+import { execSync } from "child_process";
+
+export function applyAutocorrect(filePath: string): boolean {
+  try {
+    execSync(`npx autocorrect-node --fix "${filePath}"`, { stdio: "inherit" });
+    return true;
+  } catch {
+    return false;
+  }
+}

skills/baoyu-format-markdown/scripts/bun.lock

@@ -0,0 +1,165 @@
+{
+  "lockfileVersion": 1,
+  "workspaces": {
+    "": {
+      "dependencies": {
+        "remark-frontmatter": "^5.0.0",
+        "remark-gfm": "^4.0.1",
+        "remark-parse": "^11.0.0",
+        "remark-stringify": "^11.0.0",
+        "unified": "^11.0.5",
+        "unist-util-visit": "^5.1.0",
+        "yaml": "^2.8.2",
+      },
+    },
+  },
+  "packages": {
+    "@types/debug": ["@types/debug@4.1.12", "", { "dependencies": { "@types/ms": "*" } }, "sha512-vIChWdVG3LG1SMxEvI/AK+FWJthlrqlTu7fbrlywTkkaONwk/UAGaULXRlf8vkzFBLVm0zkMdCquhL5aOjhXPQ=="],
+
+    "@types/mdast": ["@types/mdast@4.0.4", "", { "dependencies": { "@types/unist": "*" } }, "sha512-kGaNbPh1k7AFzgpud/gMdvIm5xuECykRR+JnWKQno9TAXVa6WIVCGTPvYGekIDL4uwCZQSYbUxNBSb1aUo79oA=="],
+
+    "@types/ms": ["@types/ms@2.1.0", "", {}, "sha512-GsCCIZDE/p3i96vtEqx+7dBUGXrc7zeSK3wwPHIaRThS+9OhWIXRqzs4d6k1SVU8g91DrNRWxWUGhp5KXQb2VA=="],
+
+    "@types/unist": ["@types/unist@3.0.3", "", {}, "sha512-ko/gIFJRv177XgZsZcBwnqJN5x/Gien8qNOn0D5bQU/zAzVf9Zt3BlcUiLqhV9y4ARk0GbT3tnUiPNgnTXzc/Q=="],
+
+    "bail": ["bail@2.0.2", "", {}, "sha512-0xO6mYd7JB2YesxDKplafRpsiOzPt9V02ddPCLbY1xYGPOX24NTyN50qnUxgCPcSoYMhKpAuBTjQoRZCAkUDRw=="],
+
+    "ccount": ["ccount@2.0.1", "", {}, "sha512-eyrF0jiFpY+3drT6383f1qhkbGsLSifNAjA61IUjZjmLCWjItY6LB9ft9YhoDgwfmclB2zhu51Lc7+95b8NRAg=="],
+
+    "character-entities": ["character-entities@2.0.2", "", {}, "sha512-shx7oQ0Awen/BRIdkjkvz54PnEEI/EjwXDSIZp86/KKdbafHh1Df/RYGBhn4hbe2+uKC9FnT5UCEdyPz3ai9hQ=="],
+
+    "debug": ["debug@4.4.3", "", { "dependencies": { "ms": "^2.1.3" } }, "sha512-RGwwWnwQvkVfavKVt22FGLw+xYSdzARwm0ru6DhTVA3umU5hZc28V3kO4stgYryrTlLpuvgI9GiijltAjNbcqA=="],
+
+    "decode-named-character-reference": ["decode-named-character-reference@1.3.0", "", { "dependencies": { "character-entities": "^2.0.0" } }, "sha512-GtpQYB283KrPp6nRw50q3U9/VfOutZOe103qlN7BPP6Ad27xYnOIWv4lPzo8HCAL+mMZofJ9KEy30fq6MfaK6Q=="],
+
+    "dequal": ["dequal@2.0.3", "", {}, "sha512-0je+qPKHEMohvfRTCEo3CrPG6cAzAYgmzKyxRiYSSDkS6eGJdyVJm7WaYA5ECaAD9wLB2T4EEeymA5aFVcYXCA=="],
+
+    "devlop": ["devlop@1.1.0", "", { "dependencies": { "dequal": "^2.0.0" } }, "sha512-RWmIqhcFf1lRYBvNmr7qTNuyCt/7/ns2jbpp1+PalgE/rDQcBT0fioSMUpJ93irlUhC5hrg4cYqe6U+0ImW0rA=="],
+
+    "escape-string-regexp": ["escape-string-regexp@5.0.0", "", {}, "sha512-/veY75JbMK4j1yjvuUxuVsiS/hr/4iHs9FTT6cgTexxdE0Ly/glccBAkloH/DofkjRbZU3bnoj38mOmhkZ0lHw=="],
+
+    "extend": ["extend@3.0.2", "", {}, "sha512-fjquC59cD7CyW6urNXK0FBufkZcoiGG80wTuPujX590cB5Ttln20E2UB4S/WARVqhXffZl2LNgS+gQdPIIim/g=="],
+
+    "fault": ["fault@2.0.1", "", { "dependencies": { "format": "^0.2.0" } }, "sha512-WtySTkS4OKev5JtpHXnib4Gxiurzh5NCGvWrFaZ34m6JehfTUhKZvn9njTfw48t6JumVQOmrKqpmGcdwxnhqBQ=="],
+
+    "format": ["format@0.2.2", "", {}, "sha512-wzsgA6WOq+09wrU1tsJ09udeR/YZRaeArL9e1wPbFg3GG2yDnC2ldKpxs4xunpFF9DgqCqOIra3bc1HWrJ37Ww=="],
+
+    "is-plain-obj": ["is-plain-obj@4.1.0", "", {}, "sha512-+Pgi+vMuUNkJyExiMBt5IlFoMyKnr5zhJ4Uspz58WOhBF5QoIZkFyNHIbBAtHwzVAgk5RtndVNsDRN61/mmDqg=="],
+
+    "longest-streak": ["longest-streak@3.1.0", "", {}, "sha512-9Ri+o0JYgehTaVBBDoMqIl8GXtbWg711O3srftcHhZ0dqnETqLaoIK0x17fUw9rFSlK/0NlsKe0Ahhyl5pXE2g=="],
+
+    "markdown-table": ["markdown-table@3.0.4", "", {}, "sha512-wiYz4+JrLyb/DqW2hkFJxP7Vd7JuTDm77fvbM8VfEQdmSMqcImWeeRbHwZjBjIFki/VaMK2BhFi7oUUZeM5bqw=="],
+
+    "mdast-util-find-and-replace": ["mdast-util-find-and-replace@3.0.2", "", { "dependencies": { "@types/mdast": "^4.0.0", "escape-string-regexp": "^5.0.0", "unist-util-is": "^6.0.0", "unist-util-visit-parents": "^6.0.0" } }, "sha512-Tmd1Vg/m3Xz43afeNxDIhWRtFZgM2VLyaf4vSTYwudTyeuTneoL3qtWMA5jeLyz/O1vDJmmV4QuScFCA2tBPwg=="],
+
+    "mdast-util-from-markdown": ["mdast-util-from-markdown@2.0.2", "", { "dependencies": { "@types/mdast": "^4.0.0", "@types/unist": "^3.0.0", "decode-named-character-reference": "^1.0.0", "devlop": "^1.0.0", "mdast-util-to-string": "^4.0.0", "micromark": "^4.0.0", "micromark-util-decode-numeric-character-reference": "^2.0.0", "micromark-util-decode-string": "^2.0.0", "micromark-util-normalize-identifier": "^2.0.0", "micromark-util-symbol": "^2.0.0", "micromark-util-types": "^2.0.0", "unist-util-stringify-position": "^4.0.0" } }, "sha512-uZhTV/8NBuw0WHkPTrCqDOl0zVe1BIng5ZtHoDk49ME1qqcjYmmLmOf0gELgcRMxN4w2iuIeVso5/6QymSrgmA=="],
+
+    "mdast-util-frontmatter": ["mdast-util-frontmatter@2.0.1", "", { "dependencies": { "@types/mdast": "^4.0.0", "devlop": "^1.0.0", "escape-string-regexp": "^5.0.0", "mdast-util-from-markdown": "^2.0.0", "mdast-util-to-markdown": "^2.0.0", "micromark-extension-frontmatter": "^2.0.0" } }, "sha512-LRqI9+wdgC25P0URIJY9vwocIzCcksduHQ9OF2joxQoyTNVduwLAFUzjoopuRJbJAReaKrNQKAZKL3uCMugWJA=="],
+
+    "mdast-util-gfm": ["mdast-util-gfm@3.1.0", "", { "dependencies": { "mdast-util-from-markdown": "^2.0.0", "mdast-util-gfm-autolink-literal": "^2.0.0", "mdast-util-gfm-footnote": "^2.0.0", "mdast-util-gfm-strikethrough": "^2.0.0", "mdast-util-gfm-table": "^2.0.0", "mdast-util-gfm-task-list-item": "^2.0.0", "mdast-util-to-markdown": "^2.0.0" } }, "sha512-0ulfdQOM3ysHhCJ1p06l0b0VKlhU0wuQs3thxZQagjcjPrlFRqY215uZGHHJan9GEAXd9MbfPjFJz+qMkVR6zQ=="],
+
+    "mdast-util-gfm-autolink-literal": ["mdast-util-gfm-autolink-literal@2.0.1", "", { "dependencies": { "@types/mdast": "^4.0.0", "ccount": "^2.0.0", "devlop": "^1.0.0", "mdast-util-find-and-replace": "^3.0.0", "micromark-util-character": "^2.0.0" } }, "sha512-5HVP2MKaP6L+G6YaxPNjuL0BPrq9orG3TsrZ9YXbA3vDw/ACI4MEsnoDpn6ZNm7GnZgtAcONJyPhOP8tNJQavQ=="],
+
+    "mdast-util-gfm-footnote": ["mdast-util-gfm-footnote@2.1.0", "", { "dependencies": { "@types/mdast": "^4.0.0", "devlop": "^1.1.0", "mdast-util-from-markdown": "^2.0.0", "mdast-util-to-markdown": "^2.0.0", "micromark-util-normalize-identifier": "^2.0.0" } }, "sha512-sqpDWlsHn7Ac9GNZQMeUzPQSMzR6Wv0WKRNvQRg0KqHh02fpTz69Qc1QSseNX29bhz1ROIyNyxExfawVKTm1GQ=="],
+
+    "mdast-util-gfm-strikethrough": ["mdast-util-gfm-strikethrough@2.0.0", "", { "dependencies": { "@types/mdast": "^4.0.0", "mdast-util-from-markdown": "^2.0.0", "mdast-util-to-markdown": "^2.0.0" } }, "sha512-mKKb915TF+OC5ptj5bJ7WFRPdYtuHv0yTRxK2tJvi+BDqbkiG7h7u/9SI89nRAYcmap2xHQL9D+QG/6wSrTtXg=="],
+
+    "mdast-util-gfm-table": ["mdast-util-gfm-table@2.0.0", "", { "dependencies": { "@types/mdast": "^4.0.0", "devlop": "^1.0.0", "markdown-table": "^3.0.0", "mdast-util-from-markdown": "^2.0.0", "mdast-util-to-markdown": "^2.0.0" } }, "sha512-78UEvebzz/rJIxLvE7ZtDd/vIQ0RHv+3Mh5DR96p7cS7HsBhYIICDBCu8csTNWNO6tBWfqXPWekRuj2FNOGOZg=="],
+
+    "mdast-util-gfm-task-list-item": ["mdast-util-gfm-task-list-item@2.0.0", "", { "dependencies": { "@types/mdast": "^4.0.0", "devlop": "^1.0.0", "mdast-util-from-markdown": "^2.0.0", "mdast-util-to-markdown": "^2.0.0" } }, "sha512-IrtvNvjxC1o06taBAVJznEnkiHxLFTzgonUdy8hzFVeDun0uTjxxrRGVaNFqkU1wJR3RBPEfsxmU6jDWPofrTQ=="],
+
+    "mdast-util-phrasing": ["mdast-util-phrasing@4.1.0", "", { "dependencies": { "@types/mdast": "^4.0.0", "unist-util-is": "^6.0.0" } }, "sha512-TqICwyvJJpBwvGAMZjj4J2n0X8QWp21b9l0o7eXyVJ25YNWYbJDVIyD1bZXE6WtV6RmKJVYmQAKWa0zWOABz2w=="],
+
+    "mdast-util-to-markdown": ["mdast-util-to-markdown@2.1.2", "", { "dependencies": { "@types/mdast": "^4.0.0", "@types/unist": "^3.0.0", "longest-streak": "^3.0.0", "mdast-util-phrasing": "^4.0.0", "mdast-util-to-string": "^4.0.0", "micromark-util-classify-character": "^2.0.0", "micromark-util-decode-string": "^2.0.0", "unist-util-visit": "^5.0.0", "zwitch": "^2.0.0" } }, "sha512-xj68wMTvGXVOKonmog6LwyJKrYXZPvlwabaryTjLh9LuvovB/KAH+kvi8Gjj+7rJjsFi23nkUxRQv1KqSroMqA=="],
+
+    "mdast-util-to-string": ["mdast-util-to-string@4.0.0", "", { "dependencies": { "@types/mdast": "^4.0.0" } }, "sha512-0H44vDimn51F0YwvxSJSm0eCDOJTRlmN0R1yBh4HLj9wiV1Dn0QoXGbvFAWj2hSItVTlCmBF1hqKlIyUBVFLPg=="],
+
+    "micromark": ["micromark@4.0.2", "", { "dependencies": { "@types/debug": "^4.0.0", "debug": "^4.0.0", "decode-named-character-reference": "^1.0.0", "devlop": "^1.0.0", "micromark-core-commonmark": "^2.0.0", "micromark-factory-space": "^2.0.0", "micromark-util-character": "^2.0.0", "micromark-util-chunked": "^2.0.0", "micromark-util-combine-extensions": "^2.0.0", "micromark-util-decode-numeric-character-reference": "^2.0.0", "micromark-util-encode": "^2.0.0", "micromark-util-normalize-identifier": "^2.0.0", "micromark-util-resolve-all": "^2.0.0", "micromark-util-sanitize-uri": "^2.0.0", "micromark-util-subtokenize": "^2.0.0", "micromark-util-symbol": "^2.0.0", "micromark-util-types": "^2.0.0" } }, "sha512-zpe98Q6kvavpCr1NPVSCMebCKfD7CA2NqZ+rykeNhONIJBpc1tFKt9hucLGwha3jNTNI8lHpctWJWoimVF4PfA=="],
+
+    "micromark-core-commonmark": ["micromark-core-commonmark@2.0.3", "", { "dependencies": { "decode-named-character-reference": "^1.0.0", "devlop": "^1.0.0", "micromark-factory-destination": "^2.0.0", "micromark-factory-label": "^2.0.0", "micromark-factory-space": "^2.0.0", "micromark-factory-title": "^2.0.0", "micromark-factory-whitespace": "^2.0.0", "micromark-util-character": "^2.0.0", "micromark-util-chunked": "^2.0.0", "micromark-util-classify-character": "^2.0.0", "micromark-util-html-tag-name": "^2.0.0", "micromark-util-normalize-identifier": "^2.0.0", "micromark-util-resolve-all": "^2.0.0", "micromark-util-subtokenize": "^2.0.0", "micromark-util-symbol": "^2.0.0", "micromark-util-types": "^2.0.0" } }, "sha512-RDBrHEMSxVFLg6xvnXmb1Ayr2WzLAWjeSATAoxwKYJV94TeNavgoIdA0a9ytzDSVzBy2YKFK+emCPOEibLeCrg=="],
+
+    "micromark-extension-frontmatter": ["micromark-extension-frontmatter@2.0.0", "", { "dependencies": { "fault": "^2.0.0", "micromark-util-character": "^2.0.0", "micromark-util-symbol": "^2.0.0", "micromark-util-types": "^2.0.0" } }, "sha512-C4AkuM3dA58cgZha7zVnuVxBhDsbttIMiytjgsM2XbHAB2faRVaHRle40558FBN+DJcrLNCoqG5mlrpdU4cRtg=="],
+
+    "micromark-extension-gfm": ["micromark-extension-gfm@3.0.0", "", { "dependencies": { "micromark-extension-gfm-autolink-literal": "^2.0.0", "micromark-extension-gfm-footnote": "^2.0.0", "micromark-extension-gfm-strikethrough": "^2.0.0", "micromark-extension-gfm-table": "^2.0.0", "micromark-extension-gfm-tagfilter": "^2.0.0", "micromark-extension-gfm-task-list-item": "^2.0.0", "micromark-util-combine-extensions": "^2.0.0", "micromark-util-types": "^2.0.0" } }, "sha512-vsKArQsicm7t0z2GugkCKtZehqUm31oeGBV/KVSorWSy8ZlNAv7ytjFhvaryUiCUJYqs+NoE6AFhpQvBTM6Q4w=="],
+
+    "micromark-extension-gfm-autolink-literal": ["micromark-extension-gfm-autolink-literal@2.1.0", "", { "dependencies": { "micromark-util-character": "^2.0.0", "micromark-util-sanitize-uri": "^2.0.0", "micromark-util-symbol": "^2.0.0", "micromark-util-types": "^2.0.0" } }, "sha512-oOg7knzhicgQ3t4QCjCWgTmfNhvQbDDnJeVu9v81r7NltNCVmhPy1fJRX27pISafdjL+SVc4d3l48Gb6pbRypw=="],
+
+    "micromark-extension-gfm-footnote": ["micromark-extension-gfm-footnote@2.1.0", "", { "dependencies": { "devlop": "^1.0.0", "micromark-core-commonmark": "^2.0.0", "micromark-factory-space": "^2.0.0", "micromark-util-character": "^2.0.0", "micromark-util-normalize-identifier": "^2.0.0", "micromark-util-sanitize-uri": "^2.0.0", "micromark-util-symbol": "^2.0.0", "micromark-util-types": "^2.0.0" } }, "sha512-/yPhxI1ntnDNsiHtzLKYnE3vf9JZ6cAisqVDauhp4CEHxlb4uoOTxOCJ+9s51bIB8U1N1FJ1RXOKTIlD5B/gqw=="],
+
+    "micromark-extension-gfm-strikethrough": ["micromark-extension-gfm-strikethrough@2.1.0", "", { "dependencies": { "devlop": "^1.0.0", "micromark-util-chunked": "^2.0.0", "micromark-util-classify-character": "^2.0.0", "micromark-util-resolve-all": "^2.0.0", "micromark-util-symbol": "^2.0.0", "micromark-util-types": "^2.0.0" } }, "sha512-ADVjpOOkjz1hhkZLlBiYA9cR2Anf8F4HqZUO6e5eDcPQd0Txw5fxLzzxnEkSkfnD0wziSGiv7sYhk/ktvbf1uw=="],
+
+    "micromark-extension-gfm-table": ["micromark-extension-gfm-table@2.1.1", "", { "dependencies": { "devlop": "^1.0.0", "micromark-factory-space": "^2.0.0", "micromark-util-character": "^2.0.0", "micromark-util-symbol": "^2.0.0", "micromark-util-types": "^2.0.0" } }, "sha512-t2OU/dXXioARrC6yWfJ4hqB7rct14e8f7m0cbI5hUmDyyIlwv5vEtooptH8INkbLzOatzKuVbQmAYcbWoyz6Dg=="],
+
+    "micromark-extension-gfm-tagfilter": ["micromark-extension-gfm-tagfilter@2.0.0", "", { "dependencies": { "micromark-util-types": "^2.0.0" } }, "sha512-xHlTOmuCSotIA8TW1mDIM6X2O1SiX5P9IuDtqGonFhEK0qgRI4yeC6vMxEV2dgyr2TiD+2PQ10o+cOhdVAcwfg=="],
+
+    "micromark-extension-gfm-task-list-item": ["micromark-extension-gfm-task-list-item@2.1.0", "", { "dependencies": { "devlop": "^1.0.0", "micromark-factory-space": "^2.0.0", "micromark-util-character": "^2.0.0", "micromark-util-symbol": "^2.0.0", "micromark-util-types": "^2.0.0" } }, "sha512-qIBZhqxqI6fjLDYFTBIa4eivDMnP+OZqsNwmQ3xNLE4Cxwc+zfQEfbs6tzAo2Hjq+bh6q5F+Z8/cksrLFYWQQw=="],
+
+    "micromark-factory-destination": ["micromark-factory-destination@2.0.1", "", { "dependencies": { "micromark-util-character": "^2.0.0", "micromark-util-symbol": "^2.0.0", "micromark-util-types": "^2.0.0" } }, "sha512-Xe6rDdJlkmbFRExpTOmRj9N3MaWmbAgdpSrBQvCFqhezUn4AHqJHbaEnfbVYYiexVSs//tqOdY/DxhjdCiJnIA=="],
+
+    "micromark-factory-label": ["micromark-factory-label@2.0.1", "", { "dependencies": { "devlop": "^1.0.0", "micromark-util-character": "^2.0.0", "micromark-util-symbol": "^2.0.0", "micromark-util-types": "^2.0.0" } }, "sha512-VFMekyQExqIW7xIChcXn4ok29YE3rnuyveW3wZQWWqF4Nv9Wk5rgJ99KzPvHjkmPXF93FXIbBp6YdW3t71/7Vg=="],
+
+    "micromark-factory-space": ["micromark-factory-space@2.0.1", "", { "dependencies": { "micromark-util-character": "^2.0.0", "micromark-util-types": "^2.0.0" } }, "sha512-zRkxjtBxxLd2Sc0d+fbnEunsTj46SWXgXciZmHq0kDYGnck/ZSGj9/wULTV95uoeYiK5hRXP2mJ98Uo4cq/LQg=="],
+
+    "micromark-factory-title": ["micromark-factory-title@2.0.1", "", { "dependencies": { "micromark-factory-space": "^2.0.0", "micromark-util-character": "^2.0.0", "micromark-util-symbol": "^2.0.0", "micromark-util-types": "^2.0.0" } }, "sha512-5bZ+3CjhAd9eChYTHsjy6TGxpOFSKgKKJPJxr293jTbfry2KDoWkhBb6TcPVB4NmzaPhMs1Frm9AZH7OD4Cjzw=="],
+
+    "micromark-factory-whitespace": ["micromark-factory-whitespace@2.0.1", "", { "dependencies": { "micromark-factory-space": "^2.0.0", "micromark-util-character": "^2.0.0", "micromark-util-symbol": "^2.0.0", "micromark-util-types": "^2.0.0" } }, "sha512-Ob0nuZ3PKt/n0hORHyvoD9uZhr+Za8sFoP+OnMcnWK5lngSzALgQYKMr9RJVOWLqQYuyn6ulqGWSXdwf6F80lQ=="],
+
+    "micromark-util-character": ["micromark-util-character@2.1.1", "", { "dependencies": { "micromark-util-symbol": "^2.0.0", "micromark-util-types": "^2.0.0" } }, "sha512-wv8tdUTJ3thSFFFJKtpYKOYiGP2+v96Hvk4Tu8KpCAsTMs6yi+nVmGh1syvSCsaxz45J6Jbw+9DD6g97+NV67Q=="],
+
+    "micromark-util-chunked": ["micromark-util-chunked@2.0.1", "", { "dependencies": { "micromark-util-symbol": "^2.0.0" } }, "sha512-QUNFEOPELfmvv+4xiNg2sRYeS/P84pTW0TCgP5zc9FpXetHY0ab7SxKyAQCNCc1eK0459uoLI1y5oO5Vc1dbhA=="],
+
+    "micromark-util-classify-character": ["micromark-util-classify-character@2.0.1", "", { "dependencies": { "micromark-util-character": "^2.0.0", "micromark-util-symbol": "^2.0.0", "micromark-util-types": "^2.0.0" } }, "sha512-K0kHzM6afW/MbeWYWLjoHQv1sgg2Q9EccHEDzSkxiP/EaagNzCm7T/WMKZ3rjMbvIpvBiZgwR3dKMygtA4mG1Q=="],
+
+    "micromark-util-combine-extensions": ["micromark-util-combine-extensions@2.0.1", "", { "dependencies": { "micromark-util-chunked": "^2.0.0", "micromark-util-types": "^2.0.0" } }, "sha512-OnAnH8Ujmy59JcyZw8JSbK9cGpdVY44NKgSM7E9Eh7DiLS2E9RNQf0dONaGDzEG9yjEl5hcqeIsj4hfRkLH/Bg=="],
+
+    "micromark-util-decode-numeric-character-reference": ["micromark-util-decode-numeric-character-reference@2.0.2", "", { "dependencies": { "micromark-util-symbol": "^2.0.0" } }, "sha512-ccUbYk6CwVdkmCQMyr64dXz42EfHGkPQlBj5p7YVGzq8I7CtjXZJrubAYezf7Rp+bjPseiROqe7G6foFd+lEuw=="],
+
+    "micromark-util-decode-string": ["micromark-util-decode-string@2.0.1", "", { "dependencies": { "decode-named-character-reference": "^1.0.0", "micromark-util-character": "^2.0.0", "micromark-util-decode-numeric-character-reference": "^2.0.0", "micromark-util-symbol": "^2.0.0" } }, "sha512-nDV/77Fj6eH1ynwscYTOsbK7rR//Uj0bZXBwJZRfaLEJ1iGBR6kIfNmlNqaqJf649EP0F3NWNdeJi03elllNUQ=="],
+
+    "micromark-util-encode": ["micromark-util-encode@2.0.1", "", {}, "sha512-c3cVx2y4KqUnwopcO9b/SCdo2O67LwJJ/UyqGfbigahfegL9myoEFoDYZgkT7f36T0bLrM9hZTAaAyH+PCAXjw=="],
+
+    "micromark-util-html-tag-name": ["micromark-util-html-tag-name@2.0.1", "", {}, "sha512-2cNEiYDhCWKI+Gs9T0Tiysk136SnR13hhO8yW6BGNyhOC4qYFnwF1nKfD3HFAIXA5c45RrIG1ub11GiXeYd1xA=="],
+
+    "micromark-util-normalize-identifier": ["micromark-util-normalize-identifier@2.0.1", "", { "dependencies": { "micromark-util-symbol": "^2.0.0" } }, "sha512-sxPqmo70LyARJs0w2UclACPUUEqltCkJ6PhKdMIDuJ3gSf/Q+/GIe3WKl0Ijb/GyH9lOpUkRAO2wp0GVkLvS9Q=="],
+
+    "micromark-util-resolve-all": ["micromark-util-resolve-all@2.0.1", "", { "dependencies": { "micromark-util-types": "^2.0.0" } }, "sha512-VdQyxFWFT2/FGJgwQnJYbe1jjQoNTS4RjglmSjTUlpUMa95Htx9NHeYW4rGDJzbjvCsl9eLjMQwGeElsqmzcHg=="],
+
+    "micromark-util-sanitize-uri": ["micromark-util-sanitize-uri@2.0.1", "", { "dependencies": { "micromark-util-character": "^2.0.0", "micromark-util-encode": "^2.0.0", "micromark-util-symbol": "^2.0.0" } }, "sha512-9N9IomZ/YuGGZZmQec1MbgxtlgougxTodVwDzzEouPKo3qFWvymFHWcnDi2vzV1ff6kas9ucW+o3yzJK9YB1AQ=="],
+
+    "micromark-util-subtokenize": ["micromark-util-subtokenize@2.1.0", "", { "dependencies": { "devlop": "^1.0.0", "micromark-util-chunked": "^2.0.0", "micromark-util-symbol": "^2.0.0", "micromark-util-types": "^2.0.0" } }, "sha512-XQLu552iSctvnEcgXw6+Sx75GflAPNED1qx7eBJ+wydBb2KCbRZe+NwvIEEMM83uml1+2WSXpBAcp9IUCgCYWA=="],
+
+    "micromark-util-symbol": ["micromark-util-symbol@2.0.1", "", {}, "sha512-vs5t8Apaud9N28kgCrRUdEed4UJ+wWNvicHLPxCa9ENlYuAY31M0ETy5y1vA33YoNPDFTghEbnh6efaE8h4x0Q=="],
+
+    "micromark-util-types": ["micromark-util-types@2.0.2", "", {}, "sha512-Yw0ECSpJoViF1qTU4DC6NwtC4aWGt1EkzaQB8KPPyCRR8z9TWeV0HbEFGTO+ZY1wB22zmxnJqhPyTpOVCpeHTA=="],
+
+    "ms": ["ms@2.1.3", "", {}, "sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA=="],
+
+    "remark-frontmatter": ["remark-frontmatter@5.0.0", "", { "dependencies": { "@types/mdast": "^4.0.0", "mdast-util-frontmatter": "^2.0.0", "micromark-extension-frontmatter": "^2.0.0", "unified": "^11.0.0" } }, "sha512-XTFYvNASMe5iPN0719nPrdItC9aU0ssC4v14mH1BCi1u0n1gAocqcujWUrByftZTbLhRtiKRyjYTSIOcr69UVQ=="],
+
+    "remark-gfm": ["remark-gfm@4.0.1", "", { "dependencies": { "@types/mdast": "^4.0.0", "mdast-util-gfm": "^3.0.0", "micromark-extension-gfm": "^3.0.0", "remark-parse": "^11.0.0", "remark-stringify": "^11.0.0", "unified": "^11.0.0" } }, "sha512-1quofZ2RQ9EWdeN34S79+KExV1764+wCUGop5CPL1WGdD0ocPpu91lzPGbwWMECpEpd42kJGQwzRfyov9j4yNg=="],
+
+    "remark-parse": ["remark-parse@11.0.0", "", { "dependencies": { "@types/mdast": "^4.0.0", "mdast-util-from-markdown": "^2.0.0", "micromark-util-types": "^2.0.0", "unified": "^11.0.0" } }, "sha512-FCxlKLNGknS5ba/1lmpYijMUzX2esxW5xQqjWxw2eHFfS2MSdaHVINFmhjo+qN1WhZhNimq0dZATN9pH0IDrpA=="],
+
+    "remark-stringify": ["remark-stringify@11.0.0", "", { "dependencies": { "@types/mdast": "^4.0.0", "mdast-util-to-markdown": "^2.0.0", "unified": "^11.0.0" } }, "sha512-1OSmLd3awB/t8qdoEOMazZkNsfVTeY4fTsgzcQFdXNq8ToTN4ZGwrMnlda4K6smTFKD+GRV6O48i6Z4iKgPPpw=="],
+
+    "trough": ["trough@2.2.0", "", {}, "sha512-tmMpK00BjZiUyVyvrBK7knerNgmgvcV/KLVyuma/SC+TQN167GrMRciANTz09+k3zW8L8t60jWO1GpfkZdjTaw=="],
+
+    "unified": ["unified@11.0.5", "", { "dependencies": { "@types/unist": "^3.0.0", "bail": "^2.0.0", "devlop": "^1.0.0", "extend": "^3.0.0", "is-plain-obj": "^4.0.0", "trough": "^2.0.0", "vfile": "^6.0.0" } }, "sha512-xKvGhPWw3k84Qjh8bI3ZeJjqnyadK+GEFtazSfZv/rKeTkTjOJho6mFqh2SM96iIcZokxiOpg78GazTSg8+KHA=="],
+
+    "unist-util-is": ["unist-util-is@6.0.1", "", { "dependencies": { "@types/unist": "^3.0.0" } }, "sha512-LsiILbtBETkDz8I9p1dQ0uyRUWuaQzd/cuEeS1hoRSyW5E5XGmTzlwY1OrNzzakGowI9Dr/I8HVaw4hTtnxy8g=="],
+
+    "unist-util-stringify-position": ["unist-util-stringify-position@4.0.0", "", { "dependencies": { "@types/unist": "^3.0.0" } }, "sha512-0ASV06AAoKCDkS2+xw5RXJywruurpbC4JZSm7nr7MOt1ojAzvyyaO+UxZf18j8FCF6kmzCZKcAgN/yu2gm2XgQ=="],
+
+    "unist-util-visit": ["unist-util-visit@5.1.0", "", { "dependencies": { "@types/unist": "^3.0.0", "unist-util-is": "^6.0.0", "unist-util-visit-parents": "^6.0.0" } }, "sha512-m+vIdyeCOpdr/QeQCu2EzxX/ohgS8KbnPDgFni4dQsfSCtpz8UqDyY5GjRru8PDKuYn7Fq19j1CQ+nJSsGKOzg=="],
+
+    "unist-util-visit-parents": ["unist-util-visit-parents@6.0.2", "", { "dependencies": { "@types/unist": "^3.0.0", "unist-util-is": "^6.0.0" } }, "sha512-goh1s1TBrqSqukSc8wrjwWhL0hiJxgA8m4kFxGlQ+8FYQ3C/m11FcTs4YYem7V664AhHVvgoQLk890Ssdsr2IQ=="],
+
+    "vfile": ["vfile@6.0.3", "", { "dependencies": { "@types/unist": "^3.0.0", "vfile-message": "^4.0.0" } }, "sha512-KzIbH/9tXat2u30jf+smMwFCsno4wHVdNmzFyL+T/L3UGqqk6JKfVqOFOZEpZSHADH1k40ab6NUIXZq422ov3Q=="],
+
+    "vfile-message": ["vfile-message@4.0.3", "", { "dependencies": { "@types/unist": "^3.0.0", "unist-util-stringify-position": "^4.0.0" } }, "sha512-QTHzsGd1EhbZs4AsQ20JX1rC3cOlt/IWJruk893DfLRr57lcnOeMaWG4K0JrRta4mIJZKth2Au3mM3u03/JWKw=="],
+
+    "yaml": ["yaml@2.8.2", "", { "bin": { "yaml": "bin.mjs" } }, "sha512-mplynKqc1C2hTVYxd0PU2xQAc22TI1vShAYGksCCfxbn/dFwnHTNi1bvYsBTkhdUNtGIf5xNOg938rrSSYvS9A=="],
+
+    "zwitch": ["zwitch@2.0.4", "", {}, "sha512-bXE4cR/kVZhKZX/RjPEflHaKVhUVl85noU3v6b8apfQEc1x4A+zBxjZ4lN8LqGd6WZ3dl98pY4o717VFmoPp+A=="],
+  }
+}

skills/baoyu-format-markdown/scripts/main.ts

@@ -0,0 +1,176 @@
+import { readFileSync, writeFileSync } from "fs";
+import { unified } from "unified";
+import remarkParse from "remark-parse";
+import remarkCjkFriendly from "remark-cjk-friendly";
+import remarkGfm from "remark-gfm";
+import remarkFrontmatter from "remark-frontmatter";
+import remarkStringify from "remark-stringify";
+import { visit } from "unist-util-visit";
+import YAML from "yaml";
+import { replaceQuotes } from "./quotes";
+import { applyAutocorrect } from "./autocorrect";
+
+export interface FormatOptions {
+  quotes?: boolean;
+  spacing?: boolean;
+  emphasis?: boolean;
+}
+
+export interface FormatResult {
+  success: boolean;
+  filePath: string;
+  quotesFixed: boolean;
+  spacingApplied: boolean;
+  emphasisFixed: boolean;
+  error?: string;
+}
+
+const DEFAULT_OPTIONS: Required<FormatOptions> = {
+  quotes: false,
+  spacing: true,
+  emphasis: true,
+};
+
+function decodeHtmlEntities(text: string): string {
+  return text.replace(/&#x([0-9A-Fa-f]+);/g, (_, hex) =>
+    String.fromCodePoint(parseInt(hex, 16))
+  );
+}
+
+function formatFrontmatter(value: string): string | null {
+  try {
+    const doc = YAML.parseDocument(value);
+    return doc.toString({ lineWidth: 0 }).trimEnd();
+  } catch {
+    return null;
+  }
+}
+
+function formatMarkdownContent(
+  content: string,
+  options: Required<FormatOptions>
+): string {
+  const processor = unified()
+    .use(remarkParse)
+    .use(options.emphasis ? remarkCjkFriendly : [])
+    .use(remarkGfm)
+    .use(remarkFrontmatter, ["yaml"])
+    .use(remarkStringify, {
+      wrap: false,
+    });
+
+  const tree = processor.parse(content);
+
+  visit(tree, (node) => {
+    if (node.type === "text" && options.quotes) {
+      const textNode = node as { value: string };
+      textNode.value = replaceQuotes(textNode.value);
+      return;
+    }
+    if (node.type === "yaml") {
+      const yamlNode = node as { value: string };
+      const formatted = formatFrontmatter(yamlNode.value);
+      if (formatted !== null) {
+        yamlNode.value = formatted;
+      }
+      return;
+    }
+  });
+
+  let result = processor.stringify(tree);
+  if (options.emphasis) {
+    result = decodeHtmlEntities(result);
+  }
+  return result;
+}
+
+export function formatMarkdown(
+  filePath: string,
+  options?: FormatOptions
+): FormatResult {
+  const opts: Required<FormatOptions> = { ...DEFAULT_OPTIONS, ...options };
+
+  const result: FormatResult = {
+    success: false,
+    filePath,
+    quotesFixed: false,
+    spacingApplied: false,
+    emphasisFixed: false,
+  };
+
+  try {
+    const content = readFileSync(filePath, "utf-8");
+    const formattedContent = formatMarkdownContent(content, opts);
+
+    result.quotesFixed = opts.quotes;
+    result.emphasisFixed = opts.emphasis;
+
+    writeFileSync(filePath, formattedContent, "utf-8");
+
+    if (opts.spacing) {
+      result.spacingApplied = applyAutocorrect(filePath);
+    }
+
+    result.success = true;
+    console.log(`✓ Formatted: ${filePath}`);
+  } catch (error) {
+    result.error = error instanceof Error ? error.message : String(error);
+    console.error(`✗ Format failed: ${result.error}`);
+  }
+
+  return result;
+}
+
+function parseArgs(args: string[]): { filePath: string; options: FormatOptions } {
+  const options: FormatOptions = {};
+  let filePath = "";
+
+  for (let i = 0; i < args.length; i++) {
+    const arg = args[i];
+
+    if (arg === "--quotes" || arg === "-q") {
+      options.quotes = true;
+    } else if (arg === "--no-quotes") {
+      options.quotes = false;
+    } else if (arg === "--spacing" || arg === "-s") {
+      options.spacing = true;
+    } else if (arg === "--no-spacing") {
+      options.spacing = false;
+    } else if (arg === "--emphasis" || arg === "-e") {
+      options.emphasis = true;
+    } else if (arg === "--no-emphasis") {
+      options.emphasis = false;
+    } else if (arg === "--help" || arg === "-h") {
+      console.log(`Usage: npx -y bun scripts/main.ts <file.md> [options]
+
+Options:
+  -q, --quotes       Replace ASCII quotes with fullwidth quotes (default: false)
+      --no-quotes    Do not replace quotes
+  -s, --spacing      Add CJK/English spacing via autocorrect (default: true)
+      --no-spacing   Do not add CJK/English spacing
+  -e, --emphasis     Fix CJK emphasis punctuation issues (default: true)
+      --no-emphasis  Do not fix CJK emphasis issues
+  -h, --help         Show this help message`);
+      process.exit(0);
+    } else if (!arg.startsWith("-")) {
+      filePath = arg;
+    }
+  }
+
+  return { filePath, options };
+}
+
+if (import.meta.url === `file://${process.argv[1]}`) {
+  const { filePath, options } = parseArgs(process.argv.slice(2));
+
+  if (!filePath) {
+    console.error("Usage: npx -y bun scripts/main.ts <file.md> [options]");
+    console.error("Use --help for more information.");
+    process.exit(1);
+  }
+
+  const result = formatMarkdown(filePath, options);
+  if (!result.success) {
+    process.exit(1);
+  }
+}

skills/baoyu-format-markdown/scripts/package.json

@@ -0,0 +1,12 @@
+{
+  "dependencies": {
+    "remark-cjk-friendly": "^1.1.0",
+    "remark-frontmatter": "^5.0.0",
+    "remark-gfm": "^4.0.1",
+    "remark-parse": "^11.0.0",
+    "remark-stringify": "^11.0.0",
+    "unified": "^11.0.5",
+    "unist-util-visit": "^5.1.0",
+    "yaml": "^2.8.2"
+  }
+}

skills/baoyu-format-markdown/scripts/quotes.ts

@@ -0,0 +1,5 @@
+export function replaceQuotes(content: string): string {
+  return content
+    .replace(/"([^"]+)"/g, "\u201c$1\u201d")
+    .replace(/「([^」]+)」/g, "\u201c$1\u201d");
+}

skills/baoyu-image-gen/SKILL.md

@@ -1,11 +1,11 @@
 ---
 name: baoyu-image-gen
-description: AI image generation with OpenAI and Google APIs. Supports text-to-image, reference images, aspect ratios, and parallel generation (recommended 4 concurrent subagents). Use when user asks to generate, create, or draw images.
+description: AI image generation with OpenAI, Google and DashScope APIs. Supports text-to-image, reference images, aspect ratios. Sequential by default; parallel generation available on request. Use when user asks to generate, create, or draw images.
 ---
 
 # Image Generation (AI SDK)
 
-Official API-based image generation. Supports OpenAI and Google providers.
+Official API-based image generation. Supports OpenAI, Google and DashScope (阿里通义万象) providers.
 
 ## Script Directory
 
@@ -63,6 +63,9 @@ npx -y bun ${SKILL_DIR}/scripts/main.ts --prompt "Make blue" --image out.png --r
 
 # Specific provider
 npx -y bun ${SKILL_DIR}/scripts/main.ts --prompt "A cat" --image out.png --provider openai
+
+# DashScope (阿里通义万象)
+npx -y bun ${SKILL_DIR}/scripts/main.ts --prompt "一只可爱的猫" --image out.png --provider dashscope
 ```
 
 ## Options
@@ -72,7 +75,7 @@ npx -y bun ${SKILL_DIR}/scripts/main.ts --prompt "A cat" --image out.png --provi
 | `--prompt <text>`, `-p` | Prompt text |
 | `--promptfiles <files...>` | Read prompt from files (concatenated) |
 | `--image <path>` | Output image path (required) |
-| `--provider google\|openai` | Force provider (default: google) |
+| `--provider google\|openai\|dashscope` | Force provider (default: google) |
 | `--model <id>`, `-m` | Model ID |
 | `--ar <ratio>` | Aspect ratio (e.g., `16:9`, `1:1`, `4:3`) |
 | `--size <WxH>` | Size (e.g., `1024x1024`) |
@@ -88,10 +91,13 @@ npx -y bun ${SKILL_DIR}/scripts/main.ts --prompt "A cat" --image out.png --provi
 |----------|-------------|
 | `OPENAI_API_KEY` | OpenAI API key |
 | `GOOGLE_API_KEY` | Google API key |
+| `DASHSCOPE_API_KEY` | DashScope API key (阿里云) |
 | `OPENAI_IMAGE_MODEL` | OpenAI model override |
 | `GOOGLE_IMAGE_MODEL` | Google model override |
+| `DASHSCOPE_IMAGE_MODEL` | DashScope model override (default: z-image-turbo) |
 | `OPENAI_BASE_URL` | Custom OpenAI endpoint |
 | `GOOGLE_BASE_URL` | Custom Google endpoint |
+| `DASHSCOPE_BASE_URL` | Custom DashScope endpoint |
 
 **Load Priority**: CLI args > env vars > `<cwd>/.baoyu-skills/.env` > `~/.baoyu-skills/.env`
 
@@ -99,7 +105,7 @@ npx -y bun ${SKILL_DIR}/scripts/main.ts --prompt "A cat" --image out.png --provi
 
 1. `--provider` specified → use it
 2. Only one API key available → use that provider
-3. Both available → default to Google
+3. Multiple available → default to Google
 
 ## Quality Presets
 
@@ -118,25 +124,32 @@ Supported: `1:1`, `16:9`, `9:16`, `4:3`, `3:4`, `2.35:1`
 - Google Imagen: uses `aspectRatio` parameter
 - OpenAI: maps to closest supported size
 
-## Parallel Generation
+## Generation Mode
 
-Supports concurrent image generation via background subagents for batch operations.
+**Default**: Sequential generation (one image at a time). This ensures stable output and easier debugging.
+
+**Parallel Generation**: Only use when user explicitly requests parallel/concurrent generation.
+
+| Mode | When to Use |
+|------|-------------|
+| Sequential (default) | Normal usage, single images, small batches |
+| Parallel | User explicitly requests, large batches (10+) |
+
+**Parallel Settings** (when requested):
 
 | Setting | Value |
 |---------|-------|
 | Recommended concurrency | 4 subagents |
 | Max concurrency | 8 subagents |
-| Use case | Batch generation (slides, comics, infographics) |
+| Use case | Large batch generation when user requests parallel |
 
-**Agent Implementation**:
+**Agent Implementation** (parallel mode only):
 ```
 # Launch multiple generations in parallel using Task tool
 # Each Task runs as background subagent with run_in_background=true
 # Collect results via TaskOutput when all complete
 ```
 
-**Best Practice**: When generating 4+ images, spawn background subagents (recommended 4 concurrent) instead of sequential execution.
-
 ## Error Handling
 
 - Missing API key → error with setup instructions

skills/baoyu-image-gen/scripts/main.ts

@@ -14,7 +14,7 @@ Options:
   -p, --prompt <text>       Prompt text
   --promptfiles <files...>  Read prompt from files (concatenated)
   --image <path>            Output image path (required)
-  --provider google|openai  Force provider (auto-detect by default)
+  --provider google|openai|dashscope  Force provider (auto-detect by default)
   -m, --model <id>          Model ID
   --ar <ratio>              Aspect ratio (e.g., 16:9, 1:1, 4:3)
   --size <WxH>              Size (e.g., 1024x1024)
@@ -29,10 +29,13 @@ Environment variables:
   OPENAI_API_KEY            OpenAI API key
   GOOGLE_API_KEY            Google API key
   GEMINI_API_KEY            Gemini API key (alias for GOOGLE_API_KEY)
+  DASHSCOPE_API_KEY         DashScope API key (阿里云通义万象)
   OPENAI_IMAGE_MODEL        Default OpenAI model (gpt-image-1.5)
   GOOGLE_IMAGE_MODEL        Default Google model (gemini-3-pro-image-preview)
+  DASHSCOPE_IMAGE_MODEL     Default DashScope model (z-image-turbo)
   OPENAI_BASE_URL           Custom OpenAI endpoint
   GOOGLE_BASE_URL           Custom Google endpoint
+  DASHSCOPE_BASE_URL        Custom DashScope endpoint
 
 Env file load order: CLI args > process.env > <cwd>/.baoyu-skills/.env > ~/.baoyu-skills/.env`);
 }
@@ -105,7 +108,7 @@ function parseArgs(argv: string[]): CliArgs {
 
     if (a === "--provider") {
       const v = argv[++i];
-      if (v !== "google" && v !== "openai") throw new Error(`Invalid provider: ${v}`);
+      if (v !== "google" && v !== "openai" && v !== "dashscope") throw new Error(`Invalid provider: ${v}`);
       out.provider = v;
       continue;
     }
@@ -243,13 +246,15 @@ function detectProvider(args: CliArgs): Provider {
 
   const hasGoogle = !!(process.env.GOOGLE_API_KEY || process.env.GEMINI_API_KEY);
   const hasOpenai = !!process.env.OPENAI_API_KEY;
+  const hasDashscope = !!process.env.DASHSCOPE_API_KEY;
 
-  if (hasGoogle && !hasOpenai) return "google";
-  if (hasOpenai && !hasGoogle) return "openai";
-  if (hasGoogle && hasOpenai) return "google";
+  const available = [hasGoogle && "google", hasOpenai && "openai", hasDashscope && "dashscope"].filter(Boolean) as Provider[];
+
+  if (available.length === 1) return available[0]!;
+  if (available.length > 1) return available[0]!;
 
   throw new Error(
-    "No API key found. Set GOOGLE_API_KEY, GEMINI_API_KEY, or OPENAI_API_KEY.\n" +
+    "No API key found. Set GOOGLE_API_KEY, GEMINI_API_KEY, OPENAI_API_KEY, or DASHSCOPE_API_KEY.\n" +
       "Create ~/.baoyu-skills/.env or <cwd>/.baoyu-skills/.env with your keys."
   );
 }
@@ -263,6 +268,9 @@ async function loadProviderModule(provider: Provider): Promise<ProviderModule> {
   if (provider === "google") {
     return (await import("./providers/google")) as ProviderModule;
   }
+  if (provider === "dashscope") {
+    return (await import("./providers/dashscope")) as ProviderModule;
+  }
   return (await import("./providers/openai")) as ProviderModule;
 }
 

skills/baoyu-image-gen/scripts/providers/dashscope.ts

@@ -0,0 +1,137 @@
+import type { CliArgs } from "../types";
+
+export function getDefaultModel(): string {
+  return process.env.DASHSCOPE_IMAGE_MODEL || "z-image-turbo";
+}
+
+function getApiKey(): string | null {
+  return process.env.DASHSCOPE_API_KEY || null;
+}
+
+function getBaseUrl(): string {
+  const base = process.env.DASHSCOPE_BASE_URL || "https://dashscope.aliyuncs.com";
+  return base.replace(/\/+$/g, "");
+}
+
+function parseAspectRatio(ar: string): { width: number; height: number } | null {
+  const match = ar.match(/^(\d+(?:\.\d+)?):(\d+(?:\.\d+)?)$/);
+  if (!match) return null;
+  const w = parseFloat(match[1]!);
+  const h = parseFloat(match[2]!);
+  if (w <= 0 || h <= 0) return null;
+  return { width: w, height: h };
+}
+
+function getSizeFromAspectRatio(ar: string | null, quality: CliArgs["quality"]): string {
+  const baseSize = quality === "2k" ? 1440 : 1024;
+
+  if (!ar) return `${baseSize}*${baseSize}`;
+
+  const parsed = parseAspectRatio(ar);
+  if (!parsed) return `${baseSize}*${baseSize}`;
+
+  const ratio = parsed.width / parsed.height;
+
+  if (Math.abs(ratio - 1) < 0.1) {
+    return `${baseSize}*${baseSize}`;
+  }
+
+  if (ratio > 1) {
+    const w = Math.round(baseSize * ratio);
+    return `${w}*${baseSize}`;
+  }
+
+  const h = Math.round(baseSize / ratio);
+  return `${baseSize}*${h}`;
+}
+
+function normalizeSize(size: string): string {
+  return size.replace("x", "*");
+}
+
+export async function generateImage(
+  prompt: string,
+  model: string,
+  args: CliArgs
+): Promise<Uint8Array> {
+  const apiKey = getApiKey();
+  if (!apiKey) throw new Error("DASHSCOPE_API_KEY is required");
+
+  if (args.referenceImages.length > 0) {
+    console.error("Warning: Reference images not yet supported with DashScope, ignoring.");
+  }
+
+  const size = args.size ? normalizeSize(args.size) : getSizeFromAspectRatio(args.aspectRatio, args.quality);
+  const url = `${getBaseUrl()}/api/v1/services/aigc/multimodal-generation/generation`;
+
+  const body = {
+    model,
+    input: {
+      messages: [
+        {
+          role: "user",
+          content: [{ text: prompt }],
+        },
+      ],
+    },
+    parameters: {
+      prompt_extend: false,
+      size,
+    },
+  };
+
+  console.log(`Generating image with DashScope (${model})...`, { size });
+
+  const res = await fetch(url, {
+    method: "POST",
+    headers: {
+      "Content-Type": "application/json",
+      Authorization: `Bearer ${apiKey}`,
+    },
+    body: JSON.stringify(body),
+  });
+
+  if (!res.ok) {
+    const err = await res.text();
+    throw new Error(`DashScope API error (${res.status}): ${err}`);
+  }
+
+  const result = await res.json() as {
+    output?: {
+      result_image?: string;
+      choices?: Array<{
+        message?: {
+          content?: Array<{ image?: string }>;
+        };
+      }>;
+    };
+  };
+
+  let imageData: string | null = null;
+
+  if (result.output?.result_image) {
+    imageData = result.output.result_image;
+  } else if (result.output?.choices?.[0]?.message?.content) {
+    const content = result.output.choices[0].message.content;
+    for (const item of content) {
+      if (item.image) {
+        imageData = item.image;
+        break;
+      }
+    }
+  }
+
+  if (!imageData) {
+    console.error("Response:", JSON.stringify(result, null, 2));
+    throw new Error("No image in response");
+  }
+
+  if (imageData.startsWith("http://") || imageData.startsWith("https://")) {
+    const imgRes = await fetch(imageData);
+    if (!imgRes.ok) throw new Error("Failed to download image");
+    const buf = await imgRes.arrayBuffer();
+    return new Uint8Array(buf);
+  }
+
+  return Uint8Array.from(Buffer.from(imageData, "base64"));
+}

skills/baoyu-image-gen/scripts/types.ts

@@ -1,4 +1,4 @@
-export type Provider = "google" | "openai";
+export type Provider = "google" | "openai" | "dashscope";
 export type Quality = "normal" | "2k";
 
 export type CliArgs = {

skills/baoyu-infographic/SKILL.md

@@ -153,10 +153,12 @@ Schema: `references/config/preferences-schema.md`
 **1.2 Analyze Content → `analysis.md`**
 
 1. Save source content (file path or paste → `source.md`)
+   - **Backup rule**: If `source.md` exists, rename to `source-backup-YYYYMMDD-HHMMSS.md`
 2. Analyze: topic, data type, complexity, tone, audience
 3. Detect source language and user language
 4. Extract design instructions from user input
 5. Save analysis
+   - **Backup rule**: If `analysis.md` exists, rename to `analysis-backup-YYYYMMDD-HHMMSS.md`
 
 See `references/analysis-framework.md` for detailed format.
 
@@ -182,13 +184,20 @@ Recommend 3-5 layout×style combinations based on:
 
 ### Step 4: Confirm Options
 
-Present all options in single confirmation:
-1. **Combination** (always): 3+ options with rationale
-2. **Aspect** (always): landscape/portrait/square
-3. **Language** (only if source ≠ user language): which language for text
+Use **single AskUserQuestion call** with multiple questions to confirm all options together:
+
+| Question | When | Options |
+|----------|------|---------|
+| **Combination** | Always | 3+ layout×style combos with rationale |
+| **Aspect** | Always | landscape (16:9), portrait (9:16), square (1:1) |
+| **Language** | Only if source ≠ user language | Language for text content |
+
+**Important**: Do NOT split into separate AskUserQuestion calls. Combine all applicable questions into one call.
 
 ### Step 5: Generate Prompt → `prompts/infographic.md`
 
+**Backup rule**: If `prompts/infographic.md` exists, rename to `prompts/infographic-backup-YYYYMMDD-HHMMSS.md`
+
 Combine:
 1. Layout definition from `references/layouts/<layout>.md`
 2. Style definition from `references/styles/<style>.md`
@@ -199,8 +208,10 @@ Combine:
 ### Step 6: Generate Image
 
 1. Select available image generation skill (ask user if multiple)
-2. Call with prompt file and output path
-3. On failure, auto-retry once
+2. **Check for existing file**: Before generating, check if `infographic.png` exists
+   - If exists: Rename to `infographic-backup-YYYYMMDD-HHMMSS.png`
+3. Call with prompt file and output path
+4. On failure, auto-retry once
 
 ### Step 7: Output Summary
 

skills/baoyu-markdown-to-html/SKILL.md

@@ -0,0 +1,193 @@
+---
+name: baoyu-markdown-to-html
+description: Converts Markdown to styled HTML with WeChat-compatible themes. Supports code highlighting, math, PlantUML, footnotes, alerts, and infographics. Use when user asks for "markdown to html", "convert md to html", "md转html", or needs styled HTML output from markdown.
+---
+
+# Markdown to HTML Converter
+
+Converts Markdown files to beautifully styled HTML with inline CSS, optimized for WeChat Official Account and other platforms.
+
+## Script Directory
+
+**Agent Execution**: Determine this SKILL.md directory as `SKILL_DIR`, then use `${SKILL_DIR}/scripts/<name>.ts`.
+
+| Script | Purpose |
+|--------|---------|
+| `scripts/main.ts` | Main entry point |
+
+## Preferences (EXTEND.md)
+
+Use Bash to check EXTEND.md existence (priority order):
+
+```bash
+# Check project-level first
+test -f .baoyu-skills/baoyu-markdown-to-html/EXTEND.md && echo "project"
+
+# Then user-level (cross-platform: $HOME works on macOS/Linux/WSL)
+test -f "$HOME/.baoyu-skills/baoyu-markdown-to-html/EXTEND.md" && echo "user"
+```
+
+┌──────────────────────────────────────────────────────────────┬───────────────────┐
+│                             Path                             │     Location      │
+├──────────────────────────────────────────────────────────────┼───────────────────┤
+│ .baoyu-skills/baoyu-markdown-to-html/EXTEND.md               │ Project directory │
+├──────────────────────────────────────────────────────────────┼───────────────────┤
+│ $HOME/.baoyu-skills/baoyu-markdown-to-html/EXTEND.md         │ User home         │
+└──────────────────────────────────────────────────────────────┴───────────────────┘
+
+┌───────────┬───────────────────────────────────────────────────────────────────────────┐
+│  Result   │                                  Action                                   │
+├───────────┼───────────────────────────────────────────────────────────────────────────┤
+│ Found     │ Read, parse, apply settings                                               │
+├───────────┼───────────────────────────────────────────────────────────────────────────┤
+│ Not found │ Use defaults                                                              │
+└───────────┴───────────────────────────────────────────────────────────────────────────┘
+
+**EXTEND.md Supports**: Default theme | Custom CSS variables | Code block style
+
+## Workflow
+
+### Step 0: Pre-check (Chinese Content)
+
+**Condition**: Only execute if input file contains Chinese text.
+
+**Detection**:
+1. Read input markdown file
+2. Check if content contains CJK characters (Chinese/Japanese/Korean)
+3. If no CJK content → skip to Step 1
+
+**Format Suggestion**:
+
+If CJK content detected AND `baoyu-format-markdown` skill is available:
+
+Use `AskUserQuestion` to ask whether to format first. Formatting can fix:
+- Bold markers with punctuation inside causing `**` parse failures
+- CJK/English spacing issues
+
+**If user agrees**: Invoke `baoyu-format-markdown` skill to format the file, then use formatted file as input.
+
+**If user declines**: Continue with original file.
+
+### Step 1: Confirm Theme
+
+Before converting, use AskUserQuestion to confirm the theme (unless user already specified):
+
+| Theme | Description |
+|-------|-------------|
+| `default` (Recommended) | 经典主题 - 传统排版，标题居中带底边，二级标题白字彩底 |
+| `grace` | 优雅主题 - 文字阴影，圆角卡片，精致引用块 |
+| `simple` | 简洁主题 - 现代极简风，不对称圆角，清爽留白 |
+
+### Step 2: Convert
+
+```bash
+npx -y bun ${SKILL_DIR}/scripts/main.ts <markdown_file> --theme <theme>
+```
+
+### Step 3: Report Result
+
+Display the output path from JSON result. If backup was created, mention it.
+
+## Usage
+
+```bash
+npx -y bun ${SKILL_DIR}/scripts/main.ts <markdown_file> [options]
+```
+
+**Options:**
+
+| Option | Description | Default |
+|--------|-------------|---------|
+| `--theme <name>` | Theme name (default, grace, simple) | default |
+| `--title <title>` | Override title from frontmatter | |
+| `--keep-title` | Keep the first heading in content | false (removed) |
+| `--help` | Show help | |
+
+**Examples:**
+
+```bash
+# Basic conversion (uses default theme, removes first heading)
+npx -y bun ${SKILL_DIR}/scripts/main.ts article.md
+
+# With specific theme
+npx -y bun ${SKILL_DIR}/scripts/main.ts article.md --theme grace
+
+# Keep the first heading in content
+npx -y bun ${SKILL_DIR}/scripts/main.ts article.md --keep-title
+
+# Override title
+npx -y bun ${SKILL_DIR}/scripts/main.ts article.md --title "My Article"
+```
+
+## Output
+
+**File location**: Same directory as input markdown file.
+- Input: `/path/to/article.md`
+- Output: `/path/to/article.html`
+
+**Conflict handling**: If HTML file already exists, it will be backed up first:
+- Backup: `/path/to/article.html.bak-YYYYMMDDHHMMSS`
+
+**JSON output to stdout:**
+
+```json
+{
+  "title": "Article Title",
+  "author": "Author Name",
+  "summary": "Article summary...",
+  "htmlPath": "/path/to/article.html",
+  "backupPath": "/path/to/article.html.bak-20260128180000",
+  "contentImages": [
+    {
+      "placeholder": "MDTOHTMLIMGPH_1",
+      "localPath": "/path/to/img.png",
+      "originalPath": "imgs/image.png"
+    }
+  ]
+}
+```
+
+## Themes
+
+| Theme | Description |
+|-------|-------------|
+| `default` | 经典主题 - 传统排版，标题居中带底边，二级标题白字彩底 |
+| `grace` | 优雅主题 - 文字阴影，圆角卡片，精致引用块 (by @brzhang) |
+| `simple` | 简洁主题 - 现代极简风，不对称圆角，清爽留白 (by @okooo5km) |
+
+## Supported Markdown Features
+
+| Feature | Syntax |
+|---------|--------|
+| Headings | `# H1` to `###### H6` |
+| Bold/Italic | `**bold**`, `*italic*` |
+| Code blocks | ` ```lang ` with syntax highlighting |
+| Inline code | `` `code` `` |
+| Tables | GitHub-flavored markdown tables |
+| Images | `![alt](src)` |
+| Links | `[text](url)` with footnote references |
+| Blockquotes | `> quote` |
+| Lists | `-` unordered, `1.` ordered |
+| Alerts | `> [!NOTE]`, `> [!WARNING]`, etc. |
+| Footnotes | `[^1]` references |
+| Ruby text | `{base|annotation}` |
+| Mermaid | ` ```mermaid ` diagrams |
+| PlantUML | ` ```plantuml ` diagrams |
+
+## Frontmatter
+
+Supports YAML frontmatter for metadata:
+
+```yaml
+---
+title: Article Title
+author: Author Name
+description: Article summary
+---
+```
+
+If no title is found, extracts from first H1/H2 heading or uses filename.
+
+## Extension Support
+
+Custom configurations via EXTEND.md. See **Preferences** section for paths and supported options.

skills/baoyu-markdown-to-html/scripts/main.ts

@@ -0,0 +1,322 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { writeFile } from 'node:fs/promises';
+import os from 'node:os';
+import { createHash } from 'node:crypto';
+import { fileURLToPath } from 'node:url';
+import https from 'node:https';
+import http from 'node:http';
+import { spawnSync } from 'node:child_process';
+import process from 'node:process';
+
+interface ImageInfo {
+  placeholder: string;
+  localPath: string;
+  originalPath: string;
+}
+
+interface ParsedResult {
+  title: string;
+  author: string;
+  summary: string;
+  htmlPath: string;
+  backupPath?: string;
+  contentImages: ImageInfo[];
+}
+
+function formatTimestamp(date = new Date()): string {
+  const pad = (v: number) => String(v).padStart(2, '0');
+  return `${date.getFullYear()}${pad(date.getMonth() + 1)}${pad(date.getDate())}${pad(date.getHours())}${pad(date.getMinutes())}${pad(date.getSeconds())}`;
+}
+
+function downloadFile(url: string, destPath: string): Promise<void> {
+  return new Promise((resolve, reject) => {
+    const protocol = url.startsWith('https') ? https : http;
+    const file = fs.createWriteStream(destPath);
+
+    const request = protocol.get(url, { headers: { 'User-Agent': 'Mozilla/5.0' } }, (response) => {
+      if (response.statusCode === 301 || response.statusCode === 302) {
+        const redirectUrl = response.headers.location;
+        if (redirectUrl) {
+          file.close();
+          fs.unlinkSync(destPath);
+          downloadFile(redirectUrl, destPath).then(resolve).catch(reject);
+          return;
+        }
+      }
+
+      if (response.statusCode !== 200) {
+        file.close();
+        fs.unlinkSync(destPath);
+        reject(new Error(`Failed to download: ${response.statusCode}`));
+        return;
+      }
+
+      response.pipe(file);
+      file.on('finish', () => {
+        file.close();
+        resolve();
+      });
+    });
+
+    request.on('error', (err) => {
+      file.close();
+      fs.unlink(destPath, () => {});
+      reject(err);
+    });
+
+    request.setTimeout(30000, () => {
+      request.destroy();
+      reject(new Error('Download timeout'));
+    });
+  });
+}
+
+function getImageExtension(urlOrPath: string): string {
+  const match = urlOrPath.match(/\.(jpg|jpeg|png|gif|webp)(\?|$)/i);
+  return match ? match[1]!.toLowerCase() : 'png';
+}
+
+async function resolveImagePath(imagePath: string, baseDir: string, tempDir: string): Promise<string> {
+  if (imagePath.startsWith('http://') || imagePath.startsWith('https://')) {
+    const hash = createHash('md5').update(imagePath).digest('hex').slice(0, 8);
+    const ext = getImageExtension(imagePath);
+    const localPath = path.join(tempDir, `remote_${hash}.${ext}`);
+
+    if (!fs.existsSync(localPath)) {
+      console.error(`[markdown-to-html] Downloading: ${imagePath}`);
+      await downloadFile(imagePath, localPath);
+    }
+    return localPath;
+  }
+
+  if (path.isAbsolute(imagePath)) {
+    return imagePath;
+  }
+
+  return path.resolve(baseDir, imagePath);
+}
+
+function parseFrontmatter(content: string): { frontmatter: Record<string, string>; body: string } {
+  const match = content.match(/^---\r?\n([\s\S]*?)\r?\n---\r?\n([\s\S]*)$/);
+  if (!match) return { frontmatter: {}, body: content };
+
+  const frontmatter: Record<string, string> = {};
+  const lines = match[1]!.split('\n');
+  for (const line of lines) {
+    const colonIdx = line.indexOf(':');
+    if (colonIdx > 0) {
+      const key = line.slice(0, colonIdx).trim();
+      let value = line.slice(colonIdx + 1).trim();
+      if ((value.startsWith('"') && value.endsWith('"')) || (value.startsWith("'") && value.endsWith("'"))) {
+        value = value.slice(1, -1);
+      }
+      frontmatter[key] = value;
+    }
+  }
+
+  return { frontmatter, body: match[2]! };
+}
+
+export async function convertMarkdown(markdownPath: string, options?: { title?: string; theme?: string; keepTitle?: boolean }): Promise<ParsedResult> {
+  const baseDir = path.dirname(markdownPath);
+  const content = fs.readFileSync(markdownPath, 'utf-8');
+  const theme = options?.theme ?? 'default';
+  const keepTitle = options?.keepTitle ?? false;
+
+  const { frontmatter, body } = parseFrontmatter(content);
+
+  let title = options?.title ?? frontmatter.title ?? '';
+  if (!title) {
+    const lines = body.split('\n');
+    for (const line of lines) {
+      const trimmed = line.trim();
+      if (!trimmed) continue;
+      const headingMatch = trimmed.match(/^#{1,2}\s+(.+)$/);
+      if (headingMatch) title = headingMatch[1]!;
+      break;
+    }
+  }
+  if (!title) title = path.basename(markdownPath, path.extname(markdownPath));
+  const author = frontmatter.author || '';
+  let summary = frontmatter.description || frontmatter.summary || '';
+
+  if (!summary) {
+    const lines = body.split('\n');
+    for (const line of lines) {
+      const trimmed = line.trim();
+      if (!trimmed) continue;
+      if (trimmed.startsWith('#')) continue;
+      if (trimmed.startsWith('![')) continue;
+      if (trimmed.startsWith('>')) continue;
+      if (trimmed.startsWith('-') || trimmed.startsWith('*')) continue;
+      if (/^\d+\./.test(trimmed)) continue;
+
+      const cleanText = trimmed
+        .replace(/\*\*(.+?)\*\*/g, '$1')
+        .replace(/\*(.+?)\*/g, '$1')
+        .replace(/\[([^\]]+)\]\([^)]+\)/g, '$1')
+        .replace(/`([^`]+)`/g, '$1');
+
+      if (cleanText.length > 20) {
+        summary = cleanText.length > 120 ? cleanText.slice(0, 117) + '...' : cleanText;
+        break;
+      }
+    }
+  }
+
+  const images: Array<{ src: string; placeholder: string }> = [];
+  let imageCounter = 0;
+
+  const modifiedBody = body.replace(/!\[([^\]]*)\]\(([^)]+)\)/g, (match, alt, src) => {
+    const placeholder = `MDTOHTMLIMGPH_${++imageCounter}`;
+    images.push({ src, placeholder });
+    return placeholder;
+  });
+
+  const modifiedMarkdown = `---\n${Object.entries(frontmatter).map(([k, v]) => `${k}: ${v}`).join('\n')}\n---\n${modifiedBody}`;
+
+  const tempDir = fs.mkdtempSync(path.join(os.tmpdir(), 'markdown-to-html-'));
+  const tempMdPath = path.join(tempDir, 'temp-article.md');
+  await writeFile(tempMdPath, modifiedMarkdown, 'utf-8');
+
+  const __filename = fileURLToPath(import.meta.url);
+  const __dirname = path.dirname(__filename);
+  const renderScript = path.join(__dirname, 'md', 'render.ts');
+
+  console.error(`[markdown-to-html] Rendering with theme: ${theme}, keepTitle: ${keepTitle}`);
+
+  const args = ['-y', 'bun', renderScript, tempMdPath, '--theme', theme];
+  if (keepTitle) args.push('--keep-title');
+
+  const result = spawnSync('npx', args, {
+    stdio: ['inherit', 'pipe', 'pipe'],
+    cwd: baseDir,
+  });
+
+  if (result.status !== 0) {
+    const stderr = result.stderr?.toString() || '';
+    throw new Error(`Render failed: ${stderr}`);
+  }
+
+  const tempHtmlPath = tempMdPath.replace(/\.md$/i, '.html');
+  if (!fs.existsSync(tempHtmlPath)) {
+    throw new Error(`HTML file not generated: ${tempHtmlPath}`);
+  }
+
+  const finalHtmlPath = markdownPath.replace(/\.md$/i, '.html');
+  let backupPath: string | undefined;
+
+  if (fs.existsSync(finalHtmlPath)) {
+    backupPath = `${finalHtmlPath}.bak-${formatTimestamp()}`;
+    console.error(`[markdown-to-html] Backing up existing file to: ${backupPath}`);
+    fs.renameSync(finalHtmlPath, backupPath);
+  }
+
+  fs.copyFileSync(tempHtmlPath, finalHtmlPath);
+
+  const contentImages: ImageInfo[] = [];
+  for (const img of images) {
+    const localPath = await resolveImagePath(img.src, baseDir, tempDir);
+    contentImages.push({
+      placeholder: img.placeholder,
+      localPath,
+      originalPath: img.src,
+    });
+  }
+
+  let htmlContent = fs.readFileSync(finalHtmlPath, 'utf-8');
+  for (const img of contentImages) {
+    const imgTag = `<img src="${img.placeholder}" data-local-path="${img.localPath}" style="display: block; width: 100%; margin: 1.5em auto;">`;
+    htmlContent = htmlContent.replace(img.placeholder, imgTag);
+  }
+  fs.writeFileSync(finalHtmlPath, htmlContent, 'utf-8');
+
+  console.error(`[markdown-to-html] HTML saved to: ${finalHtmlPath}`);
+
+  return {
+    title,
+    author,
+    summary,
+    htmlPath: finalHtmlPath,
+    backupPath,
+    contentImages,
+  };
+}
+
+function printUsage(): never {
+  console.log(`Convert Markdown to styled HTML
+
+Usage:
+  npx -y bun main.ts <markdown_file> [options]
+
+Options:
+  --title <title>     Override title
+  --theme <name>      Theme name (default, grace, simple). Default: default
+  --keep-title        Keep the first heading in content. Default: false (removed)
+  --help              Show this help
+
+Output:
+  HTML file saved to same directory as input markdown file.
+  Example: article.md -> article.html
+
+  If HTML file already exists, it will be backed up first:
+  article.html -> article.html.bak-YYYYMMDDHHMMSS
+
+Output JSON format:
+{
+  "title": "Article Title",
+  "htmlPath": "/path/to/article.html",
+  "backupPath": "/path/to/article.html.bak-20260128180000",
+  "contentImages": [...]
+}
+
+Example:
+  npx -y bun main.ts article.md
+  npx -y bun main.ts article.md --theme grace
+`);
+  process.exit(0);
+}
+
+async function main(): Promise<void> {
+  const args = process.argv.slice(2);
+  if (args.length === 0 || args.includes('--help') || args.includes('-h')) {
+    printUsage();
+  }
+
+  let markdownPath: string | undefined;
+  let title: string | undefined;
+  let theme: string | undefined;
+  let keepTitle = false;
+
+  for (let i = 0; i < args.length; i++) {
+    const arg = args[i]!;
+    if (arg === '--title' && args[i + 1]) {
+      title = args[++i];
+    } else if (arg === '--theme' && args[i + 1]) {
+      theme = args[++i];
+    } else if (arg === '--keep-title') {
+      keepTitle = true;
+    } else if (!arg.startsWith('-')) {
+      markdownPath = arg;
+    }
+  }
+
+  if (!markdownPath) {
+    console.error('Error: Markdown file path is required');
+    process.exit(1);
+  }
+
+  if (!fs.existsSync(markdownPath)) {
+    console.error(`Error: File not found: ${markdownPath}`);
+    process.exit(1);
+  }
+
+  const result = await convertMarkdown(markdownPath, { title, theme, keepTitle });
+  console.log(JSON.stringify(result, null, 2));
+}
+
+await main().catch((err) => {
+  console.error(`Error: ${err instanceof Error ? err.message : String(err)}`);
+  process.exit(1);
+});

skills/baoyu-markdown-to-html/scripts/md/LICENSE

@@ -0,0 +1,18 @@
+This directory contains code adapted from the doocs/md project.
+
+Original project: https://github.com/doocs/md
+License: WTFPL (Do What The Fuck You Want To Public License)
+
+            DO WHAT THE FUCK YOU WANT TO PUBLIC LICENSE
+                    Version 2, December 2004
+
+ Copyright (C) 2025 Doocs <admin@doocs.org>
+
+ Everyone is permitted to copy and distribute verbatim or modified
+ copies of this license document, and changing it is allowed as long
+ as the name is changed.
+
+            DO WHAT THE FUCK YOU WANT TO PUBLIC LICENSE
+   TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
+
+  0. You just DO WHAT THE FUCK YOU WANT TO.

skills/baoyu-markdown-to-html/scripts/md/extensions/alert.ts

@@ -0,0 +1,284 @@
+import type { MarkedExtension, Tokens } from 'marked'
+
+export interface AlertOptions {
+  className?: string
+  variants?: AlertVariantItem[]
+  withoutStyle?: boolean
+}
+
+export interface AlertVariantItem {
+  type: string
+  icon: string
+  title?: string
+  titleClassName?: string
+}
+
+function ucfirst(str: string) {
+  return str.slice(0, 1).toUpperCase() + str.slice(1).toLowerCase()
+}
+
+/**
+ * https://github.com/bent10/marked-extensions/tree/main/packages/alert
+ * To support theme, we need to modify the source code.
+ * A [marked](https://marked.js.org/) extension to support [GFM alerts](https://github.com/orgs/community/discussions/16925).
+ */
+export function markedAlert(options: AlertOptions = {}): MarkedExtension {
+  const { className = `markdown-alert`, variants = [], withoutStyle = false } = options
+  const resolvedVariants = resolveVariants(variants)
+
+  // 提取公共的元数据构建逻辑
+  function buildMeta(variantType: string, matchedVariant: AlertVariantItem, fromContainer = false) {
+    return {
+      className,
+      variant: variantType,
+      icon: matchedVariant.icon,
+      title: matchedVariant.title ?? ucfirst(variantType),
+      titleClassName: `${className}-title`,
+      fromContainer,
+    }
+  }
+
+  // 提取公共的渲染逻辑
+  function renderAlert(token: any) {
+    const { meta, tokens = [] } = token
+    // @ts-expect-error marked renderer context has parser property
+    const text = this.parser.parse(tokens)
+    // 新主题系统：使用 CSS 选择器而非内联样式
+    let tmpl = `<blockquote class="${meta.className} ${meta.className}-${meta.variant}">\n`
+    tmpl += `<p class="${meta.titleClassName} alert-title-${meta.variant}">`
+    if (!withoutStyle) {
+      // 给 SVG 添加 class，通过 CSS 控制颜色
+      tmpl += meta.icon.replace(
+        `<svg`,
+        `<svg class="alert-icon-${meta.variant}"`,
+      )
+    }
+    tmpl += meta.title
+    tmpl += `</p>\n`
+    tmpl += text
+    tmpl += `</blockquote>\n`
+
+    return tmpl
+  }
+
+  return {
+    walkTokens(token) {
+      if (token.type !== `blockquote`)
+        return
+
+      const matchedVariant = resolvedVariants.find(({ type }) =>
+        new RegExp(createSyntaxPattern(type), `i`).test(token.text),
+      )
+
+      if (matchedVariant) {
+        const { type: variantType } = matchedVariant
+        const typeRegexp = new RegExp(createSyntaxPattern(variantType), `i`)
+
+        Object.assign(token, {
+          type: `alert`,
+          meta: buildMeta(variantType, matchedVariant),
+        })
+
+        const firstLine = token.tokens?.[0] as Tokens.Paragraph
+        const firstLineText = firstLine.raw?.replace(typeRegexp, ``).trim()
+
+        if (firstLineText) {
+          const patternToken = firstLine.tokens[0] as Tokens.Text
+
+          Object.assign(patternToken, {
+            raw: patternToken.raw.replace(typeRegexp, ``),
+            text: patternToken.text.replace(typeRegexp, ``),
+          })
+
+          if (firstLine.tokens[1]?.type === `br`) {
+            firstLine.tokens.splice(1, 1)
+          }
+        }
+        else {
+          token.tokens?.shift()
+        }
+      }
+    },
+    extensions: [
+      {
+        name: `alert`,
+        level: `block`,
+        renderer: renderAlert,
+      },
+      {
+        name: `alertContainer`,
+        level: `block`,
+        start(src) {
+          return src.match(/^:::/)?.index
+        },
+        tokenizer(src, _tokens) {
+          // eslint-disable-next-line regexp/no-super-linear-backtracking
+          const match = /^:::\s*(\w+)\s*\n([\s\S]*?)\n:::/.exec(src)
+
+          if (match) {
+            const [raw, variant, content] = match
+            const matchedVariant = resolvedVariants.find(v => v.type === variant)
+            if (!matchedVariant)
+              return
+
+            return {
+              type: `alert`,
+              raw,
+              text: content.trim(),
+              tokens: this.lexer.blockTokens(content.trim()),
+              meta: buildMeta(variant, matchedVariant, true),
+            }
+          }
+        },
+        renderer: renderAlert,
+      },
+    ],
+  }
+}
+
+/**
+ * The default configuration for alert variants.
+ */
+const defaultAlertVariant: AlertVariantItem[] = [
+  {
+    type: `note`,
+    icon: `<svg class="octicon octicon-info" style="margin-right: 0.25em;" viewBox="0 0 16 16" width="16" height="16" aria-hidden="true"><path d="M0 8a8 8 0 1 1 16 0A8 8 0 0 1 0 8Zm8-6.5a6.5 6.5 0 1 0 0 13 6.5 6.5 0 0 0 0-13ZM6.5 7.75A.75.75 0 0 1 7.25 7h1a.75.75 0 0 1 .75.75v2.75h.25a.75.75 0 0 1 0 1.5h-2a.75.75 0 0 1 0-1.5h.25v-2h-.25a.75.75 0 0 1-.75-.75ZM8 6a1 1 0 1 1 0-2 1 1 0 0 1 0 2Z"></path></svg>`,
+  },
+  {
+    type: `info`,
+    icon: `<svg class="octicon octicon-info" style="margin-right: 0.25em;" viewBox="0 0 16 16" width="16" height="16" aria-hidden="true"><path d="M0 8a8 8 0 1 1 16 0A8 8 0 0 1 0 8Zm8-6.5a6.5 6.5 0 1 0 0 13 6.5 6.5 0 0 0 0-13ZM6.5 7.75A.75.75 0 0 1 7.25 7h1a.75.75 0 0 1 .75.75v2.75h.25a.75.75 0 0 1 0 1.5h-2a.75.75 0 0 1 0-1.5h.25v-2h-.25a.75.75 0 0 1-.75-.75ZM8 6a1 1 0 1 1 0-2 1 1 0 0 1 0 2Z"></path></svg>`,
+  },
+  {
+    type: `tip`,
+    icon: `<svg class="octicon octicon-light-bulb" style="margin-right: 0.25em;" viewBox="0 0 16 16" width="16" height="16" aria-hidden="true"><path d="M8 1.5c-2.363 0-4 1.69-4 3.75 0 .984.424 1.625.984 2.304l.214.253c.223.264.47.556.673.848.284.411.537.896.621 1.49a.75.75 0 0 1-1.484.211c-.04-.282-.163-.547-.37-.847a8.456 8.456 0 0 0-.542-.68c-.084-.1-.173-.205-.268-.32C3.201 7.75 2.5 6.766 2.5 5.25 2.5 2.31 4.863 0 8 0s5.5 2.31 5.5 5.25c0 1.516-.701 2.5-1.328 3.259-.095.115-.184.22-.268.319-.207.245-.383.453-.541.681-.208.3-.33.565-.37.847a.751.751 0 0 1-1.485-.212c.084-.593.337-1.078.621-1.489.203-.292.45-.584.673-.848.075-.088.147-.173.213-.253.561-.679.985-1.32.985-2.304 0-2.06-1.637-3.75-4-3.75ZM5.75 12h4.5a.75.75 0 0 1 0 1.5h-4.5a.75.75 0 0 1 0-1.5ZM6 15.25a.75.75 0 0 1 .75-.75h2.5a.75.75 0 0 1 0 1.5h-2.5a.75.75 0 0 1-.75-.75Z"></path></svg>`,
+  },
+  {
+    type: `important`,
+    icon: `<svg class="octicon octicon-report" style="margin-right: 0.25em;" viewBox="0 0 16 16" width="16" height="16" aria-hidden="true"><path d="M0 1.75C0 .784.784 0 1.75 0h12.5C15.216 0 16 .784 16 1.75v9.5A1.75 1.75 0 0 1 14.25 13H8.06l-2.573 2.573A1.458 1.458 0 0 1 3 14.543V13H1.75A1.75 1.75 0 0 1 0 11.25Zm1.75-.25a.25.25 0 0 0-.25.25v9.5c0 .138.112.25.25.25h2a.75.75 0 0 1 .75.75v2.19l2.72-2.72a.749.749 0 0 1 .53-.22h6.5a.25.25 0 0 0 .25-.25v-9.5a.25.25 0 0 0-.25-.25Zm7 2.25v2.5a.75.75 0 0 1-1.5 0v-2.5a.75.75 0 0 1 1.5 0ZM9 9a1 1 0 1 1-2 0 1 1 0 0 1 2 0Z"></path></svg>`,
+  },
+  {
+    type: `warning`,
+    icon: `<svg class="octicon octicon-alert" style="margin-right: 0.25em;" viewBox="0 0 16 16" width="16" height="16" aria-hidden="true"><path d="M6.457 1.047c.659-1.234 2.427-1.234 3.086 0l6.082 11.378A1.75 1.75 0 0 1 14.082 15H1.918a1.75 1.75 0 0 1-1.543-2.575Zm1.763.707a.25.25 0 0 0-.44 0L1.698 13.132a.25.25 0 0 0 .22.368h12.164a.25.25 0 0 0 .22-.368Zm.53 3.996v2.5a.75.75 0 0 1-1.5 0v-2.5a.75.75 0 0 1 1.5 0ZM9 11a1 1 0 1 1-2 0 1 1 0 0 1 2 0Z"></path></svg>`,
+  },
+  {
+    type: `caution`,
+    icon: `<svg class="octicon octicon-stop" style="margin-right: 0.25em;" viewBox="0 0 16 16" width="16" height="16" aria-hidden="true"><path d="M4.47.22A.749.749 0 0 1 5 0h6c.199 0 .389.079.53.22l4.25 4.25c.141.14.22.331.22.53v6a.749.749 0 0 1-.22.53l-4.25 4.25A.749.749 0 0 1 11 16H5a.749.749 0 0 1-.53-.22L.22 11.53A.749.749 0 0 1 0 11V5c0-.199.079-.389.22-.53Zm.84 1.28L1.5 5.31v5.38l3.81 3.81h5.38l3.81-3.81V5.31L10.69 1.5ZM8 4a.75.75 0 0 1 .75.75v3.5a.75.75 0 0 1-1.5 0v-3.5A.75.75 0 0 1 8 4Zm0 8a1 1 0 1 1 0-2 1 1 0 0 1 0 2Z"></path></svg>`,
+  },
+  // Obsidian-style callouts
+  {
+    type: `abstract`,
+    title: `Abstract`,
+    icon: `<svg class="octicon octicon-clipboard" style="margin-right: 0.25em;" viewBox="0 0 16 16" width="16" height="16" aria-hidden="true"><path d="M5.75 1a.75.75 0 0 0-.75.75v.5c0 .414.336.75.75.75h4.5a.75.75 0 0 0 .75-.75v-.5a.75.75 0 0 0-.75-.75Zm4.5-1.5a2.25 2.25 0 0 1 2.122 1.5H13a2 2 0 0 1 2 2v10a2 2 0 0 1-2 2H3a2 2 0 0 1-2-2V3a2 2 0 0 1 2-2h.628A2.25 2.25 0 0 1 5.75-.5ZM3.5 3v10a.5.5 0 0 0 .5.5h8a.5.5 0 0 0 .5-.5V3a.5.5 0 0 0-.5-.5h-8a.5.5 0 0 0-.5.5Z"></path></svg>`,
+  },
+  {
+    type: `summary`,
+    title: `Summary`,
+    icon: `<svg class="octicon octicon-clipboard" style="margin-right: 0.25em;" viewBox="0 0 16 16" width="16" height="16" aria-hidden="true"><path d="M5.75 1a.75.75 0 0 0-.75.75v.5c0 .414.336.75.75.75h4.5a.75.75 0 0 0 .75-.75v-.5a.75.75 0 0 0-.75-.75Zm4.5-1.5a2.25 2.25 0 0 1 2.122 1.5H13a2 2 0 0 1 2 2v10a2 2 0 0 1-2 2H3a2 2 0 0 1-2-2V3a2 2 0 0 1 2-2h.628A2.25 2.25 0 0 1 5.75-.5ZM3.5 3v10a.5.5 0 0 0 .5.5h8a.5.5 0 0 0 .5-.5V3a.5.5 0 0 0-.5-.5h-8a.5.5 0 0 0-.5.5Z"></path></svg>`,
+  },
+  {
+    type: `tldr`,
+    title: `TL;DR`,
+    icon: `<svg class="octicon octicon-clipboard" style="margin-right: 0.25em;" viewBox="0 0 16 16" width="16" height="16" aria-hidden="true"><path d="M5.75 1a.75.75 0 0 0-.75.75v.5c0 .414.336.75.75.75h4.5a.75.75 0 0 0 .75-.75v-.5a.75.75 0 0 0-.75-.75Zm4.5-1.5a2.25 2.25 0 0 1 2.122 1.5H13a2 2 0 0 1 2 2v10a2 2 0 0 1-2 2H3a2 2 0 0 1-2-2V3a2 2 0 0 1 2-2h.628A2.25 2.25 0 0 1 5.75-.5ZM3.5 3v10a.5.5 0 0 0 .5.5h8a.5.5 0 0 0 .5-.5V3a.5.5 0 0 0-.5-.5h-8a.5.5 0 0 0-.5.5Z"></path></svg>`,
+  },
+  {
+    type: `todo`,
+    title: `Todo`,
+    icon: `<svg class="octicon octicon-checklist" style="margin-right: 0.25em;" viewBox="0 0 16 16" width="16" height="16" aria-hidden="true"><path d="M2.5 1.75v11.5c0 .138.112.25.25.25h3.17a.75.75 0 0 1 0 1.5H2.75A1.75 1.75 0 0 1 1 13.25V1.75C1 .784 1.784 0 2.75 0h8.5C12.216 0 13 .784 13 1.75v7.736a.75.75 0 0 1-1.5 0V1.75a.25.25 0 0 0-.25-.25h-8.5a.25.25 0 0 0-.25.25Zm10.97 8.72a.75.75 0 0 1 1.06 0l2 2a.75.75 0 0 1-1.06 1.06l-1.22-1.22v4.94a.75.75 0 0 1-1.5 0v-4.94l-1.22 1.22a.75.75 0 0 1-1.06-1.06Z"></path></svg>`,
+  },
+  {
+    type: `success`,
+    title: `Success`,
+    icon: `<svg class="octicon octicon-check-circle" style="margin-right: 0.25em;" viewBox="0 0 16 16" width="16" height="16" aria-hidden="true"><path d="M8 16A8 8 0 1 1 8 0a8 8 0 0 1 0 16Zm3.78-9.72a.751.751 0 0 0-.018-1.042.751.751 0 0 0-1.042-.018L6.75 9.19 5.28 7.72a.751.751 0 0 0-1.042.018.751.751 0 0 0-.018 1.042l2 2a.75.75 0 0 0 1.06 0Z"></path></svg>`,
+  },
+  {
+    type: `done`,
+    title: `Done`,
+    icon: `<svg class="octicon octicon-check-circle" style="margin-right: 0.25em;" viewBox="0 0 16 16" width="16" height="16" aria-hidden="true"><path d="M8 16A8 8 0 1 1 8 0a8 8 0 0 1 0 16Zm3.78-9.72a.751.751 0 0 0-.018-1.042.751.751 0 0 0-1.042-.018L6.75 9.19 5.28 7.72a.751.751 0 0 0-1.042.018.751.751 0 0 0-.018 1.042l2 2a.75.75 0 0 0 1.06 0Z"></path></svg>`,
+  },
+  {
+    type: `question`,
+    title: `Question`,
+    icon: `<svg class="octicon octicon-question" style="margin-right: 0.25em;" viewBox="0 0 16 16" width="16" height="16" aria-hidden="true"><path d="M0 8a8 8 0 1 1 16 0A8 8 0 0 1 0 8Zm8-6.5a6.5 6.5 0 1 0 0 13 6.5 6.5 0 0 0 0-13ZM6.92 6.085h.001a.749.749 0 1 1-1.342-.67c.169-.339.436-.701.849-.977C6.845 4.16 7.369 4 8 4a2.756 2.756 0 0 1 1.637.525c.503.377.863.965.863 1.725 0 .448-.115.83-.329 1.15-.205.307-.47.513-.692.662-.109.072-.22.138-.313.195l-.006.004a6.24 6.24 0 0 0-.26.16.952.952 0 0 0-.276.245.75.75 0 0 1-1.248-.832c.184-.264.42-.489.692-.661.103-.067.207-.132.313-.195l.007-.004c.1-.061.182-.11.258-.161a.969.969 0 0 0 .277-.245C8.96 6.514 9 6.427 9 6.25a.612.612 0 0 0-.262-.525A1.27 1.27 0 0 0 8 5.5c-.369 0-.595.09-.74.187a1.01 1.01 0 0 0-.34.398ZM9 11a1 1 0 1 1-2 0 1 1 0 0 1 2 0Z"></path></svg>`,
+  },
+  {
+    type: `help`,
+    title: `Help`,
+    icon: `<svg class="octicon octicon-question" style="margin-right: 0.25em;" viewBox="0 0 16 16" width="16" height="16" aria-hidden="true"><path d="M0 8a8 8 0 1 1 16 0A8 8 0 0 1 0 8Zm8-6.5a6.5 6.5 0 1 0 0 13 6.5 6.5 0 0 0 0-13ZM6.92 6.085h.001a.749.749 0 1 1-1.342-.67c.169-.339.436-.701.849-.977C6.845 4.16 7.369 4 8 4a2.756 2.756 0 0 1 1.637.525c.503.377.863.965.863 1.725 0 .448-.115.83-.329 1.15-.205.307-.47.513-.692.662-.109.072-.22.138-.313.195l-.006.004a6.24 6.24 0 0 0-.26.16.952.952 0 0 0-.276.245.75.75 0 0 1-1.248-.832c.184-.264.42-.489.692-.661.103-.067.207-.132.313-.195l.007-.004c.1-.061.182-.11.258-.161a.969.969 0 0 0 .277-.245C8.96 6.514 9 6.427 9 6.25a.612.612 0 0 0-.262-.525A1.27 1.27 0 0 0 8 5.5c-.369 0-.595.09-.74.187a1.01 1.01 0 0 0-.34.398ZM9 11a1 1 0 1 1-2 0 1 1 0 0 1 2 0Z"></path></svg>`,
+  },
+  {
+    type: `faq`,
+    title: `FAQ`,
+    icon: `<svg class="octicon octicon-question" style="margin-right: 0.25em;" viewBox="0 0 16 16" width="16" height="16" aria-hidden="true"><path d="M0 8a8 8 0 1 1 16 0A8 8 0 0 1 0 8Zm8-6.5a6.5 6.5 0 1 0 0 13 6.5 6.5 0 0 0 0-13ZM6.92 6.085h.001a.749.749 0 1 1-1.342-.67c.169-.339.436-.701.849-.977C6.845 4.16 7.369 4 8 4a2.756 2.756 0 0 1 1.637.525c.503.377.863.965.863 1.725 0 .448-.115.83-.329 1.15-.205.307-.47.513-.692.662-.109.072-.22.138-.313.195l-.006.004a6.24 6.24 0 0 0-.26.16.952.952 0 0 0-.276.245.75.75 0 0 1-1.248-.832c.184-.264.42-.489.692-.661.103-.067.207-.132.313-.195l.007-.004c.1-.061.182-.11.258-.161a.969.969 0 0 0 .277-.245C8.96 6.514 9 6.427 9 6.25a.612.612 0 0 0-.262-.525A1.27 1.27 0 0 0 8 5.5c-.369 0-.595.09-.74.187a1.01 1.01 0 0 0-.34.398ZM9 11a1 1 0 1 1-2 0 1 1 0 0 1 2 0Z"></path></svg>`,
+  },
+  {
+    type: `failure`,
+    title: `Failure`,
+    icon: `<svg class="octicon octicon-x-circle" style="margin-right: 0.25em;" viewBox="0 0 16 16" width="16" height="16" aria-hidden="true"><path d="M2.343 13.657A8 8 0 1 1 13.658 2.343 8 8 0 0 1 2.343 13.657ZM6.03 4.97a.751.751 0 0 0-1.042.018.751.751 0 0 0-.018 1.042L6.94 8 4.97 9.97a.749.749 0 0 0 .326 1.275.749.749 0 0 0 .734-.215L8 9.06l1.97 1.97a.749.749 0 0 0 1.275-.326.749.749 0 0 0-.215-.734L9.06 8l1.97-1.97a.749.749 0 0 0-.326-1.275.749.749 0 0 0-.734.215L8 6.94Z"></path></svg>`,
+  },
+  {
+    type: `fail`,
+    title: `Fail`,
+    icon: `<svg class="octicon octicon-x-circle" style="margin-right: 0.25em;" viewBox="0 0 16 16" width="16" height="16" aria-hidden="true"><path d="M2.343 13.657A8 8 0 1 1 13.658 2.343 8 8 0 0 1 2.343 13.657ZM6.03 4.97a.751.751 0 0 0-1.042.018.751.751 0 0 0-.018 1.042L6.94 8 4.97 9.97a.749.749 0 0 0 .326 1.275.749.749 0 0 0 .734-.215L8 9.06l1.97 1.97a.749.749 0 0 0 1.275-.326.749.749 0 0 0-.215-.734L9.06 8l1.97-1.97a.749.749 0 0 0-.326-1.275.749.749 0 0 0-.734.215L8 6.94Z"></path></svg>`,
+  },
+  {
+    type: `missing`,
+    title: `Missing`,
+    icon: `<svg class="octicon octicon-x-circle" style="margin-right: 0.25em;" viewBox="0 0 16 16" width="16" height="16" aria-hidden="true"><path d="M2.343 13.657A8 8 0 1 1 13.658 2.343 8 8 0 0 1 2.343 13.657ZM6.03 4.97a.751.751 0 0 0-1.042.018.751.751 0 0 0-.018 1.042L6.94 8 4.97 9.97a.749.749 0 0 0 .326 1.275.749.749 0 0 0 .734-.215L8 9.06l1.97 1.97a.749.749 0 0 0 1.275-.326.749.749 0 0 0-.215-.734L9.06 8l1.97-1.97a.749.749 0 0 0-.326-1.275.749.749 0 0 0-.734.215L8 6.94Z"></path></svg>`,
+  },
+  {
+    type: `danger`,
+    title: `Danger`,
+    icon: `<svg class="octicon octicon-zap" style="margin-right: 0.25em;" viewBox="0 0 16 16" width="16" height="16" aria-hidden="true"><path d="M9.504.43a1.516 1.516 0 0 1 2.437 1.713L10.415 5.5h2.123c1.57 0 2.346 1.909 1.22 3.004l-7.34 7.142a1.249 1.249 0 0 1-.871.354h-.302a1.25 1.25 0 0 1-1.157-1.723L5.633 10.5H3.462c-1.57 0-2.346-1.909-1.22-3.004ZM9.98 1.873a.016.016 0 0 0-.016.006L2.252 9.021a.75.75 0 0 0 .488 1.212h3.838a.75.75 0 0 1 .694 1.034L5.545 15.02a.016.016 0 0 0 .003.017.017.017 0 0 0 .018.004h.302a.016.016 0 0 0 .012-.005l7.34-7.142a.75.75 0 0 0-.488-1.212h-3.838a.75.75 0 0 1-.694-1.034l1.527-3.628a.016.016 0 0 0-.003-.017.017.017 0 0 0-.018-.004h-.302Z"></path></svg>`,
+  },
+  {
+    type: `error`,
+    title: `Error`,
+    icon: `<svg class="octicon octicon-zap" style="margin-right: 0.25em;" viewBox="0 0 16 16" width="16" height="16" aria-hidden="true"><path d="M9.504.43a1.516 1.516 0 0 1 2.437 1.713L10.415 5.5h2.123c1.57 0 2.346 1.909 1.22 3.004l-7.34 7.142a1.249 1.249 0 0 1-.871.354h-.302a1.25 1.25 0 0 1-1.157-1.723L5.633 10.5H3.462c-1.57 0-2.346-1.909-1.22-3.004ZM9.98 1.873a.016.016 0 0 0-.016.006L2.252 9.021a.75.75 0 0 0 .488 1.212h3.838a.75.75 0 0 1 .694 1.034L5.545 15.02a.016.016 0 0 0 .003.017.017.017 0 0 0 .018.004h.302a.016.016 0 0 0 .012-.005l7.34-7.142a.75.75 0 0 0-.488-1.212h-3.838a.75.75 0 0 1-.694-1.034l1.527-3.628a.016.016 0 0 0-.003-.017.017.017 0 0 0-.018-.004h-.302Z"></path></svg>`,
+  },
+  {
+    type: `bug`,
+    title: `Bug`,
+    icon: `<svg class="octicon octicon-bug" style="margin-right: 0.25em;" viewBox="0 0 16 16" width="16" height="16" aria-hidden="true"><path d="M4.72.22a.75.75 0 0 1 1.06 0l1 .999a3.488 3.488 0 0 1 2.441 0l.999-1a.748.748 0 0 1 1.265.332.75.75 0 0 1-.205.729l-.775.776c.616.63.995 1.493.995 2.444v.327c0 .1-.009.197-.025.292l.727.726a.75.75 0 1 1-1.06 1.06l-.727-.727a2.17 2.17 0 0 1-.292.026H9.25V7.5a.75.75 0 0 1-1.5 0V6.125H6.875a2.17 2.17 0 0 1-.292-.026l-.727.727a.75.75 0 1 1-1.06-1.06l.727-.726a2.17 2.17 0 0 1-.025-.292V4.5c0-.951.379-1.814.995-2.444l-.775-.776a.75.75 0 0 1 0-1.06Zm6.437 6.003A.608.608 0 0 0 11 6.072v-.026a3.999 3.999 0 0 0-.11-.936 2.488 2.488 0 0 0-5.78 0 3.992 3.992 0 0 0-.11.936v.026c0 .05.008.098.02.147h4.937a.612.612 0 0 0 .2-.02ZM2.25 7.5a.75.75 0 0 0 0 1.5h.5v1.25a4.75 4.75 0 0 0 2.478 4.166l.247.137a.75.75 0 1 0 .722-1.313l-.246-.137A3.25 3.25 0 0 1 4.25 10.25V9h7.5v1.25a3.25 3.25 0 0 1-1.701 2.853l-.246.137a.75.75 0 1 0 .722 1.313l.247-.137A4.75 4.75 0 0 0 13.25 10.25V9h.5a.75.75 0 0 0 0-1.5Z"></path></svg>`,
+  },
+  {
+    type: `example`,
+    title: `Example`,
+    icon: `<svg class="octicon octicon-list-unordered" style="margin-right: 0.25em;" viewBox="0 0 16 16" width="16" height="16" aria-hidden="true"><path d="M5.75 2.5h8.5a.75.75 0 0 1 0 1.5h-8.5a.75.75 0 0 1 0-1.5Zm0 5h8.5a.75.75 0 0 1 0 1.5h-8.5a.75.75 0 0 1 0-1.5Zm0 5h8.5a.75.75 0 0 1 0 1.5h-8.5a.75.75 0 0 1 0-1.5ZM2 14a1 1 0 1 1 0-2 1 1 0 0 1 0 2Zm1-6a1 1 0 1 1-2 0 1 1 0 0 1 2 0ZM2 4a1 1 0 1 1 0-2 1 1 0 0 1 0 2Z"></path></svg>`,
+  },
+  {
+    type: `quote`,
+    title: `Quote`,
+    icon: `<svg class="octicon octicon-quote" style="margin-right: 0.25em;" viewBox="0 0 16 16" width="16" height="16" aria-hidden="true"><path d="M1.75 2h12.5c.966 0 1.75.784 1.75 1.75v8.5A1.75 1.75 0 0 1 14.25 14H1.75A1.75 1.75 0 0 1 0 12.25v-8.5C0 2.784.784 2 1.75 2ZM1.5 12.25c0 .138.112.25.25.25h12.5a.25.25 0 0 0 .25-.25v-8.5a.25.25 0 0 0-.25-.25H1.75a.25.25 0 0 0-.25.25ZM4 5.25a.75.75 0 0 1 .75-.75h6.5a.75.75 0 0 1 0 1.5h-6.5A.75.75 0 0 1 4 5.25Zm0 4a.75.75 0 0 1 .75-.75h6.5a.75.75 0 0 1 0 1.5h-6.5a.75.75 0 0 1-.75-.75Z"></path></svg>`,
+  },
+  {
+    type: `cite`,
+    title: `Cite`,
+    icon: `<svg class="octicon octicon-quote" style="margin-right: 0.25em;" viewBox="0 0 16 16" width="16" height="16" aria-hidden="true"><path d="M1.75 2h12.5c.966 0 1.75.784 1.75 1.75v8.5A1.75 1.75 0 0 1 14.25 14H1.75A1.75 1.75 0 0 1 0 12.25v-8.5C0 2.784.784 2 1.75 2ZM1.5 12.25c0 .138.112.25.25.25h12.5a.25.25 0 0 0 .25-.25v-8.5a.25.25 0 0 0-.25-.25H1.75a.25.25 0 0 0-.25.25ZM4 5.25a.75.75 0 0 1 .75-.75h6.5a.75.75 0 0 1 0 1.5h-6.5A.75.75 0 0 1 4 5.25Zm0 4a.75.75 0 0 1 .75-.75h6.5a.75.75 0 0 1 0 1.5h-6.5a.75.75 0 0 1-.75-.75Z"></path></svg>`,
+  },
+]
+
+/**
+ * Resolves the variants configuration, combining the provided variants with
+ * the default variants.
+ */
+export function resolveVariants(variants: AlertVariantItem[]) {
+  if (!variants.length)
+    return defaultAlertVariant
+
+  return Object.values(
+    [...defaultAlertVariant, ...variants].reduce(
+      (map, item) => {
+        map[item.type] = item
+        return map
+      },
+      {} as { [key: string]: AlertVariantItem },
+    ),
+  )
+}
+
+/**
+ * Returns regex pattern to match alert syntax.
+ */
+export function createSyntaxPattern(type: string) {
+  return `^(?:\\[!${type}])\\s*?\n*`
+}

skills/baoyu-markdown-to-html/scripts/md/extensions/footnotes.ts

@@ -0,0 +1,89 @@
+import type { MarkedExtension, Tokens } from 'marked'
+/**
+ * A marked extension to support footnotes syntax.
+ * Syntax:
+ *  This is a footnote reference[^1][^2].
+ *
+ *  [^1]: .....
+ *  [^2]: .....
+ */
+
+interface MapContent {
+  index: number
+  text: string
+}
+const fnMap = new Map<string, MapContent>()
+
+export function markedFootnotes(): MarkedExtension {
+  return {
+    extensions: [
+      {
+        name: `footnoteDef`,
+        level: `block`,
+        start(src: string) {
+          fnMap.clear()
+          return src.match(/^\[\^/)?.index
+        },
+        tokenizer(src: string) {
+          const match = src.match(/^\[\^(.*)\]:(.*)/)
+          if (match) {
+            const [raw, fnId, text] = match
+            const index = fnMap.size + 1
+            fnMap.set(fnId, { index, text })
+            return {
+              type: `footnoteDef`,
+              raw,
+              fnId,
+              index,
+              text,
+            }
+          }
+          return undefined
+        },
+        renderer(token: Tokens.Generic) {
+          const { index, text, fnId } = token
+          const fnInner = `
+                <code>${index}.</code> 
+                <span>${text}</span> 
+                    <a id="fnDef-${fnId}" href="#fnRef-${fnId}" style="color: var(--md-primary-color);">\u21A9\uFE0E</a>
+                <br>`
+          if (index === 1) {
+            return `
+            <p style="font-size: 80%;margin: 0.5em 8px;word-break:break-all;">${fnInner}`
+          }
+          if (index === fnMap.size) {
+            return `${fnInner}</p>`
+          }
+          return fnInner
+        },
+      },
+      {
+        name: `footnoteRef`,
+        level: `inline`,
+        start(src: string) {
+          return src.match(/\[\^/)?.index
+        },
+        tokenizer(src: string) {
+          const match = src.match(/^\[\^(.*?)\]/)
+          if (match) {
+            const [raw, fnId] = match
+            if (fnMap.has(fnId)) {
+              return {
+                type: `footnoteRef`,
+                raw,
+                fnId,
+              }
+            }
+          }
+        },
+        renderer(token: Tokens.Generic) {
+          const { fnId } = token
+          const { index } = fnMap.get(fnId) as MapContent
+          return `<sup style="color: var(--md-primary-color);">
+                    <a href="#fnDef-${fnId}" id="fnRef-${fnId}">\[${index}\]</a>
+                </sup>`
+        },
+      },
+    ],
+  }
+}

skills/baoyu-markdown-to-html/scripts/md/extensions/index.ts

@@ -0,0 +1,10 @@
+// Markdown 扩展导出
+export * from './alert.js'
+export * from './footnotes.js'
+export * from './infographic.js'
+export * from './katex.js'
+export * from './markup.js'
+export * from './plantuml.js'
+export * from './ruby.js'
+export * from './slider.js'
+export * from './toc.js'

skills/baoyu-markdown-to-html/scripts/md/extensions/infographic.ts

@@ -0,0 +1,119 @@
+import type { MarkedExtension } from 'marked'
+
+interface InfographicOptions {
+  themeMode?: 'dark' | 'light'
+}
+
+async function renderInfographic(containerId: string, code: string, options?: InfographicOptions) {
+  if (typeof window === 'undefined')
+    return
+
+  try {
+    const { Infographic, setDefaultFont, setFontExtendFactor, exportToSVG } = await import('@antv/infographic')
+
+    setFontExtendFactor(1.1)
+    setDefaultFont('-apple-system-font, "system-ui", "Helvetica Neue", "PingFang SC", "Hiragino Sans GB", "Microsoft YaHei UI", "Microsoft YaHei", Arial, sans-serif')
+
+    const findContainer = (retries = 5, delay = 100) => {
+      const container = document.getElementById(containerId)
+      if (container) {
+        const isDark = options?.themeMode === 'dark'
+
+        // 从 CSS 变量中读取主题颜色
+        const root = document.documentElement
+        const computedStyle = getComputedStyle(root)
+        const primaryColor = computedStyle.getPropertyValue('--md-primary-color').trim()
+        const backgroundColor = computedStyle.getPropertyValue('--background').trim()
+
+        // 转换 HSL 格式
+        const toHSLString = (variant: string) => {
+          const vars = variant.split(' ')
+          if (vars.length === 3)
+            return `hsl(${vars.join(', ')})`
+          if (vars.length === 4)
+            return `hsla(${vars.join(', ')})`
+          return ''
+        }
+
+        const instance = new Infographic({
+          container,
+          svg: {
+            style: {
+              width: '100%',
+              height: '100%',
+              background: isDark ? '#000' : 'transparent',
+            },
+            background: false,
+          },
+          theme: isDark ? 'dark' : 'default',
+          themeConfig: {
+            colorPrimary: primaryColor || undefined,
+            colorBg: toHSLString(backgroundColor) || undefined,
+          },
+        })
+
+        instance.on('loaded', ({ node }) => {
+          exportToSVG(node, { removeIds: true }).then((svg) => {
+            container.replaceChildren(svg)
+          })
+        })
+
+        instance.render(code)
+
+        return
+      }
+
+      if (retries > 0) {
+        setTimeout(() => findContainer(retries - 1, delay), delay)
+      }
+    }
+
+    findContainer()
+  }
+  catch (error) {
+    console.error('Failed to render Infographic:', error)
+    const container = document.getElementById(containerId)
+    if (container) {
+      container.innerHTML = `<div style="color: red; padding: 10px; border: 1px solid red;">Infographic 渲染失败: ${error instanceof Error ? error.message : String(error)}</div>`
+    }
+  }
+}
+
+export function markedInfographic(options?: InfographicOptions): MarkedExtension {
+  const className = 'infographic-diagram'
+
+  return {
+    extensions: [
+      {
+        name: 'infographic',
+        level: 'block',
+        start(src: string) {
+          return src.match(/^```infographic/m)?.index
+        },
+        tokenizer(src: string) {
+          const match = /^```infographic\r?\n([\s\S]*?)\r?\n```/.exec(src)
+          if (match) {
+            return {
+              type: 'infographic',
+              raw: match[0],
+              text: match[1].trim(),
+            }
+          }
+        },
+        renderer(token: any) {
+          const id = `infographic-${Math.random().toString(36).slice(2, 11)}`
+          const code = token.text
+
+          renderInfographic(id, code, options)
+
+          return `<div id="${id}" class="${className}" style="width: 100%;">正在加载 Infographic...</div>`
+        },
+      },
+    ],
+    walkTokens(token: any) {
+      if (token.type === 'code' && token.lang === 'infographic') {
+        token.type = 'infographic'
+      }
+    },
+  }
+}

skills/baoyu-markdown-to-html/scripts/md/extensions/katex.ts

@@ -0,0 +1,162 @@
+import type { MarkedExtension } from 'marked'
+
+export interface MarkedKatexOptions {
+  nonStandard?: boolean
+}
+
+const inlineRule = /^(\${1,2})(?!\$)((?:\\.|[^\\\n])*?(?:\\.|[^\\\n$]))\1(?=[\s?!.,:？！。，：]|$)/
+const inlineRuleNonStandard = /^(\${1,2})(?!\$)((?:\\.|[^\\\n])*?(?:\\.|[^\\\n$]))\1/ // Non-standard, even if there are no spaces before and after $ or $$, try to parse
+
+const blockRule = /^\s{0,3}(\${1,2})[ \t]*\n([\s\S]+?)\n\s{0,3}\1[ \t]*(?:\n|$)/
+
+// LaTeX style rules for \( ... \) and \[ ... \]
+const inlineLatexRule = /^\\\(([^\\]*(?:\\.[^\\]*)*?)\\\)/
+const blockLatexRule = /^\\\[([^\\]*(?:\\.[^\\]*)*?)\\\]/
+
+function createRenderer(display: boolean, withStyle: boolean = true) {
+  return (token: any) => {
+    // @ts-expect-error MathJax is a global variable
+    window.MathJax.texReset()
+    // @ts-expect-error MathJax is a global variable
+    const mjxContainer = window.MathJax.tex2svg(token.text, { display })
+    const svg = mjxContainer.firstChild
+    const width = svg.style[`min-width`] || svg.getAttribute(`width`)
+    svg.removeAttribute(`width`)
+
+    // 行内公式对齐 https://groups.google.com/g/mathjax-users/c/zThKffrrCvE?pli=1
+    // 直接覆盖 style 会覆盖 MathJax 的样式，需要手动设置
+    // svg.style = `max-width: 300vw !important; display: initial; flex-shrink: 0;`
+
+    if (withStyle) {
+      svg.style.display = `initial`
+      svg.style.setProperty(`max-width`, `300vw`, `important`)
+      svg.style.flexShrink = `0`
+      svg.style.width = width
+    }
+
+    if (!display) {
+      // 新主题系统：使用 class 而非内联样式
+      return `<span class="katex-inline">${svg.outerHTML}</span>`
+    }
+
+    return `<section class="katex-block">${svg.outerHTML}</section>`
+  }
+}
+
+function inlineKatex(options: MarkedKatexOptions | undefined, renderer: any) {
+  const nonStandard = options && options.nonStandard
+  const ruleReg = nonStandard ? inlineRuleNonStandard : inlineRule
+  return {
+    name: `inlineKatex`,
+    level: `inline`,
+    start(src: string) {
+      let index
+      let indexSrc = src
+
+      while (indexSrc) {
+        index = indexSrc.indexOf(`$`)
+        if (index === -1) {
+          return
+        }
+        const f = nonStandard ? index > -1 : index === 0 || indexSrc.charAt(index - 1) === ` `
+        if (f) {
+          const possibleKatex = indexSrc.substring(index)
+
+          if (possibleKatex.match(ruleReg)) {
+            return index
+          }
+        }
+
+        indexSrc = indexSrc.substring(index + 1).replace(/^\$+/, ``)
+      }
+    },
+    tokenizer(src: string) {
+      const match = src.match(ruleReg)
+      if (match) {
+        return {
+          type: `inlineKatex`,
+          raw: match[0],
+          text: match[2].trim(),
+          displayMode: match[1].length === 2,
+        }
+      }
+    },
+    renderer,
+  }
+}
+
+function blockKatex(_options: MarkedKatexOptions | undefined, renderer: any) {
+  return {
+    name: `blockKatex`,
+    level: `block`,
+    tokenizer(src: string) {
+      const match = src.match(blockRule)
+      if (match) {
+        return {
+          type: `blockKatex`,
+          raw: match[0],
+          text: match[2].trim(),
+          displayMode: match[1].length === 2,
+        }
+      }
+    },
+    renderer,
+  }
+}
+
+function inlineLatexKatex(_options: MarkedKatexOptions | undefined, renderer: any) {
+  return {
+    name: `inlineLatexKatex`,
+    level: `inline`,
+    start(src: string) {
+      const index = src.indexOf(`\\(`)
+      return index !== -1 ? index : undefined
+    },
+    tokenizer(src: string) {
+      const match = src.match(inlineLatexRule)
+      if (match) {
+        return {
+          type: `inlineLatexKatex`,
+          raw: match[0],
+          text: match[1].trim(),
+          displayMode: false,
+        }
+      }
+    },
+    renderer,
+  }
+}
+
+function blockLatexKatex(_options: MarkedKatexOptions | undefined, renderer: any) {
+  return {
+    name: `blockLatexKatex`,
+    level: `block`,
+    start(src: string) {
+      const index = src.indexOf(`\\[`)
+      return index !== -1 ? index : undefined
+    },
+    tokenizer(src: string) {
+      const match = src.match(blockLatexRule)
+      if (match) {
+        return {
+          type: `blockLatexKatex`,
+          raw: match[0],
+          text: match[1].trim(),
+          displayMode: true,
+        }
+      }
+    },
+    renderer,
+  }
+}
+
+export function MDKatex(options: MarkedKatexOptions | undefined, withStyle: boolean = true): MarkedExtension {
+  return {
+    extensions: [
+      inlineKatex(options, createRenderer(false, withStyle)),
+      blockKatex(options, createRenderer(true, withStyle)),
+      inlineLatexKatex(options, createRenderer(false, withStyle)),
+      blockLatexKatex(options, createRenderer(true, withStyle)),
+    ],
+  }
+}

skills/baoyu-markdown-to-html/scripts/md/extensions/markup.ts

@@ -0,0 +1,87 @@
+import type { MarkedExtension } from 'marked'
+
+/**
+ * 扩展标记语法：
+ * - 高亮: ==文本==
+ * - 下划线: ++文本++
+ * - 波浪线: ~文本~
+ */
+export function markedMarkup(): MarkedExtension {
+  return {
+    extensions: [
+      // 高亮语法 ==文本==
+      {
+        name: `markup_highlight`,
+        level: `inline`,
+        start(src: string) {
+          return src.match(/==(?!=)/)?.index
+        },
+        tokenizer(src: string) {
+          const rule = /^==((?:[^=]|=(?!=))+)==/
+          const match = rule.exec(src)
+          if (match) {
+            return {
+              type: `markup_highlight`,
+              raw: match[0],
+              text: match[1],
+            }
+          }
+        },
+        renderer(token: any) {
+          // 新主题系统：使用 class 而非内联样式
+          return `<span class="markup-highlight">${token.text}</span>`
+        },
+      },
+
+      // 下划线语法 ++文本++
+      {
+        name: `markup_underline`,
+        level: `inline`,
+        start(src: string) {
+          return src.match(/\+\+(?!\+)/)?.index
+        },
+        tokenizer(src: string) {
+          const rule = /^\+\+((?:[^+]|\+(?!\+))+)\+\+/
+          const match = rule.exec(src)
+          if (match) {
+            return {
+              type: `markup_underline`,
+              raw: match[0],
+              text: match[1],
+            }
+          }
+        },
+        renderer(token: any) {
+          // 新主题系统：使用 class 而非内联样式
+          return `<span class="markup-underline">${token.text}</span>`
+        },
+      },
+
+      // 波浪线语法 ~文本~
+      {
+        name: `markup_wavyline`,
+        level: `inline`,
+        start(src: string) {
+          // 查找单个 ~ 但不是连续的 ~~
+          return src.match(/~(?!~)/)?.index
+        },
+        tokenizer(src: string) {
+          // 匹配 ~文本~ 但确保不是 ~~文本~~
+          const rule = /^~([^~\n]+)~(?!~)/
+          const match = rule.exec(src)
+          if (match) {
+            return {
+              type: `markup_wavyline`,
+              raw: match[0],
+              text: match[1],
+            }
+          }
+        },
+        renderer(token: any) {
+          // 新主题系统：使用 class 而非内联样式
+          return `<span class="markup-wavyline">${token.text}</span>`
+        },
+      },
+    ],
+  }
+}

skills/baoyu-markdown-to-html/scripts/md/extensions/plantuml.ts

@@ -0,0 +1,289 @@
+import type { MarkedExtension, Tokens } from 'marked'
+import { deflateSync } from 'fflate'
+
+export interface PlantUMLOptions {
+  /**
+   * PlantUML 服务器地址
+   * @default 'https://www.plantuml.com/plantuml'
+   */
+  serverUrl?: string
+  /**
+   * 渲染格式
+   * @default 'svg'
+   */
+  format?: `svg` | `png`
+  /**
+   * CSS 类名
+   * @default 'plantuml-diagram'
+   */
+  className?: string
+  /**
+   * 是否内嵌SVG内容（用于微信公众号等不支持外链图片的环境）
+   * @default false
+   */
+  inlineSvg?: boolean
+  /**
+   * 自定义样式
+   */
+  styles?: {
+    container?: Record<string, string | number>
+  }
+}
+
+/**
+ * PlantUML 专用的 6-bit 编码函数
+ * 基于官方文档 https://plantuml.com/text-encoding
+ */
+function encode6bit(b: number): string {
+  if (b < 10) {
+    return String.fromCharCode(48 + b)
+  }
+  b -= 10
+  if (b < 26) {
+    return String.fromCharCode(65 + b)
+  }
+  b -= 26
+  if (b < 26) {
+    return String.fromCharCode(97 + b)
+  }
+  b -= 26
+  if (b === 0) {
+    return `-`
+  }
+  if (b === 1) {
+    return `_`
+  }
+  return `?`
+}
+
+/**
+ * 将 3 个字节附加到编码字符串中
+ * 基于官方文档 https://plantuml.com/text-encoding
+ */
+function append3bytes(b1: number, b2: number, b3: number): string {
+  const c1 = b1 >> 2
+  const c2 = ((b1 & 0x3) << 4) | (b2 >> 4)
+  const c3 = ((b2 & 0xF) << 2) | (b3 >> 6)
+  const c4 = b3 & 0x3F
+  let r = ``
+  r += encode6bit(c1 & 0x3F)
+  r += encode6bit(c2 & 0x3F)
+  r += encode6bit(c3 & 0x3F)
+  r += encode6bit(c4 & 0x3F)
+  return r
+}
+
+/**
+ * PlantUML 专用的 base64 编码函数
+ * 基于官方文档 https://plantuml.com/text-encoding
+ */
+function encode64(data: string): string {
+  let r = ``
+  for (let i = 0; i < data.length; i += 3) {
+    if (i + 2 === data.length) {
+      r += append3bytes(data.charCodeAt(i), data.charCodeAt(i + 1), 0)
+    }
+    else if (i + 1 === data.length) {
+      r += append3bytes(data.charCodeAt(i), 0, 0)
+    }
+    else {
+      r += append3bytes(data.charCodeAt(i), data.charCodeAt(i + 1), data.charCodeAt(i + 2))
+    }
+  }
+  return r
+}
+
+/**
+ * 使用 fflate 库进行 Deflate 压缩
+ * 按照官方规范进行压缩
+ */
+function performDeflate(input: string): string {
+  try {
+    // 将字符串转换为字节数组
+    const inputBytes = new TextEncoder().encode(input)
+
+    // 使用 fflate 进行 deflate 压缩（最高压缩级别 9）
+    const compressed = deflateSync(inputBytes, { level: 9 })
+
+    // 将压缩后的字节数组转换为二进制字符串
+    return String.fromCharCode(...compressed)
+  }
+  catch (error) {
+    console.warn(`Deflate compression failed:`, error)
+    // 如果压缩失败，返回原始输入
+    return input
+  }
+}
+
+/**
+ * 编码 PlantUML 代码为服务器可识别的格式
+ * 按照官方规范：UTF-8 编码 -> Deflate 压缩 -> PlantUML Base64 编码
+ */
+function encodePlantUML(plantumlCode: string): string {
+  try {
+    // 步骤 1 & 2: UTF-8 编码 + Deflate 压缩
+    const deflated = performDeflate(plantumlCode)
+
+    // 步骤 3: PlantUML 专用的 base64 编码
+    return encode64(deflated)
+  }
+  catch (error) {
+    // 如果编码失败，回退到简单方案
+    console.warn(`PlantUML encoding failed, using fallback:`, error)
+    const utf8Bytes = new TextEncoder().encode(plantumlCode)
+    const base64 = btoa(String.fromCharCode(...utf8Bytes))
+    return `~1${base64.replace(/\+/g, `-`).replace(/\//g, `_`).replace(/=/g, ``)}`
+  }
+}
+
+/**
+ * 生成 PlantUML 图片 URL
+ */
+function generatePlantUMLUrl(code: string, options: Required<PlantUMLOptions>): string {
+  const encoded = encodePlantUML(code)
+  const formatPath = options.format === `svg` ? `svg` : `png`
+  return `${options.serverUrl}/${formatPath}/${encoded}`
+}
+
+/**
+ * 渲染 PlantUML 图表
+ */
+function renderPlantUMLDiagram(token: Tokens.Code, options: Required<PlantUMLOptions>): string {
+  const { text: code } = token
+
+  // 检查代码是否包含 PlantUML 标记
+  const finalCode = (!code.trim().includes(`@start`) || !code.trim().includes(`@end`))
+    ? `@startuml\n${code.trim()}\n@enduml`
+    : code
+
+  const imageUrl = generatePlantUMLUrl(finalCode, options)
+
+  // 如果启用了内嵌SVG且格式是SVG
+  if (options.inlineSvg && options.format === `svg`) {
+    // 由于marked是同步的，我们需要返回一个占位符，然后异步替换
+    const placeholder = `plantuml-placeholder-${Math.random().toString(36).slice(2, 11)}`
+
+    // 异步获取SVG内容并替换
+    fetchSvgContent(imageUrl).then((svgContent) => {
+      const placeholderElement = document.querySelector(`[data-placeholder="${placeholder}"]`)
+      if (placeholderElement) {
+        placeholderElement.outerHTML = createPlantUMLHTML(imageUrl, options, svgContent)
+      }
+    })
+
+    const containerStyles = options.styles.container
+      ? Object.entries(options.styles.container)
+          .map(([key, value]) => `${key.replace(/([A-Z])/g, `-$1`).toLowerCase()}: ${value}`)
+          .join(`; `)
+      : ``
+
+    return `<div class="${options.className}" style="${containerStyles}" data-placeholder="${placeholder}">
+      <div style="color: #666; font-style: italic;">正在加载PlantUML图表...</div>
+    </div>`
+  }
+
+  return createPlantUMLHTML(imageUrl, options)
+}
+
+/**
+ * 获取SVG内容
+ */
+async function fetchSvgContent(svgUrl: string): Promise<string> {
+  try {
+    const response = await fetch(svgUrl)
+    if (!response.ok) {
+      throw new Error(`HTTP ${response.status}`)
+    }
+    const svgContent = await response.text()
+    // 移除SVG根元素的固定尺寸，使其响应式
+    return svgContent
+      // 移除width和height属性
+      .replace(/(<svg[^>]*)\swidth="[^"]*"/g, `$1`)
+      .replace(/(<svg[^>]*)\sheight="[^"]*"/g, `$1`)
+      // 移除style中的width和height
+      .replace(/(<svg[^>]*style="[^"]*?)width:[^;]*;?/g, `$1`)
+      .replace(/(<svg[^>]*style="[^"]*?)height:[^;]*;?/g, `$1`)
+  }
+  catch (error) {
+    console.warn(`Failed to fetch SVG content from ${svgUrl}:`, error)
+    return `<div style="color: #666; font-style: italic;">PlantUML图表加载失败</div>`
+  }
+}
+
+/**
+ * 创建 PlantUML HTML 元素
+ */
+function createPlantUMLHTML(imageUrl: string, options: Required<PlantUMLOptions>, svgContent?: string): string {
+  const containerStyles = options.styles.container
+    ? Object.entries(options.styles.container)
+        .map(([key, value]) => `${key.replace(/([A-Z])/g, `-$1`).toLowerCase()}: ${value}`)
+        .join(`; `)
+    : ``
+
+  // 如果有SVG内容，直接嵌入
+  if (svgContent) {
+    return `<div class="${options.className}" style="${containerStyles}">
+      ${svgContent}
+    </div>`
+  }
+
+  // 否则使用图片链接
+  return `<div class="${options.className}" style="${containerStyles}">
+    <img src="${imageUrl}" alt="PlantUML Diagram" style="max-width: 100%; height: auto;" />
+  </div>`
+}
+
+/**
+ * PlantUML marked 扩展
+ */
+export function markedPlantUML(options: PlantUMLOptions = {}): MarkedExtension {
+  const resolvedOptions: Required<PlantUMLOptions> = {
+    serverUrl: options.serverUrl || `https://www.plantuml.com/plantuml`,
+    format: options.format || `svg`,
+    className: options.className || `plantuml-diagram`,
+    inlineSvg: options.inlineSvg || false,
+    styles: {
+      container: {
+        textAlign: `center`,
+        margin: `16px 8px`,
+        overflowX: `auto`,
+        ...options.styles?.container,
+      },
+    },
+  }
+
+  return {
+    extensions: [
+      {
+        name: `plantuml`,
+        level: `block`,
+        start(src: string) {
+          // 匹配 ```plantuml 代码块
+          return src.match(/^```plantuml/m)?.index
+        },
+        tokenizer(src: string) {
+          // 匹配完整的 plantuml 代码块
+          const match = /^```plantuml\r?\n([\s\S]*?)\r?\n```/.exec(src)
+
+          if (match) {
+            const [raw, code] = match
+            return {
+              type: `plantuml`,
+              raw,
+              text: code.trim(),
+            }
+          }
+        },
+        renderer(token: any) {
+          return renderPlantUMLDiagram(token, resolvedOptions)
+        },
+      },
+    ],
+    walkTokens(token: any) {
+      // 处理现有的代码块，如果语言是 plantuml 就转换类型
+      if (token.type === `code` && token.lang === `plantuml`) {
+        token.type = `plantuml`
+      }
+    },
+  }
+}

skills/baoyu-markdown-to-html/scripts/md/extensions/ruby.ts

@@ -0,0 +1,125 @@
+import type { MarkedExtension } from 'marked'
+
+/**
+ * 注音/拼音标注扩展
+ * https://talk.commonmark.org/t/proper-ruby-text-rb-syntax-support-in-markdown/2279
+ * https://www.w3.org/TR/ruby/
+ *
+ * 支持的格式：
+ * 1. [文字]{注音}
+ * 2. [文字]^(注音)
+ *
+ * 分隔符：
+ * - `・` (中点)
+ * - `．` (全角句点)
+ * - `。` (中文句号)
+ * - `-` (英文减号)
+ */
+export function markedRuby(): MarkedExtension {
+  return {
+    extensions: [
+      {
+        name: `ruby`,
+        level: `inline`,
+        start(src: string) {
+          // 匹配以 [ 开头的格式
+          return src.match(/\[/)?.index
+        },
+        tokenizer(src: string) {
+          // 1. [文字]{注音}
+          const rule1 = /^\[([^\]]+)\]\{([^}]+)\}/
+          let match = rule1.exec(src)
+          if (match) {
+            return {
+              type: `ruby`,
+              raw: match[0],
+              text: match[1].trim(),
+              ruby: match[2].trim(),
+              format: `basic`,
+            }
+          }
+
+          // 2. [文字]^(注音)
+          const rule2 = /^\[([^\]]+)\]\^\(([^)]+)\)/
+          match = rule2.exec(src)
+          if (match) {
+            return {
+              type: `ruby`,
+              raw: match[0],
+              text: match[1].trim(),
+              ruby: match[2].trim(),
+              format: `basic-hat`,
+            }
+          }
+
+          return undefined
+        },
+        renderer(token: any) {
+          const { text, ruby, format } = token
+
+          // 检查是否有分隔符
+          const separatorRegex = /[・．。-]/g
+          const hasSeparators = separatorRegex.test(ruby)
+
+          if (hasSeparators) {
+            // 分割注音部分
+            const rubyParts = ruby.split(separatorRegex).filter((part: string) => part.trim() !== ``)
+
+            const textChars = text.split(``)
+            const result = []
+
+            if (textChars.length >= rubyParts.length) {
+              // 文字字符数量 >= 注音部分数量
+              // 按注音部分数量分割文字
+              let currentIndex = 0
+
+              for (let i = 0; i < rubyParts.length; i++) {
+                const rubyPart = rubyParts[i]
+                const remainingChars = textChars.length - currentIndex
+                const remainingParts = rubyParts.length - i
+
+                // 计算当前部分应该包含多少个字符，默认为 1
+                let charCount = 1
+                if (remainingParts === 1) {
+                  // 最后一个部分，包含所有剩余字符
+                  charCount = remainingChars
+                }
+
+                // 提取当前部分的文字
+                const currentText = textChars.slice(currentIndex, currentIndex + charCount).join(``)
+
+                result.push(`<ruby data-text="${currentText}" data-ruby="${rubyPart}" data-format="${format}">${currentText}<rp>(</rp><rt>${rubyPart}</rt><rp>)</rp></ruby>`)
+
+                currentIndex += charCount
+              }
+
+              // 处理剩余的字符
+              if (currentIndex < textChars.length) {
+                result.push(textChars.slice(currentIndex).join(``))
+              }
+            }
+            else {
+              // 文字字符数量 < 注音部分数量
+              // 每个字符对应一个注音部分，多余的注音被忽略
+              for (let i = 0; i < textChars.length; i++) {
+                const char = textChars[i]
+                const rubyPart = rubyParts[i] || ``
+
+                if (rubyPart) {
+                  result.push(`<ruby data-text="${char}" data-ruby="${rubyPart}" data-format="${format}">${char}<rp>(</rp><rt>${rubyPart}</rt><rp>)</rp></ruby>`)
+                }
+                else {
+                  result.push(char)
+                }
+              }
+            }
+
+            return result.join(``)
+          }
+
+          return `<ruby data-text="${text}" data-ruby="${ruby}" data-format="${format}">${text}<rp>(</rp><rt>${ruby}</rt><rp>)</rp></ruby>`
+        },
+      },
+    ],
+  }
+}

skills/baoyu-markdown-to-html/scripts/md/extensions/slider.ts

@@ -0,0 +1,73 @@
+import type { MarkedExtension, Tokens } from 'marked'
+
+/**
+ * A marked extension to support horizontal sliding images.
+ * Syntax: <![alt1](url1),![alt2](url2),![alt3](url3)>
+ */
+export function markedSlider(): MarkedExtension {
+  return {
+    extensions: [
+      {
+        name: `horizontalSlider`,
+        level: `block`,
+        start(src: string) {
+          return src.match(/^<!\[/)?.index
+        },
+        tokenizer(src: string) {
+          const rule = /^<(!\[.*?\]\(.*?\)(?:,!\[.*?\]\(.*?\))*)>/
+          const match = src.match(rule)
+          if (match) {
+            return {
+              type: `horizontalSlider`,
+              raw: match[0],
+              text: match[1],
+            }
+          }
+          return undefined
+        },
+        renderer(token: Tokens.Generic) {
+          const { text } = token
+          const imageMatches = text.match(/!\[(.*?)\]\((.*?)\)/g) || []
+
+          if (imageMatches.length === 0) {
+            return ``
+          }
+
+          const images = imageMatches.map((img: string) => {
+            const altMatch = img.match(/!\[(.*?)\]/) || []
+            const srcMatch = img.match(/\]\((.*?)\)/) || []
+            const alt = altMatch[1] || ``
+            const src = srcMatch[1] || ``
+
+            // 新主题系统：不再需要内联样式
+            return { src, alt }
+          })
+
+          // 使用微信公众号兼容的滑动容器布局
+          // 使用微信支持的section标签和特殊样式组合
+
+          return `
+            <section style="box-sizing: border-box; font-size: 16px;">
+              <section data-role="outer" style="font-family: 微软雅黑; font-size: 16px;">
+                <section data-role="paragraph" style="margin: 0px auto; box-sizing: border-box; width: 100%;">
+                  <section style="margin: 0px auto; text-align: center;">
+                    <section style="display: inline-block; width: 100%;">
+                      <!-- 微信公众号支持的滑动图片容器 -->
+                      <section style="overflow-x: scroll; -webkit-overflow-scrolling: touch; white-space: nowrap; width: 100%; text-align: center;">
+                        ${images.map((img: { src: string, alt: string }, _index: number) => `<section style="display: inline-block; width: 100%; margin-right: 0; vertical-align: top;">
+                          <img src="${img.src}" alt="${img.alt}" title="${img.alt}" style="width: 100%; height: auto; border-radius: 4px; vertical-align: top;"/>
+                          <p style="margin-top: 5px; font-size: 14px; color: #666; text-align: center; white-space: normal;">${img.alt}</p>
+                        </section>`).join(``)}
+                      </section>
+                    </section>
+                  </section>
+                </section>
+              </section>
+              <p style="font-size: 14px; color: #999; text-align: center; margin-top: 5px;"><<< 左右滑动看更多 >>></p>
+            </section>
+          `
+        },
+      },
+    ],
+  }
+}

skills/baoyu-markdown-to-html/scripts/md/extensions/toc.ts

@@ -0,0 +1,74 @@
+import type { MarkedExtension } from 'marked'
+
+/**
+ * marked 插件：支持 [TOC] 语法，自动生成嵌套目录
+ */
+export function markedToc(): MarkedExtension {
+  let headings: { text: string, depth: number, index: number }[] = []
+
+  let firstToken = true
+
+  return {
+    walkTokens(token) {
+      if (firstToken) {
+        headings = []
+        firstToken = false
+      }
+      if (token.type === `heading`) {
+        const text = token.text || ``
+        const depth = token.depth || 1
+        const index = headings.length
+        headings.push({ text, depth, index })
+      }
+    },
+    extensions: [
+      {
+        name: `toc`,
+        level: `block`,
+        start(src) {
+          // 只匹配独立一行的 [TOC]，避免误伤
+          const match = src.match(/^\s*\[TOC\]\s*$/m)
+          return match ? match.index : undefined
+        },
+        tokenizer(src) {
+          const match = /^\[TOC\]/.exec(src)
+          if (match) {
+            return {
+              type: `toc`,
+              raw: match[0],
+            }
+          }
+        },
+        renderer() {
+          if (!headings.length)
+            return ``
+          let html = `<nav class="markdown-toc"><ul class="toc-ul toc-level-1 pl-4 border-l ml-2">`
+          let lastDepth = 1
+          headings.forEach(({ text, depth, index }) => {
+            if (depth > lastDepth) {
+              for (let i = lastDepth + 1; i <= depth; i++) {
+                html += `<ul class="toc-ul toc-level-${i} pl-4 border-l ml-2">`
+              }
+            }
+            else if (depth < lastDepth) {
+              for (let i = lastDepth; i > depth; i--) {
+                html += `</ul>`
+              }
+            }
+            html += `<li class="toc-li toc-level-${depth} mb-1"><a class="text-gray-700 hover:text-blue-600 underline transition-colors" href="#${index}">${text}</a></li>`
+            lastDepth = depth
+          })
+
+          for (let i = lastDepth; i > 1; i--) {
+            html += `</ul>`
+          }
+
+          html += `</ul></nav>`
+
+          firstToken = true
+          return html
+        },
+      },
+    ],
+  }
+}

skills/baoyu-markdown-to-html/scripts/md/package.json

@@ -0,0 +1,14 @@
+{
+  "dependencies": {
+    "fflate": "^0.8.2",
+    "front-matter": "^4.0.2",
+    "highlight.js": "^11.11.1",
+    "juice": "^11.0.1",
+    "marked": "^15.0.6",
+    "reading-time": "^1.5.0",
+    "remark-cjk-friendly": "^1.1.0",
+    "remark-parse": "^11.0.0",
+    "remark-stringify": "^11.0.0",
+    "unified": "^11.0.5"
+  }
+}

skills/baoyu-markdown-to-html/scripts/md/render.ts

@@ -0,0 +1,848 @@
+#!/usr/bin/env npx tsx
+
+import fs from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import frontMatter from "front-matter";
+import hljs from "highlight.js/lib/core";
+import { marked, type RendererObject, type Tokens } from "marked";
+import readingTime, { type ReadTimeResults } from "reading-time";
+import { unified } from "unified";
+import remarkParse from "remark-parse";
+import remarkCjkFriendly from "remark-cjk-friendly";
+import remarkStringify from "remark-stringify";
+
+import {
+  markedAlert,
+  markedFootnotes,
+  markedInfographic,
+  markedMarkup,
+  markedPlantUML,
+  markedRuby,
+  markedSlider,
+  markedToc,
+  MDKatex,
+} from "./extensions/index.js";
+import {
+  COMMON_LANGUAGES,
+  highlightAndFormatCode,
+} from "./utils/languages.js";
+
+type ThemeName = string;
+
+const SCRIPT_DIR = path.dirname(fileURLToPath(import.meta.url));
+const THEME_DIR = path.resolve(SCRIPT_DIR, "themes");
+const EXTERNAL_THEME_CONFIG_PATH =
+  process.env.MD_THEME_CONFIG_PATH
+  || "/Users/jimliu/GitHub/md/packages/shared/src/configs/theme.ts";
+const EXTERNAL_THEME_DIR =
+  process.env.MD_THEME_DIR
+  || path.resolve(path.dirname(EXTERNAL_THEME_CONFIG_PATH), "theme-css");
+const FALLBACK_THEMES: ThemeName[] = ["default", "grace", "simple"];
+
+const DEFAULT_STYLE = {
+  primaryColor: "#0F4C81",
+  fontFamily:
+    "-apple-system-font,BlinkMacSystemFont, Helvetica Neue, PingFang SC, Hiragino Sans GB , Microsoft YaHei UI , Microsoft YaHei ,Arial,sans-serif",
+  fontSize: "16px",
+  foreground: "0 0% 3.9%",
+  blockquoteBackground: "#f7f7f7",
+};
+
+Object.entries(COMMON_LANGUAGES).forEach(([name, lang]) => {
+  hljs.registerLanguage(name, lang);
+});
+
+export { hljs };
+
+function stripOutputScope(cssContent: string): string {
+  let css = cssContent;
+  css = css.replace(/#output\s*\{/g, "body {");
+  css = css.replace(/#output\s+/g, "");
+  css = css.replace(/^#output\s*/gm, "");
+  return css;
+}
+
+function discoverThemesFromDir(dir: string): string[] {
+  if (!fs.existsSync(dir)) {
+    return [];
+  }
+  return fs
+    .readdirSync(dir)
+    .filter((name) => name.endsWith(".css"))
+    .map((name) => name.replace(/\.css$/i, ""))
+    .filter((name) => name.toLowerCase() !== "base");
+}
+
+function readThemeNamesFromConfig(configPath: string): string[] {
+  if (!fs.existsSync(configPath)) {
+    return [];
+  }
+  const content = fs.readFileSync(configPath, "utf-8");
+  const match = content.match(/themeOptionsMap\s*=\s*\{([\s\S]*?)\n\}/);
+  if (!match) {
+    return [];
+  }
+  return Array.from(match[1].matchAll(/^\s*([a-zA-Z0-9_-]+)\s*:/gm)).map(
+    (item) => item[1]!
+  );
+}
+
+function resolveThemeNames(): ThemeName[] {
+  const localThemes = discoverThemesFromDir(THEME_DIR);
+  const externalThemes = discoverThemesFromDir(EXTERNAL_THEME_DIR);
+  const configThemes = readThemeNamesFromConfig(EXTERNAL_THEME_CONFIG_PATH);
+  const combined = new Set<ThemeName>([
+    ...localThemes,
+    ...externalThemes,
+    ...configThemes,
+  ]);
+  const resolved = Array.from(combined).filter((name) =>
+    fs.existsSync(path.join(THEME_DIR, `${name}.css`))
+    || fs.existsSync(path.join(EXTERNAL_THEME_DIR, `${name}.css`))
+  );
+  return resolved.length ? resolved : FALLBACK_THEMES;
+}
+
+const THEME_NAMES: ThemeName[] = resolveThemeNames();
+
+marked.setOptions({
+  breaks: true,
+});
+marked.use(markedSlider());
+
+interface IOpts {
+  legend?: string;
+  citeStatus?: boolean;
+  countStatus?: boolean;
+  isMacCodeBlock?: boolean;
+  isShowLineNumber?: boolean;
+  themeMode?: "light" | "dark";
+}
+
+interface RendererAPI {
+  reset: (newOpts: Partial<IOpts>) => void;
+  setOptions: (newOpts: Partial<IOpts>) => void;
+  getOpts: () => IOpts;
+  parseFrontMatterAndContent: (markdown: string) => {
+    yamlData: Record<string, any>;
+    markdownContent: string;
+    readingTime: ReadTimeResults;
+  };
+  buildReadingTime: (reading: ReadTimeResults) => string;
+  buildFootnotes: () => string;
+  buildAddition: () => string;
+  createContainer: (html: string) => string;
+}
+
+interface ParseResult {
+  yamlData: Record<string, any>;
+  markdownContent: string;
+  readingTime: ReadTimeResults;
+}
+
+function escapeHtml(text: string): string {
+  return text
+    .replace(/&/g, "&amp;")
+    .replace(/</g, "&lt;")
+    .replace(/>/g, "&gt;")
+    .replace(/"/g, "&quot;")
+    .replace(/'/g, "&#39;")
+    .replace(/`/g, "&#96;");
+}
+
+function buildAddition(): string {
+  return `
+    <style>
+      .preview-wrapper pre::before {
+        position: absolute;
+        top: 0;
+        right: 0;
+        color: #ccc;
+        text-align: center;
+        font-size: 0.8em;
+        padding: 5px 10px 0;
+        line-height: 15px;
+        height: 15px;
+        font-weight: 600;
+      }
+    </style>
+  `;
+}
+
+function buildFootnoteArray(footnotes: [number, string, string][]): string {
+  return footnotes
+    .map(([index, title, link]) =>
+      link === title
+        ? `<code style="font-size: 90%; opacity: 0.6;">[${index}]</code>: <i style="word-break: break-all">${title}</i><br/>`
+        : `<code style="font-size: 90%; opacity: 0.6;">[${index}]</code> ${title}: <i style="word-break: break-all">${link}</i><br/>`
+    )
+    .join("\n");
+}
+
+function transform(legend: string, text: string | null, title: string | null): string {
+  const options = legend.split("-");
+  for (const option of options) {
+    if (option === "alt" && text) {
+      return text;
+    }
+    if (option === "title" && title) {
+      return title;
+    }
+  }
+  return "";
+}
+
+const macCodeSvg = `
+  <svg xmlns="http://www.w3.org/2000/svg" version="1.1" x="0px" y="0px" width="45px" height="13px" viewBox="0 0 450 130">
+    <ellipse cx="50" cy="65" rx="50" ry="52" stroke="rgb(220,60,54)" stroke-width="2" fill="rgb(237,108,96)" />
+    <ellipse cx="225" cy="65" rx="50" ry="52" stroke="rgb(218,151,33)" stroke-width="2" fill="rgb(247,193,81)" />
+    <ellipse cx="400" cy="65" rx="50" ry="52" stroke="rgb(27,161,37)" stroke-width="2" fill="rgb(100,200,86)" />
+  </svg>
+`.trim();
+
+function parseFrontMatterAndContent(markdownText: string): ParseResult {
+  try {
+    const parsed = frontMatter(markdownText);
+    const yamlData = parsed.attributes;
+    const markdownContent = parsed.body;
+
+    const readingTimeResult = readingTime(markdownContent);
+
+    return {
+      yamlData: yamlData as Record<string, any>,
+      markdownContent,
+      readingTime: readingTimeResult,
+    };
+  } catch (error) {
+    console.error("Error parsing front-matter:", error);
+    return {
+      yamlData: {},
+      markdownContent: markdownText,
+      readingTime: readingTime(markdownText),
+    };
+  }
+}
+
+export function initRenderer(opts: IOpts = {}): RendererAPI {
+  const footnotes: [number, string, string][] = [];
+  let footnoteIndex = 0;
+  let codeIndex = 0;
+  const listOrderedStack: boolean[] = [];
+  const listCounters: number[] = [];
+  const isBrowser = typeof window !== "undefined";
+
+  function getOpts(): IOpts {
+    return opts;
+  }
+
+  function styledContent(styleLabel: string, content: string, tagName?: string): string {
+    const tag = tagName ?? styleLabel;
+    const className = `${styleLabel.replace(/_/g, "-")}`;
+    const headingAttr = /^h\d$/.test(tag) ? " data-heading=\"true\"" : "";
+    return `<${tag} class="${className}"${headingAttr}>${content}</${tag}>`;
+  }
+
+  function addFootnote(title: string, link: string): number {
+    const existingFootnote = footnotes.find(([, , existingLink]) => existingLink === link);
+    if (existingFootnote) {
+      return existingFootnote[0];
+    }
+
+    footnotes.push([++footnoteIndex, title, link]);
+    return footnoteIndex;
+  }
+
+  function reset(newOpts: Partial<IOpts>): void {
+    footnotes.length = 0;
+    footnoteIndex = 0;
+    setOptions(newOpts);
+  }
+
+  function setOptions(newOpts: Partial<IOpts>): void {
+    opts = { ...opts, ...newOpts };
+    marked.use(markedAlert());
+    if (isBrowser) {
+      marked.use(MDKatex({ nonStandard: true }, true));
+    }
+    marked.use(markedMarkup());
+    marked.use(markedInfographic({ themeMode: opts.themeMode }));
+  }
+
+  function buildReadingTime(readingTimeResult: ReadTimeResults): string {
+    if (!opts.countStatus) {
+      return "";
+    }
+    if (!readingTimeResult.words) {
+      return "";
+    }
+    return `
+      <blockquote class="md-blockquote">
+        <p class="md-blockquote-p">字数 ${readingTimeResult?.words}，阅读大约需 ${Math.ceil(readingTimeResult?.minutes)} 分钟</p>
+      </blockquote>
+    `;
+  }
+
+  const buildFootnotes = () => {
+    if (!footnotes.length) {
+      return "";
+    }
+
+    return (
+      styledContent("h4", "引用链接")
+      + styledContent("footnotes", buildFootnoteArray(footnotes), "p")
+    );
+  };
+
+  const renderer: RendererObject = {
+    heading({ tokens, depth }: Tokens.Heading) {
+      const text = this.parser.parseInline(tokens);
+      const tag = `h${depth}`;
+      return styledContent(tag, text);
+    },
+
+    paragraph({ tokens }: Tokens.Paragraph): string {
+      const text = this.parser.parseInline(tokens);
+      const isFigureImage = text.includes("<figure") && text.includes("<img");
+      const isEmpty = text.trim() === "";
+      if (isFigureImage || isEmpty) {
+        return text;
+      }
+      return styledContent("p", text);
+    },
+
+    blockquote({ tokens }: Tokens.Blockquote): string {
+      const text = this.parser.parse(tokens);
+      return styledContent("blockquote", text);
+    },
+
+    code({ text, lang = "" }: Tokens.Code): string {
+      if (lang.startsWith("mermaid")) {
+        if (isBrowser) {
+          clearTimeout(codeIndex as any);
+          codeIndex = setTimeout(async () => {
+            const windowRef = typeof window !== "undefined" ? (window as any) : undefined;
+            if (windowRef && windowRef.mermaid) {
+              const mermaid = windowRef.mermaid;
+              await mermaid.run();
+            } else {
+              const mermaid = await import("mermaid");
+              await mermaid.default.run();
+            }
+          }, 0) as any as number;
+        }
+        return `<pre class="mermaid">${text}</pre>`;
+      }
+      const langText = lang.split(" ")[0];
+      const isLanguageRegistered = hljs.getLanguage(langText);
+      const language = isLanguageRegistered ? langText : "plaintext";
+
+      const highlighted = highlightAndFormatCode(
+        text,
+        language,
+        hljs,
+        !!opts.isShowLineNumber
+      );
+
+      const span = `<span class="mac-sign" style="padding: 10px 14px 0;">${macCodeSvg}</span>`;
+      let pendingAttr = "";
+      if (!isLanguageRegistered && langText !== "plaintext") {
+        const escapedText = text.replace(/"/g, "&quot;");
+        pendingAttr = ` data-language-pending="${langText}" data-raw-code="${escapedText}" data-show-line-number="${opts.isShowLineNumber}"`;
+      }
+      const code = `<code class="language-${lang}"${pendingAttr}>${highlighted}</code>`;
+
+      return `<pre class="hljs code__pre">${span}${code}</pre>`;
+    },
+
+    codespan({ text }: Tokens.Codespan): string {
+      const escapedText = escapeHtml(text);
+      return styledContent("codespan", escapedText, "code");
+    },
+
+    list({ ordered, items, start = 1 }: Tokens.List) {
+      listOrderedStack.push(ordered);
+      listCounters.push(Number(start));
+
+      const html = items.map((item) => this.listitem(item)).join("");
+
+      listOrderedStack.pop();
+      listCounters.pop();
+
+      return styledContent(ordered ? "ol" : "ul", html);
+    },
+
+    listitem(token: Tokens.ListItem) {
+      const ordered = listOrderedStack[listOrderedStack.length - 1];
+      const idx = listCounters[listCounters.length - 1]!;
+
+      listCounters[listCounters.length - 1] = idx + 1;
+
+      const prefix = ordered ? `${idx}. ` : "• ";
+
+      let content: string;
+      try {
+        content = this.parser.parseInline(token.tokens);
+      } catch {
+        content = this.parser
+          .parse(token.tokens)
+          .replace(/^<p(?:\s[^>]*)?>([\s\S]*?)<\/p>/, "$1");
+      }
+
+      return styledContent("listitem", `${prefix}${content}`, "li");
+    },
+
+    image({ href, title, text }: Tokens.Image): string {
+      const newText = opts.legend ? transform(opts.legend, text, title) : "";
+      const subText = newText ? styledContent("figcaption", newText) : "";
+      const titleAttr = title ? ` title="${title}"` : "";
+      return `<figure><img src="${href}"${titleAttr} alt="${text}"/>${subText}</figure>`;
+    },
+
+    link({ href, title, text, tokens }: Tokens.Link): string {
+      const parsedText = this.parser.parseInline(tokens);
+      if (/^https?:\/\/mp\.weixin\.qq\.com/.test(href)) {
+        return `<a href="${href}" title="${title || text}">${parsedText}</a>`;
+      }
+      if (href === text) {
+        return parsedText;
+      }
+      if (opts.citeStatus) {
+        const ref = addFootnote(title || text, href);
+        return `<a href="${href}" title="${title || text}">${parsedText}<sup>[${ref}]</sup></a>`;
+      }
+      return `<a href="${href}" title="${title || text}">${parsedText}</a>`;
+    },
+
+    strong({ tokens }: Tokens.Strong): string {
+      return styledContent("strong", this.parser.parseInline(tokens));
+    },
+
+    em({ tokens }: Tokens.Em): string {
+      return styledContent("em", this.parser.parseInline(tokens));
+    },
+
+    table({ header, rows }: Tokens.Table): string {
+      const headerRow = header
+        .map((cell) => {
+          const text = this.parser.parseInline(cell.tokens);
+          return styledContent("th", text);
+        })
+        .join("");
+      const body = rows
+        .map((row) => {
+          const rowContent = row.map((cell) => this.tablecell(cell)).join("");
+          return styledContent("tr", rowContent);
+        })
+        .join("");
+      return `
+        <section style="max-width: 100%; overflow: auto">
+          <table class="preview-table">
+            <thead>${headerRow}</thead>
+            <tbody>${body}</tbody>
+          </table>
+        </section>
+      `;
+    },
+
+    tablecell(token: Tokens.TableCell): string {
+      const text = this.parser.parseInline(token.tokens);
+      return styledContent("td", text);
+    },
+
+    hr(_: Tokens.Hr): string {
+      return styledContent("hr", "");
+    },
+  };
+
+  marked.use({ renderer });
+  marked.use(markedMarkup());
+  marked.use(markedToc());
+  marked.use(markedSlider());
+  marked.use(markedAlert({}));
+  if (isBrowser) {
+    marked.use(MDKatex({ nonStandard: true }, true));
+  }
+  marked.use(markedFootnotes());
+  marked.use(
+    markedPlantUML({
+      inlineSvg: isBrowser,
+    })
+  );
+  marked.use(markedInfographic());
+  marked.use(markedRuby());
+
+  return {
+    buildAddition,
+    buildFootnotes,
+    setOptions,
+    reset,
+    parseFrontMatterAndContent,
+    buildReadingTime,
+    createContainer(content: string) {
+      return styledContent("container", content, "section");
+    },
+    getOpts,
+  };
+}
+
+function printUsage(): void {
+  console.error(
+    [
+      "Usage:",
+      "  npx tsx src/md/render.ts <markdown_file> [--theme <name>]",
+      "",
+      "Options:",
+      `  --theme   Theme name (${THEME_NAMES.join(", ")})`,
+    ].join("\n")
+  );
+}
+
+function parseArgs(argv: string[]): CliOptions | null {
+  let inputPath = "";
+  let theme: ThemeName = "default";
+  let keepTitle = false;
+
+  for (let i = 0; i < argv.length; i += 1) {
+    const arg = argv[i];
+    if (!arg.startsWith("--") && !inputPath) {
+      inputPath = arg;
+      continue;
+    }
+
+    if (arg === "--theme") {
+      theme = (argv[i + 1] || "") as ThemeName;
+      i += 1;
+      continue;
+    }
+
+    if (arg.startsWith("--theme=")) {
+      theme = arg.slice("--theme=".length) as ThemeName;
+      continue;
+    }
+
+    if (arg === "--keep-title") {
+      keepTitle = true;
+      continue;
+    }
+
+    if (arg === "--help" || arg === "-h") {
+      return null;
+    }
+
+    console.error(`Unknown argument: ${arg}`);
+    return null;
+  }
+
+  if (!inputPath) {
+    return null;
+  }
+
+  if (!THEME_NAMES.includes(theme)) {
+    console.error(`Unknown theme: ${theme}`);
+    return null;
+  }
+
+  return {
+    inputPath,
+    theme,
+    keepTitle,
+  };
+}
+
+interface CliOptions {
+  inputPath: string;
+  theme: ThemeName;
+  keepTitle: boolean;
+}
+
+function preprocessCjkEmphasis(markdown: string): string {
+  const processor = unified()
+    .use(remarkParse)
+    .use(remarkCjkFriendly);
+  const tree = processor.parse(markdown);
+  const visit = (node: any, parent?: any, index?: number) => {
+    if (node.children) {
+      for (let i = 0; i < node.children.length; i++) {
+        visit(node.children[i], node, i);
+      }
+    }
+    if (node.type === "strong" && parent && typeof index === "number") {
+      const text = extractText(node);
+      parent.children[index] = { type: "html", value: `<strong>${text}</strong>` };
+    }
+    if (node.type === "emphasis" && parent && typeof index === "number") {
+      const text = extractText(node);
+      parent.children[index] = { type: "html", value: `<em>${text}</em>` };
+    }
+  };
+  const extractText = (node: any): string => {
+    if (node.type === "text") return node.value;
+    if (node.children) return node.children.map(extractText).join("");
+    return "";
+  };
+  visit(tree);
+  const stringify = unified().use(remarkStringify);
+  let result = stringify.stringify(tree);
+  result = result.replace(/&#x([0-9A-Fa-f]+);/g, (_, hex) =>
+    String.fromCodePoint(parseInt(hex, 16))
+  );
+  return result;
+}
+
+function renderMarkdown(raw: string, renderer: RendererAPI): {
+  html: string;
+  readingTime: ReadTimeResults;
+} {
+  const preprocessed = preprocessCjkEmphasis(raw);
+  const { markdownContent, readingTime: readingTimeResult } =
+    renderer.parseFrontMatterAndContent(preprocessed);
+
+  const html = marked.parse(markdownContent) as string;
+
+  return { html, readingTime: readingTimeResult };
+}
+
+function postProcessHtml(
+  baseHtml: string,
+  reading: ReadTimeResults,
+  renderer: RendererAPI
+): string {
+  let html = baseHtml;
+  html = renderer.buildReadingTime(reading) + html;
+  html += renderer.buildFootnotes();
+  html += renderer.buildAddition();
+  html += `
+    <style>
+      .hljs.code__pre > .mac-sign {
+        display: ${renderer.getOpts().isMacCodeBlock ? "flex" : "none"};
+      }
+    </style>
+  `;
+  html += `
+    <style>
+      h2 strong {
+        color: inherit !important;
+      }
+    </style>
+  `;
+  return renderer.createContainer(html);
+}
+
+function formatTimestamp(date = new Date()): string {
+  const pad = (value: number) => String(value).padStart(2, "0");
+  return `${date.getFullYear()}${pad(date.getMonth() + 1)}${pad(
+    date.getDate()
+  )}${pad(date.getHours())}${pad(date.getMinutes())}${pad(date.getSeconds())}`;
+}
+
+function ensureMarkdownPath(inputPath: string): void {
+  if (!inputPath.toLowerCase().endsWith(".md")) {
+    throw new Error("Input file must end with .md");
+  }
+}
+
+function loadThemeCss(theme: ThemeName): {
+  baseCss: string;
+  themeCss: string;
+} {
+  const basePathCandidates = [
+    path.join(THEME_DIR, "base.css"),
+    path.join(EXTERNAL_THEME_DIR, "base.css"),
+  ];
+  const themePathCandidates = [
+    path.join(THEME_DIR, `${theme}.css`),
+    path.join(EXTERNAL_THEME_DIR, `${theme}.css`),
+  ];
+  const basePath = basePathCandidates.find((candidate) =>
+    fs.existsSync(candidate)
+  );
+  const themePath = themePathCandidates.find((candidate) =>
+    fs.existsSync(candidate)
+  );
+
+  if (!basePath) {
+    throw new Error(
+      `Missing base CSS. Checked: ${basePathCandidates.join(", ")}`
+    );
+  }
+
+  if (!themePath) {
+    throw new Error(
+      `Missing theme CSS for "${theme}". Checked: ${themePathCandidates.join(", ")}`
+    );
+  }
+
+  return {
+    baseCss: fs.readFileSync(basePath, "utf-8"),
+    themeCss: fs.readFileSync(themePath, "utf-8"),
+  };
+}
+
+function buildCss(baseCss: string, themeCss: string): string {
+  const variables = `
+:root {
+  --md-primary-color: ${DEFAULT_STYLE.primaryColor};
+  --md-font-family: ${DEFAULT_STYLE.fontFamily};
+  --md-font-size: ${DEFAULT_STYLE.fontSize};
+  --foreground: ${DEFAULT_STYLE.foreground};
+  --blockquote-background: ${DEFAULT_STYLE.blockquoteBackground};
+}
+
+body {
+  margin: 0;
+  padding: 24px;
+  background: #ffffff;
+}
+
+#output {
+  max-width: 860px;
+  margin: 0 auto;
+}
+`.trim();
+
+  return [variables, baseCss, themeCss].join("\n\n");
+}
+
+function normalizeThemeCss(css: string): string {
+  return stripOutputScope(css);
+}
+
+function buildHtmlDocument(title: string, css: string, html: string): string {
+  return [
+    "<!doctype html>",
+    "<html>",
+    "<head>",
+    '  <meta charset="utf-8" />',
+    '  <meta name="viewport" content="width=device-width, initial-scale=1" />',
+    `  <title>${title}</title>`,
+    `  <style>${css}</style>`,
+    "</head>",
+    "<body>",
+    '  <div id="output">',
+    html,
+    "  </div>",
+    "</body>",
+    "</html>",
+  ].join("\n");
+}
+
+async function inlineCss(html: string): Promise<string> {
+  try {
+    const { default: juice } = await import("juice");
+    return juice(html, {
+      inlinePseudoElements: true,
+      preserveImportant: true,
+      resolveCSSVariables: false,
+    });
+  } catch (error) {
+    const detail = error instanceof Error ? error.message : String(error);
+    throw new Error(
+      `Missing dependency "juice" for CSS inlining. Install it first (e.g. "bun add juice" or "npm add juice"). Original error: ${detail}`
+    );
+  }
+}
+
+function normalizeCssText(cssText: string): string {
+  return cssText
+    .replace(/var\(--md-primary-color\)/g, DEFAULT_STYLE.primaryColor)
+    .replace(/var\(--md-font-family\)/g, DEFAULT_STYLE.fontFamily)
+    .replace(/var\(--md-font-size\)/g, DEFAULT_STYLE.fontSize)
+    .replace(/var\(--blockquote-background\)/g, DEFAULT_STYLE.blockquoteBackground)
+    .replace(/hsl\(var\(--foreground\)\)/g, "#3f3f3f")
+    .replace(/--md-primary-color:\s*[^;"']+;?/g, "")
+    .replace(/--md-font-family:\s*[^;"']+;?/g, "")
+    .replace(/--md-font-size:\s*[^;"']+;?/g, "")
+    .replace(/--blockquote-background:\s*[^;"']+;?/g, "")
+    .replace(/--foreground:\s*[^;"']+;?/g, "");
+}
+
+function normalizeInlineCss(html: string): string {
+  let output = html;
+  output = output.replace(
+    /<style([^>]*)>([\s\S]*?)<\/style>/gi,
+    (_match, attrs: string, cssText: string) =>
+      `<style${attrs}>${normalizeCssText(cssText)}</style>`
+  );
+  output = output.replace(
+    /style="([^"]*)"/gi,
+    (_match, cssText: string) => `style="${normalizeCssText(cssText)}"`
+  );
+  output = output.replace(
+    /style='([^']*)'/gi,
+    (_match, cssText: string) => `style='${normalizeCssText(cssText)}'`
+  );
+  return output;
+}
+
+function modifyHtmlStructure(htmlString: string): string {
+  let output = htmlString;
+  const pattern =
+    /<li([^>]*)>([\s\S]*?)(<ul[\s\S]*?<\/ul>|<ol[\s\S]*?<\/ol>)<\/li>/i;
+  while (pattern.test(output)) {
+    output = output.replace(pattern, "<li$1>$2</li>$3");
+  }
+  return output;
+}
+
+function removeFirstHeading(html: string): string {
+  return html.replace(/<h[12][^>]*>[\s\S]*?<\/h[12]>/, "");
+}
+
+async function main(): Promise<void> {
+  const options = parseArgs(process.argv.slice(2));
+  if (!options) {
+    printUsage();
+    process.exit(1);
+  }
+
+  const inputPath = path.resolve(process.cwd(), options.inputPath);
+  ensureMarkdownPath(inputPath);
+
+  if (!fs.existsSync(inputPath)) {
+    console.error(`File not found: ${inputPath}`);
+    process.exit(1);
+  }
+
+  const outputPath = path.resolve(
+    process.cwd(),
+    options.inputPath.replace(/\.md$/i, ".html")
+  );
+
+  const { baseCss, themeCss } = loadThemeCss(options.theme);
+  const css = normalizeThemeCss(buildCss(baseCss, themeCss));
+  const markdown = fs.readFileSync(inputPath, "utf-8");
+
+  const renderer = initRenderer({});
+  const { html: baseHtml, readingTime: readingTimeResult } = renderMarkdown(
+    markdown,
+    renderer
+  );
+  let content = postProcessHtml(baseHtml, readingTimeResult, renderer);
+  if (!options.keepTitle) {
+    content = removeFirstHeading(content);
+  }
+
+  const title = path.basename(outputPath, ".html");
+  const html = buildHtmlDocument(title, css, content);
+  const inlinedHtml = normalizeInlineCss(await inlineCss(html));
+  const finalHtml = modifyHtmlStructure(inlinedHtml);
+
+  let backupPath = "";
+  if (fs.existsSync(outputPath)) {
+    backupPath = `${outputPath}.bak-${formatTimestamp()}`;
+    fs.renameSync(outputPath, backupPath);
+  }
+
+  fs.writeFileSync(outputPath, finalHtml, "utf-8");
+
+  if (backupPath) {
+    console.log(`Backup created: ${backupPath}`);
+  }
+  console.log(`HTML written: ${outputPath}`);
+}
+
+main().catch((error) => {
+  console.error(error);
+  process.exit(1);
+});

skills/baoyu-markdown-to-html/scripts/md/themes/base.css

@@ -0,0 +1,34 @@
+/**
+ * MD 基础主题样式
+ * 包含所有元素的基础样式和 CSS 变量定义
+ */
+
+/* ==================== 容器样式 ==================== */
+section,
+container {
+  font-family: var(--md-font-family);
+  font-size: var(--md-font-size);
+  line-height: 1.75;
+  text-align: left;
+}
+
+/* 确保 #output 容器应用基础样式 */
+#output {
+  font-family: var(--md-font-family);
+  font-size: var(--md-font-size);
+  line-height: 1.75;
+  text-align: left;
+}
+
+/* ==================== Global resets ==================== */
+blockquote {
+  margin-top: 0;
+  margin-right: 0;
+  margin-bottom: 0;
+  margin-left: 0;
+}
+
+/* 去除第一个元素的 margin-top */
+#output section > :first-child {
+  margin-top: 0 !important;
+}

skills/baoyu-markdown-to-html/scripts/md/themes/default.css

@@ -0,0 +1,433 @@
+/**
+ * MD 默认主题（经典主题）
+ * 按 Alt/Option + Shift + F 可格式化
+ * 如需使用主题色，请使用 var(--md-primary-color) 代替颜色值
+ */
+
+/* ==================== 一级标题 ==================== */
+h1 {
+  display: table;
+  padding: 0 1em;
+  border-bottom: 2px solid var(--md-primary-color);
+  margin: 2em auto 1em;
+  color: hsl(var(--foreground));
+  font-size: calc(var(--md-font-size) * 1.2);
+  font-weight: bold;
+  text-align: center;
+}
+
+/* ==================== 二级标题 ==================== */
+h2 {
+  display: table;
+  padding: 0 0.2em;
+  margin: 4em auto 2em;
+  color: #fff;
+  background: var(--md-primary-color);
+  font-size: calc(var(--md-font-size) * 1.2);
+  font-weight: bold;
+  text-align: center;
+}
+
+/* ==================== 三级标题 ==================== */
+h3 {
+  padding-left: 8px;
+  border-left: 3px solid var(--md-primary-color);
+  margin: 2em 8px 0.75em 0;
+  color: hsl(var(--foreground));
+  font-size: calc(var(--md-font-size) * 1.1);
+  font-weight: bold;
+  line-height: 1.2;
+}
+
+/* ==================== 四级标题 ==================== */
+h4 {
+  margin: 2em 8px 0.5em;
+  color: var(--md-primary-color);
+  font-size: calc(var(--md-font-size) * 1);
+  font-weight: bold;
+}
+
+/* ==================== 五级标题 ==================== */
+h5 {
+  margin: 1.5em 8px 0.5em;
+  color: var(--md-primary-color);
+  font-size: calc(var(--md-font-size) * 1);
+  font-weight: bold;
+}
+
+/* ==================== 六级标题 ==================== */
+h6 {
+  margin: 1.5em 8px 0.5em;
+  font-size: calc(var(--md-font-size) * 1);
+  color: var(--md-primary-color);
+}
+
+/* ==================== 段落 ==================== */
+p {
+  margin: 1.5em 8px;
+  letter-spacing: 0.1em;
+  color: hsl(var(--foreground));
+}
+
+/* ==================== 引用块 ==================== */
+blockquote {
+  font-style: normal;
+  padding: 1em;
+  border-left: 4px solid var(--md-primary-color);
+  border-radius: 6px;
+  color: hsl(var(--foreground));
+  background: var(--blockquote-background);
+  margin-bottom: 1em;
+}
+
+blockquote > p {
+  display: block;
+  font-size: 1em;
+  letter-spacing: 0.1em;
+  color: hsl(var(--foreground));
+  margin: 0;
+}
+
+/* ==================== GFM 警告块 ==================== */
+.alert-title-note,
+.alert-title-tip,
+.alert-title-info,
+.alert-title-important,
+.alert-title-warning,
+.alert-title-caution,
+.alert-title-abstract,
+.alert-title-summary,
+.alert-title-tldr,
+.alert-title-todo,
+.alert-title-success,
+.alert-title-done,
+.alert-title-question,
+.alert-title-help,
+.alert-title-faq,
+.alert-title-failure,
+.alert-title-fail,
+.alert-title-missing,
+.alert-title-danger,
+.alert-title-error,
+.alert-title-bug,
+.alert-title-example,
+.alert-title-quote,
+.alert-title-cite {
+  display: flex;
+  align-items: center;
+  gap: 0.5em;
+  margin-bottom: 0.5em;
+}
+
+.alert-title-note {
+  color: #478be6;
+}
+
+.alert-title-tip {
+  color: #57ab5a;
+}
+
+.alert-title-info {
+  color: #93c5fd;
+}
+
+.alert-title-important {
+  color: #986ee2;
+}
+
+.alert-title-warning {
+  color: #c69026;
+}
+
+.alert-title-caution {
+  color: #e5534b;
+}
+
+/* Obsidian-style callout colors */
+.alert-title-abstract,
+.alert-title-summary,
+.alert-title-tldr {
+  color: #00bfff;
+}
+
+.alert-title-todo {
+  color: #478be6;
+}
+
+.alert-title-success,
+.alert-title-done {
+  color: #57ab5a;
+}
+
+.alert-title-question,
+.alert-title-help,
+.alert-title-faq {
+  color: #c69026;
+}
+
+.alert-title-failure,
+.alert-title-fail,
+.alert-title-missing {
+  color: #e5534b;
+}
+
+.alert-title-danger,
+.alert-title-error {
+  color: #e5534b;
+}
+
+.alert-title-bug {
+  color: #e5534b;
+}
+
+.alert-title-example {
+  color: #986ee2;
+}
+
+.alert-title-quote,
+.alert-title-cite {
+  color: #9ca3af;
+}
+
+/* GFM Alert SVG 图标颜色 */
+.alert-icon-note {
+  fill: #478be6;
+}
+
+.alert-icon-tip {
+  fill: #57ab5a;
+}
+
+.alert-icon-info {
+  fill: #93c5fd;
+}
+
+.alert-icon-important {
+  fill: #986ee2;
+}
+
+.alert-icon-warning {
+  fill: #c69026;
+}
+
+.alert-icon-caution {
+  fill: #e5534b;
+}
+
+/* Obsidian-style callout icon colors */
+.alert-icon-abstract,
+.alert-icon-summary,
+.alert-icon-tldr {
+  fill: #00bfff;
+}
+
+.alert-icon-todo {
+  fill: #478be6;
+}
+
+.alert-icon-success,
+.alert-icon-done {
+  fill: #57ab5a;
+}
+
+.alert-icon-question,
+.alert-icon-help,
+.alert-icon-faq {
+  fill: #c69026;
+}
+
+.alert-icon-failure,
+.alert-icon-fail,
+.alert-icon-missing {
+  fill: #e5534b;
+}
+
+.alert-icon-danger,
+.alert-icon-error {
+  fill: #e5534b;
+}
+
+.alert-icon-bug {
+  fill: #e5534b;
+}
+
+.alert-icon-example {
+  fill: #986ee2;
+}
+
+.alert-icon-quote,
+.alert-icon-cite {
+  fill: #9ca3af;
+}
+
+/* ==================== 代码块 ==================== */
+pre.code__pre,
+.hljs.code__pre {
+  font-size: 90%;
+  overflow-x: auto;
+  border-radius: 8px;
+  padding: 0 !important;
+  line-height: 1.5;
+  margin: 10px 8px;
+}
+
+/* ==================== 图片 ==================== */
+img {
+  display: block;
+  max-width: 100%;
+  margin: 0.1em auto 0.5em;
+  border-radius: 4px;
+}
+
+/* ==================== 列表 ==================== */
+ol {
+  padding-left: 1em;
+  margin-left: 0;
+  color: hsl(var(--foreground));
+}
+
+ul {
+  list-style: circle;
+  padding-left: 1em;
+  margin-left: 0;
+  color: hsl(var(--foreground));
+}
+
+li {
+  display: block;
+  margin: 0.2em 8px;
+  color: hsl(var(--foreground));
+}
+
+/* ==================== 脚注 ==================== */
+/* footnotes 在 buildFootnotes() 中渲染为 <p> 标签 */
+p.footnotes {
+  margin: 0.5em 8px;
+  font-size: 80%;
+  color: hsl(var(--foreground));
+}
+
+/* ==================== 图表 ==================== */
+figure {
+  margin: 1.5em 8px;
+  color: hsl(var(--foreground));
+}
+
+figcaption,
+.md-figcaption {
+  text-align: center;
+  color: #888;
+  font-size: 0.8em;
+}
+
+/* ==================== 分隔线 ==================== */
+hr {
+  border-style: solid;
+  border-width: 2px 0 0;
+  border-color: rgba(0, 0, 0, 0.1);
+  -webkit-transform-origin: 0 0;
+  -webkit-transform: scale(1, 0.5);
+  transform-origin: 0 0;
+  transform: scale(1, 0.5);
+  height: 0.4em;
+  margin: 1.5em 0;
+}
+
+/* ==================== 行内代码 ==================== */
+code {
+  font-size: 90%;
+  color: #d14;
+  background: rgba(27, 31, 35, 0.05);
+  padding: 3px 5px;
+  border-radius: 4px;
+}
+
+/* 代码块内的 code 标签需要特殊处理（覆盖行内 code 样式） */
+pre.code__pre > code,
+.hljs.code__pre > code {
+  display: -webkit-box;
+  padding: 0.5em 1em 1em;
+  overflow-x: auto;
+  text-indent: 0;
+  color: inherit;
+  background: none;
+  white-space: nowrap;
+  margin: 0;
+}
+
+/* ==================== 强调 ==================== */
+em {
+  font-style: italic;
+  font-size: inherit;
+}
+
+/* ==================== 链接 ==================== */
+a {
+  color: #576b95;
+  text-decoration: none;
+}
+
+/* ==================== 粗体 ==================== */
+strong {
+  color: var(--md-primary-color);
+  font-weight: bold;
+  font-size: inherit;
+}
+
+/* ==================== 表格 ==================== */
+table {
+  color: hsl(var(--foreground));
+}
+
+thead {
+  font-weight: bold;
+  color: hsl(var(--foreground));
+}
+
+th {
+  border: 1px solid #dfdfdf;
+  padding: 0.25em 0.5em;
+  color: hsl(var(--foreground));
+  word-break: keep-all;
+  background: rgba(0, 0, 0, 0.05);
+}
+
+td {
+  border: 1px solid #dfdfdf;
+  padding: 0.25em 0.5em;
+  color: hsl(var(--foreground));
+  word-break: keep-all;
+}
+
+/* ==================== KaTeX 公式 ==================== */
+.katex-inline {
+  max-width: 100%;
+  overflow-x: auto;
+}
+
+.katex-block {
+  max-width: 100%;
+  overflow-x: auto;
+  -webkit-overflow-scrolling: touch;
+  padding: 0.5em 0;
+  text-align: center;
+}
+
+/* ==================== 标记高亮 ==================== */
+.markup-highlight {
+  background-color: var(--md-primary-color);
+  padding: 2px 4px;
+  border-radius: 2px;
+  color: #fff;
+}
+
+.markup-underline {
+  text-decoration: underline;
+  text-decoration-color: var(--md-primary-color);
+}
+
+.markup-wavyline {
+  text-decoration: underline wavy;
+  text-decoration-color: var(--md-primary-color);
+  text-decoration-thickness: 2px;
+}

skills/baoyu-markdown-to-html/scripts/md/themes/grace.css

@@ -0,0 +1,136 @@
+/**
+ * MD 优雅主题 (@brzhang)
+ * 在默认主题基础上添加优雅的视觉效果
+ */
+
+/* ==================== 标题样式 ==================== */
+h1 {
+  padding: 0.5em 1em;
+  border-bottom: 2px solid var(--md-primary-color);
+  font-size: calc(var(--md-font-size) * 1.4);
+  text-shadow: 2px 2px 4px rgba(0, 0, 0, 0.1);
+}
+
+h2 {
+  padding: 0.3em 1em;
+  border-radius: 8px;
+  font-size: calc(var(--md-font-size) * 1.3);
+  box-shadow: 0 4px 6px rgba(0, 0, 0, 0.1);
+}
+
+h3 {
+  padding-left: 12px;
+  font-size: calc(var(--md-font-size) * 1.2);
+  border-left: 4px solid var(--md-primary-color);
+  border-bottom: 1px dashed var(--md-primary-color);
+}
+
+h4 {
+  font-size: calc(var(--md-font-size) * 1.1);
+}
+
+h5 {
+  font-size: var(--md-font-size);
+}
+
+h6 {
+  font-size: var(--md-font-size);
+}
+
+/* ==================== 引用块 ==================== */
+blockquote {
+  font-style: italic;
+  padding: 1em 1em 1em 2em;
+  border-left: 4px solid var(--md-primary-color);
+  border-radius: 6px;
+  color: rgba(0, 0, 0, 0.6);
+  box-shadow: 0 4px 6px rgba(0, 0, 0, 0.05);
+  margin-bottom: 1em;
+}
+
+.markdown-alert {
+  font-style: italic;
+}
+
+/* ==================== 代码块 ==================== */
+pre.code__pre,
+.hljs.code__pre {
+  box-shadow: inset 0 0 10px rgba(0, 0, 0, 0.05);
+}
+
+pre.code__pre > code,
+.hljs.code__pre > code {
+  font-family:
+    'Fira Code',
+    Menlo,
+    Operator Mono,
+    Consolas,
+    Monaco,
+    monospace;
+}
+
+/* ==================== 图片 ==================== */
+img {
+  border-radius: 8px;
+  box-shadow: 0 4px 8px rgba(0, 0, 0, 0.1);
+}
+
+figcaption,
+.md-figcaption {
+  text-align: center;
+  color: #888;
+  font-size: 0.8em;
+}
+
+/* ==================== 列表 ==================== */
+ol {
+  padding-left: 1.5em;
+}
+
+ul {
+  list-style: none;
+  padding-left: 1.5em;
+}
+
+li {
+  margin: 0.5em 8px;
+}
+
+/* ==================== 分隔线 ==================== */
+hr {
+  height: 1px;
+  border: none;
+  margin: 2em 0;
+  background: linear-gradient(to right, rgba(0, 0, 0, 0), rgba(0, 0, 0, 0.1), rgba(0, 0, 0, 0));
+}
+
+/* ==================== 表格 ==================== */
+table {
+  border-collapse: separate;
+  border-spacing: 0;
+  border-radius: 8px;
+  margin: 1em 8px;
+  color: hsl(var(--foreground));
+  box-shadow: 0 4px 6px rgba(0, 0, 0, 0.1);
+  overflow: hidden;
+}
+
+thead {
+  color: #fff;
+}
+
+td {
+  padding: 0.5em 1em;
+}
+
+/* ==================== 强调 ==================== */
+em {
+  font-style: italic;
+  font-size: inherit;
+}
+
+/* ==================== 链接 ==================== */
+a {
+  color: #576b95;
+  text-decoration: none;
+}

skills/baoyu-markdown-to-html/scripts/md/themes/simple.css

@@ -0,0 +1,129 @@
+/**
+ * MD 简洁主题 (@okooo5km)
+ * 简洁现代的设计风格
+ */
+
+/* ==================== 标题样式 ==================== */
+h1 {
+  padding: 0.5em 1em;
+  font-size: calc(var(--md-font-size) * 1.4);
+  text-shadow: 1px 1px 3px rgba(0, 0, 0, 0.05);
+}
+
+h2 {
+  padding: 0.3em 1.2em;
+  font-size: calc(var(--md-font-size) * 1.3);
+  border-radius: 8px 24px 8px 24px;
+  box-shadow: 0 2px 6px rgba(0, 0, 0, 0.06);
+}
+
+h3 {
+  padding-left: 12px;
+  font-size: calc(var(--md-font-size) * 1.2);
+  border-radius: 6px;
+  line-height: 2.4em;
+  border-left: 4px solid var(--md-primary-color);
+  border-right: 1px solid color-mix(in srgb, var(--md-primary-color) 10%, transparent);
+  border-bottom: 1px solid color-mix(in srgb, var(--md-primary-color) 10%, transparent);
+  border-top: 1px solid color-mix(in srgb, var(--md-primary-color) 10%, transparent);
+  background: color-mix(in srgb, var(--md-primary-color) 8%, transparent);
+}
+
+h4 {
+  font-size: calc(var(--md-font-size) * 1.1);
+  border-radius: 6px;
+}
+
+h5 {
+  font-size: var(--md-font-size);
+  border-radius: 6px;
+}
+
+h6 {
+  font-size: var(--md-font-size);
+  border-radius: 6px;
+}
+
+/* ==================== 引用块 ==================== */
+blockquote {
+  font-style: italic;
+  padding: 1em 1em 1em 2em;
+  color: rgba(0, 0, 0, 0.6);
+  border-bottom: 0.2px solid rgba(0, 0, 0, 0.04);
+  border-top: 0.2px solid rgba(0, 0, 0, 0.04);
+  border-right: 0.2px solid rgba(0, 0, 0, 0.04);
+}
+
+/* GFM Alert 样式覆盖 */
+.markdown-alert-note,
+.markdown-alert-tip,
+.markdown-alert-info,
+.markdown-alert-important,
+.markdown-alert-warning,
+.markdown-alert-caution {
+  font-style: italic;
+}
+
+/* ==================== 代码块 ==================== */
+pre.code__pre,
+.hljs.code__pre {
+  border: 1px solid rgba(0, 0, 0, 0.04);
+}
+
+pre.code__pre > code,
+.hljs.code__pre > code {
+  font-family:
+    'Fira Code',
+    Menlo,
+    Operator Mono,
+    Consolas,
+    Monaco,
+    monospace;
+}
+
+/* ==================== 图片 ==================== */
+img {
+  border-radius: 8px;
+  border: 1px solid rgba(0, 0, 0, 0.04);
+}
+
+figcaption,
+.md-figcaption {
+  text-align: center;
+  color: #888;
+  font-size: 0.8em;
+}
+
+/* ==================== 列表 ==================== */
+ol {
+  padding-left: 1.5em;
+}
+
+ul {
+  list-style: none;
+  padding-left: 1.5em;
+}
+
+li {
+  margin: 0.5em 8px;
+}
+
+/* ==================== 分隔线 ==================== */
+hr {
+  height: 1px;
+  border: none;
+  margin: 2em 0;
+  background: linear-gradient(to right, rgba(0, 0, 0, 0), rgba(0, 0, 0, 0.1), rgba(0, 0, 0, 0));
+}
+
+/* ==================== 强调 ==================== */
+em {
+  font-style: italic;
+  font-size: inherit;
+}
+
+/* ==================== 链接 ==================== */
+a {
+  color: #576b95;
+  text-decoration: none;
+}

skills/baoyu-markdown-to-html/scripts/md/utils/languages.ts

@@ -0,0 +1,238 @@
+import type { LanguageFn } from 'highlight.js'
+import bash from 'highlight.js/lib/languages/bash'
+import c from 'highlight.js/lib/languages/c'
+import cpp from 'highlight.js/lib/languages/cpp'
+import csharp from 'highlight.js/lib/languages/csharp'
+import css from 'highlight.js/lib/languages/css'
+import diff from 'highlight.js/lib/languages/diff'
+import go from 'highlight.js/lib/languages/go'
+import graphql from 'highlight.js/lib/languages/graphql'
+import ini from 'highlight.js/lib/languages/ini'
+import java from 'highlight.js/lib/languages/java'
+import javascript from 'highlight.js/lib/languages/javascript'
+import json from 'highlight.js/lib/languages/json'
+import kotlin from 'highlight.js/lib/languages/kotlin'
+import less from 'highlight.js/lib/languages/less'
+import lua from 'highlight.js/lib/languages/lua'
+import makefile from 'highlight.js/lib/languages/makefile'
+import markdown from 'highlight.js/lib/languages/markdown'
+import objectivec from 'highlight.js/lib/languages/objectivec'
+import perl from 'highlight.js/lib/languages/perl'
+import php from 'highlight.js/lib/languages/php'
+import phpTemplate from 'highlight.js/lib/languages/php-template'
+import plaintext from 'highlight.js/lib/languages/plaintext'
+import python from 'highlight.js/lib/languages/python'
+import pythonRepl from 'highlight.js/lib/languages/python-repl'
+import r from 'highlight.js/lib/languages/r'
+import ruby from 'highlight.js/lib/languages/ruby'
+import rust from 'highlight.js/lib/languages/rust'
+import scss from 'highlight.js/lib/languages/scss'
+import shell from 'highlight.js/lib/languages/shell'
+import sql from 'highlight.js/lib/languages/sql'
+import swift from 'highlight.js/lib/languages/swift'
+import typescript from 'highlight.js/lib/languages/typescript'
+import vbnet from 'highlight.js/lib/languages/vbnet'
+import wasm from 'highlight.js/lib/languages/wasm'
+import xml from 'highlight.js/lib/languages/xml'
+import yaml from 'highlight.js/lib/languages/yaml'
+
+export const COMMON_LANGUAGES: Record<string, LanguageFn> = {
+  bash,
+  c,
+  cpp,
+  csharp,
+  css,
+  diff,
+  go,
+  graphql,
+  ini,
+  java,
+  javascript,
+  json,
+  kotlin,
+  less,
+  lua,
+  makefile,
+  markdown,
+  objectivec,
+  perl,
+  php,
+  'php-template': phpTemplate,
+  plaintext,
+  python,
+  'python-repl': pythonRepl,
+  r,
+  ruby,
+  rust,
+  scss,
+  shell,
+  sql,
+  swift,
+  typescript,
+  vbnet,
+  wasm,
+  xml,
+  yaml,
+}
+
+// highlight.js CDN 配置
+const HLJS_VERSION = `11.11.1`
+const HLJS_CDN_BASE = `https://cdn-doocs.oss-cn-shenzhen.aliyuncs.com/npm/highlightjs/${HLJS_VERSION}`
+
+// 缓存正在加载的语言
+const loadingLanguages = new Map<string, Promise<void>>()
+
+/**
+ * 生成语言包的 CDN URL
+ */
+function grammarUrlFor(language: string): string {
+  return `${HLJS_CDN_BASE}/es/languages/${language}.min.js`
+}
+
+/**
+ * 动态加载并注册语言
+ * @param language 语言名称
+ * @param hljs highlight.js 实例
+ */
+export async function loadAndRegisterLanguage(language: string, hljs: any): Promise<void> {
+  // 如果已经注册，直接返回
+  if (hljs.getLanguage(language)) {
+    return
+  }
+
+  // 如果正在加载，等待加载完成
+  if (loadingLanguages.has(language)) {
+    await loadingLanguages.get(language)
+    return
+  }
+
+  // 开始加载
+  const loadPromise = (async () => {
+    try {
+      const module = await import(/* @vite-ignore */ grammarUrlFor(language))
+      hljs.registerLanguage(language, module.default)
+    }
+    catch (error) {
+      console.warn(`Failed to load language: ${language}`, error)
+      throw error
+    }
+    finally {
+      loadingLanguages.delete(language)
+    }
+  })()
+
+  loadingLanguages.set(language, loadPromise)
+  await loadPromise
+}
+
+/**
+ * 格式化高亮后的代码，处理空格和制表符
+ */
+function formatHighlightedCode(html: string, preserveNewlines = false): string {
+  let formatted = html
+  // 将 span 之间的空格移到 span 内部
+  formatted = formatted.replace(/(<span[^>]*>[^<]*<\/span>)(\s+)(<span[^>]*>[^<]*<\/span>)/g, (_: string, span1: string, spaces: string, span2: string) => span1 + span2.replace(/^(<span[^>]*>)/, `$1${spaces}`))
+  formatted = formatted.replace(/(\s+)(<span[^>]*>)/g, (_: string, spaces: string, span: string) => span.replace(/^(<span[^>]*>)/, `$1${spaces}`))
+  // 替换制表符为4个空格
+  formatted = formatted.replace(/\t/g, `    `)
+
+  if (preserveNewlines) {
+    // 替换换行符为 <br/>，并将空格转换为 &nbsp;
+    formatted = formatted.replace(/\r\n/g, `<br/>`).replace(/\n/g, `<br/>`).replace(/(>[^<]+)|(^[^<]+)/g, (str: string) => str.replace(/\s/g, `&nbsp;`))
+  }
+  else {
+    // 只将空格转换为 &nbsp;
+    formatted = formatted.replace(/(>[^<]+)|(^[^<]+)/g, (str: string) => str.replace(/\s/g, `&nbsp;`))
+  }
+
+  return formatted
+}
+
+/**
+ * 高亮代码并格式化（支持行号）
+ * @param text 原始代码文本
+ * @param language 语言名称
+ * @param hljs highlight.js 实例
+ * @param showLineNumber 是否显示行号
+ * @returns 格式化后的 HTML
+ */
+export function highlightAndFormatCode(text: string, language: string, hljs: any, showLineNumber: boolean): string {
+  let highlighted = ``
+
+  if (showLineNumber) {
+    const rawLines = text.replace(/\r\n/g, `\n`).split(`\n`)
+
+    const highlightedLines = rawLines.map((lineRaw) => {
+      const lineHtml = hljs.highlight(lineRaw, { language }).value
+      const formatted = formatHighlightedCode(lineHtml, false)
+      return formatted === `` ? `&nbsp;` : formatted
+    })
+
+    const lineNumbersHtml = highlightedLines.map((_, idx) => `<section style="padding:0 10px 0 0;line-height:1.75">${idx + 1}</section>`).join(``)
+    const codeInnerHtml = highlightedLines.join(`<br/>`)
+    const codeLinesHtml = `<div style="white-space:pre;min-width:max-content;line-height:1.75">${codeInnerHtml}</div>`
+    const lineNumberColumnStyles = `text-align:right;padding:8px 0;border-right:1px solid rgba(0,0,0,0.04);user-select:none;background:var(--code-bg,transparent);`
+
+    highlighted = `
+      <section style="display:flex;align-items:flex-start;overflow-x:hidden;overflow-y:auto;width:100%;max-width:100%;padding:0;box-sizing:border-box">
+        <section class="line-numbers" style="${lineNumberColumnStyles}">${lineNumbersHtml}</section>
+        <section class="code-scroll" style="flex:1 1 auto;overflow-x:auto;overflow-y:visible;padding:8px;min-width:0;box-sizing:border-box">${codeLinesHtml}</section>
+      </section>
+    `
+  }
+  else {
+    const rawHighlighted = hljs.highlight(text, { language }).value
+    highlighted = formatHighlightedCode(rawHighlighted, true)
+  }
+
+  return highlighted
+}
+
+export function highlightCodeBlock(codeBlock: Element, language: string, hljs: any): void {
+  const rawCode = codeBlock.getAttribute(`data-raw-code`)
+  const showLineNumber = codeBlock.getAttribute(`data-show-line-number`) === `true`
+
+  if (!rawCode)
+    return
+
+  const text = rawCode.replace(/&quot;/g, `"`)
+
+  const highlighted = highlightAndFormatCode(text, language, hljs, showLineNumber)
+
+  codeBlock.innerHTML = highlighted
+  codeBlock.removeAttribute(`data-language-pending`)
+  codeBlock.removeAttribute(`data-raw-code`)
+  codeBlock.removeAttribute(`data-show-line-number`)
+}
+
+/**
+ * 高亮 DOM 中待处理的代码块
+ * 查找带有 data-language-pending 属性的代码块，动态加载语言后重新高亮
+ * @param hljs highlight.js 实例
+ * @param container 容器元素（可选，默认为 document）
+ */
+export function highlightPendingBlocks(hljs: any, container: Document | Element = document): void {
+  const pendingBlocks = container.querySelectorAll(`code[data-language-pending]`)
+
+  pendingBlocks.forEach((codeBlock) => {
+    const language = codeBlock.getAttribute(`data-language-pending`)
+    if (!language)
+      return
+
+    if (hljs.getLanguage(language)) {
+      // 语言已加载，直接高亮
+      highlightCodeBlock(codeBlock, language, hljs)
+    }
+    else {
+      // 动态加载语言后重新高亮
+      loadAndRegisterLanguage(language, hljs).then(() => {
+        highlightCodeBlock(codeBlock, language, hljs)
+      }).catch(() => {
+        // 加载失败，移除标记
+        codeBlock.removeAttribute(`data-language-pending`)
+        codeBlock.removeAttribute(`data-raw-code`)
+        codeBlock.removeAttribute(`data-show-line-number`)
+      })
+    }
+  })
+}

skills/baoyu-post-to-wechat/SKILL.md

@@ -1,10 +1,14 @@
 ---
 name: baoyu-post-to-wechat
-description: Posts content to WeChat Official Account (微信公众号) via Chrome CDP automation. Supports article posting (文章) with full markdown formatting and image-text posting (图文) with multiple images. Use when user mentions "发布公众号", "post to wechat", "微信公众号", or "图文/文章".
+description: Posts content to WeChat Official Account (微信公众号) via API or Chrome CDP. Supports article posting (文章) with HTML, markdown, or plain text input, and image-text posting (图文) with multiple images. Use when user mentions "发布公众号", "post to wechat", "微信公众号", or "图文/文章".
 ---
 
 # Post to WeChat Official Account
 
+## Language
+
+**Match user's language**: Respond in the same language the user uses. If user writes in Chinese, respond in Chinese. If user writes in English, respond in English.
+
 ## Script Directory
 
 **Agent Execution**: Determine this SKILL.md directory as `SKILL_DIR`, then use `${SKILL_DIR}/scripts/<name>.ts`.
@@ -12,8 +16,8 @@ description: Posts content to WeChat Official Account (微信公众号) via Chro
 | Script | Purpose |
 |--------|---------|
 | `scripts/wechat-browser.ts` | Image-text posts (图文) |
-| `scripts/wechat-article.ts` | Article posting (文章) |
-| `scripts/md-to-wechat.ts` | Markdown → WeChat HTML |
+| `scripts/wechat-article.ts` | Article posting via browser (文章) |
+| `scripts/wechat-api.ts` | Article posting via API (文章) |
 
 ## Preferences (EXTEND.md)
 
@@ -43,21 +47,229 @@ test -f "$HOME/.baoyu-skills/baoyu-post-to-wechat/EXTEND.md" && echo "user"
 │ Not found │ Use defaults                                                              │
 └───────────┴───────────────────────────────────────────────────────────────────────────┘
 
-**EXTEND.md Supports**: Default theme | Auto-submit preference | Chrome profile path
+**EXTEND.md Supports**: Default theme | Default publishing method (api/browser) | Default author | Chrome profile path
 
-## Usage
+## Image-Text Posting (图文)
 
-### Image-Text (图文)
+For short posts with multiple images (up to 9):
 
 ```bash
 npx -y bun ${SKILL_DIR}/scripts/wechat-browser.ts --markdown article.md --images ./images/
 npx -y bun ${SKILL_DIR}/scripts/wechat-browser.ts --title "标题" --content "内容" --image img.png --submit
 ```
 
-### Article (文章)
+See [references/image-text-posting.md](references/image-text-posting.md) for details.
+
+## Article Posting Workflow (文章)
+
+Copy this checklist and check off items as you complete them:
+
+```
+Publishing Progress:
+- [ ] Step 0: Load preferences (EXTEND.md)
+- [ ] Step 1: Determine input type
+- [ ] Step 2: Check markdown-to-html skill
+- [ ] Step 3: Convert to HTML
+- [ ] Step 4: Validate metadata (title, summary)
+- [ ] Step 5: Select method and configure credentials
+- [ ] Step 6: Publish to WeChat
+- [ ] Step 7: Report completion
+```
+
+### Step 0: Load Preferences
+
+Check and load EXTEND.md settings (see Preferences section above).
+
+### Step 1: Determine Input Type
+
+| Input Type | Detection | Action |
+|------------|-----------|--------|
+| HTML file | Path ends with `.html`, file exists | Skip to Step 4 |
+| Markdown file | Path ends with `.md`, file exists | Continue to Step 2 |
+| Plain text | Not a file path, or file doesn't exist | Save to markdown, then Step 2 |
+
+**Plain Text Handling**:
+
+1. Generate slug from content (first 2-4 meaningful words, kebab-case)
+2. Create directory and save file:
 
 ```bash
-npx -y bun ${SKILL_DIR}/scripts/wechat-article.ts --markdown article.md --theme grace
+mkdir -p "$(pwd)/post-to-wechat/$(date +%Y-%m-%d)"
+# Save content to: post-to-wechat/yyyy-MM-dd/[slug].md
+```
+
+3. Continue processing as markdown file
+
+**Slug Examples**:
+- "Understanding AI Models" → `understanding-ai-models`
+- "人工智能的未来" → `ai-future` (translate to English for slug)
+
+### Step 2: Check Markdown-to-HTML Skill
+
+**Skip if**: Input is `.html` file
+
+**Skill Discovery**:
+
+```bash
+# Check if baoyu-markdown-to-html exists
+test -f skills/baoyu-markdown-to-html/SKILL.md && echo "found"
+```
+
+| Result | Action |
+|--------|--------|
+| Found | Read its SKILL.md, continue to Step 3 |
+| Multiple skills | AskUserQuestion to choose |
+| Not found | Show installation suggestion |
+
+**When Not Found**:
+
+```
+No markdown-to-html skill found.
+
+Suggested installation:
+https://github.com/JimLiu/baoyu-skills/blob/main/skills/baoyu-markdown-to-html/SKILL.md
+
+Options:
+A) Cancel - install the skill first
+B) Continue - provide HTML file manually
+```
+
+### Step 3: Convert Markdown to HTML
+
+**Skip if**: Input is `.html` file
+
+1. **Ask theme preference** (unless specified in EXTEND.md or CLI):
+
+| Theme | Description |
+|-------|-------------|
+| `default` | 经典主题 - 传统排版，标题居中带底边，二级标题白字彩底 |
+| `grace` | 优雅主题 - 文字阴影，圆角卡片，精致引用块 |
+| `simple` | 简洁主题 - 现代极简风，不对称圆角，清爽留白 |
+
+2. **Execute conversion** (using the discovered skill):
+
+```bash
+npx -y bun ${MD_TO_HTML_SKILL_DIR}/scripts/main.ts <markdown_file> --theme <theme>
+```
+
+3. **Parse JSON output** to get: `htmlPath`, `title`, `author`, `summary`, `contentImages`
+
+### Step 4: Validate Metadata
+
+Check extracted metadata from Step 3 (or HTML meta tags if direct HTML input).
+
+| Field | If Missing |
+|-------|------------|
+| Title | Prompt: "Enter title, or press Enter to auto-generate from content" |
+| Summary | Prompt: "Enter summary, or press Enter to auto-generate (recommended for SEO)" |
+
+**Auto-Generation Logic**:
+- **Title**: First H1/H2 heading, or first sentence
+- **Summary**: First paragraph, truncated to 120 characters
+
+### Step 5: Select Publishing Method and Configure
+
+**Ask publishing method** (unless specified in EXTEND.md or CLI):
+
+| Method | Speed | Requirements |
+|--------|-------|--------------|
+| `api` (Recommended) | Fast | API credentials |
+| `browser` | Slow | Chrome, login session |
+
+**If API Selected - Check Credentials**:
+
+```bash
+# Check project-level
+test -f .baoyu-skills/.env && grep -q "WECHAT_APP_ID" .baoyu-skills/.env && echo "project"
+
+# Check user-level
+test -f "$HOME/.baoyu-skills/.env" && grep -q "WECHAT_APP_ID" "$HOME/.baoyu-skills/.env" && echo "user"
+```
+
+**If Credentials Missing - Guide Setup**:
+
+```
+WeChat API credentials not found.
+
+To obtain credentials:
+1. Visit https://mp.weixin.qq.com
+2. Go to: 开发 → 基本配置
+3. Copy AppID and AppSecret
+
+Where to save?
+A) Project-level: .baoyu-skills/.env (this project only)
+B) User-level: ~/.baoyu-skills/.env (all projects)
+```
+
+After location choice, prompt for values and write to `.env`:
+
+```
+WECHAT_APP_ID=<user_input>
+WECHAT_APP_SECRET=<user_input>
+```
+
+### Step 6: Publish to WeChat
+
+**API method**:
+
+```bash
+npx -y bun ${SKILL_DIR}/scripts/wechat-api.ts <html_file> [--title <title>] [--summary <summary>]
+```
+
+**Browser method**:
+
+```bash
+npx -y bun ${SKILL_DIR}/scripts/wechat-article.ts --html <html_file>
+```
+
+### Step 7: Completion Report
+
+**For API method**, include draft management link:
+
+```
+WeChat Publishing Complete!
+
+Input: [type] - [path]
+Method: API
+Theme: [theme name]
+
+Article:
+• Title: [title]
+• Summary: [summary]
+• Images: [N] inline images
+
+Result:
+✓ Draft saved to WeChat Official Account
+• media_id: [media_id]
+
+Next Steps:
+→ Manage drafts: https://mp.weixin.qq.com (登录后进入「内容管理」→「草稿箱」)
+
+Files created:
+[• post-to-wechat/yyyy-MM-dd/slug.md (if plain text)]
+[• slug.html (converted)]
+```
+
+**For Browser method**:
+
+```
+WeChat Publishing Complete!
+
+Input: [type] - [path]
+Method: Browser
+Theme: [theme name]
+
+Article:
+• Title: [title]
+• Summary: [summary]
+• Images: [N] inline images
+
+Result:
+✓ Draft saved to WeChat Official Account
+
+Files created:
+[• post-to-wechat/yyyy-MM-dd/slug.md (if plain text)]
+[• slug.html (converted)]
 ```
 
 ## Detailed References
@@ -69,24 +281,47 @@ npx -y bun ${SKILL_DIR}/scripts/wechat-article.ts --markdown article.md --theme
 
 ## Feature Comparison
 
-| Feature | Image-Text | Article |
-|---------|------------|---------|
-| Multiple images | ✓ (up to 9) | ✓ (inline) |
-| Markdown support | Title/content extraction | Full formatting |
-| Auto compression | ✓ (title: 20, content: 1000 chars) | ✗ |
-| Themes | ✗ | ✓ (default, grace, simple) |
+| Feature | Image-Text | Article (API) | Article (Browser) |
+|---------|------------|---------------|-------------------|
+| Plain text input | ✗ | ✓ | ✓ |
+| HTML input | ✗ | ✓ | ✓ |
+| Markdown input | Title/content | ✓ (via skill) | ✓ (via skill) |
+| Multiple images | ✓ (up to 9) | ✓ (inline) | ✓ (inline) |
+| Themes | ✗ | ✓ | ✓ |
+| Auto-generate metadata | ✗ | ✓ | ✓ |
+| Requires Chrome | ✓ | ✗ | ✓ |
+| Requires API credentials | ✗ | ✓ | ✗ |
+| Speed | Medium | Fast | Slow |
 
 ## Prerequisites
 
+**For API method**:
+- WeChat Official Account API credentials
+- Guided setup in Step 5, or manually set in `.baoyu-skills/.env`
+
+**For Browser method**:
 - Google Chrome
 - First run: log in to WeChat Official Account (session preserved)
 
+**For Markdown conversion**:
+- A markdown-to-html skill (e.g., `baoyu-markdown-to-html`)
+- If not installed, the workflow will suggest installation
+
+**Config File Locations** (priority order):
+1. Environment variables
+2. `<cwd>/.baoyu-skills/.env`
+3. `~/.baoyu-skills/.env`
+
 ## Troubleshooting
 
 | Issue | Solution |
 |-------|----------|
-| Not logged in | First run opens browser - scan QR to log in |
+| No markdown-to-html skill | Install `baoyu-markdown-to-html` from suggested URL |
+| Missing API credentials | Follow guided setup in Step 5 |
+| Access token error | Check if API credentials are valid and not expired |
+| Not logged in (browser) | First run opens browser - scan QR to log in |
 | Chrome not found | Set `WECHAT_BROWSER_CHROME_PATH` env var |
+| Title/summary missing | Use auto-generation or provide manually |
 | Paste fails | Check system clipboard permissions |
 
 ## Extension Support

skills/baoyu-post-to-wechat/references/article-posting.md

@@ -53,7 +53,7 @@ Regular paragraph with **bold** and *italic*.
 
 ## Image Handling
 
-1. **Parse**: Images in markdown are replaced with `[[IMAGE_PLACEHOLDER_N]]`
+1. **Parse**: Images in markdown are replaced with `WECHATIMGPH_N`
 2. **Render**: HTML is generated with placeholders in text
 3. **Paste**: HTML content is pasted into WeChat editor
 4. **Replace**: For each placeholder:
@@ -81,7 +81,7 @@ Claude:
 3. Opens Chrome, navigates to WeChat editor
 4. Pastes HTML content
 5. For each image:
-   - Selects [[IMAGE_PLACEHOLDER_1]]
+   - Selects WECHATIMGPH_1
    - Scrolls into view
    - Presses Backspace to delete
    - Pastes image

skills/baoyu-post-to-wechat/scripts/cdp.ts

@@ -171,6 +171,37 @@ export interface ChromeSession {
   targetId: string;
 }
 
+export async function tryConnectExisting(port: number): Promise<CdpConnection | null> {
+  try {
+    const version = await fetchJson<{ webSocketDebuggerUrl?: string }>(`http://127.0.0.1:${port}/json/version`);
+    if (version.webSocketDebuggerUrl) {
+      const cdp = await CdpConnection.connect(version.webSocketDebuggerUrl, 5_000);
+      return cdp;
+    }
+  } catch {}
+  return null;
+}
+
+export async function findExistingChromeDebugPort(): Promise<number | null> {
+  if (process.platform !== 'darwin' && process.platform !== 'linux') return null;
+  try {
+    const { execSync } = await import('node:child_process');
+    const cmd = process.platform === 'darwin'
+      ? `lsof -nP -iTCP -sTCP:LISTEN 2>/dev/null | grep -i 'google\\|chrome' | awk '{print $9}' | sed 's/.*://'`
+      : `ss -tlnp 2>/dev/null | grep -i chrome | awk '{print $4}' | sed 's/.*://'`;
+    const output = execSync(cmd, { encoding: 'utf-8', timeout: 5_000 }).trim();
+    if (!output) return null;
+    const ports = output.split('\n').map(p => parseInt(p, 10)).filter(p => !isNaN(p) && p > 0);
+    for (const port of ports) {
+      try {
+        const version = await fetchJson<{ webSocketDebuggerUrl?: string }>(`http://127.0.0.1:${port}/json/version`);
+        if (version.webSocketDebuggerUrl) return port;
+      } catch {}
+    }
+  } catch {}
+  return null;
+}
+
 export async function launchChrome(url: string, profileDir?: string): Promise<{ cdp: CdpConnection; chrome: ReturnType<typeof spawn> }> {
   const chromePath = findChromeExecutable();
   if (!chromePath) throw new Error('Chrome not found. Set WECHAT_BROWSER_CHROME_PATH env var.');