Yuki 3.5.2

Yuki 3.5.2 发布与升级说明

Yuki 3.5.2 将正式部署入口改为版本化 Docker 镜像。本版本不改变 Agent、Memory、Plugin API
或数据库结构；Alembic head 仍为 0036，Plugin API 仍为 1.1。

新安装

1. 从 GitHub Release 下载 yuki-3.5.2-deploy.zip 或 yuki-3.5.2-deploy.tar.gz 并解压。
2. 进入解压目录，复制环境模板：cp .env.example .env。
3. 在 .env 中填写 OneBot、管理员和模型配置；保留 YUKI_VERSION=3.5.2。
4. 执行 docker compose up -d。
5. 打开 http://127.0.0.1:6099 完成 NapCat 登录，并检查 docker compose ps。

部署包不包含源码、数据库、密钥或本机配置。Bot 启动时会自动把空数据库迁移到 Alembic
0036。

从旧版本升级

不要把新部署包直接解压覆盖现有目录。升级前：

1. 备份整个 data/，并保留现有 config/、plugins/、napcat-data/、napcat-config/ 和
   napcat-plugins/。

2. 从 Release 单独下载新的 docker-compose.yml 和 .env.example，人工合并必要环境变量。

3. 把现有 .env 的 YUKI_VERSION 改为 3.5.2。

4. 执行：

   docker compose pull
   docker compose up -d
   docker compose ps

5. 检查 docker compose logs --tail 200 bot，并确认 /healthz 返回 status=ok、
   version=3.5.2 和 database=ok。

docker compose pull 只拉取 Compose 当前指定的镜像。正式部署应使用不可变版本号；latest
仅供快速体验，不是生产默认值。不要执行 docker compose down -v。

可选语音 Worker

GenieData 和声线仍由用户放在持久化语音目录中，不会打入镜像。准备完成后执行：

docker compose --profile speech up -d

Yuki 镜像标签为 3.5.2，但 Genie-TTS Worker 的内部组件版本继续保持 1.9.0。

本地源码开发

开发环境才使用构建覆盖：

docker compose -f docker-compose.yml -f docker-compose.dev.yml up -d --build

生产 docker-compose.yml 不包含任何 build:。