SuperAPI AI 工具集

evernote-debug-bundle

测试与质量

查看项目

更新于 10-16 09:57

技能介绍

用途:该技能用于调试 Evernote API 集成问题,适合排查 API 调用失败、检查请求与响应、诊断 ENML 内容及令牌状态。

主要能力:

  1. 调试日志器:记录 API 方法名、参数(含令牌脱敏)、响应耗时和错误详情,同时输出到控制台与文件,便于事后分析。
  2. 插桩客户端包装:通过 Proxy 包装 NoteStore,自动记录每次 API 调用、测量响应时间并捕获错误,为现有集成增加零配置调试。
  3. ENML 校验器:按 DTD 规则检查 XML 声明、DOCTYPE、<en-note> 根节点、禁用元素和未闭合标签,可选自动修复常见问题(补充缺失头部、闭合标签、剥离禁用元素)。
  4. 令牌检查器:调用 userStore.getUser() 验证令牌,报告所属用户、过期时间(edam_expires)、账户类型和剩余上传配额。
  5. 诊断 CLI:提供 diagnose(运行全部检查)、validate-enml <file>、inspect-token、test-api 等命令。

使用方式:需已安装 Evernote SDK 和 Node.js 环境。可先创建调试日志器,再用 Proxy 包装 NoteStore 记录调用;对笔记内容运行 ENML 校验;用令牌检查器确认凭证有效;通过 CLI 执行诊断与连通性测试。日志写入 evernote-debug.log。

常见问题排查:认证失败时运行 inspect-token 检查过期并重新认证;ENML 报错时运行 validate-enml 校验后自动或手动修复;触发限流时查看日志中的请求频率并增加调用间隔;数据缺失时检查响应日志并核对 API 参数(如 withContent 标志)。

限制:资料未提供具体价格、平台支持范围及安装命令,需以 Evernote 官方 SDK 与 API 文档为准。