# Onboard（首次设置）

**触发条件**：
- Step 1 发现 `style.yaml` 不存在
- 用户明确说"重新设置风格"、"修改配置"

## Phase 1: 收集信息（交互式问答）

通过对话收集以下信息，**不要一次性列出所有问题**——一轮问 1-2 个，像聊天一样：

**必问**（缺了无法运行）：

| 顺序 | 问题 | 对应字段 | 示例引导 |
|------|------|---------|---------|
| 1 | 你的公众号叫什么名字？主要做什么方向？ | `name` + `industry` | "比如'零号AI'，做科技/互联网" |
| 2 | 主要写哪几个方向的内容？ | `topics` | "比如 AI、产品设计、效率工具" |
| 3 | 你希望文章是什么风格？ | `tone` | "专业严肃？轻松有趣？毒舌犀利？像朋友聊天？" |

**选问**（有默认值，用户不答就用默认）：

| 问题 | 对应字段 | 默认值 |
|------|---------|-------|
| 目标读者是谁？ | `target_audience` | 从 industry 推断 |
| 用什么人称写？ | `voice` | "第一人称，像一个懂行的朋友" |
| 有没有绝对不能出现的词或话题？ | `blacklist` | 空 |
| 有没有想参考的公众号？ | `reference_accounts` | 空 |
| 署名写什么？ | `author` | name 字段值 |
| 偏好哪种写作人格？ | `writing_persona` | 从 tone 推断（见映射） |

**tone → persona 自动映射**（用户不选时的默认推断）：
- 轻松/有趣/朋友/聊天 → `midnight-friend`
- 温暖/共鸣/故事/治愈 → `warm-editor`
- 专业/分析/深度/行业 → `industry-observer`
- 犀利/锐评/观点/新闻 → `sharp-journalist`
- 严谨/数据/研究/财经 → `cold-analyst`
| 偏好哪种排版风格？（可运行 `gallery` 命令预览全部 16 个主题） | `theme` | "professional-clean" |
| 封面风格偏好？ | `cover_style` | 从 industry 推断 |
| 有没有固定封面模板？ | `cover_template` | 不设置 |

**写作人格说明**（`personas/` 目录下有详细定义）：

| 人格 | 适合 | 朱雀实测 | 一句话描述 |
|------|------|---------|----------|
| `midnight-friend` | 个人号/自媒体 | **39% 人工** | 像深夜给朋友发微信，极度口语化 |
| `warm-editor` | 生活/文化/情感 | 10% 人工 | 故事驱动，温暖共鸣 |
| `industry-observer` | 行业媒体/分析 | 10% 人工 | 克制的专业分析，偶尔锐利 |
| `sharp-journalist` | 新闻/评论 | 0% 人工（需编辑） | 短句利落，观点鲜明 |
| `cold-analyst` | 财经/投研 | 0% 人工（需编辑） | 严谨数据，专业措辞 |

**快捷路径**：
- 如果用户直接甩了一段描述（如"我做科技自媒体，风格像虎嗅"），直接从中提取所有能提取的字段，只补问缺的
- 如果用户说"不设置"、"用默认的"、"直接写" → 复制 `{skill_dir}/style.example.yaml` 为 `style.yaml`，跳过所有问答

```
参考: {skill_dir}/references/style-template.md（字段说明和可用主题列表）
```

## Phase 2: 生成配置

用收集到的信息自动生成 `{skill_dir}/style.yaml`。

同时确保以下文件/目录存在（不存在则创建）：
- `{skill_dir}/history.yaml` → 初始化为 `articles: []`
- `{skill_dir}/corpus/` → 空目录
- `{skill_dir}/lessons/` → 空目录

生成完成后，**把 style.yaml 的内容展示给用户看一遍**，问"这个配置 OK 吗？有什么要改的？"。用户确认后继续。

## Phase 3: Playbook（可选，不阻断）

问用户："你有没有之前写过的公众号文章？如果有 20 篇以上，我可以从中学习你的写作风格，以后写出来的文章会更像你。"

- **用户有语料** → 告知将文章（.md 或 .txt）放入 `{skill_dir}/corpus/`，然后运行：
  ```bash
  python3 {skill_dir}/scripts/build_playbook.py
  ```
  按脚本输出逐批阅读文章，提取风格特征，生成 `playbook.md`。

- **用户没有语料 / 暂时不想弄** → 完全正常，跳过。告知用户："没问题，先用通用风格写，后续你可以随时说'学习我的修改'来让我逐渐适应你的风格。"

## Phase 4: 试跑

Onboard 完成后，问用户："配置好了，要不要现在试写一篇？"

- **是** → 回到 Step 1，执行完整流程
- **否** → 告知用户下次如何触发："下次直接说'写一篇公众号文章'就行"