FreshRSS

FreshRSS v2.18 版本发行说明

版本号：2.18
版本代码：2026090513
发布日期：2026-09-05
包名：com.freshrss.reader

一、新增功能

1. 数据维护 - 分级清理新增"清理以上所有"
分级清理子界面底部新增一键清理按钮，可一次性执行全部六项清理：
清理文章缓存、清理媒体缓存、清理阅读历史、清理搜索历史、
清理同步历史、清理稳定性日志。

2. 同步诊断 - 日志导出为 TXT 文件
同步诊断页"最近稳定性日志"支持导出为 .txt 文本文件，
通过系统分享保存到文件管理器或发送，方便排查问题。

二、优化改进

1. 订阅源缓存并行化
原缓存逻辑为串行处理（A源图片慢会阻塞B、C源），
改为三阶段并行方案：
- Promise.all 并行拉取所有订阅源文章列表
- 收集文章去重后统一限流下载图片
- 统一执行媒体缓存容量限制
多订阅源缓存时不再被慢源阻塞，整体缓存速度显著提升。

三、Bug 修复

1. 修复跟随系统深色模式时状态栏不即时刷新
主题设置为"跟随系统"时，手机切换深色/浅色模式后，
APP顶部状态栏不会同步刷新。新增 EntryAbility 系统配置监听，
切换后即时更新状态栏颜色。

2. 修复跟随系统深色+护眼模式时状态栏颜色错误
手机深色模式 + APP跟随系统 + 开启护眼模式时，
顶部状态栏仍为深色而非护眼米白色。
调整颜色优先级为：纯黑 > 护眼 > 深色 > 浅色，
护眼模式在浅色和深色主题下均生效。

3. 修复护眼模式下缓存设置输入框文字看不清
保留已读文章、文章缓存容量、媒体缓存容量三个输入框
显式设置文字颜色和占位符颜色，适配护眼/深色模式。

4. 修复护眼模式下添加订阅源和搜索界面文字看不清
添加订阅源弹窗的输入框、全局搜索页的搜索结果标题和
最近搜索项均显式设置文字颜色，适配护眼/深色模式。

5. 修复正文界面顶部状态栏护眼模式不同步
正文界面独立实现的状态栏颜色逻辑未处理跟随系统场景，
改为统一调用 AppSettingsStore.refreshSystemBarColor，
与首页、文章列表保持一致。

完善护眼模式。

# FreshRSS Reader v2.15

> 发布日期：2026-09-04
> 版本号：2.15 (versionCode: 2026090410)
> bundleName：com.freshrss.reader

---

## 亮点

- 首页 / 文章列表 / 正文三大界面按钮行全面重构，操作更直观
- 所有设置页面返回按钮统一为 undo 图标
- 长按设置按钮直达对应设置子界面，调整完成自动返回
- 设置修改后返回即时生效，无需重新进入页面
- AppSettingsStore 新增内存缓存，彻底解决跨页面设置读写竞态

---

## 新功能

### 首页按钮行重构
- 顶部新增 9 按钮操作行（图标 + 文字）：添加、刷新、搜索、全部、未读、最近、收藏、展开、折叠
- 展开 / 折叠拆分为两个独立按钮，均为临时操作（记忆文件夹状态时不持久化）
- 设置按钮改为齿轮图标：短按进入设置主界面，长按弹出首页设置子界面
- 首页手势返回不退出应用（onBackPress 返回 true）

### 文章列表按钮行重构
- 文章列表上方新增 6 按钮操作行：刷新、全部、未读、滚动已读、已加载已读、全源已读
- 全部 / 未读 / 滚动已读按钮支持选中高亮状态
- 原右上角菜单按钮改为齿轮图标：短按进入设置，长按弹出文章列表设置子界面
- 刷新按钮从顶部标题栏移入按钮行

### 正文界面工具栏重构
- 原菜单按钮改为齿轮图标：短按进入设置，长按弹出阅读界面设置子界面
- 新增分享按钮：调用系统分享面板
- 新增复制按钮：一键复制文章标题 + 原文链接到剪贴板
- 顶部工具栏顺序：返回、阅读状态、已读 / 未读、收藏、分享、复制、设置

### 长按设置快速模式
- 从首页 / 文章列表 / 正文长按齿轮按钮进入显示和外观时，自动打开对应设置子界面
- 首页 → 首页设置（sheet=home）
- 文章列表 → 文章列表设置（sheet=list）
- 正文 → 阅读界面设置（sheet=reader）
- 子界面调整完成关闭后，保存设置并自动返回原页面，无需先返回到显示和外观主界面

### 统一返回按钮
- 所有设置页面和含返回按钮的页面，返回按钮从 Text('‹') 统一替换为 SymbolGlyph(sys.symbol.undo) 图标按钮
- 涉及 14 个文件、15 个返回按钮，透明背景无圆圈

---

## 改进

### 设置界面体验
- 显示和外观：首页设置 / 文章列表 / 阅读页面改为弹出式子界面，Slider 带 +/− 按钮实时调整
- 缓存设置：保留已读文章、文章缓存容量、媒体缓存容量改为自定义数值输入框
- 数据维护：分级清理改为弹出式子界面（文章缓存、媒体缓存、阅读历史、搜索历史、同步历史、稳定性日志）
- 所有设置页面顶部对齐、左右边距统一
- 同步诊断界面同步历史模块字号和边距统一

### 设置返回即时刷新
- 文章列表 onPageShow 新增 reloadUISettings()，重新加载所有 UI 相关设置
- 正文界面新增 onPageShow()，调用 loadReaderSettings() 重新加载阅读设置
- 从设置子界面返回后字体、间距等设置即时生效

### AppSettingsStore 内存缓存
- 新增静态变量 cachedSettings，load() 优先返回缓存，save() 同步更新缓存
- 从根本上解决跨页面设置读写竞态条件（SettingsAppearance 异步保存时，目标页面已先读取旧值的问题）

### 文章列表按钮图标
- 滚动已读：doc_text_badge_arrow_up
- 已加载已读：doc_text
- 全源已读：doc_text_badge_checkmark

---

## 修复

- 修复从设置页面返回后文章列表 / 正文界面设置不立即刷新的问题（需重新进入才生效）
- 修复 AppSettingsStore 无内存缓存导致的跨页面设置读写竞态
- 修复首页文件夹展开 / 折叠切换按钮状态不准确的问题（拆分为独立按钮）
- 修复设置子界面 Slider 拖动时右侧数值不实时更新的问题
- 修复设置子界面 +/− 按钮只能生效一次的问题
- 修复缓存设置自定义数值保存不生效的问题（删除多处白名单验证）
- 修复同步诊断界面同步历史模块边距和字号不一致的问题