netnewswire-guide NetNewsWire 源码解读图集

Visual guide / source-cited diagrams

先看图,再读代码

这是对一个 NetNewsWire fork 的源码解读。每张图上每个节点都标了原始文件与行号,点开即可跳到 GitHub 上对应的位置; 所有图由同一份 JSON IR 生成,并通过结构校验。基线提交 512e461。

8 张图全部校验通过 基线 512e461 生成工具 archify
8 / 15
张图 · 7 张待生成
按组成 / 数据 / 链路 / 生命周期分层
183
个节点
已完成部分,每个节点带源码定位
99
条连线
已完成部分,工作流之间的调用与数据流
32
次校验通过
8 张图 × 四道闸门

四层,十五张图

从组成到生命周期,每层回答一个问题;虚线卡是已经规划、还没生成的图

Layer 01 · 组成层

组成层,先看清谁依赖谁。

这个系统由哪些域、哪些包组成,谁依赖谁。

01 能力地图 81 节点 · 0 连线

NetNewsWire 能力地图

这个 fork 的全部功能能力,按包含关系逐层分解;每个叶子都指向仓库中的实现位置。

校验通过 SHOWCASE 6/6 闸门
sha256 ad28de6f2fa7
02 ARCHITECTURE 14 节点 · 8 连线

NetNewsWire 功能网络

七个功能域、依赖方向,以及所有域共用的底座边界;阅读与呈现、状态与同步、存储与检索之间互相写,形成闭环。

校验通过 SHOWCASE 6/6 闸门
sha256 c5fae2b3f30a
03 architecture 待生成

模块依赖

Modules/ 下十九个 Swift 包之间谁引用谁,改一处会波及哪些包。

Layer 02 · 数据层

数据层,数据落在哪里。

数据落在哪些表、哪些文件里,靠什么键关联。

04 erd 待生成

数据模型

articles、statuses、feeds、订阅与同步队列的表结构、主键和外键。

05 architecture 待生成

单账户存储布局

每个账户目录下的 DB.sqlite3、FeedSettings.db、Sync.db、Subscriptions.opml 各存什么,凭据为什么在 Keychain。

Layer 03 · 链路层

链路层,跟着一次请求走。

一条请求从进入到结果,中间经过谁。

06 工作流 11 节点 · 11 连线

NetNewsWire 刷新管线

从一次刷新触发到新文章出现在时间线

校验通过 SHOWCASE 6/6 闸门
sha256 2332dca4c5a6
07 WORKFLOW 18 节点 · 17 连线

一条 RSS 进来之后

本地账户口径:一条订阅从刷新到界面刷新,十四个步骤,以及五个提前退出(非 2xx、304、内容没变、解析失败、新加 feed 首次下载)。

校验通过 SHOWCASE 6/6 闸门
sha256 bca798ae2ad4
08 工作流 17 节点 · 18 连线

NetNewsWire 添加订阅

从新建订阅入口到订阅出现在侧边栏并能被抓取

校验通过 SHOWCASE 6/6 闸门
sha256 fa0e7abf554d
09 工作流 13 节点 · 13 连线

NetNewsWire 已读与星标的状态回写

从一次标记到本地库、远端服务与界面刷新

校验通过 SHOWCASE 6/6 闸门
sha256 f6e881a1f509
10 工作流 16 节点 · 19 连线

NetNewsWire 搜索索引

写入侧入库即建索引,查询侧两种范围走同一张表

校验通过 SHOWCASE 6/6 闸门
sha256 9831c81db310
11 工作流 13 节点 · 13 连线

NetNewsWire AI 翻译与改写

一篇文章从触发到三标签展示:翻译与改写两条任务线

校验通过 SHOWCASE 6/6 闸门
sha256 f6fbc03cdb31
12 workflow 待生成

CloudKit 跨设备同步

两台机器之间订阅、文章、已读星标怎么经 CloudKit 对齐。

13 workflow 待生成

通知与界面刷新

一次下载完成后,通知怎么传到侧边栏、时间线和未读数。

Layer 04 · 生命周期层

生命周期层,一个对象的一生。

一个对象什么时候算什么状态。

14 lifecycle 待生成

文章生命周期

一篇文章从入库到被删,中间经过哪些状态(未读、已读、星标、半年自动已读、三十天清理)。

15 sequence 待生成

应用启动与恢复

启动时窗口状态怎么恢复、账户怎么加载、首屏什么时候能读。