Planx 开发记录:反身性任务管理工具

Planx 开发记录 一个反身性任务管理 CLI 工具,管的是「为什么做、做什么、怎么做」——不是「什么时候做、花了多久」。 一、核心哲学 反身性设计:每个任务强制填写「意义」「预期」「路径」三个反身性字段 现象学记录:任务过程中记反思笔记 + 上下文快照(情绪/障碍) 推送通知:Termux API 实现定时/延时提醒,优先级驱动的通知策略 二、架构 模块 职责 project 项目 CRUD task 任务 CRUD + 状态机 remind 通知系统 context 上下文快照 schedule Job 调度注册 notifier 通知本质逻辑 数据层:SQLite (WAL + FK),4 表:projects / tasks / reminders / context_log ID 设计:32 位 uuid4.hex,CLI 显示前 8 位,内部全量存储 三、Bug 修复记录 所有 FK 相关 bug 的同一种修复模式 —— 短 ID resolve 层: core/task.py — update() 方法:先 get(task_id) 解析全量 ID core/context.py — log() 方法:LIKE 前缀匹配 resolve core/reminder.py — 新增 _resolve_task_id() 统一方法 四、与 Worklog 的关系 [[Worklog|Worklog]] 面向过去(时间记录、统计) planx 面向未来(计划、反身性、通知) 不需要集成,可以互补 可选 bridge 脚本:planx 任务标题 → worklog start,worklog 实际耗时 → planx actual_minutes 五、相关文档 [[Hugo + Obsidian 搭建数字小家的全流程]] [[工作注意事项]] [[Termux API 命令]] 六、待办 通知系统稳定性测试 GitHub 公开 可选的 worklog bridge 脚本

May 3, 2026 · 1 min · 117 words · kwelldo

Planx:一个反身性任务管理工具

缘起 我一直在用 worklog 做时间记录——一个简单的 CLI 工具,记录什么时候开始做什么、花了多久、每天/周/月统计。它管的是过去:你干过什么,花了多少时间。 但慢慢觉得缺了点什么。worklog 不关心你为什么要做一件事,不关心你预期做成什么样,也不关心你打算怎么做。它只告诉你「昨天写了 3 小时代码」,但不知道那代码解决什么问题、做到什么程度才算完、下一步该做什么。 于是有了 planx。 设计哲学 planx 不是 worklog 的替代品,它是另一个方向的工具。 反身性设计(Reflexivity) 每个任务创建时必须填写三个字段。不填不行,CLI 会强制你填: 意义(significance)——为什么做这件事?不做会怎样? 预期(outcome)——做完之后,成果是什么?怎么算「完成」? 路径(approach)——怎么达成?第一步做什么? 这三个字段加起来,就是让一个任务不是单纯的 todo 条目,而是有「来龙去脉」的意图单元。 现象学记录 任务执行过程中可以随时记两样东西: 反思笔记(note)——写到哪了,卡在哪里,有什么新发现 上下文快照(context log)——当时的情绪状态、遇到的障碍、备注 这些不是靠回忆补填的,而是在任务进行中记的。回头看的时候,时间线上能看到:当时是什么状态、卡在什么问题上、最后是怎么解决的。 推送通知 既然是手机上的 Termux 工具,通知系统是必须的。planx 的 remind 子系统用了 Termux API: 定时提醒——某天某时提醒你做某个任务 延时提醒——「30 分钟后提醒我」 优先级驱动的通知策略——P1 任务每 15 分钟震动+语音提醒,P5 只出现在每日汇总 后台 Job 调度——注册两个 termux-job-scheduler 任务:每天 9:00 做当日汇总推送,每 30 分钟检查到期提醒 架构一览 模块 职责 核心文件 project 项目 CRUD,任务按项目归类 core/project.py task 任务 CRUD,反身性字段,生命周期状态机 core/task.py remind Termux 通知,定时/延时提醒,优先级策略 core/reminder.py context 上下文快照,情绪/障碍/备注,绑定任务 core/context.py schedule termux-job-scheduler 注册 core/scheduler.py notifier 通知本质逻辑(TTS/震动/按钮回复) core/notifier.py 数据层用 SQLite,4 张表(projects / tasks / reminders / context_log),WAL 模式,外键约束。 ...

May 3, 2026 · 2 min · 348 words · kwelldo