youdaonote-notes

有道云笔记 · 笔记管理 Skill

前置条件

# 安装 CLI（macOS/Linux）
curl -fsSL https://artifact.lx.netease.com/download/youdaonote-cli/install.sh | bash

# 配置 API Key（从 https://mopen.163.com/#/dashboard 获取）
youdaonote config set apiKey YOUR_API_KEY

安装信息

项目	路径
CLI 二进制	~/.local/bin/youdaonote
配置文件	~/.youdaonote.json
PATH 配置	安装脚本自动写入 ~/.zshrc，新终端生效

若当前终端尚未 source ~/.zshrc，请用完整路径调用：~/.local/bin/youdaonote <command>

---

笔记操作命令

查看笔记列表

# 列出根目录笔记
youdaonote list

# 列出指定目录的笔记（需目录 ID）
youdaonote list -f <folderID>

⚠️ list 不支持 --json 参数，输出为纯文本格式。

读取笔记内容

youdaonote read <fileId>

创建笔记（富文本 .note 格式）

⚠️ create 命令固定创建 .note 富文本格式，无法创建 Markdown 笔记。

# 创建带标题和内容的笔记
youdaonote create -n "笔记标题" -c "笔记内容"

# 只创建标题（内容为空）
youdaonote create -n "笔记标题"

# 内容超过 10KB 时，从文件读取
youdaonote create -n "笔记标题" --file content.md

# 保存到指定目录
youdaonote create -n "笔记标题" -c "内容" -f <folderID>

创建 Markdown 笔记（.md 格式）

create 命令无法创建 .md 笔记，必须使用 save 命令并指定 "type": "md"。

步骤一： 用 Write 工具将 markdown 内容写入文件

⚠️ 严禁用 python3 -c "内容" 或 shell heredoc 内联传入含反引号的 markdown！ shell 会把 ``` 当命令替换执行，导致代码块内容被清空或替换成命令输出。 必须先用 Write 工具写文件，再用 Python 读取。

# 用 Write 工具写入 /tmp/note_content.md，内容为完整 markdown

步骤二： 用 Python 读取文件生成 JSON

import json

with open('/tmp/note_content.md', 'r') as f:
    content = f.read()

payload = {
    "title": "笔记标题",   # 不需要带 .md 后缀，save 命令会自动处理
    "type": "md",          # 关键：指定 md 类型
    "content": content,
    "parentId": "<folderID>"  # 目标目录 ID；不传则存到「我的资源」
}

with open('/tmp/note_payload.json', 'w') as f:
    json.dump(payload, f, ensure_ascii=False)

步骤三： 用 save 命令创建占位笔记（内容随意，仅用于建立 .md 文件）

youdaonote save --file /tmp/note_payload.json
# 输出：笔记 ID：XXXXXXXX

⚠️ save/createAnyNote 是为 HTML 内容设计的，会把 " 编码为 "，导致代码块中的引号乱码。 因此 不能 用 save 直接写入含引号的 markdown 内容，只用它建立 .md 文件。

步骤四： 立即用 update 命令覆写真正的内容（updateMarkdownNote 不做 HTML 转义）