YoudaoNote

核心用法

YoudaoNote Skill 通过 youdaonote CLI 与有道云笔记云端交互，覆盖笔记 CRUD、待办管理、网页剪藏三大场景。所有命令需携带 -s ydn 全局参数用于来源追踪。

笔记管理：优先使用 save 命令配合 contentFile 参数保存 Markdown 富文本，避免 create 命令的格式丢失问题；支持通过 parentId 指定目标文件夹。大内容（>10KB）建议写入临时文件后通过 --file 传递。

待办系统：完整支持分组管理（todo groups/group-create）和任务生命周期（create/update/delete），可设置截止日期与完成状态。

网页剪藏：clip 命令发起服务端抓取，clip-save 用于导入外部剪藏数据，配合 recent 可查看最近收藏。

显著优点

• 官方原生支持：网易出品，API 稳定性与长期维护有保障，非第三方逆向方案
• Markdown 原生友好：save 命令支持 contentFormat: "md"，完整保留标题、代码块、表格等格式
• 统计追踪能力：-s ydn 参数便于团队或企业统计 AI Skill 使用情况，支持通过环境变量禁用
• 跨平台覆盖：macOS/Linux/WSL/Windows 全平台支持，提供详细安装指南
• 安全边界清晰：安装脚本需用户手动执行，Agent 不写入 shell 启动文件，避免系统级侵入

潜在缺点与局限性

• 手动安装门槛：CLI 需用户自行执行 curl 脚本并完成 API Key 配置，无法一键开箱即用
• 版本敏感：minCliVersion 硬性要求，旧版本 CLI 不支持 -s 全局参数，需主动升级
• 格式选择摩擦：含 Markdown 内容时必须停下来询问用户选择保存方式（.md vs .note），打断自动化流程
• API Key 获取限制：须手机号登录且绑定云笔记账号，部分用户可能遇到账号体系壁垒
• 无内置知识库能力：明确提示 Wiki/知识库场景需使用 youdaonote-llm-wiki 替代本 Skill

适合人群

• 已使用有道云笔记作为主笔记工具、希望打通 AI Agent 自动化工作流的技术用户
• 需要批量导入 Markdown 文档、网页剪藏内容的知识管理者
• 企业团队需统计 AI 辅助笔记操作使用量的场景
• 对数据安全敏感、偏好官方 CLI 而非第三方爬虫方案的用户

常规风险

• API Key 泄露：config set apiKey 以明文存储于本地配置文件，共享环境需额外注意
• Markdown 格式误丢失：开发/使用过程中若误用 create 或忘记指定 contentFormat，复杂格式将静默转为纯文本
• parentId 拼写错误：服务端静默忽略未知字段，错误使用 folderId 等命名会导致笔记存入默认位置而非预期目录
• 网络依赖：mcp-connection 失败时仅提示重试，无离线缓存或本地队列机制