154 lines
3.8 KiB
Markdown
154 lines
3.8 KiB
Markdown
# 🚀 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) 获取详细说明。 |