核心用法
task-planner 是一款基于 Bash 编写的本地 CLI 任务管理工具,通过 scripts/script.sh 脚本提供完整的任务生命周期管理。核心命令包括:
- add:添加新任务并设置截止日期与提醒
- list:查看待办事项优先级列表
- done/remove/edit:完成任务、删除或修改条目
- search:关键词检索历史任务
- today/overdue:快速筛选当日待办与逾期任务
- stats:生成完成率统计报告
- export:数据导出功能
所有数据默认存储于 ~/.task-planner/ 目录,可通过 TASK_PLANNER_DIR 环境变量自定义路径。
显著优点
1. 完全离线:零外部 API 调用,杜绝数据泄露风险
2. 轻量依赖:仅需 Bash 4.0+,无需 Python/Node 运行时
3. 数据自主:本地文件存储,用户完全掌控数据主权
4. 开源透明:GitHub 源码可审计,无黑箱操作
潜在局限
- 无跨设备同步机制,多终端需手动复制数据目录
- 缺乏图形界面,纯命令行交互门槛较高
- 复杂项目管理(如甘特图、团队协作)能力不足
- 依赖本地文件系统,无自动备份机制
适合人群
- 隐私敏感型用户(开发者、安全从业者)
- 追求极简工具的效率主义者
- 离线环境或内网办公场景
- 已有自建同步方案(Syncthing、Git)的技术用户
常规风险
- 数据丢失:本地存储无云端冗余,建议配合定期备份
- 权限问题:多用户系统需注意
~/.task-planner/目录权限配置 - 脚本注入:若修改源码需防范恶意注入,建议校验官方签名