- name
- auto-image-reader
- description
- 自动读取用户上传的图片。当用户发送图片时（通过飞书/Telegram等渠道），系统会在消息中附带图片路径。触发后自动读取图片内容并理解，无需手动查找路径。
- version
- 1.0.0
Auto Image Reader — 自动图片读取技能
触发条件
- 用户发送了图片，并询问图片内容
- 用户上传了图片，希望AI读取并分析
- 任何包含图片消息的场景
核心问题
系统发送图片时，路径可能是相对路径（如 user_input_files/image.png）， 直接用这个路径访问会返回404。
正确做法：用 images_list 先查找图片的真实绝对路径。
工作流程
Step 1：查找图片的真实路径
使用 images_list 工具，遍历找到对应的图片文件：
images_list(start=0, number=20)在返回结果中找到图片的 Path 字段，如：
/workspace/user_input_files/image.png
/workspace/imgs/xxx.jpg匹配逻辑：
- 如果文件名包含用户消息中的关键词（如用户说"这张图"），匹配
- 如果有多张最新图片，取最新的（按修改时间）
- 如果是唯一的 user_input_files/image.png，直接使用
Step 2：用 images_understand 读取图片
找到真实路径后，用 images_understand 分析：
images_understand(
image_info=[
{
"file": "/workspace/user_input_files/image.png", # 真实绝对路径
"prompt": "请详细描述这张图片的所有内容，包括：文字、布局、颜色、背景色、右下角是否有水印，以及整体视觉效果。"
}
]
)Step 3：读取并回答用户
根据图片内容，用自然语言回答用户的问题。
常见场景模板
| 用户说 | 解读prompt |
|---|---|
| "这张图的内容是什么" | 请详细描述这张图片的所有内容 |
| "图片里右下角有水印吗" | 请仔细检查图片右下角和边缘是否有水印（特别是'Created by...'字样） |
| "图片里写的什么" | 请提取图片中所有可见的文字内容 |
| "这张图有什么问题" | 请分析这张图片是否存在问题（如水印、背景异常、显示错误） |
重要注意事项
- 绝对路径格式：
/workspace/...而不是user_input_files/... - 先查再读：不要直接用消息中的相对路径，必须先用
images_list确认真实路径 - 文件名重复：如果 user_input_files 下有多个 image.png，用时间或内容特征区分
- 图片可能已删除：如果 images_list 找不到，说明图片已被清理，从消息元数据中无法追溯
自动读取逻辑（伪代码）
当收到用户图片消息时：
1. 从消息元数据提取文件名（如 image.png）
2. 调用 images_list(start=0, number=20)
3. 在结果中搜索包含该文件名的记录
4. 找到 → 提取 Path 字段（真实绝对路径）
5. 调用 images_understand(file=真实路径, prompt=用户问题)
6. 回答用户已在 MEMORY.md 中固化
本技能的核心理念已写入 MEMORY.md：
- 收到图片消息时，必须先用 images_list 查找真实路径
- 不能假设消息中的文件名可以直接访问
- images_list 能看到 /workspace 下所有图片的真实路径