YoudaoNote Skills 安装指南（通用版 · 编程 AI Agent）

本文档说明如何在 Cursor、Claude Code、OpenCode 等编程 AI Agent 中安装并配置 YoudaoNote Skills。

如果你使用的是 LobsterAI（有道龙虾）、OpenClaw、EasyClaw 等龙虾 AI Agent，请参阅 龙虾 AI Agent 安装指南。

前置条件

安装 Skill 前，需先安装 YoudaoNote CLI（≥ 1.2.0）并配置 API Key。请按 CLI 安装指南 完成安装、获取 API Key 和配置，确认 youdaonote list 能正常返回笔记列表后继续。

安装 Skill

安装方式统一为 下载 ZIP → 解压 → npx skills add，支持 macOS、Linux 和 Windows 全平台。

需要已安装 Node.js（npx 随 Node.js 一同安装）。

第一步：下载 Skill ZIP

下载最新版 Skill 包：

• youdaonote-skill-latest.zip

第二步：解压

macOS / Linux：

unzip -q youdaonote-skill-latest.zip -d /tmp/youdaonote-skill

Windows（PowerShell）：

Expand-Archive -Path youdaonote-skill-latest.zip -DestinationPath $env:TEMP\youdaonote-skill

解压后会得到一个 youdaonote 目录，内含 SKILL.md 等文件。

第三步：使用 npx skills 安装

skills 是一个开源的 Agent Skill 安装 CLI，支持 Cursor、Claude Code、OpenCode 等 40+ AI Agent。

macOS / Linux：

# 全局安装到所有检测到的 AI Agent
npx skills add /tmp/youdaonote-skill/youdaonote -g -y

# 或指定安装到特定工具
npx skills add /tmp/youdaonote-skill/youdaonote -g -a cursor -a claude-code -a opencode -y

Windows（PowerShell）：

npx skills add "$env:TEMP\youdaonote-skill\youdaonote" -g -y

安装完成后，重启对应的 AI Agent 使 Skill 生效。

支持的 AI Agent

npx skills add 会自动检测本机已安装的 AI Agent。常见工具对应的 --agent 参数和 Skill 安装目录：

完整列表见 skills CLI 文档。

验证安装

安装完成后，在 AI Agent 对话中发送：

列出我有道云笔记中的笔记

返回笔记列表即表示安装成功。

如果 AI 提示找不到 youdaonote 命令，说明 CLI 未正确安装或未加入 PATH，请参阅上方「前置条件」重新安装。

常见问题

安装相关

Q：npx skills add 报错找不到 SKILL.md？

请确认解压后的路径正确——npx skills add 的参数应指向包含 SKILL.md 的 youdaonote 目录，而非 zip 文件本身。

Q：Cursor 安装后没有生效？

Skill 在 Cursor 启动时加载，安装后需要重启或重载 Cursor。

Q：没有安装 Node.js 怎么办？

npx skills add 依赖 Node.js。如果不想安装 Node.js，可以使用上方「手动安装」的方式，将解压得到的 youdaonote 目录直接复制到对应 AI Agent 的 Skill 目录。

使用相关

Q：提示 CLI 版本过低？

Skill 要求 CLI 版本 ≥ 1.2.0。请重新运行安装脚本升级：

curl -fsSL https://artifact.lx.netease.com/download/youdaonote-cli/install.sh | bash

Q：提示 API Key 无效？

请访问 网易智能开发者平台 确认 API Key 有效，然后执行：

youdaonote config set apiKey YOUR_KEY

Q：网页剪藏失败或内容为空？

部分网站需要登录或有反爬保护，内容可能无法提取。可先在浏览器中打开页面确认内容可访问，再重新触发剪藏。