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

🚀 Kimi API版本部署说明

✅ 已完成的修改

1. 大模型切换

从： Ollama本地模型 (deepseek-r1:32b)
到： Kimi远程API (moonshot-v1-32k)

配置信息：

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：复制到服务器（推荐）

# 本地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）

# 在本地执行（需要安装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调用格式

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配置

// 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地址

// 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能正常访问云服务器
• 读题功能测试成功
• 所有功能正常使用

---

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