Terminal Task Tracker

🚀 終端任務追蹤器

終端任務追蹤器是一個基於終端的任務跟蹤應用程序，採用三窗格佈局，可高效管理和規劃項目任務，幫助用戶提升工作效率。

🚀 快速開始

你可以按照以下步驟安裝和使用終端任務追蹤器：

# 克隆倉庫
git clone https://github.com/yourusername/terminal-task-tracker.git
cd terminal-task-tracker

# 安裝依賴項
pip install -e .

啟動終端界面：

python -m main.py

✨ 主要特性

• 三窗格終端界面：
  • 任務列表（左上）
  • 任務詳細信息（右上）
  • 項目計劃（底部，全寬）
• 任務管理：
  • 創建、查看、編輯和刪除任務
  • 設置優先級和狀態
  • 添加詳細描述
• 項目計劃管理：
  • 定義高層次的項目步驟
  • 跟蹤步驟完成情況
  • 重新排序步驟
• 完整API用於程序訪問
• 命令行接口用於腳本編寫
• 數據持久化

📦 安裝指南

# 克隆倉庫
git clone https://github.com/yourusername/terminal-task-tracker.git
cd terminal-task-tracker

# 安裝依賴項
pip install -e .

💻 使用示例

基礎用法

終端界面

啟動終端界面：

python -m main.py

鍵盤綁定：

• Tab：在窗口之間切換
• Up/Down：導航列表
• Enter：選擇任務（在任務列表中）
• n：新建項（在任務列表或計劃中）
• e：編輯項
• d：刪除項
• Space：切換完成狀態（在計劃中）
• Esc：退出

命令行界面

CLI提供所有功能訪問：

# 列出所有任務
python -m app.api.cli task list

# 添加新任務
python -m app.api.cli task add "實現功能X" --description "關於功能X的詳細信息" --priority 2

# 標記計劃步驟為完成
python -m app.api.cli plan toggle STEP_ID

# 導出數據到JSON
python -m app.api.cli export data.json

高級用法

API 使用方法

from app.core.task_manager import TaskManager
from app.core.plan_manager import PlanManager
from app.api.api import TaskTrackerAPI

# 初始化管理器
task_manager = TaskManager("tasks.json")
plan_manager = PlanManager("plan.json")

# 創建API
api = TaskTrackerAPI(task_manager, plan_manager)

# 添加任務
task = api.add_task("實現功能X", "關於功能X的詳細信息", priority=2)

# 添加計劃步驟
step = api.add_plan_step("為共享操作模塊設計架構")

# 標記步驟為完成
api.toggle_plan_step(step["id"])

# 保存數據
api.save_all()

📚 詳細文檔

項目結構

terminal-task-tracker/
├── app/
│   ├── __init__.py
│   ├── core/               # 業務邏輯
│   │   ├── __init__.py
│   │   ├── task_manager.py
│   │   └── plan_manager.py
│   ├── ui/                 # 終端UI
│   │   ├── __init__.py
│   │   ├── terminal_ui.py
│   │   ├── ui_components.py
│   │   └── input_handler.py
│   └── api/                # API和CLI
│       ├── __init__.py
│       ├── api.py
│       └── cli.py
├── main.py                 # 應用程序入口點
└── README.md

數據存儲

默認情況下，數據保存在 ~/.tasktracker 目錄中：

• tasks.json：任務數據
• plan.json：項目計劃數據
• notes.json：筆記數據

📄 許可證

本項目採用 MIT 許可證。