From eb92bdb9dfb821d5ba3635b27d531fc8ba1b9343 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Jim=20Liu=20=E5=AE=9D=E7=8E=89?= <junminliu@gmail.com>
Date: Thu, 22 Jan 2026 11:47:56 -0600
Subject: [PATCH] chore: release v1.15.0

---
 .claude-plugin/marketplace.json               |   2 +-
 CHANGELOG.md                                  |   8 +
 CHANGELOG.zh.md                               |   8 +
 skills/baoyu-xhs-images/SKILL.md              |  61 +++++++-
 .../references/first-time-setup.md            | 140 ++++++++++++++++++
 .../references/preferences-schema.md          | 121 +++++++++++++++
 .../references/watermark-guide.md             |  73 +++++++++
 7 files changed, 407 insertions(+), 6 deletions(-)
 create mode 100644 skills/baoyu-xhs-images/references/first-time-setup.md
 create mode 100644 skills/baoyu-xhs-images/references/preferences-schema.md
 create mode 100644 skills/baoyu-xhs-images/references/watermark-guide.md

diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json
index 75964d9..6da2569 100644
--- a/.claude-plugin/marketplace.json
+++ b/.claude-plugin/marketplace.json
@@ -6,7 +6,7 @@
   },
   "metadata": {
     "description": "Skills shared by Baoyu for improving daily work efficiency",
-    "version": "1.14.0"
+    "version": "1.15.0"
   },
   "plugins": [
     {
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 4b92d02..6562032 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -2,6 +2,14 @@
 
 English | [中文](./CHANGELOG.zh.md)
 
+## 1.15.0 - 2026-01-22
+
+### Features
+- `baoyu-xhs-images`: adds user preferences support via EXTEND.md—configure watermark (content, position, opacity), preferred style, preferred layout, and custom styles. New Step 0 checks for preferences at project (`.baoyu-skills/`) or user (`~/.baoyu-skills/`) level with first-time setup flow.
+
+### Documentation
+- `baoyu-xhs-images`: adds three reference documents—`preferences-schema.md` (YAML schema), `watermark-guide.md` (position and opacity guide), `first-time-setup.md` (setup flow).
+
 ## 1.14.0 - 2026-01-22
 
 ### Fixes
diff --git a/CHANGELOG.zh.md b/CHANGELOG.zh.md
index 31182ad..b3ee663 100644
--- a/CHANGELOG.zh.md
+++ b/CHANGELOG.zh.md
@@ -2,6 +2,14 @@
 
 [English](./CHANGELOG.md) | 中文
 
+## 1.15.0 - 2026-01-22
+
+### 新功能
+- `baoyu-xhs-images`：新增用户偏好设置支持（通过 EXTEND.md 配置）——可设置水印（内容、位置、透明度）、首选风格、首选布局和自定义风格。新增 Step 0 检查项目级（`.baoyu-skills/`）或用户级（`~/.baoyu-skills/`）偏好设置，首次使用时引导设置。
+
+### 文档
+- `baoyu-xhs-images`：新增三个参考文档——`preferences-schema.md`（YAML 配置模式）、`watermark-guide.md`（水印位置和透明度指南）、`first-time-setup.md`（首次设置流程）。
+
 ## 1.14.0 - 2026-01-22
 
 ### 修复
diff --git a/skills/baoyu-xhs-images/SKILL.md b/skills/baoyu-xhs-images/SKILL.md
index 6f49847..2d6a2e6 100644
--- a/skills/baoyu-xhs-images/SKILL.md
+++ b/skills/baoyu-xhs-images/SKILL.md
@@ -127,6 +127,31 @@ Copy all sources with naming `source-{slug}.{ext}`:
 
 ## Workflow
 
+### Step 0: Check Preferences
+
+**Check paths** (priority order):
+1. `.baoyu-skills/baoyu-xhs-images/EXTEND.md` (project)
+2. `~/.baoyu-skills/baoyu-xhs-images/EXTEND.md` (user)
+
+**If preferences found**:
+1. Parse YAML frontmatter
+2. Display current preferences summary:
+   ```
+   Loaded preferences from [path]:
+   - Watermark: [enabled/disabled] "[content]" at [position]
+   - Style: [name] - [description]
+   - Layout: [layout]
+   - Language: [lang]
+   ```
+3. Continue to Step 1
+
+**If NO preferences found**:
+1. Ask user with AskUserQuestion (see `references/first-time-setup.md`)
+2. Create EXTEND.md with user choices
+3. Continue to Step 1
+
+Schema reference: `references/preferences-schema.md`
+
 ### Step 1: Analyze Content → `analysis.md`
 
 Read source content, save it if needed, and perform deep analysis.
@@ -172,6 +197,10 @@ Based on analysis, create three distinct style variants.
 
 **IMPORTANT**: Present ALL options in a single confirmation step using AskUserQuestion. Do NOT interrupt workflow with multiple separate confirmations.
 
+**Prioritize user preferences** (from Step 0):
+- If user has `preferred_style`: Show as first option with "(Your preference)"
+- If user has `preferred_layout`: Show as first option with "(Your preference)"
+
 **Determine which questions to ask**:
 
 | Question | When to Ask |
@@ -188,14 +217,15 @@ Based on analysis, create three distinct style variants.
 
 ```
 Question 1 (Style): Which style variant?
-- A: notion + dense (Recommended) - 知识卡片风格，适合干货
-- B: notion + list - 清爽知识卡片
-- C: minimal + balanced - 简约高端风格
+- User preference: notion + dense (Your preference) - 您的默认设置
+- A: notion + list - AI推荐: 清爽知识卡片
+- B: minimal + balanced - AI推荐: 简约高端风格
 - Custom: 自定义风格描述
 
 Question 2 (Layout) - only if relevant:
+- Your preference: dense (Your preference)
 - Keep variant default (Recommended)
-- sparse / balanced / dense / list / comparison / flow
+- sparse / balanced / list / comparison / flow
 
 Question 3 (Language) - only if mismatch:
 - 中文 (匹配原文)
@@ -217,6 +247,15 @@ With confirmed outline + style + layout:
 2. Generate image using confirmed style and layout
 3. Report progress after each generation
 
+**Watermark Application** (if enabled in preferences):
+Add to each image generation prompt:
+```
+Include a subtle watermark "[content]" positioned at [position]
+with approximately [opacity*100]% visibility. The watermark should
+be legible but not distracting from the main content.
+```
+Reference: `references/watermark-guide.md`
+
 **Image Generation Skill Selection**:
 - Check available image generation skills
 - If multiple skills available, ask user preference
@@ -301,6 +340,9 @@ Detailed templates and guidelines in `references/` directory:
 - `styles/<style>.md` - Detailed style definitions
 - `layouts/<layout>.md` - Detailed layout definitions
 - `base-prompt.md` - Base prompt template
+- `preferences-schema.md` - EXTEND.md YAML schema
+- `watermark-guide.md` - Watermark configuration guide
+- `first-time-setup.md` - First-time setup flow
 
 ## Notes
 
@@ -318,4 +360,13 @@ Custom styles and configurations via EXTEND.md.
 1. `.baoyu-skills/baoyu-xhs-images/EXTEND.md` (project)
 2. `~/.baoyu-skills/baoyu-xhs-images/EXTEND.md` (user)
 
-If found, load before Step 1. Extension content overrides defaults.
+If found, load in Step 0. Extension content overrides defaults.
+
+**Supported preferences**:
+- Watermark settings (content, position, opacity)
+- Preferred style with custom description
+- Preferred layout
+- Custom style definitions
+
+**Schema**: `references/preferences-schema.md`
+**First-time setup**: `references/first-time-setup.md`
diff --git a/skills/baoyu-xhs-images/references/first-time-setup.md b/skills/baoyu-xhs-images/references/first-time-setup.md
new file mode 100644
index 0000000..87bc8c7
--- /dev/null
+++ b/skills/baoyu-xhs-images/references/first-time-setup.md
@@ -0,0 +1,140 @@
+---
+name: first-time-setup
+description: First-time setup flow for baoyu-xhs-images preferences
+---
+
+# First-Time Setup
+
+## Overview
+
+When no EXTEND.md is found, guide user through preference setup.
+
+## Setup Flow
+
+```
+No EXTEND.md found
+        │
+        ▼
+┌─────────────────────┐
+│ AskUserQuestion     │
+│ (all questions)     │
+└─────────────────────┘
+        │
+        ▼
+┌─────────────────────┐
+│ Create EXTEND.md    │
+└─────────────────────┘
+        │
+        ▼
+    Continue to Step 1
+```
+
+## Questions
+
+Use single AskUserQuestion with multiple questions (AskUserQuestion auto-adds "Other" option):
+
+### Question 1: Watermark
+
+```
+header: "Watermark"
+question: "Enable watermark on generated images?"
+options:
+  - label: "Enabled"
+    description: "Add watermark to all images"
+  - label: "Disabled"
+    description: "No watermark (can enable later)"
+```
+
+### Question 2: Watermark Content (if enabled)
+
+```
+header: "Content"
+question: "What text for your watermark?"
+options:
+  - label: "@username"
+    description: "Your XHS handle (replace 'username')"
+  - label: "Custom text"
+    description: "Enter your own text"
+```
+
+### Question 3: Watermark Position (if enabled)
+
+```
+header: "Position"
+question: "Where to place watermark?"
+options:
+  - label: "bottom-right"
+    description: "Lower right corner (most common)"
+  - label: "bottom-left"
+    description: "Lower left corner"
+  - label: "bottom-center"
+    description: "Bottom center"
+  - label: "top-right"
+    description: "Upper right corner"
+```
+
+### Question 4: Preferred Style
+
+```
+header: "Style"
+question: "Default visual style preference?"
+options:
+  - label: "cute"
+    description: "Sweet, adorable - classic XHS aesthetic"
+  - label: "notion"
+    description: "Minimalist hand-drawn, intellectual"
+  - label: "None"
+    description: "Auto-select based on content"
+```
+
+### Question 5: Save Location
+
+```
+header: "Save"
+question: "Where to save preferences?"
+options:
+  - label: "Project"
+    description: ".baoyu-skills/ (this project only)"
+  - label: "User"
+    description: "~/.baoyu-skills/ (all projects)"
+```
+
+## Save Locations
+
+| Choice | Path | Scope |
+|--------|------|-------|
+| Project | `.baoyu-skills/baoyu-xhs-images/EXTEND.md` | Current project |
+| User | `~/.baoyu-skills/baoyu-xhs-images/EXTEND.md` | All projects |
+
+## After Setup
+
+1. Create directory if needed
+2. Write EXTEND.md with frontmatter
+3. Confirm: "Preferences saved to [path]"
+4. Continue to Step 1
+
+## EXTEND.md Template
+
+```yaml
+---
+version: 1
+watermark:
+  enabled: [true/false]
+  content: "[user input]"
+  position: [selected position]
+  opacity: 0.7
+preferred_style:
+  name: [selected style or null]
+  description: ""
+preferred_layout: null
+language: null
+custom_styles: []
+---
+```
+
+## Modifying Preferences Later
+
+Users can edit EXTEND.md directly or run setup again:
+- Delete EXTEND.md to trigger setup
+- Edit YAML frontmatter for quick changes
+- Full schema: `references/preferences-schema.md`
diff --git a/skills/baoyu-xhs-images/references/preferences-schema.md b/skills/baoyu-xhs-images/references/preferences-schema.md
new file mode 100644
index 0000000..359d4d5
--- /dev/null
+++ b/skills/baoyu-xhs-images/references/preferences-schema.md
@@ -0,0 +1,121 @@
+---
+name: preferences-schema
+description: EXTEND.md YAML schema for baoyu-xhs-images user preferences
+---
+
+# Preferences Schema
+
+## Full Schema
+
+```yaml
+---
+version: 1
+
+watermark:
+  enabled: false
+  content: ""
+  position: bottom-right  # bottom-right|bottom-left|bottom-center|top-right
+  opacity: 0.7            # 0.1-1.0
+
+preferred_style:
+  name: null              # Built-in or custom style name
+  description: ""         # Override/notes
+
+preferred_layout: null    # sparse|balanced|dense|list|comparison|flow
+
+language: null            # zh|en|ja|ko|auto
+
+custom_styles:
+  - name: my-style
+    description: "Style description"
+    color_palette:
+      primary: ["#FED7E2", "#FEEBC8"]
+      background: "#FFFAF0"
+      accents: ["#FF69B4", "#FF6B6B"]
+    visual_elements: "Hearts, stars, sparkles"
+    typography: "Rounded, bubbly hand lettering"
+    best_for: "Lifestyle, beauty"
+---
+```
+
+## Field Reference
+
+| Field | Type | Default | Description |
+|-------|------|---------|-------------|
+| `version` | int | 1 | Schema version |
+| `watermark.enabled` | bool | false | Enable watermark |
+| `watermark.content` | string | "" | Watermark text (@username or custom) |
+| `watermark.position` | enum | bottom-right | Position on image |
+| `watermark.opacity` | float | 0.7 | Transparency (0.1-1.0) |
+| `preferred_style.name` | string | null | Style name or null |
+| `preferred_style.description` | string | "" | Custom notes/override |
+| `preferred_layout` | string | null | Layout preference or null |
+| `language` | string | null | Output language (null = auto-detect) |
+| `custom_styles` | array | [] | User-defined styles |
+
+## Position Options
+
+| Value | Description |
+|-------|-------------|
+| `bottom-right` | Lower right corner (default, most common) |
+| `bottom-left` | Lower left corner |
+| `bottom-center` | Bottom center |
+| `top-right` | Upper right corner |
+
+## Custom Style Fields
+
+| Field | Required | Description |
+|-------|----------|-------------|
+| `name` | Yes | Unique style identifier (kebab-case) |
+| `description` | Yes | What the style conveys |
+| `color_palette.primary` | No | Main colors (array) |
+| `color_palette.background` | No | Background color |
+| `color_palette.accents` | No | Accent colors (array) |
+| `visual_elements` | No | Decorative elements |
+| `typography` | No | Font/lettering style |
+| `best_for` | No | Recommended content types |
+
+## Example: Minimal Preferences
+
+```yaml
+---
+version: 1
+watermark:
+  enabled: true
+  content: "@myusername"
+preferred_style:
+  name: notion
+---
+```
+
+## Example: Full Preferences
+
+```yaml
+---
+version: 1
+watermark:
+  enabled: true
+  content: "@myxhsaccount"
+  position: bottom-right
+  opacity: 0.5
+
+preferred_style:
+  name: notion
+  description: "Clean knowledge cards for tech content"
+
+preferred_layout: dense
+
+language: zh
+
+custom_styles:
+  - name: corporate
+    description: "Professional B2B style"
+    color_palette:
+      primary: ["#1E3A5F", "#4A90D9"]
+      background: "#F5F7FA"
+      accents: ["#00B4D8", "#48CAE4"]
+    visual_elements: "Clean lines, subtle gradients, geometric shapes"
+    typography: "Modern sans-serif, professional"
+    best_for: "Business, SaaS, enterprise"
+---
+```
diff --git a/skills/baoyu-xhs-images/references/watermark-guide.md b/skills/baoyu-xhs-images/references/watermark-guide.md
new file mode 100644
index 0000000..dbc9900
--- /dev/null
+++ b/skills/baoyu-xhs-images/references/watermark-guide.md
@@ -0,0 +1,73 @@
+---
+name: watermark-guide
+description: Watermark configuration guide for baoyu-xhs-images
+---
+
+# Watermark Guide
+
+## Position Diagram
+
+```
+┌─────────────────────────────┐
+│                  [top-right]│
+│                             │
+│                             │
+│         IMAGE CONTENT       │
+│                             │
+│                             │
+│[bottom-left][bottom-center][bottom-right]│
+└─────────────────────────────┘
+```
+
+## Position Recommendations
+
+| Position | Best For | Avoid When |
+|----------|----------|------------|
+| `bottom-right` | Default choice, most common | Key info in bottom-right |
+| `bottom-left` | Right-heavy layouts | Key info in bottom-left |
+| `bottom-center` | Centered designs | Text-heavy bottom area |
+| `top-right` | Bottom-heavy content | Title/header in top-right |
+
+## Opacity Examples
+
+| Opacity | Visual Effect | Use Case |
+|---------|---------------|----------|
+| 0.3 | Very subtle, barely visible | Clean aesthetic priority |
+| 0.5 | Balanced, noticeable but not distracting | Default recommendation |
+| 0.7 | Clearly visible | Brand recognition priority |
+| 0.9 | Strong presence | Anti-copy protection |
+
+## Content Format
+
+| Format | Example | Style |
+|--------|---------|-------|
+| Handle | `@username` | Most common for XHS |
+| Text | `MyBrand` | Simple branding |
+| Chinese | `小红书:用户名` | Platform specific |
+| URL | `myblog.com` | Cross-platform |
+
+## Best Practices
+
+1. **Consistency**: Use same watermark across all images in series
+2. **Legibility**: Ensure watermark readable on both light/dark areas
+3. **Size**: Keep subtle - should not distract from content
+4. **Contrast**: Opacity may need adjustment per image background
+
+## Prompt Integration
+
+When watermark is enabled, add to image generation prompt:
+
+```
+Include a subtle watermark "[content]" positioned at [position]
+with approximately [opacity*100]% visibility. The watermark should
+be legible but not distracting from the main content.
+```
+
+## Common Issues
+
+| Issue | Solution |
+|-------|----------|
+| Watermark invisible | Increase opacity or adjust position |
+| Watermark too prominent | Decrease opacity (0.3-0.5) |
+| Watermark overlaps content | Change position |
+| Inconsistent across images | Use session ID for consistency |