TTS2语音代理
具有知识图谱记忆的多字符AI语音代理。
包含所有模型和依赖项的独立项目。专为 混合 环境：在中运行重型AI核心（IndexTTS2） Windows 子系统 for Linux 在保持工具（LM Studio、麦克风）打开的同时，提高Linux性能 视窗.
______________________________________________________________________
主要特点
- 多字符： 孤立的记忆图和声音（赫敏、莉丝贝、助理）。
- 图形内存： 基于SQLite的知识图与GraphRAG社区检测。
- 代理技能： MCP工具、一切搜索、网络搜索、文件访问等。
- 双TTS： IndexTTS2（语音克隆）或Kokoro（快速ONNX，延迟约80ms）。
- 情绪检测： 基于wav2vec2的语音情感识别。
- 混合架构： 无缝桥接WSL（AI）和Windows（音频/工具）。
- 灵活的人工智能： 支持OpenRouter（云）和LM Studio（本地）。
______________________________________________________________________
快速入门（混合动力/Windows）
新用户？ 阅读 安装指南 详细设置。
1.运行启动器
右击 VoiceChat.bat → 以管理员身份运行
注： WSL2安装和键盘挂钩（PTT）需要管理员权限。
2.安装
选择 选项\[5\]安装依赖项.
- 在WSL中设置Python venv（用于AI）。
- 在Windows中设置音频工具。
3.配置
编辑 config.env:
OPENROUTER_API_KEY=sk-or-v1-your-key...
# LM_STUDIO_HOST= “添加到主屏幕”
______________________________________________________________________
## 控制
|动作|按键/模式|
|--------|------------|
| **通话（PTT）** |等等 **右移** （发布发送）|
| **移动PTT** |按住“保持通话”按钮|
| **免提的** |在用户界面中切换“免提模式”|
| **停止音频** |点击UI中的“停止”|
______________________________________________________________________
## TTS选项
|后端|速度|质量|VRAM|语音克隆|
|---------|-------|---------|------|-------------|
| **索引TTS2** |~800ms |优秀|4-6GB|是（5s样本）|
| **Kokoro公司** |~80ms|良好|~500MB|预设声音|
在设置>音频设置>TTS后端中切换。
______________________________________________________________________
## 工具
|工具|说明|
|------|-------------|
| `everything_search` |PC范围的文件搜索（需要一切）|
| `web_search` |DuckDuckGo搜索（无API密钥）|
| `wikipedia` |维基百科查询|
| `read_file` / `write_file` |沙盒文件访问|
| `create_skill` |Agent创造新技能|
|MCP工具|通过 `mcp_config.json` |
______________________________________________________________________
## 文档
- **[安装指南](docs/INSTALL.md)** -逐步设置。
- **[用户手册](docs/USER_MANUAL.md)** -完整的用户指南。
- **[建筑视觉](docs/ARCHITECTURE.md)** -混合动力系统和存储器图。
- **[技术参考](docs/TECHNICAL_REFERENCE.md)** -深入了解图形内存和MCP。
- **[迁移指南](docs/MIGRATION.md)** -移动到新PC。
- **[免责声明](docs/DISCLAIMER.md)** -法律和道德准则。
______________________________________________________________________
## 故障排除
|问题|解决方案|
|-------|----------|
| **LM工作室橙色/红色** |跑步方式 **管理员**，港口 **1235**。参见 [文档](docs/INSTALL.md). |
| **PTT不工作** |使用 **右移**.确保 `VoiceChat.bat` 正在运行。 |
| **连接被拒绝** |检查 `config.env`.评论出来 `LM_STUDIO_HOST`. |
| **情绪总是“悲伤”** |可能存在音频问题-检查麦克风音量|
______________________________________________________________________
## 许可证
MIT许可证。看 [许可证](LICENSE) 了解详情。