ChatTTS-ui插件系统开发：扩展功能的实现框架

【免费下载链接】ChatTTS-ui 匹配ChatTTS的web界面和api接口 项目地址: https://gitcode.com/GitHub_Trending/ch/ChatTTS-ui

插件系统架构概述

ChatTTS-ui通过模块化工具集实现插件扩展能力，核心框架位于tools/目录下。该系统采用松耦合设计，支持文本处理、音频转换、AI交互等多类型插件开发，现有工具模块包括：

• LLM集成工具：tools/llm/ - 提供大语言模型调用接口
• 文本规范化工具：tools/normalizer/ - 实现中英文文本预处理
• 音频处理工具：tools/audio/ - 提供音频格式转换功能

插件开发规范

目录结构标准

所有插件需遵循统一的文件组织方式：

tools/
├── [插件类型]/           # 如llm、normalizer、audio
│   ├── __init__.py       # 模块初始化
│   ├── core.py           # 核心实现
│   └── config.py         # 配置定义

接口实现要求

插件必须实现以下标准接口（以LLM插件为例）：

# [tools/llm/llm.py](https://gitcode.com/GitHub_Trending/ch/ChatTTS-ui/blob/dc7a4502c4ea1c23385586bebbb91119e9e3bff6/tools/llm/llm.py?utm_source=gitcode_repo_files)
class ChatOpenAI:
    def __init__(self, api_key, base_url, model):
        # 初始化方法：接收配置参数
        
    def call(self, user_question, temperature=0.3, **kwargs):
        # 核心功能方法：实现业务逻辑

核心插件模块解析

LLM插件开发

tools/llm/llm.py实现了大语言模型调用框架，支持多模型提供商接入：

初始化配置

def __init__(self, api_key, base_url, model):
    self.client = OpenAI(
        api_key=api_key,
        base_url=base_url,
    )
    self.model = model

调用接口实现

def call(self, user_question, temperature=0.3, prompt_version="kimi", **kwargs):
    completion = self.client.chat.completions.create(
        model=self.model,
        messages=prompt_dict[prompt_version] + [
            {"role": "user", "content": user_question},
        ],
        temperature=temperature,** kwargs
    )
    return completion.choices[0].message.content

文本规范化插件

tools/normalizer/提供文本预处理能力，包含中英文两种实现：

• 中文规范化：tools/normalizer/zh.py

  def normalizer_zh_tn() -> Callable[[str], str]:
      # 中文文本规范化实现
  

• 英文规范化：tools/normalizer/en.py

  def normalizer_en_nemo_text() -> Callable[[str], str]:
      # 英文文本规范化实现
  

音频处理插件

tools/audio/np.py提供音频数据转换功能，核心方法：

def unsafe_float_to_int16(audio: np.ndarray) -> np.ndarray:
    # 浮点音频数据转int16格式

插件注册与加载机制

动态发现流程

系统通过扫描tools/目录自动发现插件：

1. 遍历子目录识别插件类型
2. 检查__init__.py中的导出符号
3. 加载实现标准接口的类或函数

配置加载方式

插件配置通过tools/llm/init.py统一管理，支持：

• 环境变量注入
• 配置文件加载
• 运行时参数覆盖

实战开发示例：自定义文本过滤器

步骤1：创建插件目录

mkdir -p tools/filter
touch tools/filter/__init__.py
touch tools/filter/core.py

步骤2：实现核心功能

# [tools/filter/core.py](https://gitcode.com/GitHub_Trending/ch/ChatTTS-ui/blob/dc7a4502c4ea1c23385586bebbb91119e9e3bff6/ChatTTS/core.py?utm_source=gitcode_repo_files)
def create_filter(patterns: list[str]) -> Callable[[str], str]:
    def filter_text(text: str) -> str:
        for pattern in patterns:
            text = re.sub(pattern, '', text)
        return text
    return filter_text

步骤3：导出插件接口

# [tools/filter/__init__.py](https://gitcode.com/GitHub_Trending/ch/ChatTTS-ui/blob/dc7a4502c4ea1c23385586bebbb91119e9e3bff6/ChatTTS/model/__init__.py?utm_source=gitcode_repo_files)
from .core import create_filter
__all__ = ["create_filter"]

步骤4：集成到主系统

在app.py中添加插件调用：

from tools.filter import create_filter

filter = create_filter(["敏感词1", "敏感词2"])
processed_text = filter(original_text)

插件系统扩展规划

未来版本将支持：

• 插件市场功能：通过asset/目录管理插件包
• 可视化配置界面：集成到templates/index.html
• 热重载机制：无需重启服务更新插件

开发资源与参考

• 官方工具模板：tools/
• 配置示例：pyproject.toml
• 依赖管理：requirements.txt

【免费下载链接】ChatTTS-ui 匹配ChatTTS的web界面和api接口 项目地址: https://gitcode.com/GitHub_Trending/ch/ChatTTS-ui