# 给非技术同事的安装说明:真实配置的经验
Contents
# 「给非技术同事的安装说明」的背景
一条路径、截图、热线。软件是本地 AI 栈里变化最快的部分。上个月还好好的配置,可能因为驱动更新、运行时升级或模型打包方式变化而出问题。一份简短的书面流程能让这些变化变得平淡无奇。
# 最小流程
- 改动前记下操作系统、显卡驱动、运行时版本和模型文件。
- 只做一项改动:新运行时、新量化、新上下文长度或新模型。
- 用同一组十到二十个提示词测试,语言要和用户实际使用的一致。
- 把回答和资源占用与上一次对比。
- 保留或回滚,并写下决定和日期。
# 安装方式的选择
单机上原生安装最简单,也能避开显卡直通的麻烦。多个服务共用一台主机或需要可复现部署时,容器更合适;模型用挂载卷,不要把几十 GB 的权重打进镜像。Windows 上 WSL2 很好用,但虚拟磁盘会悄悄变大,要盯住剩余空间。macOS 上先决定用 llama.cpp 还是 MLX,并保持目录结构整洁。
# 值得写进文档的设置
- 团队默认温度和系统提示词,例外要写理由。
- 每个模型的上下文长度和并行槽位数。
- 启用了哪些功能:工具调用、推测解码、图像输入。
- 日志存在哪里、保留多久。
# 出问题时
收集完整的报错文本、触发它的命令或界面操作,以及当时的资源占用。很多报告最后发现是内存不足、提示词模板不对或文件没下完整。发帖前先搜共享的故障维基,找到解决办法后补进去。
# 一个排错小故事
某团队反馈,本地模型升级后突然“不会中文了”。原因根本不在模型:新版运行时换了默认提示词模板,而他们拉取的量化文件也和测试时不是同一个变体。回滚运行时后问题消失,诊断得到确认。随后他们同时固定了运行时版本和模型校验值,把模板写进配置文件,并在下次升级前重新跑评测提示词。修复只花了一个下午,真正的收获是:运行时和模型文件要像其他依赖一样做版本管理。
延伸阅读:Windows 上 Dify + Ollama,以及显存与模型尺寸速查表。
# 速记要点
- 每次大版本模型升级后重新检查配置。
- 离线演示准备纸质备用方案。
- 给系统和嵌入模型留出内存余量。
- 检索文本和上传文件一律视为不可信。
作者:本地AI 1号网,深圳团队,专注本地大模型软硬件、装机与私有化部署。
End