Nanbeige 4.1-3B部署教程：解决Windows路径编码问题导致CSS样式丢失
1. 项目介绍
Nanbeige 4.1-3B是一款具有独特像素游戏风格的AI对话前端，专为Nanbeige大语言模型设计。这个项目将现代AI技术与复古JRPG视觉美学完美结合，为用户带来全新的交互体验。
1.1 核心特点
- 像素游戏风格UI：采用4px像素边框和高饱和度配色方案
- 角色化对话界面：区分玩家(蓝色气泡)和AI(绿色气泡)的对话样式
- 流式文本渲染：模拟老式游戏机的文字显示效果
- 思考过程可视化：通过
<think>标签展示模型推理过程
2. 环境准备
2.1 系统要求
- 操作系统：Windows 10/11 (本教程主要解决Windows特有问题)
- Python版本：3.8或更高
- GPU：推荐NVIDIA显卡(显存≥8GB)
- 磁盘空间：至少10GB可用空间
2.2 安装依赖
pip install streamlit transformers torch3. 部署步骤
3.1 下载项目代码
git clone https://github.com/your-repo/nanbeige-rpg-ui.git cd nanbeige-rpg-ui3.2 配置模型路径
在项目根目录创建.env文件，添加以下内容：
MODEL_PATH=./models/nanbeige-4.1-3b3.3 解决Windows路径编码问题
这是本教程要解决的核心问题。Windows系统默认使用GBK编码，而项目中的CSS文件使用UTF-8编码，会导致样式丢失。
3.3.1 修改Streamlit启动脚本
找到main.py文件，在开头添加以下代码：
import os import sys import locale # 强制使用UTF-8编码 if sys.platform == "win32": os.environ["PYTHONUTF8"] = "1" sys.stdin.reconfigure(encoding='utf-8') sys.stdout.reconfigure(encoding='utf-8') sys.stderr.reconfigure(encoding='utf-8') locale.setlocale(locale.LC_ALL, 'en_US.UTF-8')3.3.2 修改CSS文件加载方式
找到项目中加载CSS的部分，通常是在主程序文件中，修改为：
def load_css(file_name): with open(file_name, "r", encoding="utf-8") as f: st.markdown(f"<style>{f.read()}</style>", unsafe_allow_html=True)4. 启动应用
4.1 运行命令
streamlit run main.py4.2 验证CSS加载
启动后检查以下元素确认样式已正确加载：
- 页面应有4px像素边框
- 对话框颜色应符合设计规范(玩家蓝色，AI绿色)
- 背景应为温暖的复古纸张色(#FDF6E3)
5. 常见问题解决
5.1 样式仍然丢失
如果样式仍未正确加载，尝试以下步骤：
- 检查CSS文件编码确认为UTF-8
- 确保Python脚本以UTF-8编码保存
- 在Windows系统设置中将区域设置为"英语(美国)"
5.2 模型加载失败
如果模型无法加载：
# 修改模型加载代码，添加低资源模式 @st.cache_resource def load_model(): return AutoModelForCausalLM.from_pretrained( "nanbeige-4.1-3b", device_map="auto", torch_dtype=torch.float16, low_cpu_mem_usage=True )5.3 流式输出不工作
确保使用了正确的流式输出方法：
for chunk in response: print(chunk, end="", flush=True)6. 总结
通过本教程，您已经成功部署了Nanbeige 4.1-3B的像素游戏风格前端，并解决了Windows系统下因路径编码导致的CSS样式丢失问题。这套系统不仅功能强大，还为用户提供了独特的视觉体验。
获取更多AI镜像
想探索更多AI镜像和应用场景？访问 CSDN星图镜像广场，提供丰富的预置镜像，覆盖大模型推理、图像生成、视频生成、模型微调等多个领域，支持一键部署。
