# 小智ESP32服务端配置编辑器最新版 v0.1.9

@config_editor.py 感谢 [github.com/xinnan-tech/xiaozhi-esp32-server](https://github.com/xinnan-tech/xiaozhi-esp32-server) 大佬们开源项目让我们体验本地的小智服务系统。

## 项目简介

小智ESP32服务端配置编辑器是一个图形化工具，专为 xiaozhi-esp32-server 项目设计，旨在简化配置文件的编辑过程。通过直观的界面，用户可以轻松查看和修改 `data/.config.yaml` 文件中的各项配置，无需手动编辑YAML文件。
360有可能会误报风险，但作者承诺在官方提供的下载链接下载的工具包不含任何对操作系统有风险的行为，没有主动联网行为。（如果你在其它地方下载的作者无法保证工具的安全）

本工具为完全免费无任何收费项目无套路，如果有人向你收取费用使用本工具与作者无关。




### 下载

夸克网盘分享了「小智服务端图形化配置编辑器v0.1.9.zip」
链接：https://pan.quark.cn/s/53959ac7349e

通过网盘分享的文件：小智服务端图形化配置编辑器v0.1.9.zip
链接: https://pan.baidu.com/s/1r8xIHB_oU4H_lSIEq7Zv1g?pwd=ftnu 提取码: ftnu 

百度网盘：小智服务端图形化部署工具
链接: https://pan.baidu.com/s/1kYEd7tbwQgNjC6A3KI4DDw?pwd=e4xc 提取码: e4xc 

夸克网盘「小智服务端图形化部署工具」
链接：https://pan.quark.cn/s/6b1539a1c130

夸克网盘分享了「智能小智服务端」里面包含了v0.1.3到v0.1.18官方原版包
链接：https://pan.quark.cn/s/e82f835a9abf

通过网盘分享的文件：智能小智服务端 里面包含了v0.1.3到v0.1.18官方原版包
链接: https://pan.baidu.com/s/1HDPaXrcSNTvcKevwhmZP0w?pwd=5wsj 提取码: 5wsj 

或者从以下地址获取最新版本
**博客**：[https://znhblog.com](https://znhblog.com)
**B站**：[https://space.bilibili.com/298384872](https://space.bilibili.com/298384872)

### 运行
1. 解压下载的文件
2. 双击运行 `config_editor.exe`（Windows）
3. 首次运行时，程序会检查 `data/.config.yaml` 文件是否存在
   - 如果不存在，会提示从 `config.yaml` 创建或创建空文件
4. 加载完成后，即可开始编辑配置

### 编辑配置
1. 从左侧菜单选择要编辑的配置项
2. 在右侧编辑区修改配置值
3. 点击右下角的"应用更改"按钮应用修改
4. 完成后点击"保存到文件"按钮保存到配置文件

## 开发信息

### 技术栈
- Python 3.x
- Tkinter (GUI库)
- ruamel.yaml (YAML处理库)

### 依赖库列表

如果您想自行运行源代码或构建程序，需要安装以下Python库：

```bash
# requirements.txt
ruamel.yaml==0.17.21
PyYAML==6.0
pyinstaller==5.9.0  # 仅用于构建可执行文件
```

主要依赖说明：
- **ruamel.yaml**: 用于处理YAML文件，保留注释和格式
- **PyYAML**: 用于简单的YAML处理
- **tkinter**: Python标准库，用于创建GUI界面（无需单独安装）

## 常见问题

**Q: 为什么保存后配置文件的格式发生了变化？**  
A: 最新版本使用ruamel.yaml库保存配置，能够保留原始格式和注释。如果仍有问题，请更新到最新版本。

**Q: 如何添加新的令牌？**  
A: 在左侧菜单选择"服务器设置"，然后编辑"令牌列表"部分。您可以直接在YAML文本框中添加新的令牌项。

**Q: 如何更改使用的模块？**  
A: 在左侧菜单选择"模块选择"，然后在下拉菜单中选择要使用的模块类型。

**Q: 为什么我看不到Ollama模型列表？**  
A: 确保您已经安装了Ollama，并且可以在命令行中运行`ollama list`命令。如果您没有安装Ollama，您仍然可以手动输入模型名称。
    
由于这是我开发的第一个工具，可能还有些不足，请各位嘴下留情，多点包容
## 联系方式

- **作者**：曾能混
- **博客**：[https://znhblog.com](https://znhblog.com)
- **B站**：[https://space.bilibili.com/298384872](https://space.bilibili.com/298384872)
- **QQ**：7280051
- **邮箱**：jwhna1@gmail.com

如有问题可加微信群一起沟通（在B站私信索取微信群加群二维码）

## 更新日志

### v0.1.9
- 紧急修复：优化Ollama模型列表获取机制，感谢B站@糊了的坚果 反馈
  - 改用API方式替代命令行方式获取模型列表，解决未安装官方Ollama程序时的报错问题
  - 优化模型列表获取逻辑，首次进入配置界面不再自动获取，改为点击"获取可用模型"按钮时才获取
  - 支持自定义Ollama服务器地址，方便局域网内其他机器使用
  - 添加友好的错误提示和加载状态显示
- 修复selected_module配置项未完整显示子项的问题
  - 改进子模块读取逻辑，动态获取配置文件中的所有可用选项
  - 移除硬编码的模块选项列表，提高兼容性

### v0.1.8
- 优化对新版本服务端config.yaml文件的新字段兼容支持
- 将所有菜单项和界面元素转换为中文标题和标签，提升本地化体验
- 优化了Ollama本地模型列表的获取方式，提高了获取速度和可靠性
- 增强对非本机部署的Ollama服务器模型列表的支持
- 修复了selected_module部分由于注释重复读取导致的UI卡顿问题
- 优化了LLM和TTS树状列表，解决保存后跳转到大项列表时的UI卡顿问题
- 改进模块描述提取逻辑，使用更高效的算法减少重复内容

### v0.1.7
- 添加自定义应用图标，提升专业性和识别度
- 优化用户界面，提高视觉体验

### v0.1.6
- 添加Ollama模型智能选择功能，自动获取本地安装的Ollama模型列表
- 为OllamaLLM的model_name字段提供下拉菜单选择，避免手动输入错误
- 添加刷新按钮，允许用户随时更新Ollama模型列表
- 优化用户界面，提高配置编辑体验
- 添加欢迎页面，启动时显示项目信息和快速链接
- 修复提示词保存时出现格式问题的bug
- 改进字符串处理，确保YAML文件格式正确
- 优化代码结构，提高程序稳定性

### v0.1.5
- 优化LLM和TTS模块显示，使用树状菜单结构避免内容过多导致卡顿
- 修复提示词保存时出现`|-`符号导致的乱码问题
- 改进YAML字符串处理，确保保存后格式正确
- 优化模块子项编辑界面，提高用户体验
- 改进版本检测机制，使用自有服务器检查更新，避免GitHub访问不稳定问题

### v0.1.4
- 添加版本检测和更新功能
- 修复tokens列表编辑问题
- 优化用户界面，添加全局应用按钮

### v0.1.3
- 添加"关于"对话框
- 添加中文界面支持
- 修复多项bug

### v0.1.2
- 添加配置文件加载功能
- 优化菜单布局

### v0.1.1
- 添加启动检测逻辑
- 修复编辑器显示问题

### v0.1.0
- 初始版本发布


## 致谢

特别感谢 [github.com/xinnan-tech/xiaozhi-esp32-server](https://github.com/xinnan-tech/xiaozhi-esp32-server) 项目的开发者们，他们的开源项目让我们能够体验本地的小智服务系统。

---

如果您觉得这个工具有用，请给原项目 [xiaozhi-esp32-server](https://github.com/xinnan-tech/xiaozhi-esp32-server) 点个星标⭐！

小智服务端图形化配置编辑器v0.1.9更新

# 小智ESP32服务端一键部署工具

@小智服务端图形化部署工具 感谢 [github.com/xinnan-tech/xiaozhi-esp32-server](https://github.com/xinnan-tech/xiaozhi-esp32-server) 大佬们开源项目让我们体验本地的小智服务系统。

## 项目简介

小智ESP32服务端一键部署工具是一个图形化工具，专为 xiaozhi-esp32-server 项目设计，旨在简化服务端的部署和运行过程。通过直观的界面，用户可以轻松管理Python环境、安装依赖、启动和监控服务，无需手动执行复杂的命令行操作。

![小智服务端图形化部署工具](/static/img/3b34d68d4db68336a2b31794d434b5c7.1743250713812.webp)



### 下载
百度网盘：小智服务端图形化部署工具
链接: https://pan.baidu.com/s/1kYEd7tbwQgNjC6A3KI4DDw?pwd=e4xc 提取码: e4xc 

夸克网盘「小智服务端图形化部署工具」
链接：https://pan.quark.cn/s/6b1539a1c130

夸克网盘「智能小智服务端配置编辑器」。
链接：https://pan.quark.cn/s/2019bea0892d

通过网盘分享的文件：小智服务端配置编辑器
链接: https://pan.baidu.com/s/1d0r_NIHe7CAabrR9AGWKtw?pwd=ucce 提取码: ucce 

夸克网盘分享了「智能小智服务端」里面包含了v0.1.3到v0.1.16官方原版包
链接：https://pan.quark.cn/s/e82f835a9abf

通过网盘分享的文件：智能小智服务端 里面包含了v0.1.3到v0.1.16官方原版包
链接: https://pan.baidu.com/s/1HDPaXrcSNTvcKevwhmZP0w?pwd=5wsj 提取码: 5wsj 

## 主要功能

- **图形化界面**：直观的用户界面，使部署和运行更加简单
- **Python环境管理**：自动检测和管理Python环境，支持多环境切换
- **依赖管理**：自动检查和安装项目所需依赖，支持国内镜像加速
- **服务管理**：一键启动和停止服务，实时监控服务状态和日志
- **配置编辑器集成**：内置配置编辑器，方便修改服务配置
- **系统托盘支持**：支持最小化到系统托盘，方便后台运行
- **自动更新检测**：启动时自动检查是否有新版本可用
- **首次运行引导**：首次启动时自动检测环境并提供配置引导
- **多语言支持**：界面元素使用中文显示，提升用户体验
- **日志管理**：分类显示工具日志和服务日志，支持实时查看

## 功能详解

### Python环境管理
- 自动检测系统Python环境
- 支持手动选择Python解释器
- 显示Python版本信息
- 支持多环境切换

### 依赖管理
- 自动检查项目依赖
- 使用国内镜像加速安装
- 显示详细的安装进度
- 支持批量安装缺失依赖

### 服务管理
- 一键启动/停止服务
- 实时显示服务状态
- 支持优雅停止服务
- 自动重试和错误处理

### 日志管理
- 分类显示工具日志和服务日志
- 支持实时查看日志输出
- 自动滚动到最新日志
- 支持日志过滤和搜索

### 配置管理
- 集成配置编辑器
- 支持配置文件备份
- 自动检测配置文件
- 配置文件格式验证

## 安装与使用



### 运行
1. 解压下载的文件
2. 双击运行 `小智服务端部署工具.exe`
3. 首次运行时，程序会引导您完成初始配置：
   - 选择Python环境
   - 检查并安装依赖
   - 配置服务参数

### 使用说明
1. 启动程序后，首先检查Python环境
2. 点击"检查依赖"按钮检查所需依赖
3. 如有缺失依赖，点击"安装依赖"进行安装
4. 配置完成后，点击"启动服务器"运行服务
5. 使用"打开配置器"可以修改服务配置
6. 服务运行时可以最小化到系统托盘

## 开发信息

### 技术栈
- Qt 6.x (GUI框架)
- C++17
- CMake (构建系统)

### 依赖库列表

如果您想自行编译程序，需要安装以下开发环境：

```bash
# 必需组件
Qt 6.x
CMake 3.15+
C++17 兼容的编译器
```

主要依赖说明：
- **Qt**: 用于创建GUI界面和系统托盘
- **CMake**: 用于项目构建
- **C++17**: 用于现代C++特性支持

## 常见问题

**Q: 为什么无法启动服务？**  
A: 请检查以下几点：
1. Python环境是否正确配置
2. 所需依赖是否已安装
3. 配置文件是否存在且格式正确

**Q: 如何更新程序？**  
A: 程序会自动检查更新，您也可以：
1. 点击"检查更新"按钮手动检查
2. 访问GitHub Releases页面下载新版本
3. 访问作者博客获取最新版本

**Q: 如何修改服务配置？**  
A: 点击"打开配置器"按钮，使用内置的配置编辑器修改配置。

**Q: 服务无法正常停止怎么办？**  
A: 程序会自动尝试多种方式停止服务，如果仍然无法停止，可以：
1. 等待程序自动强制终止
2. 手动关闭程序窗口
3. 使用任务管理器结束进程

## 联系方式

- **作者**：曾能混
- **博客**：[https://znhblog.com](https://znhblog.com)
- **B站**：[https://space.bilibili.com/298384872](https://space.bilibili.com/298384872)
- **QQ**：7280051
- **邮箱**：jwhna1@gmail.com

如有问题可加微信群一起沟通（在B站私信索取微信群加群二维码）

## 更新日志

### v0.1.6 (2025-03-29)
- 优化了"关于"对话框的设计，采用一体化布局提升视觉体验
- 修改服务终端日志颜色方案，统一非错误/警告日志为浅绿色，提高可读性
- 移除了可能触发杀毒软件误报的代码，提高系统兼容性
- 优化了SSL错误处理机制，解决远程系统上的TLS初始化失败问题
- 简化了更新检查流程，使用HTTP连接提高兼容性
- 调整了整体UI界面字体大小和布局，提升在不同Windows系统上的显示效果
- 完全适配 xiaozhi-esp32-server v0.1.11 版本
- 向下兼容 xiaozhi-esp32-server v0.1.3 至 v0.1.16所有版本

### v0.1.3 (重大更新)
- 使用C++/Qt6.8.2重构整个项目，彻底解决Python版本在嵌入式终端命令行兼容性问题
- 修复调用播放音乐函数时导致服务卡死的问题
- 优化服务启动和停止机制，提高稳定性
- 改进日志管理功能，支持实时查看和过滤
- 完全适配 xiaozhi-esp32-server v0.1.9 版本
- 向下兼容 xiaozhi-esp32-server v0.1.3 至 v0.1.9 所有版本

### v0.1.2 (Python版本)
- 添加Python环境检测
- 优化依赖管理
- 改进服务控制
- 添加基本日志功能
- 适配 xiaozhi-esp32-server v0.1.3 至 v0.1.6 版本

### v0.1.1 (Python版本)
- 添加配置文件管理
- 优化界面布局
- 改进错误处理
- 添加基本功能
- 适配 xiaozhi-esp32-server v0.1.3至v0.1.5 版本

### v0.1.0 (Python版本)
- 初始版本发布
- 基于Python开发
- 适配 xiaozhi-esp32-server v0.1.3 版本

## 许可证

本项目基于 MIT 许可证开源。

## 致谢

特别感谢 [github.com/xinnan-tech/xiaozhi-esp32-server](https://github.com/xinnan-tech/xiaozhi-esp32-server) 项目的开发者们，他们的开源项目让我们能够体验本地的小智服务系统。

---

如果您觉得这个工具有用，请给原项目 [xiaozhi-esp32-server](https://github.com/xinnan-tech/xiaozhi-esp32-server) 点个星标⭐！

# 小智服务端问题修复指南

本指南帮助解决小智服务端部署工具可能遇到的常见问题。

## 问题修复工具

这里提供了几个工具脚本，用于解决以下问题：

1. **Qt库文件加载问题** - Qt DLL无法在子目录中被正确加载
2. **Opus库缺失问题** - opuslib_next库找不到opus.dll

## 使用方法

### 综合解决方案

使用 `xiaozhi_helper.bat` 提供了一个菜单式界面，可以：
- 启动小智服务端程序（自动处理Qt DLL）
- 安装Opus库
- 检查和修复Qt依赖

```
xiaozhi_helper.bat
```

### 修复Opus库问题

有两种方式修复Opus库问题：

#### 1. Python脚本修复 (推荐)
这个方法通过修改opuslib_next库的加载方式，使其能够找到程序目录下的opus.dll：

```
python fix_opuslib.py
```

#### 2. Python环境配置
这个方法会在Python环境中创建一个sitecustomize.py文件，为所有Python程序设置正确的DLL搜索路径：

```
python_env_helper.bat
```

## 文件结构说明

程序预期的文件结构：

```
xiaozhi_server_runner.exe      # 主程序
libs/                          # 库文件目录
  ├── Qt6Core.dll              # Qt核心库
  ├── Qt6Gui.dll               # Qt GUI库
  ├── Qt6Network.dll           # Qt网络库
  ├── Qt6Widgets.dll           # Qt控件库
  ├── opus.dll                 # Opus音频编解码库
  └── platforms/               # Qt平台插件目录
      └── qwindows.dll         # Windows平台插件
```

## 常见问题解答

### Q: 为什么Qt库文件放在libs目录不能被正确加载?
A: Windows的DLL加载机制首先查找程序所在目录，然后是系统目录，最后才是PATH环境变量中的目录。辅助工具通过临时复制DLL到程序目录解决这个问题。

### Q: 为什么会出现"Could not find Opus library"错误?
A: opuslib_next库需要opus.dll，但无法找到它。我们的修复方案通过直接修改opuslib_next库的加载机制，使其能够从程序目录或libs目录找到opus.dll。

### Q: 服务正常启动但语音识别或合成功能不可用怎么办?
A: 请确保opus.dll已正确安装，并且Python环境变量设置正确。使用fix_opuslib.py脚本可以解决大多数相关问题。

## 注意事项

- 这些修复脚本不需要管理员权限，可由普通用户运行
- 所有DLL文件仍然保存在libs目录，保持目录结构的整洁
- 启动程序时会临时复制所需DLL，结束后自动清理

小智服务端图形化部署工具v0.1.6

# 智能小智服务端配置编辑器v0.1.5


## 项目简介

首先感谢 https://github.com/xinnan-tech/xiaozhi-esp32-server 开发大佬让我们普通用户能在自已电脑体验完整的智能小智的服务端！
本工具将永久免费
重要事情说三遍工具完全免费无套路使用如遇到向你收费使用的的与本作者无关。

智能小智服务端配置编辑器是一个图形化工具，专为 xiaozhi-esp32-server 项目设计，旨在简化配置文件的编辑过程。
通过直观的界面，用户可以轻松查看和修改 `data/.config.yaml` 文件中的各项配置，无需手动编辑YAML文件。

[智能小智服务端配置编辑器v0.1.5]

![1741972825162.jpg](/static/img/82f52ae5a631fa714fd4e85aefc2a0c1.1741972825162.webp)



### 下载
百度网盘分享的文件：智能小智服务端配置编辑器v0.1.5.zip
链接: https://pan.baidu.com/s/1bG2HzA1bN_ogqV5HV1Yu8g?pwd=vpbg 提取码: vpbg 

我用夸克网盘。
链接：https://pan.quark.cn/s/f3d146788a69
提取码：rjfp

或者从以下地址获取最新版本

**博客**：[https://znhblog.com](https://znhblog.com)

**B站**：[https://space.bilibili.com/298384872](https://space.bilibili.com/298384872)
## 主要功能

- **图形化界面**：直观的用户界面，使配置编辑更加简单
- **配置文件加载与保存**：支持加载和保存YAML配置文件，保留原始格式和注释
- **多语言支持**：界面元素使用中文显示，提升用户体验
- **模块化配置**：分类显示各模块配置，包括服务器设置、日志设置、模块选择等
- **自动检测更新**：启动时自动检查是否有新版本可用
- **首次启动检测**：首次启动时自动检测配置文件和目录，提示用户创建

## 功能详解

### 配置文件管理
- 加载配置文件：支持从任意位置加载YAML配置文件
- 保存配置文件：保存修改后的配置，同时保留原始格式和注释
- 重置配置：将配置重置为加载时的状态

### 模块配置
- **服务器设置**：配置IP地址、端口和认证信息
- **日志设置**：设置日志级别、格式和存储位置
- **模块选择**：选择使用的VAD、ASR、LLM、TTS等模块
- **提示词编辑**：编辑AI的提示词，决定其行为和回复风格
- **音乐设置**：配置音乐目录和相关参数
- **其他设置**：包括退出命令、无语音断开时间等

### 特色功能
- **令牌列表编辑**：通过YAML文本直接编辑令牌列表，更加灵活
- **动态模块选择**：根据配置文件自动识别可用模块
- **应用更改按钮**：统一应用所有修改，提高操作效率
- **滚动视图**：支持长内容的滚动显示，确保所有配置项可见

## 安装与使用



### 运行
1. 解压下载的文件放把 小智ESP32服务端编辑器.exe放到xiaozhi-esp32-serve/main/xiaozhi-esp32-serve/目录下
2. 双击运行 `config_editor.exe`（Windows）或 `config_editor`（Linux/macOS）
3. 首次运行时，程序会检查 `data/.config.yaml` 文件是否存在
   - 如果不存在，会提示从 `config.yaml` 创建或创建空文件
4. 加载完成后，即可开始编辑配置

### 编辑配置
1. 从左侧菜单选择要编辑的配置项
2. 在右侧编辑区修改配置值
3. 点击右下角的"应用更改"按钮应用修改
4. 完成后点击"保存到文件"按钮保存到配置文件

## 开发信息

### 技术栈
- Python 3.x
- Tkinter (GUI库)
- ruamel.yaml (YAML处理库)
## 常见问题

**Q: 为什么保存后配置文件的格式发生了变化？**  
A: 最新版本使用ruamel.yaml库保存配置，能够保留原始格式和注释。如果仍有问题，请更新到最新版本。

**Q: 如何添加新的令牌？**  
A: 在左侧菜单选择"服务器设置"，然后编辑"令牌列表"部分。您可以直接在YAML文本框中添加新的令牌项。

**Q: 如何更改使用的模块？**  
A: 在左侧菜单选择"模块选择"，然后在下拉菜单中选择要使用的模块类型。
    
由于这是我开发的第一个工具，可能还有些不足，请各位嘴下留情，多点包容
## 联系方式

- **作者**：曾能混
- **B站**：[https://space.bilibili.com/298384872](https://space.bilibili.com/298384872)
- **QQ**：7280051
- **邮箱**：jwhna1@gmail.com

如有问题可加微信群一起沟通（在B站私信索取微信群加群二维码）

## 更新日志

### v0.1.5
- 优化LLM和TTS模块显示，使用树状菜单结构避免内容过多导致卡顿
- 修复提示词保存时出现`|-`符号导致的乱码问题
- 改进YAML字符串处理，确保保存后格式正确
- 优化模块子项编辑界面，提高用户体验
- 改进版本检测机制，使用自有服务器检查更新，避免GitHub访问不稳定问题

### v0.1.4
- 添加版本检测和更新功能
- 修复tokens列表编辑问题
- 优化用户界面，添加全局应用按钮

### v0.1.3
- 添加"关于"对话框
- 添加中文界面支持
- 修复多项bug

### v0.1.2
- 添加配置文件加载功能
- 优化菜单布局

### v0.1.1
- 添加启动检测逻辑
- 修复编辑器显示问题

### v0.1.0
- 初始版本发布

## 许可证

本项目基于 MIT 许可证开源。

## 致谢

特别感谢 [github.com/xinnan-tech/xiaozhi-esp32-server](https://github.com/xinnan-tech/xiaozhi-esp32-server) 项目的开发者们，他们的开源项目让我们能够体验本地的小智服务系统。

智能小智服务器图形化配置工具v0.1.5版本来了

# 小智ESP32服务端配置编辑器


## 项目简介

小智ESP32服务端配置编辑器是一个图形化工具，专为 https://github.com/xinnan-tech/xiaozhi-esp32-server 项目设计，旨在简化配置文件的编辑过程。通过直观的界面，用户可以轻松查看和修改 `data/.config.yaml` 文件中的各项配置，无需手动编辑YAML文件。免费无套路使用工具

![小智ESP32服务端配置编辑器](https://znhblog.com/static/img/bdfad1d57be1564e618faad4589eb2af.20250313211705.webp)




### 下载
夸克网盘分享了「小智ESP32服务端配置编辑器v0.1.4.zip」，点击链接即可保存。打开「夸克APP」，无需下载在线播放视频，畅享原画5倍速，支持电视投屏。
链接：https://pan.quark.cn/s/30d6ff39e075

或者从以下地址获取最新版本

**博客**：[https://znhblog.com](https://znhblog.com)

**B站**：[https://space.bilibili.com/298384872](https://space.bilibili.com/298384872)
## 主要功能

- **图形化界面**：直观的用户界面，使配置编辑更加简单
- **配置文件加载与保存**：支持加载和保存YAML配置文件，保留原始格式和注释
- **多语言支持**：界面元素使用中文显示，提升用户体验
- **模块化配置**：分类显示各模块配置，包括服务器设置、日志设置、模块选择等
- **自动检测更新**：启动时自动检查是否有新版本可用
- **首次启动检测**：首次启动时自动检测配置文件和目录，提示用户创建

## 功能详解

### 配置文件管理
- 加载配置文件：支持从任意位置加载YAML配置文件
- 保存配置文件：保存修改后的配置，同时保留原始格式和注释
- 重置配置：将配置重置为加载时的状态

### 模块配置
- **服务器设置**：配置IP地址、端口和认证信息
- **日志设置**：设置日志级别、格式和存储位置
- **模块选择**：选择使用的VAD、ASR、LLM、TTS等模块
- **提示词编辑**：编辑AI的提示词，决定其行为和回复风格
- **音乐设置**：配置音乐目录和相关参数
- **其他设置**：包括退出命令、无语音断开时间等

### 特色功能
- **令牌列表编辑**：通过YAML文本直接编辑令牌列表，更加灵活
- **动态模块选择**：根据配置文件自动识别可用模块
- **应用更改按钮**：统一应用所有修改，提高操作效率
- **滚动视图**：支持长内容的滚动显示，确保所有配置项可见

## 安装与使用



### 运行
1. 解压下载的文件放把 小智ESP32服务端编辑器.exe放到xiaozhi-esp32-serve/main/xiaozhi-esp32-serve/目录下
2. 双击运行 `config_editor.exe`（Windows）或 `config_editor`（Linux/macOS）
3. 首次运行时，程序会检查 `data/.config.yaml` 文件是否存在
   - 如果不存在，会提示从 `config.yaml` 创建或创建空文件
4. 加载完成后，即可开始编辑配置

### 编辑配置
1. 从左侧菜单选择要编辑的配置项
2. 在右侧编辑区修改配置值
3. 点击右下角的"应用更改"按钮应用修改
4. 完成后点击"保存到文件"按钮保存到配置文件

## 开发信息

### 技术栈
- Python 3.x
- Tkinter (GUI库)
- ruamel.yaml (YAML处理库)
## 常见问题

**Q: 为什么保存后配置文件的格式发生了变化？**  
A: 最新版本使用ruamel.yaml库保存配置，能够保留原始格式和注释。如果仍有问题，请更新到最新版本。

**Q: 如何添加新的令牌？**  
A: 在左侧菜单选择"服务器设置"，然后编辑"令牌列表"部分。您可以直接在YAML文本框中添加新的令牌项。

**Q: 如何更改使用的模块？**  
A: 在左侧菜单选择"模块选择"，然后在下拉菜单中选择要使用的模块类型。
    
由于这是我开发的第一个工具，可能还有些不足，请各位嘴下留情，多点包容
## 联系方式

- **作者**：曾能混
- **B站**：[https://space.bilibili.com/298384872](https://space.bilibili.com/298384872)
- **QQ**：7280051
- **邮箱**：jwhna1@gmail.com

如有问题可加微信群一起沟通（在B站私信索取微信群加群二维码）

## 更新日志

### v0.1.4
- 添加版本检测和更新功能
- 修复tokens列表编辑问题
- 优化用户界面，添加全局应用按钮

### v0.1.3
- 添加"关于"对话框
- 添加中文界面支持
- 修复多项bug

### v0.1.2
- 添加配置文件加载功能
- 优化菜单布局

### v0.1.1
- 添加启动检测逻辑
- 修复编辑器显示问题

### v0.1.0
- 初始版本发布

## 许可证

本项目基于 MIT 许可证开源。

## 致谢

特别感谢 [github.com/xinnan-tech/xiaozhi-esp32-server](https://github.com/xinnan-tech/xiaozhi-esp32-server) 项目的开发者们，他们的开源项目让我们能够体验本地的小智服务系统。