📘 GGUF 迁移避坑指南
30章 · 从入门到实战
🧩 友好色系
01
GGUF格式初探
什么是GGUF?与GGML、PyTorch的关系,为什么大模型需要GGUF?
02
环境准备
安装llama.cpp,Windows/Linux/Mac踩坑,Python绑定安装。
03
模型获取
HuggingFace筛选技巧,模型卡解读,GGUF模型下载。
04
量化基础
量化是什么?GGUF量化类型:q2_k~q8_0。
05
量化级别选择
性能与质量权衡,实测数据分享。
06
模型转换 (PyTorch→GGUF)
convert.py脚本使用,常见报错及解决方案。
07
模型转换 (其他格式→GGUF)
SafeTensors、AWQ、GPTQ等格式转换注意事项。
08
量化实操
llama-quantize工具,参数详解,批量量化技巧。
09
模型加载与推理
llama.cpp加载模型,命令行推理参数调优。
10
Python调用GGUF模型
llama-cpp-python库使用,API封装,流式输出。
11
性能调优
线程数、GPU加速(CUDA/Metal/Vulkan)、批处理大小。
12
内存管理
内存占用计算,上下文长度设置,KV Cache优化。
13
上下文窗口
窗口大小影响,RoPE缩放。
14
Prompt工程
GGUF模型Prompt格式,角色设定,System Prompt技巧。
15
函数调用 (Function Calling)
GGUF模型支持函数调用吗?如何实现?
16
流式输出
打字机效果,WebSocket推送,前端对接。
17
多轮对话
对话历史管理,Token计数,上下文溢出处理。
18
模型合并与分片
大模型分片存储,合并GGUF文件,分片加载。
19
自定义量化
修改量化参数,混合精度量化,实验性方案。
20
模型评估
评估量化后模型质量,Perplexity计算,下游任务测试。
21
常见错误 (一)
Shape不匹配、Tensor缺失、版本兼容问题。
22
常见错误 (二)
Segmentation Fault,内存不足,CUDA OOM。
23
常见错误 (三)
推理乱码,重复生成,输出截断。
24
安全与合规
使用许可,模型来源验证,数据隐私。
25
服务化部署
llama.cpp server模式,RESTful API,Docker部署。
26
WebUI集成
对接Text Generation WebUI、Ollama、LocalAI。
27
边缘设备部署
树莓派、手机、嵌入式设备运行GGUF模型。
28
模型微调与GGUF
LoRA微调后转GGUF,合并LoRA权重。
29
社区资源
GGUF模型排行榜,工具链,优质博客推荐。
30
未来展望
GGUF发展方向,新兴量化技术,行业趋势分析。