# Maian-X 快速入门

## 安装

### Windows
1. 下载 `Maian-X-Setup-0.1.0.exe`（76MB）
2. 双击运行，按提示完成安装
3. 启动 Maian-X 桌面客户端

### 系统要求
| 项目 | 最低 | 推荐 |
|------|------|------|
| 操作系统 | Windows 10 x64 | Windows 11 x64 |
| CPU | 双核 2.0GHz | 四核 2.5GHz+ |
| 内存 | 4GB | 8GB+ |
| 硬盘 | 10GB | 20GB+ |
| Node.js | v18 | v20+ |

## 模型配置

首次启动后，需安装本地推理模型：

```bash
# 推荐模型（按资源需求从低到高）
ollama pull qwen2.5:0.5b   # 0.3GB，最低配置
ollama pull qwen2.5:1.5b   # 0.8GB，推荐入门
ollama pull qwen2.5:3b     # 1.6GB，平衡性能
```

### 模型选择建议
| 场景 | 推荐模型 | RAM | 速度 |
|------|----------|-----|------|
| 低配 PC（4GB RAM） | qwen2.5:0.5b | ~0.3GB | ⚡ 极快 |
| 日常办公（8GB RAM） | qwen2.5:1.5b | ~0.8GB | ⚡⚡ 快 |
| 高性能（16GB RAM） | qwen2.5:3b | ~1.6GB | ⚡⚡⚡ 精准 |

## 使用指南

### 基本对话
- 在输入框中键入问题，按 Enter 发送
- 支持 Markdown 渲染（代码高亮、表格、列表）
- 主题切换：右上角切换深色/浅色模式

### 技能调用
Maian-X 内置 74 个技能，覆盖：
- **查询**：天气、新闻、词典、汇率
- **开发**：代码审查、Git 管理、API 调试
- **创作**：写作、翻译、生成图片
- **分析**：数据处理、PDF 分析、知识库

### 快捷键
| 操作 | 快捷键 |
|------|--------|
| 发送消息 | Enter |
| 换行 | Shift + Enter |
| 清空对话 | Ctrl + L |
| 切换主题 | Ctrl + T |

## 常见问题

**Q：启动后提示 "Ollama 未连接"？**
A：请确保已安装 Ollama 并在后台运行。下载地址：[ollama.ai](https://ollama.ai)

**Q：技能不响应？**
A：检查技能是否已启用。部分技能需要网络连接（如天气、新闻）。

**Q：如何更新 Maian-X？**
A：从官网下载最新版本安装包，覆盖安装即可。