核心功能
gws-tasks 是 Google Tasks API 的命令行封装工具，提供完整的任务管理能力。支持两大资源类型：tasklists（任务列表） 和 tasks（任务），涵盖创建、读取、更新、删除、移动等 CRUD 操作。
主要能力
- 任务列表管理：最多支持 2000 个列表，支持增删改查和局部更新（patch）
- 任务操作：单列表最多 20,000 个非隐藏任务，总计上限 100,000 个任务
- 任务组织：支持子任务（最多 2,000 个层级任务）和任务位置移动
- 批量清理：一键清除已完成任务（标记为隐藏）
- 跨平台协作：与 Google Docs、Chat Spaces 的任务指派联动（删除会同步清理两端）
显著优点
1. 官方 API 封装：直接对接 Google Tasks REST API，数据同步可靠
2. 脚本化友好：CLI 设计适合自动化工作流和 CI/CD 集成
3. 资源发现机制：gws schema 命令可自省 API 参数，降低使用门槛
4. Patch 语义支持：patch 方法允许增量更新，避免完整替换
潜在局限
1. 依赖 gws 二进制：必须先安装 gws CLI 工具链
2. OAuth 认证门槛：需前置配置 Google Workspace 认证（见 gws-shared）
3. 指派任务限制：从 Docs/Chat 指派的任务无法通过 API 直接创建，只能删除
4. 隐藏任务陷阱：clear 和 list 的默认行为可能让用户误判数据存在性
适合人群
- 开发者构建自动化任务管理脚本
- 团队管理员批量同步/迁移任务数据
- 高级用户偏好终端工作流而非 GUI
常规风险提示
- 误删级联效应：删除含指派任务的列表会同步清理 Docs/Chat 中的原始任务
- 配额意识：注意 100,000 任务总量上限，大规模应用需分页策略
- 认证凭证管理：遵循 gws-shared 的安全规则，避免凭证泄露