---
title: "提示词版本号放哪不易丢：动手前要问的问题"
url: https://memory.wiki/V8InaFrR
updated: 2026-11-14T21:58:11.444Z
source: "memory.wiki"
---
# 提示词版本号放哪不易丢：动手前要问的问题

## 「提示词版本号放哪不易丢」的背景

git 存 ID；日志粘贴同一 ID。软件是本地 AI 栈里变化最快的部分。上个月还好好的配置，可能因为驱动更新、运行时升级或模型打包方式变化而出问题。一份简短的书面流程能让这些变化变得平淡无奇。

## 最小流程

1. 改动前记下操作系统、显卡驱动、运行时版本和模型文件。
2. 只做一项改动：新运行时、新量化、新上下文长度或新模型。
3. 用同一组十到二十个提示词测试，语言要和用户实际使用的一致。
4. 把回答和资源占用与上一次对比。
5. 保留或回滚，并写下决定和日期。

## 安装方式的选择

单机上原生安装最简单，也能避开显卡直通的麻烦。多个服务共用一台主机或需要可复现部署时，容器更合适；模型用挂载卷，不要把几十 GB 的权重打进镜像。Windows 上 WSL2 很好用，但虚拟磁盘会悄悄变大，要盯住剩余空间。macOS 上先决定用 llama.cpp 还是 MLX，并保持目录结构整洁。

## 值得写进文档的设置

- 团队默认温度和系统提示词，例外要写理由。
- 每个模型的上下文长度和并行槽位数。
- 启用了哪些功能：工具调用、推测解码、图像输入。
- 日志存在哪里、保留多久。

## 出问题时

收集完整的报错文本、触发它的命令或界面操作，以及当时的资源占用。很多报告最后发现是内存不足、提示词模板不对或文件没下完整。发帖前先搜共享的故障维基，找到解决办法后补进去。

## 一个排错小故事

某团队反馈，本地模型升级后突然“不会中文了”。原因根本不在模型：新版运行时换了默认提示词模板，而他们拉取的量化文件也和测试时不是同一个变体。回滚运行时后问题消失，诊断得到确认。随后他们同时固定了运行时版本和模型校验值，把模板写进配置文件，并在下次升级前重新跑评测提示词。修复只花了一个下午，真正的收获是：运行时和模型文件要像其他依赖一样做版本管理。

相关资料可参考[MicroAI One 软件](https://microaione.com/microai-one/)，另见[Windows 上 Dify + Ollama](https://microaione.com/tutorials/dify-local-llm-windows-ollama/)。


## 速记要点

- 演练恢复，而不只是做备份。
- 驱动和运行时版本一起固定。
- 合侧板前给走线拍照。
- 新模型通过评测前保留旧文件。

*作者：[本地AI 1号网](https://microaione.com/)，深圳团队，专注本地大模型软硬件、装机与私有化部署。*

---

## Summary
本地AI环境配置多变，应通过记录版本信息、执行单项测试和建立标准化文档来确保系统稳定性。运行时与模型文件需像代码依赖一样进行版本管理，以避免环境升级导致的性能或功能异常。

## Themes
- local AI deployment
- version control practices
- troubleshooting workflows
- system configuration management

## Key takeaways
- Documenting operating system, driver, runtime, and model versions before making changes is a critical step for recovery.
- Testing changes with a consistent set of prompts is necessary to validate performance and resource usage.
- Model weights should be stored in mounted volumes rather than embedded directly into container images.
- Documenting team defaults for temperature, system prompts, and context lengths prevents configuration drift.
- Troubleshooting should prioritize collecting full error logs and resource usage data before seeking external help.

## Insights
- The most frequent causes of local AI failure are often environmental changes like driver updates or runtime shifts rather than the model weights themselves.
- Treating AI runtimes and model files as software dependencies with strict version locking is essential for system stability.
- Virtual disk expansion in WSL2 is a hidden operational risk that requires proactive monitoring.

## Open questions / gaps
- What specific criteria should be used to determine the optimal size and composition of the test prompt set for different model types?

