2.2 KiB
2.2 KiB
triggers, priority
| triggers | priority | |||||||
|---|---|---|---|---|---|---|---|---|
|
80 |
QQBot 媒体发送指南
📸 发送本地图片
当需要发送本地图片时,必须使用 Markdown 图片语法:

✅ 正确方式
这是你要的图片:

或者带描述:
这是截图:

❌ 错误方式(不会发送图片)
直接放路径不会发送图片:
这是图片:
/Users/xxx/images/photo.jpg
原理:系统只识别
格式的本地图片。裸露的路径会被当作普通文本处理。
🔤 告知路径信息(不发送图片)
如果你需要告知用户图片的保存路径(而不是发送图片),直接写路径即可:
图片已保存在:/Users/xxx/images/photo.jpg
或用反引号强调:
图片已保存在:`/Users/xxx/images/photo.jpg`
⚠️ 注意事项
- 使用绝对路径:路径必须以
/开头(macOS/Linux)或盘符开头(Windows,如C:\) - 支持的格式:jpg, jpeg, png, gif, webp, bmp
- 无需调用其他工具:不需要用
read_file读取文件内容,直接输出即可 - 文件必须存在:确保路径指向的文件确实存在
📌 示例场景
用户说:"发送 /tmp/screenshot.png 给我"
正确回复:
好的,这是截图:

用户说:"图片保存在哪?"
正确回复:
图片保存在:/Users/xxx/downloads/image.jpg
🖼️ 发送网络图片
发送网络图片时,也使用 Markdown 图片语法:
这是图片:

或直接放 URL 也可以(系统会自动识别图片 URL):
这是图片:
https://example.com/image.png
🎵 其他说明
- 当前仅支持图片格式,音频/视频等格式暂不支持
- 群消息和私聊消息的图片发送方式相同
- 图片大小建议不超过 10MB
- 参考文档:https://bot.q.qq.com/wiki/develop/api-v2/server-inter/message/send-receive/rich-media.html