Google Tasks 技能

使用轻量级 Bash 脚本管理所有任务列表中的 Google Tasks。

快速开始

查看任务

bash scripts/get_tasks.sh

创建任务

# 使用默认列表（在 google-tasks-config.sh 中配置）
bash scripts/create_task.sh "任务标题" ["截止日期"] ["备注"]

# 指定列表名称
bash scripts/create_task.sh "列表名称" "任务标题" ["截止日期"] ["备注"]

示例：

# 简单任务（使用默认列表）
bash scripts/create_task.sh "购买杂货"

# 带截止日期的任务（使用默认列表）
bash scripts/create_task.sh "完成报告" "2026-02-10"

# 指定列表的任务
bash scripts/create_task.sh "Work" "完成报告" "2026-02-10"

# 指定列表、截止日期和备注的任务
bash scripts/create_task.sh "Personal" "给妈妈打电话" "2026-02-05" "询问她的健康状况"

默认列表配置：
编辑 google-tasks-config.sh 设置您的默认列表：

DEFAULT_LIST="Private"  # 修改为您偏好的默认列表名称

删除任务

bash scripts/delete_task.sh "列表名称" <任务编号或标题>

示例：

# 按任务编号删除（按列表中位置计数）
bash scripts/delete_task.sh "Work" 2

# 按任务标题删除
bash scripts/delete_task.sh "Inbox" "购买杂货"

依赖要求

• jq — JSON 处理器（通常已预装）
• curl — HTTP 客户端（通常已预装）
• 有效的 token.json 文件（含 OAuth 访问令牌）
• 必需的权限范围（Scopes）： https://www.googleapis.com/auth/tasks（读写权限）

首次设置

若 token.json 文件不存在：

1. 用户需准备 OAuth 凭据（credentials.json）— 详见 setup.md
2. 首先运行 Node.js 认证流程，生成 token.json
3. 之后即可使用 Bash 脚本执行所有后续调用

输出格式

📋 您的 Google Tasks:

📌 列表名称
──────────────────────────────────────────────────
  1. ⬜ 任务标题 (截止日期: YYYY-MM-DD)
     备注: 若存在则显示任务备注
  2. ⬜ 另一个任务

📌 另一个列表
──────────────────────────────────────────────────
  (无任务)

文件位置

• token.json — 访问令牌与刷新令牌（工作区根目录）
• google-tasks-config.sh — 配置文件（用于设置默认列表）
• scripts/get_tasks.sh — 查看任务的 Bash 脚本
• scripts/create_task.sh — 创建任务的 Bash 脚本
• scripts/delete_task.sh — 删除任务的 Bash 脚本
• references/setup.md — 详细设置指南

实现原理

该 Bash 脚本使用：

• 直接调用 Google Tasks REST API
• curl 发起 HTTP 请求
• jq 解析 JSON 响应
• 从 token.json 中读取 Bearer Token 进行身份认证

无需任何 Python 依赖项。

故障排查

令牌已过期：

Error: Invalid credentials

删除 token.json 并重新完成身份认证。

缺少 jq：

bash: jq: command not found

安装 jq：apt-get install jq 或 brew install jq

更多详情请参阅 setup.md。