# 首次安装引导

这份说明用于技能安装后的第一步，引导用户先立命主小档，再进入正式问卦或每日运势。

## 安装后第一句话

推荐直接使用下面这段话，作为首次启用时的开场：

`在正式起卦前，我先替你立一个命主小档。这样以后问卦、续问与每日运势都会更连贯，也更有一份安定的仪式感。若你愿意，先告诉我两项：农历生日与性别；若还记得出生时辰，也可一并补上。若你不想提供，我们也可以直接起卦。`

## 推荐的首轮追问次第

1. 先问用户是否愿意登记命主资料。
2. 若愿意，先收 `农历生日`。
3. 再收 `性别`。
4. 最后问是否愿意补 `出生时辰`。
5. 如果用户还想看每日运势，再补 `每日时间` 与 `时区`。

## 最简对话版本

可依次这样问：

- `在正式起卦前，你若愿意，我先替你记两项命主资料：农历生日和性别。这样后面问卦与每日运势会更连贯一些。你想先登记吗？`
- `若愿意，先告诉我你的农历生日。`
- `再告诉我你的性别即可；如果你愿意补出生时辰，也可以一并说。`
- `如果你还想设每日运势，我再替你定一个时间。你希望每天几点起卦？`

## 自动初始化脚本

仓库已提供一个可交互执行的初始化脚本：

```bash
python scripts/init_profile.py
```

如果刚安装完成，也会自动显示一段安装后提示；你也可以手动再次查看：

```bash
npm run show-onboarding
```

它会依次询问：

- 农历生日
- 性别
- 出生时辰（可选）
- 是否设置每日运势
- 每日时间与时区
- 初始化完成后，是否继续配置每日运势 cron

## 非交互用法

若要直接写入资料，也可以一次性传参：

```bash
python scripts/init_profile.py \
  --lunar-birthday "农历二零零一年三月初八" \
  --gender "女" \
  --birth-hour "巳时" \
  --daily-time "07:30" \
  --timezone "Asia/Shanghai"
```

如果暂时只想登记命主资料，不设置每日运势：

```bash
python scripts/init_profile.py \
  --lunar-birthday "农历二零零一年三月初八" \
  --gender "女" \
  --skip-daily-fortune
```

## 状态查看

初始化完成后，可用下面命令查看当前保存内容：

```bash
python scripts/session_state.py --show
```

## 使用边界

- 命主资料用于增强问卦连续感与每日运势的个人化表达，不应夸大为绝对依据。
- 若用户明确拒绝提供资料，应立刻跳过，不反复劝说。
- 每日运势更适合作为当天提醒，不代替针对具体事件的正式问卦。

## 首次运行话术模板

如果要给 OpenClaw 一个统一的首次开场，可直接参考：

- `templates/first-run-message.md`

如果要给初始化完成后的承接话术一个统一模板，可直接参考：

- `templates/post-init-message.md`