From c091a1805359f89170d234de79aa134906784108 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E5=88=B6=E6=9D=96?= <ygsgdbd@hotmail.com>
Date: Wed, 2 Sep 2026 11:41:51 +0800
Subject: [PATCH] docs(release): add v0.10.0 release notes

---
 CHANGELOG.md | 10 +++++++++-
 1 file changed, 9 insertions(+), 1 deletion(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 2bb1ed1..eb4190d 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,9 +1,13 @@
 # Changelog
 
-## Unreleased
+## v0.10.0
 
 ### 🇨🇳 中文
 
+#### 升级提示
+
+- 从 v0.9.0 及以上版本直接升级会保留现有配置。更早版本请先安装并运行 v0.9.0 完成迁移，再升级到 v0.10.0；否则旧 App 规则可能无法恢复。
+
 #### 功能
 
 - 新增输入法健康诊断：输入法列表为空、读取失败或自动切换失败时，菜单会显示具体状态，并提供重新加载输入法、重试当前 App 和打开键盘设置等恢复操作。
@@ -23,6 +27,10 @@
 
 ### 🇺🇸 English
 
+#### Upgrade Notice
+
+- Direct upgrades from v0.9.0 or later preserve existing configuration. For earlier versions, install and run v0.9.0 first to complete migration before upgrading to v0.10.0; otherwise, legacy app rules may not be restored.
+
 #### Features
 
 - Added input method health diagnostics. When the input method catalog is empty, fails to load, or an automatic switch fails, the menu now explains the state and offers recovery actions to reload input methods, retry the current app, or open Keyboard Settings.