v0.9.6

Sakura 更新说明

这次更新带来了更完整的插件系统、更方便的角色与语音包管理、更好用的设置页面，以及多项 TTS、记忆和桌宠交互体验优化。

注意

本次更新将角色包的立绘人格资源和语音模型分离开来, 便于分发

旧用户: 系统自动兼容
新用户: 下面release页面提供了角色卡和语音包, 按照说明导入即可

新功能

主题色自定义功能

• 加入了自定义主题色功能
• 现在可以使用ai对立绘进行分析选取主题色

角色与语音包管理

• 角色导出功能升级，现在支持导出完整角色包、单角色包和独立语音包。
• 新增 .voice 语音包导入/导出，方便单独迁移或分享角色语音模型。
• 角色包现在可以更好地保存和恢复角色主题配置。

设置页体验优化

• 设置页结构重新整理，分类更清晰，使用起来更直观。
• API 设置新增“检测模型”功能，可以自动拉取可用模型列表。
• TTS 设置会根据当前角色和启用状态自动调整可用选项，减少误操作。

TTS 与语音运行时增强

• 新增 macOS GPT-SoVITS 运行时支持。
• 优化 TTS 安装与迁移流程，降低 Windows 路径过长导致的问题。
• 启动后会提前预热 TTS 服务，让语音不可用的问题更早暴露。
• 改善 TTS 启动等待和错误提示，问题原因更容易看懂。

桌宠交互优化

• 优化多屏和混合 DPI 环境下的拖拽体验。
• 支持更稳定的托盘隐藏与恢复。
• 优化立绘缩放后的舞台碰撞区域，减少桌宠遮挡桌面操作的情况。
• 截图按钮状态更加清晰，可以区分选择截图和已附加截图。

插件系统升级

• 新增插件管理能力，可以在设置页中查看和管理插件启用状态。
• 支持更规范的插件接入方式，插件可以提供工具、设置面板、聊天组件等能力。
• 新增示例插件，方便开发者参考和扩展 Sakura 的功能。

Bug 修复

• 修复历史清空时长期记忆保存可能卡住的问题。
• 修复手动记忆整理失败时反馈不明确的问题。
• 修复长期记忆初始化失败时缺少清晰提示的问题。
• 修复部分 API 服务不支持特定参数时聊天补全失败的问题。
• 修复 TTS 检测过程中重复点击导致状态文案异常的问题。
• 修复未修改 TTS 配置时仍重复检测的问题。
• 修复角色导出时语音模型资源缺失未提前提示的问题。
• 修复 Windows 混合 DPI、多屏切换和跨屏拖拽时的异常。
• 修复部分 Qt 环境缺少跨屏事件枚举时可能崩溃的问题。

其他改进

• 更新 README 与技术文档结构。
• 更新 GitHub Actions 和打包测试流程。
• 增加大量自动化测试，提升插件、TTS、角色包、设置页和桌宠窗口相关功能的稳定性。

What's Changed

• Fix/macos tts runtime gpt sovits by @nothing14346 in #9
• test: make fake TTS runtimes executable by @nothing14346 in #10
• Fix/macos tts UI by @nothing14346 in #12
• Fix: 修复设置页的TTS检测和启动逻辑 by @Rvosy in #14
• fix: 修复 issue #13 by @Rvosy in #15
• Feat/settings UI by @Rvosy in #16
• fix: handle chat completion compatibility fallbacks by @Rvosy in #17
• fix: 修复记忆热重载与弹窗通知 by @Rvosy in #18
• feat: 拆分角色与语音包导入导出 by @Rvosy in #19
• 修改舞台碰撞箱高度下限锁定，导致桌宠干扰用户使用电脑的问题 by @nothing14346 in #20
• feat: 为 API 设置页加入模型列表检测 by @Rvosy in #21
• fix: 修复长期记忆初始化反馈、角色语音包导出校验与 CI 配置 by @Rvosy in #24
• fix: 修正 TTS 启动等待日志语义 by @Rvosy in #25
• fix: 修复手动记忆整理失败 by @Rvosy in #26
• fix: 修复 Windows 混合 DPI 跨屏拖拽异常 by @Rvosy in #28
• docs: 更新README, 拆分出技术文档,只保留项目介绍和教程 by @Rvosy in #29
• Docs: 更新文档和图片 by @Rvosy in #30
• feat: 合并插件系统、TTS 与角色包管理更新 by @Rvosy in #31
• fix: 修复huggingface镜像站下载问题 by @Rvosy in #34
• fix: 修复 huggingface 镜像站下载问题, 退回源站下载 by @Rvosy in #35

New Contributors

• @nothing14346 made their first contribution in #9

Full Changelog: v0.9.4...v0.9.6

v0.9.4

更新方法: 直接覆盖进旧目录

What's Changed

1. TTS 稳定性大幅加固

   • 修复本地 TTS 服务异常退出、残留子进程继续占用显存的问题。
   • 保存 TTS 设置前会检测服务是否可用。
   • 支持接管已存在的本地 GPT-SoVITS / Genie TTS 进程，并在退出时清理。
   • 新增 TTS 服务启动日志，便于排查失败原因。
   • 增加“自定义外部 GPT-SoVITS”选项。

2. 置顶逻辑调整

   • 取消默认窗口置顶。
   • 新增置顶开关，并保存到系统配置。
   • 修复右键菜单触发逻辑，避免按下右键时就弹出菜单。
   • Windows 下增加原生置顶状态同步。

3. 长期记忆体验与可靠性增强

   • 增加长期记忆初始化、重载、失败、就绪状态提示。
   • 首次加载嵌入模型时会提示用户等待。
   • 改进 HuggingFace 本地缓存检测，避免半下载缓存误判。
   • mem0 抽取为空时，新增主模型兜底抽取长期记忆。
   • 关闭 mem0 telemetry。

4. MCP 能力收紧

   • Windows MCP 暂时标记为“待测试，未开放”，设置页禁用该开关。
   • 移除已废弃的 Playwright MCP 配置和本地工具包。

5. 构建与发布调整

   • 移除 macOS 构建 action。
   • Windows runtime artifact 命名从 sakura-runtime-windows-x64.zip 改为 runtime-windows-x64.zip。

6. 文档与项目约束更新

   • 更新 README 教程和架构说明。
   • 新增 AGENTS.md 约束。
   • 更新 star 趋势图表。

7. 测试覆盖补充

   • 增加 TTS 服务接管、检测、保存失败处理相关测试。
   • 增加置顶、右键菜单、长期记忆状态提示和 MCP 禁用相关测试。

New Contributors

• @Rvosy made their first contribution in #1

Full Changelog: v0.9.3...v0.9.4

v0.9.3

Sakurav0.9.3 更新说明

修复之前版本里有一个比较紧急的路由问题：Sakura 有时会判断错你要做什么，导致该聊天的时候跑去走工具，或者该执行任务的时候没有正确执行。v0.9.3 已经把这部分紧急修好了。

重点修复

• 删除了问题最大的路由层,回退代码
• 修复提醒触发后没有正常进入字幕和语音播放的问题。
• 修复记忆整理时可能出错的问题，减少后台异常。
• 优化 MCP / 工具运行稳定性，缺少依赖时会给出更清楚的提示。
• 优化 TTS 整合包下载体验，支持更准确的显卡推荐、显示包体大小、下载后自动清理压缩包。
• 新增字幕速度设置，可以调节逐字显示速度和回复停顿。
• 新增文件运行日志，方便之后排查问题。

Full Changelog: v0.9.2...v0.9.3

v0.9.2

Full Changelog: v0.9.0...v0.9.2

v0.9.0

初次发布, 使用方法见README

临时赶工出来的发行版, 可能会有很多问题, 出现bug记得提issue

双击install.bat安装依赖 然后双击start.bat运行即可
.char角色包 -> 百度网盘链接

---

Full Changelog: https://github.com/Rvosy/sakura/commits/v0.9.0