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)解析全量 IDcore/context.py—log()方法:LIKE 前缀匹配 resolvecore/reminder.py— 新增_resolve_task_id()统一方法
四、与 Worklog 的关系
- [[Worklog|Worklog]] 面向过去(时间记录、统计)
- planx 面向未来(计划、反身性、通知)
- 不需要集成,可以互补
- 可选 bridge 脚本:planx 任务标题 → worklog start,worklog 实际耗时 → planx actual_minutes
五、相关文档
- [[Hugo + Obsidian 搭建数字小家的全流程]]
- [[工作注意事项]]
- [[Termux API 命令]]
六、待办
- 通知系统稳定性测试
- GitHub 公开
- 可选的 worklog bridge 脚本