核心用法
有道云笔记 Skill 通过 youdaonote CLI 提供全功能云端笔记管理能力，覆盖笔记CRUD、Markdown富文本处理、待办清单、网页剪藏四大场景。
笔记管理是核心能力。save 命令支持 Markdown 格式完整保留（需指定 contentFormat: "md"），是创建富文本笔记的唯一推荐方式；create 命令仅支持纯文本，会静默丢弃所有格式，已被明确禁用处理 Markdown 内容。read 命令返回笔记原始格式标识（md/note/txt）及内容状态，便于二次编辑。大内容（>10KB）通过 --file 参数传递，规避命令行长度限制。
待办系统完整支持分组管理（todo groups/group-create/group-rename/group-delete）与条目操作（list/create/update/delete），支持截止日期设置与完成状态切换，可构建轻量级任务管理工作流。
网页剪藏提供服务端渲染方案（clip 命令），可将任意 URL 转换为结构化笔记存入指定目录，配合 recent 命令实现收藏回溯。
显著优点
1. 官方原生支持：网易有道出品，API 稳定性与长期维护有保障，非第三方逆向方案
2. Markdown 原生支持：save 命令完整保留 Markdown 语法，适合技术写作与代码片段管理
3. 待办系统完整：分组+条目双层结构，支持截止日期，可作为轻量级 GTD 工具
4. 服务端剪藏：无需本地浏览器依赖，服务器环境亦可执行网页归档
5. 结构化输出：全命令支持 --json 输出，便于与自动化脚本、CI/CD 流程集成
潜在缺点与局限性
1. 安装门槛：需用户手动执行安装脚本并配置 API Key，无法一键即用
2. API Key 获取繁琐：须访问独立站点（mopen.163.com），强制手机号登录且需绑定云笔记账号
3. 版本敏感：低于 1.2.0 的版本可能缺失部分能力，需主动检查升级
4. Windows 兼容性：需区分 x64/x64-baseline/ARM64 三种包，旧 CPU 可能闪退（退出码 0xC000001D）
5. 格式选择强制中断：检测到 Markdown 内容时必须等待用户确认 A/B 选项，无法完全自动化
适合人群
- 开发者、技术写作者：依赖 Markdown 格式完整性的代码文档管理者
- 自动化爱好者：希望将笔记操作集成到 shell 脚本、定时任务或 CI 流程的用户
- 跨平台重度用户：需在 Linux/WSL/服务器环境操作云笔记，无图形界面依赖
- 网页资料收藏者：需要批量、自动化归档网络文章至私有知识库
常规风险
1. API Key 泄露风险：config set apiKey 将密钥写入本地配置文件，共享环境需妥善隔离
2. 数据丢失风险：delete/update 操作不可逆，批量脚本建议前置备份逻辑
3. 格式误用风险：误用 create 保存 Markdown 内容会导致格式静默丢失，需严格遵守 save 优先原则
4. 网络依赖：所有操作需实时连接有道云服务，离线场景不可用
5. 目录 ID 误传：parentId 字段命名严格，误写为 folderId 等会导致笔记存入默认位置，可能造成数据散乱