前言¶

用 ima 收集资料、用 Obsidian 写东西的人，通常会遇到两件事：第一次要把整个知识库搬过去，之后还要持续跟上新增内容。手动做的话，截图要 OCR、音频要转写、公众号和网页要抓正文、PDF 和 Word 要解析，最后还要统一成 Obsidian 能读的 Markdown，并保留原来的文件夹层级。这个 Skill 把这两类事合并成一条流程：全量迁移负责初次搬迁和重建基线，增量同步负责之后的持续更新。

这是什么¶

ima知识库迁移与增量同步，把 ima 知识库内容迁移或同步为 Obsidian Markdown 笔记，支持两种模式。由社区发布者 user_4b3ce1d8 发布维护，坐标 @user_4b3ce1d8/ima-to-obsidian，版本 2.1.0，分类 knowledge-management，当前版本不需要 API Key（标签 requires_api_key=false）。SkillHub 上评分 100000，下载 1478 次，安装数为 0。

核心功能¶

1、两种工作模式。模式A·增量同步：对比 ima 与已迁移笔记，找出新增条目并补迁，适用于「查一下 ima 对比 obsidian 有什么更新」「把 ima 新增内容同步过来」以及每日自动镜像任务。模式B·全量迁移：批量搬迁 ima 内容，适用于「把 ima 知识库导出/搬入 Obsidian」「把截图/图片转成 md」、初次迁移或重建基线。

2、覆盖的资料类型。截图/图片走 OCR，音频/视频走 ASR 转写，另外覆盖公众号文章、网址、PDF、Word 等类型。

3、统一的输出格式。按统一 frontmatter + 信息行格式生成 md，保留 ima 的文件夹层级，而不是把内容拍平堆在一个目录里。

安装与启用¶

这个 Skill 基于通用 SKILL.md 格式，可从 SkillHub 页面获取：

https://www.skillhub.cn/skills/user_4b3ce1d8/ima-to-obsidian

官方接口地址为：

https://api.skillhub.cn/user_4b3ce1d8/ima-to-obsidian

在对应客户端里启用该 Skill 后，直接用自然语言描述要做的事即可，例如说明「把 ima 知识库全量迁移到 Obsidian」或「把 ima 新增内容同步过来」。官方资料未给出各客户端（Cursor / Codex CLI / Claude Code）的具体安装命令，因此这里不做区分说明，以你所用客户端的 Skill 启用方式为准。

典型用法¶

以下用法来自官方简介给出的场景，按模式区分：

1、初次迁移或重建基线。请求：「把 ima 知识库导出/搬入 Obsidian」，走模式B 全量迁移，会把 ima 内容批量转成 Markdown 并保留层级。

2、已有迁移结果，只需要补新增。请求：「把 ima 新增内容同步过来」，走模式A 增量同步，先对比 ima 与已迁移笔记，只补迁新增条目。

3、查差异。请求：「查一下 ima 对比 obsidian 有什么更新」，同样走模式A，输出差异结果而不是直接改动文件。

4、单独转换非文本资料。请求：「把截图/图片转成 md」，走模式B，对截图和图片做 OCR 后生成 Markdown。

适用场景与注意¶

适合：已经同时在用 ima 和 Obsidian，需要把 ima 作为资料源长期镜像到 Obsidian 的人；也适合初次从 ima 搬家、希望输出结构与原知识库一致的人。

注意几点。

1、模式选择要看基线是否存在。没有迁移过就选模式B；已有迁移结果、只想补增量就选模式A，否则会重复写入。

2、音频和视频走 ASR 转写，转写质量取决于音频内容，拿到结果后建议自己过一遍再入库。

3、OCR 和 ASR 属于有损处理，关键资料最好保留原始文件，不要把生成的 md 当作唯一副本。

4、官方资料里没有给出基线固化、去抖之类的额外机制说明，也没有视频处理时的校对约束，本文不展开；如有相关需求，需要以 Skill 实际运行结果为准。

5、该 Skill 版本 2.1.0 来自社区（source: community），安装数为 0，使用前可以自己先小范围试一次。

结尾¶

一句话回顾：这个 Skill 把「初次全量搬迁」和「之后持续增量同步」这两件事合并到同一套格式规范里，省掉自己写 OCR、ASR、正文抓取和层级保留的脚本。官方地址：https://api.skillhub.cn/user_4b3ce1d8/ima-to-obsidian，SkillHub 页面：https://www.skillhub.cn/skills/user_4b3ce1d8/ima-to-obsidian。