Agent Skills
返回列表
📚

ima 知识库迁入 Obsidian

知识管理 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中:

请根据安装指南 https://skillhub.cn/install/skillhub.md,安装 @user_4b3ce1d8/ima-to-obsidian 技能。

技能介绍

要解决的问题

把散落在 ima 知识库里的文章、截图、音频、公众号链接、PDF/Word 和视频链接搬进 Obsidian,难点在批量场景的稳定性:fetch_media_content 的 OCR 和转写成本高,列表接口不返回来源 URL,重名文件容易互相覆盖,小红书链接按常规抓取只会拿到反爬页面,视频如果没有内嵌字幕则必须走 ASR,错误的转写栈会让任务卡死。常见踩坑包括手动拼接 media_id 触发 220030、把截断的 introduction 当正文落盘、把「面板已连接」误判为工具可用。

技能如何工作

技能按已验证规则执行,不添加额外步骤,核心流程分三步:

  1. 枚举条目:调 mcp__ima-mcp__get_knowledge_base_list 拉知识库列表(limit 为 50);对每个库调 mcp__ima-mcp__get_knowledge_list,带 cursor 翻页(响应含 version 时翻页必须带上),media_type == 99 视为文件夹并递归 folder_id。最终生成 manifest(media_id/title/media_type_name/folder_path/create_time)。
  2. 分批拉取与生成:按每批 20~30 条逐条调 fetch_media_content;media_id 必须原样复制,真实格式为 {type}_{前缀}_{hash}{kb_id},hash 与 kb_id 之间无下划线,整串仅 2 个下划线。多拼一个下划线会触发 code:220030,它是兜底措辞而非服务端故障。单条失败重试最多 3 次(间隔 2 秒),仍失败记入 skip 文件(reason=fetch_failed);连续 3 条及以上失败立即停止并上报。目标 .md 已存在则跳过,重名用 -2/-3 后缀。
  3. 按类型落盘:截图/图片做 OCR 转结构化 Markdown,含插图截图(OCR 文本含 ![、parseimages、(x,y,w,h) 位置标记)直接跳过并记入清单;音频只保存完整转写文本,不保留音频本体;公众号/网址/PDF/Word 抓取正文转 Markdown,能识别到 URL 才在 frontmatter 里记 url。小红书链接不转 md,先整理清单交用户决定。目录结构按「知识库/文件夹」层级与 ima 对应。

视频有独立路径:先用 yt-dlp 拉流(只需音频时加 -x --audio-format wav),优先用 ffprobe 查字幕轨、ffmpeg 抽 .srt,有字幕直接转纯文本;无字幕再抽 16kHz 单声道 wav 走 pywhispercpp 转写(模型从 hf-mirror 下载 ggml-small.bin,需设 HF_HUB_DISABLE_XET=1)。烧录硬字幕只在用户明确授权时用抽帧 + 大模型 Read 兜底,因为逐帧 OCR 最费 token 且易错。

适用边界与注意点

前置条件是 ima MCP 连接器已连接:若面板显示断开,立即告知用户去连接器管理重新连接,不要空转重试;面板「已连接」不等于工具已注入,判断标准是能否实际调用 mcp__ima-mcp__*,搜不到工具需要点「信任/Trust」并重启会话。introduction 字段是截断预览,只能当校验参考,不能当最终结果。发表时间区分绝对时间、相对时间(换算成截图当天加 date_approx: true)和识别不到(标 unknown)。含插图截图、小红书链接会产出清单而非笔记,属于预期行为。

Created: 2026-08-27; validated with pywhispercpp, ffmpeg and yt-dlp.

使用场景

  • 把 ima 知识库里的公众号文章、网址和 PDF 按原目录结构导出为 Obsidian 笔记,保留来源与发布时间
  • 把截图、音频这类非文本收藏批量转成可检索的 Markdown,只保留正文和转写文本
  • 迁移前需要先核对小红书链接清单,确认哪些条目交由后续单独处理
  • 视频只有链接时,希望先提取内嵌字幕,无字幕再走 ASR 转写成笔记

适合人员

  • 运营 / 编辑:负责把公众号、网站和资料链接整理进个人知识库,需要归一化 Markdown 和来源信息
  • 知识库管理者:维护 Obsidian 库并定期从 ima 导入收藏,关注重名、目录层级和失败清单
  • 后端 / 自动化工程师:设计 ima 到 Obsidian 的批量迁移流程,需要处理 media_id、翻页、重试和分批边界
  • 内容研究者:收集文章、音频和视频链接做主题归档,需要正文、字幕或转写文本而非原始附件