在數字化交互的浪潮中，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目錄下的文件，探索更多玩法。
以上內容涵蓋部署、配置及優化技巧，若你在實踐中有新需求，比如調整功能模塊或解決特定問題，歡迎隨時交流。