# 2026-06-05 变更记录

## [docs] 新增项目 README 文档

### 变更内容
- 新增项目根目录 `README.md`，整理库的定位、设计目标、核心类型与主要能力
- 补充自定义类型接入示例、父节点回溯示例、内置类型扩展清单以及构建测试命令
- 说明 `tynavi` 与 `onebot-api selector` 的差异，帮助读者快速理解该 crate 的设计方向

### 涉及文件
- `README.md` [Added] 新增项目说明文档，覆盖简介、快速开始、核心 API、类型扩展和构建方式
- `changelogs/2026-06-05.md` [Added] 新增当天变更记录文件并记录本次 README 编写

### 影响
- 为首次阅读项目的开发者提供统一入口，降低理解 Selector 模式、父节点回溯机制和接入方式的成本
- 不影响现有代码行为，仅补充文档

### 原因
- 仓库当前缺少面向使用者的顶层说明文档，不利于外部理解项目定位和 API 用法
- 需要为后续开发、发布或协作提供清晰的项目介绍与示例

## [docs] 补充 README 的问题边界与适用场景说明

### 变更内容
- 在 `README.md` 中新增“这个库解决什么问题”和“不打算解决什么问题”两节
- 补充该库在 `onebot-api` 事件处理中的原始使用背景，说明其更适合替代深层嵌套场景下的样板 `match`
- 明确库的能力边界，区分适合 Selector 链式导航的场景与更适合直接使用模式匹配的场景

### 涉及文件
- `README.md` [Changed] 新增项目定位说明，强化适用问题、设计边界与使用预期
- `changelogs/2026-06-05.md` [Changed] 追加记录本次 README 定位说明补充

### 影响
- 帮助使用者更准确判断该库的价值和边界，减少把它误解为“完全替代 `match`”的风险
- 不影响现有代码行为，仅增强文档表达和项目定位清晰度

### 原因
- 项目背景与适用问题此前没有在 README 中明确写出，读者很难快速理解这个库为何存在
- 需要把“替代机械性模式匹配”与“保留复杂控制流中的 `match`”区分清楚，避免定位模糊
