refactor: 合并 claude-marketplace，重构目录结构为单一仓库
- 重命名 plugins/ → skills/，个人插件迁移到 skills-personal/（gitignore） - 更新 generate-marketplace.py 支持 config 读取和 skills-personal 扫描 - 新增 claude-config.yaml（技能启用/禁用 + MCP 配置） - 新增 init.sh（交互式 MCP 初始化，支持 stdio/SSE 模式） - 新增 CLAUDE.md 项目说明 - 重写 README.md 反映新结构 - 删除过时脚本：PUSH.sh、generate-marketplace.sh、convert-skills.sh Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
186
skills/doubao-voice-plugin/scripts/README.md
Normal file
186
skills/doubao-voice-plugin/scripts/README.md
Normal file
@@ -0,0 +1,186 @@
|
||||
# 豆包语音工具使用指南
|
||||
|
||||
简单易用的豆包语音命令行工具，支持**文字转语音(TTS)**和**唱歌**。
|
||||
|
||||
## 快速开始
|
||||
|
||||
### 1. 配置环境变量
|
||||
|
||||
```bash
|
||||
# 在 ~/.zshrc 或 ~/.bashrc 中添加
|
||||
export DOUBAO_APP_ID="your_app_id"
|
||||
export DOUBAO_ACCESS_TOKEN="your_access_token"
|
||||
|
||||
# 使配置生效
|
||||
source ~/.zshrc
|
||||
```
|
||||
|
||||
### 2. 安装依赖
|
||||
|
||||
```bash
|
||||
pip install requests
|
||||
```
|
||||
|
||||
## 使用方法
|
||||
|
||||
### 📝 文字转语音 (TTS)
|
||||
|
||||
**基础用法：**
|
||||
```bash
|
||||
python voice_converter.py tts "你好，我是豆包语音助手"
|
||||
```
|
||||
|
||||
**指定输出文件和音色：**
|
||||
```bash
|
||||
python voice_converter.py tts "欢迎使用豆包语音" -o welcome.mp3 -v BV701_V2_streaming
|
||||
```
|
||||
|
||||
**可用音色：**
|
||||
- `BV700_V2_streaming` - 通用女声（默认，推荐）
|
||||
- `BV701_V2_streaming` - 通用男声
|
||||
- `BV406_streaming` - 温柔女声
|
||||
- `BV158_streaming` - 活泼女声
|
||||
- `BV115_streaming` - 磁性男声
|
||||
|
||||
### 🎵 唱歌 (Singing)
|
||||
|
||||
**基础用法：**
|
||||
```bash
|
||||
python singing.py sing "请唱一首关于春天的歌"
|
||||
```
|
||||
|
||||
**指定输出文件：**
|
||||
```bash
|
||||
python singing.py sing "唱一个温柔的摇篮曲" -o lullaby.mp3
|
||||
```
|
||||
|
||||
**交互式模式（实时对话）：**
|
||||
```bash
|
||||
python singing.py interactive
|
||||
```
|
||||
|
||||
在交互模式下可以自然地与豆包对话，要求她唱歌、讲故事等。输入 `quit` 退出。
|
||||
|
||||
## Python 代码调用
|
||||
|
||||
```python
|
||||
# TTS - 文字转语音
|
||||
from voice_converter import DoubaoVoiceConverter
|
||||
|
||||
converter = DoubaoVoiceConverter()
|
||||
audio_file = converter.text_to_speech(
|
||||
"你好，欢迎使用豆包语音",
|
||||
output_file="hello.mp3",
|
||||
voice_type="BV700_V2_streaming"
|
||||
)
|
||||
print(f"生成语音: {audio_file}")
|
||||
|
||||
# 唱歌
|
||||
import asyncio
|
||||
from singing import DoubaoSinging
|
||||
|
||||
async def main():
|
||||
singing = DoubaoSinging()
|
||||
|
||||
# 让豆包唱歌
|
||||
audio_file = await singing.sing(
|
||||
"请唱一首情歌",
|
||||
output_file="love_song.mp3",
|
||||
language="zh-CN"
|
||||
)
|
||||
print(f"唱歌完成: {audio_file}")
|
||||
|
||||
# 或启动交互模式
|
||||
# await singing.interactive_singing()
|
||||
|
||||
asyncio.run(main())
|
||||
```
|
||||
|
||||
## 完整示例
|
||||
|
||||
### 示例1：生成通知语音
|
||||
|
||||
```bash
|
||||
# 生成女声通知
|
||||
python voice_converter.py tts "您有一条新消息，请注意查收" -o notification.mp3
|
||||
|
||||
# 生成男声通知
|
||||
python voice_converter.py tts "系统将在5分钟后进行维护" -o maintenance.mp3 -v BV701_V2_streaming
|
||||
```
|
||||
|
||||
### 示例2：唱歌
|
||||
|
||||
```bash
|
||||
# 让豆包唱一首情歌
|
||||
python singing.py sing "请唱一首温柔的情歌" -o love_song.mp3
|
||||
|
||||
# 让豆包唱一首儿歌
|
||||
python singing.py sing "唱一首欢快的儿歌" -o kids_song.mp3
|
||||
|
||||
# 启动交互式模式与豆包对话
|
||||
python singing.py interactive
|
||||
```
|
||||
|
||||
|
||||
## 错误处理
|
||||
|
||||
### 常见错误
|
||||
|
||||
**1. 环境变量未设置**
|
||||
```
|
||||
❌ 错误: 请先设置环境变量:
|
||||
export DOUBAO_APP_ID='your_app_id'
|
||||
export DOUBAO_ACCESS_TOKEN='your_access_token'
|
||||
```
|
||||
**解决：** 确保已正确设置环境变量并 `source ~/.zshrc`
|
||||
|
||||
**2. API 调用失败**
|
||||
```
|
||||
❌ 错误: TTS 失败 (code: 4001): Invalid token
|
||||
```
|
||||
**解决：** 检查 Access Token 是否正确或已过期
|
||||
|
||||
## 技术参数
|
||||
|
||||
### 音频格式要求
|
||||
|
||||
**TTS 输出：**
|
||||
- 格式：MP3
|
||||
- 采样率：16000 Hz
|
||||
- 声道：单声道
|
||||
|
||||
### API 限制
|
||||
|
||||
- **TTS**: 单次最长 5000 字符
|
||||
- **并发限制**: 根据购买的并发数
|
||||
|
||||
## 在 Claude Code 中使用
|
||||
|
||||
在 Claude Code 中可以直接用自然语言调用：
|
||||
|
||||
**TTS - 文字转语音**:
|
||||
```
|
||||
"把这段话转成语音：你好世界"
|
||||
"用温柔女声合成：欢迎光临"
|
||||
```
|
||||
|
||||
**唱歌**:
|
||||
```
|
||||
"请唱一首关于春天的歌"
|
||||
"唱一个温柔的摇篮曲"
|
||||
"开启与豆包的实时语音对话模式"
|
||||
```
|
||||
|
||||
## 获取 API 凭证
|
||||
|
||||
1. 访问 [火山引擎控制台](https://console.volcengine.com/speech/app)
|
||||
2. 创建应用
|
||||
3. 获取 App ID 和 Access Token
|
||||
4. 开通所需服务：
|
||||
- 豆包语音合成模型2.0
|
||||
|
||||
## 参考链接
|
||||
|
||||
- [火山引擎豆包语音文档](https://www.volcengine.com/docs/6561)
|
||||
- [API 接口文档](https://www.volcengine.com/docs/6561/1096680)
|
||||
- [计费说明](https://www.volcengine.com/docs/6561/1359370)
|
||||
Reference in New Issue
Block a user