# 🚀 Quick Start Guide

Ollama Console Remover 快速开始指南

## ⚡ 一键开始（推荐）

### 1. 优化处理dist目录
```bash
node scripts/optimize-dist.js
```

### 2. 预览处理效果
```bash
node scripts/optimize-dist.js --dry-run
```

### 3. 测试Ollama连接
```bash
node scripts/performance-test.js
```

## 📋 命令速查

| 目标 | 命令 | 说明 |
|------|------|------|
| 🏃‍♂️ **快速处理** | `node scripts/optimize-dist.js` | 优化整个dist目录 |
| 👀 **预览模式** | `node scripts/optimize-dist.js --dry-run` | 查看将要处理的文件 |
| 🧪 **性能测试** | `node scripts/performance-test.js` | 对比不同方法性能 |
| 🤖 **AI处理** | `node scripts/process-dist.js` | 使用Ollama处理 |
| 🔧 **本地处理** | `node scripts/optimize-dist.js --local` | 不使用AI的快速处理 |
| 🔄 **重新处理** | `node scripts/optimize-dist.js --clear-cache` | 清除缓存后重新处理 |

## 🛠️ 环境准备

### 安装Ollama（如需使用AI）
```bash
# Windows
# 从 https://ollama.com/ 下载安装

# macOS
brew install ollama

# Linux
curl -fsSL https://ollama.com/install.sh | sh
```

### 启动服务
```bash
ollama serve
```

### 下载模型
```bash
ollama pull deepseek-coder:6.7b
```

## 📊 性能对比

运行性能测试查看各方法效果：
```bash
node scripts/performance-test.js
```

典型结果：
```
Method                 | Time (ms) | Files | Reduction | Avg/File
-----------------------|-----------|-------|-----------|----------
Optimized Parallel     |      1250 |    50 |     4500  |    25.0
State Machine (Medium) |      2100 |    50 |     4450  |    42.0
Regex (Fast)          |       800 |    50 |     4300  |    16.0
Ollama AI (Accurate)   |      8500 |    50 |     4600  |   170.0
```

## 🎯 使用建议

### 生产环境
```bash
node scripts/optimize-dist.js
```
- ✅ 使用AI确保准确性
- ✅ 并行处理提高速度
- ✅ 缓存避免重复处理

### 开发环境
```bash
node scripts/optimize-dist.js --local
```
- ⚡ 更快的处理速度
- 💻 不依赖Ollama服务

### CI/CD环境
```bash
node scripts/optimize-dist.js --single --clear-cache
```
- 🔒 单线程避免并发问题
- 🔄 每次都全新处理

## 📁 文件说明

```
scripts/
├── optimize-dist.js           # 🚀 推荐使用 - 优化处理dist目录
├── optimized-processor.js     # ⚙️ 核心引擎 - 并行+缓存+增量处理
├── performance-test.js         # 📊 性能测试 - 对比不同方法
├── ollama-console-remover.js   # 🤖 AI处理器 - 原始Ollama版本
├── process-dist.js             # 📋 基础版本 - 简单dist处理
├── test-ollama.js              # 🧪 连接测试 - 测试Ollama状态
├── README-OLLAMA.md            # 📖 详细文档
└── QUICK-START.md              # ⚡ 本文件 - 快速开始
```

## 🔧 常见问题

### Q: Ollama连接失败？
A: 确保服务正在运行：
```bash
ollama serve
curl http://localhost:11434/api/tags
```

### Q: 处理速度慢？
A: 使用本地方法或并行处理：
```bash
node scripts/optimize-dist.js --local
```

### Q: 文件没被处理？
A: 检查是否已缓存，清除缓存重试：
```bash
node scripts/optimize-dist.js --clear-cache
```

### Q: 想只看处理效果？
A: 使用预览模式：
```bash
node scripts/optimize-dist.js --dry-run
```

## 🎉 开始使用！

选择适合你需求的命令开始：

```bash
# 新手推荐
node scripts/optimize-dist.js --dry-run

# 日常使用
node scripts/optimize-dist.js

# 性能测试
node scripts/performance-test.js
```

有问题？查看 [README-OLLAMA.md](./README-OLLAMA.md) 获取详细说明。