前言¶
用 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。