181 lines
5.4 KiB
Markdown
181 lines
5.4 KiB
Markdown
# 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
|
||
|
||
---
|
||
|
||
**找不到需要的文档？** 欢迎提出建议！
|