xinli/部署说明-Kimi版本.md

# 🚀 Kimi API版本部署说明

## ✅ 已完成的修改

### 1. 大模型切换
**从：** Ollama本地模型 (deepseek-r1:32b)  
**到：** Kimi远程API (moonshot-v1-32k)

**配置信息：**
```javascript
API_URL: 'https://api.moonshot.cn/v1/chat/completions'
API_KEY: 'sk-U9fdriPxwBcrpWW0Ite3N0eVtX7VxnqqqYUIBAdWd1hgEA9m'
MODEL: 'moonshot-v1-32k'
```

### 2. Android App地址修改
**从：** `http://192.168.0.106:8090` (局域网)  
**到：** `http://1.15.149.240:20001` (云服务器)

---

## 📦 部署步骤

### 第一步：部署前端

#### 方式1：复制到服务器（推荐）
```bash
# 本地dist目录路径
c:\Users\Administrator\Desktop\Project\xinli\xinli-ui\dist

# 服务器部署路径（根据实际情况修改）
服务器: 1.15.149.240
路径: /www/wwwroot/xinli_web/web/
```

**操作：**
1. 将 `xinli-ui\dist` 文件夹的**所有内容**复制
2. 上传到服务器的前端部署目录
3. 覆盖原有文件

#### 方式2：使用FTP/SFTP工具
```
工具：FileZilla / WinSCP
服务器：1.15.149.240:22
用户：根据实际情况
路径：/www/wwwroot/xinli_web/web/
```

#### 方式3：使用命令行（如果有SSH）
```bash
# 在本地执行（需要安装scp）
scp -r dist/* user@1.15.149.240:/www/wwwroot/xinli_web/web/
```

### 第二步：安装Android App

**APK位置：**
```
c:\Users\Administrator\Desktop\Project\xinli\xinli-App\app\build\outputs\apk\debug\app-debug.apk
```

**安装到手机：**
1. 将APK复制到手机
2. 安装或覆盖安装旧版本
3. 打开App，会自动访问 `http://1.15.149.240:20001`

---

## 🧪 测试步骤

### 1. 测试前端访问
在浏览器访问：
```
http://1.15.149.240:20001
```

确保：
- ✅ 页面正常显示
- ✅ 功能正常使用

### 2. 测试AI分析功能
进入报告详情页：
1. 点击"AI分析"按钮
2. 等待AI生成分析结果
3. 查看是否正常显示

**预期：**
- ✅ 调用Kimi API成功
- ✅ 生成专业的报告分析
- ✅ 格式美观，内容完整

### 3. 测试App功能
1. 在手机上打开App
2. 检查是否能正常访问云服务器
3. 测试答题功能
4. **测试读题功能** 🔊
   - 进入答题页面
   - 点击读题按钮
   - 应该听到Android原生TTS朗读

---

## 🔍 常见问题

### Q1: AI分析失败？
**可能原因：**
- Kimi API密钥无效
- 网络连接问题
- API配额用完

**解决方法：**
1. 检查控制台错误信息
2. 确认API密钥正确
3. 检查Kimi账户余额

### Q2: App无法访问？
**可能原因：**
- 手机无法连接外网
- 服务器防火墙阻止
- 端口未开放

**解决方法：**
1. 确保手机有网络
2. 在手机浏览器访问测试
3. 检查服务器防火墙配置

### Q3: 前端更新没生效？
**解决方法：**
1. 清除浏览器缓存（Ctrl + F5）
2. 确认服务器文件已更新
3. 检查Nginx/Apache配置

---

## 📊 API使用说明

### Kimi API调用格式
```javascript
POST https://api.moonshot.cn/v1/chat/completions

Headers:
  Authorization: Bearer sk-U9fdriPxwBcrpWW0Ite3N0eVtX7VxnqqqYUIBAdWd1hgEA9m
  Content-Type: application/json

Body:
{
  "model": "moonshot-v1-32k",
  "messages": [
    {"role": "system", "content": "系统提示词"},
    {"role": "user", "content": "用户问题"}
  ],
  "temperature": 0.2,
  "max_tokens": 1000
}

Response:
{
  "choices": [
    {
      "message": {
        "content": "AI生成的内容"
      }
    }
  ]
}
```

### 模型选择
- `moonshot-v1-8k` - 8K上下文，速度快
- `moonshot-v1-32k` - 32K上下文，推荐 ✅
- `moonshot-v1-128k` - 128K上下文，处理长文本

---

## 🎯 回滚方案

如果需要切换回Ollama本地模型：

**1. 修改API配置**
```javascript
// detail.vue, index.vue, comprehensive.vue
const API_URL = 'http://192.168.0.106:11434/api/chat';
const API_KEY = '';
const MODEL = 'deepseek-r1:32b';

// 响应解析
data?.message?.content  // Ollama格式
```

**2. 修改App地址**
```java
// MainActivity.java
private static final String FIXED_URL = "http://192.168.0.106:8090";
```

**3. 重新构建和部署**

---

## 📝 版本信息

- **大模型：** Kimi API (moonshot-v1-32k)
- **App地址：** http://1.15.149.240:20001
- **TTS：** Android原生TTS
- **构建时间：** 2025-12-02

---

## ✅ 部署检查清单

- [ ] 前端dist文件夹已上传到服务器
- [ ] 服务器Nginx/Apache已重启
- [ ] 浏览器访问 http://1.15.149.240:20001 正常
- [ ] AI分析功能测试成功
- [ ] APK已安装到测试手机
- [ ] App能正常访问云服务器
- [ ] 读题功能测试成功
- [ ] 所有功能正常使用

---

**部署完成后，即可在手机和浏览器正常使用新版本！** 🎉