核心功能
gws-keep 是一款面向命令行用户的 Google Keep 笔记管理工具，作为 Google Workspace CLI (gws) 的扩展技能，提供完整的笔记生命周期管理功能：
- 笔记管理：支持创建、获取、删除笔记，需具备
OWNER角色才能执行删除操作 - 批量操作：通过
list方法分页获取笔记列表，支持page_size和page_token参数控制 - 附件处理：提供
media.download方法下载笔记附件，支持通过alt=media参数指定 MIME 类型 - 权限控制：内置
permissions子资源用于协作者权限管理
显著优势
1. 开发者友好：完全基于 CLI 设计，适合自动化脚本和 CI/CD 流水线集成
2. API 原生映射：命令结构直接对应 Google Keep REST API，降低学习成本
3. 强类型辅助：gws schema 工具可预检参数类型和必填项，减少运行时错误
4. Workspace 生态整合：与 gws 认证体系打通，统一管理 Google 服务凭证
主要局限
- 删除不可逆：笔记删除立即生效且无法恢复，协作者同步失去访问权限
- 附件兼容性：下载时若请求不支持的 MIME 类型将返回 400 错误
- 无图形界面：纯命令行交互，非技术用户上手门槛较高
- 分页依赖令牌：列表翻页需手动传递
next_page_token，自动化处理需额外编码
适用人群
- 需要批量管理 Google Keep 的开发者/系统管理员
- 构建个人笔记自动化工作流的技术用户
- 将 Keep 数据集成至自有系统的企业 IT 团队
安全风险提示
| 风险项 | 说明 |
|--------|------|
| 权限扩散 | `OWNER` 角色可删除笔记，建议最小权限分配 |
| 数据永久丢失 | 删除操作无回收站机制，建议操作前备份 |
| 凭证管理 | 依赖 `gws` 全局认证配置，需遵守其安全规则（见 `../gws-shared/SKILL.md`）|
> 认证依赖：使用前必须配置 gws 认证，运行 gws generate-skills 初始化共享配置。