有道云笔记全能工具:笔记管理(创建、搜索、浏览、读取)、待办管理(创建、完成、分组)、网页剪藏(服务端抓取)。当用户需要操作有道云笔记时使用此 Skill。
通过 youdaonote CLI 操作有道云笔记。覆盖笔记 CRUD、待办管理、网页剪藏全场景。
执行任何操作前,Agent 必须先运行 youdaonote list 检测 CLI 是否可用:
command not found → 立即跳转「CLI 未安装处理」自动安装,禁止只展示安装步骤让用户手动操作youdaonote config set apiKey <用户提供的Key>。获取 API Key 的地址只有这一个,禁止告知用户其他地址。youdaonote version,若版本低于 1.2.0,展示升级建议后继续执行;否则可运行 youdaonote help --json 获取当前 CLI 全部能力的结构化描述(JSON),用于确认命令是否可用,下方速查表作为 fallback| 命令 | 用途 | 示例 |
|---|
save | 保存笔记(✅ 推荐,支持 Markdown 富文本) | youdaonote save --file note.json |
create | 创建笔记(⚠️ 仅纯文本,不支持 Markdown 富文本) | youdaonote create -n "标题" -c "内容" [-f <目录ID>] |
update | 更新 Markdown 笔记 | youdaonote update <fileId> -c "内容" 或 --file content.md |
delete | 删除笔记 | youdaonote delete <fileId> |
rename | 重命名笔记 | youdaonote rename <fileId> "新标题" |
move | 移动笔记 | youdaonote move <fileId> <目录ID> |
search | 搜索笔记 | youdaonote search "关键词" |
list | 浏览目录 | youdaonote list -f <目录ID> |
read | 读取笔记 | youdaonote read <fileId> |
recent | 最近收藏 | youdaonote recent -l 20 -c --json |
clip | 网页剪藏(服务端) | youdaonote clip "https://..." [-f <目录ID>] --json |
clip-save | 保存外部剪藏 JSON | youdaonote clip-save --file data.json |
todo list | 列出待办 | youdaonote todo list [--group <分组ID>] --json |
todo create | 创建待办 | youdaonote todo create -t "标题" [-c "内容"] [-d 2025-12-31] [-g <分组ID>] |
todo update | 更新待办 | youdaonote todo update <todoId> [--done] [--undone] [-t "新标题"] |
todo delete | 删除待办 | youdaonote todo delete <todoId> |
todo groups | 列出待办分组 | youdaonote todo groups --json |
todo group-create | 创建分组 | youdaonote todo group-create "分组名" |
todo group-rename | 重命名分组 | youdaonote todo group-rename <groupId> "新名" |
todo group-delete | 删除分组 | youdaonote todo group-delete <groupId> |
check | 健康检查 | youdaonote check |
config show | 查看配置 | youdaonote config show --json |
config set | 设置配置 | youdaonote config set apiKey YOUR_KEY |
默认创建方式:所有笔记一律使用 save 命令 + contentFormat: "md" 保存为 Markdown 富文本。
禁止使用 create 命令保存包含 Markdown 格式的内容(标题、列表、代码块、表格等)—— create 仅支持纯文本,会静默丢失所有格式。HTML/结构化数据先转 Markdown 再用 save 保存。
当用户要保存的内容包含以下任意 Markdown 特征时(# 标题、**粗体**、`代码块、- 列表、> 引用、[链接](url)、),必须先停下来询问用户,不得直接执行命令:
检测到内容包含 Markdown 格式,请选择保存方式:
A(推荐)保存为 Markdown 笔记(.md)
→ 格式完整保留,可在编辑器中正常显示和编辑
B 保存为有道专有格式(.note)
→ 支持有道云笔记富文本编辑器的全部功能
请回复 A 或 B:
收到用户选择后,按以下方式构造命令:
save 命令,type: "md",文件名加 .md 后缀
{"title":"标题.md","type":"md","content":"Markdown 内容"}
save 命令,type: "note",contentFormat: "md",文件名加 .note 后缀
{"title":"标题.note","type":"note","contentFormat":"md","content":"Markdown 内容"}
# ✅ 推荐:支持 Markdown 富文本(标题、列表、代码块等)
printf '%s\n' '{"title":"笔记","contentFormat":"md","content":"# 标题\n\n内容"}' | youdaonote save
# ✅ 大内容(>10KB)通过文件传递
youdaonote save --file note.json
# ⚠️ 仅纯文本,不支持 Markdown 格式,有格式需求时禁用
youdaonote create -n "标题" -c "纯文本内容"
youdaonote search "关键词"
youdaonote list [-f <目录ID>] # 浏览目录,id 可传给 read
youdaonote read <fileId> # 返回 JSON 含 content、rawFormat(md/note/txt)和 isRaw(是否原始内容)
youdaonote recent -l 20 -c --json # 最近收藏
youdaonote update <fileId> -c "新内容"
youdaonote update <fileId> --file content.md # 大内容(>10KB)从文件读取
youdaonote delete <fileId>
youdaonote rename <fileId> "新标题"
youdaonote move <fileId> <目录ID>
youdaonote clip "https://example.com/article" --json
youdaonote clip "https://example.com/article" -f <目录ID> --json # 保存到指定目录
收到 command not found 时,Agent 立即执行安装命令,禁止只展示步骤让用户操作。
macOS / Linux / WSL:
curl -fsSL https://artifact.lx.netease.com/download/youdaonote-cli/install.sh | bash -s -- -f -b ~/.local/bin
export PATH="$HOME/.local/bin:$PATH"
# 安装后立即重新执行用户原始请求
Windows(CMD/PowerShell):不支持一键安装,告知用户下载预编译包:
运行 youdaonote check --json,根据 status: "fail" 的项执行:
| 失败项 | 处理动作 |
|---|---|
config-file / api-key | youdaonote config set apiKey YOUR_KEY |
mcp-connection | API Key 有效但网络不通,提示用户检查网络或稍后重试 |
--json 输出机器可解析格式--file 传递,避免命令行参数限制& 时必须用双引号括起list 输出的 id 与 read 的 fileId 等价read 返回的 rawFormat 标识笔记原始格式:md=Markdown、note=云笔记、txt=纯文本;isRaw 标识返回的 content 是否为原始内容(true=原文可直接编辑,false=经过转换的纯文本)create 保存 Markdown 内容:create 不支持 contentFormat,即使内容含 Markdown 语法也会存为纯文本静默丢失格式,有格式需求时一律使用 save 并指定 contentFormat: "md"