Folo Desktop v0.2.1 更新解析：图片预览缩放、未读优先阅读与 Action 入口条件的源码实现

本文围绕 Folo 桌面端 v0.2.1 版本的发布说明（changelog）展开，逐条拆解该版本的五项新功能、一项交互改进与一个缺陷修复：包括媒体预览中的图片缩放、"Show Unread Only"（仅显示未读）默认选项、登录重定向页合并、Action 规则的入口条件，以及 Discover 页新增的 all 语言过滤。读完本文，你可以了解每个功能点在 renderer 渲染层源码 中的落点、相关配置项的定义与消费链路，从而把一份简短的版本记录转化为可追溯的实现事实。

一、v0.2.1 更新总览

0.2.1 的发布说明 内容如下，后文逐项结合当前仓库源码加以印证与扩充：

分类	内容
New Features	图片查看支持缩放（zoom）
New Features	将 "Show Unread Only" 设为默认选项
New Features	合并重定向页与登录页
New Features	为 Action 引入入口条件（entry conditions）
New Features	Discover 页语言过滤新增 all 选项
Improvements	增强多选与拖拽逻辑
Bug Fixes	修复 Instagram 图片加载问题

需要说明的前提：changelog 记录的是 v0.2.1 时点的行为，而仓库中是当前主干代码。因此下文对每个条目都会区分"该版本的更新点"与"当前源码中的实现现状"，对于当前实现已经演进的部分（例如默认值被调整），会明确指出。

二、图片查看支持缩放：基于 react-zoom-pan-pinch 的媒体预览

v0.2.1 的 "Added zoom functionality for viewing pictures" 指的是在条目（entry）内点开图片预览后可以缩放查看，典型场景是社媒类 feed（Instagram、微博等）中的图片详情查看。

当前实现落在媒体预览组件中：

• PreviewMediaContent.tsx 从 react-zoom-pan-pinch 引入 TransformComponent、TransformWrapper，并声明了 ReactZoomPanPinchRef、ReactZoomPanPinchState 类型，用于在预览弹层内对图片做缩放与平移；
• 触发入口在条目媒体画廊组件 media-gallery.tsx：每张缩略图通过 usePreviewMedia() 提供的 previewMedia(mediaList, index) 打开预览，传入整组媒体（含 url、type、blurhash 与回退地址），并对 cursor-zoom-in 样式做了提示，即"点击缩略图 → 打开可缩放预览"的交互闭环。

同一组件中的布局逻辑也值得一看：media-gallery.tsx 先用 isAllMediaSameRatio 判断整组图片比例是否一致——一致时采用横向滚动布局（1 张图占满容器、2 张各占一半、3 张以上各占 1/3 宽），比例不一致时退化为网格布局（2~4 张两列、5 张以上三列）。预览层再负责放大查看原图细节，两层配合完成"列表浏览 + 缩放查看"的图片阅读体验。

三、"Show Unread Only"：从"默认选项"看设置项与过滤链路

"Set Show Unread Only as the default option" 指的是时间线（timeline）视图的未读过滤开关。这一设置项在当前仓库中的链路相当完整，可以作为 Folo 设置体系的典型样本：

1. 定义与默认值。unreadOnly 是通用设置（GeneralSettings）的一个布尔键，接口定义见 interface.ts，默认值定义在 defaults.ts。注意当前主干中默认值为 false——也就是说，0.2.1 引入的"作为默认选项"更多是指该选项成为时间线的一等公民（有默认行为、有独立开关），而当前版本用户可在设置中自行选择默认状态，不应据此反推 0.2.1 的默认值现状；
2. 消费端。设置页与命令面板都暴露该开关：命令 ID 表中将 unreadOnly 映射为 timeline:unread-only（见 id.ts，执行逻辑在 timeline.tsx）。条目数据侧则在 useEntriesByView.ts 中把 unreadOnly: true 作为查询参数拼入条目请求（仅当开关开启且非预览态），并在本地过滤工具 filter-local-entry-ids.ts 及其测试 filter-local-entry-ids.test.ts 中对本地条目做同样的未读裁剪；
3. 联动行为。general.ts 提供了 useHideAllReadSubscriptions()：当 hideAllReadSubscriptions 与 unreadOnly 同时为真时，订阅列表中"全部已读"的订阅会被隐藏。这说明"仅未读"不仅是时间线过滤，还与订阅栏呈现形成联动语义。

从这条链路可以看出，0.2.1 让 "Show Unread Only" 成为默认阅读模式后，围绕它的过滤逻辑已经扩展到查询参数、本地条目过滤、订阅栏隐藏三个层面，这也是后续版本迭代（如 filter-local-entry-ids.test.ts 覆盖的多种未读组合）的基础。

四、重定向页与登录页合并

"Merged the redirect page with the login page" 属于账号鉴权流程的简化：早期 OAuth 类登录会先落到一个中间重定向页，再跳转到登录表单；0.2.1 将两步合一，减少一次页面切换。当前仓库中的登录表单实现位于 auth 模块，例如其中处理了 twoFactorRedirect 的双因子跳转分支（Form.tsx 附近）。从源码结构看，登录与回跳处理目前收敛在同一个 auth 模块内，与"页面合并"的演进方向一致；由于该合并发生在较早期版本，当前代码中已看不到旧的重定向页残留，这里只作方向性说明，不再展开具体页面文件。

五、Action 入口条件：When 段的 all / filter 双模式

"Introduced entry conditions for actions" 是 0.2.1 中技术含量最高的一条：自动化动作（Action）可以按"哪些 feed 命中"来决定是否执行，而不再对所有条目无差别触发。

当前实现的核心是规则编辑器的 When 段组件 when-section.tsx：

• 头部以 "When feeds match" 标识触发条件区，并提供 all / filter（custom filters）两种模式的分段选择器（SegmentGroup）：all 表示规则对所有 feed 生效，filter 表示需要命中自定义条件（见 when-section.tsx）；
• 条件数据以二维数组表达，即一组"条件组"，每条条件包含 field（字段，取自 filterFieldOptions）、operator（操作符）、value 三个部分，通过 actionActions.pathCondition 以 {ruleIndex, groupIndex, conditionIdx} 精确定位更新（见 when-section.tsx）；
• 同一条件组内的多条条件以 AND 连接（组件在条件项之间渲染 AND 徽标，见 when-section.tsx），条件组之间则是 OR 关系——后者是紧随其后的 v0.2.2 引入的 "And Or conditions for actions"，印证了 0.2.1 先落地"入口条件"、0.2.2 再补齐逻辑组合的迭代节奏。

也就是说，0.2.1 的 "entry conditions" 确立了 Action 规则的触发条件框架：先声明"哪些 feed 命中（When）"，再声明命中后"执行什么（Then）"，字段/操作符选项集中在 action store 的 constant 中维护，条件结构类型则来自客户端 SDK 的 ActionFeedField、ActionOperation（见 when-section.tsx 的导入）。

六、Discover 页语言过滤新增 all 选项

"Added all language filter in discover page"（原文如此，discover 拼写笔误）让"发现"页的推荐/浏览结果可以不再受单一语言约束。当前源码中该过滤位于 Discover 内容组件：

• 语言类型定义为 type Language = "all" | "eng" | "cmn" | "fra"（DiscoveryContent.tsx），"all" 即任意语言；
• 可选值常量 LanguageOptions 定义在同文件顶部（DiscoveryContent.tsx），UI 上以 "Language:" 标签 + 下拉项呈现；
• 选中值持久化为 UI 设置键 discoverLanguage，通过 useUISettingKey("discoverLanguage") 读取、setUISetting("discoverLanguage", value) 写回（DiscoveryContent.tsx），即该偏好会跨会话保留。

这一条体现了 Folo Discover 功能的定位：它不只是按 RSS 地址订阅，而是提供带语言维度（英文、中文、法文及不限语言）的内容发现入口，语言偏好是 Discover 模块内独立持久化的一项 UI 设置。

七、多选拖拽改进与 Instagram 图片修复

版本说明中的另外两条改动相对轻量，但在源码中也能找到对应脉络：

• 多选与拖拽逻辑增强（Improvements）：条目列表的批量选择与拖拽（拖拽重排/移动到订阅）是时间线高频交互，相关逻辑集中在 entry-column 模块 及其 hooks 中。该条目描述的是行为打磨而非新增功能，当前仓库未保留 0.2.1 时点的 diff，故此处仅指出模块位置供进一步追溯；
• Instagram 图片加载修复（Bug Fixes）：Instagram 等社媒源的图片 URL 常带访问限制，Folo 的图片加载普遍走代理策略——Media.tsx 会按优先级构造 proxy / origin 双源列表，代理源（useGetImageProxyUrl）失败时回退原图，缩略图与预览还会携带 preview_image_url 与 blurhash 兜底。Instagram 图片问题的修复正是建立在这套"代理优先、多级回退"的加载机制之上，属于对既有兜底链路的补强。

八、小结：如何从 changelog 追溯 v0.2.1 的落地

0.2.1 changelog 虽然只有十余行，但每一条都有可验证的源码落点：

更新点	当前源码中的对应位置
图片缩放	PreviewMediaContent.tsx（react-zoom-pan-pinch）
仅未读默认选项	defaults.ts、general.ts、useEntriesByView.ts
登录页合并	auth 模块
Action 入口条件	when-section.tsx
Discover 语言 all	DiscoveryContent.tsx
Instagram 图片修复	Media.tsx 的多源回退加载

需要再次强调的是时间维度：以上源码是当前主干的实现，0.2.1 时的具体代码形态可能已有变化（如 unreadOnly 默认值、When 段的 AND/OR 组合分别属于后续演进）。阅读这份 changelog 时，建议把它视为"功能首次出现的索引"，再结合对应模块源码理解其后续形态，这样得到的信息才既准确又可复核。