夜雨聆风
嗨，大家好，我是品薇
不知道你有没有遇到过这种情况：把飞书导出的 Markdown 文章导入 Obsidian，刚导入的时候图片显示得好好的，过几天再打开，图片全变成红叉。辛辛苦苦整理的资料，心态全崩了。
今天就给大家分享一个品薇自己开发的 Obsidian 插件——飞书图片助手，专门解决这类问题。
虽然名字叫飞书图片助手，但钉钉导出的 Markdown 中的图片也能一并识别处理。
文末有打包好的插件，免费分享给大家。
为什么导出的图片会失效
先讲清楚问题的根源。飞书和钉钉的处理方式不一样，但结果都不安全。
⚠️飞书：临时链接，几小时到几天就失效
飞书导出 Markdown 时，图片并没有真正下载到本地，而是给了你一段"临时链接"。打开导出的 .md 文件你会看到长这样：
注意链接里的authcode=xxxxxxxx—— 这是飞书签发的临时鉴权码，有效期通常只有几个小时到几天。一旦过期，这个链接就变成了一张永远加载不出来的"幽灵图"。
⚠️钉钉：阿里云 OSS 直链，没有过期但仍有风险
钉钉导出的 Markdown 链接长这样：
这是阿里云 OSS（对象存储）的公开直链，链接里没有过期参数，理论上现在打开还能正常访问。
但别高兴太早。这就好比你家相册放在邻居家——现在邻居人好，让你随时来看，但其实有 3 件事随时可能发生：
邻居哪天搬家了——你存在他家的图自然也跟着没了（钉钉文档被删除、改了路径） 邻居哪天不让你进门了——可能换了规矩，从此你看不了（钉钉改了访问规则） 邻居换房东了——新房东说"这房子以后只租不公开"，你以前进得去的也进不去了（阿里云改了存储策略）
所以只要图片不在你自己电脑里，这些事就有可能发生。今天能用，不代表三年后还能用。
不管哪种来源，本地化都是唯一靠谱的方案
不管图片是飞书的临时链接，还是钉钉的"看似永久"的 OSS 链接，只要图片不在你电脑上，就不属于你。
解决方案只有一个：把图片下载到本地，再把链接换成本地路径。
这个插件干的就是这件事：
扫描飞书、钉钉 Markdown 文件中的链接 把图片下载到本地的指定目录里 再把原文里的链接替换成 Obsidian 原生的
考虑到用户体验，失败的图片也会保留原链接，不破坏文件格式；删除文件时，对应的图片文件夹也自动清理，不留垃圾。
下载完成后，图片就真正属于你了。哪怕断网，5 年后再打开，图片都还在。
如何安装
插件还没上架 Obsidian 社区市场，所以无法在市场搜索，需要手动安装一下，Mac 和 Windows 步骤一样，整个过程不到 1 分钟。
第一步：网盘转存下载
点击夸克网盘链接：https://pan.quark.cn/s/187ed1c9dcf9转存至您自己的网盘中。
之后下载到电脑解压，你会得到一个文件夹：feishu-image-downloader，里面有 4 个文件：
main.js：插件的核心代码 manifest.json：插件的身份信息 styles.css：插件的样式 README.md：插件的使用说明
第二步：复制文件夹至 Obsidian 插件目录
打开 Obsidian → 设置（齿轮）→第三方插件
在「已安装插件」区域，点小文件夹图标 📁系统会直接打开.obsidian/plugins/文件夹
把解压的文件夹复制进来
最终结构是这样：
你的仓库/└── .obsidian/└── plugins/└── feishu-image-downloader/├── main.js├── manifest.json├── styles.css└── README.md
第三步：重启 Obsidian 并启用插件
新装的插件需要 Obsidian 重启才能识别，关掉再重开一下 Obsidian。
重启后在第三方插件的「已安装插件」里找到「飞书图片助手」，把开关打开。
启用后，左边侧边栏会多出一个 ⬇️图片下载图标，看到它就说明装好了。
如何使用
下载文件中的图片
打开你要处理的 Markdown 文件，让文件处于当前页 点击左侧栏的 ⬇️ 图片下载图标 等待提示「✓ 全部下载成功」就完成了
此时仓库根目录会发现多了一个feishu-images/文件夹，里面按你的 MD 文件名命名了子目录，每张图按出现顺序命名为image_1.png、image_2.png……一目了然。
到这里，文件中的图片过几年打开也不会丢失了。
| 删除文件
删除文件时将弹出确认弹窗，你可选择全部删除或保留部分内容，防止因直接删除而误删需要留存的图片。图片预览模式方便选择，体验拉满。
如果你喜欢今天的分享，请点个赞 在看 和 转发 吧！
感恩遇见，感谢喜欢~
| 插件链接
飞书图片下载助手夸克链接：https://pan.quark.cn/s/187ed1c9dcf9
