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