chore: release v1.31.0

.claude-plugin/marketplace.json

@@ -6,7 +6,7 @@
   },
   "metadata": {
     "description": "Skills shared by Baoyu for improving daily work efficiency",
-    "version": "1.30.2"
+    "version": "1.31.0"
   },
   "plugins": [
     {

CHANGELOG.md

@@ -2,6 +2,16 @@
 
 English | [中文](./CHANGELOG.zh.md)
 
+## 1.31.0 - 2026-02-07
+
+### Features
+- `baoyu-post-to-wechat`: add comment control settings (`need_open_comment`, `only_fans_can_comment`); add cover image fallback chain (CLI → frontmatter → `imgs/cover.png` → first inline image); add author resolution priority; add first-time setup flow with EXTEND.md preferences.
+
+## 1.30.3 - 2026-02-06
+
+### Refactor
+- `baoyu-article-illustrator`: optimize SKILL.md from 197 to 150 lines (24% reduction); apply progressive disclosure pattern with concise overview and detailed references.
+
 ## 1.30.2 - 2026-02-06
 
 ### Refactor

CHANGELOG.zh.md

@@ -2,6 +2,16 @@
 
 [English](./CHANGELOG.md) | 中文
 
+## 1.31.0 - 2026-02-07
+
+### 新功能
+- `baoyu-post-to-wechat`：新增评论控制设置（`need_open_comment`、`only_fans_can_comment`）；新增封面图片回退链（CLI → frontmatter → `imgs/cover.png` → 首张内联图片）；新增作者优先级解析；新增首次使用引导流程和 EXTEND.md 偏好配置。
+
+## 1.30.3 - 2026-02-06
+
+### 重构
+- `baoyu-article-illustrator`：优化 SKILL.md 从 197 行精简至 150 行（减少 24%）；采用渐进式披露模式，主文件提供简洁概览，详细内容通过引用文件提供。
+
 ## 1.30.2 - 2026-02-06
 
 ### 重构

skills/baoyu-article-illustrator/SKILL.md

@@ -11,55 +11,34 @@ Analyze articles, identify illustration positions, generate images with Type ×
 
 | Dimension | Controls | Examples |
 |-----------|----------|----------|
-| **Type** | Information structure, layout | infographic, scene, flowchart, comparison, framework, timeline |
-| **Style** | Visual aesthetics, mood | notion, warm, minimal, blueprint, watercolor, elegant |
+| **Type** | Information structure | infographic, scene, flowchart, comparison, framework, timeline |
+| **Style** | Visual aesthetics | notion, warm, minimal, blueprint, watercolor, elegant |
 
-Type × Style can be freely combined. Example: `--type infographic --style blueprint`
+Combine freely: `--type infographic --style blueprint`
 
-## Illustration Purpose
-
-Auto-detected during content analysis. Influences type/style recommendations.
-
-| Purpose | Description | Best Types |
-|---------|-------------|------------|
-| **information** | Help understand abstract concepts | infographic, flowchart, comparison |
-| **visualization** | Turn abstract ideas into concrete visuals | framework, comparison, infographic |
-| **imagination** | Create atmosphere, spark imagination | scene, timeline |
-
-## Type Gallery
+## Types
 
 | Type | Best For |
 |------|----------|
-| `infographic` | Data, metrics, technical articles |
-| `scene` | Narratives, personal stories, emotional content |
-| `flowchart` | Tutorials, workflows, processes |
-| `comparison` | Side-by-side, before/after, options |
-| `framework` | Methodologies, models, architecture |
-| `timeline` | History, progress, evolution |
+| `infographic` | Data, metrics, technical |
+| `scene` | Narratives, emotional |
+| `flowchart` | Processes, workflows |
+| `comparison` | Side-by-side, options |
+| `framework` | Models, architecture |
+| `timeline` | History, evolution |
 
 ## Styles
 
-See [references/styles.md](references/styles.md) for:
-- **Core Styles**: Simplified tier for quick selection (vector, minimal-flat, sci-fi, hand-drawn, editorial, scene)
-- **Style Gallery**: Full 20+ style options with descriptions
-- **Auto Selection**: Content signals → Type/Style recommendations
-- **Compatibility Matrix**: Type × Style combinations
+See [references/styles.md](references/styles.md) for Core Styles, full gallery, and Type × Style compatibility.
 
 ## Workflow
 
 ```
-Progress:
-- [ ] Step 1: Pre-check
-  - [ ] 1.5 Load preferences (EXTEND.md) ⛔ BLOCKING
-  - [ ] 1.0 Reference images ⚠️ (if provided)
-  - [ ] 1.2-1.4 Config questions (1 AskUserQuestion, max 4 Qs)
-- [ ] Step 2: Setup & Analyze
-- [ ] Step 3: Confirm Settings (1 AskUserQuestion, max 4 Qs)
-  - [ ] Q1: Type ⚠️
-  - [ ] Q2: Density ⚠️ MUST ASK
-  - [ ] Q3: Style ⚠️
-- [ ] Step 4: Generate Outline
-- [ ] Step 5: Generate Images
+- [ ] Step 1: Pre-check (EXTEND.md, references, config)
+- [ ] Step 2: Analyze content
+- [ ] Step 3: Confirm settings (AskUserQuestion)
+- [ ] Step 4: Generate outline
+- [ ] Step 5: Generate images
 - [ ] Step 6: Finalize
 ```
 
@@ -67,8 +46,6 @@ Progress:
 
 **1.5 Load Preferences (EXTEND.md) ⛔ BLOCKING**
 
-**CRITICAL**: If EXTEND.md not found, MUST complete first-time setup before ANY other steps.
-
 ```bash
 test -f .baoyu-skills/baoyu-article-illustrator/EXTEND.md && echo "project"
 test -f "$HOME/.baoyu-skills/baoyu-article-illustrator/EXTEND.md" && echo "user"
@@ -76,122 +53,98 @@ test -f "$HOME/.baoyu-skills/baoyu-article-illustrator/EXTEND.md" && echo "user"
 
 | Result | Action |
 |--------|--------|
-| Found | Read, parse, display summary → Continue |
-| Not found | ⛔ Run first-time setup ([references/config/first-time-setup.md](references/config/first-time-setup.md)) |
-
-**Supports**: Watermark | Preferred type/style | Custom styles | Language | Output directory
-
-**1.0-1.4**: Handle reference images, determine input type, ask config questions.
+| Found | Read, parse, display summary |
+| Not found | ⛔ Run [first-time-setup](references/config/first-time-setup.md) |
 
 Full procedures: [references/workflow.md](references/workflow.md#step-1-pre-check)
 
----
+### Step 2: Analyze
 
-### Step 2: Setup & Analyze
-
-| Analysis | Description |
-|----------|-------------|
+| Analysis | Output |
+|----------|--------|
 | Content type | Technical / Tutorial / Methodology / Narrative |
-| Illustration purpose | information / visualization / imagination |
-| Core arguments | 2-5 main points to visualize |
-| Visual opportunities | Positions where illustrations add value |
+| Purpose | information / visualization / imagination |
+| Core arguments | 2-5 main points |
+| Positions | Where illustrations add value |
 
-**CRITICAL**: If article uses metaphors, do NOT illustrate literally. Visualize the **underlying concept**.
+**CRITICAL**: Metaphors → visualize underlying concept, NOT literal image.
 
 Full procedures: [references/workflow.md](references/workflow.md#step-2-setup--analyze)
 
----
-
 ### Step 3: Confirm Settings ⚠️
 
-**Do NOT skip.** Use ONE AskUserQuestion call with max 4 questions. **Q1, Q2, Q3 are ALL REQUIRED.**
+**ONE AskUserQuestion, max 4 Qs. Q1-Q3 REQUIRED.**
 
-| Question | Options |
-|----------|---------|
-| **Q1: Type** ⚠️ | [Recommended], infographic, scene, flowchart, comparison, framework, timeline, mixed |
-| **Q2: Density** ⚠️ | minimal (1-2), balanced (3-5), per-section (Recommended), rich (6+) |
-| **Q3: Style** ⚠️ | [Recommended], minimal-flat, sci-fi, hand-drawn, editorial, scene, Other |
-| **Q4: Language** | When article language ≠ EXTEND.md setting |
+| Q | Options |
+|---|---------|
+| **Q1: Type** | [Recommended], infographic, scene, flowchart, comparison, framework, timeline, mixed |
+| **Q2: Density** | minimal (1-2), balanced (3-5), per-section (Recommended), rich (6+) |
+| **Q3: Style** | [Recommended], minimal-flat, sci-fi, hand-drawn, editorial, scene, Other |
+| Q4: Language | When article language ≠ EXTEND.md setting |
 
 Full procedures: [references/workflow.md](references/workflow.md#step-3-confirm-settings-)
 
----
-
 ### Step 4: Generate Outline
 
-Save as `outline.md` with frontmatter (type, density, style, image_count, references) and illustration entries:
+Save `outline.md` with frontmatter (type, density, style, image_count) and entries:
 
 ```yaml
 ## Illustration 1
-**Position**: [section] / [paragraph]
-**Purpose**: [why this helps]
-**Visual Content**: [what to show]
+**Position**: [section/paragraph]
+**Purpose**: [why]
+**Visual Content**: [what]
 **Filename**: 01-infographic-concept-name.png
 ```
 
 Full template: [references/workflow.md](references/workflow.md#step-4-generate-outline)
 
----
-
 ### Step 5: Generate Images
 
-1. **Create Prompts**: Follow [references/prompt-construction.md](references/prompt-construction.md)
-2. **Select Generation Skill**: Check available skills
-3. **Process References**: Handle `direct`/`style`/`palette` usage
-4. **Apply Watermark**: If enabled in EXTEND.md
-5. **Generate**: Sequential, retry once on failure
+1. Create prompts per [references/prompt-construction.md](references/prompt-construction.md)
+2. Select generation skill from available skills
+3. Process references (`direct`/`style`/`palette`)
+4. Apply watermark if EXTEND.md enabled
+5. Generate sequentially, retry once on failure
 
 Full procedures: [references/workflow.md](references/workflow.md#step-5-generate-images)
 
----
-
 ### Step 6: Finalize
 
-**Update Article**: Insert `![description](path/NN-{type}-{slug}.png)` after corresponding paragraphs.
+Insert `![description](path/NN-{type}-{slug}.png)` after paragraphs.
 
-**Output Summary**:
 ```
 Article Illustration Complete!
 Article: [path] | Type: [type] | Density: [level] | Style: [style]
 Images: X/N generated
-Positions:
-- 01-xxx.png → After "[Section]"
 ```
 
----
-
 ## Output Directory
 
 ```
 illustrations/{topic-slug}/
 ├── source-{slug}.{ext}
-├── references/                    # Only if references provided
-│   └── NN-ref-{slug}.png
+├── references/           # if provided
 ├── outline.md
 ├── prompts/
-│   └── illustration-{slug}.md
 └── NN-{type}-{slug}.png
 ```
 
-**Slug**: 2-4 word topic in kebab-case.
-**Conflict**: Append `-YYYYMMDD-HHMMSS` if exists.
+**Slug**: 2-4 words, kebab-case. **Conflict**: append `-YYYYMMDD-HHMMSS`.
 
 ## Modification
 
 | Action | Steps |
 |--------|-------|
-| **Edit** | Update prompt file FIRST → Regenerate → Update reference |
-| **Add** | Identify position → Create prompt → Generate → Update outline → Insert |
-| **Delete** | Delete files → Remove reference → Update outline |
+| Edit | Update prompt → Regenerate → Update reference |
+| Add | Position → Prompt → Generate → Update outline → Insert |
+| Delete | Delete files → Remove reference → Update outline |
 
 ## References
 
 | File | Content |
 |------|---------|
-| [references/workflow.md](references/workflow.md) | Detailed workflow procedures |
-| [references/usage.md](references/usage.md) | Command syntax and options |
-| [references/styles.md](references/styles.md) | Style gallery & compatibility |
+| [references/workflow.md](references/workflow.md) | Detailed procedures |
+| [references/usage.md](references/usage.md) | Command syntax |
+| [references/styles.md](references/styles.md) | Style gallery |
 | [references/prompt-construction.md](references/prompt-construction.md) | Prompt templates |
-| `references/styles/<style>.md` | Full style specifications |
-| `references/config/preferences-schema.md` | EXTEND.md schema |
-| `references/config/first-time-setup.md` | First-time setup flow |
+| [references/config/first-time-setup.md](references/config/first-time-setup.md) | First-time setup |

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

@@ -44,10 +44,37 @@ test -f "$HOME/.baoyu-skills/baoyu-post-to-wechat/EXTEND.md" && echo "user"
 ├───────────┼───────────────────────────────────────────────────────────────────────────┤
 │ Found     │ Read, parse, apply settings                                               │
 ├───────────┼───────────────────────────────────────────────────────────────────────────┤
-│ Not found │ Use defaults                                                              │
+│ Not found │ Run first-time setup ([references/config/first-time-setup.md](references/config/first-time-setup.md)) → Save → Continue │
 └───────────┴───────────────────────────────────────────────────────────────────────────┘
 
-**EXTEND.md Supports**: Default theme | Default publishing method (api/browser) | Default author | Chrome profile path
+**EXTEND.md Supports**: Default theme | Default publishing method (api/browser) | Default author | Default open-comment switch | Default fans-only-comment switch | Chrome profile path
+
+First-time setup: [references/config/first-time-setup.md](references/config/first-time-setup.md)
+
+**Minimum supported keys** (case-insensitive, accept `1/0` or `true/false`):
+
+| Key | Default | Mapping |
+|-----|---------|---------|
+| `default_author` | empty | Fallback for `author` when CLI/frontmatter not provided |
+| `need_open_comment` | `1` | `articles[].need_open_comment` in `draft/add` request |
+| `only_fans_can_comment` | `0` | `articles[].only_fans_can_comment` in `draft/add` request |
+
+**Recommended EXTEND.md example**:
+
+```md
+default_theme: default
+default_publish_method: api
+default_author: 宝玉
+need_open_comment: 1
+only_fans_can_comment: 0
+chrome_profile_path: /path/to/chrome/profile
+```
+
+**Value priority**:
+1. CLI arguments
+2. Frontmatter
+3. EXTEND.md
+4. Skill defaults
 
 ## Image-Text Posting (图文)
 
@@ -70,7 +97,7 @@ Publishing Progress:
 - [ ] Step 1: Determine input type
 - [ ] Step 2: Check markdown-to-html skill
 - [ ] Step 3: Convert to HTML
-- [ ] Step 4: Validate metadata (title, summary)
+- [ ] Step 4: Validate metadata (title, summary, cover)
 - [ ] Step 5: Select method and configure credentials
 - [ ] Step 6: Publish to WeChat
 - [ ] Step 7: Report completion
@@ -80,6 +107,13 @@ Publishing Progress:
 
 Check and load EXTEND.md settings (see Preferences section above).
 
+**CRITICAL**: If not found, complete first-time setup BEFORE any other steps or questions.
+
+Resolve and store these defaults for later steps:
+- `default_author`
+- `need_open_comment` (default `1`)
+- `only_fans_can_comment` (default `0`)
+
 ### Step 1: Determine Input Type
 
 | Input Type | Detection | Action |
@@ -162,11 +196,19 @@ Check extracted metadata from Step 3 (or HTML meta tags if direct HTML input).
 |-------|------------|
 | Title | Prompt: "Enter title, or press Enter to auto-generate from content" |
 | Summary | Prompt: "Enter summary, or press Enter to auto-generate (recommended for SEO)" |
+| Author | Use fallback chain: CLI `--author` → frontmatter `author` → EXTEND.md `default_author` |
 
 **Auto-Generation Logic**:
 - **Title**: First H1/H2 heading, or first sentence
 - **Summary**: First paragraph, truncated to 120 characters
 
+**Cover Image Check** (required for `article_type=news`):
+1. Use CLI `--cover` if provided.
+2. Else use frontmatter (`featureImage`, `coverImage`, `cover`, `image`).
+3. Else check article directory default path: `imgs/cover.png`.
+4. Else fallback to first inline content image.
+5. If still missing, stop and request a cover image before publishing.
+
 ### Step 5: Select Publishing Method and Configure
 
 **Ask publishing method** (unless specified in EXTEND.md or CLI):
@@ -213,9 +255,20 @@ WECHAT_APP_SECRET=<user_input>
 **API method**:
 
 ```bash
-npx -y bun ${SKILL_DIR}/scripts/wechat-api.ts <html_file> [--title <title>] [--summary <summary>]
+npx -y bun ${SKILL_DIR}/scripts/wechat-api.ts <html_file> [--title <title>] [--summary <summary>] [--author <author>] [--cover <cover_path>]
 ```
 
+**`draft/add` payload rules**:
+- Use endpoint: `POST https://api.weixin.qq.com/cgi-bin/draft/add?access_token=ACCESS_TOKEN`
+- `article_type`: `news` (default) or `newspic`
+- For `news`, include `thumb_media_id` (cover is required)
+- Always resolve and send:
+  - `need_open_comment` (default `1`)
+  - `only_fans_can_comment` (default `0`)
+- `author` resolution: CLI `--author` → frontmatter `author` → EXTEND.md `default_author`
+
+If script parameters do not expose the two comment fields, still ensure final API request body includes resolved values.
+
 **Browser method**:
 
 ```bash
@@ -237,6 +290,7 @@ Article:
 • Title: [title]
 • Summary: [summary]
 • Images: [N] inline images
+• Comments: [open/closed], [fans-only/all users]
 
 Result:
 ✓ Draft saved to WeChat Official Account
@@ -289,6 +343,8 @@ Files created:
 | Multiple images | ✓ (up to 9) | ✓ (inline) | ✓ (inline) |
 | Themes | ✗ | ✓ | ✓ |
 | Auto-generate metadata | ✗ | ✓ | ✓ |
+| Default cover fallback (`imgs/cover.png`) | ✗ | ✓ | ✗ |
+| Comment control (`need_open_comment`, `only_fans_can_comment`) | ✗ | ✓ | ✗ |
 | Requires Chrome | ✓ | ✗ | ✓ |
 | Requires API credentials | ✗ | ✓ | ✗ |
 | Speed | Medium | Fast | Slow |
@@ -322,6 +378,8 @@ Files created:
 | Not logged in (browser) | First run opens browser - scan QR to log in |
 | Chrome not found | Set `WECHAT_BROWSER_CHROME_PATH` env var |
 | Title/summary missing | Use auto-generation or provide manually |
+| No cover image | Add frontmatter cover or place `imgs/cover.png` in article directory |
+| Wrong comment defaults | Check `EXTEND.md` keys `need_open_comment` and `only_fans_can_comment` |
 | Paste fails | Check system clipboard permissions |
 
 ## Extension Support

skills/baoyu-post-to-wechat/references/config/first-time-setup.md

@@ -0,0 +1,146 @@
+---
+name: first-time-setup
+description: First-time setup flow for baoyu-post-to-wechat preferences
+---
+
+# First-Time Setup
+
+## Overview
+
+When no EXTEND.md is found, guide user through preference setup.
+
+**BLOCKING OPERATION**: This setup MUST complete before ANY other workflow steps. Do NOT:
+- Ask about content or files to publish
+- Ask about themes or publishing methods
+- Proceed to content conversion or publishing
+
+ONLY ask the questions in this setup flow, save EXTEND.md, then continue.
+
+## Setup Flow
+
+```
+No EXTEND.md found
+        |
+        v
++---------------------+
+| AskUserQuestion     |
+| (all questions)     |
++---------------------+
+        |
+        v
++---------------------+
+| Create EXTEND.md    |
++---------------------+
+        |
+        v
+    Continue to Step 1
+```
+
+## Questions
+
+**Language**: Use user's input language or saved language preference.
+
+Use AskUserQuestion with ALL questions in ONE call:
+
+### Question 1: Default Theme
+
+```yaml
+header: "Theme"
+question: "Default theme for article conversion?"
+options:
+  - label: "default (Recommended)"
+    description: "Classic layout - centered title with border, white-on-color H2"
+  - label: "grace"
+    description: "Elegant - text shadows, rounded cards, refined blockquotes"
+  - label: "simple"
+    description: "Minimal modern - asymmetric rounded corners, clean whitespace"
+```
+
+### Question 2: Default Publishing Method
+
+```yaml
+header: "Method"
+question: "Default publishing method?"
+options:
+  - label: "api (Recommended)"
+    description: "Fast, requires API credentials (AppID + AppSecret)"
+  - label: "browser"
+    description: "Slow, requires Chrome and login session"
+```
+
+### Question 3: Default Author
+
+```yaml
+header: "Author"
+question: "Default author name for articles?"
+options:
+  - label: "No default"
+    description: "Leave empty, specify per article"
+```
+
+Note: User will likely choose "Other" to type their author name.
+
+### Question 4: Open Comments
+
+```yaml
+header: "Comments"
+question: "Enable comments on articles by default?"
+options:
+  - label: "Yes (Recommended)"
+    description: "Allow readers to comment on articles"
+  - label: "No"
+    description: "Disable comments by default"
+```
+
+### Question 5: Fans-Only Comments
+
+```yaml
+header: "Fans only"
+question: "Restrict comments to followers only?"
+options:
+  - label: "No (Recommended)"
+    description: "All readers can comment"
+  - label: "Yes"
+    description: "Only followers can comment"
+```
+
+### Question 6: Save Location
+
+```yaml
+header: "Save"
+question: "Where to save preferences?"
+options:
+  - label: "Project (Recommended)"
+    description: ".baoyu-skills/ (this project only)"
+  - label: "User"
+    description: "~/.baoyu-skills/ (all projects)"
+```
+
+## Save Locations
+
+| Choice | Path | Scope |
+|--------|------|-------|
+| Project | `.baoyu-skills/baoyu-post-to-wechat/EXTEND.md` | Current project |
+| User | `~/.baoyu-skills/baoyu-post-to-wechat/EXTEND.md` | All projects |
+
+## After Setup
+
+1. Create directory if needed
+2. Write EXTEND.md
+3. Confirm: "Preferences saved to [path]"
+4. Continue to Step 0 (load the saved preferences)
+
+## EXTEND.md Template
+
+```md
+default_theme: [default/grace/simple]
+default_publish_method: [api/browser]
+default_author: [author name or empty]
+need_open_comment: [1/0]
+only_fans_can_comment: [1/0]
+chrome_profile_path:
+```
+
+## Modifying Preferences Later
+
+Users can edit EXTEND.md directly or delete it to trigger setup again.