前言¶
有道云笔记的迁移不是单一动作。官方没有开放批量导出接口,社区常用的做法是先用 youdaonote-pull 这类工具把笔记拉到本地,拿到一堆 .note 文件,再自己处理格式转换、图片引用和导入。中间任意一环断了,笔记要么格式错乱,要么图片全是裂图。更麻烦的是导入目标:ima 的知识库和笔记模块是两套东西,很多人以为导进去就能编辑,结果发现进了不可编辑的知识库。
下面介绍的 Skill「有道云笔记迁移到 ima 笔记」把这条链路打包成了一个技能,覆盖从导出到导入的全部步骤。
这是什么¶
「有道云笔记迁移到 ima 笔记」是一个基于通用 SKILL.md 格式的社区 Skill,坐标 @user_763df95b/youdao-to-ima,版本 1.0.1,由 user_763df95b 发布维护,分类为 knowledge-management,来源标记为 community。
它解决的问题是:把有道云笔记完整迁移到 ima 的笔记模块,而不是知识库。迁移过程中自动完成格式转换、文件名清理、远程图片下载和 base64 嵌入,导入后笔记可以直接编辑,图片正常显示。
SkillHub 页面显示该 Skill 下载 2390 次、安装 0 次(页面所列评分为 100000,数值形似占位,仅供参考),带有 requires_api_key=true 标签。
核心功能¶
根据官方简介,这个 Skill 覆盖的完整链路是六步:
- youdaonote-pull 导出:调用本地已有的 youdaonote-pull 工具,把有道云笔记拉取到本地。
- .note 转 .md:把有道云的 .note 格式转换成 Markdown。
- 文件名清理:处理导出文件名中不规范的字符,避免后续导入出问题。
- 远程图片下载:把笔记中引用的远程图片逐张下载到本地。
- base64 嵌入:把图片转成 base64 直接嵌入 md 文件,使图片随文件走,不再依赖原图地址。
- ima 笔记批量导入:把处理好的 md 文件批量导入 ima 笔记模块。
官方简介特别注明导入目标是「笔记模块(非知识库,可直接编辑)」,这一点和「导入知识库」是两种结果,选型时要注意区分。
触发条件方面,Skill 在用户提到「导出有道云笔记」「有道云笔记迁移」「有道云转 ima」「有道云笔记导入 ima」「youdao note export」「有道云笔记导出并嵌入图片」等需求时触发。
安装与启用¶
已抓取资料中没有给出官方的安装命令、目录路径或配置字段,因此这里不猜测具体命令。启用方式请以官方页面为准:
https://www.skillhub.cn/skills/user_763df95b/youdao-to-ima
有一点可以提前确认:Skill 带有 requires_api_key=true 标签,意味着使用前需要准备相应的 API Key。按标签名称推断,这可能与 ima 导入环节所需的接口凭证有关,具体密钥类型和配置位置以官方页面说明为准。
资料中也没有区分 Cursor、Codex CLI、Claude Code 的安装差异,此处如实留白。
典型用法¶
以下是官方简介中描述的可复现流程,作为使用前的对照清单:
1、确认本地已准备好 youdaonote-pull 导出工具,并已用它把有道云笔记导出到本地。
2、触发 Skill,例如提出「导出有道云笔记」「有道云笔记迁移」这类需求。
3、Skill 按链路依次执行:.note 转 .md → 文件名清理 → 远程图片下载 → base64 嵌入。
4、批量导入到 ima 笔记模块,检查导入结果:笔记可编辑、图片正常显示。
适用场景与注意¶
适合这几种情况:有道云笔记量大、图片多,手动导出处理成本高;需要迁移到 ima 且要求导入后可编辑;希望图片不依赖远程地址,随笔记文件一起走。
需要留意的限制:
- 导出这一步依赖 youdaonote-pull,Skill 本身不提供导出能力,本地必须先有该工具。
- 导入目标是 ima 笔记模块,不是知识库,需要进知识库的场景不适用。
- 带
requires_api_key=true标签,使用前需准备好 API Key。 - 资料中下载量为 2390 次、安装量为 0 次,社区 Skill 更新情况不透明,使用前建议先在小批量笔记上试跑。
- 官方页面在本次撰写时无法访问,安装与配置细节请以页面恢复后的最新说明为准。
结尾¶
这个 Skill 的价值在于把有道云笔记迁移这条链路上的六个环节串成一步,省掉手工处理格式、图片和文件名的重复劳动,导入后笔记可编辑、图片可显示。适合要从有道云笔记迁到 ima 笔记模块的场景。
官方地址:https://www.skillhub.cn/skills/user_763df95b/youdao-to-ima