Merge pull request #2695 from xinnan-tech/py_device_bind

update: 未绑定设备策略优化
update:常用音频增加缓存，抵御高并发未授权设备访问
2026-07-23 23:53:55 +08:00 · 2025-12-13 23:30:44 +08:00 · 2025-12-13 23:10:40 +08:00 · 2025-12-13 22:29:10 +08:00 · 2025-12-13 21:45:31 +08:00 · 2025-12-13 20:27:40 +08:00
199 changed files with 22792 additions and 8395 deletions
@@ -0,0 +1,6 @@
 version: 2
 updates:
  - package-ecosystem: pip
    directory: /main/xiaozhi-server
    schedule:
      interval: weekly
@@ -0,0 +1,49 @@
 name: Build Base Image
 on:
  push:
    branches:
      - main
    paths:
      - 'main/xiaozhi-server/requirements.txt'
      - 'Dockerfile-server-base'
      - '.github/workflows/build-base-image.yml'
 jobs:
  build-base:
    name: Build and push server base image
    runs-on: ubuntu-latest
    permissions:
      packages: write
      contents: read
    steps:
      - name: Checkout code
        uses: actions/checkout@v4
      - name: Set up Docker Buildx
        uses: docker/setup-buildx-action@v3
      - name: Login to GitHub Container Registry
        uses: docker/login-action@v3
        with:
          registry: ghcr.io
          username: ${{ github.actor }}
          password: ${{ secrets.TOKEN }}
      - name: Build and push server-base
        uses: docker/build-push-action@v6
        with:
          context: .
          file: Dockerfile-server-base
          push: true
          tags: ghcr.io/${{ github.repository }}:server-base
          platforms: linux/amd64
          cache-from: type=gha,scope=server-base
          cache-to: type=gha,mode=max,scope=server-base
          build-args: |
            BUILDKIT_PROGRESS=plain
      - name: Output image info
        run: |
          echo "✅ Base image built and pushed successfully!"
          echo "📦 Tag: ghcr.io/${{ github.repository }}:server-base"
@@ -5,6 +5,10 @@ on:
    tags:
      - 'v*.*.*'  # 只在以 v 开头的标签推送时触发，例如 v1.0.0
  workflow_dispatch:
  workflow_run:
    workflows: ["Build Base Image"]
    types:
      - completed
 jobs:
  release:
@@ -182,4 +182,5 @@ uploadfile
 # Do not ignore env and json files inside manager-mobile
 !main/manager-mobile/**/env/
 !main/manager-mobile/**/.env*
-!main/manager-mobile/**/*.json
+!main/manager-mobile/**/*.json
 !main/xiaozhi-server/**/*.json
@@ -1,36 +1,6 @@
-# 第一阶段：构建Python依赖
+# 生产镜像，仅包含应用代码
-FROM python:3.10-slim AS builder
+FROM ghcr.io/xinnan-tech/xiaozhi-esp32-server:server-base
 WORKDIR /app
 # 配置pip使用国内镜像源（阿里云）并设置超时和重试
 RUN pip config set global.index-url https://mirrors.aliyun.com/pypi/simple/ && \
    pip config set global.trusted-host mirrors.aliyun.com && \
    pip config set global.timeout 120 && \
    pip config set install.retries 5
 COPY main/xiaozhi-server/requirements.txt .
 # 安装Python依赖，使用并行下载
 RUN pip install --no-cache-dir --upgrade pip setuptools wheel && \
    pip install --no-cache-dir -r requirements.txt --default-timeout=120 --retries 5
 # 第二阶段：生产镜像
 FROM python:3.10-slim
 WORKDIR /opt/xiaozhi-esp32-server
 # 安装系统依赖
 RUN apt-get update && \
    apt-get install -y --no-install-recommends libopus0 ffmpeg && \
    apt-get clean && \
    rm -rf /var/lib/apt/lists/*
 # 从构建阶段复制Python包和前端构建产物
 COPY --from=builder /usr/local/lib/python3.10/site-packages /usr/local/lib/python3.10/site-packages
 COPY --from=builder /usr/local/bin/mcp-proxy /usr/local/bin/mcp-proxy
 # 复制应用代码
 COPY main/xiaozhi-server .
 # 启动应用
@@ -0,0 +1,32 @@
 # Dockerfile-server-base
 # 基础镜像，包含系统依赖和Python包
 FROM python:3.10-slim
 # 安装系统依赖
 RUN apt-get update && \
    apt-get install -y --no-install-recommends libopus0 ffmpeg locales && \
    sed -i '/zh_CN.UTF-8/s/^# //g' /etc/locale.gen && \
    locale-gen && \
    apt-get clean && \
    rm -rf /var/lib/apt/lists/*
 # 配置pip使用国内镜像源（阿里云）并设置超时和重试
 RUN pip config set global.index-url https://mirrors.aliyun.com/pypi/simple/ && \
    pip config set global.trusted-host mirrors.aliyun.com && \
    pip config set global.timeout 120 && \
    pip config set install.retries 5
 # 设置环境变量以确保正确的字符编码
 ENV LANG=zh_CN.UTF-8 \
    LC_ALL=zh_CN.UTF-8 \
    LANGUAGE=zh_CN:zh \
    PYTHONIOENCODING=utf-8
 WORKDIR /opt/xiaozhi-esp32-server
 # 复制requirements.txt
 COPY main/xiaozhi-server/requirements.txt .
 # 安装Python依赖
 RUN pip install --no-cache-dir --upgrade pip setuptools wheel && \
    pip install --no-cache-dir -r requirements.txt --default-timeout=120 --retries 5
@@ -6,29 +6,24 @@
 本项目基于人机共生智能理论和技术研发智能终端软硬件体系<br/>为开源智能硬件项目
 <a href="https://github.com/78/xiaozhi-esp32">xiaozhi-esp32</a>提供后端服务<br/>
 根据<a href="https://ccnphfhqs21z.feishu.cn/wiki/M0XiwldO9iJwHikpXD5cEx71nKh">小智通信协议</a>使用Python、Java、Vue实现<br/>
-支持MQTT+UDP协议、Websocket协议、MCP接入点、声纹识别
+支持MQTT+UDP协议、Websocket协议、MCP接入点、声纹识别、知识库
 </p>
 <p align="center">
-<a href="./README_en.md">English</a>
+<a href="./docs/FAQ.md">常见问题</a>
 · <a href="./docs/FAQ.md">常见问题</a>
 · <a href="https://github.com/xinnan-tech/xiaozhi-esp32-server/issues">反馈问题</a>
 · <a href="./README.md#%E9%83%A8%E7%BD%B2%E6%96%87%E6%A1%A3">部署文档</a>
 · <a href="https://github.com/xinnan-tech/xiaozhi-esp32-server/releases">更新日志</a>
 </p>
 <p align="center">
  <a href="./README.md"><img alt="简体中文版自述文件" src="https://img.shields.io/badge/简体中文-DBEDFA"></a>
  <a href="./README_en.md"><img alt="README in English" src="https://img.shields.io/badge/English-DFE0E5"></a>
  <a href="./README_vi.md"><img alt="Tiếng Việt" src="https://img.shields.io/badge/Tiếng Việt-DFE0E5"></a>
  <a href="./README_de.md"><img alt="Deutsch" src="https://img.shields.io/badge/Deutsch-DFE0E5"></a>
  <a href="https://github.com/xinnan-tech/xiaozhi-esp32-server/releases">
    <img alt="GitHub Contributors" src="https://img.shields.io/github/v/release/xinnan-tech/xiaozhi-esp32-server?logo=docker" />
  </a>
  <a href="https://github.com/xinnan-tech/xiaozhi-esp32-server/graphs/contributors">
    <img alt="GitHub Contributors" src="https://img.shields.io/github/contributors/xinnan-tech/xiaozhi-esp32-server?logo=github" />
  </a>
  <a href="https://github.com/xinnan-tech/xiaozhi-esp32-server/issues">
    <img alt="Issues" src="https://img.shields.io/github/issues/xinnan-tech/xiaozhi-esp32-server?color=0088ff" />
  </a>
  <a href="https://github.com/xinnan-tech/xiaozhi-esp32-server/pulls">
    <img alt="GitHub pull requests" src="https://img.shields.io/github/issues-pr/xinnan-tech/xiaozhi-esp32-server?color=0088ff" />
  </a>
  <a href="https://github.com/xinnan-tech/xiaozhi-esp32-server/blob/main/LICENSE">
    <img alt="GitHub pull requests" src="https://img.shields.io/badge/license-MIT-white?labelColor=black" />
  </a>
@@ -246,8 +241,9 @@ Websocket接口地址: wss://2662r3426b.vicp.fun/xiaozhi/v1/
 | 声纹识别 | 支持多用户声纹注册、管理和识别，与ASR并行处理，实时识别说话人身份并传递给LLM进行个性化回应 |
 | 智能对话 | 支持多种LLM(大语言模型)，实现智能对话 |
 | 视觉感知 | 支持多种VLLM(视觉大模型)，实现多模态交互 |
-| 意图识别 | 支持LLM意图识别、Function Call函数调用，提供插件化意图处理机制 |
+| 意图识别 | 支持外挂的大模型意图识别、大模型自主函数调用，提供插件化意图处理机制 |
 | 记忆系统 | 支持本地短期记忆、mem0ai接口记忆，具备记忆总结功能 |
 | 知识库 | 支持RAGFlow知识库，让大模型判断需要调度知识库后再回答 |
 | 工具调用 | 支持客户端IOT协议、客户MCP协议、服务端MCP协议、MCP接入点协议、自定义工具函数 |
 | 指令下发 | 依托MQTT协议，支持从智控台将MCP指令下发到ESP32设备 |
 | 管理后台 | 提供Web管理界面，支持用户管理、系统配置和设备管理；界面支持中文简体、中文繁体、英文显示 |
@@ -273,7 +269,7 @@ Websocket接口地址: wss://2662r3426b.vicp.fun/xiaozhi/v1/
 | 使用方式 | 支持平台 | 免费平台 |
 |:---:|:---:|:---:|
-| openai 接口调用 | 阿里百炼、火山引擎豆包、深度求索、智谱ChatGLM、Gemini | 智谱ChatGLM、Gemini |
+| openai 接口调用 | 阿里百炼、火山引擎、DeepSeek、智谱、Gemini、科大讯飞 | 智谱、Gemini |
 | ollama 接口调用 | Ollama | - |
 | dify 接口调用 | Dify | - |
 | fastgpt 接口调用 | Fastgpt | - |
@@ -299,7 +295,7 @@ Websocket接口地址: wss://2662r3426b.vicp.fun/xiaozhi/v1/
 | 使用方式 | 支持平台 | 免费平台 |
 |:---:|:---:|:---:|
-| 接口调用 | EdgeTTS、火山引擎豆包TTS、腾讯云、阿里云TTS、阿里云流式TTS、CosyVoiceSiliconflow、TTS302AI、CozeCnTTS、GizwitsTTS、ACGNTTS、OpenAITTS、灵犀流式TTS、MinimaxTTS、火山双流式TTS | 灵犀流式TTS、EdgeTTS、CosyVoiceSiliconflow(部分) |
+| 接口调用 | EdgeTTS、科大讯飞、火山引擎、腾讯云、阿里云及百炼、CosyVoiceSiliconflow、TTS302AI、CozeCnTTS、GizwitsTTS、ACGNTTS、OpenAITTS、灵犀流式TTS、MinimaxTTS | 灵犀流式TTS、EdgeTTS、CosyVoiceSiliconflow(部分) |
 | 本地服务 | FishSpeech、GPT_SOVITS_V2、GPT_SOVITS_V3、Index-TTS、PaddleSpeech | Index-TTS、PaddleSpeech、FishSpeech、GPT_SOVITS_V2、GPT_SOVITS_V3 |
 ---
@@ -317,7 +313,7 @@ Websocket接口地址: wss://2662r3426b.vicp.fun/xiaozhi/v1/
 | 使用方式 | 支持平台 | 免费平台 |
 |:---:|:---:|:---:|
 | 本地使用 | FunASR、SherpaASR | FunASR、SherpaASR |
-| 接口调用 | DoubaoASR、Doubao流式ASR、FunASRServer、TencentASR、AliyunASR、Aliyun流式ASR、百度ASR、OpenAI ASR | FunASRServer |
+| 接口调用 | FunASRServer、火山引擎、科大讯飞、腾讯云、阿里云、百度云、OpenAI ASR | FunASRServer |
 ---
@@ -349,6 +345,14 @@ Websocket接口地址: wss://2662r3426b.vicp.fun/xiaozhi/v1/
 ---
 ### Rag 检索增强生成
 |   类型   |     平台名称      | 使用方式 |  收费模式   |          备注           |
 |:------:|:-------------:|:----:|:-------:|:---------------------:|
 | Rag |  ragflow   | 接口调用 | 根据切片、分词消耗的token收费 |    借助RagFlow的检索增强生成功能，提供更准确的对话回复     |
 ---
 ## 鸣谢 🙏
 | Logo | 项目/公司 | 说明 |
@@ -0,0 +1,374 @@
 [![Banners](docs/images/banner1.png)](https://github.com/xinnan-tech/xiaozhi-esp32-server)
 <h1 align="center">Xiaozhi Backend-Service xiaozhi-esp32-server</h1>
 <p align="center">
 Dieses Projekt basiert auf der Theorie und Technologie der Mensch-Maschine-symbiotischen Intelligenz zur Entwicklung intelligenter Terminal-Hardware- und Software-Systeme<br/>und bietet Backend-Dienste für das Open-Source-Hardware-Projekt
 <a href="https://github.com/78/xiaozhi-esp32">xiaozhi-esp32</a><br/>
 Implementiert mit Python, Java und Vue gemäß dem <a href="https://ccnphfhqs21z.feishu.cn/wiki/M0XiwldO9iJwHikpXD5cEx71nKh">Xiaozhi-Kommunikationsprotokoll</a><br/>
 Unterstützt MQTT+UDP-Protokoll, Websocket-Protokoll, MCP-Endpunkte und Stimmabdruckerkennung
 </p>
 <p align="center">
 <a href="./docs/FAQ.md">Häufige Fragen</a>
 · <a href="https://github.com/xinnan-tech/xiaozhi-esp32-server/issues">Probleme melden</a>
 · <a href="./README.md#%E9%83%A8%E7%BD%B2%E6%96%87%E6%A1%A3">Deployment-Dokumentation</a>
 · <a href="https://github.com/xinnan-tech/xiaozhi-esp32-server/releases">Release-Hinweise</a>
 </p>
 <p align="center">
  <a href="./README.md"><img alt="简体中文版自述文件" src="https://img.shields.io/badge/简体中文-DFE0E5"></a>
  <a href="./README_en.md"><img alt="README in English" src="https://img.shields.io/badge/English-DFE0E5"></a>
  <a href="./README_vi.md"><img alt="Tiếng Việt" src="https://img.shields.io/badge/Tiếng Việt-DFE0E5"></a>
  <a href="./README_de.md"><img alt="Deutsch" src="https://img.shields.io/badge/Deutsch-DBEDFA"></a>
  <a href="https://github.com/xinnan-tech/xiaozhi-esp32-server/releases">
    <img alt="GitHub Contributors" src="https://img.shields.io/github/v/release/xinnan-tech/xiaozhi-esp32-server?logo=docker" />
  </a>
  <a href="https://github.com/xinnan-tech/xiaozhi-esp32-server/blob/main/LICENSE">
    <img alt="GitHub pull requests" src="https://img.shields.io/badge/license-MIT-white?labelColor=black" />
  </a>
  <a href="https://github.com/xinnan-tech/xiaozhi-esp32-server">
    <img alt="stars" src="https://img.shields.io/github/stars/xinnan-tech/xiaozhi-esp32-server?color=ffcb47&labelColor=black" />
  </a>
 </p>
 <p align="center">
 Geleitet vom Team von Professor Siyuan Liu (South China University of Technology)
 </br>
 刘思源教授团队主导研发(华南理工大学)
 </br>
 <img src="./docs/images/hnlg.jpg" alt="South China University of Technology" width="50%">
 </p>
 ---
 ## Zielgruppe 👥
 Dieses Projekt erfordert ESP32-Hardware-Geräte zum Betrieb. Wenn Sie ESP32-bezogene Hardware erworben haben, erfolgreich eine Verbindung zu Brother Xias bereitgestelltem Backend-Service hergestellt haben und Ihren eigenen `xiaozhi-esp32`-Backend-Service unabhängig aufbauen möchten, dann ist dieses Projekt perfekt für Sie.
 Möchten Sie die Nutzungseffekte sehen? Klicken Sie auf die Videos unten 🎥
 <table>
  <tr>
    <td>
        <a href="https://www.bilibili.com/video/BV1FMFyejExX" target="_blank">
         <picture>
           <img alt="响应速度感受" src="docs/images/demo9.png" />
         </picture>
        </a>
    </td>
    <td>
        <a href="https://www.bilibili.com/video/BV1vchQzaEse" target="_blank">
         <picture>
           <img alt="速度优化秘诀" src="docs/images/demo6.png" />
         </picture>
        </a>
    </td>
    <td>
        <a href="https://www.bilibili.com/video/BV1C1tCzUEZh" target="_blank">
         <picture>
           <img alt="复杂医疗场景" src="docs/images/demo1.png" />
         </picture>
        </a>
    </td>
    <td>
        <a href="https://www.bilibili.com/video/BV1zUW5zJEkq" target="_blank">
         <picture>
           <img alt="MQTT指令下发" src="docs/images/demo4.png" />
         </picture>
        </a>
    </td>
    <td>
        <a href="https://www.bilibili.com/video/BV1Exu3zqEDe" target="_blank">
         <picture>
           <img alt="声纹识别" src="docs/images/demo14.png" />
         </picture>
        </a>
    </td>
  </tr>
  <tr>
    <td>
        <a href="https://www.bilibili.com/video/BV1pNXWYGEx1" target="_blank">
         <picture>
           <img alt="控制家电开关" src="docs/images/demo5.png" />
         </picture>
        </a>
    </td>
    <td>
        <a href="https://www.bilibili.com/video/BV1ZQKUzYExM" target="_blank">
         <picture>
           <img alt="MCP接入点" src="docs/images/demo13.png" />
         </picture>
        </a>
    </td>
    <td>
      <a href="https://www.bilibili.com/video/BV1TJ7WzzEo6" target="_blank">
         <picture>
           <img alt="多指令任务" src="docs/images/demo11.png" />
         </picture>
        </a>
    </td>
    <td>
        <a href="https://www.bilibili.com/video/BV1VC96Y5EMH" target="_blank">
         <picture>
           <img alt="播放音乐" src="docs/images/demo7.png" />
         </picture>
        </a>
    </td>
    <td>
        <a href="https://www.bilibili.com/video/BV1Z8XuYZEAS" target="_blank">
         <picture>
           <img alt="天气插件" src="docs/images/demo8.png" />
         </picture>
        </a>
    </td>
  </tr>
  <tr>
    <td>
      <a href="https://www.bilibili.com/video/BV12J7WzBEaH" target="_blank">
         <picture>
           <img alt="实时打断" src="docs/images/demo10.png" />
         </picture>
        </a>
    </td>
    <td>
      <a href="https://www.bilibili.com/video/BV1Co76z7EvK" target="_blank">
         <picture>
           <img alt="拍照识物品" src="docs/images/demo12.png" />
         </picture>
        </a>
    </td>
    <td>
        <a href="https://www.bilibili.com/video/BV1CDKWemEU6" target="_blank">
         <picture>
           <img alt="自定义音色" src="docs/images/demo2.png" />
         </picture>
        </a>
    </td>
    <td>
        <a href="https://www.bilibili.com/video/BV12yA2egEaC" target="_blank">
         <picture>
           <img alt="使用粤语交流" src="docs/images/demo3.png" />
         </picture>
        </a>
    </td>
    <td>
        <a href="https://www.bilibili.com/video/BV17LXWYvENb" target="_blank">
         <picture>
           <img alt="播报新闻" src="docs/images/demo0.png" />
         </picture>
        </a>
    </td>
  </tr>
 </table>
 ---
 ## Warnungen ⚠️
 1. Dieses Projekt ist Open-Source-Software. Diese Software hat keine kommerzielle Partnerschaft mit Drittanbieter-API-Dienstleistern (einschließlich, aber nicht beschränkt auf Spracherkennung, große Modelle, Sprachsynthese und andere Plattformen), mit denen sie sich verbindet, und bietet keine Garantie für deren Servicequalität oder finanzielle Sicherheit. Es wird empfohlen, dass Benutzer Dienstleister mit entsprechenden Geschäftslizenzen bevorzugen und deren Servicevereinbarungen und Datenschutzrichtlinien sorgfältig lesen. Diese Software hostet keine Kontoschlüssel, nimmt nicht an Geldströmen teil und trägt nicht das Risiko von Verlusten bei Guthaben-Aufladungen.
 2. Die Funktionalität dieses Projekts ist nicht vollständig und hat keine Netzwerksicherheitsbewertung bestanden. Bitte verwenden Sie es nicht in Produktionsumgebungen. Wenn Sie dieses Projekt zu Lernzwecken in einer öffentlichen Netzwerkumgebung bereitstellen, stellen Sie bitte sicher, dass notwendige Schutzmaßnahmen vorhanden sind.
 ---
 ## Deployment-Dokumentation
 ![Banners](docs/images/banner2.png)
 Dieses Projekt bietet zwei Bereitstellungsmethoden. Bitte wählen Sie basierend auf Ihren spezifischen Anforderungen:
 #### 🚀 Auswahl der Bereitstellungsmethode
 | Bereitstellungsmethode | Funktionen | Anwendungsszenarien | Deployment-Dokumente | Konfigurationsanforderungen | Video-Tutorials |
 |---------|------|---------|---------|---------|---------|
 | **Vereinfachte Installation** | Intelligenter Dialog, IOT, MCP, visuelle Wahrnehmung | Umgebungen mit geringer Konfiguration, Daten in Konfigurationsdateien gespeichert, keine Datenbank erforderlich | [①Docker-Version](./docs/Deployment.md#%E6%96%B9%E5%BC%8F%E4%B8%80docker%E5%8F%AA%E8%BF%90%E8%A1%8Cserver) / [②Quellcode-Deployment](./docs/Deployment.md#%E6%96%B9%E5%BC%8F%E4%BA%8C%E6%9C%AC%E5%9C%B0%E6%BA%90%E7%A0%81%E5%8F%AA%E8%BF%90%E8%A1%8Cserver)| 2 Kerne 4GB bei Verwendung von `FunASR`, 2 Kerne 2GB bei allen APIs | - |
 | **Vollständige Modulinstallation** | Intelligenter Dialog, IOT, MCP-Endpunkte, Stimmabdruckerkennung, visuelle Wahrnehmung, OTA, intelligente Steuerkonsole | Vollständige Funktionserfahrung, Daten in Datenbank gespeichert |[①Docker-Version](./docs/Deployment_all.md#%E6%96%B9%E5%BC%8F%E4%B8%80docker%E8%BF%90%E8%A1%8C%E5%85%A8%E6%A8%A1%E5%9D%97) / [②Quellcode-Deployment](./docs/Deployment_all.md#%E6%96%B9%E5%BC%8F%E4%BA%8C%E6%9C%AC%E5%9C%B0%E6%BA%90%E7%A0%81%E8%BF%90%E8%A1%8C%E5%85%A8%E6%A8%A1%E5%9D%97) / [③Quellcode-Deployment Auto-Update-Tutorial](./docs/dev-ops-integration.md) | 4 Kerne 8GB bei Verwendung von `FunASR`, 2 Kerne 4GB bei allen APIs| [Video-Tutorial für lokalen Quellcode-Start](https://www.bilibili.com/video/BV1wBJhz4Ewe) |
 Häufige Fragen und entsprechende Tutorials finden Sie unter [diesem Link](./docs/FAQ.md)
 > 💡 Hinweis: Unten ist eine Testplattform, die mit dem neuesten Code bereitgestellt wurde. Sie können bei Bedarf brennen und testen. Gleichzeitige Benutzer: 6, Daten werden täglich gelöscht.
 ```
 Adresse der intelligenten Steuerkonsole: https://2662r3426b.vicp.fun
 Adresse der intelligenten Steuerkonsole (H5): https://2662r3426b.vicp.fun/h5/index.html
 Service-Testtool: https://2662r3426b.vicp.fun/test/
 OTA-Schnittstellenadresse: https://2662r3426b.vicp.fun/xiaozhi/ota/
 Websocket-Schnittstellenadresse: wss://2662r3426b.vicp.fun/xiaozhi/v1/
 ```
 #### 🚩 Konfigurationsbeschreibung und Empfehlungen
 > [!Note]
 > Dieses Projekt bietet zwei Konfigurationsschemata:
 >
 > 1. `Einstiegslevel Kostenlose Einstellungen`: Geeignet für den persönlichen und privaten Gebrauch, alle Komponenten verwenden kostenlose Lösungen, keine zusätzliche Zahlung erforderlich.
 >
 > 2. `Streaming-Konfiguration`: Geeignet für Demonstrationen, Schulungen, Szenarien mit mehr als 2 gleichzeitigen Benutzern usw. Verwendet Streaming-Verarbeitungstechnologie für schnellere Reaktionsgeschwindigkeit und bessere Erfahrung.
 >
 > Ab Version `0.5.2` unterstützt das Projekt Streaming-Konfiguration. Im Vergleich zu früheren Versionen ist die Reaktionsgeschwindigkeit um ca. `2,5 Sekunden` verbessert, was die Benutzererfahrung erheblich verbessert.
 | Modulname | Einstiegslevel Kostenlose Einstellungen | Streaming-Konfiguration |
 |:---:|:---:|:---:|
 | ASR (Spracherkennung) | FunASR (Lokal) | 👍FunASR (Lokaler GPU-Modus) |
 | LLM (Großes Modell) | ChatGLMLLM (Zhipu glm-4-flash) | 👍AliLLM (qwen3-235b-a22b-instruct-2507) oder 👍DoubaoLLM (doubao-1-5-pro-32k-250115) |
 | VLLM (Vision Large Model) | ChatGLMVLLM (Zhipu glm-4v-flash) | 👍QwenVLVLLM (Qwen qwen2.5-vl-3b-instructh) |
 | TTS (Sprachsynthese) | ✅LinkeraiTTS (Lingxi-Streaming) | 👍HuoshanDoubleStreamTTS (Volcano Dual-Stream-Sprachsynthese) oder 👍AliyunStreamTTS (Alibaba Cloud Streaming-Sprachsynthese) |
 | Intent (Absichtserkennung) | function_call (Funktionsaufruf) | function_call (Funktionsaufruf) |
 | Memory (Gedächtnisfunktion) | mem_local_short (Lokales Kurzzeitgedächtnis) | mem_local_short (Lokales Kurzzeitgedächtnis) |
 Wenn Sie sich um die Latenz jeder Komponente kümmern, lesen Sie bitte den [Xiaozhi-Komponenten-Leistungstestbericht](https://github.com/xinnan-tech/xiaozhi-performance-research). Sie können gemäß den Testmethoden im Bericht in Ihrer Umgebung tatsächlich testen.
 #### 🔧 Testwerkzeuge
 Dieses Projekt bietet die folgenden Testwerkzeuge, um Ihnen bei der Überprüfung des Systems und der Auswahl geeigneter Modelle zu helfen:
 | Werkzeugname | Standort | Verwendungsmethode | Funktionsbeschreibung |
 |:---:|:---|:---:|:---:|
 | Audio-Interaktionstesttool | main》xiaozhi-server》test》test_page.html | Direkt mit Google Chrome öffnen | Testet Audio-Wiedergabe- und Empfangsfunktionen, überprüft, ob die Python-seitige Audioverarbeitung normal ist |
 | Modell-Reaktionstesttool | main》xiaozhi-server》performance_tester.py | Ausführen `python performance_tester.py` | Testet die Reaktionsgeschwindigkeit von ASR (Spracherkennung), LLM (großes Modell), VLLM (Vision-Modell), TTS (Sprachsynthese) drei Kernmodulen |
 > 💡 Hinweis: Beim Testen der Modellgeschwindigkeit werden nur Modelle mit konfigurierten Schlüsseln getestet.
 ---
 ## Funktionsliste ✨
 ### Implementiert ✅
 ![请参考-全模块安装架构图](docs/images/deploy2.png)
 | Funktionsmodul | Beschreibung |
 |:---:|:---|
 | Kernarchitektur | Basierend auf [MQTT+UDP-Gateway](https://github.com/xinnan-tech/xiaozhi-esp32-server/blob/main/docs/mqtt-gateway-integration.md), WebSocket und HTTP-Servern, bietet vollständiges Konsolenverwaltungs- und Authentifizierungssystem |
 | Sprachinteraktion | Unterstützt Streaming-ASR (Spracherkennung), Streaming-TTS (Sprachsynthese), VAD (Sprachaktivitätserkennung), unterstützt mehrsprachige Erkennung und Sprachverarbeitung |
 | Stimmabdruckerkennung | Unterstützt Mehrbenutzer-Stimmabdruckregistrierung, -verwaltung und -erkennung, verarbeitet parallel mit ASR, Echtzeit-Sprecheridentitätserkennung und Weitergabe an LLM für personalisierte Antworten |
 | Intelligenter Dialog | Unterstützt mehrere LLM (große Sprachmodelle), implementiert intelligenten Dialog |
 | Visuelle Wahrnehmung | Unterstützt mehrere VLLM (Vision Large Models), implementiert multimodale Interaktion |
 | Absichtserkennung | Unterstützt LLM-Absichtserkennung, Function Call-Funktionsaufruf, bietet plugin-basierten Absichtsverarbeitungsmechanismus |
 | Gedächtnissystem | Unterstützt lokales Kurzzeitgedächtnis, mem0ai-Schnittstellengedächtnis, mit Gedächtniszusammenfassungsfunktion |
 | Wissensdatenbank | Unterstützt RAGFlow-Wissensdatenbank, ermöglicht großem Modell die Bewertung, ob Wissensdatenbank benötigt wird, bevor geantwortet wird |
 | Werkzeugaufruf | Unterstützt Client-IOT-Protokoll, Client-MCP-Protokoll, Server-MCP-Protokoll, MCP-Endpunktprotokoll, benutzerdefinierte Werkzeugfunktionen |
 | Befehlsübermittlung | Basierend auf MQTT-Protokoll, unterstützt die Übermittlung von MCP-Befehlen von der intelligenten Steuerkonsole an ESP32-Geräte |
 | Verwaltungs-Backend | Bietet Web-Verwaltungsoberfläche, unterstützt Benutzerverwaltung, Systemkonfiguration und Geräteverwaltung; Oberfläche unterstützt vereinfachtes Chinesisch, traditionelles Chinesisch und englische Anzeige |
 | Testwerkzeuge | Bietet Leistungstestwerkzeuge, Vision-Modell-Testwerkzeuge und Audio-Interaktionstestwerkzeuge |
 | Deployment-Unterstützung | Unterstützt Docker-Deployment und lokales Deployment, bietet vollständige Konfigurationsdateiverwaltung |
 | Plugin-System | Unterstützt funktionale Plugin-Erweiterungen, benutzerdefinierte Plugin-Entwicklung und Plugin-Hot-Loading |
 ### In Entwicklung 🚧
 Um über spezifische Entwicklungsplanfortschritte zu erfahren, [klicken Sie hier](https://github.com/users/xinnan-tech/projects/3). Häufige Fragen und entsprechende Tutorials finden Sie unter [diesem Link](./docs/FAQ.md)
 Wenn Sie ein Softwareentwickler sind, finden Sie hier einen [Offenen Brief an Entwickler](docs/contributor_open_letter.md). Willkommen beim Beitritt!
 ---
 ## Produktökosystem 👬
 Xiaozhi ist ein Ökosystem. Wenn Sie dieses Produkt verwenden, können Sie sich auch andere [hervorragende Projekte](https://github.com/78/xiaozhi-esp32?tab=readme-ov-file#%E7%9B%B8%E5%85%B3%E5%BC%80%E6%BA%90%E9%A1%B9%E7%9B%AE) in diesem Ökosystem ansehen
 ---
 ## Liste der von diesem Projekt unterstützten Plattformen/Komponenten 📋
 ### LLM-Sprachmodelle
 | Verwendungsmethode | Unterstützte Plattformen | Kostenlose Plattformen |
 |:---:|:---:|:---:|
 | OpenAI-Schnittstellenaufrufe | Alibaba Bailian, Volcano Engine Doubao, DeepSeek, Zhipu ChatGLM, Gemini | Zhipu ChatGLM, Gemini |
 | Ollama-Schnittstellenaufrufe | Ollama | - |
 | Dify-Schnittstellenaufrufe | Dify | - |
 | FastGPT-Schnittstellenaufrufe | FastGPT | - |
 | Coze-Schnittstellenaufrufe | Coze | - |
 | Xinference-Schnittstellenaufrufe | Xinference | - |
 | HomeAssistant-Schnittstellenaufrufe | HomeAssistant | - |
 Tatsächlich kann jedes LLM, das OpenAI-Schnittstellenaufrufe unterstützt, integriert und verwendet werden.
 ---
 ### VLLM-Vision-Modelle
 | Verwendungsmethode | Unterstützte Plattformen | Kostenlose Plattformen |
 |:---:|:---:|:---:|
 | OpenAI-Schnittstellenaufrufe | Alibaba Bailian, Zhipu ChatGLMVLLM | Zhipu ChatGLMVLLM |
 Tatsächlich kann jedes VLLM, das OpenAI-Schnittstellenaufrufe unterstützt, integriert und verwendet werden.
 ---
 ### TTS-Sprachsynthese
 | Verwendungsmethode | Unterstützte Plattformen | Kostenlose Plattformen |
 |:---:|:---:|:---:|
 | Schnittstellenaufrufe | EdgeTTS, Volcano Engine Doubao TTS, Tencent Cloud, Alibaba Cloud TTS, AliYun Stream TTS, CosyVoiceSiliconflow, TTS302AI, CozeCnTTS, GizwitsTTS, ACGNTTS, OpenAITTS, Lingxi Streaming TTS, MinimaxTTS, Volcano Dual-Stream TTS | Lingxi Streaming TTS, EdgeTTS, CosyVoiceSiliconflow (teilweise) |
 | Lokale Dienste | FishSpeech, GPT_SOVITS_V2, GPT_SOVITS_V3, Index-TTS, PaddleSpeech | Index-TTS, PaddleSpeech, FishSpeech, GPT_SOVITS_V2, GPT_SOVITS_V3 |
 ---
 ### VAD-Sprachaktivitätserkennung
 | Typ | Plattformname | Verwendungsmethode | Preismodell | Hinweise |
 |:---:|:---------:|:----:|:----:|:--:|
 | VAD | SileroVAD | Lokale Verwendung | Kostenlos | |
 ---
 ### ASR-Spracherkennung
 | Verwendungsmethode | Unterstützte Plattformen | Kostenlose Plattformen |
 |:---:|:---:|:---:|
 | Lokale Verwendung | FunASR, SherpaASR | FunASR, SherpaASR |
 | Schnittstellenaufrufe | DoubaoASR, Doubao Streaming ASR, FunASRServer, TencentASR, AliyunASR, Aliyun Streaming ASR, Baidu ASR, OpenAI ASR | FunASRServer |
 ---
 ### Voiceprint-Stimmabdruckerkennung
 | Verwendungsmethode | Unterstützte Plattformen | Kostenlose Plattformen |
 |:---:|:---:|:---:|
 | Lokale Verwendung | 3D-Speaker | 3D-Speaker |
 ---
 ### Memory-Gedächtnisspeicher
 | Typ | Plattformname | Verwendungsmethode | Preismodell | Hinweise |
 |:------:|:---------------:|:----:|:---------:|:--:|
 | Memory | mem0ai | Schnittstellenaufrufe | 1000 Mal/Monat Kontingent | |
 | Memory | mem_local_short | Lokale Zusammenfassung | Kostenlos | |
 | Memory | nomem | Kein Gedächtnismodus | Kostenlos | |
 ---
 ### Intent-Absichtserkennung
 | Typ | Plattformname | Verwendungsmethode | Preismodell | Hinweise |
 |:------:|:-------------:|:----:|:-------:|:---------------------:|
 | Intent | intent_llm | Schnittstellenaufrufe | Basierend auf LLM-Preisen | Erkennt Absicht durch große Modelle, starke Allgemeingültigkeit |
 | Intent | function_call | Schnittstellenaufrufe | Basierend auf LLM-Preisen | Vervollständigt Absicht durch Funktionsaufruf großer Modelle, schnelle Geschwindigkeit, guter Effekt |
 | Intent | nointent | Kein Absichtsmodus | Kostenlos | Führt keine Absichtserkennung durch, gibt direkt Dialogergebnis zurück |
 ---
 ### Rag Retrieval Augmented Generation
 | Typ | Plattformname | Verwendungsmethode | Preismodell | Hinweise |
 |:------:|:-------------:|:----:|:-------:|:---------------------:|
 | Rag | ragflow | Schnittstellenaufrufe | Gebühren basierend auf Token-Verbrauch für Segmentierung und Tokenisierung | Nutzt RAGFlow's Retrieval-Augmented-Generation-Funktion für präzisere Dialogantworten |
 ---
 ## Danksagungen 🙏
 | Logo | Projekt/Unternehmen | Beschreibung |
 |:---:|:---:|:---|
 | <img src="./docs/images/logo_bailing.png" width="160"> | [Bailing Voice Dialogue Robot](https://github.com/wwbin2017/bailing) | Dieses Projekt wurde von [Bailing Voice Dialogue Robot](https://github.com/wwbin2017/bailing) inspiriert und auf dessen Basis implementiert |
 | <img src="./docs/images/logo_tenclass.png" width="160"> | [Tenclass](https://www.tenclass.com/) | Dank an [Tenclass](https://www.tenclass.com/) für die Formulierung von Standardkommunikationsprotokollen, Multi-Geräte-Kompatibilitätslösungen und High-Concurrency-Szenario-Praxisdemonstrationen für das Xiaozhi-Ökosystem; für die Bereitstellung vollständiger technischer Dokumentationsunterstützung für dieses Projekt |
 | <img src="./docs/images/logo_xuanfeng.png" width="160"> | [Xuanfeng Technology](https://github.com/Eric0308) | Dank an [Xuanfeng Technology](https://github.com/Eric0308) für den Beitrag des Funktionsaufruf-Frameworks, des MCP-Kommunikationsprotokolls und der plugin-basierten Aufrufmechanismus-Implementierungscode. Durch standardisiertes Befehlsplanungssystem und dynamische Erweiterungsfähigkeiten wird die Interaktionseffizienz und funktionale Erweiterbarkeit von Frontend-Geräten (IoT) erheblich verbessert |
 | <img src="./docs/images/logo_junsen.png" width="160"> | [huangjunsen](https://github.com/huangjunsen0406) | Dank an [huangjunsen](https://github.com/huangjunsen0406) für den Beitrag des `Smart Control Console Mobile`-Moduls, das eine effiziente Steuerung und Echtzeit-Interaktion über mobile Geräte ermöglicht und die Betriebsbequemlichkeit und Verwaltungseffizienz des Systems in mobilen Szenarien erheblich verbessert |
 | <img src="./docs/images/logo_huiyuan.png" width="160"> | [Huiyuan Design](http://ui.kwd988.net/) | Dank an [Huiyuan Design](http://ui.kwd988.net/) für die Bereitstellung professioneller visueller Lösungen für dieses Projekt, unter Verwendung ihrer Design-Praxiserfahrung im Dienst von über tausend Unternehmen, um die Produktbenutzererfahrung dieses Projekts zu stärken |
 | <img src="./docs/images/logo_qinren.png" width="160"> | [Xi'an Qinren Information Technology](https://www.029app.com/) | Dank an [Xi'an Qinren Information Technology](https://www.029app.com/) für die Vertiefung des visuellen Systems dieses Projekts und die Sicherstellung der Konsistenz und Erweiterbarkeit des Gesamtdesignstils in Multi-Szenario-Anwendungen |
 | <img src="./docs/images/logo_contributors.png" width="160"> | [Code-Mitwirkende](https://github.com/xinnan-tech/xiaozhi-esp32-server/graphs/contributors) | Dank an [alle Code-Mitwirkenden](https://github.com/xinnan-tech/xiaozhi-esp32-server/graphs/contributors), Ihre Bemühungen haben das Projekt robuster und leistungsfähiger gemacht. |
 <a href="https://star-history.com/#xinnan-tech/xiaozhi-esp32-server&Date">
 <picture>
   <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=xinnan-tech/xiaozhi-esp32-server&type=Date&theme=dark" />
   <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=xinnan-tech/xiaozhi-esp32-server&type=Date" />
   <img alt="Star History Chart" src="https://api.star-history.com/svg?repos=xinnan-tech/xiaozhi-esp32-server&type=Date" />
 </picture>
 </a>
@@ -6,29 +6,24 @@
 This project is based on human-machine symbiotic intelligence theory and technology to develop intelligent terminal hardware and software systems<br/>providing backend services for the open-source intelligent hardware project
 <a href="https://github.com/78/xiaozhi-esp32">xiaozhi-esp32</a><br/>
 Implemented using Python, Java, and Vue according to the <a href="https://ccnphfhqs21z.feishu.cn/wiki/M0XiwldO9iJwHikpXD5cEx71nKh">Xiaozhi Communication Protocol</a><br/>
-Supports MCP endpoints and voiceprint recognition
+Support for MQTT+UDP protocol, Websocket protocol, MCP access point, voiceprint recognition, and knowledge base
 </p>
 <p align="center">
-<a href="./README.md">中文</a>
+<a href="./docs/FAQ.md">FAQ</a>
 · <a href="./docs/FAQ.md">FAQ</a>
 · <a href="https://github.com/xinnan-tech/xiaozhi-esp32-server/issues">Report Issues</a>
 · <a href="./README.md#%E9%83%A8%E7%BD%B2%E6%96%87%E6%A1%A3">Deployment Docs</a>
 · <a href="https://github.com/xinnan-tech/xiaozhi-esp32-server/releases">Release Notes</a>
 </p>
 <p align="center">
  <a href="./README.md"><img alt="简体中文版自述文件" src="https://img.shields.io/badge/简体中文-DFE0E5"></a>
  <a href="./README_en.md"><img alt="README in English" src="https://img.shields.io/badge/English-DBEDFA"></a>
  <a href="./README_vi.md"><img alt="Tiếng Việt" src="https://img.shields.io/badge/Tiếng Việt-DFE0E5"></a>
  <a href="./README_de.md"><img alt="Deutsch" src="https://img.shields.io/badge/Deutsch-DFE0E5"></a>
  <a href="https://github.com/xinnan-tech/xiaozhi-esp32-server/releases">
    <img alt="GitHub Contributors" src="https://img.shields.io/github/v/release/xinnan-tech/xiaozhi-esp32-server?logo=docker" />
  </a>
  <a href="https://github.com/xinnan-tech/xiaozhi-esp32-server/graphs/contributors">
    <img alt="GitHub Contributors" src="https://img.shields.io/github/contributors/xinnan-tech/xiaozhi-esp32-server?logo=github" />
  </a>
  <a href="https://github.com/xinnan-tech/xiaozhi-esp32-server/issues">
    <img alt="Issues" src="https://img.shields.io/github/issues/xinnan-tech/xiaozhi-esp32-server?color=0088ff" />
  </a>
  <a href="https://github.com/xinnan-tech/xiaozhi-esp32-server/pulls">
    <img alt="GitHub pull requests" src="https://img.shields.io/github/issues-pr/xinnan-tech/xiaozhi-esp32-server?color=0088ff" />
  </a>
  <a href="https://github.com/xinnan-tech/xiaozhi-esp32-server/blob/main/LICENSE">
    <img alt="GitHub pull requests" src="https://img.shields.io/badge/license-MIT-white?labelColor=black" />
  </a>
@@ -244,6 +239,7 @@ This project provides the following testing tools to help you verify the system
 | Visual Perception | Supports multiple VLLM(vision large models), implements multimodal interaction |
 | Intent Recognition | Supports LLM intent recognition, Function Call function calling, provides plugin-based intent processing mechanism |
 | Memory System | Supports local short-term memory, mem0ai interface memory, with memory summarization functionality |
 | Knowledge Base | Supports RAGFlow knowledge base, enabling LLM to judge whether to schedule the knowledge base after receiving the user's question, and then answer the question |
 | Command Delivery | Supports MCP command delivery to ESP32 devices via MQTT protocol from Smart Console |
 | Tool Calling | Supports client IOT protocol, client MCP protocol, server MCP protocol, MCP endpoint protocol, custom tool functions |
 | Management Backend | Provides Web management interface, supports user management, system configuration and device management; Supports Simplified Chinese, Traditional Chinese and English display |
@@ -275,7 +271,7 @@ Xiaozhi is an ecosystem. When using this product, you can also check out other [
 | Usage Method | Supported Platforms | Free Platforms |
 |:---:|:---:|:---:|
-| OpenAI interface calls | Alibaba Bailian, Volcano Engine Doubao, DeepSeek, Zhipu ChatGLM, Gemini | Zhipu ChatGLM, Gemini |
+| OpenAI interface calls | Alibaba Bailian, Volcano Engine, DeepSeek, Zhipu, Gemini, iFLYTEK | Zhipu, Gemini |
 | Ollama interface calls | Ollama | - |
 | Dify interface calls | Dify | - |
 | FastGPT interface calls | FastGPT | - |
@@ -299,7 +295,7 @@ In fact, any VLLM that supports OpenAI interface calls can be integrated and use
 | Usage Method | Supported Platforms | Free Platforms |
 |:---:|:---:|:---:|
-| Interface calls | EdgeTTS, Volcano Engine Doubao TTS, Tencent Cloud, Alibaba Cloud TTS, AliYun Stream TTS, CosyVoiceSiliconflow, TTS302AI, CozeCnTTS, GizwitsTTS, ACGNTTS, OpenAITTS, Lingxi Streaming TTS, MinimaxTTS | Lingxi Streaming TTS, EdgeTTS, CosyVoiceSiliconflow(partial) |
+| Interface calls | EdgeTTS, iFLYTEK, Volcano Engine, Tencent Cloud, Alibaba Cloud and Bailian, CosyVoiceSiliconflow, TTS302AI, CozeCnTTS, GizwitsTTS, ACGNTTS, OpenAITTS, Lingxi Streaming TTS, MinimaxTTS | Lingxi Streaming TTS, EdgeTTS, CosyVoiceSiliconflow(partial) |
 | Local services | FishSpeech, GPT_SOVITS_V2, GPT_SOVITS_V3, MinimaxTTS | FishSpeech, GPT_SOVITS_V2, GPT_SOVITS_V3, MinimaxTTS |
 ---
@@ -317,7 +313,7 @@ In fact, any VLLM that supports OpenAI interface calls can be integrated and use
 | Usage Method | Supported Platforms | Free Platforms |
 |:---:|:---:|:---:|
 | Local use | FunASR, SherpaASR | FunASR, SherpaASR |
-| Interface calls | DoubaoASR, FunASRServer, TencentASR, AliyunASR | FunASRServer |
+| Interface calls | FunASRServer, Volcano Engine, iFLYTEK, Tencent Cloud, Alibaba Cloud, Baidu Cloud, OpenAI ASR | FunASRServer |
 ---
@@ -347,6 +343,14 @@ In fact, any VLLM that supports OpenAI interface calls can be integrated and use
 ---
 ### Rag Retrieval-Augmented Generation
 | Type | Platform Name | Usage Method | Pricing Model | Notes |
 |:------:|:-------------:|:----:|:-------:|:---------------------:|
 | Rag | ragflow | Interface calls | Charged based on tokens consumed for slicing and word segmentation | Utilizes RagFlow's retrieval-augmented generation feature to provide more accurate dialog responses |
 ---
 ## Acknowledgments 🙏
 | Logo | Project/Company | Description |
@@ -0,0 +1,375 @@
 [![Banners](docs/images/banner1.png)](https://github.com/xinnan-tech/xiaozhi-esp32-server)
 <h1 align="center">Dịch vụ Backend Xiaozhi xiaozhi-esp32-server</h1>
 <p align="center">
 Dự án này dựa trên lý thuyết và công nghệ trí tuệ cộng sinh người-máy để phát triển hệ thống phần mềm và phần cứng thiết bị đầu cuối thông minh<br/>Cung cấp dịch vụ backend cho dự án phần cứng thông minh mã nguồn mở
 <a href="https://github.com/78/xiaozhi-esp32">xiaozhi-esp32</a><br/>
 Được triển khai bằng Python, Java, Vue theo <a href="https://ccnphfhqs21z.feishu.cn/wiki/M0XiwldO9iJwHikpXD5cEx71nKh">giao thức truyền thông Xiaozhi</a><br/>
 Hỗ trợ giao thức MQTT+UDP, giao thức Websocket, điểm truy cập MCP, nhận dạng giọng nói và kho tri thức
 </p>
 <p align="center">
 <a href="./docs/FAQ.md">Câu hỏi thường gặp</a>
 · <a href="https://github.com/xinnan-tech/xiaozhi-esp32-server/issues">Báo cáo vấn đề</a>
 · <a href="./README.md#%E9%83%A8%E7%BD%B2%E6%96%87%E6%A1%A3">Tài liệu triển khai</a>
 · <a href="https://github.com/xinnan-tech/xiaozhi-esp32-server/releases">Nhật ký cập nhật</a>
 </p>
 <p align="center">
  <a href="./README.md"><img alt="简体中文版自述文件" src="https://img.shields.io/badge/简体中文-DFE0E5"></a>
  <a href="./README_en.md"><img alt="README in English" src="https://img.shields.io/badge/English-DFE0E5"></a>
  <a href="./README_vi.md"><img alt="Tiếng Việt" src="https://img.shields.io/badge/Tiếng Việt-DBEDFA"></a>
  <a href="./README_de.md"><img alt="Deutsch" src="https://img.shields.io/badge/Deutsch-DFE0E5"></a>
  <a href="https://github.com/xinnan-tech/xiaozhi-esp32-server/releases">
    <img alt="GitHub Contributors" src="https://img.shields.io/github/v/release/xinnan-tech/xiaozhi-esp32-server?logo=docker" />
  </a>
  <a href="https://github.com/xinnan-tech/xiaozhi-esp32-server/blob/main/LICENSE">
    <img alt="GitHub pull requests" src="https://img.shields.io/badge/license-MIT-white?labelColor=black" />
  </a>
  <a href="https://github.com/xinnan-tech/xiaozhi-esp32-server">
    <img alt="stars" src="https://img.shields.io/github/stars/xinnan-tech/xiaozhi-esp32-server?color=ffcb47&labelColor=black" />
  </a>
 </p>
 <p align="center">
 Spearheaded by Professor Siyuan Liu's Team (South China University of Technology)
 </br>
 Được dẫn dắt bởi nhóm Giáo sư Lưu Tư Nguyên (Đại học Bách khoa Nam Trung Quốc)
 </br>
 <img src="./docs/images/hnlg.jpg" alt="华南理工大学" width="50%">
 </p>
 ---
 ## Người dùng phù hợp 👥
 Dự án này cần được sử dụng cùng với thiết bị phần cứng ESP32. Nếu bạn đã mua phần cứng liên quan đến ESP32, đã thành công kết nối với dịch vụ backend do anh Xia triển khai, và muốn xây dựng dịch vụ backend `xiaozhi-esp32` riêng của mình, thì dự án này rất phù hợp với bạn.
 Muốn xem hiệu quả sử dụng? Hãy xem video 🎥
 <table>
  <tr>
    <td>
        <a href="https://www.bilibili.com/video/BV1FMFyejExX" target="_blank">
         <picture>
           <img alt="响应速度感受" src="docs/images/demo9.png" />
         </picture>
        </a>
    </td>
    <td>
        <a href="https://www.bilibili.com/video/BV1vchQzaEse" target="_blank">
         <picture>
           <img alt="速度优化秘诀" src="docs/images/demo6.png" />
         </picture>
        </a>
    </td>
    <td>
        <a href="https://www.bilibili.com/video/BV1C1tCzUEZh" target="_blank">
         <picture>
           <img alt="复杂医疗场景" src="docs/images/demo1.png" />
         </picture>
        </a>
    </td>
    <td>
        <a href="https://www.bilibili.com/video/BV1zUW5zJEkq" target="_blank">
         <picture>
           <img alt="MQTT指令下发" src="docs/images/demo4.png" />
         </picture>
        </a>
    </td>
    <td>
        <a href="https://www.bilibili.com/video/BV1Exu3zqEDe" target="_blank">
         <picture>
           <img alt="声纹识别" src="docs/images/demo14.png" />
         </picture>
        </a>
    </td>
  </tr>
  <tr>
    <td>
        <a href="https://www.bilibili.com/video/BV1pNXWYGEx1" target="_blank">
         <picture>
           <img alt="控制家电开关" src="docs/images/demo5.png" />
         </picture>
        </a>
    </td>
    <td>
        <a href="https://www.bilibili.com/video/BV1ZQKUzYExM" target="_blank">
         <picture>
           <img alt="MCP接入点" src="docs/images/demo13.png" />
         </picture>
        </a>
    </td>
    <td>
      <a href="https://www.bilibili.com/video/BV1TJ7WzzEo6" target="_blank">
         <picture>
           <img alt="多指令任务" src="docs/images/demo11.png" />
         </picture>
        </a>
    </td>
    <td>
        <a href="https://www.bilibili.com/video/BV1VC96Y5EMH" target="_blank">
         <picture>
           <img alt="播放音乐" src="docs/images/demo7.png" />
         </picture>
        </a>
    </td>
    <td>
        <a href="https://www.bilibili.com/video/BV1Z8XuYZEAS" target="_blank">
         <picture>
           <img alt="天气插件" src="docs/images/demo8.png" />
         </picture>
        </a>
    </td>
  </tr>
  <tr>
    <td>
      <a href="https://www.bilibili.com/video/BV12J7WzBEaH" target="_blank">
         <picture>
           <img alt="实时打断" src="docs/images/demo10.png" />
         </picture>
        </a>
    </td>
    <td>
      <a href="https://www.bilibili.com/video/BV1Co76z7EvK" target="_blank">
         <picture>
           <img alt="拍照识物品" src="docs/images/demo12.png" />
         </picture>
        </a>
    </td>
    <td>
        <a href="https://www.bilibili.com/video/BV1CDKWemEU6" target="_blank">
         <picture>
           <img alt="自定义音色" src="docs/images/demo2.png" />
         </picture>
        </a>
    </td>
    <td>
        <a href="https://www.bilibili.com/video/BV12yA2egEaC" target="_blank">
         <picture>
           <img alt="使用粤语交流" src="docs/images/demo3.png" />
         </picture>
        </a>
    </td>
    <td>
        <a href="https://www.bilibili.com/video/BV17LXWYvENb" target="_blank">
         <picture>
           <img alt="播报新闻" src="docs/images/demo0.png" />
         </picture>
        </a>
    </td>
  </tr>
 </table>
 ---
 ## Cảnh báo ⚠️
 1. Dự án này là phần mềm mã nguồn mở, phần mềm này không có quan hệ hợp tác thương mại với bất kỳ nhà cung cấp dịch vụ API bên thứ ba nào (bao gồm nhưng không giới hạn ở các nền tảng nhận dạng giọng nói, mô hình lớn, tổng hợp giọng nói, v.v.), và không đảm bảo chất lượng dịch vụ cũng như an toàn tài chính của họ.
 Khuyến nghị người dùng ưu tiên lựa chọn nhà cung cấp dịch vụ có giấy phép kinh doanh liên quan và đọc kỹ thỏa thuận dịch vụ và chính sách bảo mật của họ. Phần mềm này không lưu trữ bất kỳ khóa tài khoản nào, không tham gia vào luồng tiền và không chịu rủi ro mất tiền nạp.
 2. Chức năng của dự án này chưa hoàn thiện và chưa qua đánh giá bảo mật mạng, vui lòng không sử dụng trong môi trường sản xuất. Nếu bạn triển khai dự án này trong môi trường mạng công cộng để học tập, vui lòng thực hiện các biện pháp bảo vệ cần thiết.
 ---
 ## Tài liệu triển khai
 ![Banners](docs/images/banner2.png)
 Dự án này cung cấp hai phương pháp triển khai, vui lòng chọn theo nhu cầu cụ thể của bạn:
 #### 🚀 Lựa chọn phương pháp triển khai
 | Phương pháp triển khai | Đặc điểm | Tình huống áp dụng | Tài liệu triển khai | Yêu cầu cấu hình | Video hướng dẫn |
 |---------|------|---------|---------|---------|---------|
 | **Cài đặt tối giản** | Đối thoại thông minh, IOT, MCP, cảm nhận thị giác | Môi trường cấu hình thấp, dữ liệu lưu trong tệp cấu hình, không cần cơ sở dữ liệu | [①Phiên bản Docker](./docs/Deployment.md#%E6%96%B9%E5%BC%8F%E4%B8%80docker%E5%8F%AA%E8%BF%90%E8%A1%8Cserver) / [②Triển khai mã nguồn](./docs/Deployment.md#%E6%96%B9%E5%BC%8F%E4%BA%8C%E6%9C%AC%E5%9C%B0%E6%BA%90%E7%A0%81%E5%8F%AA%E8%BF%90%E8%A1%8Cserver)| 2 nhân 4GB nếu dùng `FunASR`, 2 nhân 2GB nếu toàn API | - |
 | **Cài đặt toàn bộ module** | Đối thoại thông minh, IOT, điểm truy cập MCP, nhận dạng giọng nói, cảm nhận thị giác, OTA, bảng điều khiển thông minh | Trải nghiệm đầy đủ tính năng, dữ liệu lưu trong cơ sở dữ liệu |[①Phiên bản Docker](./docs/Deployment_all.md#%E6%96%B9%E5%BC%8F%E4%B8%80docker%E8%BF%90%E8%A1%8C%E5%85%A8%E6%A8%A1%E5%9D%97) / [②Triển khai mã nguồn](./docs/Deployment_all.md#%E6%96%B9%E5%BC%8F%E4%BA%8C%E6%9C%AC%E5%9C%B0%E6%BA%90%E7%A0%81%E8%BF%90%E8%A1%8C%E5%85%A8%E6%A8%A1%E5%9D%97) / [③Hướng dẫn tự động cập nhật triển khai mã nguồn](./docs/dev-ops-integration.md) | 4 nhân 8GB nếu dùng `FunASR`, 2 nhân 4GB nếu toàn API| [Video hướng dẫn khởi động mã nguồn cục bộ](https://www.bilibili.com/video/BV1wBJhz4Ewe) |
 Câu hỏi thường gặp và hướng dẫn liên quan, vui lòng tham khảo [liên kết này](./docs/FAQ.md)
 > 💡 Gợi ý: Dưới đây là nền tảng thử nghiệm được triển khai theo mã mới nhất, có thể flash để thử nghiệm nếu cần, đồng thời là 6, dữ liệu sẽ được xóa mỗi ngày,
 ```
 Địa chỉ bảng điều khiển thông minh: https://2662r3426b.vicp.fun
 Bảng điều khiển thông minh (phiên bản h5): https://2662r3426b.vicp.fun/h5/index.html
 Công cụ kiểm tra dịch vụ: https://2662r3426b.vicp.fun/test/
 Địa chỉ giao diện OTA: https://2662r3426b.vicp.fun/xiaozhi/ota/
 Địa chỉ giao diện Websocket: wss://2662r3426b.vicp.fun/xiaozhi/v1/
 ```
 #### 🚩 Mô tả và khuyến nghị cấu hình
 > [!Note]
 > Dự án này cung cấp hai phương án cấu hình:
 >
 > 1. Cấu hình `Miễn phí hoàn toàn cho người mới`: Phù hợp với sử dụng gia đình cá nhân, tất cả các thành phần đều sử dụng phương án miễn phí, không cần thanh toán thêm.
 >
 > 2. `Cấu hình streaming`: Phù hợp với demo, đào tạo, hơn 2 đồng thời, v.v., sử dụng công nghệ xử lý streaming, tốc độ phản hồi nhanh hơn, trải nghiệm tốt hơn.
 >
 > Từ phiên bản `0.5.2`, dự án hỗ trợ cấu hình streaming, so với phiên bản đầu, tốc độ phản hồi cải thiện khoảng `2.5 giây`, cải thiện đáng kể trải nghiệm người dùng.
 | Tên module | Cài đặt miễn phí cho người mới | Cấu hình streaming |
 |:---:|:---:|:---:|
 | ASR(Nhận dạng giọng nói) | FunASR(Local) | 👍FunASR(Chế độ GPU cục bộ) |
 | LLM(Mô hình lớn) | ChatGLMLLM(Zhipu glm-4-flash) | 👍AliLLM(qwen3-235b-a22b-instruct-2507) hoặc 👍DoubaoLLM(doubao-1-5-pro-32k-250115) |
 | VLLM(Mô hình lớn thị giác) | ChatGLMVLLM(Zhipu glm-4v-flash) | 👍QwenVLVLLM(Qwen qwen2.5-vl-3b-instructh) |
 | TTS(Tổng hợp giọng nói) | ✅LinkeraiTTS(Lingxi streaming) | 👍HuoshanDoubleStreamTTS(Tổng hợp giọng nói streaming kép Volcano) hoặc 👍AliyunStreamTTS(Tổng hợp giọng nói streaming Alibaba Cloud) |
 | Intent(Nhận dạng ý định) | function_call(Gọi hàm) | function_call(Gọi hàm) |
 | Memory(Chức năng bộ nhớ) | mem_local_short(Bộ nhớ ngắn hạn cục bộ) | mem_local_short(Bộ nhớ ngắn hạn cục bộ) |
 Nếu bạn quan tâm đến thời gian của từng thành phần, vui lòng xem [Báo cáo kiểm tra hiệu suất các thành phần Xiaozhi](https://github.com/xinnan-tech/xiaozhi-performance-research), có thể kiểm tra thực tế trong môi trường của bạn theo phương pháp kiểm tra trong báo cáo.
 #### 🔧 Công cụ kiểm tra
 Dự án này cung cấp các công cụ kiểm tra sau để giúp bạn xác minh hệ thống và chọn mô hình phù hợp:
 | Tên công cụ | Vị trí | Phương pháp sử dụng | Mô tả chức năng |
 |:---:|:---|:---:|:---:|
 | Công cụ kiểm tra tương tác âm thanh | main》xiaozhi-server》test》test_page.html | Mở trực tiếp bằng trình duyệt Google Chrome | Kiểm tra chức năng phát và nhận âm thanh, xác minh xử lý âm thanh phía Python có bình thường không |
 | Công cụ kiểm tra phản hồi mô hình | main》xiaozhi-server》performance_tester.py | Thực hiện `python performance_tester.py` | Kiểm tra tốc độ phản hồi của ba module cốt lõi ASR(Nhận dạng giọng nói), LLM(Mô hình lớn), VLLM(Mô hình thị giác), TTS(Tổng hợp giọng nói) |
 > 💡 Gợi ý: Khi kiểm tra tốc độ mô hình, chỉ kiểm tra các mô hình đã cấu hình khóa.
 ---
 ## Danh sách tính năng ✨
 ### Đã thực hiện ✅
 ![请参考-全模块安装架构图](docs/images/deploy2.png)
 | Module chức năng | Mô tả |
 |:---:|:---|
 | Kiến trúc cốt lõi | Dựa trên [cổng MQTT+UDP](https://github.com/xinnan-tech/xiaozhi-esp32-server/blob/main/docs/mqtt-gateway-integration.md), WebSocket, máy chủ HTTP, cung cấp hệ thống quản lý bảng điều khiển và xác thực hoàn chỉnh |
 | Tương tác giọng nói | Hỗ trợ ASR streaming(Nhận dạng giọng nói), TTS streaming(Tổng hợp giọng nói), VAD(Phát hiện hoạt động giọng nói), hỗ trợ nhận dạng đa ngôn ngữ và xử lý giọng nói |
 | Nhận dạng vân giọng | Hỗ trợ đăng ký, quản lý và nhận dạng vân giọng đa người dùng, xử lý song song với ASR, nhận dạng danh tính người nói theo thời gian thực và truyền cho LLM để phản hồi cá nhân hóa |
 | Đối thoại thông minh | Hỗ trợ nhiều LLM(Mô hình ngôn ngữ lớn), thực hiện đối thoại thông minh |
 | Cảm nhận thị giác | Hỗ trợ nhiều VLLM(Mô hình lớn thị giác), thực hiện tương tác đa phương thức |
 | Nhận dạng ý định | Hỗ trợ nhận dạng ý định mô hình lớn gắn ngoài, gọi hàm tự chủ mô hình lớn, cung cấp cơ chế xử lý ý định dạng plugin |
 | Hệ thống bộ nhớ | Hỗ trợ bộ nhớ ngắn hạn cục bộ, bộ nhớ giao diện mem0ai, có chức năng tóm tắt bộ nhớ |
 | Kho tri thức | Hỗ trợ kho tri thức RAGFlow, cho phép mô hình lớn đánh giá cần gọi kho tri thức trước khi trả lời |
 | Gọi công cụ | Hỗ trợ giao thức IOT phía client, giao thức MCP phía client, giao thức MCP phía server, giao thức điểm truy cập MCP, hàm công cụ tùy chỉnh |
 | Gửi lệnh | Dựa vào giao thức MQTT, hỗ trợ gửi lệnh MCP từ bảng điều khiển thông minh xuống thiết bị ESP32 |
 | Backend quản lý | Cung cấp giao diện quản lý Web, hỗ trợ quản lý người dùng, cấu hình hệ thống và quản lý thiết bị; giao diện hỗ trợ hiển thị tiếng Trung giản thể, tiếng Trung phồn thể, tiếng Anh |
 | Công cụ kiểm tra | Cung cấp công cụ kiểm tra hiệu suất, công cụ kiểm tra mô hình thị giác và công cụ kiểm tra tương tác âm thanh |
 | Hỗ trợ triển khai | Hỗ trợ triển khai Docker và triển khai cục bộ, cung cấp quản lý tệp cấu hình hoàn chỉnh |
 | Hệ thống plugin | Hỗ trợ mở rộng plugin chức năng, phát triển plugin tùy chỉnh và hot loading plugin |
 ### Đang phát triển 🚧
 Muốn hiểu tiến độ kế hoạch phát triển cụ thể, [vui lòng nhấp vào đây](https://github.com/users/xinnan-tech/projects/3). Câu hỏi thường gặp và hướng dẫn liên quan, vui lòng tham khảo [liên kết này](./docs/FAQ.md)
 Nếu bạn là một nhà phát triển phần mềm, đây có một [Lá thư mở gửi các nhà phát triển](docs/contributor_open_letter.md), chào mừng tham gia!
 ---
 ## Hệ sinh thái sản phẩm 👬
 Xiaozhi là một hệ sinh thái, khi bạn sử dụng sản phẩm này, bạn cũng có thể xem các [dự án xuất sắc](https://github.com/78/xiaozhi-esp32?tab=readme-ov-file#%E7%9B%B8%E5%85%B3%E5%BC%80%E6%BA%90%E9%A1%B9%E7%9B%AE) khác trong hệ sinh thái này
 ---
 ## Danh sách nền tảng/thành phần được dự án này hỗ trợ 📋
 ### LLM Mô hình ngôn ngữ
 | Phương pháp sử dụng | Nền tảng hỗ trợ | Nền tảng miễn phí |
 |:---:|:---:|:---:|
 | Gọi giao diện openai | Alibaba Bailian, Volcano Engine, DeepSeek, Zhipu, Gemini, iFlytek | Zhipu, Gemini |
 | Gọi giao diện ollama | Ollama | - |
 | Gọi giao diện dify | Dify | - |
 | Gọi giao diện fastgpt | Fastgpt | - |
 | Gọi giao diện coze | Coze | - |
 | Gọi giao diện xinference | Xinference | - |
 | Gọi giao diện homeassistant | HomeAssistant | - |
 Trên thực tế, bất kỳ LLM nào hỗ trợ gọi giao diện openai đều có thể truy cập sử dụng.
 ---
 ### VLLM Mô hình thị giác
 | Phương pháp sử dụng | Nền tảng hỗ trợ | Nền tảng miễn phí |
 |:---:|:---:|:---:|
 | Gọi giao diện openai | Alibaba Bailian, Zhipu ChatGLMVLLM | Zhipu ChatGLMVLLM |
 Trên thực tế, bất kỳ VLLM nào hỗ trợ gọi giao diện openai đều có thể truy cập sử dụng.
 ---
 ### TTS Tổng hợp giọng nói
 | Phương pháp sử dụng | Nền tảng hỗ trợ | Nền tảng miễn phí |
 |:---:|:---:|:---:|
 | Gọi giao diện | EdgeTTS, iFlytek, Volcano Engine, Tencent Cloud, Alibaba Cloud và Bailian, CosyVoiceSiliconflow, TTS302AI, CozeCnTTS, GizwitsTTS, ACGNTTS, OpenAITTS, Lingxi streaming TTS, MinimaxTTS | Lingxi streaming TTS, EdgeTTS, CosyVoiceSiliconflow(một phần) |
 | Dịch vụ cục bộ | FishSpeech, GPT_SOVITS_V2, GPT_SOVITS_V3, Index-TTS, PaddleSpeech | Index-TTS, PaddleSpeech, FishSpeech, GPT_SOVITS_V2, GPT_SOVITS_V3 |
 ---
 ### VAD Phát hiện hoạt động giọng nói
 | Loại  |   Tên nền tảng    | Phương pháp sử dụng | Mô hình thu phí | Ghi chú |
 |:---:|:---------:|:----:|:----:|:--:|
 | VAD | SileroVAD | Sử dụng cục bộ |  Miễn phí  |    |
 ---
 ### ASR Nhận dạng giọng nói
 | Phương pháp sử dụng | Nền tảng hỗ trợ | Nền tảng miễn phí |
 |:---:|:---:|:---:|
 | Sử dụng cục bộ | FunASR, SherpaASR | FunASR, SherpaASR |
 | Gọi giao diện | FunASRServer, Volcano Engine, iFlytek, Tencent Cloud, Alibaba Cloud, Baidu Cloud, OpenAI ASR | FunASRServer |
 ---
 ### Voiceprint Nhận dạng vân giọng
 | Phương pháp sử dụng | Nền tảng hỗ trợ | Nền tảng miễn phí |
 |:---:|:---:|:---:|
 | Sử dụng cục bộ | 3D-Speaker | 3D-Speaker |
 ---
 ### Memory Lưu trữ bộ nhớ
 |   Loại   |      Tên nền tảng       | Phương pháp sử dụng |   Mô hình thu phí    | Ghi chú |
 |:------:|:---------------:|:----:|:---------:|:--:|
 | Memory |     mem0ai      | Gọi giao diện | Hạn mức 1000 lần/tháng |    |
 | Memory | mem_local_short | Tóm tắt cục bộ |    Miễn phí     |    |
 | Memory |     nomem       | Chế độ không có bộ nhớ |    Miễn phí     |    |
 ---
 ### Intent Nhận dạng ý định
 |   Loại   |     Tên nền tảng      | Phương pháp sử dụng |  Mô hình thu phí   |          Ghi chú           |
 |:------:|:-------------:|:----:|:-------:|:---------------------:|
 | Intent |  intent_llm   | Gọi giao diện | Thu phí theo LLM |    Nhận dạng ý định qua mô hình lớn, tính tổng quát mạnh     |
 | Intent | function_call | Gọi giao diện | Thu phí theo LLM | Hoàn thành ý định qua gọi hàm mô hình lớn, tốc độ nhanh, hiệu quả tốt |
 | Intent |    nointent   | Chế độ không có ý định |    Miễn phí     |    Không thực hiện nhận dạng ý định, trả về trực tiếp kết quả đối thoại     |
 ---
 ### Rag Tăng cường truy xuất thông tin
 |   Loại   |     Tên nền tảng      | Phương pháp sử dụng |  Mô hình thu phí   |          Ghi chú           |
 |:------:|:-------------:|:----:|:-------:|:---------------------:|
 | Rag |  ragflow   | Gọi giao diện | Thu phí theo token tiêu tốn của phân đoạn, phân từ |    Sử dụng chức năng tăng cường truy xuất của RagFlow, cung cấp phản hồi đối thoại chính xác hơn     |
 ---
 ## Lời cảm ơn 🙏
 | Logo | Dự án/Công ty | Mô tả |
 |:---:|:---:|:---|
 | <img src="./docs/images/logo_bailing.png" width="160"> | [Robot đối thoại giọng nói Bailing](https://github.com/wwbin2017/bailing) | Dự án này được lấy cảm hứng từ [Robot đối thoại giọng nói Bailing](https://github.com/wwbin2017/bailing) và được triển khai trên cơ sở đó |
 | <img src="./docs/images/logo_tenclass.png" width="160"> | [Shifang Ronghai](https://www.tenclass.com/) | Cảm ơn [Shifang Ronghai](https://www.tenclass.com/) đã xây dựng giao thức truyền thông tiêu chuẩn, phương án tương thích đa thiết bị và mô phạm thực hành tình huống đồng thời cao cho hệ sinh thái Xiaozhi; cung cấp tài liệu hỗ trợ kỹ thuật toàn diện cho dự án này |
 | <img src="./docs/images/logo_xuanfeng.png" width="160"> | [Xuanfeng Technology](https://github.com/Eric0308) | Cảm ơn [Xuanfeng Technology](https://github.com/Eric0308) đã đóng góp khung gọi hàm, giao thức truyền thông MCP và mã triển khai cơ chế gọi dạng plugin, thông qua hệ thống điều phối lệnh tiêu chuẩn hóa và khả năng mở rộng động, đã cải thiện đáng kể hiệu suất tương tác và khả năng mở rộng chức năng của thiết bị front-end(IoT) |
 | <img src="./docs/images/logo_junsen.png" width="160"> | [huangjunsen](https://github.com/huangjunsen0406) | Cảm ơn [huangjunsen](https://github.com/huangjunsen0406) đã đóng góp module `Bảng điều khiển thông minh di động`, thực hiện điều khiển hiệu quả và tương tác thời gian thực trên thiết bị di động đa nền tảng, cải thiện đáng kể sự tiện lợi vận hành và hiệu quả quản lý của hệ thống trong tình huống di động |
 | <img src="./docs/images/logo_huiyuan.png" width="160"> | [Huiyuan Design](http://ui.kwd988.net/) | Cảm ơn [Huiyuan Design](http://ui.kwd988.net/) đã cung cấp giải pháp thị giác chuyên nghiệp cho dự án này, sử dụng kinh nghiệm thực tế thiết kế phục vụ hơn nghìn doanh nghiệp, trao quyền cho trải nghiệm người dùng sản phẩm của dự án này |
 | <img src="./docs/images/logo_qinren.png" width="160"> | [Xi'an Qinren Information Technology](https://www.029app.com/) | Cảm ơn [Xi'an Qinren Information Technology](https://www.029app.com/) đã làm sâu sắc hệ thống thị giác của dự án này, đảm bảo tính nhất quán và khả năng mở rộng của phong cách thiết kế tổng thể trong ứng dụng đa tình huống |
 | <img src="./docs/images/logo_contributors.png" width="160"> | [Người đóng góp mã](https://github.com/xinnan-tech/xiaozhi-esp32-server/graphs/contributors) | Cảm ơn [tất cả người đóng góp mã](https://github.com/xinnan-tech/xiaozhi-esp32-server/graphs/contributors), sự cống hiến của bạn khiến dự án mạnh mẽ và vững chắc hơn. |
 <a href="https://star-history.com/#xinnan-tech/xiaozhi-esp32-server&Date">
 <picture>
   <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=xinnan-tech/xiaozhi-esp32-server&type=Date&theme=dark" />
   <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=xinnan-tech/xiaozhi-esp32-server&type=Date" />
   <img alt="Star History Chart" src="https://api.star-history.com/svg?repos=xinnan-tech/xiaozhi-esp32-server&type=Date" />
 </picture>
 </a>
@@ -80,7 +80,7 @@ xiaozhi-server
 打开命令行工具，使用`终端`或`命令行`工具 进入到你的`xiaozhi-server`，执行以下命令
 ```
-docker-compose up -d
+docker compose up -d
 ```
 执行完后，再执行以下命令，查看日志信息。
@@ -139,6 +139,9 @@ conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud/
 conda install libopus -y
 conda install ffmpeg -y
 # 在 Linux 环境下进行部署时,如出现类似缺失 libiconv.so.2 动态库的报错 请通过以下命令进行安装
 conda install libiconv -y
 ```
 请注意，以上命令，不是一股脑执行就成功的，你需要一步步执行，每一步执行完后，都检查一下输出的日志，查看是否成功。
@@ -267,7 +270,8 @@ LLM:
 6、[我说话很慢，停顿时小智老是抢话](./FAQ.md)<br/>
 ## 部署相关教程
 1、[如何自动拉取本项目最新代码自动编译和启动](./dev-ops-integration.md)<br/>
-2、[如何与Nginx集成](https://github.com/xinnan-tech/xiaozhi-esp32-server/issues/791)<br/>
+2、[如何部署MQTT网关开启MQTT+UDP协议](./mqtt-gateway-integration.md)<br/>
 3、[如何与Nginx集成](https://github.com/xinnan-tech/xiaozhi-esp32-server/issues/791)<br/>
 ## 拓展相关教程
 1、[如何开启手机号码注册智控台](./ali-sms-integration.md)<br/>
 2、[如何集成HomeAssistant实现智能家居控制](./homeassistant-integration.md)<br/>
@@ -275,11 +279,13 @@ LLM:
 4、[如何部署MCP接入点](./mcp-endpoint-enable.md)<br/>
 5、[如何接入MCP接入点](./mcp-endpoint-integration.md)<br/>
 6、[如何开启声纹识别](./voiceprint-integration.md)<br/>
-10、[新闻插件源配置指南](./newsnow_plugin_config.md)<br/>
+7、[新闻插件源配置指南](./newsnow_plugin_config.md)<br/>
 8、[天气插件使用指南](./weather-integration.md)<br/>
 ## 语音克隆、本地语音部署相关教程
-1、[如何部署集成index-tts本地语音](./index-stream-integration.md)<br/>
+1、[如何在智控台克隆音色](./huoshan-streamTTS-voice-cloning.md)<br/>
-2、[如何部署集成fish-speech本地语音](./fish-speech-integration.md)<br/>
+2、[如何部署集成index-tts本地语音](./index-stream-integration.md)<br/>
-3、[如何部署集成PaddleSpeech本地语音](./paddlespeech-deploy.md)<br/>
+3、[如何部署集成fish-speech本地语音](./fish-speech-integration.md)<br/>
 4、[如何部署集成PaddleSpeech本地语音](./paddlespeech-deploy.md)<br/>
 ## 性能测试教程
 1、[各组件速度测试指南](./performance_tester.md)<br/>
 2、[定期公开测试结果](https://github.com/xinnan-tech/xiaozhi-performance-research)<br/>
@@ -355,6 +355,9 @@ conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud/
 conda install libopus -y
 conda install ffmpeg -y
 # 在 Linux 环境下进行部署时,如出现类似缺失 libiconv.so.2 动态库的报错 请通过以下命令进行安装
 conda install libiconv -y
 ```
 请注意，以上命令，不是一股脑执行就成功的，你需要一步步执行，每一步执行完后，都检查一下输出的日志，查看是否成功。
@@ -468,7 +471,8 @@ ws://你电脑局域网的ip:8000/xiaozhi/v1/
 6、[我说话很慢，停顿时小智老是抢话](./FAQ.md)<br/>
 ## 部署相关教程
 1、[如何自动拉取本项目最新代码自动编译和启动](./dev-ops-integration.md)<br/>
-2、[如何与Nginx集成](https://github.com/xinnan-tech/xiaozhi-esp32-server/issues/791)<br/>
+2、[如何部署MQTT网关开启MQTT+UDP协议](./mqtt-gateway-integration.md)<br/>
 3、[如何与Nginx集成](https://github.com/xinnan-tech/xiaozhi-esp32-server/issues/791)<br/>
 ## 拓展相关教程
 1、[如何开启手机号码注册智控台](./ali-sms-integration.md)<br/>
 2、[如何集成HomeAssistant实现智能家居控制](./homeassistant-integration.md)<br/>
@@ -479,9 +483,10 @@ ws://你电脑局域网的ip:8000/xiaozhi/v1/
 7、[新闻插件源配置指南](./newsnow_plugin_config.md)<br/>
 8、[天气插件使用指南](./weather-integration.md)<br/>
 ## 语音克隆、本地语音部署相关教程
-1、[如何部署集成index-tts本地语音](./index-stream-integration.md)<br/>
+1、[如何在智控台克隆音色](./huoshan-streamTTS-voice-cloning.md)<br/>
-2、[如何部署集成fish-speech本地语音](./fish-speech-integration.md)<br/>
+2、[如何部署集成index-tts本地语音](./index-stream-integration.md)<br/>
-3、[如何部署集成PaddleSpeech本地语音](./paddlespeech-deploy.md)<br/>
+3、[如何部署集成fish-speech本地语音](./fish-speech-integration.md)<br/>
 4、[如何部署集成PaddleSpeech本地语音](./paddlespeech-deploy.md)<br/>
 ## 性能测试教程
 1、[各组件速度测试指南](./performance_tester.md)<br/>
 2、[定期公开测试结果](https://github.com/xinnan-tech/xiaozhi-performance-research)<br/>
@@ -62,30 +62,33 @@ VAD:
 ### 7、部署相关教程
 1、[如何进行最简化部署](./Deployment.md)<br/>
 2、[如何进行全模块部署](./Deployment_all.md)<br/>
-2、[如何部署MQTT网关开启MQTT+UDP协议](./mqtt-gateway-integration.md)<br/>
+3、[如何部署MQTT网关开启MQTT+UDP协议](./mqtt-gateway-integration.md)<br/>
-3、[如何自动拉取本项目最新代码自动编译和启动](./dev-ops-integration.md)<br/>
+4、[如何自动拉取本项目最新代码自动编译和启动](./dev-ops-integration.md)<br/>
-4、[如何与Nginx集成](https://github.com/xinnan-tech/xiaozhi-esp32-server/issues/791)<br/>
+5、[如何与Nginx集成](https://github.com/xinnan-tech/xiaozhi-esp32-server/issues/791)<br/>
-### 8、编译固件相关教程
+### 9、编译固件相关教程
 1、[如何自己编译小智固件](./firmware-build.md)<br/>
 2、[如何基于虾哥编译好的固件修改OTA地址](./firmware-setting.md)<br/>
-### 8、拓展相关教程
+### 10、拓展相关教程
 1、[如何开启手机号码注册智控台](./ali-sms-integration.md)<br/>
 2、[如何集成HomeAssistant实现智能家居控制](./homeassistant-integration.md)<br/>
 3、[如何开启视觉模型实现拍照识物](./mcp-vision-integration.md)<br/>
 4、[如何部署MCP接入点](./mcp-endpoint-enable.md)<br/>
 5、[如何接入MCP接入点](./mcp-endpoint-integration.md)<br/>
-6、[如何开启声纹识别](./voiceprint-integration.md)<br/>
+6、[MCP方法如何获取设备信息](./mcp-get-device-info.md)<br/>
-10、[新闻插件源配置指南](./newsnow_plugin_config.md)<br/>
+7、[如何开启声纹识别](./voiceprint-integration.md)<br/>
 8、[新闻插件源配置指南](./newsnow_plugin_config.md)<br/>
 9、[知识库ragflow集成指南](./ragflow-integration.md)<br/>
 10、[如何部署上下文源](./context-provider-integration.md)<br/>
-### 9、语音克隆、本地语音部署相关教程
+### 11、语音克隆、本地语音部署相关教程
 1、[如何在智控台克隆音色](./huoshan-streamTTS-voice-cloning.md)<br/>
 2、[如何部署集成index-tts本地语音](./index-stream-integration.md)<br/>
 3、[如何部署集成fish-speech本地语音](./fish-speech-integration.md)<br/>
 4、[如何部署集成PaddleSpeech本地语音](./paddlespeech-deploy.md)<br/>
-### 10、性能测试教程
+### 12、性能测试教程
 1、[各组件速度测试指南](./performance_tester.md)<br/>
 2、[定期公开测试结果](https://github.com/xinnan-tech/xiaozhi-performance-research)<br/>
@@ -0,0 +1,224 @@
 # 上下文源使用教程
 ## 概述
 `上下文源`，就是为小智系统提示词的上下文添加【数据源】。
 `上下文源` 在小智在唤醒那一刻，获取外部系统的数据，并将其动态注入到大模型的系统提示词（System Prompt）中。
 让其做到唤醒时感知世界某个事物的状态。
 它和MCP、记忆有本质的区别：`上下文源`是强制让小智感知世界的数据；`记忆(Mem)`是让他知道之前聊了什么内容；`MCP(functionc all)`是当需要调用某项能力/知识的时候使用调用。
 通过这个功能，在小智唤醒的一刹那，“感知”到：
 - 人体健康传感器状态（体温、血压、血氧状态等）
 - 业务系统的实时数据（服务器负载、待办数据、股票信息等）
 - 任何可以通过 HTTP API 获取的文本信息
 **注意**：该功能只是方便小智在唤醒的时候感知事物的状态，而如果想要小智唤醒后实时获取事物的状态，建议在此功能上再结合MCP工具的调用。
 ## 工作原理
 1. **配置源**：用户配置一个或多个 HTTP API 地址。
 2. **触发请求**：当系统构建 Prompt 时，如果发现模板中包含 `{{ dynamic_context }}` 占位符，会请求所有配置的 API。
 3. **自动注入**：系统会自动将 API 返回的数据格式化为 Markdown 列表，替换 `{{ dynamic_context }}` 占位符。
 ## 接口规范
 为了让小智正确解析数据，您的 API 需要满足以下规范：
 - **请求方式**：`GET`
 - **请求头**：系统会自动添加 `device-id` 字段到 Request Header。
 - **响应格式**：必须返回 JSON 格式，且包含 `code` 和 `data` 字段。
 ### 响应示例
 **情况 1：返回键值对**
 ```json
 {
  "code": 0,
  "msg": "success",
  "data": {
    "客厅温度": "26℃",
    "客厅湿度": "45%",
    "大门状态": "已关闭"
  }
 }
 ```
 *注入效果：*
 ```markdown
 <context>
 - **客厅温度：** 26℃
 - **客厅湿度：** 45%
 - **大门状态：** 已关闭
 </context>
 ```
 **情况 2：返回列表**
 ```json
 {
  "code": 0,
  "data": [
    "您有10个待办事项",
    "当前汽车的行驶速度是100km每小时"
  ]
 }
 ```
 *注入效果：*
 ```markdown
 <context>
 - 您有10个待办事项
 - 当前汽车的行驶速度是100km每小时
 </context>
 ```
 ## 配置指南
 ### 方式 1：智控台配置（全模块部署）
 1. 登录智控台，进入**角色配置**页面。
 2. 找到**上下文源**配置项（点击“编辑源”按钮）。
 3. 点击**添加**，输入您的 API 地址。
 4. 如果 API 需要鉴权，可以在**请求头**部分添加 `Authorization` 或其他 Header。
 5. 保存配置。
 ### 方式 2：配置文件配置（单模块部署）
 编辑 `xiaozhi-server/data/.config.yaml` 文件，添加 `context_providers` 配置段：
 ```yaml
 # 上下文源配置
 context_providers:
  - url: "http://api.example.com/data"
    headers:
      Authorization: "Bearer your-token"
  - url: "http://another-api.com/data"
 ```
 ## 启用功能
 默认情况下，系统的提示词模板文件（`data/.agent-base-prompt.txt`）中已经预置了 `{{ dynamic_context }}` 占位符，您无需手动添加。
 **示例：**
 ```markdown
 <context>
 【重要！以下信息已实时提供，无需调用工具查询，请直接使用：】
 - **设备ID：** {{device_id}}
 - **当前时间：** {{current_time}}
 ...
 {{ dynamic_context }}
 </context>
 ```
 **注意**：如果您不需要使用此功能，可以选择**不配置任何上下文源**，也可以从提示词模板文件中**删除** `{{ dynamic_context }}` 占位符。
 ## 附录：Mock 测试服务示例
 为了方便您测试和开发，我们提供了一个简单的 Python Mock Server 脚本。您可以运行此脚本在本地模拟 API 接口。
 **mock_api_server.py**
 ```python
 import http.server
 import socketserver
 import json
 from urllib.parse import urlparse, parse_qs
 # 设置端口号
 PORT = 8081
 class MockRequestHandler(http.server.SimpleHTTPRequestHandler):
    def do_GET(self):
        # 解析路径和参数
        parsed_path = urlparse(self.path)
        path = parsed_path.path
        query = parse_qs(parsed_path.query)
        response_data = {}
        status_code = 200
        print(f"收到请求: {path}, 参数: {query}")
        # Case 1: 模拟健康数据 (返回字典 Dict)
        # 路径参数风格: /health
        # device_id 从 Header 获取
        if path == "/health":
            device_id = self.headers.get("device-id", "unknown_device")
            print(f"device_id: {device_id}")
            response_data = {
                "code": 0,
                "msg": "success",
                "data": {
                    "测试设备ID": device_id,
                    "心率": "80 bpm",
                    "血压": "120/80 mmHg",
                    "状态": "良好"
                }
            }
        # Case 2: 模拟新闻列表 (返回列表 List)
        # 无参数: /news/list
        elif path == "/news/list":
            response_data = {
                "code": 0,
                "msg": "success",
                "data": [
                    "今日头条：Python 3.14 发布",
                    "科技新闻：AI 助手改变生活",
                    "本地新闻：明日有大雨，记得带伞"
                ]
            }
        # Case 3: 模拟天气简报 (返回字符串 String)
        # 无参数: /weather/simple
        elif path == "/weather/simple":
            response_data = {
                "code": 0,
                "msg": "success",
                "data": "今日晴转多云，气温 20-25 度，空气质量优，适合出行。"
            }
        # Case 4: 模拟设备详情 (Query参数风格)
        # 参数风格: /device/info
        # device_id 从 Header 获取
        elif path == "/device/info":
            device_id = self.headers.get("device-id", "unknown_device")
            response_data = {
                "code": 0,
                "msg": "success",
                "data": {
                    "查询方式": "Header参数",
                    "设备ID": device_id,
                    "电量": "85%",
                    "固件": "v2.0.1"
                }
            }
        # Case 5: 404 Not Found
        else:
            status_code = 404
            response_data = {"error": "接口不存在"}
        # 发送响应
        self.send_response(status_code)
        self.send_header('Content-type', 'application/json; charset=utf-8')
        self.end_headers()
        self.wfile.write(json.dumps(response_data, ensure_ascii=False).encode('utf-8'))
 # 启动服务
 # 允许地址重用，防止快速重启报错
 socketserver.TCPServer.allow_reuse_address = True
 with socketserver.TCPServer(("", PORT), MockRequestHandler) as httpd:
    print(f"==================================================")
    print(f"Mock API Server 已启动: http://localhost:{PORT}")
    print(f"可用接口列表:")
    print(f"1. [字典] http://localhost:{PORT}/health")
    print(f"2. [列表] http://localhost:{PORT}/news/list")
    print(f"3. [文本] http://localhost:{PORT}/weather/simple")
    print(f"4. [参数] http://localhost:{PORT}/device/info")
    print(f"==================================================")
    try:
        httpd.serve_forever()
    except KeyboardInterrupt:
        print("\n服务已停止")
 ```
@@ -17,5 +17,5 @@ docker build -t xiaozhi-esp32-server:web_latest -f ./Dockerfile-web .
 # 编译完成后，可以使用docker-compose启动项目
 # docker-compose.yml你需要修改成自己编译的镜像版本
 cd main/xiaozhi-server
-docker-compose up -d
+docker compose up -d
 ```
@@ -97,7 +97,7 @@ http://homeassistant.local:8123
 使用管理员账号，登录`智控台`。在`智能体管理`，找到你的智能体，再点击`配置角色`。
-将意图识别设置成`函数调用`或`LLM意图识别`。这时你会看到右侧有一个`编辑功能`。点击`编辑功能`按钮，会弹出`功能管理`的框。
+将意图识别设置成`外挂的大模型意图识别`或`大模型自主函数调用`。这时你会看到右侧有一个`编辑功能`。点击`编辑功能`按钮，会弹出`功能管理`的框。
 在`功能管理`的框里，你需要勾选`HomeAssistant设备状态查询`和`HomeAssistant设备状态修改`。
@@ -1,6 +1,6 @@
 # 智控台 火山双流式语音合成+音色克隆配置教程
-本教程分为3个阶段：准备阶段、配置阶段、克隆阶段、使用阶段。主要是介绍通过智控台配置火山双流式语音合成+音色克隆的过程。
+本教程分为4个阶段：准备阶段、配置阶段、克隆阶段、使用阶段。主要是介绍通过智控台配置火山双流式语音合成+音色克隆的过程。
 ## 第一阶段：准备阶段
 超级管理员先预先把火山引擎服务开通好，获取到App Id，Access Token。默认火上引擎会赠送一个音色资源。这个音色资源需要把它复制到本项目里。
@@ -46,7 +46,7 @@
 如果复刻成功，在列表里会看到对应的音色会变成“训练成功”状态。此时你可以点击【声音名称】栏的修改按钮，修改音色资源的名称，方便后期选择使用。
-## 第三阶段：使用阶段
+## 第四阶段：使用阶段
 点击顶部【智能体管理】，选择任意一个智能体，点击【配置角色】按钮。
@@ -71,6 +71,7 @@ docker logs -f mcp-endpoint-server
 请你保留好上面两个`接口地址`，下一步要用到。
 # 2、全模块部署时，怎么配置MCP接入点
 首先，你要开启MCP接入点功能。在智控台，点击顶部`参数字典`，在下拉菜单中，点击`系统功能配置`页面。在页面上勾选`MCP接入点`，点击`保存配置`。在`角色配置`页面，点击`编辑功能`按钮，即可看到`mcp接入点`功能。
 如果你是全模块部署，使用管理员账号，登录智控台，点击顶部`参数字典`，选择`参数管理`功能。
@@ -0,0 +1,40 @@
 # MCP 方法如何获取设备信息
 本教程将指导你如何使用MCP方法获取设备信息。
 第一步：自定义你的`agent-base-prompt.txt`文件
 把xiaozhi-server目录的`agent-base-prompt.txt`文件内容复制到你的`data`目录下，并重命名为`.agent-base-prompt.txt`。
 第二步：修改`data/.agent-base-prompt.txt`文件，找到`<context>`标签，在标签内容中添加以下代码内容：
 ```
 - **设备ID：** {{device_id}}
 ```
 添加完成后，你的`data/.agent-base-prompt.txt`文件的`<context>`标签内容大致如下：
 ```
 <context>
 【重要！以下信息已实时提供，无需调用工具查询，请直接使用：】
 - **设备ID：** {{device_id}}
 - **当前时间：** {{current_time}}
 - **今天日期：** {{today_date}} ({{today_weekday}})
 - **今天农历：** {{lunar_date}}
 - **用户所在城市：** {{local_address}}
 - **当地未来7天天气：** {{weather_info}}
 </context>
 ```
 第三步：修改`data/.config.yaml`文件，找到`agent-base-prompt`配置，修改前内容如下：
 ```
 prompt_template: agent-base-prompt.txt
 ```
 修改成
 ```
 prompt_template: data/.agent-base-prompt.txt
 ```
 第四步：重启你的xiaozhi-server服务。
 第五步：在你的mcp方法增加名称为`device_id`,类型为`string`,描述为`设备ID`的参数。
 第六步：重新唤醒小智，让他调用mcp方法，查看你的mcp方法是否可以获取`设备ID`。
@@ -11,12 +11,12 @@
 1、如果你是源码部署，你的`mqtt-websocket`地址是：
 ```
-ws://127.0.0.1:8000/xiaozhi/v1?from=mqtt_gateway
+ws://127.0.0.1:8000/xiaozhi/v1/?from=mqtt_gateway
 ```
 2、如果你是docker部署，你的`mqtt-websocket`地址是
 ```
-ws://你宿主机局域网IP:8000/xiaozhi/v1?from=mqtt_gateway
+ws://你宿主机局域网IP:8000/xiaozhi/v1/?from=mqtt_gateway
 ```
 ## 重要提示
@@ -53,7 +53,7 @@ cp config/mqtt.json.example config/mqtt.json
 {
    "production": {
        "chat_servers": [
-            "ws://127.0.0.1:8000/xiaozhi/v1?from=mqtt_gateway"
+            "ws://127.0.0.1:8000/xiaozhi/v1/?from=mqtt_gateway"
        ]
    },
    "debug": false,
@@ -0,0 +1,269 @@
 # ragflow 集成指南
 本教程主要是是两部分
 - 一、如何部署ragflow
 - 二、如何在智控台配置ragflow接口
 如果您对ragflow很熟悉，且已经部署了ragflow，可直接跳过第一部分，直接进入第二部分。但是如果你希望有人指导你部署ragflow，让它能够和`xiaozhi-esp32-server`共同使用`mysql`、`redis`基础服务，以减少资源成本，你需要从第一部分开始。
 # 第一部分 如何部署ragflow
 ## 第一步， 确认mysql、redis是否可用
 ragflow需要依赖`mysql`数据库。如果你之前已经部署`智控台`，说明你已经安装了`mysql`。你可以共用它。
 你可以你试一下在宿主机使用`telnet`命令，看看能不能正常访问`mysql`的`3306`端口。
 ``` shell
 telnet 127.0.0.1 3306
 telnet 127.0.0.1 6379
 ```
 如果能访问到`3306`端口和`6379`端口，请忽略以下的内容，直接进入第二步。
 如果不能访问，你需要回忆一下，你的`mysql`是怎么安装的。
 如果你的mysql是通过自己使用安装包安装的，说明你的`mysql`做了网络隔离。你可能先解决访问`mysql`的`3306`端口这个问题。
 如果你`mysql`是通过本项目的`docker-compose_all.yml`安装的。你需要找一下你当时创建数据库的`docker-compose_all.yml`文件，修改以下的内容
 修改前
 ``` yaml
  xiaozhi-esp32-server-db:
    ...
    networks:
      - default
    expose:
      - "3306:3306"
  xiaozhi-esp32-server-redis:
    ...
    expose:
      - 6379
 ```
 修改后
 ``` yaml
  xiaozhi-esp32-server-db:
    ...
    networks:
      - default
    ports:
      - "3306:3306"
  xiaozhi-esp32-server-redis:
    ...
    ports:
      - "6379:6379"
 ```
 注意是将`xiaozhi-esp32-server-db`和`xiaozhi-esp32-server-redis`下面的`expose`改成`ports`。改完后，需要重新启动。以下是重启mysql的命令：
 ``` shell
 # 进入你docker-compose_all.yml所在的文件夹，例如我的是xiaozhi-server
 cd xiaozhi-server
 docker compose -f docker-compose_all.yml down
 docker compose -f docker-compose.yml up -d
 ```
 启动完后，在宿主机再使用`telnet`命令，看看能不能正常访问`mysql`的`3306`端口。
 ``` shell
 telnet 127.0.0.1 3306
 telnet 127.0.0.1 6379
 ```
 正常来说这样就可以访问的了。
 ## 第二步， 创建数据库和表
 如果你的宿主机，能正常访问mysql数据库，那就在mysql上创建一个名字为`rag_flow`的数据库和`rag_flow`用户，密码为`infini_rag_flow`。
 ``` sql
 -- 创建数据库
 CREATE DATABASE IF NOT EXISTS rag_flow CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
 -- 创建用户并授权
 CREATE USER IF NOT EXISTS 'rag_flow'@'%' IDENTIFIED BY 'infini_rag_flow';
 GRANT ALL PRIVILEGES ON rag_flow.* TO 'rag_flow'@'%';
 -- 刷新权限
 FLUSH PRIVILEGES;
 ```
 ## 第三步， 下载ragflow项目
 你需要在你电脑找一个文件夹，用来存放ragflow项目。例如我在`/home/system/xiaozhi`文件夹。
 你可以使用`git`命令，将ragflow项目下载到这个文件夹，本教程使用的是`v0.22.0`版本进行安装部署。
 ```
 git clone https://ghfast.top/https://github.com/infiniflow/ragflow.git
 cd ragflow
 git checkout v0.22.0
 ```
 下载完后，进入`docker`文件夹。
 ``` shell
 cd docker
 ```
 修改`ragflow/docker`文件夹下的`docker-compose.yml`文件，将`ragflow-cpu`和`ragflow-gpu`服务的`depends_on`配置去掉，用于解除`ragflow-cpu`服务对`mysql`的依赖。
 这是修改前：
 ``` yaml
  ragflow-cpu:
    depends_on:
      mysql:
        condition: service_healthy
    profiles:
      - cpu
  ...
  ragflow-gpu:
    depends_on:
      mysql:
        condition: service_healthy
    profiles:
      - gpu
 ```
 这是修改后：
 ``` yaml
  ragflow-cpu:
    profiles:
      - cpu
  ...
  ragflow-gpu:
    profiles:
      - gpu
 ```
 接着，修改`ragflow/docker`文件夹下的`docker-compose-base.yml`文件，去掉`mysql`和`redis`的配置。
 例如，删除前：
 ``` yaml
 services:
  minio:
    image: quay.io/minio/minio:RELEASE.2025-06-13T11-33-47Z
    ...
  mysql:
    image: mysql:8.0
    ...
  redis:
    image: redis:6.2-alpine
    ...
 ```
 删除后
 ``` yaml
 services:
  minio:
    image: quay.io/minio/minio:RELEASE.2025-06-13T11-33-47Z
    ...
 ```
 ## 第四步，修改环境变量配置
 编辑`ragflow/docker`文件夹下的`.env`文件,找到以下配置，逐个搜索，逐个修改！逐个搜索，逐个修改！
 下面对于`.env`文件的修改，60%的人会忽略`MYSQL_USER`配置导致ragflow启动不成功，因此，需要强调三次：
 强调第一次：如果你的`.env`文件如果没有`MYSQL_USER`配置，请在配置文件增加这项！
 强调第二次：如果你的`.env`文件如果没有`MYSQL_USER`配置，请在配置文件增加这项！
 强调第三次：如果你的`.env`文件如果没有`MYSQL_USER`配置，请在配置文件增加这项！
 ``` env
 # 端口设置
 SVR_WEB_HTTP_PORT=8008           # HTTP端口
 SVR_WEB_HTTPS_PORT=8009          # HTTPS端口
 # MySQL配置 - 修改为您本地MySQL的信息
 MYSQL_HOST=host.docker.internal  # 使用host.docker.internal让容器访问主机服务
 MYSQL_PORT=3306                  # 本地MySQL端口
 MYSQL_USER=rag_flow              # 上面创建的用户名，如果没有这项就增加这一项
 MYSQL_PASSWORD=infini_rag_flow   # 上面设置的密码
 MYSQL_DBNAME=rag_flow            # 数据库名称
 # Redis配置 - 修改为您本地Redis的信息
 REDIS_HOST=host.docker.internal  # 使用host.docker.internal让容器访问主机服务
 REDIS_PORT=6379                  # 本地Redis端口
 REDIS_PASSWORD=                  # 如果你的Redis没有设置密码，就按这样子填写，否则填写密码
 ```
 注意，如果你的Redis没有设置密码，还要修改`ragflow/docker`文件夹下`service_conf.yaml.template`，将`infini_rag_flow`替换成空字符串。
 修改前
 ``` shell
 redis:
  db: 1
  password: '${REDIS_PASSWORD:-infini_rag_flow}'
  host: '${REDIS_HOST:-redis}:6379'
 ```
 修改后
 ``` shell
 redis:
  db: 1
  password: '${REDIS_PASSWORD:-}'
  host: '${REDIS_HOST:-redis}:6379'
 ```
 ## 第五步，启动ragflow服务
 执行命令：
 ``` shell
 docker-compose -f docker-compose.yml up -d
 ```
 执行成功后，你可以使用`docker logs -n 20 -f docker-ragflow-cpu-1`命令，查看`docker-ragflow-cpu-1`服务的日志。
 如果日志中没有报错，说明ragflow服务启动成功。
 # 第五步，注册账号
 你可以在浏览器中访问`http://127.0.0.1:8008`，点击`Sign Up`，注册一个账号。
 注册成功后，你可以点击`Sign In`，登录到ragflow服务。如果你想关闭ragflow服务的注册服务，不想让其他人注册账号，你可以在`ragflow/docker`文件夹下的`.env`文件中，将`REGISTER_ENABLED`配置项设置为`0`。
 ``` dotenv
 REGISTER_ENABLED=0
 ```
 修改后，重启启动ragflow服务。
 ``` shell
 docker-compose -f docker-compose.yml down
 docker-compose -f docker-compose.yml up -d
 ```
 # 第六步，配置ragflow服务的模型
 你可以在浏览器中访问`http://127.0.0.1:8008`，点击`Sign In`，登录到ragflow服务。点击页面右上角的`头像`，进入设置页面。
 首先，在左侧导航栏中，点击`模型供应商`，进入到模型配置页面。在右侧的`可选模型`搜索框下，选择`LLM`，在列表选择你使用的模型供应商，点击`添加`，输入你的密钥；
 然后，选择`TEXT EMBEDDING`，在列表选择你使用的模型供应商，点击`添加`，输入你的密钥。
 最后，刷新一下页面，分别点击`设置默认模型`列表的LLM和Embedding，选择你使用的模型即可。请确认你的密钥开通了相应的服务，比如我是用的Embedding模型是xxx供应商的，需要去这个供应商官网查看这个模型是否需要购买资源包才能使用。
 # 第二部分 配置ragflow服务
 # 第一步 登录ragflow服务
 你可以在浏览器中访问`http://127.0.0.1:8008`，点击`Sign In`，登录到ragflow服务。
 然后点击右上角的`头像`，进入设置页面。在左侧导航栏中，点击`API`功能，然后点击"API Key"按钮。出现一个弹框，
 在弹框中，点击"Create new Key"按钮，生成一个API Key。复制这个`API Key`，你稍后会用到。
 # 第二步 配置到智控台
 确保你的智控台版本是`0.8.7`或以上。使用超级管理员账号登录到智控台。
 首先，你要先开启知识库功能。在顶部导航栏中，点击`参数字典`，在下拉菜单中，点击`系统功能配置`页面。在页面上勾选`知识库`，点击`保存配置`。即可在导航栏看到`知识库`功能。
 在顶部导航栏中，点击`模型配置`，在左侧导航栏中，点击`知识库`。在列表中找到`RAG_RAGFlow`，点击`编辑`按钮。
 在`服务地址`中，填写`http://你的ragflow服务的局域网IP:8008`，例如我的ragflow服务的局域网IP是`192.168.1.100`，那么我就填写`http://192.168.1.100:8008`。
 在`API密钥`中，填写之前复制的`API Key`。
 最后点击保存按钮。
 # 第二步 创建一个知识库
 使用超级管理员账号登录到智控台。在顶部导航栏中，点击`知识库`，在列表左下脚，点击`新增`按钮。填写一个知识库的名字和描述。点击保存。
 为了提高大模型对知识库的理解和召回能力，建议在创建知识库时，填写一个有意义的名字和描述。例如，如果你要创建一个关于`公司介绍`的知识库，那么知识库的名字可以是`公司介绍`，描述可以是`关于公司的相关信息例如公司基本信息、服务项目、联系电话、地址等。`。
 保存后，你可以在知识库列表中看到这个知识库。点击刚才创建的知识库的`查看`按钮，进入知识库详情页面。
 在知识库详情页面中，左下角点击`新增`按钮，可以上传文档到知识库。
 上传后，你可以在知识库详情页面中，看到上传的文档。此时可以点击文档的`解析`按钮，解析文档。
 解析完成后，你可以查看解析后的切片信息。你可以在知识库详情页面中，点击`召回测试`按钮，可以测试知识库的召回/检索功能。
 # 第三步 让小智使用ragflow知识库
 登录到智控台。在顶部导航栏中，点击`智能体`，找到你要配置的智能体，点击`配置角色`按钮。
 在意图识别左侧，点击`编辑功能`按钮，弹出一个弹框。在弹框中选择你要添加的知识库。保存即可。
@@ -28,7 +28,7 @@ telnet 127.0.0.1 3306
 如果不能访问，你需要回忆一下，你的`mysql`是怎么安装的。
-如果你的mysql是通过自己使用安装包安装的，说明你的`mysql`做了网络隔离。你可能先解访问`mysql`的`3306`端口这个问题。
+如果你的mysql是通过自己使用安装包安装的，说明你的`mysql`做了网络隔离。你可能先解决访问`mysql`的`3306`端口这个问题。
 如果你`mysql`是通过本项目的`docker-compose_all.yml`安装的。你需要找一下你当时创建数据库的`docker-compose_all.yml`文件，修改以下的内容
@@ -164,6 +164,8 @@ http://192.168.1.25:8005/voiceprint/health?key=abcd
 # 2、全模块部署时，怎么配置声纹识别
 ## 第一步 配置接口
 首先，你要开启声纹识别功能。在智控台，点击顶部`参数字典`，在下拉菜单中，点击`系统功能配置`页面。在页面上勾选`声纹识别`，点击`保存配置`。即可在新建智能体的卡片上看到`声纹识别`按钮。
 如果你是全模块部署，使用管理员账号，登录智控台，点击顶部`参数字典`，选择`参数管理`功能。
 然后搜索参数`server.voice_print`，此时，它的值应该是`null`值。
@@ -141,6 +141,11 @@ public interface Constant {
     */
    String SERVER_MQTT_SECRET = "server.mqtt_signature_key";
    /**
     * WebSocket认证开关
     */
    String SERVER_AUTH_ENABLED = "server.auth.enabled";
    /**
     * 无记忆
     */
@@ -151,6 +156,11 @@ public interface Constant {
     */
    String VOICE_CLONE_HUOSHAN_DOUBLE_STREAM = "huoshan_double_stream";
    /**
     * RAG配置类型
     */
    String RAG_CONFIG_TYPE = "RAG";
    enum SysBaseParam {
        /**
         * ICP备案号
@@ -294,7 +304,7 @@ public interface Constant {
    /**
     * 版本号
     */
-    public static final String VERSION = "0.8.5";
+    public static final String VERSION = "0.8.10";
    /**
     * 无效固件URL
@@ -82,14 +82,6 @@ public interface ErrorCode {
    int DEVICE_ALREADY_ACTIVATED = 10063;
    // 默认模型删除错误
    int DEFAULT_MODEL_DELETE_ERROR = 10064;
    // 设备相关错误码
    int MAC_ADDRESS_ALREADY_EXISTS = 10090; // Mac地址已存在
    // 模型相关错误码
    int MODEL_PROVIDER_NOT_EXIST = 10091; // 供应器不存在
    int LLM_NOT_EXIST = 10092; // 设置的LLM不存在
    int MODEL_REFERENCED_BY_AGENT = 10093; // 该模型配置已被智能体引用，无法删除
    int LLM_REFERENCED_BY_INTENT = 10094; // 该LLM模型已被意图识别配置引用，无法删除
    // 登录相关错误码
    int ADD_DATA_FAILED = 10065; // 新增数据失败
    int UPDATE_DATA_FAILED = 10066; // 修改数据失败
@@ -127,6 +119,10 @@ public interface ErrorCode {
    int VOICEPRINT_UNREGISTER_PROCESS_ERROR = 10090; // 声纹注销处理失败
    int VOICEPRINT_IDENTIFY_REQUEST_ERROR = 10091; // 声纹识别请求失败
    int LLM_NOT_EXIST = 10092; // 设置的LLM不存在
    int MODEL_REFERENCED_BY_AGENT = 10093; // 该模型配置已被智能体引用，无法删除
    int LLM_REFERENCED_BY_INTENT = 10094; // 该LLM模型已被意图识别配置引用，无法删除
    // 服务端管理相关错误码
    int INVALID_SERVER_ACTION = 10095; // 无效服务端操作
    int SERVER_WEBSOCKET_NOT_CONFIGURED = 10096; // 未配置服务端WebSocket地址
@@ -198,4 +194,50 @@ public interface ErrorCode {
    int VOICE_CLONE_PREFIX = 10158; // 复刻音色前缀
    int VOICE_ID_ALREADY_EXISTS = 10159; // 音色ID已存在
    int VOICE_CLONE_HUOSHAN_VOICE_ID_ERROR = 10160; // 火山引擎音色ID格式错误
    // 设备相关错误码
    int MAC_ADDRESS_ALREADY_EXISTS = 10161; // Mac地址已存在
    // 模型相关错误码
    int MODEL_PROVIDER_NOT_EXIST = 10162; // 供应器不存在
    // 知识库相关错误码
    int Knowledge_Base_RECORD_NOT_EXISTS = 10163; // 知识库记录不存在
    int RAG_CONFIG_NOT_FOUND = 10164; // RAG配置未找到
    int RAG_CONFIG_TYPE_ERROR = 10165; // RAG配置类型错误
    int RAG_DEFAULT_CONFIG_NOT_FOUND = 10166; // 默认RAG配置未找到
    int RAG_API_ERROR = 10167; // RAG调用失败
    int UPLOAD_FILE_ERROR = 10168; // 上传文件失败
    int NO_PERMISSION = 10169; // 没有权限
    int KNOWLEDGE_BASE_NAME_EXISTS = 10170; // 同名知识库已存在
    int RAG_API_ERROR_URL_NULL = 10171; // RAG配置中base_url为空，请完善配置
    int RAG_API_ERROR_API_KEY_NULL = 10172; // RAG配置中api_key为空，请完善配置
    int RAG_API_ERROR_API_KEY_INVALID = 10173; // RAG配置中api_key包含占位符，请替换为实际的API密钥
    int RAG_API_ERROR_URL_INVALID = 10174; // RAG配置中base_url格式不正确，请检查协议是否正确
    int RAG_DATASET_ID_NOT_NULL = 10176; // RAG配置中dataset_id不能为空
    int RAG_MODEL_ID_NOT_NULL = 10177; // RAG配置中model_id不能为空
    int RAG_DATASET_ID_AND_MODEL_ID_NOT_NULL = 10178; // RAG配置中dataset_id和model_id不能为空
    int RAG_FILE_NAME_NOT_NULL = 10179; // 文件名称不能为空
    int RAG_FILE_CONTENT_EMPTY = 10180; // 文件内容不能为空
    // 设备相关错误码（补充）
    int MCA_NOT_NULL = 10175; // mac地址不能为空
    // 音色克隆（补充）
    int VOICE_CLONE_NAME_NOT_NULL = 10181; // 音色克隆名称不能为空
    int VOICE_CLONE_AUDIO_NOT_FOUND = 10182; // 音色克隆音频不存在
    // 智能体模板相关错误码(补充)
    int AGENT_TEMPLATE_NOT_FOUND = 10183; // 默认智能体未找到
    // 知识库适配器相关错误码
    int RAG_ADAPTER_TYPE_NOT_SUPPORTED = 10184; // 不支持的适配器类型
    int RAG_CONFIG_VALIDATION_FAILED = 10185; // RAG配置验证失败
    int RAG_ADAPTER_CREATION_FAILED = 10186; // 适配器创建失败
    int RAG_ADAPTER_INIT_FAILED = 10187; // 适配器初始化失败
    int RAG_ADAPTER_CONNECTION_FAILED = 10188; // 适配器连接测试失败
    int RAG_ADAPTER_OPERATION_FAILED = 10189; // 适配器操作失败
    int RAG_ADAPTER_NOT_FOUND = 10190; // 适配器未找到
    int RAG_ADAPTER_CACHE_ERROR = 10191; // 适配器缓存错误
    int RAG_ADAPTER_TYPE_NOT_FOUND = 10192; // 适配器类型未找到
 }
@@ -32,13 +32,23 @@ public class FieldMetaObjectHandler implements MetaObjectHandler {
        // 创建者
        strictInsertFill(metaObject, CREATOR, Long.class, user.getId());
-        // 创建时间
+        // 创建时间 - 支持createDate和createdAt两种字段名
-        strictInsertFill(metaObject, CREATE_DATE, Date.class, date);
+        if (metaObject.hasSetter(CREATE_DATE)) {
            strictInsertFill(metaObject, CREATE_DATE, Date.class, date);
        }
        if (metaObject.hasSetter("createdAt")) {
            strictInsertFill(metaObject, "createdAt", Date.class, date);
        }
        // 更新者
        strictInsertFill(metaObject, UPDATER, Long.class, user.getId());
-        // 更新时间
+        // 更新时间 - 支持updateDate和updatedAt两种字段名
-        strictInsertFill(metaObject, UPDATE_DATE, Date.class, date);
+        if (metaObject.hasSetter(UPDATE_DATE)) {
            strictInsertFill(metaObject, UPDATE_DATE, Date.class, date);
        }
        if (metaObject.hasSetter("updatedAt")) {
            strictInsertFill(metaObject, "updatedAt", Date.class, date);
        }
        // 数据标识
        strictInsertFill(metaObject, DATA_OPERATION, String.class, Constant.DataOperation.INSERT.getValue());
@@ -46,10 +56,17 @@ public class FieldMetaObjectHandler implements MetaObjectHandler {
    @Override
    public void updateFill(MetaObject metaObject) {
        Date date = new Date();
        // 更新者
        strictUpdateFill(metaObject, UPDATER, Long.class, SecurityUser.getUserId());
-        // 更新时间
+        // 更新时间 - 支持updateDate和updatedAt两种字段名
-        strictUpdateFill(metaObject, UPDATE_DATE, Date.class, new Date());
+        if (metaObject.hasSetter(UPDATE_DATE)) {
            strictUpdateFill(metaObject, UPDATE_DATE, Date.class, date);
        }
        if (metaObject.hasSetter("updatedAt")) {
            strictUpdateFill(metaObject, "updatedAt", Date.class, date);
        }
        // 数据标识
        strictInsertFill(metaObject, DATA_OPERATION, String.class, Constant.DataOperation.UPDATE.getValue());
@@ -152,4 +152,11 @@ public class RedisKeys {
    public static String getVoiceCloneAudioIdKey(String uuid) {
        return "voiceClone:audio:id:" + uuid;
    }
    /**
     * 获取知识库缓存key
     */
    public static String getKnowledgeBaseCacheKey(String datasetId) {
        return "knowledge:base:" + datasetId;
    }
 }
@@ -1,14 +1,15 @@
 package xiaozhi.common.utils;
 import cn.hutool.json.JSONObject;
 import org.apache.commons.lang3.StringUtils;
 import java.util.Arrays;
 import java.util.HashMap;
 import java.util.HashSet;
 import java.util.Map;
 import java.util.HashMap;
 import java.util.Set;
 import org.apache.commons.lang3.StringUtils;
 import cn.hutool.json.JSONObject;
 /**
 * 敏感数据处理工具类
 */
@@ -30,7 +31,7 @@ public class SensitiveDataUtils {
     * 隐藏字符串中间部分
     */
    public static String maskMiddle(String value) {
-        if (StringUtils.isBlank(value)) {
+        if (StringUtils.isBlank(value) || value.length() == 1) {
            return value;
        }
@@ -139,14 +139,14 @@ public class AgentChatHistoryController {
        // 从Redis获取agentId和sessionId
        String agentSessionInfo = (String) redisUtils.get(RedisKeys.getChatHistoryKey(uuid));
        if (StringUtils.isBlank(agentSessionInfo)) {
-            throw new RenException("下载链接已过期或无效");
+            throw new RenException(ErrorCode.DOWNLOAD_LINK_EXPIRED);
        }
        try {
            // 解析agentId和sessionId
            String[] parts = agentSessionInfo.split(":");
            if (parts.length != 2) {
-                throw new RenException("下载链接无效");
+                throw new RenException(ErrorCode.DOWNLOAD_LINK_INVALID);
            }
            String agentId = parts[0];
            String sessionId = parts[1];
@@ -44,6 +44,7 @@ import xiaozhi.modules.agent.entity.AgentEntity;
 import xiaozhi.modules.agent.entity.AgentTemplateEntity;
 import xiaozhi.modules.agent.service.AgentChatAudioService;
 import xiaozhi.modules.agent.service.AgentChatHistoryService;
 import xiaozhi.modules.agent.service.AgentContextProviderService;
 import xiaozhi.modules.agent.service.AgentPluginMappingService;
 import xiaozhi.modules.agent.service.AgentService;
 import xiaozhi.modules.agent.service.AgentTemplateService;
@@ -64,6 +65,7 @@ public class AgentController {
    private final AgentChatHistoryService agentChatHistoryService;
    private final AgentChatAudioService agentChatAudioService;
    private final AgentPluginMappingService agentPluginMappingService;
    private final AgentContextProviderService agentContextProviderService;
    private final RedisUtils redisUtils;
    @GetMapping("/list")
@@ -135,6 +137,8 @@ public class AgentController {
        agentChatHistoryService.deleteByAgentId(id, true, true);
        // 删除关联的插件
        agentPluginMappingService.deleteByAgentId(id);
        // 删除关联的上下文源配置
        agentContextProviderService.deleteByAgentId(id);
        // 再删除智能体
        agentService.deleteById(id);
        return new Result<>();
@@ -0,0 +1,9 @@
 package xiaozhi.modules.agent.dao;
 import org.apache.ibatis.annotations.Mapper;
 import xiaozhi.common.dao.BaseDao;
 import xiaozhi.modules.agent.entity.AgentContextProviderEntity;
@Mapper
 public interface AgentContextProviderDao extends BaseDao<AgentContextProviderEntity> {
 }
@@ -69,6 +69,9 @@ public class AgentUpdateDTO implements Serializable {
    @Schema(description = "排序", example = "1", nullable = true)
    private Integer sort;
    @Schema(description = "上下文源配置", nullable = true)
    private List<ContextProviderDTO> contextProviders;
    @Data
    @Schema(description = "插件函数信息")
    public static class FunctionInfo implements Serializable {
@@ -0,0 +1,19 @@
 package xiaozhi.modules.agent.dto;
 import java.io.Serializable;
 import java.util.Map;
 import io.swagger.v3.oas.annotations.media.Schema;
 import lombok.Data;
@Data
@Schema(description = "上下文源配置DTO")
 public class ContextProviderDTO implements Serializable {
    private static final long serialVersionUID = 1L;
    @Schema(description = "URL地址")
    private String url;
    @Schema(description = "请求头")
    private Map<String, Object> headers;
 }
@@ -0,0 +1,43 @@
 package xiaozhi.modules.agent.entity;
 import java.util.Date;
 import java.util.List;
 import com.baomidou.mybatisplus.annotation.IdType;
 import com.baomidou.mybatisplus.annotation.TableField;
 import com.baomidou.mybatisplus.annotation.TableId;
 import com.baomidou.mybatisplus.annotation.TableName;
 import com.baomidou.mybatisplus.extension.handlers.JacksonTypeHandler;
 import io.swagger.v3.oas.annotations.media.Schema;
 import lombok.Data;
 import xiaozhi.modules.agent.dto.ContextProviderDTO;
@Data
@TableName(value = "ai_agent_context_provider", autoResultMap = true)
@Schema(description = "智能体上下文源配置")
 public class AgentContextProviderEntity {
    @TableId(type = IdType.ASSIGN_UUID)
    @Schema(description = "主键")
    private String id;
    @Schema(description = "智能体ID")
    private String agentId;
    @Schema(description = "上下文源配置")
    @TableField(typeHandler = JacksonTypeHandler.class)
    private List<ContextProviderDTO> contextProviders;
    @Schema(description = "创建者")
    private Long creator;
    @Schema(description = "创建时间")
    private Date createdAt;
    @Schema(description = "更新者")
    private Long updater;
    @Schema(description = "更新时间")
    private Date updatedAt;
 }
@@ -0,0 +1,25 @@
 package xiaozhi.modules.agent.service;
 import xiaozhi.common.service.BaseService;
 import xiaozhi.modules.agent.entity.AgentContextProviderEntity;
 public interface AgentContextProviderService extends BaseService<AgentContextProviderEntity> {
    /**
     * 根据智能体ID获取上下文源配置
     * @param agentId 智能体ID
     * @return 上下文源配置实体
     */
    AgentContextProviderEntity getByAgentId(String agentId);
    /**
     * 保存或更新上下文源配置
     * @param entity 实体
     */
    void saveOrUpdateByAgentId(AgentContextProviderEntity entity);
    /**
     * 根据智能体ID删除上下文源配置
     * @param agentId 智能体ID
     */
    void deleteByAgentId(String agentId);
 }
@@ -0,0 +1,35 @@
 package xiaozhi.modules.agent.service.impl;
 import org.springframework.stereotype.Service;
 import com.baomidou.mybatisplus.core.conditions.query.QueryWrapper;
 import xiaozhi.common.service.impl.BaseServiceImpl;
 import xiaozhi.modules.agent.dao.AgentContextProviderDao;
 import xiaozhi.modules.agent.entity.AgentContextProviderEntity;
 import xiaozhi.modules.agent.service.AgentContextProviderService;
@Service
 public class AgentContextProviderServiceImpl extends BaseServiceImpl<AgentContextProviderDao, AgentContextProviderEntity> implements AgentContextProviderService {
    @Override
    public AgentContextProviderEntity getByAgentId(String agentId) {
        return baseDao.selectOne(new QueryWrapper<AgentContextProviderEntity>().eq("agent_id", agentId));
    }
    @Override
    public void saveOrUpdateByAgentId(AgentContextProviderEntity entity) {
        AgentContextProviderEntity exist = getByAgentId(entity.getAgentId());
        if (exist != null) {
            entity.setId(exist.getId());
            updateById(entity);
        } else {
            insert(entity);
        }
    }
    @Override
    public void deleteByAgentId(String agentId) {
        baseDao.delete(new QueryWrapper<AgentContextProviderEntity>().eq("agent_id", agentId));
    }
 }
@@ -1,16 +1,26 @@
 package xiaozhi.modules.agent.service.impl;
 import java.util.ArrayList;
 import java.util.HashMap;
 import java.util.List;
 import java.util.Map;
 import org.apache.commons.lang3.StringUtils;
 import org.springframework.stereotype.Service;
 import com.baomidou.mybatisplus.core.conditions.update.UpdateWrapper;
 import com.baomidou.mybatisplus.extension.service.impl.ServiceImpl;
 import lombok.RequiredArgsConstructor;
 import lombok.extern.slf4j.Slf4j;
 import xiaozhi.common.utils.JsonUtils;
 import xiaozhi.modules.agent.dao.AgentPluginMappingMapper;
 import xiaozhi.modules.agent.entity.AgentPluginMapping;
 import xiaozhi.modules.agent.service.AgentPluginMappingService;
 import xiaozhi.modules.knowledge.entity.KnowledgeBaseEntity;
 import xiaozhi.modules.knowledge.service.KnowledgeBaseService;
 import xiaozhi.modules.model.entity.ModelConfigEntity;
 import xiaozhi.modules.model.service.ModelConfigService;
 /**
 * @description 针对表【ai_agent_plugin_mapping(Agent与插件的唯一映射表)】的数据库操作Service实现
@@ -18,13 +28,73 @@ import xiaozhi.modules.agent.service.AgentPluginMappingService;
 */
@Service
@RequiredArgsConstructor
@Slf4j
 public class AgentPluginMappingServiceImpl extends ServiceImpl<AgentPluginMappingMapper, AgentPluginMapping>
        implements AgentPluginMappingService {
    private final AgentPluginMappingMapper agentPluginMappingMapper;
    private final KnowledgeBaseService knowledgeBaseService;
    private final ModelConfigService modelConfigService;
    @Override
    public List<AgentPluginMapping> agentPluginParamsByAgentId(String agentId) {
-        return agentPluginMappingMapper.selectPluginsByAgentId(agentId);
+        List<AgentPluginMapping> list = agentPluginMappingMapper.selectPluginsByAgentId(agentId);
        Map<String, List<KnowledgeBaseEntity>> knowledgeBaseMap = new HashMap<>();
        Map<String, ModelConfigEntity> modelConfigMap = new HashMap<>();
        for (int i = list.size() - 1; i >= 0; i--) {
            AgentPluginMapping mapping = list.get(i);
            if (StringUtils.isBlank(mapping.getProviderCode())) {
                // 查询知识库插件参数
                KnowledgeBaseEntity knowledgeBaseEntity = knowledgeBaseService.selectById(mapping.getPluginId());
                if (knowledgeBaseEntity == null) {
                    list.remove(i);
                    continue;
                }
                ModelConfigEntity modelConfigEntity = modelConfigService
                        .getModelByIdFromCache(knowledgeBaseEntity.getRagModelId());
                if (modelConfigEntity == null) {
                    list.remove(i);
                    continue;
                }
                List<KnowledgeBaseEntity> knowledgeBaseList = knowledgeBaseMap.get(modelConfigEntity.getModelCode());
                if (knowledgeBaseList == null) {
                    knowledgeBaseList = new ArrayList<>();
                }
                modelConfigMap.put(modelConfigEntity.getModelCode(), modelConfigEntity);
                knowledgeBaseList.add(knowledgeBaseEntity);
                knowledgeBaseMap.put(modelConfigEntity.getModelCode(), knowledgeBaseList);
                list.remove(i);
            }
        }
        if (knowledgeBaseMap.size() > 0) {
            for (String pluginCode : knowledgeBaseMap.keySet()) {
                List<KnowledgeBaseEntity> knowledgeBaseList = knowledgeBaseMap.get(pluginCode);
                if (knowledgeBaseList == null || knowledgeBaseList.isEmpty()) {
                    continue;
                }
                AgentPluginMapping agentPluginMapping = new AgentPluginMapping();
                agentPluginMapping.setAgentId(agentId);
                agentPluginMapping.setPluginId(pluginCode);
                agentPluginMapping.setProviderCode("search_from_" + pluginCode);
                agentPluginMapping.setId(Long.valueOf(list.size() + 1));
                Map<String, Object> paramInfo = new HashMap<>(4);
                ModelConfigEntity modelConfigEntity = modelConfigMap.get(pluginCode);
                paramInfo.put("base_url", modelConfigEntity.getConfigJson().getStr("base_url"));
                paramInfo.put("api_key", modelConfigEntity.getConfigJson().getStr("api_key"));
                paramInfo.put("dataset_ids",
                        knowledgeBaseList.stream().map(KnowledgeBaseEntity::getDatasetId).toList());
                String description = "如果用户询问与【"
                        + String.join(",", knowledgeBaseList.stream().map(KnowledgeBaseEntity::getName).toList())
                        + "】涵盖的主体范围相关内容时应调用本方法，用于查询：" + String.join(",",
                                knowledgeBaseList.stream().map(KnowledgeBaseEntity::getDescription).toList());
                paramInfo.put("description", description);
                agentPluginMapping.setParamInfo(JsonUtils.toJsonString(paramInfo));
                list.add(agentPluginMapping);
            }
        }
        return list;
    }
    @Override
@@ -32,10 +32,12 @@ import xiaozhi.modules.agent.dao.AgentDao;
 import xiaozhi.modules.agent.dto.AgentCreateDTO;
 import xiaozhi.modules.agent.dto.AgentDTO;
 import xiaozhi.modules.agent.dto.AgentUpdateDTO;
 import xiaozhi.modules.agent.entity.AgentContextProviderEntity;
 import xiaozhi.modules.agent.entity.AgentEntity;
 import xiaozhi.modules.agent.entity.AgentPluginMapping;
 import xiaozhi.modules.agent.entity.AgentTemplateEntity;
 import xiaozhi.modules.agent.service.AgentChatHistoryService;
 import xiaozhi.modules.agent.service.AgentContextProviderService;
 import xiaozhi.modules.agent.service.AgentPluginMappingService;
 import xiaozhi.modules.agent.service.AgentService;
 import xiaozhi.modules.agent.service.AgentTemplateService;
@@ -62,6 +64,7 @@ public class AgentServiceImpl extends BaseServiceImpl<AgentDao, AgentEntity> imp
    private final AgentChatHistoryService agentChatHistoryService;
    private final AgentTemplateService agentTemplateService;
    private final ModelProviderService modelProviderService;
    private final AgentContextProviderService agentContextProviderService;
    @Override
    public PageData<AgentEntity> adminAgentList(Map<String, Object> params) {
@@ -85,6 +88,13 @@ public class AgentServiceImpl extends BaseServiceImpl<AgentDao, AgentEntity> imp
                agent.setChatHistoryConf(Constant.ChatHistoryConfEnum.RECORD_TEXT_AUDIO.getCode());
            }
        }
        // 查询上下文源配置
        AgentContextProviderEntity contextProviderEntity = agentContextProviderService.getByAgentId(id);
        if (contextProviderEntity != null) {
            agent.setContextProviders(contextProviderEntity.getContextProviders());
        }
        // 无需额外查询插件列表，已通过SQL查询出来
        return agent;
    }
@@ -331,6 +341,14 @@ public class AgentServiceImpl extends BaseServiceImpl<AgentDao, AgentEntity> imp
            agentChatHistoryService.deleteByAgentId(existingEntity.getId(), true, false);
        }
        // 更新上下文源配置
        if (dto.getContextProviders() != null) {
            AgentContextProviderEntity contextEntity = new AgentContextProviderEntity();
            contextEntity.setAgentId(agentId);
            contextEntity.setContextProviders(dto.getContextProviders());
            agentContextProviderService.saveOrUpdateByAgentId(contextEntity);
        }
        boolean b = validateLLMIntentParams(dto.getLlmModelId(), dto.getIntentModelId());
        if (!b) {
            throw new RenException(ErrorCode.LLM_INTENT_PARAMS_MISMATCH);
@@ -395,7 +413,20 @@ public class AgentServiceImpl extends BaseServiceImpl<AgentDao, AgentEntity> imp
            entity.setIntentModelId(template.getIntentModelId());
            entity.setSystemPrompt(template.getSystemPrompt());
            entity.setSummaryMemory(template.getSummaryMemory());
-            entity.setChatHistoryConf(template.getChatHistoryConf());
+
            // 根据记忆模型类型设置默认的chatHistoryConf值
            if (template.getMemModelId() != null) {
                if (template.getMemModelId().equals("Memory_nomem")) {
                    // 无记忆功能的模型，默认不记录聊天记录
                    entity.setChatHistoryConf(0);
                } else {
                    // 有记忆功能的模型，默认记录文本和语音
                    entity.setChatHistoryConf(2);
                }
            } else {
                entity.setChatHistoryConf(template.getChatHistoryConf());
            }
            entity.setLangCode(template.getLangCode());
            entity.setLanguage(template.getLanguage());
        }
@@ -45,6 +45,10 @@ public class AgentTemplateServiceImpl extends ServiceImpl<AgentTemplateDao, Agen
    @Override
    public void updateDefaultTemplateModelId(String modelType, String modelId) {
        modelType = modelType.toUpperCase();
        // 如果是rag模型，不需要更新
        if (modelType.equals("RAG")) {
            return;
        }
        UpdateWrapper<AgentTemplateEntity> wrapper = new UpdateWrapper<>();
        switch (modelType) {
@@ -5,6 +5,7 @@ import com.baomidou.mybatisplus.extension.handlers.JacksonTypeHandler;
 import io.swagger.v3.oas.annotations.media.Schema;
 import lombok.Data;
 import lombok.EqualsAndHashCode;
 import xiaozhi.modules.agent.dto.ContextProviderDTO;
 import xiaozhi.modules.agent.entity.AgentEntity;
 import xiaozhi.modules.agent.entity.AgentPluginMapping;
@@ -21,4 +22,7 @@ public class AgentInfoVO extends AgentEntity
    @Schema(description = "插件列表Id")
    @TableField(typeHandler = JacksonTypeHandler.class)
    private List<AgentPluginMapping> functions;
    @Schema(description = "上下文源配置")
    private List<ContextProviderDTO> contextProviders;
 }
@@ -20,10 +20,12 @@ import xiaozhi.common.redis.RedisUtils;
 import xiaozhi.common.utils.ConvertUtils;
 import xiaozhi.common.utils.JsonUtils;
 import xiaozhi.modules.agent.dao.AgentVoicePrintDao;
 import xiaozhi.modules.agent.entity.AgentContextProviderEntity;
 import xiaozhi.modules.agent.entity.AgentEntity;
 import xiaozhi.modules.agent.entity.AgentPluginMapping;
 import xiaozhi.modules.agent.entity.AgentTemplateEntity;
 import xiaozhi.modules.agent.entity.AgentVoicePrintEntity;
 import xiaozhi.modules.agent.service.AgentContextProviderService;
 import xiaozhi.modules.agent.service.AgentMcpAccessPointService;
 import xiaozhi.modules.agent.service.AgentPluginMappingService;
 import xiaozhi.modules.agent.service.AgentService;
@@ -53,6 +55,7 @@ public class ConfigServiceImpl implements ConfigService {
    private final TimbreService timbreService;
    private final AgentPluginMappingService agentPluginMappingService;
    private final AgentMcpAccessPointService agentMcpAccessPointService;
    private final AgentContextProviderService agentContextProviderService;
    private final VoiceCloneService cloneVoiceService;
    private final AgentVoicePrintDao agentVoicePrintDao;
@@ -73,7 +76,7 @@ public class ConfigServiceImpl implements ConfigService {
        // 查询默认智能体
        AgentTemplateEntity agent = agentTemplateService.getDefaultTemplate();
        if (agent == null) {
-            throw new RenException("默认智能体未找到");
+            throw new RenException(ErrorCode.AGENT_TEMPLATE_NOT_FOUND);
        }
        // 构建模块配置
@@ -91,6 +94,7 @@ public class ConfigServiceImpl implements ConfigService {
                null,
                null,
                null,
                null,
                result,
                isCache);
@@ -110,13 +114,13 @@ public class ConfigServiceImpl implements ConfigService {
            if (StringUtils.isNotBlank(cachedCode)) {
                throw new RenException(ErrorCode.OTA_DEVICE_NEED_BIND, cachedCode);
            }
-            throw new RenException(ErrorCode.OTA_DEVICE_NOT_FOUND, "not found device");
+            throw new RenException(ErrorCode.OTA_DEVICE_NOT_FOUND);
        }
        // 获取智能体信息
        AgentEntity agent = agentService.getAgentById(device.getAgentId());
        if (agent == null) {
-            throw new RenException("智能体未找到");
+            throw new RenException(ErrorCode.AGENT_NOT_FOUND);
        }
        // 获取音色信息
        String voice = null;
@@ -177,6 +181,13 @@ public class ConfigServiceImpl implements ConfigService {
            mcpEndpoint = mcpEndpoint.replace("/mcp/", "/call/");
            result.put("mcp_endpoint", mcpEndpoint);
        }
        // 获取上下文源配置
        AgentContextProviderEntity contextProviderEntity = agentContextProviderService.getByAgentId(agent.getId());
        if (contextProviderEntity != null && contextProviderEntity.getContextProviders() != null && !contextProviderEntity.getContextProviders().isEmpty()) {
            result.put("context_providers", contextProviderEntity.getContextProviders());
        }
        // 获取声纹信息
        buildVoiceprintConfig(agent.getId(), result);
@@ -195,6 +206,7 @@ public class ConfigServiceImpl implements ConfigService {
                agent.getTtsModelId(),
                agent.getMemModelId(),
                agent.getIntentModelId(),
                null,
                result,
                true);
@@ -371,12 +383,14 @@ public class ConfigServiceImpl implements ConfigService {
            String ttsModelId,
            String memModelId,
            String intentModelId,
            String ragModelId,
            Map<String, Object> result,
            boolean isCache) {
        Map<String, String> selectedModule = new HashMap<>();
-        String[] modelTypes = { "VAD", "ASR", "TTS", "Memory", "Intent", "LLM", "VLLM" };
+        String[] modelTypes = { "VAD", "ASR", "TTS", "Memory", "Intent", "LLM", "VLLM", "RAG" };
-        String[] modelIds = { vadModelId, asrModelId, ttsModelId, memModelId, intentModelId, llmModelId, vllmModelId };
+        String[] modelIds = { vadModelId, asrModelId, ttsModelId, memModelId, intentModelId, llmModelId, vllmModelId,
                ragModelId };
        String intentLLMModelId = null;
        String memLocalShortLLMModelId = null;
@@ -69,13 +69,15 @@ public class DeviceController {
    public Result<String> registerDevice(@RequestBody DeviceRegisterDTO deviceRegisterDTO) {
        String macAddress = deviceRegisterDTO.getMacAddress();
        if (StringUtils.isBlank(macAddress)) {
-            return new Result<String>().error(ErrorCode.NOT_NULL, "mac地址不能为空");
+            return new Result<String>().error(ErrorCode.MCA_NOT_NULL);
        }
        // 生成六位验证码
-        String code = String.valueOf(Math.random()).substring(2, 8);
+        String code;
-        String key = RedisKeys.getDeviceCaptchaKey(code);
+        String key;
        String existsMac = null;
        do {
            code = String.valueOf(Math.random()).substring(2, 8);
            key = RedisKeys.getDeviceCaptchaKey(code);
            existsMac = (String) redisUtils.get(key);
        } while (StringUtils.isNotBlank(existsMac));
@@ -93,7 +95,7 @@ public class DeviceController {
    }
    @PostMapping("/bind/{agentId}")
-    @Operation(summary = "转发POST请求到MQTT网关")
+    @Operation(summary = "设备在线接口")
    @RequiresPermissions("sys:role:normal")
    public Result<String> forwardToMqttGateway(@PathVariable String agentId, @RequestBody String requestBody) {
        try {
@@ -208,63 +210,4 @@ public class DeviceController {
        deviceService.manualAddDevice(user.getId(), dto);
        return new Result<>();
    }
    @PostMapping("/commands/{deviceId}")
    @Operation(summary = "发送设备指令")
    @RequiresPermissions("sys:role:normal")
    public Result<String> sendDeviceCommand(@PathVariable String deviceId, @RequestBody String command) {
        try {
            // 从系统参数中获取MQTT网关地址
            String mqttGatewayUrl = sysParamsService.getValue("server.mqtt_manager_api", true);
            if (StringUtils.isBlank(mqttGatewayUrl) || "null".equals(mqttGatewayUrl)) {
                return new Result<String>().error("MQTT网关地址未配置");
            }
            // 构建完整的URL
            // 获取设备信息以构建mqttClientId
            DeviceEntity deviceById = deviceService.selectById(deviceId);
            if (!deviceById.getUserId().equals(SecurityUser.getUser().getId())) {
                return new Result<String>().error("设备不存在");
            }
            String macAddress = deviceById != null ? deviceById.getMacAddress() : "unknown";
            String groupId = deviceById != null ? deviceById.getBoard() : null;
            if (groupId == null) {
                groupId = "GID_default";
            }
            groupId = groupId.replace(":", "_");
            macAddress = macAddress.replace(":", "_");
            // 拼接为groupId@@@macAddress@@@deviceId格式
            String mqttClientId = groupId + "@@@" + macAddress + "@@@" + macAddress;
            String url = "http://" + mqttGatewayUrl + "/api/commands/" + mqttClientId;
            // 设置请求头
            HttpHeaders headers = new HttpHeaders();
            headers.set("Content-Type", "application/json");
            // 生成Bearer令牌
            String dateStr = java.time.LocalDate.now()
                    .format(java.time.format.DateTimeFormatter.ofPattern("yyyy-MM-dd"));
            String signatureKey = sysParamsService.getValue("server.mqtt_signature_key", false);
            if (StringUtils.isBlank(signatureKey)) {
                return new Result<String>().error("MQTT签名密钥未配置");
            }
            String tokenContent = dateStr + signatureKey;
            String token = org.apache.commons.codec.digest.DigestUtils.sha256Hex(tokenContent);
            headers.set("Authorization", "Bearer " + token);
            // 构建请求体
            HttpEntity<String> requestEntity = new HttpEntity<>(command, headers);
            // 发送POST请求
            ResponseEntity<String> response = restTemplate.exchange(url, HttpMethod.POST, requestEntity, String.class);
            // 返回响应
            return new Result<String>().ok(response.getBody());
        } catch (Exception e) {
            return new Result<String>().error("发送指令失败: " + e.getMessage());
        }
    }
 }
@@ -1,6 +1,8 @@
 package xiaozhi.modules.device.service.impl;
 import java.nio.charset.StandardCharsets;
 import java.security.InvalidKeyException;
 import java.security.NoSuchAlgorithmException;
 import java.time.Instant;
 import java.util.Base64;
 import java.util.Date;
@@ -169,7 +171,22 @@ public class DeviceServiceImpl extends BaseServiceImpl<DeviceDao, DeviceEntity>
        DeviceReportRespDTO.Websocket websocket = new DeviceReportRespDTO.Websocket();
        // 从系统参数获取WebSocket URL，如果未配置则使用默认值
        String wsUrl = sysParamsService.getValue(Constant.SERVER_WEBSOCKET, true);
-        websocket.setToken("");
+
        // 检查是否启用认证并生成token
        String authEnabled = sysParamsService.getValue(Constant.SERVER_AUTH_ENABLED, true);
        if ("true".equalsIgnoreCase(authEnabled)) {
            try {
                // 生成token
                String token = generateWebSocketToken(clientId, macAddress);
                websocket.setToken(token);
            } catch (Exception e) {
                log.error("生成WebSocket token失败: {}", e.getMessage());
                websocket.setToken("");
            }
        } else {
            websocket.setToken("");
        }
        if (StringUtils.isBlank(wsUrl) || wsUrl.equals("null")) {
            log.error("WebSocket地址未配置，请登录智控台，在参数管理找到【server.websocket】配置");
            wsUrl = "ws://xiaozhi.server.com:8000/xiaozhi/v1/";
@@ -189,7 +206,7 @@ public class DeviceServiceImpl extends BaseServiceImpl<DeviceDao, DeviceEntity>
        // 添加MQTT UDP配置
        // 从系统参数获取MQTT Gateway地址，仅在配置有效时使用
-        String mqttUdpConfig = sysParamsService.getValue(Constant.SERVER_MQTT_GATEWAY, false);
+        String mqttUdpConfig = sysParamsService.getValue(Constant.SERVER_MQTT_GATEWAY, true);
        if (mqttUdpConfig != null && !mqttUdpConfig.equals("null") && !mqttUdpConfig.isEmpty()) {
            try {
                String groupId = deviceById != null && deviceById.getBoard() != null ? deviceById.getBoard()
@@ -494,6 +511,40 @@ public class DeviceServiceImpl extends BaseServiceImpl<DeviceDao, DeviceEntity>
        return Base64.getEncoder().encodeToString(signature);
    }
    /**
     * 生成WebSocket认证token 遵循Python端AuthManager的实现逻辑：token = signature.timestamp
     * 
     * @param clientId 客户端ID
     * @param username 用户名 (通常为deviceId/macAddress)
     * @return 认证token字符串
     */
    private String generateWebSocketToken(String clientId, String username)
            throws NoSuchAlgorithmException, InvalidKeyException {
        // 从系统参数获取密钥
        String secretKey = sysParamsService.getValue(Constant.SERVER_SECRET, false);
        if (StringUtils.isBlank(secretKey)) {
            throw new IllegalStateException("WebSocket认证密钥未配置(server.secret)");
        }
        // 获取当前时间戳(秒)
        long timestamp = System.currentTimeMillis() / 1000;
        // 构建签名内容: clientId|username|timestamp
        String content = String.format("%s|%s|%d", clientId, username, timestamp);
        // 生成HMAC-SHA256签名
        Mac hmac = Mac.getInstance("HmacSHA256");
        SecretKeySpec keySpec = new SecretKeySpec(secretKey.getBytes(StandardCharsets.UTF_8), "HmacSHA256");
        hmac.init(keySpec);
        byte[] signature = hmac.doFinal(content.getBytes(StandardCharsets.UTF_8));
        // Base64 URL-safe编码签名(去除填充符=)
        String signatureBase64 = Base64.getUrlEncoder().withoutPadding().encodeToString(signature);
        // 返回格式: signature.timestamp
        return String.format("%s.%d", signatureBase64, timestamp);
    }
    /**
     * 构建MQTT配置信息
     * 
@@ -504,7 +555,7 @@ public class DeviceServiceImpl extends BaseServiceImpl<DeviceDao, DeviceEntity>
    private DeviceReportRespDTO.MQTT buildMqttConfig(String macAddress, String groupId)
            throws Exception {
        // 从环境变量或系统参数获取签名密钥
-        String signatureKey = sysParamsService.getValue("server.mqtt_signature_key", false);
+        String signatureKey = sysParamsService.getValue("server.mqtt_signature_key", true);
        if (StringUtils.isBlank(signatureKey)) {
            log.warn("缺少MQTT_SIGNATURE_KEY，跳过MQTT配置生成");
            return null;
@@ -0,0 +1,22 @@
 package xiaozhi.modules.knowledge.config;
 import org.springframework.context.annotation.Bean;
 import org.springframework.context.annotation.Configuration;
 import xiaozhi.modules.knowledge.rag.KnowledgeBaseAdapterFactory;
 /**
 * 知识库配置类
 * 配置知识库相关的Bean
 */
@Configuration
 public class KnowledgeBaseConfig {
    /**
     * 提供KnowledgeBaseAdapterFactory的Bean实例
     * @return KnowledgeBaseAdapterFactory实例
     */
    @Bean
    public KnowledgeBaseAdapterFactory knowledgeBaseAdapterFactory() {
        return new KnowledgeBaseAdapterFactory();
    }
 }
@@ -0,0 +1,159 @@
 package xiaozhi.modules.knowledge.controller;
 import java.util.List;
 import java.util.Map;
 import org.apache.commons.lang3.StringUtils;
 import org.apache.shiro.authz.annotation.RequiresPermissions;
 import org.springframework.validation.annotation.Validated;
 import org.springframework.web.bind.annotation.DeleteMapping;
 import org.springframework.web.bind.annotation.GetMapping;
 import org.springframework.web.bind.annotation.PathVariable;
 import org.springframework.web.bind.annotation.PostMapping;
 import org.springframework.web.bind.annotation.PutMapping;
 import org.springframework.web.bind.annotation.RequestBody;
 import org.springframework.web.bind.annotation.RequestMapping;
 import org.springframework.web.bind.annotation.RequestParam;
 import org.springframework.web.bind.annotation.RestController;
 import io.swagger.v3.oas.annotations.Operation;
 import io.swagger.v3.oas.annotations.Parameter;
 import io.swagger.v3.oas.annotations.tags.Tag;
 import lombok.AllArgsConstructor;
 import xiaozhi.common.exception.ErrorCode;
 import xiaozhi.common.exception.RenException;
 import xiaozhi.common.page.PageData;
 import xiaozhi.common.utils.Result;
 import xiaozhi.modules.knowledge.dto.KnowledgeBaseDTO;
 import xiaozhi.modules.knowledge.service.KnowledgeBaseService;
 import xiaozhi.modules.security.user.SecurityUser;
@AllArgsConstructor
@RestController
@RequestMapping("/datasets")
@Tag(name = "知识库管理")
 public class KnowledgeBaseController {
    private final KnowledgeBaseService knowledgeBaseService;
    @GetMapping
    @Operation(summary = "分页查询知识库列表")
    @RequiresPermissions("sys:role:normal")
    public Result<PageData<KnowledgeBaseDTO>> getPageList(
            @RequestParam(required = false) String name,
            @RequestParam(required = false, defaultValue = "1") Integer page,
            @RequestParam(required = false, defaultValue = "10") Integer page_size) {
        // 获取当前登录用户ID
        Long currentUserId = SecurityUser.getUserId();
        KnowledgeBaseDTO knowledgeBaseDTO = new KnowledgeBaseDTO();
        knowledgeBaseDTO.setName(name);
        knowledgeBaseDTO.setCreator(currentUserId); // 设置创建者ID，用于权限过滤
        PageData<KnowledgeBaseDTO> pageData = knowledgeBaseService.getPageList(knowledgeBaseDTO, page, page_size);
        return new Result<PageData<KnowledgeBaseDTO>>().ok(pageData);
    }
    @GetMapping("/{dataset_id}")
    @Operation(summary = "根据知识库ID获取知识库详情")
    @RequiresPermissions("sys:role:normal")
    public Result<KnowledgeBaseDTO> getByDatasetId(@PathVariable("dataset_id") String datasetId) {
        // 获取当前登录用户ID
        Long currentUserId = SecurityUser.getUserId();
        KnowledgeBaseDTO knowledgeBaseDTO = knowledgeBaseService.getByDatasetId(datasetId);
        // 检查权限：用户只能查看自己创建的知识库
        if (knowledgeBaseDTO.getCreator() == null || !knowledgeBaseDTO.getCreator().equals(currentUserId)) {
            throw new RenException(ErrorCode.NO_PERMISSION);
        }
        return new Result<KnowledgeBaseDTO>().ok(knowledgeBaseDTO);
    }
    @PostMapping
    @Operation(summary = "创建知识库")
    @RequiresPermissions("sys:role:normal")
    public Result<KnowledgeBaseDTO> save(@RequestBody @Validated KnowledgeBaseDTO knowledgeBaseDTO) {
        KnowledgeBaseDTO resp = knowledgeBaseService.save(knowledgeBaseDTO);
        return new Result<KnowledgeBaseDTO>().ok(resp);
    }
    @PutMapping("/{dataset_id}")
    @Operation(summary = "更新知识库")
    @RequiresPermissions("sys:role:normal")
    public Result<KnowledgeBaseDTO> update(@PathVariable("dataset_id") String datasetId,
            @RequestBody @Validated KnowledgeBaseDTO knowledgeBaseDTO) {
        // 获取当前登录用户ID
        Long currentUserId = SecurityUser.getUserId();
        // 先获取现有知识库信息以检查权限
        KnowledgeBaseDTO existingKnowledgeBase = knowledgeBaseService.getByDatasetId(datasetId);
        // 检查权限：用户只能更新自己创建的知识库
        if (existingKnowledgeBase.getCreator() == null || !existingKnowledgeBase.getCreator().equals(currentUserId)) {
            throw new RenException(ErrorCode.NO_PERMISSION);
        }
        knowledgeBaseDTO.setDatasetId(datasetId);
        KnowledgeBaseDTO resp = knowledgeBaseService.update(knowledgeBaseDTO);
        return new Result<KnowledgeBaseDTO>().ok(resp);
    }
    @DeleteMapping("/{dataset_id}")
    @Operation(summary = "删除单个知识库")
    @Parameter(name = "dataset_id", description = "知识库ID", required = true)
    @RequiresPermissions("sys:role:normal")
    public Result<Void> delete(@PathVariable("dataset_id") String datasetId) {
        // 获取当前登录用户ID
        Long currentUserId = SecurityUser.getUserId();
        // 先获取现有知识库信息以检查权限
        KnowledgeBaseDTO existingKnowledgeBase = knowledgeBaseService.getByDatasetId(datasetId);
        // 检查权限：用户只能删除自己创建的知识库
        if (existingKnowledgeBase.getCreator() == null || !existingKnowledgeBase.getCreator().equals(currentUserId)) {
            throw new RenException(ErrorCode.NO_PERMISSION);
        }
        knowledgeBaseService.deleteByDatasetId(datasetId);
        return new Result<>();
    }
    @DeleteMapping("/batch")
    @Operation(summary = "批量删除知识库")
    @Parameter(name = "ids", description = "知识库ID列表，用逗号分隔", required = true)
    @RequiresPermissions("sys:role:normal")
    public Result<Void> deleteBatch(@RequestParam("ids") String ids) {
        if (StringUtils.isBlank(ids)) {
            throw new RenException(ErrorCode.PARAMS_GET_ERROR);
        }
        // 获取当前登录用户ID
        Long currentUserId = SecurityUser.getUserId();
        String[] idArray = ids.split(",");
        for (String datasetId : idArray) {
            if (StringUtils.isNotBlank(datasetId)) {
                // 先获取现有知识库信息以检查权限
                KnowledgeBaseDTO existingKnowledgeBase = knowledgeBaseService.getByDatasetId(datasetId.trim());
                // 检查权限：用户只能删除自己创建的知识库
                if (existingKnowledgeBase.getCreator() == null
                        || !existingKnowledgeBase.getCreator().equals(currentUserId)) {
                    throw new RenException(ErrorCode.NO_PERMISSION);
                }
                knowledgeBaseService.deleteByDatasetId(datasetId.trim());
            }
        }
        return new Result<>();
    }
    @GetMapping("/rag-models")
    @Operation(summary = "获取RAG模型列表")
    @RequiresPermissions("sys:role:normal")
    public Result<List<Map<String, Object>>> getRAGModels() {
        List<Map<String, Object>> result = knowledgeBaseService.getRAGModels();
        return new Result<List<Map<String, Object>>>().ok(result);
    }
 }
@@ -0,0 +1,224 @@
 package xiaozhi.modules.knowledge.controller;
 import java.util.List;
 import java.util.Map;
 import org.apache.shiro.authz.annotation.RequiresPermissions;
 import org.springframework.web.bind.annotation.*;
 import org.springframework.web.multipart.MultipartFile;
 import com.fasterxml.jackson.core.type.TypeReference;
 import com.fasterxml.jackson.databind.ObjectMapper;
 import io.swagger.v3.oas.annotations.Operation;
 import io.swagger.v3.oas.annotations.Parameter;
 import io.swagger.v3.oas.annotations.tags.Tag;
 import lombok.AllArgsConstructor;
 import xiaozhi.common.exception.ErrorCode;
 import xiaozhi.common.exception.RenException;
 import xiaozhi.common.page.PageData;
 import xiaozhi.common.utils.Result;
 import xiaozhi.modules.knowledge.dto.KnowledgeBaseDTO;
 import xiaozhi.modules.knowledge.dto.KnowledgeFilesDTO;
 import xiaozhi.modules.knowledge.service.KnowledgeBaseService;
 import xiaozhi.modules.knowledge.service.KnowledgeFilesService;
 import xiaozhi.modules.security.user.SecurityUser;
@AllArgsConstructor
@RestController
@RequestMapping("/datasets/{dataset_id}")
@Tag(name = "知识库文档管理")
 public class KnowledgeFilesController {
    private final KnowledgeFilesService knowledgeFilesService;
    private final KnowledgeBaseService knowledgeBaseService;
    /**
     * 验证当前用户是否有权限操作指定知识库
     * 
     * @param datasetId 知识库ID
     */
    private void validateKnowledgeBasePermission(String datasetId) {
        // 获取当前登录用户ID
        Long currentUserId = SecurityUser.getUserId();
        // 获取知识库信息
        KnowledgeBaseDTO knowledgeBase = knowledgeBaseService.getByDatasetId(datasetId);
        // 检查权限：用户只能操作自己创建的知识库
        if (knowledgeBase.getCreator() == null || !knowledgeBase.getCreator().equals(currentUserId)) {
            throw new RenException(ErrorCode.NO_PERMISSION);
        }
    }
    @GetMapping("/documents")
    @Operation(summary = "分页查询文档列表")
    @RequiresPermissions("sys:role:normal")
    public Result<PageData<KnowledgeFilesDTO>> getPageList(
            @PathVariable("dataset_id") String datasetId,
            @RequestParam(required = false) String name,
            @RequestParam(required = false) Integer status,
            @RequestParam(required = false, defaultValue = "1") Integer page,
            @RequestParam(required = false, defaultValue = "10") Integer page_size) {
        // 验证知识库权限
        validateKnowledgeBasePermission(datasetId);
        // 如果指定了状态参数，使用状态查询接口
        if (status != null) {
            PageData<KnowledgeFilesDTO> pageData = knowledgeFilesService.getPageListByStatus(datasetId, status, page, page_size);
            return new Result<PageData<KnowledgeFilesDTO>>().ok(pageData);
        }
        // 否则使用通用查询接口
        KnowledgeFilesDTO knowledgeFilesDTO = new KnowledgeFilesDTO();
        knowledgeFilesDTO.setDatasetId(datasetId);
        knowledgeFilesDTO.setName(name);
        PageData<KnowledgeFilesDTO> pageData = knowledgeFilesService.getPageList(knowledgeFilesDTO, page, page_size);
        return new Result<PageData<KnowledgeFilesDTO>>().ok(pageData);
    }
    @GetMapping("/documents/status/{status}")
    @Operation(summary = "根据状态分页查询文档列表")
    @RequiresPermissions("sys:role:normal")
    public Result<PageData<KnowledgeFilesDTO>> getPageListByStatus(
            @PathVariable("dataset_id") String datasetId,
            @PathVariable("status") Integer status,
            @RequestParam(required = false, defaultValue = "1") Integer page,
            @RequestParam(required = false, defaultValue = "10") Integer page_size) {
        // 验证知识库权限
        validateKnowledgeBasePermission(datasetId);
        PageData<KnowledgeFilesDTO> pageData = knowledgeFilesService.getPageListByStatus(datasetId, status, page, page_size);
        return new Result<PageData<KnowledgeFilesDTO>>().ok(pageData);
    }
    @PostMapping("/documents")
    @Operation(summary = "上传文档到知识库")
    @RequiresPermissions("sys:role:normal")
    public Result<KnowledgeFilesDTO> uploadDocument(
            @PathVariable("dataset_id") String datasetId,
            @RequestParam("file") MultipartFile file,
            @RequestParam(required = false) String name,
            @RequestParam(required = false) String chunkMethod,
            @RequestParam(required = false) String metaFields,
            @RequestParam(required = false) String parserConfig) {
        // 验证知识库权限
        validateKnowledgeBasePermission(datasetId);
        KnowledgeFilesDTO resp = knowledgeFilesService.uploadDocument(datasetId, file, name,
                metaFields != null ? parseJsonMap(metaFields) : null,
                chunkMethod,
                parserConfig != null ? parseJsonMap(parserConfig) : null);
        return new Result<KnowledgeFilesDTO>().ok(resp);
    }
    @DeleteMapping("/documents/{document_id}")
    @Operation(summary = "删除单个文档")
    @Parameter(name = "document_id", description = "文档ID", required = true)
    @RequiresPermissions("sys:role:normal")
    public Result<Void> delete(@PathVariable("dataset_id") String datasetId,
            @PathVariable("document_id") String documentId) {
        // 验证知识库权限
        validateKnowledgeBasePermission(datasetId);
        knowledgeFilesService.deleteByDocumentId(documentId, datasetId);
        return new Result<>();
    }
    @PostMapping("/chunks")
    @Operation(summary = "解析文档（切块）")
    @RequiresPermissions("sys:role:normal")
    public Result<Void> parseDocuments(@PathVariable("dataset_id") String datasetId,
            @RequestBody Map<String, List<String>> requestBody) {
        // 验证知识库权限
        validateKnowledgeBasePermission(datasetId);
        List<String> documentIds = requestBody.get("document_ids");
        if (documentIds == null || documentIds.isEmpty()) {
            return new Result<Void>().error("document_ids参数不能为空");
        }
        boolean success = knowledgeFilesService.parseDocuments(datasetId, documentIds);
        if (success) {
            return new Result<Void>();
        } else {
            return new Result<Void>().error("文档解析失败，文档可能正在处理中");
        }
    }
    @GetMapping("/documents/{document_id}/chunks")
    @Operation(summary = "列出指定文档的切片")
    @RequiresPermissions("sys:role:normal")
    public Result<Map<String, Object>> listChunks(@PathVariable("dataset_id") String datasetId,
            @PathVariable("document_id") String documentId,
            @RequestParam(required = false) String keywords,
            @RequestParam(required = false, defaultValue = "1") Integer page,
            @RequestParam(required = false, defaultValue = "1024") Integer page_size,
            @RequestParam(required = false) String id) {
        // 验证知识库权限
        validateKnowledgeBasePermission(datasetId);
        Map<String, Object> result = knowledgeFilesService.listChunks(datasetId, documentId, keywords, page, page_size,
                id);
        return new Result<Map<String, Object>>().ok(result);
    }
    /**
     * 召回测试
     */
    @PostMapping("/retrieval-test")
    @Operation(summary = "召回测试")
    @RequiresPermissions("sys:role:normal")
    public Result<Map<String, Object>> retrievalTest(@PathVariable("dataset_id") String datasetId,
            @RequestBody Map<String, Object> params) {
        // 验证知识库权限
        validateKnowledgeBasePermission(datasetId);
        try {
            // 提取参数
            String question = (String) params.get("question");
            if (question == null || question.trim().isEmpty()) {
                return new Result<Map<String, Object>>().error("问题不能为空");
            }
            List<String> datasetIds = (List<String>) params.get("dataset_ids");
            List<String> documentIds = (List<String>) params.get("document_ids");
            Integer page = (Integer) params.get("page");
            Integer pageSize = (Integer) params.get("page_size");
            Float similarityThreshold = (Float) params.get("similarity_threshold");
            Float vectorSimilarityWeight = (Float) params.get("vector_similarity_weight");
            Integer topK = (Integer) params.get("top_k");
            String rerankId = (String) params.get("rerank_id");
            Boolean keyword = (Boolean) params.get("keyword");
            Boolean highlight = (Boolean) params.get("highlight");
            List<String> crossLanguages = (List<String>) params.get("cross_languages");
            Map<String, Object> metadataCondition = (Map<String, Object>) params.get("metadata_condition");
            // 如果未指定数据集ID，使用当前数据集
            if (datasetIds == null || datasetIds.isEmpty()) {
                datasetIds = java.util.Arrays.asList(datasetId);
            }
            Map<String, Object> result = knowledgeFilesService.retrievalTest(
                    question, datasetIds, documentIds, page, pageSize, similarityThreshold,
                    vectorSimilarityWeight, topK, rerankId, keyword, highlight, crossLanguages, metadataCondition);
            return new Result<Map<String, Object>>().ok(result);
        } catch (Exception e) {
            return new Result<Map<String, Object>>().error("召回测试失败: " + e.getMessage());
        }
    }
    /**
     * 解析JSON字符串为Map对象
     */
    private Map<String, Object> parseJsonMap(String jsonString) {
        try {
            ObjectMapper objectMapper = new ObjectMapper();
            return objectMapper.readValue(jsonString, new TypeReference<Map<String, Object>>() {
            });
        } catch (Exception e) {
            throw new RuntimeException("解析JSON字符串失败: " + jsonString, e);
        }
    }
 }
@@ -0,0 +1,22 @@
 package xiaozhi.modules.knowledge.dao;
 import org.apache.ibatis.annotations.Mapper;
 import org.apache.ibatis.annotations.Param;
 import xiaozhi.common.dao.BaseDao;
 import xiaozhi.modules.knowledge.entity.KnowledgeBaseEntity;
 /**
 * 知识库知识库
 */
@Mapper
 public interface KnowledgeBaseDao extends BaseDao<KnowledgeBaseEntity> {
    /**
     * 根据知识库ID删除相关的插件映射记录
     * 
     * @param knowledgeBaseId 知识库ID
     */
    void deletePluginMappingByKnowledgeBaseId(@Param("knowledgeBaseId") String knowledgeBaseId);
 }
@@ -0,0 +1,49 @@
 package xiaozhi.modules.knowledge.dto;
 import java.io.Serial;
 import java.io.Serializable;
 import java.util.Date;
 import io.swagger.v3.oas.annotations.media.Schema;
 import lombok.Data;
@Data
@Schema(description = "知识库知识库")
 public class KnowledgeBaseDTO implements Serializable {
    @Serial
    private static final long serialVersionUID = 1L;
    @Schema(description = "唯一标识")
    private String id;
    @Schema(description = "知识库ID")
    private String datasetId;
    @Schema(description = "RAG模型配置ID")
    private String ragModelId;
    @Schema(description = "知识库名称")
    private String name;
    @Schema(description = "知识库描述")
    private String description;
    @Schema(description = "状态(0:禁用 1:启用)")
    private Integer status;
    @Schema(description = "创建者")
    private Long creator;
    @Schema(description = "创建时间")
    private Date createdAt;
    @Schema(description = "更新者")
    private Long updater;
    @Schema(description = "更新时间")
    private Date updatedAt;
    @Schema(description = "文档数量")
    private Integer documentCount;
 }
@@ -0,0 +1,96 @@
 package xiaozhi.modules.knowledge.dto;
 import java.io.Serial;
 import java.io.Serializable;
 import java.util.Date;
 import java.util.Map;
 import io.swagger.v3.oas.annotations.media.Schema;
 import lombok.Data;
@Data
@Schema(description = "知识库文档")
 public class KnowledgeFilesDTO implements Serializable {
    @Serial
    private static final long serialVersionUID = 1L;
    @Schema(description = "唯一标识")
    private String id;
    @Schema(description = "文档ID")
    private String documentId;
    @Schema(description = "知识库ID")
    private String datasetId;
    @Schema(description = "文档名称")
    private String name;
    @Schema(description = "文档类型")
    private String fileType;
    @Schema(description = "文件大小（字节）")
    private Long fileSize;
    @Schema(description = "文件路径")
    private String filePath;
    @Schema(description = "元数据字段")
    private Map<String, Object> metaFields;
    @Schema(description = "分块方法")
    private String chunkMethod;
    @Schema(description = "解析器配置")
    private Map<String, Object> parserConfig;
    @Schema(description = "状态")
    private Integer status;
    @Schema(description = "文档解析状态")
    private String run;
    @Schema(description = "创建者")
    private Long creator;
    @Schema(description = "创建时间")
    private Date createdAt;
    @Schema(description = "更新者")
    private Long updater;
    @Schema(description = "更新时间")
    private Date updatedAt;
    // 文档解析状态常量定义
    private static final Integer STATUS_UNSTART = 0;
    private static final Integer STATUS_RUNNING = 1;
    private static final Integer STATUS_CANCEL = 2;
    private static final Integer STATUS_DONE = 3;
    private static final Integer STATUS_FAIL = 4;
    /**
     * 获取文档解析状态码（基于run字段转换）
     */
    public Integer getParseStatusCode() {
        if (run == null) {
            return STATUS_UNSTART;
        }
        // RAGFlow根据run字段的值直接映射到对应的状态码
        switch (run.toUpperCase()) {
            case "RUNNING":
                return STATUS_RUNNING;
            case "CANCEL":
                return STATUS_CANCEL;
            case "DONE":
                return STATUS_DONE;
            case "FAIL":
                return STATUS_FAIL;
            case "UNSTART":
            default:
                return STATUS_UNSTART;
        }
    }
 }
@@ -0,0 +1,53 @@
 package xiaozhi.modules.knowledge.entity;
 import java.util.Date;
 import com.baomidou.mybatisplus.annotation.FieldFill;
 import com.baomidou.mybatisplus.annotation.IdType;
 import com.baomidou.mybatisplus.annotation.TableField;
 import com.baomidou.mybatisplus.annotation.TableId;
 import com.baomidou.mybatisplus.annotation.TableName;
 import io.swagger.v3.oas.annotations.media.Schema;
 import lombok.Data;
@Data
@TableName(value = "ai_rag_dataset", autoResultMap = true)
@Schema(description = "知识库知识库表")
 public class KnowledgeBaseEntity {
    @TableId(type = IdType.ASSIGN_UUID)
    @Schema(description = "唯一标识")
    private String id;
    @Schema(description = "知识库ID")
    private String datasetId;
    @Schema(description = "RAG模型配置ID")
    private String ragModelId;
    @Schema(description = "知识库名称")
    private String name;
    @Schema(description = "知识库描述")
    private String description;
    @Schema(description = "状态(0:禁用 1:启用)")
    private Integer status;
    @Schema(description = "创建者")
    @TableField(fill = FieldFill.INSERT)
    private Long creator;
    @Schema(description = "创建时间")
    @TableField(fill = FieldFill.INSERT)
    private Date createdAt;
    @Schema(description = "更新者")
    @TableField(fill = FieldFill.UPDATE)
    private Long updater;
    @Schema(description = "更新时间")
    @TableField(fill = FieldFill.UPDATE)
    private Date updatedAt;
 }
@@ -0,0 +1,200 @@
 package xiaozhi.modules.knowledge.rag;
 import java.util.List;
 import java.util.Map;
 import org.springframework.web.multipart.MultipartFile;
 import xiaozhi.common.page.PageData;
 import xiaozhi.modules.knowledge.dto.KnowledgeFilesDTO;
 /**
 * 知识库API适配器抽象基类
 * 定义通用的知识库操作接口，支持多种后端API实现
 */
 public abstract class KnowledgeBaseAdapter {
        /**
         * 获取适配器类型标识
         * 
         * @return 适配器类型（如：ragflow, milvus, pinecone等）
         */
        public abstract String getAdapterType();
        /**
         * 初始化适配器配置
         * 
         * @param config 配置参数
         */
        public abstract void initialize(Map<String, Object> config);
        /**
         * 验证配置是否有效
         * 
         * @param config 配置参数
         * @return 验证结果
         */
        public abstract boolean validateConfig(Map<String, Object> config);
        /**
         * 分页查询文档列表
         * 
         * @param datasetId   知识库ID
         * @param queryParams 查询参数
         * @param page        页码
         * @param limit       每页数量
         * @return 分页数据
         */
        public abstract PageData<KnowledgeFilesDTO> getDocumentList(String datasetId,
                        Map<String, Object> queryParams,
                        Integer page,
                        Integer limit);
        /**
         * 根据文档ID获取文档详情
         * 
         * @param datasetId 知识库ID
         * @return 文档详情
         */
        public abstract KnowledgeFilesDTO getDocumentById(String datasetId, String documentId);
        /**
         * 上传文档到知识库
         * 
         * @param datasetId    知识库ID
         * @param file         上传的文件
         * @param name         文档名称
         * @param metaFields   元数据字段
         * @param chunkMethod  分块方法
         * @param parserConfig 解析器配置
         * @return 上传的文档信息
         */
        public abstract KnowledgeFilesDTO uploadDocument(String datasetId,
                        MultipartFile file,
                        String name,
                        Map<String, Object> metaFields,
                        String chunkMethod,
                        Map<String, Object> parserConfig);
        /**
         * 根据状态分页查询文档列表
         * 
         * @param datasetId 知识库ID
         * @param status    文档解析状态
         * @param page      页码
         * @param limit     每页数量
         * @return 分页数据
         */
        public abstract PageData<KnowledgeFilesDTO> getDocumentListByStatus(String datasetId,
                        Integer status,
                        Integer page,
                        Integer limit);
        /**
         * 删除文档
         * 
         * @param datasetId  知识库ID
         * @param documentId 文档ID
         */
        public abstract void deleteDocument(String datasetId, String documentId);
        /**
         * 解析文档（切块）
         * 
         * @param datasetId   知识库ID
         * @param documentIds 文档ID列表
         * @return 解析结果
         */
        public abstract boolean parseDocuments(String datasetId, List<String> documentIds);
        /**
         * 列出指定文档的切片
         * 
         * @param datasetId  知识库ID
         * @param documentId 文档ID
         * @param keywords   关键词过滤
         * @param page       页码
         * @param pageSize   每页数量
         * @param chunkId    切片ID
         * @return 切片列表信息
         */
        public abstract Map<String, Object> listChunks(String datasetId,
                        String documentId,
                        String keywords,
                        Integer page,
                        Integer pageSize,
                        String chunkId);
        /**
         * 召回测试 - 从知识库中检索相关切片
         * 
         * @param question        用户查询
         * @param datasetIds      数据集ID列表
         * @param documentIds     文档ID列表
         * @param retrievalParams 检索参数
         * @return 召回测试结果
         */
        public abstract Map<String, Object> retrievalTest(String question,
                        List<String> datasetIds,
                        List<String> documentIds,
                        Map<String, Object> retrievalParams);
        /**
         * 测试连接
         * 
         * @return 连接测试结果
         */
        public abstract boolean testConnection();
        /**
         * 获取适配器状态信息
         * 
         * @return 状态信息
         */
        public abstract Map<String, Object> getStatus();
        /**
         * 获取支持的配置参数
         * 
         * @return 配置参数说明
         */
        public abstract Map<String, Object> getSupportedConfig();
        /**
         * 获取默认配置
         * 
         * @return 默认配置
         */
        public abstract Map<String, Object> getDefaultConfig();
        /**
         * 创建数据集
         * 
         * @param createParams 创建参数
         * @return 数据集ID
         */
        public abstract String createDataset(Map<String, Object> createParams);
        /**
         * 更新数据集
         * 
         * @param datasetId    数据集ID
         * @param updateParams 更新参数
         */
        public abstract void updateDataset(String datasetId, Map<String, Object> updateParams);
        /**
         * 删除数据集
         * 
         * @param datasetId 数据集ID
         */
        public abstract void deleteDataset(String datasetId);
        /**
         * 获取数据集的文档数量
         * 
         * @param datasetId 数据集ID
         * @return 文档数量
         */
        public abstract Integer getDocumentCount(String datasetId);
 }
@@ -0,0 +1,197 @@
 package xiaozhi.modules.knowledge.rag;
 import java.util.HashMap;
 import java.util.Map;
 import java.util.Set;
 import java.util.concurrent.ConcurrentHashMap;
 import lombok.extern.slf4j.Slf4j;
 import xiaozhi.common.exception.ErrorCode;
 import xiaozhi.common.exception.RenException;
 /**
 * 知识库适配器工厂类
 * 负责创建和管理不同类型的知识库API适配器
 */
@Slf4j
 public class KnowledgeBaseAdapterFactory {
    // 注册的适配器类型映射
    private static final Map<String, Class<? extends KnowledgeBaseAdapter>> adapterRegistry = new HashMap<>();
    // 适配器实例缓存
    private static final Map<String, KnowledgeBaseAdapter> adapterCache = new ConcurrentHashMap<>();
    static {
        // 注册内置适配器类型
        registerAdapter("ragflow", xiaozhi.modules.knowledge.rag.impl.RAGFlowAdapter.class);
        // 可以在这里注册更多适配器类型
    }
    /**
     * 注册新的适配器类型
     * 
     * @param adapterType  适配器类型标识
     * @param adapterClass 适配器类
     */
    public static void registerAdapter(String adapterType, Class<? extends KnowledgeBaseAdapter> adapterClass) {
        if (adapterRegistry.containsKey(adapterType)) {
            log.warn("适配器类型 '{}' 已存在，将被覆盖", adapterType);
        }
        adapterRegistry.put(adapterType, adapterClass);
        log.info("注册适配器类型: {} -> {}", adapterType, adapterClass.getSimpleName());
    }
    /**
     * 获取适配器实例
     * 
     * @param adapterType 适配器类型
     * @param config      配置参数
     * @return 适配器实例
     */
    public static KnowledgeBaseAdapter getAdapter(String adapterType, Map<String, Object> config) {
        String cacheKey = buildCacheKey(adapterType, config);
        // 检查缓存中是否已存在实例
        if (adapterCache.containsKey(cacheKey)) {
            log.debug("从缓存获取适配器实例: {}", cacheKey);
            return adapterCache.get(cacheKey);
        }
        // 创建新的适配器实例
        KnowledgeBaseAdapter adapter = createAdapter(adapterType, config);
        // 缓存适配器实例
        adapterCache.put(cacheKey, adapter);
        log.info("创建并缓存适配器实例: {}", cacheKey);
        return adapter;
    }
    /**
     * 获取适配器实例（无配置）
     * 
     * @param adapterType 适配器类型
     * @return 适配器实例
     */
    public static KnowledgeBaseAdapter getAdapter(String adapterType) {
        return getAdapter(adapterType, null);
    }
    /**
     * 获取所有已注册的适配器类型
     * 
     * @return 适配器类型集合
     */
    public static Set<String> getRegisteredAdapterTypes() {
        return adapterRegistry.keySet();
    }
    /**
     * 检查适配器类型是否已注册
     * 
     * @param adapterType 适配器类型
     * @return 是否已注册
     */
    public static boolean isAdapterTypeRegistered(String adapterType) {
        return adapterRegistry.containsKey(adapterType);
    }
    /**
     * 清除适配器缓存
     */
    public static void clearCache() {
        int cacheSize = adapterCache.size();
        adapterCache.clear();
        log.info("清除适配器缓存，共清除 {} 个实例", cacheSize);
    }
    /**
     * 移除特定适配器类型的缓存
     * 
     * @param adapterType 适配器类型
     */
    public static void removeCacheByType(String adapterType) {
        int removedCount = 0;
        for (String cacheKey : adapterCache.keySet()) {
            if (cacheKey.startsWith(adapterType + "@")) {
                adapterCache.remove(cacheKey);
                removedCount++;
            }
        }
        log.info("移除适配器类型 '{}' 的缓存，共移除 {} 个实例", adapterType, removedCount);
    }
    /**
     * 获取适配器工厂状态信息
     * 
     * @return 状态信息
     */
    public static Map<String, Object> getFactoryStatus() {
        Map<String, Object> status = new HashMap<>();
        status.put("registeredAdapterTypes", adapterRegistry.keySet());
        status.put("cachedAdapterCount", adapterCache.size());
        status.put("cacheKeys", adapterCache.keySet());
        return status;
    }
    /**
     * 创建适配器实例
     * 
     * @param adapterType 适配器类型
     * @param config      配置参数
     * @return 适配器实例
     */
    private static KnowledgeBaseAdapter createAdapter(String adapterType, Map<String, Object> config) {
        if (!adapterRegistry.containsKey(adapterType)) {
            throw new RenException(ErrorCode.RAG_ADAPTER_TYPE_NOT_SUPPORTED,
                    "不支持的适配器类型: " + adapterType);
        }
        try {
            Class<? extends KnowledgeBaseAdapter> adapterClass = adapterRegistry.get(adapterType);
            KnowledgeBaseAdapter adapter = adapterClass.getDeclaredConstructor().newInstance();
            // 初始化适配器
            if (config != null) {
                adapter.initialize(config);
                // 验证配置
                if (!adapter.validateConfig(config)) {
                    throw new RenException(ErrorCode.RAG_CONFIG_VALIDATION_FAILED,
                            "适配器配置验证失败: " + adapterType);
                }
            }
            log.info("成功创建适配器实例: {}", adapterType);
            return adapter;
        } catch (Exception e) {
            log.error("创建适配器实例失败: {}", adapterType, e);
            throw new RenException(ErrorCode.RAG_ADAPTER_CREATION_FAILED,
                    "创建适配器失败: " + adapterType + ", 错误: " + e.getMessage());
        }
    }
    /**
     * 构建缓存键
     * 
     * @param adapterType 适配器类型
     * @param config      配置参数
     * @return 缓存键
     */
    private static String buildCacheKey(String adapterType, Map<String, Object> config) {
        if (config == null || config.isEmpty()) {
            return adapterType + "@default";
        }
        // 基于配置参数生成缓存键
        StringBuilder keyBuilder = new StringBuilder(adapterType + "@");
        // 使用配置的哈希值作为缓存键的一部分
        int configHash = config.hashCode();
        keyBuilder.append(configHash);
        return keyBuilder.toString();
    }
 }
@@ -0,0 +1,87 @@
 package xiaozhi.modules.knowledge.service;
 import java.util.List;
 import java.util.Map;
 import xiaozhi.common.page.PageData;
 import xiaozhi.common.service.BaseService;
 import xiaozhi.modules.knowledge.dto.KnowledgeBaseDTO;
 import xiaozhi.modules.knowledge.entity.KnowledgeBaseEntity;
 /**
 * 知识库知识库服务接口
 */
 public interface KnowledgeBaseService extends BaseService<KnowledgeBaseEntity> {
    /**
     * 分页查询知识库列表
     * 
     * @param knowledgeBaseDTO 查询条件
     * @param page             页码
     * @param limit            每页数量
     * @return 分页数据
     */
    PageData<KnowledgeBaseDTO> getPageList(KnowledgeBaseDTO knowledgeBaseDTO, Integer page, Integer limit);
    /**
     * 根据ID获取知识库详情
     * 
     * @param id 知识库ID
     * @return 知识库详情
     */
    KnowledgeBaseDTO getById(String id);
    /**
     * 新增知识库
     * 
     * @param knowledgeBaseDTO 知识库信息
     * @return 新增的知识库
     */
    KnowledgeBaseDTO save(KnowledgeBaseDTO knowledgeBaseDTO);
    /**
     * 更新知识库
     * 
     * @param knowledgeBaseDTO 知识库信息
     * @return 更新的知识库
     */
    KnowledgeBaseDTO update(KnowledgeBaseDTO knowledgeBaseDTO);
    /**
     * 根据知识库ID查询知识库
     * 
     * @param datasetId 知识库ID
     * @return 知识库详情
     */
    KnowledgeBaseDTO getByDatasetId(String datasetId);
    /**
     * 根据知识库ID删除知识库
     * 
     * @param datasetId 知识库ID
     */
    void deleteByDatasetId(String datasetId);
    /**
     * 获取RAG配置信息
     * 
     * @param ragModelId RAG模型配置ID
     * @return RAG配置信息
     */
    Map<String, Object> getRAGConfig(String ragModelId);
    /**
     * 根据知识库ID获取对应的RAG配置
     * 
     * @param datasetId 知识库ID
     * @return RAG配置
     */
    Map<String, Object> getRAGConfigByDatasetId(String datasetId);
    /**
     * 获取RAG模型列表
     * 
     * @return RAG模型列表
     */
    List<Map<String, Object>> getRAGModels();
 }
@@ -0,0 +1,123 @@
 package xiaozhi.modules.knowledge.service;
 import java.util.List;
 import java.util.Map;
 import org.springframework.web.multipart.MultipartFile;
 import xiaozhi.common.page.PageData;
 import xiaozhi.modules.knowledge.dto.KnowledgeFilesDTO;
 /**
 * 知识库文档服务接口
 */
 public interface KnowledgeFilesService {
        /**
         * 分页查询文档列表
         * 
         * @param knowledgeFilesDTO 查询条件
         * @param page              页码
         * @param limit             每页数量
         * @return 分页数据
         */
        PageData<KnowledgeFilesDTO> getPageList(KnowledgeFilesDTO knowledgeFilesDTO, Integer page, Integer limit);
        /**
         * 根据文档ID和知识库ID获取文档详情
         * 
         * @param documentId 文档ID
         * @param datasetId  知识库ID
         * @return 文档详情
         */
        KnowledgeFilesDTO getByDocumentId(String documentId, String datasetId);
        /**
         * 上传文档到知识库
         * 
         * @param datasetId    知识库ID
         * @param file         上传的文件
         * @param name         文档名称
         * @param metaFields   元数据字段
         * @param chunkMethod  分块方法
         * @param parserConfig 解析器配置
         * @return 上传的文档信息
         */
        KnowledgeFilesDTO uploadDocument(String datasetId, MultipartFile file, String name,
                        Map<String, Object> metaFields, String chunkMethod,
                        Map<String, Object> parserConfig);
        /**
         * 根据状态分页查询文档列表
         * 
         * @param datasetId 知识库ID
         * @param status    文档解析状态（0-未开始，1-进行中，2-已取消，3-已完成，4-失败）
         * @param page      页码
         * @param limit     每页数量
         * @return 分页数据
         */
        PageData<KnowledgeFilesDTO> getPageListByStatus(String datasetId, Integer status, Integer page, Integer limit);
        /**
         * 根据文档ID和知识库ID删除文档
         * 
         * @param documentId 文档ID
         * @param datasetId  知识库ID
         */
        void deleteByDocumentId(String documentId, String datasetId);
        /**
         * 获取RAG配置信息
         * 
         * @param ragModelId RAG模型配置ID
         * @return RAG配置信息
         */
        Map<String, Object> getRAGConfig(String ragModelId);
        /**
         * 解析文档（切块）
         * 
         * @param datasetId   知识库ID
         * @param documentIds 文档ID列表
         * @return 解析结果
         */
        boolean parseDocuments(String datasetId, List<String> documentIds);
        /**
         * 列出指定文档的切片
         * 
         * @param datasetId  知识库ID
         * @param documentId 文档ID
         * @param keywords   关键词过滤
         * @param page       页码
         * @param pageSize   每页数量
         * @param chunkId    切片ID
         * @return 切片列表信息
         */
        Map<String, Object> listChunks(String datasetId, String documentId, String keywords,
                        Integer page, Integer pageSize, String chunkId);
        /**
         * 召回测试 - 从指定数据集或文档中检索相关切片
         * 
         * @param question               用户查询或查询关键词
         * @param datasetIds             数据集ID列表
         * @param documentIds            文档ID列表
         * @param page                   页码
         * @param pageSize               每页数量
         * @param similarityThreshold    最小相似度阈值
         * @param vectorSimilarityWeight 向量相似度权重
         * @param topK                   参与向量余弦计算的切片数量
         * @param rerankId               重排模型ID
         * @param keyword                是否启用关键词匹配
         * @param highlight              是否启用高亮显示
         * @param crossLanguages         跨语言翻译列表
         * @param metadataCondition      元数据过滤条件
         * @return 召回测试结果
         */
        Map<String, Object> retrievalTest(String question, List<String> datasetIds, List<String> documentIds,
                        Integer page, Integer pageSize, Float similarityThreshold,
                        Float vectorSimilarityWeight, Integer topK, String rerankId,
                        Boolean keyword, Boolean highlight, List<String> crossLanguages,
                        Map<String, Object> metadataCondition);
 }
@@ -0,0 +1,644 @@
 package xiaozhi.modules.knowledge.service.impl;
 import java.io.IOException;
 import java.io.Serializable;
 import java.util.ArrayList;
 import java.util.HashMap;
 import java.util.List;
 import java.util.Map;
 import org.apache.commons.lang3.StringUtils;
 import org.springframework.http.HttpEntity;
 import org.springframework.http.HttpHeaders;
 import org.springframework.http.HttpMethod;
 import org.springframework.http.MediaType;
 import org.springframework.http.ResponseEntity;
 import org.springframework.stereotype.Service;
 import org.springframework.web.client.RestTemplate;
 import com.baomidou.mybatisplus.core.conditions.query.QueryWrapper;
 import com.baomidou.mybatisplus.core.metadata.IPage;
 import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
 import com.fasterxml.jackson.databind.ObjectMapper;
 import lombok.AllArgsConstructor;
 import lombok.extern.slf4j.Slf4j;
 import xiaozhi.common.constant.Constant;
 import xiaozhi.common.exception.ErrorCode;
 import xiaozhi.common.exception.RenException;
 import xiaozhi.common.page.PageData;
 import xiaozhi.common.redis.RedisKeys;
 import xiaozhi.common.redis.RedisUtils;
 import xiaozhi.common.service.impl.BaseServiceImpl;
 import xiaozhi.common.utils.ConvertUtils;
 import xiaozhi.common.utils.MessageUtils;
 import xiaozhi.modules.knowledge.dao.KnowledgeBaseDao;
 import xiaozhi.modules.knowledge.dto.KnowledgeBaseDTO;
 import xiaozhi.modules.knowledge.entity.KnowledgeBaseEntity;
 import xiaozhi.modules.knowledge.rag.KnowledgeBaseAdapter;
 import xiaozhi.modules.knowledge.rag.KnowledgeBaseAdapterFactory;
 import xiaozhi.modules.knowledge.service.KnowledgeBaseService;
 import xiaozhi.modules.model.dao.ModelConfigDao;
 import xiaozhi.modules.model.entity.ModelConfigEntity;
 import xiaozhi.modules.model.service.ModelConfigService;
 import xiaozhi.modules.security.user.SecurityUser;
@Service
@AllArgsConstructor
@Slf4j
 public class KnowledgeBaseServiceImpl extends BaseServiceImpl<KnowledgeBaseDao, KnowledgeBaseEntity>
        implements KnowledgeBaseService {
    private final KnowledgeBaseDao knowledgeBaseDao;
    private final ModelConfigService modelConfigService;
    private final ModelConfigDao modelConfigDao;
    private final RedisUtils redisUtils;
    private RestTemplate restTemplate = new RestTemplate();
    private final ObjectMapper objectMapper = new ObjectMapper();
    @Override
    public KnowledgeBaseEntity selectById(Serializable datasetId) {
        if (datasetId == null) {
            return null;
        }
        // 先从Redis获取缓存
        String key = RedisKeys.getKnowledgeBaseCacheKey(datasetId.toString());
        KnowledgeBaseEntity cachedEntity = (KnowledgeBaseEntity) redisUtils.get(key);
        if (cachedEntity != null) {
            return cachedEntity;
        }
        // 如果缓存中没有，则从数据库获取
        KnowledgeBaseEntity entity = knowledgeBaseDao.selectById(datasetId);
        if (entity == null) {
            return null;
        }
        // 存入Redis缓存
        redisUtils.set(key, entity);
        return entity;
    }
    @Override
    public PageData<KnowledgeBaseDTO> getPageList(KnowledgeBaseDTO knowledgeBaseDTO, Integer page, Integer limit) {
        long curPage = page;
        long pageSize = limit;
        Page<KnowledgeBaseEntity> pageInfo = new Page<>(curPage, pageSize);
        QueryWrapper<KnowledgeBaseEntity> queryWrapper = new QueryWrapper<>();
        // 添加查询条件
        if (knowledgeBaseDTO != null) {
            queryWrapper.like(StringUtils.isNotBlank(knowledgeBaseDTO.getName()), "name", knowledgeBaseDTO.getName());
            queryWrapper.eq(knowledgeBaseDTO.getStatus() != null, "status", knowledgeBaseDTO.getStatus());
            queryWrapper.eq("creator", knowledgeBaseDTO.getCreator());
        }
        // 添加排序规则：按创建时间降序
        queryWrapper.orderByDesc("created_at");
        IPage<KnowledgeBaseEntity> knowledgeBaseEntityIPage = knowledgeBaseDao.selectPage(pageInfo, queryWrapper);
        // 获取分页数据
        PageData<KnowledgeBaseDTO> pageData = getPageData(knowledgeBaseEntityIPage, KnowledgeBaseDTO.class);
        // 为每个知识库获取文档数量
        if (pageData != null && pageData.getList() != null) {
            for (KnowledgeBaseDTO knowledgeBase : pageData.getList()) {
                try {
                    Integer documentCount = getDocumentCountFromRAG(knowledgeBase.getDatasetId(),
                            knowledgeBase.getRagModelId());
                    knowledgeBase.setDocumentCount(documentCount);
                } catch (Exception e) {
                    // 构建详细的错误信息，包含异常类型和消息
                    String baseErrorMessage = e.getClass().getSimpleName() + " - 获取知识库文档数量失败";
                    String errorMessage = baseErrorMessage + (e.getMessage() != null ? ": " + e.getMessage() : "");
                    log.warn("知识库 {} {}", knowledgeBase.getDatasetId(), errorMessage);
                    knowledgeBase.setDocumentCount(0); // 设置默认值
                }
            }
        }
        return pageData;
    }
    @Override
    public KnowledgeBaseDTO getById(String id) {
        if (StringUtils.isBlank(id)) {
            throw new RenException(ErrorCode.IDENTIFIER_NOT_NULL);
        }
        KnowledgeBaseEntity entity = knowledgeBaseDao.selectById(id);
        if (entity == null) {
            throw new RenException(ErrorCode.Knowledge_Base_RECORD_NOT_EXISTS);
        }
        return ConvertUtils.sourceToTarget(entity, KnowledgeBaseDTO.class);
    }
    @Override
    public KnowledgeBaseDTO save(KnowledgeBaseDTO knowledgeBaseDTO) {
        if (knowledgeBaseDTO == null) {
            throw new RenException(ErrorCode.PARAMS_GET_ERROR);
        }
        // 检查是否存在同名知识库
        checkDuplicateKnowledgeBaseName(knowledgeBaseDTO, null);
        String datasetId = null;
        // 调用RAG API创建数据集
        try {
            Map<String, Object> ragConfig = getValidatedRAGConfig(knowledgeBaseDTO.getRagModelId());
            datasetId = createDatasetInRAG(
                    knowledgeBaseDTO.getName(),
                    knowledgeBaseDTO.getDescription(),
                    ragConfig);
        } catch (Exception e) {
            // 如果RAG API调用失败，直接抛出异常
            throw e;
        }
        // 验证数据集ID是否已存在
        KnowledgeBaseEntity existingEntity = knowledgeBaseDao.selectOne(
                new QueryWrapper<KnowledgeBaseEntity>().eq("dataset_id", datasetId));
        if (existingEntity != null) {
            // 如果datasetId已存在，删除RAG中的数据集并抛出异常
            try {
                Map<String, Object> ragConfig = getValidatedRAGConfig(knowledgeBaseDTO.getRagModelId());
                deleteDatasetInRAG(datasetId, ragConfig);
            } catch (Exception deleteException) {
                // 提供更详细的错误信息，包括异常类型和消息
                String errorMessage = "删除重复datasetId的RAG数据集失败: " + deleteException.getClass().getSimpleName();
                if (deleteException.getMessage() != null) {
                    errorMessage += " - " + deleteException.getMessage();
                }
                log.warn(errorMessage, deleteException);
            }
            throw new RenException(ErrorCode.DB_RECORD_EXISTS);
        }
        // 创建本地实体并保存
        KnowledgeBaseEntity entity = ConvertUtils.sourceToTarget(knowledgeBaseDTO, KnowledgeBaseEntity.class);
        entity.setDatasetId(datasetId);
        knowledgeBaseDao.insert(entity);
        return ConvertUtils.sourceToTarget(entity, KnowledgeBaseDTO.class);
    }
    @Override
    public KnowledgeBaseDTO update(KnowledgeBaseDTO knowledgeBaseDTO) {
        if (knowledgeBaseDTO == null || StringUtils.isBlank(knowledgeBaseDTO.getId())) {
            throw new RenException(ErrorCode.IDENTIFIER_NOT_NULL);
        }
        // 检查记录是否存在
        KnowledgeBaseEntity existingEntity = knowledgeBaseDao.selectById(knowledgeBaseDTO.getId());
        if (existingEntity == null) {
            throw new RenException(ErrorCode.Knowledge_Base_RECORD_NOT_EXISTS);
        }
        // 检查是否存在同名知识库（排除当前记录）
        checkDuplicateKnowledgeBaseName(knowledgeBaseDTO, knowledgeBaseDTO.getId());
        // 验证数据集ID是否与其他记录冲突
        if (StringUtils.isNotBlank(knowledgeBaseDTO.getDatasetId())) {
            KnowledgeBaseEntity conflictEntity = knowledgeBaseDao.selectOne(
                    new QueryWrapper<KnowledgeBaseEntity>()
                            .eq("dataset_id", knowledgeBaseDTO.getDatasetId())
                            .ne("id", knowledgeBaseDTO.getId()));
            if (conflictEntity != null) {
                throw new RenException(ErrorCode.DB_RECORD_EXISTS);
            }
        }
        boolean needRagValidation = StringUtils.isNotBlank(knowledgeBaseDTO.getDatasetId())
                && StringUtils.isNotBlank(knowledgeBaseDTO.getRagModelId());
        if (needRagValidation) {
            try {
                // 先校验RAG配置
                Map<String, Object> ragConfig = getValidatedRAGConfig(knowledgeBaseDTO.getRagModelId());
                // 调用RAG API更新数据集
                updateDatasetInRAG(
                        knowledgeBaseDTO.getDatasetId(),
                        knowledgeBaseDTO.getName(),
                        knowledgeBaseDTO.getDescription(),
                        ragConfig);
                log.info("RAG API更新成功，datasetId: {}", knowledgeBaseDTO.getDatasetId());
            } catch (Exception e) {
                // 提供更详细的错误信息，包括异常类型和消息
                String errorMessage = "更新RAG数据集失败: " + e.getClass().getSimpleName();
                if (e.getMessage() != null) {
                    errorMessage += " - " + e.getMessage();
                }
                log.error(errorMessage, e);
                throw e;
            }
        } else {
            log.warn("datasetId或ragModelId为空，跳过RAG更新");
        }
        KnowledgeBaseEntity entity = ConvertUtils.sourceToTarget(knowledgeBaseDTO, KnowledgeBaseEntity.class);
        knowledgeBaseDao.updateById(entity);
        // 删除缓存
        if (entity.getDatasetId() != null) {
            redisUtils.delete(RedisKeys.getKnowledgeBaseCacheKey(entity.getId()));
        }
        return ConvertUtils.sourceToTarget(entity, KnowledgeBaseDTO.class);
    }
    @Override
    public KnowledgeBaseDTO getByDatasetId(String datasetId) {
        if (StringUtils.isBlank(datasetId)) {
            throw new RenException(ErrorCode.PARAMS_GET_ERROR);
        }
        KnowledgeBaseEntity entity = knowledgeBaseDao.selectOne(
                new QueryWrapper<KnowledgeBaseEntity>().eq("dataset_id", datasetId));
        if (entity == null) {
            throw new RenException(ErrorCode.Knowledge_Base_RECORD_NOT_EXISTS);
        }
        return ConvertUtils.sourceToTarget(entity, KnowledgeBaseDTO.class);
    }
    @Override
    public void deleteByDatasetId(String datasetId) {
        if (StringUtils.isBlank(datasetId)) {
            throw new RenException(ErrorCode.PARAMS_GET_ERROR);
        }
        log.info("=== 开始通过datasetId删除操作 ===");
        log.info("删除datasetId: {}", datasetId);
        KnowledgeBaseEntity entity = knowledgeBaseDao.selectOne(
                new QueryWrapper<KnowledgeBaseEntity>().eq("dataset_id", datasetId));
        if (entity == null) {
            log.warn("记录不存在，datasetId: {}", datasetId);
            throw new RenException(ErrorCode.Knowledge_Base_RECORD_NOT_EXISTS);
        }
        redisUtils.delete(RedisKeys.getKnowledgeBaseCacheKey(entity.getId()));
        log.info("找到记录: ID={}, datasetId={}, ragModelId={}",
                entity.getId(), entity.getDatasetId(), entity.getRagModelId());
        // 先调用RAG API删除数据集
        boolean apiDeleteSuccess = false;
        if (StringUtils.isNotBlank(entity.getDatasetId()) && StringUtils.isNotBlank(entity.getRagModelId())) {
            try {
                log.info("开始调用RAG API删除数据集");
                // 在删除前进行RAG配置校验
                Map<String, Object> ragConfig = getValidatedRAGConfig(entity.getRagModelId());
                deleteDatasetInRAG(entity.getDatasetId(), ragConfig);
                log.info("RAG API删除调用完成");
                apiDeleteSuccess = true;
            } catch (Exception e) {
                // 提供更详细的错误信息，包括异常类型和消息
                String errorMessage = "删除RAG数据集失败: " + e.getClass().getSimpleName();
                if (e.getMessage() != null) {
                    errorMessage += " - " + e.getMessage();
                }
                log.error(errorMessage, e);
                throw e;
            }
        } else {
            log.warn("datasetId或ragModelId为空，跳过RAG删除");
            apiDeleteSuccess = true; // 没有RAG数据集，视为成功
        }
        // API删除成功后再删除本地记录
        if (apiDeleteSuccess) {
            log.info("开始删除ai_agent_plugin_mapping表中与知识库ID '{}' 相关的映射记录", entity.getId());
            // 先删除相关的插件映射记录
            knowledgeBaseDao.deletePluginMappingByKnowledgeBaseId(entity.getId());
            log.info("插件映射记录删除完成");
            int deleteCount = knowledgeBaseDao.deleteById(entity.getId());
            log.info("本地数据库删除结果: {}", deleteCount > 0 ? "成功" : "失败");
        }
        log.info("=== 通过datasetId删除操作结束 ===");
    }
    @Override
    public Map<String, Object> getRAGConfig(String ragModelId) {
        if (StringUtils.isBlank(ragModelId)) {
            throw new RenException(ErrorCode.PARAMS_GET_ERROR);
        }
        // 从缓存获取模型配置
        ModelConfigEntity modelConfig = modelConfigService.getModelByIdFromCache(ragModelId);
        if (modelConfig == null || modelConfig.getConfigJson() == null) {
            throw new RenException(ErrorCode.RAG_CONFIG_NOT_FOUND);
        }
        // 验证是否为RAG类型配置
        if (!Constant.RAG_CONFIG_TYPE.equals(modelConfig.getModelType().toUpperCase())) {
            throw new RenException(ErrorCode.RAG_CONFIG_TYPE_ERROR);
        }
        Map<String, Object> config = modelConfig.getConfigJson();
        // 验证必要的配置参数
        validateRagConfig(config);
        // 返回配置信息
        return config;
    }
    @Override
    public Map<String, Object> getRAGConfigByDatasetId(String datasetId) {
        if (StringUtils.isBlank(datasetId)) {
            throw new RenException(ErrorCode.RAG_DATASET_ID_NOT_NULL);
        }
        // 根据datasetId查询知识库信息
        KnowledgeBaseDTO knowledgeBase = getByDatasetId(datasetId);
        if (knowledgeBase == null) {
            log.warn("未找到datasetId为{}的知识库", datasetId);
            throw new RenException(ErrorCode.Knowledge_Base_RECORD_NOT_EXISTS);
        }
        // 如果知识库指定了ragModelId，使用该配置
        String ragModelId = knowledgeBase.getRagModelId();
        if (StringUtils.isBlank(ragModelId)) {
            log.warn("知识库datasetId为{}未配置ragModelId", datasetId);
            throw new RenException(ErrorCode.RAG_CONFIG_NOT_FOUND);
        }
        // 获取并返回RAG配置
        return getRAGConfig(ragModelId);
    }
    @Override
    public List<Map<String, Object>> getRAGModels() {
        // 查询RAG类型的模型配置
        QueryWrapper<ModelConfigEntity> queryWrapper = new QueryWrapper<>();
        queryWrapper.eq("model_type", Constant.RAG_CONFIG_TYPE)
                .eq("is_enabled", 1)
                .orderByDesc("is_default")
                .orderByDesc("create_date");
        List<ModelConfigEntity> modelConfigs = modelConfigDao.selectList(queryWrapper);
        List<Map<String, Object>> modelList = new ArrayList<>();
        for (ModelConfigEntity modelConfig : modelConfigs) {
            Map<String, Object> modelInfo = new HashMap<>();
            modelInfo.put("id", modelConfig.getId());
            modelInfo.put("modelName", modelConfig.getModelName());
            modelList.add(modelInfo);
        }
        return modelList;
    }
    /**
     * 验证RAG配置中是否包含必要的参数
     */
    private void validateRagConfig(Map<String, Object> config) {
        if (config == null) {
            throw new RenException(ErrorCode.RAG_CONFIG_NOT_FOUND);
        }
        // 从配置中提取必要的参数
        String baseUrl = (String) config.get("base_url");
        String apiKey = (String) config.get("api_key");
        // 验证base_url是否存在且非空
        if (StringUtils.isBlank(baseUrl)) {
            throw new RenException(ErrorCode.RAG_API_ERROR_URL_NULL);
        }
        // 验证api_key是否存在且非空
        if (StringUtils.isBlank(apiKey)) {
            throw new RenException(ErrorCode.RAG_API_ERROR_API_KEY_NULL);
        }
        // 检查api_key是否包含占位符
        if (apiKey.contains("你")) {
            throw new RenException(ErrorCode.RAG_API_ERROR_API_KEY_INVALID);
        }
        // 验证base_url格式
        if (!baseUrl.startsWith("http://") && !baseUrl.startsWith("https://")) {
            throw new RenException(ErrorCode.RAG_API_ERROR_URL_INVALID);
        }
    }
    /**
     * 从RAG配置中提取适配器类型
     * 
     * @param config RAG配置
     * @return 适配器类型
     */
    private String extractAdapterType(Map<String, Object> config) {
        if (config == null) {
            throw new RenException(ErrorCode.RAG_CONFIG_NOT_FOUND);
        }
        // 从配置中提取适配器类型
        String adapterType = (String) config.get("type");
        // 验证适配器类型是否存在且非空
        if (StringUtils.isBlank(adapterType)) {
            throw new RenException(ErrorCode.RAG_ADAPTER_TYPE_NOT_FOUND);
        }
        // 验证适配器类型是否已注册
        if (!KnowledgeBaseAdapterFactory.isAdapterTypeRegistered(adapterType)) {
            throw new RenException(ErrorCode.RAG_ADAPTER_TYPE_NOT_SUPPORTED,
                    "不支持的适配器类型: " + adapterType);
        }
        return adapterType;
    }
    /**
     * 使用适配器创建数据集
     */
    private String createDatasetInRAG(String name, String description, Map<String, Object> ragConfig) {
        log.info("开始使用适配器创建数据集, name: {}", name);
        try {
            // 从RAG配置中提取适配器类型
            String adapterType = extractAdapterType(ragConfig);
            // 使用适配器工厂获取适配器实例
            KnowledgeBaseAdapter adapter = KnowledgeBaseAdapterFactory.getAdapter(adapterType, ragConfig);
            // 构建数据集创建参数
            Map<String, Object> createParams = new HashMap<>();
            String username = SecurityUser.getUser().getUsername();
            createParams.put("name", username + "_" + name);
            if (StringUtils.isNotBlank(description)) {
                createParams.put("description", description);
            }
            // 调用适配器的创建数据集方法
            String datasetId = adapter.createDataset(createParams);
            log.info("数据集创建成功，datasetId: {}", datasetId);
            return datasetId;
        } catch (Exception e) {
            // 直接传递底层适配器的详细错误信息
            log.error("创建数据集失败", e);
            if (e instanceof RenException) {
                throw (RenException) e;
            }
            throw new RenException(ErrorCode.RAG_API_ERROR, e.getMessage());
        }
    }
    /**
     * 使用适配器更新数据集
     */
    private void updateDatasetInRAG(String datasetId, String name, String description,
            Map<String, Object> ragConfig) {
        log.info("开始使用适配器更新数据集，datasetId: {}, name: {}", datasetId, name);
        try {
            // 从RAG配置中提取适配器类型
            String adapterType = extractAdapterType(ragConfig);
            // 使用适配器工厂获取适配器实例
            KnowledgeBaseAdapter adapter = KnowledgeBaseAdapterFactory.getAdapter(adapterType, ragConfig);
            // 构建数据集更新参数
            Map<String, Object> updateParams = new HashMap<>();
            String username = SecurityUser.getUser().getUsername();
            updateParams.put("name", username + "_" + name);
            if (StringUtils.isNotBlank(description)) {
                updateParams.put("description", description);
            }
            // 调用适配器的更新数据集方法
            adapter.updateDataset(datasetId, updateParams);
            log.info("数据集更新成功，datasetId: {}", datasetId);
        } catch (Exception e) {
            // 直接传递底层适配器的详细错误信息
            log.error("更新数据集失败", e);
            if (e instanceof RenException) {
                throw (RenException) e;
            }
            throw new RenException(ErrorCode.RAG_API_ERROR, e.getMessage());
        }
    }
    /**
     * 使用适配器删除数据集
     */
    private void deleteDatasetInRAG(String datasetId, Map<String, Object> ragConfig) {
        log.info("开始使用适配器删除数据集，datasetId: {}", datasetId);
        try {
            // 从RAG配置中提取适配器类型
            String adapterType = extractAdapterType(ragConfig);
            // 使用适配器工厂获取适配器实例
            KnowledgeBaseAdapter adapter = KnowledgeBaseAdapterFactory.getAdapter(adapterType, ragConfig);
            // 调用适配器的删除数据集方法
            adapter.deleteDataset(datasetId);
            log.info("数据集删除成功，datasetId: {}", datasetId);
        } catch (Exception e) {
            // 直接传递底层适配器的详细错误信息
            log.error("删除数据集失败", e);
            if (e instanceof RenException) {
                throw (RenException) e;
            }
            throw new RenException(ErrorCode.RAG_API_ERROR, e.getMessage());
        }
    }
    /**
     * 获取RAG配置并验证
     */
    private Map<String, Object> getValidatedRAGConfig(String ragModelId) {
        if (StringUtils.isBlank(ragModelId)) {
            throw new RenException(ErrorCode.RAG_MODEL_ID_NOT_NULL);
        }
        Map<String, Object> ragConfig = getRAGConfig(ragModelId);
        // 验证RAG配置参数
        validateRagConfig(ragConfig);
        return ragConfig;
    }
    /**
     * 检查是否存在同名知识库
     * 
     * @param knowledgeBaseDTO 知识库DTO
     * @param excludeId        排除的ID（更新时使用）
     */
    private void checkDuplicateKnowledgeBaseName(KnowledgeBaseDTO knowledgeBaseDTO, String excludeId) {
        if (StringUtils.isNotBlank(knowledgeBaseDTO.getName())) {
            Long currentUserId = SecurityUser.getUserId();
            QueryWrapper<KnowledgeBaseEntity> queryWrapper = new QueryWrapper<KnowledgeBaseEntity>()
                    .eq("name", knowledgeBaseDTO.getName())
                    .eq("creator", currentUserId);
            // 如果提供了排除ID，则排除该记录
            if (StringUtils.isNotBlank(excludeId)) {
                queryWrapper.ne("id", excludeId);
            }
            long count = knowledgeBaseDao.selectCount(queryWrapper);
            if (count > 0) {
                throw new RenException(ErrorCode.KNOWLEDGE_BASE_NAME_EXISTS,
                        MessageUtils.getMessage(ErrorCode.KNOWLEDGE_BASE_NAME_EXISTS));
            }
        }
    }
    /**
     * 从适配器获取知识库的文档数量
     */
    private Integer getDocumentCountFromRAG(String datasetId, String ragModelId) {
        if (StringUtils.isBlank(datasetId) || StringUtils.isBlank(ragModelId)) {
            log.warn("datasetId或ragModelId为空，无法获取文档数量");
            return 0;
        }
        log.info("开始获取知识库 {} 的文档数量", datasetId);
        try {
            // 获取RAG配置
            Map<String, Object> ragConfig = getValidatedRAGConfig(ragModelId);
            // 从RAG配置中提取适配器类型
            String adapterType = extractAdapterType(ragConfig);
            // 使用适配器工厂获取适配器实例
            KnowledgeBaseAdapter adapter = KnowledgeBaseAdapterFactory.getAdapter(adapterType, ragConfig);
            // 调用适配器的获取文档数量方法
            Integer documentCount = adapter.getDocumentCount(datasetId);
            log.info("获取知识库 {} 的文档数量成功: {}", datasetId, documentCount);
            return documentCount;
        } catch (Exception e) {
            // 构建详细的错误信息，包含异常类型和消息
            String baseErrorMessage = e.getClass().getSimpleName() + " - 获取知识库文档数量失败";
            String errorMessage = baseErrorMessage + (e.getMessage() != null ? ": " + e.getMessage() : "");
            log.error(errorMessage, e);
            return 0;
        }
    }
 }
@@ -13,9 +13,9 @@ public class ModelConfigBodyDTO {
    @Serial
    private static final long serialVersionUID = 1L;
-    // @Schema(description = "模型类型(Memory/ASR/VAD/LLM/TTS)")
+    @Schema(description = "模型ID,未填写将自动生成")
-    // private String modelType;
+    private String id;
-    //
+
    @Schema(description = "模型编码(如AliLLM、DoubaoTTS)")
    private String modelCode;
@@ -19,4 +19,15 @@ public class VoiceDTO implements Serializable {
    @Schema(description = "音色名称")
    private String name;
    @Schema(description = "音频播放地址")
    private String voiceDemo;
    // 添加双参数构造函数，保持向后兼容
    public VoiceDTO(String id, String name) {
        this.id = id;
        this.name = name;
        this.voiceDemo = null;
    }
 }
@@ -3,9 +3,7 @@ package xiaozhi.modules.model.entity;
 import java.util.Date;
 import com.baomidou.mybatisplus.annotation.FieldFill;
 import com.baomidou.mybatisplus.annotation.IdType;
 import com.baomidou.mybatisplus.annotation.TableField;
 import com.baomidou.mybatisplus.annotation.TableId;
 import com.baomidou.mybatisplus.annotation.TableName;
 import com.baomidou.mybatisplus.extension.handlers.JacksonTypeHandler;
@@ -18,7 +16,6 @@ import lombok.Data;
@Schema(description = "模型配置表")
 public class ModelConfigEntity {
    @TableId(type = IdType.ASSIGN_UUID)
    @Schema(description = "主键")
    private String id;
@@ -11,6 +11,7 @@ import org.springframework.stereotype.Service;
 import com.baomidou.mybatisplus.core.conditions.query.LambdaQueryWrapper;
 import com.baomidou.mybatisplus.core.conditions.query.QueryWrapper;
 import com.baomidou.mybatisplus.core.incrementer.DefaultIdentifierGenerator;
 import com.baomidou.mybatisplus.core.metadata.IPage;
 import com.baomidou.mybatisplus.core.metadata.OrderItem;
 import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
@@ -252,6 +253,12 @@ public class ModelConfigServiceImpl extends BaseServiceImpl<ModelConfigDao, Mode
        if (modelConfigBodyDTO == null) {
            throw new RenException(ErrorCode.PARAMS_GET_ERROR);
        }
        if (StringUtils.isBlank(modelConfigBodyDTO.getId())) {
            // 参照 MP @TableId AutoUUID 策略使用
            // com.baomidou.mybatisplus.core.incrementer.DefaultIdentifierGenerator(UUID.replace("-",""))
            // 进行分配默认模型ID
            modelConfigBodyDTO.setId(DefaultIdentifierGenerator.getInstance().nextUUID(ModelConfigEntity.class));
        }
    }
    /**
@@ -22,6 +22,8 @@ import xiaozhi.common.page.PageData;
 import xiaozhi.common.service.impl.BaseServiceImpl;
 import xiaozhi.common.user.UserDetail;
 import xiaozhi.common.utils.ConvertUtils;
 import xiaozhi.modules.knowledge.dao.KnowledgeBaseDao;
 import xiaozhi.modules.knowledge.entity.KnowledgeBaseEntity;
 import xiaozhi.modules.model.dao.ModelProviderDao;
 import xiaozhi.modules.model.dto.ModelProviderDTO;
 import xiaozhi.modules.model.entity.ModelProviderEntity;
@@ -34,13 +36,43 @@ public class ModelProviderServiceImpl extends BaseServiceImpl<ModelProviderDao,
        implements ModelProviderService {
    private final ModelProviderDao modelProviderDao;
    private final KnowledgeBaseDao knowledgeBaseDao;
    @Override
    public List<ModelProviderDTO> getPluginList() {
        // 1. 获取插件列表
        LambdaQueryWrapper<ModelProviderEntity> queryWrapper = new LambdaQueryWrapper<>();
        queryWrapper.eq(ModelProviderEntity::getModelType, "Plugin");
        List<ModelProviderEntity> providerEntities = modelProviderDao.selectList(queryWrapper);
-        return ConvertUtils.sourceToTarget(providerEntities, ModelProviderDTO.class);
+        List<ModelProviderDTO> resultList = ConvertUtils.sourceToTarget(providerEntities, ModelProviderDTO.class);
        // 2. 获取当前用户的知识库列表并追加到结果中
        UserDetail userDetail = SecurityUser.getUser();
        if (userDetail != null && userDetail.getId() != null) {
            // 查询当前用户的知识库
            LambdaQueryWrapper<KnowledgeBaseEntity> kbQueryWrapper = new LambdaQueryWrapper<>();
            kbQueryWrapper.eq(KnowledgeBaseEntity::getCreator, userDetail.getId());
            kbQueryWrapper.eq(KnowledgeBaseEntity::getStatus, 1); // 只获取启用状态的知识库
            List<KnowledgeBaseEntity> knowledgeBases = knowledgeBaseDao.selectList(kbQueryWrapper);
            // 将知识库转换为ModelProviderDTO格式并添加到结果列表
            for (KnowledgeBaseEntity kb : knowledgeBases) {
                ModelProviderDTO dto = new ModelProviderDTO();
                dto.setId(kb.getId());
                dto.setModelType("Rag");
                dto.setName("[知识库]" + kb.getName());
                dto.setProviderCode("ragflow"); // 假设所有RAG都使用ragflow
                dto.setFields("[]");
                dto.setSort(0);
                dto.setCreateDate(kb.getCreatedAt());
                dto.setUpdateDate(kb.getUpdatedAt());
                dto.setCreator(0L);
                dto.setUpdater(0L);
                resultList.add(dto);
            }
        }
        return resultList;
    }
    @Override
@@ -100,7 +100,7 @@ public class WebMvcConfig implements WebMvcConfigurer {
        converter.setObjectMapper(mapper);
        return converter;
    }
-    
+
    /**
     * 国际化配置 - 根据请求头中的Accept-Language设置语言环境
     */
@@ -113,14 +113,14 @@ public class WebMvcConfig implements WebMvcConfigurer {
                if (acceptLanguage == null || acceptLanguage.isEmpty()) {
                    return Locale.getDefault();
                }
-                
+
                // 解析Accept-Language请求头中的首选语言
                String[] languages = acceptLanguage.split(",");
                if (languages.length > 0) {
                    // 提取第一个语言代码，去除可能的质量值(q=...)
                    String[] parts = languages[0].split(";" + "\\s*");
                    String primaryLanguage = parts[0].trim();
-                     
+
                    // 根据前端发送的语言代码直接创建Locale对象
                    if (primaryLanguage.equals("zh-CN")) {
                        return Locale.SIMPLIFIED_CHINESE;
@@ -128,15 +128,25 @@ public class WebMvcConfig implements WebMvcConfigurer {
                        return Locale.TRADITIONAL_CHINESE;
                    } else if (primaryLanguage.equals("en-US")) {
                        return Locale.US;
                    } else if (primaryLanguage.equals("de-DE")) {
                        return Locale.GERMANY;
                    } else if (primaryLanguage.equals("vi-VN")) {
                        return Locale.forLanguageTag("vi-VN");
                    } else if (primaryLanguage.startsWith("zh")) {
                        // 对于其他中文变体，默认使用简体中文
                        return Locale.SIMPLIFIED_CHINESE;
                    } else if (primaryLanguage.startsWith("en")) {
                        // 对于其他英文变体，默认使用美式英语
                        return Locale.US;
                    } else if (primaryLanguage.startsWith("de")) {
                        // 对于其他德语变体，默认使用德语
                        return Locale.GERMANY;
                    } else if (primaryLanguage.startsWith("vi")) {
                        // 对于其他越南语变体，默认使用越南语
                        return Locale.forLanguageTag("vi-VN");
                    }
                }
-                
+
                // 如果没有匹配的语言，使用默认语言
                return Locale.getDefault();
            }
@@ -6,6 +6,7 @@ import java.util.HashMap;
 import java.util.List;
 import java.util.Map;
 import org.apache.commons.lang3.StringUtils;
 import org.springframework.web.bind.annotation.GetMapping;
 import org.springframework.web.bind.annotation.PostMapping;
 import org.springframework.web.bind.annotation.PutMapping;
@@ -23,7 +24,9 @@ import xiaozhi.common.exception.ErrorCode;
 import xiaozhi.common.exception.RenException;
 import xiaozhi.common.page.TokenDTO;
 import xiaozhi.common.user.UserDetail;
 import xiaozhi.common.utils.JsonUtils;
 import xiaozhi.common.utils.Result;
 import xiaozhi.common.utils.Sm2DecryptUtil;
 import xiaozhi.common.validator.AssertUtils;
 import xiaozhi.common.validator.ValidatorUtils;
 import xiaozhi.modules.security.dto.LoginDTO;
@@ -32,8 +35,6 @@ import xiaozhi.modules.security.password.PasswordUtils;
 import xiaozhi.modules.security.service.CaptchaService;
 import xiaozhi.modules.security.service.SysUserTokenService;
 import xiaozhi.modules.security.user.SecurityUser;
 import xiaozhi.common.utils.Sm2DecryptUtil;
 import org.apache.commons.lang3.StringUtils;
 import xiaozhi.modules.sys.dto.PasswordDTO;
 import xiaozhi.modules.sys.dto.RetrievePasswordDTO;
 import xiaozhi.modules.sys.dto.SysUserDTO;
@@ -89,13 +90,13 @@ public class LoginController {
    @Operation(summary = "登录")
    public Result<TokenDTO> login(@RequestBody LoginDTO login) {
        String password = login.getPassword();
-        
+
        // 使用工具类解密并验证验证码
        String actualPassword = Sm2DecryptUtil.decryptAndValidateCaptcha(
                password, login.getCaptchaId(), captchaService, sysParamsService);
-        
+
        login.setPassword(actualPassword);
-        
+
        // 按照用户名获取用户
        SysUserDTO userDTO = sysUserService.getByUsername(login.getUsername());
        // 判断用户是否存在
@@ -108,8 +109,6 @@ public class LoginController {
        }
        return sysUserTokenService.createToken(userDTO.getId());
    }
    @PostMapping("/register")
    @Operation(summary = "注册")
@@ -117,15 +116,15 @@ public class LoginController {
        if (!sysUserService.getAllowUserRegister()) {
            throw new RenException(ErrorCode.USER_REGISTER_DISABLED);
        }
-        
+
        String password = login.getPassword();
-        
+
        // 使用工具类解密并验证验证码
        String actualPassword = Sm2DecryptUtil.decryptAndValidateCaptcha(
                password, login.getCaptchaId(), captchaService, sysParamsService);
-        
+
        login.setPassword(actualPassword);
-        
+
        // 是否开启手机注册
        Boolean isMobileRegister = sysParamsService
                .getValueObject(Constant.SysMSMParam.SERVER_ENABLE_MOBILE_REGISTER.getValue(), Boolean.class);
@@ -204,11 +203,11 @@ public class LoginController {
        }
        String password = dto.getPassword();
-        
+
        // 使用工具类解密并验证验证码
        String actualPassword = Sm2DecryptUtil.decryptAndValidateCaptcha(
                password, dto.getCaptchaId(), captchaService, sysParamsService);
-        
+
        dto.setPassword(actualPassword);
        sysUserService.changePasswordDirectly(userDTO.getId(), dto.getPassword());
@@ -229,7 +228,7 @@ public class LoginController {
        config.put("beianIcpNum", sysParamsService.getValue(Constant.SysBaseParam.BEIAN_ICP_NUM.getValue(), true));
        config.put("beianGaNum", sysParamsService.getValue(Constant.SysBaseParam.BEIAN_GA_NUM.getValue(), true));
        config.put("name", sysParamsService.getValue(Constant.SysBaseParam.SERVER_NAME.getValue(), true));
-        
+
        // SM2公钥
        String publicKey = sysParamsService.getValue(Constant.SM2_PUBLIC_KEY, true);
        if (StringUtils.isBlank(publicKey)) {
@@ -237,6 +236,12 @@ public class LoginController {
        }
        config.put("sm2PublicKey", publicKey);
        // 获取system-web.menu参数配置
        String menuConfig = sysParamsService.getValue("system-web.menu", true);
        if (StringUtils.isNotBlank(menuConfig)) {
            config.put("systemWebMenu", JsonUtils.parseObject(menuConfig, Object.class));
        }
        return new Result<Map<String, Object>>().ok(config);
    }
 }
@@ -174,7 +174,7 @@ public class SysParamsController {
            return;
        }
        if (StringUtils.isBlank(url) || url.equals("null")) {
-            throw new RenException(ErrorCode.OTA_URL_EMPTY);
+            return;
        }
        // 检查是否包含localhost或127.0.0.1
@@ -211,7 +211,7 @@ public class SysParamsController {
            return;
        }
        if (StringUtils.isBlank(url) || url.equals("null")) {
-            throw new RenException(ErrorCode.MCP_URL_EMPTY);
+            return;
        }
        if (url.contains("localhost") || url.contains("127.0.0.1")) {
            throw new RenException(ErrorCode.MCP_URL_LOCALHOST);
@@ -242,7 +242,7 @@ public class SysParamsController {
            return;
        }
        if (StringUtils.isBlank(url) || url.equals("null")) {
-            throw new RenException(ErrorCode.VOICEPRINT_URL_EMPTY);
+            return;
        }
        if (url.contains("localhost") || url.contains("127.0.0.1")) {
            throw new RenException(ErrorCode.VOICEPRINT_URL_LOCALHOST);
@@ -133,7 +133,11 @@ public class TimbreServiceImpl extends BaseServiceImpl<TimbreDao, TimbreEntity>
            timbreEntities = new ArrayList<>();
        }
        List<VoiceDTO> voiceDTOs = timbreEntities.stream()
-                .map(entity -> new VoiceDTO(entity.getId(), entity.getName()))
+                .map(entity -> {
                    VoiceDTO dto = new VoiceDTO(entity.getId(), entity.getName());
                    dto.setVoiceDemo(entity.getVoiceDemo());
                    return dto;
                })
                .collect(Collectors.toList());
        // 获取当前登录用户ID
@@ -146,6 +150,8 @@ public class TimbreServiceImpl extends BaseServiceImpl<TimbreDao, TimbreEntity>
                VoiceDTO voiceDTO = new VoiceDTO();
                voiceDTO.setId(entity.getId());
                voiceDTO.setName(MessageUtils.getMessage(ErrorCode.VOICE_CLONE_PREFIX) + entity.getName());
                // 保留从数据库查询到的voiceDemo字段
                voiceDTO.setVoiceDemo(entity.getVoiceDemo());
                redisUtils.set(RedisKeys.getTimbreNameById(voiceDTO.getId()), voiceDTO.getName(),
                        RedisUtils.NOT_EXPIRE);
                voiceDTOs.add(0, voiceDTO);
@@ -205,6 +211,9 @@ public class TimbreServiceImpl extends BaseServiceImpl<TimbreDao, TimbreEntity>
        if (list.isEmpty()) {
            return null;
        }
-        return new VoiceDTO(list.get(0).getId(), list.get(0).getName());
+        TimbreEntity entity = list.get(0);
        VoiceDTO dto = new VoiceDTO(entity.getId(), entity.getName());
        dto.setVoiceDemo(entity.getVoiceDemo());
        return dto;
    }
 }
@@ -107,10 +107,10 @@ public class VoiceCloneController {
            String name = params.get("name");
            if (id == null || id.isEmpty()) {
-                return new Result<String>().error(ErrorCode.IDENTIFIER_NOT_NULL, "唯一标识不能为空");
+                return new Result<String>().error(ErrorCode.IDENTIFIER_NOT_NULL);
            }
-            if (name == null) {
+            if (name == null || name.isEmpty()) {
-                return new Result<String>().error(ErrorCode.NOT_NULL, "名称不能为空");
+                return new Result<String>().error(ErrorCode.VOICE_CLONE_NAME_NOT_NULL);
            }
            // 检查权限
            checkPermission(id);
@@ -119,7 +119,7 @@ public class VoiceCloneController {
            redisUtils.delete(RedisKeys.getTimbreNameById(id));
            return new Result<String>();
        } catch (Exception e) {
-            return new Result<String>().error(ErrorCode.UPDATE_DATA_FAILED, "更新失败: " + e.getMessage());
+            return new Result<String>().error(ErrorCode.UPDATE_DATA_FAILED, e.getMessage());
        }
    }
@@ -131,7 +131,7 @@ public class VoiceCloneController {
        checkPermission(id);
        byte[] audioData = voiceCloneService.getVoiceData(id);
        if (audioData == null) {
-            return new Result<String>().error(ErrorCode.RESOURCE_NOT_FOUND, "音频不存在");
+            return new Result<String>().error(ErrorCode.VOICE_CLONE_AUDIO_NOT_FOUND);
        }
        String uuid = UUID.randomUUID().toString();
        redisUtils.set(RedisKeys.getVoiceCloneAudioIdKey(uuid), id);
@@ -100,7 +100,7 @@ public class VoiceCloneServiceImpl extends BaseServiceImpl<VoiceCloneDao, VoiceC
            wrapper.eq("model_id", dto.getModelId());
            Long count = baseDao.selectCount(wrapper);
            if (count > 0) {
-                throw new RenException(ErrorCode.VOICE_ID_ALREADY_EXISTS, "音色ID " + voiceId + " 已存在");
+                throw new RenException(ErrorCode.VOICE_ID_ALREADY_EXISTS);
            }
        }
@@ -164,6 +164,9 @@ public class VoiceCloneServiceImpl extends BaseServiceImpl<VoiceCloneDao, VoiceC
        if (entity.getUserId() != null) {
            dto.setUserName(sysUserService.getByUserId(entity.getUserId()).getUsername());
        }
        // 确保trainStatus字段被正确设置，前端需要这个字段来判断是否为克隆音频
        dto.setTrainStatus(entity.getTrainStatus());
        return dto;
    }
@@ -197,6 +200,9 @@ public class VoiceCloneServiceImpl extends BaseServiceImpl<VoiceCloneDao, VoiceC
            if (entity.getUserId() != null) {
                dto.setUserName(sysUserService.getByUserId(entity.getUserId()).getUsername());
            }
            // 确保trainStatus字段被正确设置，前端需要这个字段来判断是否为克隆音频
            dto.setTrainStatus(entity.getTrainStatus());
            // 设置是否有音频数据
            dto.setHasVoice(entity.getVoice() != null);
@@ -0,0 +1,24 @@
 -- 添加RAG模型供应器和配置
 -- -------------------------------------------------------
 -- 添加RAG模型供应器
 delete from `ai_model_provider` where id = 'SYSTEM_RAG_ragflow';
 INSERT INTO `ai_model_provider` (`id`, `model_type`, `provider_code`, `name`, `fields`, `sort`, `creator`, `create_date`, `updater`, `update_date`) VALUES
 ('SYSTEM_RAG_ragflow', 'RAG', 'ragflow', 'RAGFlow', '[{"key": "base_url", "type": "string", "label": "服务地址"}, {"key": "api_key", "type": "string", "label": "API密钥"}]', 1, 1, NOW(), 1, NOW());
 -- 添加RAG模型配置
 delete from `ai_model_config` where id = 'RAG_RAGFlow';
 INSERT INTO `ai_model_config` VALUES ('RAG_RAGFlow', 'RAG', 'ragflow', 'RAGFlow', 1, 1, '{"type": "ragflow", "base_url": "http://localhost", "api_key": "你的RAG密钥"}', 'https://github.com/infiniflow/ragflow/blob/main/README_zh.md', 'RAGFlow配置说明：
 一、快速部署教程（docker部署）
 1.$ sysctl vm.max_map_count
 2.$ sysctl -w vm.max_map_count=262144
 3.$ git clone https://github.com/infiniflow/ragflow.git
 4.docker compose -f docker-compose.yml up -d
 5.$ docker logs -f docker-ragflow-cpu-1
 6.注冊登录后，点击右上角头像，获得RAGFlow的API KEY和API服务器地址。使用RAGFlow前请在Model Provider中添加模型和设置默认模型。
 二、如果您希望关掉注册功能
 1.停止服务   docker compose down
 2. sed -i ''s/REGISTER_ENABLED=1/REGISTER_ENABLED=0/g'' .env   
 3.cat .env | grep -i register
 4.看到REGISTER_ENABLED=0 重启服务即可。',  1, NULL, NULL, NULL, NULL);
@@ -0,0 +1,19 @@
 -- 知识库表
 DROP TABLE IF EXISTS `ai_rag_dataset`;
 CREATE TABLE `ai_rag_dataset` (
    `id` VARCHAR(32) NOT NULL COMMENT '唯一标识',
    `dataset_id` VARCHAR(64) NOT NULL COMMENT '知识库ID',
    `rag_model_id` VARCHAR(64) COMMENT 'RAG模型配置ID',
    `name` VARCHAR(100) NOT NULL COMMENT '知识库名称',
    `description` TEXT COMMENT '知识库描述',
    `status` TINYINT(1) DEFAULT 1 COMMENT '状态：0停用 1启用',
    `creator` BIGINT COMMENT '创建者',
    `created_at` DATETIME COMMENT '创建时间',
    `updater` BIGINT COMMENT '更新者',
    `updated_at` DATETIME COMMENT '更新时间',
    PRIMARY KEY (`id`),
    UNIQUE KEY `uk_dataset_id` (`dataset_id`),
    INDEX `idx_ai_rag_dataset_status` (`status`),
    INDEX `idx_ai_rag_dataset_creator` (`creator`),
    INDEX `idx_ai_rag_dataset_created_at` (`created_at`)
 ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='知识库表';
@@ -0,0 +1,62 @@
 UPDATE `ai_model_config` SET 
 `doc_link` = 'https://github.com/infiniflow/ragflow/blob/main/README_zh.md',
 `remark` = '详细部署教程参考：https://github.com/xinnan-tech/xiaozhi-esp32-server/blob/main/docs/ragflow-integration.md
 部署成功，注冊登录后，点击右上角头像，获得RAGFlow的API KEY和API服务器地址。使用RAGFlow前请在Model Provider中添加模型和设置默认模型。' WHERE `id` = 'RAG_RAGFlow';
 update `ai_model_config` set `model_name` = '外挂的大模型意图识别' where `id` = 'Intent_intent_llm';
 update `ai_model_config` set `model_name` = '大模型自主函数调用' where `id` = 'Intent_function_call';
 update `ai_model_config` set `model_name` = '百炼智能体应用' where `id` = 'LLM_AliAppLLM';
 update `ai_model_provider` set `name` = '外挂的大模型意图识别' , `fields` =  '[{"key":"llm","label":"引用的LLM模型","type":"string"}]' where  id = 'SYSTEM_Intent_intent_llm';
 update `ai_model_provider` set `name` = '大模型自主函数调用' where  id = 'SYSTEM_Intent_function_call';
 UPDATE ai_model_config set model_name = 'Linkerai(流式)' where id = 'TTS_LinkeraiTTS';
 UPDATE ai_model_config set model_name = '火山引擎(流式)' where id = 'TTS_HuoshanDoubleStreamTTS';
 UPDATE ai_model_config set model_name = '阿里百炼(流式)' where id = 'TTS_AliBLStreamTTS';
 UPDATE ai_model_config set model_name = '科大讯飞(流式)' where id = 'TTS_XunFeiStreamTTS';
 UPDATE ai_model_config set model_name = 'Minimax(流式)' where id = 'TTS_MinimaxStreamTTS';
 UPDATE ai_model_config set model_name = '阿里云(流式)' where id = 'TTS_AliyunStreamTTS';
 UPDATE ai_model_config set model_name = 'PaddleSpeech(流式)' where id = 'TTS_PaddleSpeechTTS';
 UPDATE ai_model_config set model_name = 'IndexTTS(流式)' where id = 'TTS_IndexStreamTTS';
 update ai_model_config SET sort = 2 where id = 'TTS_LinkeraiTTS';
 update ai_model_config SET sort = 3 where id = 'TTS_HuoshanDoubleStreamTTS';
 update ai_model_config SET sort = 4 where id = 'TTS_AliBLStreamTTS';
 update ai_model_config SET sort = 5 where id = 'TTS_XunFeiStreamTTS';
 update ai_model_config SET sort = 6 where id = 'TTS_MinimaxStreamTTS';
 update ai_model_config SET sort = 7 where id = 'TTS_AliyunStreamTTS';
 update ai_model_config SET sort = 8 where id = 'TTS_IndexStreamTTS';
 update ai_model_config SET sort = 9 where id = 'TTS_PaddleSpeechTTS';
 update ai_model_config SET sort = 10 where id = 'TTS_DoubaoTTS';
 update ai_model_config SET sort = 11 where id = 'TTS_TencentTTS';
 update ai_model_config SET sort = 12 where id = 'TTS_AliyunTTS';
 update ai_model_config SET sort = 13 where id = 'TTS_OpenAITTS';
 update ai_model_config SET sort = 14 where id = 'TTS_CosyVoiceSiliconflow';
 update ai_model_config SET sort = 15 where id = 'TTS_CozeCnTTS';
 update ai_model_config SET sort = 16 where id = 'TTS_FishSpeech';
 update ai_model_config SET sort = 17 where id = 'TTS_GPT_SOVITS_V3';
 update ai_model_config SET sort = 18 where id = 'TTS_GPT_SOVITS_V2';
 update ai_model_config SET sort = 19 where id = 'TTS_TTS302AI';
 update ai_model_config SET sort = 20 where id = 'TTS_GizwitsTTS';
 update ai_model_config SET sort = 21 where id = 'TTS_VolcesAiGatewayTTS';
 update ai_model_config SET sort = 22 where id = 'TTS_ACGNTTS';
 update ai_model_config SET sort = 23 where id = 'TTS_CustomTTS';
 UPDATE ai_model_config set model_name = '讯飞语音识别(流式)' where id = 'ASR_XunfeiStream';
 UPDATE ai_model_config set model_name = 'Qwen3Flash语音识别' where id = 'ASR_Qwen3Flash';
 update ai_model_config SET sort = 2 where id = 'ASR_FunASRServer';
 update ai_model_config SET sort = 3 where id = 'ASR_XunfeiStream';
 update ai_model_config SET sort = 4 where id = 'ASR_AliyunStreamASR';
 update ai_model_config SET sort = 5 where id = 'ASR_DoubaoStreamASR';
 update ai_model_config SET sort = 6 where id = 'ASR_TencentASR';
 update ai_model_config SET sort = 7 where id = 'ASR_BaiduASR';
 update ai_model_config SET sort = 8 where id = 'ASR_DoubaoASR';
 update ai_model_config SET sort = 9 where id = 'ASR_AliyunASR';
 update ai_model_config SET sort = 10 where id = 'ASR_SherpaASR';
 update ai_model_config SET sort = 11 where id = 'ASR_OpenaiASR';
 update ai_model_config SET sort = 12 where id = 'ASR_GroqASR';
 update ai_model_config SET sort = 13 where id = 'ASR_VoskASR';
 update ai_model_config SET sort = 14 where id = 'ASR_Qwen3Flash';
 UPDATE ai_model_config SET config_json='{\"type\": \"openai\", \"base_url\": \"https://ark.cn-beijing.volces.com/api/v3\", \"model_name\": \"doubao-1-5-pro-32k-250115\", \"api_key\": \"你的api_key\"}' where id = 'LLM_DoubaoLLM' AND config_json LIKE '%你的api_key"%';
@@ -0,0 +1,6 @@
 -- 添加系统功能菜单配置参数
 delete from `sys_params` where param_code = 'system-web.menu';
 -- 添加系统功能菜单配置参数
 INSERT INTO `sys_params` (id, param_code, param_value, value_type, param_type, remark) VALUES 
 (600, 'system-web.menu', '{"features":{"voiceprintRecognition":{"name":"feature.voiceprintRecognition.name","enabled":false,"description":"feature.voiceprintRecognition.description"},"voiceClone":{"name":"feature.voiceClone.name","enabled":false,"description":"feature.voiceClone.description"},"knowledgeBase":{"name":"feature.knowledgeBase.name","enabled":false,"description":"feature.knowledgeBase.description"},"mcpAccessPoint":{"name":"feature.mcpAccessPoint.name","enabled":false,"description":"feature.mcpAccessPoint.description"},"vad":{"name":"feature.vad.name","enabled":true,"description":"feature.vad.description"},"asr":{"name":"feature.asr.name","enabled":true,"description":"feature.asr.description"}},"groups":{"featureManagement":["voiceprintRecognition","voiceClone","knowledgeBase","mcpAccessPoint"],"voiceManagement":["vad","asr"]}}', 'json', 1, '系统功能菜单配置');
@@ -0,0 +1,14 @@
 -- liquibase formatted sql
 -- changeset xiaozhi:202512041515
 CREATE TABLE ai_agent_context_provider (
    id VARCHAR(32) NOT NULL COMMENT '主键',
    agent_id VARCHAR(32) NOT NULL COMMENT '智能体ID',
    context_providers JSON COMMENT '上下文源配置',
    creator BIGINT COMMENT '创建者',
    created_at DATETIME COMMENT '创建时间',
    updater BIGINT COMMENT '更新者',
    updated_at DATETIME COMMENT '更新时间',
    PRIMARY KEY (id),
    INDEX idx_agent_id (agent_id)
 ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='智能体上下文源配置表';
@@ -0,0 +1,6 @@
 -- 删除server模块是否开启token认证参数
 delete from `sys_params` where param_code = 'server.auth.enabled';
 -- 添加server模块是否开启token认证参数
 INSERT INTO `sys_params` (id, param_code, param_value, value_type, param_type, remark) VALUES 
 (122, 'server.auth.enabled', 'true', 'boolean', 1, 'server模块是否开启token认证');
@@ -402,3 +402,46 @@ databaseChangeLog:
        - sqlFile:
            encoding: utf8
            path: classpath:db/changelog/202510191042.sql
  - changeSet:
      id: 202510250956
      author: rainv123
      changes:
        - sqlFile:
            encoding: utf8
            path: classpath:db/changelog/202510250956.sql
  - changeSet:
      id: 202510251150
      author: rainv123
      changes:
        - sqlFile:
            encoding: utf8
            path: classpath:db/changelog/202510251150.sql
  - changeSet:
      id: 202511131023
      author: hrz
      changes:
        - sqlFile:
            encoding: utf8
            path: classpath:db/changelog/202511131023.sql
  - changeSet:
      id: 202512031517
      author: rainv123
      changes:
        - sqlFile:
            encoding: utf8
            path: classpath:db/changelog/202512031517.sql
  - changeSet:
      id: 202512041515
      author: cgd
      changes:
        - sqlFile:
            encoding: utf8
            path: classpath:db/changelog/202512041515.sql
  - changeSet:
      id: 202512131453
      author: hrz
      changes:
        - sqlFile:
            encoding: utf8
            path: classpath:db/changelog/202512131453.sql
@@ -160,10 +160,42 @@
 10151=\u8BF7\u5148\u4E0A\u4F20\u97F3\u9891\u6587\u4EF6
 10152=\u6A21\u578B\u914D\u7F6E\u672A\u627E\u5230
 10153=\u6A21\u578B\u7C7B\u578B\u672A\u627E\u5230
-10154=\u8BAD\u7EC3\u5931\u8D25
+10154=\u8BAD\u7EC3\u5931\u8D25: {0}
 10155=\u706B\u5C71\u5F15\u64CE\u7F3A\u5C11\u914D\u7F6E
 10156=\u54CD\u5E94\u683C\u5F0F\u9519\u8BEF\uFF0C\u7F3A\u5C11BaseResp\u5B57\u6BB5
 10157=\u8BF7\u6C42\u5931\u8D25
-10158=\u8BF7\u6C42\u5931\u8D25\uFF0C\u72B6\u6001\u7801{0}
+10158=\u514B\u9686\u97F3\u8272:
 10159=\u97F3\u8272ID\u5DF2\u5B58\u5728
-10160=\u706B\u5C71\u5F15\u64CE\u97F3\u8272ID\u683C\u5F0F\u9519\u8BEF\uFF0C\u5FC5\u987B\u4EE5S_\u5F00\u5934
+10160=\u706B\u5C71\u5F15\u64CE\u97F3\u8272ID\u683C\u5F0F\u9519\u8BEF\uFF0C\u5FC5\u987B\u4EE5S_\u5F00\u5934
 10161=Mac\u5730\u5740\u5DF2\u5B58\u5728
 10162=\u6A21\u578B\u4F9B\u5E94\u5668\u4E0D\u5B58\u5728
 10163=\u77E5\u8BC6\u5E93\u8BB0\u5F55\u4E0D\u5B58\u5728
 10164=RAG\u914D\u7F6E\u672A\u627E\u5230
 10165=RAG\u914D\u7F6E\u7C7B\u578B\u9519\u8BEF
 10166=\u9ED8\u8BA4RAG\u914D\u7F6E\u672A\u627E\u5230
 10167=RAG\u8C03\u7528\u5931\u8D25\uFF0C{0}
 10168=\u4E0A\u4F20\u6587\u4EF6\u5931\u8D25
 10169=\u60A8\u6CA1\u6709\u6743\u9650\u64CD\u4F5C\u8BE5\u8BB0\u5F55
 10170=\u77E5\u8BC6\u5E93\u540D\u79F0\u91CD\u590D
 10171=RAG\u914D\u7F6E\u4F53\u7684base_url\u4E0D\u80FD\u4E3A\u7A7A
 10172=RAG\u914D\u7F6E\u4F53\u7684api_key\u4E0D\u80FD\u4E3A\u7A7A
 10173=RAG\u914D\u7F6E\u4F53\u7684api_key\u4E0D\u80FD\u4E3A\u7A7A\uFF0C\u8BF7\u66F4\u6362\u4E3A\u5728\u53D6\u7684API\u53C2\u6570
 10174=RAG\u914D\u7F6E\u4F53\u7684base_url\u683C\u5F0F\u9519\u8BEF\uFF0C\u5FC5\u987B\u4EE5http\u6216https\u5F00\u5934
 10175=mac\u5730\u5740\u4E0D\u80FD\u4E3A\u7A7A
 10176=RAG\u914D\u7F6E\u4F53\u7684dataset_id\u4E0D\u80FD\u4E3A\u7A7A
 10177=RAG\u914D\u7F6E\u4F53\u7684model_id\u4E0D\u80FD\u4E3A\u7A7A
 10178=RAG\u914D\u7F6E\u4F53\u7684dataset_id\u548Cmodel_id\u4E0D\u80FD\u4E3A\u7A7A
 10179=\u6587\u4EF6\u540D\u79F0\u4E0D\u80FD\u4E3A\u7A7A
 10180=\u6587\u4EF6\u5185\u5BB9\u4E0D\u80FD\u4E3A\u7A7A
 10181=\u97F3\u8272\u514B\u9686\u540D\u79F0\u4E0D\u80FD\u4E3A\u7A7A
 10182=\u97F3\u8272\u514B\u9686\u97F3\u9891\u4E0D\u5B58\u5728
 10183=\u9ED8\u8BA4\u667A\u80FD\u4F53\u672A\u627E\u5230
 10184=\u4E0D\u652F\u6301\u7684\u9002\u914D\u5668\u7C7B\u578B
 10185=RAG\u914D\u7F6E\u9A8C\u8BC1\u5931\u8D25
 10186=\u9002\u914D\u5668\u521B\u5EFA\u5931\u8D25
 10187=\u9002\u914D\u5668\u521D\u59CB\u5316\u5931\u8D25
 10188=\u9002\u914D\u5668\u8FDE\u63A5\u6D4B\u8BD5\u5931\u8D25
 10189=\u9002\u914D\u5668\u64CD\u4F5C\u5931\u8D25
 10190=\u9002\u914D\u5668\u672A\u627E\u5230
 10191=\u9002\u914D\u5668\u7F13\u5B58\u9519\u8BEF
 10192=\u9002\u914D\u5668\u7C7B\u578B\u672A\u627E\u5230
@@ -0,0 +1,201 @@
 #Deutsch
 500=Server interne Ausnahme
 401=Nicht autorisiert
 403=Zugriff verweigert, keine Berechtigungen
 10001={0} darf nicht leer sein
 10002=Der Datensatz existiert bereits in der Datenbank
 10003=Parameter abrufen fehlgeschlagen
 10004=Die Kontonummer oder das Passwort ist falsch
 10005=Konto wurde deaktiviert
 10006=Eindeutige ID darf nicht leer sein
 10007=Der Bestätigungscode ist falsch
 10008=Zuerst Untermenü oder Schaltfläche löschen
 10009=Das ursprüngliche Passwort ist falsch
 10010=Das Konto oder Passwort ist falsch, Sie können es noch {0} Mal versuchen
 10011=Die übergeordnete Abteilung hat eine falsche Wahl getroffen
 10012=Oberes Menü kann nicht sich selbst sein
 10013=Datenberechtigungsschnittstelle, die nur ein Map-Typ-Parameter sein kann
 10014=Bitte löschen Sie zuerst die untergeordnete Abteilung
 10015=Bitte löschen Sie zuerst den Benutzer unter der Abteilung
 10016=Bereitstellung fehlgeschlagen, kein Prozess
 10017=Das ModellDiagramm ist falsch, bitte überprüfen
 10018=Export fehlgeschlagen, Modell-ID ist {0}
 10019=Bitte laden Sie eine Datei hoch
 10020=Token darf nicht leer sein
 10021=Token ist ungültig, bitte melden Sie sich erneut an
 10022=Das Konto wurde gesperrt
 10023=Bitte laden Sie Dateien im Format zip, bar, bpmn, bpmn20.xml hoch
 10024=Datei-Upload fehlgeschlagen {0}
 10025=SMS-Sendung fehlgeschlagen {0}
 10026=E-Mail-Vorlage existiert nicht
 10027=Redis-Dienstausnahme
 10028=Zeitgesteuerte Aufgabe fehlgeschlagen
 10029=Darf keine illegalen Zeichen enthalten
 10030=Das Passwort hat weniger als {0} Ziffern
 10031=Das Passwort muss gleichzeitig aus Zahlen, Groß- und Kleinbuchstaben sowie Sonderzeichen bestehen
 10032=Ausnahme beim Löschen dieser Daten
 10033=Gerätebestätigungscode Fehler
 10034=Parameterwert darf nicht leer sein
 10035=Parametertyp darf nicht leer sein
 10036=Nicht unterstützter Parametertyp
 10037=Parameterwert muss eine gültige Zahl sein
 10038=Parameterwert muss true oder false sein
 10039=Parameterwert muss ein gültiges JSON-Array-Format sein
 10040=Parameterwert muss ein gültiges JSON-Format sein
 10041=Gerät nicht gefunden
 10042={0}
 10043=Löschen der Daten fehlgeschlagen
 10044=Benutzer nicht angemeldet
 10045=WebSocket-Verbindung fehlgeschlagen oder Zeitüberschreitung
 10046=Stimmabdruck speichern fehlgeschlagen, bitte Administrator kontaktieren
 10047=Tägliches SendeLimit erreicht
 10048=Altes Passwort ist falsch
 10049=Das eingestellte LLM ist nicht openai oder ollama
 10050=Token-Generierung fehlgeschlagen
 10051=Ressource nicht gefunden
 10052=Standard-Agent nicht gefunden
 10053=Agent nicht gefunden
 10054=Stimmabdruck-Schnittstelle nicht konfiguriert, bitte konfigurieren Sie zuerst die Stimmabdruck-Schnittstellenadresse (server.voice_print) in der Parameterkonfiguration
 10055=SMS-Sendung fehlgeschlagen
 10056=SMS-Verbindung konnte nicht hergestellt werden
 10057=Stimmabdruck für Agent konnte nicht erstellt werden
 10058=Stimmabdruck für Agent konnte nicht aktualisiert werden
 10059=Stimmabdruck für Agent konnte nicht gelöscht werden
 10060=Sendung zu häufig, bitte versuchen Sie es nach {0} Sekunden erneut
 10061=Aktivierungscode darf nicht leer sein
 10062=Aktivierungscode Fehler
 10063=Gerät bereits aktiviert
 10064=Dieses Modell ist das Standardmodell, bitte setzen Sie zuerst ein anderes Modell als Standard
 10065=Hinzufügen der Daten fehlgeschlagen
 10066=Aktualisieren der Daten fehlgeschlagen
 10067=Grafischer Bestätigungscode Fehler
 10068=Mobilregistrierung nicht aktiviert, SMS-Bestätigungscode-Funktion kann nicht verwendet werden
 10069=Benutzername ist keine Handynummer, bitte erneut eingeben
 10070=Diese Handynummer wurde bereits registriert
 10071=Die eingegebene Handynummer ist nicht registriert
 10072=Normale Benutzerregistrierung derzeit nicht erlaubt
 10073=Mobilregistrierung nicht aktiviert, Passwort-Wiederherstellungsfunktion kann nicht verwendet werden
 10074=Das Format der eingegebenen Handynummer ist falsch
 10075=Der eingegebene SMS-Bestätigungscode ist falsch
 10076=Wörterbuchtyp existiert nicht
 10077=Wörterbuchtypcode ist dupliziert
 10078=Lesen der Ressource fehlgeschlagen
 10079=LLM-Modell und Absichtserkennung, Parameterauswahl stimmt nicht überein
 10080=Dieser Stimmabdruck gehört zu {0}, der bereits registriert ist, bitte wählen Sie eine andere Stimme
 10081=Fehler beim Löschen des Stimmabdrucks aufgetreten
 10082=Änderung nicht erlaubt, diese Stimme wurde bereits als Stimmabdruck registriert ({0})
 10083=Fehler beim Ändern des Stimmabdrucks, bitte Administrator kontaktieren
 10084=Stimmabdruck-Schnittstellenadresse Fehler, bitte gehen Sie zur Parameterverwaltung, um die Stimmabdruck-Schnittstellenadresse zu ändern
 10085=Audiodaten gehören nicht zu diesem Agent
 10086=Audiodaten sind leer, bitte überprüfen Sie hochgeladene Daten
 10087=Stimmabdruck-Registrierung fehlgeschlagen, Anfrage nicht erfolgreich
 10088=Stimmabdruck-Registrierung fehlgeschlagen, Anfrageverarbeitung fehlgeschlagen
 10089=Stimmabdruck-Stornierung fehlgeschlagen, Anfrage nicht erfolgreich
 10090=Stimmabdruck-Stornierung fehlgeschlagen, Anfrageverarbeitung fehlgeschlagen
 10091=Modellanbieter existiert nicht
 10092=Das konfigurierte LLM existiert nicht
 10093=Diese Modellkonfiguration wird von Agent {0} referenziert und kann nicht gelöscht werden
 10094=Dieses LLM-Modell wird von der Absichtserkennungskonfiguration referenziert und kann nicht gelöscht werden
 10095=Ungültige Serveroperation
 10096=Server WebSocket-Adresse nicht konfiguriert
 10097=Ziel-WebSocket-Adresse existiert nicht
 10098=WebSocket-Adressliste darf nicht leer sein
 10099=WebSocket-Adresse darf nicht localhost oder 127.0.0.1 verwenden
 10100=WebSocket-Adressformat ist falsch
 10101=WebSocket-Verbindungstest fehlgeschlagen
 10102=OTA-Adresse darf nicht leer sein
 10103=OTA-Adresse darf nicht localhost oder 127.0.0.1 verwenden
 10104=OTA-Adresse muss mit http oder https beginnen
 10105=OTA-Adresse muss mit /ota/ enden
 10106=OTA-Schnittstellenzugriff fehlgeschlagen
 10107=OTA-Schnittstelle Rückgabeinhaltformat ist falsch
 10108=OTA-Schnittstellenvalidierung fehlgeschlagen
 10109=MCP-Adresse darf nicht leer sein
 10110=MCP-Adresse darf nicht localhost oder 127.0.0.1 verwenden
 10111=Keine gültige MCP-Adresse
 10112=MCP-Schnittstellenzugriff fehlgeschlagen
 10113=MCP-Schnittstelle Rückgabeinhaltformat ist falsch
 10114=MCP-Schnittstellenvalidierung fehlgeschlagen
 10115=Stimmabdruck-Schnittstellenadresse darf nicht leer sein
 10116=Stimmabdruck-Schnittstellenadresse darf nicht localhost oder 127.0.0.1 verwenden
 10117=Keine gültige Stimmabdruck-Schnittstellenadresse
 10118=Stimmabdruck-Schnittstellenadresse muss mit http oder https beginnen
 10119=Stimmabdruck-Schnittstellenzugriff fehlgeschlagen
 10120=Stimmabdruck-Schnittstelle Rückgabeinhaltformat ist falsch
 10121=Stimmabdruck-Schnittstellenvalidierung fehlgeschlagen
 10122=MQTT-Geheimnis darf nicht leer sein
 10123=Ihr MQTT-Geheimnis ist nicht sicher, es muss mindestens 8 Zeichen lang sein und muss sowohl Groß- als auch Kleinbuchstaben enthalten
 10124=Ihr MQTT-Geheimnis ist nicht sicher, MQTT-Geheimnis muss sowohl Groß- als auch Kleinbuchstaben enthalten
 10125=Ihr MQTT-Geheimnis enthält schwaches Passwort
 10128=Wörterbuchlabel ist dupliziert
 10129=SM2-Schlüssel nicht konfiguriert
 10130=SM2-Entschlüsselung fehlgeschlagen
 10131=modelType und provideCode dürfen nicht leer sein
 10132=Keine Berechtigung, den Chat-Verlauf dieses Agents anzuzeigen
 10133=Sitzungs-ID darf nicht leer sein
 10134=Agent-ID darf nicht leer sein
 10135=Chat-Verlauf-Download fehlgeschlagen
 10136=Download-Link abgelaufen oder ungültig
 10137=Download-Link ungültig
 10138=Benutzer
 10139=Agent
 10140=Audio-Datei darf nicht leer sein
 10141=Nur Audio-Dateien werden unterstützt
 10142=Audio-Dateigröße darf 10MB nicht überschreiten
 10143=Upload fehlgeschlagen
 10144=Stimmenklon-Datensatz existiert nicht
 10145=Stimmressourceninformationen dürfen nicht leer sein
 10146=TTS-Plattformname darf nicht leer sein
 10147=Stimmen-ID darf nicht leer sein
 10148=Kontoinhaber darf nicht leer sein
 10149=Zu löschende Stimmressourcen-ID darf nicht leer sein
 10150=Sie haben keine Berechtigung, diesen Datensatz zu bearbeiten
 10151=Bitte laden Sie zuerst eine Audio-Datei hoch
 10152=Modellkonfiguration nicht gefunden
 10153=Modelltyp nicht gefunden
 10154=Training fehlgeschlagen: {0}
 10155=Huoshan Engine-Konfiguration fehlt
 10156=Antwortformat Fehler, BaseResp-Feld fehlt
 10157=Anfrage fehlgeschlagen
 10158=Stimme klonen:
 10159=Stimmen-ID existiert bereits
 10160=Huoshan Engine-Stimmen-ID-Formatfehler, muss mit S_ beginnen
 10161=Mac-Adresse existiert bereits
 10162=Modellanbieter existiert nicht
 10163=Wissensbasis-Datensatz existiert nicht
 10164=RAG-Konfiguration nicht gefunden
 10165=RAG-Konfigurationstyp Fehler
 10166=Standard-RAG-Konfiguration nicht gefunden
 10167=RAG-API-Aufruf fehlgeschlagen: {0}
 10168=Datei-Upload fehlgeschlagen
 10169=Keine Berechtigung, diese Wissensbasis zu bearbeiten
 10170=Wissensbasis-Name existiert bereits
 10171=RAG-Konfiguration base_url darf nicht leer sein
 10172=RAG-Konfiguration api_key darf nicht leer sein
 10173=RAG-Konfiguration api_key darf keinen Platzhalter enthalten, bitte ersetzen Sie mit tatsächlichem API-Schlüssel
 10174=RAG-Konfiguration base_url-Formatfehler, muss mit http oder https beginnen
 10175=Mac-Adresse darf nicht leer sein
 10176=RAG-Konfiguration dataset_id darf nicht leer sein
 10177=RAG-Konfiguration model_id darf nicht leer sein
 10178=RAG-Konfiguration dataset_id und model_id dürfen nicht leer sein
 10179=Dateiname darf nicht leer sein
 10180=Dateiinhalt darf nicht leer sein
 10181=Stimmenklon-Name darf nicht leer sein
 10182=Stimmenklon-Audio nicht gefunden
 10183=Standard-Agent-Vorlage nicht gefunden
 10184=Nicht unterstützter Adaptertyp
 10185=RAG-Konfigurationsvalidierung fehlgeschlagen
 10186=Adapter-Erstellung fehlgeschlagen
 10187=Adapter-Initialisierung fehlgeschlagen
 10188=Adapter-Verbindungstest fehlgeschlagen
 10189=Adapter-Operation fehlgeschlagen
 10190=Adapter nicht gefunden
 10191=Adapter-Cache-Fehler
 10192=Adaptertyp nicht gefunden
@@ -166,4 +166,36 @@
 10157=Request failed
 10158=Clone Voice:
 10159=Voice ID already exists
-10160=Huoshan Engine voice ID format error, must start with S_
+10160=Huoshan Engine voice ID format error, must start with S_
 10161=Mac address already exists
 10162=Model provider does not exist
 10163=Knowledge base record does not exist
 10164=RAG configuration not found
 10165=RAG configuration type error
 10166=Default RAG configuration not found
 10167=RAG API call failed: {0}
 10168=Upload file failed
 10169=No permission to operate this knowledge base
 10170=Knowledge base name already exists
 10171=RAG configuration base_url cannot be empty
 10172=RAG configuration api_key cannot be empty
 10173=RAG configuration api_key cannot contain placeholder, please replace with actual API key
 10174=RAG configuration base_url format error, must start with http or https
 10175=Mac address cannot be empty
 10176=RAG configuration dataset_id cannot be empty
 10177=RAG configuration model_id cannot be empty
 10178=RAG configuration dataset_id and model_id cannot be empty
 10179=File name cannot be empty
 10180=File content cannot be empty
 10181=Voice clone name cannot be empty
 10182=Voice clone audio not found
 10183=Default agent template not found
 10184=Unsupported adapter type
 10185=RAG configuration validation failed
 10186=Adapter creation failed
 10187=Adapter initialization failed
 10188=Adapter connection test failed
 10189=Adapter operation failed
 10190=Adapter not found
 10191=Adapter cache error
 10192=Adapter type not found
@@ -0,0 +1,201 @@
 #Tiếng Việt
 500=Ngoại lệ nội bộ máy chủ
 401=Không được ủy quyền
 403=Truy cập bị từ chối, không có quyền
 10001={0} không thể để trống
 10002=Bản ghi đã tồn tại trong cơ sở dữ liệu
 10003=Không thể lấy tham số
 10004=Số tài khoản hoặc mật khẩu không chính xác
 10005=Tài khoản đã bị vô hiệu hóa
 10006=ID duy nhất không thể để trống
 10007=Mã xác minh không chính xác
 10008=Trước tiên hãy xóa menu con hoặc nút
 10009=Mật khẩu gốc không chính xác
 10010=Tài khoản hoặc mật khẩu không chính xác, bạn có thể thử thêm {0} lần nữa
 10011=Phòng ban cấp trên đã lựa chọn sai
 10012=Menu trên không thể là chính nó
 10013=Giao diện quyền dữ liệu, chỉ có thể là tham số kiểu Map
 10014=Vui lòng xóa phòng ban cấp dưới trước
 10015=Vui lòng xóa người dùng thuộc phòng ban trước
 10016=Triển khai thất bại, không có quy trình
 10017=Biểu đồ mô hình không chính xác, vui lòng kiểm tra
 10018=Xuất thất bại, ID mô hình là {0}
 10019=Vui lòng tải lên tệp
 10020=Token không thể để trống
 10021=Token không hợp lệ, vui lòng đăng nhập lại
 10022=Tài khoản đã bị khóa
 10023=Vui lòng tải lên tệp ở định dạng zip, bar, bpmn, bpmn20.xml
 10024=Tải lên tệp {0} thất bại
 10025=Gửi SMS {0} thất bại
 10026=Mẫu email không tồn tại
 10027=Ngoại lệ dịch vụ Redis
 10028=Tác vụ hẹn giờ thất bại
 10029=Không thể chứa ký tự không hợp lệ
 10030=Mật khẩu ít hơn {0} chữ số
 10031=Mật khẩu phải bao gồm số, chữ hoa, chữ thường và ký tự đặc biệt cùng một lúc
 10032=Ngoại lệ khi xóa dữ liệu này
 10033=Lỗi mã xác minh thiết bị
 10034=Giá trị tham số không thể để trống
 10035=Loại tham số không thể để trống
 10036=Loại tham số không được hỗ trợ
 10037=Giá trị tham số phải là số hợp lệ
 10038=Giá trị tham số phải là true hoặc false
 10039=Giá trị tham số phải là định dạng mảng JSON hợp lệ
 10040=Giá trị tham số phải là định dạng JSON hợp lệ
 10041=Không tìm thấy thiết bị
 10042={0}
 10043=Xóa dữ liệu thất bại
 10044=Người dùng chưa đăng nhập
 10045=Kết nối WebSocket thất bại hoặc hết thời gian chờ
 10046=Không thể lưu dấu giọng nói, vui lòng liên hệ quản trị viên
 10047=Đạt đến giới hạn gửi hàng ngày
 10048=Mật khẩu cũ không chính xác
 10049=LLM được đặt không phải là openai hoặc ollama
 10050=Không thể tạo token
 10051=Không tìm thấy tài nguyên
 10052=Không tìm thấy agent mặc định
 10053=Không tìm thấy agent
 10054=Giao diện dấu giọng nói chưa được cấu hình, vui lòng cấu hình địa chỉ giao diện dấu giọng nói (server.voice_print) trong cấu hình tham số trước
 10055=Gửi SMS thất bại
 10056=Không thể thiết lập kết nối SMS
 10057=Không thể tạo dấu giọng nói cho agent
 10058=Không thể cập nhật dấu giọng nói cho agent
 10059=Không thể xóa dấu giọng nói cho agent
 10060=Gửi quá thường xuyên, vui lòng thử lại sau {0} giây
 10061=Mã kích hoạt không thể để trống
 10062=Lỗi mã kích hoạt
 10063=Thiết bị đã được kích hoạt
 10064=Mô hình này là mô hình mặc định, vui lòng đặt mô hình khác làm mặc định trước
 10065=Thêm dữ liệu thất bại
 10066=Cập nhật dữ liệu thất bại
 10067=Lỗi mã xác minh đồ họa
 10068=Đăng ký di động không được bật, không thể sử dụng chức năng mã xác minh SMS
 10069=Tên người dùng không phải là số điện thoại di động, vui lòng nhập lại
 10070=Số điện thoại di động này đã được đăng ký
 10071=Số điện thoại di động đã nhập không được đăng ký
 10072=Hiện không cho phép đăng ký người dùng thông thường
 10073=Đăng ký di động không được bật, không thể sử dụng chức năng truy xuất mật khẩu
 10074=Định dạng số điện thoại di động đã nhập không chính xác
 10075=Mã xác minh SMS đã nhập không chính xác
 10076=Loại từ điển không tồn tại
 10077=Mã loại từ điển bị trùng lặp
 10078=Đọc tài nguyên thất bại
 10079=Mô hình LLM và nhận dạng ý định, lựa chọn tham số không khớp
 10080=Dấu giọng nói này thuộc về {0} đã đăng ký, vui lòng chọn giọng nói khác
 10081=Đã xảy ra lỗi khi xóa dấu giọng nói
 10082=Không cho phép sửa đổi, giọng nói này đã được đăng ký làm dấu giọng nói ({0})
 10083=Lỗi sửa đổi dấu giọng nói, vui lòng liên hệ quản trị viên
 10084=Lỗi địa chỉ giao diện dấu giọng nói, vui lòng vào quản lý tham số để sửa đổi địa chỉ giao diện dấu giọng nói
 10085=Dữ liệu âm thanh không thuộc về agent này
 10086=Dữ liệu âm thanh trống, vui lòng kiểm tra dữ liệu đã tải lên
 10087=Đăng ký dấu giọng nói thất bại, yêu cầu không thành công
 10088=Đăng ký dấu giọng nói thất bại, xử lý yêu cầu thất bại
 10089=Hủy dấu giọng nói thất bại, yêu cầu không thành công
 10090=Hủy dấu giọng nói thất bại, xử lý yêu cầu thất bại
 10091=Nhà cung cấp mô hình không tồn tại
 10092=LLM được cấu hình không tồn tại
 10093=Cấu hình mô hình này được tham chiếu bởi agent {0} và không thể xóa
 10094=Mô hình LLM này được tham chiếu bởi cấu hình nhận dạng ý định và không thể xóa
 10095=Thao tác máy chủ không hợp lệ
 10096=Địa chỉ WebSocket máy chủ chưa được cấu hình
 10097=Địa chỉ WebSocket mục tiêu không tồn tại
 10098=Danh sách địa chỉ WebSocket không thể để trống
 10099=Địa chỉ WebSocket không thể sử dụng localhost hoặc 127.0.0.1
 10100=Định dạng địa chỉ WebSocket không chính xác
 10101=Kiểm tra kết nối WebSocket thất bại
 10102=Địa chỉ OTA không thể để trống
 10103=Địa chỉ OTA không thể sử dụng localhost hoặc 127.0.0.1
 10104=Địa chỉ OTA phải bắt đầu bằng http hoặc https
 10105=Địa chỉ OTA phải kết thúc bằng /ota/
 10106=Truy cập giao diện OTA thất bại
 10107=Định dạng nội dung trả về giao diện OTA không chính xác
 10108=Xác thực giao diện OTA thất bại
 10109=Địa chỉ MCP không thể để trống
 10110=Địa chỉ MCP không thể sử dụng localhost hoặc 127.0.0.1
 10111=Không phải địa chỉ MCP hợp lệ
 10112=Truy cập giao diện MCP thất bại
 10113=Định dạng nội dung trả về giao diện MCP không chính xác
 10114=Xác thực giao diện MCP thất bại
 10115=Địa chỉ giao diện dấu giọng nói không thể để trống
 10116=Địa chỉ giao diện dấu giọng nói không thể sử dụng localhost hoặc 127.0.0.1
 10117=Không phải địa chỉ giao diện dấu giọng nói hợp lệ
 10118=Địa chỉ giao diện dấu giọng nói phải bắt đầu bằng http hoặc https
 10119=Truy cập giao diện dấu giọng nói thất bại
 10120=Định dạng nội dung trả về giao diện dấu giọng nói không chính xác
 10121=Xác thực giao diện dấu giọng nói thất bại
 10122=Bí mật MQTT không thể để trống
 10123=Bí mật MQTT của bạn không an toàn, cần ít nhất 8 ký tự và phải chứa cả chữ hoa và chữ thường
 10124=Bí mật MQTT của bạn không an toàn, bí mật MQTT phải chứa cả chữ hoa và chữ thường
 10125=Bí mật MQTT của bạn chứa mật khẩu yếu
 10128=Nhãn từ điển bị trùng lặp
 10129=Khóa SM2 chưa được cấu hình
 10130=Giải mã SM2 thất bại
 10131=modelType và provideCode không thể để trống
 10132=Không có quyền xem lịch sử trò chuyện của agent này
 10133=ID phiên không thể để trống
 10134=ID agent không thể để trống
 10135=Tải xuống lịch sử trò chuyện thất bại
 10136=Liên kết tải xuống đã hết hạn hoặc không hợp lệ
 10137=Liên kết tải xuống không hợp lệ
 10138=Người dùng
 10139=Agent
 10140=Tệp âm thanh không thể để trống
 10141=Chỉ hỗ trợ tệp âm thanh
 10142=Kích thước tệp âm thanh không thể vượt quá 10MB
 10143=Tải lên thất bại
 10144=Bản ghi nhân bản giọng nói không tồn tại
 10145=Thông tin tài nguyên giọng nói không thể để trống
 10146=Tên nền tảng TTS không thể để trống
 10147=ID giọng nói không thể để trống
 10148=Tài khoản chủ sở hữu không thể để trống
 10149=ID tài nguyên giọng nói cần xóa không thể để trống
 10150=Bạn không có quyền thao tác bản ghi này
 10151=Vui lòng tải lên tệp âm thanh trước
 10152=Không tìm thấy cấu hình mô hình
 10153=Không tìm thấy loại mô hình
 10154=Đào tạo thất bại: {0}
 10155=Thiếu cấu hình Huoshan Engine
 10156=Lỗi định dạng phản hồi, thiếu trường BaseResp
 10157=Yêu cầu thất bại
 10158=Nhân bản âm sắc:
 10159=ID giọng nói đã tồn tại
 10160=Lỗi định dạng ID giọng nói Huoshan Engine, phải bắt đầu bằng S_
 10161=Địa chỉ Mac đã tồn tại
 10162=Nhà cung cấp mô hình không tồn tại
 10163=Bản ghi cơ sở kiến thức không tồn tại
 10164=Không tìm thấy cấu hình RAG
 10165=Lỗi loại cấu hình RAG
 10166=Không tìm thấy cấu hình RAG mặc định
 10167=Gọi API RAG thất bại: {0}
 10168=Tải lên tệp thất bại
 10169=Không có quyền thao tác cơ sở kiến thức này
 10170=Tên cơ sở kiến thức đã tồn tại
 10171=Cấu hình RAG base_url không thể để trống
 10172=Cấu hình RAG api_key không thể để trống
 10173=Cấu hình RAG api_key không thể chứa trình giữ chỗ, vui lòng thay thế bằng khóa API thực tế
 10174=Lỗi định dạng cấu hình RAG base_url, phải bắt đầu bằng http hoặc https
 10175=Địa chỉ Mac không thể để trống
 10176=Cấu hình RAG dataset_id không thể để trống
 10177=Cấu hình RAG model_id không thể để trống
 10178=Cấu hình RAG dataset_id và model_id không thể để trống
 10179=Tên tệp không thể để trống
 10180=Nội dung tệp không thể để trống
 10181=Tên nhân bản giọng nói không thể để trống
 10182=Không tìm thấy âm thanh nhân bản giọng nói
 10183=Không tìm thấy mẫu agent mặc định
 10184=Loại bộ chuyển đổi không được hỗ trợ
 10185=Kiểm tra cấu hình RAG thất bại
 10186=Tạo bộ chuyển đổi thất bại
 10187=Khởi tạo bộ chuyển đổi thất bại
 10188=Kiểm tra kết nối bộ chuyển đổi thất bại
 10189=Thao tác bộ chuyển đổi thất bại
 10190=Không tìm thấy bộ chuyển đổi
 10191=Lỗi bộ nhớ đệm bộ chuyển đổi
 10192=Không tìm thấy loại bộ chuyển đổi
@@ -160,10 +160,42 @@
 10151=\u8BF7\u5148\u4E0A\u4F20\u97F3\u9891\u6587\u4EF6
 10152=\u6A21\u578B\u914D\u7F6E\u672A\u627E\u5230
 10153=\u6A21\u578B\u7C7B\u578B\u672A\u627E\u5230
-10154=\u8BAD\u7EC3\u5931\u8D25
+10154=\u8BAD\u7EC3\u5931\u8D25: {0}
 10155=\u706B\u5C71\u5F15\u64CE\u7F3A\u5C11\u914D\u7F6E
 10156=\u54CD\u5E94\u683C\u5F0F\u9519\u8BEF\uFF0C\u7F3A\u5C11BaseResp\u5B57\u6BB5
 10157=\u8BF7\u6C42\u5931\u8D25
-10158=\u514B\u9686\u8272\u97F3:
+10158=\u514B\u9686\u97F3\u8272:
 10159=\u97F3\u8272ID\u5DF2\u5B58\u5728
-10160=\u706B\u5C71\u5F15\u64CE\u97F3\u8272ID\u683C\u5F0F\u9519\u8BEF\uFF0C\u5FC5\u987B\u4EE5S_\u5F00\u5934
+10160=\u706B\u5C71\u5F15\u64CE\u97F3\u8272ID\u683C\u5F0F\u9519\u8BEF\uFF0C\u5FC5\u987B\u4EE5S_\u5F00\u5934
 10161=Mac\u5730\u5740\u5DF2\u5B58\u5728
 10162=\u6A21\u578B\u4F9B\u5E94\u5668\u4E0D\u5B58\u5728
 10163=\u77E5\u8BC6\u5E93\u8BB0\u5F55\u4E0D\u5B58\u5728
 10164=RAG\u914D\u7F6E\u672A\u627E\u5230
 10165=RAG\u914D\u7F6E\u7C7B\u578B\u9519\u8BEF
 10166=\u9ED8\u8BA4RAG\u914D\u7F6E\u672A\u627E\u5230
 10167=RAG\u8C03\u7528\u5931\u8D25\uFF0C{0}
 10168=\u4E0A\u4F20\u6587\u4EF6\u5931\u8D25
 10169=\u60A8\u6CA1\u6709\u6743\u9650\u64CD\u4F5C\u8BE5\u8BB0\u5F55
 10170=\u77E5\u8BC6\u5E93\u540D\u79F0\u91CD\u590D
 10171=RAG\u914D\u7F6E\u4F53\u7684base_url\u4E0D\u80FD\u4E3A\u7A7A
 10172=RAG\u914D\u7F6E\u4F53\u7684api_key\u4E0D\u80FD\u4E3A\u7A7A
 10173=RAG\u914D\u7F6E\u4F53\u7684api_key\u4E0D\u80FD\u4E3A\u7A7A\uFF0C\u8BF7\u66F4\u6362\u4E3A\u5728\u53D6\u7684API\u53C2\u6570
 10174=RAG\u914D\u7F6E\u4F53\u7684base_url\u683C\u5F0F\u9519\u8BEF\uFF0C\u5FC5\u987B\u4EE5http\u6216https\u5F00\u5934
 10175=mac\u5730\u5740\u4E0D\u80FD\u4E3A\u7A7A
 10176=RAG\u914D\u7F6E\u4F53\u7684dataset_id\u4E0D\u80FD\u4E3A\u7A7A
 10177=RAG\u914D\u7F6E\u4F53\u7684model_id\u4E0D\u80FD\u4E3A\u7A7A
 10178=RAG\u914D\u7F6E\u4F53\u7684dataset_id\u548Cmodel_id\u4E0D\u80FD\u4E3A\u7A7A
 10179=\u6587\u4EF6\u540D\u79F0\u4E0D\u80FD\u4E3A\u7A7A
 10180=\u6587\u4EF6\u5185\u5BB9\u4E0D\u80FD\u4E3A\u7A7A
 10181=\u97F3\u8272\u514B\u9686\u540D\u79F0\u4E0D\u80FD\u4E3A\u7A7A
 10182=\u97F3\u8272\u514B\u9686\u97F3\u9891\u4E0D\u5B58\u5728
 10183=\u9ED8\u8BA4\u667A\u80FD\u4F53\u672A\u627E\u5230
 10184=\u4E0D\u652F\u6301\u7684\u9002\u914D\u5668\u7C7B\u578B
 10185=RAG\u914D\u7F6E\u9A8C\u8BC1\u5931\u8D25
 10186=\u9002\u914D\u5668\u521B\u5EFA\u5931\u8D25
 10187=\u9002\u914D\u5668\u521D\u59CB\u5316\u5931\u8D25
 10188=\u9002\u914D\u5668\u8FDE\u63A5\u6D4B\u8BD5\u5931\u8D25
 10189=\u9002\u914D\u5668\u64CD\u4F5C\u5931\u8D25
 10190=\u9002\u914D\u5668\u672A\u627E\u5230
 10191=\u9002\u914D\u5668\u7F13\u5B58\u9519\u8BEF
 10192=\u9002\u914D\u5668\u7C7B\u578B\u672A\u627E\u5230
@@ -164,6 +164,38 @@
 10155=\u706B\u5C71\u5F15\u64CE\u7F3A\u5C11appid\u6216access_token
 10156=\u97FF\u61C9\u683C\u5F0F\u932F\u8AA4\uFF0C\u7F3A\u5C11BaseResp\u5B57\u6BB5
 10157=\u8ACB\u6C42\u5931\u6557
-10158=\u514B\u9686\u8A9E\u97F3:
+10158=\u514b\u9686\u97f3\u8272:
 10159=\u97F3\u8272ID\u5DF2\u5B58\u5728
-10160=\u706B\u5C71\u5F15\u64CE\u97F3\u8272ID\u683C\u5F0F\u932F\u8AA4\uFF0C\u5FC5\u9808\u4EE5S_\u958B\u982D
+10160=\u706B\u5C71\u5F15\u64CE\u97F3\u8272ID\u683C\u5F0F\u932F\u8AA4\uFF0C\u5FC5\u9808\u4EE5S_\u958B\u982D
 10161=Mac\u5730\u5740\u5DF2\u5B58\u5728
 10162=\u6A21\u578B\u63D0\u4F9B\u5546\u4E0D\u5B58\u5728
 10163=\u77E5\u8B58\u5EAB\u8A18\u9304\u4E0D\u5B58\u5728
 10164=RAG\u914D\u7F6E\u672A\u627E\u5230
 10165=RAG\u914D\u7F6E\u985E\u578B\u932F\u8AA4
 10166=\u9810\u8A2DRAG\u914D\u7F6E\u672A\u627E\u5230
 10167=\u0052\u0041\u0047\u8abf\u7528\u5931\u6557\uFF0C{0}
 10168=\u4E0A\u50B3\u6587\u4EF6\u5931\u6557
 10169=\u60A8\u6C92\u6709\u6B0A\u9650\u64CD\u4F5C\u8A72\u8A18\u9304
 10170=\u77E5\u8B58\u5EAB\u540D\u7A31\u91CD\u8907
 10171=\u0052\u0041\u0047\u914D\u7F6E\u4F53\u7684base_url\u4E0D\u80FD\u4E3A\u7A7A
 10172=\u0052\u0041\u0047\u914D\u7F6E\u4F53\u7684api_key\u4E0D\u80FD\u4E3A\u7A7A
 10173=\u0052\u0041\u0047\u914D\u7F6E\u4F53\u7684api_key\u4E0D\u80FD\u4E3A\u7A7A\uFF0C\u8BF7\u66F4\u6362\u4E3A\u5728\u53D6\u7684API\u53C2\u6570
 10174=\u0052\u0041\u0047\u914D\u7F6E\u4F53\u7684base_url\u683C\u5F0F\u9519\u8BEF\uFF0C\u5FC5\u987B\u4EE5http\u6216https\u5F00\u5934
 10175=mac\u5730\u5740\u4E0D\u80FD\u4E3A\u7A7A
 10176=\u0052\u0041\u0047\u914D\u7F6E\u4F53\u7684dataset_id\u4E0D\u80FD\u4E3A\u7A7A
 10177=\u0052\u0041\u0047\u914D\u7F6E\u4F53\u7684model_id\u4E0D\u80FD\u4E3A\u7A7A
 10178=\u0052\u0041\u0047\u914D\u7F6E\u4F53\u7684dataset_id\u548Cmodel_id\u4E0D\u80FD\u4E3A\u7A7A
 10179=\u6587\u4ef6\u540d\u7a31\u4e0d\u80fd\u70ba\u7a7a
 10180=\u6587\u4ef6\u5185\u5bb9\u4e0d\u80fd\u70ba\u7a7a
 10181=\u97f3\u8272\u514b\u9686\u540d\u7a31\u4e0d\u80fd\u70ba\u7a7a
 10182=\u97f3\u8272\u514b\u9686\u97f3\u983b\u4e0d\u5b58\u5728
 10183=\u9ed8\u8ba4\u667a\u80fd\u4f53\u672a\u627e\u5230
 10184=\u4E0D\u652F\u6301\u7684\u9002\u914D\u5668\u985E\u578B
 10185=RAG\u914D\u7F6E\u9A57\u8B49\u5931\u6557
 10186=\u9002\u914D\u5668\u5275\u5EFA\u5931\u6557
 10187=\u9002\u914D\u5668\u521D\u59CB\u5316\u5931\u6557
 10188=\u9002\u914D\u5668\u9023\u63A5\u6E2C\u8A66\u5931\u6557
 10189=\u9002\u914D\u5668\u64CD\u4F5C\u5931\u6557
 10190=\u9002\u914D\u5668\u672A\u627E\u5230
 10191=\u9002\u914D\u5668\u7F13\u5B58\u932F\u8AA4
 10192=\u9002\u914D\u5668\u985E\u578B\u672A\u627E\u5230
@@ -0,0 +1,34 @@
 #Deutsch
 id.require=ID darf nicht leer sein
 id.null=ID muss leer sein
 sort.number=Der Sortierwert darf nicht kleiner als 0 sein
 page.number=Der Seitenwert darf nicht kleiner als 0 sein
 limit.number=Der Limit-Wert darf nicht kleiner als 0 sein
 sysdict.type.require=Der Wörterbuchtyp darf nicht leer sein
 sysdict.name.require=Der Wörterbuchname darf nicht leer sein
 sysdict.label.require=Wörterbuch-Label darf nicht leer sein
 sysparams.paramcode.require=Parameter-Code darf nicht leer sein
 sysparams.paramvalue.require=Parameter-Werte dürfen nicht leer sein
 sysparams.valuetype.require=Werttyp darf nicht leer sein
 sysparams.valuetype.pattern=Werttyp muss string, number, boolean oder array sein
 sysuser.username.require=Der Benutzername darf nicht leer sein
 sysuser.password.require=Das Passwort darf nicht leer sein
 sysuser.realname.require=Der echte Name darf nicht leer sein
 sysuser.gender.range=Geschlecht liegt im Bereich von 0 bis 2
 sysuser.email.error=Falsches E-Mail-Format
 sysuser.deptId.require=Abteilungen dürfen nicht leer sein
 sysuser.status.range=Status liegt im Bereich von 0 bis 1
 sysuser.captcha.require=Das Captcha darf nicht leer sein
 sysuser.uuid.require=Der eindeutige Identifikator darf nicht leer sein
 timbre.languages.require=Die Sprache des Klangs darf nicht leer sein
 timbre.name.require=Der Name des Klangs darf nicht leer sein
 timbre.ttsModelId.require=Die TTS-Modell-ID des Klangs darf nicht leer sein
 timbre.ttsVoice.require=Die TTS-Stimme des Klangs darf nicht leer sein
 ota.device.not.found=Gerät nicht gefunden
 ota.device.need.bind={0}
@@ -0,0 +1,34 @@
 # Tiếng Việt
 id.require=ID không được để trống
 id.null=ID phải để trống
 sort.number=Giá trị sắp xếp không thể nhỏ hơn 0
 page.number=Giá trị trang không thể nhỏ hơn 0
 limit.number=Giá trị giới hạn không thể nhỏ hơn 0
 sysdict.type.require=Loại từ điển không được để trống
 sysdict.name.require=Tên từ điển không được để trống
 sysdict.label.require=Thẻ từ điển không được để trống
 sysparams.paramcode.require=Mã tham số không được để trống
 sysparams.paramvalue.require=Giá trị tham số không được để trống
 sysparams.valuetype.require=Loại giá trị không được để trống
 sysparams.valuetype.pattern=Loại giá trị phải là chuỗi, số, boolean hoặc mảng
 sysuser.username.require=Tên người dùng không được để trống
 sysuser.password.require=Mật khẩu không được để trống
 sysuser.realname.require=Tên thật không được để trống
 sysuser.gender.range=Giới tính phải từ 0 đến 2
 sysuser.email.error=Định dạng email không chính xác
 sysuser.deptId.require=Phòng ban không được để trống
 sysuser.status.range=Trạng thái phải từ 0 đến 1
 sysuser.captcha.require=Mã xác thực không được để trống
 sysuser.uuid.require=Định danh duy nhất không được để trống
 timbre.languages.require=Ngôn ngữ của âm sắc không được để trống
 timbre.name.require=Tên âm sắc không được để trống
 timbre.ttsModelId.require=ID mô hình TTS của âm sắc không được để trống
 timbre.ttsVoice.require=Giọng TTS của âm sắc không được để trống
 ota.device.not.found=Không tìm thấy thiết bị
 ota.device.need.bind={0}
@@ -3,8 +3,8 @@ id.require=ID\u4E0D\u80FD\u4E3A\u7A7A
 id.null=ID\u5FC5\u987B\u4E3A\u7A7A
 sort.number=\u6392\u5E8F\u503C\u4E0D\u80FD\u5C0F\u4E8E0
-page.number=\u9801\u6578\u4E0D\u80FD\u5C0F\u4E8E0
+page.number=\u9875\u6570\u4E0D\u80FD\u5C0F\u4E8E0
-limit.number=\u5217\u6578\u4E0D\u80FD\u5C0F\u4E8E0
+limit.number=\u5217\u6570\u4E0D\u80FD\u5C0F\u4E8E0
 sysdict.type.require=\u5B57\u5178\u7C7B\u578B\u4E0D\u80FD\u4E3A\u7A7A
 sysdict.name.require=\u5B57\u5178\u540D\u79F0\u4E0D\u80FD\u4E3A\u7A7A
@@ -25,10 +25,10 @@ sysuser.status.range=\u72B6\u6001\u53D6\u503C\u8303\u56F40~1
 sysuser.captcha.require=\u9A8C\u8BC1\u7801\u4E0D\u80FD\u4E3A\u7A7A
 sysuser.uuid.require=\u552F\u4E00\u6807\u8BC6\u4E0D\u80FD\u4E3A\u7A7A
-timbre.languages.require=\u97F3\u8272\u7684\u8A9E\u8A00\u4E0D\u53EF\u4EE5\u70BA\u7A7A
+timbre.languages.require=\u97F3\u8272\u7684\u8BED\u8A00\u4E0D\u80FD\u4E3A\u7A7A
-timbre.name.require=\u97F3\u8272\u7684\u540D\u7A31\u4E0D\u53EF\u4EE5\u70BA\u7A7A
+timbre.name.require=\u97F3\u8272\u7684\u540D\u79F0\u4E0D\u80FD\u4E3A\u7A7A
-timbre.ttsModelId.require=\u97F3\u8272\u7684tts\u4E3B\u9375\u4E0D\u53EF\u4EE5\u70BA\u7A7A
+timbre.ttsModelId.require=\u97F3\u8272\u7684tts\u4E3B\u952E\u4E0D\u80FD\u4E3A\u7A7A
-timbre.ttsVoice.require=\u97F3\u8272\u7684\u7DE8\u78BC\u4E0D\u53EF\u4EE5\u70BA\u7A7A
+timbre.ttsVoice.require=\u97F3\u8272\u7684\u7F16\u7801\u4E0D\u80FD\u4E3A\u7A7A
-ota.device.not.found=\u8A2D\u5099\u672A\u627E\u5230
+ota.device.not.found=\u8BBE\u5907\u672A\u627E\u5230
 ota.device.need.bind={0}
@@ -0,0 +1,26 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!DOCTYPE mapper
        PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
        "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
 <mapper namespace="xiaozhi.modules.knowledge.dao.KnowledgeBaseDao">
    <resultMap id="BaseResultMap" type="xiaozhi.modules.knowledge.entity.KnowledgeBaseEntity">
        <id property="id" column="id" jdbcType="VARCHAR"/>
        <result property="datasetId" column="dataset_id" jdbcType="VARCHAR"/>
        <result property="ragModelId" column="rag_model_id" jdbcType="VARCHAR"/>
        <result property="name" column="name" jdbcType="VARCHAR"/>
        <result property="description" column="description" jdbcType="VARCHAR"/>
        <result property="status" column="status" jdbcType="TINYINT"/>
        <result property="creator" column="creator" jdbcType="BIGINT"/>
        <result property="createdAt" column="created_at" jdbcType="TIMESTAMP"/>
        <result property="updater" column="updater" jdbcType="BIGINT"/>
        <result property="updatedAt" column="updated_at" jdbcType="TIMESTAMP"/>
    </resultMap>
    <!-- 根据知识库ID删除相关的插件映射记录 -->
    <delete id="deletePluginMappingByKnowledgeBaseId">
        DELETE FROM ai_agent_plugin_mapping 
        WHERE plugin_id = #{knowledgeBaseId}
    </delete>
 </mapper>
@@ -3,7 +3,7 @@
 <mapper namespace="xiaozhi.modules.voiceclone.dao.VoiceCloneDao">
    <select id="getTrainSuccess" resultType="xiaozhi.modules.model.dto.VoiceDTO">
-        select id, name
+        select id, name, voice_id as voiceDemo
        from ai_voice_clone
        where model_id = #{modelId} and user_id = #{userId} and train_status = 2
    </select>
@@ -0,0 +1,440 @@
 // Deutsch Sprachpaket
 export default {
    // TabBar
    'tabBar.home': 'Startseite',
    'tabBar.deviceConfig': 'Netzwerkkonfig',
    'tabBar.settings': 'System',
    // Einstellungsseitentitel
    'settings.title': 'Einstellungen',
    // Anmeldeseite
    'login.pageTitle': 'Anmelden',
    'login.navigationTitle': 'Anmelden',
    'login.fetchConfigError': 'Konfiguration konnte nicht abgerufen werden:',
    'login.selectLanguage': 'Sprache auswählen',
    'login.selectLanguageTip': 'Vi',
    'login.welcomeBack': 'Willkommen zurück',
    'login.pleaseLogin': 'Bitte melden Sie sich an',
    'login.enterUsername': 'Bitte Benutzernamen eingeben',
    'login.enterPassword': 'Bitte Passwort eingeben',
    'login.enterCaptcha': 'Bitte Bestätigungscode eingeben',
    'login.loginButton': 'Anmelden',
    'login.loggingIn': 'Wird angemeldet...',
    'login.noAccount': 'Registrieren',
    'login.enterPhone': 'Bitte Handynummer eingeben',
    'login.selectCountry': 'Land/Region auswählen',
    'login.confirm': 'Bestätigen',
    'login.serverSetting': 'Server-Einstellungen',
    'login.requiredUsername': 'Benutzername darf nicht leer sein',
    'login.requiredPassword': 'Passwort darf nicht leer sein',
    'login.requiredCaptcha': 'Bestätigungscode darf nicht leer sein',
    'login.requiredMobile': 'Bitte gültige Handynummer eingeben',
    'login.captchaError': 'Grafischer Bestätigungscode Fehler',
    'login.forgotPassword': 'Passwort vergessen',
    // Registrierungsseite
    'register.pageTitle': 'Registrieren',
    'register.createAccount': 'Konto erstellen',
    'register.enterUsername': 'Bitte Benutzernamen eingeben',
    'register.enterPassword': 'Bitte Passwort eingeben',
    'register.confirmPassword': 'Bitte Passwort bestätigen',
    'register.enterPhone': 'Bitte Handynummer eingeben',
    'register.enterCode': 'Bitte Bestätigungscode eingeben',
    'register.getCode': 'Code erhalten',
    'register.agreeTerms': 'Ich habe gelesen und stimme zu',
    'register.terms': 'Nutzungsbedingungen',
    'register.privacy': 'Datenschutzrichtlinie',
    'register.registerButton': 'Registrieren',
    'register.registering': 'Wird registriert...',
    'register.haveAccount': 'Bereits ein Konto?',
    'register.loginNow': 'Jetzt anmelden',
    'register.selectCountry': 'Land/Region auswählen',
    'register.confirm': 'Bestätigen',
    'register.captchaSendSuccess': 'Bestätigungscode erfolgreich gesendet',
    // Startseite
    'home.pageTitle': 'Startseite',
    'home.createAgent': 'Agent erstellen',
    'home.agentName': 'Agent',
    'home.modelInfo': 'Modell-Info',
    'home.lastActive': 'Zuletzt aktiv',
    'home.greeting': 'Hallo Jarvis',
    'home.subtitle': 'Lassen Sie uns',
    'home.wonderfulDay': 'einen wunderbaren Tag haben!',
    'home.emptyState': 'Keine Agenten verfügbar',
    'home.deviceManagement': 'Geräteverwaltung',
    'home.lastConversation': 'Letzte Konversation:',
    'home.delete': 'Löschen',
    'home.createFirstAgent': 'Klicken Sie auf die + Schaltfläche unten rechts, um Ihren ersten Agenten zu erstellen',
    'home.dialogTitle': 'Agent erstellen',
    'home.inputPlaceholder': 'z.B. Kundenservice-Assistent, Sprachassistent, Wissens-F&A',
    'home.createError': 'Bitte Agenten-Namen eingeben',
    'home.createNow': 'Jetzt erstellen',
    'home.justNow': 'Gerade eben',
    'home.minutesAgo': 'Minuten her',
    'home.hoursAgo': 'Stunden her',
    'home.daysAgo': 'Tage her',
    // Agentenseite
    'agent.pageTitle': 'Agent',
    'agent.roleConfig': 'Rollenkonfiguration',
    'agent.deviceManagement': 'Geräteverwaltung',
    'agent.chatHistory': 'Chat-Verlauf',
    'agent.voiceprintManagement': 'Stimmabdruckverwaltung',
    'agent.editTitle': 'Agent bearbeiten',
    'agent.toolsTitle': 'Funktionen bearbeiten',
    'agent.voiceActivityDetection': 'Sprachaktivitätserkennung',
    'agent.speechRecognition': 'Spracherkennung',
    'agent.largeLanguageModel': 'Großes Sprachmodell',
    'agent.save': 'Speichern',
    'agent.cancel': 'Abbrechen',
    // Agenten-Bearbeitungsseite
    'agent.basicInfo': 'Grundinformationen',
    'agent.agentName': 'Agentenname',
    'agent.inputAgentName': 'Bitte Agenten-Namen eingeben',
    'agent.roleMode': 'Rollenmodus',
    'agent.roleDescription': 'Rollenbeschreibung',
    'agent.inputRoleDescription': 'Bitte Rollenbeschreibung eingeben',
    'agent.modelConfig': 'Modellkonfiguration',
    'agent.vad': 'Sprachaktivitätserkennung',
    'agent.asr': 'Spracherkennung',
    'agent.llm': 'Großes Sprachmodell',
    'agent.vllm': 'Vision-Sprachmodell',
    'agent.intent': 'Absichtserkennung',
    'agent.memory': 'Speicher',
    'agent.voiceSettings': 'Stimmeinstellungen',
    'agent.tts': 'Text-zu-Sprache',
    'agent.voiceprint': 'Agenten-Stimme',
    'agent.plugins': 'Plugins',
    'agent.editFunctions': 'Funktionen bearbeiten',
    'agent.historyMemory': 'Verlaufsspeicher',
    'agent.memoryContent': 'Speicherinhalt',
    'agent.saving': 'Wird gespeichert...',
    'agent.saveSuccess': 'Erfolgreich gespeichert',
    'agent.saveFail': 'Speichern fehlgeschlagen',
    'agent.loadFail': 'Laden fehlgeschlagen',
    'agent.pleaseInputAgentName': 'Bitte Agenten-Namen eingeben',
    'agent.pleaseInputRoleDescription': 'Bitte Rollenbeschreibung eingeben',
    'agent.pleaseSelect': 'Bitte auswählen',
    // Chat-Verlauf Seite
    'chatHistory.getChatSessions': 'Chat-Sitzungsliste abrufen',
    'chatHistory.noSelectedAgent': 'Kein Agent ausgewählt',
    'chatHistory.getChatSessionsFailed': 'Chat-Sitzungsliste konnte nicht abgerufen werden:',
    'chatHistory.unknownTime': 'Unbekannte Zeit',
    'chatHistory.justNow': 'Gerade eben',
    'chatHistory.minutesAgo': 'Vor {minutes} Minuten',
    'chatHistory.hoursAgo': 'Vor {hours} Stunden',
    'chatHistory.daysAgo': 'Vor {days} Tagen',
    'chatHistory.conversationRecord': 'Konversationsaufzeichnung',
    'chatHistory.totalChats': 'Insgesamt {count} Chats',
    'chatHistory.loading': 'Lädt...',
    'chatHistory.noMoreData': 'Keine weiteren Daten',
    'chatHistory.noChatRecords': 'Keine Chat-Aufzeichnungen',
    'chatHistory.chatRecordsDescription': 'Konversationsaufzeichnungen mit Agenten werden hier angezeigt',
    // Chat-Verlauf Detailseite
    'chatHistory.pageTitle': 'Chat-Details',
    'chatHistory.assistantName': 'Intelligenter Assistent',
    'chatHistory.userName': 'Benutzer',
    'chatHistory.aiAssistantName': 'KI-Assistent',
    'chatHistory.loadFailed': 'Chat-Verlauf konnte nicht geladen werden',
    'chatHistory.parameterError': 'Seitenparameter Fehler',
    'chatHistory.invalidAudioId': 'Ungültige Audio-ID',
    'chatHistory.audioPlayFailed': 'Audio-Wiedergabe fehlgeschlagen',
    'chatHistory.playAudioFailed': 'Audio konnte nicht abgespielt werden',
    // Geräteverwaltungsseite
    'device.pageTitle': 'Geräteverwaltung',
    'device.noDevices': 'Keine Geräte verfügbar',
    'device.macAddress': 'MAC-Adresse',
    'device.firmwareVersion': 'Firmware-Version',
    'device.lastConnected': 'Letzte Konversation',
    'device.otaUpdate': 'OTA-Update',
    'device.unbind': 'Entbinden',
    'device.confirmUnbind': 'Bestätigen',
    'device.bindDevice': 'Neues Gerät binden',
    'device.deviceType': 'Gerätetyp',
    'device.loading': 'Lädt...',
    'device.neverConnected': 'Nie verbunden',
    'device.justNow': 'Gerade eben',
    'device.minutesAgo': 'Vor {minutes} Minuten',
    'device.hoursAgo': 'Vor {hours} Stunden',
    'device.daysAgo': 'Vor {days} Tagen',
    'device.otaAutoUpdateEnabled': 'OTA Auto-Update aktiviert',
    'device.otaAutoUpdateDisabled': 'OTA Auto-Update deaktiviert',
    'device.operationFailed': 'Operation fehlgeschlagen, bitte erneut versuchen',
    'device.deviceUnbound': 'Gerät entbunden',
    'device.unbindFailed': 'Entbinden fehlgeschlagen, bitte erneut versuchen',
    'device.unbindDevice': 'Gerät entbinden',
    'device.confirmUnbindDevice': 'Sind Sie sicher, dass Sie Gerät "{macAddress}" entbinden möchten?',
    'device.cancel': 'Abbrechen',
    'device.noDevice': 'Kein Gerät',
    'device.pleaseSelectAgent': 'Bitte wählen Sie zuerst einen Agenten aus',
    'device.deviceBindSuccess': 'Gerät erfolgreich gebunden!',
    'device.bindFailed': 'Binden fehlgeschlagen, bitte prüfen Sie ob der Bestätigungscode korrekt ist',
    'device.enterDeviceCode': 'Bitte Geräte-Bestätigungscode eingeben',
    'device.bindNow': 'Jetzt binden',
    'device.lastConnection': 'Letzte Verbindung',
    'device.clickToBindFirstDevice': 'Klicken Sie auf die + Schaltfläche unten rechts, um Ihr erstes Gerät zu binden',
    // Allgemein
    'common.success': 'Erfolg',
    'common.fail': 'Fehlgeschlagen',
    'common.loading': 'Lädt...',
    'common.confirm': 'Bestätigen',
    'common.cancel': 'Abbrechen',
    'common.delete': 'Löschen',
    'common.edit': 'Bearbeiten',
    'common.add': 'Hinzufügen',
    'common.pleaseSelect': 'Bitte auswählen',
    'common.unknownError': 'Unbekannter Fehler',
    'common.networkError': 'Netzwerkfehler',
    // Passwort-Wiederherstellungsseite
    'retrievePassword.title': 'Passwort zurücksetzen',
    'retrievePassword.subtitle': 'Stellen Sie Ihr Kontopasswort über Handynummer wieder her',
    'retrievePassword.mobileRequired': 'Bitte Handynummer eingeben',
    'retrievePassword.inputCorrectMobile': 'Bitte gültige Handynummer eingeben',
    'retrievePassword.captchaRequired': 'Bitte grafischen Bestätigungscode eingeben',
    'retrievePassword.mobileCaptchaRequired': 'Bitte SMS-Bestätigungscode eingeben',
    'retrievePassword.newPasswordRequired': 'Bitte neues Passwort eingeben',
    'retrievePassword.confirmNewPasswordRequired': 'Bitte neues Passwort bestätigen',
    'retrievePassword.passwordsNotMatch': 'Passwörter stimmen nicht überein',
    'retrievePassword.mobilePlaceholder': 'Bitte Handynummer eingeben',
    'retrievePassword.captchaPlaceholder': 'Bitte grafischen Bestätigungscode eingeben',
    'retrievePassword.mobileCaptchaPlaceholder': 'Bitte SMS-Bestätigungscode eingeben',
    'retrievePassword.newPasswordPlaceholder': 'Bitte neues Passwort eingeben',
    'retrievePassword.confirmNewPasswordPlaceholder': 'Bitte neues Passwort bestätigen',
    'retrievePassword.getMobileCaptcha': 'Code erhalten',
    'retrievePassword.captchaSendSuccess': 'Bestätigungscode erfolgreich gesendet',
    'retrievePassword.passwordUpdateSuccess': 'Passwort erfolgreich zurückgesetzt',
    'retrievePassword.resetButton': 'Passwort zurücksetzen',
    'retrievePassword.goToLogin': 'Zurück zur Anmeldung',
    // SM2-Verschlüsselungsbezogene Fehlermeldungen
    'sm2.publicKeyNotConfigured': 'SM2 öffentlicher Schlüssel nicht konfiguriert, bitte Administrator kontaktieren',
    'sm2.encryptionFailed': 'Passwortverschlüsselung fehlgeschlagen',
    'sm2.keyGenerationFailed': 'Schlüsselpaar-Generierung fehlgeschlagen',
    'sm2.invalidPublicKey': 'Ungültiges öffentliches Schlüsselformat',
    'sm2.encryptionError': 'Fehler bei der Verschlüsselung aufgetreten',
    'sm2.publicKeyRetry': 'Öffentlichen Schlüssel erneut abrufen...',
    'sm2.publicKeyRetryFailed': 'Wiederholter Abruf des öffentlichen Schlüssels fehlgeschlagen',
    // Stimmabdruckseite
    'voiceprint.noSelectedAgent': 'Kein Agent ausgewählt',
    'voiceprint.pleaseSelectAgent': 'Bitte wählen Sie zuerst einen Agenten aus',
    'voiceprint.fetchHistoryFailed': 'Chat-Verlauf konnte nicht abgerufen werden',
    'voiceprint.clickToSelectVector': 'Klicken zum Auswählen des Stimmabdruck-Vektors',
    'voiceprint.pleaseInputName': 'Bitte Namen eingeben',
    'voiceprint.pleaseSelectVector': 'Bitte Stimmabdruck-Vektor auswählen',
    'voiceprint.addSuccess': 'Erfolgreich hinzugefügt',
    'voiceprint.addFailed': 'Hinzufügen des Sprechers fehlgeschlagen',
    'voiceprint.editSuccess': 'Erfolgreich bearbeitet',
    'voiceprint.editFailed': 'Bearbeiten des Sprechers fehlgeschlagen',
    'voiceprint.deleteConfirmMsg': 'Sind Sie sicher, dass Sie diesen Sprecher löschen möchten?',
    'voiceprint.deleteConfirmTitle': 'Löschen bestätigen',
    'voiceprint.deleteSuccess': 'Erfolgreich gelöscht',
    'voiceprint.loading': 'Lädt...',
    'voiceprint.delete': 'Löschen',
    'voiceprint.emptyTitle': 'Keine Stimmabdruck-Daten',
    'voiceprint.emptyDesc': 'Klicken Sie auf die + Schaltfläche unten rechts, um Ihren ersten Sprecher hinzuzufügen',
    'voiceprint.addSpeaker': 'Sprecher hinzufügen',
    'voiceprint.voiceVector': 'Stimmabdruck-Vektor',
    'voiceprint.name': 'Name',
    'voiceprint.description': 'Beschreibung',
    'voiceprint.pleaseInputDescription': 'Bitte Beschreibung eingeben',
    'voiceprint.cancel': 'Abbrechen',
    'voiceprint.save': 'Speichern',
    'voiceprint.editSpeaker': 'Sprecher bearbeiten',
    'voiceprint.selectVector': 'Stimmabdruck-Vektor auswählen',
    'voiceprint.voiceprintInterfaceNotConfigured': 'Stimmabdruck-Schnittstelle nicht konfiguriert',
    // Einstellungsseite
    'settings.pageTitle': 'Einstellungen',
    'settings.navigationTitle': 'Einstellungen',
    'settings.networkSettings': 'Netzwerkeinstellungen',
    'settings.serverApiUrl': 'Server-API-URL',
    'settings.validServerUrl': 'Bitte gültige Serveradresse eingeben (beginnt mit http oder https und endet mit /xiaozhi)',
    'settings.saveSettings': 'Einstellungen speichern',
    'settings.resetDefault': 'Auf Standard zurücksetzen',
    'settings.restartApp': 'App neu starten',
    'settings.restartNow': 'Jetzt neu starten',
    'settings.restartLater': 'Später',
    // Über uns
    'settings.aboutApp': 'Über XiaoZhi Konsole',
    'settings.aboutContent': 'XiaoZhi Konsole\n\nEine plattformübergreifende mobile Management-App, erstellt mit Vue.js 3 + uni-app, bietet Geräteverwaltung, Agentenkonfiguration und andere Funktionen für xiaozhi ESP32 Smart Hardware.\n\n© 2025 xiaozhi-esp32-server {version}',
    'settings.restartSuccess': 'Gespeichert, Sie können die App später manuell neu starten',
    'settings.serverUrlSavedAndCacheCleared': 'Server-URL gespeichert und Cache geleert',
    'settings.resetToDefaultAndCacheCleared': 'Auf Standard zurückgesetzt und Cache geleert',
    'settings.resetSuccess': 'Zurücksetzen erfolgreich',
    'settings.enterServerUrl': 'Bitte Server-URL eingeben',
    'settings.clearCacheFailed': 'Cache konnte nicht geleert werden',
    'settings.cacheManagement': 'Cache-Verwaltung',
    'settings.totalCacheSize': 'Gesamte Cache-Größe',
    'settings.appDataSize': 'Gesamte App-Datengröße',
    'settings.cacheClear': 'Cache leeren',
    'settings.clearAllCache': 'Alle Cache-Daten löschen',
    'settings.clearCache': 'Cache leeren',
    'settings.modifyWillClearCache': 'Änderungen werden Cache leeren',
    'settings.appInfo': 'App-Info',
    'settings.aboutUs': 'Über uns',
    'settings.appVersion': 'App-Version & Team-Info',
    'settings.confirmClear': 'Löschen bestätigen',
    'settings.confirmClearMessage': 'Sind Sie sicher, dass Sie den gesamten Cache löschen möchten? Dies löscht alle Daten einschließlich Anmeldestatus und erfordert erneute Anmeldung.',
    'settings.cacheCleared': 'Cache erfolgreich geleert, leite zur Anmeldeseite weiter',
    'settings.languageSettings': 'Spracheinstellungen',
    'settings.language': 'Sprache',
    'settings.selectLanguage': 'Sprache auswählen',
    'settings.languageChanged': 'Sprache erfolgreich geändert',
    // Nachrichten
    'message.loginSuccess': 'Anmeldung erfolgreich!',
    'message.loginFail': 'Anmeldung fehlgeschlagen',
    'message.registerSuccess': 'Registrierung erfolgreich',
    'message.registerFail': 'Registrierung fehlgeschlagen',
    'message.saveSuccess': 'Erfolgreich gespeichert',
    'message.saveFail': 'Speichern fehlgeschlagen',
    'message.deleteSuccess': 'Erfolgreich gelöscht',
    'message.deleteFail': 'Löschen fehlgeschlagen',
    'message.bindSuccess': 'Binden erfolgreich',
    'message.bindFail': 'Binden fehlgeschlagen',
    'message.unbindSuccess': 'Entbinden erfolgreich',
    'message.unbindFail': 'Entbinden fehlgeschlagen',
    'message.networkError': 'Netzwerkfehler, bitte Verbindung prüfen',
    'message.serverError': 'Serverfehler, bitte später erneut versuchen',
    'message.invalidAddress': 'Ungültige Adresse, bitte prüfen ob Server gestartet oder Netzwerkverbindung normal ist',
    'message.languageChanged': 'Sprache geändert',
    'message.passwordError': 'Konto oder Passwort Fehler',
    'message.phoneRegistered': 'Diese Handynummer wurde bereits registriert',
    // Agenten-Werkzeuge Seite
    'agent.tools.pageTitle': 'Agenten-Werkzeuge',
    'agent.tools.unselected': 'Nicht ausgewählt',
    'agent.tools.selected': 'Ausgewählt',
    'agent.tools.noMorePlugins': 'Keine weiteren Plugins',
    'agent.tools.pleaseSelectPlugin': 'Bitte Plugin-Funktion auswählen',
    'agent.tools.builtInPlugins': 'Eingebaute Plugins',
    'agent.tools.mcpAccessPoint': 'MCP-Zugangspunkt',
    'agent.tools.copy': 'Kopieren',
    'agent.tools.noTools': 'Keine Werkzeuge verfügbar',
    'agent.tools.parameterConfig': 'Parameterkonfiguration',
    'agent.tools.noParamsNeeded': 'Keine Parameter benötigt',
    'agent.tools.pleaseInput': 'Bitte eingeben',
    'agent.tools.inputOneItemPerLine': 'Ein Element pro Zeile eingeben',
    'agent.tools.pleaseInputValidJson': 'Bitte gültiges JSON-Format eingeben',
    'agent.tools.enableFunction': 'Funktion aktivieren',
    'agent.tools.toggleFunction': 'Diese Funktion ein- oder ausschalten',
    'agent.tools.jsonFormatError': 'JSON-Format Fehler',
    'agent.tools.noMcpAddressToCopy': 'Keine MCP-Adresse zum Kopieren',
    'agent.tools.mcpAddressCopied': 'MCP-Adresse in Zwischenablage kopiert',
    'agent.tools.copyFailed': 'Kopieren fehlgeschlagen, bitte erneut versuchen',
    'agent.tools.defaultValue': 'Standardwert',
    'agent.tools.notSelected': 'Nicht ausgewählt',
    'agent.tools.clickToConfigure': 'Klicken zum Konfigurieren',
    'agent.tools.mcpEndpoint': 'MCP-Endpunkt',
    'agent.tools.eachLineOneItem': 'Ein Element pro Zeile eingeben',
    // Gerätekonfigurationsseite
    'deviceConfig.pageTitle': 'Gerätekonfiguration',
    'deviceConfig.wifiConfig': 'WiFi-Konfiguration',
    'deviceConfig.ultrasonicConfig': 'Ultraschall-Konfiguration',
    'deviceConfig.selectConfigMethod': 'Konfigurationsmethode auswählen',
    'deviceConfig.networkConfig': 'Netzwerkkonfiguration',
    'deviceConfig.selectedNetwork': 'Ausgewähltes Netzwerk',
    'deviceConfig.signal': 'Signal',
    'deviceConfig.openNetwork': 'Offenes Netzwerk',
    'deviceConfig.encryptedNetwork': 'Verschlüsseltes Netzwerk',
    'deviceConfig.password': 'Passwort',
    'deviceConfig.pleaseEnterPassword': 'Bitte WiFi-Passwort eingeben',
    'deviceConfig.startConfig': 'Konfiguration starten',
    'deviceConfig.connectToXiaozhiHotspot': 'Bitte verbinden Sie sich zuerst mit dem xiaozhi Hotspot',
    'deviceConfig.detecting': 'Erkennen...',
    'deviceConfig.reDetect': 'Erneut erkennen',
    'deviceConfig.alreadyConnected': 'Mit xiaozhi Hotspot verbunden',
    'deviceConfig.refreshStatus': 'Status aktualisieren',
    'deviceConfig.wifiNetworks': 'WiFi-Netzwerke',
    'deviceConfig.selectWifiNetwork': 'WiFi-Netzwerk auswählen',
    'deviceConfig.refreshScan': 'Scan aktualisieren',
    'deviceConfig.noWifiNetworks': 'Keine WiFi-Netzwerke verfügbar',
    'deviceConfig.clickToRefreshScan': 'Bitte Scan aktualisieren klicken',
    'deviceConfig.signalStrong': 'Starkes Signal',
    'deviceConfig.signalGood': 'Gutes Signal',
    'deviceConfig.signalFair': 'Mittleres Signal',
    'deviceConfig.signalWeak': 'Schwaches Signal',
    'deviceConfig.channel': 'Kanal',
    'deviceConfig.about': 'ungefähr',
    'deviceConfig.seconds': 'Sekunden',
    'deviceConfig.generating': 'Wird generiert...',
    'deviceConfig.playing': 'Wird abgespielt...',
    'deviceConfig.generateAndPlaySoundWave': 'Schallwelle generieren und abspielen',
    'deviceConfig.playSoundWave': 'Schallwelle abspielen',
    'deviceConfig.stopPlaying': 'Abspielen stoppen',
    'deviceConfig.autoLoopPlaySoundWave': 'Schallwelle automatisch wiederholt abspielen',
    'deviceConfig.configAudioFile': 'Konfigurations-Audio-Datei',
    'deviceConfig.duration': 'Dauer',
    'deviceConfig.ultrasonicConfigInstructions': 'Ultraschall-Konfigurationsanleitung',
    'deviceConfig.ensureWifiNetworkSelectedAndPasswordEntered': 'Stellen Sie sicher, dass WiFi-Netzwerk ausgewählt und Passwort eingegeben ist',
    'deviceConfig.clickGenerateAndPlaySoundWave': 'Klicken Sie auf Schallwelle generieren und abspielen, das System kodiert Konfigurationsinformationen in Audio',
    'deviceConfig.bringPhoneCloseToXiaozhiDevice': 'Bringen Sie das Telefon in die Nähe des xiaozhi Geräts (1-2 Meter Entfernung)',
    'deviceConfig.duringAudioPlaybackXiaozhiWillReceive': 'Während der Audio-Wiedergabe empfängt xiaozhi und dekodiert Konfigurationsinformationen',
    'deviceConfig.afterConfigSuccessDeviceWillConnect': 'Nach erfolgreicher Konfiguration verbindet sich das Gerät automatisch mit dem WiFi-Netzwerk',
    'deviceConfig.usesAfskModulation': 'Verwendet AFSK-Modulationstechnologie, überträgt Daten durch 1800Hz und 1500Hz Frequenzen',
    'deviceConfig.ensureModeratePhoneVolume': 'Bitte stellen Sie sicher, dass die Telefonlautstärke moderat ist, um Umgebungsgeräuschstörungen zu vermeiden',
    'deviceConfig.generatingUltrasonicConfigAudio': 'Ultraschall-Konfigurationsaudio wird generiert',
    'deviceConfig.configData': 'Konfigurationsdaten',
    'deviceConfig.dataBytesLength': 'Datenbytes-Länge',
    'deviceConfig.bitStreamLength': 'Bitstrom-Länge',
    'deviceConfig.base64Length': 'Base64-Länge',
    'deviceConfig.audioFileTooLarge': 'Audio-Datei zu groß, bitte SSID oder Passwortlänge kürzen',
    'deviceConfig.audioGenerationSuccess': 'Audio-Generierung erfolgreich',
    'deviceConfig.samplePoints': 'Abtastpunkte',
    'deviceConfig.soundWaveGenerationSuccess': 'Schallwellen-Generierung erfolgreich',
    'deviceConfig.audioGenerationFailed': 'Audio-Generierung fehlgeschlagen',
    'deviceConfig.soundWaveGenerationFailed': 'Schallwellen-Generierung fehlgeschlagen',
    'deviceConfig.pleaseGenerateAudioFirst': 'Bitte generieren Sie zuerst Audio',
    'deviceConfig.startPlayingUltrasonicConfigAudio': 'Ultraschall-Konfigurationsaudio wird abgespielt',
    'deviceConfig.ultrasonicAudioStartedPlaying': 'Ultraschall-Audio wurde gestartet',
    'deviceConfig.startPlayingConfigSoundWave': 'Konfigurations-Schallwelle wurde gestartet',
    'deviceConfig.ultrasonicAudioPlaybackEnded': 'Ultraschall-Audio-Wiedergabe beendet',
    'deviceConfig.audioPlaybackFailed': 'Audio-Wiedergabe fehlgeschlagen',
    'deviceConfig.audioResourceBusy': 'Audio-Ressource beschäftigt, bitte später erneut versuchen',
    'deviceConfig.audioFormatNotSupported': 'Audio-Format nicht unterstützt, möglicherweise ein Data-URI-Problem',
    'deviceConfig.audioFileError': 'Audio-Datei-Fehler',
    'deviceConfig.cleaningUpAudioContext': 'Audio-Kontext wird bereinigt',
    'deviceConfig.cleaningUpAudioContextFailed': 'Audio-Kontext-Bereinigung fehlgeschlagen',
    'deviceConfig.stoppedPlayingUltrasonicAudio': 'Ultraschall-Audio-Wiedergabe gestoppt',
    'deviceConfig.stoppedPlaying': 'Wiedergabe gestoppt',
    'deviceConfig.configMethod': 'Konfigurationsmethode',
    'deviceConfig.enterWifiPassword': 'Bitte WiFi-Passwort eingeben',
    'deviceConfig.xiaozhi': 'xiaozhi',
    'deviceConfig.connectXiaozhiHotspot': 'Bitte verbinden Sie sich mit dem xiaozhi Hotspot',
    'deviceConfig.wifiScanResponse': 'WiFi-Scan-Antwort',
    'deviceConfig.scanSuccess': 'Scan erfolgreich',
    'deviceConfig.networks': 'Netzwerke',
    'deviceConfig.wifiScanFailed': 'WiFi-Scan fehlgeschlagen',
    'deviceConfig.scanFailedCheckConnection': 'Scan fehlgeschlagen, bitte Verbindung prüfen',
    'deviceConfig.checking': 'Wird geprüft',
    'deviceConfig.reCheck': 'Erneut prüfen',
    'deviceConfig.connectedXiaozhiHotspot': 'Mit xiaozhi Hotspot verbunden',
    'deviceConfig.wifiNetwork': 'WiFi-Netzwerk',
    'deviceConfig.scanning': 'Wird gescannt',
    'deviceConfig.cancel': 'Abbrechen',
    'deviceConfig.clickRefreshScan': 'Bitte Scan aktualisieren klicken',
    'deviceConfig.esp32ConnectionCheckFailed': 'ESP32-Verbindungsprüfung fehlgeschlagen',
    'deviceConfig.startWifiConfig': 'WiFi-Konfiguration wird gestartet',
    'deviceConfig.configSuccess': 'Konfiguration erfolgreich',
    'deviceConfig.deviceWillConnectTo': 'Gerät wird sich verbinden mit',
    'deviceConfig.deviceWillRestart': 'Gerät wird neu starten',
    'deviceConfig.pleaseDisconnectXiaozhiHotspot': 'Bitte trennen Sie sich vom xiaozhi Hotspot',
    'deviceConfig.configFailed': 'Konfiguration fehlgeschlagen',
    'deviceConfig.wifiConfigFailed': 'WiFi-Konfiguration fehlgeschlagen',
    'deviceConfig.pleaseCheckNetworkConnection': 'Bitte Netzwerkverbindung prüfen',
    'deviceConfig.startWifiConfigButton': 'Konfiguration starten',
    'deviceConfig.wifiConfigInstructions': 'WiFi-Konfigurationsanleitung',
    'deviceConfig.phoneConnectXiaozhiHotspot': 'Telefon mit xiaozhi Hotspot verbinden',
    'deviceConfig.selectTargetWifiNetwork': 'Ziel-WiFi-Netzwerk auswählen',
    'deviceConfig.enterWifiPasswordIfNeeded': 'WiFi-Passwort eingeben falls benötigt',
    'deviceConfig.clickStartConfigAndWait': 'Konfiguration starten klicken und warten',
    'deviceConfig.afterConfigSuccessDeviceWillRestart': 'Nach erfolgreicher Konfiguration startet Gerät automatisch neu',
    'deviceConfig.audioPlaybackError': 'Audio-Wiedergabe-Fehler',
    'deviceConfig.playbackFailed': 'Wiedergabe fehlgeschlagen',
 }
@@ -3,15 +3,19 @@ import { useLangStore } from '@/store/lang'
 import type { Language } from '@/store/lang'
 // 导入各个语言的翻译文件
-import zhCN from './zh_CN'
+import zh_CN from './zh_CN'
 import en from './en'
-import zhTW from './zh_TW'
+import zh_TW from './zh_TW'
 import de from './de'
 import vi from './vi'
 // 语言包映射
 const messages = {
-  zh_CN: zhCN,
+  zh_CN: zh_CN,
  en,
-  zh_TW: zhTW,
+  zh_TW: zh_TW,
  de,
  vi,
 }
 // 当前使用的语言
@@ -61,10 +65,12 @@ export function getCurrentLanguage(): Language {
 }
 // 获取支持的语言列表
-export function getSupportedLanguages(): {code: Language, name: string}[] {
+export function getSupportedLanguages(): { code: Language, name: string }[] {
  return [
    { code: 'zh_CN', name: '简体中文' },
    { code: 'en', name: 'English' },
    { code: 'zh_TW', name: '繁體中文' },
    { code: 'de', name: 'Deutsch' },
    { code: 'vi', name: 'Tiếng Việt' },
  ]
 }
@@ -0,0 +1,440 @@
 // Gói ngôn ngữ tiếng Việt
 export default {
    // TabBar
    'tabBar.home': 'Trang chủ',
    'tabBar.deviceConfig': 'Cấu hình mạng',
    'tabBar.settings': 'Hệ thống',
    // Tiêu đề trang cài đặt
    'settings.title': 'Cài đặt',
    // Trang đăng nhập
    'login.pageTitle': 'Đăng nhập',
    'login.navigationTitle': 'Đăng nhập',
    'login.fetchConfigError': 'Không thể tải cấu hình:',
    'login.selectLanguage': 'Chọn ngôn ngữ',
    'login.selectLanguageTip': 'de',
    'login.welcomeBack': 'Chào mừng trở lại',
    'login.pleaseLogin': 'Vui lòng đăng nhập vào tài khoản của bạn',
    'login.enterUsername': 'Vui lòng nhập tên đăng nhập',
    'login.enterPassword': 'Vui lòng nhập mật khẩu',
    'login.enterCaptcha': 'Vui lòng nhập mã xác minh',
    'login.loginButton': 'Đăng nhập',
    'login.loggingIn': 'Đang đăng nhập...',
    'login.noAccount': 'Đăng ký',
    'login.enterPhone': 'Vui lòng nhập số điện thoại',
    'login.selectCountry': 'Chọn quốc gia/vùng',
    'login.confirm': 'Xác nhận',
    'login.serverSetting': 'Cài đặt máy chủ',
    'login.requiredUsername': 'Tên đăng nhập không thể để trống',
    'login.requiredPassword': 'Mật khẩu không thể để trống',
    'login.requiredCaptcha': 'Mã xác minh không thể để trống',
    'login.requiredMobile': 'Vui lòng nhập số điện thoại hợp lệ',
    'login.captchaError': 'Lỗi mã xác minh đồ họa',
    'login.forgotPassword': 'Quên mật khẩu',
    // Trang đăng ký
    'register.pageTitle': 'Đăng ký',
    'register.createAccount': 'Tạo tài khoản',
    'register.enterUsername': 'Vui lòng nhập tên đăng nhập',
    'register.enterPassword': 'Vui lòng nhập mật khẩu',
    'register.confirmPassword': 'Vui lòng xác nhận mật khẩu',
    'register.enterPhone': 'Vui lòng nhập số điện thoại',
    'register.enterCode': 'Vui lòng nhập mã xác minh',
    'register.getCode': 'Lấy mã',
    'register.agreeTerms': 'Tôi đã đọc và đồng ý với',
    'register.terms': 'Thỏa thuận người dùng',
    'register.privacy': 'Chính sách bảo mật',
    'register.registerButton': 'Đăng ký',
    'register.registering': 'Đang đăng ký...',
    'register.haveAccount': 'Đã có tài khoản?',
    'register.loginNow': 'Đăng nhập ngay',
    'register.selectCountry': 'Chọn quốc gia/vùng',
    'register.confirm': 'Xác nhận',
    'register.captchaSendSuccess': 'Đã gửi mã xác minh thành công',
    // Trang chủ
    'home.pageTitle': 'Trang chủ',
    'home.createAgent': 'Tạo đại lý',
    'home.agentName': 'Đại lý',
    'home.modelInfo': 'Thông tin mô hình',
    'home.lastActive': 'Hoạt động lần cuối',
    'home.greeting': 'Xin chào Jarvis',
    'home.subtitle': 'Hãy cùng có',
    'home.wonderfulDay': 'một ngày tuyệt vời!',
    'home.emptyState': 'Không có đại lý nào',
    'home.deviceManagement': 'Quản lý thiết bị',
    'home.lastConversation': 'Cuộc trò chuyện cuối:',
    'home.delete': 'Xóa',
    'home.createFirstAgent': 'Nhấp vào nút + ở góc dưới bên phải để tạo đại lý đầu tiên của bạn',
    'home.dialogTitle': 'Tạo đại lý',
    'home.inputPlaceholder': 'ví dụ: Trợ lý chăm sóc khách hàng, Trợ lý giọng nói, Hỏi đáp kiến thức',
    'home.createError': 'Vui lòng nhập tên đại lý',
    'home.createNow': 'Tạo ngay',
    'home.justNow': 'Vừa xong',
    'home.minutesAgo': 'phút trước',
    'home.hoursAgo': 'giờ trước',
    'home.daysAgo': 'ngày trước',
    // Trang đại lý
    'agent.pageTitle': 'Đại lý',
    'agent.roleConfig': 'Cấu hình vai trò',
    'agent.deviceManagement': 'Quản lý thiết bị',
    'agent.chatHistory': 'Lịch sử trò chuyện',
    'agent.voiceprintManagement': 'Quản lý dấu giọng nói',
    'agent.editTitle': 'Chỉnh sửa đại lý',
    'agent.toolsTitle': 'Chỉnh sửa tính năng',
    'agent.voiceActivityDetection': 'Phát hiện hoạt động giọng nói',
    'agent.speechRecognition': 'Nhận dạng giọng nói',
    'agent.largeLanguageModel': 'Mô hình ngôn ngữ lớn',
    'agent.save': 'Lưu',
    'agent.cancel': 'Hủy',
    // Trang chỉnh sửa đại lý
    'agent.basicInfo': 'Thông tin cơ bản',
    'agent.agentName': 'Tên đại lý',
    'agent.inputAgentName': 'Vui lòng nhập tên đại lý',
    'agent.roleMode': 'Chế độ vai trò',
    'agent.roleDescription': 'Mô tả vai trò',
    'agent.inputRoleDescription': 'Vui lòng nhập mô tả vai trò',
    'agent.modelConfig': 'Cấu hình mô hình',
    'agent.vad': 'Phát hiện hoạt động giọng nói',
    'agent.asr': 'Nhận dạng giọng nói',
    'agent.llm': 'Mô hình ngôn ngữ lớn',
    'agent.vllm': 'Mô hình ngôn ngữ thị giác',
    'agent.intent': 'Nhận dạng ý định',
    'agent.memory': 'Bộ nhớ',
    'agent.voiceSettings': 'Cài đặt giọng nói',
    'agent.tts': 'Văn bản thành giọng nói',
    'agent.voiceprint': 'Giọng nói đại lý',
    'agent.plugins': 'Plugin',
    'agent.editFunctions': 'Chỉnh sửa tính năng',
    'agent.historyMemory': 'Bộ nhớ lịch sử',
    'agent.memoryContent': 'Nội dung bộ nhớ',
    'agent.saving': 'Đang lưu...',
    'agent.saveSuccess': 'Lưu thành công',
    'agent.saveFail': 'Lưu thất bại',
    'agent.loadFail': 'Tải thất bại',
    'agent.pleaseInputAgentName': 'Vui lòng nhập tên đại lý',
    'agent.pleaseInputRoleDescription': 'Vui lòng nhập mô tả vai trò',
    'agent.pleaseSelect': 'Vui lòng chọn',
    // Trang lịch sử trò chuyện
    'chatHistory.getChatSessions': 'Lấy danh sách phiên trò chuyện',
    'chatHistory.noSelectedAgent': 'Chưa chọn đại lý',
    'chatHistory.getChatSessionsFailed': 'Không thể lấy danh sách phiên trò chuyện:',
    'chatHistory.unknownTime': 'Thời gian không xác định',
    'chatHistory.justNow': 'Vừa xong',
    'chatHistory.minutesAgo': '{minutes} phút trước',
    'chatHistory.hoursAgo': '{hours} giờ trước',
    'chatHistory.daysAgo': '{days} ngày trước',
    'chatHistory.conversationRecord': 'Bản ghi trò chuyện',
    'chatHistory.totalChats': 'Tổng cộng {count} cuộc trò chuyện',
    'chatHistory.loading': 'Đang tải...',
    'chatHistory.noMoreData': 'Không còn dữ liệu',
    'chatHistory.noChatRecords': 'Không có bản ghi trò chuyện',
    'chatHistory.chatRecordsDescription': 'Bản ghi trò chuyện với đại lý sẽ hiển thị ở đây',
    // Trang chi tiết lịch sử trò chuyện
    'chatHistory.pageTitle': 'Chi tiết trò chuyện',
    'chatHistory.assistantName': 'Trợ lý thông minh',
    'chatHistory.userName': 'Người dùng',
    'chatHistory.aiAssistantName': 'Trợ lý AI',
    'chatHistory.loadFailed': 'Không thể tải lịch sử trò chuyện',
    'chatHistory.parameterError': 'Lỗi tham số trang',
    'chatHistory.invalidAudioId': 'ID âm thanh không hợp lệ',
    'chatHistory.audioPlayFailed': 'Phát âm thanh thất bại',
    'chatHistory.playAudioFailed': 'Không thể phát âm thanh',
    // Trang quản lý thiết bị
    'device.pageTitle': 'Quản lý thiết bị',
    'device.noDevices': 'Không có thiết bị nào',
    'device.macAddress': 'Địa chỉ MAC',
    'device.firmwareVersion': 'Phiên bản firmware',
    'device.lastConnected': 'Cuộc trò chuyện cuối',
    'device.otaUpdate': 'Cập nhật OTA',
    'device.unbind': 'Hủy liên kết',
    'device.confirmUnbind': 'Xác nhận',
    'device.bindDevice': 'Liên kết thiết bị mới',
    'device.deviceType': 'Loại thiết bị',
    'device.loading': 'Đang tải...',
    'device.neverConnected': 'Chưa kết nối',
    'device.justNow': 'Vừa xong',
    'device.minutesAgo': '{minutes} phút trước',
    'device.hoursAgo': '{hours} giờ trước',
    'device.daysAgo': '{days} ngày trước',
    'device.otaAutoUpdateEnabled': 'Đã bật cập nhật OTA tự động',
    'device.otaAutoUpdateDisabled': 'Đã tắt cập nhật OTA tự động',
    'device.operationFailed': 'Thao tác thất bại, vui lòng thử lại',
    'device.deviceUnbound': 'Đã hủy liên kết thiết bị',
    'device.unbindFailed': 'Hủy liên kết thất bại, vui lòng thử lại',
    'device.unbindDevice': 'Hủy liên kết thiết bị',
    'device.confirmUnbindDevice': 'Bạn có chắc chắn muốn hủy liên kết thiết bị "{macAddress}"?',
    'device.cancel': 'Hủy',
    'device.noDevice': 'Không có thiết bị',
    'device.pleaseSelectAgent': 'Vui lòng chọn một đại lý trước',
    'device.deviceBindSuccess': 'Liên kết thiết bị thành công!',
    'device.bindFailed': 'Liên kết thất bại, vui lòng kiểm tra mã xác minh có đúng không',
    'device.enterDeviceCode': 'Vui lòng nhập mã xác minh thiết bị',
    'device.bindNow': 'Liên kết ngay',
    'device.lastConnection': 'Kết nối cuối',
    'device.clickToBindFirstDevice': 'Nhấp vào nút + ở góc dưới bên phải để liên kết thiết bị đầu tiên của bạn',
    // Chung
    'common.success': 'Thành công',
    'common.fail': 'Thất bại',
    'common.loading': 'Đang tải...',
    'common.confirm': 'Xác nhận',
    'common.cancel': 'Hủy',
    'common.delete': 'Xóa',
    'common.edit': 'Chỉnh sửa',
    'common.add': 'Thêm',
    'common.pleaseSelect': 'Vui lòng chọn',
    'common.unknownError': 'Lỗi không xác định',
    'common.networkError': 'Lỗi mạng',
    // Trang khôi phục mật khẩu
    'retrievePassword.title': 'Đặt lại mật khẩu',
    'retrievePassword.subtitle': 'Khôi phục mật khẩu tài khoản qua số điện thoại',
    'retrievePassword.mobileRequired': 'Vui lòng nhập số điện thoại',
    'retrievePassword.inputCorrectMobile': 'Vui lòng nhập số điện thoại hợp lệ',
    'retrievePassword.captchaRequired': 'Vui lòng nhập mã xác minh đồ họa',
    'retrievePassword.mobileCaptchaRequired': 'Vui lòng nhập mã xác minh SMS',
    'retrievePassword.newPasswordRequired': 'Vui lòng nhập mật khẩu mới',
    'retrievePassword.confirmNewPasswordRequired': 'Vui lòng xác nhận mật khẩu mới',
    'retrievePassword.passwordsNotMatch': 'Mật khẩu không khớp',
    'retrievePassword.mobilePlaceholder': 'Vui lòng nhập số điện thoại',
    'retrievePassword.captchaPlaceholder': 'Vui lòng nhập mã xác minh đồ họa',
    'retrievePassword.mobileCaptchaPlaceholder': 'Vui lòng nhập mã xác minh SMS',
    'retrievePassword.newPasswordPlaceholder': 'Vui lòng nhập mật khẩu mới',
    'retrievePassword.confirmNewPasswordPlaceholder': 'Vui lòng xác nhận mật khẩu mới',
    'retrievePassword.getMobileCaptcha': 'Lấy mã',
    'retrievePassword.captchaSendSuccess': 'Đã gửi mã xác minh thành công',
    'retrievePassword.passwordUpdateSuccess': 'Đặt lại mật khẩu thành công',
    'retrievePassword.resetButton': 'Đặt lại mật khẩu',
    'retrievePassword.goToLogin': 'Quay lại đăng nhập',
    // Thông báo lỗi liên quan đến mã hóa SM2
    'sm2.publicKeyNotConfigured': 'Khóa công khai SM2 chưa được cấu hình, vui lòng liên hệ quản trị viên',
    'sm2.encryptionFailed': 'Mã hóa mật khẩu thất bại',
    'sm2.keyGenerationFailed': 'Tạo cặp khóa thất bại',
    'sm2.invalidPublicKey': 'Định dạng khóa công khai không hợp lệ',
    'sm2.encryptionError': 'Đã xảy ra lỗi khi mã hóa',
    'sm2.publicKeyRetry': 'Đang thử lấy lại khóa công khai...',
    'sm2.publicKeyRetryFailed': 'Thử lấy lại khóa công khai thất bại',
    // Trang dấu giọng nói
    'voiceprint.noSelectedAgent': 'Chưa chọn đại lý',
    'voiceprint.pleaseSelectAgent': 'Vui lòng chọn một đại lý trước',
    'voiceprint.fetchHistoryFailed': 'Không thể tải lịch sử trò chuyện',
    'voiceprint.clickToSelectVector': 'Nhấp để chọn vector dấu giọng nói',
    'voiceprint.pleaseInputName': 'Vui lòng nhập tên',
    'voiceprint.pleaseSelectVector': 'Vui lòng chọn vector dấu giọng nói',
    'voiceprint.addSuccess': 'Thêm thành công',
    'voiceprint.addFailed': 'Thêm người nói thất bại',
    'voiceprint.editSuccess': 'Chỉnh sửa thành công',
    'voiceprint.editFailed': 'Chỉnh sửa người nói thất bại',
    'voiceprint.deleteConfirmMsg': 'Bạn có chắc chắn muốn xóa người nói này?',
    'voiceprint.deleteConfirmTitle': 'Xác nhận xóa',
    'voiceprint.deleteSuccess': 'Xóa thành công',
    'voiceprint.loading': 'Đang tải...',
    'voiceprint.delete': 'Xóa',
    'voiceprint.emptyTitle': 'Không có dữ liệu dấu giọng nói',
    'voiceprint.emptyDesc': 'Nhấp vào nút + ở góc dưới bên phải để thêm người nói đầu tiên của bạn',
    'voiceprint.addSpeaker': 'Thêm người nói',
    'voiceprint.voiceVector': 'Vector dấu giọng nói',
    'voiceprint.name': 'Tên',
    'voiceprint.description': 'Mô tả',
    'voiceprint.pleaseInputDescription': 'Vui lòng nhập mô tả',
    'voiceprint.cancel': 'Hủy',
    'voiceprint.save': 'Lưu',
    'voiceprint.editSpeaker': 'Chỉnh sửa người nói',
    'voiceprint.selectVector': 'Chọn vector dấu giọng nói',
    'voiceprint.voiceprintInterfaceNotConfigured': 'Giao diện dấu giọng nói chưa được cấu hình',
    // Trang cài đặt
    'settings.pageTitle': 'Cài đặt',
    'settings.navigationTitle': 'Cài đặt',
    'settings.networkSettings': 'Cài đặt mạng',
    'settings.serverApiUrl': 'URL API máy chủ',
    'settings.validServerUrl': 'Vui lòng nhập địa chỉ máy chủ hợp lệ (bắt đầu bằng http hoặc https và kết thúc bằng /xiaozhi)',
    'settings.saveSettings': 'Lưu cài đặt',
    'settings.resetDefault': 'Đặt lại mặc định',
    'settings.restartApp': 'Khởi động lại ứng dụng',
    'settings.restartNow': 'Khởi động lại ngay',
    'settings.restartLater': 'Để sau',
    // Về chúng tôi
    'settings.aboutApp': 'Về Bảng điều khiển XiaoZhi',
    'settings.aboutContent': 'Bảng điều khiển XiaoZhi\n\nỨng dụng quản lý di động đa nền tảng được xây dựng với Vue.js 3 + uni-app, cung cấp quản lý thiết bị, cấu hình đại lý và các chức năng khác cho phần cứng thông minh xiaozhi ESP32.\n\n© 2025 xiaozhi-esp32-server {version}',
    'settings.restartSuccess': 'Đã lưu, bạn có thể tự khởi động lại ứng dụng sau',
    'settings.serverUrlSavedAndCacheCleared': 'Đã lưu URL máy chủ và xóa bộ nhớ cache',
    'settings.resetToDefaultAndCacheCleared': 'Đã đặt lại mặc định và xóa bộ nhớ cache',
    'settings.resetSuccess': 'Đặt lại thành công',
    'settings.enterServerUrl': 'Vui lòng nhập URL máy chủ',
    'settings.clearCacheFailed': 'Không thể xóa bộ nhớ cache',
    'settings.cacheManagement': 'Quản lý bộ nhớ cache',
    'settings.totalCacheSize': 'Tổng kích thước bộ nhớ cache',
    'settings.appDataSize': 'Tổng kích thước dữ liệu ứng dụng',
    'settings.cacheClear': 'Xóa bộ nhớ cache',
    'settings.clearAllCache': 'Xóa tất cả dữ liệu bộ nhớ cache',
    'settings.clearCache': 'Xóa bộ nhớ cache',
    'settings.modifyWillClearCache': 'Thay đổi sẽ xóa bộ nhớ cache',
    'settings.appInfo': 'Thông tin ứng dụng',
    'settings.aboutUs': 'Về chúng tôi',
    'settings.appVersion': 'Phiên bản ứng dụng & Thông tin nhóm',
    'settings.confirmClear': 'Xác nhận xóa',
    'settings.confirmClearMessage': 'Bạn có chắc chắn muốn xóa toàn bộ bộ nhớ cache? Điều này sẽ xóa tất cả dữ liệu bao gồm trạng thái đăng nhập và yêu cầu đăng nhập lại.',
    'settings.cacheCleared': 'Đã xóa bộ nhớ cache thành công, đang chuyển hướng đến trang đăng nhập',
    'settings.languageSettings': 'Cài đặt ngôn ngữ',
    'settings.language': 'Ngôn ngữ',
    'settings.selectLanguage': 'Chọn ngôn ngữ',
    'settings.languageChanged': 'Đã thay đổi ngôn ngữ thành công',
    // Thông báo
    'message.loginSuccess': 'Đăng nhập thành công!',
    'message.loginFail': 'Đăng nhập thất bại',
    'message.registerSuccess': 'Đăng ký thành công',
    'message.registerFail': 'Đăng ký thất bại',
    'message.saveSuccess': 'Lưu thành công',
    'message.saveFail': 'Lưu thất bại',
    'message.deleteSuccess': 'Xóa thành công',
    'message.deleteFail': 'Xóa thất bại',
    'message.bindSuccess': 'Liên kết thành công',
    'message.bindFail': 'Liên kết thất bại',
    'message.unbindSuccess': 'Hủy liên kết thành công',
    'message.unbindFail': 'Hủy liên kết thất bại',
    'message.networkError': 'Lỗi mạng, vui lòng kiểm tra kết nối',
    'message.serverError': 'Lỗi máy chủ, vui lòng thử lại sau',
    'message.invalidAddress': 'Địa chỉ không hợp lệ, vui lòng kiểm tra máy chủ đã khởi động hoặc kết nối mạng bình thường',
    'message.languageChanged': 'Đã thay đổi ngôn ngữ',
    'message.passwordError': 'Lỗi tài khoản hoặc mật khẩu',
    'message.phoneRegistered': 'Số điện thoại này đã được đăng ký',
    // Trang công cụ đại lý
    'agent.tools.pageTitle': 'Công cụ đại lý',
    'agent.tools.unselected': 'Chưa chọn',
    'agent.tools.selected': 'Đã chọn',
    'agent.tools.noMorePlugins': 'Không còn plugin',
    'agent.tools.pleaseSelectPlugin': 'Vui lòng chọn chức năng plugin',
    'agent.tools.builtInPlugins': 'Plugin tích hợp',
    'agent.tools.mcpAccessPoint': 'Điểm truy cập MCP',
    'agent.tools.copy': 'Sao chép',
    'agent.tools.noTools': 'Không có công cụ nào',
    'agent.tools.parameterConfig': 'Cấu hình tham số',
    'agent.tools.noParamsNeeded': 'Không cần tham số',
    'agent.tools.pleaseInput': 'Vui lòng nhập',
    'agent.tools.inputOneItemPerLine': 'Nhập một mục mỗi dòng',
    'agent.tools.pleaseInputValidJson': 'Vui lòng nhập định dạng JSON hợp lệ',
    'agent.tools.enableFunction': 'Bật chức năng',
    'agent.tools.toggleFunction': 'Bật hoặc tắt chức năng này',
    'agent.tools.jsonFormatError': 'Lỗi định dạng JSON',
    'agent.tools.noMcpAddressToCopy': 'Không có địa chỉ MCP để sao chép',
    'agent.tools.mcpAddressCopied': 'Đã sao chép địa chỉ MCP vào bộ nhớ tạm',
    'agent.tools.copyFailed': 'Sao chép thất bại, vui lòng thử lại',
    'agent.tools.defaultValue': 'Giá trị mặc định',
    'agent.tools.notSelected': 'Chưa chọn',
    'agent.tools.clickToConfigure': 'Nhấp để cấu hình',
    'agent.tools.mcpEndpoint': 'Điểm cuối MCP',
    'agent.tools.eachLineOneItem': 'Nhập một mục mỗi dòng',
    // Trang cấu hình thiết bị
    'deviceConfig.pageTitle': 'Cấu hình thiết bị',
    'deviceConfig.wifiConfig': 'Cấu hình WiFi',
    'deviceConfig.ultrasonicConfig': 'Cấu hình siêu âm',
    'deviceConfig.selectConfigMethod': 'Chọn phương pháp cấu hình',
    'deviceConfig.networkConfig': 'Cấu hình mạng',
    'deviceConfig.selectedNetwork': 'Mạng đã chọn',
    'deviceConfig.signal': 'Tín hiệu',
    'deviceConfig.openNetwork': 'Mạng mở',
    'deviceConfig.encryptedNetwork': 'Mạng mã hóa',
    'deviceConfig.password': 'Mật khẩu',
    'deviceConfig.pleaseEnterPassword': 'Vui lòng nhập mật khẩu WiFi',
    'deviceConfig.startConfig': 'Bắt đầu cấu hình',
    'deviceConfig.connectToXiaozhiHotspot': 'Vui lòng kết nối với điểm phát sóng xiaozhi trước',
    'deviceConfig.detecting': 'Đang phát hiện...',
    'deviceConfig.reDetect': 'Phát hiện lại',
    'deviceConfig.alreadyConnected': 'Đã kết nối với điểm phát sóng xiaozhi',
    'deviceConfig.refreshStatus': 'Làm mới trạng thái',
    'deviceConfig.wifiNetworks': 'Mạng WiFi',
    'deviceConfig.selectWifiNetwork': 'Chọn mạng WiFi',
    'deviceConfig.refreshScan': 'Làm mới quét',
    'deviceConfig.noWifiNetworks': 'Không có mạng WiFi nào',
    'deviceConfig.clickToRefreshScan': 'Vui lòng nhấp Làm mới quét',
    'deviceConfig.signalStrong': 'Tín hiệu mạnh',
    'deviceConfig.signalGood': 'Tín hiệu tốt',
    'deviceConfig.signalFair': 'Tín hiệu trung bình',
    'deviceConfig.signalWeak': 'Tín hiệu yếu',
    'deviceConfig.channel': 'Kênh',
    'deviceConfig.about': 'khoảng',
    'deviceConfig.seconds': 'giây',
    'deviceConfig.generating': 'Đang tạo...',
    'deviceConfig.playing': 'Đang phát...',
    'deviceConfig.generateAndPlaySoundWave': 'Tạo và phát sóng âm',
    'deviceConfig.playSoundWave': 'Phát sóng âm',
    'deviceConfig.stopPlaying': 'Dừng phát',
    'deviceConfig.autoLoopPlaySoundWave': 'Tự động lặp phát sóng âm',
    'deviceConfig.configAudioFile': 'Tệp âm thanh cấu hình',
    'deviceConfig.duration': 'Thời lượng',
    'deviceConfig.ultrasonicConfigInstructions': 'Hướng dẫn cấu hình siêu âm',
    'deviceConfig.ensureWifiNetworkSelectedAndPasswordEntered': 'Đảm bảo mạng WiFi được chọn và mật khẩu đã nhập',
    'deviceConfig.clickGenerateAndPlaySoundWave': 'Nhấp Tạo và phát sóng âm, hệ thống sẽ mã hóa thông tin cấu hình thành âm thanh',
    'deviceConfig.bringPhoneCloseToXiaozhiDevice': 'Đưa điện thoại lại gần thiết bị xiaozhi (khoảng cách 1-2 mét)',
    'deviceConfig.duringAudioPlaybackXiaozhiWillReceive': 'Trong khi phát âm thanh, xiaozhi sẽ nhận và giải mã thông tin cấu hình',
    'deviceConfig.afterConfigSuccessDeviceWillConnect': 'Sau khi cấu hình thành công, thiết bị sẽ tự động kết nối với mạng WiFi',
    'deviceConfig.usesAfskModulation': 'Sử dụng công nghệ điều chế AFSK, truyền dữ liệu qua tần số 1800Hz và 1500Hz',
    'deviceConfig.ensureModeratePhoneVolume': 'Vui lòng đảm bảo âm lượng điện thoại vừa phải để tránh nhiễu tiếng ồn môi trường',
    'deviceConfig.generatingUltrasonicConfigAudio': 'Đang tạo âm thanh cấu hình siêu âm',
    'deviceConfig.configData': 'Dữ liệu cấu hình',
    'deviceConfig.dataBytesLength': 'Độ dài byte dữ liệu',
    'deviceConfig.bitStreamLength': 'Độ dài luồng bit',
    'deviceConfig.base64Length': 'Độ dài base64',
    'deviceConfig.audioFileTooLarge': 'Tệp âm thanh quá lớn, vui lòng rút ngắn SSID hoặc độ dài mật khẩu',
    'deviceConfig.audioGenerationSuccess': 'Tạo âm thanh thành công',
    'deviceConfig.samplePoints': 'Điểm mẫu',
    'deviceConfig.soundWaveGenerationSuccess': 'Tạo sóng âm thành công',
    'deviceConfig.audioGenerationFailed': 'Tạo âm thanh thất bại',
    'deviceConfig.soundWaveGenerationFailed': 'Tạo sóng âm thất bại',
    'deviceConfig.pleaseGenerateAudioFirst': 'Vui lòng tạo âm thanh trước',
    'deviceConfig.startPlayingUltrasonicConfigAudio': 'Bắt đầu phát âm thanh cấu hình siêu âm',
    'deviceConfig.ultrasonicAudioStartedPlaying': 'Đã bắt đầu phát âm thanh siêu âm',
    'deviceConfig.startPlayingConfigSoundWave': 'Đã bắt đầu phát sóng âm cấu hình',
    'deviceConfig.ultrasonicAudioPlaybackEnded': 'Kết thúc phát âm thanh siêu âm',
    'deviceConfig.audioPlaybackFailed': 'Phát âm thanh thất bại',
    'deviceConfig.audioResourceBusy': 'Tài nguyên âm thanh bận, vui lòng thử lại sau',
    'deviceConfig.audioFormatNotSupported': 'Định dạng âm thanh không được hỗ trợ, có thể là vấn đề URI dữ liệu',
    'deviceConfig.audioFileError': 'Lỗi tệp âm thanh',
    'deviceConfig.cleaningUpAudioContext': 'Đang dọn dẹp ngữ cảnh âm thanh',
    'deviceConfig.cleaningUpAudioContextFailed': 'Không thể dọn dẹp ngữ cảnh âm thanh',
    'deviceConfig.stoppedPlayingUltrasonicAudio': 'Đã dừng phát âm thanh siêu âm',
    'deviceConfig.stoppedPlaying': 'Đã dừng phát',
    'deviceConfig.configMethod': 'Phương pháp cấu hình',
    'deviceConfig.enterWifiPassword': 'Vui lòng nhập mật khẩu WiFi',
    'deviceConfig.xiaozhi': 'xiaozhi',
    'deviceConfig.connectXiaozhiHotspot': 'Vui lòng kết nối với điểm phát sóng xiaozhi',
    'deviceConfig.wifiScanResponse': 'Phản hồi quét WiFi',
    'deviceConfig.scanSuccess': 'Quét thành công',
    'deviceConfig.networks': 'mạng',
    'deviceConfig.wifiScanFailed': 'Quét WiFi thất bại',
    'deviceConfig.scanFailedCheckConnection': 'Quét thất bại, vui lòng kiểm tra kết nối',
    'deviceConfig.checking': 'Đang kiểm tra',
    'deviceConfig.reCheck': 'Kiểm tra lại',
    'deviceConfig.connectedXiaozhiHotspot': 'Đã kết nối với điểm phát sóng xiaozhi',
    'deviceConfig.wifiNetwork': 'Mạng WiFi',
    'deviceConfig.scanning': 'Đang quét',
    'deviceConfig.cancel': 'Hủy',
    'deviceConfig.clickRefreshScan': 'Vui lòng nhấp Làm mới quét',
    'deviceConfig.esp32ConnectionCheckFailed': 'Kiểm tra kết nối ESP32 thất bại',
    'deviceConfig.startWifiConfig': 'Đang bắt đầu cấu hình WiFi',
    'deviceConfig.configSuccess': 'Cấu hình thành công',
    'deviceConfig.deviceWillConnectTo': 'Thiết bị sẽ kết nối với',
    'deviceConfig.deviceWillRestart': 'Thiết bị sẽ khởi động lại',
    'deviceConfig.pleaseDisconnectXiaozhiHotspot': 'Vui lòng ngắt kết nối khỏi điểm phát sóng xiaozhi',
    'deviceConfig.configFailed': 'Cấu hình thất bại',
    'deviceConfig.wifiConfigFailed': 'Cấu hình WiFi thất bại',
    'deviceConfig.pleaseCheckNetworkConnection': 'Vui lòng kiểm tra kết nối mạng',
    'deviceConfig.startWifiConfigButton': 'Bắt đầu cấu hình',
    'deviceConfig.wifiConfigInstructions': 'Hướng dẫn cấu hình WiFi',
    'deviceConfig.phoneConnectXiaozhiHotspot': 'Điện thoại kết nối với điểm phát sóng xiaozhi',
    'deviceConfig.selectTargetWifiNetwork': 'Chọn mạng WiFi mục tiêu',
    'deviceConfig.enterWifiPasswordIfNeeded': 'Nhập mật khẩu WiFi nếu cần',
    'deviceConfig.clickStartConfigAndWait': 'Nhấp Bắt đầu cấu hình và chờ',
    'deviceConfig.afterConfigSuccessDeviceWillRestart': 'Sau khi cấu hình thành công, thiết bị sẽ tự động khởi động lại',
    'deviceConfig.audioPlaybackError': 'Lỗi phát âm thanh',
    'deviceConfig.playbackFailed': 'Phát thất bại',
 }
@@ -46,13 +46,9 @@ export default {
  'retrievePassword.mobileCaptchaPlaceholder': '請輸入手機驗證碼',
  'retrievePassword.newPasswordPlaceholder': '請輸入新密碼',
  'retrievePassword.confirmNewPasswordPlaceholder': '請確認新密碼',
  'retrievePassword.confirmPasswordPlaceholder': '請確認新密碼',
  'retrievePassword.captchaSendSuccess': '驗證碼發送成功',
  'retrievePassword.passwordUpdateSuccess': '密碼更新成功',
  'retrievePassword.getCaptcha': '獲取驗證碼',
  'retrievePassword.getMobileCaptcha': '獲取驗證碼',
-  'retrievePassword.resend': '重新發送',
+  'retrievePassword.captchaSendSuccess': '驗證碼發送成功',
-  'retrievePassword.resetPasswordButton': '重置密碼',
+  'retrievePassword.passwordUpdateSuccess': '密碼重置成功',
  'retrievePassword.resetButton': '重置密碼',
  'retrievePassword.goToLogin': '返回登錄',
@@ -7,12 +7,12 @@
 }</route>
 <script lang="ts" setup>
 import { changeLanguage, getCurrentLanguage, getSupportedLanguages, t } from '@/i18n'
 import type { Language } from '@/store/lang'
 import { clearServerBaseUrlOverride, getEnvBaseUrl, getServerBaseUrlOverride, setServerBaseUrlOverride } from '@/utils'
 import { isMp } from '@/utils/platform'
 import { computed, onMounted, reactive, ref } from 'vue'
 import { useToast } from 'wot-design-uni'
 import { t, changeLanguage, getSupportedLanguages, getCurrentLanguage } from '@/i18n'
 import type { Language } from '@/store/lang'
 defineOptions({
  name: 'SettingsPage',
@@ -233,9 +233,9 @@ async function clearCache() {
 function showAbout() {
  uni.showModal({
    title: t('settings.aboutApp', { appName: import.meta.env.VITE_APP_TITLE }),
-    content: t('settings.aboutContent', { 
+    content: t('settings.aboutContent', {
      appName: import.meta.env.VITE_APP_TITLE,
-      version: '0.8.5'
+      version: '0.8.10'
    }),
    showCancel: false,
    confirmText: t('common.confirm'),
@@ -248,7 +248,7 @@ onMounted(async () => {
    loadServerBaseUrl()
  }
  getCacheInfo()
-  
+
  // 动态设置导航栏标题为国际化文本
  uni.setNavigationBarTitle({
    title: t('settings.title')
@@ -283,9 +283,9 @@ onMounted(async () => {
          <view class="mb-[24rpx]">
            <view class="w-full rounded-[16rpx] border border-[#eeeeee] bg-[#f5f7fb] overflow-hidden">
              <wd-input v-model="baseUrlInput" type="text" clearable :maxlength="200"
-              :placeholder="t('settings.enterServerUrl')"
+                :placeholder="t('settings.enterServerUrl')"
-              custom-class="!border-none !bg-transparent h-[64rpx] px-[24rpx] items-center"
+                custom-class="!border-none !bg-transparent h-[64rpx] px-[24rpx] items-center"
-              input-class="text-[28rpx] text-[#232338]" @input="validateUrl" @blur="validateUrl" />
+                input-class="text-[28rpx] text-[#232338]" @input="validateUrl" @blur="validateUrl" />
            </view>
            <text v-if="urlError" class="mt-[8rpx] block text-[24rpx] text-[#ff4d4f]">
              {{ urlError }}
@@ -323,11 +323,11 @@ onMounted(async () => {
              class="flex items-center justify-between border border-[#eeeeee] rounded-[16rpx] bg-[#f5f7fb] p-[24rpx] transition-all active:bg-[#eef3ff]">
              <view>
                <text class="text-[28rpx] text-[#232338] font-medium">
-              {{ t('settings.totalCacheSize') }}
+                  {{ t('settings.totalCacheSize') }}
-            </text>
+                </text>
-            <text class="mt-[4rpx] block text-[24rpx] text-[#9d9ea3]">
+                <text class="mt-[4rpx] block text-[24rpx] text-[#9d9ea3]">
-              {{ t('settings.appDataSize') }}
+                  {{ t('settings.appDataSize') }}
-            </text>
+                </text>
              </view>
              <text class="text-[28rpx] text-[#65686f] font-semibold">
                {{ cacheInfo.storageSize }}
@@ -339,11 +339,11 @@ onMounted(async () => {
              class="flex items-center justify-between border border-[#eeeeee] rounded-[16rpx] bg-[#f5f7fb] p-[24rpx]">
              <view>
                <text class="text-[28rpx] text-[#232338] font-medium">
-              {{ t('settings.cacheClear') }}
+                  {{ t('settings.cacheClear') }}
-            </text>
+                </text>
-            <text class="mt-[4rpx] block text-[24rpx] text-[#9d9ea3]">
+                <text class="mt-[4rpx] block text-[24rpx] text-[#9d9ea3]">
-              {{ t('settings.clearAllCache') }}
+                  {{ t('settings.clearAllCache') }}
-            </text>
+                </text>
              </view>
              <view
                class="cursor-pointer rounded-[24rpx] bg-[rgba(255,107,107,0.1)] px-[28rpx] py-[16rpx] text-[24rpx] text-[#ff6b6b] font-semibold transition-all duration-300 active:scale-95 active:bg-[#ff6b6b] active:text-white"
@@ -359,8 +359,8 @@ onMounted(async () => {
      <view class="mb-[32rpx]">
        <view class="mb-[24rpx] flex items-center">
          <text class="text-[32rpx] text-[#232338] font-bold">
-              {{ t('settings.appInfo') }}
+            {{ t('settings.appInfo') }}
-            </text>
+          </text>
        </view>
        <view class="border border-[#eeeeee] rounded-[24rpx] bg-[#fbfbfb] p-[32rpx]"
@@ -370,11 +370,11 @@ onMounted(async () => {
            @click="showAbout">
            <view>
              <text class="text-[28rpx] text-[#232338] font-medium">
-                  {{ t('settings.aboutUs') }}
+                {{ t('settings.aboutUs') }}
-                </text>
+              </text>
-                <text class="mt-[4rpx] block text-[24rpx] text-[#9d9ea3]">
+              <text class="mt-[4rpx] block text-[24rpx] text-[#9d9ea3]">
-                  {{ t('settings.appVersion') }}
+                {{ t('settings.appVersion') }}
-                </text>
+              </text>
            </view>
            <wd-icon name="arrow-right" custom-class="text-[32rpx] text-[#9d9ea3]" />
          </view>
@@ -385,24 +385,26 @@ onMounted(async () => {
      <view class="mb-[32rpx]">
        <view class="mb-[24rpx] flex items-center">
          <text class="text-[32rpx] text-[#232338] font-bold">
-              {{ t('settings.languageSettings') }}
+            {{ t('settings.languageSettings') }}
-            </text>
+          </text>
        </view>
        <view class="border border-[#eeeeee] rounded-[24rpx] bg-[#fbfbfb] p-[32rpx]"
          style="box-shadow: 0 4rpx 20rpx rgba(0, 0, 0, 0.06);">
-          <view class="flex cursor-pointer items-center justify-between border border-[#eeeeee] rounded-[16rpx] bg-[#f5f7fb] p-[24rpx] transition-all active:bg-[#eef3ff]" @click="showLanguageSheet = true">
+          <view
            class="flex cursor-pointer items-center justify-between border border-[#eeeeee] rounded-[16rpx] bg-[#f5f7fb] p-[24rpx] transition-all active:bg-[#eef3ff]"
            @click="showLanguageSheet = true">
            <view>
              <text class="text-[32rpx] text-[#232338] font-medium">
-                  {{ t('settings.language') }}
+                {{ t('settings.language') }}
-                </text>
+              </text>
-                <text class="mt-[4rpx] block text-[24rpx] text-[#9d9ea3]">
+              <text class="mt-[4rpx] block text-[24rpx] text-[#9d9ea3]">
-                  {{ t('settings.selectLanguage') }}
+                {{ t('settings.selectLanguage') }}
-                </text>
+              </text>
            </view>
            <view class="flex items-center">
              <text class="text-[32rpx] text-[#9d9ea3] font-semibold mr-[16rpx]">
-                {{ supportedLanguages.find(lang => lang.code === currentLanguage)?.name }}
+                {{supportedLanguages.find(lang => lang.code === currentLanguage)?.name}}
              </text>
              <wd-icon name="arrow-right" custom-class="text-[32rpx] text-[#9d9ea3]" />
            </view>
@@ -411,19 +413,11 @@ onMounted(async () => {
      </view>
      <!-- 语言选择弹窗 -->
-      <wd-action-sheet
+      <wd-action-sheet v-model="showLanguageSheet" :title="t('settings.selectLanguage')" :close-on-click-modal="true">
        v-model="showLanguageSheet"
        :title="t('settings.selectLanguage')"
        :close-on-click-modal="true"
      >
        <view class="language-sheet">
          <scroll-view scroll-y class="language-list">
-            <view
+            <view v-for="lang in supportedLanguages" :key="lang.code" class="language-item"
-              v-for="lang in supportedLanguages"
+              @click="handleLanguageChange(lang.code)">
              :key="lang.code"
              class="language-item"
              @click="handleLanguageChange(lang.code)"
            >
              <text class="language-name">
                {{ lang.name }}
              </text>
@@ -446,17 +440,21 @@ onMounted(async () => {
 .language-sheet {
  .language-list {
    max-height: 50vh;
    .language-item {
      padding: 30rpx 0;
      text-align: center;
      border-bottom: 1rpx solid #f0f0f0;
      .language-name {
        font-size: 28rpx;
        color: #333;
      }
      &:last-child {
        border-bottom: none;
      }
      &:active {
        background-color: #f5f7fb;
      }
@@ -1,9 +1,8 @@
 import { ref } from 'vue'
 import { ref } from 'vue'
 import { defineStore } from 'pinia'
 // 支持的语言类型
-export type Language = 'zh_CN' | 'en' | 'zh_TW'
+export type Language = 'zh_CN' | 'en' | 'zh_TW' | 'de' | 'vi'
 export interface LangStore {
  currentLang: Language
@@ -9,6 +9,7 @@ import timbre from "./module/timbre.js"
 import user from './module/user.js'
 import voiceClone from './module/voiceClone.js'
 import voiceResource from './module/voiceResource.js'
 import knowledgeBase from './module/knowledgeBase.js'
@@ -39,5 +40,6 @@ export default {
    ota,
    dict,
    voiceResource,
-    voiceClone
+    voiceClone,
-}
+    knowledgeBase
  }
@@ -102,21 +102,4 @@ export default {
                });
            }).send();
    },
    // 发送设备指令
    sendDeviceCommand(deviceId, mcpData, callback) {
        RequestService.sendRequest()
            .url(`${getServiceUrl()}/device/commands/${deviceId}`)
            .method('POST')
            .data(mcpData)
            .success((res) => {
                RequestService.clearRequestTime();
                callback(res);
            })
            .networkFail((err) => {
                console.error('发送设备指令失败:', err);
                RequestService.reAjaxFun(() => {
                    this.sendDeviceCommand(deviceId, mcpData, callback);
                });
            }).send();
    },
 }
@@ -0,0 +1,318 @@
 import { getServiceUrl } from '../api';
 import RequestService from '../httpRequest';
 /**
 * 获取认证token
 */
 function getAuthToken() {
  return localStorage.getItem('token') || '';
 }
 /**
 * 通用API请求包装器
 * @param {Object} config - 请求配置
 * @param {string} config.url - 请求URL
 * @param {string} config.method - 请求方法
 * @param {Object} [config.data] - 请求数据
 * @param {Object} [config.headers] - 额外请求头
 * @param {Function} config.callback - 成功回调
 * @param {Function} [config.errorCallback] - 错误回调
 * @param {string} [config.errorMessage] - 错误消息
 * @param {Function} [config.retryFunction] - 重试函数
 */
 function makeApiRequest(config) {
  const token = getAuthToken();
  const { url, method, data, headers, callback, errorCallback, errorMessage, retryFunction } = config;
  const requestBuilder = RequestService.sendRequest()
    .url(url)
    .method(method)
    .header({
      'Authorization': `Bearer ${token}`,
      ...headers
    });
  if (data) {
    requestBuilder.data(data);
  }
  requestBuilder
    .success((res) => {
      RequestService.clearRequestTime();
      callback(res);
    })
    .fail((err) => {
      console.error(errorMessage || '操作失败', err);
      if (errorCallback) {
        errorCallback(err);
      }
    })
    .networkFail(() => {
      if (retryFunction) {
        RequestService.reAjaxFun(() => {
          retryFunction();
        });
      }
    }).send();
 }
 /**
 * 知识库管理相关API
 */
 export default {
  /**
   * 获取知识库列表
   * @param {Object} params - 查询参数
   * @param {Function} callback - 回调函数
   * @param {Function} errorCallback - 错误回调
   */
  getKnowledgeBaseList(params, callback, errorCallback) {
    const queryParams = new URLSearchParams({
      page: params.page,
      page_size: params.page_size,
      name: params.name || ''
    }).toString();
    makeApiRequest({
      url: `${getServiceUrl()}/datasets?${queryParams}`,
      method: 'GET',
      callback: callback,
      errorCallback: errorCallback,
      errorMessage: '获取知识库列表失败',
      retryFunction: () => this.getKnowledgeBaseList(params, callback, errorCallback)
    });
  },
  /**
   * 创建知识库
   * @param {Object} data - 知识库数据
   * @param {Function} callback - 回调函数
   * @param {Function} errorCallback - 错误回调
   */
  createKnowledgeBase(data, callback, errorCallback) {
    console.log('createKnowledgeBase called with data:', data);
    console.log('API URL:', `${getServiceUrl()}/datasets`);
    makeApiRequest({
      url: `${getServiceUrl()}/datasets`,
      method: 'POST',
      data: data,
      headers: { 'Content-Type': 'application/json' },
      callback: (res) => {
        console.log('createKnowledgeBase success response:', res);
        callback(res);
      },
      errorCallback: (err) => {
        console.error('创建知识库失败:', err);
        if (err.response) {
          console.error('Error response data:', err.response.data);
          console.error('Error response status:', err.response.status);
        }
        if (errorCallback) {
          errorCallback(err);
        }
      },
      errorMessage: '创建知识库失败',
      retryFunction: () => this.createKnowledgeBase(data, callback, errorCallback)
    });
  },
  /**
   * 更新知识库
   * @param {string} datasetId - 知识库ID
   * @param {Object} data - 更新数据
   * @param {Function} callback - 回调函数
   * @param {Function} errorCallback - 错误回调
   */
  updateKnowledgeBase(datasetId, data, callback, errorCallback) {
    console.log('updateKnowledgeBase called with datasetId:', datasetId, 'data:', data);
    console.log('API URL:', `${getServiceUrl()}/datasets/${datasetId}`);
    makeApiRequest({
      url: `${getServiceUrl()}/datasets/${datasetId}`,
      method: 'PUT',
      data: data,
      headers: { 'Content-Type': 'application/json' },
      callback: callback,
      errorCallback: errorCallback,
      errorMessage: '更新知识库失败',
      retryFunction: () => this.updateKnowledgeBase(datasetId, data, callback, errorCallback)
    });
  },
  /**
   * 删除单个知识库
   * @param {string} datasetId - 知识库ID
   * @param {Function} callback - 回调函数
   * @param {Function} errorCallback - 错误回调
   */
  deleteKnowledgeBase(datasetId, callback, errorCallback) {
    console.log('deleteKnowledgeBase called with datasetId:', datasetId);
    console.log('API URL:', `${getServiceUrl()}/datasets/${datasetId}`);
    makeApiRequest({
      url: `${getServiceUrl()}/datasets/${datasetId}`,
      method: 'DELETE',
      callback: callback,
      errorCallback: errorCallback,
      errorMessage: '删除知识库失败',
      retryFunction: () => this.deleteKnowledgeBase(datasetId, callback, errorCallback)
    });
  },
  /**
   * 批量删除知识库
   * @param {string|Array} ids - 知识库ID字符串或数组
   * @param {Function} callback - 回调函数
   * @param {Function} errorCallback - 错误回调
   */
  deleteKnowledgeBases(ids, callback, errorCallback) {
    // 确保ids是正确格式的字符串
    const idsStr = Array.isArray(ids) ? ids.join(',') : ids;
    makeApiRequest({
      url: `${getServiceUrl()}/datasets/batch?ids=${idsStr}`,
      method: 'DELETE',
      callback: callback,
      errorCallback: errorCallback,
      errorMessage: '批量删除知识库失败',
      retryFunction: () => this.deleteKnowledgeBases(ids, callback, errorCallback)
    });
  },
  /**
   * 获取文档列表
   * @param {string} datasetId - 知识库ID
   * @param {Object} params - 查询参数
   * @param {Function} callback - 回调函数
   * @param {Function} errorCallback - 错误回调
   */
  getDocumentList(datasetId, params, callback, errorCallback) {
    const queryParams = new URLSearchParams({
      page: params.page,
      page_size: params.page_size,
      name: params.name || ''
    }).toString();
    makeApiRequest({
      url: `${getServiceUrl()}/datasets/${datasetId}/documents?${queryParams}`,
      method: 'GET',
      callback: callback,
      errorCallback: errorCallback,
      errorMessage: '获取文档列表失败',
      retryFunction: () => this.getDocumentList(datasetId, params, callback, errorCallback)
    });
  },
  /**
   * 上传文档
   * @param {string} datasetId - 知识库ID
   * @param {Object} formData - 表单数据
   * @param {Function} callback - 回调函数
   * @param {Function} errorCallback - 错误回调
   */
  uploadDocument(datasetId, formData, callback, errorCallback) {
    makeApiRequest({
      url: `${getServiceUrl()}/datasets/${datasetId}/documents`,
      method: 'POST',
      data: formData,
      headers: { 'Content-Type': 'multipart/form-data' },
      callback: callback,
      errorCallback: errorCallback,
      errorMessage: '上传文档失败',
      retryFunction: () => this.uploadDocument(datasetId, formData, callback, errorCallback)
    });
  },
  /**
   * 解析文档
   * @param {string} datasetId - 知识库ID
   * @param {string} documentId - 文档ID
   * @param {Function} callback - 回调函数
   * @param {Function} errorCallback - 错误回调
   */
  parseDocument(datasetId, documentId, callback, errorCallback) {
    const requestBody = {
      document_ids: [documentId]
    };
    makeApiRequest({
      url: `${getServiceUrl()}/datasets/${datasetId}/chunks`,
      method: 'POST',
      data: requestBody,
      headers: { 'Content-Type': 'application/json' },
      callback: callback,
      errorCallback: errorCallback,
      errorMessage: '解析文档失败',
      retryFunction: () => this.parseDocument(datasetId, documentId, callback, errorCallback)
    });
  },
  /**
   * 删除文档
   * @param {string} datasetId - 知识库ID
   * @param {string} documentId - 文档ID
   * @param {Function} callback - 回调函数
   * @param {Function} errorCallback - 错误回调
   */
  deleteDocument(datasetId, documentId, callback, errorCallback) {
    makeApiRequest({
      url: `${getServiceUrl()}/datasets/${datasetId}/documents/${documentId}`,
      method: 'DELETE',
      callback: callback,
      errorCallback: errorCallback,
      errorMessage: '删除文档失败',
      retryFunction: () => this.deleteDocument(datasetId, documentId, callback, errorCallback)
    });
  },
  /**
   * 获取文档切片列表
   * @param {string} datasetId - 知识库ID
   * @param {string} documentId - 文档ID
   * @param {Object} params - 查询参数
   * @param {Function} callback - 回调函数
   * @param {Function} errorCallback - 错误回调
   */
  listChunks(datasetId, documentId, params, callback, errorCallback) {
    let queryParams = new URLSearchParams({
      page: params.page || 1,
      page_size: params.page_size || 10
    }).toString();
    // 添加关键词搜索参数
    if (params.keywords) {
      queryParams += `&keywords=${encodeURIComponent(params.keywords)}`;
    }
    makeApiRequest({
      url: `${getServiceUrl()}/datasets/${datasetId}/documents/${documentId}/chunks?${queryParams}`,
      method: 'GET',
      callback: callback,
      errorCallback: errorCallback,
      errorMessage: '获取切片列表失败',
      retryFunction: () => this.listChunks(datasetId, documentId, params, callback, errorCallback)
    });
  },
  /**
   * 召回测试
   * @param {string} datasetId - 知识库ID
   * @param {Object} data - 召回测试参数
   * @param {Function} callback - 回调函数
   * @param {Function} errorCallback - 错误回调
   */
  retrievalTest(datasetId, data, callback, errorCallback) {
    makeApiRequest({
      url: `${getServiceUrl()}/datasets/${datasetId}/retrieval-test`,
      method: 'POST',
      data: data,
      headers: { 'Content-Type': 'application/json' },
      callback: callback,
      errorCallback: errorCallback,
      errorMessage: '召回测试失败',
      retryFunction: () => this.retrievalTest(datasetId, data, callback, errorCallback)
    });
  }
 };
@@ -47,6 +47,7 @@ export default {
  addModel(params, callback) {
    const { modelType, provideCode, formData } = params;
    const postData = {
      id: formData.id,
      modelCode: formData.modelCode,
      modelName: formData.modelName,
      isDefault: formData.isDefault ? 1 : 0,
@@ -336,5 +337,23 @@ export default {
          this.getPluginFunctionList(params, callback)
        })
      }).send()
  },
  // 获取RAG模型列表
  getRAGModels(callback) {
    RequestService.sendRequest()
      .url(`${getServiceUrl()}/datasets/rag-models`)
      .method('GET')
      .success((res) => {
        RequestService.clearRequestTime()
        callback(res)
      })
      .networkFail((err) => {
        console.error('获取RAG模型列表失败:', err)
        this.$message.error(err.msg || '获取RAG模型列表失败')
        RequestService.reAjaxFun(() => {
          this.getRAGModels(callback)
        })
      }).send()
  }
 }
@@ -27,6 +27,12 @@
      <div style="height: 2px; background: #e9e9e9; margin-bottom: 22px;"></div>
      <el-form :model="formData" label-width="100px" label-position="left" class="custom-form">
        <div style="display: flex; gap: 20px; margin-bottom: 0;">
          <el-form-item :label="$t('modelConfigDialog.modelId')" prop="id" style="flex: 1;">
            <el-input v-model="formData.id" :placeholder="$t('modelConfigDialog.enterModelId')" class="custom-input-bg"
              maxlength="32"></el-input>
          </el-form-item>
        </div>
        <div style="display: flex; gap: 20px; margin-bottom: 0;">
          <el-form-item :label="$t('modelConfigDialog.modelName')" prop="modelName" style="flex: 1;">
            <el-input v-model="formData.modelName" :placeholder="$t('modelConfigDialog.enterModelName')"
@@ -69,16 +75,14 @@
      <div style="height: 2px; background: #e9e9e9; margin-bottom: 22px;"></div>
      <el-form :model="formData.configJson" label-width="auto" label-position="left" class="custom-form">
-        <template v-for="(row, rowIndex) in chunkedCallInfoFields">
+        <div v-for="(row, rowIndex) in chunkedCallInfoFields" :key="rowIndex"
-          <div :key="rowIndex" style="display: flex; gap: 20px; margin-bottom: 0;">
+          style="display: flex; gap: 20px; margin-bottom: 0;">
-            <el-form-item v-for="field in row" :key="field.prop" :label="field.label" :prop="field.prop"
+          <el-form-item v-for="field in row" :key="field.prop" :label="field.label" :prop="field.prop" style="flex: 1;">
-              style="flex: 1;">
+            <el-input v-model="formData.configJson[field.prop]" :placeholder="field.placeholder"
-              <el-input v-model="formData.configJson[field.prop]" :placeholder="field.placeholder"
+              :type="field.type || 'text'" class="custom-input-bg" :show-password="field.type === 'password'">
-                :type="field.type || 'text'" class="custom-input-bg" :show-password="field.type === 'password'">
+            </el-input>
-              </el-input>
+          </el-form-item>
-            </el-form-item>
+        </div>
          </div>
        </template>
      </el-form>
    </div>
@@ -107,6 +111,7 @@ export default {
      providerFields: [],
      currentProvider: null,
      formData: {
        id: '',
        modelName: '',
        modelCode: '',
        supplier: '',
@@ -195,6 +200,13 @@ export default {
    confirm() {
      this.saving = true;
      // 校验模型ID不能为纯文字或空格
      if (this.formData.id && !this.validateModelId(this.formData.id)) {
        this.$message.error(this.$t('modelConfigDialog.invalidModelId'));
        this.saving = false;
        return;
      }
      if (!this.formData.supplier) {
        this.$message.error(this.$t('addModelDialog.requiredSupplier'));
        this.saving = false;
@@ -202,6 +214,7 @@ export default {
      }
      const submitData = {
        id: this.formData.id || '',
        modelName: this.formData.modelName || '',
        modelCode: this.formData.modelCode || '',
        supplier: this.formData.supplier,
@@ -230,6 +243,7 @@ export default {
    resetForm() {
      this.saving = false;
      this.formData = {
        id: '',
        modelName: '',
        modelCode: '',
        supplier: '',
@@ -247,6 +261,38 @@ export default {
      this.providerFields = [];
      this.currentProvider = null;
    },
    // 校验模型ID：不能为纯文字或空格
    validateModelId(modelId) {
      if (!modelId || typeof modelId !== 'string') {
        return false;
      }
      // 去除首尾空格
      const trimmedId = modelId.trim();
      // 检查是否为空或纯空格
      if (trimmedId === '') {
        return false;
      }
      // 检查是否只包含字母（纯文字）
      if (/^[a-zA-Z]+$/.test(trimmedId)) {
        return false;
      }
      // 检查是否包含空格
      if (/\s/.test(trimmedId)) {
        return false;
      }
      // 允许字母、数字、下划线、连字符
      if (!/^[a-zA-Z0-9_-]+$/.test(trimmedId)) {
        return false;
      }
      return true;
    }
  }
 }
 </script>
@@ -358,7 +404,7 @@ export default {
 .custom-input-bg .el-input__inner,
 .custom-input-bg .el-textarea__inner {
-  background-color: #f6f8fc;
+  background-color: #ffffff;
 }
@@ -0,0 +1,329 @@
 <template>
  <el-dialog
    :visible.sync="dialogVisible"
    width="900px"
    :title="$t('contextProviderDialog.title')"
    :close-on-click-modal="false"
    custom-class="context-provider-dialog"
    append-to-body
  >
    <div class="dialog-content">
      <el-empty v-if="localProviders.length === 0" :description="$t('contextProviderDialog.noContextApi')">
        <el-button type="primary" icon="el-icon-plus" @click="addProvider(0)">{{ $t('contextProviderDialog.add') }}</el-button>
      </el-empty>
      <div
        v-for="(provider, pIndex) in localProviders"
        :key="pIndex"
        class="provider-item"
      >
        <el-card class="provider-card" shadow="hover" :body-style="{ padding: '15px 20px' }">
          <!-- URL Row -->
          <div class="input-row">
            <span class="label-text">{{ $t('contextProviderDialog.apiUrl') }}</span>
            <el-input
              v-model="provider.url"
              :placeholder="$t('contextProviderDialog.apiUrlPlaceholder')"
              size="small"
              class="flex-1"
            ></el-input>
          </div>
          <!-- Headers Section -->
          <div class="headers-section">
            <div class="label-text" style="margin-top: 6px;">{{ $t('contextProviderDialog.requestHeaders') }}</div>
            <div class="headers-list">
              <div
                v-for="(header, hIndex) in provider.headers"
                :key="hIndex"
                class="header-row"
              >
                <el-input
                  v-model="header.key"
                  :placeholder="$t('contextProviderDialog.headerKeyPlaceholder')"
                  size="small"
                  style="width: 180px;"
                ></el-input>
                <span class="separator">:</span>
                <el-input
                  v-model="header.value"
                  :placeholder="$t('contextProviderDialog.headerValuePlaceholder')"
                  size="small"
                  class="flex-1"
                ></el-input>
                <div class="row-controls">
                  <el-button
                    type="primary"
                    icon="el-icon-plus"
                    circle
                    size="mini"
                    plain
                    @click="addHeader(pIndex, hIndex + 1)"
                  ></el-button>
                  <el-button
                    type="danger"
                    icon="el-icon-minus"
                    circle
                    size="mini"
                    plain
                    @click="removeHeader(pIndex, hIndex)"
                  ></el-button>
                </div>
              </div>
              <!-- Empty Headers State -->
              <div v-if="provider.headers.length === 0" class="header-row empty-header">
                 <span class="no-header-text">{{ $t('contextProviderDialog.noHeaders') }}</span>
                 <el-button
                    type="text"
                    icon="el-icon-plus"
                    size="mini"
                    @click="addHeader(pIndex, 0)"
                  >{{ $t('contextProviderDialog.addHeader') }}</el-button>
              </div>
            </div>
          </div>
        </el-card>
        <!-- Provider Block Controls (Right Side) -->
        <div class="block-controls">
          <el-button
            type="primary"
            icon="el-icon-plus"
            circle
            size="medium"
            @click="addProvider(pIndex + 1)"
          ></el-button>
          <el-button
            type="danger"
            icon="el-icon-minus"
            circle
            size="medium"
            @click="removeProvider(pIndex)"
          ></el-button>
        </div>
      </div>
    </div>
    <span slot="footer" class="dialog-footer">
      <el-button @click="dialogVisible = false">{{ $t('contextProviderDialog.cancel') }}</el-button>
      <el-button type="primary" @click="handleConfirm">{{ $t('contextProviderDialog.confirm') }}</el-button>
    </span>
  </el-dialog>
 </template>
 <script>
 export default {
  name: 'ContextProviderDialog',
  props: {
    visible: {
      type: Boolean,
      default: false
    },
    providers: {
      type: Array,
      default: () => []
    }
  },
  data() {
    return {
      localProviders: []
    };
  },
  computed: {
    dialogVisible: {
      get() {
        return this.visible;
      },
      set(val) {
        this.$emit('update:visible', val);
      }
    }
  },
  watch: {
    visible(val) {
      if (val) {
        this.initLocalData();
      }
    }
  },
  methods: {
    initLocalData() {
      // 深拷贝并将 headers 对象转换为数组
      this.localProviders = this.providers.map(p => {
        const headers = p.headers || {};
        return {
          url: p.url || '',
          headers: Object.entries(headers).map(([key, value]) => ({ key, value }))
        };
      });
      // 如果为空，添加一个默认块
      if (this.localProviders.length === 0) {
         this.localProviders.push({ url: '', headers: [{ key: '', value: '' }] });
      }
    },
    addProvider(index) {
      this.localProviders.splice(index, 0, {
        url: '',
        headers: [{ key: '', value: '' }]
      });
    },
    removeProvider(index) {
      this.localProviders.splice(index, 1);
    },
    addHeader(pIndex, hIndex) {
      this.localProviders[pIndex].headers.splice(hIndex, 0, { key: '', value: '' });
    },
    removeHeader(pIndex, hIndex) {
      this.localProviders[pIndex].headers.splice(hIndex, 1);
    },
    handleConfirm() {
      const result = this.localProviders
        .filter(p => p.url.trim() !== '')
        .map(p => {
          const headersObj = {};
          p.headers.forEach(h => {
            if (h.key.trim()) {
              headersObj[h.key.trim()] = h.value;
            }
          });
          return {
            url: p.url.trim(),
            headers: headersObj
          };
        });
      this.$emit('confirm', result);
      this.dialogVisible = false;
    }
  }
 };
 </script>
 <style scoped>
 .dialog-content {
  max-height: 60vh;
  overflow-y: auto;
  padding: 20px 25px;
 }
 .dialog-content::-webkit-scrollbar {
  width: 6px;
 }
 .dialog-content::-webkit-scrollbar-thumb {
  background: #dcdfe6;
  border-radius: 3px;
 }
 .dialog-content::-webkit-scrollbar-track {
  background: #f5f7fa;
 }
 .provider-item {
  display: flex;
  gap: 15px;
  margin-bottom: 20px;
  align-items: center;
 }
 .provider-card {
  flex: 1;
  border-radius: 12px;
  border: 1px solid #e4e7ed;
  border-left: 4px solid #409EFF; /* 左侧强调色 */
  background-color: #fff;
  transition: all 0.3s ease;
  box-shadow: 0 2px 12px 0 rgba(0, 0, 0, 0.05);
 }
 .provider-card:hover {
  box-shadow: 0 8px 20px rgba(0, 0, 0, 0.1);
  transform: translateY(-2px);
 }
 .block-controls {
  display: flex;
  flex-direction: row;
  gap: 8px;
 }
 .input-row {
  display: flex;
  align-items: center;
  gap: 12px;
  margin-bottom: 18px;
 }
 .label-text {
  width: 60px;
  font-weight: 600;
  color: #606266;
  text-align: right;
  font-size: 13px;
  white-space: nowrap;
  line-height: 32px; /* 垂直居中对齐 */
 }
 .flex-1 {
  flex: 1;
 }
 .headers-section {
  display: flex;
  gap: 12px;
  align-items: flex-start;
 }
 .headers-list {
  flex: 1;
  display: flex;
  flex-direction: column;
  gap: 10px;
  background: #fcfcfc;
  padding: 15px;
  border-radius: 8px;
  border: 1px dashed #dcdfe6;
  transition: all 0.3s;
 }
 .headers-list:hover {
  border-color: #c0c4cc;
  background: #fff;
 }
 .header-row {
  display: flex;
  align-items: center;
  gap: 10px;
 }
 .separator {
  color: #909399;
  font-weight: bold;
  margin: 0 2px;
 }
 .row-controls {
  display: flex;
  gap: 6px;
  margin-left: 8px;
  flex-shrink: 0;
  opacity: 0.6;
  transition: opacity 0.2s;
 }
 .header-row:hover .row-controls {
  opacity: 1;
 }
 .empty-header {
  justify-content: center;
  padding: 10px;
  color: #909399;
  font-size: 13px;
 }
 .no-header-text {
  margin-right: 8px;
 }
 </style>
@@ -23,7 +23,7 @@
      <div class="settings-btn" @click="handleConfigure">
        {{ $t('home.configureRole') }}
      </div>
-      <div class="settings-btn" @click="handleVoicePrint">
+      <div v-if="featureStatus.voiceprintRecognition" class="settings-btn" @click="handleVoicePrint">
        {{ $t('home.voiceprintRecognition') }}
      </div>
      <div class="settings-btn" @click="handleDeviceManage">
@@ -49,7 +49,15 @@ import i18n from '@/i18n';
 export default {
  name: 'DeviceItem',
  props: {
-    device: { type: Object, required: true }
+    device: { type: Object, required: true },
    featureStatus: { 
      type: Object, 
      default: () => ({
        voiceprintRecognition: false,
        voiceClone: false,
        knowledgeBase: false
      })
    }
  },
  data() {
    return { switchValue: false }
@@ -13,7 +13,9 @@
      <div class="function-column">
        <div class="column-header">
          <h4 class="column-title">{{ $t('functionDialog.unselectedFunctions') }}</h4>
-          <el-button type="text" @click="selectAll" class="select-all-btn">{{ $t('functionDialog.selectAll') }}</el-button>
+          <el-button type="text" @click="selectAll" class="select-all-btn">
            {{ $t('functionDialog.selectAll') }}
          </el-button>
        </div>
        <div class="function-list">
          <div v-if="unselected.length">
@@ -21,7 +23,7 @@
              <el-checkbox :label="func.name" v-model="selectedNames" @change="(val) => handleCheckboxChange(func, val)"
                @click.native.stop></el-checkbox>
              <div class="func-tag" @click="handleFunctionClick(func)">
-                <div class="color-dot" :style="{ backgroundColor: getFunctionColor(func.name) }"></div>
+                <div class="color-dot"></div>
                <span>{{ func.name }}</span>
              </div>
            </div>
@@ -36,7 +38,9 @@
      <div class="function-column">
        <div class="column-header">
          <h4 class="column-title">{{ $t('functionDialog.selectedFunctions') }}</h4>
-          <el-button type="text" @click="deselectAll" class="select-all-btn">{{ $t('functionDialog.selectAll') }}</el-button>
+          <el-button type="text" @click="deselectAll" class="select-all-btn">
            {{ $t('functionDialog.selectAll') }}
          </el-button>
        </div>
        <div class="function-list">
          <div v-if="selectedList.length > 0">
@@ -44,7 +48,7 @@
              <el-checkbox :label="func.name" v-model="selectedNames" @change="(val) => handleCheckboxChange(func, val)"
                @click.native.stop></el-checkbox>
              <div class="func-tag" @click="handleFunctionClick(func)">
-                <div class="color-dot" :style="{ backgroundColor: getFunctionColor(func.name) }"></div>
+                <div class="color-dot"></div>
                <span>{{ func.name }}</span>
              </div>
            </div>
@@ -57,7 +61,9 @@
      <!-- 右侧：参数配置 -->
      <div class="params-column">
-        <h4 v-if="currentFunction" class="column-title">{{ $t('functionDialog.paramConfig') }} - {{ currentFunction.name }}</h4>
+        <h4 v-if="currentFunction" class="column-title">
          {{ $t('functionDialog.paramConfig') }} - {{ currentFunction.name }}
        </h4>
        <div v-if="currentFunction" class="params-container">
          <el-form :model="currentFunction" class="param-form">
            <!-- 遍历 fieldsMeta，而不是 params 的 keys -->
@@ -100,7 +106,7 @@
    </div>
    <!-- MCP区域 -->
-    <div class="mcp-access-point">
+    <div class="mcp-access-point" v-if="featureStatus.mcpAccessPoint">
      <div class="mcp-container">
        <!-- 左侧区域 -->
        <div class="mcp-left">
@@ -119,8 +125,8 @@
          <el-input v-model="mcpUrl" readonly class="url-input">
            <template #suffix>
              <el-button @click="copyUrl" class="inner-copy-btn" icon="el-icon-document-copy">
-                  {{ $t('functionDialog.copy') }}
+                {{ $t('functionDialog.copy') }}
-                </el-button>
+              </el-button>
            </template>
          </el-input>
        </div>
@@ -165,6 +171,7 @@
 <script>
 import Api from '@/apis/api';
 import i18n from '@/i18n';
 import featureManager from '@/utils/featureManager';
 export default {
  i18n,
@@ -191,10 +198,6 @@ export default {
      selectedNames: [],
      currentFunction: null,
      modifiedFunctions: {},
      functionColorMap: [
        '#FF6B6B', '#4ECDC4', '#45B7D1',
        '#96CEB4', '#FFEEAD', '#D4A5A5', '#A2836E'
      ],
      tempFunctions: {},
      // 添加一个标志位来跟踪是否已经保存
      hasSaved: false,
@@ -203,6 +206,11 @@ export default {
      mcpUrl: "",
      mcpStatus: "disconnected",
      mcpTools: [],
      // 功能状态
      featureStatus: {
        mcpAccessPoint: false
      }
    }
  },
  computed: {
@@ -247,6 +255,9 @@ export default {
        // 右侧默认指向第一个
        this.currentFunction = this.selectedList[0] || null;
        // 加载功能状态
        this.loadFeatureStatus();
        // 加载MCP数据
        this.loadMcpAddress();
        this.loadMcpTools();
@@ -257,6 +268,19 @@ export default {
    }
  },
  methods: {
    /**
     * 加载功能状态
     */
    async loadFeatureStatus() {
      // 确保featureManager已初始化完成
      await featureManager.waitForInitialization();
      const config = featureManager.getConfig();
      this.featureStatus = {
        mcpAccessPoint: config.mcpAccessPoint || false
      };
    },
    copyUrl() {
      const textarea = document.createElement('textarea');
      textarea.value = this.mcpUrl;
@@ -405,10 +429,6 @@ export default {
      // 通知父组件对话框已关闭且已保存
      this.$emit('dialog-closed', true);
    },
    getFunctionColor(name) {
      const hash = [...name].reduce((acc, char) => acc + char.charCodeAt(0), 0);
      return this.functionColorMap[hash % this.functionColorMap.length];
    },
    fieldRemark(field) {
      let description = (field && field.label) ? field.label : '';
      if (field.default) {
@@ -458,6 +478,7 @@ export default {
 .function-column {
  position: relative;
  width: auto;
  height:700px; 
  padding: 10px;
  overflow-y: auto;
  border-right: 1px solid #EBEEF5;
@@ -465,6 +486,12 @@ export default {
  overflow-x: hidden;
 }
 .mcp-access-point {
  position: relative;
  z-index: 1;
  background: white;
 }
 .function-column::-webkit-scrollbar {
  display: none;
 }
@@ -527,6 +554,7 @@ export default {
  flex-shrink: 0;
  width: 8px;
  height: 8px;
  background-color: #5778ff;
  margin-right: 8px;
  border-radius: 50%;
 }
--- a/Show More
+++ b/Show More