命令行待办事项应用开发全指南

1. 为什么选择命令行待办事项应用？

在图形界面大行其道的今天，命令行工具依然保持着独特的生命力。我十年前刚开始接触编程时，就被命令行工具的高效所震撼。与图形界面相比，命令行待办事项应用有几个不可替代的优势：

首先，命令行工具几乎不占用系统资源。我曾经测试过，一个完整的图形界面待办事项应用至少占用50MB内存，而命令行版本通常不到1MB。这对于配置较低的开发机或需要长时间运行的后台任务尤为重要。

其次，命令行工具天然适合自动化。我经常需要将待办事项与CI/CD流程集成，命令行工具可以通过简单的管道操作与其他工具无缝衔接。比如，我可以用todo list | grep "urgent"快速筛选出紧急任务。

最重要的是，命令行工具提供了极致的定制空间。我的团队中有人喜欢用Emacs org-mode管理任务，有人偏爱Vim插件，而命令行核心可以适配各种前端界面。这种灵活性是图形界面难以企及的。

2. 基础架构设计

2.1 数据存储方案选择

经过多次迭代，我发现SQLite是最适合命令行待办事项的存储方案。它零配置、单文件、支持完整SQL语法。下面是我的典型tasks表结构：

sql复制CREATE TABLE tasks (
    id INTEGER PRIMARY KEY,
    title TEXT NOT NULL,
    description TEXT,
    status TEXT CHECK(status IN ('pending', 'completed', 'archived')),
    priority INTEGER DEFAULT 3,
    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
    due_date TIMESTAMP
);

对比其他方案：

• 纯文本文件：查询效率低，缺乏事务支持
• JSON文件：难以处理并发写入
• MySQL等：过度设计，增加部署复杂度

2.2 核心命令设计

一个实用的命令行待办工具至少需要这些命令：

bash复制todo add "Review project proposal" -d "2023-06-15" -p 1
todo list --status pending --sort priority
todo complete 42
todo delete 37
todo search "meeting"

我特别推荐使用Python的click库构建命令行界面。它支持：

• 自动生成帮助文档
• 参数类型验证
• 子命令嵌套
• 彩色输出

3. 高级功能实现

3.1 任务依赖管理

真实项目中的任务往往存在依赖关系。我通过添加dependencies表实现：

sql复制CREATE TABLE task_dependencies (
    task_id INTEGER,
    depends_on INTEGER,
    PRIMARY KEY (task_id, depends_on),
    FOREIGN KEY (task_id) REFERENCES tasks(id),
    FOREIGN KEY (depends_on) REFERENCES tasks(id)
);

查询待办事项时，可以这样检查依赖状态：

python复制def is_task_ready(task_id):
    dependencies = db.execute("""
        SELECT t.status FROM task_dependencies d
        JOIN tasks t ON d.depends_on = t.id
        WHERE d.task_id = ?
    """, (task_id,)).fetchall()
    
    return all(dep[0] == 'completed' for dep in dependencies)

3.2 自然语言日期解析

为了让日期输入更人性化，我整合了dateparser库：

python复制from dateparser import parse

def parse_due_date(date_str):
    result = parse(date_str)
    if not result:
        raise ValueError(f"无法识别的日期格式: {date_str}")
    return result

现在可以这样添加任务：

bash复制todo add "Send report" -d "next Monday at 2pm"

4. 实战技巧与避坑指南

4.1 并发写入处理

SQLite虽然支持并发读取，但写入时需要特别注意。我的解决方案：

python复制import sqlite3
from contextlib import contextmanager

@contextmanager
def db_connection():
    conn = sqlite3.connect('tasks.db', timeout=10)
    conn.execute("PRAGMA busy_timeout = 3000")  # 3秒等待
    try:
        yield conn
    finally:
        conn.close()

使用时：

python复制with db_connection() as conn:
    conn.execute("INSERT INTO tasks (...) VALUES (...)")
    conn.commit()

4.2 命令行自动补全

使用argcomplete为bash/zsh添加自动补全：

python复制import argcomplete

def main():
    parser = argparse.ArgumentParser()
    # ...添加参数...
    argcomplete.autocomplete(parser)
    args = parser.parse_args()

然后在shell配置中添加：

bash复制eval "$(register-python-argcomplete todo)"

5. 扩展与集成

5.1 邮件提醒集成

我使用SMTP协议实现任务到期提醒：

python复制import smtplib
from email.message import EmailMessage

def send_reminder(task, recipient):
    msg = EmailMessage()
    msg.set_content(f"Reminder: {task['title']} is due at {task['due_date']}")
    msg['Subject'] = f"待办事项提醒: {task['title']}"
    msg['From'] = "todo@example.com"
    msg['To'] = recipient
    
    with smtplib.SMTP('smtp.example.com', 587) as smtp:
        smtp.starttls()
        smtp.login("user", "password")
        smtp.send_message(msg)

5.2 与日历同步

通过生成ICS文件实现与Google Calendar等同步：

python复制from icalendar import Calendar, Event

def generate_ics(tasks):
    cal = Calendar()
    for task in tasks:
        event = Event()
        event.add('summary', task['title'])
        event.add('dtstart', task['due_date'])
        cal.add_component(event)
    
    with open('tasks.ics', 'wb') as f:
        f.write(cal.to_ical())

6. 性能优化实践

6.1 数据库索引优化

对于超过1000条记录的待办事项，这些索引至关重要：

sql复制CREATE INDEX idx_tasks_status ON tasks(status);
CREATE INDEX idx_tasks_due_date ON tasks(due_date);
CREATE INDEX idx_tasks_priority ON tasks(priority);

在我的测试中，添加索引后查询速度提升了20倍。

6.2 批量操作支持

处理大量任务时，单个SQL语句比多次执行更高效：

python复制# 低效方式
for task in tasks:
    cursor.execute("INSERT INTO tasks (...) VALUES (?, ...)", task)

# 高效方式
cursor.executemany("INSERT INTO tasks (...) VALUES (?, ...)", tasks)

7. 安全注意事项

7.1 输入验证

所有用户输入都必须严格验证：

python复制import re

def sanitize_input(text):
    if not re.match(r'^[\w\s\-,.?!]+$', text):
        raise ValueError("输入包含非法字符")
    return text.strip()

7.2 敏感数据保护

数据库连接信息等应存储在环境变量中：

python复制import os

db_path = os.getenv('TODO_DB_PATH', 'default.db')

8. 测试策略

8.1 单元测试示例

使用pytest测试核心逻辑：

python复制def test_add_task():
    with tempfile.NamedTemporaryFile() as tmp:
        db = Database(tmp.name)
        task_id = db.add_task("Test task")
        task = db.get_task(task_id)
        assert task['title'] == "Test task"

8.2 端到端测试

使用subprocess测试完整命令行流程：

python复制def test_cli_add():
    result = subprocess.run(
        ['todo', 'add', 'Test CLI task'],
        capture_output=True, text=True
    )
    assert "added successfully" in result.stdout

9. 打包与分发

9.1 使用PyInstaller创建独立可执行文件

bash复制pyinstaller --onefile --name todo todo/cli.py

9.2 制作Homebrew Formula（Mac用户）

ruby复制class Todo < Formula
  desc "Command-line todo manager"
  homepage "https://github.com/yourname/todo"
  url "https://github.com/yourname/todo/archive/v1.0.0.tar.gz"
  
  depends_on "python"

  def install
    system "pip3", "install", "-r", "requirements.txt"
    bin.install "todo.py" => "todo"
  end
end

10. 用户界面增强

10.1 彩色终端输出

使用rich库提升可读性：

python复制from rich.console import Console
from rich.table import Table

console = Console()

def print_tasks(tasks):
    table = Table(title="待办事项")
    table.add_column("ID")
    table.add_column("标题")
    table.add_column("截止日期")
    
    for task in tasks:
        table.add_row(
            str(task['id']),
            task['title'],
            task['due_date']
        )
    
    console.print(table)

10.2 交互式编辑模式

结合prompt_toolkit实现：

python复制from prompt_toolkit import prompt
from prompt_toolkit.completion import WordCompleter

completer = WordCompleter(['pending', 'completed', 'archived'])

def edit_task_interactive(task):
    new_title = prompt("标题: ", default=task['title'])
    new_status = prompt("状态: ", completer=completer)
    # 更新数据库...

11. 跨平台兼容性

11.1 Windows特殊处理

处理Windows路径问题：

python复制import platform
import os

if platform.system() == 'Windows':
    db_path = os.path.join(os.getenv('APPDATA'), 'todo', 'tasks.db')
else:
    db_path = os.path.join(os.path.expanduser('~'), '.todo.db')

11.2 终端编码处理

确保UTF-8支持：

python复制import sys
import codecs

if sys.stdout.encoding != 'UTF-8':
    sys.stdout = codecs.getwriter('utf-8')(sys.stdout.buffer)

12. 实际工作流示例

12.1 晨会准备

bash复制# 列出所有未完成的高优先级任务
todo list --status pending --priority 1

# 添加今日计划
todo add "完成API文档" -p 1 -d "today 17:00"
todo add "代码评审" -p 2 -d "today 15:00"

12.2 周报生成

bash复制# 获取本周完成的任务
todo list --status completed --after "last Monday" --before "this Sunday" > weekly_report.txt

# 统计各优先级任务数量
todo list --status pending | awk '{print $4}' | sort | uniq -c

13. 性能基准测试

在我的MacBook Pro (M1, 2020)上测试：

14. 错误处理最佳实践

14.1 友好的错误提示

python复制def handle_db_error(func):
    def wrapper(*args, **kwargs):
        try:
            return func(*args, **kwargs)
        except sqlite3.Error as e:
            print(f"[错误] 数据库操作失败: {str(e)}")
            sys.exit(1)
    return wrapper

14.2 事务回滚

python复制@handle_db_error
def update_task(task_id, updates):
    with db_connection() as conn:
        try:
            conn.execute("BEGIN")
            # 执行多个更新...
            conn.commit()
        except:
            conn.rollback()
            raise

15. 插件系统设计

15.1 插件接口定义

python复制from abc import ABC, abstractmethod

class TodoPlugin(ABC):
    @abstractmethod
    def on_task_add(self, task):
        pass
        
    @abstractmethod
    def on_task_complete(self, task_id):
        pass

15.2 示例插件：番茄钟集成

python复制class PomodoroPlugin(TodoPlugin):
    def on_task_add(self, task):
        if task['priority'] == 1:
            print("⚠️ 高优先级任务建议使用番茄钟专注处理")

    def on_task_complete(self, task_id):
        print("🎉 任务完成！休息5分钟吧")

16. 数据备份策略

16.1 自动备份实现

python复制import shutil
from datetime import datetime

def backup_database():
    timestamp = datetime.now().strftime("%Y%m%d_%H%M%S")
    backup_path = f"tasks_backup_{timestamp}.db"
    shutil.copy2('tasks.db', backup_path)
    print(f"数据库已备份到 {backup_path}")

16.2 云备份集成

使用rsync同步到远程服务器：

python复制def sync_to_remote():
    subprocess.run([
        'rsync', '-avz', 'tasks.db',
        'user@remote:/backups/todo/'
    ])

17. 国际化支持

17.1 多语言实现

使用gettext：

python复制import gettext

zh = gettext.translation('todo', localedir='locales', languages=['zh_CN'])
zh.install()

_ = zh.gettext

print(_("Task added successfully"))

17.2 本地化日期格式

python复制from babel.dates import format_date

def localized_date(date, locale='en_US'):
    return format_date(date, locale=locale)

18. 快捷键配置

支持用户自定义快捷键：

python复制import configparser

config = configparser.ConfigParser()
config.read('shortcuts.ini')

def get_shortcut(action):
    return config.get('SHORTCUTS', action, fallback=None)

示例配置文件：

ini复制[SHORTCUTS]
add_task = ctrl+a
complete_task = ctrl+d

19. 搜索功能增强

19.1 全文搜索支持

使用SQLite FTS5扩展：

sql复制CREATE VIRTUAL TABLE tasks_search USING fts5(title, description);

19.2 模糊搜索实现

python复制from fuzzywuzzy import fuzz

def fuzzy_search(query, tasks):
    return sorted(
        tasks,
        key=lambda t: fuzz.ratio(query, t['title']),
        reverse=True
    )[:5]

20. 系统集成技巧

20.1 Shell别名配置

在.bashrc/zshrc中添加：

bash复制alias td="todo"
alias tda="todo add"
alias tdl="todo list"

20.2 Git钩子集成

在pre-commit钩子中检查任务：

bash复制#!/bin/sh
incomplete=$(todo list --status pending --count)
if [ "$incomplete" -gt 0 ]; then
    echo "⚠️ 你有 $incomplete 个未完成任务！"
    todo list --status pending
fi