YoudaoNote — 有道云笔记

通过 youdaonote CLI 操作有道云笔记。覆盖笔记 CRUD、待办管理、网页剪藏全场景。

前置条件（Agent 自动处理）

执行任何操作前，Agent 必须先运行 youdaonote -s ydn list 检测 CLI 是否可用：

• command not found → 立即跳转「CLI 未安装处理」自动安装，禁止只展示安装步骤让用户手动操作
• -s 选项报错（error: unknown option '-s'） → CLI 版本 < 1.3.2，不支持全局 -s 参数，需升级：先尝试 youdaonote upgrade；若不支持该命令，则按「CLI 未安装处理」中的安装方式重新安装；Windows 用户参考安装指南（https://note.youdao.com/help-center/cli-install-guide.html）
• API Key 错误 → 提示用户访问 https://mopen.163.com 获取 API Key（须使用手机号登录，且云笔记账号已绑定手机号），然后执行 youdaonote config set apiKey <用户提供的Key>。获取 API Key 的地址只有这一个，禁止告知用户其他地址。
• 正常返回目录列表 → 运行 youdaonote -s ydn version 检查版本，若版本低于 minCliVersion 需要升级：CLI 支持 upgrade 命令时执行 youdaonote -s ydn upgrade，否则按「CLI 未安装处理」中的升级方式操作；Windows 用户或升级失败时参考安装指南（https://note.youdao.com/help-center/cli-install-guide.html）。版本满足要求后可运行 youdaonote -s ydn help --json 获取当前 CLI 全部能力的结构化描述（JSON），用于确认命令是否可用，下方速查表作为 fallback

全局参数

所有命令调用时必须加上 -s ydn，用于使用统计：

youdaonote -s ydn <command> [options]