TESTING.md

# AI 小说创作平台 - 测试指南

## 🧪 边界情况测试

### 1. 首次启动测试（无配置）

**预期结果：**
- ✅ 底部状态栏显示：Ollama 状态: 未连接 | 模型数量: 0 个 | 当前模型: 未配置模型
- ✅ 当前模型文字显示为红色
- ✅ 显示"前往配置"按钮
- ✅ 侧边栏状态显示：服务未连接

### 2. Ollama 服务未启动测试

**步骤：**
1. 确保 Ollama 服务未运行
2. 启动应用

**预期结果：**
- ✅ 底部状态栏显示：Ollama 状态: 未连接（红色）
- ✅ 显示警告提示：Ollama 服务未连接
- ✅ 提示信息：请确保 Ollama 服务正在运行
- ✅ 侧边栏显示服务未连接图标

### 3. 有服务但无模型测试

**步骤：**
1. 启动 Ollama 服务
2. 不安装任何模型
3. 启动应用

**预期结果：**
- ✅ 底部状态栏显示：Ollama 状态: 已连接（绿色）| 模型数量: 0 个（黄色）
- ✅ 当前模型: 未配置模型（红色）
- ✅ 显示警告提示：未检测到 AI 模型
- ✅ 提示信息：请先安装 AI 模型

### 4. 配置了模型但未安装测试

**步骤：**
1. 在设置中选择一个模型（如 qwen2.5:7b）
2. 但本地实际没有安装这个模型
3. 启动应用

**预期结果：**
- ✅ 底部状态栏显示：Ollama 状态: 已连接 | 模型数量: 0 个
- ✅ 当前模型: qwen2.5:7b (未安装)（黄色）
- ✅ 显示警告提示：当前配置的模型未安装
- ✅ 提示前往配置页面重新选择

### 5. 正常配置测试

**步骤：**
1. 启动 Ollama 服务
2. 安装模型：ollama pull qwen2.5:7b
3. 在设置中选择该模型
4. 启动应用

**预期结果：**
- ✅ 底部状态栏显示：Ollama 状态: 已连接（绿色）| 模型数量: 1 个（绿色）
- ✅ 当前模型: qwen2.5:7b (4.XX GB)（绿色）
- ✅ 不显示任何警告提示
- ✅ 侧边栏显示正常状态

### 6. 多个模型测试

**步骤：**
1. 安装多个模型：qwen2.5:7b, llama3:8b
2. 启动应用

**预期结果：**
- ✅ 底部状态栏显示：模型数量: 2 个
- ✅ 当前模型显示实际选中的模型信息
- ✅ 模型配置页面显示所有可用模型

### 7. 配置变更测试

**步骤：**
1. 从一个模型切换到另一个模型
2. 观察底部状态栏变化

**预期结果：**
- ✅ 切换后底部状态栏立即更新
- ✅ 如果新模型未安装，显示警告状态
- ✅ 如果新模型已安装，显示正常状态

## 🔄 状态刷新测试

### 手动刷新测试
**步骤：**
1. 点击底部"刷新状态"按钮
2. 观察 loading 状态

**预期结果：**
- ✅ 按钮显示加载动画
- ✅ 状态信息更新
- ✅ 如果期间状态变化，及时反映

### 自动刷新测试
**步骤：**
1. 启动应用后等待30秒
2. 观察 auto-refresh 机制

**预期结果：**
- ✅ 每30秒自动检查状态
- ✅ 状态变化时自动更新界面
- ✅ 无需手动操作

## 🎯 模型配置页面测试

### 页面加载测试
**步骤：**
1. 进入设置 > 模型页面
2. 观察初始状态

**预期结果：**
- ✅ 页面顶部显示服务状态卡片
- ✅ 如果已连接，自动显示已安装模型
- ✅ 表单自动加载当前配置

### 检测模型测试
**步骤：**
1. 点击"检测模型"按钮
2. 观察 loading 和结果

**预期结果：**
- ✅ 显示加载状态
- ✅ 检测完成后显示模型列表
- ✅ 如果当前模型未安装，自动清空选择
- ✅ 全局状态同步更新

### 保存配置测试
**步骤：**
1. 修改模型选择
2. 点击"保存配置"
3. 观察底部状态栏

**预期结果：**
- ✅ 配置保存成功提示
- ✅ 底部状态栏立即更新
- ✅ 全局状态同步更新
- ✅ 新配置生效

## 🚨 异常情况测试

### 网络断开测试
**步骤：**
1. 正常运行时断开网络
2. 尝试刷新状态

**预期结果：**
- ✅ 显示连接错误
- ✅ 不显示崩溃或白屏
- ✅ 提供重试机制

### 模型损坏测试
**步骤：**
1. 使用损坏的模型
2. 启动应用

**预期结果：**
- ✅ 系统识别模型问题
- ✅ 提示重新选择模型
- ✅ 不影响其他功能使用

## ✅ 功能完整性检查

- [ ] 启动时自动检查 Ollama 状态
- [ ] 启动时自动检查模型安装情况
- [ ] 底部状态栏实时显示准确信息
- [ ] 模型未配置时显示明确提示
- [ ] 模型未安装时显示警告状态
- [ ] 配置无效模型时提示用户
- [ ] 提供"前往配置"快捷入口
- [ ] 手动刷新状态功能正常
- [ ] 自动刷新状态机制工作
- [ ] 配置变更立即生效
- [ ] 错误处理用户友好

## 🎨 界面显示规则

### 状态颜色规则
- **绿色**: 状态正常，已配置且已安装
- **黄色**: 有问题但可用，如未安装模型
- **红色**: 严重问题，如未配置或服务未连接
- **灰色**: 服务未连接时的模型信息

### 文字提示规则
- **未配置模型**: "未配置模型" + 红色 + 前往配置按钮
- **未安装模型**: "模型名 (未安装)" + 黄色
- **服务未连接**: "模型名 (服务未连接)" + 灰色
- **正常状态**: "模型名 (大小)" + 绿色

通过以上测试，确保系统在各种边界情况下都能正确显示状态信息并提供用户友好的提示。