FreeTodo 使用方法
快速开始
启动服务
启动后端服务
首次设置: 首次运行时，如果
config.yaml不存在，系统会自动从default_config.yaml复制创建。您可以通过编辑lifetrace/config/config.yaml来自定义设置。
启动服务器：
bash
python -m lifetrace.server自定义提示词: 如果您想修改不同功能的 AI 提示词，可以编辑
lifetrace/config/prompt.yaml文件。
后端服务会自动从 8001 端口开始查找可用端口，实际端口会在控制台显示。
启动前端服务
前端是使用 FreeTodo 的必需组件。启动前端开发服务器：
bash
cd free-todo-frontend
pnpm install
pnpm dev前端开发服务器会自动从 3001 端口开始查找可用端口，并自动检测后端端口。
开始使用
两个服务启动后，在浏览器中访问控制台显示的前端地址（通常为 http://localhost:3001）开始使用 FreeTodo！🎉
核心功能使用
🤖 AI 智能助手
智能任务拆分
FreeTodo 的 AI 可以自动将复杂任务分解为可管理的子任务：
- 创建复杂任务 - 输入一个高级任务，如"规划一次旅行"
- AI 问卷流程 - AI 会通过引导式问题帮助您更好地理解任务
- 自动分解 - 根据您的回答，AI 创建结构化的子任务列表
- 审查和调整 - 您可以审查、编辑或添加更多子任务
智能任务提取
与 AI 助手聊天时，您可以从对话中提取可执行的待办：
- 与 AI 聊天 - 就您的目标或计划进行对话
- 提取待办 - 点击从 AI 的响应中提取可执行项
- 自动创建任务 - 提取的项目会自动添加到您的待办列表
上下文感知建议
AI 根据您当前的待办上下文提供任务建议：
- 相关任务 - 建议与您当前工作相关的任务
- 下一步 - 推荐逻辑上的下一步行动
- 优先级指导 - 根据截止日期和重要性帮助优先处理任务
✅ 任务管理
创建待办
快速创建：
- 点击 "+" 按钮或使用键盘快捷键
- 输入任务标题并按 Enter
详细创建：
- 点击"添加待办"并填写：
- 标题（必填）
- 描述/备注
- 优先级（紧急/高/中/低）
- 截止日期
- 标签
- 父任务（用于层级结构）
层级任务
FreeTodo 支持无限任务嵌套：
- 父任务 - 高级目标或项目
- 子任务 - 属于父任务的子任务
- 嵌套结构 - 创建多级任务层次结构
示例：
📋 发布新产品 (父任务)
├── 📝 设计 UI 原型 (子任务)
├── 💻 开发后端 API (子任务)
│ ├── 设置数据库 (孙任务)
│ └── 实现身份验证 (孙任务)
└── 📧 准备营销材料 (子任务)优先级与状态管理
优先级级别：
- 🔴 紧急 - 必须立即完成
- 🟠 高 - 重要，应该尽快完成
- 🟡 中 - 正常优先级
- 🟢 低 - 可以稍后完成
状态：
- 📋 待办 - 未开始
- 🚧 进行中 - 正在处理
- ✅ 已完成 - 已完成
- ⏸️ 已暂停 - 暂时停止
- ❌ 已取消 - 不再需要
标签与分类
使用自定义标签组织您的待办：
- 创建标签 - 在创建或编辑待办时添加标签
- 按标签筛选 - 使用标签筛选器查看特定组的任务
- 标签管理 - 在设置中管理您的标签列表
截止日期管理
- 设置截止日期 - 为任务添加到期日期
- 可视化提醒 - 截止日期在日历中高亮显示
- 逾期提醒 - 收到逾期任务的通知
📅 日历视图
日/周/月视图
在不同日历视图之间切换：
- 日视图 - 查看特定日期的所有计划任务
- 周视图 - 一周的日程概览
- 月视图 - 带有任务指示器的月历
拖拽排期
轻松安排您的待办：
- 查看日历 - 打开日历面板
- 拖拽待办 - 从列表中将待办拖到日历时间槽
- 自动排期 - 待办会自动安排到该时间
快速创建待办
直接从日历创建待办：
- 点击时间槽 - 点击日历中的空时间槽
- 快速创建 - 打开对话框创建新待办
- 自动排期 - 待办会自动安排到该时间
🎨 界面自定义
多面板布局
FreeTodo 具有灵活的多面板布局：
- 待办列表面板 - 查看和管理您的待办
- 聊天面板 - 与 AI 助手交互
- 详情面板 - 查看和编辑待办详情
- 日历面板 - 安排和可视化任务
自定义布局：
- 通过拖拽边框调整面板大小
- 根据需要显示/隐藏面板
- 保存您偏好的布局
主题
切换主题：
- 浅色主题 - 干净、明亮的界面
- 深色主题 - 适合低光环境的护眼界面
- 多种配色方案 - 从各种颜色选项中选择
国际化
FreeTodo 支持多种语言：
- English - 默认语言
- 中文 - 完整的中文支持
- 在设置中切换语言
项目结构
了解项目结构有助于定制和开发：
FreeTodo/
├── .github/ # GitHub 仓库资源
│ ├── assets/ # 静态资源（README 图片）
│ ├── BACKEND_GUIDELINES.md # 后端开发规范
│ ├── FRONTEND_GUIDELINES.md # 前端开发规范
│ ├── CONTRIBUTING.md # 贡献指南
│ └── ... # 其他 GitHub 仓库文件
├── lifetrace/ # 后端模块 (FastAPI)
│ ├── server.py # Web API 服务入口
│ ├── config/ # 配置文件
│ │ ├── config.yaml # 主配置文件（自动生成）
│ │ ├── default_config.yaml # 默认配置模板
│ │ ├── prompt.yaml # AI 提示词模板
│ │ └── rapidocr_config.yaml# OCR 配置
│ ├── routers/ # API 路由处理器
│ │ ├── chat.py # 聊天接口端点
│ │ ├── todo.py # 待办事项端点
│ │ ├── task.py # 任务管理端点
│ │ └── ... # 其他端点
│ ├── schemas/ # Pydantic 数据模型
│ ├── services/ # 业务逻辑服务层
│ ├── repositories/ # 数据访问层
│ ├── storage/ # 数据存储层
│ ├── llm/ # LLM 和 AI 服务
│ ├── jobs/ # 后台任务
│ ├── util/ # 工具函数
│ └── data/ # 运行时数据（自动生成）
│ ├── lifetrace.db # SQLite 数据库
│ ├── vector_db/ # 向量数据库存储
│ └── logs/ # 应用日志
├── free-todo-frontend/ # 前端应用 (Next.js) ⭐
│ ├── app/ # Next.js 应用目录
│ ├── apps/ # 功能模块
│ │ ├── todo-list/ # 待办列表模块
│ │ ├── todo-detail/ # 待办详情模块
│ │ ├── chat/ # AI 聊天模块
│ │ ├── calendar/ # 日历模块
│ │ ├── settings/ # 设置模块
│ │ └── ... # 其他模块
│ ├── components/ # React 组件
│ ├── lib/ # 工具和服务
│ ├── electron/ # Electron 桌面应用
│ ├── package.json # 前端依赖
│ └── README.md # 前端文档
├── pyproject.toml # Python 项目配置
├── uv.lock # uv 锁定文件
├── LICENSE # FreeU Community License
├── README.md # 英文 README
└── README_CN.md # 中文 README（本文件）最佳实践
1. 任务组织
- 对复杂项目使用层级结构
- 一致地应用标签以便筛选
- 设置现实的截止日期和优先级
2. AI 助手使用
- 对大型、复杂的项目使用 AI 任务拆分
- 从对话中提取待办以快速捕获想法
- 审查 AI 建议并根据需要进行调整
3. 日历管理
- 提前安排重要任务
- 使用拖拽进行快速重新排期
- 定期审查您的日程安排
4. 生产力技巧
- 将大任务分解为更小、可执行的项
- 使用优先级级别专注于最重要的事情
- 定期审查和更新任务状态