# 每日运势与定时任务

这份说明用于把 `King Wen Hexagrams` 接入 OpenClaw 的定时任务能力，让它在每日固定时间，为同一位用户起一卦并给出当天运势提示。

## 适用原则

- 每日运势更适合做 `当天气机提醒`，不宜替代针对具体事件的正式问卦。
- 若要让每日运势更有连续感，首次启用时应先登记命主资料。
- 建议至少登记两项：`农历生日` 与 `性别`。
- 若用户愿意补充时辰，可一并记录，但不应强求。

## 首次登记命主资料

建议首次启用时，用简短、庄重的方式补齐以下资料：

1. 命主农历生日
2. 命主性别
3. 可选的出生时辰
4. 每日运势希望推送的时间
5. 时区

本仓库附带了一个轻量状态脚本，可用于把这些信息写入本地：

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

查看当前已保存资料：

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

如果用户已经在初始化脚本里补了每日运势时间，建议在初始化完成后顺势追问一句：

- `命主小档已经立好。若你愿意，我下一步还可以继续帮你配置每日运势的 cron。`

## 推荐的每日运势输出口径

每日定时起卦时，输出应尽量稳定，建议采用五段式：

1. 今日卦势
2. 气机偏向
3. 宜做之事
4. 宜避之事
5. 一句收束

若当日卦象偏于收敛、等待、避争，应说得明确，但仍保持克制，不制造惊吓感。

## OpenClaw 定时任务示例

如果宿主环境已安装 OpenClaw CLI，可直接创建一个每日任务：

```bash
openclaw cron add \
  --name "文王每日运势" \
  --cron "30 7 * * *" \
  --tz "Asia/Shanghai" \
  --session isolated \
  --message "请启用 king-wen-hexagrams 技能，为我生成今日运势。命主资料如下：农历生日=农历二零零一年三月初八；性别=女；出生时辰=巳时。请结合今天的日期，起一卦看当日气机，只输出：今日卦势、气机偏向、宜、忌、一句收束。口吻保持庄重、简洁、克制，不要夸张渲染神秘。" \
  --announce
```

上例表示每天 `07:30` 自动运行一次。

## 定时任务参数建议

- `--session isolated`：适合每日运势这类独立任务，避免打乱主会话。
- `--tz "Asia/Shanghai"`：明确时区，避免服务器时区不一致。
- `--announce`：让结果自动回送到聊天渠道；若只想后台运行，可改为 `--no-deliver`。
- `--cron "30 7 * * *"`：表示每日 07:30 执行；用户可以按需要改成其他时间。

## 推荐消息模板

若你不想把命主资料写死在命令里，也可以在创建任务前先保存本地状态，然后把消息写成：

```text
请启用 king-wen-hexagrams 技能，如本地已保存命主资料则直接沿用；若未保存，则提醒我先补农历生日与性别。请按今日日期起一卦，只解今日运势，不延展到长期人生判断。输出保持简洁、庄重、可执行。
```

## 适合补问的内容

如果用户后续想把每日运势做得更贴身，可以再补：

- 更偏重事业、关系、财务还是身心状态
- 是否只看工作日
- 是否希望晨间推送或晚间复盘