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 run136 项(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。