迁移（面向 AI 助手）
供 AI 助手协助将 HeroUI v2 迁移到 v3 时使用的入口
面向 AI 助手：在协助将 HeroUI v2 → v3 进行迁移时，请将本文档作为入口。
入口
请选择一种迁移策略：
- 完整迁移（迁移过程中项目将无法正常运行）→ 阅读
(workflows)/agent-guide-full.mdx。 - 渐进式迁移（v2 与 v3 并存）→ 阅读
(workflows)/agent-guide-incremental.mdx。
本套文档中的参考资料
- 通用指南：
hooks.mdx、styling.mdx。 - 上述工作流程指南已经内嵌了「主要变更」、「关键 API 变更」、组件参考表以及「新增组件」等内容。
- 各组件指南：
(components)/<component>.mdx（例如(components)/button.mdx、(components)/select.mdx）。请通过工作流程指南中的组件参考表来定位对应的文件。