From 2643bf9cdfef0308079b77953c818a0e5578a2c5 Mon Sep 17 00:00:00 2001
From: 7015725 <user@example.com>
Date: Tue, 19 May 2026 05:24:23 +0800
Subject: [PATCH] docs: update ToolHub README

---
 README.md | 31 ++++++++++++++++++++++++++++++-
 1 file changed, 30 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 9eebd42..595f4ae 100644
--- a/README.md
+++ b/README.md
@@ -9,6 +9,12 @@ ShortX ToolHub 是一个面向 **ShortX / Rhino ES5 JS** 的模块化悬浮工
 https://git.xin-blog.com/linshenjianlu/ShortX_ToolHub
 ```
 
+GitHub 镜像地址：
+
+```text
+https://github.com/7015725/Toolhub-FloatBall
+```
+
 ---
 
 ## 核心特性
@@ -18,11 +24,12 @@ https://git.xin-blog.com/linshenjianlu/ShortX_ToolHub
 - **SHA256 文件校验**：每个子模块按清单中的 `sha256` 和 `size` 校验，通过后才覆盖本地文件。
 - **防回滚**：入口内置 `MIN_TRUSTED_MANIFEST_VERSION`，并记录本地已信任清单版本，拒绝旧版本清单。
 - **本地可信回退**：网络或远端清单异常时，不盲目覆盖；已验证过的本地模块可继续使用。
+- **更新源切换**：入口支持在 Gitea 主源与 GitHub 镜像之间切换，下载流程仍统一走签名清单与 SHA256 校验。
 - **App 化设置页**：设置主页、按钮管理、按钮编辑等页面使用统一 Shell 与页面栈，支持顶部返回/关闭。
 - **系统返回适配**：支持导航键返回；悬浮窗内置左右边缘交互式滑动返回，拖动时实时露出上级页面，松手后完成返回。
 - **ShortX 图标选择器**：支持图标点选、搜索、分页、自适应列数，不再依赖手填图标名。
 - **颜色选择器**：使用折叠式完整调色板，支持常用色、最近色、RGB、透明度和实时预览；避免重复内联色板。
-- **自适应布局**：ToolApp 根据屏幕尺寸调整宽高，按钮管理页底部操作区保持可见。
+- **自适应布局**：ToolApp 根据屏幕尺寸调整宽高，按钮管理页底部操作区保持可见；悬浮球在横竖屏切换后会重新计算屏幕尺寸并保持吸边位置。
 - **日志记录**：启动、更新、验签、加载异常写入 `ToolHub/logs/init.log`。
 
 ---
@@ -154,6 +161,13 @@ ShortX_ToolHub/
 9. 校验通过才覆盖本地模块。
 10. 所有模块加载正常后，保存本地可信清单版本。
 
+入口顶部可通过 `UPDATE_SOURCE` 选择更新源：
+
+- `0`：Gitea 主源
+- `1`：GitHub 镜像
+
+无论选择哪个源，`manifest.json` / `manifest.sig` 验签、防回滚和子模块 SHA256 校验流程都保持一致。
+
 当前 keyId：
 
 ```text
@@ -271,6 +285,21 @@ ToolHub.js.sha256
 
 ## 更新记录
 
+### 2026-05-19
+
+**功能改进**
+
+- README 补充 GitHub 镜像地址与更新源切换说明。
+- ToolHub 入口支持通过 `UPDATE_SOURCE` 在 Gitea 主源与 GitHub 镜像之间切换。
+- 主面板动物岛主题继续优化为更轻量的融合色视觉，避免高频主面板出现过重图标气泡。
+
+**稳定性修复**
+
+- 改进悬浮球横竖屏切换后的屏幕尺寸刷新与吸边重排，减少横屏时位置跑到屏幕中间的问题。
+- 修复长按打开设置后手指轻微移动导致设置页被普通拖拽逻辑关闭的问题。
+- 修复设置 schema 持久化导致旧用户看不到最新滑块范围或文案的问题。
+- 优化 ToolApp 页面内返回边界宽度设置，变更后可即时作用于当前页面。
+
 ### 2026-05-13
 
 **功能改进**