68 lines
2.0 KiB
Markdown
68 lines
2.0 KiB
Markdown
---
|
|
name: send-local-image
|
|
description: "发送本地图片技能。当你需要将本地图片文件发送到当前微信会话时使用。"
|
|
---
|
|
|
|
# Send Local Image Skill
|
|
|
|
## 描述
|
|
|
|
这是一个发送本地图片文件到当前微信会话的技能。
|
|
|
|
技能脚本位于 `scripts/send_local_image.py`，会直接调用机器人客户端接口发送图片，不会修改或生成图片。
|
|
|
|
## 触发条件
|
|
|
|
- 当你有本地图片地址，需要将图片发送到当前微信会话时触发。
|
|
|
|
## 入参规范
|
|
|
|
```json
|
|
{
|
|
"type": "object",
|
|
"properties": {
|
|
"file_path": {
|
|
"type": "string",
|
|
"description": "要发送的本地图片文件路径。必须是机器人运行环境可访问的路径。"
|
|
},
|
|
"file_paths": {
|
|
"type": "array",
|
|
"items": {
|
|
"type": "string"
|
|
},
|
|
"description": "可选，要发送的多个本地图片文件路径。"
|
|
}
|
|
},
|
|
"anyOf": [{ "required": ["file_path"] }, { "required": ["file_paths"] }],
|
|
"additionalProperties": false
|
|
}
|
|
```
|
|
|
|
对应命令行参数：
|
|
|
|
- `--file_path <本地图片路径>` 必填或可重复传入
|
|
- `--file_paths <JSON数组>` 可选，用于一次传入多个本地图片路径
|
|
|
|
## 执行步骤
|
|
|
|
1. 仅当用户明确要发送已有本地图片文件时触发该技能。
|
|
2. 从用户输入或上下文中提取本地图片路径，不要把远程 URL 当成本地路径。
|
|
3. 在仓库根目录执行脚本，例如：
|
|
|
|
```bash
|
|
python3 scripts/send_local_image.py --file_path '/tmp/example.png'
|
|
```
|
|
|
|
4. 脚本会调用客户端接口 `POST http://127.0.0.1:{ROBOT_WECHAT_CLIENT_PORT}/api/v1/robot/message/send/image/local` 将图片发送给当前会话。
|
|
|
|
## 校验规则
|
|
|
|
- `file_path` 不能为空。
|
|
- 传入的路径必须指向一个已存在的本地文件。
|
|
- 远程 `http` 或 `https` 图片地址应使用 `send-remote-image` 技能。
|
|
|
|
## 回复要求
|
|
|
|
- 成功时，脚本输出「图片发送成功」，表示图片已通过客户端接口直接发送，无需 AI 智能体再做额外处理。
|
|
- 失败时，返回脚本输出的具体错误信息。
|