Google Keep

概述

gkeep 是基于 Python gkeepapi 库的 Google Keep 非官方命令行工具，让用户无需打开浏览器即可在终端管理云端笔记。项目活跃维护（2026年1月仍有更新），适合开发者和工作流自动化场景。

核心用法

| 功能 | 命令示例 |

|------|---------|

| 登录 | `gkeep login your.email@gmail.com` |

| 列出笔记 | `gkeep list --limit 10` |

| 搜索 | `gkeep search "关键词"` |

| 读取单条 | `gkeep get <note_id>` |

| 创建笔记 | `gkeep create "标题" "正文内容"` |

| 归档/删除 | `gkeep archive <id>` / `gkeep delete <id>` |

显著优点

• 终端原生体验：适合 Vim/Emacs 用户及键盘驱动工作流
• 轻量快速：无需加载完整 Keep Web 应用
• 可脚本化：支持 Shell 管道和自动化任务集成
• 活跃维护：近期持续更新，问题响应及时

局限性与风险

• 非官方 API：基于逆向工程，Google 随时可能封禁或变更接口
• 稳定性隐患：API 变动可能导致功能突然失效
• 凭据管理：Token 明文存储于 ~/.config/gkeep/token.json
• 功能覆盖不全：不支持高级特性如协作、标签颜色、附件预览

适合人群

• 终端重度用户、开发者、运维工程师
• 需要笔记自动化（如日志归档、任务生成）的场景
• 追求极简工具、拒绝浏览器 tab 的技术用户

安全建议

⚠️ 必须使用 Google 应用专用密码，禁止直接使用主密码。建议定期检查 Token 文件权限（chmod 600），并在可疑活动时立即 revoke 应用密码。

核心功能与用法

gkeep 是一个基于非官方 API（gkeepapi）的 Google Keep 命令行工具包装器，让用户无需打开浏览器或手机应用即可通过终端管理云端笔记。

核心用法

• 登录配置：首次使用需执行 gkeep login your.email@gmail.com，必须使用 Google App Password（非主密码），且需开启 2FA
• 笔记管理：支持列出（list --limit）、搜索（search）、获取详情（get）、创建（create）、归档（archive）及删除（delete）
• 本地存储：认证 Token 保存在 ~/.config/gkeep/token.json，不依赖浏览器会话

显著优点

1. 效率提升：纯 CLI 操作，适合键盘优先用户和自动化脚本场景
2. 轻量依赖：仅依赖单个 Python 包（gkeepapi），无重量级浏览器或 GUI 组件
3. 开源可信：基于 kiwiz/gkeepapi（GitHub 活跃维护，MIT 许可），社区可审计
4. 数据本地化：Token 本地存储，无第三方服务端中转

潜在缺点与局限性

• API 稳定性风险：gkeepapi 为逆向工程实现的非官方 API，Google 随时可能调整内部接口导致功能失效
• 功能边界：不支持 Keep 全部特性（如绘图、语音转文字、协作共享等）
• 账户安全门槛：强制要求 2FA + App Password，对普通用户配置有一定复杂度
• 无离线支持：完全依赖 Google 云端服务，无本地缓存机制

适合人群

• 开发者、系统管理员等命令行重度用户
• 需要快速记录或检索笔记而不愿切换上下文的效率追求者
• 希望将 Keep 集成到自动化工作流（如配合 cron、shell 脚本）的用户
• 不适合：依赖 Keep 富媒体功能、或无法接受非官方 API 风险的场景

常规风险

| 风险类型 | 说明 | 缓解建议 |

|---------|------|---------|

| API 失效 | Google 变更内部 API 导致工具不可用 | 关注 GitHub 仓库更新，准备替代方案 |

| Token 泄露 | 本地 `token.json` 被恶意程序读取 | 设置文件权限 600，定期轮换 App Password |

| 数据一致性 | 非官方 API 可能导致同步延迟或冲突 | 关键笔记保留 Google 官方客户端二次确认 |

| 账户安全 | App Password 管理不当 | 仅用于 Keep 专用，发现异常立即撤销 |

综合评价

该 Skill 是命令行用户的实用工具，A 级安全评分（82分）表明代码本身无恶意，但核心风险来自外部依赖的非官方 API 稳定性。适合作为辅助工具，不建议用于关键业务数据的唯一管理渠道。