外观
核心配置（application.yml）
后端核心配置集中在
ruoyi-admin/src/main/resources/application.yml，并按需覆盖aihuman-client-tools.yml、aihuman-prompt.yml等外部化文件。以下逐项列出有「可选值 / 可调整范围」的关键参数，便于部署与二次开发。
一、关键配置项一览
| 配置项 | 默认值 | 说明 | 可选值 / 可调整范围 |
|---|---|---|---|
spring.servlet.multipart.max-file-size | 50MB | 单个上传文件最大体积（ASR 语音文件上传） | 可酌情调大，如 100MB、200MB；单位支持 KB / MB / GB |
spring.servlet.multipart.max-request-size | 100MB | 单次请求最大体积 | 同上，需 ≥ max-file-size |
aihuman.llm.openai.api-key | 无（必填） | SiliconFlow API Key，格式以 sk- 开头 | 任意有效 Key；LLM 与 ASR 可共用同一 Key |
aihuman.llm.openai.base-url | SiliconFlow 网关 | OpenAI 兼容接口地址（代码默认值） | 可切换为其他 OpenAI 兼容网关地址 |
aihuman.llm.model | deepseek-ai/DeepSeek-V3.2 | 实际调用的 LLM 模型名（代码默认值） | 可选 SiliconFlow 上其他模型，例如 deepseek-ai/DeepSeek-R1、Qwen/Qwen2.5-72B-Instruct、Pro/ 付费模型等；需在 SiliconFlow 控制台先开通 |
aihuman.client-tools.config-location | classpath:aihuman-client-tools.yml | 客户端工具（数字人可执行的地图/弹窗/模块切换等动作）清单配置文件位置 | classpath:xxx.yml 或外部绝对路径 file:/path/xxx.yml（便于不重新打包即更新工具） |
aihuman.prompt.config-location | classpath:aihuman-prompt.yml | 提示词配置文件位置 | 同上，支持 classpath: 或 file: 外部路径 |
aihuman.asr.siliconflow.api-key | 无（必填） | 硅基流动 ASR 的 API Key | 可与 LLM 共用同一 sk- Key；也可单独申请 |
aihuman.tts.* | 见 module-tts 文档 | 文本转语音相关（阿里云 NLS 等） | 不同厂商 / 不同音色，详见「文本转语音 TTS」 |
aihuman.tts.aliyun.realtime.idle-keep-alive-ms | 15000 | 双工实时合成的「空闲保活」间隔（毫秒）：距上次投喂文本超过该值就补发一个保活帧，规避阿里云 23s 空闲超时（request timeout after 23 seconds） | 设为 0 关闭该机制；建议 < 20000（默认已相对 23s 留出余量） |
aihuman.tts.aliyun.realtime.idle-keep-alive-text | 。 | 保活帧文本（句末标点） | 不要用空格 / 逗号：软标点会被服务端"攒批"等更多文本、反而不回流 |
aihuman.tts.aliyun.realtime.download-format | mp3 | 「预设语音 mp3 生成」接口（/tts/qwen/download）的音频格式，服务端直出、无需后端编码 | mp3（默认）/ wav / opus；改成 pcm 得到的是无文件头的裸数据 |
aihuman.tts.aliyun.realtime.download-sample-rate | 24000 | 同上接口的采样率（Hz） | 与音色匹配的常用值即可，如 24000 / 22050 / 16000 |
aihuman.tts.aliyun.realtime.download-timeout-ms | 60000 | 同上接口的整体超时（毫秒）：覆盖「建连 → 合成 → task-finished」全过程，超时自动取消云端任务 | 长文本可适当调大（如 120000） |
ℹ️ 暂未使用：表格中的
aihuman.llm.*、aihuman.client-tools.*、aihuman.prompt.*服务于数字人内置 LLM 对话能力（ruoyi-aihuman-core+-business），该能力暂未使用、前端未调用（前端对话使用的是业务后台/ai/*）；配置暂予保留。aihuman.asr.*、aihuman.nlu.*、aihuman.tts.*仍在使用。
二、application.yml 关键片段
yaml
# 关键配置项
spring:
servlet:
multipart:
max-file-size: 50MB # ASR 语音文件上传
max-request-size: 100MB
aihuman:
llm: # 【暂未使用】内置 LLM 对话（前端对话走业务后台）
openai:
api-key: sk-xxx # SiliconFlow API Key
client-tools: # 【暂未使用】内置 LLM 对话工具清单
config-location: classpath:aihuman-client-tools.yml
prompt: # 【暂未使用】内置 LLM 对话提示词
config-location: classpath:aihuman-prompt.yml
asr:
siliconflow:
api-key: sk-xxx # 与 LLM 共用一 Key三、Security 已放行路径
所有 /digital-human/* 和 /ws/* 端点均为公开访问，无需 JWT 认证（前端大屏 / 手机 H5 直接调用）：
java
.antMatchers("/ws/**").permitAll()
.antMatchers("/digital-human/pairing/**").permitAll()
.antMatchers("/digital-human/agent/**").permitAll() // 暂未使用的 LLM 对话接口（前端对话走业务后台）
.antMatchers("/digital-human/asr/**").permitAll()迁移到新项目时，务必保留上述放行配置，否则前端配对 / 对话 / 语音接口会返回 401。