Nanbeige 4.1-3B保姆级教程：从Docker镜像拉取到像素对话上线

Nanbeige 4.1-3B保姆级教程：从Docker镜像拉取到像素对话上线

1. 环境准备与快速部署

1.1 系统要求

• 操作系统：Linux (推荐Ubuntu 20.04+) 或 macOS
• 显卡：NVIDIA GPU (显存≥16GB)
• Docker：版本≥19.03
• Python：版本3.8-3.10

1.2 一键部署命令

# 拉取预构建镜像 docker pull registry.cn-hangzhou.aliyuncs.com/nanbeige/nanbeige-rpg:4.1-3b # 启动容器 (根据显存调整--gpus参数) docker run -it --gpus all -p 8501:8501 registry.cn-hangzhou.aliyuncs.com/nanbeige/nanbeige-rpg:4.1-3b

启动后访问http://localhost:8501即可看到像素风格的聊天界面。

2. 界面功能详解

2.1 核心交互区域

• 输入框：底部蓝色区域，输入你的对话内容
• 发送按钮：右侧金色按钮，提交问题
• 重置按钮：红色RESET按钮，清空对话历史

2.2 对话显示区

• 玩家气泡：蓝色对话框，显示你的提问
• AI回复：绿色对话框，带像素动画效果
• 思考过程：灰色系统日志区，展示<think>标签内容

3. 进阶使用技巧

3.1 特殊指令

# 触发系统功能 /reset - 清空对话上下文 /think on - 显示思考过程 /think off - 隐藏思考过程 # 示例对话 你: /think on NANBEIGE LV.99: [系统] 思考日志显示已开启

3.2 自定义样式

修改style.css可以调整界面颜色：

/* 修改玩家气泡颜色 */ .player-bubble { background-color: #5D8BF4; /* 新蓝色值 */ border: 4px solid #2C2C2C; }

4. 常见问题解决

4.1 性能优化

• 显存不足：在启动命令中添加环境变量限制显存

docker run -it --gpus all -e MAX_MEMORY=12GB -p 8501:8501 [镜像名]

• 响应慢：调整config.yml中的参数

generation: max_new_tokens: 1024 # 减少生成长度 temperature: 0.7 # 降低随机性

4.2 故障排除

• 界面不显示：检查8501端口是否被占用
• 模型加载失败：确认Docker有GPU访问权限
• 样式异常：清除浏览器缓存强制刷新

5. 总结

通过本教程，您已经完成：

1. 成功部署Nanbeige 4.1-3B的像素风格对话界面
2. 掌握基本交互和特殊指令使用方法
3. 学会自定义界面样式和性能调优
4. 能够解决常见运行问题

建议下一步尝试：

• 修改CSS创建自己的主题风格
• 结合API开发游戏化应用
• 探索<think>标签的更多创意用法

获取更多AI镜像

想探索更多AI镜像和应用场景？访问 CSDN星图镜像广场，提供丰富的预置镜像，覆盖大模型推理、图像生成、视频生成、模型微调等多个领域，支持一键部署。