chore: release v1.61.0

feat(baoyu-post-to-wechat): add multi-account support
Support multiple WeChat Official Accounts via EXTEND.md accounts block. Each account gets isolated Chrome profile, credential resolution chain (inline → prefixed env → unprefixed env), and --account CLI arg.
2026-07-12 22:09:48 +08:00 · 2026-03-11 23:24:43 -05:00 · 2026-03-11 23:24:02 -05:00 · 2026-03-11 22:55:47 -05:00 · 2026-03-11 22:46:06 -05:00 · 2026-03-11 22:22:03 -05:00
125 changed files with 9890 additions and 2849 deletions
@@ -6,7 +6,7 @@
  },
  "metadata": {
    "description": "Skills shared by Baoyu for improving daily work efficiency",
-    "version": "1.52.0"
+    "version": "1.61.0"
  },
  "plugins": [
    {
@@ -35,6 +35,7 @@ Just run `/release-skills` - auto-detects your project configuration.
 ### Step 1: Detect Project Configuration

 1. Check for `.releaserc.yml` (optional config override)
+   - If present, inspect whether it defines release hooks
 2. Auto-detect version file by scanning (priority order):
   - `package.json` (Node.js)
   - `pyproject.toml` (Python)
@@ -48,6 +49,34 @@ Just run `/release-skills` - auto-detects your project configuration.
 4. Identify language of each changelog by filename suffix
 5. Display detected configuration

+**Project Hook Contract**:
+
+If `.releaserc.yml` defines `release.hooks`, keep the release workflow generic and delegate project-specific packaging/publishing to those hooks.
+
+Supported hooks:
+
+| Hook | Purpose | Expected Responsibility |
+|------|---------|-------------------------|
+| `prepare_artifact` | Make one target releasable | Validate the target is self-contained, sync/embed local dependencies, optionally stage extra files |
+| `publish_artifact` | Publish one releasable target | Upload the prepared target (or a staged directory if the project uses one), attach version/changelog/tags |
+
+Supported placeholders:
+
+| Placeholder | Meaning |
+|-------------|---------|
+| `{project_root}` | Absolute path to repository root |
+| `{target}` | Absolute path to the module/skill being released |
+| `{artifact_dir}` | Absolute path to a temporary staging directory for this target, when the project uses one |
+| `{version}` | Version selected by the release workflow |
+| `{dry_run}` | `true` or `false` |
+| `{release_notes_file}` | Absolute path to a UTF-8 file containing release notes/changelog text |
+
+Execution rules:
+- Keep the skill generic: do not hardcode registry/package-manager/project layout details into this SKILL.
+- If `prepare_artifact` exists, run it once per target before publish-related checks that need the final releasable target state.
+- Write release notes to a temp file and pass that file path to `publish_artifact`; do not inline multiline changelog text into shell commands.
+- If hooks are absent, fall back to the default project-agnostic release workflow.
+
 **Language Detection Rules**:

 Changelog files follow the pattern `CHANGELOG_{LANG}.md` or `CHANGELOG.{lang}.md`, where `{lang}` / `{LANG}` is a language or region code.
@@ -0,0 +1,7 @@
+#!/bin/sh
+set -eu
+
+REPO_ROOT=$(git rev-parse --show-toplevel)
+cd "$REPO_ROOT"
+
+node scripts/sync-shared-skill-packages.mjs --repo-root "$REPO_ROOT" --enforce-clean
@@ -161,3 +161,8 @@ posts/
 *.ipr

 .claude/skills/baoyu-skill-evolution
+# ClawHub local state (current and legacy directory names from the official CLI)
+.clawhub/
+.clawdhub/
+.release-artifacts/
+.worktrees/
@@ -0,0 +1,6 @@
+release:
+  target_globs:
+    - skills/*
+  hooks:
+    prepare_artifact: node scripts/sync-shared-skill-packages.mjs --repo-root "{project_root}" --target "{target}"
+    publish_artifact: node scripts/publish-skill.mjs --skill-dir "{target}" --version "{version}" --changelog-file "{release_notes_file}" --dry-run "{dry_run}"
@@ -2,6 +2,126 @@

 English | [中文](./CHANGELOG.zh.md)

+## 1.61.0 - 2026-03-11
+
+### Features
+- `baoyu-post-to-wechat`: add multi-account support with `--account` CLI arg, EXTEND.md accounts block, isolated Chrome profiles, and credential resolution chain
+
+### Fixes
+- Exclude `out/dist/build` dirs and `bun.lockb` from skill release files
+- Use proper MIME types in skill publish to fix ClawhHub rejection
+
+## 1.60.0 - 2026-03-11
+
+### Features
+- `baoyu-url-to-markdown`: support reusing existing Chrome CDP instances and fix port detection order
+
+### Fixes
+- `baoyu-post-to-x`: add missing `fs` import in x-article
+
+### Refactor
+- Unify all CDP skills to use shared `baoyu-chrome-cdp` package with vendored copies
+- Simplify CLAUDE.md, move detailed documentation to `docs/` directory
+- Publish skills directly from synced vendor, removing separate artifact preparation step
+
+## 1.59.1 - 2026-03-11
+
+### Fixes
+- `baoyu-translate`: improve short text annotation density rule and add explicit style preset passing to 02-prompt.md
+- `baoyu-post-to-x`: remove `--disable-blink-features=AutomationControlled` Chrome flag
+
+### Refactor
+- `baoyu-post-to-weibo`: add entry point guard to md-to-html.ts for module import compatibility
+- Replace clawhub CLI with local sync-clawhub.mjs script
+
+### Documentation
+- Update CLAUDE.md to reflect v1.59.0 codebase state (by @jackL1020)
+
+## 1.59.0 - 2026-03-09
+
+### Features
+- `baoyu-image-gen`: add batch parallel image generation and provider-level throttling (by @SeamoonAO)
+
+### Fixes
+- `baoyu-image-gen`: restore Google as default provider when multiple keys available
+
+### Documentation
+- Improve skill documentation clarity (by @SeamoonAO)
+
+## 1.58.0 - 2026-03-08
+
+### Features
+- Add XDG config path support for EXTEND.md (by @liby)
+
+### Fixes
+- `baoyu-post-to-wechat`: surface agent-browser startup errors
+- `baoyu-post-to-wechat`: harden agent-browser command and eval handling (by @luojiyin1987)
+- `baoyu-image-gen`: use execFileSync for google curl requests (by @luojiyin1987)
+- `baoyu-format-markdown`: use spawnSync for autocorrect command (by @luojiyin1987)
+
+### Documentation
+- Fix CLAUDE dependency statement (by @luojiyin1987)
+- Add markdown-to-html to README utility skills (by @luojiyin1987)
+
+## 1.57.0 - 2026-03-08
+
+### Features
+- Add ClawHub/OpenClaw publishing support with sync script and README documentation
+
+### Refactor
+- Add openclaw metadata to all skill frontmatter for ClawHub registry compatibility
+- Rename `SKILL_DIR` to `baseDir` across all skills for consistency
+- `baoyu-danger-gemini-web`, `baoyu-danger-x-to-markdown`: dynamic script path in usage display
+- `baoyu-comic`, `baoyu-xhs-images`: use skill interface instead of direct script invocation for image generation
+
+## 1.56.1 - 2026-03-08
+
+### Fixes
+- `baoyu-post-to-weibo`: simplify article image insertion with Backspace-based placeholder deletion for ProseMirror compatibility
+
+## 1.56.0 - 2026-03-08
+
+### Features
+- `baoyu-article-illustrator`: preset-first selection flow with categorized style presets by content type
+- `baoyu-xhs-images`: streamline workflow from 6 to 4 steps with Smart Confirm (Quick/Customize/Detailed paths)
+
+### Fixes
+- `baoyu-post-to-wechat`: improve image upload reliability with file chooser interception and fallback
+
+## 1.55.0 - 2026-03-08
+
+### Features
+- `baoyu-article-illustrator`: add screen-print style and `--preset` flag for quick type + style selection
+- `baoyu-cover-image`: add screen-print rendering and duotone palette with 5 new style presets
+- `baoyu-xhs-images`: add screen-print style and `--preset` flag with 23 built-in presets
+
+### Documentation
+- Add credits section to both READMEs acknowledging open source inspirations
+
+## 1.54.1 - 2026-03-07
+
+### Fixes
+- `baoyu-post-to-x`: keep composed posts open in Chrome so users can review and publish manually
+
+### Documentation
+- `baoyu-post-to-x`: document default post type selection and manual publishing flow
+- `README`: add Star History charts to the English and Chinese READMEs
+
+## 1.54.0 - 2026-03-06
+
+### Features
+- `baoyu-format-markdown`: improve title and summary generation with style-differentiated candidates, prohibited patterns, and hook-first principles
+- `baoyu-markdown-to-html`: add `--cite` option to convert ordinary external links to numbered bottom citations
+- `baoyu-post-to-wechat`: enable bottom citations by default for markdown input, add `--no-cite` flag to disable
+- `baoyu-translate`: support external glossary files via `glossary_files` in EXTEND.md (markdown table or YAML)
+- `baoyu-translate`: add frontmatter transformation rules to rename source metadata fields with `source` prefix
+
+## 1.53.0 - 2026-03-06
+
+### Features
+- `baoyu-url-to-markdown`: save rendered HTML snapshot as `-captured.html` alongside markdown output
+- `baoyu-url-to-markdown`: Defuddle-first markdown conversion with automatic fallback to legacy Readability/selector extractor
+
 ## 1.52.0 - 2026-03-06

 ### Features
@@ -2,6 +2,126 @@

 [English](./CHANGELOG.md) | 中文

+## 1.61.0 - 2026-03-11
+
+### 新功能
+- `baoyu-post-to-wechat`：新增多账号支持，通过 `--account` 参数选择账号，EXTEND.md 支持 accounts 配置块，每个账号独立 Chrome 配置目录和凭证解析链
+
+### 修复
+- 排除 `out/dist/build` 目录和 `bun.lockb` 文件，避免打包到技能发布文件中
+- 修复技能发布时 MIME 类型不正确导致 ClawhHub 拒绝的问题
+
+## 1.60.0 - 2026-03-11
+
+### 新功能
+- `baoyu-url-to-markdown`：支持复用已有 Chrome CDP 实例，修复端口检测顺序问题
+
+### 修复
+- `baoyu-post-to-x`：补充 x-article 缺失的 `fs` 导入
+
+### 重构
+- 统一所有 CDP 技能使用共享 `baoyu-chrome-cdp` 包，各技能内置 vendor 副本
+- 精简 CLAUDE.md，将详细文档移至 `docs/` 目录
+- 从 synced vendor 直接发布技能，移除单独的 artifact 准备步骤
+
+## 1.59.1 - 2026-03-11
+
+### 修复
+- `baoyu-translate`：改进短文本注释密度规则，补充风格预设到 02-prompt.md 的显式传递
+- `baoyu-post-to-x`：移除 `--disable-blink-features=AutomationControlled` Chrome 启动参数
+
+### 重构
+- `baoyu-post-to-weibo`：为 md-to-html.ts 添加入口守卫，支持模块导入
+- 使用本地 sync-clawhub.mjs 脚本替代 clawhub CLI
+
+### 文档
+- 更新 CLAUDE.md 以反映 v1.59.0 代码库状态 (by @jackL1020)
+
+## 1.59.0 - 2026-03-09
+
+### 新功能
+- `baoyu-image-gen`：新增批量并行图片生成和提供商级别限流 (by @SeamoonAO)
+
+### 修复
+- `baoyu-image-gen`：修复多个 API key 可用时恢复 Google 为默认提供商
+
+### 文档
+- 改进技能文档清晰度 (by @SeamoonAO)
+
+## 1.58.0 - 2026-03-08
+
+### 新功能
+- 新增 EXTEND.md 的 XDG 配置路径支持 (by @liby)
+
+### 修复
+- `baoyu-post-to-wechat`：暴露 agent-browser 启动错误信息
+- `baoyu-post-to-wechat`：加固 agent-browser 命令和 eval 处理 (by @luojiyin1987)
+- `baoyu-image-gen`：使用 execFileSync 替代 shell 执行 Google curl 请求 (by @luojiyin1987)
+- `baoyu-format-markdown`：使用 spawnSync 替代 shell 执行 autocorrect 命令 (by @luojiyin1987)
+
+### 文档
+- 修正 CLAUDE 依赖说明 (by @luojiyin1987)
+- 将 markdown-to-html 添加到 README 工具技能列表 (by @luojiyin1987)
+
+## 1.57.0 - 2026-03-08
+
+### 新功能
+- 新增 ClawHub/OpenClaw 发布支持，包含同步脚本和 README 文档
+
+### 重构
+- 为所有 skill 前言添加 openclaw 元数据，兼容 ClawHub 注册表
+- 全部 skill 中将 `SKILL_DIR` 统一重命名为 `baseDir`
+- `baoyu-danger-gemini-web`、`baoyu-danger-x-to-markdown`：使用动态脚本路径显示用法
+- `baoyu-comic`、`baoyu-xhs-images`：通过 skill 接口调用图片生成，不再直接调用脚本
+
+## 1.56.1 - 2026-03-08
+
+### 修复
+- `baoyu-post-to-weibo`：简化头条文章图片插入逻辑，使用 Backspace 按键替代复杂的 deleteContents 方案，兼容 ProseMirror 编辑器
+
+## 1.56.0 - 2026-03-08
+
+### 新功能
+- `baoyu-article-illustrator`：预设优先选择流程，按内容类型分类的风格预设
+- `baoyu-xhs-images`：精简工作流从 6 步到 4 步，新增智能确认（快速/自定义/详细三种路径）
+
+### 修复
+- `baoyu-post-to-wechat`：通过文件选择器拦截改进图片上传可靠性
+
+## 1.55.0 - 2026-03-08
+
+### 新功能
+- `baoyu-article-illustrator`：新增 screen-print 风格和 `--preset` 快捷预设（如 tech-explainer、opinion-piece）
+- `baoyu-cover-image`：新增 screen-print 渲染风格和 duotone 调色板，包含 5 个新预设（poster-art、mondo 等）
+- `baoyu-xhs-images`：新增 screen-print 风格和 `--preset` 快捷预设，内置 23 个场景预设
+
+### 文档
+- 为中英文 README 新增致谢章节，致敬相关开源项目
+
+## 1.54.1 - 2026-03-07
+
+### 修复
+- `baoyu-post-to-x`：保持已填充的发帖窗口处于打开状态，方便用户手动检查并发布
+
+### 文档
+- `baoyu-post-to-x`：补充默认帖子类型选择规则和手动发布流程说明
+- `README`：为中英文 README 新增 Star History 图表
+
+## 1.54.0 - 2026-03-06
+
+### 新功能
+- `baoyu-format-markdown`：优化标题和摘要生成，支持多风格候选（颠覆型、方案型、悬念型、数字型），新增禁用模式和钩子优先原则
+- `baoyu-markdown-to-html`：新增 `--cite` 选项，将普通外链转换为底部编号引用
+- `baoyu-post-to-wechat`：Markdown 输入默认启用底部引用，新增 `--no-cite` 标志可关闭
+- `baoyu-translate`：EXTEND.md 支持 `glossary_files` 加载外部术语表文件（Markdown 表格或 YAML 格式）
+- `baoyu-translate`：新增 frontmatter 转换规则，翻译时将源文章元数据字段添加 `source` 前缀
+
+## 1.53.0 - 2026-03-06
+
+### 新功能
+- `baoyu-url-to-markdown`：将渲染后的 HTML 快照保存为 `-captured.html`，与 Markdown 文件并列输出
+- `baoyu-url-to-markdown`：优先使用 Defuddle 转换，失败时自动回退到旧版 Readability/选择器提取器
+
 ## 1.52.0 - 2026-03-06

 ### 新功能
@@ -1,527 +1,76 @@
 # CLAUDE.md

-This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
-
-## Project Overview
-
-Claude Code marketplace plugin providing AI-powered content generation skills. Skills use Gemini Web API (reverse-engineered) for text/image generation and Chrome CDP for browser automation.
+Claude Code marketplace plugin providing AI-powered content generation skills. Version: **1.61.0**.

 ## Architecture

-Skills are organized into three plugin categories in `marketplace.json`:
+Skills organized into three categories in `.claude-plugin/marketplace.json` (defines plugin metadata, version, and skill paths):

-```
-skills/
-├── [content-skills]           # Content generation and publishing
-│   ├── baoyu-xhs-images/          # Xiaohongshu infographic series (1-10 images)
-│   ├── baoyu-cover-image/         # Article cover images (2.35:1 aspect)
-│   ├── baoyu-slide-deck/          # Presentation slides with outlines
-│   ├── baoyu-article-illustrator/ # Smart illustration placement
-│   ├── baoyu-comic/               # Knowledge comics (Logicomix/Ohmsha style)
-│   ├── baoyu-post-to-x/           # X/Twitter posting automation
-│   └── baoyu-post-to-wechat/      # WeChat Official Account posting
-│
-├── [ai-generation-skills]     # AI-powered generation backends
-│   └── baoyu-danger-gemini-web/   # Gemini API wrapper (text + image gen)
-│
-└── [utility-skills]           # Utility tools for content processing
-    ├── baoyu-danger-x-to-markdown/ # X/Twitter content to markdown
-    └── baoyu-compress-image/      # Image compression
-```
-
-**Plugin Categories**:
 | Category | Description |
 |----------|-------------|
-| `content-skills` | Skills that generate or publish content (images, slides, comics, posts) |
-| `ai-generation-skills` | Backend skills providing AI generation capabilities |
-| `utility-skills` | Helper tools for content processing (conversion, compression) |
+| `content-skills` | Generate or publish content (images, slides, comics, posts) |
+| `ai-generation-skills` | AI generation backends |
+| `utility-skills` | Content processing (conversion, compression, translation) |

-Each skill contains:
- `SKILL.md` - YAML front matter (name, description) + documentation
- `scripts/` - TypeScript implementations
- `prompts/system.md` - AI generation guidelines (optional)
+Each skill contains `SKILL.md` (YAML front matter + docs), optional `scripts/`, `references/`, `prompts/`.
+
+Top-level `scripts/` contains repo maintenance utilities (sync, hooks, publish).

 ## Running Skills

-All scripts are TypeScript, executed via Bun runtime (no build step).
-
-### Runtime Detection (`${BUN_X}`)
-
-Before running any script, the agent MUST detect the runtime **once per session** and set `${BUN_X}`:
-
+TypeScript via Bun (no build step). Detect runtime once per session:
 ```bash
-# Detect runtime (run once, reuse result)
-if command -v bun &>/dev/null; then
-  BUN_X="bun"
-elif command -v npx &>/dev/null; then
-  BUN_X="npx -y bun"
-else
-  echo "Error: Neither bun nor npx found. Install bun: brew install oven-sh/bun/bun (macOS) or npm install -g bun"
-  exit 1
-fi
+if command -v bun &>/dev/null; then BUN_X="bun"
+elif command -v npx &>/dev/null; then BUN_X="npx -y bun"
+else echo "Error: install bun: brew install oven-sh/bun/bun or npm install -g bun"; exit 1; fi
 ```

-| Priority | Condition | `${BUN_X}` value | Notes |
-|----------|-----------|-------------------|-------|
-| 1 | `bun` installed | `bun` | Fastest, native execution |
-| 2 | `npx` available | `npx -y bun` | Downloads bun on first run via npm |
-| 3 | Neither found | Error + install guide | `brew install oven-sh/bun/bun` (macOS) or `npm install -g bun` |
-
-### Script Execution
-
-```bash
-${BUN_X} skills/<skill>/scripts/main.ts [options]
-```
-
-Examples:
-```bash
-# Text generation
-${BUN_X} skills/baoyu-danger-gemini-web/scripts/main.ts "Hello"
-
-# Image generation
-${BUN_X} skills/baoyu-danger-gemini-web/scripts/main.ts --prompt "A cat" --image cat.png
-
-# From prompt files
-${BUN_X} skills/baoyu-danger-gemini-web/scripts/main.ts --promptfiles system.md content.md --image out.png
-```
+Execute: `${BUN_X} skills/<skill>/scripts/main.ts [options]`

 ## Key Dependencies

- **Bun**: TypeScript runtime (native `bun` preferred, fallback `npx -y bun`)
- **Chrome**: Required for `baoyu-danger-gemini-web` auth and `baoyu-post-to-x` automation
- **No npm packages**: Self-contained TypeScript, no external dependencies
+- **Bun**: TypeScript runtime (`bun` preferred, fallback `npx -y bun`)
+- **Chrome**: Required for CDP-based skills (gemini-web, post-to-x/wechat/weibo, url-to-markdown). All CDP skills share a single profile, override via `BAOYU_CHROME_PROFILE_DIR` env var. Platform paths: [docs/chrome-profile.md](docs/chrome-profile.md)
+- **Image generation APIs**: `baoyu-image-gen` requires API key (OpenAI, Google, DashScope, or Replicate) configured in EXTEND.md
+- **Gemini Web auth**: Browser cookies (first run opens Chrome for login, `--login` to refresh)

-## Chrome Profile (Unified)
+## Security

-All skills that use Chrome CDP share a **single** profile directory. Do NOT create per-skill profiles.
-
-| Platform | Default Path |
-|----------|-------------|
-| macOS | `~/Library/Application Support/baoyu-skills/chrome-profile` |
-| Linux | `$XDG_DATA_HOME/baoyu-skills/chrome-profile` (fallback `~/.local/share/baoyu-skills/chrome-profile`) |
-| Windows | `%APPDATA%/baoyu-skills/chrome-profile` |
-| WSL | Windows home `/.local/share/baoyu-skills/chrome-profile` |
-
-**Environment variable override**: `BAOYU_CHROME_PROFILE_DIR` (takes priority, all skills respect it).
-
-Each skill also accepts its own legacy env var as fallback (e.g., `X_BROWSER_PROFILE_DIR`), but new skills should only use `BAOYU_CHROME_PROFILE_DIR`.
-
-### Implementation Pattern
-
-When adding a new skill that needs Chrome CDP:
-
-```typescript
-function getDefaultProfileDir(): string {
-  const override = process.env.BAOYU_CHROME_PROFILE_DIR?.trim();
-  if (override) return path.resolve(override);
-  const base = process.platform === 'darwin'
-    ? path.join(os.homedir(), 'Library', 'Application Support')
-    : process.env.XDG_DATA_HOME || path.join(os.homedir(), '.local', 'share');
-  return path.join(base, 'baoyu-skills', 'chrome-profile');
-}
-```
-
-## Security Guidelines
-
-### No Piped Shell Installs
-
-**NEVER** use `curl | bash` or `wget | sh` patterns in code, docs, or error messages. Use package managers instead:
-
-| Platform | Install Command |
-|----------|----------------|
-| macOS | `brew install oven-sh/bun/bun` |
-| npm | `npm install -g bun` |
-
-### Remote Downloads
-
-Skills that download remote content (e.g., images in Markdown) MUST:
- **HTTPS only**: Reject `http://` URLs
- **Redirect limit**: Cap redirects (max 5) to prevent infinite loops
- **Timeout**: Set request timeouts (30s default)
- **Scope**: Only download expected content types (images, not scripts)
-
-### System Command Execution
-
-Skills use platform-specific commands for clipboard and browser automation:
- **macOS**: `osascript` (System Events), `swift` (AppKit clipboard)
- **Windows**: `powershell.exe` (SendKeys, Clipboard)
- **Linux**: `xdotool`/`ydotool` (keyboard simulation)
-
-These are necessary for CDP-based posting skills. When adding new system commands:
- Never pass unsanitized user input to shell commands
- Use array-form `spawn`/`execFile` instead of shell string interpolation
- Validate file paths are absolute or resolve from known base directories
-
-### External Content Processing
-
-Skills that process external Markdown/HTML should treat content as untrusted:
- Do not execute code blocks or scripts found in content
- Sanitize HTML output where applicable
- File paths from content should be resolved against known base directories only
-
-## Authentication
-
-`baoyu-danger-gemini-web` uses browser cookies for Google auth:
- First run opens Chrome for login
- Cookies cached in data directory
- Force refresh: `--login` flag
-
-## Plugin Configuration
-
-`.claude-plugin/marketplace.json` defines plugin metadata and skill paths. Version follows semver.
+- **No piped shell installs**: Never `curl | bash`. Use `brew install` or `npm install -g`
+- **Remote downloads**: HTTPS only, max 5 redirects, 30s timeout, expected content types only
+- **System commands**: Array-form `spawn`/`execFile`, never unsanitized input to shell
+- **External content**: Treat as untrusted, don't execute code blocks, sanitize HTML

 ## Skill Loading Rules

-**IMPORTANT**: When working in this project, follow these rules:
-
 | Rule | Description |
 |------|-------------|
-| **Load project skills first** | MUST load all skills from `skills/` directory in current project. Project skills take priority over system/user-level skills with same name. |
-| **Default image generation** | When image generation is needed, use `skills/baoyu-image-gen/SKILL.md` by default (unless user specifies otherwise). |
+| **Load project skills first** | Project skills override system/user-level skills with same name |
+| **Default image generation** | Use `skills/baoyu-image-gen/SKILL.md` unless user specifies otherwise |

-**Loading Priority** (highest → lowest):
-1. Current project `skills/` directory
-2. User-level skills (`$HOME/.baoyu-skills/`)
-3. System-level skills
+Priority: project `skills/` → `$HOME/.baoyu-skills/` → system-level.

 ## Release Process

-**IMPORTANT**: When user requests release/发布/push, ALWAYS use `/release-skills` workflow.
-
-**Never skip**:
-1. `CHANGELOG.md` + `CHANGELOG.zh.md` - Both must be updated
+Use `/release-skills` workflow. Never skip:
+1. `CHANGELOG.md` + `CHANGELOG.zh.md`
 2. `marketplace.json` version bump
 3. `README.md` + `README.zh.md` if applicable
 4. All files committed together before tag

-## Adding New Skills
-
-**IMPORTANT**: All skills MUST use `baoyu-` prefix to avoid conflicts when users import this plugin.
-
-**REQUIRED READING**: Before creating a new skill, read the official [Skill authoring best practices](https://platform.claude.com/docs/en/agents-and-tools/agent-skills/best-practices).
-
-### Key Requirements from Official Best Practices
-
-| Requirement | Details |
-|-------------|---------|
-| **Concise is key** | Claude is smart—only add context it doesn't have. Challenge each token. |
-| **name field** | Max 64 chars, lowercase letters/numbers/hyphens only, no "anthropic"/"claude" |
-| **description field** | Max 1024 chars, non-empty, MUST be third person, include what + when to use |
-| **SKILL.md body** | Keep under 500 lines; use separate files for additional content |
-| **Naming convention** | Gerund form preferred (e.g., `processing-pdfs`), but `baoyu-` prefix required here |
-| **References** | Keep one level deep from SKILL.md; avoid nested references |
-| **No time-sensitive info** | Avoid dates/versions that become outdated |
-
-### Steps
-
-1. Create `skills/baoyu-<name>/SKILL.md` with YAML front matter
-   - Directory name: `baoyu-<name>`
-   - SKILL.md `name` field: `baoyu-<name>`
-2. Add TypeScript in `skills/baoyu-<name>/scripts/`
-3. Add prompt templates in `skills/baoyu-<name>/prompts/` if needed
-4. **Choose the appropriate category** and register in `marketplace.json`:
-   - `content-skills`: For content generation/publishing (images, slides, posts)
-   - `ai-generation-skills`: For AI backend capabilities
-   - `utility-skills`: For helper tools (conversion, compression)
-   - If none fit, create a new category with descriptive name
-5. **Add Script Directory section** to SKILL.md (see template below)
-
-### Choosing a Category
-
-| If your skill... | Use category |
-|------------------|--------------|
-| Generates visual content (images, slides, comics) | `content-skills` |
-| Publishes to platforms (X, WeChat, etc.) | `content-skills` |
-| Provides AI generation backend | `ai-generation-skills` |
-| Converts or processes content | `utility-skills` |
-| Compresses or optimizes files | `utility-skills` |
-
-**Creating a new category**: If the skill doesn't fit existing categories, add a new plugin object to `marketplace.json` with:
- `name`: Descriptive kebab-case name (e.g., `analytics-skills`)
- `description`: Brief description of the category
- `skills`: Array with the skill path
-
-### Writing Effective Descriptions
-
-**MUST write in third person** (not "I can help you" or "You can use this"):
-
-```yaml
-# Good
-description: Generates Xiaohongshu infographic series from content. Use when user asks for "小红书图片", "XHS images", or "RedNote infographics".
-
-# Bad
-description: I can help you create Xiaohongshu images
-description: You can use this to generate XHS content
-```
-
-Include both **what** the skill does and **when** to use it (triggers/keywords).
-
-### Script Directory Template
-
-Every SKILL.md with scripts MUST include this section after Usage:
-
-```markdown
-## Script Directory
-
-**Important**: All scripts are located in the `scripts/` subdirectory of this skill.
-
-**Agent Execution Instructions**:
-1. Determine this SKILL.md file's directory path as `SKILL_DIR`
-2. Script path = `${SKILL_DIR}/scripts/<script-name>.ts`
-3. Resolve `${BUN_X}` runtime: if `bun` installed → `bun`; if `npx` available → `npx -y bun`; else suggest installing bun
-4. Replace all `${SKILL_DIR}` and `${BUN_X}` in this document with actual values
-
-**Script Reference**:
-| Script | Purpose |
-|--------|---------|
-| `scripts/main.ts` | Main entry point |
-| `scripts/other.ts` | Other functionality |
-```
-
-When referencing scripts in workflow sections, use `${BUN_X} ${SKILL_DIR}/scripts/<name>.ts` so agents can resolve the correct runtime and path.
-
-### Progressive Disclosure
-
-For skills with extensive content, use separate reference files:
-
-```
-skills/baoyu-example/
-├── SKILL.md              # Main instructions (<500 lines)
-├── references/
-│   ├── styles.md         # Style definitions (loaded as needed)
-│   └── examples.md       # Usage examples (loaded as needed)
-└── scripts/
-    └── main.ts           # Executable script
-```
-
-In SKILL.md, link to reference files (one level deep only):
-```markdown
-**Available styles**: See [references/styles.md](references/styles.md)
-**Examples**: See [references/examples.md](references/examples.md)
-```
-
 ## Code Style

- TypeScript throughout, no comments
- Async/await patterns
- Short variable names
- Type-safe interfaces
+TypeScript, no comments, async/await, short variable names, type-safe interfaces.

-## Image Generation Guidelines
+## Adding New Skills

-Skills that require image generation MUST delegate to available image generation skills rather than implementing their own.
+All skills MUST use `baoyu-` prefix. Details: [docs/creating-skills.md](docs/creating-skills.md)

-### Image Generation Skill Selection
+## Reference Docs

-**Default**: Use `skills/baoyu-image-gen/SKILL.md` (unless user specifies otherwise).
-
-1. Read `skills/baoyu-image-gen/SKILL.md` for parameters and capabilities
-2. If user explicitly requests a different skill, check `skills/` directory for alternatives
-3. Only ask user to choose when they haven't specified and multiple viable options exist
-
-### Generation Flow Template
-
-Use this template when implementing image generation in skills:
-
-```markdown
-### Step N: Generate Images
-
-**Skill Selection**:
-1. Check available image generation skills (e.g., `baoyu-danger-gemini-web`)
-2. Read selected skill's SKILL.md for parameter reference
-3. If multiple skills available, ask user to choose
-
-**Generation Flow**:
-1. Call selected image generation skill with:
-   - Prompt file path (or inline prompt)
-   - Output image path
-   - Any skill-specific parameters (refer to skill's SKILL.md)
-2. Generate images sequentially (one at a time)
-3. After each image, output progress: "Generated X/N"
-4. On failure, auto-retry once before reporting error
-```
-
-### Output Path Convention
-
-Each session creates an independent directory. Even the same source file generates a new directory per session.
-
-**Output Directory**:
-```
-<skill-suffix>/<topic-slug>/
-```
- `<skill-suffix>`: Skill name suffix (e.g., `xhs-images`, `cover-image`, `slide-deck`, `comic`)
- `<topic-slug>`: Generated from content topic (2-4 words, kebab-case)
- Example: `xhs-images/ai-future-trends/`
-
-**Slug Generation**:
-1. Extract main topic from content (2-4 words, kebab-case)
-2. Example: "Introduction to Machine Learning" → `intro-machine-learning`
-
-**Conflict Resolution**:
-If `<skill-suffix>/<topic-slug>/` already exists:
- Append timestamp: `<topic-slug>-YYYYMMDD-HHMMSS`
- Example: `ai-future` exists → `ai-future-20260118-143052`
-
-**Source Files**:
- Copy all sources to `<skill-suffix>/<topic-slug>/` with naming: `source-{slug}.{ext}`
- Multiple sources supported: text, images, files from conversation
- Examples:
-  - `source-article.md` (main text content)
-  - `source-reference.png` (image from conversation)
-  - `source-data.csv` (additional file)
- Original source files remain unchanged
-
-### Image Naming Convention
-
-Image filenames MUST include meaningful slugs for readability:
-
-**Format**: `NN-{type}-[slug].png`
- `NN`: Two-digit sequence number (01, 02, ...)
- `{type}`: Image type (cover, content, page, slide, illustration, etc.)
- `[slug]`: Descriptive kebab-case slug derived from content
-
-**Examples**:
-```
-01-cover-ai-future.png
-02-content-key-benefits.png
-03-page-enigma-machine.png
-04-slide-architecture-overview.png
-```
-
-**Slug Rules**:
- Derived from image purpose or content (kebab-case)
- Must be unique within the output directory
- 2-5 words, concise but descriptive
- When content changes significantly, update slug accordingly
-
-### Best Practices
-
- Always read the image generation skill's SKILL.md before calling
- Pass parameters exactly as documented in the skill
- Handle failures gracefully with retry logic
- Provide clear progress feedback to user
-
-## Style Maintenance (baoyu-comic)
-
-When adding, updating, or deleting styles for `baoyu-comic`, follow this workflow:
-
-### Adding a New Style
-
-1. **Create style definition**: `skills/baoyu-comic/references/styles/<style-name>.md`
-2. **Update SKILL.md**:
-   - Add style to `--style` options table
-   - Add auto-selection entry if applicable
-3. **Generate showcase image**:
-   ```bash
-   ${BUN_X} skills/baoyu-danger-gemini-web/scripts/main.ts \
-     --prompt "A single comic book page in <style-name> style showing [appropriate scene]. Features: [style characteristics from style definition]. 3:4 portrait aspect ratio comic page." \
-     --image screenshots/comic-styles/<style-name>.png
-   ```
-4. **Compress to WebP**:
-   ```bash
-   ${BUN_X} skills/baoyu-compress-image/scripts/main.ts screenshots/comic-styles/<style-name>.png
-   ```
-5. **Update both READMEs** (`README.md` and `README.zh.md`):
-   - Add style to `--style` options
-   - Add row to style description table
-   - Add image to style preview grid
-
-### Updating an Existing Style
-
-1. **Update style definition**: `skills/baoyu-comic/references/styles/<style-name>.md`
-2. **Regenerate showcase image** (if visual characteristics changed):
-   - Follow steps 3-4 from "Adding a New Style"
-3. **Update READMEs** if description changed
-
-### Deleting a Style
-
-1. **Delete style definition**: `skills/baoyu-comic/references/styles/<style-name>.md`
-2. **Delete showcase image**: `screenshots/comic-styles/<style-name>.webp`
-3. **Update SKILL.md**:
-   - Remove from `--style` options
-   - Remove auto-selection entry
-4. **Update both READMEs**:
-   - Remove from `--style` options
-   - Remove from style description table
-   - Remove from style preview grid
-
-### Style Preview Grid Format
-
-READMEs use 3-column tables for style previews:
-
-```markdown
-| | | |
-|:---:|:---:|:---:|
-| ![style1](./screenshots/comic-styles/style1.webp) | ![style2](./screenshots/comic-styles/style2.webp) | ![style3](./screenshots/comic-styles/style3.webp) |
-| style1 | style2 | style3 |
-```
-
-## Extension Support
-
-Every SKILL.md MUST include two parts for extension support:
-
-### 1. Load Preferences Section (in Step 1 or as "Preferences" section)
-
-For skills with workflows, add as Step 1.1. For utility skills, add as "Preferences (EXTEND.md)" section before Usage:
-
-```markdown
-**1.1 Load Preferences (EXTEND.md)**
-
-Check EXTEND.md existence (priority order):
-
-\`\`\`bash
-# macOS, Linux, WSL, Git Bash
-test -f .baoyu-skills/<skill-name>/EXTEND.md && echo "project"
-test -f "$HOME/.baoyu-skills/<skill-name>/EXTEND.md" && echo "user"
-\`\`\`
-
-\`\`\`powershell
-# PowerShell (Windows)
-if (Test-Path .baoyu-skills/<skill-name>/EXTEND.md) { "project" }
-if (Test-Path "$HOME/.baoyu-skills/<skill-name>/EXTEND.md") { "user" }
-\`\`\`
-
-┌────────────────────────────────────────────┬───────────────────┐
-│                    Path                    │     Location      │
-├────────────────────────────────────────────┼───────────────────┤
-│ .baoyu-skills/<skill-name>/EXTEND.md       │ Project directory │
-├────────────────────────────────────────────┼───────────────────┤
-│ $HOME/.baoyu-skills/<skill-name>/EXTEND.md │ User home         │
-└────────────────────────────────────────────┴───────────────────┘
-
-┌───────────┬───────────────────────────────────────────────────────────────────────────┐
-│  Result   │                                  Action                                   │
-├───────────┼───────────────────────────────────────────────────────────────────────────┤
-│ Found     │ Read, parse, display summary                                              │
-├───────────┼───────────────────────────────────────────────────────────────────────────┤
-│ Not found │ Ask user with AskUserQuestion (see references/config/first-time-setup.md) │
-└───────────┴───────────────────────────────────────────────────────────────────────────┘
-
-**EXTEND.md Supports**: [List supported configuration options for this skill]
-
-Schema: `references/config/preferences-schema.md`
-```
-
-### 2. Extension Support Section (at the end)
-
-Simplified section that references the preferences section:
-
-```markdown
-## Extension Support
-
-Custom configurations via EXTEND.md. See **Step 1.1** for paths and supported options.
-```
-
-Or for utility skills without workflow steps:
-
-```markdown
-## Extension Support
-
-Custom configurations via EXTEND.md. See **Preferences** section for paths and supported options.
-```
-
-**Notes**:
- Replace `<skill-name>` with actual skill name (e.g., `baoyu-cover-image`)
- Use `$HOME` instead of `~` for cross-platform compatibility (macOS/Linux/WSL/PowerShell)
- Use `test -f` (Bash) or `Test-Path` (PowerShell) for explicit file existence check
- ASCII tables for clear visual formatting
+| Topic | File |
+|-------|------|
+| Image generation guidelines | [docs/image-generation.md](docs/image-generation.md) |
+| Chrome profile platform paths | [docs/chrome-profile.md](docs/chrome-profile.md) |
+| Comic style maintenance | [docs/comic-style-maintenance.md](docs/comic-style-maintenance.md) |
+| ClawHub/OpenClaw publishing | [docs/publishing.md](docs/publishing.md) |
@@ -17,6 +17,27 @@ Skills shared by Baoyu for improving daily work efficiency with Claude Code.
 npx skills add jimliu/baoyu-skills
 ```

+### Publish to ClawHub / OpenClaw
+
+This repository now supports publishing each `skills/baoyu-*` directory as an individual ClawHub skill.
+
+```bash
+# Preview what would be published
+./scripts/sync-clawhub.sh --dry-run
+
+# Publish all changed skills from ./skills
+./scripts/sync-clawhub.sh --all
+```
+
+ClawHub installs skills individually, not as one marketplace bundle. After publishing, users can install specific skills such as:
+
+```bash
+clawhub install baoyu-image-gen
+clawhub install baoyu-markdown-to-html
+```
+
+Publishing to ClawHub releases the published skill under `MIT-0`, per ClawHub's registry rules.
+
 ### Register as Plugin Marketplace

 Run the following command in Claude Code:
@@ -55,7 +76,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), [post-to-weibo](#baoyu-post-to-weibo) |
 | **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), [format-markdown](#baoyu-format-markdown), [translate](#baoyu-translate) |
+| **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), [markdown-to-html](#baoyu-markdown-to-html), [translate](#baoyu-translate) |

 ## Update Skills

@@ -504,6 +525,8 @@ Smart article illustration skill with Type × Style two-dimension approach. Anal

 Post content and articles to X (Twitter). Supports regular posts with images and X Articles (long-form Markdown). Uses real Chrome with CDP to bypass anti-automation.

+Plain text input is treated as a regular post. Markdown files are treated as X Articles. Scripts fill content into the browser, and the user reviews and publishes manually.
+
 ```bash
 # Post with text
 /baoyu-post-to-x "Hello from Claude Code!"
@@ -558,6 +581,47 @@ To obtain credentials:

 **Browser Method** (no API setup needed): Requires Google Chrome. First run opens browser for QR code login (session preserved).

+**Multi-Account Support**: Manage multiple WeChat Official Accounts via `EXTEND.md`:
+
+```bash
+mkdir -p .baoyu-skills/baoyu-post-to-wechat
+```
+
+Create `.baoyu-skills/baoyu-post-to-wechat/EXTEND.md`:
+
+```yaml
+# Global settings (shared across all accounts)
+default_theme: default
+default_color: blue
+
+# Account list
+accounts:
+  - name: My Tech Blog
+    alias: tech-blog
+    default: false
+    default_publish_method: api
+    default_author: Author Name
+    need_open_comment: 1
+    only_fans_can_comment: 0
+    app_id: wx1234567890abcdef
+    app_secret: your_app_secret_here
+  - name: AI Newsletter
+    alias: ai-news
+    default_publish_method: browser
+    default_author: AI Newsletter
+    need_open_comment: 1
+    only_fans_can_comment: 0
+```
+
+| Accounts configured | Behavior |
+|---------------------|----------|
+| No `accounts` block | Single-account mode (backward compatible) |
+| 1 account | Auto-select, no prompt |
+| 2+ accounts | Prompt to select, or use `--account <alias>` |
+| 1 account has `default: true` | Pre-selected as default |
+
+Each account gets an isolated Chrome profile for independent login sessions (browser method). API credentials can be set inline in EXTEND.md or via `.env` with alias-prefixed keys (e.g., `WECHAT_TECH_BLOG_APP_ID`).
+
 #### baoyu-post-to-weibo

 Post content to Weibo (微博). Supports regular posts with text, images, and videos, and headline articles (头条文章) with Markdown input. Uses real Chrome with CDP to bypass anti-automation.
@@ -677,7 +741,7 @@ Utility tools for content processing.

 #### baoyu-url-to-markdown

-Fetch any URL via Chrome CDP and convert to clean markdown. Supports two capture modes for different scenarios.
+Fetch any URL via Chrome CDP and convert to clean markdown. Saves rendered HTML snapshot alongside the markdown, and automatically falls back to a legacy extractor when Defuddle fails.

 ```bash
 # Auto mode (default) - capture when page loads
@@ -775,6 +839,21 @@ Format plain text or markdown files with proper frontmatter, titles, summaries,
 | Code/commands | `` `inline` `` or ` ```block``` ` |
 | Quotes | `>` blockquote |

+#### baoyu-markdown-to-html
+
+Convert markdown files into styled HTML with WeChat-compatible themes, syntax highlighting, and optional bottom citations for external links.
+
+```bash
+# Basic conversion
+/baoyu-markdown-to-html article.md
+
+# Theme + color
+/baoyu-markdown-to-html article.md --theme grace --color red
+
+# Convert ordinary external links to bottom citations
+/baoyu-markdown-to-html article.md --cite
+```
+
 #### baoyu-translate

 Translate articles and documents between languages with three modes: quick (direct), normal (analysis-informed), and refined (full publication-quality workflow with review and polish).
@@ -958,6 +1037,19 @@ This skill uses a reverse-engineered X (Twitter) API.
 - First use requires consent acknowledgment
 - Authentication via environment variables or Chrome login

+## Credits
+
+This project was inspired by and builds upon the following open source projects:
+
+- [x-article-publisher-skill](https://github.com/wshuyi/x-article-publisher-skill) by [@wshuyi](https://github.com/wshuyi) — Inspiration for the X article publishing skill
+- [doocs/md](https://github.com/doocs/md) by [@doocs](https://github.com/doocs) — Core implementation logic for Markdown to HTML conversion
+- [High-density Infographic Prompt](https://waytoagi.feishu.cn/wiki/YG0zwalijihRREkgmPzcWRInnUg) by AJ@WaytoAGI — Inspiration for the infographic skill
+- [qiaomu-mondo-poster-design](https://github.com/joeseesun/qiaomu-mondo-poster-design) by [@joeseesun](https://github.com/joeseesun)（乔木） — Inspiration for the Mondo style
+
 ## License

 MIT
+
+## Star History
+
+[![Star History Chart](https://api.star-history.com/svg?repos=JimLiu/baoyu-skills&type=Date)](https://www.star-history.com/#JimLiu/baoyu-skills&Date)
@@ -17,6 +17,27 @@
 npx skills add jimliu/baoyu-skills
 ```

+### 发布到 ClawHub / OpenClaw
+
+现在这个仓库支持把每个 `skills/baoyu-*` 目录作为独立 ClawHub skill 发布。
+
+```bash
+# 预览将要发布的变更
+./scripts/sync-clawhub.sh --dry-run
+
+# 发布 ./skills 下所有已变更的 skill
+./scripts/sync-clawhub.sh --all
+```
+
+ClawHub 按“单个 skill”安装，不是把整个 marketplace 一次性装进去。发布后，用户可以按需安装：
+
+```bash
+clawhub install baoyu-image-gen
+clawhub install baoyu-markdown-to-html
+```
+
+根据 ClawHub 的 registry 规则，发布到 ClawHub 的 skill 会以 `MIT-0` 许可分发。
+
 ### 注册插件市场

 在 Claude Code 中运行：
@@ -55,7 +76,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), [post-to-weibo](#baoyu-post-to-weibo) |
 | **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), [format-markdown](#baoyu-format-markdown), [translate](#baoyu-translate) |
+| **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), [markdown-to-html](#baoyu-markdown-to-html), [translate](#baoyu-translate) |

 ## 更新技能

@@ -504,6 +525,8 @@ npx skills add jimliu/baoyu-skills

 发布内容和文章到 X (Twitter)。支持带图片的普通帖子和 X 文章（长篇 Markdown）。使用真实 Chrome + CDP 绕过反自动化检测。

+纯文本输入默认按普通帖子处理，Markdown 文件默认按 X 文章处理。脚本会将内容填入浏览器，用户需手动检查并发布。
+
 ```bash
 # 发布文字
 /baoyu-post-to-x "Hello from Claude Code!"
@@ -558,6 +581,47 @@ WECHAT_APP_SECRET=你的AppSecret

 **浏览器方式**（无需 API 配置）：需已安装 Google Chrome，首次运行需扫码登录（登录状态会保存）

+**多账号支持**：通过 `EXTEND.md` 管理多个微信公众号：
+
+```bash
+mkdir -p .baoyu-skills/baoyu-post-to-wechat
+```
+
+创建 `.baoyu-skills/baoyu-post-to-wechat/EXTEND.md`：
+
+```yaml
+# 全局设置（所有账号共享）
+default_theme: default
+default_color: blue
+
+# 账号列表
+accounts:
+  - name: 宝玉的技术分享
+    alias: baoyu
+    default: false
+    default_publish_method: api
+    default_author: 宝玉
+    need_open_comment: 1
+    only_fans_can_comment: 0
+    app_id: wx1234567890abcdef
+    app_secret: 你的 AppSecret
+  - name: AI 工具集
+    alias: ai-tools
+    default_publish_method: browser
+    default_author: AI 工具集
+    need_open_comment: 1
+    only_fans_can_comment: 0
+```
+
+| 账号配置情况 | 行为 |
+|-------------|------|
+| 无 `accounts` 块 | 单账号模式（向后兼容） |
+| 1 个账号 | 自动选择，无需提示 |
+| 2+ 个账号 | 提示选择，或使用 `--account <别名>` |
+| 某账号设置 `default: true` | 预选为默认账号 |
+
+每个账号拥有独立的 Chrome 配置目录，保证浏览器方式下的登录会话互不干扰。API 凭证可在 EXTEND.md 中直接配置，也可通过 `.env` 文件使用别名前缀的环境变量（如 `WECHAT_BAOYU_APP_ID`）。
+
 #### baoyu-post-to-weibo

 发布内容到微博。支持文字、图片、视频发布和头条文章（长篇 Markdown）。使用真实 Chrome + CDP 绕过反自动化检测。
@@ -677,7 +741,7 @@ AI 驱动的生成后端。

 #### baoyu-url-to-markdown

-通过 Chrome CDP 抓取任意 URL 并转换为干净的 Markdown。支持两种抓取模式，适应不同场景。
+通过 Chrome CDP 抓取任意 URL 并转换为 Markdown。同时保存渲染后的 HTML 快照，Defuddle 失败时自动回退到旧版提取器。

 ```bash
 # 自动模式（默认）- 页面加载后立即抓取
@@ -775,6 +839,21 @@ AI 驱动的生成后端。
 | 代码/命令 | `` `行内` `` 或 ` ```代码块``` ` |
 | 引用 | `>` 引用块 |

+#### baoyu-markdown-to-html
+
+将 Markdown 文件转换为样式化 HTML，支持微信公众号兼容主题、代码高亮，以及可选的外链底部引用。
+
+```bash
+# 基础转换
+/baoyu-markdown-to-html article.md
+
+# 主题 + 颜色
+/baoyu-markdown-to-html article.md --theme grace --color red
+
+# 将普通外链转换为文末引用
+/baoyu-markdown-to-html article.md --cite
+```
+
 #### baoyu-translate

 三模式翻译技能：快速（直接翻译）、标准（分析后翻译）、精翻（完整出版级工作流，含审校与润色）。
@@ -958,6 +1037,19 @@ HTTP_PROXY=http://127.0.0.1:7890 HTTPS_PROXY=http://127.0.0.1:7890 /baoyu-danger
 - 首次使用需确认免责声明
 - 通过环境变量或 Chrome 登录进行身份验证

+## 致谢
+
+本项目受到以下开源项目的启发，感谢它们的作者：
+
+- [x-article-publisher-skill](https://github.com/wshuyi/x-article-publisher-skill) by [@wshuyi](https://github.com/wshuyi) — 发布 X 文章技能的灵感来源
+- [doocs/md](https://github.com/doocs/md) by [@doocs](https://github.com/doocs) — Markdown 转 HTML 的核心实现逻辑
+- [高密度信息图 Prompt](https://waytoagi.feishu.cn/wiki/YG0zwalijihRREkgmPzcWRInnUg) by AJ@WaytoAGI — 信息图技能的灵感来源
+- [qiaomu-mondo-poster-design](https://github.com/joeseesun/qiaomu-mondo-poster-design) by [@joeseesun](https://github.com/joeseesun)（乔木） — Mondo 风格的灵感来源
+
 ## 许可证

 MIT
+
+## Star History
+
+[![Star History Chart](https://api.star-history.com/svg?repos=JimLiu/baoyu-skills&type=Date)](https://www.star-history.com/#JimLiu/baoyu-skills&Date)
@@ -0,0 +1,27 @@
+# Chrome Profile
+
+All CDP skills share a single profile directory. Do NOT create per-skill profiles.
+
+Override: `BAOYU_CHROME_PROFILE_DIR` env var (takes priority over all defaults).
+
+| Platform | Default Path |
+|----------|-------------|
+| macOS | `~/Library/Application Support/baoyu-skills/chrome-profile` |
+| Linux | `$XDG_DATA_HOME/baoyu-skills/chrome-profile` (fallback `~/.local/share/`) |
+| Windows | `%APPDATA%/baoyu-skills/chrome-profile` |
+| WSL | Windows home `/.local/share/baoyu-skills/chrome-profile` |
+
+New skills: use `BAOYU_CHROME_PROFILE_DIR` only (not per-skill env vars like `X_BROWSER_PROFILE_DIR`).
+
+## Implementation Pattern
+
+```typescript
+function getDefaultProfileDir(): string {
+  const override = process.env.BAOYU_CHROME_PROFILE_DIR?.trim();
+  if (override) return path.resolve(override);
+  const base = process.platform === 'darwin'
+    ? path.join(os.homedir(), 'Library', 'Application Support')
+    : process.env.XDG_DATA_HOME || path.join(os.homedir(), '.local', 'share');
+  return path.join(base, 'baoyu-skills', 'chrome-profile');
+}
+```
@@ -0,0 +1,35 @@
+# Style Maintenance (baoyu-comic)
+
+## Adding a New Style
+
+1. Create style definition: `skills/baoyu-comic/references/styles/<style-name>.md`
+2. Update SKILL.md: add to `--style` options table + auto-selection entry
+3. Generate showcase image:
+   ```bash
+   ${BUN_X} skills/baoyu-danger-gemini-web/scripts/main.ts \
+     --prompt "A single comic book page in <style-name> style showing [scene]. Features: [characteristics]. 3:4 portrait aspect ratio comic page." \
+     --image screenshots/comic-styles/<style-name>.png
+   ```
+4. Compress: `${BUN_X} skills/baoyu-compress-image/scripts/main.ts screenshots/comic-styles/<style-name>.png`
+5. Update both READMEs (`README.md` + `README.zh.md`): add style to options, description table, preview grid
+
+## Updating an Existing Style
+
+1. Update style definition in `references/styles/`
+2. Regenerate showcase image if visual characteristics changed (steps 3-4 above)
+3. Update READMEs if description changed
+
+## Deleting a Style
+
+1. Delete style definition + showcase image (`.webp`)
+2. Remove from SKILL.md `--style` options + auto-selection
+3. Remove from both READMEs (options, description table, preview grid)
+
+## Style Preview Grid Format
+
+```markdown
+| | | |
+|:---:|:---:|:---:|
+| ![style1](./screenshots/comic-styles/style1.webp) | ![style2](./screenshots/comic-styles/style2.webp) | ![style3](./screenshots/comic-styles/style3.webp) |
+| style1 | style2 | style3 |
+```
@@ -0,0 +1,135 @@
+# Creating New Skills
+
+**REQUIRED READING**: [Skill authoring best practices](https://platform.claude.com/docs/en/agents-and-tools/agent-skills/best-practices)
+
+## Key Requirements
+
+| Requirement | Details |
+|-------------|---------|
+| **Prefix** | All skills MUST use `baoyu-` prefix |
+| **name field** | Max 64 chars, lowercase letters/numbers/hyphens only, no "anthropic"/"claude" |
+| **description** | Max 1024 chars, third person, include what + when to use |
+| **SKILL.md body** | Keep under 500 lines; use `references/` for additional content |
+| **References** | One level deep from SKILL.md; avoid nested references |
+
+## SKILL.md Frontmatter Template
+
+```yaml
+---
+name: baoyu-<name>
+description: <Third-person description. What it does + when to use it.>
+version: <semver matching marketplace.json>
+metadata:
+  openclaw:
+    homepage: https://github.com/JimLiu/baoyu-skills#baoyu-<name>
+    requires:          # include only if skill has scripts
+      anyBins:
+        - bun
+        - npx
+---
+```
+
+## Steps
+
+1. Create `skills/baoyu-<name>/SKILL.md` with YAML front matter
+2. Add TypeScript in `skills/baoyu-<name>/scripts/` (if applicable)
+3. Add prompt templates in `skills/baoyu-<name>/prompts/` if needed
+4. Register in `marketplace.json` under appropriate category
+5. Add Script Directory section to SKILL.md if skill has scripts
+6. Add openclaw metadata to frontmatter
+
+## Category Selection
+
+| If your skill... | Use category |
+|------------------|--------------|
+| Generates visual content (images, slides, comics) | `content-skills` |
+| Publishes to platforms (X, WeChat, Weibo) | `content-skills` |
+| Provides AI generation backend | `ai-generation-skills` |
+| Converts or processes content | `utility-skills` |
+
+New category: add plugin object to `marketplace.json` with `name`, `description`, `skills[]`.
+
+## Writing Descriptions
+
+**MUST write in third person**:
+
+```yaml
+# Good
+description: Generates Xiaohongshu infographic series from content. Use when user asks for "小红书图片", "XHS images".
+
+# Bad
+description: I can help you create Xiaohongshu images
+```
+
+## Script Directory Template
+
+Every SKILL.md with scripts MUST include:
+
+```markdown
+## Script Directory
+
+**Important**: All scripts are located in the `scripts/` subdirectory of this skill.
+
+**Agent Execution Instructions**:
+1. Determine this SKILL.md file's directory path as `{baseDir}`
+2. Script path = `{baseDir}/scripts/<script-name>.ts`
+3. Resolve `${BUN_X}` runtime: if `bun` installed → `bun`; if `npx` available → `npx -y bun`; else suggest installing bun
+4. Replace all `{baseDir}` and `${BUN_X}` in this document with actual values
+
+**Script Reference**:
+| Script | Purpose |
+|--------|---------|
+| `scripts/main.ts` | Main entry point |
+```
+
+## Progressive Disclosure
+
+For skills with extensive content:
+
+```
+skills/baoyu-example/
+├── SKILL.md              # Main instructions (<500 lines)
+├── references/
+│   ├── styles.md         # Loaded as needed
+│   └── examples.md       # Loaded as needed
+└── scripts/
+    └── main.ts
+```
+
+Link from SKILL.md (one level deep only):
+```markdown
+**Available styles**: See [references/styles.md](references/styles.md)
+```
+
+## Extension Support (EXTEND.md)
+
+Every SKILL.md MUST include EXTEND.md loading. Add as Step 1.1 (workflow skills) or "Preferences" section (utility skills):
+
+```markdown
+**1.1 Load Preferences (EXTEND.md)**
+
+Check EXTEND.md existence (priority order):
+
+\`\`\`bash
+test -f .baoyu-skills/<skill-name>/EXTEND.md && echo "project"
+test -f "${XDG_CONFIG_HOME:-$HOME/.config}/baoyu-skills/<skill-name>/EXTEND.md" && echo "xdg"
+test -f "$HOME/.baoyu-skills/<skill-name>/EXTEND.md" && echo "user"
+\`\`\`
+
+| Path | Location |
+|------|----------|
+| `.baoyu-skills/<skill-name>/EXTEND.md` | Project directory |
+| `$XDG_CONFIG_HOME/baoyu-skills/<skill-name>/EXTEND.md` | XDG config (~/.config) |
+| `$HOME/.baoyu-skills/<skill-name>/EXTEND.md` | User home (legacy) |
+
+| Result | Action |
+|--------|--------|
+| Found | Read, parse, display summary |
+| Not found | Ask user with AskUserQuestion |
+```
+
+End of SKILL.md should include:
+```markdown
+## Extension Support
+Custom configurations via EXTEND.md. See **Step 1.1** for paths and supported options.
+```
@@ -0,0 +1,53 @@
+# Image Generation Guidelines
+
+Skills that require image generation MUST delegate to available image generation skills.
+
+## Skill Selection
+
+**Default**: `skills/baoyu-image-gen/SKILL.md` (unless user specifies otherwise).
+
+1. Read skill's SKILL.md for parameters and capabilities
+2. If user requests different skill, check `skills/` for alternatives
+3. Only ask user when multiple viable options exist
+
+## Generation Flow Template
+
+```markdown
+### Step N: Generate Images
+
+**Skill Selection**:
+1. Check available skills (`baoyu-image-gen` default, or `baoyu-danger-gemini-web`)
+2. Read selected skill's SKILL.md for parameters
+3. If multiple skills available, ask user to choose
+
+**Generation Flow**:
+1. Call skill with prompt, output path, and skill-specific parameters
+2. Generate sequentially by default (batch parallel only when user has multiple prompts)
+3. Output progress: "Generated X/N"
+4. On failure, auto-retry once before reporting error
+```
+
+**Batch Parallel** (`baoyu-image-gen` only): concurrent workers with per-provider throttling via `batch.max_workers` in EXTEND.md.
+
+## Output Path Convention
+
+**Output Directory**: `<skill-suffix>/<topic-slug>/`
+- `<skill-suffix>`: e.g., `xhs-images`, `cover-image`, `slide-deck`, `comic`
+- `<topic-slug>`: 2-4 words, kebab-case from content topic
+- Conflict: append timestamp `<topic-slug>-YYYYMMDD-HHMMSS`
+
+**Source Files**: Copy to output dir as `source-{slug}.{ext}`
+
+## Image Naming Convention
+
+**Format**: `NN-{type}-[slug].png`
+- `NN`: Two-digit sequence (01, 02, ...)
+- `{type}`: cover, content, page, slide, illustration, etc.
+- `[slug]`: 2-5 word kebab-case descriptor, unique within directory
+
+Examples:
+```
+01-cover-ai-future.png
+02-content-key-benefits.png
+03-slide-architecture-overview.png
+```
@@ -0,0 +1,39 @@
+# ClawHub / OpenClaw Publishing
+
+## OpenClaw Metadata
+
+Skills include `metadata.openclaw` in YAML front matter:
+
+```yaml
+metadata:
+  openclaw:
+    homepage: https://github.com/JimLiu/baoyu-skills#<skill-name>
+    requires:          # only for skills with scripts
+      anyBins:
+        - bun
+        - npx
+```
+
+## Publishing Commands
+
+```bash
+bash scripts/sync-clawhub.sh           # sync all skills
+bash scripts/sync-clawhub.sh <skill>   # sync one skill
+```
+
+Release hooks are configured via `.releaserc.yml`. This repo does not stage a separate release directory: release prep only syncs `packages/` into each skill's committed `scripts/vendor/`, and publish reads the skill directory directly.
+
+## Shared Workspace Packages
+
+`packages/` is the **only** source of truth. Never edit `skills/*/scripts/vendor/` directly.
+
+Current package: `baoyu-chrome-cdp` (Chrome CDP utilities), consumed by 6 skills (`baoyu-danger-gemini-web`, `baoyu-danger-x-to-markdown`, `baoyu-post-to-wechat`, `baoyu-post-to-weibo`, `baoyu-post-to-x`, `baoyu-url-to-markdown`).
+
+**How it works**: Sync script copies packages into each consuming skill's `vendor/` directory and rewrites dependency specs to `file:./vendor/<name>`. Vendor copies are committed to git, making skills self-contained.
+
+**Update workflow**:
+1. Edit package under `packages/`
+2. Run `node scripts/sync-shared-skill-packages.mjs`
+3. Commit synced `vendor/`, `package.json`, and `bun.lock` together
+
+**Git hook**: Run `node scripts/install-git-hooks.mjs` once to enable the `pre-push` hook. It re-syncs and blocks push if vendor copies are stale (`--enforce-clean`).
@@ -0,0 +1,9 @@
+{
+  "name": "baoyu-chrome-cdp",
+  "private": true,
+  "version": "0.1.0",
+  "type": "module",
+  "exports": {
+    ".": "./src/index.ts"
+  }
+}
@@ -0,0 +1,408 @@
+import { spawn, spawnSync, type ChildProcess } from "node:child_process";
+import fs from "node:fs";
+import net from "node:net";
+import os from "node:os";
+import path from "node:path";
+import process from "node:process";
+
+export type PlatformCandidates = {
+  darwin?: string[];
+  win32?: string[];
+  default: string[];
+};
+
+type PendingRequest = {
+  resolve: (value: unknown) => void;
+  reject: (error: Error) => void;
+  timer: ReturnType<typeof setTimeout> | null;
+};
+
+type CdpSendOptions = {
+  sessionId?: string;
+  timeoutMs?: number;
+};
+
+type FetchJsonOptions = {
+  timeoutMs?: number;
+};
+
+type FindChromeExecutableOptions = {
+  candidates: PlatformCandidates;
+  envNames?: string[];
+};
+
+type ResolveSharedChromeProfileDirOptions = {
+  envNames?: string[];
+  appDataDirName?: string;
+  profileDirName?: string;
+  wslWindowsHome?: string | null;
+};
+
+type FindExistingChromeDebugPortOptions = {
+  profileDir: string;
+  timeoutMs?: number;
+};
+
+type LaunchChromeOptions = {
+  chromePath: string;
+  profileDir: string;
+  port: number;
+  url?: string;
+  headless?: boolean;
+  extraArgs?: string[];
+};
+
+type ChromeTargetInfo = {
+  targetId: string;
+  url: string;
+  type: string;
+};
+
+type OpenPageSessionOptions = {
+  cdp: CdpConnection;
+  reusing: boolean;
+  url: string;
+  matchTarget: (target: ChromeTargetInfo) => boolean;
+  enablePage?: boolean;
+  enableRuntime?: boolean;
+  enableDom?: boolean;
+  enableNetwork?: boolean;
+  activateTarget?: boolean;
+};
+
+export type PageSession = {
+  sessionId: string;
+  targetId: string;
+};
+
+export function sleep(ms: number): Promise<void> {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+
+export async function getFreePort(fixedEnvName?: string): Promise<number> {
+  const fixed = fixedEnvName ? Number.parseInt(process.env[fixedEnvName] ?? "", 10) : NaN;
+  if (Number.isInteger(fixed) && fixed > 0) return fixed;
+
+  return await new Promise((resolve, reject) => {
+    const server = net.createServer();
+    server.unref();
+    server.on("error", reject);
+    server.listen(0, "127.0.0.1", () => {
+      const address = server.address();
+      if (!address || typeof address === "string") {
+        server.close(() => reject(new Error("Unable to allocate a free TCP port.")));
+        return;
+      }
+      const port = address.port;
+      server.close((err) => {
+        if (err) reject(err);
+        else resolve(port);
+      });
+    });
+  });
+}
+
+export function findChromeExecutable(options: FindChromeExecutableOptions): string | undefined {
+  for (const envName of options.envNames ?? []) {
+    const override = process.env[envName]?.trim();
+    if (override && fs.existsSync(override)) return override;
+  }
+
+  const candidates = process.platform === "darwin"
+    ? options.candidates.darwin ?? options.candidates.default
+    : process.platform === "win32"
+      ? options.candidates.win32 ?? options.candidates.default
+      : options.candidates.default;
+
+  for (const candidate of candidates) {
+    if (fs.existsSync(candidate)) return candidate;
+  }
+  return undefined;
+}
+
+export function resolveSharedChromeProfileDir(options: ResolveSharedChromeProfileDirOptions = {}): string {
+  for (const envName of options.envNames ?? []) {
+    const override = process.env[envName]?.trim();
+    if (override) return path.resolve(override);
+  }
+
+  const appDataDirName = options.appDataDirName ?? "baoyu-skills";
+  const profileDirName = options.profileDirName ?? "chrome-profile";
+
+  if (options.wslWindowsHome) {
+    return path.join(options.wslWindowsHome, ".local", "share", appDataDirName, profileDirName);
+  }
+
+  const base = process.platform === "darwin"
+    ? path.join(os.homedir(), "Library", "Application Support")
+    : process.platform === "win32"
+      ? (process.env.APPDATA ?? path.join(os.homedir(), "AppData", "Roaming"))
+      : (process.env.XDG_DATA_HOME ?? path.join(os.homedir(), ".local", "share"));
+  return path.join(base, appDataDirName, profileDirName);
+}
+
+async function fetchWithTimeout(url: string, timeoutMs?: number): Promise<Response> {
+  if (!timeoutMs || timeoutMs <= 0) return await fetch(url, { redirect: "follow" });
+
+  const ctl = new AbortController();
+  const timer = setTimeout(() => ctl.abort(), timeoutMs);
+  try {
+    return await fetch(url, { redirect: "follow", signal: ctl.signal });
+  } finally {
+    clearTimeout(timer);
+  }
+}
+
+async function fetchJson<T = unknown>(url: string, options: FetchJsonOptions = {}): Promise<T> {
+  const response = await fetchWithTimeout(url, options.timeoutMs);
+  if (!response.ok) {
+    throw new Error(`Request failed: ${response.status} ${response.statusText}`);
+  }
+  return await response.json() as T;
+}
+
+async function isDebugPortReady(port: number, timeoutMs = 3_000): Promise<boolean> {
+  try {
+    const version = await fetchJson<{ webSocketDebuggerUrl?: string }>(
+      `http://127.0.0.1:${port}/json/version`,
+      { timeoutMs }
+    );
+    return !!version.webSocketDebuggerUrl;
+  } catch {
+    return false;
+  }
+}
+
+export async function findExistingChromeDebugPort(options: FindExistingChromeDebugPortOptions): Promise<number | null> {
+  const timeoutMs = options.timeoutMs ?? 3_000;
+  const portFile = path.join(options.profileDir, "DevToolsActivePort");
+
+  try {
+    const content = fs.readFileSync(portFile, "utf-8");
+    const [portLine] = content.split(/\r?\n/);
+    const port = Number.parseInt(portLine?.trim() ?? "", 10);
+    if (port > 0 && await isDebugPortReady(port, timeoutMs)) return port;
+  } catch {}
+
+  if (process.platform === "win32") return null;
+
+  try {
+    const result = spawnSync("ps", ["aux"], { encoding: "utf-8", timeout: 5_000 });
+    if (result.status !== 0 || !result.stdout) return null;
+
+    const lines = result.stdout
+      .split("\n")
+      .filter((line) => line.includes(options.profileDir) && line.includes("--remote-debugging-port="));
+
+    for (const line of lines) {
+      const portMatch = line.match(/--remote-debugging-port=(\d+)/);
+      const port = Number.parseInt(portMatch?.[1] ?? "", 10);
+      if (port > 0 && await isDebugPortReady(port, timeoutMs)) return port;
+    }
+  } catch {}
+
+  return null;
+}
+
+export async function waitForChromeDebugPort(
+  port: number,
+  timeoutMs: number,
+  options?: { includeLastError?: boolean }
+): Promise<string> {
+  const start = Date.now();
+  let lastError: unknown = null;
+
+  while (Date.now() - start < timeoutMs) {
+    try {
+      const version = await fetchJson<{ webSocketDebuggerUrl?: string }>(
+        `http://127.0.0.1:${port}/json/version`,
+        { timeoutMs: 5_000 }
+      );
+      if (version.webSocketDebuggerUrl) return version.webSocketDebuggerUrl;
+      lastError = new Error("Missing webSocketDebuggerUrl");
+    } catch (error) {
+      lastError = error;
+    }
+    await sleep(200);
+  }
+
+  if (options?.includeLastError && lastError) {
+    throw new Error(
+      `Chrome debug port not ready: ${lastError instanceof Error ? lastError.message : String(lastError)}`
+    );
+  }
+  throw new Error("Chrome debug port not ready");
+}
+
+export class CdpConnection {
+  private ws: WebSocket;
+  private nextId = 0;
+  private pending = new Map<number, PendingRequest>();
+  private eventHandlers = new Map<string, Set<(params: unknown) => void>>();
+  private defaultTimeoutMs: number;
+
+  private constructor(ws: WebSocket, defaultTimeoutMs = 15_000) {
+    this.ws = ws;
+    this.defaultTimeoutMs = defaultTimeoutMs;
+
+    this.ws.addEventListener("message", (event) => {
+      try {
+        const data = typeof event.data === "string"
+          ? event.data
+          : new TextDecoder().decode(event.data as ArrayBuffer);
+        const msg = JSON.parse(data) as {
+          id?: number;
+          method?: string;
+          params?: unknown;
+          result?: unknown;
+          error?: { message?: string };
+        };
+
+        if (msg.method) {
+          const handlers = this.eventHandlers.get(msg.method);
+          if (handlers) {
+            handlers.forEach((handler) => handler(msg.params));
+          }
+        }
+
+        if (msg.id) {
+          const pending = this.pending.get(msg.id);
+          if (pending) {
+            this.pending.delete(msg.id);
+            if (pending.timer) clearTimeout(pending.timer);
+            if (msg.error?.message) pending.reject(new Error(msg.error.message));
+            else pending.resolve(msg.result);
+          }
+        }
+      } catch {}
+    });
+
+    this.ws.addEventListener("close", () => {
+      for (const [id, pending] of this.pending.entries()) {
+        this.pending.delete(id);
+        if (pending.timer) clearTimeout(pending.timer);
+        pending.reject(new Error("CDP connection closed."));
+      }
+    });
+  }
+
+  static async connect(
+    url: string,
+    timeoutMs: number,
+    options?: { defaultTimeoutMs?: number }
+  ): Promise<CdpConnection> {
+    const ws = new WebSocket(url);
+    await new Promise<void>((resolve, reject) => {
+      const timer = setTimeout(() => reject(new Error("CDP connection timeout.")), timeoutMs);
+      ws.addEventListener("open", () => {
+        clearTimeout(timer);
+        resolve();
+      });
+      ws.addEventListener("error", () => {
+        clearTimeout(timer);
+        reject(new Error("CDP connection failed."));
+      });
+    });
+    return new CdpConnection(ws, options?.defaultTimeoutMs ?? 15_000);
+  }
+
+  on(method: string, handler: (params: unknown) => void): void {
+    if (!this.eventHandlers.has(method)) {
+      this.eventHandlers.set(method, new Set());
+    }
+    this.eventHandlers.get(method)?.add(handler);
+  }
+
+  off(method: string, handler: (params: unknown) => void): void {
+    this.eventHandlers.get(method)?.delete(handler);
+  }
+
+  async send<T = unknown>(method: string, params?: Record<string, unknown>, options?: CdpSendOptions): Promise<T> {
+    const id = ++this.nextId;
+    const message: Record<string, unknown> = { id, method };
+    if (params) message.params = params;
+    if (options?.sessionId) message.sessionId = options.sessionId;
+
+    const timeoutMs = options?.timeoutMs ?? this.defaultTimeoutMs;
+    const result = await new Promise<unknown>((resolve, reject) => {
+      const timer = timeoutMs > 0
+        ? setTimeout(() => {
+          this.pending.delete(id);
+          reject(new Error(`CDP timeout: ${method}`));
+        }, timeoutMs)
+        : null;
+      this.pending.set(id, { resolve, reject, timer });
+      this.ws.send(JSON.stringify(message));
+    });
+
+    return result as T;
+  }
+
+  close(): void {
+    try {
+      this.ws.close();
+    } catch {}
+  }
+}
+
+export async function launchChrome(options: LaunchChromeOptions): Promise<ChildProcess> {
+  await fs.promises.mkdir(options.profileDir, { recursive: true });
+
+  const args = [
+    `--remote-debugging-port=${options.port}`,
+    `--user-data-dir=${options.profileDir}`,
+    "--no-first-run",
+    "--no-default-browser-check",
+    ...(options.extraArgs ?? []),
+  ];
+  if (options.headless) args.push("--headless=new");
+  if (options.url) args.push(options.url);
+
+  return spawn(options.chromePath, args, { stdio: "ignore" });
+}
+
+export function killChrome(chrome: ChildProcess): void {
+  try {
+    chrome.kill("SIGTERM");
+  } catch {}
+  setTimeout(() => {
+    if (!chrome.killed) {
+      try {
+        chrome.kill("SIGKILL");
+      } catch {}
+    }
+  }, 2_000).unref?.();
+}
+
+export async function openPageSession(options: OpenPageSessionOptions): Promise<PageSession> {
+  let targetId: string;
+
+  if (options.reusing) {
+    const created = await options.cdp.send<{ targetId: string }>("Target.createTarget", { url: options.url });
+    targetId = created.targetId;
+  } else {
+    const targets = await options.cdp.send<{ targetInfos: ChromeTargetInfo[] }>("Target.getTargets");
+    const existing = targets.targetInfos.find(options.matchTarget);
+    if (existing) {
+      targetId = existing.targetId;
+    } else {
+      const created = await options.cdp.send<{ targetId: string }>("Target.createTarget", { url: options.url });
+      targetId = created.targetId;
+    }
+  }
+
+  const { sessionId } = await options.cdp.send<{ sessionId: string }>(
+    "Target.attachToTarget",
+    { targetId, flatten: true }
+  );
+
+  if (options.activateTarget ?? true) {
+    await options.cdp.send("Target.activateTarget", { targetId });
+  }
+  if (options.enablePage) await options.cdp.send("Page.enable", {}, { sessionId });
+  if (options.enableRuntime) await options.cdp.send("Runtime.enable", {}, { sessionId });
+  if (options.enableDom) await options.cdp.send("DOM.enable", {}, { sessionId });
+  if (options.enableNetwork) await options.cdp.send("Network.enable", {}, { sessionId });
+
+  return { sessionId, targetId };
+}
@@ -0,0 +1,25 @@
+#!/usr/bin/env node
+
+import { spawnSync } from "node:child_process";
+import path from "node:path";
+
+async function main() {
+  const repoRoot = path.resolve(process.cwd());
+  const hooksPath = path.join(repoRoot, ".githooks");
+
+  const result = spawnSync("git", ["config", "core.hooksPath", hooksPath], {
+    cwd: repoRoot,
+    stdio: "inherit",
+  });
+
+  if (result.status !== 0) {
+    throw new Error("Failed to configure core.hooksPath");
+  }
+
+  console.log(`Configured git hooks path: ${hooksPath}`);
+}
+
+main().catch((error) => {
+  console.error(error instanceof Error ? error.message : String(error));
+  process.exit(1);
+});
@@ -0,0 +1,75 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+
+const PACKAGE_DEPENDENCY_SECTIONS = [
+  "dependencies",
+  "optionalDependencies",
+  "peerDependencies",
+  "devDependencies",
+];
+
+const SKIPPED_DIRS = new Set([".git", ".clawhub", ".clawdhub", "node_modules", "out", "dist", "build"]);
+const SKIPPED_FILES = new Set([".DS_Store", "bun.lockb"]);
+
+export async function listReleaseFiles(root) {
+  const resolvedRoot = path.resolve(root);
+  const files = [];
+
+  async function walk(folder) {
+    const entries = await fs.readdir(folder, { withFileTypes: true });
+    for (const entry of entries) {
+      if (entry.isDirectory() && SKIPPED_DIRS.has(entry.name)) continue;
+      if (entry.isFile() && SKIPPED_FILES.has(entry.name)) continue;
+
+      const fullPath = path.join(folder, entry.name);
+      if (entry.isDirectory()) {
+        await walk(fullPath);
+        continue;
+      }
+      if (!entry.isFile()) continue;
+
+      const relPath = path.relative(resolvedRoot, fullPath).split(path.sep).join("/");
+      const bytes = await fs.readFile(fullPath);
+      files.push({ relPath, bytes });
+    }
+  }
+
+  await walk(resolvedRoot);
+  files.sort((left, right) => left.relPath.localeCompare(right.relPath));
+  return files;
+}
+
+export async function validateSelfContainedRelease(root) {
+  const files = await listReleaseFiles(root);
+  for (const file of files.filter((entry) => path.posix.basename(entry.relPath) === "package.json")) {
+    const packageDir = path.resolve(root, fromPosixRel(path.posix.dirname(file.relPath)));
+    const packageJson = JSON.parse(file.bytes.toString("utf8"));
+    for (const section of PACKAGE_DEPENDENCY_SECTIONS) {
+      const dependencies = packageJson[section];
+      if (!dependencies || typeof dependencies !== "object") continue;
+
+      for (const [name, spec] of Object.entries(dependencies)) {
+        if (typeof spec !== "string" || !spec.startsWith("file:")) continue;
+        const targetDir = path.resolve(packageDir, spec.slice(5));
+        if (!isWithinRoot(root, targetDir)) {
+          throw new Error(
+            `Release target is not self-contained: ${file.relPath} depends on ${name} via ${spec}`,
+          );
+        }
+        await fs.access(targetDir).catch(() => {
+          throw new Error(`Missing local dependency for release: ${file.relPath} -> ${spec}`);
+        });
+      }
+    }
+  }
+}
+
+function fromPosixRel(relPath) {
+  return relPath === "." ? "." : relPath.split("/").join(path.sep);
+}
+
+function isWithinRoot(root, target) {
+  const resolvedRoot = path.resolve(root);
+  const relative = path.relative(resolvedRoot, path.resolve(target));
+  return relative === "" || (!relative.startsWith("..") && !path.isAbsolute(relative));
+}
@@ -0,0 +1,280 @@
+import { spawnSync } from "node:child_process";
+import { existsSync } from "node:fs";
+import fs from "node:fs/promises";
+import path from "node:path";
+
+const PACKAGE_DEPENDENCY_SECTIONS = [
+  "dependencies",
+  "optionalDependencies",
+  "peerDependencies",
+  "devDependencies",
+];
+
+const SKIPPED_DIRS = new Set([".git", ".clawhub", ".clawdhub", "node_modules"]);
+const SKIPPED_FILES = new Set([".DS_Store"]);
+
+export async function syncSharedSkillPackages(repoRoot, options = {}) {
+  const root = path.resolve(repoRoot);
+  const workspacePackages = await discoverWorkspacePackages(root);
+  const targetConsumerDirs = normalizeTargetConsumerDirs(root, options.targets ?? []);
+  const consumers = await discoverSkillScriptPackages(root, targetConsumerDirs);
+  const runtime = options.install === false ? null : resolveBunRuntime();
+  const managedPaths = new Set();
+  const packageDirs = [];
+
+  for (const consumer of consumers) {
+    const result = await syncConsumerPackage({
+      consumer,
+      root,
+      workspacePackages,
+      runtime,
+    });
+    if (!result) continue;
+
+    packageDirs.push(consumer.dir);
+    for (const managedPath of result.managedPaths) {
+      managedPaths.add(managedPath);
+    }
+  }
+
+  return {
+    packageDirs,
+    managedPaths: [...managedPaths].sort(),
+  };
+}
+
+function normalizeTargetConsumerDirs(repoRoot, targets) {
+  if (!targets || targets.length === 0) return null;
+
+  const consumerDirs = new Set();
+  for (const target of targets) {
+    if (!target) continue;
+
+    const resolvedTarget = path.resolve(repoRoot, target);
+    if (path.basename(resolvedTarget) === "scripts") {
+      consumerDirs.add(resolvedTarget);
+      continue;
+    }
+
+    consumerDirs.add(path.join(resolvedTarget, "scripts"));
+  }
+
+  return consumerDirs;
+}
+
+export function ensureManagedPathsClean(repoRoot, managedPaths) {
+  if (managedPaths.length === 0) return;
+
+  const result = spawnSync("git", ["status", "--porcelain", "--", ...managedPaths], {
+    cwd: repoRoot,
+    encoding: "utf8",
+    stdio: ["ignore", "pipe", "pipe"],
+  });
+
+  if (result.status !== 0) {
+    throw new Error(result.stderr.trim() || "Failed to inspect git status for managed paths");
+  }
+
+  const output = result.stdout.trim();
+  if (!output) return;
+
+  throw new Error(
+    [
+      "Shared skill package sync produced uncommitted managed changes.",
+      "Review and commit these files before pushing:",
+      output,
+    ].join("\n"),
+  );
+}
+
+async function syncConsumerPackage({ consumer, root, workspacePackages, runtime }) {
+  const packageJsonPath = path.join(consumer.dir, "package.json");
+  const packageJson = JSON.parse(await fs.readFile(packageJsonPath, "utf8"));
+  const localDeps = collectLocalDependencies(packageJson, workspacePackages);
+  if (localDeps.length === 0) {
+    return null;
+  }
+
+  const vendorRoot = path.join(consumer.dir, "vendor");
+  await fs.rm(vendorRoot, { recursive: true, force: true });
+
+  for (const name of localDeps) {
+    const sourceDir = workspacePackages.get(name);
+    if (!sourceDir) continue;
+    await syncPackageTree({
+      sourceDir,
+      targetDir: path.join(vendorRoot, name),
+      workspacePackages,
+    });
+  }
+
+  rewriteLocalDependencySpecs(packageJson, localDeps);
+  await writeJson(packageJsonPath, packageJson);
+
+  if (runtime) {
+    runInstall(runtime, consumer.dir);
+  }
+
+  const managedPaths = [
+    path.relative(root, packageJsonPath).split(path.sep).join("/"),
+    path.relative(root, path.join(consumer.dir, "bun.lock")).split(path.sep).join("/"),
+    path.relative(root, vendorRoot).split(path.sep).join("/"),
+  ];
+
+  return { managedPaths };
+}
+
+async function syncPackageTree({ sourceDir, targetDir, workspacePackages }) {
+  await fs.rm(targetDir, { recursive: true, force: true });
+  await fs.mkdir(targetDir, { recursive: true });
+
+  const sourcePackageJsonPath = path.join(sourceDir, "package.json");
+  const packageJson = JSON.parse(await fs.readFile(sourcePackageJsonPath, "utf8"));
+  const localDeps = collectLocalDependencies(packageJson, workspacePackages);
+
+  const entries = await fs.readdir(sourceDir, { withFileTypes: true });
+  for (const entry of entries) {
+    if (SKIPPED_DIRS.has(entry.name) || SKIPPED_FILES.has(entry.name)) continue;
+
+    const sourcePath = path.join(sourceDir, entry.name);
+    const targetPath = path.join(targetDir, entry.name);
+
+    if (entry.isDirectory()) {
+      await copyDirectory(sourcePath, targetPath);
+      continue;
+    }
+
+    if (!entry.isFile() || entry.name === "package.json") continue;
+    await fs.mkdir(path.dirname(targetPath), { recursive: true });
+    await fs.copyFile(sourcePath, targetPath);
+  }
+
+  for (const name of localDeps) {
+    const nestedSourceDir = workspacePackages.get(name);
+    if (!nestedSourceDir) continue;
+    await syncPackageTree({
+      sourceDir: nestedSourceDir,
+      targetDir: path.join(targetDir, "vendor", name),
+      workspacePackages,
+    });
+  }
+
+  rewriteLocalDependencySpecs(packageJson, localDeps);
+  await writeJson(path.join(targetDir, "package.json"), packageJson);
+}
+
+async function copyDirectory(sourceDir, targetDir) {
+  await fs.mkdir(targetDir, { recursive: true });
+  const entries = await fs.readdir(sourceDir, { withFileTypes: true });
+  for (const entry of entries) {
+    if (SKIPPED_DIRS.has(entry.name) || SKIPPED_FILES.has(entry.name)) continue;
+
+    const sourcePath = path.join(sourceDir, entry.name);
+    const targetPath = path.join(targetDir, entry.name);
+
+    if (entry.isDirectory()) {
+      await copyDirectory(sourcePath, targetPath);
+      continue;
+    }
+
+    if (!entry.isFile()) continue;
+    await fs.mkdir(path.dirname(targetPath), { recursive: true });
+    await fs.copyFile(sourcePath, targetPath);
+  }
+}
+
+async function discoverWorkspacePackages(repoRoot) {
+  const packagesRoot = path.join(repoRoot, "packages");
+  const map = new Map();
+  if (!existsSync(packagesRoot)) return map;
+
+  const entries = await fs.readdir(packagesRoot, { withFileTypes: true });
+  for (const entry of entries) {
+    if (!entry.isDirectory()) continue;
+    const packageJsonPath = path.join(packagesRoot, entry.name, "package.json");
+    if (!existsSync(packageJsonPath)) continue;
+
+    const packageJson = JSON.parse(await fs.readFile(packageJsonPath, "utf8"));
+    if (!packageJson.name) continue;
+    map.set(packageJson.name, path.join(packagesRoot, entry.name));
+  }
+
+  return map;
+}
+
+async function discoverSkillScriptPackages(repoRoot, targetConsumerDirs = null) {
+  const skillsRoot = path.join(repoRoot, "skills");
+  const consumers = [];
+  const skillEntries = await fs.readdir(skillsRoot, { withFileTypes: true });
+  for (const entry of skillEntries) {
+    if (!entry.isDirectory()) continue;
+    const scriptsDir = path.join(skillsRoot, entry.name, "scripts");
+    if (targetConsumerDirs && !targetConsumerDirs.has(path.resolve(scriptsDir))) continue;
+    const packageJsonPath = path.join(scriptsDir, "package.json");
+    if (!existsSync(packageJsonPath)) continue;
+    consumers.push({ dir: scriptsDir, packageJsonPath });
+  }
+  return consumers.sort((left, right) => left.dir.localeCompare(right.dir));
+}
+
+function collectLocalDependencies(packageJson, workspacePackages) {
+  const localDeps = [];
+  for (const section of PACKAGE_DEPENDENCY_SECTIONS) {
+    const dependencies = packageJson[section];
+    if (!dependencies || typeof dependencies !== "object") continue;
+
+    for (const name of Object.keys(dependencies)) {
+      if (!workspacePackages.has(name)) continue;
+      localDeps.push(name);
+    }
+  }
+
+  return [...new Set(localDeps)].sort();
+}
+
+function rewriteLocalDependencySpecs(packageJson, localDeps) {
+  for (const section of PACKAGE_DEPENDENCY_SECTIONS) {
+    const dependencies = packageJson[section];
+    if (!dependencies || typeof dependencies !== "object") continue;
+
+    for (const name of localDeps) {
+      if (!(name in dependencies)) continue;
+      dependencies[name] = `file:./vendor/${name}`;
+    }
+  }
+}
+
+async function writeJson(filePath, value) {
+  await fs.mkdir(path.dirname(filePath), { recursive: true });
+  await fs.writeFile(filePath, `${JSON.stringify(value, null, 2)}\n`);
+}
+
+function resolveBunRuntime() {
+  if (commandExists("bun")) {
+    return { command: "bun", args: [] };
+  }
+  if (commandExists("npx")) {
+    return { command: "npx", args: ["-y", "bun"] };
+  }
+  throw new Error(
+    "Neither bun nor npx is installed. Install bun with `brew install oven-sh/bun/bun` or `npm install -g bun`.",
+  );
+}
+
+function commandExists(command) {
+  const result = spawnSync("sh", ["-lc", `command -v ${command}`], {
+    stdio: "ignore",
+  });
+  return result.status === 0;
+}
+
+function runInstall(runtime, cwd) {
+  const result = spawnSync(runtime.command, [...runtime.args, "install"], {
+    cwd,
+    stdio: "inherit",
+  });
+
+  if (result.status !== 0) {
+    throw new Error(`Failed to refresh Bun dependencies in ${cwd}`);
+  }
+}
@@ -0,0 +1,311 @@
+#!/usr/bin/env node
+
+import fs from "node:fs/promises";
+import { existsSync } from "node:fs";
+import os from "node:os";
+import path from "node:path";
+
+import { listReleaseFiles, validateSelfContainedRelease } from "./lib/release-files.mjs";
+
+const DEFAULT_REGISTRY = "https://clawhub.ai";
+
+async function main() {
+  const options = parseArgs(process.argv.slice(2));
+  if (!options.skillDir || !options.version) {
+    throw new Error("--skill-dir and --version are required");
+  }
+
+  const skillDir = path.resolve(options.skillDir);
+  const skill = buildSkillEntry(skillDir, options.slug, options.displayName);
+  const changelog = options.changelogFile
+    ? await fs.readFile(path.resolve(options.changelogFile), "utf8")
+    : "";
+
+  await validateSelfContainedRelease(skillDir);
+  const files = await listReleaseFiles(skillDir);
+  if (files.length === 0) {
+    throw new Error(`Skill directory is empty: ${skillDir}`);
+  }
+
+  if (options.dryRun) {
+    console.log(`Dry run: would publish ${skill.slug}@${options.version}`);
+    console.log(`Skill: ${skillDir}`);
+    console.log(`Files: ${files.length}`);
+    return;
+  }
+
+  const config = await readClawhubConfig();
+  const registry = (
+    options.registry ||
+    process.env.CLAWHUB_REGISTRY ||
+    process.env.CLAWDHUB_REGISTRY ||
+    config.registry ||
+    DEFAULT_REGISTRY
+  ).replace(/\/+$/, "");
+
+  if (!config.token) {
+    throw new Error("Not logged in. Run: clawhub login");
+  }
+
+  await apiJson(registry, config.token, "/api/v1/whoami");
+
+  const tags = options.tags
+    .split(",")
+    .map((tag) => tag.trim())
+    .filter(Boolean);
+
+  await publishSkill({
+    registry,
+    token: config.token,
+    skill,
+    files,
+    version: options.version,
+    changelog,
+    tags,
+  });
+}
+
+function parseArgs(argv) {
+  const options = {
+    skillDir: "",
+    version: "",
+    changelogFile: "",
+    registry: "",
+    tags: "latest",
+    dryRun: false,
+    slug: "",
+    displayName: "",
+  };
+
+  for (let index = 0; index < argv.length; index += 1) {
+    const arg = argv[index];
+    if (arg === "--skill-dir") {
+      options.skillDir = argv[index + 1] ?? "";
+      index += 1;
+      continue;
+    }
+    if (arg === "--version") {
+      options.version = argv[index + 1] ?? "";
+      index += 1;
+      continue;
+    }
+    if (arg === "--changelog-file") {
+      options.changelogFile = argv[index + 1] ?? "";
+      index += 1;
+      continue;
+    }
+    if (arg === "--registry") {
+      options.registry = argv[index + 1] ?? "";
+      index += 1;
+      continue;
+    }
+    if (arg === "--tags") {
+      options.tags = argv[index + 1] ?? "latest";
+      index += 1;
+      continue;
+    }
+    if (arg === "--slug") {
+      options.slug = argv[index + 1] ?? "";
+      index += 1;
+      continue;
+    }
+    if (arg === "--display-name") {
+      options.displayName = argv[index + 1] ?? "";
+      index += 1;
+      continue;
+    }
+    if (arg === "--dry-run") {
+      const next = argv[index + 1];
+      if (next && !next.startsWith("-")) {
+        options.dryRun = parseBoolean(next);
+        index += 1;
+      } else {
+        options.dryRun = true;
+      }
+      continue;
+    }
+    if (arg === "-h" || arg === "--help") {
+      printUsage();
+      process.exit(0);
+    }
+    throw new Error(`Unknown argument: ${arg}`);
+  }
+
+  return options;
+}
+
+function printUsage() {
+  console.log(`Usage: publish-skill.mjs --skill-dir <dir> --version <semver> [options]
+
+Options:
+  --skill-dir <dir>        Skill directory to publish
+  --version <semver>       Version to publish
+  --changelog-file <file>  Release notes file
+  --registry <url>         Override registry base URL
+  --tags <tags>            Comma-separated tags (default: latest)
+  --slug <value>           Override slug
+  --display-name <value>   Override display name
+  --dry-run                Print publish plan without network calls
+  -h, --help               Show help`);
+}
+
+function buildSkillEntry(folder, slugOverride, displayNameOverride) {
+  const base = path.basename(folder);
+  return {
+    folder,
+    slug: slugOverride || sanitizeSlug(base),
+    displayName: displayNameOverride || titleCase(base),
+  };
+}
+
+async function readClawhubConfig() {
+  const configPath = getConfigPath();
+  try {
+    return JSON.parse(await fs.readFile(configPath, "utf8"));
+  } catch {
+    return {};
+  }
+}
+
+function getConfigPath() {
+  const override =
+    process.env.CLAWHUB_CONFIG_PATH?.trim() || process.env.CLAWDHUB_CONFIG_PATH?.trim();
+  if (override) {
+    return path.resolve(override);
+  }
+
+  const home = os.homedir();
+  if (process.platform === "darwin") {
+    const clawhub = path.join(home, "Library", "Application Support", "clawhub", "config.json");
+    const clawdhub = path.join(home, "Library", "Application Support", "clawdhub", "config.json");
+    return pathForExistingConfig(clawhub, clawdhub);
+  }
+
+  const xdg = process.env.XDG_CONFIG_HOME;
+  if (xdg) {
+    const clawhub = path.join(xdg, "clawhub", "config.json");
+    const clawdhub = path.join(xdg, "clawdhub", "config.json");
+    return pathForExistingConfig(clawhub, clawdhub);
+  }
+
+  if (process.platform === "win32" && process.env.APPDATA) {
+    const clawhub = path.join(process.env.APPDATA, "clawhub", "config.json");
+    const clawdhub = path.join(process.env.APPDATA, "clawdhub", "config.json");
+    return pathForExistingConfig(clawhub, clawdhub);
+  }
+
+  const clawhub = path.join(home, ".config", "clawhub", "config.json");
+  const clawdhub = path.join(home, ".config", "clawdhub", "config.json");
+  return pathForExistingConfig(clawhub, clawdhub);
+}
+
+function pathForExistingConfig(primary, legacy) {
+  if (existsSync(primary)) return path.resolve(primary);
+  if (existsSync(legacy)) return path.resolve(legacy);
+  return path.resolve(primary);
+}
+
+async function publishSkill({ registry, token, skill, files, version, changelog, tags }) {
+  const form = new FormData();
+  form.set(
+    "payload",
+    JSON.stringify({
+      slug: skill.slug,
+      displayName: skill.displayName,
+      version,
+      changelog,
+      tags,
+      acceptLicenseTerms: true,
+    }),
+  );
+
+  for (const file of files) {
+    form.append("files", new Blob([file.bytes], { type: mimeType(file.relPath) }), file.relPath);
+  }
+
+  const response = await fetch(`${registry}/api/v1/skills`, {
+    method: "POST",
+    headers: {
+      Accept: "application/json",
+      Authorization: `Bearer ${token}`,
+    },
+    body: form,
+  });
+
+  const text = await response.text();
+  if (!response.ok) {
+    throw new Error(text || `Publish failed for ${skill.slug} (HTTP ${response.status})`);
+  }
+
+  const result = text ? JSON.parse(text) : {};
+  console.log(`OK. Published ${skill.slug}@${version}${result.versionId ? ` (${result.versionId})` : ""}`);
+}
+
+async function apiJson(registry, token, requestPath) {
+  const response = await fetch(`${registry}${requestPath}`, {
+    headers: {
+      Accept: "application/json",
+      Authorization: `Bearer ${token}`,
+    },
+  });
+
+  const text = await response.text();
+  let body = null;
+  try {
+    body = text ? JSON.parse(text) : null;
+  } catch {
+    body = { message: text };
+  }
+
+  if (response.status < 200 || response.status >= 300) {
+    throw new Error(body?.message || `HTTP ${response.status}`);
+  }
+  return body;
+}
+
+function sanitizeSlug(value) {
+  return value
+    .trim()
+    .toLowerCase()
+    .replace(/[^a-z0-9-]+/g, "-")
+    .replace(/^-+/, "")
+    .replace(/-+$/, "")
+    .replace(/--+/g, "-");
+}
+
+function titleCase(value) {
+  return value
+    .trim()
+    .replace(/[-_]+/g, " ")
+    .replace(/\s+/g, " ")
+    .replace(/\b\w/g, (char) => char.toUpperCase());
+}
+
+const MIME_MAP = {
+  ".md": "text/markdown",
+  ".ts": "text/plain",
+  ".js": "text/javascript",
+  ".mjs": "text/javascript",
+  ".json": "application/json",
+  ".yml": "text/yaml",
+  ".yaml": "text/yaml",
+  ".txt": "text/plain",
+  ".html": "text/html",
+  ".css": "text/css",
+  ".xml": "text/xml",
+  ".svg": "image/svg+xml",
+};
+
+function mimeType(relPath) {
+  const ext = path.extname(relPath).toLowerCase();
+  return MIME_MAP[ext] || "text/plain";
+}
+
+function parseBoolean(value) {
+  return ["1", "true", "yes", "on"].includes(String(value).trim().toLowerCase());
+}
+
+main().catch((error) => {
+  console.error(error instanceof Error ? error.message : String(error));
+  process.exit(1);
+});
@@ -0,0 +1,528 @@
+#!/usr/bin/env node
+
+import crypto from "node:crypto";
+import fs from "node:fs/promises";
+import { existsSync } from "node:fs";
+import path from "node:path";
+import os from "node:os";
+
+const DEFAULT_REGISTRY = "https://clawhub.ai";
+const TEXT_EXTENSIONS = new Set([
+  "md",
+  "mdx",
+  "txt",
+  "json",
+  "json5",
+  "yaml",
+  "yml",
+  "toml",
+  "js",
+  "cjs",
+  "mjs",
+  "ts",
+  "tsx",
+  "jsx",
+  "py",
+  "sh",
+  "rb",
+  "go",
+  "rs",
+  "swift",
+  "kt",
+  "java",
+  "cs",
+  "cpp",
+  "c",
+  "h",
+  "hpp",
+  "sql",
+  "csv",
+  "ini",
+  "cfg",
+  "env",
+  "xml",
+  "html",
+  "css",
+  "scss",
+  "sass",
+  "svg",
+]);
+
+async function main() {
+  const options = parseArgs(process.argv.slice(2));
+  const config = await readClawhubConfig();
+  const registry = (
+    process.env.CLAWHUB_REGISTRY ||
+    process.env.CLAWDHUB_REGISTRY ||
+    config.registry ||
+    DEFAULT_REGISTRY
+  ).replace(/\/+$/, "");
+
+  if (!config.token) {
+    throw new Error("Not logged in. Run: clawhub login");
+  }
+
+  await apiJson(registry, config.token, "/api/v1/whoami");
+
+  const roots = options.roots.length > 0 ? options.roots : [path.resolve("skills")];
+  const skills = await findSkills(roots);
+
+  if (skills.length === 0) {
+    throw new Error("No skills found.");
+  }
+
+  console.log("ClawHub sync");
+  console.log(`Roots with skills: ${roots.join(", ")}`);
+
+  const locals = await mapWithConcurrency(skills, options.concurrency, async (skill) => {
+    const files = await listTextFiles(skill.folder);
+    const fingerprint = buildFingerprint(files);
+    return {
+      ...skill,
+      fileCount: files.length,
+      fingerprint,
+    };
+  });
+
+  const candidates = await mapWithConcurrency(locals, options.concurrency, async (skill) => {
+    const query = new URLSearchParams({
+      slug: skill.slug,
+      hash: skill.fingerprint,
+    });
+    const { status, body } = await apiJsonWithStatus(
+      registry,
+      config.token,
+      `/api/v1/resolve?${query.toString()}`
+    );
+
+    if (status === 404) {
+      return {
+        ...skill,
+        status: "new",
+        latestVersion: null,
+        matchVersion: null,
+      };
+    }
+
+    if (status !== 200) {
+      throw new Error(body?.message || `Resolve failed for ${skill.slug} (HTTP ${status})`);
+    }
+
+    const latestVersion = body?.latestVersion?.version ?? null;
+    const matchVersion = body?.match?.version ?? null;
+
+    if (!latestVersion) {
+      return {
+        ...skill,
+        status: "new",
+        latestVersion: null,
+        matchVersion: null,
+      };
+    }
+
+    return {
+      ...skill,
+      status: matchVersion ? "synced" : "update",
+      latestVersion,
+      matchVersion,
+    };
+  });
+
+  const actionable = candidates.filter((candidate) => candidate.status !== "synced");
+  if (actionable.length === 0) {
+    console.log("Nothing to sync.");
+    return;
+  }
+
+  console.log("");
+  console.log("To sync");
+  for (const candidate of actionable) {
+    console.log(`- ${formatCandidate(candidate, options.bump)}`);
+  }
+
+  if (options.dryRun) {
+    console.log("");
+    console.log(`Dry run: would upload ${actionable.length} skill(s).`);
+    return;
+  }
+
+  const tags = options.tags
+    .split(",")
+    .map((tag) => tag.trim())
+    .filter(Boolean);
+
+  for (const candidate of actionable) {
+    const version =
+      candidate.status === "new"
+        ? "1.0.0"
+        : bumpSemver(candidate.latestVersion, options.bump);
+
+    console.log(`Publishing ${candidate.slug}@${version}`);
+    const files = await listTextFiles(candidate.folder);
+    await publishSkill({
+      registry,
+      token: config.token,
+      skill: candidate,
+      files,
+      version,
+      changelog: options.changelog,
+      tags,
+    });
+  }
+
+  console.log("");
+  console.log(`Uploaded ${actionable.length} skill(s).`);
+}
+
+function parseArgs(argv) {
+  const options = {
+    roots: [],
+    dryRun: false,
+    bump: "patch",
+    changelog: "",
+    tags: "latest",
+    concurrency: 4,
+  };
+
+  for (let index = 0; index < argv.length; index += 1) {
+    const arg = argv[index];
+    if (arg === "--dry-run") {
+      options.dryRun = true;
+      continue;
+    }
+    if (arg === "--all") {
+      continue;
+    }
+    if (arg === "--root") {
+      const value = argv[index + 1];
+      if (!value) throw new Error("--root requires a directory");
+      options.roots.push(path.resolve(value));
+      index += 1;
+      continue;
+    }
+    if (arg === "--bump") {
+      const value = argv[index + 1];
+      if (!["patch", "minor", "major"].includes(value)) {
+        throw new Error("--bump must be patch, minor, or major");
+      }
+      options.bump = value;
+      index += 1;
+      continue;
+    }
+    if (arg === "--changelog") {
+      const value = argv[index + 1];
+      if (value == null) throw new Error("--changelog requires text");
+      options.changelog = value;
+      index += 1;
+      continue;
+    }
+    if (arg === "--tags") {
+      const value = argv[index + 1];
+      if (value == null) throw new Error("--tags requires a value");
+      options.tags = value;
+      index += 1;
+      continue;
+    }
+    if (arg === "--concurrency") {
+      const value = Number(argv[index + 1]);
+      if (!Number.isInteger(value) || value < 1 || value > 32) {
+        throw new Error("--concurrency must be an integer between 1 and 32");
+      }
+      options.concurrency = value;
+      index += 1;
+      continue;
+    }
+    if (arg === "-h" || arg === "--help") {
+      printUsage();
+      process.exit(0);
+    }
+    throw new Error(`Unknown argument: ${arg}`);
+  }
+
+  return options;
+}
+
+function printUsage() {
+  console.log(`Usage: sync-clawhub.mjs [options]
+
+Options:
+  --root <dir>         Extra skill root (repeatable)
+  --all                Accepted for compatibility
+  --dry-run            Show what would be uploaded
+  --bump <type>        patch | minor | major
+  --changelog <text>   Changelog for updates
+  --tags <tags>        Comma-separated tags
+  --concurrency <n>    Registry check concurrency (1-32)
+  -h, --help           Show help`);
+}
+
+async function readClawhubConfig() {
+  const configPath = getConfigPath();
+  try {
+    return JSON.parse(await fs.readFile(configPath, "utf8"));
+  } catch {
+    return {};
+  }
+}
+
+function getConfigPath() {
+  const override =
+    process.env.CLAWHUB_CONFIG_PATH?.trim() || process.env.CLAWDHUB_CONFIG_PATH?.trim();
+  if (override) {
+    return path.resolve(override);
+  }
+
+  const home = os.homedir();
+  if (process.platform === "darwin") {
+    const clawhub = path.join(home, "Library", "Application Support", "clawhub", "config.json");
+    const clawdhub = path.join(home, "Library", "Application Support", "clawdhub", "config.json");
+    return pathForExistingConfig(clawhub, clawdhub);
+  }
+
+  const xdg = process.env.XDG_CONFIG_HOME;
+  if (xdg) {
+    const clawhub = path.join(xdg, "clawhub", "config.json");
+    const clawdhub = path.join(xdg, "clawdhub", "config.json");
+    return pathForExistingConfig(clawhub, clawdhub);
+  }
+
+  if (process.platform === "win32" && process.env.APPDATA) {
+    const clawhub = path.join(process.env.APPDATA, "clawhub", "config.json");
+    const clawdhub = path.join(process.env.APPDATA, "clawdhub", "config.json");
+    return pathForExistingConfig(clawhub, clawdhub);
+  }
+
+  const clawhub = path.join(home, ".config", "clawhub", "config.json");
+  const clawdhub = path.join(home, ".config", "clawdhub", "config.json");
+  return pathForExistingConfig(clawhub, clawdhub);
+}
+
+function pathForExistingConfig(primary, legacy) {
+  if (existsSync(primary)) return path.resolve(primary);
+  if (existsSync(legacy)) return path.resolve(legacy);
+  return path.resolve(primary);
+}
+
+async function findSkills(roots) {
+  const deduped = new Map();
+  for (const root of roots) {
+    const folders = await findSkillFolders(root);
+    for (const folder of folders) {
+      deduped.set(folder.slug, folder);
+    }
+  }
+  return [...deduped.values()].sort((left, right) => left.slug.localeCompare(right.slug));
+}
+
+async function findSkillFolders(root) {
+  const stat = await safeStat(root);
+  if (!stat?.isDirectory()) return [];
+
+  if (await hasSkillMarker(root)) {
+    return [buildSkillEntry(root)];
+  }
+
+  const entries = await fs.readdir(root, { withFileTypes: true });
+  const found = [];
+  for (const entry of entries) {
+    if (!entry.isDirectory()) continue;
+    const folder = path.join(root, entry.name);
+    if (await hasSkillMarker(folder)) {
+      found.push(buildSkillEntry(folder));
+    }
+  }
+  return found;
+}
+
+function buildSkillEntry(folder) {
+  const base = path.basename(folder);
+  return {
+    folder,
+    slug: sanitizeSlug(base),
+    displayName: titleCase(base),
+  };
+}
+
+async function hasSkillMarker(folder) {
+  return Boolean(
+    (await safeStat(path.join(folder, "SKILL.md")))?.isFile() ||
+      (await safeStat(path.join(folder, "skill.md")))?.isFile()
+  );
+}
+
+async function listTextFiles(root) {
+  const files = [];
+
+  async function walk(folder) {
+    const entries = await fs.readdir(folder, { withFileTypes: true });
+    for (const entry of entries) {
+      if (entry.name.startsWith(".")) continue;
+      if (entry.name === "node_modules") continue;
+      if (entry.name === ".clawhub" || entry.name === ".clawdhub") continue;
+
+      const fullPath = path.join(folder, entry.name);
+      if (entry.isDirectory()) {
+        await walk(fullPath);
+        continue;
+      }
+      if (!entry.isFile()) continue;
+
+      const relPath = path.relative(root, fullPath).split(path.sep).join("/");
+      const ext = relPath.split(".").pop()?.toLowerCase() ?? "";
+      if (!TEXT_EXTENSIONS.has(ext)) continue;
+
+      const bytes = await fs.readFile(fullPath);
+      files.push({ relPath, bytes });
+    }
+  }
+
+  await walk(root);
+  files.sort((left, right) => left.relPath.localeCompare(right.relPath));
+  return files;
+}
+
+function buildFingerprint(files) {
+  const payload = files
+    .map((file) => `${file.relPath}:${sha256(file.bytes)}`)
+    .sort((left, right) => left.localeCompare(right))
+    .join("\n");
+  return crypto.createHash("sha256").update(payload).digest("hex");
+}
+
+function sha256(bytes) {
+  return crypto.createHash("sha256").update(bytes).digest("hex");
+}
+
+async function publishSkill({ registry, token, skill, files, version, changelog, tags }) {
+  const form = new FormData();
+  form.set(
+    "payload",
+    JSON.stringify({
+      slug: skill.slug,
+      displayName: skill.displayName,
+      version,
+      changelog,
+      tags,
+      acceptLicenseTerms: true,
+    })
+  );
+
+  for (const file of files) {
+    form.append("files", new Blob([file.bytes], { type: "text/plain" }), file.relPath);
+  }
+
+  const response = await fetch(`${registry}/api/v1/skills`, {
+    method: "POST",
+    headers: {
+      Accept: "application/json",
+      Authorization: `Bearer ${token}`,
+    },
+    body: form,
+  });
+
+  const text = await response.text();
+  if (!response.ok) {
+    throw new Error(text || `Publish failed for ${skill.slug} (HTTP ${response.status})`);
+  }
+
+  const result = text ? JSON.parse(text) : {};
+  console.log(`OK. Published ${skill.slug}@${version}${result.versionId ? ` (${result.versionId})` : ""}`);
+}
+
+async function apiJson(registry, token, requestPath) {
+  const { status, body } = await apiJsonWithStatus(registry, token, requestPath);
+  if (status < 200 || status >= 300) {
+    throw new Error(body?.message || `HTTP ${status}`);
+  }
+  return body;
+}
+
+async function apiJsonWithStatus(registry, token, requestPath) {
+  const response = await fetch(`${registry}${requestPath}`, {
+    headers: {
+      Accept: "application/json",
+      Authorization: `Bearer ${token}`,
+    },
+  });
+
+  const text = await response.text();
+  let body = null;
+  try {
+    body = text ? JSON.parse(text) : null;
+  } catch {
+    body = { message: text };
+  }
+  return { status: response.status, body };
+}
+
+async function mapWithConcurrency(items, limit, fn) {
+  const results = new Array(items.length);
+  let cursor = 0;
+
+  async function worker() {
+    while (cursor < items.length) {
+      const index = cursor;
+      cursor += 1;
+      results[index] = await fn(items[index], index);
+    }
+  }
+
+  const count = Math.min(Math.max(limit, 1), Math.max(items.length, 1));
+  await Promise.all(Array.from({ length: count }, () => worker()));
+  return results;
+}
+
+function formatCandidate(candidate, bump) {
+  if (candidate.status === "new") {
+    return `${candidate.slug}  NEW  (${candidate.fileCount} files)`;
+  }
+  return `${candidate.slug}  UPDATE ${candidate.latestVersion} -> ${bumpSemver(
+    candidate.latestVersion,
+    bump
+  )}  (${candidate.fileCount} files)`;
+}
+
+function bumpSemver(version, bump) {
+  const match = /^(\d+)\.(\d+)\.(\d+)$/.exec(version ?? "");
+  if (!match) {
+    throw new Error(`Invalid semver: ${version}`);
+  }
+  const major = Number(match[1]);
+  const minor = Number(match[2]);
+  const patch = Number(match[3]);
+
+  if (bump === "major") return `${major + 1}.0.0`;
+  if (bump === "minor") return `${major}.${minor + 1}.0`;
+  return `${major}.${minor}.${patch + 1}`;
+}
+
+function sanitizeSlug(value) {
+  return value
+    .trim()
+    .toLowerCase()
+    .replace(/[^a-z0-9-]+/g, "-")
+    .replace(/^-+/, "")
+    .replace(/-+$/, "")
+    .replace(/--+/g, "-");
+}
+
+function titleCase(value) {
+  return value
+    .trim()
+    .replace(/[-_]+/g, " ")
+    .replace(/\s+/g, " ")
+    .replace(/\b\w/g, (char) => char.toUpperCase());
+}
+
+async function safeStat(filePath) {
+  try {
+    return await fs.stat(filePath);
+  } catch {
+    return null;
+  }
+}
+
+main().catch((error) => {
+  console.error(error instanceof Error ? error.message : String(error));
+  process.exit(1);
+});
@@ -0,0 +1,16 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+SKILLS_DIR="${ROOT_DIR}/skills"
+
+if ! command -v node >/dev/null 2>&1; then
+  echo "Error: node is required."
+  exit 1
+fi
+
+if [ "$#" -eq 0 ]; then
+  set -- --all
+fi
+
+exec node "${ROOT_DIR}/scripts/sync-clawhub.mjs" --root "${SKILLS_DIR}" "$@"
@@ -0,0 +1,70 @@
+#!/usr/bin/env node
+
+import path from "node:path";
+
+import {
+  ensureManagedPathsClean,
+  syncSharedSkillPackages,
+} from "./lib/shared-skill-packages.mjs";
+
+async function main() {
+  const options = parseArgs(process.argv.slice(2));
+  const repoRoot = path.resolve(options.repoRoot);
+  const result = await syncSharedSkillPackages(repoRoot, {
+    targets: options.targets,
+  });
+
+  if (options.enforceClean) {
+    ensureManagedPathsClean(repoRoot, result.managedPaths);
+  }
+
+  console.log(`Synced shared workspace packages into ${result.packageDirs.length} skill script package(s).`);
+}
+
+function parseArgs(argv) {
+  const options = {
+    repoRoot: process.cwd(),
+    enforceClean: false,
+    targets: [],
+  };
+
+  for (let index = 0; index < argv.length; index += 1) {
+    const arg = argv[index];
+    if (arg === "--repo-root") {
+      options.repoRoot = argv[index + 1] ?? options.repoRoot;
+      index += 1;
+      continue;
+    }
+    if (arg === "--enforce-clean") {
+      options.enforceClean = true;
+      continue;
+    }
+    if (arg === "--target") {
+      options.targets.push(argv[index + 1] ?? "");
+      index += 1;
+      continue;
+    }
+    if (arg === "-h" || arg === "--help") {
+      printUsage();
+      process.exit(0);
+    }
+    throw new Error(`Unknown argument: ${arg}`);
+  }
+
+  return options;
+}
+
+function printUsage() {
+  console.log(`Usage: sync-shared-skill-packages.mjs [options]
+
+Options:
+  --repo-root <dir>   Repository root (default: current directory)
+  --target <dir>      Sync only one skill directory (can be repeated)
+  --enforce-clean     Fail if managed files change after sync
+  -h, --help          Show help`);
+}
+
+main().catch((error) => {
+  console.error(error instanceof Error ? error.message : String(error));
+  process.exit(1);
+});
@@ -1,6 +1,10 @@
 ---
 name: baoyu-article-illustrator
 description: Analyzes article structure, identifies positions requiring visual aids, generates illustrations with Type × Style two-dimension approach. Use when user asks to "illustrate article", "add images", "generate images for article", or "为文章配图".
+version: 1.56.1
+metadata:
+  openclaw:
+    homepage: https://github.com/JimLiu/baoyu-skills#baoyu-article-illustrator
 ---

 # Article Illustrator
@@ -16,6 +20,8 @@ Analyze articles, identify illustration positions, generate images with Type ×

 Combine freely: `--type infographic --style blueprint`

+Or use presets: `--preset tech-explainer` → type + style in one flag. See [Style Presets](references/style-presets.md).
+
 ## Types

 | Type | Best For |
@@ -49,12 +55,15 @@ See [references/styles.md](references/styles.md) for Core Styles, full gallery,
 ```bash
 # macOS, Linux, WSL, Git Bash
 test -f .baoyu-skills/baoyu-article-illustrator/EXTEND.md && echo "project"
+test -f "${XDG_CONFIG_HOME:-$HOME/.config}/baoyu-skills/baoyu-article-illustrator/EXTEND.md" && echo "xdg"
 test -f "$HOME/.baoyu-skills/baoyu-article-illustrator/EXTEND.md" && echo "user"
 ```

 ```powershell
 # PowerShell (Windows)
 if (Test-Path .baoyu-skills/baoyu-article-illustrator/EXTEND.md) { "project" }
+$xdg = if ($env:XDG_CONFIG_HOME) { $env:XDG_CONFIG_HOME } else { "$HOME/.config" }
+if (Test-Path "$xdg/baoyu-skills/baoyu-article-illustrator/EXTEND.md") { "xdg" }
 if (Test-Path "$HOME/.baoyu-skills/baoyu-article-illustrator/EXTEND.md") { "user" }
 ```

@@ -80,13 +89,13 @@ Full procedures: [references/workflow.md](references/workflow.md#step-2-setup--a

 ### Step 3: Confirm Settings ⚠️

-**ONE AskUserQuestion, max 4 Qs. Q1-Q3 REQUIRED.**
+**ONE AskUserQuestion, max 4 Qs. Q1-Q2 REQUIRED. Q3 required unless preset chosen.**

 | Q | Options |
 |---|---------|
-| **Q1: Type** | [Recommended], infographic, scene, flowchart, comparison, framework, timeline, mixed |
+| **Q1: Preset or Type** | [Recommended preset], [alt preset], or manual: 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 |
+| **Q3: Style** | [Recommended], minimal-flat, sci-fi, hand-drawn, editorial, scene, poster, Other — **skip if preset chosen** |
 | Q4: Language | When article language ≠ EXTEND.md setting |

 Full procedures: [references/workflow.md](references/workflow.md#step-3-confirm-settings-)
@@ -109,6 +118,8 @@ Full template: [references/workflow.md](references/workflow.md#step-4-generate-o

 ⛔ **BLOCKING: Prompt files MUST be saved before ANY image generation.**

+**Execution strategy**: When multiple illustrations have saved prompt files and the task is now plain generation, prefer `baoyu-image-gen` batch mode (`build-batch.ts` → `--batchfile`) over spawning subagents. Use subagents only when each image still needs separate prompt iteration or creative exploration.
+
 1. For each illustration, create a prompt file per [references/prompt-construction.md](references/prompt-construction.md)
 2. Save to `prompts/NN-{type}-{slug}.md` with YAML frontmatter
 3. Prompts **MUST** use type-specific templates with structured sections (ZONES / LABELS / COLORS / STYLE / ASPECT)
@@ -158,5 +169,6 @@ illustrations/{topic-slug}/
 | [references/workflow.md](references/workflow.md) | Detailed procedures |
 | [references/usage.md](references/usage.md) | Command syntax |
 | [references/styles.md](references/styles.md) | Style gallery |
+| [references/style-presets.md](references/style-presets.md) | Preset shortcuts (type + style) |
 | [references/prompt-construction.md](references/prompt-construction.md) | Prompt templates |
 | [references/config/first-time-setup.md](references/config/first-time-setup.md) | First-time setup |
@@ -236,6 +236,38 @@ STYLE: [style characteristics]
 ASPECT: 16:9
 ```

+### Screen-Print Style Override
+
+When `style: screen-print`, replace standard style instructions with:
+
+```
+Screen print / silkscreen poster art. Flat color blocks, NO gradients.
+COLORS: 2-5 colors maximum. [Choose from style palette or duotone pair]
+TEXTURE: Halftone dot patterns, slight color layer misregistration, paper grain
+COMPOSITION: Bold silhouettes, geometric framing, negative space as storytelling element
+FIGURES: Silhouettes only, no detailed faces, stencil-cut edges
+TYPOGRAPHY: Bold condensed sans-serif integrated into composition (not overlaid)
+```
+
+**Scene + screen-print**:
+```
+Conceptual poster scene. Single symbolic focal point, NOT literal illustration.
+COLORS: Duotone pair (e.g., Burnt Orange #E8751A + Deep Teal #0A6E6E) on Off-Black #121212
+COMPOSITION: Centered silhouette or geometric frame, 60%+ negative space
+TEXTURE: Halftone dots, paper grain, slight print misregistration
+```
+
+**Comparison + screen-print**:
+```
+Split poster composition. Each side dominated by one color from duotone pair.
+LEFT: [Color A] side with silhouette/icon for [Option A]
+RIGHT: [Color B] side with silhouette/icon for [Option B]
+DIVIDER: Geometric shape or negative space boundary
+TEXTURE: Halftone transitions between sides
+```
+
+---
+
 ## What to Avoid

 - Vague descriptions ("a nice image")
@@ -0,0 +1,72 @@
+# Style Presets
+
+`--preset X` expands to a type + style combination. Users can override either dimension.
+
+## By Category
+
+### Technical & Engineering
+
+| --preset | Type | Style | Best For |
+|----------|------|-------|----------|
+| `tech-explainer` | `infographic` | `blueprint` | API docs, system metrics, technical deep-dives |
+| `system-design` | `framework` | `blueprint` | Architecture diagrams, system design |
+| `architecture` | `framework` | `vector-illustration` | Component relationships, module structure |
+| `science-paper` | `infographic` | `scientific` | Research findings, lab results, academic |
+
+### Knowledge & Education
+
+| --preset | Type | Style | Best For |
+|----------|------|-------|----------|
+| `knowledge-base` | `infographic` | `vector-illustration` | Concept explainers, tutorials, how-to |
+| `saas-guide` | `infographic` | `notion` | Product guides, SaaS docs, tool walkthroughs |
+| `tutorial` | `flowchart` | `vector-illustration` | Step-by-step tutorials, setup guides |
+| `process-flow` | `flowchart` | `notion` | Workflow documentation, onboarding flows |
+
+### Data & Analysis
+
+| --preset | Type | Style | Best For |
+|----------|------|-------|----------|
+| `data-report` | `infographic` | `editorial` | Data journalism, metrics reports, dashboards |
+| `versus` | `comparison` | `vector-illustration` | Tech comparisons, framework shootouts |
+| `business-compare` | `comparison` | `elegant` | Product evaluations, strategy options |
+
+### Narrative & Creative
+
+| --preset | Type | Style | Best For |
+|----------|------|-------|----------|
+| `storytelling` | `scene` | `warm` | Personal essays, reflections, growth stories |
+| `lifestyle` | `scene` | `watercolor` | Travel, wellness, lifestyle, creative |
+| `history` | `timeline` | `elegant` | Historical overviews, milestones |
+| `evolution` | `timeline` | `warm` | Progress narratives, growth journeys |
+
+### Editorial & Opinion
+
+| --preset | Type | Style | Best For |
+|----------|------|-------|----------|
+| `opinion-piece` | `scene` | `screen-print` | Op-eds, commentary, critical essays |
+| `editorial-poster` | `comparison` | `screen-print` | Debate, contrasting viewpoints |
+| `cinematic` | `scene` | `screen-print` | Dramatic narratives, cultural essays |
+
+## Content Type → Preset Recommendations
+
+Use this table during Step 3 to recommend presets based on Step 2 content analysis:
+
+| Content Type (Step 2) | Primary Preset | Alternatives |
+|------------------------|----------------|--------------|
+| Technical | `tech-explainer` | `system-design`, `architecture` |
+| Tutorial | `tutorial` | `process-flow`, `knowledge-base` |
+| Methodology / Framework | `system-design` | `architecture`, `process-flow` |
+| Data / Metrics | `data-report` | `versus`, `tech-explainer` |
+| Comparison / Review | `versus` | `business-compare`, `editorial-poster` |
+| Narrative / Personal | `storytelling` | `lifestyle`, `evolution` |
+| Opinion / Editorial | `opinion-piece` | `cinematic`, `editorial-poster` |
+| Historical / Timeline | `history` | `evolution` |
+| Academic / Research | `science-paper` | `tech-explainer`, `data-report` |
+| SaaS / Product | `saas-guide` | `knowledge-base`, `process-flow` |
+
+## Override Examples
+
+- `--preset tech-explainer --style notion` = infographic type with notion style
+- `--preset storytelling --type timeline` = timeline type with warm style
+
+Explicit `--type`/`--style` flags always override preset values.
@@ -12,6 +12,7 @@ Simplified style tier for quick selection:
 | `hand-drawn` | sketch/warm | Relaxed, reflective, casual content |
 | `editorial` | editorial | Processes, data, journalism |
 | `scene` | warm/watercolor | Narratives, emotional, lifestyle |
+| `poster` | screen-print | Opinion, editorial, cultural, cinematic |

 Use Core Styles for most cases. See full Style Gallery below for granular control.

@@ -40,6 +41,7 @@ Use Core Styles for most cases. See full Style Gallery below for granular contro
 | `playful` | Whimsical pastel doodles | Fun, casual, educational |
 | `retro` | 80s/90s neon geometric | 80s/90s nostalgic, bold |
 | `sketch` | Raw pencil notebook style | Brainstorming, creative exploration |
+| `screen-print` | Bold poster art, halftone textures, limited colors | Opinion, editorial, cultural, cinematic |
 | `sketch-notes` | Soft hand-drawn warm notes | Educational, warm notes |
 | `vintage` | Aged parchment historical | Historical, heritage |

@@ -47,14 +49,14 @@ Full specifications: `references/styles/<style>.md`

 ## Type × Style Compatibility Matrix

-| | vector-illustration | notion | warm | minimal | blueprint | watercolor | elegant | editorial | scientific |
-|---|:---:|:---:|:---:|:---:|:---:|:---:|:---:|:---:|:---:|
-| infographic | ✓✓ | ✓✓ | ✓ | ✓✓ | ✓✓ | ✓ | ✓✓ | ✓✓ | ✓✓ |
-| scene | ✓ | ✓ | ✓✓ | ✓ | ✗ | ✓✓ | ✓ | ✓ | ✗ |
-| flowchart | ✓✓ | ✓✓ | ✓ | ✓ | ✓✓ | ✗ | ✓ | ✓✓ | ✓ |
-| comparison | ✓✓ | ✓✓ | ✓ | ✓✓ | ✓ | ✓ | ✓✓ | ✓✓ | ✓ |
-| framework | ✓✓ | ✓✓ | ✓ | ✓✓ | ✓✓ | ✗ | ✓✓ | ✓ | ✓✓ |
-| timeline | ✓ | ✓✓ | ✓ | ✓ | ✓ | ✓✓ | ✓✓ | ✓✓ | ✓ |
+| | vector-illustration | notion | warm | minimal | blueprint | watercolor | elegant | editorial | scientific | screen-print |
+|---|:---:|:---:|:---:|:---:|:---:|:---:|:---:|:---:|:---:|:---:|
+| infographic | ✓✓ | ✓✓ | ✓ | ✓✓ | ✓✓ | ✓ | ✓✓ | ✓✓ | ✓✓ | ✓ |
+| scene | ✓ | ✓ | ✓✓ | ✓ | ✗ | ✓✓ | ✓ | ✓ | ✗ | ✓✓ |
+| flowchart | ✓✓ | ✓✓ | ✓ | ✓ | ✓✓ | ✗ | ✓ | ✓✓ | ✓ | ✗ |
+| comparison | ✓✓ | ✓✓ | ✓ | ✓✓ | ✓ | ✓ | ✓✓ | ✓✓ | ✓ | ✓ |
+| framework | ✓✓ | ✓✓ | ✓ | ✓✓ | ✓✓ | ✗ | ✓✓ | ✓ | ✓✓ | ✓ |
+| timeline | ✓ | ✓✓ | ✓ | ✓ | ✓ | ✓✓ | ✓✓ | ✓✓ | ✓ | ✓ |

 ✓✓ = highly recommended | ✓ = compatible | ✗ = not recommended

@@ -83,6 +85,7 @@ Full specifications: `references/styles/<style>.md`
 | History, timeline, progress, evolution | timeline | elegant, warm |
 | Productivity, SaaS, tool, app, software | infographic | notion, vector-illustration |
 | Business, professional, strategy, corporate | framework | elegant |
+| Opinion, editorial, culture, philosophy, cinematic, dramatic, poster | scene | screen-print |
 | Biology, chemistry, medical, scientific | infographic | scientific |
 | Explainer, journalism, magazine, investigation | infographic | editorial |

@@ -172,3 +175,22 @@ Full specifications: `references/styles/<style>.md`
 - Organic flow
 - Personal journey feel
 - Growth narratives
+
+### scene + screen-print
+- Bold silhouettes, symbolic compositions
+- 2-5 flat colors with halftone textures
+- Figure-ground inversion (negative space tells secondary story)
+- Vintage poster aesthetic, conceptual not literal
+- Great for opinion pieces and cultural commentary
+
+### comparison + screen-print
+- Split duotone composition (one color per side)
+- Bold geometric dividers
+- Symbolic icons over detailed rendering
+- High contrast, immediate visual impact
+
+### framework + screen-print
+- Geometric node representations with stencil-cut edges
+- Limited color coding (one color per concept level)
+- Clean silhouette-based iconography
+- Poster-style hierarchy with bold typography
@@ -0,0 +1,70 @@
+# screen-print
+
+Bold poster art with limited colors, halftone textures, and symbolic storytelling
+
+## Design Aesthetic
+
+Screen print / silkscreen aesthetic inspired by Mondo limited-edition posters and vintage concert prints. Flat color blocks, halftone dot patterns, bold silhouettes, and deliberate print imperfections. Conceptual and symbolic rather than literal — one iconic image tells the whole story. Perfect for opinion pieces, cultural commentary, and editorial content.
+
+## Background
+
+- Color: Off-Black (#121212) or Warm Cream (#F5E6D0)
+- Texture: Paper grain with subtle halftone dot overlay
+
+## Color Palette
+
+| Role | Color | Hex | Usage |
+|------|-------|-----|-------|
+| Background | Off-Black | #121212 | Dark compositions |
+| Background Alt | Warm Cream | #F5E6D0 | Light compositions |
+| Primary | Burnt Orange | #E8751A | Main accent |
+| Secondary | Deep Teal | #0A6E6E | Contrast accent |
+| Tertiary | Crimson | #C0392B | Bold emphasis |
+| Highlight | Amber | #F4A623 | Small accents |
+| Text | Cream White | #FAF3E0 | On dark backgrounds |
+
+**Duotone Pairs** (choose ONE pair for high-impact compositions):
+
+| Pair | Color A | Color B | Feel |
+|------|---------|---------|------|
+| Orange + Teal | #E8751A | #0A6E6E | Cinematic, action |
+| Red + Cream | #C0392B | #F5E6D0 | Bold, classic |
+| Blue + Gold | #1A3A5C | #D4A843 | Prestigious, premium |
+| Crimson + Navy | #DC143C | #0D1B2A | Dramatic, noir |
+
+**Rule**: Use 2-5 colors maximum. Fewer colors = stronger impact.
+
+## Visual Elements
+
+- Bold silhouettes and symbolic shapes
+- Halftone dot patterns within color fills
+- Slight color layer misregistration (print offset effect)
+- Geometric framing (circles, arches, triangles)
+- Figure-ground inversion (negative space forms secondary image)
+- Stencil-cut edges, no outlines — shapes defined by color boundaries
+- Typography integrated as design element, not overlay
+- Vintage poster border treatments
+
+## Style Rules
+
+### Do
+
+- Limit to 2-5 flat colors
+- Use bold silhouettes over detailed rendering
+- Let negative space tell part of the story
+- Add halftone texture for authenticity
+- Use geometric composition (centered, symmetrical)
+- Reference vintage decades (60s/70s/80s) for era feel
+
+### Don't
+
+- Use photorealistic rendering or gradients
+- Add complex facial details (silhouettes preferred)
+- Mix too many visual elements (one focal point)
+- Use modern digital aesthetic
+- Create busy or cluttered compositions
+- Use more than 5 colors
+
+## Best For
+
+Opinion/editorial articles, cultural commentary, philosophy and strategy, dramatic narratives, cinematic storytelling, music and entertainment, event announcements, bold branding content
@@ -29,6 +29,7 @@
 |--------|-------------|
 | `--type <name>` | Illustration type (see Type Gallery in SKILL.md) |
 | `--style <name>` | Visual style (see references/styles.md) |
+| `--preset <name>` | Shorthand for type + style combo (see [references/style-presets.md](references/style-presets.md)) |
 | `--density <level>` | Image count: minimal / balanced / rich |

 ## Input Modes
@@ -55,12 +56,27 @@ Configure in EXTEND.md: `default_output_dir: illustrations-subdir`
 /baoyu-article-illustrator api-design.md --type infographic --style blueprint
 ```

+**Same thing with preset**:
+```bash
+/baoyu-article-illustrator api-design.md --preset tech-explainer
+```
+
 **Personal story**:
 ```bash
-/baoyu-article-illustrator journey.md --type scene --style warm
+/baoyu-article-illustrator journey.md --preset storytelling
 ```

 **Tutorial with steps**:
 ```bash
-/baoyu-article-illustrator how-to-deploy.md --type flowchart --density rich
+/baoyu-article-illustrator how-to-deploy.md --preset tutorial --density rich
+```
+
+**Opinion article with poster style**:
+```bash
+/baoyu-article-illustrator opinion.md --preset opinion-piece
+```
+
+**Preset with override**:
+```bash
+/baoyu-article-illustrator article.md --preset tech-explainer --style notion
 ```
@@ -88,12 +88,15 @@ Check preferences and existing state, then ask ALL needed questions in ONE AskUs
 ```bash
 # macOS, Linux, WSL, Git Bash
 test -f .baoyu-skills/baoyu-article-illustrator/EXTEND.md && echo "project"
+test -f "${XDG_CONFIG_HOME:-$HOME/.config}/baoyu-skills/baoyu-article-illustrator/EXTEND.md" && echo "xdg"
 test -f "$HOME/.baoyu-skills/baoyu-article-illustrator/EXTEND.md" && echo "user"
 ```

 ```powershell
 # PowerShell (Windows)
 if (Test-Path .baoyu-skills/baoyu-article-illustrator/EXTEND.md) { "project" }
+$xdg = if ($env:XDG_CONFIG_HOME) { $env:XDG_CONFIG_HOME } else { "$HOME/.config" }
+if (Test-Path "$xdg/baoyu-skills/baoyu-article-illustrator/EXTEND.md") { "xdg" }
 if (Test-Path "$HOME/.baoyu-skills/baoyu-article-illustrator/EXTEND.md") { "user" }
 ```

@@ -165,9 +168,16 @@ For each reference image:

 **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
+### Q1: Preset or Type ⚠️ REQUIRED
+
+Based on Step 2 content analysis, recommend a preset first (sets both type & style). Look up [style-presets.md](style-presets.md) "Content Type → Preset Recommendations" table.
+
+- [Recommended preset] — [brief: type + style + why] (Recommended)
+- [Alternative preset] — [brief]
+- Or choose type manually: infographic / scene / flowchart / comparison / framework / timeline / mixed
+
+**If user picks a preset → skip Q3** (type & style both resolved).
+**If user picks a type → Q3 is REQUIRED.**

 ### Q2: Density ⚠️ REQUIRED - DO NOT SKIP
 - minimal (1-2) - Core concepts only
@@ -175,7 +185,7 @@ For each reference image:
 - 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)
+### Q3: Style ⚠️ REQUIRED (skip if preset chosen in Q1)

 If EXTEND.md has `preferred_style`:
 - [Custom style name + brief description] (Recommended)
@@ -191,13 +201,14 @@ If no `preferred_style` (present Core Styles first):

 **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 |
+| Core Style | Maps To | Best For |
+|------------|---------|----------|
+| `minimal-flat` | notion | General, knowledge sharing, SaaS |
+| `sci-fi` | blueprint | AI, frontier tech, system design |
+| `hand-drawn` | sketch/warm | Relaxed, reflective, casual |
+| `editorial` | editorial | Processes, data, journalism |
+| `scene` | warm/watercolor | Narratives, emotional, lifestyle |
+| `poster` | screen-print | Opinion, editorial, cultural, cinematic |

 Style selection based on Type × Style compatibility matrix (styles.md).
 Full specs: `styles/<style>.md`
@@ -304,6 +315,10 @@ Prompt Files:

 **DO NOT** pass ad-hoc inline text to `--prompt` without first saving prompt files. The generation command should either use `--promptfiles prompts/NN-{type}-{slug}.md` or read the saved file content for `--prompt`.

+**Execution choice**:
+- If multiple illustrations already have saved prompt files and the task is now plain generation, prefer `baoyu-image-gen` batch mode (`build-batch.ts` -> `main.ts --batchfile`)
+- Use subagents only when each illustration still needs separate prompt rewriting, style exploration, or other per-image reasoning before generation
+
 **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
@@ -0,0 +1,156 @@
+import path from "node:path";
+import process from "node:process";
+import { readdir, readFile, writeFile } from "node:fs/promises";
+
+type CliArgs = {
+  outlinePath: string | null;
+  promptsDir: string | null;
+  outputPath: string | null;
+  imagesDir: string | null;
+  provider: string;
+  model: string;
+  aspectRatio: string;
+  quality: string;
+  jobs: number | null;
+  help: boolean;
+};
+
+type OutlineEntry = {
+  index: number;
+  filename: string;
+};
+
+function printUsage(): void {
+  console.log(`Usage:
+  npx -y tsx scripts/build-batch.ts --outline outline.md --prompts prompts --output batch.json --images-dir attachments
+
+Options:
+  --outline <path>     Path to outline.md
+  --prompts <path>     Path to prompts directory
+  --output <path>      Path to output batch.json
+  --images-dir <path>  Directory for generated images
+  --provider <name>    Provider for baoyu-image-gen batch tasks (default: replicate)
+  --model <id>         Model for baoyu-image-gen batch tasks (default: google/nano-banana-pro)
+  --ar <ratio>         Aspect ratio for all tasks (default: 16:9)
+  --quality <level>    Quality for all tasks (default: 2k)
+  --jobs <count>       Recommended worker count metadata (optional)
+  -h, --help           Show help`);
+}
+
+function parseArgs(argv: string[]): CliArgs {
+  const args: CliArgs = {
+    outlinePath: null,
+    promptsDir: null,
+    outputPath: null,
+    imagesDir: null,
+    provider: "replicate",
+    model: "google/nano-banana-pro",
+    aspectRatio: "16:9",
+    quality: "2k",
+    jobs: null,
+    help: false,
+  };
+
+  for (let i = 0; i < argv.length; i++) {
+    const current = argv[i]!;
+    if (current === "--outline") args.outlinePath = argv[++i] ?? null;
+    else if (current === "--prompts") args.promptsDir = argv[++i] ?? null;
+    else if (current === "--output") args.outputPath = argv[++i] ?? null;
+    else if (current === "--images-dir") args.imagesDir = argv[++i] ?? null;
+    else if (current === "--provider") args.provider = argv[++i] ?? args.provider;
+    else if (current === "--model") args.model = argv[++i] ?? args.model;
+    else if (current === "--ar") args.aspectRatio = argv[++i] ?? args.aspectRatio;
+    else if (current === "--quality") args.quality = argv[++i] ?? args.quality;
+    else if (current === "--jobs") {
+      const value = argv[++i];
+      args.jobs = value ? parseInt(value, 10) : null;
+    } else if (current === "--help" || current === "-h") {
+      args.help = true;
+    }
+  }
+  return args;
+}
+
+function parseOutline(content: string): OutlineEntry[] {
+  const entries: OutlineEntry[] = [];
+  const blocks = content.split(/^## Illustration\s+/m).slice(1);
+
+  for (const block of blocks) {
+    const indexMatch = block.match(/^(\d+)/);
+    const filenameMatch = block.match(/\*\*Filename\*\*:\s*(.+)/);
+    if (indexMatch && filenameMatch) {
+      entries.push({
+        index: parseInt(indexMatch[1]!, 10),
+        filename: filenameMatch[1]!.trim(),
+      });
+    }
+  }
+  return entries;
+}
+
+async function findPromptFile(promptsDir: string, entry: OutlineEntry): Promise<string | null> {
+  const files = await readdir(promptsDir);
+  const prefix = String(entry.index).padStart(2, "0");
+  const match = files.find((f) => f.startsWith(prefix) && f.endsWith(".md"));
+  return match ? path.join(promptsDir, match) : null;
+}
+
+async function main(): Promise<void> {
+  const args = parseArgs(process.argv.slice(2));
+  if (args.help) {
+    printUsage();
+    return;
+  }
+
+  if (!args.outlinePath) {
+    console.error("Error: --outline is required");
+    process.exit(1);
+  }
+  if (!args.promptsDir) {
+    console.error("Error: --prompts is required");
+    process.exit(1);
+  }
+  if (!args.outputPath) {
+    console.error("Error: --output is required");
+    process.exit(1);
+  }
+
+  const outlineContent = await readFile(args.outlinePath, "utf8");
+  const entries = parseOutline(outlineContent);
+
+  if (entries.length === 0) {
+    console.error("No illustration entries found in outline.");
+    process.exit(1);
+  }
+
+  const tasks = [];
+  for (const entry of entries) {
+    const promptFile = await findPromptFile(args.promptsDir, entry);
+    if (!promptFile) {
+      console.error(`Warning: No prompt file found for illustration ${entry.index}, skipping.`);
+      continue;
+    }
+
+    const imageDir = args.imagesDir ?? path.dirname(args.outputPath);
+    tasks.push({
+      id: `illustration-${String(entry.index).padStart(2, "0")}`,
+      promptFiles: [promptFile],
+      image: path.join(imageDir, entry.filename),
+      provider: args.provider,
+      model: args.model,
+      ar: args.aspectRatio,
+      quality: args.quality,
+    });
+  }
+
+  const output: Record<string, unknown> = { tasks };
+  if (args.jobs) output.jobs = args.jobs;
+
+  await writeFile(args.outputPath, JSON.stringify(output, null, 2) + "\n");
+  console.log(`Batch file written: ${args.outputPath} (${tasks.length} tasks)`);
+}
+
+main().catch((error) => {
+  console.error(error instanceof Error ? error.message : String(error));
+  process.exit(1);
+});
@@ -1,6 +1,14 @@
 ---
 name: baoyu-comic
 description: Knowledge comic creator supporting multiple art styles and tones. Creates original educational comics with detailed panel layouts and sequential image generation. Use when user asks to create "知识漫画", "教育漫画", "biography comic", "tutorial comic", or "Logicomix-style comic".
+version: 1.56.1
+metadata:
+  openclaw:
+    homepage: https://github.com/JimLiu/baoyu-skills#baoyu-comic
+    requires:
+      anyBins:
+        - bun
+        - npx
 ---

 # Knowledge Comic Creator
@@ -104,9 +112,9 @@ Details: [references/auto-selection.md](references/auto-selection.md)
 **Important**: All scripts are located in the `scripts/` subdirectory of this skill.

 **Agent Execution Instructions**:
-1. Determine this SKILL.md file's directory path as `SKILL_DIR`
-2. Script path = `${SKILL_DIR}/scripts/<script-name>.ts`
-3. Replace all `${SKILL_DIR}` in this document with the actual path
+1. Determine this SKILL.md file's directory path as `{baseDir}`
+2. Script path = `{baseDir}/scripts/<script-name>.ts`
+3. Replace all `{baseDir}` in this document with the actual path
 4. Resolve `${BUN_X}` runtime: if `bun` installed → `bun`; if `npx` available → `npx -y bun`; else suggest installing bun

 **Script Reference**:
@@ -208,12 +216,11 @@ Analyze → [Check Existing?] → [Confirm: Style + Reviews] → Storyboard →

 **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
-${BUN_X} ${SKILL_DIR}/../baoyu-image-gen/scripts/main.ts \
-  --promptfiles characters/characters.md \
-  --image characters/characters.png --ar 4:3
-```
+- Invoke an installed image generation skill such as `baoyu-image-gen`
+- Read that skill's `SKILL.md` and follow its documented interface rather than calling its scripts directly
+- Use `characters/characters.md` as the prompt-file input
+- Save output to `characters/characters.png`
+- Use aspect ratio `4:3`

 **Compress character sheet** (recommended):
 Compress to reduce token usage when used as reference image:
@@ -231,14 +238,11 @@ Compress to reduce token usage when used as reference image:
 **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
-${BUN_X} ${SKILL_DIR}/../baoyu-image-gen/scripts/main.ts \
-  --promptfiles prompts/01-page-xxx.md \
-  --image 01-page-xxx.png --ar 3:4 \
-  --ref characters/characters.png
-```
+- Invoke the installed image generation skill for each page
+- Use `prompts/01-page-xxx.md` as the prompt-file input
+- Save output to `01-page-xxx.png`
+- Use aspect ratio `3:4`
+- If the chosen skill supports reference images, pass `characters/characters.png` as `--ref`

 **Full workflow details**: [references/workflow.md](references/workflow.md)

@@ -39,12 +39,15 @@ Check EXTEND.md existence (priority order):
 ```bash
 # macOS, Linux, WSL, Git Bash
 test -f .baoyu-skills/baoyu-comic/EXTEND.md && echo "project"
+test -f "${XDG_CONFIG_HOME:-$HOME/.config}/baoyu-skills/baoyu-comic/EXTEND.md" && echo "xdg"
 test -f "$HOME/.baoyu-skills/baoyu-comic/EXTEND.md" && echo "user"
 ```

 ```powershell
 # PowerShell (Windows)
 if (Test-Path .baoyu-skills/baoyu-comic/EXTEND.md) { "project" }
+$xdg = if ($env:XDG_CONFIG_HOME) { $env:XDG_CONFIG_HOME } else { "$HOME/.config" }
+if (Test-Path "$xdg/baoyu-skills/baoyu-comic/EXTEND.md") { "xdg" }
 if (Test-Path "$HOME/.baoyu-skills/baoyu-comic/EXTEND.md") { "user" }
 ```

@@ -433,14 +436,12 @@ With confirmed prompts from Step 5/6:

 **Strategy A: Using `--ref` parameter** (e.g., baoyu-image-gen)

-```bash
-# Each page generation MUST include --ref
-${BUN_X} ${SKILL_DIR}/../baoyu-image-gen/scripts/main.ts \
-  --promptfiles prompts/01-page-xxx.md \
-  --image 01-page-xxx.png \
-  --ar 3:4 \
-  --ref characters/characters.png
-```
+- Read the chosen image generation skill's `SKILL.md`
+- Invoke that installed skill via its documented interface, not by calling its scripts directly
+- For every page, use `prompts/01-page-xxx.md` as the prompt-file input
+- Save output to `01-page-xxx.png`
+- Use aspect ratio `3:4`
+- Pass `characters/characters.png` as `--ref` on every page generation

 **Strategy B: Embedding character descriptions in prompt**

@@ -478,7 +479,7 @@ If image generation skill supports `--sessionId`:
 After all images generated:

 ```bash
-${BUN_X} ${SKILL_DIR}/scripts/merge-to-pdf.ts <comic-dir>
+${BUN_X} {baseDir}/scripts/merge-to-pdf.ts <comic-dir>
 ```

 Creates `{topic-slug}.pdf` with all pages as full-page images.
@@ -1,6 +1,14 @@
 ---
 name: baoyu-compress-image
 description: Compresses images to WebP (default) or PNG with automatic tool selection. Use when user asks to "compress image", "optimize image", "convert to webp", or reduce image file size.
+version: 1.56.1
+metadata:
+  openclaw:
+    homepage: https://github.com/JimLiu/baoyu-skills#baoyu-compress-image
+    requires:
+      anyBins:
+        - bun
+        - npx
 ---

 # Image Compressor
@@ -9,7 +17,7 @@ Compresses images using best available tool (sips → cwebp → ImageMagick →

 ## Script Directory

-Scripts in `scripts/` subdirectory. `${SKILL_DIR}` = this SKILL.md's directory path. Resolve `${BUN_X}` runtime: if `bun` installed → `bun`; if `npx` available → `npx -y bun`; else suggest installing bun. Replace `${SKILL_DIR}` and `${BUN_X}` with actual values.
+Scripts in `scripts/` subdirectory. `{baseDir}` = this SKILL.md's directory path. Resolve `${BUN_X}` runtime: if `bun` installed → `bun`; if `npx` available → `npx -y bun`; else suggest installing bun. Replace `{baseDir}` and `${BUN_X}` with actual values.

 | Script | Purpose |
 |--------|---------|
@@ -22,12 +30,15 @@ Check EXTEND.md existence (priority order):
 ```bash
 # macOS, Linux, WSL, Git Bash
 test -f .baoyu-skills/baoyu-compress-image/EXTEND.md && echo "project"
+test -f "${XDG_CONFIG_HOME:-$HOME/.config}/baoyu-skills/baoyu-compress-image/EXTEND.md" && echo "xdg"
 test -f "$HOME/.baoyu-skills/baoyu-compress-image/EXTEND.md" && echo "user"
 ```

 ```powershell
 # PowerShell (Windows)
 if (Test-Path .baoyu-skills/baoyu-compress-image/EXTEND.md) { "project" }
+$xdg = if ($env:XDG_CONFIG_HOME) { $env:XDG_CONFIG_HOME } else { "$HOME/.config" }
+if (Test-Path "$xdg/baoyu-skills/baoyu-compress-image/EXTEND.md") { "xdg" }
 if (Test-Path "$HOME/.baoyu-skills/baoyu-compress-image/EXTEND.md") { "user" }
 ```

@@ -52,7 +63,7 @@ if (Test-Path "$HOME/.baoyu-skills/baoyu-compress-image/EXTEND.md") { "user" }
 ## Usage

 ```bash
-${BUN_X} ${SKILL_DIR}/scripts/main.ts <input> [options]
+${BUN_X} {baseDir}/scripts/main.ts <input> [options]
 ```

 ## Options
@@ -71,16 +82,16 @@ ${BUN_X} ${SKILL_DIR}/scripts/main.ts <input> [options]

 ```bash
 # Single file → WebP (replaces original)
-${BUN_X} ${SKILL_DIR}/scripts/main.ts image.png
+${BUN_X} {baseDir}/scripts/main.ts image.png

 # Keep PNG format
-${BUN_X} ${SKILL_DIR}/scripts/main.ts image.png -f png --keep
+${BUN_X} {baseDir}/scripts/main.ts image.png -f png --keep

 # Directory recursive
-${BUN_X} ${SKILL_DIR}/scripts/main.ts ./images/ -r -q 75
+${BUN_X} {baseDir}/scripts/main.ts ./images/ -r -q 75

 # JSON output
-${BUN_X} ${SKILL_DIR}/scripts/main.ts image.png --json
+${BUN_X} {baseDir}/scripts/main.ts image.png --json
 ```

 **Output**:
@@ -1,6 +1,10 @@
 ---
 name: baoyu-cover-image
-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".
+description: Generates article cover images with 5 dimensions (type, palette, rendering, text, mood) combining 10 color palettes and 7 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".
+version: 1.56.1
+metadata:
+  openclaw:
+    homepage: https://github.com/JimLiu/baoyu-skills#baoyu-cover-image
 ---

 # Cover Image Generator
@@ -35,8 +39,8 @@ Generate elegant cover images for articles with 5-dimensional customization.
 | Option | Description |
 |--------|-------------|
 | `--type <name>` | hero, conceptual, typography, metaphor, scene, minimal |
-| `--palette <name>` | warm, elegant, cool, dark, earth, vivid, pastel, mono, retro |
-| `--rendering <name>` | flat-vector, hand-drawn, painterly, digital, pixel, chalk |
+| `--palette <name>` | warm, elegant, cool, dark, earth, vivid, pastel, mono, retro, duotone |
+| `--rendering <name>` | flat-vector, hand-drawn, painterly, digital, pixel, chalk, screen-print |
 | `--style <name>` | Preset shorthand (see [Style Presets](references/style-presets.md)) |
 | `--text <level>` | none, title-only, title-subtitle, text-rich |
 | `--mood <level>` | subtle, balanced, bold |
@@ -52,8 +56,8 @@ Generate elegant cover images for articles with 5-dimensional customization.
 | Dimension | Values | Default |
 |-----------|--------|---------|
 | **Type** | hero, conceptual, typography, metaphor, scene, minimal | auto |
-| **Palette** | warm, elegant, cool, dark, earth, vivid, pastel, mono, retro | auto |
-| **Rendering** | flat-vector, hand-drawn, painterly, digital, pixel, chalk | auto |
+| **Palette** | warm, elegant, cool, dark, earth, vivid, pastel, mono, retro, duotone | auto |
+| **Rendering** | flat-vector, hand-drawn, painterly, digital, pixel, chalk, screen-print | auto |
 | **Text** | none, title-only, title-subtitle, text-rich | title-only |
 | **Mood** | subtle, balanced, bold | balanced |
 | **Font** | clean, handwritten, serif, display | clean |
@@ -65,10 +69,10 @@ Auto-selection rules: [references/auto-selection.md](references/auto-selection.m
 **Types**: hero, conceptual, typography, metaphor, scene, minimal
 → Details: [references/types.md](references/types.md)

-**Palettes**: warm, elegant, cool, dark, earth, vivid, pastel, mono, retro
+**Palettes**: warm, elegant, cool, dark, earth, vivid, pastel, mono, retro, duotone
 → Details: [references/palettes/](references/palettes/)

-**Renderings**: flat-vector, hand-drawn, painterly, digital, pixel, chalk
+**Renderings**: flat-vector, hand-drawn, painterly, digital, pixel, chalk, screen-print
 → Details: [references/renderings/](references/renderings/)

 **Text Levels**: none (pure visual) | title-only (default) | title-subtitle | text-rich (with tags)
@@ -130,12 +134,15 @@ Check EXTEND.md existence (priority: project → user):
 ```bash
 # macOS, Linux, WSL, Git Bash
 test -f .baoyu-skills/baoyu-cover-image/EXTEND.md && echo "project"
+test -f "${XDG_CONFIG_HOME:-$HOME/.config}/baoyu-skills/baoyu-cover-image/EXTEND.md" && echo "xdg"
 test -f "$HOME/.baoyu-skills/baoyu-cover-image/EXTEND.md" && echo "user"
 ```

 ```powershell
 # PowerShell (Windows)
 if (Test-Path .baoyu-skills/baoyu-cover-image/EXTEND.md) { "project" }
+$xdg = if ($env:XDG_CONFIG_HOME) { $env:XDG_CONFIG_HOME } else { "$HOME/.config" }
+if (Test-Path "$xdg/baoyu-skills/baoyu-cover-image/EXTEND.md") { "xdg" }
 if (Test-Path "$HOME/.baoyu-skills/baoyu-cover-image/EXTEND.md") { "user" }
 ```

@@ -26,6 +26,7 @@ When a dimension is omitted, select based on content signals.
 | Fantasy, children, gentle, creative, whimsical | `pastel` |
 | Zen, focus, essential, pure, simple | `mono` |
 | History, vintage, retro, classic, exploration | `retro` |
+| Movie poster, album cover, concert, cinematic, dramatic, two-color | `duotone` |

 ## Auto Rendering Selection

@@ -37,6 +38,7 @@ When a dimension is omitted, select based on content signals.
 | Data, dashboard, SaaS, corporate, polished | `digital` |
 | Gaming, retro, 8-bit, nostalgic | `pixel` |
 | Education, tutorial, classroom, teaching | `chalk` |
+| Poster, movie, album, concert, silhouette, mondo, limited-edition | `screen-print` |

 ## Auto Text Selection

@@ -4,28 +4,29 @@

 ## Palette × Rendering

-| | flat-vector | hand-drawn | painterly | digital | pixel | chalk |
-|---|:---:|:---:|:---:|:---:|:---:|:---:|
-| warm | ✓✓ | ✓✓ | ✓ | ✓ | ✓ | ✓ |
-| elegant | ✓ | ✓✓ | ✓ | ✓✓ | ✗ | ✗ |
-| cool | ✓✓ | ✓ | ✗ | ✓✓ | ✓ | ✓ |
-| dark | ✓ | ✓ | ✓ | ✓✓ | ✓ | ✓✓ |
-| earth | ✓ | ✓✓ | ✓✓ | ✓ | ✗ | ✗ |
-| vivid | ✓✓ | ✓ | ✓ | ✓ | ✓✓ | ✓ |
-| pastel | ✓✓ | ✓✓ | ✓✓ | ✓ | ✗ | ✗ |
-| mono | ✓✓ | ✓ | ✗ | ✓✓ | ✓ | ✓ |
-| retro | ✓✓ | ✓✓ | ✓ | ✓✓ | ✓ | ✗ |
+| | flat-vector | hand-drawn | painterly | digital | pixel | chalk | screen-print |
+|---|:---:|:---:|:---:|:---:|:---:|:---:|:---:|
+| warm | ✓✓ | ✓✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
+| elegant | ✓ | ✓✓ | ✓ | ✓✓ | ✗ | ✗ | ✓ |
+| cool | ✓✓ | ✓ | ✗ | ✓✓ | ✓ | ✓ | ✓ |
+| dark | ✓ | ✓ | ✓ | ✓✓ | ✓ | ✓✓ | ✓✓ |
+| earth | ✓ | ✓✓ | ✓✓ | ✓ | ✗ | ✗ | ✓ |
+| vivid | ✓✓ | ✓ | ✓ | ✓ | ✓✓ | ✓ | ✓✓ |
+| pastel | ✓✓ | ✓✓ | ✓✓ | ✓ | ✗ | ✗ | ✗ |
+| mono | ✓✓ | ✓ | ✗ | ✓✓ | ✓ | ✓ | ✓✓ |
+| retro | ✓✓ | ✓✓ | ✓ | ✓✓ | ✓ | ✗ | ✓✓ |
+| duotone | ✓ | ✗ | ✗ | ✓ | ✗ | ✗ | ✓✓ |

 ## Type × Rendering

-| | flat-vector | hand-drawn | painterly | digital | pixel | chalk |
-|---|:---:|:---:|:---:|:---:|:---:|:---:|
-| hero | ✓ | ✓✓ | ✓✓ | ✓✓ | ✓ | ✓ |
-| conceptual | ✓✓ | ✓ | ✗ | ✓✓ | ✓ | ✓ |
-| typography | ✓✓ | ✓ | ✓ | ✓✓ | ✓ | ✓ |
-| metaphor | ✓ | ✓✓ | ✓✓ | ✓ | ✗ | ✓ |
-| scene | ✗ | ✓ | ✓✓ | ✓ | ✓ | ✗ |
-| minimal | ✓✓ | ✓ | ✓ | ✓✓ | ✗ | ✗ |
+| | flat-vector | hand-drawn | painterly | digital | pixel | chalk | screen-print |
+|---|:---:|:---:|:---:|:---:|:---:|:---:|:---:|
+| hero | ✓ | ✓✓ | ✓✓ | ✓✓ | ✓ | ✓ | ✓✓ |
+| conceptual | ✓✓ | ✓ | ✗ | ✓✓ | ✓ | ✓ | ✓ |
+| typography | ✓✓ | ✓ | ✓ | ✓✓ | ✓ | ✓ | ✓✓ |
+| metaphor | ✓ | ✓✓ | ✓✓ | ✓ | ✗ | ✓ | ✓✓ |
+| scene | ✗ | ✓ | ✓✓ | ✓ | ✓ | ✗ | ✓ |
+| minimal | ✓✓ | ✓ | ✓ | ✓✓ | ✗ | ✗ | ✓✓ |

 ## Type × Text

@@ -51,9 +52,9 @@

 ## Font × Rendering

-| | flat-vector | hand-drawn | painterly | digital | pixel | chalk |
-|---|:---:|:---:|:---:|:---:|:---:|:---:|
-| clean | ✓✓ | ✗ | ✗ | ✓✓ | ✓ | ✗ |
-| handwritten | ✓ | ✓✓ | ✓✓ | ✓ | ✗ | ✓✓ |
-| serif | ✓ | ✗ | ✓ | ✓✓ | ✗ | ✗ |
-| display | ✓✓ | ✓ | ✓ | ✓✓ | ✓✓ | ✓ |
+| | flat-vector | hand-drawn | painterly | digital | pixel | chalk | screen-print |
+|---|:---:|:---:|:---:|:---:|:---:|:---:|:---:|
+| clean | ✓✓ | ✗ | ✗ | ✓✓ | ✓ | ✗ | ✓ |
+| handwritten | ✓ | ✓✓ | ✓✓ | ✓ | ✗ | ✓✓ | ✗ |
+| serif | ✓ | ✗ | ✓ | ✓✓ | ✗ | ✗ | ✓ |
+| display | ✓✓ | ✓ | ✓ | ✓✓ | ✓✓ | ✓ | ✓✓ |
@@ -120,12 +120,12 @@ Bold, decorative typography for maximum impact.

 ## Rendering Compatibility

-| Font × Rendering | flat-vector | hand-drawn | painterly | digital | pixel | chalk |
-|------------------|:-----------:|:----------:|:---------:|:-------:|:-----:|:-----:|
-| clean | ✓✓ | ✗ | ✗ | ✓✓ | ✓ | ✗ |
-| handwritten | ✓ | ✓✓ | ✓✓ | ✓ | ✗ | ✓✓ |
-| serif | ✓ | ✗ | ✓ | ✓✓ | ✗ | ✗ |
-| display | ✓✓ | ✓ | ✓ | ✓✓ | ✓✓ | ✓ |
+| Font × Rendering | flat-vector | hand-drawn | painterly | digital | pixel | chalk | screen-print |
+|------------------|:-----------:|:----------:|:---------:|:-------:|:-----:|:-----:|:------------:|
+| clean | ✓✓ | ✗ | ✗ | ✓✓ | ✓ | ✗ | ✓ |
+| handwritten | ✓ | ✓✓ | ✓✓ | ✓ | ✗ | ✓✓ | ✗ |
+| serif | ✓ | ✗ | ✓ | ✓✓ | ✗ | ✗ | ✓ |
+| display | ✓✓ | ✓ | ✓ | ✓✓ | ✓✓ | ✓ | ✓✓ |

 ✓✓ = highly recommended | ✓ = compatible | ✗ = not recommended

@@ -148,6 +148,7 @@ Font style adapts to palette characteristics:
 | Cool (cool, mono, elegant) | Perfect match | Contrast | Classic pairing | Bold statement |
 | Dark (dark, vivid) | High contrast | Glow effects | Dramatic | Maximum impact |
 | Vintage (retro) | Modern contrast | Nostalgic fit | Period-appropriate | Retro headlines |
+| Duotone (duotone) | Sharp contrast | Not recommended | Dramatic pairing | Cinematic impact |

 ## Auto Selection

@@ -112,6 +112,7 @@ Mood modifies the base palette characteristics:
 | 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 |
+| Duotone palettes (duotone) | Softer contrast between pair | Standard two-color split | Maximum contrast, stark separation |

 ## Rendering Interaction

@@ -125,6 +126,7 @@ Mood adjusts rendering characteristics:
 | 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 |
+| screen-print | Fewer colors (2), lighter halftone | Standard 3-4 colors, medium halftone | More colors (4-5), dense halftone, stronger misregistration |

 ## Auto Selection

@@ -0,0 +1,39 @@
+# duotone
+
+Dramatic, cinematic, two-color high contrast
+
+## Color Palette
+
+| Role | Color | Hex |
+|------|-------|-----|
+| Primary 1 | Burnt Orange | #E8751A |
+| Primary 2 | Deep Teal | #0A6E6E |
+| Background | Off-Black | #121212 |
+| Background Alt | Dark Charcoal | #1E1E1E |
+| Accent 1 | Warm Cream | #F5E6D0 |
+| Accent 2 | Amber Highlight | #F4A623 |
+
+## Duotone Pair Options
+
+Choose ONE pair based on content mood. The two colors dominate the entire image:
+
+| Pair | Color A | Color B | Feel |
+|------|---------|---------|------|
+| Orange + Teal | #E8751A | #0A6E6E | Cinematic, action |
+| Red + Cream | #C0392B | #F5E6D0 | Bold, classic |
+| Blue + Gold | #1A3A5C | #D4A843 | Prestigious, premium |
+| Purple + Green | #6B3FA0 | #2ECC71 | Futuristic, contrast |
+| Magenta + Cyan | #C2185B | #00BCD4 | Vibrant, pop |
+| Crimson + Navy | #DC143C | #0D1B2A | Dramatic, noir |
+
+## Decorative Hints
+
+- Stark two-color separation across entire composition
+- Halftone transitions between the two colors
+- Silhouettes in one color against the other
+- Minimal use of third color (only for small highlights)
+- High contrast figure-ground relationships
+
+## Best For
+
+Movie posters, album covers, concert prints, dramatic announcements, cinematic content, bold branding, editorial covers, artistic campaigns
@@ -0,0 +1,44 @@
+# screen-print
+
+Bold, limited-color poster art with print texture
+
+## Core Characteristics
+
+Screen print / silkscreen aesthetic with flat color blocks, halftone textures, and deliberate print imperfections. Think Mondo limited-edition posters, vintage concert prints, and alternative movie poster art.
+
+## Lines
+
+- Clean, sharp edges between color blocks
+- No outlines — shapes defined by color boundaries
+- Stencil-cut quality, bold silhouettes
+- Geometric shapes with precise registration
+
+## Texture
+
+- Halftone dot patterns within color fills
+- Slight color layer misregistration (offset between print layers)
+- Paper grain texture beneath colors
+- Risograph / screen print imperfections (ink spread, dot gain)
+
+## Depth
+
+- Flat color planes layered front to back
+- Depth through silhouette overlap and color layering
+- No gradients — tonal variation via halftone density
+- Negative space as active compositional element
+
+## Element Vocabulary
+
+- Bold silhouettes and symbolic shapes
+- Geometric framing (circles, arches, triangles)
+- Figure-ground inversion (negative space forms secondary image)
+- Limited icon vocabulary: key props, symbolic objects
+- Typography integrated as design element, not overlay
+- Vintage poster border treatments
+
+## Typography Approach
+
+- Bold condensed sans-serif or hand-drawn lettering
+- Art Deco influences, vintage poster typography
+- Typography as integral part of composition (not separate layer)
+- Strong readability through high contrast with background
@@ -24,6 +24,11 @@
 | `warm` | `warm` | `hand-drawn` |
 | `warm-flat` | `warm` | `flat-vector` |
 | `watercolor` | `earth` | `painterly` |
+| `poster-art` | `retro` | `screen-print` |
+| `mondo` | `mono` | `screen-print` |
+| `art-deco` | `elegant` | `screen-print` |
+| `propaganda` | `vivid` | `screen-print` |
+| `cinematic` | `duotone` | `screen-print` |

 ## Override Examples

@@ -1,6 +1,14 @@
 ---
 name: baoyu-danger-gemini-web
 description: Generates images and text via reverse-engineered Gemini Web API. Supports text generation, image generation from prompts, reference images for vision input, and multi-turn conversations. Use when other skills need image generation backend, or when user requests "generate image with Gemini", "Gemini text generation", or needs vision-capable AI generation.
+version: 1.56.1
+metadata:
+  openclaw:
+    homepage: https://github.com/JimLiu/baoyu-skills#baoyu-danger-gemini-web
+    requires:
+      anyBins:
+        - bun
+        - npx
 ---

 # Gemini Web Client
@@ -12,10 +20,10 @@ Text/image generation via Gemini Web API. Supports reference images and multi-tu
 **Important**: All scripts are located in the `scripts/` subdirectory of this skill.

 **Agent Execution Instructions**:
-1. Determine this SKILL.md file's directory path as `SKILL_DIR`
-2. Script path = `${SKILL_DIR}/scripts/<script-name>.ts`
+1. Determine this SKILL.md file's directory path as `{baseDir}`
+2. Script path = `{baseDir}/scripts/<script-name>.ts`
 3. Resolve `${BUN_X}` runtime: if `bun` installed → `bun`; if `npx` available → `npx -y bun`; else suggest installing bun
-4. Replace all `${SKILL_DIR}` and `${BUN_X}` in this document with actual values
+4. Replace all `{baseDir}` and `${BUN_X}` in this document with actual values

 **Script Reference**:
 | Script | Purpose |
@@ -49,12 +57,15 @@ Check EXTEND.md existence (priority order):
 ```bash
 # macOS, Linux, WSL, Git Bash
 test -f .baoyu-skills/baoyu-danger-gemini-web/EXTEND.md && echo "project"
+test -f "${XDG_CONFIG_HOME:-$HOME/.config}/baoyu-skills/baoyu-danger-gemini-web/EXTEND.md" && echo "xdg"
 test -f "$HOME/.baoyu-skills/baoyu-danger-gemini-web/EXTEND.md" && echo "user"
 ```

 ```powershell
 # PowerShell (Windows)
 if (Test-Path .baoyu-skills/baoyu-danger-gemini-web/EXTEND.md) { "project" }
+$xdg = if ($env:XDG_CONFIG_HOME) { $env:XDG_CONFIG_HOME } else { "$HOME/.config" }
+if (Test-Path "$xdg/baoyu-skills/baoyu-danger-gemini-web/EXTEND.md") { "xdg" }
 if (Test-Path "$HOME/.baoyu-skills/baoyu-danger-gemini-web/EXTEND.md") { "user" }
 ```

@@ -80,23 +91,23 @@ if (Test-Path "$HOME/.baoyu-skills/baoyu-danger-gemini-web/EXTEND.md") { "user"

 ```bash
 # Text generation
-${BUN_X} ${SKILL_DIR}/scripts/main.ts "Your prompt"
-${BUN_X} ${SKILL_DIR}/scripts/main.ts --prompt "Your prompt" --model gemini-3-flash
+${BUN_X} {baseDir}/scripts/main.ts "Your prompt"
+${BUN_X} {baseDir}/scripts/main.ts --prompt "Your prompt" --model gemini-3-flash

 # Image generation
-${BUN_X} ${SKILL_DIR}/scripts/main.ts --prompt "A cute cat" --image cat.png
-${BUN_X} ${SKILL_DIR}/scripts/main.ts --promptfiles system.md content.md --image out.png
+${BUN_X} {baseDir}/scripts/main.ts --prompt "A cute cat" --image cat.png
+${BUN_X} {baseDir}/scripts/main.ts --promptfiles system.md content.md --image out.png

 # Vision input (reference images)
-${BUN_X} ${SKILL_DIR}/scripts/main.ts --prompt "Describe this" --reference image.png
-${BUN_X} ${SKILL_DIR}/scripts/main.ts --prompt "Create variation" --reference a.png --image out.png
+${BUN_X} {baseDir}/scripts/main.ts --prompt "Describe this" --reference image.png
+${BUN_X} {baseDir}/scripts/main.ts --prompt "Create variation" --reference a.png --image out.png

 # Multi-turn conversation
-${BUN_X} ${SKILL_DIR}/scripts/main.ts "Remember: 42" --sessionId session-abc
-${BUN_X} ${SKILL_DIR}/scripts/main.ts "What number?" --sessionId session-abc
+${BUN_X} {baseDir}/scripts/main.ts "Remember: 42" --sessionId session-abc
+${BUN_X} {baseDir}/scripts/main.ts "What number?" --sessionId session-abc

 # JSON output
-${BUN_X} ${SKILL_DIR}/scripts/main.ts "Hello" --json
+${BUN_X} {baseDir}/scripts/main.ts "Hello" --json
 ```

 ## Options
@@ -0,0 +1,14 @@
+{
+  "lockfileVersion": 1,
+  "workspaces": {
+    "": {
+      "name": "baoyu-danger-gemini-web-scripts",
+      "dependencies": {
+        "baoyu-chrome-cdp": "file:./vendor/baoyu-chrome-cdp",
+      },
+    },
+  },
+  "packages": {
+    "baoyu-chrome-cdp": ["baoyu-chrome-cdp@file:vendor/baoyu-chrome-cdp", {}],
+  }
+}
@@ -1,183 +1,76 @@
-import { spawn, type ChildProcess } from 'node:child_process';
-import fs from 'node:fs';
-import { mkdir } from 'node:fs/promises';
-import net from 'node:net';
 import process from 'node:process';

+import {
+  CdpConnection,
+  findChromeExecutable as findChromeExecutableBase,
+  findExistingChromeDebugPort,
+  getFreePort,
+  killChrome,
+  launchChrome as launchChromeBase,
+  openPageSession,
+  sleep,
+  waitForChromeDebugPort,
+  type PlatformCandidates,
+} from 'baoyu-chrome-cdp';
+
 import { Endpoint, Headers } from '../constants.js';
 import { logger } from './logger.js';
-import { cookie_header, fetch_with_timeout, sleep } from './http.js';
+import { cookie_header, fetch_with_timeout } from './http.js';
 import { read_cookie_file, type CookieMap, write_cookie_file } from './cookie-file.js';
 import { resolveGeminiWebChromeProfileDir, resolveGeminiWebCookiePath } from './paths.js';

-type CdpSendOptions = { sessionId?: string; timeoutMs?: number };
+const GEMINI_APP_URL = 'https://gemini.google.com/app';

-class CdpConnection {
-  private ws: WebSocket;
-  private nextId = 0;
-  private pending = new Map<
-    number,
-    { resolve: (v: unknown) => void; reject: (e: Error) => void; timer: ReturnType<typeof setTimeout> | null }
-  >();
-
-  private constructor(ws: WebSocket) {
-    this.ws = ws;
-    this.ws.addEventListener('message', (event) => {
-      try {
-        const data = typeof event.data === 'string' ? event.data : new TextDecoder().decode(event.data as ArrayBuffer);
-        const msg = JSON.parse(data) as { id?: number; result?: unknown; error?: { message?: string } };
-        if (msg.id) {
-          const p = this.pending.get(msg.id);
-          if (p) {
-            this.pending.delete(msg.id);
-            if (p.timer) clearTimeout(p.timer);
-            if (msg.error?.message) p.reject(new Error(msg.error.message));
-            else p.resolve(msg.result);
-          }
-        }
-      } catch {}
-    });
-    this.ws.addEventListener('close', () => {
-      for (const [id, p] of this.pending.entries()) {
-        this.pending.delete(id);
-        if (p.timer) clearTimeout(p.timer);
-        p.reject(new Error('CDP connection closed.'));
-      }
-    });
-  }
-
-  static async connect(url: string, timeoutMs: number): Promise<CdpConnection> {
-    const ws = new WebSocket(url);
-    await new Promise<void>((resolve, reject) => {
-      const t = setTimeout(() => reject(new Error('CDP connection timeout.')), timeoutMs);
-      ws.addEventListener('open', () => {
-        clearTimeout(t);
-        resolve();
-      });
-      ws.addEventListener('error', () => {
-        clearTimeout(t);
-        reject(new Error('CDP connection failed.'));
-      });
-    });
-    return new CdpConnection(ws);
-  }
-
-  async send<T = unknown>(method: string, params?: Record<string, unknown>, opts?: CdpSendOptions): Promise<T> {
-    const id = ++this.nextId;
-    const msg: Record<string, unknown> = { id, method };
-    if (params) msg.params = params;
-    if (opts?.sessionId) msg.sessionId = opts.sessionId;
-
-    const timeoutMs = opts?.timeoutMs ?? 15_000;
-    const out = await new Promise<unknown>((resolve, reject) => {
-      const t =
-        timeoutMs > 0
-          ? setTimeout(() => {
-              this.pending.delete(id);
-              reject(new Error(`CDP timeout: ${method}`));
-            }, timeoutMs)
-          : null;
-      this.pending.set(id, { resolve, reject, timer: t });
-      this.ws.send(JSON.stringify(msg));
-    });
-    return out as T;
-  }
-
-  close(): void {
-    try {
-      this.ws.close();
-    } catch {}
-  }
-}
+const CHROME_CANDIDATES_FULL: PlatformCandidates = {
+  darwin: [
+    '/Applications/Google Chrome.app/Contents/MacOS/Google Chrome',
+    '/Applications/Google Chrome Canary.app/Contents/MacOS/Google Chrome Canary',
+    '/Applications/Google Chrome Beta.app/Contents/MacOS/Google Chrome Beta',
+    '/Applications/Chromium.app/Contents/MacOS/Chromium',
+    '/Applications/Microsoft Edge.app/Contents/MacOS/Microsoft Edge',
+  ],
+  win32: [
+    'C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe',
+    'C:\\Program Files (x86)\\Google\\Chrome\\Application\\chrome.exe',
+    'C:\\Program Files\\Microsoft\\Edge\\Application\\msedge.exe',
+    'C:\\Program Files (x86)\\Microsoft\\Edge\\Application\\msedge.exe',
+  ],
+  default: [
+    '/usr/bin/google-chrome',
+    '/usr/bin/google-chrome-stable',
+    '/usr/bin/chromium',
+    '/usr/bin/chromium-browser',
+    '/snap/bin/chromium',
+    '/usr/bin/microsoft-edge',
+  ],
+};

 async function get_free_port(): Promise<number> {
-  const fixed = parseInt(process.env.GEMINI_WEB_DEBUG_PORT || '', 10);
-  if (fixed > 0) return fixed;
-  return await new Promise((resolve, reject) => {
-    const srv = net.createServer();
-    srv.unref();
-    srv.on('error', reject);
-    srv.listen(0, '127.0.0.1', () => {
-      const addr = srv.address();
-      if (!addr || typeof addr === 'string') {
-        srv.close(() => reject(new Error('Unable to allocate a free TCP port.')));
-        return;
-      }
-      const port = addr.port;
-      srv.close((err) => (err ? reject(err) : resolve(port)));
-    });
-  });
+  return await getFreePort('GEMINI_WEB_DEBUG_PORT');
 }

 function find_chrome_executable(): string | null {
-  const override = process.env.GEMINI_WEB_CHROME_PATH?.trim();
-  if (override && fs.existsSync(override)) return override;
-
-  const candidates: string[] = [];
-  switch (process.platform) {
-    case 'darwin':
-      candidates.push(
-        '/Applications/Google Chrome.app/Contents/MacOS/Google Chrome',
-        '/Applications/Google Chrome Canary.app/Contents/MacOS/Google Chrome Canary',
-        '/Applications/Google Chrome Beta.app/Contents/MacOS/Google Chrome Beta',
-        '/Applications/Chromium.app/Contents/MacOS/Chromium',
-        '/Applications/Microsoft Edge.app/Contents/MacOS/Microsoft Edge',
-      );
-      break;
-    case 'win32':
-      candidates.push(
-        'C:\\\\Program Files\\\\Google\\\\Chrome\\\\Application\\\\chrome.exe',
-        'C:\\\\Program Files (x86)\\\\Google\\\\Chrome\\\\Application\\\\chrome.exe',
-        'C:\\\\Program Files\\\\Microsoft\\\\Edge\\\\Application\\\\msedge.exe',
-        'C:\\\\Program Files (x86)\\\\Microsoft\\\\Edge\\\\Application\\\\msedge.exe',
-      );
-      break;
-    default:
-      candidates.push(
-        '/usr/bin/google-chrome',
-        '/usr/bin/google-chrome-stable',
-        '/usr/bin/chromium',
-        '/usr/bin/chromium-browser',
-        '/snap/bin/chromium',
-        '/usr/bin/microsoft-edge',
-      );
-      break;
-  }
-
-  for (const p of candidates) {
-    if (fs.existsSync(p)) return p;
-  }
-  return null;
+  return findChromeExecutableBase({
+    candidates: CHROME_CANDIDATES_FULL,
+    envNames: ['GEMINI_WEB_CHROME_PATH'],
+  }) ?? null;
 }

-async function wait_for_chrome_debug_port(port: number, timeoutMs: number): Promise<string> {
-  const start = Date.now();
-  while (Date.now() - start < timeoutMs) {
-    try {
-      const res = await fetch_with_timeout(`http://127.0.0.1:${port}/json/version`, { timeout_ms: 5_000 });
-      if (!res.ok) throw new Error(`status=${res.status}`);
-      const j = (await res.json()) as { webSocketDebuggerUrl?: string };
-      if (j.webSocketDebuggerUrl) return j.webSocketDebuggerUrl;
-    } catch {}
-    await sleep(200);
-  }
-  throw new Error('Chrome debug port not ready');
+async function find_existing_chrome_debug_port(profileDir: string): Promise<number | null> {
+  return await findExistingChromeDebugPort({ profileDir });
 }

-async function launch_chrome(profileDir: string, port: number): Promise<ChildProcess> {
-  const chrome = find_chrome_executable();
-  if (!chrome) throw new Error('Chrome executable not found.');
+async function launch_chrome(profileDir: string, port: number) {
+  const chromePath = find_chrome_executable();
+  if (!chromePath) throw new Error('Chrome executable not found.');

-  const args = [
-    `--remote-debugging-port=${port}`,
-    `--user-data-dir=${profileDir}`,
-    '--no-first-run',
-    '--no-default-browser-check',
-    '--disable-popup-blocking',
-    'https://gemini.google.com/app',
-  ];
-
-  return spawn(chrome, args, { stdio: 'ignore' });
+  return await launchChromeBase({
+    chromePath,
+    profileDir,
+    port,
+    url: GEMINI_APP_URL,
+    extraArgs: ['--disable-popup-blocking'],
+  });
 }

 async function is_gemini_session_ready(cookies: CookieMap, verbose: boolean): Promise<boolean> {
@@ -209,27 +102,33 @@ async function fetch_google_cookies_via_cdp(
  timeoutMs: number,
  verbose: boolean,
 ): Promise<CookieMap> {
-  await mkdir(profileDir, { recursive: true });
-
-  const port = await get_free_port();
-  const chrome = await launch_chrome(profileDir, port);
+  const existingPort = await find_existing_chrome_debug_port(profileDir);
+  const reusing = existingPort !== null;
+  const port = existingPort ?? await get_free_port();
+  const chrome = reusing ? null : await launch_chrome(profileDir, port);

  let cdp: CdpConnection | null = null;
+  let targetId: string | null = null;
  try {
-    const wsUrl = await wait_for_chrome_debug_port(port, 30_000);
+    const wsUrl = await waitForChromeDebugPort(port, 30_000, { includeLastError: true });
    cdp = await CdpConnection.connect(wsUrl, 15_000);

-    const { targetId } = await cdp.send<{ targetId: string }>('Target.createTarget', {
-      url: 'https://gemini.google.com/app',
-      newWindow: true,
-    });
-    const { sessionId } = await cdp.send<{ sessionId: string }>('Target.attachToTarget', { targetId, flatten: true });
-    await cdp.send('Network.enable', {}, { sessionId });
-
    if (verbose) {
-      logger.info('Chrome opened. If needed, complete Google login in the window. Waiting for a valid Gemini session...');
+      logger.info(reusing
+        ? `Reusing existing Chrome on port ${port}. Waiting for a valid Gemini session...`
+        : 'Chrome opened. If needed, complete Google login in the window. Waiting for a valid Gemini session...');
    }

+    const page = await openPageSession({
+      cdp,
+      reusing,
+      url: GEMINI_APP_URL,
+      matchTarget: (target) => target.type === 'page' && target.url.includes('gemini.google.com'),
+      enableNetwork: true,
+    });
+    const { sessionId } = page;
+    targetId = page.targetId;
+
    const start = Date.now();
    let last: CookieMap = {};

@@ -240,14 +139,14 @@ async function fetch_google_cookies_via_cdp(
        { sessionId, timeoutMs: 10_000 },
      );

-      const m: CookieMap = {};
-      for (const c of cookies) {
-        if (c?.name && typeof c.value === 'string') m[c.name] = c.value;
+      const cookieMap: CookieMap = {};
+      for (const cookie of cookies) {
+        if (cookie?.name && typeof cookie.value === 'string') cookieMap[cookie.name] = cookie.value;
      }

-      last = m;
-      if (await is_gemini_session_ready(m, verbose)) {
-        return m;
+      last = cookieMap;
+      if (await is_gemini_session_ready(cookieMap, verbose)) {
+        return cookieMap;
      }

      await sleep(1000);
@@ -256,22 +155,19 @@ async function fetch_google_cookies_via_cdp(
    throw new Error(`Timed out waiting for a valid Gemini session. Last keys: ${Object.keys(last).join(', ')}`);
  } finally {
    if (cdp) {
-      try {
-        await cdp.send('Browser.close', {}, { timeoutMs: 5_000 });
-      } catch {}
+      if (reusing && targetId) {
+        try {
+          await cdp.send('Target.closeTarget', { targetId }, { timeoutMs: 5_000 });
+        } catch {}
+      } else {
+        try {
+          await cdp.send('Browser.close', {}, { timeoutMs: 5_000 });
+        } catch {}
+      }
      cdp.close();
    }

-    try {
-      chrome.kill('SIGTERM');
-    } catch {}
-    setTimeout(() => {
-      if (!chrome.killed) {
-        try {
-          chrome.kill('SIGKILL');
-        } catch {}
-      }
-    }, 2_000).unref?.();
+    if (chrome) killChrome(chrome);
  }
 }

@@ -286,8 +182,8 @@ export async function load_browser_cookies(domain_name: string = '', verbose: bo
  const cookies = await fetch_google_cookies_via_cdp(profileDir, 120_000, verbose);

  const filtered: CookieMap = {};
-  for (const [k, v] of Object.entries(cookies)) {
-    if (typeof v === 'string' && v.length > 0) filtered[k] = v;
+  for (const [key, value] of Object.entries(cookies)) {
+    if (typeof value === 'string' && value.length > 0) filtered[key] = value;
  }

  await write_cookie_file(filtered, resolveGeminiWebCookiePath(), 'cdp');
@@ -59,16 +59,31 @@ function normalizeSessionMetadata(input: unknown): Array<string | null> {
  return [null, null, null];
 }

+function formatScriptCommand(fallback: string): string {
+  const raw = process.argv[1];
+  const displayPath = raw
+    ? (() => {
+        const relative = path.relative(process.cwd(), raw);
+        return relative && !relative.startsWith("..") ? relative : raw;
+      })()
+    : fallback;
+  const quotedPath = displayPath.includes(" ")
+    ? `"${displayPath.replace(/"/g, '\\"')}"`
+    : displayPath;
+  return `npx -y bun ${quotedPath}`;
+}
+
 function printUsage(cookiePath: string, profileDir: string): void {
+  const cmd = formatScriptCommand("scripts/main.ts");
  console.log(`Usage:
-  npx -y bun skills/baoyu-danger-gemini-web/scripts/main.ts --prompt "Hello"
-  npx -y bun skills/baoyu-danger-gemini-web/scripts/main.ts "Hello"
-  npx -y bun skills/baoyu-danger-gemini-web/scripts/main.ts --prompt "A cute cat" --image generated.png
-  npx -y bun skills/baoyu-danger-gemini-web/scripts/main.ts --promptfiles system.md content.md --image out.png
+  ${cmd} --prompt "Hello"
+  ${cmd} "Hello"
+  ${cmd} --prompt "A cute cat" --image generated.png
+  ${cmd} --promptfiles system.md content.md --image out.png

 Multi-turn conversation (agent generates unique sessionId):
-  npx -y bun skills/baoyu-danger-gemini-web/scripts/main.ts "Remember 42" --sessionId abc123
-  npx -y bun skills/baoyu-danger-gemini-web/scripts/main.ts "What number?" --sessionId abc123
+  ${cmd} "Remember 42" --sessionId abc123
+  ${cmd} "What number?" --sessionId abc123

 Options:
  -p, --prompt <text>       Prompt text
@@ -0,0 +1,8 @@
+{
+  "name": "baoyu-danger-gemini-web-scripts",
+  "private": true,
+  "type": "module",
+  "dependencies": {
+    "baoyu-chrome-cdp": "file:./vendor/baoyu-chrome-cdp"
+  }
+}
@@ -0,0 +1,9 @@
+{
+  "name": "baoyu-chrome-cdp",
+  "private": true,
+  "version": "0.1.0",
+  "type": "module",
+  "exports": {
+    ".": "./src/index.ts"
+  }
+}
@@ -0,0 +1,408 @@
+import { spawn, spawnSync, type ChildProcess } from "node:child_process";
+import fs from "node:fs";
+import net from "node:net";
+import os from "node:os";
+import path from "node:path";
+import process from "node:process";
+
+export type PlatformCandidates = {
+  darwin?: string[];
+  win32?: string[];
+  default: string[];
+};
+
+type PendingRequest = {
+  resolve: (value: unknown) => void;
+  reject: (error: Error) => void;
+  timer: ReturnType<typeof setTimeout> | null;
+};
+
+type CdpSendOptions = {
+  sessionId?: string;
+  timeoutMs?: number;
+};
+
+type FetchJsonOptions = {
+  timeoutMs?: number;
+};
+
+type FindChromeExecutableOptions = {
+  candidates: PlatformCandidates;
+  envNames?: string[];
+};
+
+type ResolveSharedChromeProfileDirOptions = {
+  envNames?: string[];
+  appDataDirName?: string;
+  profileDirName?: string;
+  wslWindowsHome?: string | null;
+};
+
+type FindExistingChromeDebugPortOptions = {
+  profileDir: string;
+  timeoutMs?: number;
+};
+
+type LaunchChromeOptions = {
+  chromePath: string;
+  profileDir: string;
+  port: number;
+  url?: string;
+  headless?: boolean;
+  extraArgs?: string[];
+};
+
+type ChromeTargetInfo = {
+  targetId: string;
+  url: string;
+  type: string;
+};
+
+type OpenPageSessionOptions = {
+  cdp: CdpConnection;
+  reusing: boolean;
+  url: string;
+  matchTarget: (target: ChromeTargetInfo) => boolean;
+  enablePage?: boolean;
+  enableRuntime?: boolean;
+  enableDom?: boolean;
+  enableNetwork?: boolean;
+  activateTarget?: boolean;
+};
+
+export type PageSession = {
+  sessionId: string;
+  targetId: string;
+};
+
+export function sleep(ms: number): Promise<void> {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+
+export async function getFreePort(fixedEnvName?: string): Promise<number> {
+  const fixed = fixedEnvName ? Number.parseInt(process.env[fixedEnvName] ?? "", 10) : NaN;
+  if (Number.isInteger(fixed) && fixed > 0) return fixed;
+
+  return await new Promise((resolve, reject) => {
+    const server = net.createServer();
+    server.unref();
+    server.on("error", reject);
+    server.listen(0, "127.0.0.1", () => {
+      const address = server.address();
+      if (!address || typeof address === "string") {
+        server.close(() => reject(new Error("Unable to allocate a free TCP port.")));
+        return;
+      }
+      const port = address.port;
+      server.close((err) => {
+        if (err) reject(err);
+        else resolve(port);
+      });
+    });
+  });
+}
+
+export function findChromeExecutable(options: FindChromeExecutableOptions): string | undefined {
+  for (const envName of options.envNames ?? []) {
+    const override = process.env[envName]?.trim();
+    if (override && fs.existsSync(override)) return override;
+  }
+
+  const candidates = process.platform === "darwin"
+    ? options.candidates.darwin ?? options.candidates.default
+    : process.platform === "win32"
+      ? options.candidates.win32 ?? options.candidates.default
+      : options.candidates.default;
+
+  for (const candidate of candidates) {
+    if (fs.existsSync(candidate)) return candidate;
+  }
+  return undefined;
+}
+
+export function resolveSharedChromeProfileDir(options: ResolveSharedChromeProfileDirOptions = {}): string {
+  for (const envName of options.envNames ?? []) {
+    const override = process.env[envName]?.trim();
+    if (override) return path.resolve(override);
+  }
+
+  const appDataDirName = options.appDataDirName ?? "baoyu-skills";
+  const profileDirName = options.profileDirName ?? "chrome-profile";
+
+  if (options.wslWindowsHome) {
+    return path.join(options.wslWindowsHome, ".local", "share", appDataDirName, profileDirName);
+  }
+
+  const base = process.platform === "darwin"
+    ? path.join(os.homedir(), "Library", "Application Support")
+    : process.platform === "win32"
+      ? (process.env.APPDATA ?? path.join(os.homedir(), "AppData", "Roaming"))
+      : (process.env.XDG_DATA_HOME ?? path.join(os.homedir(), ".local", "share"));
+  return path.join(base, appDataDirName, profileDirName);
+}
+
+async function fetchWithTimeout(url: string, timeoutMs?: number): Promise<Response> {
+  if (!timeoutMs || timeoutMs <= 0) return await fetch(url, { redirect: "follow" });
+
+  const ctl = new AbortController();
+  const timer = setTimeout(() => ctl.abort(), timeoutMs);
+  try {
+    return await fetch(url, { redirect: "follow", signal: ctl.signal });
+  } finally {
+    clearTimeout(timer);
+  }
+}
+
+async function fetchJson<T = unknown>(url: string, options: FetchJsonOptions = {}): Promise<T> {
+  const response = await fetchWithTimeout(url, options.timeoutMs);
+  if (!response.ok) {
+    throw new Error(`Request failed: ${response.status} ${response.statusText}`);
+  }
+  return await response.json() as T;
+}
+
+async function isDebugPortReady(port: number, timeoutMs = 3_000): Promise<boolean> {
+  try {
+    const version = await fetchJson<{ webSocketDebuggerUrl?: string }>(
+      `http://127.0.0.1:${port}/json/version`,
+      { timeoutMs }
+    );
+    return !!version.webSocketDebuggerUrl;
+  } catch {
+    return false;
+  }
+}
+
+export async function findExistingChromeDebugPort(options: FindExistingChromeDebugPortOptions): Promise<number | null> {
+  const timeoutMs = options.timeoutMs ?? 3_000;
+  const portFile = path.join(options.profileDir, "DevToolsActivePort");
+
+  try {
+    const content = fs.readFileSync(portFile, "utf-8");
+    const [portLine] = content.split(/\r?\n/);
+    const port = Number.parseInt(portLine?.trim() ?? "", 10);
+    if (port > 0 && await isDebugPortReady(port, timeoutMs)) return port;
+  } catch {}
+
+  if (process.platform === "win32") return null;
+
+  try {
+    const result = spawnSync("ps", ["aux"], { encoding: "utf-8", timeout: 5_000 });
+    if (result.status !== 0 || !result.stdout) return null;
+
+    const lines = result.stdout
+      .split("\n")
+      .filter((line) => line.includes(options.profileDir) && line.includes("--remote-debugging-port="));
+
+    for (const line of lines) {
+      const portMatch = line.match(/--remote-debugging-port=(\d+)/);
+      const port = Number.parseInt(portMatch?.[1] ?? "", 10);
+      if (port > 0 && await isDebugPortReady(port, timeoutMs)) return port;
+    }
+  } catch {}
+
+  return null;
+}
+
+export async function waitForChromeDebugPort(
+  port: number,
+  timeoutMs: number,
+  options?: { includeLastError?: boolean }
+): Promise<string> {
+  const start = Date.now();
+  let lastError: unknown = null;
+
+  while (Date.now() - start < timeoutMs) {
+    try {
+      const version = await fetchJson<{ webSocketDebuggerUrl?: string }>(
+        `http://127.0.0.1:${port}/json/version`,
+        { timeoutMs: 5_000 }
+      );
+      if (version.webSocketDebuggerUrl) return version.webSocketDebuggerUrl;
+      lastError = new Error("Missing webSocketDebuggerUrl");
+    } catch (error) {
+      lastError = error;
+    }
+    await sleep(200);
+  }
+
+  if (options?.includeLastError && lastError) {
+    throw new Error(
+      `Chrome debug port not ready: ${lastError instanceof Error ? lastError.message : String(lastError)}`
+    );
+  }
+  throw new Error("Chrome debug port not ready");
+}
+
+export class CdpConnection {
+  private ws: WebSocket;
+  private nextId = 0;
+  private pending = new Map<number, PendingRequest>();
+  private eventHandlers = new Map<string, Set<(params: unknown) => void>>();
+  private defaultTimeoutMs: number;
+
+  private constructor(ws: WebSocket, defaultTimeoutMs = 15_000) {
+    this.ws = ws;
+    this.defaultTimeoutMs = defaultTimeoutMs;
+
+    this.ws.addEventListener("message", (event) => {
+      try {
+        const data = typeof event.data === "string"
+          ? event.data
+          : new TextDecoder().decode(event.data as ArrayBuffer);
+        const msg = JSON.parse(data) as {
+          id?: number;
+          method?: string;
+          params?: unknown;
+          result?: unknown;
+          error?: { message?: string };
+        };
+
+        if (msg.method) {
+          const handlers = this.eventHandlers.get(msg.method);
+          if (handlers) {
+            handlers.forEach((handler) => handler(msg.params));
+          }
+        }
+
+        if (msg.id) {
+          const pending = this.pending.get(msg.id);
+          if (pending) {
+            this.pending.delete(msg.id);
+            if (pending.timer) clearTimeout(pending.timer);
+            if (msg.error?.message) pending.reject(new Error(msg.error.message));
+            else pending.resolve(msg.result);
+          }
+        }
+      } catch {}
+    });
+
+    this.ws.addEventListener("close", () => {
+      for (const [id, pending] of this.pending.entries()) {
+        this.pending.delete(id);
+        if (pending.timer) clearTimeout(pending.timer);
+        pending.reject(new Error("CDP connection closed."));
+      }
+    });
+  }
+
+  static async connect(
+    url: string,
+    timeoutMs: number,
+    options?: { defaultTimeoutMs?: number }
+  ): Promise<CdpConnection> {
+    const ws = new WebSocket(url);
+    await new Promise<void>((resolve, reject) => {
+      const timer = setTimeout(() => reject(new Error("CDP connection timeout.")), timeoutMs);
+      ws.addEventListener("open", () => {
+        clearTimeout(timer);
+        resolve();
+      });
+      ws.addEventListener("error", () => {
+        clearTimeout(timer);
+        reject(new Error("CDP connection failed."));
+      });
+    });
+    return new CdpConnection(ws, options?.defaultTimeoutMs ?? 15_000);
+  }
+
+  on(method: string, handler: (params: unknown) => void): void {
+    if (!this.eventHandlers.has(method)) {
+      this.eventHandlers.set(method, new Set());
+    }
+    this.eventHandlers.get(method)?.add(handler);
+  }
+
+  off(method: string, handler: (params: unknown) => void): void {
+    this.eventHandlers.get(method)?.delete(handler);
+  }
+
+  async send<T = unknown>(method: string, params?: Record<string, unknown>, options?: CdpSendOptions): Promise<T> {
+    const id = ++this.nextId;
+    const message: Record<string, unknown> = { id, method };
+    if (params) message.params = params;
+    if (options?.sessionId) message.sessionId = options.sessionId;
+
+    const timeoutMs = options?.timeoutMs ?? this.defaultTimeoutMs;
+    const result = await new Promise<unknown>((resolve, reject) => {
+      const timer = timeoutMs > 0
+        ? setTimeout(() => {
+          this.pending.delete(id);
+          reject(new Error(`CDP timeout: ${method}`));
+        }, timeoutMs)
+        : null;
+      this.pending.set(id, { resolve, reject, timer });
+      this.ws.send(JSON.stringify(message));
+    });
+
+    return result as T;
+  }
+
+  close(): void {
+    try {
+      this.ws.close();
+    } catch {}
+  }
+}
+
+export async function launchChrome(options: LaunchChromeOptions): Promise<ChildProcess> {
+  await fs.promises.mkdir(options.profileDir, { recursive: true });
+
+  const args = [
+    `--remote-debugging-port=${options.port}`,
+    `--user-data-dir=${options.profileDir}`,
+    "--no-first-run",
+    "--no-default-browser-check",
+    ...(options.extraArgs ?? []),
+  ];
+  if (options.headless) args.push("--headless=new");
+  if (options.url) args.push(options.url);
+
+  return spawn(options.chromePath, args, { stdio: "ignore" });
+}
+
+export function killChrome(chrome: ChildProcess): void {
+  try {
+    chrome.kill("SIGTERM");
+  } catch {}
+  setTimeout(() => {
+    if (!chrome.killed) {
+      try {
+        chrome.kill("SIGKILL");
+      } catch {}
+    }
+  }, 2_000).unref?.();
+}
+
+export async function openPageSession(options: OpenPageSessionOptions): Promise<PageSession> {
+  let targetId: string;
+
+  if (options.reusing) {
+    const created = await options.cdp.send<{ targetId: string }>("Target.createTarget", { url: options.url });
+    targetId = created.targetId;
+  } else {
+    const targets = await options.cdp.send<{ targetInfos: ChromeTargetInfo[] }>("Target.getTargets");
+    const existing = targets.targetInfos.find(options.matchTarget);
+    if (existing) {
+      targetId = existing.targetId;
+    } else {
+      const created = await options.cdp.send<{ targetId: string }>("Target.createTarget", { url: options.url });
+      targetId = created.targetId;
+    }
+  }
+
+  const { sessionId } = await options.cdp.send<{ sessionId: string }>(
+    "Target.attachToTarget",
+    { targetId, flatten: true }
+  );
+
+  if (options.activateTarget ?? true) {
+    await options.cdp.send("Target.activateTarget", { targetId });
+  }
+  if (options.enablePage) await options.cdp.send("Page.enable", {}, { sessionId });
+  if (options.enableRuntime) await options.cdp.send("Runtime.enable", {}, { sessionId });
+  if (options.enableDom) await options.cdp.send("DOM.enable", {}, { sessionId });
+  if (options.enableNetwork) await options.cdp.send("Network.enable", {}, { sessionId });
+
+  return { sessionId, targetId };
+}
@@ -1,6 +1,14 @@
 ---
 name: baoyu-danger-x-to-markdown
 description: Converts X (Twitter) tweets and articles to markdown with YAML front matter. Uses reverse-engineered API requiring user consent. Use when user mentions "X to markdown", "tweet to markdown", "save tweet", or provides x.com/twitter.com URLs for conversion.
+version: 1.56.1
+metadata:
+  openclaw:
+    homepage: https://github.com/JimLiu/baoyu-skills#baoyu-danger-x-to-markdown
+    requires:
+      anyBins:
+        - bun
+        - npx
 ---

 # X to Markdown
@@ -14,8 +22,8 @@ Converts X content to markdown:
 Scripts located in `scripts/` subdirectory.

 **Path Resolution**:
-1. `SKILL_DIR` = this SKILL.md's directory
-2. Script path = `${SKILL_DIR}/scripts/main.ts`
+1. `{baseDir}` = this SKILL.md's directory
+2. Script path = `{baseDir}/scripts/main.ts`
 3. Resolve `${BUN_X}` runtime: if `bun` installed → `bun`; if `npx` available → `npx -y bun`; else suggest installing bun

 ## Consent Requirement
@@ -75,12 +83,15 @@ Check EXTEND.md existence (priority order):
 ```bash
 # macOS, Linux, WSL, Git Bash
 test -f .baoyu-skills/baoyu-danger-x-to-markdown/EXTEND.md && echo "project"
+test -f "${XDG_CONFIG_HOME:-$HOME/.config}/baoyu-skills/baoyu-danger-x-to-markdown/EXTEND.md" && echo "xdg"
 test -f "$HOME/.baoyu-skills/baoyu-danger-x-to-markdown/EXTEND.md" && echo "user"
 ```

 ```powershell
 # PowerShell (Windows)
 if (Test-Path .baoyu-skills/baoyu-danger-x-to-markdown/EXTEND.md) { "project" }
+$xdg = if ($env:XDG_CONFIG_HOME) { $env:XDG_CONFIG_HOME } else { "$HOME/.config" }
+if (Test-Path "$xdg/baoyu-skills/baoyu-danger-x-to-markdown/EXTEND.md") { "xdg" }
 if (Test-Path "$HOME/.baoyu-skills/baoyu-danger-x-to-markdown/EXTEND.md") { "user" }
 ```

@@ -140,10 +151,10 @@ Full reference: [references/config/first-time-setup.md](references/config/first-
 ## Usage

 ```bash
-${BUN_X} ${SKILL_DIR}/scripts/main.ts <url>
-${BUN_X} ${SKILL_DIR}/scripts/main.ts <url> -o output.md
-${BUN_X} ${SKILL_DIR}/scripts/main.ts <url> --download-media
-${BUN_X} ${SKILL_DIR}/scripts/main.ts <url> --json
+${BUN_X} {baseDir}/scripts/main.ts <url>
+${BUN_X} {baseDir}/scripts/main.ts <url> -o output.md
+${BUN_X} {baseDir}/scripts/main.ts <url> --download-media
+${BUN_X} {baseDir}/scripts/main.ts <url> --json
 ```

 ## Options
@@ -0,0 +1,14 @@
+{
+  "lockfileVersion": 1,
+  "workspaces": {
+    "": {
+      "name": "baoyu-danger-x-to-markdown-scripts",
+      "dependencies": {
+        "baoyu-chrome-cdp": "file:./vendor/baoyu-chrome-cdp",
+      },
+    },
+  },
+  "packages": {
+    "baoyu-chrome-cdp": ["baoyu-chrome-cdp@file:vendor/baoyu-chrome-cdp", {}],
+  }
+}
@@ -1,7 +1,16 @@
-import { spawn, type ChildProcess } from "node:child_process";
-import fs from "node:fs";
-import { mkdir } from "node:fs/promises";
-import net from "node:net";
+import {
+  CdpConnection,
+  findChromeExecutable as findChromeExecutableBase,
+  findExistingChromeDebugPort,
+  getFreePort,
+  killChrome,
+  launchChrome as launchChromeBase,
+  openPageSession,
+  sleep,
+  waitForChromeDebugPort,
+  type PlatformCandidates,
+} from "baoyu-chrome-cdp";
+
 import process from "node:process";

 import { read_cookie_file, write_cookie_file } from "./cookie-file.js";
@@ -9,201 +18,47 @@ import { resolveXToMarkdownCookiePath } from "./paths.js";
 import { X_COOKIE_NAMES, X_REQUIRED_COOKIES, X_LOGIN_URL, X_USER_DATA_DIR } from "./constants.js";
 import type { CookieLike } from "./types.js";

-type CdpSendOptions = { sessionId?: string; timeoutMs?: number };
-
-function sleep(ms: number): Promise<void> {
-  return new Promise((resolve) => setTimeout(resolve, ms));
-}
-
-async function fetchWithTimeout(
-  url: string,
-  init: RequestInit & { timeoutMs?: number } = {}
-): Promise<Response> {
-  const { timeoutMs, ...rest } = init;
-  if (!timeoutMs || timeoutMs <= 0) return fetch(url, rest);
-
-  const ctl = new AbortController();
-  const t = setTimeout(() => ctl.abort(), timeoutMs);
-  try {
-    return await fetch(url, { ...rest, signal: ctl.signal });
-  } finally {
-    clearTimeout(t);
-  }
-}
-
-class CdpConnection {
-  private ws: WebSocket;
-  private nextId = 0;
-  private pending = new Map<
-    number,
-    { resolve: (v: unknown) => void; reject: (e: Error) => void; timer: ReturnType<typeof setTimeout> | null }
-  >();
-
-  private constructor(ws: WebSocket) {
-    this.ws = ws;
-    this.ws.addEventListener("message", (event) => {
-      try {
-        const data =
-          typeof event.data === "string"
-            ? event.data
-            : new TextDecoder().decode(event.data as ArrayBuffer);
-        const msg = JSON.parse(data) as { id?: number; result?: unknown; error?: { message?: string } };
-        if (msg.id) {
-          const p = this.pending.get(msg.id);
-          if (p) {
-            this.pending.delete(msg.id);
-            if (p.timer) clearTimeout(p.timer);
-            if (msg.error?.message) p.reject(new Error(msg.error.message));
-            else p.resolve(msg.result);
-          }
-        }
-      } catch {}
-    });
-    this.ws.addEventListener("close", () => {
-      for (const [id, p] of this.pending.entries()) {
-        this.pending.delete(id);
-        if (p.timer) clearTimeout(p.timer);
-        p.reject(new Error("CDP connection closed."));
-      }
-    });
-  }
-
-  static async connect(url: string, timeoutMs: number): Promise<CdpConnection> {
-    const ws = new WebSocket(url);
-    await new Promise<void>((resolve, reject) => {
-      const t = setTimeout(() => reject(new Error("CDP connection timeout.")), timeoutMs);
-      ws.addEventListener("open", () => {
-        clearTimeout(t);
-        resolve();
-      });
-      ws.addEventListener("error", () => {
-        clearTimeout(t);
-        reject(new Error("CDP connection failed."));
-      });
-    });
-    return new CdpConnection(ws);
-  }
-
-  async send<T = unknown>(
-    method: string,
-    params?: Record<string, unknown>,
-    opts?: CdpSendOptions
-  ): Promise<T> {
-    const id = ++this.nextId;
-    const msg: Record<string, unknown> = { id, method };
-    if (params) msg.params = params;
-    if (opts?.sessionId) msg.sessionId = opts.sessionId;
-
-    const timeoutMs = opts?.timeoutMs ?? 15_000;
-    const out = await new Promise<unknown>((resolve, reject) => {
-      const t =
-        timeoutMs > 0
-          ? setTimeout(() => {
-              this.pending.delete(id);
-              reject(new Error(`CDP timeout: ${method}`));
-            }, timeoutMs)
-          : null;
-      this.pending.set(id, { resolve, reject, timer: t });
-      this.ws.send(JSON.stringify(msg));
-    });
-    return out as T;
-  }
-
-  close(): void {
-    try {
-      this.ws.close();
-    } catch {}
-  }
-}
-
-async function getFreePort(): Promise<number> {
-  const fixed = parseInt(process.env.X_DEBUG_PORT || "", 10);
-  if (fixed > 0) return fixed;
-  return await new Promise((resolve, reject) => {
-    const srv = net.createServer();
-    srv.unref();
-    srv.on("error", reject);
-    srv.listen(0, "127.0.0.1", () => {
-      const addr = srv.address();
-      if (!addr || typeof addr === "string") {
-        srv.close(() => reject(new Error("Unable to allocate a free TCP port.")));
-        return;
-      }
-      const port = addr.port;
-      srv.close((err) => (err ? reject(err) : resolve(port)));
-    });
-  });
-}
+const CHROME_CANDIDATES_FULL: PlatformCandidates = {
+  darwin: [
+    "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome",
+    "/Applications/Google Chrome Canary.app/Contents/MacOS/Google Chrome Canary",
+    "/Applications/Google Chrome Beta.app/Contents/MacOS/Google Chrome Beta",
+    "/Applications/Chromium.app/Contents/MacOS/Chromium",
+    "/Applications/Microsoft Edge.app/Contents/MacOS/Microsoft Edge",
+  ],
+  win32: [
+    "C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe",
+    "C:\\Program Files (x86)\\Google\\Chrome\\Application\\chrome.exe",
+    "C:\\Program Files\\Microsoft\\Edge\\Application\\msedge.exe",
+    "C:\\Program Files (x86)\\Microsoft\\Edge\\Application\\msedge.exe",
+  ],
+  default: [
+    "/usr/bin/google-chrome",
+    "/usr/bin/google-chrome-stable",
+    "/usr/bin/chromium",
+    "/usr/bin/chromium-browser",
+    "/snap/bin/chromium",
+    "/usr/bin/microsoft-edge",
+  ],
+};

 function findChromeExecutable(): string | null {
-  const override = process.env.X_CHROME_PATH?.trim();
-  if (override && fs.existsSync(override)) return override;
-
-  const candidates: string[] = [];
-  switch (process.platform) {
-    case "darwin":
-      candidates.push(
-        "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome",
-        "/Applications/Google Chrome Canary.app/Contents/MacOS/Google Chrome Canary",
-        "/Applications/Google Chrome Beta.app/Contents/MacOS/Google Chrome Beta",
-        "/Applications/Chromium.app/Contents/MacOS/Chromium",
-        "/Applications/Microsoft Edge.app/Contents/MacOS/Microsoft Edge"
-      );
-      break;
-    case "win32":
-      candidates.push(
-        "C:\\\\Program Files\\\\Google\\\\Chrome\\\\Application\\\\chrome.exe",
-        "C:\\\\Program Files (x86)\\\\Google\\\\Chrome\\\\Application\\\\chrome.exe",
-        "C:\\\\Program Files\\\\Microsoft\\\\Edge\\\\Application\\\\msedge.exe",
-        "C:\\\\Program Files (x86)\\\\Microsoft\\\\Edge\\\\Application\\\\msedge.exe"
-      );
-      break;
-    default:
-      candidates.push(
-        "/usr/bin/google-chrome",
-        "/usr/bin/google-chrome-stable",
-        "/usr/bin/chromium",
-        "/usr/bin/chromium-browser",
-        "/snap/bin/chromium",
-        "/usr/bin/microsoft-edge"
-      );
-      break;
-  }
-
-  for (const p of candidates) {
-    if (fs.existsSync(p)) return p;
-  }
-  return null;
+  return findChromeExecutableBase({
+    candidates: CHROME_CANDIDATES_FULL,
+    envNames: ["X_CHROME_PATH"],
+  }) ?? null;
 }

-async function waitForChromeDebugPort(port: number, timeoutMs: number): Promise<string> {
-  const start = Date.now();
-  while (Date.now() - start < timeoutMs) {
-    try {
-      const res = await fetchWithTimeout(`http://127.0.0.1:${port}/json/version`, { timeoutMs: 5_000 });
-      if (!res.ok) throw new Error(`status=${res.status}`);
-      const j = (await res.json()) as { webSocketDebuggerUrl?: string };
-      if (j.webSocketDebuggerUrl) return j.webSocketDebuggerUrl;
-    } catch {}
-    await sleep(200);
-  }
-  throw new Error("Chrome debug port not ready");
-}
-
-async function launchChrome(profileDir: string, port: number): Promise<ChildProcess> {
-  const chrome = findChromeExecutable();
-  if (!chrome) throw new Error("Chrome executable not found.");
-
-  const args = [
-    `--remote-debugging-port=${port}`,
-    `--user-data-dir=${profileDir}`,
-    "--no-first-run",
-    "--no-default-browser-check",
-    "--disable-popup-blocking",
-    X_LOGIN_URL,
-  ];
-
-  return spawn(chrome, args, { stdio: "ignore" });
+async function launchChrome(profileDir: string, port: number) {
+  const chromePath = findChromeExecutable();
+  if (!chromePath) throw new Error("Chrome executable not found.");
+  return await launchChromeBase({
+    chromePath,
+    profileDir,
+    port,
+    url: X_LOGIN_URL,
+    extraArgs: ["--disable-popup-blocking"],
+  });
 }

 async function fetchXCookiesViaCdp(
@@ -212,25 +67,33 @@ async function fetchXCookiesViaCdp(
  verbose: boolean,
  log?: (message: string) => void
 ): Promise<Record<string, string>> {
-  await mkdir(profileDir, { recursive: true });
-
-  const port = await getFreePort();
-  const chrome = await launchChrome(profileDir, port);
+  const existingPort = await findExistingChromeDebugPort({ profileDir });
+  const reusing = existingPort !== null;
+  const port = existingPort ?? await getFreePort("X_DEBUG_PORT");
+  const chrome = reusing ? null : await launchChrome(profileDir, port);

  let cdp: CdpConnection | null = null;
+  let targetId: string | null = null;
  try {
-    const wsUrl = await waitForChromeDebugPort(port, 30_000);
+    const wsUrl = await waitForChromeDebugPort(port, 30_000, { includeLastError: true });
    cdp = await CdpConnection.connect(wsUrl, 15_000);

-    const { targetId } = await cdp.send<{ targetId: string }>("Target.createTarget", {
+    const page = await openPageSession({
+      cdp,
+      reusing,
      url: X_LOGIN_URL,
-      newWindow: true,
+      matchTarget: (target) => target.type === "page" && (
+        target.url.includes("x.com") || target.url.includes("twitter.com")
+      ),
+      enableNetwork: true,
    });
-    const { sessionId } = await cdp.send<{ sessionId: string }>("Target.attachToTarget", { targetId, flatten: true });
-    await cdp.send("Network.enable", {}, { sessionId });
+    const { sessionId } = page;
+    targetId = page.targetId;

    if (verbose) {
-      log?.("[x-cookies] Chrome opened. If needed, complete X login in the window. Waiting for cookies...");
+      log?.(reusing
+        ? `[x-cookies] Reusing existing Chrome on port ${port}. Waiting for cookies...`
+        : "[x-cookies] Chrome opened. If needed, complete X login in the window. Waiting for cookies...");
    }

    const start = Date.now();
@@ -255,22 +118,19 @@ async function fetchXCookiesViaCdp(
    throw new Error(`Timed out waiting for X cookies. Last keys: ${Object.keys(last).join(", ")}`);
  } finally {
    if (cdp) {
-      try {
-        await cdp.send("Browser.close", {}, { timeoutMs: 5_000 });
-      } catch {}
+      if (reusing && targetId) {
+        try {
+          await cdp.send("Target.closeTarget", { targetId }, { timeoutMs: 5_000 });
+        } catch {}
+      } else {
+        try {
+          await cdp.send("Browser.close", {}, { timeoutMs: 5_000 });
+        } catch {}
+      }
      cdp.close();
    }

-    try {
-      chrome.kill("SIGTERM");
-    } catch {}
-    setTimeout(() => {
-      if (!chrome.killed) {
-        try {
-          chrome.kill("SIGKILL");
-        } catch {}
-      }
-    }, 2_000).unref?.();
+    if (chrome) killChrome(chrome);
  }
 }

@@ -30,8 +30,22 @@ type ConsentRecord = {

 const DISCLAIMER_VERSION = "1.0";

+function formatScriptCommand(fallback: string): string {
+  const raw = process.argv[1];
+  const displayPath = raw
+    ? (() => {
+        const relative = path.relative(process.cwd(), raw);
+        return relative && !relative.startsWith("..") ? relative : raw;
+      })()
+    : fallback;
+  const quotedPath = displayPath.includes(" ")
+    ? `"${displayPath.replace(/"/g, '\\"')}"`
+    : displayPath;
+  return `npx -y bun ${quotedPath}`;
+}
+
 function printUsage(exitCode: number): never {
-  const cmd = "npx -y bun skills/baoyu-danger-x-to-markdown/scripts/main.ts";
+  const cmd = formatScriptCommand("scripts/main.ts");
  console.log(`X (Twitter) to Markdown

 Usage:
@@ -0,0 +1,8 @@
+{
+  "name": "baoyu-danger-x-to-markdown-scripts",
+  "private": true,
+  "type": "module",
+  "dependencies": {
+    "baoyu-chrome-cdp": "file:./vendor/baoyu-chrome-cdp"
+  }
+}
@@ -36,6 +36,20 @@ function normalizeInputUrl(input: string): string {
  }
 }

+function formatScriptCommand(fallback: string): string {
+  const raw = process.argv[1];
+  const displayPath = raw
+    ? (() => {
+        const relative = path.relative(process.cwd(), raw);
+        return relative && !relative.startsWith("..") ? relative : raw;
+      })()
+    : fallback;
+  const quotedPath = displayPath.includes(" ")
+    ? `"${displayPath.replace(/"/g, '\\"')}"`
+    : displayPath;
+  return `npx -y bun ${quotedPath}`;
+}
+
 function parseTweetId(input: string): string | null {
  const trimmed = input.trim();
  if (!trimmed) return null;
@@ -179,7 +193,7 @@ async function main() {
  const { url } = parseArgs();
  if (!url) {
    console.error("Usage:");
-    console.error("  npx -y bun skills/baoyu-danger-x-to-markdown/scripts/tweet-to-markdown.ts <tweet url>");
+    console.error(`  ${formatScriptCommand("scripts/tweet-to-markdown.ts")} <tweet url>`);
    process.exit(1);
  }

@@ -0,0 +1,9 @@
+{
+  "name": "baoyu-chrome-cdp",
+  "private": true,
+  "version": "0.1.0",
+  "type": "module",
+  "exports": {
+    ".": "./src/index.ts"
+  }
+}
@@ -0,0 +1,408 @@
+import { spawn, spawnSync, type ChildProcess } from "node:child_process";
+import fs from "node:fs";
+import net from "node:net";
+import os from "node:os";
+import path from "node:path";
+import process from "node:process";
+
+export type PlatformCandidates = {
+  darwin?: string[];
+  win32?: string[];
+  default: string[];
+};
+
+type PendingRequest = {
+  resolve: (value: unknown) => void;
+  reject: (error: Error) => void;
+  timer: ReturnType<typeof setTimeout> | null;
+};
+
+type CdpSendOptions = {
+  sessionId?: string;
+  timeoutMs?: number;
+};
+
+type FetchJsonOptions = {
+  timeoutMs?: number;
+};
+
+type FindChromeExecutableOptions = {
+  candidates: PlatformCandidates;
+  envNames?: string[];
+};
+
+type ResolveSharedChromeProfileDirOptions = {
+  envNames?: string[];
+  appDataDirName?: string;
+  profileDirName?: string;
+  wslWindowsHome?: string | null;
+};
+
+type FindExistingChromeDebugPortOptions = {
+  profileDir: string;
+  timeoutMs?: number;
+};
+
+type LaunchChromeOptions = {
+  chromePath: string;
+  profileDir: string;
+  port: number;
+  url?: string;
+  headless?: boolean;
+  extraArgs?: string[];
+};
+
+type ChromeTargetInfo = {
+  targetId: string;
+  url: string;
+  type: string;
+};
+
+type OpenPageSessionOptions = {
+  cdp: CdpConnection;
+  reusing: boolean;
+  url: string;
+  matchTarget: (target: ChromeTargetInfo) => boolean;
+  enablePage?: boolean;
+  enableRuntime?: boolean;
+  enableDom?: boolean;
+  enableNetwork?: boolean;
+  activateTarget?: boolean;
+};
+
+export type PageSession = {
+  sessionId: string;
+  targetId: string;
+};
+
+export function sleep(ms: number): Promise<void> {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+
+export async function getFreePort(fixedEnvName?: string): Promise<number> {
+  const fixed = fixedEnvName ? Number.parseInt(process.env[fixedEnvName] ?? "", 10) : NaN;
+  if (Number.isInteger(fixed) && fixed > 0) return fixed;
+
+  return await new Promise((resolve, reject) => {
+    const server = net.createServer();
+    server.unref();
+    server.on("error", reject);
+    server.listen(0, "127.0.0.1", () => {
+      const address = server.address();
+      if (!address || typeof address === "string") {
+        server.close(() => reject(new Error("Unable to allocate a free TCP port.")));
+        return;
+      }
+      const port = address.port;
+      server.close((err) => {
+        if (err) reject(err);
+        else resolve(port);
+      });
+    });
+  });
+}
+
+export function findChromeExecutable(options: FindChromeExecutableOptions): string | undefined {
+  for (const envName of options.envNames ?? []) {
+    const override = process.env[envName]?.trim();
+    if (override && fs.existsSync(override)) return override;
+  }
+
+  const candidates = process.platform === "darwin"
+    ? options.candidates.darwin ?? options.candidates.default
+    : process.platform === "win32"
+      ? options.candidates.win32 ?? options.candidates.default
+      : options.candidates.default;
+
+  for (const candidate of candidates) {
+    if (fs.existsSync(candidate)) return candidate;
+  }
+  return undefined;
+}
+
+export function resolveSharedChromeProfileDir(options: ResolveSharedChromeProfileDirOptions = {}): string {
+  for (const envName of options.envNames ?? []) {
+    const override = process.env[envName]?.trim();
+    if (override) return path.resolve(override);
+  }
+
+  const appDataDirName = options.appDataDirName ?? "baoyu-skills";
+  const profileDirName = options.profileDirName ?? "chrome-profile";
+
+  if (options.wslWindowsHome) {
+    return path.join(options.wslWindowsHome, ".local", "share", appDataDirName, profileDirName);
+  }
+
+  const base = process.platform === "darwin"
+    ? path.join(os.homedir(), "Library", "Application Support")
+    : process.platform === "win32"
+      ? (process.env.APPDATA ?? path.join(os.homedir(), "AppData", "Roaming"))
+      : (process.env.XDG_DATA_HOME ?? path.join(os.homedir(), ".local", "share"));
+  return path.join(base, appDataDirName, profileDirName);
+}
+
+async function fetchWithTimeout(url: string, timeoutMs?: number): Promise<Response> {
+  if (!timeoutMs || timeoutMs <= 0) return await fetch(url, { redirect: "follow" });
+
+  const ctl = new AbortController();
+  const timer = setTimeout(() => ctl.abort(), timeoutMs);
+  try {
+    return await fetch(url, { redirect: "follow", signal: ctl.signal });
+  } finally {
+    clearTimeout(timer);
+  }
+}
+
+async function fetchJson<T = unknown>(url: string, options: FetchJsonOptions = {}): Promise<T> {
+  const response = await fetchWithTimeout(url, options.timeoutMs);
+  if (!response.ok) {
+    throw new Error(`Request failed: ${response.status} ${response.statusText}`);
+  }
+  return await response.json() as T;
+}
+
+async function isDebugPortReady(port: number, timeoutMs = 3_000): Promise<boolean> {
+  try {
+    const version = await fetchJson<{ webSocketDebuggerUrl?: string }>(
+      `http://127.0.0.1:${port}/json/version`,
+      { timeoutMs }
+    );
+    return !!version.webSocketDebuggerUrl;
+  } catch {
+    return false;
+  }
+}
+
+export async function findExistingChromeDebugPort(options: FindExistingChromeDebugPortOptions): Promise<number | null> {
+  const timeoutMs = options.timeoutMs ?? 3_000;
+  const portFile = path.join(options.profileDir, "DevToolsActivePort");
+
+  try {
+    const content = fs.readFileSync(portFile, "utf-8");
+    const [portLine] = content.split(/\r?\n/);
+    const port = Number.parseInt(portLine?.trim() ?? "", 10);
+    if (port > 0 && await isDebugPortReady(port, timeoutMs)) return port;
+  } catch {}
+
+  if (process.platform === "win32") return null;
+
+  try {
+    const result = spawnSync("ps", ["aux"], { encoding: "utf-8", timeout: 5_000 });
+    if (result.status !== 0 || !result.stdout) return null;
+
+    const lines = result.stdout
+      .split("\n")
+      .filter((line) => line.includes(options.profileDir) && line.includes("--remote-debugging-port="));
+
+    for (const line of lines) {
+      const portMatch = line.match(/--remote-debugging-port=(\d+)/);
+      const port = Number.parseInt(portMatch?.[1] ?? "", 10);
+      if (port > 0 && await isDebugPortReady(port, timeoutMs)) return port;
+    }
+  } catch {}
+
+  return null;
+}
+
+export async function waitForChromeDebugPort(
+  port: number,
+  timeoutMs: number,
+  options?: { includeLastError?: boolean }
+): Promise<string> {
+  const start = Date.now();
+  let lastError: unknown = null;
+
+  while (Date.now() - start < timeoutMs) {
+    try {
+      const version = await fetchJson<{ webSocketDebuggerUrl?: string }>(
+        `http://127.0.0.1:${port}/json/version`,
+        { timeoutMs: 5_000 }
+      );
+      if (version.webSocketDebuggerUrl) return version.webSocketDebuggerUrl;
+      lastError = new Error("Missing webSocketDebuggerUrl");
+    } catch (error) {
+      lastError = error;
+    }
+    await sleep(200);
+  }
+
+  if (options?.includeLastError && lastError) {
+    throw new Error(
+      `Chrome debug port not ready: ${lastError instanceof Error ? lastError.message : String(lastError)}`
+    );
+  }
+  throw new Error("Chrome debug port not ready");
+}
+
+export class CdpConnection {
+  private ws: WebSocket;
+  private nextId = 0;
+  private pending = new Map<number, PendingRequest>();
+  private eventHandlers = new Map<string, Set<(params: unknown) => void>>();
+  private defaultTimeoutMs: number;
+
+  private constructor(ws: WebSocket, defaultTimeoutMs = 15_000) {
+    this.ws = ws;
+    this.defaultTimeoutMs = defaultTimeoutMs;
+
+    this.ws.addEventListener("message", (event) => {
+      try {
+        const data = typeof event.data === "string"
+          ? event.data
+          : new TextDecoder().decode(event.data as ArrayBuffer);
+        const msg = JSON.parse(data) as {
+          id?: number;
+          method?: string;
+          params?: unknown;
+          result?: unknown;
+          error?: { message?: string };
+        };
+
+        if (msg.method) {
+          const handlers = this.eventHandlers.get(msg.method);
+          if (handlers) {
+            handlers.forEach((handler) => handler(msg.params));
+          }
+        }
+
+        if (msg.id) {
+          const pending = this.pending.get(msg.id);
+          if (pending) {
+            this.pending.delete(msg.id);
+            if (pending.timer) clearTimeout(pending.timer);
+            if (msg.error?.message) pending.reject(new Error(msg.error.message));
+            else pending.resolve(msg.result);
+          }
+        }
+      } catch {}
+    });
+
+    this.ws.addEventListener("close", () => {
+      for (const [id, pending] of this.pending.entries()) {
+        this.pending.delete(id);
+        if (pending.timer) clearTimeout(pending.timer);
+        pending.reject(new Error("CDP connection closed."));
+      }
+    });
+  }
+
+  static async connect(
+    url: string,
+    timeoutMs: number,
+    options?: { defaultTimeoutMs?: number }
+  ): Promise<CdpConnection> {
+    const ws = new WebSocket(url);
+    await new Promise<void>((resolve, reject) => {
+      const timer = setTimeout(() => reject(new Error("CDP connection timeout.")), timeoutMs);
+      ws.addEventListener("open", () => {
+        clearTimeout(timer);
+        resolve();
+      });
+      ws.addEventListener("error", () => {
+        clearTimeout(timer);
+        reject(new Error("CDP connection failed."));
+      });
+    });
+    return new CdpConnection(ws, options?.defaultTimeoutMs ?? 15_000);
+  }
+
+  on(method: string, handler: (params: unknown) => void): void {
+    if (!this.eventHandlers.has(method)) {
+      this.eventHandlers.set(method, new Set());
+    }
+    this.eventHandlers.get(method)?.add(handler);
+  }
+
+  off(method: string, handler: (params: unknown) => void): void {
+    this.eventHandlers.get(method)?.delete(handler);
+  }
+
+  async send<T = unknown>(method: string, params?: Record<string, unknown>, options?: CdpSendOptions): Promise<T> {
+    const id = ++this.nextId;
+    const message: Record<string, unknown> = { id, method };
+    if (params) message.params = params;
+    if (options?.sessionId) message.sessionId = options.sessionId;
+
+    const timeoutMs = options?.timeoutMs ?? this.defaultTimeoutMs;
+    const result = await new Promise<unknown>((resolve, reject) => {
+      const timer = timeoutMs > 0
+        ? setTimeout(() => {
+          this.pending.delete(id);
+          reject(new Error(`CDP timeout: ${method}`));
+        }, timeoutMs)
+        : null;
+      this.pending.set(id, { resolve, reject, timer });
+      this.ws.send(JSON.stringify(message));
+    });
+
+    return result as T;
+  }
+
+  close(): void {
+    try {
+      this.ws.close();
+    } catch {}
+  }
+}
+
+export async function launchChrome(options: LaunchChromeOptions): Promise<ChildProcess> {
+  await fs.promises.mkdir(options.profileDir, { recursive: true });
+
+  const args = [
+    `--remote-debugging-port=${options.port}`,
+    `--user-data-dir=${options.profileDir}`,
+    "--no-first-run",
+    "--no-default-browser-check",
+    ...(options.extraArgs ?? []),
+  ];
+  if (options.headless) args.push("--headless=new");
+  if (options.url) args.push(options.url);
+
+  return spawn(options.chromePath, args, { stdio: "ignore" });
+}
+
+export function killChrome(chrome: ChildProcess): void {
+  try {
+    chrome.kill("SIGTERM");
+  } catch {}
+  setTimeout(() => {
+    if (!chrome.killed) {
+      try {
+        chrome.kill("SIGKILL");
+      } catch {}
+    }
+  }, 2_000).unref?.();
+}
+
+export async function openPageSession(options: OpenPageSessionOptions): Promise<PageSession> {
+  let targetId: string;
+
+  if (options.reusing) {
+    const created = await options.cdp.send<{ targetId: string }>("Target.createTarget", { url: options.url });
+    targetId = created.targetId;
+  } else {
+    const targets = await options.cdp.send<{ targetInfos: ChromeTargetInfo[] }>("Target.getTargets");
+    const existing = targets.targetInfos.find(options.matchTarget);
+    if (existing) {
+      targetId = existing.targetId;
+    } else {
+      const created = await options.cdp.send<{ targetId: string }>("Target.createTarget", { url: options.url });
+      targetId = created.targetId;
+    }
+  }
+
+  const { sessionId } = await options.cdp.send<{ sessionId: string }>(
+    "Target.attachToTarget",
+    { targetId, flatten: true }
+  );
+
+  if (options.activateTarget ?? true) {
+    await options.cdp.send("Target.activateTarget", { targetId });
+  }
+  if (options.enablePage) await options.cdp.send("Page.enable", {}, { sessionId });
+  if (options.enableRuntime) await options.cdp.send("Runtime.enable", {}, { sessionId });
+  if (options.enableDom) await options.cdp.send("DOM.enable", {}, { sessionId });
+  if (options.enableNetwork) await options.cdp.send("Network.enable", {}, { sessionId });
+
+  return { sessionId, targetId };
+}
@@ -1,6 +1,14 @@
 ---
 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.
+version: 1.56.1
+metadata:
+  openclaw:
+    homepage: https://github.com/JimLiu/baoyu-skills#baoyu-format-markdown
+    requires:
+      anyBins:
+        - bun
+        - npx
 ---

 # Markdown Formatter
@@ -11,7 +19,7 @@ Transforms plain text or markdown into well-structured, reader-friendly markdown

 ## Script Directory

-Scripts in `scripts/` subdirectory. `${SKILL_DIR}` = this SKILL.md's directory path. Resolve `${BUN_X}` runtime: if `bun` installed → `bun`; if `npx` available → `npx -y bun`; else suggest installing bun. Replace `${SKILL_DIR}` and `${BUN_X}` with actual values.
+Scripts in `scripts/` subdirectory. `{baseDir}` = this SKILL.md's directory path. Resolve `${BUN_X}` runtime: if `bun` installed → `bun`; if `npx` available → `npx -y bun`; else suggest installing bun. Replace `{baseDir}` and `${BUN_X}` with actual values.

 | Script | Purpose |
 |--------|---------|
@@ -26,12 +34,15 @@ Check EXTEND.md existence (priority order):
 ```bash
 # macOS, Linux, WSL, Git Bash
 test -f .baoyu-skills/baoyu-format-markdown/EXTEND.md && echo "project"
+test -f "${XDG_CONFIG_HOME:-$HOME/.config}/baoyu-skills/baoyu-format-markdown/EXTEND.md" && echo "xdg"
 test -f "$HOME/.baoyu-skills/baoyu-format-markdown/EXTEND.md" && echo "user"
 ```

 ```powershell
 # PowerShell (Windows)
 if (Test-Path .baoyu-skills/baoyu-format-markdown/EXTEND.md) { "project" }
+$xdg = if ($env:XDG_CONFIG_HOME) { $env:XDG_CONFIG_HOME } else { "$HOME/.config" }
+if (Test-Path "$xdg/baoyu-skills/baoyu-format-markdown/EXTEND.md") { "xdg" }
 if (Test-Path "$HOME/.baoyu-skills/baoyu-format-markdown/EXTEND.md") { "user" }
 ```

@@ -168,29 +179,55 @@ Check for YAML frontmatter (`---` block). Create if missing.

 **Title Generation:**

-Generate 3 candidate titles with different angles/styles. Present to user for selection:
+Whether or not a title already exists, always run the title optimization flow (unless `auto_select_title` is set).
+
+**Preparation** — read the full text and extract:
+- Core argument (one sentence: "what is this article about?")
+- Most impactful opinion or conclusion
+- Reader pain point or curiosity trigger
+- Most memorable metaphor or golden quote
+
+**Generate 3-4 style-differentiated candidates:**
+
+| Style | Characteristics | Example |
+|-------|----------------|---------|
+| Subversive | Deny common practice, create conflict | "All de-AI-flavor prompts are wrong" |
+| Solution | Give the answer directly, promise value | "One recipe to make AI write in your voice" |
+| Suspense | Reveal half, spark curiosity | "It took me six months to find how to remove AI flavor" |
+| Concrete number | Use numbers for credibility | "150 lines of docs taught AI my writing style" |
+
+Present to user:

 ```
 Pick a title:

-1. [Title A] — [angle/style note]
-2. [Title B] — [angle/style note]
-3. [Title C] — [angle/style note]
+1. [Title A] — (recommended)
+2. [Title B] — [style note]
+3. [Title C] — [style note]

 Enter number, or type a custom title:
 ```

-Title principles:
- Engaging, sparks reading interest
- Captures core message or most compelling angle
- Accurate, avoids clickbait
- Vary angles: e.g. story-driven, conclusion-driven, question-driven
+Put the strongest hook first and mark it (recommended).

-If frontmatter already has `title`, skip selection and use it. If first line is H1, extract to frontmatter as default title but still offer alternatives.
+**Title principles:**
+- **Hook in first 5 chars**: create information gap or cognitive conflict
+- **Specific > abstract**: "150 lines" beats "a document"
+- **Negation > affirmation**: "you're doing it wrong" beats "the right way"
+- **Conversational**: like chatting with a friend, not a paper title
+- **Max ~25 chars**: longer titles get truncated in feeds
+- **Accurate, not clickbait**: the article must deliver what the title promises
+
+**Prohibited patterns:**
+- "浅谈 XX"、"关于 XX 的思考"、"XX 的探索与实践"
+- "震惊！"、"万字长文"、"建议收藏"
+- Pure questions without direction: "AI 写作的未来在哪里？"
+
+If first line is H1, extract to frontmatter and remove from body. If frontmatter already has `title`, include it as context but still generate fresh candidates.

 **Summary Generation:**

-Generate 3 candidate summaries with different focuses. Present to user for selection:
+Generate 3 candidate summaries with different angles. Present to user:

 ```
 Pick a summary:
@@ -202,11 +239,17 @@ Pick a summary:
 Enter number, or type a custom summary:
 ```

-Summary principles:
+**Summary principles:**
 - 80-150 characters, precise and information-rich
- Convey article's core value, not just topic
- Vary focuses: e.g. problem-driven, result-driven, insight-driven
- Avoid generic descriptions like "本文介绍了..."
+- Convey **core value** to the reader, not just the topic
+- Vary angles: problem-driven, result-driven, insight-driven
+- **Hook the reader**: make them want to read the full article
+- Use concrete details (numbers, outcomes, specific methods) over vague descriptions
+
+**Prohibited patterns:**
+- "本文介绍了..."、"本文探讨了..."
+- Pure topic description without value proposition
+- Repeating the title in different words

 If frontmatter already has `summary`, skip selection and use it.

@@ -240,9 +283,11 @@ Apply formatting guided by the Step 2 analysis. The goal is making the content s

 **Formatting principles — what TO do:**
 - Preserve the author's voice, tone, and every word
- Use bold sparingly for genuinely important points
+- **Bold key conclusions and core takeaways** — the sentences a reader would highlight
 - Extract parallel items from prose into lists only when the structure is clearly there
- Add headings where the topic genuinely shifts
+- Add headings where the topic genuinely shifts — prefer vivid, specific headings over generic ones (e.g., "3 天搞定 vs 传统方案" over "方案对比")
+- Use tables for comparisons or structured data buried in prose
+- Use blockquotes for golden quotes, memorable statements, or important warnings
 - Fix obvious typos (based on Step 2 findings)

 ### Step 5: Save Formatted File
@@ -262,7 +307,7 @@ fi
 Run the formatting script on the output file:

 ```bash
-${BUN_X} ${SKILL_DIR}/scripts/main.ts {output-file-path} [options]
+${BUN_X} {baseDir}/scripts/main.ts {output-file-path} [options]
 ```

 **Script Options:**
@@ -280,13 +325,13 @@ ${BUN_X} ${SKILL_DIR}/scripts/main.ts {output-file-path} [options]

 ```bash
 # Default: spacing + emphasis enabled, quotes disabled
-${BUN_X} ${SKILL_DIR}/scripts/main.ts article.md
+${BUN_X} {baseDir}/scripts/main.ts article.md

 # Enable all features including quote replacement
-${BUN_X} ${SKILL_DIR}/scripts/main.ts article.md --quotes
+${BUN_X} {baseDir}/scripts/main.ts article.md --quotes

 # Only fix emphasis issues, skip spacing
-${BUN_X} ${SKILL_DIR}/scripts/main.ts article.md --no-spacing
+${BUN_X} {baseDir}/scripts/main.ts article.md --no-spacing
 ```

 **Script performs (based on options):**
@@ -319,7 +364,7 @@ Display a report summarizing all changes made:
 - Tables created: X
 - Code markers added: X
 - Blockquotes added: X
- Typos fixed: X [list each: "原文" → "修正"]
+- Typos fixed: X [list each: "original" → "corrected"]

 **Typography Script:**
 - CJK spacing: [applied/skipped]
@@ -1,10 +1,10 @@
-import { execSync } from "child_process";
+import { spawnSync } from "node:child_process";
+import process from "node:process";

 export function applyAutocorrect(filePath: string): boolean {
-  try {
-    execSync(`npx autocorrect-node --fix "${filePath}"`, { stdio: "inherit" });
-    return true;
-  } catch {
-    return false;
-  }
+  const npxCmd = process.platform === "win32" ? "npx.cmd" : "npx";
+  const result = spawnSync(npxCmd, ["autocorrect-node", "--fix", filePath], {
+    stdio: "inherit",
+  });
+  return result.status === 0;
 }
@@ -1,6 +1,14 @@
 ---
 name: baoyu-image-gen
-description: AI image generation with OpenAI, Google, DashScope and Replicate 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.
+description: AI image generation with OpenAI, Google, DashScope and Replicate APIs. Supports text-to-image, reference images, aspect ratios, and batch generation from saved prompt files. Sequential by default; use batch parallel generation when the user already has multiple prompts or wants stable multi-image throughput. Use when user asks to generate, create, or draw images.
+version: 1.56.1
+metadata:
+  openclaw:
+    homepage: https://github.com/JimLiu/baoyu-skills#baoyu-image-gen
+    requires:
+      anyBins:
+        - bun
+        - npx
 ---

 # Image Generation (AI SDK)
@@ -10,8 +18,8 @@ Official API-based image generation. Supports OpenAI, Google, DashScope (阿里
 ## Script Directory

 **Agent Execution**:
-1. `SKILL_DIR` = this SKILL.md file's directory
-2. Script path = `${SKILL_DIR}/scripts/main.ts`
+1. `{baseDir}` = this SKILL.md file's directory
+2. Script path = `{baseDir}/scripts/main.ts`
 3. Resolve `${BUN_X}` runtime: if `bun` installed → `bun`; if `npx` available → `npx -y bun`; else suggest installing bun

 ## Step 0: Load Preferences ⛔ BLOCKING
@@ -23,12 +31,15 @@ Check EXTEND.md existence (priority: project → user):
 ```bash
 # macOS, Linux, WSL, Git Bash
 test -f .baoyu-skills/baoyu-image-gen/EXTEND.md && echo "project"
+test -f "${XDG_CONFIG_HOME:-$HOME/.config}/baoyu-skills/baoyu-image-gen/EXTEND.md" && echo "xdg"
 test -f "$HOME/.baoyu-skills/baoyu-image-gen/EXTEND.md" && echo "user"
 ```

 ```powershell
 # PowerShell (Windows)
 if (Test-Path .baoyu-skills/baoyu-image-gen/EXTEND.md) { "project" }
+$xdg = if ($env:XDG_CONFIG_HOME) { $env:XDG_CONFIG_HOME } else { "$HOME/.config" }
+if (Test-Path "$xdg/baoyu-skills/baoyu-image-gen/EXTEND.md") { "xdg" }
 if (Test-Path "$HOME/.baoyu-skills/baoyu-image-gen/EXTEND.md") { "user" }
 ```

@@ -44,7 +55,7 @@ if (Test-Path "$HOME/.baoyu-skills/baoyu-image-gen/EXTEND.md") { "user" }
 | `.baoyu-skills/baoyu-image-gen/EXTEND.md` | Project directory |
 | `$HOME/.baoyu-skills/baoyu-image-gen/EXTEND.md` | User home |

-**EXTEND.md Supports**: Default provider | Default quality | Default aspect ratio | Default image size | Default models
+**EXTEND.md Supports**: Default provider | Default quality | Default aspect ratio | Default image size | Default models | Batch worker cap | Provider-specific batch limits

 Schema: `references/config/preferences-schema.md`

@@ -52,50 +63,85 @@ Schema: `references/config/preferences-schema.md`

 ```bash
 # Basic
-${BUN_X} ${SKILL_DIR}/scripts/main.ts --prompt "A cat" --image cat.png
+${BUN_X} {baseDir}/scripts/main.ts --prompt "A cat" --image cat.png

 # With aspect ratio
-${BUN_X} ${SKILL_DIR}/scripts/main.ts --prompt "A landscape" --image out.png --ar 16:9
+${BUN_X} {baseDir}/scripts/main.ts --prompt "A landscape" --image out.png --ar 16:9

 # High quality
-${BUN_X} ${SKILL_DIR}/scripts/main.ts --prompt "A cat" --image out.png --quality 2k
+${BUN_X} {baseDir}/scripts/main.ts --prompt "A cat" --image out.png --quality 2k

 # From prompt files
-${BUN_X} ${SKILL_DIR}/scripts/main.ts --promptfiles system.md content.md --image out.png
+${BUN_X} {baseDir}/scripts/main.ts --promptfiles system.md content.md --image out.png

 # With reference images (Google multimodal or OpenAI edits)
-${BUN_X} ${SKILL_DIR}/scripts/main.ts --prompt "Make blue" --image out.png --ref source.png
+${BUN_X} {baseDir}/scripts/main.ts --prompt "Make blue" --image out.png --ref source.png

 # With reference images (explicit provider/model)
-${BUN_X} ${SKILL_DIR}/scripts/main.ts --prompt "Make blue" --image out.png --provider google --model gemini-3-pro-image-preview --ref source.png
+${BUN_X} {baseDir}/scripts/main.ts --prompt "Make blue" --image out.png --provider google --model gemini-3-pro-image-preview --ref source.png

 # Specific provider
-${BUN_X} ${SKILL_DIR}/scripts/main.ts --prompt "A cat" --image out.png --provider openai
+${BUN_X} {baseDir}/scripts/main.ts --prompt "A cat" --image out.png --provider openai

 # DashScope (阿里通义万象)
-${BUN_X} ${SKILL_DIR}/scripts/main.ts --prompt "一只可爱的猫" --image out.png --provider dashscope
+${BUN_X} {baseDir}/scripts/main.ts --prompt "一只可爱的猫" --image out.png --provider dashscope

 # Replicate (google/nano-banana-pro)
-${BUN_X} ${SKILL_DIR}/scripts/main.ts --prompt "A cat" --image out.png --provider replicate
+${BUN_X} {baseDir}/scripts/main.ts --prompt "A cat" --image out.png --provider replicate

 # Replicate with specific model
-${BUN_X} ${SKILL_DIR}/scripts/main.ts --prompt "A cat" --image out.png --provider replicate --model google/nano-banana
+${BUN_X} {baseDir}/scripts/main.ts --prompt "A cat" --image out.png --provider replicate --model google/nano-banana
+
+# Batch mode with saved prompt files
+${BUN_X} {baseDir}/scripts/main.ts --batchfile batch.json
+
+# Batch mode with explicit worker count
+${BUN_X} {baseDir}/scripts/main.ts --batchfile batch.json --jobs 4 --json
 ```

+### Batch File Format
+
+```json
+{
+  "jobs": 4,
+  "tasks": [
+    {
+      "id": "hero",
+      "promptFiles": ["prompts/hero.md"],
+      "image": "out/hero.png",
+      "provider": "replicate",
+      "model": "google/nano-banana-pro",
+      "ar": "16:9",
+      "quality": "2k"
+    },
+    {
+      "id": "diagram",
+      "promptFiles": ["prompts/diagram.md"],
+      "image": "out/diagram.png",
+      "ref": ["references/original.png"]
+    }
+  ]
+}
+```
+
+Paths in `promptFiles`, `image`, and `ref` are resolved relative to the batch file's directory. `jobs` is optional (overridden by CLI `--jobs`). Top-level array format (without `jobs` wrapper) is also accepted.
+
 ## Options

 | Option | Description |
 |--------|-------------|
 | `--prompt <text>`, `-p` | Prompt text |
 | `--promptfiles <files...>` | Read prompt from files (concatenated) |
-| `--image <path>` | Output image path (required) |
-| `--provider google\|openai\|dashscope\|replicate` | Force provider (default: google) |
-| `--model <id>`, `-m` | Model ID (Google: `gemini-3-pro-image-preview`, `gemini-3.1-flash-image-preview`; OpenAI: `gpt-image-1.5`) |
+| `--image <path>` | Output image path (required in single-image mode) |
+| `--batchfile <path>` | JSON batch file for multi-image generation |
+| `--jobs <count>` | Worker count for batch mode (default: auto, max from config, built-in default 10) |
+| `--provider google\|openai\|dashscope\|replicate` | Force provider (default: auto-detect) |
+| `--model <id>`, `-m` | Model ID (Google: `gemini-3-pro-image-preview`, `gemini-3.1-flash-image-preview`; OpenAI: `gpt-image-1.5`, `gpt-image-1`) |
 | `--ar <ratio>` | Aspect ratio (e.g., `16:9`, `1:1`, `4:3`) |
 | `--size <WxH>` | Size (e.g., `1024x1024`) |
-| `--quality normal\|2k` | Quality preset (default: 2k) |
+| `--quality normal\|2k` | Quality preset (default: `2k`) |
 | `--imageSize 1K\|2K\|4K` | Image size for Google (default: from quality) |
-| `--ref <files...>` | Reference images. Supported by Google multimodal (`gemini-3-pro-image-preview`, `gemini-3-flash-preview`, `gemini-3.1-flash-image-preview`) and OpenAI edits (GPT Image models). If provider omitted: Google first, then OpenAI |
+| `--ref <files...>` | Reference images. Supported by Google multimodal, OpenAI GPT Image edits, and Replicate |
 | `--n <count>` | Number of images |
 | `--json` | JSON output |

@@ -115,6 +161,9 @@ ${BUN_X} ${SKILL_DIR}/scripts/main.ts --prompt "A cat" --image out.png --provide
 | `GOOGLE_BASE_URL` | Custom Google endpoint |
 | `DASHSCOPE_BASE_URL` | Custom DashScope endpoint |
 | `REPLICATE_BASE_URL` | Custom Replicate endpoint |
+| `BAOYU_IMAGE_GEN_MAX_WORKERS` | Override batch worker cap |
+| `BAOYU_IMAGE_GEN_<PROVIDER>_CONCURRENCY` | Override provider concurrency, e.g. `BAOYU_IMAGE_GEN_REPLICATE_CONCURRENCY` |
+| `BAOYU_IMAGE_GEN_<PROVIDER>_START_INTERVAL_MS` | Override provider start gap, e.g. `BAOYU_IMAGE_GEN_REPLICATE_START_INTERVAL_MS` |

 **Load Priority**: CLI args > EXTEND.md > env vars > `<cwd>/.baoyu-skills/.env` > `~/.baoyu-skills/.env`

@@ -144,10 +193,10 @@ Examples:

 ```bash
 # Use Replicate default model
-${BUN_X} ${SKILL_DIR}/scripts/main.ts --prompt "A cat" --image out.png --provider replicate
+${BUN_X} {baseDir}/scripts/main.ts --prompt "A cat" --image out.png --provider replicate

 # Override model explicitly
-${BUN_X} ${SKILL_DIR}/scripts/main.ts --prompt "A cat" --image out.png --provider replicate --model google/nano-banana
+${BUN_X} {baseDir}/scripts/main.ts --prompt "A cat" --image out.png --provider replicate --model google/nano-banana
 ```

 ## Provider Selection
@@ -159,10 +208,10 @@ ${BUN_X} ${SKILL_DIR}/scripts/main.ts --prompt "A cat" --image out.png --provide

 ## Quality Presets

-| Preset | Google imageSize | OpenAI Size | Use Case |
-|--------|------------------|-------------|----------|
-| `normal` | 1K | 1024px | Quick previews |
-| `2k` (default) | 2K | 2048px | Covers, illustrations, infographics |
+| Preset | Google imageSize | OpenAI Size | Replicate resolution | Use Case |
+|--------|------------------|-------------|----------------------|----------|
+| `normal` | 1K | 1024px | 1K | Quick previews |
+| `2k` (default) | 2K | 2048px | 2K | Covers, illustrations, infographics |

 **Google imageSize**: Can be overridden with `--imageSize 1K|2K|4K`

@@ -171,41 +220,48 @@ ${BUN_X} ${SKILL_DIR}/scripts/main.ts --prompt "A cat" --image out.png --provide
 Supported: `1:1`, `16:9`, `9:16`, `4:3`, `3:4`, `2.35:1`

 - Google multimodal: uses `imageConfig.aspectRatio`
- Google Imagen: uses `aspectRatio` parameter
 - OpenAI: maps to closest supported size
+- Replicate: passes `aspect_ratio` to model; when `--ref` is provided without `--ar`, defaults to `match_input_image`

 ## Generation Mode

-**Default**: Sequential generation (one image at a time). This ensures stable output and easier debugging.
+**Default**: Sequential generation.

-**Parallel Generation**: Only use when user explicitly requests parallel/concurrent generation.
+**Batch Parallel Generation**: When `--batchfile` contains 2 or more pending tasks, the script automatically enables parallel generation.

 | Mode | When to Use |
 |------|-------------|
 | Sequential (default) | Normal usage, single images, small batches |
-| Parallel | User explicitly requests, large batches (10+) |
+| Parallel batch | Batch mode with 2+ tasks |

-**Parallel Settings** (when requested):
+Execution choice:

-| Setting | Value |
-|---------|-------|
-| Recommended concurrency | 4 subagents |
-| Max concurrency | 8 subagents |
-| Use case | Large batch generation when user requests parallel |
+| Situation | Preferred approach | Why |
+|-----------|--------------------|-----|
+| One image, or 1-2 simple images | Sequential | Lower coordination overhead and easier debugging |
+| Multiple images already have saved prompt files | Batch (`--batchfile`) | Reuses finalized prompts, applies shared throttling/retries, and gives predictable throughput |
+| Each image still needs separate reasoning, prompt writing, or style exploration | Subagents | The work is still exploratory, so each image may need independent analysis before generation |
+| Output comes from `baoyu-article-illustrator` with `outline.md` + `prompts/` | Batch (`build-batch.ts` -> `--batchfile`) | That workflow already produces prompt files, so direct batch execution is the intended path |

-**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
-```
+Rule of thumb:
+
+- Prefer batch over subagents once prompt files are already saved and the task is "generate all of these"
+- Use subagents only when generation is coupled with per-image thinking, rewriting, or divergent creative exploration
+
+Parallel behavior:
+
+- Default worker count is automatic, capped by config, built-in default 10
+- Provider-specific throttling is applied only in batch mode, and the built-in defaults are tuned for faster throughput while still avoiding obvious RPM bursts
+- You can override worker count with `--jobs <count>`
+- Each image retries automatically up to 3 attempts
+- Final output includes success count, failure count, and per-image failure reasons

 ## Error Handling

 - Missing API key → error with setup instructions
- Generation failure → auto-retry once
+- Generation failure → auto-retry up to 3 attempts per image
 - Invalid aspect ratio → warning, proceed with default
- Reference images with unsupported provider/model → error with fix hint (switch to Google multimodal: `gemini-3-pro-image-preview`, `gemini-3.1-flash-image-preview`; or OpenAI GPT Image edits)
+- Reference images with unsupported provider/model → error with fix hint

 ## Extension Support

@@ -21,9 +21,25 @@ default_image_size: null    # 1K|2K|4K|null (Google only, overrides quality)

 default_model:
  google: null              # e.g., "gemini-3-pro-image-preview", "gemini-3.1-flash-image-preview"
-  openai: null              # e.g., "gpt-image-1.5"
+  openai: null              # e.g., "gpt-image-1.5", "gpt-image-1"
  dashscope: null           # e.g., "z-image-turbo"
  replicate: null           # e.g., "google/nano-banana-pro"
+
+batch:
+  max_workers: 10
+  provider_limits:
+    replicate:
+      concurrency: 5
+      start_interval_ms: 700
+    google:
+      concurrency: 3
+      start_interval_ms: 1100
+    openai:
+      concurrency: 3
+      start_interval_ms: 1100
+    dashscope:
+      concurrency: 3
+      start_interval_ms: 1100
 ---
 ```

@@ -40,6 +56,9 @@ default_model:
 | `default_model.openai` | string\|null | null | OpenAI default model |
 | `default_model.dashscope` | string\|null | null | DashScope default model |
 | `default_model.replicate` | string\|null | null | Replicate default model |
+| `batch.max_workers` | int\|null | 10 | Batch worker cap |
+| `batch.provider_limits.<provider>.concurrency` | int\|null | provider default | Max simultaneous requests per provider |
+| `batch.provider_limits.<provider>.start_interval_ms` | int\|null | provider default | Minimum gap between request starts per provider |

 ## Examples

@@ -65,5 +84,11 @@ default_model:
  openai: "gpt-image-1.5"
  dashscope: "z-image-turbo"
  replicate: "google/nano-banana-pro"
+batch:
+  max_workers: 10
+  provider_limits:
+    replicate:
+      concurrency: 5
+      start_interval_ms: 700
 ---
 ```
@@ -2,34 +2,108 @@ import path from "node:path";
 import process from "node:process";
 import { homedir } from "node:os";
 import { access, mkdir, readFile, writeFile } from "node:fs/promises";
-import type { CliArgs, Provider, ExtendConfig } from "./types";
+import type {
+  BatchFile,
+  BatchTaskInput,
+  CliArgs,
+  ExtendConfig,
+  Provider,
+} from "./types";
+
+type ProviderModule = {
+  getDefaultModel: () => string;
+  generateImage: (prompt: string, model: string, args: CliArgs) => Promise<Uint8Array>;
+};
+
+type PreparedTask = {
+  id: string;
+  prompt: string;
+  args: CliArgs;
+  provider: Provider;
+  model: string;
+  outputPath: string;
+  providerModule: ProviderModule;
+};
+
+type TaskResult = {
+  id: string;
+  provider: Provider;
+  model: string;
+  outputPath: string;
+  success: boolean;
+  attempts: number;
+  error: string | null;
+};
+
+type ProviderRateLimit = {
+  concurrency: number;
+  startIntervalMs: number;
+};
+
+type LoadedBatchTasks = {
+  tasks: BatchTaskInput[];
+  jobs: number | null;
+  batchDir: string;
+};
+
+const MAX_ATTEMPTS = 3;
+const DEFAULT_MAX_WORKERS = 10;
+const POLL_WAIT_MS = 250;
+const DEFAULT_PROVIDER_RATE_LIMITS: Record<Provider, ProviderRateLimit> = {
+  replicate: { concurrency: 5, startIntervalMs: 700 },
+  google: { concurrency: 3, startIntervalMs: 1100 },
+  openai: { concurrency: 3, startIntervalMs: 1100 },
+  dashscope: { concurrency: 3, startIntervalMs: 1100 },
+};

 function printUsage(): void {
  console.log(`Usage:
  npx -y bun scripts/main.ts --prompt "A cat" --image cat.png
-  npx -y bun scripts/main.ts --prompt "A landscape" --image landscape.png --ar 16:9
  npx -y bun scripts/main.ts --promptfiles system.md content.md --image out.png
+  npx -y bun scripts/main.ts --batchfile batch.json

 Options:
  -p, --prompt <text>       Prompt text
  --promptfiles <files...>  Read prompt from files (concatenated)
-  --image <path>            Output image path (required)
+  --image <path>            Output image path (required in single-image mode)
+  --batchfile <path>        JSON batch file for multi-image generation
+  --jobs <count>            Worker count for batch mode (default: auto, max from config, built-in default 10)
  --provider google|openai|dashscope|replicate  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)
  --quality normal|2k       Quality preset (default: 2k)
  --imageSize 1K|2K|4K      Image size for Google (default: from quality)
-  --ref <files...>          Reference images (Google multimodal or OpenAI edits)
-  --n <count>               Number of images (default: 1)
+  --ref <files...>          Reference images (Google multimodal, OpenAI GPT Image edits, or Replicate)
+  --n <count>               Number of images for the current task (default: 1)
  --json                    JSON output
  -h, --help                Show help

+Batch file format:
+  {
+    "jobs": 4,
+    "tasks": [
+      {
+        "id": "hero",
+        "promptFiles": ["prompts/hero.md"],
+        "image": "out/hero.png",
+        "provider": "replicate",
+        "model": "google/nano-banana-pro",
+        "ar": "16:9"
+      }
+    ]
+  }
+
+Behavior:
+  - Batch mode automatically runs in parallel when pending tasks >= 2
+  - Each image retries automatically up to 3 attempts
+  - Batch summary reports success count, failure count, and per-image errors
+
 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 (阿里云通义万象)
+  DASHSCOPE_API_KEY         DashScope API key
  REPLICATE_API_TOKEN       Replicate API token
  OPENAI_IMAGE_MODEL        Default OpenAI model (gpt-image-1.5)
  GOOGLE_IMAGE_MODEL        Default Google model (gemini-3-pro-image-preview)
@@ -40,6 +114,9 @@ Environment variables:
  GOOGLE_BASE_URL           Custom Google endpoint
  DASHSCOPE_BASE_URL        Custom DashScope endpoint
  REPLICATE_BASE_URL        Custom Replicate endpoint
+  BAOYU_IMAGE_GEN_MAX_WORKERS  Override batch worker cap
+  BAOYU_IMAGE_GEN_<PROVIDER>_CONCURRENCY  Override provider concurrency
+  BAOYU_IMAGE_GEN_<PROVIDER>_START_INTERVAL_MS  Override provider start gap in ms

 Env file load order: CLI args > EXTEND.md > process.env > <cwd>/.baoyu-skills/.env > ~/.baoyu-skills/.env`);
 }
@@ -57,6 +134,8 @@ function parseArgs(argv: string[]): CliArgs {
    imageSize: null,
    referenceImages: [],
    n: 1,
+    batchFile: null,
+    jobs: null,
    json: false,
    help: false,
  };
@@ -110,9 +189,26 @@ function parseArgs(argv: string[]): CliArgs {
      continue;
    }

+    if (a === "--batchfile") {
+      const v = argv[++i];
+      if (!v) throw new Error("Missing value for --batchfile");
+      out.batchFile = v;
+      continue;
+    }
+
+    if (a === "--jobs") {
+      const v = argv[++i];
+      if (!v) throw new Error("Missing value for --jobs");
+      out.jobs = parseInt(v, 10);
+      if (isNaN(out.jobs) || out.jobs < 1) throw new Error(`Invalid worker count: ${v}`);
+      continue;
+    }
+
    if (a === "--provider") {
      const v = argv[++i];
-      if (v !== "google" && v !== "openai" && v !== "dashscope" && v !== "replicate") throw new Error(`Invalid provider: ${v}`);
+      if (v !== "google" && v !== "openai" && v !== "dashscope" && v !== "replicate") {
+        throw new Error(`Invalid provider: ${v}`);
+      }
      out.provider = v;
      continue;
    }
@@ -228,9 +324,11 @@ function parseSimpleYaml(yaml: string): Partial<ExtendConfig> {
  const config: Partial<ExtendConfig> = {};
  const lines = yaml.split("\n");
  let currentKey: string | null = null;
+  let currentProvider: Provider | null = null;

  for (const line of lines) {
    const trimmed = line.trim();
+    const indent = line.match(/^\s*/)?.[0].length ?? 0;
    if (!trimmed || trimmed.startsWith("#")) continue;

    if (trimmed.includes(":") && !trimmed.startsWith("-")) {
@@ -247,18 +345,57 @@ function parseSimpleYaml(yaml: string): Partial<ExtendConfig> {
      } else if (key === "default_provider") {
        config.default_provider = value === "null" ? null : (value as Provider);
      } else if (key === "default_quality") {
-        config.default_quality = value === "null" ? null : (value as "normal" | "2k");
+        config.default_quality = value === "null" ? null : value as "normal" | "2k";
      } else if (key === "default_aspect_ratio") {
        const cleaned = value.replace(/['"]/g, "");
        config.default_aspect_ratio = cleaned === "null" ? null : cleaned;
      } else if (key === "default_image_size") {
-        config.default_image_size = value === "null" ? null : (value as "1K" | "2K" | "4K");
+        config.default_image_size = value === "null" ? null : value as "1K" | "2K" | "4K";
      } else if (key === "default_model") {
        config.default_model = { google: null, openai: null, dashscope: null, replicate: null };
        currentKey = "default_model";
-      } else if (currentKey === "default_model" && (key === "google" || key === "openai" || key === "dashscope" || key === "replicate")) {
+        currentProvider = null;
+      } else if (key === "batch") {
+        config.batch = {};
+        currentKey = "batch";
+        currentProvider = null;
+      } else if (currentKey === "batch" && indent >= 2 && key === "max_workers") {
+        config.batch ??= {};
+        config.batch.max_workers = value === "null" ? null : parseInt(value, 10);
+      } else if (currentKey === "batch" && indent >= 2 && key === "provider_limits") {
+        config.batch ??= {};
+        config.batch.provider_limits ??= {};
+        currentKey = "provider_limits";
+        currentProvider = null;
+      } else if (
+        currentKey === "provider_limits" &&
+        indent >= 4 &&
+        (key === "google" || key === "openai" || key === "dashscope" || key === "replicate")
+      ) {
+        config.batch ??= {};
+        config.batch.provider_limits ??= {};
+        config.batch.provider_limits[key] ??= {};
+        currentProvider = key;
+      } else if (
+        currentKey === "default_model" &&
+        (key === "google" || key === "openai" || key === "dashscope" || key === "replicate")
+      ) {
        const cleaned = value.replace(/['"]/g, "");
        config.default_model![key] = cleaned === "null" ? null : cleaned;
+      } else if (
+        currentKey === "provider_limits" &&
+        currentProvider &&
+        indent >= 6 &&
+        (key === "concurrency" || key === "start_interval_ms")
+      ) {
+        config.batch ??= {};
+        config.batch.provider_limits ??= {};
+        const providerLimit = (config.batch.provider_limits[currentProvider] ??= {});
+        if (key === "concurrency") {
+          providerLimit.concurrency = value === "null" ? null : parseInt(value, 10);
+        } else {
+          providerLimit.start_interval_ms = value === "null" ? null : parseInt(value, 10);
+        }
      }
    }
  }
@@ -280,7 +417,6 @@ async function loadExtendConfig(): Promise<Partial<ExtendConfig>> {
      const content = await readFile(p, "utf8");
      const yaml = extractYamlFrontMatter(content);
      if (!yaml) continue;
-
      return parseSimpleYaml(yaml);
    } catch {
      continue;
@@ -300,6 +436,57 @@ function mergeConfig(args: CliArgs, extend: Partial<ExtendConfig>): CliArgs {
  };
 }

+function parsePositiveInt(value: string | undefined): number | null {
+  if (!value) return null;
+  const parsed = parseInt(value, 10);
+  return Number.isFinite(parsed) && parsed > 0 ? parsed : null;
+}
+
+function parsePositiveBatchInt(value: unknown): number | null {
+  if (value === null || value === undefined) return null;
+  if (typeof value === "number") {
+    return Number.isInteger(value) && value > 0 ? value : null;
+  }
+  if (typeof value === "string") {
+    return parsePositiveInt(value);
+  }
+  return null;
+}
+
+function getConfiguredMaxWorkers(extendConfig: Partial<ExtendConfig>): number {
+  const envValue = parsePositiveInt(process.env.BAOYU_IMAGE_GEN_MAX_WORKERS);
+  const configValue = extendConfig.batch?.max_workers ?? null;
+  return Math.max(1, envValue ?? configValue ?? DEFAULT_MAX_WORKERS);
+}
+
+function getConfiguredProviderRateLimits(
+  extendConfig: Partial<ExtendConfig>
+): Record<Provider, ProviderRateLimit> {
+  const configured: Record<Provider, ProviderRateLimit> = {
+    replicate: { ...DEFAULT_PROVIDER_RATE_LIMITS.replicate },
+    google: { ...DEFAULT_PROVIDER_RATE_LIMITS.google },
+    openai: { ...DEFAULT_PROVIDER_RATE_LIMITS.openai },
+    dashscope: { ...DEFAULT_PROVIDER_RATE_LIMITS.dashscope },
+  };
+
+  for (const provider of ["replicate", "google", "openai", "dashscope"] as Provider[]) {
+    const envPrefix = `BAOYU_IMAGE_GEN_${provider.toUpperCase()}`;
+    const extendLimit = extendConfig.batch?.provider_limits?.[provider];
+    configured[provider] = {
+      concurrency:
+        parsePositiveInt(process.env[`${envPrefix}_CONCURRENCY`]) ??
+        extendLimit?.concurrency ??
+        configured[provider].concurrency,
+      startIntervalMs:
+        parsePositiveInt(process.env[`${envPrefix}_START_INTERVAL_MS`]) ??
+        extendLimit?.start_interval_ms ??
+        configured[provider].startIntervalMs,
+    };
+  }
+
+  return configured;
+}
+
 async function readPromptFromFiles(files: string[]): Promise<string> {
  const parts: string[] = [];
  for (const f of files) {
@@ -311,9 +498,12 @@ async function readPromptFromFiles(files: string[]): Promise<string> {
 async function readPromptFromStdin(): Promise<string | null> {
  if (process.stdin.isTTY) return null;
  try {
-    const t = await Bun.stdin.text();
-    const v = t.trim();
-    return v.length > 0 ? v : null;
+    const chunks: Buffer[] = [];
+    for await (const chunk of process.stdin) {
+      chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
+    }
+    const value = Buffer.concat(chunks).toString("utf8").trim();
+    return value.length > 0 ? value : null;
  } catch {
    return null;
  }
@@ -327,7 +517,13 @@ function normalizeOutputImagePath(p: string): string {
 }

 function detectProvider(args: CliArgs): Provider {
-  if (args.referenceImages.length > 0 && args.provider && args.provider !== "google" && args.provider !== "openai" && args.provider !== "replicate") {
+  if (
+    args.referenceImages.length > 0 &&
+    args.provider &&
+    args.provider !== "google" &&
+    args.provider !== "openai" &&
+    args.provider !== "replicate"
+  ) {
    throw new Error(
      "Reference images require a ref-capable provider. Use --provider google (Gemini multimodal), --provider openai (GPT Image edits), or --provider replicate."
    );
@@ -349,7 +545,12 @@ function detectProvider(args: CliArgs): Provider {
    );
  }

-  const available = [hasGoogle && "google", hasOpenai && "openai", hasDashscope && "dashscope", hasReplicate && "replicate"].filter(Boolean) as Provider[];
+  const available = [
+    hasGoogle && "google",
+    hasOpenai && "openai",
+    hasDashscope && "dashscope",
+    hasReplicate && "replicate",
+  ].filter(Boolean) as Provider[];

  if (available.length === 1) return available[0]!;
  if (available.length > 1) return available[0]!;
@@ -371,11 +572,6 @@ async function validateReferenceImages(referenceImages: string[]): Promise<void>
  }
 }

-type ProviderModule = {
-  getDefaultModel: () => string;
-  generateImage: (prompt: string, model: string, args: CliArgs) => Promise<Uint8Array>;
-};
-
 function isRetryableGenerationError(error: unknown): boolean {
  const msg = error instanceof Error ? error.message : String(error);
  const nonRetryableMarkers = [
@@ -384,26 +580,353 @@ function isRetryableGenerationError(error: unknown): boolean {
    "only supported",
    "No API key found",
    "is required",
+    "Invalid ",
+    "Unexpected ",
+    "API error (400)",
+    "API error (401)",
+    "API error (402)",
+    "API error (403)",
+    "API error (404)",
+    "temporarily disabled",
  ];
  return !nonRetryableMarkers.some((marker) => msg.includes(marker));
 }

 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;
-  }
-  if (provider === "replicate") {
-    return (await import("./providers/replicate")) as ProviderModule;
-  }
+  if (provider === "google") return (await import("./providers/google")) as ProviderModule;
+  if (provider === "dashscope") return (await import("./providers/dashscope")) as ProviderModule;
+  if (provider === "replicate") return (await import("./providers/replicate")) as ProviderModule;
  return (await import("./providers/openai")) as ProviderModule;
 }

+async function loadPromptForArgs(args: CliArgs): Promise<string | null> {
+  let prompt: string | null = args.prompt;
+  if (!prompt && args.promptFiles.length > 0) {
+    prompt = await readPromptFromFiles(args.promptFiles);
+  }
+  return prompt;
+}
+
+function getModelForProvider(
+  provider: Provider,
+  requestedModel: string | null,
+  extendConfig: Partial<ExtendConfig>,
+  providerModule: ProviderModule
+): string {
+  if (requestedModel) return requestedModel;
+  if (extendConfig.default_model) {
+    if (provider === "google" && extendConfig.default_model.google) return extendConfig.default_model.google;
+    if (provider === "openai" && extendConfig.default_model.openai) return extendConfig.default_model.openai;
+    if (provider === "dashscope" && extendConfig.default_model.dashscope) return extendConfig.default_model.dashscope;
+    if (provider === "replicate" && extendConfig.default_model.replicate) return extendConfig.default_model.replicate;
+  }
+  return providerModule.getDefaultModel();
+}
+
+async function prepareSingleTask(args: CliArgs, extendConfig: Partial<ExtendConfig>): Promise<PreparedTask> {
+  if (!args.quality) args.quality = "2k";
+
+  const prompt = (await loadPromptForArgs(args)) ?? (await readPromptFromStdin());
+  if (!prompt) throw new Error("Prompt is required");
+  if (!args.imagePath) throw new Error("--image is required");
+  if (args.referenceImages.length > 0) await validateReferenceImages(args.referenceImages);
+
+  const provider = detectProvider(args);
+  const providerModule = await loadProviderModule(provider);
+  const model = getModelForProvider(provider, args.model, extendConfig, providerModule);
+
+  return {
+    id: "single",
+    prompt,
+    args,
+    provider,
+    model,
+    outputPath: normalizeOutputImagePath(args.imagePath),
+    providerModule,
+  };
+}
+
+async function loadBatchTasks(batchFilePath: string): Promise<LoadedBatchTasks> {
+  const resolvedBatchFilePath = path.resolve(batchFilePath);
+  const content = await readFile(resolvedBatchFilePath, "utf8");
+  const parsed = JSON.parse(content.replace(/^\uFEFF/, "")) as BatchFile;
+  const batchDir = path.dirname(resolvedBatchFilePath);
+  if (Array.isArray(parsed)) {
+    return {
+      tasks: parsed,
+      jobs: null,
+      batchDir,
+    };
+  }
+  if (parsed && typeof parsed === "object" && Array.isArray(parsed.tasks)) {
+    const jobs = parsePositiveBatchInt(parsed.jobs);
+    if (parsed.jobs !== undefined && parsed.jobs !== null && jobs === null) {
+      throw new Error("Invalid batch file. jobs must be a positive integer when provided.");
+    }
+    return {
+      tasks: parsed.tasks,
+      jobs,
+      batchDir,
+    };
+  }
+  throw new Error("Invalid batch file. Expected an array of tasks or an object with a tasks array.");
+}
+
+function resolveBatchPath(batchDir: string, filePath: string): string {
+  return path.isAbsolute(filePath) ? filePath : path.resolve(batchDir, filePath);
+}
+
+function createTaskArgs(baseArgs: CliArgs, task: BatchTaskInput, batchDir: string): CliArgs {
+  return {
+    ...baseArgs,
+    prompt: task.prompt ?? null,
+    promptFiles: task.promptFiles ? task.promptFiles.map((filePath) => resolveBatchPath(batchDir, filePath)) : [],
+    imagePath: task.image ? resolveBatchPath(batchDir, task.image) : null,
+    provider: task.provider ?? baseArgs.provider ?? null,
+    model: task.model ?? baseArgs.model ?? null,
+    aspectRatio: task.ar ?? baseArgs.aspectRatio ?? null,
+    size: task.size ?? baseArgs.size ?? null,
+    quality: task.quality ?? baseArgs.quality ?? null,
+    imageSize: task.imageSize ?? baseArgs.imageSize ?? null,
+    referenceImages: task.ref ? task.ref.map((filePath) => resolveBatchPath(batchDir, filePath)) : [],
+    n: task.n ?? baseArgs.n,
+    batchFile: null,
+    jobs: baseArgs.jobs,
+    json: baseArgs.json,
+    help: false,
+  };
+}
+
+async function prepareBatchTasks(
+  args: CliArgs,
+  extendConfig: Partial<ExtendConfig>
+): Promise<{ tasks: PreparedTask[]; jobs: number | null }> {
+  if (!args.batchFile) throw new Error("--batchfile is required in batch mode");
+  const { tasks: taskInputs, jobs: batchJobs, batchDir } = await loadBatchTasks(args.batchFile);
+  if (taskInputs.length === 0) throw new Error("Batch file does not contain any tasks.");
+
+  const prepared: PreparedTask[] = [];
+  for (let i = 0; i < taskInputs.length; i++) {
+    const task = taskInputs[i]!;
+    const taskArgs = createTaskArgs(args, task, batchDir);
+    const prompt = await loadPromptForArgs(taskArgs);
+    if (!prompt) throw new Error(`Task ${i + 1} is missing prompt or promptFiles.`);
+    if (!taskArgs.imagePath) throw new Error(`Task ${i + 1} is missing image output path.`);
+    if (taskArgs.referenceImages.length > 0) await validateReferenceImages(taskArgs.referenceImages);
+
+    const provider = detectProvider(taskArgs);
+    const providerModule = await loadProviderModule(provider);
+    const model = getModelForProvider(provider, taskArgs.model, extendConfig, providerModule);
+    prepared.push({
+      id: task.id || `task-${String(i + 1).padStart(2, "0")}`,
+      prompt,
+      args: taskArgs,
+      provider,
+      model,
+      outputPath: normalizeOutputImagePath(taskArgs.imagePath),
+      providerModule,
+    });
+  }
+
+  return {
+    tasks: prepared,
+    jobs: args.jobs ?? batchJobs,
+  };
+}
+
+async function writeImage(outputPath: string, imageData: Uint8Array): Promise<void> {
+  await mkdir(path.dirname(outputPath), { recursive: true });
+  await writeFile(outputPath, imageData);
+}
+
+async function generatePreparedTask(task: PreparedTask): Promise<TaskResult> {
+  console.error(`Using ${task.provider} / ${task.model} for ${task.id}`);
+  console.error(
+    `Switch model: --model <id> | EXTEND.md default_model.${task.provider} | env ${task.provider.toUpperCase()}_IMAGE_MODEL`
+  );
+
+  let attempts = 0;
+  while (attempts < MAX_ATTEMPTS) {
+    attempts += 1;
+    try {
+      const imageData = await task.providerModule.generateImage(task.prompt, task.model, task.args);
+      await writeImage(task.outputPath, imageData);
+      return {
+        id: task.id,
+        provider: task.provider,
+        model: task.model,
+        outputPath: task.outputPath,
+        success: true,
+        attempts,
+        error: null,
+      };
+    } catch (error) {
+      const message = error instanceof Error ? error.message : String(error);
+      const canRetry = attempts < MAX_ATTEMPTS && isRetryableGenerationError(error);
+      if (canRetry) {
+        console.error(`[${task.id}] Attempt ${attempts}/${MAX_ATTEMPTS} failed, retrying...`);
+        continue;
+      }
+      return {
+        id: task.id,
+        provider: task.provider,
+        model: task.model,
+        outputPath: task.outputPath,
+        success: false,
+        attempts,
+        error: message,
+      };
+    }
+  }
+
+  return {
+    id: task.id,
+    provider: task.provider,
+    model: task.model,
+    outputPath: task.outputPath,
+    success: false,
+    attempts: MAX_ATTEMPTS,
+    error: "Unknown failure",
+  };
+}
+
+function createProviderGate(providerRateLimits: Record<Provider, ProviderRateLimit>) {
+  const state = new Map<Provider, { active: number; lastStartedAt: number }>();
+
+  return async function acquire(provider: Provider): Promise<() => void> {
+    const limit = providerRateLimits[provider];
+    while (true) {
+      const current = state.get(provider) ?? { active: 0, lastStartedAt: 0 };
+      const now = Date.now();
+      const enoughCapacity = current.active < limit.concurrency;
+      const enoughGap = now - current.lastStartedAt >= limit.startIntervalMs;
+      if (enoughCapacity && enoughGap) {
+        state.set(provider, { active: current.active + 1, lastStartedAt: now });
+        return () => {
+          const latest = state.get(provider) ?? { active: 1, lastStartedAt: now };
+          state.set(provider, {
+            active: Math.max(0, latest.active - 1),
+            lastStartedAt: latest.lastStartedAt,
+          });
+        };
+      }
+      await new Promise((resolve) => setTimeout(resolve, POLL_WAIT_MS));
+    }
+  };
+}
+
+function getWorkerCount(taskCount: number, jobs: number | null, maxWorkers: number): number {
+  const requested = jobs ?? Math.min(taskCount, maxWorkers);
+  return Math.max(1, Math.min(requested, taskCount, maxWorkers));
+}
+
+async function runBatchTasks(
+  tasks: PreparedTask[],
+  jobs: number | null,
+  extendConfig: Partial<ExtendConfig>
+): Promise<TaskResult[]> {
+  if (tasks.length === 1) {
+    return [await generatePreparedTask(tasks[0]!)];
+  }
+
+  const maxWorkers = getConfiguredMaxWorkers(extendConfig);
+  const providerRateLimits = getConfiguredProviderRateLimits(extendConfig);
+  const acquireProvider = createProviderGate(providerRateLimits);
+  const workerCount = getWorkerCount(tasks.length, jobs, maxWorkers);
+  console.error(`Batch mode: ${tasks.length} tasks, ${workerCount} workers, parallel mode enabled.`);
+  for (const provider of ["replicate", "google", "openai", "dashscope"] as Provider[]) {
+    const limit = providerRateLimits[provider];
+    console.error(`- ${provider}: concurrency=${limit.concurrency}, startIntervalMs=${limit.startIntervalMs}`);
+  }
+
+  let nextIndex = 0;
+  const results: TaskResult[] = new Array(tasks.length);
+
+  const worker = async (): Promise<void> => {
+    while (true) {
+      const currentIndex = nextIndex;
+      nextIndex += 1;
+      if (currentIndex >= tasks.length) return;
+
+      const task = tasks[currentIndex]!;
+      const release = await acquireProvider(task.provider);
+      try {
+        results[currentIndex] = await generatePreparedTask(task);
+      } finally {
+        release();
+      }
+    }
+  };
+
+  await Promise.all(Array.from({ length: workerCount }, () => worker()));
+  return results;
+}
+
+function printBatchSummary(results: TaskResult[]): void {
+  const successCount = results.filter((result) => result.success).length;
+  const failureCount = results.length - successCount;
+
+  console.error("");
+  console.error("Batch generation summary:");
+  console.error(`- Total: ${results.length}`);
+  console.error(`- Succeeded: ${successCount}`);
+  console.error(`- Failed: ${failureCount}`);
+
+  if (failureCount > 0) {
+    console.error("Failure reasons:");
+    for (const result of results.filter((item) => !item.success)) {
+      console.error(`- ${result.id}: ${result.error}`);
+    }
+  }
+}
+
+function emitJson(payload: unknown): void {
+  console.log(JSON.stringify(payload, null, 2));
+}
+
+async function runSingleMode(args: CliArgs, extendConfig: Partial<ExtendConfig>): Promise<void> {
+  const task = await prepareSingleTask(args, extendConfig);
+  const result = await generatePreparedTask(task);
+  if (!result.success) {
+    throw new Error(result.error || "Generation failed");
+  }
+
+  if (args.json) {
+    emitJson({
+      savedImage: result.outputPath,
+      provider: result.provider,
+      model: result.model,
+      attempts: result.attempts,
+      prompt: task.prompt.slice(0, 200),
+    });
+    return;
+  }
+
+  console.log(result.outputPath);
+}
+
+async function runBatchMode(args: CliArgs, extendConfig: Partial<ExtendConfig>): Promise<void> {
+  const { tasks, jobs } = await prepareBatchTasks(args, extendConfig);
+  const results = await runBatchTasks(tasks, jobs, extendConfig);
+  printBatchSummary(results);
+
+  if (args.json) {
+    emitJson({
+      mode: "batch",
+      total: results.length,
+      succeeded: results.filter((item) => item.success).length,
+      failed: results.filter((item) => !item.success).length,
+      results,
+    });
+  }
+
+  if (results.some((item) => !item.success)) {
+    process.exitCode = 1;
+  }
+}
+
 async function main(): Promise<void> {
  const args = parseArgs(process.argv.slice(2));
-
  if (args.help) {
    printUsage();
    return;
@@ -412,86 +935,18 @@ async function main(): Promise<void> {
  await loadEnv();
  const extendConfig = await loadExtendConfig();
  const mergedArgs = mergeConfig(args, extendConfig);
-
  if (!mergedArgs.quality) mergedArgs.quality = "2k";

-  let prompt: string | null = mergedArgs.prompt;
-  if (!prompt && mergedArgs.promptFiles.length > 0) prompt = await readPromptFromFiles(mergedArgs.promptFiles);
-  if (!prompt) prompt = await readPromptFromStdin();
-
-  if (!prompt) {
-    console.error("Error: Prompt is required");
-    printUsage();
-    process.exitCode = 1;
+  if (mergedArgs.batchFile) {
+    await runBatchMode(mergedArgs, extendConfig);
    return;
  }

-  if (!mergedArgs.imagePath) {
-    console.error("Error: --image is required");
-    printUsage();
-    process.exitCode = 1;
-    return;
-  }
-
-  if (mergedArgs.referenceImages.length > 0) {
-    await validateReferenceImages(mergedArgs.referenceImages);
-  }
-
-  const provider = detectProvider(mergedArgs);
-  const providerModule = await loadProviderModule(provider);
-
-  let model = mergedArgs.model;
-  if (!model && extendConfig.default_model) {
-    if (provider === "google") model = extendConfig.default_model.google ?? null;
-    if (provider === "openai") model = extendConfig.default_model.openai ?? null;
-    if (provider === "dashscope") model = extendConfig.default_model.dashscope ?? null;
-    if (provider === "replicate") model = extendConfig.default_model.replicate ?? null;
-  }
-  model = model || providerModule.getDefaultModel();
-
-  const outputPath = normalizeOutputImagePath(mergedArgs.imagePath);
-
-  let imageData: Uint8Array;
-  let retried = false;
-
-  while (true) {
-    try {
-      imageData = await providerModule.generateImage(prompt, model, mergedArgs);
-      break;
-    } catch (e) {
-      if (!retried && isRetryableGenerationError(e)) {
-        retried = true;
-        console.error("Generation failed, retrying...");
-        continue;
-      }
-      throw e;
-    }
-  }
-
-  const dir = path.dirname(outputPath);
-  await mkdir(dir, { recursive: true });
-  await writeFile(outputPath, imageData);
-
-  if (mergedArgs.json) {
-    console.log(
-      JSON.stringify(
-        {
-          savedImage: outputPath,
-          provider,
-          model,
-          prompt: prompt.slice(0, 200),
-        },
-        null,
-        2
-      )
-    );
-  } else {
-    console.log(outputPath);
-  }
+  await runSingleMode(mergedArgs, extendConfig);
 }

-main().catch((e) => {
-  const msg = e instanceof Error ? e.message : String(e);
-  console.error(msg);
+main().catch((error) => {
+  const message = error instanceof Error ? error.message : String(error);
+  console.error(message);
  process.exit(1);
 });
@@ -1,6 +1,6 @@
 import path from "node:path";
 import { readFile } from "node:fs/promises";
-import { execSync } from "node:child_process";
+import { execFileSync } from "node:child_process";
 import type { CliArgs } from "../types";

 const GOOGLE_MULTIMODAL_MODELS = [
@@ -76,14 +76,43 @@ async function postGoogleJsonViaCurl<T>(
 ): Promise<T> {
  const proxy = getHttpProxy();
  const bodyStr = JSON.stringify(body);
-  const proxyArgs = proxy ? `-x "${proxy}"` : "";
+  const args = [
+    "-s",
+    "--connect-timeout",
+    "30",
+    "--max-time",
+    "300",
+    ...(proxy ? ["-x", proxy] : []),
+    url,
+    "-H",
+    "Content-Type: application/json",
+    "-H",
+    `x-goog-api-key: ${apiKey}`,
+    "-d",
+    "@-",
+  ];

-  const result = execSync(
-    `curl -s --connect-timeout 30 --max-time 300 ${proxyArgs} "${url}" -H "Content-Type: application/json" -H "x-goog-api-key: ${apiKey}" -d @-`,
-    { input: bodyStr, maxBuffer: 100 * 1024 * 1024, timeout: 310000 },
-  );
+  let result = "";
+  try {
+    result = execFileSync("curl", args, {
+      input: bodyStr,
+      encoding: "utf8",
+      maxBuffer: 100 * 1024 * 1024,
+      timeout: 310000,
+    });
+  } catch (error) {
+    const e = error as { message?: string; stderr?: string | Buffer };
+    const stderrText =
+      typeof e.stderr === "string"
+        ? e.stderr
+        : e.stderr
+          ? e.stderr.toString("utf8")
+          : "";
+    const details = stderrText.trim() || e.message || "curl request failed";
+    throw new Error(`Google API request failed via curl: ${details}`);
+  }

-  const parsed = JSON.parse(result.toString()) as any;
+  const parsed = JSON.parse(result) as any;
  if (parsed.error) {
    throw new Error(
      `Google API error (${parsed.error.code}): ${parsed.error.message}`,
@@ -68,7 +68,11 @@ export async function generateImage(
  const baseURL = process.env.OPENAI_BASE_URL || "https://api.openai.com/v1";
  const apiKey = process.env.OPENAI_API_KEY;

-  if (!apiKey) throw new Error("OPENAI_API_KEY is required");
+  if (!apiKey) {
+    throw new Error(
+      "OPENAI_API_KEY is required. Codex/ChatGPT desktop login does not automatically grant OpenAI Images API access to this script."
+    );
+  }

  if (process.env.OPENAI_IMAGE_USE_CHAT === "true") {
    return generateWithChatCompletions(baseURL, apiKey, prompt, model);
@@ -36,22 +36,24 @@ function buildInput(prompt: string, args: CliArgs, referenceImages: string[]): R

  if (args.aspectRatio) {
    input.aspect_ratio = args.aspectRatio;
+  } else if (referenceImages.length > 0) {
+    input.aspect_ratio = "match_input_image";
  }

  if (args.n > 1) {
    input.number_of_images = args.n;
  }

+  if (args.quality === "normal") {
+    input.resolution = "1K";
+  } else if (args.quality === "2k") {
+    input.resolution = "2K";
+  }
+
  input.output_format = "png";

  if (referenceImages.length > 0) {
-    if (referenceImages.length === 1) {
-      input.image = referenceImages[0];
-    } else {
-      for (let i = 0; i < referenceImages.length; i++) {
-        input[`image${i > 0 ? i + 1 : ""}`] = referenceImages[i];
-      }
-    }
+    input.image_input = referenceImages;
  }

  return input;
@@ -13,10 +13,34 @@ export type CliArgs = {
  imageSize: string | null;
  referenceImages: string[];
  n: number;
+  batchFile: string | null;
+  jobs: number | null;
  json: boolean;
  help: boolean;
 };

+export type BatchTaskInput = {
+  id?: string;
+  prompt?: string | null;
+  promptFiles?: string[];
+  image?: string;
+  provider?: Provider | null;
+  model?: string | null;
+  ar?: string | null;
+  size?: string | null;
+  quality?: Quality | null;
+  imageSize?: "1K" | "2K" | "4K" | null;
+  ref?: string[];
+  n?: number;
+};
+
+export type BatchFile =
+  | BatchTaskInput[]
+  | {
+      tasks: BatchTaskInput[];
+      jobs?: number | null;
+    };
+
 export type ExtendConfig = {
  version: number;
  default_provider: Provider | null;
@@ -29,4 +53,16 @@ export type ExtendConfig = {
    dashscope: string | null;
    replicate: string | null;
  };
+  batch?: {
+    max_workers?: number | null;
+    provider_limits?: Partial<
+      Record<
+        Provider,
+        {
+          concurrency?: number | null;
+          start_interval_ms?: number | null;
+        }
+      >
+    >;
+  };
 };
@@ -1,6 +1,10 @@
 ---
 name: baoyu-infographic
 description: Generates professional infographics with 21 layout types and 20 visual styles. Analyzes content, recommends layout×style combinations, and generates publication-ready infographics. Use when user asks to create "infographic", "信息图", "visual summary", "可视化", or "高密度信息大图".
+version: 1.56.1
+metadata:
+  openclaw:
+    homepage: https://github.com/JimLiu/baoyu-skills#baoyu-infographic
 ---

 # Infographic Generator
@@ -143,12 +147,15 @@ Check EXTEND.md existence (priority order):
 ```bash
 # macOS, Linux, WSL, Git Bash
 test -f .baoyu-skills/baoyu-infographic/EXTEND.md && echo "project"
+test -f "${XDG_CONFIG_HOME:-$HOME/.config}/baoyu-skills/baoyu-infographic/EXTEND.md" && echo "xdg"
 test -f "$HOME/.baoyu-skills/baoyu-infographic/EXTEND.md" && echo "user"
 ```

 ```powershell
 # PowerShell (Windows)
 if (Test-Path .baoyu-skills/baoyu-infographic/EXTEND.md) { "project" }
+$xdg = if ($env:XDG_CONFIG_HOME) { $env:XDG_CONFIG_HOME } else { "$HOME/.config" }
+if (Test-Path "$xdg/baoyu-skills/baoyu-infographic/EXTEND.md") { "xdg" }
 if (Test-Path "$HOME/.baoyu-skills/baoyu-infographic/EXTEND.md") { "user" }
 ```

@@ -1,6 +1,14 @@
 ---
 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.
+description: Converts Markdown to styled HTML with WeChat-compatible themes. Supports code highlighting, math, PlantUML, footnotes, alerts, infographics, and optional bottom citations for external links. Use when user asks for "markdown to html", "convert md to html", "md转html", "微信外链转底部引用", or needs styled HTML output from markdown.
+version: 1.56.1
+metadata:
+  openclaw:
+    homepage: https://github.com/JimLiu/baoyu-skills#baoyu-markdown-to-html
+    requires:
+      anyBins:
+        - bun
+        - npx
 ---

 # Markdown to HTML Converter
@@ -9,7 +17,7 @@ Converts Markdown files to beautifully styled HTML with inline CSS, optimized fo

 ## Script Directory

-**Agent Execution**: Determine this SKILL.md directory as `SKILL_DIR`. Resolve `${BUN_X}` runtime: if `bun` installed → `bun`; if `npx` available → `npx -y bun`; else suggest installing bun. Replace `${SKILL_DIR}` and `${BUN_X}` with actual values.
+**Agent Execution**: Determine this SKILL.md directory as `{baseDir}`. Resolve `${BUN_X}` runtime: if `bun` installed → `bun`; if `npx` available → `npx -y bun`; else suggest installing bun. Replace `{baseDir}` and `${BUN_X}` with actual values.

 | Script | Purpose |
 |--------|---------|
@@ -22,12 +30,15 @@ Check EXTEND.md existence (priority order):
 ```bash
 # macOS, Linux, WSL, Git Bash
 test -f .baoyu-skills/baoyu-markdown-to-html/EXTEND.md && echo "project"
+test -f "${XDG_CONFIG_HOME:-$HOME/.config}/baoyu-skills/baoyu-markdown-to-html/EXTEND.md" && echo "xdg"
 test -f "$HOME/.baoyu-skills/baoyu-markdown-to-html/EXTEND.md" && echo "user"
 ```

 ```powershell
 # PowerShell (Windows)
 if (Test-Path .baoyu-skills/baoyu-markdown-to-html/EXTEND.md) { "project" }
+$xdg = if ($env:XDG_CONFIG_HOME) { $env:XDG_CONFIG_HOME } else { "$HOME/.config" }
+if (Test-Path "$xdg/baoyu-skills/baoyu-markdown-to-html/EXTEND.md") { "xdg" }
 if (Test-Path "$HOME/.baoyu-skills/baoyu-markdown-to-html/EXTEND.md") { "user" }
 ```

@@ -98,15 +109,26 @@ if (Test-Path "$HOME/.baoyu-skills/baoyu-post-to-wechat/EXTEND.md") { Select-Str

 | Theme | Description |
 |-------|-------------|
-| `default` (Recommended) | 经典主题 - 传统排版，标题居中带底边，二级标题白字彩底 |
-| `grace` | 优雅主题 - 文字阴影，圆角卡片，精致引用块 |
-| `simple` | 简洁主题 - 现代极简风，不对称圆角，清爽留白 |
-| `modern` | 现代主题 - 大圆角、药丸形标题、宽松行距（搭配 `--color red` 还原传统红金风格） |
+| `default` (Recommended) | Classic - traditional layout, centered title with bottom border, H2 with white text on colored background |
+| `grace` | Elegant - text shadow, rounded cards, refined blockquotes |
+| `simple` | Minimal - modern minimalist, asymmetric rounded corners, clean whitespace |
+| `modern` | Modern - large radius, pill-shaped titles, relaxed line height (pair with `--color red` for traditional red-gold style) |
+
+### Step 1.5: Determine Citation Mode
+
+**Default**: Off. Do not ask by default.
+
+**Enable only if the user explicitly asks** for "微信外链转底部引用", "底部引用", "文末引用", or passes `--cite`.
+
+**Behavior when enabled**:
+- Ordinary external links are rendered with numbered superscripts and collected under a final `引用链接` section.
+- `https://mp.weixin.qq.com/...` links stay as direct links and are not moved to the bottom.
+- Bare links where link text equals URL stay inline.

 ### Step 2: Convert

 ```bash
-${BUN_X} ${SKILL_DIR}/scripts/main.ts <markdown_file> --theme <theme>
+${BUN_X} {baseDir}/scripts/main.ts <markdown_file> --theme <theme> [--cite]
 ```

 ### Step 3: Report Result
@@ -116,7 +138,7 @@ Display the output path from JSON result. If backup was created, mention it.
 ## Usage

 ```bash
-${BUN_X} ${SKILL_DIR}/scripts/main.ts <markdown_file> [options]
+${BUN_X} {baseDir}/scripts/main.ts <markdown_file> [options]
 ```

 **Options:**
@@ -128,6 +150,7 @@ ${BUN_X} ${SKILL_DIR}/scripts/main.ts <markdown_file> [options]
 | `--font-family <name>` | Font: sans, serif, serif-cjk, mono, or CSS value | theme default |
 | `--font-size <N>` | Font size: 14px, 15px, 16px, 17px, 18px | 16px |
 | `--title <title>` | Override title from frontmatter | |
+| `--cite` | Convert external links to bottom citations, append `引用链接` section | false (off) |
 | `--keep-title` | Keep the first heading in content | false (removed) |
 | `--help` | Show help | |

@@ -135,37 +158,40 @@ ${BUN_X} ${SKILL_DIR}/scripts/main.ts <markdown_file> [options]

 | Name | Hex | Label |
 |------|-----|-------|
-| blue | #0F4C81 | 经典蓝 |
-| green | #009874 | 翡翠绿 |
-| vermilion | #FA5151 | 活力橘 |
-| yellow | #FECE00 | 柠檬黄 |
-| purple | #92617E | 薰衣紫 |
-| sky | #55C9EA | 天空蓝 |
-| rose | #B76E79 | 玫瑰金 |
-| olive | #556B2F | 橄榄绿 |
-| black | #333333 | 石墨黑 |
-| gray | #A9A9A9 | 雾烟灰 |
-| pink | #FFB7C5 | 樱花粉 |
-| red | #A93226 | 中国红 |
-| orange | #D97757 | 暖橘 (modern default) |
+| blue | #0F4C81 | Classic Blue |
+| green | #009874 | Emerald Green |
+| vermilion | #FA5151 | Vibrant Vermilion |
+| yellow | #FECE00 | Lemon Yellow |
+| purple | #92617E | Lavender Purple |
+| sky | #55C9EA | Sky Blue |
+| rose | #B76E79 | Rose Gold |
+| olive | #556B2F | Olive Green |
+| black | #333333 | Graphite Black |
+| gray | #A9A9A9 | Smoke Gray |
+| pink | #FFB7C5 | Sakura Pink |
+| red | #A93226 | China Red |
+| orange | #D97757 | Warm Orange (modern default) |

 **Examples:**

 ```bash
 # Basic conversion (uses default theme, removes first heading)
-${BUN_X} ${SKILL_DIR}/scripts/main.ts article.md
+${BUN_X} {baseDir}/scripts/main.ts article.md

 # With specific theme
-${BUN_X} ${SKILL_DIR}/scripts/main.ts article.md --theme grace
+${BUN_X} {baseDir}/scripts/main.ts article.md --theme grace

 # Theme with custom color
-${BUN_X} ${SKILL_DIR}/scripts/main.ts article.md --theme modern --color red
+${BUN_X} {baseDir}/scripts/main.ts article.md --theme modern --color red
+
+# Enable bottom citations for ordinary external links
+${BUN_X} {baseDir}/scripts/main.ts article.md --cite

 # Keep the first heading in content
-${BUN_X} ${SKILL_DIR}/scripts/main.ts article.md --keep-title
+${BUN_X} {baseDir}/scripts/main.ts article.md --keep-title

 # Override title
-${BUN_X} ${SKILL_DIR}/scripts/main.ts article.md --title "My Article"
+${BUN_X} {baseDir}/scripts/main.ts article.md --title "My Article"
 ```

 ## Output
@@ -200,10 +226,10 @@ ${BUN_X} ${SKILL_DIR}/scripts/main.ts article.md --title "My Article"

 | Theme | Description |
 |-------|-------------|
-| `default` | 经典主题 - 传统排版，标题居中带底边，二级标题白字彩底 |
-| `grace` | 优雅主题 - 文字阴影，圆角卡片，精致引用块 (by @brzhang) |
-| `simple` | 简洁主题 - 现代极简风，不对称圆角，清爽留白 (by @okooo5km) |
-| `modern` | 现代主题 - 大圆角、药丸形标题、宽松行距（搭配 `--color red` 还原传统红金风格） |
+| `default` | Classic - traditional layout, centered title with bottom border, H2 with white text on colored background |
+| `grace` | Elegant - text shadow, rounded cards, refined blockquotes (by @brzhang) |
+| `simple` | Minimal - modern minimalist, asymmetric rounded corners, clean whitespace (by @okooo5km) |
+| `modern` | Modern - large radius, pill-shaped titles, relaxed line height (pair with `--color red` for traditional red-gold style) |

 ## Supported Markdown Features

@@ -215,7 +241,7 @@ ${BUN_X} ${SKILL_DIR}/scripts/main.ts article.md --title "My Article"
 | Inline code | `` `code` `` |
 | Tables | GitHub-flavored markdown tables |
 | Images | `![alt](src)` |
-| Links | `[text](url)` with footnote references |
+| Links | `[text](url)`; add `--cite` to move ordinary external links into bottom references |
 | Blockquotes | `> quote` |
 | Lists | `-` unordered, `1.` ordered |
 | Alerts | `> [!NOTE]`, `> [!WARNING]`, etc. |
@@ -122,11 +122,15 @@ function parseFrontmatter(content: string): { frontmatter: Record<string, string
  return { frontmatter, body: match[2]! };
 }

-export async function convertMarkdown(markdownPath: string, options?: { title?: string; theme?: string; keepTitle?: boolean }): Promise<ParsedResult> {
+export async function convertMarkdown(
+  markdownPath: string,
+  options?: { title?: string; theme?: string; keepTitle?: boolean; citeStatus?: 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 citeStatus = options?.citeStatus ?? false;

  const { frontmatter, body } = parseFrontmatter(content);

@@ -191,7 +195,7 @@ export async function convertMarkdown(markdownPath: string, options?: { title?:

  const modifiedMarkdown = `---\n${Object.entries(frontmatter).map(([k, v]) => `${k}: ${v}`).join('\n')}\n---\n${modifiedBody}`;

-  console.error(`[markdown-to-html] Rendering with theme: ${theme}, keepTitle: ${keepTitle}`);
+  console.error(`[markdown-to-html] Rendering with theme: ${theme}, keepTitle: ${keepTitle}, citeStatus: ${citeStatus}`);

  const themeDefaults = THEME_STYLE_DEFAULTS[theme] ?? {};
  const style: StyleConfig = { ...DEFAULT_STYLE, ...themeDefaults };
@@ -199,7 +203,7 @@ export async function convertMarkdown(markdownPath: string, options?: { title?:
  const css = normalizeThemeCss(buildCss(baseCss, themeCss, style));
  const codeThemeCss = loadCodeThemeCss('github');

-  const renderer = initRenderer({});
+  const renderer = initRenderer({ citeStatus });
  const { html: baseHtml, readingTime } = renderMarkdown(modifiedMarkdown, renderer);
  let htmlContent = postProcessHtml(baseHtml, readingTime, renderer);
  if (!keepTitle) htmlContent = removeFirstHeading(htmlContent);
@@ -263,6 +267,7 @@ Usage:
 Options:
  --title <title>     Override title
  --theme <name>      Theme name (default, grace, simple). Default: default
+  --cite              Convert ordinary external links to bottom citations. Default: off
  --keep-title        Keep the first heading in content. Default: false (removed)
  --help              Show this help

@@ -284,6 +289,7 @@ Output JSON format:
 Example:
  npx -y bun main.ts article.md
  npx -y bun main.ts article.md --theme grace
+  npx -y bun main.ts article.md --cite
 `);
  process.exit(0);
 }
@@ -297,6 +303,7 @@ async function main(): Promise<void> {
  let markdownPath: string | undefined;
  let title: string | undefined;
  let theme: string | undefined;
+  let citeStatus = false;
  let keepTitle = false;

  for (let i = 0; i < args.length; i++) {
@@ -305,6 +312,8 @@ async function main(): Promise<void> {
      title = args[++i];
    } else if (arg === '--theme' && args[i + 1]) {
      theme = args[++i];
+    } else if (arg === '--cite') {
+      citeStatus = true;
    } else if (arg === '--keep-title') {
      keepTitle = true;
    } else if (!arg.startsWith('-')) {
@@ -322,7 +331,7 @@ async function main(): Promise<void> {
    process.exit(1);
  }

-  const result = await convertMarkdown(markdownPath, { title, theme, keepTitle });
+  const result = await convertMarkdown(markdownPath, { title, theme, keepTitle, citeStatus });
  console.log(JSON.stringify(result, null, 2));
 }

@@ -37,6 +37,10 @@ function parseExtendYaml(yaml: string): Partial<ExtendConfig> {
 export function loadExtendConfig(): Partial<ExtendConfig> {
  const paths = [
    path.join(process.cwd(), ".baoyu-skills", "baoyu-markdown-to-html", "EXTEND.md"),
+    path.join(
+      process.env.XDG_CONFIG_HOME || path.join(homedir(), ".config"),
+      "baoyu-skills", "baoyu-markdown-to-html", "EXTEND.md"
+    ),
    path.join(homedir(), ".baoyu-skills", "baoyu-markdown-to-html", "EXTEND.md"),
  ];
  for (const p of paths) {
@@ -1,6 +1,14 @@
 ---
 name: baoyu-post-to-wechat
-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 (贴图, formerly 图文) 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 (贴图, formerly 图文) with multiple images. Markdown article workflows default to converting ordinary external links into bottom citations for WeChat-friendly output. Use when user mentions "发布公众号", "post to wechat", "微信公众号", or "贴图/图文/文章".
+version: 1.56.1
+metadata:
+  openclaw:
+    homepage: https://github.com/JimLiu/baoyu-skills#baoyu-post-to-wechat
+    requires:
+      anyBins:
+        - bun
+        - npx
 ---

 # Post to WeChat Official Account
@@ -11,7 +19,7 @@ description: Posts content to WeChat Official Account (微信公众号) via API

 ## Script Directory

-**Agent Execution**: Determine this SKILL.md directory as `SKILL_DIR`, then use `${SKILL_DIR}/scripts/<name>.ts`. Resolve `${BUN_X}` runtime: if `bun` installed → `bun`; if `npx` available → `npx -y bun`; else suggest installing bun.
+**Agent Execution**: Determine this SKILL.md directory as `{baseDir}`, then use `{baseDir}/scripts/<name>.ts`. Resolve `${BUN_X}` runtime: if `bun` installed → `bun`; if `npx` available → `npx -y bun`; else suggest installing bun.

 | Script | Purpose |
 |--------|---------|
@@ -28,12 +36,15 @@ Check EXTEND.md existence (priority order):
 ```bash
 # macOS, Linux, WSL, Git Bash
 test -f .baoyu-skills/baoyu-post-to-wechat/EXTEND.md && echo "project"
+test -f "${XDG_CONFIG_HOME:-$HOME/.config}/baoyu-skills/baoyu-post-to-wechat/EXTEND.md" && echo "xdg"
 test -f "$HOME/.baoyu-skills/baoyu-post-to-wechat/EXTEND.md" && echo "user"
 ```

 ```powershell
 # PowerShell (Windows)
 if (Test-Path .baoyu-skills/baoyu-post-to-wechat/EXTEND.md) { "project" }
+$xdg = if ($env:XDG_CONFIG_HOME) { $env:XDG_CONFIG_HOME } else { "$HOME/.config" }
+if (Test-Path "$xdg/baoyu-skills/baoyu-post-to-wechat/EXTEND.md") { "xdg" }
 if (Test-Path "$HOME/.baoyu-skills/baoyu-post-to-wechat/EXTEND.md") { "user" }
 ```

@@ -84,15 +95,121 @@ chrome_profile_path: /path/to/chrome/profile
 **Value priority**:
 1. CLI arguments
 2. Frontmatter
-3. EXTEND.md
+3. EXTEND.md (account-level → global-level)
 4. Skill defaults

+## Multi-Account Support
+
+EXTEND.md supports managing multiple WeChat Official Accounts. When `accounts:` block is present, each account can have its own credentials, Chrome profile, and default settings.
+
+**Compatibility rules**:
+
+| Condition | Mode | Behavior |
+|-----------|------|----------|
+| No `accounts` block | Single-account | Current behavior, unchanged |
+| `accounts` with 1 entry | Single-account | Auto-select, no prompt |
+| `accounts` with 2+ entries | Multi-account | Prompt to select before publishing |
+| `accounts` with `default: true` | Multi-account | Pre-select default, user can switch |
+
+**Multi-account EXTEND.md example**:
+
+```md
+default_theme: default
+default_color: blue
+
+accounts:
+  - name: 宝玉的技术分享
+    alias: baoyu
+    default: true
+    default_publish_method: api
+    default_author: 宝玉
+    need_open_comment: 1
+    only_fans_can_comment: 0
+    app_id: wx1234567890abcdef
+    app_secret: abc123secret456
+  - name: AI工具集
+    alias: ai-tools
+    default_publish_method: browser
+    default_author: AI工具集
+    need_open_comment: 1
+    only_fans_can_comment: 0
+```
+
+**Per-account keys** (can be set per-account or globally as fallback):
+`default_publish_method`, `default_author`, `need_open_comment`, `only_fans_can_comment`, `app_id`, `app_secret`, `chrome_profile_path`
+
+**Global-only keys** (always shared across accounts):
+`default_theme`, `default_color`
+
+### Account Selection (Step 0.5)
+
+Insert between Step 0 and Step 1 in the Article Posting Workflow:
+
+```
+if no accounts block:
+    → single-account mode (current behavior)
+elif accounts.length == 1:
+    → auto-select the only account
+elif --account <alias> CLI arg:
+    → select matching account
+elif one account has default: true:
+    → pre-select, show: "Using account: <name> (--account to switch)"
+else:
+    → prompt user:
+      "Multiple WeChat accounts configured:
+       1) <name1> (<alias1>)
+       2) <name2> (<alias2>)
+       Select account [1-N]:"
+```
+
+### Credential Resolution (API Method)
+
+For a selected account with alias `{alias}`:
+
+1. `app_id` / `app_secret` inline in EXTEND.md account block
+2. Env var `WECHAT_{ALIAS}_APP_ID` / `WECHAT_{ALIAS}_APP_SECRET` (alias uppercased, hyphens → underscores)
+3. `.baoyu-skills/.env` with prefixed key `WECHAT_{ALIAS}_APP_ID`
+4. `~/.baoyu-skills/.env` with prefixed key
+5. Fallback to unprefixed `WECHAT_APP_ID` / `WECHAT_APP_SECRET`
+
+**.env multi-account example**:
+
+```bash
+# Account: baoyu
+WECHAT_BAOYU_APP_ID=wx1234567890abcdef
+WECHAT_BAOYU_APP_SECRET=abc123secret456
+
+# Account: ai-tools
+WECHAT_AI_TOOLS_APP_ID=wxabcdef1234567890
+WECHAT_AI_TOOLS_APP_SECRET=def789secret012
+```
+
+### Chrome Profile (Browser Method)
+
+Each account uses an isolated Chrome profile for independent login sessions:
+
+| Source | Path |
+|--------|------|
+| Account `chrome_profile_path` in EXTEND.md | Use as-is |
+| Auto-generated from alias | `{shared_profile_parent}/wechat-{alias}/` |
+| Single-account fallback | Shared default profile (current behavior) |
+
+### CLI `--account` Argument
+
+All publishing scripts accept `--account <alias>`:
+
+```bash
+${BUN_X} {baseDir}/scripts/wechat-api.ts <file> --theme default --account ai-tools
+${BUN_X} {baseDir}/scripts/wechat-article.ts --markdown <file> --theme default --account baoyu
+${BUN_X} {baseDir}/scripts/wechat-browser.ts --markdown <file> --images ./photos/ --account baoyu
+```
+
 ## Pre-flight Check (Optional)

 Before first use, suggest running the environment check. User can skip if they prefer.

 ```bash
-${BUN_X} ${SKILL_DIR}/scripts/check-permissions.ts
+${BUN_X} {baseDir}/scripts/check-permissions.ts
 ```

 Checks: Chrome, profile isolation, Bun, Accessibility, clipboard, paste keystroke, API credentials, Chrome conflicts.
@@ -115,8 +232,8 @@ Checks: Chrome, profile isolation, Bun, Accessibility, clipboard, paste keystrok
 For short posts with multiple images (up to 9):

 ```bash
-${BUN_X} ${SKILL_DIR}/scripts/wechat-browser.ts --markdown article.md --images ./images/
-${BUN_X} ${SKILL_DIR}/scripts/wechat-browser.ts --title "标题" --content "内容" --image img.png --submit
+${BUN_X} {baseDir}/scripts/wechat-browser.ts --markdown article.md --images ./images/
+${BUN_X} {baseDir}/scripts/wechat-browser.ts --title "标题" --content "内容" --image img.png --submit
 ```

 See [references/image-text-posting.md](references/image-text-posting.md) for details.
@@ -128,6 +245,7 @@ Copy this checklist and check off items as you complete them:
 ```
 Publishing Progress:
 - [ ] Step 0: Load preferences (EXTEND.md)
+- [ ] Step 0.5: Resolve account (multi-account only)
 - [ ] Step 1: Determine input type
 - [ ] Step 2: Select method and configure credentials
 - [ ] Step 3: Resolve theme/color and validate metadata
@@ -252,10 +370,15 @@ WECHAT_APP_SECRET=<user_input>

 **CRITICAL**: Publishing scripts handle markdown conversion internally. Do NOT pre-convert markdown to HTML — pass the original markdown file directly. This ensures the API method renders images as `<img>` tags (for API upload) while the browser method uses placeholders (for paste-and-replace workflow).

+**Markdown citation default**:
+- For markdown input, ordinary external links are converted to bottom citations by default.
+- Use `--no-cite` only if the user explicitly wants to keep ordinary external links inline.
+- Existing HTML input is left as-is; no extra citation conversion is applied.
+
 **API method** (accepts `.md` or `.html`):

 ```bash
-${BUN_X} ${SKILL_DIR}/scripts/wechat-api.ts <file> --theme <theme> [--color <color>] [--title <title>] [--summary <summary>] [--author <author>] [--cover <cover_path>]
+${BUN_X} {baseDir}/scripts/wechat-api.ts <file> --theme <theme> [--color <color>] [--title <title>] [--summary <summary>] [--author <author>] [--cover <cover_path>] [--no-cite]
 ```

 **CRITICAL**: Always include `--theme` parameter. Never omit it, even if using `default`. Only include `--color` if explicitly set by user or EXTEND.md.
@@ -274,8 +397,8 @@ If script parameters do not expose the two comment fields, still ensure final AP
 **Browser method** (accepts `--markdown` or `--html`):

 ```bash
-${BUN_X} ${SKILL_DIR}/scripts/wechat-article.ts --markdown <markdown_file> --theme <theme> [--color <color>]
-${BUN_X} ${SKILL_DIR}/scripts/wechat-article.ts --html <html_file>
+${BUN_X} {baseDir}/scripts/wechat-article.ts --markdown <markdown_file> --theme <theme> [--color <color>] [--no-cite]
+${BUN_X} {baseDir}/scripts/wechat-article.ts --html <html_file>
 ```

 ### Step 5: Completion Report
@@ -11,6 +11,9 @@ ${BUN_X} ./scripts/wechat-article.ts --markdown article.md
 # With theme
 ${BUN_X} ./scripts/wechat-article.ts --markdown article.md --theme grace

+# Disable bottom citations for ordinary external links
+${BUN_X} ./scripts/wechat-article.ts --markdown article.md --no-cite
+
 # With explicit options
 ${BUN_X} ./scripts/wechat-article.ts --markdown article.md --author "作者名" --summary "摘要"
 ```
@@ -21,6 +24,7 @@ ${BUN_X} ./scripts/wechat-article.ts --markdown article.md --author "作者名"
 |-----------|-------------|
 | `--markdown <path>` | Markdown file to convert and post |
 | `--theme <name>` | Theme: default, grace, simple, modern |
+| `--no-cite` | Keep ordinary external links inline instead of converting them to bottom citations |
 | `--title <text>` | Override title (auto-extracted from markdown) |
 | `--author <name>` | Author name |
 | `--summary <text>` | Article summary |
@@ -51,6 +55,8 @@ Regular paragraph with **bold** and *italic*.
 [Link text](https://example.com)
 ```

+Markdown mode converts ordinary external links into bottom citations by default for WeChat-friendly output. Use `--no-cite` to disable that behavior.
+
 ## Image Handling

 1. **Parse**: Images in markdown are replaced with `WECHATIMGPH_N`
@@ -152,6 +152,8 @@ options:

 ## EXTEND.md Template

+### Single Account (Default)
+
 ```md
 default_theme: [default/grace/simple/modern]
 default_color: [preset name, hex, or empty for theme default]
@@ -162,6 +164,40 @@ only_fans_can_comment: [1/0]
 chrome_profile_path:
 ```

+### Multi-Account
+
+```md
+default_theme: [default/grace/simple/modern]
+default_color: [preset name, hex, or empty for theme default]
+
+accounts:
+  - name: [display name]
+    alias: [short key, e.g. "baoyu"]
+    default: true
+    default_publish_method: [api/browser]
+    default_author: [author name]
+    need_open_comment: [1/0]
+    only_fans_can_comment: [1/0]
+    app_id: [WeChat App ID, optional]
+    app_secret: [WeChat App Secret, optional]
+  - name: [second account name]
+    alias: [short key, e.g. "ai-tools"]
+    default_publish_method: [api/browser]
+    default_author: [author name]
+    need_open_comment: [1/0]
+    only_fans_can_comment: [1/0]
+```
+
+## Adding More Accounts Later
+
+After initial setup, users can add accounts by editing EXTEND.md:
+
+1. Add an `accounts:` block with list items
+2. Move per-account settings (author, publish method, comments) into each account entry
+3. Keep global settings (theme, color) at the top level
+4. Each account needs a unique `alias` (used for CLI `--account` arg and Chrome profile naming)
+5. Set `default: true` on the primary account
+
 ## Modifying Preferences Later

 Users can edit EXTEND.md directly or delete it to trigger setup again.
@@ -0,0 +1,14 @@
+{
+  "lockfileVersion": 1,
+  "workspaces": {
+    "": {
+      "name": "baoyu-post-to-wechat-scripts",
+      "dependencies": {
+        "baoyu-chrome-cdp": "file:./vendor/baoyu-chrome-cdp",
+      },
+    },
+  },
+  "packages": {
+    "baoyu-chrome-cdp": ["baoyu-chrome-cdp@file:vendor/baoyu-chrome-cdp", {}],
+  }
+}
@@ -1,172 +1,89 @@
-import { spawn } from 'node:child_process';
-import fs from 'node:fs';
-import { mkdir } from 'node:fs/promises';
-import net from 'node:net';
-import os from 'node:os';
+import { execSync, type ChildProcess } from 'node:child_process';
 import path from 'node:path';
 import process from 'node:process';

-export function sleep(ms: number): Promise<void> {
-  return new Promise((resolve) => setTimeout(resolve, ms));
+import {
+  CdpConnection,
+  findChromeExecutable as findChromeExecutableBase,
+  findExistingChromeDebugPort as findExistingChromeDebugPortBase,
+  getFreePort as getFreePortBase,
+  launchChrome as launchChromeBase,
+  resolveSharedChromeProfileDir,
+  sleep,
+  waitForChromeDebugPort,
+  type PlatformCandidates,
+} from 'baoyu-chrome-cdp';
+
+export { CdpConnection, sleep, waitForChromeDebugPort };
+
+const CHROME_CANDIDATES_FULL: PlatformCandidates = {
+  darwin: [
+    '/Applications/Google Chrome.app/Contents/MacOS/Google Chrome',
+    '/Applications/Google Chrome Canary.app/Contents/MacOS/Google Chrome Canary',
+    '/Applications/Google Chrome Beta.app/Contents/MacOS/Google Chrome Beta',
+    '/Applications/Chromium.app/Contents/MacOS/Chromium',
+    '/Applications/Microsoft Edge.app/Contents/MacOS/Microsoft Edge',
+  ],
+  win32: [
+    'C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe',
+    'C:\\Program Files (x86)\\Google\\Chrome\\Application\\chrome.exe',
+    'C:\\Program Files\\Microsoft\\Edge\\Application\\msedge.exe',
+    'C:\\Program Files (x86)\\Microsoft\\Edge\\Application\\msedge.exe',
+  ],
+  default: [
+    '/usr/bin/google-chrome',
+    '/usr/bin/google-chrome-stable',
+    '/usr/bin/chromium',
+    '/usr/bin/chromium-browser',
+    '/snap/bin/chromium',
+    '/usr/bin/microsoft-edge',
+  ],
+};
+
+let wslHome: string | null | undefined;
+function getWslWindowsHome(): string | null {
+  if (wslHome !== undefined) return wslHome;
+  if (!process.env.WSL_DISTRO_NAME) {
+    wslHome = null;
+    return null;
+  }
+  try {
+    const raw = execSync('cmd.exe /C "echo %USERPROFILE%"', {
+      encoding: 'utf-8',
+      timeout: 5_000,
+    }).trim().replace(/\r/g, '');
+    wslHome = execSync(`wslpath -u "${raw}"`, {
+      encoding: 'utf-8',
+      timeout: 5_000,
+    }).trim() || null;
+  } catch {
+    wslHome = null;
+  }
+  return wslHome;
 }

 export async function getFreePort(): Promise<number> {
-  return new Promise((resolve, reject) => {
-    const server = net.createServer();
-    server.unref();
-    server.on('error', reject);
-    server.listen(0, '127.0.0.1', () => {
-      const address = server.address();
-      if (!address || typeof address === 'string') {
-        server.close(() => reject(new Error('Unable to allocate a free TCP port.')));
-        return;
-      }
-      const port = address.port;
-      server.close((err) => {
-        if (err) reject(err);
-        else resolve(port);
-      });
-    });
+  return await getFreePortBase('WECHAT_BROWSER_DEBUG_PORT');
+}
+
+export function findChromeExecutable(chromePathOverride?: string): string | undefined {
+  if (chromePathOverride?.trim()) return chromePathOverride.trim();
+  return findChromeExecutableBase({
+    candidates: CHROME_CANDIDATES_FULL,
+    envNames: ['WECHAT_BROWSER_CHROME_PATH'],
  });
 }

-export function findChromeExecutable(): string | undefined {
-  const override = process.env.WECHAT_BROWSER_CHROME_PATH?.trim();
-  if (override && fs.existsSync(override)) return override;
-
-  const candidates: string[] = [];
-  switch (process.platform) {
-    case 'darwin':
-      candidates.push(
-        '/Applications/Google Chrome.app/Contents/MacOS/Google Chrome',
-        '/Applications/Google Chrome Canary.app/Contents/MacOS/Google Chrome Canary',
-        '/Applications/Chromium.app/Contents/MacOS/Chromium',
-      );
-      break;
-    case 'win32':
-      candidates.push(
-        'C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe',
-        'C:\\Program Files (x86)\\Google\\Chrome\\Application\\chrome.exe',
-      );
-      break;
-    default:
-      candidates.push('/usr/bin/google-chrome', '/usr/bin/chromium');
-      break;
-  }
-
-  for (const p of candidates) {
-    if (fs.existsSync(p)) return p;
-  }
-  return undefined;
-}
-
 export function getDefaultProfileDir(): string {
-  const override = process.env.BAOYU_CHROME_PROFILE_DIR?.trim();
-  if (override) return path.resolve(override);
-  const base = process.platform === 'darwin'
-    ? path.join(os.homedir(), 'Library', 'Application Support')
-    : process.env.XDG_DATA_HOME || path.join(os.homedir(), '.local', 'share');
-  return path.join(base, 'baoyu-skills', 'chrome-profile');
+  return resolveSharedChromeProfileDir({
+    envNames: ['BAOYU_CHROME_PROFILE_DIR', 'WECHAT_BROWSER_PROFILE_DIR'],
+    wslWindowsHome: getWslWindowsHome(),
+  });
 }

-async function fetchJson<T = unknown>(url: string): Promise<T> {
-  const res = await fetch(url, { redirect: 'follow' });
-  if (!res.ok) throw new Error(`Request failed: ${res.status} ${res.statusText}`);
-  return (await res.json()) as T;
-}
-
-async function waitForChromeDebugPort(port: number, timeoutMs: number): Promise<string> {
-  const start = Date.now();
-  let lastError: unknown = null;
-
-  while (Date.now() - start < timeoutMs) {
-    try {
-      const version = await fetchJson<{ webSocketDebuggerUrl?: string }>(`http://127.0.0.1:${port}/json/version`);
-      if (version.webSocketDebuggerUrl) return version.webSocketDebuggerUrl;
-      lastError = new Error('Missing webSocketDebuggerUrl');
-    } catch (error) {
-      lastError = error;
-    }
-    await sleep(200);
-  }
-
-  throw new Error(`Chrome debug port not ready: ${lastError instanceof Error ? lastError.message : String(lastError)}`);
-}
-
-export class CdpConnection {
-  private ws: WebSocket;
-  private nextId = 0;
-  private pending = new Map<number, { resolve: (v: unknown) => void; reject: (e: Error) => void; timer: ReturnType<typeof setTimeout> | null }>();
-  private eventHandlers = new Map<string, Set<(params: unknown) => void>>();
-
-  private constructor(ws: WebSocket) {
-    this.ws = ws;
-    this.ws.addEventListener('message', (event) => {
-      try {
-        const data = typeof event.data === 'string' ? event.data : new TextDecoder().decode(event.data as ArrayBuffer);
-        const msg = JSON.parse(data) as { id?: number; method?: string; params?: unknown; result?: unknown; error?: { message?: string } };
-
-        if (msg.method) {
-          const handlers = this.eventHandlers.get(msg.method);
-          if (handlers) handlers.forEach((h) => h(msg.params));
-        }
-
-        if (msg.id) {
-          const pending = this.pending.get(msg.id);
-          if (pending) {
-            this.pending.delete(msg.id);
-            if (pending.timer) clearTimeout(pending.timer);
-            if (msg.error?.message) pending.reject(new Error(msg.error.message));
-            else pending.resolve(msg.result);
-          }
-        }
-      } catch {}
-    });
-
-    this.ws.addEventListener('close', () => {
-      for (const [id, pending] of this.pending.entries()) {
-        this.pending.delete(id);
-        if (pending.timer) clearTimeout(pending.timer);
-        pending.reject(new Error('CDP connection closed.'));
-      }
-    });
-  }
-
-  static async connect(url: string, timeoutMs: number): Promise<CdpConnection> {
-    const ws = new WebSocket(url);
-    await new Promise<void>((resolve, reject) => {
-      const timer = setTimeout(() => reject(new Error('CDP connection timeout.')), timeoutMs);
-      ws.addEventListener('open', () => { clearTimeout(timer); resolve(); });
-      ws.addEventListener('error', () => { clearTimeout(timer); reject(new Error('CDP connection failed.')); });
-    });
-    return new CdpConnection(ws);
-  }
-
-  on(method: string, handler: (params: unknown) => void): void {
-    if (!this.eventHandlers.has(method)) this.eventHandlers.set(method, new Set());
-    this.eventHandlers.get(method)!.add(handler);
-  }
-
-  async send<T = unknown>(method: string, params?: Record<string, unknown>, options?: { sessionId?: string; timeoutMs?: number }): Promise<T> {
-    const id = ++this.nextId;
-    const message: Record<string, unknown> = { id, method };
-    if (params) message.params = params;
-    if (options?.sessionId) message.sessionId = options.sessionId;
-
-    const timeoutMs = options?.timeoutMs ?? 15_000;
-
-    const result = await new Promise<unknown>((resolve, reject) => {
-      const timer = timeoutMs > 0 ? setTimeout(() => { this.pending.delete(id); reject(new Error(`CDP timeout: ${method}`)); }, timeoutMs) : null;
-      this.pending.set(id, { resolve, reject, timer });
-      this.ws.send(JSON.stringify(message));
-    });
-
-    return result as T;
-  }
-
-  close(): void {
-    try { this.ws.close(); } catch {}
-  }
+export function getAccountProfileDir(alias: string): string {
+  const base = getDefaultProfileDir();
+  return path.join(path.dirname(base), `wechat-${alias}`);
 }

 export interface ChromeSession {
@@ -177,56 +94,38 @@ export interface ChromeSession {

 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;
+    const wsUrl = await waitForChromeDebugPort(port, 5_000, { includeLastError: true });
+    return await CdpConnection.connect(wsUrl, 5_000);
+  } 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 findExistingChromeDebugPort(profileDir = getDefaultProfileDir()): Promise<number | null> {
+  return await findExistingChromeDebugPortBase({ profileDir });
 }

-export async function launchChrome(url: string, profileDir?: string): Promise<{ cdp: CdpConnection; chrome: ReturnType<typeof spawn> }> {
-  const chromePath = findChromeExecutable();
+export async function launchChrome(
+  url: string,
+  profileDir?: string,
+  chromePathOverride?: string,
+): Promise<{ cdp: CdpConnection; chrome: ChildProcess }> {
+  const chromePath = findChromeExecutable(chromePathOverride);
  if (!chromePath) throw new Error('Chrome not found. Set WECHAT_BROWSER_CHROME_PATH env var.');

  const profile = profileDir ?? getDefaultProfileDir();
-  await mkdir(profile, { recursive: true });
-
  const port = await getFreePort();
  console.log(`[cdp] Launching Chrome (profile: ${profile})`);

-  const chrome = spawn(chromePath, [
-    `--remote-debugging-port=${port}`,
-    `--user-data-dir=${profile}`,
-    '--no-first-run',
-    '--no-default-browser-check',
-    '--disable-blink-features=AutomationControlled',
-    '--start-maximized',
+  const chrome = await launchChromeBase({
+    chromePath,
+    profileDir: profile,
+    port,
    url,
-  ], { stdio: 'ignore' });
+    extraArgs: ['--disable-blink-features=AutomationControlled', '--start-maximized'],
+  });

-  const wsUrl = await waitForChromeDebugPort(port, 30_000);
+  const wsUrl = await waitForChromeDebugPort(port, 30_000, { includeLastError: true });
  const cdp = await CdpConnection.connect(wsUrl, 30_000);

  return { cdp, chrome };
@@ -234,11 +133,14 @@ export async function launchChrome(url: string, profileDir?: string): Promise<{

 export async function getPageSession(cdp: CdpConnection, urlPattern: string): Promise<ChromeSession> {
  const targets = await cdp.send<{ targetInfos: Array<{ targetId: string; url: string; type: string }> }>('Target.getTargets');
-  let pageTarget = targets.targetInfos.find((t) => t.type === 'page' && t.url.includes(urlPattern));
+  const pageTarget = targets.targetInfos.find((target) => target.type === 'page' && target.url.includes(urlPattern));

  if (!pageTarget) throw new Error(`Page not found: ${urlPattern}`);

-  const { sessionId } = await cdp.send<{ sessionId: string }>('Target.attachToTarget', { targetId: pageTarget.targetId, flatten: true });
+  const { sessionId } = await cdp.send<{ sessionId: string }>('Target.attachToTarget', {
+    targetId: pageTarget.targetId,
+    flatten: true,
+  });

  await cdp.send('Page.enable', {}, { sessionId });
  await cdp.send('Runtime.enable', {}, { sessionId });
@@ -247,11 +149,20 @@ export async function getPageSession(cdp: CdpConnection, urlPattern: string): Pr
  return { cdp, sessionId, targetId: pageTarget.targetId };
 }

-export async function waitForNewTab(cdp: CdpConnection, initialIds: Set<string>, urlPattern: string, timeoutMs = 30_000): Promise<string> {
+export async function waitForNewTab(
+  cdp: CdpConnection,
+  initialIds: Set<string>,
+  urlPattern: string,
+  timeoutMs = 30_000,
+): Promise<string> {
  const start = Date.now();
  while (Date.now() - start < timeoutMs) {
    const targets = await cdp.send<{ targetInfos: Array<{ targetId: string; url: string; type: string }> }>('Target.getTargets');
-    const newTab = targets.targetInfos.find(t => t.type === 'page' && !initialIds.has(t.targetId) && t.url.includes(urlPattern));
+    const newTab = targets.targetInfos.find((target) => (
+      target.type === 'page' &&
+      !initialIds.has(target.targetId) &&
+      target.url.includes(urlPattern)
+    ));
    if (newTab) return newTab.targetId;
    await sleep(500);
  }
@@ -259,7 +170,7 @@ export async function waitForNewTab(cdp: CdpConnection, initialIds: Set<string>,
 }

 export async function clickElement(session: ChromeSession, selector: string): Promise<void> {
-  const posResult = await session.cdp.send<{ result: { value: string } }>('Runtime.evaluate', {
+  const position = await session.cdp.send<{ result: { value: string } }>('Runtime.evaluate', {
    expression: `
      (function() {
        const el = document.querySelector('${selector}');
@@ -272,23 +183,46 @@ export async function clickElement(session: ChromeSession, selector: string): Pr
    returnByValue: true,
  }, { sessionId: session.sessionId });

-  if (posResult.result.value === 'null') throw new Error(`Element not found: ${selector}`);
-  const pos = JSON.parse(posResult.result.value);
+  if (position.result.value === 'null') throw new Error(`Element not found: ${selector}`);
+  const pos = JSON.parse(position.result.value);

-  await session.cdp.send('Input.dispatchMouseEvent', { type: 'mousePressed', x: pos.x, y: pos.y, button: 'left', clickCount: 1 }, { sessionId: session.sessionId });
+  await session.cdp.send('Input.dispatchMouseEvent', {
+    type: 'mousePressed',
+    x: pos.x,
+    y: pos.y,
+    button: 'left',
+    clickCount: 1,
+  }, { sessionId: session.sessionId });
  await sleep(50);
-  await session.cdp.send('Input.dispatchMouseEvent', { type: 'mouseReleased', x: pos.x, y: pos.y, button: 'left', clickCount: 1 }, { sessionId: session.sessionId });
+  await session.cdp.send('Input.dispatchMouseEvent', {
+    type: 'mouseReleased',
+    x: pos.x,
+    y: pos.y,
+    button: 'left',
+    clickCount: 1,
+  }, { sessionId: session.sessionId });
 }

 export async function typeText(session: ChromeSession, text: string): Promise<void> {
  const lines = text.split('\n');
-  for (let i = 0; i < lines.length; i++) {
-    if (lines[i].length > 0) {
-      await session.cdp.send('Input.insertText', { text: lines[i] }, { sessionId: session.sessionId });
+  for (let index = 0; index < lines.length; index += 1) {
+    const line = lines[index];
+    if (line.length > 0) {
+      await session.cdp.send('Input.insertText', { text: line }, { sessionId: session.sessionId });
    }
-    if (i < lines.length - 1) {
-      await session.cdp.send('Input.dispatchKeyEvent', { type: 'keyDown', key: 'Enter', code: 'Enter', windowsVirtualKeyCode: 13 }, { sessionId: session.sessionId });
-      await session.cdp.send('Input.dispatchKeyEvent', { type: 'keyUp', key: 'Enter', code: 'Enter', windowsVirtualKeyCode: 13 }, { sessionId: session.sessionId });
+    if (index < lines.length - 1) {
+      await session.cdp.send('Input.dispatchKeyEvent', {
+        type: 'keyDown',
+        key: 'Enter',
+        code: 'Enter',
+        windowsVirtualKeyCode: 13,
+      }, { sessionId: session.sessionId });
+      await session.cdp.send('Input.dispatchKeyEvent', {
+        type: 'keyUp',
+        key: 'Enter',
+        code: 'Enter',
+        windowsVirtualKeyCode: 13,
+      }, { sessionId: session.sessionId });
    }
    await sleep(30);
  }
@@ -296,8 +230,20 @@ export async function typeText(session: ChromeSession, text: string): Promise<vo

 export async function pasteFromClipboard(session: ChromeSession): Promise<void> {
  const modifiers = process.platform === 'darwin' ? 4 : 2;
-  await session.cdp.send('Input.dispatchKeyEvent', { type: 'keyDown', key: 'v', code: 'KeyV', modifiers, windowsVirtualKeyCode: 86 }, { sessionId: session.sessionId });
-  await session.cdp.send('Input.dispatchKeyEvent', { type: 'keyUp', key: 'v', code: 'KeyV', modifiers, windowsVirtualKeyCode: 86 }, { sessionId: session.sessionId });
+  await session.cdp.send('Input.dispatchKeyEvent', {
+    type: 'keyDown',
+    key: 'v',
+    code: 'KeyV',
+    modifiers,
+    windowsVirtualKeyCode: 86,
+  }, { sessionId: session.sessionId });
+  await session.cdp.send('Input.dispatchKeyEvent', {
+    type: 'keyUp',
+    key: 'v',
+    code: 'KeyV',
+    modifiers,
+    windowsVirtualKeyCode: 86,
+  }, { sessionId: session.sessionId });
 }

 export async function evaluate<T = unknown>(session: ChromeSession, expression: string): Promise<T> {
@@ -112,10 +112,14 @@ function parseFrontmatter(content: string): { frontmatter: Record<string, string
  return { frontmatter, body: match[2]! };
 }

-export async function convertMarkdown(markdownPath: string, options?: { title?: string; theme?: string; color?: string }): Promise<ParsedResult> {
+export async function convertMarkdown(
+  markdownPath: string,
+  options?: { title?: string; theme?: string; color?: string; citeStatus?: boolean }
+): Promise<ParsedResult> {
  const baseDir = path.dirname(markdownPath);
  const content = fs.readFileSync(markdownPath, 'utf-8');
  const theme = options?.theme ?? 'default';
+  const citeStatus = options?.citeStatus ?? true;

  const { frontmatter, body } = parseFrontmatter(content);

@@ -185,8 +189,9 @@ export async function convertMarkdown(markdownPath: string, options?: { title?:

  const renderArgs = ['-y', 'bun', renderScript, tempMdPath, '--theme', theme];
  if (options?.color) renderArgs.push('--color', options.color);
+  if (citeStatus) renderArgs.push('--cite');

-  console.error(`[md-to-wechat] Rendering markdown with theme: ${theme}${options?.color ? `, color: ${options.color}` : ''}`);
+  console.error(`[md-to-wechat] Rendering markdown with theme: ${theme}${options?.color ? `, color: ${options.color}` : ''}, citeStatus: ${citeStatus}`);

  const result = spawnSync('npx', renderArgs, {
    stdio: ['inherit', 'pipe', 'pipe'],
@@ -232,6 +237,7 @@ Options:
  --title <title>     Override title
  --theme <name>      Theme name (default, grace, simple, modern)
  --color <name|hex>  Primary color (blue, green, vermilion, etc. or hex)
+  --no-cite           Disable bottom citations for ordinary external links
  --help              Show this help

 Output JSON format:
@@ -251,6 +257,7 @@ Example:
  npx -y bun md-to-wechat.ts article.md
  npx -y bun md-to-wechat.ts article.md --theme grace
  npx -y bun md-to-wechat.ts article.md --theme modern --color blue
+  npx -y bun md-to-wechat.ts article.md --no-cite
 `);
  process.exit(0);
 }
@@ -265,6 +272,7 @@ async function main(): Promise<void> {
  let title: string | undefined;
  let theme: string | undefined;
  let color: string | undefined;
+  let citeStatus = true;

  for (let i = 0; i < args.length; i++) {
    const arg = args[i]!;
@@ -274,6 +282,10 @@ async function main(): Promise<void> {
      theme = args[++i];
    } else if (arg === '--color' && args[i + 1]) {
      color = args[++i];
+    } else if (arg === '--cite') {
+      citeStatus = true;
+    } else if (arg === '--no-cite') {
+      citeStatus = false;
    } else if (!arg.startsWith('-')) {
      markdownPath = arg;
    }
@@ -289,7 +301,7 @@ async function main(): Promise<void> {
    process.exit(1);
  }

-  const result = await convertMarkdown(markdownPath, { title, theme, color });
+  const result = await convertMarkdown(markdownPath, { title, theme, color, citeStatus });
  console.log(JSON.stringify(result, null, 2));
 }

@@ -37,6 +37,10 @@ function parseExtendYaml(yaml: string): Partial<ExtendConfig> {
 export function loadExtendConfig(): Partial<ExtendConfig> {
  const paths = [
    path.join(process.cwd(), ".baoyu-skills", "baoyu-markdown-to-html", "EXTEND.md"),
+    path.join(
+      process.env.XDG_CONFIG_HOME || path.join(homedir(), ".config"),
+      "baoyu-skills", "baoyu-markdown-to-html", "EXTEND.md"
+    ),
    path.join(homedir(), ".baoyu-skills", "baoyu-markdown-to-html", "EXTEND.md"),
  ];
  for (const p of paths) {
@@ -0,0 +1,8 @@
+{
+  "name": "baoyu-post-to-wechat-scripts",
+  "private": true,
+  "type": "module",
+  "dependencies": {
+    "baoyu-chrome-cdp": "file:./vendor/baoyu-chrome-cdp"
+  }
+}
@@ -0,0 +1,9 @@
+{
+  "name": "baoyu-chrome-cdp",
+  "private": true,
+  "version": "0.1.0",
+  "type": "module",
+  "exports": {
+    ".": "./src/index.ts"
+  }
+}
@@ -0,0 +1,408 @@
+import { spawn, spawnSync, type ChildProcess } from "node:child_process";
+import fs from "node:fs";
+import net from "node:net";
+import os from "node:os";
+import path from "node:path";
+import process from "node:process";
+
+export type PlatformCandidates = {
+  darwin?: string[];
+  win32?: string[];
+  default: string[];
+};
+
+type PendingRequest = {
+  resolve: (value: unknown) => void;
+  reject: (error: Error) => void;
+  timer: ReturnType<typeof setTimeout> | null;
+};
+
+type CdpSendOptions = {
+  sessionId?: string;
+  timeoutMs?: number;
+};
+
+type FetchJsonOptions = {
+  timeoutMs?: number;
+};
+
+type FindChromeExecutableOptions = {
+  candidates: PlatformCandidates;
+  envNames?: string[];
+};
+
+type ResolveSharedChromeProfileDirOptions = {
+  envNames?: string[];
+  appDataDirName?: string;
+  profileDirName?: string;
+  wslWindowsHome?: string | null;
+};
+
+type FindExistingChromeDebugPortOptions = {
+  profileDir: string;
+  timeoutMs?: number;
+};
+
+type LaunchChromeOptions = {
+  chromePath: string;
+  profileDir: string;
+  port: number;
+  url?: string;
+  headless?: boolean;
+  extraArgs?: string[];
+};
+
+type ChromeTargetInfo = {
+  targetId: string;
+  url: string;
+  type: string;
+};
+
+type OpenPageSessionOptions = {
+  cdp: CdpConnection;
+  reusing: boolean;
+  url: string;
+  matchTarget: (target: ChromeTargetInfo) => boolean;
+  enablePage?: boolean;
+  enableRuntime?: boolean;
+  enableDom?: boolean;
+  enableNetwork?: boolean;
+  activateTarget?: boolean;
+};
+
+export type PageSession = {
+  sessionId: string;
+  targetId: string;
+};
+
+export function sleep(ms: number): Promise<void> {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+
+export async function getFreePort(fixedEnvName?: string): Promise<number> {
+  const fixed = fixedEnvName ? Number.parseInt(process.env[fixedEnvName] ?? "", 10) : NaN;
+  if (Number.isInteger(fixed) && fixed > 0) return fixed;
+
+  return await new Promise((resolve, reject) => {
+    const server = net.createServer();
+    server.unref();
+    server.on("error", reject);
+    server.listen(0, "127.0.0.1", () => {
+      const address = server.address();
+      if (!address || typeof address === "string") {
+        server.close(() => reject(new Error("Unable to allocate a free TCP port.")));
+        return;
+      }
+      const port = address.port;
+      server.close((err) => {
+        if (err) reject(err);
+        else resolve(port);
+      });
+    });
+  });
+}
+
+export function findChromeExecutable(options: FindChromeExecutableOptions): string | undefined {
+  for (const envName of options.envNames ?? []) {
+    const override = process.env[envName]?.trim();
+    if (override && fs.existsSync(override)) return override;
+  }
+
+  const candidates = process.platform === "darwin"
+    ? options.candidates.darwin ?? options.candidates.default
+    : process.platform === "win32"
+      ? options.candidates.win32 ?? options.candidates.default
+      : options.candidates.default;
+
+  for (const candidate of candidates) {
+    if (fs.existsSync(candidate)) return candidate;
+  }
+  return undefined;
+}
+
+export function resolveSharedChromeProfileDir(options: ResolveSharedChromeProfileDirOptions = {}): string {
+  for (const envName of options.envNames ?? []) {
+    const override = process.env[envName]?.trim();
+    if (override) return path.resolve(override);
+  }
+
+  const appDataDirName = options.appDataDirName ?? "baoyu-skills";
+  const profileDirName = options.profileDirName ?? "chrome-profile";
+
+  if (options.wslWindowsHome) {
+    return path.join(options.wslWindowsHome, ".local", "share", appDataDirName, profileDirName);
+  }
+
+  const base = process.platform === "darwin"
+    ? path.join(os.homedir(), "Library", "Application Support")
+    : process.platform === "win32"
+      ? (process.env.APPDATA ?? path.join(os.homedir(), "AppData", "Roaming"))
+      : (process.env.XDG_DATA_HOME ?? path.join(os.homedir(), ".local", "share"));
+  return path.join(base, appDataDirName, profileDirName);
+}
+
+async function fetchWithTimeout(url: string, timeoutMs?: number): Promise<Response> {
+  if (!timeoutMs || timeoutMs <= 0) return await fetch(url, { redirect: "follow" });
+
+  const ctl = new AbortController();
+  const timer = setTimeout(() => ctl.abort(), timeoutMs);
+  try {
+    return await fetch(url, { redirect: "follow", signal: ctl.signal });
+  } finally {
+    clearTimeout(timer);
+  }
+}
+
+async function fetchJson<T = unknown>(url: string, options: FetchJsonOptions = {}): Promise<T> {
+  const response = await fetchWithTimeout(url, options.timeoutMs);
+  if (!response.ok) {
+    throw new Error(`Request failed: ${response.status} ${response.statusText}`);
+  }
+  return await response.json() as T;
+}
+
+async function isDebugPortReady(port: number, timeoutMs = 3_000): Promise<boolean> {
+  try {
+    const version = await fetchJson<{ webSocketDebuggerUrl?: string }>(
+      `http://127.0.0.1:${port}/json/version`,
+      { timeoutMs }
+    );
+    return !!version.webSocketDebuggerUrl;
+  } catch {
+    return false;
+  }
+}
+
+export async function findExistingChromeDebugPort(options: FindExistingChromeDebugPortOptions): Promise<number | null> {
+  const timeoutMs = options.timeoutMs ?? 3_000;
+  const portFile = path.join(options.profileDir, "DevToolsActivePort");
+
+  try {
+    const content = fs.readFileSync(portFile, "utf-8");
+    const [portLine] = content.split(/\r?\n/);
+    const port = Number.parseInt(portLine?.trim() ?? "", 10);
+    if (port > 0 && await isDebugPortReady(port, timeoutMs)) return port;
+  } catch {}
+
+  if (process.platform === "win32") return null;
+
+  try {
+    const result = spawnSync("ps", ["aux"], { encoding: "utf-8", timeout: 5_000 });
+    if (result.status !== 0 || !result.stdout) return null;
+
+    const lines = result.stdout
+      .split("\n")
+      .filter((line) => line.includes(options.profileDir) && line.includes("--remote-debugging-port="));
+
+    for (const line of lines) {
+      const portMatch = line.match(/--remote-debugging-port=(\d+)/);
+      const port = Number.parseInt(portMatch?.[1] ?? "", 10);
+      if (port > 0 && await isDebugPortReady(port, timeoutMs)) return port;
+    }
+  } catch {}
+
+  return null;
+}
+
+export async function waitForChromeDebugPort(
+  port: number,
+  timeoutMs: number,
+  options?: { includeLastError?: boolean }
+): Promise<string> {
+  const start = Date.now();
+  let lastError: unknown = null;
+
+  while (Date.now() - start < timeoutMs) {
+    try {
+      const version = await fetchJson<{ webSocketDebuggerUrl?: string }>(
+        `http://127.0.0.1:${port}/json/version`,
+        { timeoutMs: 5_000 }
+      );
+      if (version.webSocketDebuggerUrl) return version.webSocketDebuggerUrl;
+      lastError = new Error("Missing webSocketDebuggerUrl");
+    } catch (error) {
+      lastError = error;
+    }
+    await sleep(200);
+  }
+
+  if (options?.includeLastError && lastError) {
+    throw new Error(
+      `Chrome debug port not ready: ${lastError instanceof Error ? lastError.message : String(lastError)}`
+    );
+  }
+  throw new Error("Chrome debug port not ready");
+}
+
+export class CdpConnection {
+  private ws: WebSocket;
+  private nextId = 0;
+  private pending = new Map<number, PendingRequest>();
+  private eventHandlers = new Map<string, Set<(params: unknown) => void>>();
+  private defaultTimeoutMs: number;
+
+  private constructor(ws: WebSocket, defaultTimeoutMs = 15_000) {
+    this.ws = ws;
+    this.defaultTimeoutMs = defaultTimeoutMs;
+
+    this.ws.addEventListener("message", (event) => {
+      try {
+        const data = typeof event.data === "string"
+          ? event.data
+          : new TextDecoder().decode(event.data as ArrayBuffer);
+        const msg = JSON.parse(data) as {
+          id?: number;
+          method?: string;
+          params?: unknown;
+          result?: unknown;
+          error?: { message?: string };
+        };
+
+        if (msg.method) {
+          const handlers = this.eventHandlers.get(msg.method);
+          if (handlers) {
+            handlers.forEach((handler) => handler(msg.params));
+          }
+        }
+
+        if (msg.id) {
+          const pending = this.pending.get(msg.id);
+          if (pending) {
+            this.pending.delete(msg.id);
+            if (pending.timer) clearTimeout(pending.timer);
+            if (msg.error?.message) pending.reject(new Error(msg.error.message));
+            else pending.resolve(msg.result);
+          }
+        }
+      } catch {}
+    });
+
+    this.ws.addEventListener("close", () => {
+      for (const [id, pending] of this.pending.entries()) {
+        this.pending.delete(id);
+        if (pending.timer) clearTimeout(pending.timer);
+        pending.reject(new Error("CDP connection closed."));
+      }
+    });
+  }
+
+  static async connect(
+    url: string,
+    timeoutMs: number,
+    options?: { defaultTimeoutMs?: number }
+  ): Promise<CdpConnection> {
+    const ws = new WebSocket(url);
+    await new Promise<void>((resolve, reject) => {
+      const timer = setTimeout(() => reject(new Error("CDP connection timeout.")), timeoutMs);
+      ws.addEventListener("open", () => {
+        clearTimeout(timer);
+        resolve();
+      });
+      ws.addEventListener("error", () => {
+        clearTimeout(timer);
+        reject(new Error("CDP connection failed."));
+      });
+    });
+    return new CdpConnection(ws, options?.defaultTimeoutMs ?? 15_000);
+  }
+
+  on(method: string, handler: (params: unknown) => void): void {
+    if (!this.eventHandlers.has(method)) {
+      this.eventHandlers.set(method, new Set());
+    }
+    this.eventHandlers.get(method)?.add(handler);
+  }
+
+  off(method: string, handler: (params: unknown) => void): void {
+    this.eventHandlers.get(method)?.delete(handler);
+  }
+
+  async send<T = unknown>(method: string, params?: Record<string, unknown>, options?: CdpSendOptions): Promise<T> {
+    const id = ++this.nextId;
+    const message: Record<string, unknown> = { id, method };
+    if (params) message.params = params;
+    if (options?.sessionId) message.sessionId = options.sessionId;
+
+    const timeoutMs = options?.timeoutMs ?? this.defaultTimeoutMs;
+    const result = await new Promise<unknown>((resolve, reject) => {
+      const timer = timeoutMs > 0
+        ? setTimeout(() => {
+          this.pending.delete(id);
+          reject(new Error(`CDP timeout: ${method}`));
+        }, timeoutMs)
+        : null;
+      this.pending.set(id, { resolve, reject, timer });
+      this.ws.send(JSON.stringify(message));
+    });
+
+    return result as T;
+  }
+
+  close(): void {
+    try {
+      this.ws.close();
+    } catch {}
+  }
+}
+
+export async function launchChrome(options: LaunchChromeOptions): Promise<ChildProcess> {
+  await fs.promises.mkdir(options.profileDir, { recursive: true });
+
+  const args = [
+    `--remote-debugging-port=${options.port}`,
+    `--user-data-dir=${options.profileDir}`,
+    "--no-first-run",
+    "--no-default-browser-check",
+    ...(options.extraArgs ?? []),
+  ];
+  if (options.headless) args.push("--headless=new");
+  if (options.url) args.push(options.url);
+
+  return spawn(options.chromePath, args, { stdio: "ignore" });
+}
+
+export function killChrome(chrome: ChildProcess): void {
+  try {
+    chrome.kill("SIGTERM");
+  } catch {}
+  setTimeout(() => {
+    if (!chrome.killed) {
+      try {
+        chrome.kill("SIGKILL");
+      } catch {}
+    }
+  }, 2_000).unref?.();
+}
+
+export async function openPageSession(options: OpenPageSessionOptions): Promise<PageSession> {
+  let targetId: string;
+
+  if (options.reusing) {
+    const created = await options.cdp.send<{ targetId: string }>("Target.createTarget", { url: options.url });
+    targetId = created.targetId;
+  } else {
+    const targets = await options.cdp.send<{ targetInfos: ChromeTargetInfo[] }>("Target.getTargets");
+    const existing = targets.targetInfos.find(options.matchTarget);
+    if (existing) {
+      targetId = existing.targetId;
+    } else {
+      const created = await options.cdp.send<{ targetId: string }>("Target.createTarget", { url: options.url });
+      targetId = created.targetId;
+    }
+  }
+
+  const { sessionId } = await options.cdp.send<{ sessionId: string }>(
+    "Target.attachToTarget",
+    { targetId, flatten: true }
+  );
+
+  if (options.activateTarget ?? true) {
+    await options.cdp.send("Target.activateTarget", { targetId });
+  }
+  if (options.enablePage) await options.cdp.send("Page.enable", {}, { sessionId });
+  if (options.enableRuntime) await options.cdp.send("Runtime.enable", {}, { sessionId });
+  if (options.enableDom) await options.cdp.send("DOM.enable", {}, { sessionId });
+  if (options.enableNetwork) await options.cdp.send("Network.enable", {}, { sessionId });
+
+  return { sessionId, targetId };
+}
@@ -1,4 +1,4 @@
-import { execSync, spawnSync } from 'node:child_process';
+import { spawnSync } from 'node:child_process';
 import fs from 'node:fs';
 import path from 'node:path';
 import process from 'node:process';
@@ -10,30 +10,51 @@ function sleep(ms: number): Promise<void> {
  return new Promise((resolve) => setTimeout(resolve, ms));
 }

-function ab(cmd: string, json = false): string {
-  const fullCmd = `agent-browser --session ${SESSION} ${cmd}${json ? ' --json' : ''}`;
-  console.log(`[ab] ${fullCmd}`);
-  try {
-    const result = execSync(fullCmd, { encoding: 'utf8', stdio: ['pipe', 'pipe', 'pipe'] });
-    return result.trim();
-  } catch (e: unknown) {
-    const err = e as { stdout?: string; stderr?: string; message?: string };
-    console.error(`[ab] Error: ${err.stderr || err.message}`);
-    return err.stdout || '';
-  }
+function quoteForLog(arg: string): string {
+  return /[\s"'\\]/.test(arg) ? JSON.stringify(arg) : arg;
 }

-function abRaw(args: string[]): { success: boolean; output: string } {
+function toSafeJsStringLiteral(value: string): string {
+  return JSON.stringify(value)
+    .replace(/\u2028/g, '\\u2028')
+    .replace(/\u2029/g, '\\u2029');
+}
+
+function runAgentBrowser(args: string[]): {
+  success: boolean;
+  output: string;
+  spawnError?: string;
+} {
  const result = spawnSync('agent-browser', ['--session', SESSION, ...args], {
    encoding: 'utf8',
    stdio: ['pipe', 'pipe', 'pipe']
  });
+  const spawnError = result.error?.message?.trim();
+  const output = result.stdout || result.stderr || '';
  return {
    success: result.status === 0,
-    output: result.stdout || result.stderr || ''
+    output: output || spawnError || '',
+    spawnError
  };
 }

+function ab(args: string[], json = false): string {
+  const fullArgs = json ? [...args, '--json'] : args;
+  console.log(`[ab] agent-browser --session ${SESSION} ${fullArgs.map(quoteForLog).join(' ')}`);
+  const result = runAgentBrowser(fullArgs);
+  if (result.spawnError) {
+    throw new Error(`agent-browser failed to start: ${result.spawnError}`);
+  }
+  if (!result.success) {
+    console.error(`[ab] Error: ${result.output.trim()}`);
+  }
+  return result.output.trim();
+}
+
+function abRaw(args: string[]): { success: boolean; output: string } {
+  return runAgentBrowser(args);
+}
+
 interface SnapshotElement {
  ref: string;
  role: string;
@@ -99,17 +120,17 @@ async function postToWeChat(options: WeChatOptions): Promise<void> {
  }

  console.log('[wechat] Opening WeChat Official Account...');
-  ab(`open ${WECHAT_URL} --headed`);
+  ab(['open', WECHAT_URL, '--headed']);
  await sleep(5000);

  console.log('[wechat] Checking login status...');
-  let url = ab('get url');
+  let url = ab(['get', 'url']);
  console.log(`[wechat] Current URL: ${url}`);

  const waitForLogin = async (timeoutMs = 120_000): Promise<boolean> => {
    const start = Date.now();
    while (Date.now() - start < timeoutMs) {
-      url = ab('get url');
+      url = ab(['get', 'url']);
      if (url.includes('/cgi-bin/home')) return true;
      console.log('[wechat] Waiting for login...');
      await sleep(3000);
@@ -126,7 +147,7 @@ async function postToWeChat(options: WeChatOptions): Promise<void> {
  await sleep(2000);

  console.log('[wechat] Getting page snapshot...');
-  let snapshot = ab('snapshot');
+  let snapshot = ab(['snapshot']);
  console.log(snapshot);

  console.log('[wechat] Looking for "图文" menu...');
@@ -134,16 +155,16 @@ async function postToWeChat(options: WeChatOptions): Promise<void> {

  if (!tuWenRef) {
    console.log('[wechat] Using eval to find and click menu...');
-    ab(`eval "document.querySelectorAll('.new-creation__menu .new-creation__menu-item')[2].click()"`);
+    ab(['eval', "document.querySelectorAll('.new-creation__menu .new-creation__menu-item')[2].click()"]);
  } else {
    console.log(`[wechat] Clicking menu ref: ${tuWenRef}`);
-    ab(`click ${tuWenRef}`);
+    ab(['click', tuWenRef]);
  }

  await sleep(4000);

  console.log('[wechat] Checking for new tab...');
-  const tabsOutput = ab('tab');
+  const tabsOutput = ab(['tab']);
  console.log(`[wechat] Tabs: ${tabsOutput}`);

  const tabLines = tabsOutput.split('\n');
@@ -153,14 +174,14 @@ async function postToWeChat(options: WeChatOptions): Promise<void> {
    const tabMatch = tabsOutput.match(/\[(\d+)\].*(?:appmsg|edit)/i);
    if (tabMatch) {
      console.log(`[wechat] Switching to editor tab ${tabMatch[1]}...`);
-      ab(`tab ${tabMatch[1]}`);
+      ab(['tab', tabMatch[1]]);
    } else {
      const lastTabMatch = tabsOutput.match(/\[(\d+)\]/g);
      if (lastTabMatch && lastTabMatch.length > 1) {
        const lastTab = lastTabMatch[lastTabMatch.length - 1].match(/\d+/)?.[0];
        if (lastTab) {
          console.log(`[wechat] Switching to last tab ${lastTab}...`);
-          ab(`tab ${lastTab}`);
+          ab(['tab', lastTab]);
        }
      }
    }
@@ -168,38 +189,44 @@ async function postToWeChat(options: WeChatOptions): Promise<void> {

  await sleep(3000);

-  url = ab('get url');
+  url = ab(['get', 'url']);
  console.log(`[wechat] Editor URL: ${url}`);

  console.log('[wechat] Getting editor snapshot...');
-  snapshot = ab('snapshot');
+  snapshot = ab(['snapshot']);
  console.log(snapshot.substring(0, 2000));

  console.log('[wechat] Uploading images...');
  const fileInputSelector = '.js_upload_btn_container input[type=file]';
+  const fileInputSelectorJs = toSafeJsStringLiteral(fileInputSelector);

-  ab(`eval "document.querySelector('${fileInputSelector}').style.display = 'block'"`);
+  ab(['eval', `{
+    const input = document.querySelector(${fileInputSelectorJs});
+    if (input) input.style.display = 'block';
+  }`]);
  await sleep(500);

-  const uploadResult = abRaw(['upload', `"${fileInputSelector}"`, ...absoluteImages]);
+  const uploadResult = abRaw(['upload', fileInputSelector, ...absoluteImages]);
  console.log(`[wechat] Upload result: ${uploadResult.output}`);

  if (!uploadResult.success) {
    console.log('[wechat] Using alternative upload method...');
    for (const img of absoluteImages) {
      console.log(`[wechat] Uploading: ${img}`);
-      ab(`eval "
-        const input = document.querySelector('${fileInputSelector}');
+      const imgUrlJs = toSafeJsStringLiteral(`file://${img}`);
+      const imgFileNameJs = toSafeJsStringLiteral(path.basename(img));
+      ab(['eval', `
+        const input = document.querySelector(${fileInputSelectorJs});
        if (input) {
          const dt = new DataTransfer();
-          fetch('file://${img}').then(r => r.blob()).then(b => {
-            const file = new File([b], '${path.basename(img)}', { type: 'image/png' });
+          fetch(${imgUrlJs}).then(r => r.blob()).then(b => {
+            const file = new File([b], ${imgFileNameJs}, { type: 'image/png' });
            dt.items.add(file);
            input.files = dt.files;
            input.dispatchEvent(new Event('change', { bubbles: true }));
          });
        }
-      "`);
+      `]);
      await sleep(2000);
    }
  }
@@ -208,13 +235,14 @@ async function postToWeChat(options: WeChatOptions): Promise<void> {
  await sleep(10000);

  console.log('[wechat] Filling title...');
-  snapshot = ab('snapshot -i');
+  snapshot = ab(['snapshot', '-i']);
  const titleRef = findElementByText(snapshot, 'title') || findElementByText(snapshot, '标题');

  if (titleRef) {
-    ab(`fill ${titleRef} "${title.replace(/"/g, '\\"')}"`);
+    ab(['fill', titleRef, title]);
  } else {
-    ab(`eval "const t = document.querySelector('#title'); if(t) { t.value = '${title.replace(/'/g, "\\'")}'; t.dispatchEvent(new Event('input', {bubbles: true})); }"`);
+    const titleJs = toSafeJsStringLiteral(title);
+    ab(['eval', `const t = document.querySelector('#title'); if(t) { t.value = ${titleJs}; t.dispatchEvent(new Event('input', {bubbles: true})); }`]);
  }
  await sleep(500);

@@ -222,9 +250,9 @@ async function postToWeChat(options: WeChatOptions): Promise<void> {
  const editorRef = findElementByText(snapshot, 'js_pmEditorArea') || findElementByText(snapshot, 'textbox');

  if (editorRef) {
-    ab(`click ${editorRef}`);
+    ab(['click', editorRef]);
  } else {
-    ab(`eval "document.querySelector('.js_pmEditorArea')?.click()"`);
+    ab(['eval', "document.querySelector('.js_pmEditorArea')?.click()"]);
  }
  await sleep(500);

@@ -233,11 +261,11 @@ async function postToWeChat(options: WeChatOptions): Promise<void> {
  for (let i = 0; i < lines.length; i++) {
    const line = lines[i];
    if (line.length > 0) {
-      const escapedLine = line.replace(/"/g, '\\"').replace(/'/g, "\\'");
-      ab(`eval "document.execCommand('insertText', false, '${escapedLine}')"`);
+      const lineJs = toSafeJsStringLiteral(line);
+      ab(['eval', `document.execCommand('insertText', false, ${lineJs})`]);
    }
    if (i < lines.length - 1) {
-      ab('press Enter');
+      ab(['press', 'Enter']);
    }
    await sleep(100);
  }
@@ -249,9 +277,9 @@ async function postToWeChat(options: WeChatOptions): Promise<void> {
    console.log('[wechat] Saving as draft...');
    const submitRef = findElementByText(snapshot, 'js_submit') || findElementByText(snapshot, '保存');
    if (submitRef) {
-      ab(`click ${submitRef}`);
+      ab(['click', submitRef]);
    } else {
-      ab(`eval "document.querySelector('#js_submit')?.click()"`);
+      ab(['eval', "document.querySelector('#js_submit')?.click()"]);
    }
    await sleep(3000);
    console.log('[wechat] Draft saved!');
@@ -261,7 +289,7 @@ async function postToWeChat(options: WeChatOptions): Promise<void> {

  if (!keepOpen) {
    console.log('[wechat] Closing browser...');
-    ab('close');
+    ab(['close']);
  } else {
    console.log('[wechat] Done. Browser window left open.');
  }
@@ -1,13 +1,8 @@
 import fs from "node:fs";
 import path from "node:path";
-import os from "node:os";
 import { spawnSync } from "node:child_process";
 import { fileURLToPath } from "node:url";
-
-interface WechatConfig {
-  appId: string;
-  appSecret: string;
-}
+import { loadWechatExtendConfig, resolveAccount, loadCredentials } from "./wechat-extend-config.ts";

 interface AccessTokenResponse {
  access_token?: string;
@@ -38,53 +33,14 @@ interface ArticleOptions {
  thumbMediaId: string;
  articleType: ArticleType;
  imageMediaIds?: string[];
+  needOpenComment?: number;
+  onlyFansCanComment?: number;
 }

 const TOKEN_URL = "https://api.weixin.qq.com/cgi-bin/token";
 const UPLOAD_URL = "https://api.weixin.qq.com/cgi-bin/material/add_material";
 const DRAFT_URL = "https://api.weixin.qq.com/cgi-bin/draft/add";

-function loadEnvFile(envPath: string): Record<string, string> {
-  const env: Record<string, string> = {};
-  if (!fs.existsSync(envPath)) return env;
-
-  const content = fs.readFileSync(envPath, "utf-8");
-  for (const line of content.split("\n")) {
-    const trimmed = line.trim();
-    if (!trimmed || trimmed.startsWith("#")) continue;
-    const eqIdx = trimmed.indexOf("=");
-    if (eqIdx > 0) {
-      const key = trimmed.slice(0, eqIdx).trim();
-      let value = trimmed.slice(eqIdx + 1).trim();
-      if ((value.startsWith('"') && value.endsWith('"')) ||
-          (value.startsWith("'") && value.endsWith("'"))) {
-        value = value.slice(1, -1);
-      }
-      env[key] = value;
-    }
-  }
-  return env;
-}
-
-function loadConfig(): WechatConfig {
-  const cwdEnvPath = path.join(process.cwd(), ".baoyu-skills", ".env");
-  const homeEnvPath = path.join(os.homedir(), ".baoyu-skills", ".env");
-
-  const cwdEnv = loadEnvFile(cwdEnvPath);
-  const homeEnv = loadEnvFile(homeEnvPath);
-
-  const appId = process.env.WECHAT_APP_ID || cwdEnv.WECHAT_APP_ID || homeEnv.WECHAT_APP_ID;
-  const appSecret = process.env.WECHAT_APP_SECRET || cwdEnv.WECHAT_APP_SECRET || homeEnv.WECHAT_APP_SECRET;
-
-  if (!appId || !appSecret) {
-    throw new Error(
-      "Missing WECHAT_APP_ID or WECHAT_APP_SECRET.\n" +
-      "Set via environment variables or in .baoyu-skills/.env file."
-    );
-  }
-
-  return { appId, appSecret };
-}

 async function fetchAccessToken(appId: string, appSecret: string): Promise<string> {
  const url = `${TOKEN_URL}?grant_type=client_credential&appid=${appId}&secret=${appSecret}`;
@@ -241,6 +197,9 @@ async function publishToDraft(

  let article: Record<string, unknown>;

+  const noc = options.needOpenComment ?? 1;
+  const ofcc = options.onlyFansCanComment ?? 0;
+
  if (options.articleType === "newspic") {
    if (!options.imageMediaIds || options.imageMediaIds.length === 0) {
      throw new Error("newspic requires at least one image");
@@ -249,8 +208,8 @@ async function publishToDraft(
      article_type: "newspic",
      title: options.title,
      content: options.content,
-      need_open_comment: 1,
-      only_fans_can_comment: 0,
+      need_open_comment: noc,
+      only_fans_can_comment: ofcc,
      image_info: {
        image_list: options.imageMediaIds.map(id => ({ image_media_id: id })),
      },
@@ -262,8 +221,8 @@ async function publishToDraft(
      title: options.title,
      content: options.content,
      thumb_media_id: options.thumbMediaId,
-      need_open_comment: 1,
-      only_fans_can_comment: 0,
+      need_open_comment: noc,
+      only_fans_can_comment: ofcc,
    };
    if (options.author) article.author = options.author;
    if (options.digest) article.digest = options.digest;
@@ -307,7 +266,12 @@ function parseFrontmatter(content: string): { frontmatter: Record<string, string
  return { frontmatter, body: match[2]! };
 }

-function renderMarkdownToHtml(markdownPath: string, theme: string = "default", color?: string): string {
+function renderMarkdownToHtml(
+  markdownPath: string,
+  theme: string = "default",
+  color?: string,
+  citeStatus: boolean = true
+): string {
  const __filename = fileURLToPath(import.meta.url);
  const __dirname = path.dirname(__filename);
  const renderScript = path.join(__dirname, "md", "render.ts");
@@ -315,8 +279,9 @@ function renderMarkdownToHtml(markdownPath: string, theme: string = "default", c

  const renderArgs = ["-y", "bun", renderScript, markdownPath, "--theme", theme];
  if (color) renderArgs.push("--color", color);
+  if (citeStatus) renderArgs.push("--cite");

-  console.error(`[wechat-api] Rendering markdown with theme: ${theme}${color ? `, color: ${color}` : ""}`);
+  console.error(`[wechat-api] Rendering markdown with theme: ${theme}${color ? `, color: ${color}` : ""}, citeStatus: ${citeStatus}`);
  const result = spawnSync("npx", renderArgs, {
    stdio: ["inherit", "pipe", "pipe"],
    cwd: baseDir,
@@ -362,6 +327,8 @@ Options:
  --theme <name>      Theme name for markdown (default, grace, simple, modern). Default: default
  --color <name|hex>  Primary color (blue, green, vermilion, etc. or hex)
  --cover <path>      Cover image path (local or URL)
+  --account <alias>   Select account by alias (for multi-account setups)
+  --no-cite           Disable bottom citations for ordinary external links in markdown mode
  --dry-run           Parse and render only, don't publish
  --help              Show this help

@@ -390,6 +357,7 @@ Example:
  npx -y bun wechat-api.ts article.html --title "My Article"
  npx -y bun wechat-api.ts images/ --type newspic --title "Photo Album"
  npx -y bun wechat-api.ts article.md --dry-run
+  npx -y bun wechat-api.ts article.md --no-cite
 `);
  process.exit(0);
 }
@@ -404,6 +372,8 @@ interface CliArgs {
  theme: string;
  color?: string;
  cover?: string;
+  account?: string;
+  citeStatus: boolean;
  dryRun: boolean;
 }

@@ -417,6 +387,7 @@ function parseArgs(argv: string[]): CliArgs {
    isHtml: false,
    articleType: "news",
    theme: "default",
+    citeStatus: true,
    dryRun: false,
  };

@@ -439,6 +410,12 @@ function parseArgs(argv: string[]): CliArgs {
      args.color = argv[++i];
    } else if (arg === "--cover" && argv[i + 1]) {
      args.cover = argv[++i];
+    } else if (arg === "--account" && argv[i + 1]) {
+      args.account = argv[++i];
+    } else if (arg === "--cite") {
+      args.citeStatus = true;
+    } else if (arg === "--no-cite") {
+      args.citeStatus = false;
    } else if (arg === "--dry-run") {
      args.dryRun = true;
    } else if (arg.startsWith("--") && argv[i + 1] && !argv[i + 1]!.startsWith("-")) {
@@ -513,8 +490,8 @@ async function main(): Promise<void> {
    if (!author) author = frontmatter.author || "";
    if (!digest) digest = frontmatter.digest || frontmatter.summary || frontmatter.description || "";

-    console.error(`[wechat-api] Theme: ${args.theme}${args.color ? `, color: ${args.color}` : ""}`);
-    htmlPath = renderMarkdownToHtml(filePath, args.theme, args.color);
+    console.error(`[wechat-api] Theme: ${args.theme}${args.color ? `, color: ${args.color}` : ""}, citeStatus: ${args.citeStatus}`);
+    htmlPath = renderMarkdownToHtml(filePath, args.theme, args.color, args.citeStatus);
    console.error(`[wechat-api] HTML generated: ${htmlPath}`);
    htmlContent = extractHtmlContent(htmlPath);
  }
@@ -536,6 +513,12 @@ async function main(): Promise<void> {
  if (digest) console.error(`[wechat-api] Digest: ${digest.slice(0, 50)}...`);
  console.error(`[wechat-api] Type: ${args.articleType}`);

+  const extConfig = loadWechatExtendConfig();
+  const resolved = resolveAccount(extConfig, args.account);
+  if (resolved.name) console.error(`[wechat-api] Account: ${resolved.name} (${resolved.alias})`);
+
+  if (!author && resolved.default_author) author = resolved.default_author;
+
  if (args.dryRun) {
    console.log(JSON.stringify({
      articleType: args.articleType,
@@ -544,13 +527,14 @@ async function main(): Promise<void> {
      digest: digest || undefined,
      htmlPath,
      contentLength: htmlContent.length,
+      account: resolved.alias || undefined,
    }, null, 2));
    return;
  }

-  const config = loadConfig();
+  const creds = loadCredentials(resolved);
  console.error("[wechat-api] Fetching access token...");
-  const accessToken = await fetchAccessToken(config.appId, config.appSecret);
+  const accessToken = await fetchAccessToken(creds.appId, creds.appSecret);

  console.error("[wechat-api] Uploading images...");
  const { html: processedHtml, firstMediaId, allMediaIds } = await uploadImagesInHtml(
@@ -603,6 +587,8 @@ async function main(): Promise<void> {
    thumbMediaId,
    articleType: args.articleType,
    imageMediaIds: args.articleType === "newspic" ? allMediaIds : undefined,
+    needOpenComment: resolved.need_open_comment,
+    onlyFansCanComment: resolved.only_fans_can_comment,
  }, accessToken);

  console.log(JSON.stringify({
@@ -3,7 +3,8 @@ import path from 'node:path';
 import { spawnSync } from 'node:child_process';
 import process from 'node:process';
 import { fileURLToPath } from 'node:url';
-import { launchChrome, tryConnectExisting, findExistingChromeDebugPort, getPageSession, waitForNewTab, clickElement, typeText, evaluate, sleep, type ChromeSession, type CdpConnection } from './cdp.ts';
+import { launchChrome, tryConnectExisting, findExistingChromeDebugPort, getPageSession, waitForNewTab, clickElement, typeText, evaluate, sleep, getAccountProfileDir, type ChromeSession, type CdpConnection } from './cdp.ts';
+import { loadWechatExtendConfig, resolveAccount } from './wechat-extend-config.ts';

 const WECHAT_URL = 'https://mp.weixin.qq.com/';

@@ -20,6 +21,7 @@ interface ArticleOptions {
  markdownFile?: string;
  theme?: string;
  color?: string;
+  citeStatus?: boolean;
  author?: string;
  summary?: string;
  images?: string[];
@@ -182,13 +184,19 @@ async function pasteFromClipboardInEditor(session: ChromeSession): Promise<void>
  await sleep(1000);
 }

-async function parseMarkdownWithPlaceholders(markdownPath: string, theme?: string, color?: string): Promise<{ title: string; author: string; summary: string; htmlPath: string; contentImages: ImageInfo[] }> {
+async function parseMarkdownWithPlaceholders(
+  markdownPath: string,
+  theme?: string,
+  color?: string,
+  citeStatus: boolean = true
+): Promise<{ title: string; author: string; summary: string; htmlPath: string; contentImages: ImageInfo[] }> {
  const __filename = fileURLToPath(import.meta.url);
  const __dirname = path.dirname(__filename);
  const mdToWechatScript = path.join(__dirname, 'md-to-wechat.ts');
  const args = ['-y', 'bun', mdToWechatScript, markdownPath];
  if (theme) args.push('--theme', theme);
  if (color) args.push('--color', color);
+  if (!citeStatus) args.push('--no-cite');

  const result = spawnSync('npx', args, { stdio: ['inherit', 'pipe', 'pipe'] });
  if (result.status !== 0) {
@@ -383,7 +391,7 @@ async function removeExtraEmptyLineAfterImage(session: ChromeSession): Promise<b
 }

 export async function postArticle(options: ArticleOptions): Promise<void> {
-  const { title, content, htmlFile, markdownFile, theme, color, author, summary, images = [], submit = false, profileDir, cdpPort } = options;
+  const { title, content, htmlFile, markdownFile, theme, color, citeStatus = true, author, summary, images = [], submit = false, profileDir, cdpPort } = options;
  let { contentImages = [] } = options;
  let effectiveTitle = title || '';
  let effectiveAuthor = author || '';
@@ -392,7 +400,7 @@ export async function postArticle(options: ArticleOptions): Promise<void> {

  if (markdownFile) {
    console.log(`[wechat] Parsing markdown: ${markdownFile}`);
-    const parsed = await parseMarkdownWithPlaceholders(markdownFile, theme, color);
+    const parsed = await parseMarkdownWithPlaceholders(markdownFile, theme, color, citeStatus);
    effectiveTitle = effectiveTitle || parsed.title;
    effectiveAuthor = effectiveAuthor || parsed.author;
    effectiveSummary = effectiveSummary || parsed.summary;
@@ -677,23 +685,27 @@ Options:
  --markdown <path>  Markdown file to convert and post (recommended)
  --theme <name>     Theme for markdown (default, grace, simple, modern)
  --color <name|hex> Primary color (blue, green, vermilion, etc. or hex)
+  --no-cite          Disable bottom citations for ordinary external links in markdown mode
  --author <name>    Author name
  --summary <text>   Article summary
  --image <path>     Content image, can repeat (only with --content)
  --submit           Save as draft
  --profile <dir>    Chrome profile directory
+  --account <alias>  Select account by alias (for multi-account setups)
  --cdp-port <port>  Connect to existing Chrome debug port instead of launching new instance

 Examples:
  npx -y bun wechat-article.ts --markdown article.md
  npx -y bun wechat-article.ts --markdown article.md --theme grace --submit
+  npx -y bun wechat-article.ts --markdown article.md --no-cite
  npx -y bun wechat-article.ts --title "标题" --content "内容" --image img.png
  npx -y bun wechat-article.ts --title "标题" --html article.html --submit

 Markdown mode:
  Images in markdown are converted to placeholders. After pasting HTML,
  each placeholder is selected, scrolled into view, deleted, and replaced
-  with the actual image via paste.
+  with the actual image via paste. Ordinary external links are converted to
+  bottom citations by default.
 `);
  process.exit(0);
 }
@@ -709,11 +721,13 @@ async function main(): Promise<void> {
  let markdownFile: string | undefined;
  let theme: string | undefined;
  let color: string | undefined;
+  let citeStatus = true;
  let author: string | undefined;
  let summary: string | undefined;
  let submit = false;
  let profileDir: string | undefined;
  let cdpPort: number | undefined;
+  let accountAlias: string | undefined;

  for (let i = 0; i < args.length; i++) {
    const arg = args[i]!;
@@ -723,18 +737,31 @@ async function main(): Promise<void> {
    else if (arg === '--markdown' && args[i + 1]) markdownFile = args[++i];
    else if (arg === '--theme' && args[i + 1]) theme = args[++i];
    else if (arg === '--color' && args[i + 1]) color = args[++i];
+    else if (arg === '--cite') citeStatus = true;
+    else if (arg === '--no-cite') citeStatus = false;
    else if (arg === '--author' && args[i + 1]) author = args[++i];
    else if (arg === '--summary' && args[i + 1]) summary = args[++i];
    else if (arg === '--image' && args[i + 1]) images.push(args[++i]!);
    else if (arg === '--submit') submit = true;
    else if (arg === '--profile' && args[i + 1]) profileDir = args[++i];
+    else if (arg === '--account' && args[i + 1]) accountAlias = args[++i];
    else if (arg === '--cdp-port' && args[i + 1]) cdpPort = parseInt(args[++i]!, 10);
  }

+  const extConfig = loadWechatExtendConfig();
+  const resolved = resolveAccount(extConfig, accountAlias);
+  if (resolved.name) console.log(`[wechat] Account: ${resolved.name} (${resolved.alias})`);
+
+  if (!author && resolved.default_author) author = resolved.default_author;
+
+  if (!profileDir && resolved.alias) {
+    profileDir = resolved.chrome_profile_path || getAccountProfileDir(resolved.alias);
+  }
+
  if (!markdownFile && !htmlFile && !title) { console.error('Error: --title is required (or use --markdown/--html)'); process.exit(1); }
  if (!markdownFile && !htmlFile && !content) { console.error('Error: --content, --html, or --markdown is required'); process.exit(1); }

-  await postArticle({ title: title || '', content, htmlFile, markdownFile, theme, color, author, summary, images, submit, profileDir, cdpPort });
+  await postArticle({ title: title || '', content, htmlFile, markdownFile, theme, color, citeStatus, author, summary, images, submit, profileDir, cdpPort });
 }

 await main().then(() => {
@@ -1,11 +1,18 @@
-import { execSync, spawn } from 'node:child_process';
 import fs from 'node:fs';
-import { mkdir, readdir } from 'node:fs/promises';
-import net from 'node:net';
-import os from 'node:os';
+import { readdir } from 'node:fs/promises';
 import path from 'node:path';
 import process from 'node:process';

+import {
+  CdpConnection,
+  findChromeExecutable,
+  getDefaultProfileDir,
+  getAccountProfileDir,
+  launchChrome,
+  sleep,
+} from './cdp.ts';
+import { loadWechatExtendConfig, resolveAccount } from './wechat-extend-config.ts';
+
 const WECHAT_URL = 'https://mp.weixin.qq.com/';

 interface MarkdownMeta {
@@ -104,195 +111,6 @@ async function loadImagesFromDir(dir: string): Promise<string[]> {
  return images;
 }

-function sleep(ms: number): Promise<void> {
-  return new Promise((resolve) => setTimeout(resolve, ms));
-}
-
-async function getFreePort(): Promise<number> {
-  const fixed = parseInt(process.env.WECHAT_BROWSER_DEBUG_PORT || '', 10);
-  if (fixed > 0) return fixed;
-  return new Promise((resolve, reject) => {
-    const server = net.createServer();
-    server.unref();
-    server.on('error', reject);
-    server.listen(0, '127.0.0.1', () => {
-      const address = server.address();
-      if (!address || typeof address === 'string') {
-        server.close(() => reject(new Error('Unable to allocate a free TCP port.')));
-        return;
-      }
-      const port = address.port;
-      server.close((err) => {
-        if (err) reject(err);
-        else resolve(port);
-      });
-    });
-  });
-}
-
-function findChromeExecutable(): string | undefined {
-  const override = process.env.WECHAT_BROWSER_CHROME_PATH?.trim();
-  if (override && fs.existsSync(override)) return override;
-
-  const candidates: string[] = [];
-  switch (process.platform) {
-    case 'darwin':
-      candidates.push(
-        '/Applications/Google Chrome.app/Contents/MacOS/Google Chrome',
-        '/Applications/Google Chrome Canary.app/Contents/MacOS/Google Chrome Canary',
-        '/Applications/Google Chrome Beta.app/Contents/MacOS/Google Chrome Beta',
-        '/Applications/Chromium.app/Contents/MacOS/Chromium',
-        '/Applications/Microsoft Edge.app/Contents/MacOS/Microsoft Edge',
-      );
-      break;
-    case 'win32':
-      candidates.push(
-        'C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe',
-        'C:\\Program Files (x86)\\Google\\Chrome\\Application\\chrome.exe',
-        'C:\\Program Files\\Microsoft\\Edge\\Application\\msedge.exe',
-        'C:\\Program Files (x86)\\Microsoft\\Edge\\Application\\msedge.exe',
-      );
-      break;
-    default:
-      candidates.push(
-        '/usr/bin/google-chrome',
-        '/usr/bin/google-chrome-stable',
-        '/usr/bin/chromium',
-        '/usr/bin/chromium-browser',
-        '/snap/bin/chromium',
-        '/usr/bin/microsoft-edge',
-      );
-      break;
-  }
-
-  for (const p of candidates) {
-    if (fs.existsSync(p)) return p;
-  }
-  return undefined;
-}
-
-let _wslHome: string | null | undefined;
-function getWslWindowsHome(): string | null {
-  if (_wslHome !== undefined) return _wslHome;
-  if (!process.env.WSL_DISTRO_NAME) { _wslHome = null; return null; }
-  try {
-    const raw = execSync('cmd.exe /C "echo %USERPROFILE%"', { encoding: 'utf-8', timeout: 5000 }).trim().replace(/\r/g, '');
-    _wslHome = execSync(`wslpath -u "${raw}"`, { encoding: 'utf-8', timeout: 5000 }).trim() || null;
-  } catch { _wslHome = null; }
-  return _wslHome;
-}
-
-function getDefaultProfileDir(): string {
-  const override = process.env.BAOYU_CHROME_PROFILE_DIR?.trim() || process.env.WECHAT_BROWSER_PROFILE_DIR?.trim();
-  if (override) return path.resolve(override);
-  const wslHome = getWslWindowsHome();
-  if (wslHome) return path.join(wslHome, '.local', 'share', 'baoyu-skills', 'chrome-profile');
-  const base = process.platform === 'darwin'
-    ? path.join(os.homedir(), 'Library', 'Application Support')
-    : process.env.XDG_DATA_HOME || path.join(os.homedir(), '.local', 'share');
-  return path.join(base, 'baoyu-skills', 'chrome-profile');
-}
-
-async function fetchJson<T = unknown>(url: string): Promise<T> {
-  const res = await fetch(url, { redirect: 'follow' });
-  if (!res.ok) throw new Error(`Request failed: ${res.status} ${res.statusText}`);
-  return (await res.json()) as T;
-}
-
-async function waitForChromeDebugPort(port: number, timeoutMs: number): Promise<string> {
-  const start = Date.now();
-  let lastError: unknown = null;
-
-  while (Date.now() - start < timeoutMs) {
-    try {
-      const version = await fetchJson<{ webSocketDebuggerUrl?: string }>(`http://127.0.0.1:${port}/json/version`);
-      if (version.webSocketDebuggerUrl) return version.webSocketDebuggerUrl;
-      lastError = new Error('Missing webSocketDebuggerUrl');
-    } catch (error) {
-      lastError = error;
-    }
-    await sleep(200);
-  }
-
-  throw new Error(`Chrome debug port not ready: ${lastError instanceof Error ? lastError.message : String(lastError)}`);
-}
-
-class CdpConnection {
-  private ws: WebSocket;
-  private nextId = 0;
-  private pending = new Map<number, { resolve: (v: unknown) => void; reject: (e: Error) => void; timer: ReturnType<typeof setTimeout> | null }>();
-  private eventHandlers = new Map<string, Set<(params: unknown) => void>>();
-
-  private constructor(ws: WebSocket) {
-    this.ws = ws;
-    this.ws.addEventListener('message', (event) => {
-      try {
-        const data = typeof event.data === 'string' ? event.data : new TextDecoder().decode(event.data as ArrayBuffer);
-        const msg = JSON.parse(data) as { id?: number; method?: string; params?: unknown; result?: unknown; error?: { message?: string } };
-
-        if (msg.method) {
-          const handlers = this.eventHandlers.get(msg.method);
-          if (handlers) handlers.forEach((h) => h(msg.params));
-        }
-
-        if (msg.id) {
-          const pending = this.pending.get(msg.id);
-          if (pending) {
-            this.pending.delete(msg.id);
-            if (pending.timer) clearTimeout(pending.timer);
-            if (msg.error?.message) pending.reject(new Error(msg.error.message));
-            else pending.resolve(msg.result);
-          }
-        }
-      } catch {}
-    });
-
-    this.ws.addEventListener('close', () => {
-      for (const [id, pending] of this.pending.entries()) {
-        this.pending.delete(id);
-        if (pending.timer) clearTimeout(pending.timer);
-        pending.reject(new Error('CDP connection closed.'));
-      }
-    });
-  }
-
-  static async connect(url: string, timeoutMs: number): Promise<CdpConnection> {
-    const ws = new WebSocket(url);
-    await new Promise<void>((resolve, reject) => {
-      const timer = setTimeout(() => reject(new Error('CDP connection timeout.')), timeoutMs);
-      ws.addEventListener('open', () => { clearTimeout(timer); resolve(); });
-      ws.addEventListener('error', () => { clearTimeout(timer); reject(new Error('CDP connection failed.')); });
-    });
-    return new CdpConnection(ws);
-  }
-
-  on(method: string, handler: (params: unknown) => void): void {
-    if (!this.eventHandlers.has(method)) this.eventHandlers.set(method, new Set());
-    this.eventHandlers.get(method)!.add(handler);
-  }
-
-  async send<T = unknown>(method: string, params?: Record<string, unknown>, options?: { sessionId?: string; timeoutMs?: number }): Promise<T> {
-    const id = ++this.nextId;
-    const message: Record<string, unknown> = { id, method };
-    if (params) message.params = params;
-    if (options?.sessionId) message.sessionId = options.sessionId;
-
-    const timeoutMs = options?.timeoutMs ?? 15_000;
-
-    const result = await new Promise<unknown>((resolve, reject) => {
-      const timer = timeoutMs > 0 ? setTimeout(() => { this.pending.delete(id); reject(new Error(`CDP timeout: ${method}`)); }, timeoutMs) : null;
-      this.pending.set(id, { resolve, reject, timer });
-      this.ws.send(JSON.stringify(message));
-    });
-
-    return result as T;
-  }
-
-  close(): void {
-    try { this.ws.close(); } catch {}
-  }
-}
-
 interface WeChatBrowserOptions {
  title?: string;
  content?: string;
@@ -348,29 +166,18 @@ export async function postToWeChat(options: WeChatBrowserOptions): Promise<void>
    if (!fs.existsSync(img)) throw new Error(`Image not found: ${img}`);
  }

-  const chromePath = options.chromePath ?? findChromeExecutable();
+  const chromePath = findChromeExecutable(options.chromePath);
  if (!chromePath) throw new Error('Chrome not found. Set WECHAT_BROWSER_CHROME_PATH env var.');

-  await mkdir(profileDir, { recursive: true });
-
-  const port = await getFreePort();
  console.log(`[wechat-browser] Launching Chrome (profile: ${profileDir})`);

-  const chrome = spawn(chromePath, [
-    `--remote-debugging-port=${port}`,
-    `--user-data-dir=${profileDir}`,
-    '--no-first-run',
-    '--no-default-browser-check',
-    '--disable-blink-features=AutomationControlled',
-    '--start-maximized',
-    WECHAT_URL,
-  ], { stdio: 'ignore' });
+  const launched = await launchChrome(WECHAT_URL, profileDir, chromePath);
+  const chrome = launched.chrome;

  let cdp: CdpConnection | null = null;

  try {
-    const wsUrl = await waitForChromeDebugPort(port, 30_000);
-    cdp = await CdpConnection.connect(wsUrl, 30_000);
+    cdp = launched.cdp;

    const targets = await cdp.send<{ targetInfos: Array<{ targetId: string; url: string; type: string }> }>('Target.getTargets');
    let pageTarget = targets.targetInfos.find((t) => t.type === 'page' && t.url.includes('mp.weixin.qq.com'));
@@ -551,37 +358,126 @@ export async function postToWeChat(options: WeChatBrowserOptions): Promise<void>
    const absolutePaths = images.map(p => path.isAbsolute(p) ? p : path.resolve(process.cwd(), p));
    console.log(`[wechat-browser] Images: ${absolutePaths.join(', ')}`);

-    const { root } = await cdp.send<{ root: { nodeId: number } }>('DOM.getDocument', {}, { sessionId });
+    // --- PRIMARY approach: intercept file chooser dialog ---
+    let uploadSuccess = false;
+    try {
+      console.log('[wechat-browser] [primary] Enabling file chooser interception...');
+      await cdp.send('Page.setInterceptFileChooserDialog', { enabled: true }, { sessionId });

-    // Try primary selector, then fallback to any multi-file image input
-    let { nodeId } = await cdp.send<{ nodeId: number }>('DOM.querySelector', {
-      nodeId: root.nodeId,
-      selector: '.js_upload_btn_container input[type=file]',
-    }, { sessionId });
+      // Set up listener for file chooser opened event BEFORE clicking
+      const fileChooserPromise = new Promise<{ backendNodeId: number; mode: string }>((resolve, reject) => {
+        const timeout = setTimeout(() => reject(new Error('File chooser dialog not opened within 10s')), 10_000);
+        cdp!.on('Page.fileChooserOpened', (params: unknown) => {
+          clearTimeout(timeout);
+          const p = params as { backendNodeId: number; mode: string };
+          console.log(`[wechat-browser] [primary] File chooser opened: backendNodeId=${p.backendNodeId}, mode=${p.mode}`);
+          resolve(p);
+        });
+      });

-    if (!nodeId) {
-      console.log('[wechat-browser] Primary file input not found, trying fallback selector...');
-      const fallback = await cdp.send<{ nodeId: number }>('DOM.querySelector', {
-        nodeId: root.nodeId,
-        selector: 'input[type=file][multiple][accept*="image"]',
+      // Trigger file chooser by calling .click() on the file input with userGesture
+      const fileInputSelectors = [
+        '.js_upload_btn_container input[type=file]',
+        'input[type=file][multiple][accept*="image"]',
+        'input[type=file][accept*="image"]',
+        'input[type=file][multiple]',
+        'input[type=file]',
+      ];
+
+      console.log('[wechat-browser] [primary] Clicking file input via JS .click() with userGesture...');
+      const clickResult = await cdp.send<{ result: { value: string } }>('Runtime.evaluate', {
+        expression: `
+          (function() {
+            const selectors = ${JSON.stringify(fileInputSelectors)};
+            for (const sel of selectors) {
+              const el = document.querySelector(sel);
+              if (el) {
+                el.click();
+                return JSON.stringify({ clicked: sel });
+              }
+            }
+            const debug = [];
+            document.querySelectorAll('input[type=file]').forEach((inp, i) => {
+              debug.push({ i, accept: inp.accept, multiple: inp.multiple, parentClass: inp.parentElement?.className?.slice(0, 60) });
+            });
+            return JSON.stringify({ error: 'no file input found', fileInputs: debug });
+          })()
+        `,
+        returnByValue: true,
+        userGesture: true,
      }, { sessionId });
-      nodeId = fallback.nodeId;
+      console.log(`[wechat-browser] [primary] Click result: ${clickResult.result.value}`);
+
+      const clickStatus = JSON.parse(clickResult.result.value);
+      if (clickStatus.error) {
+        throw new Error(`File input not found: ${clickStatus.error}`);
+      }
+
+      // Wait for the file chooser event
+      console.log('[wechat-browser] [primary] Waiting for file chooser dialog...');
+      const chooser = await fileChooserPromise;
+
+      console.log(`[wechat-browser] [primary] Setting files via backendNodeId=${chooser.backendNodeId}...`);
+      await cdp.send('DOM.setFileInputFiles', {
+        files: absolutePaths,
+        backendNodeId: chooser.backendNodeId,
+      }, { sessionId });
+      console.log('[wechat-browser] [primary] Files set successfully via file chooser interception');
+      uploadSuccess = true;
+    } catch (primaryErr) {
+      console.log(`[wechat-browser] [primary] File chooser approach failed: ${primaryErr instanceof Error ? primaryErr.message : String(primaryErr)}`);
+      // Disable interception before falling back
+      try { await cdp.send('Page.setInterceptFileChooserDialog', { enabled: false }, { sessionId }); } catch {}
    }

-    if (!nodeId) throw new Error('File input not found');
+    // --- FALLBACK approach: direct DOM.setFileInputFiles on nodeId ---
+    if (!uploadSuccess) {
+      console.log('[wechat-browser] [fallback] Trying direct DOM.setFileInputFiles...');
+      const { root } = await cdp.send<{ root: { nodeId: number } }>('DOM.getDocument', {}, { sessionId });

-    await cdp.send('DOM.setFileInputFiles', {
-      nodeId,
-      files: absolutePaths,
-    }, { sessionId });
+      const fileInputSelectors = [
+        '.js_upload_btn_container input[type=file]',
+        'input[type=file][multiple][accept*="image"]',
+        'input[type=file][accept*="image"]',
+        'input[type=file][multiple]',
+        'input[type=file]',
+      ];

-    // Dispatch change event to trigger the upload
-    await cdp.send('Runtime.evaluate', {
-      expression: `
-        const fileInput = document.querySelector('.js_upload_btn_container input[type=file]') || document.querySelector('input[type=file][multiple][accept*="image"]');
-        if (fileInput) fileInput.dispatchEvent(new Event('change', { bubbles: true }));
-      `,
-    }, { sessionId });
+      let nodeId = 0;
+      for (const sel of fileInputSelectors) {
+        const result = await cdp.send<{ nodeId: number }>('DOM.querySelector', { nodeId: root.nodeId, selector: sel }, { sessionId });
+        if (result.nodeId) {
+          console.log(`[wechat-browser] [fallback] Found file input with selector: ${sel}`);
+          nodeId = result.nodeId;
+          break;
+        }
+      }
+
+      if (!nodeId) throw new Error('File input not found with any selector');
+
+      await cdp.send('DOM.setFileInputFiles', { nodeId, files: absolutePaths }, { sessionId });
+      console.log('[wechat-browser] [fallback] Files set via nodeId');
+
+      // Dispatch change event
+      await cdp.send('Runtime.evaluate', {
+        expression: `
+          (function() {
+            const selectors = ${JSON.stringify(fileInputSelectors)};
+            for (const sel of selectors) {
+              const el = document.querySelector(sel);
+              if (el) {
+                el.dispatchEvent(new Event('change', { bubbles: true }));
+                el.dispatchEvent(new Event('input', { bubbles: true }));
+                return 'dispatched on ' + sel;
+              }
+            }
+            return 'no input found for event dispatch';
+          })()
+        `,
+        returnByValue: true,
+      }, { sessionId });
+      console.log('[wechat-browser] [fallback] Change event dispatched');
+    }

    // Wait for images to upload
    console.log('[wechat-browser] Waiting for images to upload...');
@@ -589,11 +485,16 @@ export async function postToWeChat(options: WeChatBrowserOptions): Promise<void>
    for (let i = 0; i < 30; i++) {
      await sleep(2000);
      const uploadCheck = await cdp.send<{ result: { value: string } }>('Runtime.evaluate', {
-        expression: `JSON.stringify({ uploaded: document.querySelectorAll('.weui-desktop-upload__thumb, .pic_item, [class*=upload_thumb]').length })`,
+        expression: `
+          JSON.stringify({
+            uploaded: document.querySelectorAll('.weui-desktop-upload__thumb, .pic_item, [class*=upload_thumb], [class*="pic_item"], [class*="upload__thumb"]').length,
+            loading: document.querySelectorAll('[class*="upload_loading"], [class*="uploading"], .weui-desktop-upload__loading').length
+          })
+        `,
        returnByValue: true,
      }, { sessionId });
      const status = JSON.parse(uploadCheck.result.value);
-      console.log(`[wechat-browser] Upload progress: ${status.uploaded}/${targetCount}`);
+      console.log(`[wechat-browser] Upload progress: ${status.uploaded}/${targetCount} (loading: ${status.loading})`);
      if (status.uploaded >= targetCount) break;
    }

@@ -765,6 +666,7 @@ Options:
  --image <path>     Add image (can be repeated)
  --submit           Save as draft (default: preview only)
  --profile <dir>    Chrome profile directory
+  --account <alias>  Select account by alias (for multi-account setups)
  --help             Show this help

 Examples:
@@ -786,6 +688,7 @@ async function main(): Promise<void> {
  let content: string | undefined;
  let markdownFile: string | undefined;
  let imagesDir: string | undefined;
+  let accountAlias: string | undefined;

  for (let i = 0; i < args.length; i++) {
    const arg = args[i]!;
@@ -803,9 +706,19 @@ async function main(): Promise<void> {
      submit = true;
    } else if (arg === '--profile' && args[i + 1]) {
      profileDir = args[++i];
+    } else if (arg === '--account' && args[i + 1]) {
+      accountAlias = args[++i];
    }
  }

+  const extConfig = loadWechatExtendConfig();
+  const resolved = resolveAccount(extConfig, accountAlias);
+  if (resolved.name) console.log(`[wechat-browser] Account: ${resolved.name} (${resolved.alias})`);
+
+  if (!profileDir && resolved.alias) {
+    profileDir = resolved.chrome_profile_path || getAccountProfileDir(resolved.alias);
+  }
+
  if (!markdownFile && !title) {
    console.error('Error: --title or --markdown is required');
    process.exit(1);
@@ -0,0 +1,245 @@
+import fs from "node:fs";
+import path from "node:path";
+import os from "node:os";
+
+export interface WechatAccount {
+  name: string;
+  alias: string;
+  default?: boolean;
+  default_publish_method?: string;
+  default_author?: string;
+  need_open_comment?: number;
+  only_fans_can_comment?: number;
+  app_id?: string;
+  app_secret?: string;
+  chrome_profile_path?: string;
+}
+
+export interface WechatExtendConfig {
+  default_theme?: string;
+  default_color?: string;
+  default_publish_method?: string;
+  default_author?: string;
+  need_open_comment?: number;
+  only_fans_can_comment?: number;
+  chrome_profile_path?: string;
+  accounts?: WechatAccount[];
+}
+
+export interface ResolvedAccount {
+  name?: string;
+  alias?: string;
+  default_publish_method?: string;
+  default_author?: string;
+  need_open_comment: number;
+  only_fans_can_comment: number;
+  app_id?: string;
+  app_secret?: string;
+  chrome_profile_path?: string;
+}
+
+function stripQuotes(s: string): string {
+  return s.replace(/^['"]|['"]$/g, "");
+}
+
+function toBool01(v: string): number {
+  return v === "1" || v === "true" ? 1 : 0;
+}
+
+function parseWechatExtend(content: string): WechatExtendConfig {
+  const config: WechatExtendConfig = {};
+  const lines = content.split("\n");
+  let inAccounts = false;
+  let current: Record<string, string> | null = null;
+  const rawAccounts: Record<string, string>[] = [];
+
+  for (const raw of lines) {
+    const trimmed = raw.trim();
+    if (!trimmed || trimmed.startsWith("#")) continue;
+
+    if (trimmed === "accounts:") {
+      inAccounts = true;
+      continue;
+    }
+
+    if (inAccounts) {
+      const listMatch = raw.match(/^\s+-\s+(.+)$/);
+      if (listMatch) {
+        if (current) rawAccounts.push(current);
+        current = {};
+        const kv = listMatch[1]!;
+        const ci = kv.indexOf(":");
+        if (ci > 0) {
+          current[kv.slice(0, ci).trim()] = stripQuotes(kv.slice(ci + 1).trim());
+        }
+        continue;
+      }
+
+      if (current && /^\s{2,}/.test(raw) && !trimmed.startsWith("-")) {
+        const ci = trimmed.indexOf(":");
+        if (ci > 0) {
+          current[trimmed.slice(0, ci).trim()] = stripQuotes(trimmed.slice(ci + 1).trim());
+        }
+        continue;
+      }
+
+      if (!/^\s/.test(raw)) {
+        if (current) rawAccounts.push(current);
+        current = null;
+        inAccounts = false;
+      } else {
+        continue;
+      }
+    }
+
+    const ci = trimmed.indexOf(":");
+    if (ci < 0) continue;
+    const key = trimmed.slice(0, ci).trim();
+    const val = stripQuotes(trimmed.slice(ci + 1).trim());
+    if (val === "null" || val === "") continue;
+
+    switch (key) {
+      case "default_theme": config.default_theme = val; break;
+      case "default_color": config.default_color = val; break;
+      case "default_publish_method": config.default_publish_method = val; break;
+      case "default_author": config.default_author = val; break;
+      case "need_open_comment": config.need_open_comment = toBool01(val); break;
+      case "only_fans_can_comment": config.only_fans_can_comment = toBool01(val); break;
+      case "chrome_profile_path": config.chrome_profile_path = val; break;
+    }
+  }
+
+  if (current) rawAccounts.push(current);
+
+  if (rawAccounts.length > 0) {
+    config.accounts = rawAccounts.map(a => ({
+      name: a.name || "",
+      alias: a.alias || "",
+      default: a.default === "true" || a.default === "1",
+      default_publish_method: a.default_publish_method || undefined,
+      default_author: a.default_author || undefined,
+      need_open_comment: a.need_open_comment ? toBool01(a.need_open_comment) : undefined,
+      only_fans_can_comment: a.only_fans_can_comment ? toBool01(a.only_fans_can_comment) : undefined,
+      app_id: a.app_id || undefined,
+      app_secret: a.app_secret || undefined,
+      chrome_profile_path: a.chrome_profile_path || undefined,
+    }));
+  }
+
+  return config;
+}
+
+export function loadWechatExtendConfig(): WechatExtendConfig {
+  const paths = [
+    path.join(process.cwd(), ".baoyu-skills", "baoyu-post-to-wechat", "EXTEND.md"),
+    path.join(
+      process.env.XDG_CONFIG_HOME || path.join(os.homedir(), ".config"),
+      "baoyu-skills", "baoyu-post-to-wechat", "EXTEND.md"
+    ),
+    path.join(os.homedir(), ".baoyu-skills", "baoyu-post-to-wechat", "EXTEND.md"),
+  ];
+  for (const p of paths) {
+    try {
+      const content = fs.readFileSync(p, "utf-8");
+      return parseWechatExtend(content);
+    } catch {
+      continue;
+    }
+  }
+  return {};
+}
+
+function selectAccount(config: WechatExtendConfig, alias?: string): WechatAccount | undefined {
+  if (!config.accounts || config.accounts.length === 0) return undefined;
+  if (alias) return config.accounts.find(a => a.alias === alias);
+  if (config.accounts.length === 1) return config.accounts[0];
+  return config.accounts.find(a => a.default);
+}
+
+export function resolveAccount(config: WechatExtendConfig, alias?: string): ResolvedAccount {
+  const acct = selectAccount(config, alias);
+  return {
+    name: acct?.name,
+    alias: acct?.alias,
+    default_publish_method: acct?.default_publish_method ?? config.default_publish_method,
+    default_author: acct?.default_author ?? config.default_author,
+    need_open_comment: acct?.need_open_comment ?? config.need_open_comment ?? 1,
+    only_fans_can_comment: acct?.only_fans_can_comment ?? config.only_fans_can_comment ?? 0,
+    app_id: acct?.app_id,
+    app_secret: acct?.app_secret,
+    chrome_profile_path: acct?.chrome_profile_path ?? config.chrome_profile_path,
+  };
+}
+
+function loadEnvFile(envPath: string): Record<string, string> {
+  const env: Record<string, string> = {};
+  if (!fs.existsSync(envPath)) return env;
+  const content = fs.readFileSync(envPath, "utf-8");
+  for (const line of content.split("\n")) {
+    const trimmed = line.trim();
+    if (!trimmed || trimmed.startsWith("#")) continue;
+    const eqIdx = trimmed.indexOf("=");
+    if (eqIdx > 0) {
+      const key = trimmed.slice(0, eqIdx).trim();
+      let value = trimmed.slice(eqIdx + 1).trim();
+      if ((value.startsWith('"') && value.endsWith('"')) ||
+          (value.startsWith("'") && value.endsWith("'"))) {
+        value = value.slice(1, -1);
+      }
+      env[key] = value;
+    }
+  }
+  return env;
+}
+
+function aliasToEnvKey(alias: string): string {
+  return alias.toUpperCase().replace(/-/g, "_");
+}
+
+export function loadCredentials(account?: ResolvedAccount): { appId: string; appSecret: string } {
+  if (account?.app_id && account?.app_secret) {
+    return { appId: account.app_id, appSecret: account.app_secret };
+  }
+
+  const cwdEnvPath = path.join(process.cwd(), ".baoyu-skills", ".env");
+  const homeEnvPath = path.join(os.homedir(), ".baoyu-skills", ".env");
+  const cwdEnv = loadEnvFile(cwdEnvPath);
+  const homeEnv = loadEnvFile(homeEnvPath);
+
+  const prefix = account?.alias ? `WECHAT_${aliasToEnvKey(account.alias)}_` : "";
+
+  let appId = "";
+  let appSecret = "";
+
+  if (prefix) {
+    appId = process.env[`${prefix}APP_ID`]
+      || cwdEnv[`${prefix}APP_ID`]
+      || homeEnv[`${prefix}APP_ID`]
+      || "";
+    appSecret = process.env[`${prefix}APP_SECRET`]
+      || cwdEnv[`${prefix}APP_SECRET`]
+      || homeEnv[`${prefix}APP_SECRET`]
+      || "";
+  }
+
+  if (!appId) {
+    appId = process.env.WECHAT_APP_ID || cwdEnv.WECHAT_APP_ID || homeEnv.WECHAT_APP_ID || "";
+  }
+  if (!appSecret) {
+    appSecret = process.env.WECHAT_APP_SECRET || cwdEnv.WECHAT_APP_SECRET || homeEnv.WECHAT_APP_SECRET || "";
+  }
+
+  if (!appId || !appSecret) {
+    const hint = account?.alias ? ` (account: ${account.alias})` : "";
+    throw new Error(
+      `Missing WECHAT_APP_ID or WECHAT_APP_SECRET${hint}.\n` +
+      "Set via EXTEND.md account config, environment variables, or .baoyu-skills/.env file."
+    );
+  }
+
+  return { appId, appSecret };
+}
+
+export function listAccounts(config: WechatExtendConfig): string[] {
+  return (config.accounts || []).map(a => a.alias);
+}
@@ -1,6 +1,14 @@
 ---
 name: baoyu-post-to-weibo
 description: Posts content to Weibo (微博). Supports regular posts with text, images, and videos, and headline articles (头条文章) with Markdown input via Chrome CDP. Use when user asks to "post to Weibo", "发微博", "发布微博", "publish to Weibo", "share on Weibo", "写微博", or "微博头条文章".
+version: 1.56.1
+metadata:
+  openclaw:
+    homepage: https://github.com/JimLiu/baoyu-skills#baoyu-post-to-weibo
+    requires:
+      anyBins:
+        - bun
+        - npx
 ---

 # Post to Weibo
@@ -12,9 +20,9 @@ Posts text, images, videos, and long-form articles to Weibo via real Chrome brow
 **Important**: All scripts are located in the `scripts/` subdirectory of this skill.

 **Agent Execution Instructions**:
-1. Determine this SKILL.md file's directory path as `SKILL_DIR`
-2. Script path = `${SKILL_DIR}/scripts/<script-name>.ts`
-3. Replace all `${SKILL_DIR}` in this document with the actual path
+1. Determine this SKILL.md file's directory path as `{baseDir}`
+2. Script path = `{baseDir}/scripts/<script-name>.ts`
+3. Replace all `{baseDir}` in this document with the actual path
 4. Resolve `${BUN_X}` runtime: if `bun` installed → `bun`; if `npx` available → `npx -y bun`; else suggest installing bun

 **Script Reference**:
@@ -32,12 +40,15 @@ Check EXTEND.md existence (priority order):
 ```bash
 # macOS, Linux, WSL, Git Bash
 test -f .baoyu-skills/baoyu-post-to-weibo/EXTEND.md && echo "project"
+test -f "${XDG_CONFIG_HOME:-$HOME/.config}/baoyu-skills/baoyu-post-to-weibo/EXTEND.md" && echo "xdg"
 test -f "$HOME/.baoyu-skills/baoyu-post-to-weibo/EXTEND.md" && echo "user"
 ```

 ```powershell
 # PowerShell (Windows)
 if (Test-Path .baoyu-skills/baoyu-post-to-weibo/EXTEND.md) { "project" }
+$xdg = if ($env:XDG_CONFIG_HOME) { $env:XDG_CONFIG_HOME } else { "$HOME/.config" }
+if (Test-Path "$xdg/baoyu-skills/baoyu-post-to-weibo/EXTEND.md") { "xdg" }
 if (Test-Path "$HOME/.baoyu-skills/baoyu-post-to-weibo/EXTEND.md") { "user" }
 ```

@@ -72,8 +83,8 @@ if (Test-Path "$HOME/.baoyu-skills/baoyu-post-to-weibo/EXTEND.md") { "user" }
 Text + images/videos (max 18 files total). Posted on Weibo homepage.

 ```bash
-${BUN_X} ${SKILL_DIR}/scripts/weibo-post.ts "Hello Weibo!" --image ./photo.png
-${BUN_X} ${SKILL_DIR}/scripts/weibo-post.ts "Watch this" --video ./clip.mp4
+${BUN_X} {baseDir}/scripts/weibo-post.ts "Hello Weibo!" --image ./photo.png
+${BUN_X} {baseDir}/scripts/weibo-post.ts "Watch this" --video ./clip.mp4
 ```

 **Parameters**:
@@ -93,8 +104,8 @@ ${BUN_X} ${SKILL_DIR}/scripts/weibo-post.ts "Watch this" --video ./clip.mp4
 Long-form Markdown articles published at `https://card.weibo.com/article/v3/editor`.

 ```bash
-${BUN_X} ${SKILL_DIR}/scripts/weibo-article.ts article.md
-${BUN_X} ${SKILL_DIR}/scripts/weibo-article.ts article.md --cover ./cover.jpg
+${BUN_X} {baseDir}/scripts/weibo-article.ts article.md
+${BUN_X} {baseDir}/scripts/weibo-article.ts article.md --cover ./cover.jpg
 ```

 **Parameters**:
@@ -0,0 +1,31 @@
+{
+  "lockfileVersion": 1,
+  "workspaces": {
+    "": {
+      "name": "baoyu-post-to-weibo-scripts",
+      "dependencies": {
+        "baoyu-chrome-cdp": "file:./vendor/baoyu-chrome-cdp",
+        "front-matter": "^4.0.2",
+        "highlight.js": "^11.11.1",
+        "marked": "^15.0.6",
+      },
+    },
+  },
+  "packages": {
+    "argparse": ["argparse@1.0.10", "", { "dependencies": { "sprintf-js": "~1.0.2" } }, "sha512-o5Roy6tNG4SL/FOkCAN6RzjiakZS25RLYFrcMttJqbdd8BWrnA+fGz57iN5Pb06pvBGvl5gQ0B48dJlslXvoTg=="],
+
+    "baoyu-chrome-cdp": ["baoyu-chrome-cdp@file:vendor/baoyu-chrome-cdp", {}],
+
+    "esprima": ["esprima@4.0.1", "", { "bin": { "esparse": "./bin/esparse.js", "esvalidate": "./bin/esvalidate.js" } }, "sha512-eGuFFw7Upda+g4p+QHvnW0RyTX/SVeJBDM/gCtMARO0cLuT2HcEKnTPvhjV6aGeqrCB/sbNop0Kszm0jsaWU4A=="],
+
+    "front-matter": ["front-matter@4.0.2", "", { "dependencies": { "js-yaml": "^3.13.1" } }, "sha512-I8ZuJ/qG92NWX8i5x1Y8qyj3vizhXS31OxjKDu3LKP+7/qBgfIKValiZIEwoVoJKUHlhWtYrktkxV1XsX+pPlg=="],
+
+    "highlight.js": ["highlight.js@11.11.1", "", {}, "sha512-Xwwo44whKBVCYoliBQwaPvtd/2tYFkRQtXDWj1nackaV2JPXx3L0+Jvd8/qCJ2p+ML0/XVkJ2q+Mr+UVdpJK5w=="],
+
+    "js-yaml": ["js-yaml@3.14.2", "", { "dependencies": { "argparse": "^1.0.7", "esprima": "^4.0.0" }, "bin": { "js-yaml": "bin/js-yaml.js" } }, "sha512-PMSmkqxr106Xa156c2M265Z+FTrPl+oxd/rgOQy2tijQeK5TxQ43psO1ZCwhVOSdnn+RzkzlRz/eY4BgJBYVpg=="],
+
+    "marked": ["marked@15.0.12", "", { "bin": { "marked": "bin/marked.js" } }, "sha512-8dD6FusOQSrpv9Z1rdNMdlSgQOIP880DHqnohobOmYLElGEqAL/JvxvuxZO16r4HtjTlfPRDC1hbvxC9dPN2nA=="],
+
+    "sprintf-js": ["sprintf-js@1.0.3", "", {}, "sha512-D9cPgkvLlV3t3IzL0D0YLvGA9Ahk4PcvVwUbN0dSGr1aP0Nrt4AEnTUbuGvquEC0mA64Gqt1fzirlRs5ibXx8g=="],
+  }
+}
@@ -446,7 +446,9 @@ Options:
  }
 }

-await main().catch((err) => {
-  console.error(`Error: ${err instanceof Error ? err.message : String(err)}`);
-  process.exit(1);
-});
+if (import.meta.main ?? (process.argv[1] && path.resolve(process.argv[1]) === path.resolve(import.meta.filename ?? ''))) {
+  await main().catch((err) => {
+    console.error(`Error: ${err instanceof Error ? err.message : String(err)}`);
+    process.exit(1);
+  });
+}
@@ -0,0 +1,11 @@
+{
+  "name": "baoyu-post-to-weibo-scripts",
+  "private": true,
+  "type": "module",
+  "dependencies": {
+    "baoyu-chrome-cdp": "file:./vendor/baoyu-chrome-cdp",
+    "front-matter": "^4.0.2",
+    "highlight.js": "^11.11.1",
+    "marked": "^15.0.6"
+  }
+}
@@ -0,0 +1,9 @@
+{
+  "name": "baoyu-chrome-cdp",
+  "private": true,
+  "version": "0.1.0",
+  "type": "module",
+  "exports": {
+    ".": "./src/index.ts"
+  }
+}
@@ -0,0 +1,408 @@
+import { spawn, spawnSync, type ChildProcess } from "node:child_process";
+import fs from "node:fs";
+import net from "node:net";
+import os from "node:os";
+import path from "node:path";
+import process from "node:process";
+
+export type PlatformCandidates = {
+  darwin?: string[];
+  win32?: string[];
+  default: string[];
+};
+
+type PendingRequest = {
+  resolve: (value: unknown) => void;
+  reject: (error: Error) => void;
+  timer: ReturnType<typeof setTimeout> | null;
+};
+
+type CdpSendOptions = {
+  sessionId?: string;
+  timeoutMs?: number;
+};
+
+type FetchJsonOptions = {
+  timeoutMs?: number;
+};
+
+type FindChromeExecutableOptions = {
+  candidates: PlatformCandidates;
+  envNames?: string[];
+};
+
+type ResolveSharedChromeProfileDirOptions = {
+  envNames?: string[];
+  appDataDirName?: string;
+  profileDirName?: string;
+  wslWindowsHome?: string | null;
+};
+
+type FindExistingChromeDebugPortOptions = {
+  profileDir: string;
+  timeoutMs?: number;
+};
+
+type LaunchChromeOptions = {
+  chromePath: string;
+  profileDir: string;
+  port: number;
+  url?: string;
+  headless?: boolean;
+  extraArgs?: string[];
+};
+
+type ChromeTargetInfo = {
+  targetId: string;
+  url: string;
+  type: string;
+};
+
+type OpenPageSessionOptions = {
+  cdp: CdpConnection;
+  reusing: boolean;
+  url: string;
+  matchTarget: (target: ChromeTargetInfo) => boolean;
+  enablePage?: boolean;
+  enableRuntime?: boolean;
+  enableDom?: boolean;
+  enableNetwork?: boolean;
+  activateTarget?: boolean;
+};
+
+export type PageSession = {
+  sessionId: string;
+  targetId: string;
+};
+
+export function sleep(ms: number): Promise<void> {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+
+export async function getFreePort(fixedEnvName?: string): Promise<number> {
+  const fixed = fixedEnvName ? Number.parseInt(process.env[fixedEnvName] ?? "", 10) : NaN;
+  if (Number.isInteger(fixed) && fixed > 0) return fixed;
+
+  return await new Promise((resolve, reject) => {
+    const server = net.createServer();
+    server.unref();
+    server.on("error", reject);
+    server.listen(0, "127.0.0.1", () => {
+      const address = server.address();
+      if (!address || typeof address === "string") {
+        server.close(() => reject(new Error("Unable to allocate a free TCP port.")));
+        return;
+      }
+      const port = address.port;
+      server.close((err) => {
+        if (err) reject(err);
+        else resolve(port);
+      });
+    });
+  });
+}
+
+export function findChromeExecutable(options: FindChromeExecutableOptions): string | undefined {
+  for (const envName of options.envNames ?? []) {
+    const override = process.env[envName]?.trim();
+    if (override && fs.existsSync(override)) return override;
+  }
+
+  const candidates = process.platform === "darwin"
+    ? options.candidates.darwin ?? options.candidates.default
+    : process.platform === "win32"
+      ? options.candidates.win32 ?? options.candidates.default
+      : options.candidates.default;
+
+  for (const candidate of candidates) {
+    if (fs.existsSync(candidate)) return candidate;
+  }
+  return undefined;
+}
+
+export function resolveSharedChromeProfileDir(options: ResolveSharedChromeProfileDirOptions = {}): string {
+  for (const envName of options.envNames ?? []) {
+    const override = process.env[envName]?.trim();
+    if (override) return path.resolve(override);
+  }
+
+  const appDataDirName = options.appDataDirName ?? "baoyu-skills";
+  const profileDirName = options.profileDirName ?? "chrome-profile";
+
+  if (options.wslWindowsHome) {
+    return path.join(options.wslWindowsHome, ".local", "share", appDataDirName, profileDirName);
+  }
+
+  const base = process.platform === "darwin"
+    ? path.join(os.homedir(), "Library", "Application Support")
+    : process.platform === "win32"
+      ? (process.env.APPDATA ?? path.join(os.homedir(), "AppData", "Roaming"))
+      : (process.env.XDG_DATA_HOME ?? path.join(os.homedir(), ".local", "share"));
+  return path.join(base, appDataDirName, profileDirName);
+}
+
+async function fetchWithTimeout(url: string, timeoutMs?: number): Promise<Response> {
+  if (!timeoutMs || timeoutMs <= 0) return await fetch(url, { redirect: "follow" });
+
+  const ctl = new AbortController();
+  const timer = setTimeout(() => ctl.abort(), timeoutMs);
+  try {
+    return await fetch(url, { redirect: "follow", signal: ctl.signal });
+  } finally {
+    clearTimeout(timer);
+  }
+}
+
+async function fetchJson<T = unknown>(url: string, options: FetchJsonOptions = {}): Promise<T> {
+  const response = await fetchWithTimeout(url, options.timeoutMs);
+  if (!response.ok) {
+    throw new Error(`Request failed: ${response.status} ${response.statusText}`);
+  }
+  return await response.json() as T;
+}
+
+async function isDebugPortReady(port: number, timeoutMs = 3_000): Promise<boolean> {
+  try {
+    const version = await fetchJson<{ webSocketDebuggerUrl?: string }>(
+      `http://127.0.0.1:${port}/json/version`,
+      { timeoutMs }
+    );
+    return !!version.webSocketDebuggerUrl;
+  } catch {
+    return false;
+  }
+}
+
+export async function findExistingChromeDebugPort(options: FindExistingChromeDebugPortOptions): Promise<number | null> {
+  const timeoutMs = options.timeoutMs ?? 3_000;
+  const portFile = path.join(options.profileDir, "DevToolsActivePort");
+
+  try {
+    const content = fs.readFileSync(portFile, "utf-8");
+    const [portLine] = content.split(/\r?\n/);
+    const port = Number.parseInt(portLine?.trim() ?? "", 10);
+    if (port > 0 && await isDebugPortReady(port, timeoutMs)) return port;
+  } catch {}
+
+  if (process.platform === "win32") return null;
+
+  try {
+    const result = spawnSync("ps", ["aux"], { encoding: "utf-8", timeout: 5_000 });
+    if (result.status !== 0 || !result.stdout) return null;
+
+    const lines = result.stdout
+      .split("\n")
+      .filter((line) => line.includes(options.profileDir) && line.includes("--remote-debugging-port="));
+
+    for (const line of lines) {
+      const portMatch = line.match(/--remote-debugging-port=(\d+)/);
+      const port = Number.parseInt(portMatch?.[1] ?? "", 10);
+      if (port > 0 && await isDebugPortReady(port, timeoutMs)) return port;
+    }
+  } catch {}
+
+  return null;
+}
+
+export async function waitForChromeDebugPort(
+  port: number,
+  timeoutMs: number,
+  options?: { includeLastError?: boolean }
+): Promise<string> {
+  const start = Date.now();
+  let lastError: unknown = null;
+
+  while (Date.now() - start < timeoutMs) {
+    try {
+      const version = await fetchJson<{ webSocketDebuggerUrl?: string }>(
+        `http://127.0.0.1:${port}/json/version`,
+        { timeoutMs: 5_000 }
+      );
+      if (version.webSocketDebuggerUrl) return version.webSocketDebuggerUrl;
+      lastError = new Error("Missing webSocketDebuggerUrl");
+    } catch (error) {
+      lastError = error;
+    }
+    await sleep(200);
+  }
+
+  if (options?.includeLastError && lastError) {
+    throw new Error(
+      `Chrome debug port not ready: ${lastError instanceof Error ? lastError.message : String(lastError)}`
+    );
+  }
+  throw new Error("Chrome debug port not ready");
+}
+
+export class CdpConnection {
+  private ws: WebSocket;
+  private nextId = 0;
+  private pending = new Map<number, PendingRequest>();
+  private eventHandlers = new Map<string, Set<(params: unknown) => void>>();
+  private defaultTimeoutMs: number;
+
+  private constructor(ws: WebSocket, defaultTimeoutMs = 15_000) {
+    this.ws = ws;
+    this.defaultTimeoutMs = defaultTimeoutMs;
+
+    this.ws.addEventListener("message", (event) => {
+      try {
+        const data = typeof event.data === "string"
+          ? event.data
+          : new TextDecoder().decode(event.data as ArrayBuffer);
+        const msg = JSON.parse(data) as {
+          id?: number;
+          method?: string;
+          params?: unknown;
+          result?: unknown;
+          error?: { message?: string };
+        };
+
+        if (msg.method) {
+          const handlers = this.eventHandlers.get(msg.method);
+          if (handlers) {
+            handlers.forEach((handler) => handler(msg.params));
+          }
+        }
+
+        if (msg.id) {
+          const pending = this.pending.get(msg.id);
+          if (pending) {
+            this.pending.delete(msg.id);
+            if (pending.timer) clearTimeout(pending.timer);
+            if (msg.error?.message) pending.reject(new Error(msg.error.message));
+            else pending.resolve(msg.result);
+          }
+        }
+      } catch {}
+    });
+
+    this.ws.addEventListener("close", () => {
+      for (const [id, pending] of this.pending.entries()) {
+        this.pending.delete(id);
+        if (pending.timer) clearTimeout(pending.timer);
+        pending.reject(new Error("CDP connection closed."));
+      }
+    });
+  }
+
+  static async connect(
+    url: string,
+    timeoutMs: number,
+    options?: { defaultTimeoutMs?: number }
+  ): Promise<CdpConnection> {
+    const ws = new WebSocket(url);
+    await new Promise<void>((resolve, reject) => {
+      const timer = setTimeout(() => reject(new Error("CDP connection timeout.")), timeoutMs);
+      ws.addEventListener("open", () => {
+        clearTimeout(timer);
+        resolve();
+      });
+      ws.addEventListener("error", () => {
+        clearTimeout(timer);
+        reject(new Error("CDP connection failed."));
+      });
+    });
+    return new CdpConnection(ws, options?.defaultTimeoutMs ?? 15_000);
+  }
+
+  on(method: string, handler: (params: unknown) => void): void {
+    if (!this.eventHandlers.has(method)) {
+      this.eventHandlers.set(method, new Set());
+    }
+    this.eventHandlers.get(method)?.add(handler);
+  }
+
+  off(method: string, handler: (params: unknown) => void): void {
+    this.eventHandlers.get(method)?.delete(handler);
+  }
+
+  async send<T = unknown>(method: string, params?: Record<string, unknown>, options?: CdpSendOptions): Promise<T> {
+    const id = ++this.nextId;
+    const message: Record<string, unknown> = { id, method };
+    if (params) message.params = params;
+    if (options?.sessionId) message.sessionId = options.sessionId;
+
+    const timeoutMs = options?.timeoutMs ?? this.defaultTimeoutMs;
+    const result = await new Promise<unknown>((resolve, reject) => {
+      const timer = timeoutMs > 0
+        ? setTimeout(() => {
+          this.pending.delete(id);
+          reject(new Error(`CDP timeout: ${method}`));
+        }, timeoutMs)
+        : null;
+      this.pending.set(id, { resolve, reject, timer });
+      this.ws.send(JSON.stringify(message));
+    });
+
+    return result as T;
+  }
+
+  close(): void {
+    try {
+      this.ws.close();
+    } catch {}
+  }
+}
+
+export async function launchChrome(options: LaunchChromeOptions): Promise<ChildProcess> {
+  await fs.promises.mkdir(options.profileDir, { recursive: true });
+
+  const args = [
+    `--remote-debugging-port=${options.port}`,
+    `--user-data-dir=${options.profileDir}`,
+    "--no-first-run",
+    "--no-default-browser-check",
+    ...(options.extraArgs ?? []),
+  ];
+  if (options.headless) args.push("--headless=new");
+  if (options.url) args.push(options.url);
+
+  return spawn(options.chromePath, args, { stdio: "ignore" });
+}
+
+export function killChrome(chrome: ChildProcess): void {
+  try {
+    chrome.kill("SIGTERM");
+  } catch {}
+  setTimeout(() => {
+    if (!chrome.killed) {
+      try {
+        chrome.kill("SIGKILL");
+      } catch {}
+    }
+  }, 2_000).unref?.();
+}
+
+export async function openPageSession(options: OpenPageSessionOptions): Promise<PageSession> {
+  let targetId: string;
+
+  if (options.reusing) {
+    const created = await options.cdp.send<{ targetId: string }>("Target.createTarget", { url: options.url });
+    targetId = created.targetId;
+  } else {
+    const targets = await options.cdp.send<{ targetInfos: ChromeTargetInfo[] }>("Target.getTargets");
+    const existing = targets.targetInfos.find(options.matchTarget);
+    if (existing) {
+      targetId = existing.targetId;
+    } else {
+      const created = await options.cdp.send<{ targetId: string }>("Target.createTarget", { url: options.url });
+      targetId = created.targetId;
+    }
+  }
+
+  const { sessionId } = await options.cdp.send<{ sessionId: string }>(
+    "Target.attachToTarget",
+    { targetId, flatten: true }
+  );
+
+  if (options.activateTarget ?? true) {
+    await options.cdp.send("Target.activateTarget", { targetId });
+  }
+  if (options.enablePage) await options.cdp.send("Page.enable", {}, { sessionId });
+  if (options.enableRuntime) await options.cdp.send("Runtime.enable", {}, { sessionId });
+  if (options.enableDom) await options.cdp.send("DOM.enable", {}, { sessionId });
+  if (options.enableNetwork) await options.cdp.send("Network.enable", {}, { sessionId });
+
+  return { sessionId, targetId };
+}
@@ -1,9 +1,7 @@
-import { spawn } from 'node:child_process';
 import fs from 'node:fs';
 import { mkdir, writeFile } from 'node:fs/promises';
 import os from 'node:os';
 import path from 'node:path';
-import process from 'node:process';
 import {
  CdpConnection,
  copyHtmlToClipboard,
@@ -11,7 +9,7 @@ import {
  findChromeExecutable,
  findExistingChromeDebugPort,
  getDefaultProfileDir,
-  getFreePort,
+  launchChrome,
  pasteFromClipboard,
  sleep,
  waitForChromeDebugPort,
@@ -74,36 +72,17 @@ export async function publishArticle(options: ArticleOptions): Promise<void> {
  await mkdir(profileDir, { recursive: true });

  // Try reusing an existing Chrome instance with the same profile
-  const existingPort = findExistingChromeDebugPort(profileDir);
+  const existingPort = await findExistingChromeDebugPort(profileDir);
  let port: number;
-  let launched = false;

  if (existingPort) {
    console.log(`[weibo-article] Found existing Chrome on port ${existingPort}, reusing...`);
    port = existingPort;
  } else {
-    const chromePath = options.chromePath ?? findChromeExecutable();
+    const chromePath = findChromeExecutable(options.chromePath);
    if (!chromePath) throw new Error('Chrome not found. Set WEIBO_BROWSER_CHROME_PATH env var.');

-    port = await getFreePort();
-    console.log(`[weibo-article] Launching Chrome...`);
-    const chromeArgs = [
-      `--remote-debugging-port=${port}`,
-      `--user-data-dir=${profileDir}`,
-      '--no-first-run',
-      '--no-default-browser-check',
-      '--disable-blink-features=AutomationControlled',
-      '--start-maximized',
-      WEIBO_ARTICLE_URL,
-    ];
-
-    if (process.platform === 'darwin') {
-      const appPath = chromePath.replace(/\/Contents\/MacOS\/Google Chrome$/, '');
-      spawn('open', ['-na', appPath, '--args', ...chromeArgs], { stdio: 'ignore' });
-    } else {
-      spawn(chromePath, chromeArgs, { stdio: 'ignore' });
-    }
-    launched = true;
+    port = await launchChrome(WEIBO_ARTICLE_URL, profileDir, chromePath);
  }

  let cdp: CdpConnection | null = null;
@@ -459,7 +438,7 @@ export async function publishArticle(options: ArticleOptions): Promise<void> {
                    if (charAfter === undefined || !/\\d/.test(charAfter)) {
                      const parentElement = node.parentElement;
                      if (parentElement) {
-                        parentElement.scrollIntoView({ behavior: 'smooth', block: 'center' });
+                        parentElement.scrollIntoView({ behavior: 'instant', block: 'center' });
                      }

                      const range = document.createRange();
@@ -500,112 +479,56 @@ export async function publishArticle(options: ArticleOptions): Promise<void> {
          return false;
        };

+        // Step A: Copy image to clipboard first (slow due to Swift compilation)
+        console.log(`[weibo-article] Copying image to clipboard: ${path.basename(img.localPath)}`);
+        if (!copyImageToClipboard(img.localPath)) {
+          console.warn(`[weibo-article] Failed to copy image to clipboard`);
+          continue;
+        }
+        await sleep(500);
+
+        // Step B: Select placeholder text (paste will replace the selection)
        const selected = await selectPlaceholder(3);
        if (!selected) {
          console.warn(`[weibo-article] Skipping image - could not select placeholder: ${img.placeholder}`);
          continue;
        }

-        console.log(`[weibo-article] Copying image: ${path.basename(img.localPath)}`);
-
-        if (!copyImageToClipboard(img.localPath)) {
-          console.warn(`[weibo-article] Failed to copy image to clipboard`);
-          continue;
-        }
-
-        await sleep(1000);
-
-        // Delete placeholder by replacing selection with empty text
-        console.log(`[weibo-article] Deleting placeholder...`);
-        await cdp.send('Runtime.evaluate', {
-          expression: `(() => {
-            const sel = window.getSelection();
-            if (!sel || sel.isCollapsed) return false;
-            const range = sel.getRangeAt(0);
-            range.deleteContents();
-            sel.collapseToStart();
-            return true;
-          })()`,
-          returnByValue: true,
-        }, { sessionId });
-
-        await sleep(300);
-
-        // Fallback: send Backspace key if placeholder still exists
-        const stillExists = await cdp!.send<{ result: { value: boolean } }>('Runtime.evaluate', {
-          expression: `(() => {
-            const editor = document.querySelector('div[contenteditable="true"]');
-            if (!editor) return false;
-            const placeholder = ${JSON.stringify(img.placeholder)};
-            const regex = new RegExp(placeholder + '(?!\\\\d)');
-            return regex.test(editor.innerText);
-          })()`,
-          returnByValue: true,
-        }, { sessionId });
-
-        if (stillExists.result.value) {
-          console.log('[weibo-article] Placeholder survived deleteContents, trying Input.insertText replacement...');
-          // Re-select and replace with empty via Input.insertText
-          await cdp!.send('Runtime.evaluate', {
-            expression: `(() => {
-              const editor = document.querySelector('div[contenteditable="true"]');
-              if (!editor) return false;
-              const placeholder = ${JSON.stringify(img.placeholder)};
-              const walker = document.createTreeWalker(editor, NodeFilter.SHOW_TEXT, null, false);
-              let node;
-              while ((node = walker.nextNode())) {
-                const text = node.textContent || '';
-                let searchStart = 0;
-                let idx;
-                while ((idx = text.indexOf(placeholder, searchStart)) !== -1) {
-                  const afterIdx = idx + placeholder.length;
-                  const charAfter = text[afterIdx];
-                  if (charAfter === undefined || !/\\d/.test(charAfter)) {
-                    const range = document.createRange();
-                    range.setStart(node, idx);
-                    range.setEnd(node, idx + placeholder.length);
-                    const sel = window.getSelection();
-                    sel.removeAllRanges();
-                    sel.addRange(range);
-                    return true;
-                  }
-                  searchStart = afterIdx;
-                }
-              }
-              return false;
-            })()`,
-          }, { sessionId });
-          await sleep(200);
-          await cdp!.send('Input.insertText', { text: '' }, { sessionId });
-          await sleep(300);
-        }
-
-        await sleep(200);
+        // Step C: Delete selected placeholder via Backspace (ProseMirror-compatible)
+        console.log(`[weibo-article] Deleting placeholder via Backspace...`);
+        await cdp.send('Input.dispatchKeyEvent', { type: 'keyDown', key: 'Backspace', code: 'Backspace', windowsVirtualKeyCode: 8 }, { sessionId });
+        await cdp.send('Input.dispatchKeyEvent', { type: 'keyUp', key: 'Backspace', code: 'Backspace', windowsVirtualKeyCode: 8 }, { sessionId });
+        await sleep(500);

        // Verify placeholder was deleted
-        const afterDelete = await cdp.send<{ result: { value: boolean } }>('Runtime.evaluate', {
+        const placeholderGone = await cdp.send<{ result: { value: boolean } }>('Runtime.evaluate', {
          expression: `(() => {
            const editor = document.querySelector('div[contenteditable="true"]');
            if (!editor) return true;
-            const text = editor.innerText;
            const placeholder = ${JSON.stringify(img.placeholder)};
            const regex = new RegExp(placeholder + '(?!\\\\d)');
-            return !regex.test(text);
+            return !regex.test(editor.innerText);
          })()`,
          returnByValue: true,
        }, { sessionId });

-        if (afterDelete.result.value) {
+        if (placeholderGone.result.value) {
          console.log(`[weibo-article] Placeholder deleted`);
        } else {
-          console.warn(`[weibo-article] Placeholder may still exist after delete`);
+          console.warn(`[weibo-article] Placeholder may still exist, trying execCommand delete...`);
+          // Re-select and delete via execCommand
+          await selectPlaceholder(1);
+          await cdp.send('Runtime.evaluate', {
+            expression: `document.execCommand('delete')`,
+          }, { sessionId });
+          await sleep(300);
        }

-        // Focus editor for paste
+        // Step D: Focus editor and paste image
        await cdp.send('Runtime.evaluate', {
          expression: `document.querySelector('div[contenteditable="true"]')?.focus()`,
        }, { sessionId });
-        await sleep(300);
+        await sleep(200);

        // Count images before paste
        const imgCountBefore = await cdp.send<{ result: { value: number } }>('Runtime.evaluate', {
@@ -613,7 +536,7 @@ export async function publishArticle(options: ArticleOptions): Promise<void> {
          returnByValue: true,
        }, { sessionId });

-        // Paste image
+        // Paste image at cursor position (where placeholder was)
        console.log(`[weibo-article] Pasting image...`);
        if (pasteFromClipboard('Google Chrome', 5, 1000)) {
          console.log(`[weibo-article] Paste keystroke sent for: ${path.basename(img.localPath)}`);
@@ -1,4 +1,3 @@
-import { spawn } from 'node:child_process';
 import fs from 'node:fs';
 import { mkdir } from 'node:fs/promises';
 import path from 'node:path';
@@ -8,8 +7,8 @@ import {
  findChromeExecutable,
  findExistingChromeDebugPort,
  getDefaultProfileDir,
-  getFreePort,
  killChromeByProfile,
+  launchChrome as launchWeiboChrome,
  sleep,
  waitForChromeDebugPort,
 } from './weibo-utils.js';
@@ -37,32 +36,11 @@ export async function postToWeibo(options: WeiboPostOptions): Promise<void> {

  await mkdir(profileDir, { recursive: true });

-  const chromePath = options.chromePath ?? findChromeExecutable();
+  const chromePath = findChromeExecutable(options.chromePath);
  if (!chromePath) throw new Error('Chrome not found. Set WEIBO_BROWSER_CHROME_PATH env var.');

-  const launchChrome = async (): Promise<number> => {
-    const port = await getFreePort();
-    console.log(`[weibo-post] Launching Chrome (profile: ${profileDir})`);
-    const chromeArgs = [
-      `--remote-debugging-port=${port}`,
-      `--user-data-dir=${profileDir}`,
-      '--no-first-run',
-      '--no-default-browser-check',
-      '--disable-blink-features=AutomationControlled',
-      '--start-maximized',
-      WEIBO_HOME_URL,
-    ];
-    if (process.platform === 'darwin') {
-      const appPath = chromePath.replace(/\/Contents\/MacOS\/Google Chrome$/, '');
-      spawn('open', ['-na', appPath, '--args', ...chromeArgs], { stdio: 'ignore' });
-    } else {
-      spawn(chromePath, chromeArgs, { stdio: 'ignore' });
-    }
-    return port;
-  };
-
  let port: number;
-  const existingPort = findExistingChromeDebugPort(profileDir);
+  const existingPort = await findExistingChromeDebugPort(profileDir);

  if (existingPort) {
    console.log(`[weibo-post] Found existing Chrome on port ${existingPort}, checking health...`);
@@ -77,10 +55,10 @@ export async function postToWeibo(options: WeiboPostOptions): Promise<void> {
      console.log('[weibo-post] Existing Chrome unresponsive, restarting...');
      killChromeByProfile(profileDir);
      await sleep(2000);
-      port = await launchChrome();
+      port = await launchWeiboChrome(WEIBO_HOME_URL, profileDir, chromePath);
    }
  } else {
-    port = await launchChrome();
+    port = await launchWeiboChrome(WEIBO_HOME_URL, profileDir, chromePath);
  }

  let cdp: CdpConnection | null = null;
@@ -1,12 +1,23 @@
-import { spawnSync } from 'node:child_process';
-import fs from 'node:fs';
-import net from 'node:net';
-import os from 'node:os';
+import { execSync, spawnSync } from 'node:child_process';
 import path from 'node:path';
 import process from 'node:process';
 import { fileURLToPath } from 'node:url';

-export const CHROME_CANDIDATES = {
+import {
+  CdpConnection,
+  findChromeExecutable as findChromeExecutableBase,
+  findExistingChromeDebugPort as findExistingChromeDebugPortBase,
+  getFreePort as getFreePortBase,
+  launchChrome as launchChromeBase,
+  resolveSharedChromeProfileDir,
+  sleep,
+  waitForChromeDebugPort,
+  type PlatformCandidates,
+} from 'baoyu-chrome-cdp';
+
+export { CdpConnection, sleep, waitForChromeDebugPort };
+
+export const CHROME_CANDIDATES: PlatformCandidates = {
  darwin: [
    '/Applications/Google Chrome.app/Contents/MacOS/Google Chrome',
    '/Applications/Google Chrome Canary.app/Contents/MacOS/Google Chrome Canary',
@@ -23,183 +34,81 @@ export const CHROME_CANDIDATES = {
  ],
 };

-export function findChromeExecutable(): string | undefined {
-  const override = process.env.WEIBO_BROWSER_CHROME_PATH?.trim();
-  if (override && fs.existsSync(override)) return override;
-
-  const candidates = process.platform === 'darwin'
-    ? CHROME_CANDIDATES.darwin
-    : process.platform === 'win32'
-      ? CHROME_CANDIDATES.win32
-      : CHROME_CANDIDATES.default;
-
-  for (const candidate of candidates) {
-    if (fs.existsSync(candidate)) return candidate;
+let wslHome: string | null | undefined;
+function getWslWindowsHome(): string | null {
+  if (wslHome !== undefined) return wslHome;
+  if (!process.env.WSL_DISTRO_NAME) {
+    wslHome = null;
+    return null;
  }
-  return undefined;
+  try {
+    const raw = execSync('cmd.exe /C "echo %USERPROFILE%"', {
+      encoding: 'utf-8',
+      timeout: 5_000,
+    }).trim().replace(/\r/g, '');
+    wslHome = execSync(`wslpath -u "${raw}"`, {
+      encoding: 'utf-8',
+      timeout: 5_000,
+    }).trim() || null;
+  } catch {
+    wslHome = null;
+  }
+  return wslHome;
 }

-export function findExistingChromeDebugPort(profileDir: string): number | null {
-  try {
-    const result = spawnSync('ps', ['aux'], { encoding: 'utf-8', timeout: 5000 });
-    if (result.status !== 0 || !result.stdout) return null;
-    const lines = result.stdout.split('\n');
-    for (const line of lines) {
-      if (!line.includes('--remote-debugging-port=') || !line.includes(profileDir)) continue;
-      const portMatch = line.match(/--remote-debugging-port=(\d+)/);
-      if (portMatch) return Number(portMatch[1]);
-    }
-  } catch {}
-  return null;
+export function findChromeExecutable(chromePathOverride?: string): string | undefined {
+  if (chromePathOverride?.trim()) return chromePathOverride.trim();
+  return findChromeExecutableBase({
+    candidates: CHROME_CANDIDATES,
+    envNames: ['WEIBO_BROWSER_CHROME_PATH'],
+  });
+}
+
+export async function findExistingChromeDebugPort(profileDir: string): Promise<number | null> {
+  return await findExistingChromeDebugPortBase({ profileDir });
 }

 export function killChromeByProfile(profileDir: string): void {
  try {
-    const result = spawnSync('ps', ['aux'], { encoding: 'utf-8', timeout: 5000 });
+    const result = spawnSync('ps', ['aux'], { encoding: 'utf-8', timeout: 5_000 });
    if (result.status !== 0 || !result.stdout) return;
    for (const line of result.stdout.split('\n')) {
      if (!line.includes(profileDir) || !line.includes('--remote-debugging-port=')) continue;
-      const pidMatch = line.trim().split(/\s+/)[1];
-      if (pidMatch) {
-        try { process.kill(Number(pidMatch), 'SIGTERM'); } catch {}
+      const pid = line.trim().split(/\s+/)[1];
+      if (pid) {
+        try {
+          process.kill(Number(pid), 'SIGTERM');
+        } catch {}
      }
    }
  } catch {}
 }

 export function getDefaultProfileDir(): string {
-  const override = process.env.BAOYU_CHROME_PROFILE_DIR?.trim() || process.env.WEIBO_BROWSER_PROFILE_DIR?.trim();
-  if (override) return path.resolve(override);
-  const base = process.platform === 'darwin'
-    ? path.join(os.homedir(), 'Library', 'Application Support')
-    : process.env.XDG_DATA_HOME || path.join(os.homedir(), '.local', 'share');
-  return path.join(base, 'baoyu-skills', 'chrome-profile');
-}
-
-export function sleep(ms: number): Promise<void> {
-  return new Promise((resolve) => setTimeout(resolve, ms));
-}
-
-export async function getFreePort(): Promise<number> {
-  const fixed = parseInt(process.env.WEIBO_BROWSER_DEBUG_PORT || '', 10);
-  if (fixed > 0) return fixed;
-  return new Promise((resolve, reject) => {
-    const server = net.createServer();
-    server.unref();
-    server.on('error', reject);
-    server.listen(0, '127.0.0.1', () => {
-      const address = server.address();
-      if (!address || typeof address === 'string') {
-        server.close(() => reject(new Error('Unable to allocate a free TCP port.')));
-        return;
-      }
-      const port = address.port;
-      server.close((err) => {
-        if (err) reject(err);
-        else resolve(port);
-      });
-    });
+  return resolveSharedChromeProfileDir({
+    envNames: ['BAOYU_CHROME_PROFILE_DIR', 'WEIBO_BROWSER_PROFILE_DIR'],
+    wslWindowsHome: getWslWindowsHome(),
  });
 }

-async function fetchJson<T = unknown>(url: string): Promise<T> {
-  const res = await fetch(url, { redirect: 'follow' });
-  if (!res.ok) throw new Error(`Request failed: ${res.status} ${res.statusText}`);
-  return (await res.json()) as T;
+export async function getFreePort(): Promise<number> {
+  return await getFreePortBase('WEIBO_BROWSER_DEBUG_PORT');
 }

-export async function waitForChromeDebugPort(port: number, timeoutMs: number): Promise<string> {
-  const start = Date.now();
-  let lastError: unknown = null;
+export async function launchChrome(url: string, profileDir: string, chromePathOverride?: string): Promise<number> {
+  const chromePath = findChromeExecutable(chromePathOverride);
+  if (!chromePath) throw new Error('Chrome not found. Set WEIBO_BROWSER_CHROME_PATH env var.');

-  while (Date.now() - start < timeoutMs) {
-    try {
-      const version = await fetchJson<{ webSocketDebuggerUrl?: string }>(`http://127.0.0.1:${port}/json/version`);
-      if (version.webSocketDebuggerUrl) return version.webSocketDebuggerUrl;
-      lastError = new Error('Missing webSocketDebuggerUrl');
-    } catch (error) {
-      lastError = error;
-    }
-    await sleep(200);
-  }
-
-  throw new Error(`Chrome debug port not ready: ${lastError instanceof Error ? lastError.message : String(lastError)}`);
-}
-
-type PendingRequest = {
-  resolve: (value: unknown) => void;
-  reject: (error: Error) => void;
-  timer: ReturnType<typeof setTimeout> | null;
-};
-
-export class CdpConnection {
-  private ws: WebSocket;
-  private nextId = 0;
-  private pending = new Map<number, PendingRequest>();
-  private defaultTimeoutMs: number;
-
-  private constructor(ws: WebSocket, options?: { defaultTimeoutMs?: number }) {
-    this.ws = ws;
-    this.defaultTimeoutMs = options?.defaultTimeoutMs ?? 15_000;
-
-    this.ws.addEventListener('message', (event) => {
-      try {
-        const data = typeof event.data === 'string' ? event.data : new TextDecoder().decode(event.data as ArrayBuffer);
-        const msg = JSON.parse(data) as { id?: number; method?: string; params?: unknown; result?: unknown; error?: { message?: string } };
-
-        if (msg.id) {
-          const pending = this.pending.get(msg.id);
-          if (pending) {
-            this.pending.delete(msg.id);
-            if (pending.timer) clearTimeout(pending.timer);
-            if (msg.error?.message) pending.reject(new Error(msg.error.message));
-            else pending.resolve(msg.result);
-          }
-        }
-      } catch {}
-    });
-
-    this.ws.addEventListener('close', () => {
-      for (const [id, pending] of this.pending.entries()) {
-        this.pending.delete(id);
-        if (pending.timer) clearTimeout(pending.timer);
-        pending.reject(new Error('CDP connection closed.'));
-      }
-    });
-  }
-
-  static async connect(url: string, timeoutMs: number, options?: { defaultTimeoutMs?: number }): Promise<CdpConnection> {
-    const ws = new WebSocket(url);
-    await new Promise<void>((resolve, reject) => {
-      const timer = setTimeout(() => reject(new Error('CDP connection timeout.')), timeoutMs);
-      ws.addEventListener('open', () => { clearTimeout(timer); resolve(); });
-      ws.addEventListener('error', () => { clearTimeout(timer); reject(new Error('CDP connection failed.')); });
-    });
-    return new CdpConnection(ws, options);
-  }
-
-  async send<T = unknown>(method: string, params?: Record<string, unknown>, options?: { sessionId?: string; timeoutMs?: number }): Promise<T> {
-    const id = ++this.nextId;
-    const message: Record<string, unknown> = { id, method };
-    if (params) message.params = params;
-    if (options?.sessionId) message.sessionId = options.sessionId;
-
-    const timeoutMs = options?.timeoutMs ?? this.defaultTimeoutMs;
-
-    const result = await new Promise<unknown>((resolve, reject) => {
-      const timer = timeoutMs > 0
-        ? setTimeout(() => { this.pending.delete(id); reject(new Error(`CDP timeout: ${method}`)); }, timeoutMs)
-        : null;
-      this.pending.set(id, { resolve, reject, timer });
-      this.ws.send(JSON.stringify(message));
-    });
-
-    return result as T;
-  }
-
-  close(): void {
-    try { this.ws.close(); } catch {}
-  }
+  const port = await getFreePort();
+  console.log(`[weibo-cdp] Launching Chrome (profile: ${profileDir})`);
+  await launchChromeBase({
+    chromePath,
+    profileDir,
+    port,
+    url,
+    extraArgs: ['--disable-blink-features=AutomationControlled', '--start-maximized'],
+  });
+  return port;
 }

 export function getScriptDir(): string {
@@ -1,6 +1,14 @@
 ---
 name: baoyu-post-to-x
 description: Posts content and articles to X (Twitter). Supports regular posts with images/videos and X Articles (long-form Markdown). Uses real Chrome with CDP to bypass anti-automation. Use when user asks to "post to X", "tweet", "publish to Twitter", or "share on X".
+version: 1.56.1
+metadata:
+  openclaw:
+    homepage: https://github.com/JimLiu/baoyu-skills#baoyu-post-to-x
+    requires:
+      anyBins:
+        - bun
+        - npx
 ---

 # Post to X (Twitter)
@@ -12,9 +20,9 @@ Posts text, images, videos, and long-form articles to X via real Chrome browser
 **Important**: All scripts are located in the `scripts/` subdirectory of this skill.

 **Agent Execution Instructions**:
-1. Determine this SKILL.md file's directory path as `SKILL_DIR`
-2. Script path = `${SKILL_DIR}/scripts/<script-name>.ts`
-3. Replace all `${SKILL_DIR}` in this document with the actual path
+1. Determine this SKILL.md file's directory path as `{baseDir}`
+2. Script path = `{baseDir}/scripts/<script-name>.ts`
+3. Replace all `{baseDir}` in this document with the actual path
 4. Resolve `${BUN_X}` runtime: if `bun` installed → `bun`; if `npx` available → `npx -y bun`; else suggest installing bun

 **Script Reference**:
@@ -36,12 +44,15 @@ Check EXTEND.md existence (priority order):
 ```bash
 # macOS, Linux, WSL, Git Bash
 test -f .baoyu-skills/baoyu-post-to-x/EXTEND.md && echo "project"
+test -f "${XDG_CONFIG_HOME:-$HOME/.config}/baoyu-skills/baoyu-post-to-x/EXTEND.md" && echo "xdg"
 test -f "$HOME/.baoyu-skills/baoyu-post-to-x/EXTEND.md" && echo "user"
 ```

 ```powershell
 # PowerShell (Windows)
 if (Test-Path .baoyu-skills/baoyu-post-to-x/EXTEND.md) { "project" }
+$xdg = if ($env:XDG_CONFIG_HOME) { $env:XDG_CONFIG_HOME } else { "$HOME/.config" }
+if (Test-Path "$xdg/baoyu-skills/baoyu-post-to-x/EXTEND.md") { "xdg" }
 if (Test-Path "$HOME/.baoyu-skills/baoyu-post-to-x/EXTEND.md") { "user" }
 ```

@@ -74,7 +85,7 @@ if (Test-Path "$HOME/.baoyu-skills/baoyu-post-to-x/EXTEND.md") { "user" }
 Before first use, suggest running the environment check. User can skip if they prefer.

 ```bash
-${BUN_X} ${SKILL_DIR}/scripts/check-paste-permissions.ts
+${BUN_X} {baseDir}/scripts/check-paste-permissions.ts
 ```

 Checks: Chrome, profile isolation, Bun, Accessibility, clipboard, paste keystroke, Chrome conflicts.
@@ -98,12 +109,16 @@ Checks: Chrome, profile isolation, Bun, Accessibility, clipboard, paste keystrok

 ---

+## Post Type Selection
+
+Unless the user explicitly specifies the post type:
+- **Plain text** + within 10,000 characters → **Regular Post** (Premium members support up to 10,000 characters, non-Premium: 280)
+- **Markdown file** (.md) → **X Article**
+
 ## Regular Posts

-Text + up to 4 images.
-
 ```bash
-${BUN_X} ${SKILL_DIR}/scripts/x-browser.ts "Hello!" --image ./photo.png
+${BUN_X} {baseDir}/scripts/x-browser.ts "Hello!" --image ./photo.png
 ```

 **Parameters**:
@@ -122,7 +137,7 @@ ${BUN_X} ${SKILL_DIR}/scripts/x-browser.ts "Hello!" --image ./photo.png
 Text + video file.

 ```bash
-${BUN_X} ${SKILL_DIR}/scripts/x-video.ts "Check this out!" --video ./clip.mp4
+${BUN_X} {baseDir}/scripts/x-video.ts "Check this out!" --video ./clip.mp4
 ```

 **Parameters**:
@@ -143,7 +158,7 @@ ${BUN_X} ${SKILL_DIR}/scripts/x-video.ts "Check this out!" --video ./clip.mp4
 Quote an existing tweet with comment.

 ```bash
-${BUN_X} ${SKILL_DIR}/scripts/x-quote.ts https://x.com/user/status/123 "Great insight!"
+${BUN_X} {baseDir}/scripts/x-quote.ts https://x.com/user/status/123 "Great insight!"
 ```

 **Parameters**:
@@ -162,8 +177,8 @@ ${BUN_X} ${SKILL_DIR}/scripts/x-quote.ts https://x.com/user/status/123 "Great in
 Long-form Markdown articles (requires X Premium).

 ```bash
-${BUN_X} ${SKILL_DIR}/scripts/x-article.ts article.md
-${BUN_X} ${SKILL_DIR}/scripts/x-article.ts article.md --cover ./cover.jpg
+${BUN_X} {baseDir}/scripts/x-article.ts article.md
+${BUN_X} {baseDir}/scripts/x-article.ts article.md --cover ./cover.jpg
 ```

 **Parameters**:
@@ -12,13 +12,13 @@ Publish Markdown articles to X Articles editor with rich text formatting and ima

 ```bash
 # Publish markdown article (preview mode)
-${BUN_X} ${SKILL_DIR}/scripts/x-article.ts article.md
+${BUN_X} {baseDir}/scripts/x-article.ts article.md

 # With custom cover image
-${BUN_X} ${SKILL_DIR}/scripts/x-article.ts article.md --cover ./cover.jpg
+${BUN_X} {baseDir}/scripts/x-article.ts article.md --cover ./cover.jpg

 # Actually publish
-${BUN_X} ${SKILL_DIR}/scripts/x-article.ts article.md --submit
+${BUN_X} {baseDir}/scripts/x-article.ts article.md --submit
 ```

 ## Markdown Format
@@ -76,13 +76,13 @@ Convert markdown and inspect structure:

 ```bash
 # Get JSON with all metadata
-${BUN_X} ${SKILL_DIR}/scripts/md-to-html.ts article.md
+${BUN_X} {baseDir}/scripts/md-to-html.ts article.md

 # Output HTML only
-${BUN_X} ${SKILL_DIR}/scripts/md-to-html.ts article.md --html-only
+${BUN_X} {baseDir}/scripts/md-to-html.ts article.md --html-only

 # Save HTML to file
-${BUN_X} ${SKILL_DIR}/scripts/md-to-html.ts article.md --save-html /tmp/article.html
+${BUN_X} {baseDir}/scripts/md-to-html.ts article.md --save-html /tmp/article.html
 ```

 JSON output:
@@ -161,7 +161,7 @@ Claude:
 - **No create button**: Ensure X Premium subscription is active
 - **Cover upload fails**: Check file path and format (PNG, JPEG)
 - **Images not inserting**: Verify placeholders exist in pasted content
- **Content not pasting**: Check HTML clipboard: `${BUN_X} ${SKILL_DIR}/scripts/copy-to-clipboard.ts html --file /tmp/test.html`
+- **Content not pasting**: Check HTML clipboard: `${BUN_X} {baseDir}/scripts/copy-to-clipboard.ts html --file /tmp/test.html`

 ## How It Works

@@ -9,20 +9,20 @@ If you prefer step-by-step control:
 ### Step 1: Copy Image to Clipboard

 ```bash
-${BUN_X} ${SKILL_DIR}/scripts/copy-to-clipboard.ts image /path/to/image.png
+${BUN_X} {baseDir}/scripts/copy-to-clipboard.ts image /path/to/image.png
 ```

 ### Step 2: Paste from Clipboard

 ```bash
 # Simple paste to frontmost app
-${BUN_X} ${SKILL_DIR}/scripts/paste-from-clipboard.ts
+${BUN_X} {baseDir}/scripts/paste-from-clipboard.ts

 # Paste to Chrome with retries
-${BUN_X} ${SKILL_DIR}/scripts/paste-from-clipboard.ts --app "Google Chrome" --retries 5
+${BUN_X} {baseDir}/scripts/paste-from-clipboard.ts --app "Google Chrome" --retries 5

 # Quick paste with shorter delay
-${BUN_X} ${SKILL_DIR}/scripts/paste-from-clipboard.ts --delay 200
+${BUN_X} {baseDir}/scripts/paste-from-clipboard.ts --delay 200
 ```

 ### Step 3: Use Playwright MCP (if Chrome session available)
@@ -59,7 +59,7 @@ mcp__playwright__browser_take_screenshot filename="preview.png"
 User: /post-to-x "Hello from Claude!" --image ./screenshot.png

 Claude:
-1. Runs: ${BUN_X} ${SKILL_DIR}/scripts/x-browser.ts "Hello from Claude!" --image ./screenshot.png
+1. Runs: ${BUN_X} {baseDir}/scripts/x-browser.ts "Hello from Claude!" --image ./screenshot.png
 2. Chrome opens with X compose page
 3. Text is typed into editor
 4. Image is copied to clipboard and pasted
@@ -72,7 +72,7 @@ Claude:
 - **Chrome not found**: Set `X_BROWSER_CHROME_PATH` environment variable
 - **Not logged in**: First run opens Chrome - log in manually, cookies are saved
 - **Image paste fails**:
-  - Verify clipboard script: `${BUN_X} ${SKILL_DIR}/scripts/copy-to-clipboard.ts image <path>`
+  - Verify clipboard script: `${BUN_X} {baseDir}/scripts/copy-to-clipboard.ts image <path>`
  - On macOS, grant "Accessibility" permission to Terminal/iTerm in System Settings > Privacy & Security > Accessibility
  - Keep Chrome window visible and in front during paste operations
 - **osascript permission denied**: Grant Terminal accessibility permissions in System Preferences
@@ -4,6 +4,7 @@
    "": {
      "name": "baoyu-post-to-x-scripts",
      "dependencies": {
+        "baoyu-chrome-cdp": "file:./vendor/baoyu-chrome-cdp",
        "front-matter": "^4.0.2",
        "highlight.js": "^11.11.1",
        "marked": "^15.0.6",
@@ -27,6 +28,8 @@

    "bail": ["bail@2.0.2", "", {}, "sha512-0xO6mYd7JB2YesxDKplafRpsiOzPt9V02ddPCLbY1xYGPOX24NTyN50qnUxgCPcSoYMhKpAuBTjQoRZCAkUDRw=="],

+    "baoyu-chrome-cdp": ["baoyu-chrome-cdp@file:vendor/baoyu-chrome-cdp", {}],
+
    "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=="],
@@ -3,6 +3,7 @@
  "private": true,
  "type": "module",
  "dependencies": {
+    "baoyu-chrome-cdp": "file:./vendor/baoyu-chrome-cdp",
    "front-matter": "^4.0.2",
    "highlight.js": "^11.11.1",
    "marked": "^15.0.6",
--- a/Show More
+++ b/Show More
Author	SHA1	Message	Date
Jim Liu 宝玉	d889c04084	chore: release v1.61.0	2026-03-11 23:24:43 -05:00
Jim Liu 宝玉	5276fae6bd	feat(baoyu-post-to-wechat): add multi-account support Support multiple WeChat Official Accounts via EXTEND.md accounts block. Each account gets isolated Chrome profile, credential resolution chain (inline → prefixed env → unprefixed env), and --account CLI arg.	2026-03-11 23:24:02 -05:00
Jim Liu 宝玉	c0941f8089	fix: exclude out/dist/build dirs and bun.lockb from skill release files	2026-03-11 22:55:47 -05:00
Jim Liu 宝玉	42b8b1fc99	fix: use proper MIME types in skill publish to fix ClawhHub rejection	2026-03-11 22:46:06 -05:00
Jim Liu 宝玉	53c788eb3b	chore: release v1.60.0	2026-03-11 22:22:03 -05:00
Jim Liu 宝玉	c79066e96e	fix(baoyu-post-to-x): add missing fs import in x-article	2026-03-11 22:18:11 -05:00
Jim Liu 宝玉	05dba5c320	refactor: publish skills directly from synced vendor	2026-03-11 21:36:19 -05:00
Jim Liu 宝玉	270a9af804	refactor: simplify CLAUDE.md, move detailed docs to docs/ CLAUDE.md reduced from 621 to 76 lines (↓88%). Detailed guidelines moved to on-demand reference files under docs/.	2026-03-11 21:01:59 -05:00
Jim Liu 宝玉	3bba18c1fe	build: commit vendored shared skill packages	2026-03-11 20:45:25 -05:00
Jim Liu 宝玉	069c5dc7d7	refactor: unify skill cdp and release artifacts	2026-03-11 19:38:59 -05:00
Jim Liu 宝玉	00bf946403	支持复用已有 Chrome CDP 实例，修复端口检测顺序问题	2026-03-11 17:24:18 -05:00
Jim Liu 宝玉	1cb54420e0	chore: release v1.59.1	2026-03-11 17:08:33 -05:00
Jim Liu 宝玉	6363bd83e2	refactor(scripts): replace clawhub CLI with local sync-clawhub.mjs	2026-03-11 16:45:57 -05:00
Jim Liu 宝玉	7b8247544d	refactor(baoyu-post-to-weibo): add entry point guard to md-to-html.ts	2026-03-11 16:45:56 -05:00
Jim Liu 宝玉	a9576ebc67	fix(baoyu-post-to-x): remove disable-blink-features Chrome flag	2026-03-11 16:45:55 -05:00
Jim Liu 宝玉	79ca378229	fix(baoyu-translate): improve annotation density and style preset passing - Add short text (<5 sentences) annotation reduction rule to translator's notes - Explicitly pass resolved style preset to 02-prompt.md assembly in all modes	2026-03-11 16:45:51 -05:00
Jim Liu 宝玉	e1a1fe23cb	Merge pull request #77 from jackL1020/claude/claude-md-mmlh0po6953zhhbf-D8rFo docs: Update CLAUDE.md with v1.59.0 features and skill registry	2026-03-11 13:40:27 -05:00
Claude	3d85a7e663	docs: fix marketplace.json path (it's in .claude-plugin/, not root) https://claude.ai/code/session_01DREj1A7KKhNVE1RXjmg9ZH	2026-03-11 03:28:56 +00:00
Claude	10aabb39f8	docs: update CLAUDE.md to reflect v1.59.0 codebase state - Add 8 missing skills to architecture tree (baoyu-post-to-weibo, baoyu-infographic, baoyu-image-gen, baoyu-url-to-markdown, baoyu-format-markdown, baoyu-markdown-to-html, baoyu-translate) - Fix marketplace.json path (root, not .claude-plugin/) - Rename SKILL_DIR → baseDir in Script Directory template (v1.57.0 change) - Add ClawHub/OpenClaw publishing section with sync-clawhub.sh usage - Add openclaw frontmatter template and requirement for new skills - Document baoyu-image-gen batch parallel generation capability - Update Project Overview to mention all AI providers - Expand Key Dependencies and Choosing a Category tables - Add image-gen API key requirement note https://claude.ai/code/session_01DREj1A7KKhNVE1RXjmg9ZH	2026-03-11 03:28:14 +00:00
Jim Liu 宝玉	661c74cce4	docs: add contributor credit to v1.59.0 changelog	2026-03-09 00:58:14 -05:00
Jim Liu 宝玉	82445f2a39	chore: release v1.59.0	2026-03-09 00:55:52 -05:00
Jim Liu 宝玉	df9ce95c46	fix: restore Google as default provider when multiple keys available EXTEND.md default_provider still takes priority over auto-detect. Priority: CLI --provider > EXTEND.md default_provider > auto-detect (Google first).	2026-03-09 00:52:53 -05:00
Jim Liu 宝玉	88b433d565	docs: improve skill documentation clarity - Fix Provider Selection: default to Replicate when multiple keys available (matches code) - Add Replicate column to Quality Presets table (normal→1K, 2k→2K) - Add Replicate aspect ratio behavior (match_input_image when --ref without --ar) - Remove stale Google Imagen reference from Aspect Ratios - Add batch file format example with JSON schema to SKILL.md - Note that batch paths resolve relative to batch file directory - Move batch execution strategy in article-illustrator before numbered steps - Fix translate image-language reminder to use standard markdown syntax with note to match article's own image syntax convention	2026-03-09 00:43:05 -05:00
Jim Liu 宝玉	5acef7151b	feat: add batch parallel image generation and provider-level throttling - Add --batchfile and --jobs flags for multi-image parallel generation with per-provider concurrency control and rate limiting - Refactor main.ts into prepareSingleTask/prepareBatchTasks/runBatchTasks with worker pool pattern and up to 3 retries per image - Fix Replicate provider: use image_input array (nano-banana-pro schema), add match_input_image aspect ratio, add quality-to-resolution mapping - Improve OpenAI error message for missing API key (Codex auth hint) - Expand non-retryable error detection (4xx codes, disabled models) - Add batch config to EXTEND.md schema (max_workers, provider_limits) - Add build-batch.ts for article-illustrator batch workflow integration - Add image-language awareness pass to baoyu-translate Co-authored-by: 敖氏 <aoshi@MacBook-Air.local>	2026-03-09 00:07:45 -05:00
Jim Liu 宝玉	e4d4ec8334	chore: release v1.58.0	2026-03-08 22:30:46 -05:00
Jim Liu 宝玉	4935dc8b1a	fix: surface agent-browser startup errors	2026-03-08 22:25:34 -05:00
Jim Liu 宝玉	c43ed57ffc	Merge pull request #69 from liby/feat/xdg-config-path feat: add XDG config path support for EXTEND.md	2026-03-08 22:19:52 -05:00
Jim Liu 宝玉	d96368492e	Merge pull request #66 from luojiyin1987/fix/harden-command-exec-and-js-escaping fix: harden command execution and JS literal escaping	2026-03-08 22:10:45 -05:00
Jim Liu 宝玉	cfc647fd38	Merge pull request #68 from luojiyin1987/docs/sync-readme-and-claude-deps docs: sync README utility skills and CLAUDE dependency notes	2026-03-08 22:04:40 -05:00
Jim Liu 宝玉	5144335916	chore: release v1.57.0	2026-03-08 19:24:45 -05:00
Jim Liu 宝玉	fa82c3d910	refactor(baoyu-xhs-images): use skill interface instead of direct script invocation for image generation	2026-03-08 19:24:03 -05:00
Jim Liu 宝玉	90730bc551	refactor(baoyu-comic): use skill interface instead of direct script invocation for image generation	2026-03-08 19:24:02 -05:00
Jim Liu 宝玉	154ccfe3ff	refactor: add openclaw metadata and rename SKILL_DIR to baseDir across all skills	2026-03-08 19:22:24 -05:00
Jim Liu 宝玉	93efa5aeb1	refactor(baoyu-comic): add openclaw metadata, baseDir rename, and decouple image skill path	2026-03-08 19:22:19 -05:00
Jim Liu 宝玉	40ccbed74a	refactor(baoyu-danger-x-to-markdown): add openclaw metadata, baseDir rename, and dynamic script path	2026-03-08 19:22:18 -05:00
Jim Liu 宝玉	fbf2bc02c5	refactor(baoyu-danger-gemini-web): add openclaw metadata, baseDir rename, and dynamic script path	2026-03-08 19:22:18 -05:00
Jim Liu 宝玉	a37c80e142	feat: add ClawHub/OpenClaw publishing support	2026-03-08 19:22:13 -05:00
Jim Liu 宝玉	2e68aa64a4	chore: release v1.56.1	2026-03-08 17:42:38 -05:00
Bryan Lee	a702513487	feat: add XDG config path support for EXTEND.md Add $XDG_CONFIG_HOME/baoyu-skills/<skill>/EXTEND.md as second priority path between project-level and legacy $HOME/.baoyu-skills/ paths. Priority order: 1. .baoyu-skills/<skill>/EXTEND.md (project) 2. $XDG_CONFIG_HOME/baoyu-skills/<skill>/EXTEND.md (XDG, new) 3. $HOME/.baoyu-skills/<skill>/EXTEND.md (legacy fallback) Updated: CLAUDE.md template, 16 SKILL.md files, 2 workflow.md references, and 2 extend-config.ts runtime loaders.	2026-03-09 04:54:26 +08:00
Jim Liu 宝玉	059ebc759c	fix(baoyu-post-to-weibo): simplify article image insertion with Backspace-based placeholder deletion	2026-03-08 15:49:54 -05:00
Jim Liu 宝玉	d4a5a34865	chore: release v1.56.0	2026-03-08 14:08:40 -05:00
Jim Liu 宝玉	b3b2f8ea36	feat(baoyu-xhs-images): streamline workflow with smart confirm (6→4 steps)	2026-03-08 14:07:59 -05:00
Jim Liu 宝玉	f19ed00cb2	fix(baoyu-post-to-wechat): improve image upload with file chooser interception	2026-03-08 14:07:55 -05:00
Jim Liu 宝玉	8e58855047	feat(baoyu-article-illustrator): add preset-first selection and categorized style presets	2026-03-08 14:07:53 -05:00
Jim Liu 宝玉	fdfb0e2dfe	chore: release v1.55.0	2026-03-08 13:07:49 -05:00
Jim Liu 宝玉	b4e319ba8f	docs: add credits section to READMEs	2026-03-08 13:07:18 -05:00
Jim Liu 宝玉	691a9c2272	feat(baoyu-xhs-images): add screen-print style and style presets Add screen-print as 11th visual style with poster aesthetic. Add --preset flag for quick style + layout selection with 23 built-in presets (knowledge-card, poster, cinematic, etc.). Update auto-selection and compatibility matrices.	2026-03-08 13:07:14 -05:00
Jim Liu 宝玉	16db99a3ef	feat(baoyu-cover-image): add screen-print rendering and duotone palette Add screen-print as 7th rendering style with halftone textures and limited colors. Add duotone as 10th color palette for dramatic two-color compositions. Update all compatibility matrices and style presets (poster-art, mondo, art-deco, propaganda, cinematic).	2026-03-08 13:07:10 -05:00
Jim Liu 宝玉	adb587439d	feat(baoyu-article-illustrator): add screen-print style and style presets Add screen-print as new style option with poster aesthetic (bold silhouettes, halftone textures, limited colors). Add --preset flag for quick type + style selection (e.g., --preset tech-explainer, --preset opinion-piece).	2026-03-08 13:07:05 -05:00
luojiyin	6b2b28b421	docs: fix CLAUDE dependency statement	2026-03-08 21:21:54 +08:00
luojiyin	0df63c3a0b	docs: add markdown-to-html to README.zh utility skills	2026-03-08 21:21:54 +08:00
luojiyin	7834d632e0	docs: add markdown-to-html to README utility skills	2026-03-08 21:21:47 +08:00
luojiyin	ca9a0a1404	fix: harden wechat agent-browser command and eval handling	2026-03-08 20:34:43 +08:00
luojiyin	366e7b5403	fix: use execFileSync for google curl requests	2026-03-08 20:34:39 +08:00
luojiyin	709e026be1	fix: use spawnSync for autocorrect command	2026-03-08 20:34:35 +08:00
Jim Liu 宝玉	f6cef6bcbb	chore: release v1.54.1	2026-03-07 16:11:24 -06:00
Jim Liu 宝玉	4300e6899c	fix(baoyu-post-to-x): keep browser open for manual publishing	2026-03-07 16:10:19 -06:00
Jim Liu 宝玉	4435366898	docs: add star history to readmes	2026-03-07 16:07:29 -06:00
Jim Liu 宝玉	69cd89184e	chore: release v1.54.0	2026-03-06 23:40:53 -06:00
Jim Liu 宝玉	5771e6d8c5	feat(baoyu-translate): add external glossary files and frontmatter transformation Support glossary_files in EXTEND.md for loading glossaries from external markdown tables or YAML files. Add frontmatter transformation rules to rename source metadata fields with source prefix during translation.	2026-03-06 23:38:27 -06:00
Jim Liu 宝玉	970f5e741a	feat(baoyu-post-to-wechat): default bottom citations for markdown input Enable bottom citations by default for markdown articles. Add --no-cite flag to all posting scripts (wechat-api, wechat-article, md-to-wechat) to optionally disable. WeChat mp links stay inline.	2026-03-06 23:38:23 -06:00
Jim Liu 宝玉	8cea550627	feat(baoyu-markdown-to-html): add --cite option for bottom citations Add optional --cite flag to convert ordinary external links to numbered bottom citations. WeChat links stay inline. Also translate theme and color descriptions from Chinese to English for consistency.	2026-03-06 23:38:19 -06:00
Jim Liu 宝玉	82029160d1	feat(baoyu-format-markdown): improve title and summary generation quality Add style-differentiated title candidates (subversive, solution, suspense, concrete number), prohibited patterns, hook-first principles, and stronger summary guidelines with concrete detail requirements.	2026-03-06 23:38:15 -06:00
Jim Liu 宝玉	46af919634	chore: release v1.53.0	2026-03-06 21:20:22 -06:00
Jim Liu 宝玉	5560db595a	feat(baoyu-url-to-markdown): add HTML snapshot saving and Defuddle fallback pipeline - Save rendered HTML as sibling -captured.html file alongside markdown - Defuddle-first conversion with automatic fallback to legacy Readability/selector extractor - Add rawHtml, conversionMethod, fallbackReason to ConversionResult - Log converter method and fallback reason in CLI output	2026-03-06 21:18:21 -06:00