Google Keep

核心用法

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` 包含会话凭证，需妥善保护 |

| 数据一致性 | 多端同时编辑可能产生冲突覆盖 |

核心用法

gkeep 是一个基于 Python 库 gkeepapi 的命令行工具，让用户无需打开浏览器即可在终端管理 Google Keep 笔记。安装后通过 gkeep login 使用 Google 应用专用密码（App Password）完成认证，支持 2FA 账户。

主要功能覆盖笔记的完整生命周期：

• 查询：list 列出笔记（支持 --limit 限制数量）、search 关键词搜索、get 读取单条内容
• 创建：create "标题" "正文" 快速新建笔记
• 管理：archive 归档、pin/unpin 置顶切换、delete 移至回收站

首次运行会自动在 skills/gkeep/.venv 创建虚拟环境并安装依赖，Token 存储于 ~/.config/gkeep/token.json，权限设置为 600。

显著优点

• 效率导向：纯 CLI 交互，适合开发者/键盘优先用户快速记录想法、待办事项
• 功能完整：覆盖 Keep 核心功能，包括搜索、置顶、归档等高频操作
• 安全认证：支持 2FA + App Password，不暴露主密码；Token 文件权限严格控制
• 轻量部署：依赖隔离在本地 venv，不污染系统 Python 环境

潜在缺点与局限性

• API 非官方：底层 gkeepapi 为逆向工程实现，Google 可随时变更内部 API 导致功能失效
• 来源可信度：Skill 作者 VACInc 及依赖库作者 kiwiz 均为个人开发者（T3），无企业背书
• 凭证存储：Token 以文件形式落盘，虽权限受限但仍存在本地进程读取风险
• 网络不可控：网络通信完全委托给第三方库，无法保证仅访问 Google 端点

适合人群

• 常驻终端的开发者、运维人员
• 需要快速记录碎片信息、排斥 GUI 的键盘党
• 已启用 Google 2FA、能接受非官方 API 风险的技术用户

常规风险

• 服务中断：Google 更新 API 后可能完全不可用，需关注 gkeepapi 项目动态
• 凭证泄露：建议定期轮换 App Password，避免在共享/多用户环境使用
• 隐私边界：笔记内容经第三方库传输，虽为 HTTPS 加密，但信任链包含个人开发者