Google Keep

核心功能

gkeep 是一个围绕 gkeepapi 构建的命令行工具，通过反向工程 Google Keep 的内部 API，让用户无需打开浏览器即可在终端完成笔记管理。支持列出、搜索、创建、归档、删除、置顶/取消置顶等完整 CRUD 操作，并可通过 ID 精准定位单条笔记。

显著优点

• 高效工作流：纯 CLI 交互，适合键盘驱动的开发者快速记录灵感或待办事项
• 完整功能覆盖：涵盖 Keep 核心功能，包括 pin/unpin 等细节操作
• 便捷认证：采用 Google App Password 机制，避免直接存储主密码，兼顾 2FA 兼容性
• 自动环境管理：首次运行自动创建本地 venv，降低 Python 依赖维护成本

潜在局限与风险

• API 稳定性：依赖非官方逆向工程接口，Google 随时可能更改内部协议导致工具失效
• 安全合规灰色地带：违反 Google 服务条款的可能性，存在账号受限风险
• Token 本地存储：认证令牌以明文 JSON 形式存放于 ~/.config/gkeep/token.json，需防范本地权限泄露
• 功能边界：不支持图片、协作、标签管理等 Keep 高级特性

适用人群

终端重度用户、需要脚本化笔记管理的开发者、追求极简工作流的效率爱好者。

常规风险

非官方 API 的可持续性无法保证；建议避免存储敏感信息，定期备份关键笔记至其他平台。

核心用法

gkeep 是一个基于 gkeepapi 的 Google Keep CLI 包装器，允许用户在终端中管理 Google Keep 笔记。首次使用需执行 gkeep login your.email@gmail.com 完成认证，系统会在 ~/.config/gkeep/token.json 存储加密 Token。

主要功能包括：

• 笔记管理：create 创建笔记、get 查看详情、archive 归档、delete 移至回收站
• 笔记属性：pin/unpin 固定/取消固定笔记
• 搜索功能：search 支持关键词检索，list 可配合 --limit 限制返回数量

显著优点

1. 便捷性：无需打开浏览器或手机 App，终端即可完成笔记管理
2. 认证安全：强制使用 Google App Password（非主密码），支持 2FA，Token 本地以 0o600 权限存储
3. 代码简洁：仅 385 行代码，无危险函数调用，依赖单一且可控
4. 隐私友好：符合 GDPR 数据最小化原则，不收集系统信息

潜在缺点与局限性

1. API 稳定性风险：gkeepapi 为社区逆向工程的非官方 API，Google 随时可能更改内部接口导致功能失效
2. 功能受限：仅支持基础 CRUD 操作，无法处理图片、语音、协作等高级功能
3. 依赖单一维护者：gkeepapi 非 Google 官方维护，长期可持续性存疑
4. 无离线支持：所有操作需实时连接 Google 服务器

适合人群

• 终端重度用户，习惯命令行工作流
• 需要快速记录或检索笔记的开发者
• 对 Google 生态有依赖但希望减少 GUI 切换的用户
• 能接受非官方 API 潜在风险的技术用户

常规风险

• 服务中断：非官方 API 可能随时失效
• 数据同步冲突：多客户端同时操作可能产生版本冲突
• Token 泄露：虽然文件权限严格，但共享环境仍需注意主目录保护