Emotion2Vec+ Large文档解读：outputs目录结构详解

1. 欢迎使用 Emotion2Vec+ Large 语音情感识别系统

你是否正在寻找一个高效、准确且易于二次开发的语音情感识别工具？Emotion2Vec+ Large 正是为此而生。由科哥基于阿里达摩院开源模型深度优化构建，这套系统不仅具备强大的情感识别能力，还提供了清晰的结果输出机制和灵活的功能配置选项。

本文将重点解析该系统的outputs目录结构，帮助开发者快速理解每次识别任务生成的数据内容、文件用途以及如何在后续项目中有效利用这些结果。无论你是想做批量分析、特征比对，还是集成到其他AI流程中，掌握输出结构都是关键一步。

2. 输出目录概览

2.1 默认输出路径

所有识别任务的结果都会自动保存在一个独立的时间戳命名目录中：

outputs/outputs_YYYYMMDD_HHMMSS/

例如：

outputs/outputs_20240104_223000/

这种设计确保了每轮识别的结果互不干扰，便于追溯和管理多个测试或生产任务。

2.2 典型目录结构

一个完整的输出目录通常包含以下三个核心文件：

outputs/ └── outputs_20240104_223000/ ├── processed_audio.wav # 预处理后的音频（统一为16kHz WAV） ├── result.json # 情感识别结果（JSON格式） └── embedding.npy # 特征向量（仅当勾选“提取Embedding”时生成）

下面我们逐一解析每个文件的作用与使用方式。

3. 核心输出文件详解

3.1`processed_audio.wav`—— 统一格式的预处理音频

这是原始上传音频经过标准化处理后的版本。

采样率：统一转换为 16kHz（模型输入要求）
格式：WAV（无损、兼容性强）
用途：
- 可用于回放验证
- 作为标准输入供其他模块调用
- 调试时确认预处理是否正常

注意：即使你上传的是 MP3 或 M4A 文件，系统也会自动转码并保存为.wav，方便后续处理。

你可以用 Python 快速加载这个文件进行检查：

from scipy.io import wavfile import numpy as np sample_rate, audio_data = wavfile.read("outputs/outputs_20240104_223000/processed_audio.wav") print(f"采样率: {sample_rate}Hz") print(f"音频长度: {len(audio_data) / sample_rate:.2f}秒")

3.2`result.json`—— 情感识别结果的核心数据

这是最核心的输出文件，记录了完整的识别结果，采用标准 JSON 格式，易于程序读取和解析。

示例内容：

{ "emotion": "happy", "confidence": 0.853, "scores": { "angry": 0.012, "disgusted": 0.008, "fearful": 0.015, "happy": 0.853, "neutral": 0.045, "other": 0.023, "sad": 0.018, "surprised": 0.021, "unknown": 0.005 }, "granularity": "utterance", "timestamp": "2024-01-04 22:30:00" }

字段说明：

字段名	含义
`emotion`	主要识别出的情感标签（英文小写）
`confidence`	置信度（0~1之间），越高越可靠
`scores`	所有9种情感的得分分布，总和为1.0
`granularity`	识别粒度：`utterance`或`frame`
`timestamp`	任务执行时间

如何在代码中读取？

import json with open("outputs/outputs_20240104_223000/result.json", "r", encoding="utf-8") as f: result = json.load(f) print(f"情感: {result['emotion']}") print(f"置信度: {result['confidence'] * 100:.1f}%") # 查看所有得分 for emo, score in result["scores"].items(): print(f"{emo}: {score:.3f}")

提示：如果你要做自动化评分系统或情绪趋势分析，result.json是你主要依赖的数据源。

3.3`embedding.npy`—— 可选但极具价值的特征向量

当你在 WebUI 中勾选了“提取 Embedding 特征”后，系统会额外生成一个.npy文件。

它是什么？

这是音频的深层语义特征表示（即 Embedding 向量）
来自 Emotion2Vec+ Large 模型中间层的输出
形状通常是(D,)或(T, D)，取决于粒度设置

有什么用？

应用场景	说明
相似度计算	计算两段语音情感表达的接近程度
聚类分析	对大量语音按情感特征分组
异常检测	发现不符合常规情绪模式的语音
二次训练	作为下游任务（如分类器）的输入特征

如何加载和使用？

import numpy as np # 加载特征向量 embedding = np.load("outputs/outputs_20240104_223000/embedding.npy") print(f"Embedding 形状: {embedding.shape}") # 例如 (768,) 或 (50, 768) # 计算两个音频的余弦相似度示例 def cosine_similarity(a, b): return np.dot(a, b) / (np.linalg.norm(a) * np.linalg.norm(b)) # 假设有两个 embedding 文件 emb1 = np.load("outputs/outputs_20240104_223000/embedding.npy") emb2 = np.load("outputs/outputs_20240104_223100/embedding.npy") similarity = cosine_similarity(emb1.flatten(), emb2.flatten()) print(f"情感相似度: {similarity:.3f}")

建议：若你计划做长期数据分析或构建个性化情感引擎，务必开启此功能。

4. 不同识别模式下的输出差异

根据你在 WebUI 中选择的粒度（granularity），输出内容会有细微差别。

4.1`utterance`模式（整句级别）

适用场景：短语音、一句话总结情绪
输出特点：
- result.json中emotion和confidence更具代表性
- embedding.npy通常是单个向量(768,)
- 结果简洁明了，适合大多数应用

推荐用于：客服质检、语音助手反馈、短视频情绪打标等。

4.2`frame`模式（帧级别）

适用场景：长语音、动态情绪变化追踪
输出特点：
- result.json的scores是一个数组列表，每帧一个
- embedding.npy是二维数组(T, 768)，T 为帧数
- 日志中会显示逐帧处理过程

示例片段（result.json中 scores）：

"scores": [ {"angry": 0.01, "happy": 0.92, ...}, {"angry": 0.03, "happy": 0.88, ...}, ... ]

适合用于：心理评估辅助、演讲情绪波动分析、影视配音匹配等需要细节洞察的场景。

5. 实际应用技巧与最佳实践

5.1 批量处理多文件时的目录管理

虽然系统一次只处理一个音频，但你可以通过脚本实现批量操作：

# 示例：循环处理多个音频 for audio in *.mp3; do cp "$audio" input.wav bash /root/run.sh sleep 3 # 等待处理完成 mv outputs/outputs_*/ result_$(basename "$audio" .mp3) done

这样每个结果都有独立命名的文件夹，便于后期整理。

5.2 自动化读取所有结果

编写一个汇总脚本，遍历所有outputs_*目录，提取关键信息：

import os import json import pandas as pd results = [] for folder in sorted(os.listdir("outputs")): if folder.startswith("outputs_"): path = os.path.join("outputs", folder) json_file = os.path.join(path, "result.json") if os.path.exists(json_file): with open(json_file, "r") as f: data = json.load(f) results.append({ "folder": folder, "emotion": data["emotion"], "confidence": data["confidence"], "timestamp": data["timestamp"] }) df = pd.DataFrame(results) df.to_csv("emotion_summary.csv", index=False) print(" 所有结果已汇总至 emotion_summary.csv")