鱼声语音合成 yuuuuukiu/dsh-fish-audio

dsh-fish-audio

DeepSeek Harness（DSH）的 Fish Audio S2.1 插件，同时是 Model Context Protocol（MCP）服务器和命令行工具。
原生支持免费无限量 S2.1-Pro、角色音色库搜索与动态切换、歌声生成（[singing]），以及自然语言音高/情绪调节。

中文说明文档 (README_CN.md)

✨ 功能

- 🆓 官方无限量免费档：默认使用 s2.1-pro-free，提供高质量 S2.1 神经网络 TTS，不扣 token。
- 🎶 歌声与旋律：用行内 [singing] 标签和旋律标记（♪、~、——）指示模型演唱。
- 🎚️ 音高与情绪调节：支持开放式自然语言韵律标签：
- [pitch up] / [high pitch]：提高音高（可爱 / 动漫音）。
- [pitch down] / [low pitch]：降低音高（低沉 / 权威音）。
- [whispering]：亲密的耳语气声。
- [shouting] / [screaming]：情绪激动的呼喊。
- 🎙️ 丰富音色库：按关键词搜索数千个社区与官方角色音色（如动漫角色、歌手），动态切换并持久记忆。
- 🔄 模型与引擎管理：查询并在 s2.1-pro-free、s2.1-pro、s2-pro 和 ASR 模型之间切换。
- 🎧 语音转文字（ASR）：通过 transcribe-1 / transcribe-1-pro 高精度转写音频。
- 🌐 内置代理支持：支持 HTTP/HTTPS 正向代理（http://127.0.0.1:7892 等），使用 Node.js 原生 HTTP CONNECT 隧道，零外部依赖。
- 🔌 三合一架构：
1. DeepSeek Harness（Cordis） 原生插件，带 GUI Schema 设置。
2. Model Context Protocol（MCP） Stdio 服务器，适用于 Claude Desktop、Antigravity、Cursor 和 Cline。
3. 命令行工具（fish-audio-mcp / dsh-fish-audio）。

🚀 快速开始

1. 安装

Global install for CLI & MCP
npm install -g dsh-fish-audio

Or inside DeepSeek Harness profile
pnpm add dsh-fish-audio

2. 配置 API Key

通过命令行或环境变量设置你的 Fish Audio API key（sk-fish-...）：

Via CLI (saved to ~/.fish-audio/config.json with 0600 permissions)
fish-audio-mcp apikey sk-fish-xxxxxxxxxxxxxxxxxxxx

Or via environment variable
export FISH_AUDIO_API_KEY="sk-fish-xxxxxxxxxxxxxxxxxxxx"

🛠️ 用法

模式 A：DeepSeek Harness（Cordis 插件）

把 dsh-fish-audio 加入 cordis.patch.yml，或通过 DeepSeek Harness 桌面 GUI 配置：

- insert:
- id: dsh-fish-audio
name: dsh-fish-audio
config:
apiKey: '' # 留空则使用 ~/.fish-audio/config.json 或环境变量 defaultModelId: 568fe6a62f294908936212ce81e201e2 # 默认角色音色 ID modelTier: s2.1-pro-free # 默认引擎模型 outputDir: voice # 音频输出目录，相对或绝对路径 proxyUrl: '' # 例如 http://127.0.0.1:7892（可选）

已注册的可用智能体工具：

- fish_audio_tts：把语音或歌声合成为音频文件。
- fish_audio_voices：按关键词搜索角色音色库。
- fish_audio_set_voice：切换当前角色音色 ID。
- fish_audio_models：列出可用的官方引擎模型与价格。
- fish_audio_set_model：切换当前引擎模型。
- fish_audio_stt：把音频文件或 URL 转写成文字。
- fish_audio_balance：查询 Fish Audio 账户额度与限制。

模式 B：Model Context Protocol（MCP）服务器

支持 Claude Desktop、Antigravity、Cursor 和 Cline。

在 claude_desktop_config.json 中添加：

{
"mcpServers": {
"fish-audio": {
"command": "npx",
"args": ["-y", "dsh-fish-audio", "serve"],
"env": {
"FISH_AUDIO_API_KEY": "sk-fish-xxxxxxxxxxxxxxxxxxxx",
"HTTPS_PROXY": "http://127.0.0.1:7892"
}
}
}
}

模式 C：命令行界面（CLI）

1. Synthesize Speech
fish-audio-mcp tts "Hello world, this is a test!" -o test.mp3

2. Singing Generation
fish-audio-mcp tts "[singing] Happy birthday to you~ Happy birthday to you~ ♪" -o sing.mp3

3. Pitch & Prosody Modulation
fish-audio-mcp tts "[pitch up] Look at how high my voice can reach! [whispering] Secret..." -o pitch.mp3

4. Search and Switch Voices
fish-audio-mcp voice list "初音未来" fish-audio-mcp voice set 14d9940607fc477b8115a40b60a29b0b

5. List and Switch Underlying Engine Models
fish-audio-mcp model list
fish-audio-mcp model set s2.1-pro-free

6. Audio Transcription (STT)
fish-audio-mcp stt ./audio.mp3 --lang zh

7. Check Status & Account Balance
fish-audio-mcp status

模式 D：Node.js 编程 SDK

import { textToSpeech, searchVoices, setActiveVoice } from 'dsh-fish-audio';

// Search voices
const results = await searchVoices('萝莉');

// Generate TTS
const audio = await textToSpeech('[singing] 祝你生日快乐~ ♪', { voice: '568fe6a62f294908936212ce81e201e2', model: 's2.1-pro-free', outputPath: './output.mp3', });

console.log(Audio saved to: ${audio.localPath} (${audio.fileSize} bytes));

🎵 歌声与音高调制指南

Fish Audio S2.1 原生支持方括号 [tag] 里的描述性指令：

| 标签 | 作用 | 示例 |
| [singing] | 旋律化演唱 | [singing] 朋友的情谊呀~ 比天还高—— 比地还辽阔♪ |
| [pitch up] / [high pitch] | 提高音区 | [pitch up] 哇！大叔你看本小姐的高音厉不厉害~♡ |
| [pitch down] / [low pitch]| 降低音区 | [pitch down] 肃静。这才是深海主宰的声音。 |
| [whispering] | 气声 / 悄悄话 | [whispering] 悄悄告诉你一个小秘密哦... |
| [shouting] | 喊叫 / 高能量 | [shouting] 呜哇！不准拔本小姐的网线！ |

唱歌小技巧：把 [singing] 和音乐符号搭配使用，比如 ♪（旋律标记）、~（颤音 / 拖长）、——（持续音），给神经网络清晰的节奏感。

📄 许可证

MIT © Yuki-U