Kokoro Engine v0.2.4

新功能 / Features

• 本次版本以稳定发布为目标，未引入新的用户可见功能，后端持续优化精简重构。
• This release focuses on stability and does not introduce new user-facing features.
• Backend continuous optimization, simplification, and refactoring.

修复 / Fixes

• 修复 Windows MSI 打包版本号兼容问题：移除了非数字预发布标识，确保可正常打包发布。
• Fixed Windows MSI bundling version compatibility by removing non-numeric pre-release identifier.

安装 / Installation

• 下载对应平台安装包，解压后直接运行。
• Download the package for your platform and run it directly after extraction.

Kokoro Engine v0.2.3-fix

修复

• 修复设置页在特定时序下绘图（ImageGen）标签页显示空白的问题

安装

• 下载对应平台安装包，解压后直接运行。

Fixes

• Fixed an issue where the ImageGen tab in the settings page would display a blank page under certain timing conditions.

Installation

• Download the installation package for your platform, extract it, and run it directly.

Kokoro Engine v0.2.3

修复

• 修复设置面板切换时数据预加载与挂载行为，提升稳定性。
• 规范桥接调用错误处理与聊天错误观测结构。

安装

• 请在 Release Assets 中下载对应平台安装包并安装。

---

Fixes

• Improved settings panel mount/preload behavior for better stability.
• Normalized bridge invoke error handling and structured chat error observability.

Installation

• Download the installer/package for your platform from Release Assets.

Kokoro Engine v0.2.2

新功能 / New Features

• 聊天取消机制（最小闭环）：新增 turn 级取消状态、取消命令与桥接绑定，并在核心 pipeline 中加入取消检查点。
  Added turn-level cancellation state, cancel command/bridge binding, and cancellation checkpoints in the core chat pipeline.
• Hook 生命周期增强：新增 TTS 生命周期 Hook 事件，并强化核心流程的 Hook modify 策略。
  Added TTS lifecycle hook events and tightened hook modify policy for core pipelines.
• MOD 能力声明增强：在 manifest 中加入最小声明式 capabilities 支持。
  Added minimal declarative capabilities support in MOD manifests.
• 后端日志系统升级：引入 tracing subscriber 与全局日志初始化，完成后端关键模块日志迁移并支持级别颜色高亮。
  Introduced tracing subscriber/global logging init, migrated backend logging paths, and added colored level highlighting in Tauri console.
• Tool 权限语义与可观测性增强：新增工具审计模型与 canonical tool identity 持久化/展示能力，统一审批决策链路。
  Added tool audit model and canonical tool identity persistence/visibility, with unified permission decision flow.
• Edge TTS 能力完善：集成并升级 edge-tts-rust（0.1.2 → 0.1.3），改进语音选择与默认语音策略。
  Integrated and upgraded edge-tts-rust (0.1.2 → 0.1.3), improving voice selection and default voice behavior.

修复与稳定性 / Fixes & Stability

• LLM Provider 稳定性修复（本版核心）：
  • 修复缺失 provider 时的 panic 与错误路径不清晰问题
  • 修复配置更新时 provider 重建顺序与原子性问题
  • 修复 enabled-provider 选择不一致问题并跳过禁用 provider
  • 统一 provider map 管理，降低状态漂移风险
    Core LLM provider stabilization: fixed missing-provider panic/error paths, made config/provider rebuild ordering atomic, aligned enabled-provider selection, skipped disabled providers, and unified provider-map management.
• 权限与拒绝语义修复：对 deny kind 映射、直接执行拒绝、pending approval 幂等处理进行修复与一致化。
  Fixed and aligned deny-kind mapping, direct-execute denial handling, and idempotent pending approval resolution.
• 聊天历史与执行器测试修复：修复执行器权限测试辅助逻辑，并补充工具身份覆盖测试。
  Fixed executor permission test helpers and expanded tool identity coverage.
• 跨平台与 UI 修复：修复 macOS 下拉动画异常、补充本地 TTS WAV 回退、统一 show 命令自动拉起 pet window。
  Fixed macOS dropdown animation issue, added WAV fallback for local TTS playback, and unified auto-show for pet window.

重构 / Refactoring

• 统一工具输入 canonical id 边界解析，集中化工具权限决策流程，并将审批流改为由 permission decisions 驱动。
  Unified canonical tool ID resolution boundaries, centralized permission decisions, and refactored approval flow to be decision-driven.

文档与测试 / Docs & Tests

• 完成 UTC 稳定化、Claude essence 最小闭环、取消与 Hook 生命周期相关计划收口文档。
  Closed plan/checklist docs for UTC stabilization, Claude essence minimal closure, and cancellation/hook lifecycle work.
• 新增并完善多项 LLM / permission / tool identity 稳定性测试。
  Added and improved stability tests across LLM, permissions, and tool identity.

距离上一个版本（v0.2.1）的变更范围 / Delta Since v0.2.1

本次 Release 覆盖 v0.2.1..v0.2.2 的全部提交，重点是：

• LLM Provider 可靠性收敛
• Tool 权限语义统一与可审计性增强
• 聊天取消与 Hook 生命周期最小闭环
• 后端 tracing 日志体系落地

This release includes all commits in v0.2.1..v0.2.2, focused on:

• LLM provider reliability hardening
• Unified tool permission semantics and better observability
• Minimal closure for chat cancellation and hook lifecycle
• Backend tracing/logging rollout

致谢 / Acknowledgements

感谢社区贡献者的大力支持！Thanks to our community contributors!

• @aegbirou

安装 / Installation

下载对应平台安装包，解压后直接运行。
Download the installer for your platform and run it directly.

Kokoro Engine v0.2.1

新功能 / New Features

• 会话摘要与共享工具执行管线：新增会话摘要能力，并打通共享 action/tool 执行基础设施。
  Added conversation summaries and shared action/tool execution plumbing.
• 集中式 Hook Runtime：统一接入 chat、tools/actions、mods 生命周期 hook。
  Introduced centralized hook runtime across chat, tools/actions, and mod lifecycle.
• 审批语义与分阶段动作策略：新增 staged action policy、语义化审批 trace 展示与 chat 内交互式 pending approval。
  Added staged action policy, semantic approval trace rendering, and interactive pending approval in chat.
• 文案本地化改进：本地化 MCP 与 chat tool trace 相关展示文案。
  Localized MCP and chat tool trace copy.

重构 / Refactoring

• AI 情感链路精简：移除 emotion classification 系统，简化 AI 处理路径。
  Removed the emotion classification subsystem to simplify AI processing flow.

修复 / Bug Fixes

• 审批与拒绝语义修复：修复 deny 语义重叠问题，补全 pending approval 默认状态。
  Fixed overlapping deny semantics and added default state handling for pending approvals.
• Hook 安全策略修复：强化 hook deny 的 fail-closed 执行行为。
  Enforced fail-closed behavior when hooks deny actions.
• AI 记忆与上下文质量修复：
  • 替换 fake summary 为真实 LLM summarization
  • 改进 RAG 相关性与矛盾检测
  • 修复代码评审指出的 mutex 生命周期与上下文保留问题
    Improved AI memory/context quality by replacing fake summaries with real LLM summarization, improving RAG relevance and contradiction detection, and fixing mutex lifetime / context preservation issues.
• 构建与数据迁移修复：修复 Windows 测试构建链接器问题；修复 IndexedDB 迁移到 SQLite 后残留记录清理。
  Fixed Windows test build linker usage and cleaned up stale IndexedDB records after SQLite migration.

安装 / Installation

下载对应平台安装包，解压后直接运行。
Download the installer for your platform and run it directly.

---

Kokoro Engine v0.2.0

新功能 / New Features

• ONNX Runtime 自动下载：构建时自动下载跨平台 ONNX Runtime，无需手动配置
  Auto-download ONNX Runtime during build for cross-platform support
• 设置 Tab 持久化：记住上次打开的设置页，重启后自动恢复
  Persist active settings tab selection across sessions
• 自定义 Select 组件：ModelTab 中的下拉选择器替换为统一的自定义组件，交互更一致
  Replace native selects with custom Select component in ModelTab for consistent UX

重构 / Refactoring

• Native Tool Calling：重构聊天管线，采用 async-openai 原生 tool calling 类型，支持多轮工具调用
  Rebuilt chat pipeline around native tool calling with async-openai types
• Live2D Cue 系统重建：统一内置 cue profile，改进动作播放和口型同步架构
  Rebuilt Live2D playback around unified cue profiles with improved animation architecture
• 统一错误处理：引入 KokoroError 跨所有服务层统一错误类型
  Unified error handling with KokoroError across all service layers
• 情感系统优化：情感更新改为模型驱动，支持可选启用
  Made emotion updates model-driven and optional

修复 / Bug Fixes

• 修复聊天历史重建在工具调用轮次中的错误 / Fix chat history reconstruction for tool-assisted turns
• 修复 continue-from 和消息删除的竞态条件 / Fix race condition in continue-from and message deletion
• 修复 LLM 返回空文本时的无限工具调用循环 / Prevent infinite tool call loop when LLM returns empty text
• 修复工具重试时禁用工具以打破死循环 / Disable tools on retry to break tool-only loop
• 修复翻译标签语言异常导致 LLM 用响应语言翻译的问题 / Fix translation tag language exception
• 修复 Live2D hit 区域映射和聊天轮次渲染 / Improve Live2D hit mapping and chat turn rendering
• 修复 Windows 右键拖拽窗口 / Restore right-click window dragging on Windows
• 修复内存面板滚动和重复角色条目 / Fix MemoryPanel scrolling and duplicate character entries
• 修复 pet 模型选择同步和工具 fallback 模式 / Fix pet model selection sync and tool fallback mode
• 其他多项稳定性修复 / Various stability improvements

致谢 / Acknowledgements

感谢社区贡献者的大力支持！Thanks to our community contributors!

• @Initsnow

安装 / Installation

下载对应平台安装包，解压后直接运行。
Download the installer for your platform and run it directly.

---

Kokoro Engine v0.1.9

🎉 New Features / 新功能

• Automated PR Code Review: Added Claude-powered automated code review for pull requests

• 自动化 PR 代码审查: 集成 Claude 驱动的自动代码审查功能

• SQLx Migration System: Replaced hardcoded schema with proper database migration system

• SQLx 迁移系统: 用数据库迁移系统替代硬编码的 schema

• Comprehensive Backend Tests: Added 39 new backend tests for improved reliability

• 完整的后端测试套件: 新增 39 个后端测试，提升可靠性

🔧 Improvements / 改进

• Complete KokoroError Migration: Migrated all 80+ commands from Result<T, String> to Result<T, KokoroError> for better error handling

• 完整的 KokoroError 迁移: 将所有 80+ 个命令从 Result<T, String> 迁移到 Result<T, KokoroError>，改进错误处理

• Live2D Performance Optimization: Reduced CPU usage, throttled pet dragging, and unified render FPS settings

• Live2D 性能优化: 降低 CPU 占用，优化宠物拖拽响应，统一渲染帧率设置

• Error Handling Refactor: Reorganized command registration and standardized error handling across modules

• 错误处理重构: 重组命令注册，标准化模块间的错误处理

• Dependency Updates: Updated package-lock.json and Cargo.lock to latest compatible versions

• 依赖更新: 更新 package-lock.json 和 Cargo.lock 到最新兼容版本

致谢 / Credits

感谢 @Initsnow 贡献的新功能！
Special thanks to @Initsnow for contributing the new features!

🐛 Bug Fixes / 修复

• Fixed Live2D state preservation when updating FPS

• 修复更新 FPS 时 Live2D 状态丢失的问题

• Fixed missing permissions and GitHub token for PR comment posting

• 修复 PR 评论发布的权限和 GitHub token 问题

• Removed emoji from locale strings for better compatibility

• 移除本地化字符串中的 emoji，提升兼容性

📝 Documentation / 文档

• Synced Nix/Flakes section across all READMEs

• 同步所有 README 中的 Nix/Flakes 部分

• Translated nix.md to English

• 将 nix.md 翻译为英文

🔗 Installation / 安装

Download the installer for your platform:

• Windows: Kokoro Engine_0.1.9_x64-setup.exe
• macOS: Kokoro Engine_0.1.9_aarch64.dmg
• Linux: Kokoro Engine_0.1.9_x64.AppImage or .deb

从下方下载对应平台的安装包：

• Windows: Kokoro Engine_0.1.9_x64-setup.exe
• macOS: Kokoro Engine_0.1.9_aarch64.dmg
• Linux: Kokoro Engine_0.1.9_x64.AppImage 或 .deb

---

Kokoro Engine v0.1.8

新功能

• Live2D 本地内置默认 Haru 模型，无需在线加载

修复

• 修复 MOD 协议 (mod://) 在跨平台的路径解析问题
• 修复 macOS WKWebView 上 mod:// 协议的路径解析
• 修复 macOS 沙箱环境下运行时应用数据目录的解析

安装

Download the installer for your platform, extract it if needed, and run directly.

对应平台:

• Windows: NSIS 安装程序 (.exe)
• macOS: DMG 镜像 (.dmg)
• Linux: AppImage (.AppImage) 和 DEB 包 (.deb)

Kokoro Engine v0.1.7

修复 / Fixes

• 悬浮窗口跨平台缩放修复：统一使用原生 startResizeDragging() 实现窗口边缘拖拽缩放，修复了 Windows 上无法调整窗口大小的问题
• 悬浮窗口尺寸与模型缩放持久化：重启后正确恢复上次保存的窗口大小和 Live2D 模型缩放比例
• 自定义 OpenAI TTS 语音与流式播放恢复：修复了自定义语音名称和流式音频播放失效的问题
• OpenAI 转录自定义 Base URL 支持：语音转录现在正确使用用户配置的自定义 API 地址

---

• Pet window cross-platform resize fix: Unified native startResizeDragging() for edge-drag resizing; fixes inability to resize the window on Windows
• Pet window size & model scale persistence: Window size and Live2D model scale are now correctly restored after restart
• Custom OpenAI TTS voices & stream playback restored: Fixes broken custom voice names and streaming audio playback
• OpenAI transcription custom base URL support: Voice transcription now correctly uses user-configured custom API base URLs

其他 / Other

• README 中新增官方 Telegram 社区群链接 / Added official Telegram community group link to README files

已知问题 / Known Issues

• 覆盖安装旧版本时对话记录与记忆数据丢失：从旧版本升级时，若直接覆盖安装，可能导致聊天历史和记忆数据丢失。建议升级前手动备份 ~/.local/share/com.chyin.kokoro/（Linux/macOS）或 %APPDATA%\com.chyin.kokoro\（Windows）目录
• Conversation and memory data loss on upgrade: Upgrading by overwriting an older installation may cause chat history and memory data to be lost. It is recommended to manually back up ~/.local/share/com.chyin.kokoro/ (Linux/macOS) or %APPDATA%\com.chyin.kokoro\ (Windows) before upgrading

致谢 / Credits

感谢 @Initsnow 贡献的新功能！
Special thanks to @Initsnow for contributing the new features!

安装 / Installation

下载对应平台安装包，解压后直接运行。
Download the installer for your platform and run it directly.

Kokoro Engine v0.1.6

修复 / Fixes

• 悬浮窗口 Live2D 模型居中修复：修复了模型上方存在大量空白、下半身被裁切的问题，现在模型在窗口内正确居中显示
• 悬浮窗口位置与尺寸恢复：重新显示悬浮窗口时，正确还原上次保存的位置和窗口大小

---

• Pet window Live2D centering fix: Fixed excessive blank space above the model and feet being cut off; model now centers correctly within the window
• Pet window position & size restore: Window position and size are now correctly restored when re-showing the pet window

已知问题 / Known Issues

• 覆盖安装旧版本时对话记录与记忆数据丢失：从旧版本升级时，若直接覆盖安装，可能导致聊天历史和记忆数据丢失。建议升级前手动备份 ~/.local/share/com.chyin.kokoro/（Linux/macOS）或 %APPDATA%\com.chyin.kokoro\（Windows）目录
• Conversation and memory data loss on upgrade: Upgrading by overwriting an older installation may cause chat history and memory data to be lost. It is recommended to manually back up ~/.local/share/com.chyin.kokoro/ (Linux/macOS) or %APPDATA%\com.chyin.kokoro\ (Windows) before upgrading

安装 / Installation

下载对应平台安装包，解压后直接运行。
Download the installer for your platform and run it directly.