核心用法
youdaonote 是网易有道官方推出的云笔记命令行工具，实现笔记全生命周期管理与待办协作。核心工作流围绕 save 命令构建——这是唯一支持 Markdown 富文本（标题、代码块、表格等）的创建方式，create 仅保留纯文本会静默丢失格式。
笔记管理：save/update/delete/move/rename 完成 CRUD；search/list/read 实现检索与浏览；recent 调取最近收藏。大内容（>10KB）通过 --file 参数传递规避命令行限制。
待办系统：todo 子命令覆盖创建、完成状态切换、截止日期设置、分组管理（group-create/rename/delete），支持 JSON 结构化输出便于自动化处理。
网页剪藏：clip 命令服务端抓取网页内容，可直接入库或配合 clip-save 处理外部剪藏数据。
前置依赖：执行前必须 list 检测 CLI 可用性，缺失时自动安装（macOS/Linux/WSL 一键脚本，Windows 需手动下载）；API Key 须从 https://mopen.163.com 获取（需手机号登录且云笔记账号绑定手机）。
显著优点
- 官方背书：网易有道原生开发，API 稳定性与数据安全有企业级保障
- 格式完整：
save+contentFormat: md保留 Markdown 全部语义，告别富文本粘贴失真 - 自动化友好：全命令支持
--json输出，易于脚本集成与 CI/CD 衔接 - 跨平台：覆盖 macOS、Linux、WSL，服务端剪藏无需浏览器依赖
潜在缺点
- Windows 体验断层：无一键安装脚本，需手动下载解压配置 PATH
- 认证门槛：API Key 获取流程较长（需手机号+账号绑定），新用户上手成本偏高
- 格式选择陷阱：
create与save能力差异大，误用会导致 Markdown 格式丢失，需严格遵循「有格式必用 save」规则 - 网络依赖：服务端剪藏与云端同步均依赖网易 API 可用性
适合人群
- 有道云笔记重度用户，追求本地编辑器 + 云端同步的 Markdown 工作流
- 开发者/技术写作者，需通过 CLI 批量管理笔记或集成自动化工具链
- 待办驱动型知识工作者，希望笔记与任务系统深度联动
常规风险
- 数据丢失风险：
create误用导致格式剥离，且操作不可逆；delete无二次确认机制 - 密钥泄露：API Key 以明文存储于本地配置，共享环境需额外防护
- 剪藏合规性：服务端抓取需遵守目标站点的 robots.txt 与版权协议
- 版本兼容性：minCliVersion 1.2.0 以下功能受限，需关注升级提示