迁移（面向 AI 助手）

面向 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）。请通过工作流程指南中的组件参考表来定位对应的文件。