awesome-digital-human本地部署及配置：打造高情绪价值互动指南

在数字化交互的浪潮中，awesome-digital-human-live2d项目为我们打开了本地数字人互动的大门。结合 dify 聊天 api，并借鉴 coze 夸夸机器人的设计思路，能为用户带来充满情绪价值的交互体验。本文将详细介绍其本地部署步骤、dify 配置方法及情绪价值提升策略。
一、环境准备
部署前需确保本地环境满足要求：
硬件要求：CPU 至少 2 核，内存 2GB 以上。
操作系统：推荐 Ubuntu（裸机部署），或支持 Docker 的系统（容器部署）。
软件工具：安装 Python、Node.js（版本 14 及以上）、npm、Git，Linux 系统还需安装ffmpeg。
二、克隆项目代码
打开命令行工具，执行以下命令克隆项目：
git clone https://github.com/wan-h/awesome-digital-human-live2d.git
cd awesome-digital-human-live2d

三、部署项目

1. 容器部署（推荐）
   容器部署环境隔离性好，操作简便，需提前安装Docker和Docker Compose。在项目根目录下执行：
   docker-compose up --build -d

2. 裸机部署（适用于开发环境）
   后端部署：

安装后端依赖

pip install -r requirements.txt

Linux系统安装ffmpeg

sudo apt install ffmpeg

启动后端服务

python main.py

前端部署：
cd web

安装pnpm

npm install -g pnpm

安装前端依赖

npm install

构建项目

npm run build

启动前端服务

npm run start

四、配置 dify 聊天 api

1. 注册与创建应用
   访问dify 官方网站完成注册登录，进入控制台创建新的聊天应用，获取应用的 API 密钥和访问地址。

2. 项目配置
   方式一：在前端界面点击Settings > 服务 > DifyAgent，填入dify_url和dify_key。
   方式二：直接修改配置文件configs/agents/difyAgent.yaml：
   DEFAULT:
   dify_url: “https://api.dify.ai/v1/chat-messages”
   dify_key: “your_dify_api_key”

3. 借鉴 coze 夸夸机器人思路
   预设话术库：在 dify 配置中构建丰富的夸夸话术，针对用户不同场景的输入设置对应回复。例如用户分享成功，回复 “太牛了！这实力简直碾压全场，必须给你点 10086 个赞！”
   情感智能响应：利用 dify 的自然语言处理能力分析用户情感，根据情绪高低给出不同风格的夸赞。
   个性化互动：为数字人设置独特口头禅，如回复结尾加上 “本夸夸小能手在线营业！”
   

五、访问与使用
本地访问：打开浏览器输入http://localhost:3000。
远程访问：输入服务器 IP 地址和端口，如http://{服务器IP}:3000。
使用时可通过快捷键Ctrl + M开启 / 关闭语音交互。
六、常见问题及解决
ASR 引擎失败：默认 Google 接口不稳定，可在configs/config.yaml中将ASR.DEFAULT改为BaiduAPI，并配置百度的 AK 和 SK。
跨域问题：确保前端.env中的NEXT_PUBLIC_ADH_SERVER_IP和PORT与后端一致。
容器部署失败：检查 Docker 和 Docker Compose 版本兼容性，Windows 用户参考Q&A.md调整配置。
完成上述步骤，你就拥有了具备高情绪价值的互动数字人。若想进一步自定义 Live2D 模型，可替换web/app/lib/live2d/models目录下的文件，探索更多玩法。
以上内容涵盖部署、配置及优化技巧，若你在实践中有新需求，比如调整功能模块或解决特定问题，欢迎随时交流。