ADK 事务管理助手

基于 Google ADK 的 CLI 事务管理助手，使用 DeepSeek 模型，支持自然语言添加、查询事务，并在设定时间通过终端输出提醒。

功能

• 事务管理：添加、查询、更新、删除事务
• 一次性提醒：如「明天 9 点开会」
• 周期性提醒：如「每周一 9 点交周报」「每月 1 号还房贷」
• 无时间提醒：添加时提示补充时间；每日 9 点扫描并提醒未设置时间的任务
• 提醒输出：终端输出

环境要求

• Python 3.10+
• uv（推荐）或 pip

安装

# 使用 uv
uv sync

# 或使用 pip
pip install -e .

配置

在 task_agent/.env 中配置 DeepSeek API：

DEEPSEEK_API_KEY="your-api-key"
DEEPSEEK_BASE_URL="https://api.deepseek.com"

注意：需确保 DeepSeek 账户有足够余额。

运行

uv run adk run task_agent

或使用 pip 安装后：

adk run task_agent

输入 exit 退出。

使用示例

• 添加事务：明天 9 点开会、记一下买牛奶（会提示补充时间）
• 添加周期：每周一 9 点交周报、每月 1 号还房贷
• 查询：我今天有什么事、显示未完成的事务
• 完成：把第 3 个任务标记为完成
• 删除：删除第 2 个任务

项目结构

adk-task-manager/
├── task_agent/
│   ├── __init__.py
│   ├── agent.py
│   ├── storage.py
│   ├── time_parser.py
│   ├── notifier.py
│   ├── scheduler.py
│   └── .env
├── PROJECT.md
├── DEVELOPMENT.md
└── README.md

技术栈

• Google ADK + LiteLLM（DeepSeek）
• uv 包管理
• SQLite 存储
• APScheduler 调度
• 终端提醒输出
• dateparser 时间解析