有道云笔记备份工具安全指南：本地存储与迁移方案

「youdaonote-pull」是一款专为有道云笔记用户设计的本地备份工具，通过Python脚本实现笔记的一键导出与格式转换，帮助用户建立数据安全防线，摆脱云端依赖。本指南将从安全准备、操作流程到效率优化，全面介绍工具的使用方法，确保您的笔记数据可掌控、可迁移、可备份。

⚠️ 安全操作前置说明

在开始备份操作前，请务必了解以下安全要点：

• 本地执行保障：所有备份流程均在本地环境完成，不涉及第三方服务器，最大限度降低数据泄露风险
• 存储空间检查：确保本地磁盘有足够存储空间（建议预留笔记总容量2倍以上空间）
• 网络稳定性：备份过程中保持网络连接稳定，避免因中断导致数据不完整
• 配置文件保护：包含登录凭证的配置文件请妥善保管，避免共享或上传至公共平台

一、环境准备流程

1.1 获取工具源码

通过终端执行以下命令获取工具代码：

git clone https://gitcode.com/gh_mirrors/yo/youdaonote-pull
cd youdaonote-pull

1.2 检查Python环境

确保系统已安装Python 3.6及以上版本：

python3 --version  # 检查Python版本
pip3 --version     # 检查pip包管理器

1.3 安装依赖包

使用pip安装工具所需依赖：

pip3 install -r requirements.txt

二、配置文件生成与设置

2.1 创建登录凭证文件

在项目根目录创建cookies.json文件，填入有道云笔记登录凭证：

{
    "cookies": [
        [
            "YNOTE_CSTK",        // 身份验证令牌
            "您的CSTK值",        // 从浏览器开发者工具获取
            ".note.youdao.com",  // 作用域域名
            "/"                  // 作用路径
        ],
        [
            "YNOTE_LOGIN",       // 登录状态标识
            "您的LOGIN值",       // 从浏览器开发者工具获取
            ".note.youdao.com",
            "/"
        ],
        [
            "YNOTE_SESS",        // 会话标识
            "您的SESS值",        // 从浏览器开发者工具获取
            ".note.youdao.com",
            "/"
        ]
    ]
}

获取方法：在浏览器中登录有道云笔记后，通过"开发者工具→应用→Cookie"找到对应字段值

2.2 配置导出参数

编辑项目根目录的config.json文件，设置备份参数：

{
    "local_dir": "/path/to/your/backup",  // 本地备份存储路径（必填）
    "ydnote_dir": "",                     // 指定有道云笔记文件夹（留空表示全部）
    "smms_secret_token": "",              // SMMS图床Token（图片本地存储可留空）
    "is_relative_path": true              // 图片路径是否使用相对路径（建议true）
}

三、执行备份操作

3.1 启动备份流程

在项目根目录执行主脚本开始备份：

python3 pull.py

3.2 监控备份进度

备份过程中，终端会显示当前进度：

• 正在处理的笔记标题
• 已完成数量/总数量
• 图片下载状态
• 格式转换结果

3.3 验证备份结果

备份完成后，检查local_dir指定的目录：

• 确认生成.md格式的笔记文件
• 检查images子目录是否包含所有图片资源
• 随机打开几个笔记文件验证内容完整性

四、核心优势

• 格式无损转换：将有道云笔记专有格式精确转换为标准Markdown，保留文本样式、列表、表格等元素
• 图片自动处理：智能识别笔记中的图片资源，自动下载并修复本地引用路径
• 批量高效处理：支持成百上千条笔记的批量导出，通过多线程优化下载速度
• 增量备份支持：二次运行时仅处理新增或修改的笔记，节省时间和带宽
• 配置灵活定制：可按文件夹导出、设置图片存储方式、自定义本地目录结构

五、效率提升方案

5.1 分批次备份策略

对于超过1000条笔记的用户，建议按文件夹分批导出：

1. 在config.json中设置ydnote_dir为特定文件夹名称
2. 完成一批后修改该值继续下一批
3. 最终合并所有备份目录

5.2 定期备份自动化

使用系统定时任务实现自动备份：

# Linux/macOS使用crontab，添加如下配置（每月1日凌晨2点执行）
0 2 1 * * cd /path/to/youdaonote-pull && python3 pull.py >> backup.log 2>&1

5.3 网络优化建议

• 避开网络高峰期执行备份（建议凌晨时段）
• 对于海外用户，可配置代理加速资源下载
• 大文件笔记（含大量图片）单独处理

六、常见问题处理

Q1: 执行脚本提示"登录失败"

解决步骤：

1. 检查cookies.json中三个字段值是否完整
2. 重新登录有道云笔记获取最新Cookie
3. 确认系统时间与网络时间同步

Q2: 图片下载不完整或链接错误

解决方法：

1. 确保is_relative_path设置为true
2. 删除local_dir中的images目录后重新执行
3. 检查网络连接是否稳定，尝试使用VPN

Q3: 备份过程中程序意外终止

恢复方法：

1. 直接重新运行python3 pull.py
2. 工具会自动从上次中断处继续处理
3. 若频繁中断，可减少单次备份数量

七、工具局限性说明

本工具目前存在以下限制，使用前请了解：

• 依赖Cookie登录：需要手动获取登录凭证，不支持账号密码直接登录
• 有道格式依赖：若有道云笔记API或格式发生变化，可能导致备份失败
• 不支持加密笔记：加密保护的笔记无法导出内容
• 图片处理限制：超大图片（超过10MB）可能下载失败
• 平台兼容性：主要测试环境为Linux/macOS，Windows系统可能需要调整路径格式

建议定期访问项目主页获取更新，及时应对有道云笔记平台的变化。通过合理使用本工具，您可以构建起安全可靠的本地笔记备份系统，为数字资产提供双重保障。