# nlcosyvoice

**Repository Path**: mt_chen/nlcosyvoice

## Basic Information

- **Project Name**: nlcosyvoice
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-16
- **Last Updated**: 2026-06-22

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# NL CosyVoice

完全本地离线、免费无联网的 Flutter 跨端文字转语音应用，基于 **Fun-CosyVoice3-0.5B-2512** 大模型。

## 特性

- 全程本地推理，禁止云端上传与联网校验
- 命令行下载模型权重脚本 + 环境自检脚本
- 多音色切换、本地音色克隆、情感/语速/语调/音量调节
- 可配置音频生成保存目录、音色录入保存目录
- 个人音色：底部「录入」Tab，支持录制、导入、试听
- 长文本批量推理：一次 Python 进程、模型只加载一次，降低 CPU 占用
- 错误信息可选中复制（设置开关控制）
- 接口抽象解耦，可无缝替换底层 TTS 模型

## 快速开始

```bash
flutter pub get
scripts\deploy.bat        # 首次：一键部署到项目目录
scripts\run_windows.bat   # 日常启动
```

> Python 与引擎路径写入 `native/inference/.cosyvoice_env.json`（项目内，非 C 盘用户目录）。

首次使用需准备 **两样东西**（详见部署文档）：

1. **模型权重**：`scripts\download_model.bat`（默认 `models/`）
2. **Python 推理引擎**：`scripts\setup_cosyvoice.bat`（默认 `third_party/CosyVoice/`，非 C 盘用户目录）

```bash
pip install modelscope
scripts\download_model.bat
scripts\check_inference_env.bat
```

## 文档

| 文档 | 说明 |
|------|------|
| [配置说明](docs/06-配置说明.md) | **全部配置项**与自动配置方式 |
| [项目结构](docs/00-项目结构.md) | 目录布局与模块职责 |
| [项目设计文档](docs/01-项目设计文档.md) | 架构、模块、存储规范 |
| [技术开发文档](docs/02-技术开发文档.md) | 接口、打包、设置项 |
| [部署文档](docs/03-小白一键运行部署文档.md) | 模型下载、环境、排错 |
| [Flutter→Python 推理流程](docs/04-Flutter调用Python离线推理流程.md) | 调用链路、入口文件 |
| [界面操作手册](docs/05-界面操作手册.md) | 全部 Tab 功能与操作说明 |
| [项目实现原理](docs/07-项目实现原理.md) | **依赖包、音频链路、关键代码** |

## 打包

```bash
scripts\build_windows.bat
scripts\build_android.bat
scripts\build_web.bat
```

## Flutter 调用 Python 推理（简述）

```
首页生成 → SynthesisService → CosyVoiceDesktopBridge.synthesizeBatch()
  → python native/inference/cosyvoice_inference.py --batch_stdin + stdin JSON
  → CosyVoice AutoModel（进程内加载一次）→ 多段 WAV → 合并导出
```

详见 [docs/04-Flutter调用Python离线推理流程.md](docs/04-Flutter调用Python离线推理流程.md)。