修复Dockerfile不再使用Git LFS，确保Hugging Face可以正确构建Docker镜像

.gitattributes

@@ -54,7 +54,7 @@ README.md !filter !diff !merge text
 *.nomedia filter=lfs diff=lfs merge=lfs -text
 *.npmignore filter=lfs diff=lfs merge=lfs -text
 *.replit filter=lfs diff=lfs merge=lfs -text
-/Dockerfile filter=lfs diff=lfs merge=lfs -text
+/Dockerfile !filter !diff !merge text
 /LICENSE filter=lfs diff=lfs merge=lfs -text
 *.cmd filter=lfs diff=lfs merge=lfs -text
 *.bat filter=lfs diff=lfs merge=lfs -text

.github/readme.md

@@ -1,3 +1,380 @@
-version https://git-lfs.github.com/spec/v1
-oid sha256:3f004c1b3f59cb28c6bbb6300d3c1081f262ad6c4d9300c4efdc3742ffc2ed03
-size 22404
+<a name="readme-top"></a>
+
+![][cover]
+
+<div align="center">
+
+English | [German](readme-de_de.md) | [中文](readme-zh_cn.md) | [繁體中文](readme-zh_tw.md) | [日本語](readme-ja_jp.md) | [Русский](readme-ru_ru.md) | [한국어](readme-ko_kr.md)
+
+[![GitHub Stars](https://img.shields.io/github/stars/SillyTavern/SillyTavern.svg)](https://github.com/SillyTavern/SillyTavern/stargazers)
+[![GitHub Forks](https://img.shields.io/github/forks/SillyTavern/SillyTavern.svg)](https://github.com/SillyTavern/SillyTavern/network)
+[![GitHub Issues](https://img.shields.io/github/issues/SillyTavern/SillyTavern.svg)](https://github.com/SillyTavern/SillyTavern/issues)
+[![GitHub Pull Requests](https://img.shields.io/github/issues-pr/SillyTavern/SillyTavern.svg)](https://github.com/SillyTavern/SillyTavern/pulls)
+
+</div>
+
+---
+
+SillyTavern provides a single unified interface for many LLM APIs (KoboldAI/CPP, Horde, NovelAI, Ooba, Tabby, OpenAI, OpenRouter, Claude, Mistral and more), a mobile-friendly layout, Visual Novel Mode, Automatic1111 & ComfyUI API image generation integration, TTS, WorldInfo (lorebooks), customizable UI, auto-translate, more prompt options than you'd ever want or need, and endless growth potential via third-party extensions.
+
+We have a [Documentation website](https://docs.sillytavern.app/) to answer most of your questions and help you get started.
+
+## What is SillyTavern?
+
+SillyTavern (or ST for short) is a locally installed user interface that allows you to interact with text generation LLMs, image generation engines, and TTS voice models.
+
+Beginning in February 2023 as a fork of TavernAI 1.2.8, SillyTavern now has over 100 contributors and 2 years of independent development under its belt, and continues to serve as a leading software for savvy AI hobbyists.
+
+## Our Vision
+
+1. We aim to empower users with as much utility and control over their LLM prompts as possible. The steep learning curve is part of the fun!
+2. We do not provide any online or hosted services, nor programmatically track any user data.
+3. SillyTavern is a passion project brought to you by a dedicated community of LLM enthusiasts, and will always be free and open sourced.
+
+## Branches
+
+SillyTavern is being developed using a two-branch system to ensure a smooth experience for all users.
+
+* `release` -🌟 **Recommended for most users.** This is the most stable and recommended branch, updated only when major releases are pushed. It's suitable for the majority of users. Typically updated once a month.
+* `staging` - ⚠️ **Not recommended for casual use.** This branch has the latest features, but be cautious as it may break at any time. Only for power users and enthusiasts. Updates several times daily.
+
+If you're not familiar with using the git CLI or don't understand what a branch is, don't worry! The release branch is always the preferable option for you.
+
+## What do I need other than SillyTavern?
+
+Since SillyTavern is only an interface, you will need access to an LLM backend to provide inference. You can use AI Horde for instant out-of-the-box chatting. Aside from that, we support many other local and cloud-based LLM backends: OpenAI-compatible API, KoboldAI, Tabby, and many more. You can read more about our supported APIs in [the FAQ](https://docs.sillytavern.app/usage/api-connections/).
+
+### Do I need a powerful PC to run SillyTavern?
+
+The hardware requirements are minimal: it will run on anything that can run NodeJS 18 or higher. If you intend to do LLM inference on your local machine, we recommend a 3000-series NVIDIA graphics card with at least 6GB of VRAM. Check your backend's documentation for more details.
+
+### Suggested Backends (not affiliated)
+
+* [AI Horde](https://aihorde.net/) - use models hosted by volunteers. Requires no further setup
+* [KoboldCpp](https://github.com/LostRuins/koboldcpp) - a community's favorite for running GGUF models locally
+* [tabbyAPI](https://github.com/theroyallab/tabbyAPI) - a popular, lightweight, locally-hosted exl2 inference API
+* [OpenRouter](https://openrouter.ai) - a single API for many cloud providers (OpenAI, Claude, Meta Llama, etc.) as well as popular community models.
+
+## Questions or suggestions?
+
+### Discord server
+
+| [![][discord-shield-badge]][discord-link] | [Join our Discord community!](https://discord.gg/sillytavern) Get support, share favorite characters and prompts. |
+| :---------------------------------------- | :----------------------------------------------------------------------------------------------------------------- |
+
+Or get in touch with the developers directly:
+
+* Discord: cohee, rossascends, wolfsblvt
+* Reddit: [/u/RossAscends](https://www.reddit.com/user/RossAscends/), [/u/sillylossy](https://www.reddit.com/user/sillylossy/), [u/Wolfsblvt](https://www.reddit.com/user/Wolfsblvt/)
+* [Post a GitHub issue](https://github.com/SillyTavern/SillyTavern/issues)
+
+### I like your project! How do I contribute?
+
+1. Send pull requests. Learn how to contribute: [CONTRIBUTING.md](../CONTRIBUTING.md)
+2. Send feature suggestions and issue reports using the provided templates.
+3. Read this entire readme file and check the documentation website first, to avoid sending duplicate issues.
+
+## Screenshots
+
+<img width="500" alt="image" src="https://github.com/user-attachments/assets/9b5f32f0-c3b3-4102-b3f5-0e9213c0f50f">
+<img width="500" alt="image" src="https://github.com/user-attachments/assets/913fdbaa-7d33-42f1-ae2c-89dca41c53d1">
+
+## Character Cards
+
+SillyTavern is built around the concept of "character cards". A character card is a collection of prompts that set the behavior of the LLM and is required to have persistent conversations in SillyTavern. They function similarly to ChatGPT's GPTs or Poe's bots. The content of a character card can be anything: an abstract scenario, an assistant tailored for a specific task, a famous personality or a fictional character.
+
+The name field is the only required character card input. To start a neutral conversation with the language model, create a new card simply called "Assistant" and leave the rest of the boxes blank. For a more themed chat, you can provide the language model with various background details, behavior and writing patterns, and a scenario to jump start the chat.
+
+To have a quick conversation without selecting a character card or to just test the LLM connection, simply type your prompt input into the input bar on the Welcome Screen after opening SillyTavern. Please note that such chats are temporary and will not be saved.
+
+To get a general idea on how to define character cards, see the default character (Seraphina) or download selected community-made cards from the "Download Extensions & Assets" menu.
+
+## Key Features
+
+* Advanced text generation settings with many community-made presets
+* World Info support: create rich lore or save tokens on your character card
+* Group chats: multi-bot rooms for characters to talk to you and/or each other
+* Rich UI customization options: theme colors, background images, custom CSS, and more
+* User personas: let the AI know a bit about you for greater immersion
+* Built-in RAG support: add documents to your chats for the AI to reference
+* Extensive chat commands subsystem and own [scripting engine](https://docs.sillytavern.app/usage/st-script/)
+
+## Extensions
+
+SillyTavern has extensibility support.
+
+* Character emotional expressions (sprites)
+* Auto-Summary of the chat history
+* Automatic UI and chat translation
+* Stable Diffusion/FLUX/DALL-E image generation
+* Text-to-speech for AI response messages (via ElevenLabs, Silero, or the OS's System TTS)
+* Web Search capabilities for adding additional real world context to your prompts
+* Many more are available to download from the "Download Extensions & Assets" menu.
+
+Tutorials on how to use them can be found in the [Docs](https://docs.sillytavern.app/).
+
+# ⌛ Installation
+
+> \[!WARNING]
+>
+> * DO NOT INSTALL INTO ANY WINDOWS CONTROLLED FOLDER (Program Files, System32, etc).
+> * DO NOT RUN START.BAT WITH ADMIN PERMISSIONS
+> * INSTALLATION ON WINDOWS 7 IS IMPOSSIBLE AS IT CAN NOT RUN NODEJS 18.16
+
+## 🪟 Windows
+
+### Installing via Git
+
+1. Install [NodeJS](https://nodejs.org/en) (latest LTS version is recommended)
+2. Install [Git for Windows](https://gitforwindows.org/)
+3. Open Windows Explorer (`Win+E`)
+4. Browse to or Create a folder that is not controlled or monitored by Windows. (ex: C:\MySpecialFolder\)
+5. Open a Command Prompt inside that folder by clicking in the 'Address Bar' at the top, typing `cmd`, and pressing Enter.
+6. Once the black box (Command Prompt) pops up, type ONE of the following into it and press Enter:
+
+* for Release Branch: `git clone https://github.com/SillyTavern/SillyTavern -b release`
+* for Staging Branch: `git clone https://github.com/SillyTavern/SillyTavern -b staging`
+
+7. Once everything is cloned, double-click `Start.bat` to make NodeJS install its requirements.
+8. The server will then start, and SillyTavern will pop up in your browser.
+
+### Installing via GitHub Desktop
+
+(This allows git usage **only** in GitHub Desktop, if you want to use `git` on the command line too, you also need to install [Git for Windows](https://gitforwindows.org/))
+
+  1. Install [NodeJS](https://nodejs.org/en) (latest LTS version is recommended)
+  2. Install [GitHub Desktop](https://central.github.com/deployments/desktop/desktop/latest/win32)
+  3. After installing GitHub Desktop, click on `Clone a repository from the internet....` (Note: You **do NOT need** to create a GitHub account for this step)
+  4. On the menu, click the URL tab, enter this URL `https://github.com/SillyTavern/SillyTavern`, and click Clone. You can change the Local path to change where SillyTavern is going to be downloaded.
+  6. To open SillyTavern, use Windows Explorer to browse into the folder where you cloned the repository. By default, the repository will be cloned here: `C:\Users\[Your Windows Username]\Documents\GitHub\SillyTavern`
+  7. Double-click on the `start.bat` file. (Note: the `.bat` part of the file name might be hidden by your OS, in that case, it will look like a file called "`Start`". This is what you double-click to run SillyTavern)
+  8. After double-clicking, a large black command console window should open and SillyTavern will begin to install what it needs to operate.
+  9. After the installation process, if everything is working, the command console window should look like this and a SillyTavern tab should be open in your browser:
+  10. Connect to any of the [supported APIs](https://docs.sillytavern.app/usage/api-connections/) and start chatting!
+
+## 🐧 Linux & 🍎 MacOS
+
+For MacOS / Linux all of these will be done in a Terminal.
+
+1. Install git and nodeJS (the method for doing this will vary depending on your OS)
+2. Clone the repo
+
+* for Release Branch: `git clone https://github.com/SillyTavern/SillyTavern -b release`
+* for Staging Branch: `git clone https://github.com/SillyTavern/SillyTavern -b staging`
+
+3. `cd SillyTavern` to navigate into the install folder.
+4. Run the `start.sh` script with one of these commands:
+
+* `./start.sh`
+* `bash start.sh`
+
+## ⚡ Installing via SillyTavern Launcher
+
+SillyTavern Launcher is an installation wizard that will help you get setup with many options, including installing a backend for local inference.
+
+### For Windows users
+
+1. On your keyboard: press **`WINDOWS + R`** to open Run dialog box. Then, run the following command to install git:
+
+```shell
+cmd /c winget install -e --id Git.Git
+```
+
+2. On your keyboard: press **`WINDOWS + E`** to open File Explorer, then navigate to the folder where you want to install the launcher. Once in the desired folder, type `cmd` into the address bar and press enter. Then, run the following command:
+
+```shell
+git clone https://github.com/SillyTavern/SillyTavern-Launcher.git && cd SillyTavern-Launcher && start installer.bat
+```
+
+### For Linux users
+
+1. Open your favorite terminal and install git
+2. Git clone the Sillytavern-Launcher with:
+
+```shell
+git clone https://github.com/SillyTavern/SillyTavern-Launcher.git && cd SillyTavern-Launcher
+```
+
+3. Start the installer.sh with:
+
+```shell
+chmod +x install.sh && ./install.sh
+```
+
+4. After installation start the launcher.sh with:
+
+```shell
+chmod +x launcher.sh && ./launcher.sh
+```
+
+### For Mac users
+
+1. Open a terminal and install brew with:
+
+```shell
+/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
+```
+
+2. Install git with:
+
+```shell
+brew install git
+```
+
+3. Git clone the Sillytavern-Launcher with:
+
+```shell
+git clone https://github.com/SillyTavern/SillyTavern-Launcher.git && cd SillyTavern-Launcher
+```
+
+4. Start the installer.sh with:
+
+```shell
+chmod +x install.sh && ./install.sh
+```
+
+5. After installation start the launcher.sh with:
+
+```shell
+chmod +x launcher.sh && ./launcher.sh
+```
+
+## 🐋 Installing via Docker
+
+These instructions assume you have installed Docker, are able to access your command line for the installation of containers, and familiar with their general operation.
+
+### Building the image yourself
+
+We have a comprehensive guide on using SillyTavern in Docker [here](http://docs.sillytavern.app/installation/docker/) which covers installations on Windows, macOS and Linux! Give it a read if you wish to build the image yourself.
+
+### Using the GitHub Container Registry (easiest)
+
+You will need two mandatory directory mappings and a port mapping to allow SillyTavern to function. In the command, replace your selections in the following places:
+
+#### Container Variables
+
+##### Volume Mappings
+
+* [config] - The directory where SillyTavern configuration files will be stored on your host machine
+* [data] - The directory where SillyTavern user data (including characters) will be stored on your host machine
+* [plugins] - (optional) The directory where SillyTavern server plugins will be stored on your host machine
+* [extensions] - (optional) The directory where global UI extensions will be stored on your host machine
+
+##### Port Mappings
+
+* [PublicPort] - The port to expose the traffic on. This is mandatory, as you will be accessing the instance from outside of its virtual machine container. DO NOT expose this to the internet without implementing a separate service for security.
+
+##### Additional Settings
+
+* [DockerNet] - The docker network that the container should be created with a connection to. If you don't know what it is, see the [official Docker documentation](https://docs.docker.com/reference/cli/docker/network/).
+* [version] - On the right-hand side of this GitHub page, you'll see "Packages". Select the "sillytavern" package and you'll see the image versions. The image tag "latest" will keep you up-to-date with the current release. You can also utilize "staging" and "release" tags that point to the nightly images of the respective branches, but this may not be appropriate, if you are utilizing extensions that could be broken, and may need time to update.
+
+#### Install command
+
+1. Open your Command Line
+2. Run the following command
+
+`docker run --name='sillytavern' --net='[DockerNet]' -p '8000:8000/tcp' -v '[plugins]':'/home/node/app/plugins':'rw' -v '[config]':'/home/node/app/config':'rw' -v '[data]':'/home/node/app/data':'rw' -v '[extensions]':'/home/node/app/public/scripts/extensions/third-party':'rw' 'ghcr.io/sillytavern/sillytavern:[version]'`
+
+> Note that 8000 is a default listening port. Don't forget to use an appropriate port if you change it in the config.
+
+## 📱 Installing via Termux on Android OS
+
+> \[!NOTE]
+> **SillyTavern can be run natively on Android devices using Termux, but we do not provide official support for this use case.**
+>
+> **Please refer to this guide by ArroganceComplex#2659:**
+>
+> * <https://rentry.org/STAI-Termux>
+
+**Unsupported platform: android arm LEtime-web.** 32-bit Android requires an external dependency that can't be installed with npm. Use the following command to install it: `pkg install esbuild`. Then run the usual installation steps.
+
+## API keys management
+
+SillyTavern saves your API keys to a `secrets.json` file in the user data directory (`/data/default-user/secrets.json` is the default path).
+
+By default, API keys will not be visible from the interface after you have saved them and refreshed the page.
+
+In order to enable viewing your keys:
+
+1. Set the value of `allowKeysExposure` to `true` in `config.yaml` file.
+2. Restart the SillyTavern server.
+3. Click the 'View hidden API keys' link at the bottom right of the API Connection Panel.
+
+## Command-line arguments
+
+You can pass command-line arguments to SillyTavern server startup to override some settings in `config.yaml`.
+
+### Examples
+
+```shell
+node server.js --port 8000 --listen false
+# or
+npm run start -- --port 8000 --listen false
+# or (Windows only)
+Start.bat --port 8000 --listen false
+```
+
+### Supported arguments
+
+| Option                  | Description                                                                                          | Type     |
+|-------------------------|------------------------------------------------------------------------------------------------------|----------|
+| `--version`             | Show version number                                                                                  | boolean  |
+| `--enableIPv6`          | Enables IPv6.                                                                                        | boolean  |
+| `--enableIPv4`          | Enables IPv4.                                                                                        | boolean  |
+| `--port`                | Sets the port under which SillyTavern will run. If not provided falls back to yaml config 'port'.    | number   |
+| `--dnsPreferIPv6`       | Prefers IPv6 for dns. If not provided falls back to yaml config 'preferIPv6'.                        | boolean  |
+| `--autorun`             | Automatically launch SillyTavern in the browser. If not provided falls back to yaml config 'autorun'.| boolean  |
+| `--autorunHostname`     | The autorun hostname, probably best left on 'auto'.                                                  | string   |
+| `--autorunPortOverride` | Overrides the port for autorun.                                                                      | string   |
+| `--listen`              | SillyTavern is listening on all network interfaces. If not provided falls back to yaml config 'listen'.| boolean  |
+| `--corsProxy`           | Enables CORS proxy. If not provided falls back to yaml config 'enableCorsProxy'.                     | boolean  |
+| `--disableCsrf`         | Disables CSRF protection                                                                             | boolean  |
+| `--ssl`                 | Enables SSL                                                                                          | boolean  |
+| `--certPath`            | Path to your certificate file.                                                                       | string   |
+| `--keyPath`             | Path to your private key file.                                                                       | string   |
+| `--whitelist`           | Enables whitelist mode                                                                               | boolean  |
+| `--dataRoot`            | Root directory for data storage                                                                      | string   |
+| `--avoidLocalhost`      | Avoids using 'localhost' for autorun in auto mode.                                                   | boolean  |
+| `--basicAuthMode`       | Enables basic authentication                                                                         | boolean  |
+| `--requestProxyEnabled` | Enables a use of proxy for outgoing requests                                                         | boolean  |
+| `--requestProxyUrl`     | Request proxy URL (HTTP or SOCKS protocols)                                                          | string   |
+| `--requestProxyBypass`  | Request proxy bypass list (space separated list of hosts)                                            | array    |
+
+## Remote connections
+
+Most often this is for people who want to use SillyTavern on their mobile phones while their PC runs the ST server on the same Wi-Fi network. However, it can be used to allow remote connections from anywhere as well.
+
+Read the detailed guide on how to set up remote connections in the [Docs](https://docs.sillytavern.app/usage/remoteconnections/).
+
+You may also want to configure SillyTavern user profiles with (optional) password protection: [Users](https://docs.sillytavern.app/installation/st-1.12.0-migration-guide/#users).
+
+## Performance issues?
+
+1. Disable the Blur Effect and enable Reduced Motion on the User Settings panel (UI Theme toggles category).
+2. If using response streaming, set the streaming FPS to a lower value (10-15 FPS is recommended).
+3. Make sure the browser is enabled to use GPU acceleration for rendering.
+
+## License and credits
+
+**This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+GNU Affero General Public License for more details.**
+
+* [TavernAI](https://github.com/TavernAI/TavernAI) 1.2.8 by Humi: MIT License
+* Portions of CncAnon's TavernAITurbo mod used with permission
+* Visual Novel Mode inspired by the work of PepperTaco (<https://github.com/peppertaco/Tavern/>)
+* Noto Sans font by Google (OFL license)
+* Icon theme by Font Awesome <https://fontawesome.com> (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License)
+* Default content by @OtisAlejandro (Seraphina character and lorebook) and @kallmeflocc (10K Discord Users Celebratory Background)
+* Docker guide by [@mrguymiah](https://github.com/mrguymiah) and [@Bronya-Rand](https://github.com/Bronya-Rand)
+
+## Top Contributors
+
+[![Contributors](https://contrib.rocks/image?repo=SillyTavern/SillyTavern)](https://github.com/SillyTavern/SillyTavern/graphs/contributors)
+
+<!-- LINK GROUP -->
+[cover]: https://github.com/user-attachments/assets/01a6ae9a-16aa-45f2-8bff-32b5dc587e44
+[discord-link]: https://discord.gg/sillytavern
+[discord-shield-badge]: https://img.shields.io/discord/1100685673633153084?color=5865F2&label=discord&labelColor=black&logo=discord&logoColor=white&style=for-the-badge

Dockerfile

@@ -1,3 +0,0 @@
-version https://git-lfs.github.com/spec/v1
-oid sha256:743e2ac6d14f5c961f4a71b23c20b529d1604f5b26628ffbdd875c3bc02c5873
-size 1297

public/scripts/extensions/tts/readme.md

@@ -1,3 +1,76 @@
-version https://git-lfs.github.com/spec/v1
-oid sha256:f3d01a815a99698109b298732572532f9bde45a12866912804b8dd65489dd363
-size 3493
+# Provider Requirements.
+Because I don't know how, or if you can, and/or maybe I am just too lazy to implement interfaces in JS, here's the requirements of a provider that the extension needs to operate.
+
+### class YourTtsProvider
+#### Required
+Exported for use in extension index.js, and added to providers list in index.js
+1. generateTts(text, voiceId)
+2. fetchTtsVoiceObjects()
+3. onRefreshClick()
+4. checkReady()
+5. loadSettings(settingsObject)
+6. settings field
+7. settingsHtml field
+
+#### Optional
+1. previewTtsVoice()
+2. separator field
+3. processText(text)
+
+# Requirement Descriptions
+### generateTts(text, voiceId)
+Must return `audioData.type in ['audio/mpeg', 'audio/wav', 'audio/x-wav', 'audio/wave', 'audio/webm']`
+Must take text to be rendered and the voiceId to identify the voice to be used
+
+### fetchTtsVoiceObjects()
+Required.
+Used by the TTS extension to get a list of voice objects from the provider.
+Must return an list of voice objects representing the available voices.
+1. name: a friendly user facing name to assign to characters. Shows in dropdown list next to user.
+2. voice_id: the provider specific id of the voice used in fetchTtsGeneration() call
+3. preview_url: a URL to a local audio file that will be used to sample voices
+4. lang: OPTIONAL language string
+
+### getVoice(voiceName)
+Required.
+Must return a single voice object matching the provided voiceName. The voice object must have the following at least:
+1. name: a friendly user facing name to assign to characters. Shows in dropdown list next to user.
+2. voice_id: the provider specific id of the voice used in fetchTtsGeneration() call
+3. preview_url: a URL to a local audio file that will be used to sample voices
+4. lang: OPTIONAL language indicator
+
+### onRefreshClick()
+Required.
+Users click this button to reconnect/reinit the selected provider.
+Responds to the user clicking the refresh button, which is intended to re-initialize the Provider into a working state, like retrying connections or checking if everything is loaded.
+
+### checkReady()
+Required.
+Return without error to let TTS extension know that the provider is ready.
+Return an error to block the main TTS extension for initializing the provider and UI. The error will be put in the TTS extension UI directly.
+
+### loadSettings(settingsObject)
+Required.
+Handle the input settings from the TTS extension on provider load.
+Put code in here to load your provider settings.
+
+### settings field
+Required, used for storing any provider state that needs to be saved.
+Anything stored in this field is automatically persisted under extension_settings[providerName] by the main extension in `saveTtsProviderSettings()`, as well as loaded when the provider is selected in `loadTtsProvider(provider)`.
+TTS extension doesn't expect any specific contents.
+
+### settingsHtml field
+Required, injected into the TTS extension UI. Besides adding it, not relied on by TTS extension directly.
+
+### previewTtsVoice()
+Optional.
+Function to handle playing previews of voice samples if no direct preview_url is available in fetchTtsVoiceObjects() response
+
+### separator field
+Optional.
+Used when narrate quoted text is enabled.
+Defines the string of characters used to introduce separation between between the groups of extracted quoted text sent to the provider. The provider will use this to introduce pauses by default using `...`
+
+### processText(text)
+Optional.
+A function applied to the input text before passing it to the TTS generator. Can be async.