当前位置：首页 > news >正文

Nanbeige 4.1-3B实操手册：自定义LV.99贤者头像与语音提示音效接入

news 2026/5/12 19:14:14

Nanbeige 4.1-3B实操手册：自定义LV.99贤者头像与语音提示音效接入

1. 项目概述

Nanbeige 4.1-3B像素冒险聊天终端是一款专为对话AI设计的复古风格交互界面。它将传统的大模型对话体验转化为充满游戏感的冒险旅程，让每次交流都像在玩一款经典的JRPG游戏。

核心特色包括：

完全自定义的像素游戏UI界面
角色扮演式的对话体验（玩家VS贤者）
支持流式输出与思考过程可视化
高度可定制的视觉元素和音效系统

2. 环境准备与快速部署

2.1 系统要求

Python 3.8+
NVIDIA GPU（推荐显存≥16GB）
已安装Git和CUDA环境

2.2 一键安装

git clone https://github.com/nanbeige/pixel-chat-terminal.git cd pixel-chat-terminal pip install -r requirements.txt

2.3 快速启动

streamlit run app.py --server.port 8501

启动后浏览器访问http://localhost:8501即可进入聊天界面。

3. 自定义贤者头像设置

3.1 头像规格要求

尺寸：256x256像素
格式：PNG（支持透明背景）
风格：建议使用像素艺术风格

3.2 替换默认头像

准备符合要求的头像文件（如sage.png）
将其放入项目目录的assets/avatars/文件夹
修改config.py中的配置项：

BOT_AVATAR = "assets/avatars/sage.png"

3.3 动态头像进阶设置

如需实现表情变化效果，可创建多张不同表情的头像，然后在ui_logic.py中添加切换逻辑：

def get_avatar(emotion="default"): return f"assets/avatars/sage_{emotion}.png"

4. 语音提示音效接入

4.1 音效文件准备

格式：WAV或MP3
时长：建议0.5-2秒
存放路径：assets/sounds/

4.2 基础音效配置

在config.py中设置以下参数：

SOUND_CONFIG = { "startup": "assets/sounds/startup.wav", "message_sent": "assets/sounds/send.wav", "message_received": "assets/sounds/receive.wav", "error": "assets/sounds/error.wav" }

4.3 实现音效播放

在audio_utils.py中添加播放逻辑：

import pygame def play_sound(sound_type): pygame.mixer.init() sound = pygame.mixer.Sound(SOUND_CONFIG[sound_type]) sound.play()

5. 完整配置示例

5.1 配置文件结构

# config.py 完整示例 UI_THEME = { "background": "#FDF6E3", "player_bubble": "#4D96FF", "bot_bubble": "#6BCB77", "border": "4px solid #2C2C2C" } AVATAR_CONFIG = { "player": "assets/avatars/hero.png", "bot": "assets/avatars/sage.png" } SOUND_CONFIG = { "startup": "assets/sounds/startup.wav", "message_sent": "assets/sounds/sword.wav", "message_received": "assets/sounds/magic.wav" }

5.2 主题效果预览

元素	效果描述
玩家对话框	蓝色气泡+剑击音效
AI回复	绿色气泡+魔法音效
系统消息	金色边框+宝箱开启音效
错误提示	红色边框+警报音效