# td

**Repository Path**: xbea/td

## Basic Information

- **Project Name**: td
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: GPL-3.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-27
- **Last Updated**: 2026-06-30

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

Based on the code map provided, I can see this is a macOS TodoList application built with SwiftUI and SwiftData. Let me create a comprehensive README.md for this project.

# TodoList

一款简洁优雅的 macOS 任务管理应用，支持智能过滤、自然语言解析、快速添加和系统级全局热键。

## 功能特性

### 核心功能
- **任务管理**：创建、编辑、删除任务，支持子任务层级
- **快速添加**：全局热键快速唤起悬浮窗口添加任务
- **自然语言解析**：输入任务时自动识别日期、优先级、标签和项目
- **智能过滤**：自定义过滤器，按状态、标签、项目、关键词等条件筛选
- **项目与标签**：使用颜色区分的项目和标签组织任务
- **提醒同步**：支持与系统提醒事项同步

### 快捷键
- **全局热键**：快速唤起添加窗口（默认配置）
- **⌘N**：新建任务
- **⌘⇧N**：新建子任务

## 技术栈

- **UI 框架**：SwiftUI
- **数据持久化**：SwiftData
- **系统集成**：AppKit（全局热键、悬浮窗口）
- **系统框架**：EventKit（提醒事项同步）

## 项目结构

```
TodoList/
├── TodoList/
│   ├── Models/           # 数据模型
│   │   ├── TodoItem.swift
│   │   ├── Project.swift
│   │   ├── TodoTag.swift
│   │   └── SmartFilter.swift
│   ├── Views/           # 视图组件
│   │   ├── ContentView.swift
│   │   ├── SidebarView.swift
│   │   ├── TaskListView.swift
│   │   ├── TaskRowView.swift
│   │   ├── QuickAddView.swift
│   │   └── ...
│   ├── Services/        # 服务层
│   │   ├── SmartFilterEngine.swift
│   │   └── RemindersSyncService.swift
│   ├── Utilities/       # 工具类
│   │   ├── NaturalLanguageParser.swift
│   │   ├── GlobalHotkeyManager.swift
│   │   └── FloatingWindowController.swift
│   └── AppDelegate.swift
```

## 使用说明

### 添加任务
1. 使用全局热键或点击侧边栏添加按钮
2. 输入任务标题，支持自然语言：
   - 日期：`明天`、`周五`、`2024-01-01`
   - 优先级：`高`、`中`、`低`
   - 标签：`#标签名`
   - 项目：`@项目名`

### 创建智能过滤
1. 点击侧边栏「过滤器」旁的 + 按钮
2. 设置过滤条件（状态、日期、标签等）
3. 设置排序方式和显示顺序

### 组织任务
- 创建项目：为任务分配颜色项目
- 添加标签：为任务添加多个标签
- 创建子任务：在任务右侧点击添加按钮

## 环境要求

- macOS 14.0+ (Sonoma)
- Xcode 15.0+

## 许可协议

MIT License