youdaonote

1# YoudaoNote — 有道云笔记
2 
3通过 `youdaonote` CLI 操作有道云笔记。覆盖笔记 CRUD、待办管理、网页剪藏全场景。
4 
5## 前置条件（Agent 自动处理）
6 
7执行任何操作前，Agent 必须先运行 `youdaonote list` 检测 CLI 是否可用：
8- **`command not found`** → 立即跳转「CLI 未安装处理」自动安装，**禁止只展示安装步骤让用户手动操作**
9- **API Key 错误** → 提示用户访问 **https://mopen.163.com** 获取 API Key（须使用手机号登录，且云笔记账号已绑定手机号），然后执行 `youdaonote config set apiKey <用户提供的Key>`。**获取 API Key 的地址只有这一个，禁止告知用户其他地址。**
10- **正常返回目录列表** → 运行 `youdaonote version`，若版本低于 `1.2.0`，展示升级建议后继续执行；否则可运行 `youdaonote help --json` 获取当前 CLI 全部能力的结构化描述（JSON），用于确认命令是否可用，下方速查表作为 fallback
11 
12## 命令速查
13 
14| 命令 | 用途 | 示例 |
15|------|------|------|
16| `save` | 保存笔记（✅ 推荐，支持 Markdown 富文本） | `youdaonote save --file note.json` |
17| `create` | 创建笔记（⚠️ 仅纯文本，不支持 Markdown 富文本） | `youdaonote create -n "标题" -c "内容" [-f <目录ID>]` |
18| `update` | 更新 Markdown 笔记 | `youdaonote update <fileId> -c "内容"` 或 `--file content.md` |
19| `delete` | 删除笔记 | `youdaonote delete <fileId>` |
20| `rename` | 重命名笔记 | `youdaonote rename <fileId> "新标题"` |
21| `move` | 移动笔记 | `youdaonote move <fileId> <目录ID>` |
22| `search` | 搜索笔记 | `youdaonote search "关键词"` |
23| `list` | 浏览目录 | `youdaonote list -f <目录ID>` |
24| `read` | 读取笔记 | `youdaonote read <fileId>` |
25| `recent` | 最近收藏 | `youdaonote recent -l 20 -c --json` |
26| `clip` | 网页剪藏（服务端） | `youdaonote clip "https://..." [-f <目录ID>] --json` |
27| `clip-save` | 保存外部剪藏 JSON | `youdaonote clip-save --file data.json` |
28| `todo list` | 列出待办 | `youdaonote todo list [--group <分组ID>] --json` |
29…