1---
2name: first-time-setup
3description: First-time setup flow for baoyu-post-to-wechat preferences
4---
5 
6# First-Time Setup
7 
8## Overview
9 
10When no EXTEND.md is found, guide user through preference setup.
11 
12**BLOCKING OPERATION**: This setup MUST complete before ANY other workflow steps. Do NOT:
13- Ask about content or files to publish
14- Ask about themes or publishing methods
15- Proceed to content conversion or publishing
16 
17ONLY ask the questions in this setup flow, save EXTEND.md, then continue.
18 
19## Setup Flow
20 
21```
22No EXTEND.md found
23        |
24        v
25+---------------------+
26| AskUserQuestion     |
27| (all questions)     |
28+---------------------+
29        |
30        v
31+---------------------+
32| Create EXTEND.md    |
33+---------------------+
34        |
35        v
36    Continue to Step 1
37```
38 
39## Questions
40 
41**Language**: Use user's input language or saved language preference.
42 
43Use AskUserQuestion with ALL questions in ONE call:
44 
45### Question 1: Default Theme
46 
47```yaml
48header: "Theme"
49question: "Default theme for article conversion?"
50options:
51  - label: "default (Recommended)"
52    description: "Classic layout - centered title with border, white-on-color H2 (default: blue)"
53  - label: "grace"
54    description: "Elegant - text shadows, rounded cards, refined blockquotes (default: purple)"
55  - label: "simple"
56    description: "Minimal modern - asymmetric rounded corners, clean whitespace (default: green)"
57  - label: "modern"
58    description: "Large rounded corners, pill headings, spacious (default: orange)"
59```
60 
61### Question 2: Default Color
62 
63```yaml
64header: "Color"
65question: "Default color preset? (theme default if not set)"
66options:
67  - label: "Theme default (Recommended)"
68    description: "Use the theme's built-in default color"
69  - label: "blue"
70    description: "#0F4C81 经典蓝"
71  - label: "red"
72    description: "#A93226 中国红"
73  - label: "green"
74    description: "#009874 翡翠绿"
75```
76 
77Note: User can choose "Other" to type any preset name (vermilion, yellow, purple, sky, rose, olive, black, gray, pink, orange) or hex value.
78 
79### Question 3: Default Publishing Method
80 
81```yaml
82header: "Method"
83question: "Default publishing method?"
84options:
85  - label: "api (Recommended)"
86    description: "Fast, requires API credentials (AppID + AppSecret)"
87  - label: "browser"
88    description: "Slow, requires Chrome and login session"
89```
90 
91### Question 4: Default Author
92 
93```yaml
94header: "Author"
95question: "Default author name for articles?"
96options:
97  - label: "No default"
98    description: "Leave empty, specify per article"
99```
100 
101Note: User will likely choose "Other" to type their author name.
102 
103### Question 5: Open Comments
104 
105```yaml
106header: "Comments"
107question: "Enable comments on articles by default?"
108options:
109  - label: "Yes (Recommended)"
110    description: "Allow readers to comment on articles"
111  - label: "No"
112    description: "Disable comments by default"
113```
114 
115### Question 6: Fans-Only Comments
116 
117```yaml
118header: "Fans only"
119question: "Restrict comments to followers only?"
120options:
121  - label: "No (Recommended)"
122    description: "All readers can comment"
123  - label: "Yes"
124    description: "Only followers can comment"
125```
126 
127### Question 7: Save Location
128 
129```yaml
130header: "Save"
131question: "Where to save preferences?"
132options:
133  - label: "Project (Recommended)"
134    description: ".baoyu-skills/ (this project only)"
135  - label: "User"
136    description: "~/.baoyu-skills/ (all projects)"
137```
138 
139## Save Locations
140 
141| Choice | Path | Scope |
142|--------|------|-------|
143| Project | `.baoyu-skills/baoyu-post-to-wechat/EXTEND.md` | Current project |
144| User | `~/.baoyu-skills/baoyu-post-to-wechat/EXTEND.md` | All projects |
145 
146## After Setup
147 
1481. Create directory if needed
1492. Write EXTEND.md
1503. Confirm: "Preferences saved to [path]"
1514. Continue to Step 0 (load the saved preferences)
152 
153## EXTEND.md Template
154 
155### Single Account (Default)
156 
157```md
158default_theme: [default/grace/simple/modern]
159default_color: [preset name, hex, or empty for theme default]
160default_publish_method: [api/browser]
161default_author: [author name or empty]
162need_open_comment: [1/0]
163only_fans_can_comment: [1/0]
164chrome_profile_path:
165```
166 
167### Multi-Account
168 
169```md
170default_theme: [default/grace/simple/modern]
171default_color: [preset name, hex, or empty for theme default]
172 
173accounts:
174  - name: [display name]
175    alias: [short key, e.g. "baoyu"]
176    default: true
177    default_publish_method: [api/browser]
178    default_author: [author name]
179    need_open_comment: [1/0]
180    only_fans_can_comment: [1/0]
181    app_id: [WeChat App ID, optional]
182    app_secret: [WeChat App Secret, optional]
183  - name: [second account name]
184    alias: [short key, e.g. "ai-tools"]
185    default_publish_method: [api/browser]
186    default_author: [author name]
187    need_open_comment: [1/0]
188    only_fans_can_comment: [1/0]
189```
190 
191## Adding More Accounts Later
192 
193After initial setup, users can add accounts by editing EXTEND.md:
194 
1951. Add an `accounts:` block with list items
1962. Move per-account settings (author, publish method, comments) into each account entry
1973. Keep global settings (theme, color) at the top level
1984. Each account needs a unique `alias` (used for CLI `--account` arg and Chrome profile naming)
1995. Set `default: true` on the primary account
200 
201## Modifying Preferences Later
202 
203Users can edit EXTEND.md directly or delete it to trigger setup again.
204