Smart Image Loader

快速开始

当用户请求显示一张图片时：

1. 判断输入是 URL 还是本地路径

   • URL 以 http:// 或 https:// 开头
   • 本地路径为工作区（workspace）内的文件路径

2. 若为 URL：

   • 使用 Python 脚本将图片下载至临时位置
   • 调用 read 工具显示该图片
   • 随后清理临时文件

3. 若为本地文件：

   • 验证文件是否存在（支持相对于 workspace 的相对路径或绝对路径）
   • 直接使用 read 工具显示该图片

使用示例

用户说：“展示这张图片：https://example.com/photo.jpg”

1. 执行命令：python3 scripts/smart_image_loader.py https://example.com/photo.jpg
2. 脚本下载至临时路径：/tmp/dir/photo.jpg
3. 对路径 /tmp/dir/photo.jpg 使用 read 工具
4. 清理操作：删除该临时文件

用户说：“显示 ./images/logo.png”

1. 执行命令：python3 scripts/smart_image_loader.py ./images/logo.png
2. 脚本验证文件存在性
3. 对路径 /home/node/clawd/images/logo.png（绝对路径）使用 read 工具

脚本用法

python3 scripts/smart_image_loader.py 

参数

输出格式

脚本返回类 JSON 格式的输出，包含以下字段：

• Status：SUCCESS 或 FAILED
• Type：url 或 local
• File Path：供 read 工具使用的本地路径
• Message：状态描述信息
• Cleanup Needed：若需删除临时文件则为 true

示例

# URL 示例
python3 scripts/smart_image_loader.py https://example.com/image.jpg
# 输出：下载至 /tmp/xyz/image.jpg，后续可对该路径使用 read 工具

# 本地文件示例（相对路径）
python3 scripts/smart_image_loader.py ./photos/vacation.jpg
# 输出：文件位于 /home/node/clawd/photos/vacation.jpg

# 本地文件示例（绝对路径）
python3 scripts/smart_image_loader.py /home/node/clawd/downloads/graphic.png
# 输出：文件位于 /home/node/clawd/downloads/graphic.png

工作流决策树

User asks to display an image
         |
         v
    Is it a URL? (http:// or https://)
         |
    +----+---------------------------+
    |                                 |
   YES                               NO
    |                                 |
    v                                 v
Download to temp              Does file exist?
    |                                 |
    v                          +-----+-----+
Use read tool                 |           |
    |                        YES          NO
    v                              |
Cleanup temp file              v
                           Use read tool
                               |
                               v
                          Done (no cleanup)

清理规范

• URL 下载场景：显示完成后必须清理临时文件
• 本地文件场景：无需清理（文件保留在 workspace 中）
• 使用 exec 命令配合 rm 执行清理

支持的图片格式

• JPEG（.jpg、.jpeg）
• PNG（.png）
• GIF（.gif）
• WebP（.webp）
• BMP（.bmp）

错误处理