在普通 Python 脚本中，IPython.display.Image 无法直接渲染图像，仅输出对象描述；需将 Mermaid PNG 数据保存为文件，再用 Pillow 加载并调用 show() 弹出预览窗口。
在普通 python 脚本中，`ipython.display.image` 无法直接渲染图像，仅输出对象描述；需将 mermaid png 数据保存为文件，再用 pillow 加载并调用 `show()` 弹出预览窗口。
IPython.display 模块本质上是为交互式环境（如 Jupyter Notebook、IPython 终端）设计的，其 display() 函数依赖于前端通信协议（如 Jupyter 的 MIME 显示机制），在标准 Python 解释器或 .py 脚本中运行时完全无效——此时 display(Image(...)) 不会触发任何可视化，仅返回 <ipython.core.display.image object></ipython.core.display.image> 字符串表示。
要实现在非 Notebook 环境（例如 Ubuntu 上的 .py 脚本）中查看 LangChain 的状态图，核心思路是：绕过 IPython 的显示管道，转为本地图像 I/O 流程。LangChain 的 graph.get_graph().draw_mermaid_png() 方法返回的是 bytes 类型的 PNG 原始数据，可直接写入磁盘，再用跨平台图像库加载并展示。
以下是推荐的完整实现方案（基于 Pillow）：
from PIL import Image
import tempfile
import os
# 生成 PNG 图像字节数据
png_data = simple_graph.get_graph().draw_mermaid_png()
# ✅ 推荐：使用临时文件（避免硬编码路径，更安全可靠）
with tempfile.NamedTemporaryFile(delete=False, suffix=".png") as tmp:
tmp.write(png_data)
tmp_path = tmp.name
try:
img = Image.open(tmp_path)
img.show() # 调用系统默认图片查看器（Ubuntu 下通常为 Eye of GNOME）
except Exception as e:
print(f"图像展示失败：{e}")
finally:
# 可选：展示后自动清理临时文件
os.unlink(tmp_path)
⚠️ 注意事项：
-
img.show()在 Linux（如 Ubuntu）上依赖xdg-open或默认桌面环境的图片查看器，首次运行可能无响应，请确认桌面环境已启动（即非纯终端 SSH 无 GUI 场景）； - 若运行于服务器或无图形界面环境，可改用
matplotlib保存为文件并打印路径，或导出为 PDF/SVG 进行离线查看； -
draw_mermaid_png()需提前安装graphviz（sudo apt install graphviz）及 Python 包python-graphviz，否则会抛出ImportError或ExecutableNotFound； - 不建议长期使用
/tmp/graph.png等固定路径，易引发并发冲突或权限问题；tempfile是更健壮的选择。
总结：IPython.display 不适用于常规 Python 模块；正确做法是将二进制图像数据落地为文件，再借助 Pillow、matplotlib 或系统工具完成可视化。该模式简洁、跨平台、不依赖 Jupyter 生态，是生产脚本和 CLI 工具中展示 LangChain 图的标准实践。
