From 4f93eaf251327174c97a47da17272185f4fa282e Mon Sep 17 00:00:00 2001
From: ZF sun <34314687@qq.com>
Date: Fri, 24 Apr 2026 10:01:40 +0800
Subject: [PATCH] =?UTF-8?q?Update=20=E5=8D=8E=E4=B8=BA=E4=BA=91MetaStudio?=
=?UTF-8?q?=E4=BA=A4=E4=BA=92=E6=95=B0=E5=AD=97=E4=BA=BA=E9=85=8D=E7=BD=AE?=
=?UTF-8?q?=E6=8C=87=E5=8D=97.md?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/华为云MetaStudio交互数字人配置指南.md | 1097 ++++++++------------
1 file changed, 450 insertions(+), 647 deletions(-)
diff --git a/docs/华为云MetaStudio交互数字人配置指南.md b/docs/华为云MetaStudio交互数字人配置指南.md
index c741359..08086f3 100644
--- a/docs/华为云MetaStudio交互数字人配置指南.md
+++ b/docs/华为云MetaStudio交互数字人配置指南.md
@@ -1,50 +1,67 @@
-# 华为云交互数字人 MetaStudio 配置完整指南
+# 华为云数字内容生产线 MetaStudio 智能交互数字人配置指南
-本文档详细说明如何在华为云 MetaStudio 平台配置交互数字人，涵盖从创建到发布的全流程操作。
+本文档记录基于华为云 MetaStudio 智能交互 + 第三方大脑（华为云官方称为"第三方大模型"）的交互数字人配置方案，智能大脑使用 Dify 平台。
+
+> **重要公告**：华为云 MetaStudio **3D 数字人产品已停售**；**Flexus 分身数字人仅支持视频制作，不支持智能交互**。本文档智能交互部分仅涵盖 **分身数字人** 相关配置。
---
## 目录
-- [一、基础概念](#一基础概念)
+- [一、整体架构](#一整体架构)
- [二、前置准备](#二前置准备)
-- [三、创建数字人项目](#三创建数字人项目)
-- [四、角色选择与配置](#四角色选择与配置)
-- [五、终端配置](#五终端配置)
-- [六、互动文档配置](#六互动文档配置)
-- [七、对话配置](#七对话配置)
-- [八、多语言配置](#八多语言配置)
-- [九、发布与上线](#九发布与上线)
-- [十、常见问题](#十常见问题)
+- [三、部署 Dify 中转服务](#三部署-dify-中转服务)
+- [四、配置 Dify 应用](#四配置-dify-应用)
+- [五、配置 MetaStudio 智能交互](#五配置-metastudio-智能交互)
+- [六、常见问题](#六常见问题)
+- [附录](#附录)
---
-## 一、基础概念
+## 一、整体架构
-### 1.1 交互数字人类型
+```
+用户 ──→ 华为云 MetaStudio 智能交互（控制台配置）
+ │
+ │ 第三方大脑（大模型）
+ ↓
+ ┌───────────────────────┐
+ │ digital-human.py │ ← 中转服务（部署在自有服务器）
+ │ (FastAPI + Redis) │
+ └───────────┬───────────┘
+ │ HTTP / SSE 流式
+ ↓
+ ┌──────────┐
+ │ Dify │ ← 知识库 + LLM（大语言模型）
+ │ 平台 │
+ └──────────┘
+```
-| 类型 | 说明 | 适用场景 |
+**组件说明：**
+
+| 组件 | 作用 | 托管位置 |
|:---|:---|:---|
-| 2D 数字人 | 真人录制驱动，成本低，部署快 | 客服、讲解、播报 |
-| 3D 数字人 | 高精度建模，交互强，表现力丰富 | 品牌代言、展厅展示 |
+| MetaStudio 智能交互 | 数字人形象驱动、语音合成（TTS）、语音识别（ASR）、Web 端交互界面 | 华为云托管 |
+| 第三方大脑（第三方大模型） | MetaStudio 调用外部 LLM 获取对话内容 | 自有服务器 |
+| digital-human.py（中转服务） | 接收 MetaStudio 请求，转发至 Dify，转换响应格式 | 自有服务器 |
+| Redis | 存储 session_id → conversation_id 映射，支持多轮对话 | 自有服务器 |
+| Dify 平台 | 知识库检索 + 大语言模型对话生成 | 自有部署或 Dify Cloud |
-### 1.2 核心组件
+**中转服务 `POST /digital-human` 请求转发流程：**
-- **数字人模型**：2D/3D 虚拟形象
-- **智能语音对话**：与数字人实时语音/文字交互
-- **知识库**：数字人回答的知识来源
-- **互动文档**：数字人主动播报的内容脚本
-- **终端渠道**：数字人落地展示的平台
-
-### 1.3 名词解释
-
-| 名词 | 说明 |
-|:---|:---|
-| 知识库 | 数字人回答问题的语料来源，支持文档上传、网页抓取等 |
-| 互动文档 | 数字人主动播报的脚本，可配置触发时机 |
-| 对话技能 | 控制数字人在特定场景下的对话逻辑 |
-| 终端 | 数字人对外展示的渠道，如电脑端、手机端、大屏端 |
-| WebRTC | 实时音视频通信协议，用于数字人实时交互 |
+```
+MetaStudio 发起 HTTP POST /digital-human
+ ↓（携带用户语音转文字后的 query）
+digital-human.py 接收请求
+ ↓（携带 conversation_id，从 Redis 查询）
+Dify /chat-messages 接口
+ ↓
+Dify 返回 answer（或 SSE 流式 chunk）
+ ↓
+digital-human.py 转换为统一格式
+ ↓
+MetaStudio 接收并驱动数字人播报
+```
---
@@ -58,409 +75,177 @@
- 进入 [MetaStudio 控制台](https://console.huaweicloud.com/metastudio/)
- 开通服务，按需选择资源包
-2. **语音交互服务（可选）**
- - 如需语音对话，开通 "语音合成 TTS" 和 "语音识别 ASR"
+2. **语音交互服务 SIS（语音交互）**
+ - 如需语音对话，开通：
+ - **语音合成 TTS**：将文字转为自然语音
+ - **语音识别 ASR**：将用户语音转为文字
+ - ASR/TTS 计费属于独立计费项，请以华为云控制台实时价格为准
-3. **IEF（智能边缘平台，可选）**
- - 如需本地部署数字人终端
+3. **OBS 对象存储**
+ - MetaStudio 用于存储数字人形象、视频等资产（部分地区自动开通）
-### 2.2 准备资源
+### 2.2 ASR 并发数限制说明
-- 华为云账号 + IAM 用户（建议创建子账号授权）
-- 已备案的域名（生产环境）
-- Dify 平台账号（用于对接数字人中转服务）
+> 此说明仅供参考，具体套餐请以华为云控制台实时价格为准。
+
+**并发数计算规则：**
+- 1 路并发 = 1 个终端同时进行语音识别
+- 同一终端内，用户说话、等待回复均占用 1 路并发
+- 多人同时使用 = 并发数叠加（如 10 人同时使用 = 10 路并发）
+
+**扩容建议：**
+- 预估并发 = 预计同时在线用户数 × 0.3（正常对话频率）
+- 建议预留 20% 余量，避免高峰时段超限
+- 企业版可申请动态扩容，支持突发流量
+
+> **注意**：ASR 并发数超限后，新请求将被直接拒绝，终端表现为"无法识别语音，请重试"。生产环境务必提前评估并发需求并购买对应套餐。
+
+### 2.3 准备资源清单
+
+- [ ] 华为云账号 + 已完成实名认证
+- [ ] MetaStudio 服务已开通
+- [ ] 华为云 SIS（ASR + TTS）已开通
+- [ ] 一台可对外提供 HTTP 服务的服务器（用于部署中转服务）
+- [ ] Dify 平台账号（自部署或 Dify Cloud）
+- [ ] Dify 应用已创建，知识库已配置
---
-## 三、创建数字人项目
+## 三、部署 Dify 中转服务
-### 3.1 进入 MetaStudio 控制台
+中转服务 `digital-human.py` 负责将 MetaStudio 的第三方大脑请求转发给 Dify，并处理多轮对话上下文（Redis）。
-1. 登录 [MetaStudio 控制台](https://console.huaweicloud.com/metastudio/)
-2. 左侧菜单选择 **数字人** → **交互数字人**
-3. 点击 **创建项目**
+### 3.1 快速部署（一键脚本）
-### 3.2 项目基础信息
+华为云官方提供自动部署脚本，在中转服务器上执行：
-| 字段 | 说明 |
-|:---|:---|
-| 项目名称 | 如：`公司官网数字人客服` |
-| 项目描述 | 简要描述项目用途 |
-| 地域 | 选择最近地域（如：华北-北京四） |
-| 数字人类型 | 2D / 3D，根据需求选择 |
-
-### 3.3 选择数字人模板
-
-华为 MetaStudio 提供以下模板类型：
-
-| 模板 | 特点 | 适用场景 |
-|:---|:---|:---|
-| 客服助手模板 | 开箱即用，配置简单 | 官网客服、产品咨询 |
-| 讲解员模板 | 支持主动播报内容 | 展厅导览、品牌讲解 |
-| 虚拟主播模板 | 支持内容自动播报 | 新闻播报、活动主持 |
-| 自定义模板 | 从零配置，灵活度高 | 深度定制需求 |
-
-建议首次使用选择 **客服助手模板**，快速熟悉流程。
-
----
-
-## 四、角色选择与配置
-
-### 4.1 选择数字人形象
-
-在 **角色配置** 页面，选择数字人的外观形象：
-
-#### 方式一：使用平台预设形象
-
-MetaStudio 提供多种预设形象，分为：
-
-| 分类 | 说明 |
-|:---|:---|
-| 2D 预设形象 | 真人模特，覆盖多种性别、肤色、服装风格 |
-| 3D 预设形象 | 二次元、仿真人、超写实等多种风格 |
-
-选择步骤：
-1. 在 **形象市场** 中浏览预设形象
-2. 点击 **预览**，查看数字人在不同场景下的表现
-3. 点击 **使用**，将形象添加到当前项目
-
-#### 方式二：定制专属形象（需申请）
-
-如需使用真人定制：
-1. 联系华为云商务，申请定制数字人形象
-2. 提供多角度真人视频素材（10-15 分钟）
-3. 华为云制作团队完成建模（约 5-10 个工作日）
-
-### 4.2 角色参数配置
-
-选定形象后，配置以下参数：
-
-| 参数 | 说明 | 推荐值 |
-|:---|:---|:---|
-| 音色 | 数字人说话的声音类型 | 根据形象性别/场景选择 |
-| 语速 | 播报语速 | 1.0x（正常） |
-| 音调 | 声音高低 | 根据场景调整 |
-| 音量 | 播报音量 | 80% |
-| 口型匹配 | 是否启用口型动画 | 启用 |
-| 动作姿态 | 待机/讲解时的肢体动作 | 选择对应场景动作集 |
-
-### 4.3 背景配置
-
-| 设置项 | 说明 |
-|:---|:---|
-| 背景类型 | 纯色 / 虚拟背景 / 透明（抠像） |
-| 虚拟背景 | 可上传图片或使用平台提供的场景模板 |
-| 分辨率 | 720P / 1080P / 4K |
-
-> **建议**：如数字人需要叠加在任何背景内容上（如展厅大屏、网页侧边栏），选择透明背景（WebGL 渲染模式）。
-
----
-
-## 五、终端配置
-
-终端决定了数字人在哪里展示。华为 MetaStudio 支持电脑端、手机端和大屏端三种终端类型。
-
-### 5.1 支持的终端类型
-
-| 终端类型 | 说明 | 适用场景 |
-|:---|:---|:---|
-| **电脑端（PC Web）** | 通过浏览器访问，支持 WebRTC | 官网、线上展厅、办公系统 |
-| **手机端（Mobile）** | 适配手机浏览器，含 H5 / 小程序 | 微信内嵌、企业微信、扫码体验 |
-| **大屏端（Large Screen）** | 支持 Linux / Windows 大屏设备 | 展厅、营业厅、迎宾大屏、发布会 |
-
-### 5.2 电脑端（PC Web）配置
-
-适用于 PC 浏览器访问的数字人终端场景，如官网客服、线上展厅等。
-
-#### 创建电脑端终端
-
-1. 在项目页面，点击 **添加终端** → **电脑端**
-2. 配置以下参数：
-
-| 参数 | 说明 |
-|:---|:---|
-| 终端名称 | 如：`官网电脑端` |
-| 终端尺寸 | 固定尺寸（如 1280×720）或全屏自适应 |
-| 分辨率 | 720P / 1080P，推荐 1080P |
-| 默认语言 | 终端默认语言，如 `zh_CN` |
-| 域名白名单 | 允许嵌入数字人的域名，如：`*.example.com` |
-| HTTPS | **必须启用**，生产环境必须配置 |
-
-3. 点击 **生成嵌入代码**，获取 Iframe 或 Web SDK 代码
-
-#### Iframe 嵌入
-
-```html
-
+```bash
+wget -O /tmp/digital-human.sh \
+ https://documentation-samples.obs.cn-north-4.myhuaweicloud.com/solution-as-code-publicbucket/solution-as-code-moudle/building-a-dify-llm-application-platform/human/digital-human.sh \
+ && bash /tmp/digital-human.sh {Dify_IP} {API_KEY}
```
-#### Web SDK 嵌入
+| 参数 | 说明 | 示例 |
+|:---|:---|:---|
+| `Dify_IP` | Dify 服务地址（末尾带 `/v1`） | `https://atwdify.antiwearvalve.com/v1` |
+| `API_KEY` | Dify API 密钥（纯密钥，不要 `Bearer ` 前缀） | `app-PDkSHiHZsZIluoZF7N2OlNZM` |
-```html
-
-
+### 3.2 手动部署（Docker Compose）
-
-
+如需手动部署：
-
+# 配置环境变量
+cp .env.example .env
+# 编辑 .env，填入 DIFY_URL 和 DIFY_API_KEY
+
+# 启动服务
+docker compose up -d
```
-#### 电脑端尺寸参考
+`.env` 必填项：
-| 场景 | 推荐尺寸 | 说明 |
-|:---|:---|:---|
-| 官网侧边栏 | 320×580 px | 小尺寸，悬浮展示 |
-| 官网全屏 | 1920×1080 px | 全屏沉浸式体验 |
-| 线上展厅 | 1280×720 px | 兼顾清晰度与性能 |
+```env
+# Dify 服务地址（末尾不要加 /chat-messages）
+DIFY_URL=https://your-dify-domain.com/v1
-### 5.3 手机端（Mobile）配置
+# Dify API 密钥（纯密钥，不要加 Bearer 前缀）
+DIFY_API_KEY=app-xxxxxxxxxxxxxxxx
+```
-适用于手机浏览器、微信内嵌页、企业微信等移动端场景。
+### 3.3 配置防火墙
-#### 创建手机端终端
+允许外部访问中转服务端口（默认 8000）：
-1. 点击 **添加终端** → **手机端**
-2. 配置以下参数：
+```bash
+# 云服务器安全组：放行 TCP 8000 端口（源地址 0.0.0.0/0）
+# 或使用云防火墙配置规则
+```
-| 参数 | 说明 |
-|:---|:---|
-| 终端名称 | 如：`手机H5端` |
-| 终端尺寸 | 自适应（撑满屏幕宽度） |
-| 授权域名 | 微信/浏览器安全域名配置 |
-| 是否支持微信内嵌 | 开启后使用微信 JSSDK，支持微信分享 |
-| 底部交互栏 | 是否显示输入框、快捷按钮等交互组件 |
-| 键盘适配 | 移动端软键盘弹出时数字人画面自动上移 |
+### 3.4 验证中转服务
-3. 获取分享链接或二维码，扫码即可体验
+```bash
+# 健康检查
+curl http://{中转服务器IP}:8000
-#### 手机端尺寸参考
+# 应返回
+{"status":"ok"}
-| 场景 | 推荐尺寸 | 说明 |
-|:---|:---|:---|
-| 全屏沉浸 | 100vw × 100vh | 铺满整个手机屏幕 |
-| 底部悬浮 | 100vw × 60vh | 底部固定，叠加在网页内容上 |
-| 侧边栏 | 375×667（iPhone SE） | 小尺寸悬浮展示 |
+# 对话接口测试（非流式）
+curl -X POST http://{中转服务器IP}:8000/digital-human \
+ -H "Content-Type: application/json" \
+ -d '{
+ "messages": [{"content": "你好"}],
+ "app_id": "your-app-id",
+ "user": "test-user",
+ "session_id": "test-001",
+ "is_stream": false
+ }'
+```
-#### 微信内嵌注意事项
+> **注意**：`app_id` 请替换为您的实际 Dify 应用 ID。**切勿将 API Key 明文写入文档或代码仓库**。
-- 必须在华为云 MetaStudio 控制台将微信域名加入白名单
-- 微信内置浏览器需使用 HTTPS
-- 如需调用微信 JSSDK（分享、录音等），需在微信公众平台配置 JS 安全域名
+### 3.5 中转服务接口说明
-### 5.4 大屏端（Large Screen）配置
+#### `POST /digital-human`（核心接口）
-适用于展厅、营业厅、迎宾大屏、发布会等线下大尺寸展示场景，支持 Linux 和 Windows 系统。
+| 字段 | 类型 | 必填 | 说明 |
+|:---|:---|:---:|:---|
+| `messages` | `Array` | ✅ | 消息列表，取第一条 `content` 作为 Dify query |
+| `app_id` | `string` | ✅ | Dify 应用 ID |
+| `user` | `string` | ✅ | 用户标识，用于 Dify 会话上下文 |
+| `session_id` | `string` | ✅ | 会话 ID，多轮对话关联，空则自动生成 |
+| `is_stream` | `boolean` | ✅ | `true` = SSE 流式，`false` = 非流式阻塞返回 |
-#### 创建大屏端终端
-
-1. 点击 **添加终端** → **大屏端**
-2. 配置以下参数：
-
-| 参数 | 说明 |
-|:---|:---|
-| 终端名称 | 如：`展厅迎宾大屏` |
-| 分辨率 | 1920×1080 / 2560×1440 / 3840×2160（4K） |
-| 画面比例 | 16:9 / 16:10 / 4:3 |
-| 数字人位置 | 左侧 / 右侧 / 底部，居中 |
-| 数字人尺寸 | 占屏幕宽度比例，如 40% |
-| 背景设置 | 支持透明背景叠加在任何内容上 |
-| 待机画面 | 无交互时播放的内容（如品牌视频） |
-| 自动唤醒 | 检测到人脸/人体时自动唤醒数字人 |
-
-#### 大屏端高级功能
-
-| 功能 | 说明 |
-|:---|:---|
-| 人脸唤醒 | 通过摄像头检测用户靠近，自动启动数字人 |
-| 手势识别 | 支持挥手、指屏幕等手势触发对应内容 |
-| 多人识别 | 支持同时检测多名观众，数字人面向最近用户 |
-| 静音模式 | 大屏无声时，数字人仅做唇形动画，不播放语音 |
-| 定时播报 | 按设置时间自动播放欢迎语或宣传内容 |
-
-#### 大屏端尺寸参考
-
-| 场景 | 分辨率 | 数字人推荐宽度 |
-|:---|:---|:---|
-| 企业展厅（55寸） | 1920×1080 | 屏幕宽度的 35-40% |
-| 营业厅大堂（75寸） | 3840×2160（4K） | 屏幕宽度的 30-35% |
-| 发布会主屏 | 1920×1080 | 屏幕宽度的 50-60% |
-| 走廊导览屏 | 1080×1920（竖屏） | 屏幕宽度的 60% |
-
-### 5.5 终端通用参数
-
-| 参数 | 说明 | 推荐值 |
-|:---|:---|:---|
-| 默认语言 | 终端启动时的语言 | `zh_CN` |
-| 自动启动 | 页面加载后自动启动数字人 | 是 |
-| 显示水印 | 是否显示华为云水印 | 生产环境关闭 |
-| 会话超时 | 无交互自动休眠时间 | 5 分钟 |
-
----
-
-## 六、互动文档配置
-
-互动文档用于配置数字人**主动播报**的内容，可以是产品介绍、活动说明、迎宾语等。
-
-### 6.1 创建互动文档
-
-1. 在项目左侧菜单选择 **内容管理** → **互动文档**
-2. 点击 **新建文档**
-3. 填写文档名称（如：`产品介绍-旗舰机型`）
-
-### 6.2 文档结构
-
-互动文档采用**结构化脚本**格式，支持以下元素：
+**响应（非流式）：**
```json
{
- "doc_id": "doc-001",
- "doc_name": "产品介绍-旗舰机型",
- "language": "zh_CN",
- "content": [
- {
- "type": "greeting",
- "text": "您好，欢迎来到我们的产品展厅！"
- },
- {
- "type": "segment",
- "title": "关于我们",
- "text": "我们是国内领先的智能制造企业，专注于为客户提供高品质的智能产品解决方案。"
- },
- {
- "type": "image",
- "url": "https://cdn.example.com/product.jpg",
- "description": "产品实物图"
- },
- {
- "type": "segment",
- "title": "核心优势",
- "text": "我们的产品有三大核心优势：\n1. 高性能处理器\n2. 超长续航能力\n3. 智能交互体验"
- },
- {
- "type": "qa",
- "question": "产品价格是多少",
- "answer": "具体价格请咨询我们的销售顾问，或拨打400-888-8888。"
- },
- {
- "type": "video",
- "url": "https://cdn.example.com/intro.mp4",
- "description": "产品介绍视频"
- },
- {
- "type": "goodbye",
- "text": "感谢您的参观，如有任何问题，随时向我咨询！"
- }
- ],
- "triggers": [
- {
- "type": "keyword",
- "keywords": ["产品", "介绍", "优势"],
- "priority": 1
- },
- {
- "type": "schedule",
- "cron": "0 9 * * *", // 每天早上9点自动播报
- "description": "每日早间播报"
- }
- ]
+ "id": "131424542124",
+ "created": 20230512084843,
+ "choices": [{"index": 0, "message": {"content": "您好！我是..."}}]
}
```
-### 6.3 触发时机配置
+**响应（流式，SSE）：**
-互动文档支持多种触发方式：
+```
+data: {"id":"1231414141541252525","created":20230512084843,"choices":[{"message":{"content":"您"}}]}
-| 触发类型 | 说明 | 配置方式 |
-|:---|:---|:---|
-| **关键词触发** | 用户提到特定关键词时播报 | 配置关键词列表，设置优先级 |
-| **定时播报** | 按 Cron 表达式定时触发 | 设置 Cron 表达式 |
-| **欢迎语触发** | 用户首次进入时播报 | 全局开关控制 |
-| **按钮触发** | 用户点击引导按钮时播报 | 生成互动按钮 |
-| **手势触发** | 特定手势（如挥手）触发 | 需配置摄像头手势识别 |
+data: {"id":"1231414141541252525","created":20230512084843,"choices":[{"message":{"content":"好"}}]}
-### 6.4 多文档优先级
+...
-当多个文档的触发条件同时满足时，按以下优先级处理：
+data: [DONE]
+```
-1. **问答匹配最高** — 用户问题与 Q&A 完全匹配
-2. **关键词命中数最多** — 命中关键词最多的文档
-3. **手动优先级设置** — 在文档属性中手动设置 1-100 优先级
+#### `GET /`（健康检查）
+
+```json
+{"status":"ok"}
+```
---
-## 七、对话配置
+## 四、配置 Dify 应用
-对话配置是数字人"智能"的核心，决定数字人如何理解和回答用户问题。
+Dify 是交互数字人的"大脑"，负责知识库检索和大语言模型对话生成。
-### 7.1 接入中转服务（推荐）
-
-数字人对话推荐通过 `digital-human.py` 中转服务接入 Dify，无需每个终端单独对接：
-
-```
-数字人终端 --> digital-human.py 中转 --> Dify 知识库 --> LLM --> 响应
- |
- +--> Redis（多轮对话上下文）
-```
-
-**配置步骤：**
-
-1. 在华为云 MetaStudio 终端配置中，填写中转服务地址：
-
-```
-中转服务地址：https://your-domain.com/digital-human
-```
-
-2. 中转服务 `POST /digital-human` 请求参数映射：
-
-| 华为云参数 | 中转服务字段 | 说明 |
-|:---|:---|:---|
-| 用户 ID | `user` | 终端用户标识 |
-| 会话 ID | `session_id` | 多轮对话上下文关联 |
-| 用户输入 | `messages[0].content` | 用户问题内容 |
-| 应用 ID | `app_id` | Dify 应用标识 |
-| 流式模式 | `is_stream` | 是否启用流式响应 |
-
-### 7.2 Dify 应用配置
-
-#### 7.2.1 创建 Dify 应用
+### 4.1 创建 Dify 应用
1. 登录 Dify 平台
2. 创建应用，选择类型：
- - **聊天助手**：适合问答场景
+ - **聊天助手**：适合问答场景（推荐）
- **Agent**：适合复杂任务处理
- **Workflow**：适合流程化对话
-#### 7.2.2 知识库配置
-
-1. 在 Dify 应用中，进入 **知识库**
-2. 上传文档，支持格式：
- - PDF
- - Word（.docx）
- - TXT
- - Markdown
- - 网页 URL
+### 4.2 配置知识库
+1. 进入应用 → **知识库**
+2. 上传文档，支持格式：PDF、Word（.docx）、TXT、Markdown、网页 URL
3. 文档分段策略：
| 策略 | 说明 | 适用场景 |
@@ -469,11 +254,11 @@ MetaStudio 提供多种预设形象，分为：
| 固定长度分段 | 每 N 个字符一段 | 结构化文档 |
| 自定义分段 | 手动设置分段点 | 精准控制 |
-4. 设置Embedding 模型（推荐使用华为云或 OpenAI 的 Embedding 服务）
+4. 设置 Embedding 模型（推荐使用与 LLM 同供应商的服务）
-#### 7.2.3 对话技能配置
+### 4.3 配置提示词（对话技能）
-在 Dify 应用中配置 **提示词**，控制数字人回答风格：
+在应用 **提示词** 中配置，控制数字人回答风格：
```
你是华为云交互数字人客服，名为"小华"。
@@ -484,273 +269,269 @@ MetaStudio 提供多种预设形象，分为：
4. 禁止回答与公司业务无关的问题
```
-### 7.3 多轮对话配置
+### 4.4 获取 API Key
-通过 Redis 存储 `session_id` 与 `conversation_id` 映射，实现多轮对话：
+1. 进入 Dify 应用 → **API** 标签页
+2. 复制 **API Key**（格式如 `app-xxxxxxxxxxxxxxxx`）
+3. 将 API Key 填入中转服务 `.env` 中的 `DIFY_API_KEY`
-```
-用户: 你好，我想咨询产品
-数字人: 您好！很高兴为您服务。请问您想了解哪类产品？
-用户: 有没有适合企业使用的？
-数字人: 当然有！我们有多款企业级产品，请问您更关注哪个方面？
- （A）服务器 （B）存储 （C）网络
-用户: A
-数字人: 我们的服务器产品分为...
-```
+### 4.5 多轮对话说明
-**配置要点：**
-- `session_id`：由终端生成，必须唯一，用于关联同一用户的多轮会话
-- `conversation_id`：由 Dify 生成，存储在 Redis 中
-- 会话超时时间：建议设置 30 分钟无交互则清理会话
-
-### 7.4 意图识别与槽位填充
-
-高级配置：通过 Dify Workflow 配置意图识别：
-
-```
-用户输入
- ↓
-意图分类（识别是"咨询产品"还是"投诉"还是"转人工"）
- ↓
-分支处理
- ├── 咨询产品 → 知识库检索
- ├── 投诉 → 道歉+记录+转人工
- └── 转人工 → 输出转接指令
-```
+- `session_id`：由 MetaStudio 终端生成，每次对话中保持一致
+- `conversation_id`：由 Dify 返回，存储在中转服务 Redis 中
+- 会话超时：默认 86400 秒（24 小时），可按需调整 Redis expire 时间
---
-## 八、多语言配置
+## 五、配置 MetaStudio 智能交互
-多语言支持让数字人可以服务全球用户，是国际化场景的必备能力。
-
-### 8.1 支持的语言列表
-
-| 语言代码 | 语言名称 | 说明 |
-|:---|:---|:---|
-| `zh_CN` | 简体中文 | 默认 |
-| `zh_TW` | 繁体中文 | 港澳台地区 |
-| `en_US` | 英语 | 国际通用 |
-| `ja_JP` | 日语 | 日本市场 |
-| `ko_KR` | 韩语 | 韩国市场 |
-| `fr_FR` | 法语 | 法国及法语区 |
-| `de_DE` | 德语 | 德国及德语区 |
-| `es_ES` | 西班牙语 | 西班牙及拉丁美洲 |
-| `pt_BR` | 葡萄牙语 | 巴西及葡萄牙 |
-| `ru_RU` | 俄语 | 俄罗斯市场 |
-| `ar_SA` | 阿拉伯语 | 中东地区（RTL） |
-
-### 8.2 终端语言配置
-
-在终端配置中设置支持的语言列表：
-
-```json
-{
- "supported_languages": [
- { "code": "zh_CN", "name": "简体中文", "default": true },
- { "code": "en_US", "name": "English", "default": false },
- { "code": "ja_JP", "name": "日本語", "default": false }
- ],
- "default_language": "zh_CN",
- "language_switch_position": "top-right"
-}
-```
-
-### 8.3 数字人音色多语言配置
-
-每种语言需配置对应的音色：
-
-| 语言 | 音色名称 | 参数 |
-|:---|:---|:---|
-| 简体中文 | 小华-女声-自然 | `zh-CN-XiaoxiaoNeural` |
-| 简体中文 | 小华-男声-正式 | `zh-CN-YunxiNeural` |
-| 英语 | Emma-女声 | `en-US-EmmaNeural` |
-| 英语 | Justin-男声 | `en-US-JustinNeural` |
-| 日语 | Nanami-女声 | `ja-JP-NanamiNeural` |
-
-**配置步骤：**
-1. 进入 **角色配置** → **音色设置**
-2. 点击 **添加音色**
-3. 选择语言和音色类型
-4. 预览并确认
-
-### 8.4 多语言互动文档
-
-每个语言创建独立的互动文档：
-
-```
-内容管理/
-├── 互动文档/
-│ ├── 产品介绍（中文） doc-zh-CN.json
-│ ├── 产品介绍（英文） doc-en-US.json
-│ ├── 产品介绍（日文） doc-ja-JP.json
-│ └── 欢迎语（多语言） doc-welcome-all.json
-```
-
-**文档语言字段：**
-
-```json
-{
- "doc_id": "doc-001",
- "language": "en_US",
- "content": [
- {
- "type": "greeting",
- "text": "Hello! Welcome to our digital showroom. How can I assist you today?"
- }
- ]
-}
-```
-
-### 8.5 多语言对话路由
-
-在 `digital-human.py` 中转服务实现多语言路由：
-
-```python
-# 根据用户语言选择 Dify 对应的应用
-LANGUAGE_APP_MAP = {
- "zh_CN": "app-zh-cn-xxx",
- "en_US": "app-en-us-xxx",
- "ja_JP": "app-ja-jp-xxx",
-}
-
-# 从请求中获取语言参数
-lang = body.get("language", "zh_CN")
-app_id = LANGUAGE_APP_MAP.get(lang, LANGUAGE_APP_MAP["zh_CN"])
-```
-
-### 8.6 翻译知识库
-
-对于知识库文档较多的场景，建议：
-
-| 方案 | 适用规模 | 说明 |
-|:---|:---|:---|
-| **多套独立知识库** | 少于 10 个应用 | 每种语言独立维护，简单可靠 |
-| **统一知识库 + 翻译中间件** | 大规模多语言 | 知识库统一存储，翻译层按需转换 |
-| **多语言 Embedding 模型** | 中等规模 | 使用支持多语言的 Embedding 模型 |
+> **控制台路径**：登录 MetaStudio → 进入工作台 → 点击「分身智能交互」卡片 → 在对话项目编辑页面配置各环节参数。
---
-## 九、发布与上线
+### 5.1 进入控制台与创建对话项目
-### 9.1 预览测试
+**操作步骤：**
-在正式发布前，使用 MetaStudio 提供的**预览功能**：
+1. 登录 [MetaStudio 控制台](https://console.huaweicloud.com/metastudio/)，进入 MetaStudio 服务概览页面
+2. 点击「**前往 MetaStudio 工作台**」
+3. 在工作台页面点击「**分身智能交互**」卡片
+4. 进入智能交互对话项目编辑页面，依次配置以下参数
-1. 点击右上角 **预览**
-2. 在模拟器中选择终端类型（PC / 手机 / 大屏）
-3. 输入测试问题，验证回答是否正确
-4. 检查多语言切换是否正常
-5. 确认互动文档触发是否符合预期
-
-### 9.2 发布配置
-
-#### 基本信息
-
-| 字段 | 说明 |
-|:---|:---|
-| 发布版本号 | 如：`v1.0.0`，建议遵循语义化版本 |
-| 更新说明 | 本次更新的内容简述 |
-| 发布环境 | 测试环境 / 预发布 / 正式环境 |
-
-#### 终端发布
-
-| 终端 | 发布前检查项 |
-|:---|:---|
-| 电脑端 | 域名已备案、HTTPS 证书有效、ICP 许可证（如需） |
-| 手机端 | 微信/支付宝域名白名单已配置 |
-| 大屏端 | 大屏设备已就绪，系统为 Windows 或 Linux，网络畅通 |
-| APP | APP 已上架或已添加测试设备 |
-
-#### 数字人内容审核
-
-华为云对数字人内容有审核机制：
-
-1. **内容合规检查**：禁止涉及政治、色情、暴力等内容
-2. **品牌合规检查**：涉及商标、品牌需提供授权证明
-3. **AI 安全检查**：对话内容通过 AI 安全审核
-
-审核时间：工作日 1-3 个工作日。
-
-### 9.3 发布上线
-
-审核通过后，点击 **立即发布**：
-
-```
-发布中 → 部署终端 → 服务启动 → 上线成功
-```
-
-### 9.4 监控与运维
-
-发布后通过华为云控制台监控：
-
-| 监控项 | 说明 |
-|:---|:---|
-| 在线人数 | 当前同时在线的终端用户数 |
-| 对话量 | 每小时/每天的对话请求数 |
-| 平均响应时间 | Dify → 数字人响应的端到端延迟 |
-| 错误率 | 5xx 错误占比 |
-| Redis 连接状态 | 会话缓存是否正常 |
-
-**告警配置：**
-- 对话量突增 / 突降
-- 错误率超过 5%
-- 响应时间超过 10 秒
-- Redis 连接失败
+> **创建与编辑入口**：如已有对话项目，在「我的创作 → 智能交互」列表中点击对应项目名称进入编辑。
---
-## 十、常见问题
+### 5.2 角色配置
-### Q1：数字人形象无法加载？
+在编辑页面左侧「**角色**」区域，配置数字人形象：
+
+| 配置项 | 说明 |
+|:---|:---|
+| **定制数字人** | 点击跳转到形象制作页面，发起分身数字人定制任务 |
+| **搜索框** | 输入数字人名称，精准筛选已创建的数字人 |
+| **筛选条件** | 支持按角色、性别、姿势、行业、区域和分辨率筛选 |
+| **数字人卡片列表** | 点击卡片自动替换为对应形象 |
+
+**形象类型说明：**
+
+| 类型 | 说明 |
+|:---|:---|
+| 分身数字人 | 基于真人形象采集打造，交互自然，推荐正式客服场景 |
+| 照片数字人 | 上传照片即可生成，适合快速验证 |
+
+> **重要**：Flexus 分身数字人仅支持视频制作，**不支持智能交互**，详见 [Flexus 分身数字人限制说明](https://support.huaweicloud.com/productdesc-metastudio/metastudio_01_0022.html)。3D 数字人产品已停售，均不在可选范围内。
+
+---
+
+### 5.3 背景配置
+
+在编辑页面左侧「**背景**」区域，配置交互场景背景：
+
+| 配置项 | 说明 |
+|:---|:---|
+| **本地导入** | 支持上传 PNG、JPG、JPEG、BMP 格式图片，或直接拖拽上传 |
+| **搜索框** | 输入背景名称精准搜索 |
+| **筛选条件** | 支持按来源筛选背景图片 |
+| **透明背景** | 第一张图为透明背景，点击后数字人预览区域切换为透明背景（用于叠加在任何画面内容之上） |
+
+> **注意**：上传后的背景图片不支持修改，如需更换请本地修改后再重新上传。
+
+---
+
+### 5.4 互动问答配置（第三方大脑）
+
+> 本项目使用 **第三方大脑（大模型）** 场景，通过中转服务对接 Dify。
+
+在编辑页面填写以下参数：
+
+#### 基础参数
+
+| 配置项 | 填写内容 | 说明 |
+|:---|:---|:---|
+| **第三方应用** | 选择「**第三方大脑（大模型）**」 | — |
+| **应用名称** | 自定义，如：`智能客服数字人` | 便于识别的项目名称 |
+| **APPID** | `898675431` | 默认值，通常无需修改 |
+| **APPKEY** | 随意填写（当前 `digital-human.py` 中转服务未实现签名验证，留空或填任意值均可） | 用于 MetaStudio 请求签名验证占位，当前版本可忽略 |
+| **第三方语言模型地址** | 中转服务地址，如：`http://your-server:8000/digital-human` | MetaStudio 调用此地址获取对话答案 |
+
+> **地址格式说明**：中转服务地址必须能被华为云服务器访问。若使用 HTTPS，建议使用有效证书；若使用 HTTP，地址不能包含 `localhost` 或私有 IP（如 `192.168.x.x`）。
+
+#### 流式与多轮对话参数
+
+| 配置项 | 建议值 | 说明 |
+|:---|:---|:---|
+| **流式响应** | 根据 Dify 支持情况选择 | 开启后使用 SSE 流式问答（响应更快）；关闭则使用非流式。需中转服务同步支持 |
+| **多轮语境理解能力** | `3`（推荐） | 数值越高，携带历史对话越多。设为 `1` 则不支持多轮对话 |
+
+**多轮语境配置规则：**
+
+- 设为 `1`：不携带历史对话，每次问答独立
+- 设为非 `1`（如 `3`）：携带历史对话，携带数量 = 当前问题 + 历史最新的 N-1 轮问答
+
+#### ASR 服务配置
+
+| 配置项 | 填写内容 | 说明 |
+|:---|:---|:---|
+| **ASR 服务** | 选择「**奇妙问**」 | 使用华为云奇妙问平台提供语音识别服务 |
+| **ASR 账号** | 奇妙问平台账号 | 需联系奇妙问客户经理注册开通，详见 [奇妙问配置说明](https://support.huaweicloud.com/intl/zh-cn/usermanual-metastudio/metastudio_05_0181.html) |
+| **ASR 密钥** | 奇妙问平台密钥 | 同上 |
+
+> **ASR 说明**：如仅需文字输入模式，可不配置 ASR 服务，使用 MetaStudio 自带的文字输入入口进行对话测试。
+
+#### 其他参数
+
+| 配置项 | 建议值 | 说明 |
+|:---|:---|:---|
+| **尾静音时长** | `≥ 500ms` | 云端对音频进行 VAD 检测，静默超过此值结束语音识别，建议不低于 500ms |
+| **热词** | 按需配置 | 语音识别不准确的专业词汇可作为热词反馈至语音模型，提高识别准确率 |
+
+#### 配置检查
+
+点击「**配置检查**」，系统自动验证当前配置是否正确，如有错误会显示相应提示。
+
+---
+
+### 5.5 对话配置
+
+在编辑页面点击「**对话配置**」页签，配置语言与声音参数：
+
+| 配置项 | 取值范围 | 说明 |
+|:---|:---|:---|
+| **语言** | 中文 / 英文 | 支持同时添加并设置默认语言，可通过界面右上角图标切换 |
+| **声音** | 需与语言匹配 | 中文选中文音色，英文选英文音色 |
+| **语速** | 0.5X ~ 2X | 推荐 1.0X（正常语速） |
+| **音量** | 90 ~ 240 | 建议调大初始音量以保证播放效果适中 |
+| **音高** | 50 ~ 200 | 音高增加声音更尖锐，降低更低沉 |
+| **静默退出时长** | 5 ~ 1440 分钟 | 无操作超过设定时间后自动关闭对话窗口 |
+
+---
+
+### 5.6 发布设置
+
+在编辑页面右上角点击「**发布**」：
+
+| 配置项 | 说明 |
+|:---|:---|
+| **激活码** | 发布成功后自动生成，用于激活对话链接 |
+| **并发数** | 同时访问的最大用户数量，超过时报 `MSS.20010135` 错误（对话资源不足），需根据实际需求配置 |
+| **有效期** | 从发布开始的智能交互可用时长 |
+
+**发布后操作：**
+
+1. 点击「**发布**」，成功后弹出对话框
+2. 点击「**发布链接**」→ 在"智能交互激活"界面输入激活码激活对话
+3. 或点击「**复制分享**」→ 一键复制发布链接和激活码，分享给用户
+
+> **修改已发布的项目**：返回编辑页面，点击「**修改**」按钮即可重新编辑配置（发布后激活码会更新）。
+
+---
+
+### 5.7 终端类型说明
+
+MetaStudio 智能交互支持以下终端接入方式，同一对话项目可适配多种终端：
+
+| 终端 | 说明 | 适用场景 |
+|:---|:---|:---|
+| **PC 端（网页）** | 通过浏览器访问发布链接，麦克风权限授权后即可语音对话 | 官网客服、展厅大屏 |
+| **手机端** | 在移动浏览器中打开，支持语音输入 | 微信/企业微信嵌入、APP 内嵌 H5 |
+| **大屏端** | 通过专用大屏终端 SDK 接入，适合触摸大屏设备 | 展厅、营业厅、政务服务大厅 |
+
+---
+
+### 5.8 预览与测试
+
+配置完成后，使用控制台内置的模拟器进行预览测试：
+
+1. 在编辑页面右侧预览区选择终端类型（电脑端 / 手机端）
+2. 在模拟器中输入文字或点击麦克风进行语音测试
+3. 验证 Dify 回复是否正确返回、数字人播报是否正常
+4. 如有问题，点击「**配置检查**」排查，或参考 [第六节常见问题](#六常见问题)
+
+---
+
+## 六、常见问题
+
+### Q1：中转服务返回 500 错误？
**排查步骤：**
-1. 检查网络是否正常
-2. 检查浏览器控制台是否有 CORS 错误
-3. 确认终端配置的域名与实际访问域名一致
-4. 检查 HTTPS 证书是否有效
+1. 检查 `.env` 中 `DIFY_URL` 是否正确（末尾是否为 `/v1`）
+2. 检查 `DIFY_API_KEY` 是否有效
+3. 确认服务器能访问 Dify 地址：
-### Q2：对话回答不准确？
+```bash
+curl -I $DIFY_URL
+```
-**排查步骤：**
-1. 检查 Dify 知识库是否已正确关联应用
-2. 检查文档分段是否合理
-3. 在 Dify 的"日志"中查看实际检索到的内容
-4. 调整提示词，减少"幻觉"回答
-5. 适当提高检索相似度阈值（0.7-0.85 为宜）
-
-### Q3：多轮对话上下文丢失？
+### Q2：多轮对话上下文丢失？
**排查步骤：**
1. 检查 Redis 是否正常运行：`docker ps | grep redis`
-2. 检查 `session_id` 是否每次请求都相同
+2. 检查 `session_id` 是否每次请求都相同（终端需保持 session 不变）
3. 检查 Redis 会话过期时间（默认 86400 秒）
-4. 查看容器日志是否有 Redis 连接错误
+
+```bash
+# 查看 Redis 日志
+docker compose logs redis
+```
+
+### Q3：ASR 并发数超限如何处理？
+
+**现象**：用户语音输入无响应，终端提示"无法识别语音"或"服务繁忙"。
+
+**排查步骤：**
+1. 登录华为云控制台，查看 **语音交互服务 → ASR** 的用量监控
+2. 确认当前并发使用量是否已达到套餐上限
+
+| 紧急程度 | 处理方式 |
+|:---|:---|
+| 临时紧急 | 在控制台申请临时扩容（需企业认证） |
+| 短期解决 | 降级为文字输入模式，减少 ASR 调用 |
+| 长期解决 | 升级套餐或购买额外并发包 |
+
+**预防措施**：
+- 在华为云监控控制台配置 ASR 并发告警（阈值建议设为套餐上限的 80%）
+- 在 `digital-human.py` 中可增加请求排队逻辑，超时返回友好提示
### Q4：流式响应延迟高？
**排查步骤：**
-1. 检查 Dify 服务响应时间（独立测试 Dify）
-2. 检查容器服务器与 Dify 服务器之间的网络延迟
-3. 确认 `digital-human.py` 中 `generate_streaming_messages` 是否实时 yield
+1. 检查 Dify 服务响应时间（单独测试 Dify 接口）
+2. 检查服务器与 Dify 服务器之间的网络延迟
+3. 确认 `digital-human.py` 中 `generate_streaming_messages` 实时 yield
4. 检查 Redis 查询耗时（`session_id` 读取）
-5. 考虑在 Dify 侧开启流式输出（`response_mode: streaming`）
-### Q5：多语言切换不生效？
+### Q5：API 返回 APIGW.0308 错误码（QPS 流控限制）？
-**排查步骤：**
-1. 确认终端配置中已添加对应语言
-2. 确认该语言的知识库文档已上传
-3. 确认 `digital-human.py` 中有 `LANGUAGE_APP_MAP` 路由
-4. 终端前端是否正确传递 `language` 参数
+**现象**：API 调用时报错，提示"请求过于频繁"。
-### Q6：互动文档触发时机不正确？
+**原因**：触发了 MetaStudio API QPS 流控限制。
-**排查步骤：**
-1. 检查关键词列表是否覆盖用户可能表达的同义词
-2. 确认文档优先级设置（数字越小优先级越高）
-3. 检查定时触发 Cron 表达式是否正确
-4. 在 Dify 日志中确认是否有匹配的知识库内容被检索到
+#### 核心接口 QPS 限制（单租户）：
+
+| 接口分类 | 操作类型 | 华北-北京四 | 华东-上海一 | 亚太-新加坡 |
+|:---|:---|:---:|:---:|:---:|
+| 数字资产管理 | 查询资产列表/详情 | 20次/秒 | 10次/秒 | 10次/秒 |
+| 数字资产管理 | 创建/更新/删除资产 | 10次/秒 | 5次/秒 | 5次/秒 |
+| **智能交互对话** | **创建对话** | **5次/秒** | **3次/秒** | **不支持** |
+| 语音合成 TTS | 试听任务 | 5次/秒 | 3次/秒 | 3次/秒 |
+| 分身数字人 | 创建视频任务 | 5次/秒 | 3次/秒 | 3次/秒 |
+
+#### 低频限制接口（1次/秒）：
+
+- 批量资产操作
+- 导入导出相关操作
+- 交互助手相关操作（角色、知识库、问答对）
+
+**解决方案**：
+
+| 场景 | 处理方式 |
+|:---|:---|
+| 轻微超限 | 在代码中增加请求间隔（如 `asyncio.sleep(0.2)`） |
+| 持续超限 | 将业务拆分到多个子账号，分散 QPS 压力 |
+| 长期需求 | 提交工单申请 QPS 配额提升 |
+
+> **说明**：华北-北京四区域 QPS 限制最宽松，是跨区域部署的首选区域。
---
@@ -758,39 +539,61 @@ app_id = LANGUAGE_APP_MAP.get(lang, LANGUAGE_APP_MAP["zh_CN"])
### A. 华为云 MetaStudio 官方文档
-- 控制台地址：https://console.huaweicloud.com/metastudio/
-- 产品文档：https://support.huaweicloud.com/metastudio/
+| 资源 | 地址 |
+|:---|:---|
+| MetaStudio 控制台 | https://console.huaweicloud.com/metastudio/ |
+| MetaStudio 产品文档 | https://support.huaweicloud.com/metastudio/ |
+| 产品功能说明 | https://support.huaweicloud.com/productdesc-metastudio/metastudio_01_0001.html |
+| 计费说明 | https://support.huaweicloud.com/productdesc-metastudio/metastudio_01_0006.html |
+| API 使用限制（QPS 流控） | https://support.huaweicloud.com/productdesc-metastudio/metastudio_01_0010.html |
+| 智能交互限制 | https://support.huaweicloud.com/productdesc-metastudio/metastudio_01_0017.html |
+| 华为云定价页面 | https://www.huaweicloud.com/price_detail.html |
-### B. 中转服务快速验证命令
-
-```bash
-# 健康检查
-curl http://localhost:8000/
-
-# 非流式对话测试
-curl -X POST http://localhost:8000/digital-human \
- -H "Content-Type: application/json" \
- -d '{
- "messages": [{"content": "你好"}],
- "app_id": "app-PDkSHiHZsZIluoZF7N2OlNZM",
- "user": "test-user",
- "session_id": "test-001",
- "is_stream": false
- }'
-```
-
-### C. 推荐配置清单
+### B. 部署检查清单
```
□ 华为云 MetaStudio 已开通
-□ Dify 平台应用已创建
-□ 知识库文档已上传并关联
-□ .env 中 DIFY_URL / DIFY_API_KEY 已配置
-□ 容器已启动（docker compose up -d --build）
-□ 容器状态为 healthy
-□ HTTPS 反向代理已配置
-□ 域名白名单已在华为云终端配置
-□ 多语言知识库和文档已准备
-□ 发布审核已通过
-□ 上线后监控告警已配置
+□ 华为云 SIS（ASR + TTS）已开通（如需语音）
+□ 奇妙问 ASR 服务已开通（如使用奇妙问 ASR）
+□ 中转服务器防火墙已放行 TCP 8000 端口
+□ digital-human.py 中转服务已启动（状态：healthy）
+□ Redis 连接正常
+□ Dify 平台应用已创建，知识库文档已上传
+□ Dify API Key 已填入 .env
+
+# MetaStudio 控制台配置
+□ 登录 MetaStudio 工作台，点击「分身智能交互」卡片
+□ 角色配置：已选择分身数字人形象（已上传至 MetaStudio）
+□ 背景配置：已上传背景图片或选择透明背景
+□ 互动问答：已选择「第三方大脑（大模型）」
+□ APPKEY：已填入中转服务签名密钥
+□ 第三方语言模型地址：已正确填写（中转服务 URL，须公网可达）
+□ 流式响应：已按需开启/关闭
+□ 多轮语境理解能力：已配置（推荐 3）
+□ ASR 服务：已选择「奇妙问」并填入账号和密钥
+□ 尾静音时长：已设置为 ≥ 500ms
+□ 配置检查：已点击验证，无报错
+
+# 对话配置
+□ 语言和声音：已匹配（中文/英文音色对应）
+□ 语速：已调整（推荐 1.0X）
+□ 静默退出时长：已设置（建议 5 分钟）
+
+# 发布与测试
+□ 发布设置：并发数和有效期已按需配置
+□ 激活码：已获取并保存
+□ 预览测试通过，数字人能正常对话
+□ ASR 并发告警已配置（生产环境）
```
+
+### C. 名词解释
+
+| 名词 | 说明 |
+|:---|:---|
+| 第三方大脑（第三方大模型） | MetaStudio 智能交互对外调用的外部 LLM 接口，本方案通过中转服务对接 Dify |
+| 中转服务 | digital-human.py，将 MetaStudio 请求转发至 Dify，并处理多轮对话上下文 |
+| CBS | 华为云对话机器人服务（Conversational Bot Service），MetaStudio 智能交互的默认大脑 |
+| QPS | 每秒请求数（Query Per Second），API 调用频率上限 |
+| ASR | 自动语音识别（Automatic Speech Recognition），将用户语音转为文字 |
+| TTS | 语音合成（Text To Speech），将文字转为自然语音 |
+| SSE | Server-Sent Events，服务端流式推送协议，MetaStudio 与中转服务之间的流式响应格式 |