用途:管理用户的 Google Tasks,包括任务清单(tasklists)与任务(tasks)的查看、创建、更新、完成、移动和删除。所有操作通过 hatch_gws_cli tasks <resource> <method> 执行,资源为 tasklists 和 tasks,因此任务命令会两次出现 tasks,例如 hatch_gws_cli tasks tasks list。参数放在 --params JSON 对象中,创建和编辑另加 --json 请求体。可用 hatch_gws_cli tasks <resource> --help 查看命令参数,用 hatch_gws_cli schema tasks.tasks.insert 等查看方法的 --params/--json 结构。
主要能力:列出清单(hatch_gws_cli tasks tasklists list);列出某清单的未完成任务(--params '{"tasklist":"@default","showCompleted":false}',含已完成需设 showCompleted 与 showHidden 为 true);按到期时间窗口筛选(dueMin、dueMax,RFC3339);获取单个任务详情;新增任务(仅 title 必填,可加 notes 和 due);标记完成或重新打开(patch status 为 completed 或 needsAction);编辑或改期;移动、嵌套为子任务或排序(tasks move,可省略 parent 或 previous);管理清单(tasklists insert/patch/delete);删除单个任务或隐藏已完成任务(tasks clear,不删除)。
使用方式:首次需连接,运行 hatch_gws_cli tasks status,若未连接则把返回的 connect_url 以链接形式发给用户等待点击;断开用 hatch_gws_cli tasks disconnect 并发送 disconnect_url。认证失败或未连接时重跑 status 并跟随链接;status 不可用则说明该设备不支持。默认清单为 @default,用户指定清单时先用 tasklists list 解析其 ID。读取得到的 tasklist ID 与 task ID 应原样用于后续写入,不要回退到 @default,也不要编造或改写 ID。
限制:任务的 due 是仅含日期的 RFC3339 时间戳(如 2026-04-16T00:00:00Z),Google Tasks 只使用日期,没有具体时间,也不发送提醒或通知;如需定时提醒可建议改用 Google Calendar。任务属于所连接账号个人所有,不支持共享清单、指派他人或附件。回复用户时只用自然语言,不要暴露命令、参数、状态词、ID、API 字段或原始 JSON,也不要输出令牌或凭据。