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  - label: "remote-api"
90    description: "Fast, tunnels WeChat API calls through SSH to a server whose IP is on the WeChat allowlist"
91```
92 
93If the user selects `remote-api`, prompt for `remote_publish_host` and (optionally) `remote_publish_user`, `remote_publish_identity_file`. These can also be filled in later by editing EXTEND.md.
94 
95### Question 4: Default Author
96 
97```yaml
98header: "Author"
99question: "Default author name for articles?"
100options:
101  - label: "No default"
102    description: "Leave empty, specify per article"
103```
104 
105Note: User will likely choose "Other" to type their author name.
106 
107### Question 5: Open Comments
108 
109```yaml
110header: "Comments"
111question: "Enable comments on articles by default?"
112options:
113  - label: "Yes (Recommended)"
114    description: "Allow readers to comment on articles"
115  - label: "No"
116    description: "Disable comments by default"
117```
118 
119### Question 6: Fans-Only Comments
120 
121```yaml
122header: "Fans only"
123question: "Restrict comments to followers only?"
124options:
125  - label: "No (Recommended)"
126    description: "All readers can comment"
127  - label: "Yes"
128    description: "Only followers can comment"
129```
130 
131### Question 7: Save Location
132 
133```yaml
134header: "Save"
135question: "Where to save preferences?"
136options:
137  - label: "Project (Recommended)"
138    description: ".baoyu-skills/ (this project only)"
139  - label: "User"
140    description: "~/.baoyu-skills/ (all projects)"
141```
142 
143## Save Locations
144 
145| Choice | Path | Scope |
146|--------|------|-------|
147| Project | `.baoyu-skills/baoyu-post-to-wechat/EXTEND.md` | Current project |
148| User | `~/.baoyu-skills/baoyu-post-to-wechat/EXTEND.md` | All projects |
149 
150## After Setup
151 
1521. Create directory if needed
1532. Write EXTEND.md
1543. Confirm: "Preferences saved to [path]"
1554. Continue to Step 0 (load the saved preferences)
156 
157## EXTEND.md Template
158 
159### Single Account (Default)
160 
161```md
162default_theme: [default/grace/simple/modern]
163default_color: [preset name, hex, or empty for theme default]
164default_publish_method: [api/browser/remote-api]
165default_author: [author name or empty]
166need_open_comment: [1/0]
167only_fans_can_comment: [1/0]
168chrome_profile_path:
169 
170# Remote API publishing — only fill in if default_publish_method is remote-api
171# or you plan to pass --remote on the CLI.
172remote_publish_host:
173remote_publish_user:
174remote_publish_port:
175remote_publish_identity_file:
176remote_publish_known_hosts_file:
177remote_publish_strict_host_key_checking:
178remote_publish_connect_timeout:
179remote_publish_proxy_jump:
180```
181 
182Raw `ssh` / `scp` options are intentionally not supported; only the typed keys above are honored. Authentication is SSH key only.
183 
184### Multi-Account
185 
186```md
187default_theme: [default/grace/simple/modern]
188default_color: [preset name, hex, or empty for theme default]
189 
190accounts:
191  - name: [display name]
192    alias: [short key, e.g. "baoyu"]
193    default: true
194    default_publish_method: [api/browser/remote-api]
195    default_author: [author name]
196    need_open_comment: [1/0]
197    only_fans_can_comment: [1/0]
198    app_id: [WeChat App ID, optional]
199    app_secret: [WeChat App Secret, optional]
200    # Remote API publishing (optional, per-account override of globals)
201    remote_publish_host:
202    remote_publish_user:
203    remote_publish_identity_file:
204  - name: [second account name]
205    alias: [short key, e.g. "ai-tools"]
206    default_publish_method: [api/browser/remote-api]
207    default_author: [author name]
208    need_open_comment: [1/0]
209    only_fans_can_comment: [1/0]
210```
211 
212## Adding More Accounts Later
213 
214After initial setup, users can add accounts by editing EXTEND.md:
215 
2161. Add an `accounts:` block with list items
2172. Move per-account settings (author, publish method, comments) into each account entry
2183. Keep global settings (theme, color) at the top level
2194. Each account needs a unique `alias` (used for CLI `--account` arg and Chrome profile naming)
2205. Set `default: true` on the primary account
221 
222## Modifying Preferences Later
223 
224Users can edit EXTEND.md directly or delete it to trigger setup again.
225