AI Customer Service MCP Server

# 快速修复指南

## npm配置错误修复

如果您在运行安装脚本时遇到以下错误：

```
npm error `timeout` is not a valid npm option
```

### 解决方案1：使用修复脚本（推荐）

```bash
# 运行修复脚本
chmod +x fix-npm-config.sh
./fix-npm-config.sh

# 然后继续安装
./install-ubuntu.sh
```

### 解决方案2：手动修复

```bash
# 删除错误的配置
npm config delete timeout

# 设置正确的超时配置
npm config set fetch-timeout 60000
npm config set fetch-retry-mintimeout 20000
npm config set fetch-retry-maxtimeout 120000

# 验证配置
npm config list

# 继续安装
npm install
```

### 解决方案3：跳过npm配置，直接安装

```bash
# 直接安装项目依赖
npm install

# 如果遇到权限问题
npm install --unsafe-perm=true --allow-root
```

## 其他常见问题快速修复

### 1. Node.js版本问题

```bash
# 检查版本
node --version

# 如果版本过低，重新安装
curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt-get install -y nodejs
```

### 2. 权限问题

```bash
# 设置npm全局路径
mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc
```

### 3. 网络问题

```bash
# 设置npm镜像源
npm config set registry https://registry.npmmirror.com

# 或使用淘宝镜像
npm config set registry https://registry.npm.taobao.org
```

### 4. 依赖安装失败

```bash
# 清理缓存
npm cache clean --force
rm -rf node_modules package-lock.json

# 重新安装
npm install
```

## 验证安装

安装完成后，验证功能：

```bash
# 检查Node.js和npm版本
node --version
npm --version

# 检查项目依赖
npm list

# 测试启动
npm start
```

## 获取帮助

如果问题仍然存在：

1. 查看完整日志：`cat ~/.npm/_logs/*.log`
2. 检查系统环境：`uname -a && lsb_release -a`
3. 查看README.md中的详细故障排除部分
4. 在GitHub上提交Issue

## 联系支持

- GitHub Issues: [项目地址]
- 技术支持邮箱: [邮箱地址]
- 文档: README.md