NetNewsWire 能力地图
这个 fork 的全部功能能力,按包含关系逐层分解;每个叶子都指向仓库中的实现位置。
Visual guide / source-cited diagrams
这是对一个 NetNewsWire fork 的源码解读。每张图上每个节点都标了原始文件与行号,点开即可跳到 GitHub 上对应的位置;
所有图由同一份 JSON IR 生成,并通过结构校验。基线提交 512e461。
从组成到生命周期,每层回答一个问题;虚线卡是已经规划、还没生成的图
Layer 01 · 组成层
这个系统由哪些域、哪些包组成,谁依赖谁。
这个 fork 的全部功能能力,按包含关系逐层分解;每个叶子都指向仓库中的实现位置。
七个功能域、依赖方向,以及所有域共用的底座边界;阅读与呈现、状态与同步、存储与检索之间互相写,形成闭环。
Modules/ 下十九个 Swift 包之间谁引用谁,改一处会波及哪些包。
Layer 02 · 数据层
数据落在哪些表、哪些文件里,靠什么键关联。
articles、statuses、feeds、订阅与同步队列的表结构、主键和外键。
每个账户目录下的 DB.sqlite3、FeedSettings.db、Sync.db、Subscriptions.opml 各存什么,凭据为什么在 Keychain。
Layer 03 · 链路层
一条请求从进入到结果,中间经过谁。
从一次刷新触发到新文章出现在时间线
本地账户口径:一条订阅从刷新到界面刷新,十四个步骤,以及五个提前退出(非 2xx、304、内容没变、解析失败、新加 feed 首次下载)。
从新建订阅入口到订阅出现在侧边栏并能被抓取
从一次标记到本地库、远端服务与界面刷新
写入侧入库即建索引,查询侧两种范围走同一张表
一篇文章从触发到三标签展示:翻译与改写两条任务线
两台机器之间订阅、文章、已读星标怎么经 CloudKit 对齐。
一次下载完成后,通知怎么传到侧边栏、时间线和未读数。
Layer 04 · 生命周期层
一个对象什么时候算什么状态。
一篇文章从入库到被删,中间经过哪些状态(未读、已读、星标、半年自动已读、三十天清理)。
启动时窗口状态怎么恢复、账户怎么加载、首屏什么时候能读。