https://blog.zhifouli.top/index.php/tag/%E5%BC%80%E6%BA%90/ https://blog.zhifouli.top/index.php/archives/82/ 2026-01-27T19:05:00+08:00 AI摘要 Dify安装Markdown转换器插件失败，原因是插件容器缺少cairo依赖和pkg-config工具，导致pycairo编译失败。通过进入插件容器并执行apt update后安装cmake、pkg-config、libcairo2-dev等依赖项，成功解决问题。 此内容根据文章生成，仅用于文章内容的解释与总结 1.软件环境Docker方式部署 Dify1.8.02.故障现象3.排查方式找到dify插件容器langgenius/dify-plugin-daemon:0.2.0-local查看容器日志2026/01/27 10:48:05 full_duplex.go:65: [ERROR]init environment failed: failed to install dependencies: exit status 1, output: Resolved 81 packages in 725ms Building pycairo==1.29.0 × Failed to build `pycairo==1.29.0` ├─▶ The build backend returned an error ╰─▶ Call to `mesonpy.build_wheel` failed (exit status: 1) Did not find pkg-config by name 'pkg-config' Found pkg-config: NO Did not find CMake 'cmake' Found CMake: NO Run-time dependency cairo found: NO ../cairo/meson.build:31:12: ERROR: Dependency lookup for cairo with method 'pkgconfig' failed: Pkg-config for machine host machine not found. Giving up. hint: This usually indicates a problem with the package or the build environment. help: `pycairo` (v1.29.0) was included because `xhtml2pdf` (v0.2.17) depends on `svglib` (v1.6.0) which depends on `rlpycairo` (v0.4.0) which depends on `pycairo` , retrying发现是缺失 cairo 底层依赖 +pkg-config 工具，导致 pycairo==1.29.0 编译构建失败，进而引发插件依赖安装失败，多次重试均未解决4.解决方法安装插件 bowenliang123/md_exporter 所需的以下依赖项：cmakepkg-configlibcairo2-devlibjpeg-devlibgif-dev# 进入插件容器终端，安装依赖 apt-get install -y cmake pkg-config libcairo2-dev libjpeg-dev libgif-dev如果提示无法定位镜像Reading package lists... Done Building dependency tree... Done Reading state information... Done E: Unable to locate package cmake E: Unable to locate package pkg-config E: Unable to locate package libcairo2-dev E: Unable to locate package libjpeg-dev E: Unable to locate package libgif-dev# 1. 先更新软件源索引（关键步骤，解决「无法定位包」的核心） apt update -y # 2. 再执行依赖安装，然后再在Web端正常安装即可 apt-get install -y cmake pkg-config libcairo2-dev libjpeg-dev libgif-dev5.处理结果 https://blog.zhifouli.top/index.php/archives/73/ 2025-12-24T21:55:00+08:00 AI摘要 一款免费开源的PDF转图片工具，支持批量处理、多种格式和质量设置，界面简洁易用，转换过程可暂停继续，适合多种使用场景。 此内容根据文章生成，仅用于文章内容的解释与总结 一个简单易用的 PDF 批量转图片工具，支持暂停、继续，完全免费开源！写在前面你是否经常需要把 PDF 文件转换成图片？📄 想把 PDF 课件转成图片发朋友圈？📊 需要提取 PDF 报告中的某几页？📚 想把电子书转成图片在手机上看？🎨 需要批量处理几十个 PDF 文件？今天给大家分享一个我刚开源的小工具，专门解决这些问题！工具特点这个工具有几个我觉得很实用的功能：✨ 简单易用不需要懂任何技术，界面超级简洁，三步就能完成转换：选择 PDF 文件设置输出格式和质量点击开始转换就这么简单！🚀 批量处理支持一次选择多个 PDF 文件，自动批量转换。再也不用一个一个手动操作了！转换过程在独立进程中进行，不会卡住界面，可以随时查看进度、暂停或停止。每个 PDF 会自动创建一个独立的文件夹，页面按顺序命名（如 文件名_0001.png），井井有条。⚙️ 灵活设置格式选择：PNG（高质量）或 JPG（小体积）质量调节：50% - 100% 自由调整分辨率：72/96/150/200/300 DPI 多档可选我的推荐设置：屏幕查看：JPG 格式 + 95% 质量 + 150 DPI打印使用：PNG 格式 + 300 DPI🎯 实时进度转换过程中可以看到：总体进度（处理了几个文件）当前文件进度（转换到第几页）实时状态更新而且支持暂停/继续/停止，随时掌控转换过程！下载使用方式一：直接下载 exe（推荐）如果你不想折腾，直接下载打包好的 exe 文件：👉 下载地址：GitHub Releases下载后双击运行即可，无需安装任何环境！方式二：从源码运行如果你懂一点 Python，也可以从源码运行：# 克隆仓库 git clone https://github.com/zhifouli/pdf2img.git cd pdf2img # 安装依赖 pip install -r requirements.txt # 运行 python pdf2img_converter.py使用教程第一步：添加 PDF 文件可以一次选择多个 PDF 文件，选完后会在列表中显示。第二步：调整设置根据你的需求调整：输出格式：选 PNG 如果你要高质量（文件会大一些）选 JPG 如果你要节省空间（推荐）图片质量：拖动滑块调整（50-100%）建议设置 95%，基本看不出差别分辨率：屏幕看：选 150 DPI（推荐）打印用：选 300 DPI第三步：开始转换点击 "开始转换" 按钮选择输出目录（图片保存的位置）等待转换完成！转换过程中：可以点 "暂停" 暂停转换可以点 "停止" 终止任务进度条实时显示转换进度完成！转换完成后，在输出目录中会看到：输出目录/ ├── 文件1_imgs/ │ ├── 文件1_0001.png │ ├── 文件1_0002.png │ └── ... └── 文件2_imgs/ ├── 文件2_0001.png └── ...每个 PDF 一个文件夹，页面按顺序命名，清清楚楚！实际使用场景场景 1：课件分享老师发了一个 200 页的 PDF 课件，但你只想分享其中几页重点内容到朋友圈或群里。解决方案：用这个工具转成图片挑选需要的几页直接发送图片即可！场景 2：批量处理你有 50 个 PDF 报告需要转成图片用于 PPT 制作。解决方案：一次性选择所有 PDF点击开始转换去喝杯咖啡，回来就好了！场景 3：电子书阅读下载的 PDF 电子书在手机上看不太方便，想转成图片。解决方案：转成 JPG 格式（节省空间）质量设置 95%分辨率选 150 DPI（适合手机）为什么选择这个工具？🆓 完全免费开源软件，完全免费使用，无任何限制！🔒 隐私安全所有转换都在本地完成，不上传任何文件到云端，你的文件你做主！🚀 界面不卡顿转换过程在独立进程中进行，界面永远保持流畅响应。可以随时查看进度、暂停继续或停止任务。实测：100 页的 PDF 文件，大约 1-2 分钟就能转换完成（具体取决于电脑性能和设置的 DPI）。🛠️ 稳定可靠基于成熟的 PyMuPDF 库开发，处理过程稳定可靠。常见问题Q: 支持哪些系统？A: 目前提供 Windows 版本的 exe 文件。Mac 和 Linux 用户可以从源码运行。Q: 有没有文件大小或页数限制？A: 没有限制！想转多大的 PDF 都可以，想转多少页都行。Q: 转换质量怎么样？A: 使用业界成熟的 PyMuPDF 库，转换质量有保障。你可以自己调节 DPI 和质量参数。Q: 转换速度如何？A: 基于成熟的 PyMuPDF 库，转换速度不错！一般的 PDF（100 页左右）：1-2 分钟大文件（500+ 页）：几分钟到十几分钟具体速度取决于你的电脑性能和设置的 DPIQ: 会不会有水印或广告？A: 绝对不会！ 这是纯粹的开源工具，没有任何水印、广告或限制。Q: 可以商用吗？A: 可以使用，但要注意：个人使用：✅ 完全没问题开源项目：✅ 可以使用商业闭源：⚠️ 需要额外的商业许可详情可以看项目的 COMPLIANCE.md 文件。开源协议本项目采用 AGPL-3.0 开源协议。简单说就是：✅ 你可以自由使用、修改、分发✅ 必须保持开源✅ 如果你修改了代码，也要开源你的修改这保证了软件会一直保持开源和免费！技术栈对于想了解技术的朋友，简单说一下：🐍 Python - 开发语言📚 PyMuPDF - PDF 处理核心库🎨 Tkinter - GUI 界面⚡ multiprocessing - 后台进程处理，界面不卡顿📦 PyInstaller - 打包成 exe代码都在 GitHub 上，欢迎查看和贡献！未来计划目前还在持续改进中，计划添加：[ ] 真正的多进程并行转换（同时处理多个 PDF）[ ] 支持批量设置不同的转换参数[ ] 添加图片压缩选项[ ] 支持更多输出格式（WebP、TIFF 等）[ ] 添加简单的图片编辑功能[ ] 提供 Mac 版本的打包文件如果你有好的想法，欢迎在 GitHub 提 Issue 或 PR！写在最后这个工具是我平时自己用着顺手，想着分享给大家。如果你觉得好用，欢迎：⭐ 给项目点个 Star🔄 分享给有需要的朋友💬 提出你的建议和想法希望这个小工具能帮到你！相关链接📦 项目地址：https://github.com/zhifouli/pdf2img📥 下载地址：https://github.com/zhifouli/pdf2img/releases🐛 问题反馈：https://github.com/zhifouli/pdf2img/issues📖 使用文档：https://github.com/zhifouli/pdf2img/blob/master/README.md如果这篇文章对你有帮助，欢迎点赞、收藏、分享！有任何问题欢迎在评论区留言，我会尽快回复～本文首发于 [拾星漫记] 作者：zhifouli 日期：2025-12-24