NowTree —— 本地优先的 GTD 桌面应用
Last updated on

NowTree —— 本地优先的 GTD 桌面应用


零账号、纯本地、数据自托管 —— 任务存在本机 SQLite 里,除「你主动点检查更新」这一处外,所有功能离线可用。

这是什么

一个轻量级 GTD(Getting Things Done)桌面应用,目前只做 Windows 10/11。核心思路:任务进 Inbox 后由人主动整理,不自动归类,避免「系统替你决定」的隐性打扰。

技术栈与关键决策

  • Tauri 2 —— Rust 内核 + 系统 WebView,主程序约 6MB(安装包 v1.1.8 约 2.5MB,带 updater 后比 1.0.x 的 1.8MB 略大),换 Electron 大概要多背 100MB 运行时。
  • React 18 + TypeScript + Vite 5 + Zustand 4 —— UI 与状态层;组件化真正兑现的地方是后来加第二窗口(见下),不是「先给 AI 留位置」。
  • SQLite(本地单表 + rusqlite bundled) —— 数据在本机应用数据目录下的 .sqlite 里,local-first 哲学;v1.0.0 到 v1.1.8 的所有版本零数据库迁移(db.rs 至今是「建表 + 若干条失败即吞的 ALTER」,没有迁移版本号这回事)。
  • 状态机而非优先级魔法 —— 任务在 Inbox / Active / Completed 三态间流转,系统永不自动把任务推进 Next Actions,整理权完全在人。
  • 真相源下沉 service 层 —— 事务遍历与级联算法(释放整棵子树、撤销时收集子树 ID、字段级差异比对)都在 services/,store 只做编排,所以能纯前端单测覆盖。
  • 双窗口 + 双 Vite 入口(v1.1.5 起)—— 主窗之外多了一个独立的 reminder 窗(reminder.html 单独打包),提醒不再寄生在主窗口里。
  • 插件层 —— dialog / autostart / single-instance / opener / updater。前端三个与 updater 相关的包必须锁到精确版本,minor 与 Rust crate 对不齐时 tauri build 会直接拒绝。

版本演进(v1.0.0 → v1.1.8)

版本 主要内容
v1.0.0 Inbox → 四类事务(Next Action / Project / Waiting / Someday)完整 GTD 工作流;三时段规划与启动弹窗;Project 树与子事务;回收站 + JSON 导入导出;托盘化运行;深浅主题;快捷键与拖拽排序
v1.0.1 写入失败不再静默;到期提醒去重;拖拽排序索引修复;相对截止日锚定「修改时刻」
v1.0.2 Waiting 到期自动进 Next;「具体日期 = 今天」自动归一为「今日」
v1.0.3 弹窗内拖选文本误触关闭的修复;一键清理提示音
v1.0.4 启动弹窗按当前钟点过滤任务、跨时段边界自动重弹、每日励志语
v1.1.0 新增 Habits 视图(习惯每日复位、可拖拽排序),启动弹窗按时段问候
v1.1.1 时间要求新增「明天 / 下周」相对类型(到期自动翻转);习惯可选早 / 午 / 晚时段
v1.1.2 时段分界线可自定义(早 / 午 / 晚各自起点小时);「展示在 Next」开关收进编辑弹窗;移除 Habits 视图
v1.1.3 父事务改类别时释放整棵子树(不再凭空消失);「展示在 Next」开关按来源收口;拖拽到垃圾桶快捷删除(软删除 + 整棵子树撤销)
v1.1.4 修「明天 / 下周」跨日被静默改写成未来日、把逾期信号抹掉的回归;取消「展示在 Next」时同步清空时段槽;编辑弹窗改成 Project 时可直选父事务;保存提示改为按字段比对
v1.1.5 最大一版:弃用 Windows 系统通知,改应用自绘右下角提醒窗;原居中「今日」弹窗并入每日摘要卡;新增 Inbox 每周回顾提醒;提醒改为到点精确触发;删除 StartupModal 与 notification 插件
v1.1.6 一键清理 / 批量删除改「点了就删 + 5 秒撤销条」,撤销按整棵子树 ID 回滚;清空回收站改独立确认框;15 个弹窗默认不再点遮罩关闭,防丢草稿
v1.1.7 菜单新增「检查更新」:拉 GitHub 上的静态清单、校验签名后应用内下载安装并自动重启(没有跳过校验的开关);修「跟随系统」主题恒为浅色;修启动闪深色;README 按普通使用者整篇重排
v1.1.8 纯收尾:检查失败也能打开发布页(5 秒动作 toast);发布说明截断口径三处统一为「最多 8 行」;证书 / TLS 错误不再误报成「签名被篡改」;三处重复的环境判断收进 isTauri.ts

关于 v1.1.2 移除 Habits:习惯曾是纯前端概念(仅靠 category='habit' 文本值区分),移除即纯代码删除,数据库表结构无需任何调整,也不影响既有数据。

关于 v1.1.5 删除启动弹窗:它是 v1.0.0 的门面功能,但每次启动都挡在任务前面。现在拆成两件事——想立刻看今天做什么,就开每日摘要卡;想每周复盘,就靠 Inbox 每周回顾提醒。

把系统通知全删了(v1.1.5)

这是至今最大的一次改动,起因是系统通知不受控:弹多久、抢不抢焦点、几条同时来怎么排队、用户在系统设置里一关就全哑,全都由 Windows 决定。

于是改成应用自己画:一个无边框、置顶、不进任务栏的小窗口,卡片上三个动作(完成 / 稍后 / 关闭)。

  • 不抢焦点:建窗后调 Win32 ShowWindow(SW_SHOWNOACTIVATE)。坑在于建窗的 Tauri command 必须是 async,同步版本在 Windows 上会死锁。
  • 四角定位:提醒卡可以贴屏幕四个角,位置偏好存本地。
  • 全屏时排队:检测到全屏(放视频、开会)就让卡片等着,退出全屏再依次弹出。
  • 不是一直堆着:10 秒自动收起;多条同时到期则纵向堆叠。
  • 到点精确触发:不再靠前端 setInterval 轮询,改为 Rust 侧调度(schedule_reminder_fire),跨时段边界也能准点。

代价是它只在程序运行时有效:OS 级定时(关掉程序也能响)仍然没做。

自动更新为什么走静态文件

第一版想用 GitHub REST API 查最新版,问题是最新版本号是「读一次少一次」的资源——匿名调用 60 次/小时,用户多开几次、或者开发时反复试,就会撞限流。

最后改成:仓库里放一个静态 latest.json,App 直接拉这份文件,没有频次限制、也不需要 token。安全性靠签名——公钥内置在安装包里,对下载到的安装包验签,没有「跳过校验」的开关。私钥不进仓库(在 gitignore 的 Materials/updater/ 里)。

失败路径也做了兜底:网络不通、证书错误、限流,都只是提示 + 给一个「打开发布页」的按钮,不假装成功。证书 / TLS 错误曾一度被误标成「签名被篡改」,v1.1.8 修掉了——这类误报会让人以为安装包被人动过手脚。

几处工程细节

  • 软删除 + 级联撤销:删除非 Inbox 事务会连整棵子树(父 + 所有后代)一起进回收站,并弹出几秒的撤销窗口;后端软删只向下级联,撤销时显式逐条恢复每个子树成员。Inbox 里的任务例外:那是硬删、不给撤销(还没进系统的东西,删了就是删了)。
  • 回收站护栏:Project 子事务只在 Project 视图里渲染,若其父事务已不在列表,单独恢复会得到「永远看不见的孤儿」——因此被显式拦截并提示。
  • 状态收口而非堆开关:例如「展示在 Next」的开关,先后经历「行内 → 编辑弹窗 → 只在 Next 视图打开时出现」三次收敛,把重复入口逐个砍掉。
  • 别信 prefers-color-scheme:「跟随系统」在 WebView2 里会失真(窗口没焦点时媒体查询不更新,于是永远是浅色)。现在改成 Rust 读注册表拿真实主题、20 秒复查一次,顺带修掉了启动瞬间的深色闪烁。
  • 测试边界要说清:vitest run 136 项(v1.1.3 时是 54 项,v1.1.4 → v1.1.8 一路补到 136),覆盖的全是纯前端逻辑。Rust 侧至今 0 个 #[test]、没有 CI——提醒窗、更新器这些真正跟系统打交道的地方,目前只有真机手测。

路线图

已经做完的一条:应用内签名更新(v1.1.7),当初只在「未来方向」清单里占一行。

规划中(未立项):全文搜索、Stats 热力图、全局热键 / 快速捕获、重复任务、列表虚拟化、命令面板、版本化迁移 + 每日备份 + WAL、Rust 侧测试与 CI、i18n。

仍不打算做:云同步。也没有在做 AI——「AI 辅助整理 / AI 周报」到现在仍只是想法,代码里一行相关逻辑都没有。sync_id 字段只是给未来留的占位(启动时回填),没有 rev、没有设备标识、没有墓碑表。

仓库

github.com/z1lyA/NowTree — 最新 v1.1.8(2026-11-12),欢迎 Star / Issue。