安装前先确认硬件与运行库满足要求,再选择安装方式,最后了解目录约定与配置位置。
系统要求
| 项目 | 要求 |
|---|---|
| 操作系统 | Windows 10 / 11(x64) |
| GPU | NVIDIA GPU + 最新驱动(CUDA 加速);无显卡也可运行小模型,但速度会慢很多 |
| 运行库 | VC++ 运行库(x64) |
| 内存 / 磁盘 | 建议 8GB+ 内存;GGUF 模型通常 2GB~50GB,请预留足够磁盘 |
提示:模型量化等级(如 Q4_K_M)决定显存占用,显存不足时可选择更小量化版本,详见 12 · 故障排查。
获取安装包
从官方渠道获取最新版本:
- 官网:https://wanaigc.com
- 内置更新器:应用启动后后台静默检查新版本并下载,完成后点「立即安装」即可
LMPanel 提供便携版(解压即用)与安装版两种形态,功能一致,按习惯选择。
安装 / 运行方式
便携版:
- 解压到任意目录(建议路径中不含中文与空格,例如
D:\LMPanel) - 双击
LMPanel.exe启动
安装版:
- 运行安装程序,按向导完成安装
- 从开始菜单或桌面快捷方式启动
目录约定
LMPanel 按以下目录组织(以安装目录为例):
<安装目录>
├── LMPanel.exe # 主程序
├── backends # 推理后端
│ ├── llama.cpp # 文本推理引擎(llama-server)
│ ├── llama-swap # 多模型网关
│ ├── stable-diffusion.cpp # 图像生成
│ └── whisper.cpp # 语音识别
└── models # GGUF 模型文件(可在设置中增配多个目录)
配置存放位置
- 配置与备份存放于
%APPDATA%LMPanel - 核心配置文件为
config.yaml(YAML 格式,内含模型与网关定义) - 可在 设置 中将配置目录迁移到其他位置
演示图占位
此处放:安装向导 / 首次启动引导
说明:安装包运行后进入首启引导,顶部提示进入设置安装后端
首次启动
- 双击
LMPanel.exe - 顶部出现引导条时,跟随进入 设置 → 后端与依赖
- 一键安装
llama.cpp与llama-swap(联网下载预编译二进制) - 若防火墙弹窗询问,需允许后端进程监听本地端口,否则网关无法工作
常见问题
| 现象 | 处理 |
|---|---|
| 双击无反应 | 检查 VC++ 运行库是否安装,右键以管理员身份运行一次 |
| 提示未检测到网络连接 | 模型搜索/下载与更新不可用;本地已启动的模型不受影响 |
| 防火墙询问 | 需允许 llama-swap 监听本地端口,否则网关无法工作 |
下一步
→ 03 · 三步上手 安装后端、添加模型、跑通第一个对话