编辑
2025-04-03
智能小智
00
请注意,本文编写于 96 天前,最后修改于 63 天前,其中某些信息可能已经过时。

目录

小智ESP32服务端配置编辑器最新版 v0.1.9
项目简介
下载
运行
编辑配置
开发信息
技术栈
依赖库列表
常见问题
联系方式
更新日志
v0.1.9
v0.1.8
v0.1.7
v0.1.6
v0.1.5
v0.1.4
v0.1.3
v0.1.2
v0.1.1
v0.1.0
致谢

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

@config_editor.py 感谢 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

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

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

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

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

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

或者从以下地址获取最新版本 博客https://znhblog.com B站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,您仍然可以手动输入模型名称。

由于这是我开发的第一个工具,可能还有些不足,请各位嘴下留情,多点包容

联系方式

如有问题可加微信群一起沟通(在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 项目的开发者们,他们的开源项目让我们能够体验本地的小智服务系统。


如果您觉得这个工具有用,请给原项目 xiaozhi-esp32-server 点个星标⭐!

本文作者:曾能混

本文链接:

版权声明:本博客所有文章除特别声明外,均采用 BY-NC-SA 许可协议。转载请注明出处!