chore: 增加scripts目录

This commit is contained in:
2025-12-28 08:13:13 +08:00
parent bc89550a28
commit f6d9f5255e
23 changed files with 4817 additions and 2638 deletions

View File

@@ -0,0 +1,154 @@
# 🚀 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) 获取详细说明。