核心用法
gws-keep 是一个命令行工具，用于管理 Google Keep 笔记。它通过 gws keep <resource> <method> [flags] 的语法结构提供对 Keep API 的访问能力。
支持的资源操作：
- notes: 创建(
create)、删除(delete)、获取(get)、列表(list)、权限管理(permissions) - media: 下载附件(
download)
关键特性：
- 分页列表支持（通过
page_token和page_size控制） - 支持
gws schema命令自动发现 API 参数结构 - 灵活的
--params和--json参数传递方式
显著优点：
- 纯命令行操作，适合脚本化和自动化工作流
- 与
gws生态集成，共享认证和全局配置 - 支持附件媒体下载（需注意
alt=media参数要求）
潜在缺点与局限性：
- 需要前置阅读
gws-shared/SKILL.md了解认证流程 - 删除操作不可逆，且会立即移除协作者访问权限
- 依赖外部二进制
gws，环境配置门槛较高 - 无图形界面，对非技术用户不友好
适合人群：
- 需要自动化 Google Keep 操作的开发者
- 习惯命令行工作流的效率用户
- 需要将笔记管理集成到 CI/CD 或批处理脚本中的团队
常规风险：
- 数据丢失风险: 删除操作永久生效，无回收站机制
- 权限风险: 需
OWNER角色才能删除，但操作本身会剥夺所有协作者访问 - 认证安全: 依赖
gws的认证体系，需确保凭据妥善保管 - API 限制: 分页令牌为不透明值，调试困难；媒体下载需特定 MIME 类型支持