gkeep

核心用法

gkeep 是一个面向 Google Keep 的命令行封装工具，基于社区维护的 gkeepapi 库实现。用户通过 gkeep login 完成 OAuth 式登录后，即可在终端中执行完整的笔记生命周期管理：使用 list 与 search 快速检索笔记，，create 新建内容，，get 查看详情，，archive//delete//pin//unpin` 进行状态管理。所有操作均通过 HTTPS 直连 Google 官方 API 端点，数据实时同步至云端。

显著优点

1. 效率优先的交互设计：无需打开浏览器或移动端 App，命令行即可完成高频操作，特别适合键盘流用户与自动化脚本集成。
2. 轻量无依赖：纯 Python 实现，无系统命令调用，首次运行自动创建隔离虚拟环境，避免污染系统 Python 环境。
3. 安全凭证管理：采用 Google App Password 机制（强制 2FA），令牌以 0o600 权限存储于用户目录，密码输入使用 getpass 防窥视。
4. 活跃维护状态：截至 2026 年 1 月仍有更新，依赖库 gkeepapi 为社区知名项目，有持续的问题修复记录。

潜在缺点与局限性

1. 非官方 API 的固有风险：gkeepapi 通过逆向工程实现，Google 随时可能调整内部接口导致功能失效，存在服务中断的不可控因素。
2. 功能覆盖有限：仅支持基础文本笔记操作，不支持图片附件、语音笔记、协作共享、标签颜色等高级特性。
3. 单账户绑定：每次登录仅关联一个 Google 账户，多账户切换需重新执行登录流程。
4. 网络依赖严格：所有操作实时联网，无本地离线缓存机制，弱网环境下体验受限。

适合的目标群体

• 开发者与运维人员：习惯终端工作流，需要将笔记管理集成到 Shell 脚本或开发工具链中
• 效率工具爱好者：追求最小上下文切换，希望用命令行替代 GUI 操作的重度键盘用户
• 自动化场景需求者：需要通过 cron 或 CI/CD 流水线自动创建、归档笔记的自动化场景

使用风险

• API 变更风险：Google 对非官方客户端无兼容性承诺，建议关注上游 gkeepapi 更新动态
• 令牌泄露风险：~/.config/gkeep/token.json 包含长期有效凭证，需确保该文件不被其他进程或用户读取
• 性能瓶颈：大量笔记列表时未实现分页懒加载，，--limit 仅为展示截断，全量数据仍从 API 拉取
• 环境隔离依赖：虚拟环境位于 skills/gkeep/.venv，若手动删除需重新触发 bootstrap 流程