剑侠AI · 本地聊天整合包 必备依赖下载与报错对照
剑侠AI · 本地聊天整合包必备依赖下载与报错对照
========================================
适用：JianxiaChat v1.22版本
建议：装完依赖后重启电脑，再运行整合包根目录「本地引擎诊断.bat」自检。
------------------------------------------------
【依赖 1】Visual C++ 2015–2022 x64（必装，优先级最高）
------------------------------------------------
名称
Microsoft Visual C++ v14 Redistributable (x64)
也叫：VC++ 2015-2022 运行库 / vc_redist.x64
用途
本地推理引擎 llama-server.exe 运行必需。
官方下载（直接安装包）
https://aka.ms/vc14/vc_redist.x64.exe
说明页（微软文档）
https://learn.microsoft.com/zh-cn/cpp/windows/latest-supported-vc-redist
页面中选择「X64」即可。
不安装时常见报错 / 现象
· 模型一切换就失败，界面「后端未连接」
· 退出码：3221225477 或 -1073741819
· 日志：0xC0000005 内存访问冲突（Access Violation）
· 「本地引擎诊断.bat」里：llama-server --version 直接崩溃
· 云端聊天正常，本地模型怎么换都失败
· CPU 模式同样崩溃（不是显存不够）
安装提示
必须装 x64（64位），不要只装 x86。
装完建议重启后再开整合包。
------------------------------------------------
【依赖 2】NVIDIA 显卡驱动（N 卡必装 / 必更新）
------------------------------------------------
名称
NVIDIA GeForce / Studio 驱动（支持 CUDA 12）
用途
本包 NVIDIA 本地加速使用 CUDA 版 llama-server。
官方下载
驱动下载页：
https://www.nvidia.cn/Download/index.aspx?lang=cn
或：
https://www.nvidia.com/Download/index.aspx
GeForce Experience（可选）：
https://www.nvidia.cn/geforce/geforce-experience/
建议版本
驱动一般建议 >= 535，越新越好。
检查方法：CMD 输入 nvidia-smi，看 Driver Version。
不安装 / 驱动过旧时常见报错 / 现象
· CUDA 后端启动失败，反复回退 CPU
· 模型加载超时、显存识别异常
· nvidia-smi 打不开或找不到命令
· 日志出现 CUDA / dll / driver 相关错误
A 卡用户注意
不要依赖本条 CUDA 驱动。
请用整合包内「A卡专用启动器.bat」（Vulkan）。
AMD 驱动下载：
https://www.amd.com/zh-hans/support/download/drivers.html
------------------------------------------------
【依赖 3】Microsoft Edge WebView2 Runtime（正式启动器需要）
------------------------------------------------
名称
Microsoft Edge WebView2 运行时
用途
「双击-剑侠启动器.exe」内嵌窗口显示界面。
官方下载页
https://developer.microsoft.com/zh-cn/microsoft-edge/webview2/
推荐下载
Evergreen Bootstrapper（在线安装，体积小）
或 Evergreen Standalone Installer x64（离线完整包）
不安装时常见报错 / 现象
· 双击正式启动器后窗口空白 / 闪退 / 提示无法创建内嵌窗口
· 提示需要安装 WebView2
临时绕过
可改用「剑侠备用启动器.bat」（系统浏览器打开，不依赖 WebView2）
------------------------------------------------
【依赖 4】杀毒 / 防火墙白名单（强烈建议，不算安装包但必须做）
------------------------------------------------
操作
把「整个整合包文件夹」加入 360 / 火绒 / QQ电脑管家 / Windows Defender 信任区。
重点放行文件
· runtime\python\python.exe
· python\llama-server.exe
· python-vulkan\llama-server.exe（若有）
· python\ggml-cuda.dll
· python\cudart64_12.dll
· python\cublas64_12.dll
不做白名单时常见报错 / 现象
· http://127.0.0.1:8765/ 打不开，但控制台已提示服务启动
· llama-server / DLL 被隔离，启动即崩或文件突然缺失
· 模型加载失败、诊断提示关键 DLL 丢失
· 网页提示后端未连接
-----------------------------------------------
【依赖 5】Windows 系统要求（环境）
------------------------------------------------
建议
· Windows 10 / 11 64位
· 内存建议 16GB 及以上（小模型可更低）
· 本地模型放在 Models\ 目录，使用「对话用」GGUF
（不要把 Flux / SD 文生图权重当聊天模型）
------------------------------------------------
安装顺序（推荐）
------------------------------------------------
1. 安装 VC++ x64（必装）
2. 更新显卡驱动（N 卡 / A 卡按自己显卡）
3. 安装 WebView2（要用正式 exe 启动器时）
4. 杀软加白名单
5. 重启电脑
6. 运行「本地依赖诊断.bat」
7. 再双击启动器使用
------------------------------------------------
报错速查表
------------------------------------------------
现象 / 退出码 优先检查
-----------------------------------------------
0xC0000005 / 3221225477 / --version崩 VC++ x64、杀软白名单、重解压 python\
后端未连接 + 云端正常 同上（本地引擎没起来）
正式启动器窗口空白/闪退 WebView2；或改用备用启动器.bat
8765 网页打不开 杀软/防火墙；看控制台是否 Uvicorn running
CUDA 失败 / 显存异常（N卡） NVIDIA 驱动更新
A卡只吃内存 / 显存0 A卡专用启动器.bat + AMD驱动
模型切换超时 换更小模型、降上下文、看 data\runtime.log
Flux/文生图 GGUF 加载失败 模型类型错误，请换聊天 GGUF
------------------------------------------------
自检工具
------------------------------------------------
整合包根目录：
· 本地引擎诊断.bat
· 必备依赖与常见问题.txt（更详细 FAQ）
仍无法解决时请提供：
1) 本地引擎诊断.bat 完整输出
2) data\runtime.log 末尾
3) nvidia-smi 截图（N卡）
4) 是否已装 VC++ x64、使用哪家杀软
作者：剑侠君
========================================
评论列表（暂无评论）
还没有评论，来说两句吧…