# King Wen Hexagrams 工作流

这份文档定义从用户输入到完整解读输出的标准流程。

## 标准流程

1. 识别用户意图
2. 判断是否为首次启用或每日运势场景
3. 如为首次启用，补齐命主资料意愿
4. 判断是否已提供卦象
5. 如未起卦，确认起卦方式
6. 标准化本卦、动爻和变卦
7. 判断问事类型与时间范围
8. 选择输出模板
9. 生成解读与后续追问

## 首次启用流程

当用户第一次安装或第一次正式使用技能时，优先按以下顺序处理：

1. 判断当前上下文里是否已有命主资料。
2. 若没有，先询问用户是否愿意登记基础资料。
3. 默认只补两项：`农历生日`、`性别`。
4. 若用户愿意再补 `出生时辰`，可一并记录。
5. 若用户拒绝，直接进入正常问卦流程，不重复劝说。

## 每日运势流程

当用户想看 `今日运势`、`今日卦势` 或希望配置 OpenClaw 定时任务时，按以下顺序处理：

1. 检查是否已有命主资料。
2. 若无，优先补 `农历生日` 与 `性别`。
3. 补齐每日执行时间与时区。
4. 明确这是 `当天提醒`，不是长期命运总断。
5. 以简短结构输出 `今日卦势 -> 气机偏向 -> 宜 -> 忌 -> 一句收束`。

## 手动抛硬币流程

当用户希望亲手起卦时，按以下顺序引导：

1. 请用户只定一事，并用一句话默念问题。
2. 请用户放慢节奏，安静片刻后再开始。
3. 说明默认规则为 `正=阳爻`、`反=阴爻`；若用户要直接发数字串，则同步说明 `0=反=阴`、`1=正=阳`。
4. 请用户抛硬币六次，每次只记录一次正或反。
5. 强调记录顺序必须是 `从下往上`，第一次为初爻，第六次为上爻。
6. 每次结果记为 `正` 或 `反`，例如 `反,正,反,正,反,反`；若用户已经整理成六位串，也可直接写成 `000111`。
7. 六次完成后，再统一换算本卦；若没有额外动爻信息，则不单独推导变卦。
8. 正式解读前，可先用一句简短收束，例如“六投既定，先看卦势，再论进退”。

## 输入分流

### 已经有卦象

输入可能是：

- 卦序
- 卦名
- 上下卦
- 动爻组合
- 本卦和变卦

处理方式：

- 先统一成标准表示
- 识别需要读取的卦文件
- 决定是查询模式还是正式解读模式

### 只有起卦材料

输入可能是：

- 数字
- 铜钱结果
- 手动抛硬币的六次正反记录
- 六爻阴阳
- 时间起卦参数

处理方式：

- 收集缺失参数
- 若为手动抛硬币，先确认记录顺序是否为从下往上
- 生成标准卦象
- 推导动爻与变卦

### 只有问题没有卦

处理方式：

- 先追问是否需要起卦
- 如果需要，选择起卦方式
- 如果不需要，只提供相关卦理或术语说明

## 标准中间结果

无论用户如何输入，最终都应整理为统一结构：

- `profile_snapshot`
- `question_type`
- `time_horizon`
- `source_method`
- `raw_divination_input`
- `base_hexagram`
- `moving_lines`
- `changed_hexagram`
- `confidence_notes`

## 输出结构

默认采用五段式：

1. 问题聚焦
2. 卦象结构
3. 核心解读
4. 行动建议
5. 后续追问

若为每日运势，可缩短为：

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

## 特殊处理规则

### 信息不足

- 优先追问而不是硬解
- 一次只补最关键的信息
- 首次启用时，优先补命主资料意愿，再补问事细节
- 铜钱起卦时，优先补齐记录顺序、六次结果是否完整、每次是否只记录一次正反

### 高风险议题

- 明确提醒用户结合现实专业意见
- 不输出绝对化结论

### 单纯知识查询

- 返回简明说明
- 不自动进入趋吉避凶式表达

### 仪式感表达

- 允许在起卦引导和解卦开场使用庄重、安静、敬慎的语气
- 仪式感只服务于聚焦问题与整理流程，不能替代清楚的结构化判断