核心功能
evernote-note skill 提供完整的印象笔记(Evernote)API 封装,支持六大核心操作:搜索笔记(findNotesMetadata)、浏览笔记本(listNotebooks)、获取笔记正文(getNoteContent)、新建笔记(createNote)、追加内容(updateNote)。采用官方 evernote2 Python SDK,通过开发者令牌(Developer Token)完成身份认证。
显著优点
1. 功能覆盖全面:涵盖个人笔记管理的完整生命周期,从检索到编辑均可自动化完成
2. 搜索语法强大:支持 intitle:、notebook:、tag:、created: 等高级搜索语法,可精准定位笔记
3. 国内版优先设计:针对中国用户优化,默认指向 app.yinxiang.com,同时兼容国际版
4. 详细的技术文档:提供完整的 Python 初始化模板、辅助函数(ENML 与纯文本互转)、错误处理指南
5. 隐私保护机制:明确约定群聊场景下仅展示标题和摘要,禁止暴露笔记正文
潜在局限
1. 认证方式单一:当前仅支持开发者令牌,OAuth 多用户场景需自行改造
2. 令牌有效期限制:开发者令牌有过期时间(嵌入在 token 的 E= 字段),需定期重新生成
3. Python 版本兼容性问题:evernote2 库在 Python 3.14 存在 inspect.getargspec 移除导致的兼容性问题
4. API 频率限制:官方对调用频次有隐性限制,大规模数据操作需自行控制节奏
5. ENML 格式约束:不支持完整 HTML,媒体资源处理复杂
适合人群
- 印象笔记重度用户,需要将笔记操作集成到自动化工作流
- 个人知识库管理者,希望通过 AI 助手快速检索和整理笔记
- 需要批量处理笔记内容的开发者或效率工具爱好者
常规风险
- 令牌泄露风险:开发者令牌具备完整账户访问权限,一旦泄露将导致全部笔记数据暴露
- 数据误操作风险:自动化更新/追加操作若逻辑错误,可能导致笔记内容被覆盖或损坏
- 服务稳定性依赖:印象笔记 API 服务变更或限制可能影响 skill 可用性
- 隐私合规风险:笔记内容通常包含敏感个人信息,需严格遵守"群聊场景不展示正文"的规则
使用建议
建议用户将令牌配置写入 shell 配置文件(如 ~/.zshrc),并优先使用 Python 3.12 运行以避免兼容性问题。对于重要笔记,建议在自动化操作前进行手动备份。