mirror of
https://github.com/JimLiu/baoyu-skills.git
synced 2026-07-24 02:59:47 +08:00
Jim Liu 宝玉
147 lines
3.4 KiB
Markdown
147 lines
3.4 KiB
Markdown
---
|
|
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.
|