核心用法
evernote-note 是印象笔记（Evernote）的官方API封装技能，提供完整的笔记生命周期管理能力。主要分为两大引擎：
- Engine A（EDAM Python SDK）：覆盖95%场景，包括笔记搜索、笔记本浏览、内容读取、新建笔记、追加编辑等核心功能
- Engine B（RESTful API）：v2.0新增的网页剪藏功能，需单独OAuth Token
典型工作流：
1. 搜索笔记：通过findNotesMetadata()配合丰富搜索语法（intitle、notebook、tag、日期范围等）
2. 读取内容：获取笔记GUID后调用getNoteContent()，支持ENML到纯文本转换
3. 创建/编辑：新建笔记需转换为ENML格式；追加内容需先获取再更新
4. 网页剪藏：curl直接调用clipper-gateway/clipAndSaveNote接口，将任意URL正文抓取保存
显著优点
- 功能完整：覆盖CRUD全操作，支持复杂搜索语法和分页
- 官方背书：基于印象笔记官方SDK和API，数据可靠性高
- 剪藏能力：v2.0新增RESTful剪藏通道，填补EDAM SDK功能空白
- 隐私友好：群聊场景自动脱敏，仅展示标题摘要
潜在局限
- 双Token架构：剪藏功能需单独申请
YX_AUTH_TOKEN，与主Token不通用，配置门槛较高 - Python版本限制：
evernote2库依赖已废弃的inspect.getargspec，Python 3.14需降级至3.12或打补丁 - 频率限制：API有调用配额，建议单次搜索不超过50条
- ENML格式限制：不支持完整HTML，媒体资源需单独处理
- Token过期：开发者令牌有有效期，需定期在后台重新生成
适合人群
- 重度印象笔记用户，需要自动化笔记管理
- 知识工作者，有网页剪藏和资料归档需求
- 开发者/极客，能接受环境变量配置和Token维护
常规风险
| 风险项 | 说明 | 缓解措施 |
|--------|------|---------|
| Token泄露 | 开发者令牌可完全访问账户 | 勿提交至代码仓库，使用环境变量隔离 |
| 数据冲突 | 并发编辑可能导致覆盖 | 更新前重新获取最新版本 |
| 服务切换 | 国内版与国际版Host不通用 | 确认账户所属服务，通常选`app.yinxiang.com` |
| 剪藏失败 | 部分网站反爬或动态渲染 | 检查`status.code`反馈，非8200即为失败 |
配置建议
个人用户推荐开发者令牌方案，5分钟完成配置；仅需基础笔记管理则无需申请剪藏专用的OAuth Token。