# MCP Client Vue 文档索引

## 🎉 最新更新 (v1.0.2+ Cherry Studio 架构)

| 文档 | 说明 | 重要度 |
|------|------|--------|
| [UPDATE_SUMMARY_v1.0.2+.md](./UPDATE_SUMMARY_v1.0.2+.md) | **完整更新总结和功能说明** | ⭐️⭐️⭐️ |
| [Cherry Studio 架构实现](./docs/CHERRY_STUDIO_IMPLEMENTATION.md) | 架构实现细节和对比 | ⭐️⭐️⭐️ |
| [MCP 工具调用完整示例](./docs/mcp-tool-calling-example.md) | 9步详细流程和代码示例 | ⭐️⭐️⭐️ |
| [快速测试指南](./docs/QUICK_TEST_GUIDE.md) | 5个测试用例和验证方法 | ⭐️⭐️ |

---

## 📚 快速导航

### 🚀 开始使用

| 文档 | 说明 | 适合人群 |
|------|------|----------|
| [README.md](./README.md) | 项目总览和快速开始 | 所有用户 |
| [CURRENT_STATUS.md](./CURRENT_STATUS.md) | 当前状态快速概览 | 所有用户 |
| [DEVELOPMENT_GUIDE.md](./DEVELOPMENT_GUIDE.md) | 详细使用指南 | 新用户 |

### 📋 更新信息

| 文档 | 说明 | 适合人群 |
|------|------|----------|
| [CHANGELOG.md](./CHANGELOG.md) | 完整的更新日志 | 所有用户 |
| [IMPROVEMENTS.md](./IMPROVEMENTS.md) | 改进详细说明 | 所有用户 |

### 🔧 技术文档

| 文档 | 说明 | 适合人群 |
|------|------|----------|
| [TYPESCRIPT_FIXES.md](./TYPESCRIPT_FIXES.md) | TypeScript错误修复指南 | 开发者 |
| [MODAL_FIX_GUIDE.md](./MODAL_FIX_GUIDE.md) | 模态框修复详解 | 开发者 |
| [BLANK_PAGE_FIX.md](./BLANK_PAGE_FIX.md) | 空白页问题修复 | 开发者 |
| [AUTO_RECONNECT_GUIDE.md](./AUTO_RECONNECT_GUIDE.md) | 自动重连功能文档 | 开发者 |
| [FIX_REPORT.md](./FIX_REPORT.md) | 修复报告汇总 | 开发者 |

### 🐛 调试帮助

| 文档 | 说明 | 适合人群 |
|------|------|----------|
| [debug-ui.md](./debug-ui.md) | UI调试指南 | 开发者 |
| [VUE_ERROR_DEBUG.md](./VUE_ERROR_DEBUG.md) | Vue错误调试 | 开发者 |

## 📖 按场景查找文档

### 我是新用户

1. 先看 [README.md](./README.md) 了解项目
2. 再看 [DEVELOPMENT_GUIDE.md](./DEVELOPMENT_GUIDE.md) 学习使用
3. 遇到问题查看 [常见问题](#常见问题文档)

### 我想了解最新改进

1. 查看 [CHANGELOG.md](./CHANGELOG.md) 了解更改
2. 阅读 [IMPROVEMENTS.md](./IMPROVEMENTS.md) 了解详情
3. 查看 [CURRENT_STATUS.md](./CURRENT_STATUS.md) 了解当前状态

### 我遇到了问题

1. 先查看 [VERSION_1.3.5_GUIDE.md - 常见问题](./VERSION_1.3.5_GUIDE.md#常见问题)
2. 再查看 [VERSION_1.3.5_GUIDE.md - 故障排除](./VERSION_1.3.5_GUIDE.md#故障排除)
3. 查看相关的技术文档

### 我是开发者

1. 了解 [技术栈](./README.md#技术栈)
2. 查看 [代码架构](./README.md#项目架构)
3. 阅读相关技术文档

## 🔍 按问题类型查找

### 连接问题

**HTTP连接失败**
- [DEVELOPMENT_GUIDE.md - HTTP连接](./DEVELOPMENT_GUIDE.md#http服务器)
- [CHANGELOG.md - HTTP修复](./CHANGELOG.md#连接问题)

**SSE连接失败**
- [DEVELOPMENT_GUIDE.md - SSE连接](./DEVELOPMENT_GUIDE.md#sse服务器)
- [CHANGELOG.md - SSE修复](./CHANGELOG.md#连接问题)

**自动重连问题**
- [AUTO_RECONNECT_GUIDE.md](./AUTO_RECONNECT_GUIDE.md)
- [DEVELOPMENT_GUIDE.md - 自动重连](./DEVELOPMENT_GUIDE.md#自动重连功能)

### UI问题

**编辑按钮无响应**
- [MODAL_FIX_GUIDE.md](./MODAL_FIX_GUIDE.md)
- [FIX_REPORT.md - 编辑功能](./FIX_REPORT.md)

**模态框空白**
- [BLANK_PAGE_FIX.md](./BLANK_PAGE_FIX.md)
- [MODAL_FIX_GUIDE.md](./MODAL_FIX_GUIDE.md)

**表单数据不显示**
- [BLANK_PAGE_FIX.md - 表单问题](./BLANK_PAGE_FIX.md)
- [debug-ui.md](./debug-ui.md)

### 构建问题

**TypeScript错误**
- [TYPESCRIPT_FIXES.md](./TYPESCRIPT_FIXES.md)
- [CHANGELOG.md - 构建问题](./CHANGELOG.md#构建问题)

**依赖问题**
- [README.md - 快速开始](./README.md#快速开始)
- [DEVELOPMENT_GUIDE.md - 故障排除](./DEVELOPMENT_GUIDE.md#构建问题)

## 📱 常见问题文档

快速链接到常见问题的解答：

1. **编辑按钮无响应** → [DEVELOPMENT_GUIDE.md#Q1](./DEVELOPMENT_GUIDE.md#常见问题)
2. **模态框空白** → [DEVELOPMENT_GUIDE.md#Q2](./DEVELOPMENT_GUIDE.md#常见问题)
3. **表单不显示数据** → [DEVELOPMENT_GUIDE.md#Q3](./DEVELOPMENT_GUIDE.md#常见问题)
4. **页面刷新断连** → [DEVELOPMENT_GUIDE.md#Q4](./DEVELOPMENT_GUIDE.md#常见问题)
5. **HTTP 406错误** → [DEVELOPMENT_GUIDE.md#Q5](./DEVELOPMENT_GUIDE.md#常见问题)
6. **SSE 404错误** → [DEVELOPMENT_GUIDE.md#Q6](./DEVELOPMENT_GUIDE.md#常见问题)
7. **0.0.0.0连接失败** → [DEVELOPMENT_GUIDE.md#Q7](./DEVELOPMENT_GUIDE.md#常见问题)

## 🎯 快速参考

### 配置示例

**HTTP服务器**
```
类型: http
URL: http://localhost:3100
```

**SSE服务器**
```
类型: sse  
URL: http://localhost:3200/sse
```

### 命令速查

```bash
# 安装依赖
npm install

# 开发服务器
npm run dev

# 构建（跳过类型检查）
npm run build:skip-check

# 构建（完整类型检查）
npm run build
```

### 端口配置

- **前端开发**: 5173 (默认)
- **HTTP MCP**: 3100
- **SSE MCP**: 3200

## 📞 获取帮助

如果文档没有解决你的问题：

1. 检查 [已知问题](./IMPROVEMENTS.md#已知问题)
2. 查看浏览器控制台日志
3. 查看MCP服务器日志
4. 提交Issue（附上错误信息和日志）

## 🔄 文档更新

最后更新：2025-10-14  
版本：1.0.0

---

**找不到需要的文档？** 欢迎提出建议！