# Iteration Roadmap

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

---

## Version Naming Convention

| Position | Meaning | Trigger Condition |
|----------|---------|-------------------|
| **X**.y.z | Major version | 一个关键场景的完整解决方案首次全部实现 |
| x.**Y**.z | Minor version | 针对同一关键场景新增了一种迭代解决方案 |
| x.y.**Z** | Patch version | Bug 修复、文档或交互细节优化 |

---

## Roadmap

**v0.1.0** — 建立 Windows CLI 核心播报能力

> 完成 Horn 命令行工具的基础实现：用户可通过 `horn --start` / `horn --done` / `horn --confirm` 三条命令，分别触发 Windows 系统 TTS 播报对应的中文预设语音。执行裸命令 `horn` 时播报验证语音，用于确认安装成功。

**v0.2.0** — 实现 Cursor Rules 自动触发集成

> 提供可直接使用的 Cursor Rules 模板文件（`.mdc`），agent 在任务开始、完成、需要确认时自动调用对应 Horn 命令，无需开发者手动触发。至此，Windows 平台的核心使用场景完整闭环。

**v1.0.0** — 里程碑：Windows + Cursor 开箱即用完整方案

> v0.1.0 ～ v0.2.0 的完整方案经过验证稳定，补充完善 README、安装文档、常见问题排查指南，正式发布 1.0.0。

**v1.1.0** — 支持 agent 动态传入自定义消息文本

> `horn` 命令支持 `--message` 参数，agent 可传入任意文本内容进行播报（如 `horn --done --message "登录模块重构完成"`），不再局限于预设文本。

**v1.2.0** — 支持配置文件自定义预设文本

> 用户可通过配置文件（YAML）修改三种预设通知的播报文本、语速、音量等参数，实现个性化配置，同时保持开箱即用的默认值。

**v2.0.0** — 里程碑：跨平台支持（macOS / Linux）

> 扩展 TTS 引擎适配层，支持 macOS（say 命令）和 Linux（espeak / festival），核心 CLI 接口保持不变。

**v2.1.0** — MCP Server 模式

> 以 MCP Server 方式暴露 Horn 的通知能力，支持通过 MCP 协议调用，扩大与 agent 客户端的兼容范围。

**v3.0.0** — 里程碑：跨 agent 客户端通用技能包

> 同时提供适用于 Cursor、Claude（Open Claw）等主流 agent 客户端的通用技能包（Skill/Rules 模板），任意支持工具调用的 agent 客户端均可自动触发 Horn 通知。
