# v2.0.1 修复说明

## 🐛 修复的问题

### 问题描述

在 v2.0.0 中，尝试下载 Vue 和 React 文档时会报错：
```
Failed to pull docs: docs folder not found in cloned repository
```

### 根本原因

React 和 Vue 的官方文档不在主代码仓库中，而是在独立的文档仓库：

- **React**：文档在 `reactjs/react.dev` 仓库
- **Vue**：文档在 `vuejs/docs` 仓库

这些文档仓库不按版本维护，只有 `main` 分支包含最新文档。

## ✅ 解决方案

### 1. 配置更新

为框架配置添加了 `useFixedBranch` 和 `fixedBranch` 选项：

```typescript
interface FrameworkConfig {
  // ... 其他配置
  useFixedBranch?: boolean;     // 是否使用固定分支
  fixedBranch?: string;         // 固定分支名称
}
```

### 2. React 配置

```typescript
react: {
  id: "react",
  name: "React",
  packageName: "react",
  githubRepo: "https://github.com/reactjs/react.dev.git",
  docsPath: "src/content",
  outputDir: ".react-docs",
  versionToTag: (version) => "main",
  markerPrefix: "REACT",
  description: "A JavaScript library for building user interfaces",
  useFixedBranch: true,        // 使用固定分支
  fixedBranch: "main",         // 使用 main 分支
}
```

### 3. Vue 配置

```typescript
vue: {
  id: "vue",
  name: "Vue",
  packageName: "vue",
  githubRepo: "https://github.com/vuejs/docs.git",
  docsPath: "src",
  outputDir: ".vue-docs",
  versionToTag: (version) => "main",
  markerPrefix: "VUE",
  description: "The Progressive JavaScript Framework",
  useFixedBranch: true,        // 使用固定分支
  fixedBranch: "main",         // 使用 main 分支
}
```

### 4. 用户提示

现在运行时会显示提示信息：

```
✔ Vue documentation pulled
   Path: /path/to/.vue-docs
   Version: 3.4.21
   Note: Using latest docs from 'main' branch (version-specific docs not available)
```

## 📋 框架支持状态

### ✅ 完整版本匹配

- **Next.js** - 从主仓库按版本 tag 下载文档
- **Nuxt** - 从主仓库按版本 tag 下载文档
- **Vite** - 从主仓库按版本 tag 下载文档

### ⚠️ 使用最新文档

- **React** - 从 react.dev 下载最新文档
- **Vue** - 从 vuejs/docs 下载最新文档

## 🎯 使用建议

### Nuxt 项目（推荐）

```bash
# Nuxt 项目同时使用 Vue 和 Nuxt
npx @gorden301jiawei/framework-ai-doc --all

# 结果：
# - .nuxt-docs/ - Nuxt 文档（版本匹配）
# - .vue-docs/   - Vue 文档（最新版）
```

### Next.js 项目

```bash
# 只需要 Next.js 文档（版本匹配）
npx @gorden301jiawei/framework-ai-doc

# 或显式指定
npx @gorden301jiawei/framework-ai-doc --framework nextjs
```

### React + Vite 项目

```bash
# 同时安装 React 和 Vite
npx @gorden301jiawei/framework-ai-doc --all

# 结果：
# - .react-docs/ - React 文档（最新版）
# - .vite-docs/  - Vite 文档（版本匹配）
```

## 💡 为什么这样设计？

### 1. 最新文档通常更好

对于 API 相对稳定的框架（如 React、Vue），最新文档包含：
- 最佳实践
- 完整的 API 说明
- 常见问题解答
- 性能优化建议

### 2. 版本要求会标注

现代文档通常会标注功能的版本要求，例如：
```
React 18+
Vue 3.3+
```

### 3. 用户体验优先

相比完全不支持这些框架，提供最新文档是更好的选择。

## 🔄 迁移指南

### 从 v2.0.0 升级

如果你之前尝试安装 React 或 Vue 失败了，现在可以重新运行：

```bash
# 全局安装最新版
npm install -g @gorden301jiawei/framework-ai-doc@latest

# 或使用 npx
npx @gorden301jiawei/framework-ai-doc@latest --framework vue
```

### 清理旧的安装

如果之前安装失败留下了空目录：

```bash
# 删除空目录
rm -rf .vue-docs .react-docs

# 重新运行工具
npx @gorden301jiawei/framework-ai-doc --all
```

## 📝 文档更新

- ✅ 更新 `README.md` - 说明框架支持状态
- ✅ 添加常见问题解答 - 解释为什么某些框架使用最新文档
- ✅ 更新示例 - 展示正确的使用方式

## 🚀 测试

请在你的 Nuxt 项目中重新运行：

```bash
npx @gorden301jiawei/framework-ai-doc@2.0.1 --all
```

应该能成功下载 Vue 和 Nuxt 的文档。

## 🙏 感谢

感谢你的测试和反馈！这帮助我们发现并修复了这个问题。