# Business Flow

> Date: 2026/03/08
> Author: Horn Team

---

> **说明**：从用户视角描述操作产品的过程，每个关键场景对应一张流程图。
> 节点描述覆盖用户可感知的操作和产品响应，不涉及技术实现细节。

---

## Scenario 1：首次安装与验证（v0.1.0）

```mermaid
flowchart TD
    A([开发者准备使用 Horn]) --> B[执行 pip install horn]
    B --> C{安装是否成功？}
    C -- 失败 --> D[查看错误信息\n参考文档排查]
    D --> B
    C -- 成功 --> E[执行裸命令 horn]
    E --> F{是否听到验证语音？}
    F -- 否 --> G[参考文档检查\n系统音量 / SAPI 配置]
    G --> E
    F -- 是 --> H([安装验证完成，Horn 可正常使用])
```

---

## Scenario 2：配置 Cursor Rules 触发集成（v0.2.0）

```mermaid
flowchart TD
    A([开发者准备配置自动触发]) --> B[从文档获取 Horn Rules 模板内容]
    B --> C[将 .mdc 文件放入\n.cursor/rules/ 目录]
    C --> D[在 Cursor 中下达一个简单测试任务]
    D --> E{是否听到"老板，我开始执行任务了"？}
    E -- 否 --> F[参考文档检查\nRules 路径 / horn 是否在 PATH 中]
    F --> D
    E -- 是 --> G([配置完成，自动触发生效])
```

---

## Scenario 3：日常使用 - agent 执行任务全流程通知（v0.2.0）

```mermaid
flowchart TD
    A([开发者向 Cursor agent 下达任务]) --> B[agent 开始执行]
    B --> C[Horn 播报\n「老板，我开始执行任务了」]
    C --> D[开发者离开电脑处理其他事务]
    D --> E{agent 执行状态}
    E -- 顺利完成 --> F[Horn 播报\n「老板，任务已完成」]
    E -- 中途遇到需要决策的节点 --> G[Horn 播报\n「老板，有事情需要你确认」]
    F --> H[开发者返回电脑查看结果]
    G --> H
    H --> I{开发者操作}
    I -- 确认并继续 --> E
    I -- 任务结束 --> J([本次任务闭环完成])
```

---

## Scenario 4：异常情况 - 通知未触发（v0.2.0，说明范围边界）

```mermaid
flowchart TD
    A([开发者等待语音通知但未收到]) --> B{排查原因}
    B -- Horn 未安装或不在 PATH 中 --> C[重新安装 Horn\n参考安装文档]
    B -- Cursor Rules 未配置或路径错误 --> D[重新配置 Rules\n参考配置文档]
    B -- agent 客户端通信异常 --> E[此为 agent 客户端问题\n不属于 Horn 职责范围\n重启 agent 客户端]
    B -- 系统音量关闭或 SAPI 异常 --> F[检查 Windows 系统音量\n和 TTS 服务状态]
    C --> G([问题解决，重新验证])
    D --> G
    E --> G
    F --> G
```
