# 包名变更通知

## 📦 新包名

从 **v2.0.3** 开始，包名已更改：

- ❌ 旧包名：`@gorden301jiawei/next-ai-doc`
- ✅ 新包名：`@gorden301jiawei/framework-ai-doc`

## 🎯 变更原因

由于工具已从 Next.js 专用工具升级为**通用多框架文档工具**，支持：
- Next.js
- React
- Vue
- Nuxt
- Vite
- 等更多框架

新包名 `@gorden301jiawei/framework-ai-doc` 更能体现工具的通用性。

## 🚀 使用方式

### 新包名使用

```bash
# 直接使用（推荐）
npx @gorden301jiawei/framework-ai-doc

# 指定框架
npx @gorden301jiawei/framework-ai-doc --framework nextjs

# 安装所有检测到的框架
npx @gorden301jiawei/framework-ai-doc --all

# 列出支持的框架
npx @gorden301jiawei/framework-ai-doc --list
```

### 命令名称也更新了

- ❌ 旧命令：`next-ai-doc`
- ✅ 新命令：`framework-ai-doc`

## 📌 向后兼容说明

### 旧包名会怎样？

`@gorden301jiawei/next-ai-doc` 包将：
- ✅ 保留在 npm 上（已发布的版本不会删除）
- ⚠️ 不再更新（停留在 v2.0.2）
- 📢 建议迁移到新包名

### 迁移步骤

如果你之前使用了旧包名，**无需任何操作**。因为每次都使用 `npx` 运行，自动使用最新版本。

只需下次运行时使用新包名：

```bash
# 将这个
npx @gorden301jiawei/next-ai-doc

# 改为
npx @gorden301jiawei/framework-ai-doc
```

### 如果全局安装了旧包

如果你全局安装过旧包：

```bash
# 卸载旧包
npm uninstall -g @gorden301jiawei/next-ai-doc

# 安装新包（可选，推荐使用 npx）
npm install -g @gorden301jiawei/framework-ai-doc
```

## 🔗 更新的链接

### GitHub 仓库
- 旧地址：`https://github.com/gorden301/next-ai-doc`（可能重定向）
- 新地址：`https://github.com/gorden301/framework-ai-doc`

### npm 包
- 旧地址：`https://www.npmjs.com/package/@gorden301jiawei/next-ai-doc`
- 新地址：`https://www.npmjs.com/package/@gorden301jiawei/framework-ai-doc`

## 📝 文档索引中的命令

生成的文档索引中的命令也会自动更新为新包名：

```markdown
<!-- NEXT-AGENTS-MD-START -->
[Next.js Docs Index]|...|If docs missing run: npx @gorden301jiawei/framework-ai-doc --framework nextjs
<!-- NEXT-AGENTS-MD-END -->
```

## ❓ 常见问题

### Q: 我已经生成的 AGENTS.md 需要更新吗？

不需要。现有的文档索引可以继续使用。如果需要更新文档，重新运行工具即可自动更新为新的命令提示。

### Q: 新旧包名可以共存吗？

可以，但不推荐。建议统一使用新包名 `@gorden301jiawei/framework-ai-doc`。

### Q: 功能有变化吗？

没有。除了包名和命令名，所有功能完全一致。

## 🎉 总结

- 包名：`@gorden301jiawei/next-ai-doc` → `@gorden301jiawei/framework-ai-doc`
- 命令：`next-ai-doc` → `framework-ai-doc`
- 功能：完全不变，更通用的名称
- 迁移：无需操作，下次直接使用新包名即可