# ext2-py-voice-api

**Repository Path**: mind-plus/ext2-py-voice-api

## Basic Information

- **Project Name**: ext2-py-voice-api
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-10-26
- **Last Updated**: 2026-10-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# AI课程工具箱 - 语音工具（aicoursetoolsvoice）

`aicoursetoolsvoice` 是一个适用于 Mind+ V2 Python 积木模式的扩展，由爱方思（AiFangSi）同名 Mind+ V1.8 用户库 `ai_course_tools_voice`（语音工具）转换而来，配合 AIToolkit2 与 AI 课程使用。

该扩展提供语音合成（TTS）、音频播放控制、YAMNet 音频分类、语音克隆与语音生成、语音识别（FunASR/ASR）以及关键词搜索积木。

本扩展无硬件 SKU，运行依赖本机 AIToolkit2 Python 环境中的 `aitoolkit.speech`、`aitoolkit.tts`、`aitoolkit.asr` 等模块（扩展不声明 pip 依赖，与 V1 行为一致）。

## 积木

扩展共 26 个积木，按功能分组：

- 语音（Speech）：文字转语音、长文本转语音、长文本转语音完成回调（帽子）、停止长文本转语音
- 音频（Audio）：播放 / 停止音频、是否正在播放、设置音量（0-100）、设置静音
- 音频处理（Audio Processing）：启动音频可视化演示窗口
- 音频分类（Audio Classification）：初始化 YAMNet 模型、音频分类推理（含音频分类回调帽子积木）、创建数据集、训练模型
- 语音生成（Voice Generation）：初始化 TTS 服务、克隆语音（预设音色 / 外部音频两种）、生成语音（性别 / 音调 / 速度）、获取最后一次生成的语音对象
- 语音识别（Speech Recognition）：音频标准化、语音转文字、添加标点、语音转文本（含标点）
- 文本处理（Text Processing）：关键词搜索

下拉菜单：静音与播放开关（是/否）、音色（刘德华、余承东、马云、鲁豫、哪吒、徐志胜、李靖、杨澜、特朗普（英语）、钟离(英语)，实际值保持 V1 中文原值）、性别（男声/女声）、音调与速度（中等/低/高/非常低/非常高）。

## 示例程序

V1 源库未包含示例工程文件，本仓库暂未提供可运行示例；典型用法：先「指定Python解释器」指向 AIToolkit2 的 primary 目录，再按需调用 TTS、ASR 或音频分类积木。

## 支持列表

本扩展为 Python 积木模式（`mode: "python-block"`），不绑定主板，在 Mind+ Python 模式下于 Windows 平台配合 AIToolkit2 使用（V1 config 声明 `platform: ["win"]`）。

## 更新日志

### V2.0.6

- 由 Mind+ V1 用户库 `ai_course_tools_voice` 2.0.6 完整转换为 Mind+ V2 扩展；积木名称、参数、菜单值与生成代码行为保持一致（`compatibilityId: 爱方思-ai_course_tools_voice-thirdex`）

## 开发指南

- 源码位于 `extension/`（index.js 积木定义、func.js 生成代码、public/ 配置与本地库、icon/ 图标、locales/ 翻译）。
- 本地 Python 库 `public/libraries/env.py`、`a.py` 负责按 `#env_path` 注释切换到 AIToolkit2 解释器运行生成的脚本。
- 初始化与编译：`npm install` 后 `npm run build`，产物在 `build/`。
- 更详细的 Mind+ V2 扩展开发说明请参考：[Mind+官方扩展开发文档](https://mindplus.dfrobot.com.cn/mp2/Extensions/)