youdaonote-pull：有道云笔记一键导出备份脚本

项目介绍

youdaonote-pull 是一个 Python 脚本，用于将有道云笔记中的所有笔记一键导出/备份到本地。解决有道云笔记无法导出笔记的痛点。

有道云笔记的 Mac 客户端和网页端去除了导出所有笔记的功能。此脚本通过模拟有道云笔记的 API 接口，将所有笔记按原格式下载到本地。

核心功能

使用步骤

一、准备工作

1. 安装 Git 并克隆项目

git clone https://github.com/DeppWang/youdaonote-pull.git
cd youdaonote-pull

2. 安装 Python3 和依赖包

# macOS
python3 -m venv venv
. venv/bin/activate
pip3 install -r requirements.txt

# Windows
python -m venv venv
. venv/bin/activate
pip install -r requirements.txt

3. 设置 Cookies 登录

由于有道云笔记登录升级加入了图形验证码，脚本目前只能使用 Cookies 登录，不能使用账号密码。

在 cookies.json 中填写你的登录 Cookies：

{
    "cookies": [
        ["YNOTE_CSTK", "**", ".note.youdao.com", "/"],
        ["YNOTE_LOGIN", "**", ".note.youdao.com", "/"],
        ["YNOTE_SESS", "**", ".note.youdao.com", "/"]
    ]
}

获取方法：浏览器中登录有道云笔记 → 打开 DevTools(F12) → Network → 找到第一个请求 → 复制 Cookie 值。

脚本完全本地运行，不必担心 Cookies 泄露。

4. 配置参数 config.json

{
    "local_dir": "",
    "ydnote_dir": "",
    "smms_secret_token": "",
    "is_relative_path": true
}

示例（Windows）：

{
    "local_dir": "D:/Documents/youdaonote-pull/test",
    "ydnote_dir": "",
    "smms_secret_token": "SGSLk9yWdTe4RenXYqEPWkqVrx0Yexample"
}

二、运行导出

# macOS/Linux
python3 pull.py

# Windows
python pull.py

三、多次导出（增量同步）

再次运行同样的命令即可。脚本会根据有道云笔记文件最后修改时间与本地文件最后修改时间对比，判断是否需要更新。

• 只导出新增、修改或未导出的笔记
• 不会覆盖本地已经修改的文件
• ⚠️ 不要同时在有道云笔记和本地修改同一个文件

工作原理

有道云笔记的正常使用流程是：浏览器（前端）调用服务器（后端）接口 → 接口返回文件内容 → 前端渲染显示。

youdaonote-pull 的原理是找到有道云笔记的 API 接口，模拟接口调用，将本应由前端显示的内容直接存放到本地文件。Xml 转换为 Markdown 借助了 xml.etree.ElementTree。

优劣势分析

适合谁用

• 有道云笔记老用户——想迁移到 Obsidian / Typora / Notion 等更开放的笔记工具
• 需要备份笔记的人——担心云端数据丢失，想本地留一份离线备份
• 从有道云笔记转出的所有用户——因为官方去除了导出功能，这是目前最完整的替代方案

总结

youdaonote-pull 解决了一个非常具体的痛点：有道云笔记去除了导出功能，用户想迁移却出不去。 这个脚本提供了一个相对完整的解决方案——导出所有笔记、自动转 Markdown、处理图床图片。对于想要从有道云笔记迁移到 Obsidian 等开放笔记工具的用户来说，这是一个必备工具。

项目地址

参考资料

• GitHub 仓库：源代码、Issue、使用教程。→ https://github.com/DeppWang/youdaonote-pull
• 作者博文：更简单的使用教程和原理解析。→ https://depp.wang/2020/06/11/how-to-find-the-api-of-a-website-eg-note-youdao-com
• B 站视频教程：https://www.bilibili.com/video/BV11F411F7vG/