读完本文，你将能独立完成米斯顿葛的安装、参数配置、日常校准与典型故障修复，无需再依赖模糊的“经验之谈”。
---
之一步：环境准备与基础安装
米斯顿葛对运行环境敏感，请按以下顺序操作：
1. 确认硬件更低要求：CPU需支持AVX2指令集，内存不低于8GB（推荐16GB），硬盘预留至少20GB空间（固态硬盘优先，避免机械盘导致随机读写延迟）。
2. 安装依赖库：在终端执行 `sudo apt update && sudo apt install -y build-essential libssl-dev libzstd-dev`（Ubuntu/Debian系）。若使用CentOS，将apt换为yum，并额外安装`epel-release`。
3. 解压米斯顿葛主程序包至`/opt/miston_ge/`，并运行 `./miston_ge --init`。该命令会生成默认配置目录`~/.miston_ge/`，内含`config.toml`、`rules.db`和`logs/`。
4. 验证安装：执行 `miston_ge --version`，输出形如`v4.2.1 (build 2025-03-01)`即成功。若报错“libcrypto.so.3缺失”，请用`ln -s /usr/lib/x86_64-linux-gnu/libssl.so.3 /usr/lib/libcrypto.so.3`临时解决，然后重新编译依赖。
第二步：核心参数配置（config.toml）
编辑`~/.miston_ge/config.toml`，重点调整以下字段（不要动其他默认值）：
- `[core]`区：`thread_pool = 4`（根据CPU核数减2设定），`cache_size = 2048`（单位MB，若内存紧张可降至1024）。
- `[io]`区：`read_buffer = 64`（KB），`write_buffer = 128`（KB）。若处理大文件（>1GB），将`read_buffer`提升至256，但写缓冲不要超过256，否则内存峰值暴涨。
- `[safety]`区：`auto_backup = true`，`backup_interval = 3600`（秒）。首次运行务必开启，防止后续调坏参数。
- 保存后执行 `miston_ge --check-config`，若提示“invalid key: core.thread_pool”请检查是否拼写错误（常见坑：写成`thread_pool`而非`thread_pool`）。
第三步：规则库初始化与导入
1. 创建你的首个规则文件`my_rules.json`，格式如下：
```json
[{"name": "过滤重复行", "action": "dedup", "target": "line", "params": {"case_sensitive": false}}]
```
2. 导入规则：`miston_ge --import-rules my_rules.json`。导入后执行`miston_ge --list-rules`，应显示已加载规则及ID。
3. 若需批量导入，将多个规则放入同一 ON数组，注意`name`字段全局唯一，否则后导入的会覆盖先前的（不会报错，只会静默替换）。
第四步：运行与实时监控
1. 启动服务：`miston_ge --daemon --log-level info`。使用`--log-level debug`可输出每步操作细节，但生产环境慎用，会拖慢性能30%以上。
2. 实时查看处理队列：`miston_ge --status`，输出中关注`queue_depth`（正常应<100）和`error_rate`（若>0.5%需立即排查）。
3. 测试单条数据：将待处理文本写入`test_input.txt`，执行`miston_ge --process test_input.txt --output test_output.txt`，对比输出是否符合预期。若输出为空，检查规则中的`target`字段是否写错（如`line`误写为`row`）。
第五步：日常校准与参数微调
每运行48小时后，建议执行一次校准：
1. 运行 `miston_ge --calibrate --sample 5000`，它会从日志中抽取样本并生成`calibration_report.html`。
2. 打开报告，重点看“延迟分位图”（P95延迟若>200ms则需调大`thread_pool`）和“内存抖动指数”（若>0.7则降低`cache_size`）。
3. 根据报告修改`config.toml`，然后执行`miston_ge --reload`热加载配置，无需重启进程。
第六步：常见故障修复
- 症状1：处理卡死，`--status`显示`queue_depth`持续增长
修复：执行`miston_ge --pause`，然后`miston_ge --drop-queue`清空积压，检查是否有规则导致死循环（如“去重”规则误配为“全表扫描”）。修复后`--resume`。
- 症状2：输出乱码或中文丢失
修复：在`config.toml`的`[io]`区添加`encoding = "utf-8"`，并确保输入文件已转码。不要使用`--force-encoding`，它只改标识不实际转换。
- 症状3：启动即崩溃，无日志
修复：删除`~/.miston_ge/cache/`下所有文件，并运行`miston_ge --rebuild-db`。若仍崩溃，查看`dmesg | tail -20`，确认是否内存溢出（OOM）。
---
常见坑提醒
1. 千万别用`--skip-backup`省事——一旦配置写错，恢复只能靠手动改回默认值，非常痛苦。
2. 规则中的正则表达式默认不转义`\`，如需匹配反斜杠，必须写`\\\\`。
3. 不要同时运行两个`miston_ge --daemon`进程，会锁死`rules.db`导致数据损坏。
4. `--calibrate`必须在无负载时运行，否则采样数据失真，校准结果反而劣化性能。
5. 升级版本前务必导出规则：`miston_ge --export-rules > backup_rules.json`，新版可能更改规则字段名，不导出则全部失效。
