# 迁移（面向 AI 助手） · HeroUI

> 供 AI 助手协助将 HeroUI v2 迁移到 v3 时使用的入口

- 页面: https://jiguang132.com/zh/systems/heroui/docs/migration/agent-index
- 改编自: HeroUI 文档 (Apache-2.0) @ 60edd8ed751b1d2a270623fbb182bbcfa8baa9af

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

---

JGuang 全部资源索引: https://jiguang132.com/llms.txt