feat(v1.2.5): 优化首页滚动顺滑性、恢复整屏吸附并提升 Halo 要求至 2.27

- 首页固定模糊半径只改 opacity；Hero 离屏停绘；Navbar 滚动状态去重
- 恢复首屏整屏吸附：仅接管 0 ↔ 内容区顶部边界，scrollend + 600ms 兜底解锁
- CSS scroll-snap proximity 实际不吸附（缺页面顶部吸附点），已移除避免与 scrollTo 冲突
- 版本 1.2.5，requires >=2.27.0；源码仓库与问题反馈改为 git.nxxy335.top
- 更新 README / FAQ / 开发指南 / 更新日志，补充性能与发版说明

README.md

@@ -6,7 +6,7 @@
 
 ## 环境要求
 
-- Halo **2.26.0 及以上**（页面布局契约、微信读书页面均依赖 2.26 的新能力）
+- Halo **2.27.0 及以上**（页面布局契约、微信读书页面均依赖 2.27 的新能力）
 - v1.2.0 起内置主题配色系统（纯 CSS 变量实现）；更低版本的 Halo 请使用主题 v1.1.x
 
 ## 特点
@@ -15,7 +15,7 @@
 2. **插件兼容性** — 适配 11 款常用 Halo 插件，安装即用；提供页面布局契约，插件前台页面自动复用主题外观
 3. **内置灯箱** — 主题内置 LightGallery 灯箱，支持 EXIF 信息展示；安装 lightgallery.js 插件后自动禁用
 4. **可配置性** — 17 个设置分组、122 个配置项，几乎所有模块可独立开关
-5. **性能优化** — 服务端字数统计（API 扩展包）、图片懒加载与响应式缩略图、滚动吸附、CSS/HTML 压缩
+5. **性能优化** — 服务端字数统计（API 扩展包）、图片懒加载与响应式缩略图、首屏整屏吸附（仅首屏边界接管，内容区保留原生滚动）、Hero 离屏停绘、CSS/HTML 压缩；详见[开发指南 - 性能与滚动顺滑](docs/customize/development.md)
 6. **页面布局契约** — 提供 `templates/layout.html`，插件页面不再回退到 Halo 内置布局
 
 ## 预览
@@ -56,7 +56,7 @@
 
 - Hero 首屏：明暗双背景图、大标题/副标题独立配色、一言（支持自动刷新与淡入淡出过渡）、下滑箭头平滑滚动
 - 欢迎弹窗：基于访客 IP 地理定位的欢迎提示，支持 5 种位置、自定义 API 与会话去重开关
-- 滚动吸附：首屏与内容区之间滚轮/触摸自动吸附
+- 滚动吸附：首屏与内容区之间滚轮/触摸自动吸附，进入内容区后恢复原生自由滚动
 - 文章卡片：可配置显示字数（依赖 API 扩展包）、阅读量、分类、标签、摘要行数
 
 ### 文章
@@ -177,7 +177,7 @@ pnpm smoke
 
 ## 技术栈
 
-- [Halo](https://halo.run) 2.26+
+- [Halo](https://halo.run) 2.27+
 - [Astro](https://astro.build) 6（构建输出 Thymeleaf 模板）
 - [Thymeleaf](https://www.thymeleaf.org) 模板引擎
 - [Sass](https://sass-lang.com/) 样式