本地 SQLite 待办管家，轻量高效

纯本地 SQLite 待办管理工具，通过 Shell 脚本操作，零网络依赖、防注入设计，适合开发者的轻量任务追踪。

基本信息

• 技能名称?Todo management
• 中文名称?本地 SQLite 待办管家，轻量高效
• 作者?lstpsche
• 分类?专业技能
• 版本?1.1.3
• 标签?todo, sqlite, cli, local-first, shell-script, productivity, task-management, privacy-focused

使用方法

使用说明
核心用法
Todo Management 是一款基于 SQLite 的本地待办事项管理 Skill，通过 {baseDir}/scripts/todo.sh 脚本与数据库交互。核心功能围绕 条目（Entry） 和 分组（Group） 两个维度展开：
条目操作 ：支持创建（ entry create ）、列表查询（ entry list ）、单条查看（ entry show ）、文本编辑（ entry edit ）、分组移动（ entry move ）、状态变更（ entry status ）及删除（ entry remove ）。状态流转覆盖 pending → in_progress → done/skipped 的完整生命周期，默认视图自动隐藏已完成和已跳过任务。
分组管理 ：提供分组的创建、列表、重命名（ rename / edit 别名）及删除功能。删除分组时默认将条目移至 Inbox，仅在用户明确授权后才允许级联删除条目，体现数据安全设计。

环境配置 ：支持通过 TODO_DB 环境变量覆盖默认的 ./todo.db 路径，实现多工作区隔离。

显著优点

1. 零网络依赖 ：纯本地 SQLite 操作，无外发流量，隐私完全自主掌控
2. 防注入设计 ：SQL 操作采用参数化查询，配合 sql_q 转义函数，有效防御注入攻击
3. Shell 安全模式 ：脚本启用 set -euo pipefail ，严格错误处理，避免未定义变量等常见漏洞
4. 交互设计克制 ：非必要不展示列表，操作后单行确认反馈，减少信息噪音

5. 破坏性操作保护 ：分组删除、条目移除等操作需 ID 确认或用户二次授权，防止误操作

   潜在局限
   依赖系统工具 ：必须预装 sqlite3 二进制，Windows 环境需额外配置
   无同步机制 ：纯本地存储，跨设备协作需自行解决数据同步
   功能边界清晰 ：不支持优先级、截止日期、标签等复杂字段，适合轻量场景

   CLI 学习成本 ：相比 GUI 工具，非技术用户需要熟悉命令参数

   适合人群
   偏好终端工作流的开发者与技术用户
   对数据隐私敏感、拒绝云端服务的用户
   需要快速嵌入项目工作区的轻量任务管理场景

   已有脚本化工作流、希望统一工具链的团队

   常规风险
   数据备份责任 ：SQLite 文件需用户自行备份，无自动快照机制
   并发访问限制 ：无显式锁机制，多进程同时写入可能产生冲突
   环境变量覆盖误用 ：错误设置 TODO_DB 可能导致数据写入非预期位置