核心用法
Google Keep Skill 采用 nodriver 库驱动真实 Chrome 浏览器，绕过传统自动化检测机制，实现与 Google Keep 的完整交互。用户需先执行一次性登录命令保存会话，后续所有操作（创建、读取、更新、删除、归档笔记）均通过终端命令完成。
关键命令：
login— 手动登录并持久化会话list/read— 检索笔记，支持过滤和数量限制create/create-list— 创建文本笔记或清单update— 完全替换笔记内容（⚠️ 不支持增量编辑清单项）delete/archive— 移至回收站或归档
所有命令返回结构化 JSON，代理需解析为 Markdown 呈现给用户，而非直接暴露原始数据。
显著优点
1. 无 API 密钥依赖：直接操作网页版 Google Keep，规避官方 API 的限制与配额问题
2. 反检测能力强：基于真实 Chrome 实例，nodriver 技术栈较 Selenium/Puppeteer 更难被识别为自动化工具
3. 会话持久化：一次登录后长期复用，用户体验接近原生应用
4. 双模式笔记支持：同时处理纯文本笔记和可勾选清单
5. 可视化调试选项：--visible 参数允许用户实时观察操作过程
潜在缺点与局限性
- 手动初始化门槛：首次必须人工介入完成 Google 账号登录
- 无增量编辑能力：更新清单笔记时需先读取完整内容、在上下文中重构、再整体回写，增加代理复杂度
- 浏览器依赖：强制要求系统预装 Google Chrome，Linux 需额外安装步骤
- 环境锁定：依赖
uv包管理器，对非 Python 3.11+ 环境不兼容 - 无官方保障：通过非官方渠道操作 Google 服务，存在服务条款风险
- 会话失效处理：Token 过期时需用户手动重新执行
login，无法自动恢复
适合人群
- 需要批量管理 Google Keep 数据的高级用户
- 希望绕过 API 限制、直接操作网页版的自动化场景
- 已熟悉终端命令和 Python 环境的开发者/技术用户
- 对隐私敏感、不愿开放 Google Cloud API 权限的个人用户
常规风险
| 风险类别 | 说明 |
|---------|------|
| 账号安全 | 会话文件存储于本地 `config/` 目录，若设备共享或泄露可能导致 Google 账号被冒用 |
| 服务可用性 | Google 可随时更新 Keep 前端结构导致脚本失效，属于非官方集成的固有脆弱性 |
| 数据一致性 | `update` 操作无事务保护，并发修改可能导致数据覆盖丢失 |
| 合规风险 | 违反 Google 服务条款中关于自动化工具的规定，极端情况下可能导致账号限制 |
| 依赖链安全 | `nodriver` 及 Chrome 版本兼容性可能引入未预期的崩溃或行为变更 |