---
title: 迁移（面向 AI 助手）
description: 供 AI 助手协助将 HeroUI v2 迁移到 v3 时使用的入口
index: false
---

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