Planx 开发记录

一个反身性任务管理 CLI 工具,管的是「为什么做、做什么、怎么做」——不是「什么时候做、花了多久」。


一、核心哲学

  • 反身性设计:每个任务强制填写「意义」「预期」「路径」三个反身性字段
  • 现象学记录:任务过程中记反思笔记 + 上下文快照(情绪/障碍)
  • 推送通知:Termux API 实现定时/延时提醒,优先级驱动的通知策略

二、架构

模块职责
project项目 CRUD
task任务 CRUD + 状态机
remind通知系统
context上下文快照
scheduleJob 调度注册
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 脚本