diff --git a/README.md b/README.md
index 82650cb..4d723b2 100644
--- a/README.md
+++ b/README.md
@@ -215,6 +215,14 @@ shortx.getShortXDir() + "/ToolHub/logs/init.log"
 > 规则：按天归档，同一天多次提交合并为一条。
 
 ### 2026-04-20
+
+**Bug 修复**
+- **修复 ShortX 图标调色板确认后未应用颜色**：颜色弹窗确认回调未同步触发 ShortX 图标预览链路，新增统一入口 `applyTintSelectionFromPopup()` 规范化处理
+- **修复颜色弹窗确认时 `recentGrid` 引用异常**：`showColorPickerPopup()` 中最近颜色网格重建后未更新局部引用，改为延迟初始化并缓存 `recentGrid` 引用
+- **改为独立维护 ShortX 图标颜色状态**：图标颜色与悬浮球颜色分离存储，避免互相覆盖
+- **强制应用弹窗选中的图标颜色**：确保弹窗选色结果立即写入按钮编辑状态并刷新预览
+
+**功能改进**
 - **图标库与调色板** 默认收起，打开编辑面板时不再自动展开
 - **常用颜色** 改为自适应布局，根据当前可用宽度自动计算列数（与 ShortX 图标列表一致）
 - **ShortX 图标浮窗选择器** 改为分页模式，按当前可见容量动态计算每页图标数量
@@ -224,3 +232,7 @@ shortx.getShortXDir() + "/ToolHub/logs/init.log"
 - **设置面板改造**：取消“执行与查看器”、“悬浮球文字/大小/颜色”设置项
 - **悬浮球图标配置** 支持 ShortX 图标选择器（弹窗列表+搜索）和调色板拖拽选色
 - **弹出式颜色选择器**：新增独立弹窗，支持最近使用颜色（8 个）、RGB 实时调色、常用色网格、透明度滑块，最近颜色持久化存储
+
+**代码清理**
+- **统一图标弹窗**：按钮编辑与悬浮球设置复用同一套 `showShortXIconPickerPopup` 和 `showColorPickerPopup`
+- **清理悬浮球文字相关死代码**：删除悬浮球文字开关、文字大小、文字颜色等 UI 渲染与持久化残留