Task Planner

核心用法

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/ 目录权限配置
• 脚本注入：若修改源码需防范恶意注入，建议校验官方签名

核心用法

task-planner 是一款基于 Bash/Python3 的本地命令行任务管理工具，无需安装复杂依赖，开箱即用。用户通过 add、list、done、remove、edit 等子命令完成任务的增删改查；today 与 overdue 快速筛选当日及逾期任务；stats 提供完成度统计；export 支持数据导出。所有任务数据以 JSON 格式存储于 ~/.task-planner/，可通过环境变量 TASK_PLANNER_DIR 自定义路径。

显著优点

1. 零外部依赖风险：纯本地运行，无网络调用、无第三方 API 接入，彻底杜绝数据泄露与供应链攻击。
2. 隐私优先设计：GDPR 合规，数据最小化、本地存储、无跨境传输，用户拥有完全的数据主权。
3. 轻量高效：仅依赖系统标准工具（bash 4.0+、python3），630 行代码结构清晰，启动极快。
4. 功能完备：涵盖优先级（high/medium/low）、截止日期、完成状态、搜索筛选、统计导出等完整任务管理闭环。

潜在缺点与局限性

• 无云同步：多设备协作需手动迁移数据，团队场景适用性弱。
• CLI 门槛：纯命令行交互，对非技术用户学习成本较高。
• T3 来源级别：个人开发者（BytesAgain）维护，长期更新与社区生态依赖作者个人投入。
• 无可视化界面：缺乏图形看板、日历视图等直观呈现方式。

适合人群

• 隐私敏感型个人用户（开发者、研究员、自由职业者）
• 偏好离线工具、拒绝 SaaS 订阅的极简主义者
• 需在终端环境快速记录任务的技术工作者
• 本地自动化脚本集成场景

常规风险

• 数据丢失：本地存储无自动备份，建议定期执行 export 或手动备份目录。
• 输入注入：虽经静态分析未发现危险函数，但用户仍需避免在任务描述中插入特殊 shell 字符。
• 权限管理：需确保 ~/.task-planner/ 目录权限正确，防止多用户系统下的数据交叉访问。