核心用法
gkeep 是 Google Keep 的非官方 CLI 工具,基于 gkeepapi Python 库构建,提供完整的笔记生命周期管理。首次运行会在 skills/gkeep/.venv 自动创建虚拟环境。
认证流程:gkeep login <email> 使用 Google App Password(非主密码)登录,令牌存储于 ~/.config/gkeep/token.json。
主要功能:
list [--limit N]浏览笔记列表search <keyword>全文搜索get <note_id>读取单条笔记create "标题" "正文"快速创建archive/delete/pin/unpin <note_id>状态管理
显著优点
- 零配置上手:自动处理 Python 依赖与虚拟环境
- 完整 CRUD 覆盖:涵盖 Keep 核心功能(含置顶、归档)
- 轻量高效:纯命令行交互,适合脚本化工作流
- 活跃维护:截至 2026 年 1 月仍有更新
潜在局限
- API 非官方:逆向工程实现,Google 随时可能封锁或变更接口
- 功能边界:不支持标签管理、协作共享、附件上传等高级特性
- 单账户限制:每次登录绑定一个 Google 账户,切换需重新认证
- 无实时同步:拉取操作非即时,存在数据延迟风险
适合人群
- 习惯终端操作的开发者/极客
- 需要快速笔记录入的轻量化用户
- 希望将 Keep 集成到自动化脚本的工作流用户
常规风险
| 风险点 | 说明 |
|--------|------|
| 服务中断 | 非官方 API 可能导致功能突然失效 |
| 令牌泄露 | `token.json` 包含会话凭证,需妥善保护 |
| 数据一致性 | 多端同时编辑可能产生冲突覆盖 |